@contentgrowth/content-emailing 0.6.1 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentgrowth/content-emailing",
-  "version": "0.6.1",
+  "version": "0.7.1",
   "type": "module",
   "description": "Unified email delivery and template management system with UI components",
   "main": "./dist/index.js",

package/schema.sql

@@ -61,3 +61,35 @@ CREATE INDEX IF NOT EXISTS idx_system_email_preferences_unsub_token ON system_em
 CREATE INDEX IF NOT EXISTS idx_system_email_sends_user ON system_email_sends(user_id);
 CREATE INDEX IF NOT EXISTS idx_system_email_sends_period ON system_email_sends(email_kind, period_key);
 CREATE INDEX IF NOT EXISTS idx_system_email_events_send ON system_email_events(send_id);
+
+-- =========================================================
+-- Email Logs: Comprehensive tracking of all email sends
+-- =========================================================
+-- Use this table to track every email sent, with status, 
+-- provider info, and error handling. Supports batch emails via batch_id.
+
+CREATE TABLE IF NOT EXISTS system_email_logs (
+    id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+    batch_id TEXT,                              -- Groups multiple recipients in same send
+    recipient_email TEXT NOT NULL,              -- Email address sent to
+    recipient_user_id TEXT,                     -- User ID if known (NULL for invitations)
+    template_id TEXT NOT NULL,                  -- e.g., 'tmpl_verify_email', 'direct'
+    subject TEXT,                               -- Rendered subject line
+    status TEXT NOT NULL DEFAULT 'pending',     -- 'pending', 'sent', 'failed', 'bounced', 'complained'
+    provider TEXT,                              -- 'resend', 'sendgrid', 'mailchannels', etc.
+    provider_message_id TEXT,                   -- ID from email provider for tracking/webhooks
+    error_message TEXT,                         -- Failure reason if status = 'failed'
+    error_code TEXT,                            -- Provider error code if available
+    metadata TEXT,                              -- JSON for extra context (org name, etc.)
+    created_at INTEGER NOT NULL DEFAULT (strftime('%s', 'now')),
+    sent_at INTEGER                             -- When successfully delivered to provider
+);
+
+-- Email logs indexes for common queries
+CREATE INDEX IF NOT EXISTS idx_email_logs_recipient ON system_email_logs(recipient_email);
+CREATE INDEX IF NOT EXISTS idx_email_logs_user ON system_email_logs(recipient_user_id);
+CREATE INDEX IF NOT EXISTS idx_email_logs_template ON system_email_logs(template_id);
+CREATE INDEX IF NOT EXISTS idx_email_logs_status ON system_email_logs(status);
+CREATE INDEX IF NOT EXISTS idx_email_logs_batch ON system_email_logs(batch_id);
+CREATE INDEX IF NOT EXISTS idx_email_logs_created ON system_email_logs(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_email_logs_provider_msg ON system_email_logs(provider_message_id);