@bernierllc/email 1.0.1 → 1.1.1

package/examples/fastapi-example/main.py

@@ -1,257 +0,0 @@
-"""
-Copyright (c) 2025 Bernier LLC
-
-This file is licensed to the client under a limited-use license.
-The client may use and modify this code *only within the scope of the project it was delivered for*.
-Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
-"""
-
-from fastapi import FastAPI, BackgroundTasks, HTTPException
-from fastapi.middleware.cors import CORSMiddleware
-from contextlib import asynccontextmanager
-import os
-from typing import List, Dict, Any
-
-from email_template_manager import (
-    EmailTemplateManager,
-    EmailScheduler,
-    MagicLinkManager,
-    SendGridProvider,
-    EmailTemplate,
-    ScheduledEmail,
-    MagicLink
-)
-from email_template_manager.integrations.fastapi import create_email_router
-
-# Configuration
-DATABASE_URL = os.getenv("DATABASE_URL", "postgresql://user:pass@localhost/email_templates")
-SENDGRID_API_KEY = os.getenv("SENDGRID_API_KEY")
-ENCRYPTION_KEY = os.getenv("ENCRYPTION_KEY", "your-secret-encryption-key")
-
-# Global managers
-template_manager: EmailTemplateManager = None
-scheduler: EmailScheduler = None
-magic_link_manager: MagicLinkManager = None
-
-@asynccontextmanager
-async def lifespan(app: FastAPI):
-    # Startup
-    global template_manager, scheduler, magic_link_manager
-    
-    # Initialize components
-    template_manager = EmailTemplateManager(DATABASE_URL)
-    
-    email_provider = SendGridProvider({
-        "api_key": SENDGRID_API_KEY,
-        "from_email": "noreply@yourapp.com",
-        "from_name": "Your App"
-    })
-    
-    scheduler = EmailScheduler(template_manager, email_provider)
-    magic_link_manager = MagicLinkManager(template_manager, ENCRYPTION_KEY)
-    
-    print("Email Template Manager initialized")
-    yield
-    
-    # Shutdown
-    print("Email Template Manager shutting down")
-
-# Create FastAPI app
-app = FastAPI(
-    title="Email Template Manager Example",
-    description="Example FastAPI application using email-template-manager",
-    version="1.0.0",
-    lifespan=lifespan
-)
-
-# Add CORS middleware
-app.add_middleware(
-    CORSMiddleware,
-    allow_origins=["http://localhost:3000"],  # React dev server
-    allow_credentials=True,
-    allow_methods=["*"],
-    allow_headers=["*"],
-)
-
-# Include the email management router
-email_router = create_email_router(
-    get_template_manager=lambda: template_manager,
-    get_scheduler=lambda: scheduler,
-    get_magic_link_manager=lambda: magic_link_manager
-)
-app.include_router(email_router, prefix="/api/email", tags=["email"])
-
-# Custom endpoints for your application
-@app.post("/api/users/{user_id}/welcome-email")
-async def send_welcome_email(
-    user_id: str,
-    user_email: str,
-    user_name: str,
-    background_tasks: BackgroundTasks
-):
-    """Send a welcome email to a new user"""
-    try:
-        # Find the welcome email template
-        templates = await template_manager.list_templates(
-            filters={"name": "Welcome Email"}
-        )
-        
-        if not templates:
-            raise HTTPException(status_code=404, detail="Welcome email template not found")
-        
-        welcome_template = templates[0]
-        
-        # Schedule the email
-        scheduled_email = ScheduledEmail(
-            template_id=welcome_template.id,
-            recipient_email=user_email,
-            recipient_name=user_name,
-            variables={
-                "name": user_name,
-                "email": user_email,
-                "user_id": user_id
-            },
-            trigger_type="immediate",
-            metadata={"user_id": user_id, "type": "welcome"}
-        )
-        
-        result = await scheduler.schedule_email(scheduled_email)
-        
-        # Process immediately in the background
-        background_tasks.add_task(scheduler.process_pending_emails)
-        
-        return {"success": True, "scheduled_email_id": result.id}
-        
-    except Exception as e:
-        raise HTTPException(status_code=500, detail=str(e))
-
-@app.post("/api/events/{event_id}/reminder-emails")
-async def schedule_event_reminders(
-    event_id: str,
-    event_date: str,
-    attendees: List[Dict[str, str]]
-):
-    """Schedule reminder emails for an event"""
-    try:
-        # Find reminder email templates
-        templates = await template_manager.list_templates(
-            filters={"tags": ["event", "reminder"]}
-        )
-        
-        if not templates:
-            raise HTTPException(status_code=404, detail="Event reminder template not found")
-        
-        reminder_template = templates[0]
-        scheduled_emails = []
-        
-        for attendee in attendees:
-            # Schedule 7 days before
-            scheduled_email = ScheduledEmail(
-                template_id=reminder_template.id,
-                recipient_email=attendee["email"],
-                recipient_name=attendee.get("name", ""),
-                variables={
-                    "name": attendee.get("name", ""),
-                    "event_id": event_id,
-                    "event_date": event_date
-                },
-                trigger_type="relative",
-                trigger_offset=-7,  # 7 days before
-                reference_date=event_date,
-                metadata={"event_id": event_id, "type": "reminder"}
-            )
-            scheduled_emails.append(scheduled_email)
-        
-        results = await scheduler.schedule_batch(scheduled_emails)
-        
-        return {
-            "success": True,
-            "scheduled_count": len(results),
-            "scheduled_email_ids": [r.id for r in results]
-        }
-        
-    except Exception as e:
-        raise HTTPException(status_code=500, detail=str(e))
-
-@app.post("/api/magic-links/user-onboarding")
-async def generate_onboarding_link(
-    user_email: str,
-    user_id: str,
-    expires_in_hours: int = 72
-):
-    """Generate a magic link for user onboarding"""
-    try:
-        magic_link = await magic_link_manager.generate_magic_link(
-            email=user_email,
-            link_type="user_onboarding",
-            payload={"user_id": user_id, "step": "profile_setup"},
-            expires_in_hours=expires_in_hours
-        )
-        
-        # In a real app, you'd send this link via email
-        onboarding_url = f"https://yourapp.com/onboarding?token={magic_link.token}"
-        
-        return {
-            "success": True,
-            "magic_link_id": magic_link.id,
-            "onboarding_url": onboarding_url,
-            "expires_at": magic_link.expires_at
-        }
-        
-    except Exception as e:
-        raise HTTPException(status_code=500, detail=str(e))
-
-@app.get("/api/onboarding")
-async def validate_onboarding_token(token: str):
-    """Validate and use an onboarding magic link"""
-    try:
-        magic_link = await magic_link_manager.validate_magic_link(token)
-        
-        if not magic_link:
-            raise HTTPException(status_code=404, detail="Invalid or expired token")
-        
-        if magic_link.type != "user_onboarding":
-            raise HTTPException(status_code=400, detail="Invalid token type")
-        
-        # Use the token (marks it as used)
-        used_link = await magic_link_manager.use_magic_link(token)
-        
-        return {
-            "success": True,
-            "user_id": used_link.payload.get("user_id"),
-            "step": used_link.payload.get("step"),
-            "email": used_link.email
-        }
-        
-    except Exception as e:
-        raise HTTPException(status_code=400, detail=str(e))
-
-# Background task endpoint for processing emails
-@app.post("/internal/process-emails")
-async def process_pending_emails():
-    """Internal endpoint to process pending emails (called by cron job)"""
-    try:
-        result = await scheduler.process_pending_emails()
-        return {
-            "success": True,
-            "processed": result.get("processed", 0),
-            "failed": result.get("failed", 0),
-            "errors": result.get("errors", [])
-        }
-    except Exception as e:
-        raise HTTPException(status_code=500, detail=str(e))
-
-# Health check
-@app.get("/health")
-async def health_check():
-    """Health check endpoint"""
-    try:
-        # Test database connection
-        await template_manager.list_templates(skip=0, limit=1)
-        return {"status": "healthy", "service": "email-template-manager"}
-    except Exception as e:
-        raise HTTPException(status_code=503, detail=f"Service unhealthy: {str(e)}")
-
-if __name__ == "__main__":
-    import uvicorn
-    uvicorn.run(app, host="0.0.0.0", port=8000) 

package/examples/nextjs-example/next-env.d.ts

@@ -1,13 +0,0 @@
-/*
-Copyright (c) 2025 Bernier LLC
-
-This file is licensed to the client under a limited-use license.
-The client may use and modify this code *only within the scope of the project it was delivered for*.
-Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
-*/
-
-/// <reference types="next" />
-/// <reference types="next/image-types/global" />
-
-// NOTE: This file should not be edited
-// see https://nextjs.org/docs/basic-features/typescript for more information.

package/examples/nextjs-example/package.json

@@ -1,26 +0,0 @@
-{
-  "name": "nextjs-email-template-example",
-  "version": "1.0.0",
-  "private": true,
-  "scripts": {
-    "dev": "next dev",
-    "build": "next build",
-    "start": "next start",
-    "lint": "next lint"
-  },
-  "dependencies": {
-    "@email-template-manager/core": "^1.0.0",
-    "@email-template-manager/react": "^1.0.0",
-    "next": "14.0.0",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
-    "typescript": "^5.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "eslint": "^8.0.0",
-    "eslint-config-next": "14.0.0"
-  }
-}

package/examples/nextjs-example/pages/admin/templates.tsx

@@ -1,157 +0,0 @@
-/*
-Copyright (c) 2025 Bernier LLC
-
-This file is licensed to the client under a limited-use license.
-The client may use and modify this code *only within the scope of the project it was delivered for*.
-Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
-*/
-
-import { useState } from 'react';
-import {
-  EmailTemplateProvider,
-  EmailTemplateList,
-  EmailTemplateEditor,
-  useEmailTemplates
-} from '@email-template-manager/react';
-import { EmailManagerConfig } from '@email-template-manager/core';
-
-const config: EmailManagerConfig = {
-  database: {
-    type: 'postgresql',
-    connectionString: process.env.DATABASE_URL!,
-  },
-  emailProvider: {
-    provider: 'sendgrid',
-    apiKey: process.env.SENDGRID_API_KEY!,
-    fromEmail: 'noreply@yourapp.com',
-    fromName: 'Your App'
-  },
-  templates: {
-    defaultFromEmail: 'noreply@yourapp.com',
-    defaultFromName: 'Your App',
-    liquidEngine: {
-      strictVariables: false
-    }
-  },
-  scheduling: {
-    defaultMaxRetries: 3,
-    retryDelayMinutes: [5, 15, 60],
-    batchSize: 100,
-    processingIntervalMinutes: 5
-  },
-  security: {
-    encryptionKey: process.env.ENCRYPTION_KEY!,
-    tokenLength: 32,
-    defaultExpiryHours: 24
-  },
-  logging: {
-    level: 'info',
-    includePayload: false
-  }
-};
-
-function TemplateManager() {
-  const [selectedTemplateId, setSelectedTemplateId] = useState<string | null>(null);
-  const [showEditor, setShowEditor] = useState(false);
-  const { templates, createTemplate, updateTemplate, deleteTemplate } = useEmailTemplates();
-
-  const handleCreateNew = () => {
-    setSelectedTemplateId(null);
-    setShowEditor(true);
-  };
-
-  const handleEdit = (templateId: string) => {
-    setSelectedTemplateId(templateId);
-    setShowEditor(true);
-  };
-
-  const handleSave = async (template: any) => {
-    if (selectedTemplateId) {
-      await updateTemplate(selectedTemplateId, template);
-    } else {
-      await createTemplate(template);
-    }
-    setShowEditor(false);
-    setSelectedTemplateId(null);
-  };
-
-  const handleCancel = () => {
-    setShowEditor(false);
-    setSelectedTemplateId(null);
-  };
-
-  if (showEditor) {
-    const selectedTemplate = selectedTemplateId 
-      ? templates.find(t => t.id === selectedTemplateId)
-      : undefined;
-
-    return (
-      <div className="container mx-auto p-6">
-        <EmailTemplateEditor
-          template={selectedTemplate}
-          onSave={handleSave}
-          onCancel={handleCancel}
-          variables={[
-            { name: 'name', type: 'text', required: true, description: 'User name' },
-            { name: 'email', type: 'text', required: true, description: 'User email' },
-            { name: 'company', type: 'text', required: false, description: 'Company name' },
-            { name: 'custom_message', type: 'text', required: false, description: 'Custom message' }
-          ]}
-          previewData={{
-            name: 'John Doe',
-            email: 'john@example.com',
-            company: 'Acme Corp',
-            custom_message: 'Welcome to our platform!'
-          }}
-          className="max-w-6xl"
-        />
-      </div>
-    );
-  }
-
-  return (
-    <div className="container mx-auto p-6">
-      <div className="flex justify-between items-center mb-6">
-        <h1 className="text-3xl font-bold text-gray-900">Email Templates</h1>
-        <button
-          onClick={handleCreateNew}
-          className="bg-blue-600 hover:bg-blue-700 text-white px-4 py-2 rounded-md font-medium"
-        >
-          Create New Template
-        </button>
-      </div>
-      
-      <EmailTemplateList
-        templates={templates}
-        onSelect={(template) => console.log('Selected:', template)}
-        onEdit={(template) => handleEdit(template.id!)}
-        onDelete={(templateId) => deleteTemplate(templateId)}
-        onDuplicate={async (template) => {
-          const newTemplate = { ...template, name: `${template.name} (Copy)` };
-          delete newTemplate.id;
-          await createTemplate(newTemplate);
-        }}
-        className="bg-white rounded-lg shadow"
-      />
-    </div>
-  );
-}
-
-export default function TemplatesPage() {
-  return (
-    <EmailTemplateProvider config={config}>
-      <div className="min-h-screen bg-gray-50">
-        <nav className="bg-white shadow-sm border-b">
-          <div className="container mx-auto px-6 py-4">
-            <h1 className="text-xl font-semibold text-gray-900">
-              Email Template Manager
-            </h1>
-          </div>
-        </nav>
-        <main>
-          <TemplateManager />
-        </main>
-      </div>
-    </EmailTemplateProvider>
-  );
-} 

package/examples/nextjs-example/tsconfig.json

@@ -1,28 +0,0 @@
-{
-  "compilerOptions": {
-    "lib": [
-      "dom",
-      "dom.iterable",
-      "esnext"
-    ],
-    "allowJs": true,
-    "skipLibCheck": true,
-    "strict": false,
-    "noEmit": true,
-    "incremental": true,
-    "esModuleInterop": true,
-    "module": "esnext",
-    "moduleResolution": "node",
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "jsx": "preserve"
-  },
-  "include": [
-    "next-env.d.ts",
-    "**/*.ts",
-    "**/*.tsx"
-  ],
-  "exclude": [
-    "node_modules"
-  ]
-}

package/packages/core/package.json

@@ -1,70 +0,0 @@
-{
-  "name": "@email-template-manager/core",
-  "version": "1.0.0",
-  "description": "Core email template management library - framework agnostic",
-  "main": "dist/index.js",
-  "module": "dist/index.esm.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "rollup -c",
-    "build:watch": "rollup -c -w",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
-    "lint": "eslint src --ext .ts,.tsx",
-    "lint:fix": "eslint src --ext .ts,.tsx --fix",
-    "type-check": "tsc --noEmit",
-    "clean": "rimraf dist",
-    "dev": "npm run build:watch",
-    "prepublishOnly": "npm run clean && npm run build"
-  },
-  "keywords": [
-    "email",
-    "templates",
-    "scheduling",
-    "sendgrid",
-    "notifications",
-    "typescript"
-  ],
-  "author": "Matt Bernier <matt@example.com>",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/mattbernier/email-template-manager.git",
-    "directory": "packages/core"
-  },
-  "homepage": "https://github.com/mattbernier/email-template-manager#readme",
-  "bugs": {
-    "url": "https://github.com/mattbernier/email-template-manager/issues"
-  },
-  "dependencies": {
-    "date-fns": "^2.30.0",
-    "liquidjs": "^10.9.0",
-    "zod": "^3.22.4"
-  },
-  "devDependencies": {
-    "@rollup/plugin-commonjs": "^25.0.7",
-    "@rollup/plugin-node-resolve": "^15.2.3",
-    "@rollup/plugin-typescript": "^11.1.5",
-    "@types/jest": "^29.5.8",
-    "@types/node": "^20.9.0",
-    "@typescript-eslint/eslint-plugin": "^6.11.0",
-    "@typescript-eslint/parser": "^6.11.0",
-    "eslint": "^8.54.0",
-    "jest": "^29.7.0",
-    "rimraf": "^5.0.5",
-    "rollup": "^4.5.0",
-    "ts-jest": "^29.1.1",
-    "typescript": "^5.2.2"
-  },
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}

package/packages/core/rollup.config.js

@@ -1,37 +0,0 @@
-/*
-Copyright (c) 2025 Bernier LLC
-
-This file is licensed to the client under a limited-use license.
-The client may use and modify this code *only within the scope of the project it was delivered for*.
-Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
-*/
-
-import resolve from '@rollup/plugin-node-resolve';
-import commonjs from '@rollup/plugin-commonjs';
-import typescript from '@rollup/plugin-typescript';
-
-export default {
-  input: 'src/index.ts',
-  output: [
-    {
-      file: 'dist/index.js',
-      format: 'cjs',
-      sourcemap: true,
-    },
-    {
-      file: 'dist/index.esm.js',
-      format: 'esm',
-      sourcemap: true,
-    },
-  ],
-  external: ['date-fns', 'liquidjs', 'zod'],
-  plugins: [
-    resolve(),
-    commonjs(),
-    typescript({
-      tsconfig: './tsconfig.json',
-      declaration: true,
-      declarationDir: './dist',
-    }),
-  ],
-};