@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.
Files changed (132) hide show
  1. package/README.md +89 -0
  2. package/dist/components/index.d.ts +3 -0
  3. package/dist/components/index.d.ts.map +1 -0
  4. package/dist/components/index.js +3 -0
  5. package/dist/components/index.js.map +1 -0
  6. package/dist/index.d.ts +14 -0
  7. package/dist/index.d.ts.map +1 -0
  8. package/dist/index.js +65 -0
  9. package/dist/index.js.map +1 -0
  10. package/dist/middleware/tracking.d.ts +3 -0
  11. package/dist/middleware/tracking.d.ts.map +1 -0
  12. package/dist/middleware/tracking.js +13 -0
  13. package/dist/middleware/tracking.js.map +1 -0
  14. package/dist/options.d.ts +160 -0
  15. package/dist/options.d.ts.map +1 -0
  16. package/dist/options.js +51 -0
  17. package/dist/options.js.map +1 -0
  18. package/dist/queue/consumer.d.ts +8 -0
  19. package/dist/queue/consumer.d.ts.map +1 -0
  20. package/dist/queue/consumer.js +83 -0
  21. package/dist/queue/consumer.js.map +1 -0
  22. package/dist/routes/confirm.d.ts +3 -0
  23. package/dist/routes/confirm.d.ts.map +1 -0
  24. package/dist/routes/confirm.js +59 -0
  25. package/dist/routes/confirm.js.map +1 -0
  26. package/dist/routes/subscribe.d.ts +3 -0
  27. package/dist/routes/subscribe.d.ts.map +1 -0
  28. package/dist/routes/subscribe.js +87 -0
  29. package/dist/routes/subscribe.js.map +1 -0
  30. package/dist/routes/track-click.d.ts +3 -0
  31. package/dist/routes/track-click.d.ts.map +1 -0
  32. package/dist/routes/track-click.js +45 -0
  33. package/dist/routes/track-click.js.map +1 -0
  34. package/dist/routes/track-open.d.ts +3 -0
  35. package/dist/routes/track-open.d.ts.map +1 -0
  36. package/dist/routes/track-open.js +40 -0
  37. package/dist/routes/track-open.js.map +1 -0
  38. package/dist/routes/unsubscribe.d.ts +4 -0
  39. package/dist/routes/unsubscribe.d.ts.map +1 -0
  40. package/dist/routes/unsubscribe.js +81 -0
  41. package/dist/routes/unsubscribe.js.map +1 -0
  42. package/dist/routes/webhook.d.ts +3 -0
  43. package/dist/routes/webhook.d.ts.map +1 -0
  44. package/dist/routes/webhook.js +30 -0
  45. package/dist/routes/webhook.js.map +1 -0
  46. package/dist/schema.d.ts +564 -0
  47. package/dist/schema.d.ts.map +1 -0
  48. package/dist/schema.js +47 -0
  49. package/dist/schema.js.map +1 -0
  50. package/dist/types.d.ts +106 -0
  51. package/dist/types.d.ts.map +1 -0
  52. package/dist/types.js +3 -0
  53. package/dist/types.js.map +1 -0
  54. package/dist/utils/bindings.d.ts +20 -0
  55. package/dist/utils/bindings.d.ts.map +1 -0
  56. package/dist/utils/bindings.js +19 -0
  57. package/dist/utils/bindings.js.map +1 -0
  58. package/dist/utils/bounce.d.ts +29 -0
  59. package/dist/utils/bounce.d.ts.map +1 -0
  60. package/dist/utils/bounce.js +59 -0
  61. package/dist/utils/bounce.js.map +1 -0
  62. package/dist/utils/index.d.ts +12 -0
  63. package/dist/utils/index.d.ts.map +1 -0
  64. package/dist/utils/index.js +9 -0
  65. package/dist/utils/index.js.map +1 -0
  66. package/dist/utils/providers.d.ts +31 -0
  67. package/dist/utils/providers.d.ts.map +1 -0
  68. package/dist/utils/providers.js +109 -0
  69. package/dist/utils/providers.js.map +1 -0
  70. package/dist/utils/scheduling.d.ts +89 -0
  71. package/dist/utils/scheduling.d.ts.map +1 -0
  72. package/dist/utils/scheduling.js +110 -0
  73. package/dist/utils/scheduling.js.map +1 -0
  74. package/dist/utils/send.d.ts +42 -0
  75. package/dist/utils/send.d.ts.map +1 -0
  76. package/dist/utils/send.js +193 -0
  77. package/dist/utils/send.js.map +1 -0
  78. package/dist/utils/subscribers.d.ts +23 -0
  79. package/dist/utils/subscribers.d.ts.map +1 -0
  80. package/dist/utils/subscribers.js +200 -0
  81. package/dist/utils/subscribers.js.map +1 -0
  82. package/dist/utils/templates.d.ts +16 -0
  83. package/dist/utils/templates.d.ts.map +1 -0
  84. package/dist/utils/templates.js +426 -0
  85. package/dist/utils/templates.js.map +1 -0
  86. package/dist/utils/tokens.d.ts +13 -0
  87. package/dist/utils/tokens.d.ts.map +1 -0
  88. package/dist/utils/tokens.js +62 -0
  89. package/dist/utils/tokens.js.map +1 -0
  90. package/dist/utils/tracking.d.ts +26 -0
  91. package/dist/utils/tracking.d.ts.map +1 -0
  92. package/dist/utils/tracking.js +49 -0
  93. package/dist/utils/tracking.js.map +1 -0
  94. package/dist/utils/urls.d.ts +7 -0
  95. package/dist/utils/urls.d.ts.map +1 -0
  96. package/dist/utils/urls.js +34 -0
  97. package/dist/utils/urls.js.map +1 -0
  98. package/dist/vite-plugin.d.ts +4 -0
  99. package/dist/vite-plugin.d.ts.map +1 -0
  100. package/dist/vite-plugin.js +18 -0
  101. package/dist/vite-plugin.js.map +1 -0
  102. package/package.json +85 -0
  103. package/src/astro.d.ts +4 -0
  104. package/src/components/PreferenceCenter.astro +147 -0
  105. package/src/components/SubscribeForm.astro +161 -0
  106. package/src/components/index.ts +2 -0
  107. package/src/index.ts +101 -0
  108. package/src/middleware/tracking.ts +18 -0
  109. package/src/options.ts +65 -0
  110. package/src/queue/consumer.ts +99 -0
  111. package/src/routes/confirm.ts +68 -0
  112. package/src/routes/preferences.astro +137 -0
  113. package/src/routes/subscribe.ts +107 -0
  114. package/src/routes/track-click.ts +57 -0
  115. package/src/routes/track-open.ts +51 -0
  116. package/src/routes/unsubscribe.ts +96 -0
  117. package/src/routes/webhook.ts +48 -0
  118. package/src/schema.ts +56 -0
  119. package/src/types.ts +145 -0
  120. package/src/utils/bindings.ts +28 -0
  121. package/src/utils/bounce.ts +77 -0
  122. package/src/utils/index.ts +47 -0
  123. package/src/utils/providers.ts +141 -0
  124. package/src/utils/scheduling.ts +188 -0
  125. package/src/utils/send.ts +282 -0
  126. package/src/utils/subscribers.ts +277 -0
  127. package/src/utils/templates.ts +459 -0
  128. package/src/utils/tokens.ts +91 -0
  129. package/src/utils/tracking.ts +58 -0
  130. package/src/utils/urls.ts +49 -0
  131. package/src/virtual.d.ts +32 -0
  132. 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,3 @@
1
+ export { default as PreferenceCenter } from './PreferenceCenter.astro';
2
+ export { default as SubscribeForm } from './SubscribeForm.astro';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -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,3 @@
1
+ export { default as PreferenceCenter } from './PreferenceCenter.astro';
2
+ export { default as SubscribeForm } from './SubscribeForm.astro';
3
+ //# sourceMappingURL=index.js.map
@@ -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"}
@@ -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,3 @@
1
+ import type { MiddlewareHandler } from 'astro';
2
+ export declare const onRequest: MiddlewareHandler;
3
+ //# sourceMappingURL=tracking.d.ts.map
@@ -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"}
@@ -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":"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"}
@@ -0,0 +1,3 @@
1
+ import type { APIRoute } from 'astro';
2
+ export declare const GET: APIRoute;
3
+ //# sourceMappingURL=confirm.d.ts.map
@@ -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,3 @@
1
+ import type { APIRoute } from 'astro';
2
+ export declare const POST: APIRoute;
3
+ //# sourceMappingURL=subscribe.d.ts.map
@@ -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"}