@bernierllc/email 1.0.0 → 1.1.0

package/dist/types.d.ts

@@ -0,0 +1,311 @@
+/**
+ * Email service configuration options
+ */
+export interface EmailServiceConfig {
+    /**
+     * Email provider configuration
+     */
+    provider: {
+        type: 'smtp' | 'sendgrid' | 'ses' | 'mailgun' | 'postmark';
+        config: Record<string, any>;
+    };
+    /**
+     * Default sender information
+     */
+    defaults?: {
+        from?: string;
+        replyTo?: string;
+        subject?: string;
+    };
+    /**
+     * Template engine configuration
+     */
+    templates?: {
+        engine: 'liquid' | 'handlebars';
+        templateDir?: string;
+        cache?: boolean;
+    };
+    /**
+     * Magic link configuration for authentication emails
+     */
+    magicLink?: {
+        secret: string;
+        expirationMinutes?: number;
+        issuer?: string;
+    };
+    /**
+     * Retry configuration for failed email delivery
+     */
+    retry?: {
+        maxRetries?: number;
+        initialDelayMs?: number;
+        maxDelayMs?: number;
+        jitter?: boolean;
+        enableMetrics?: boolean;
+    };
+    /**
+     * Rate limiting configuration
+     */
+    rateLimit?: {
+        maxEmailsPerMinute?: number;
+        maxEmailsPerHour?: number;
+    };
+}
+/**
+ * Email message structure
+ */
+export interface EmailMessage {
+    to: string | string[];
+    from?: string;
+    replyTo?: string;
+    subject: string;
+    text?: string;
+    html?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    attachments?: EmailAttachment[];
+    templateData?: Record<string, any>;
+    priority?: EmailPriority;
+    tags?: string[];
+    metadata?: Record<string, any>;
+}
+/**
+ * Email template message with template rendering
+ */
+export interface TemplateEmailMessage extends Omit<EmailMessage, 'text' | 'html'> {
+    template: string;
+    templateData: Record<string, any>;
+    engine?: 'liquid' | 'handlebars';
+}
+/**
+ * Magic link email configuration
+ */
+export interface MagicLinkEmail extends Omit<EmailMessage, 'text' | 'html'> {
+    recipient: string;
+    purpose: string;
+    redirectUrl: string;
+    template?: string;
+    customData?: Record<string, any>;
+    expirationMinutes?: number;
+}
+/**
+ * Email attachment structure
+ */
+export interface EmailAttachment {
+    filename: string;
+    content: Buffer | string;
+    contentType?: string;
+    encoding?: string;
+    cid?: string;
+}
+/**
+ * Email priority levels
+ */
+export declare enum EmailPriority {
+    LOW = "low",
+    NORMAL = "normal",
+    HIGH = "high",
+    URGENT = "urgent"
+}
+/**
+ * Email sending result
+ */
+export interface EmailResult {
+    success: boolean;
+    messageId?: string;
+    error?: string;
+    provider?: string;
+    timestamp: Date;
+    retryCount?: number;
+    deliveryTime?: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * Bulk email operation result
+ */
+export interface BulkEmailResult {
+    totalEmails: number;
+    successful: number;
+    failed: number;
+    results: EmailResult[];
+    errors: string[];
+    summary: {
+        successRate: number;
+        averageDeliveryTime: number;
+        totalRetries: number;
+    };
+}
+/**
+ * Magic link generation result
+ */
+export interface MagicLinkResult {
+    success: boolean;
+    magicLink?: string;
+    token?: string;
+    expiresAt?: Date;
+    error?: string;
+    emailResult?: EmailResult;
+}
+/**
+ * Email delivery status
+ */
+export declare enum DeliveryStatus {
+    PENDING = "pending",
+    SENT = "sent",
+    DELIVERED = "delivered",
+    FAILED = "failed",
+    BOUNCED = "bounced",
+    COMPLAINED = "complained"
+}
+/**
+ * Email delivery tracking
+ */
+export interface EmailDeliveryInfo {
+    messageId: string;
+    status: DeliveryStatus;
+    timestamp: Date;
+    recipient: string;
+    subject: string;
+    provider: string;
+    retryCount: number;
+    error?: string;
+    events: DeliveryEvent[];
+}
+/**
+ * Email delivery event
+ */
+export interface DeliveryEvent {
+    event: string;
+    timestamp: Date;
+    description?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Email service metrics
+ */
+export interface EmailMetrics {
+    totalSent: number;
+    totalDelivered: number;
+    totalFailed: number;
+    successRate: number;
+    averageDeliveryTime: number;
+    retryRate: number;
+    bounceRate: number;
+    complaintRate: number;
+    providerStats: Record<string, ProviderMetrics>;
+}
+/**
+ * Provider-specific metrics
+ */
+export interface ProviderMetrics {
+    sent: number;
+    delivered: number;
+    failed: number;
+    averageDeliveryTime: number;
+    errorTypes: Record<string, number>;
+}
+/**
+ * Template validation result
+ */
+export interface TemplateValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+    requiredVariables: string[];
+    optionalVariables: string[];
+}
+/**
+ * Email queue configuration
+ */
+export interface EmailQueueConfig {
+    maxConcurrency?: number;
+    batchSize?: number;
+    retryDelay?: number;
+    priorityLevels?: boolean;
+}
+/**
+ * Scheduled email configuration
+ */
+export interface ScheduledEmail extends EmailMessage {
+    scheduledFor: Date;
+    timezone?: string;
+    recurring?: {
+        pattern: 'daily' | 'weekly' | 'monthly';
+        interval?: number;
+        endDate?: Date;
+    };
+}
+/**
+ * Email campaign configuration
+ */
+export interface EmailCampaign {
+    name: string;
+    description?: string;
+    template: string;
+    recipients: CampaignRecipient[];
+    schedule?: {
+        startTime: Date;
+        timezone?: string;
+        batchSize?: number;
+        delayBetweenBatches?: number;
+    };
+    tracking?: {
+        trackOpens?: boolean;
+        trackClicks?: boolean;
+        trackUnsubscribes?: boolean;
+    };
+    metadata?: Record<string, any>;
+}
+/**
+ * Campaign recipient with personalization data
+ */
+export interface CampaignRecipient {
+    email: string;
+    name?: string;
+    personalData?: Record<string, any>;
+    subscriptionStatus?: 'subscribed' | 'unsubscribed' | 'bounced';
+}
+/**
+ * Email service interface
+ */
+export interface IEmailService {
+    /**
+     * Send a single email
+     */
+    send(message: EmailMessage): Promise<EmailResult>;
+    /**
+     * Send an email using a template
+     */
+    sendTemplate(message: TemplateEmailMessage): Promise<EmailResult>;
+    /**
+     * Send a magic link email
+     */
+    sendMagicLink(config: MagicLinkEmail): Promise<MagicLinkResult>;
+    /**
+     * Send multiple emails
+     */
+    sendBulk(messages: EmailMessage[]): Promise<BulkEmailResult>;
+    /**
+     * Validate an email template
+     */
+    validateTemplate(template: string, engine?: 'liquid' | 'handlebars'): Promise<TemplateValidationResult>;
+    /**
+     * Get email delivery metrics
+     */
+    getMetrics(timeRange?: {
+        start: Date;
+        end: Date;
+    }): Promise<EmailMetrics>;
+    /**
+     * Track email delivery status
+     */
+    getDeliveryStatus(messageId: string): Promise<EmailDeliveryInfo | null>;
+    /**
+     * Test email configuration
+     */
+    testConfiguration(): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,33 @@
+"use strict";
+/*
+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.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryStatus = exports.EmailPriority = void 0;
+/**
+ * Email priority levels
+ */
+var EmailPriority;
+(function (EmailPriority) {
+    EmailPriority["LOW"] = "low";
+    EmailPriority["NORMAL"] = "normal";
+    EmailPriority["HIGH"] = "high";
+    EmailPriority["URGENT"] = "urgent";
+})(EmailPriority || (exports.EmailPriority = EmailPriority = {}));
+/**
+ * Email delivery status
+ */
+var DeliveryStatus;
+(function (DeliveryStatus) {
+    DeliveryStatus["PENDING"] = "pending";
+    DeliveryStatus["SENT"] = "sent";
+    DeliveryStatus["DELIVERED"] = "delivered";
+    DeliveryStatus["FAILED"] = "failed";
+    DeliveryStatus["BOUNCED"] = "bounced";
+    DeliveryStatus["COMPLAINED"] = "complained";
+})(DeliveryStatus || (exports.DeliveryStatus = DeliveryStatus = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAgHF;;GAEG;AACH,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,4BAAW,CAAA;IACX,kCAAiB,CAAA;IACjB,8BAAa,CAAA;IACb,kCAAiB,CAAA;AACnB,CAAC,EALW,aAAa,6BAAb,aAAa,QAKxB;AA4CD;;GAEG;AACH,IAAY,cAOX;AAPD,WAAY,cAAc;IACxB,qCAAmB,CAAA;IACnB,+BAAa,CAAA;IACb,yCAAuB,CAAA;IACvB,mCAAiB,CAAA;IACjB,qCAAmB,CAAA;IACnB,2CAAyB,CAAA;AAC3B,CAAC,EAPW,cAAc,8BAAd,cAAc,QAOzB"}

package/package.json

@@ -1,32 +1,63 @@
 {
   "name": "@bernierllc/email",
-  "version": "1.0.0",
-  "description": "A package for email functionality in the tools monorepo.",
-  "main": "src/index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "keywords": [],
+  "version": "1.1.0",
+  "deprecated": "This package is deprecated. Please use @bernierllc/email-service instead. See https://github.com/BernierLLC/tools/blob/main/packages/service/email-service/MIGRATION.md for migration guide.",
+  "description": "A comprehensive email service that orchestrates sending, templates, authentication, and retry logic",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "keywords": [
+    "email",
+    "service",
+    "templates",
+    "authentication",
+    "magic-link",
+    "retry",
+    "reliability",
+    "orchestration",
+    "typescript"
+  ],
   "author": "Bernier LLC",
-  "license": "ISC",
+  "license": "Bernier LLC",
   "repository": {
     "type": "git",
-    "url": "https://github.com/bernier-llc/tools"
+    "url": "https://github.com/bernierllc/tools.git",
+    "directory": "packages/service/email"
   },
-  "type": "commonjs",
-  "peerDependencies": {},
-  "devDependencies": {
-    "@changesets/cli": "^2.27.1",
-    "lint-staged": "^15.1.0",
-    "prettier": "^3.1.0"
+  "dependencies": {
+    "@bernierllc/email-sender": "^0.2.4",
+    "@bernierllc/email-parser": "^0.1.1",
+    "@bernierllc/email-validator": "^1.0.3",
+    "@bernierllc/crypto-utils": "^1.0.2",
+    "@bernierllc/retry-policy": "^0.1.1",
+    "@bernierllc/retry-state": "^0.1.1",
+    "@bernierllc/retry-metrics": "^0.1.1"
   },
-  "lint-staged": {
-    "*.{js,jsx,ts,tsx,json,css,md}": [
-      "prettier --write"
-    ]
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.19",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
   },
   "engines": {
-    "node": ">=16.0.0",
-    "npm": ">=8.0.0"
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "clean": "rm -rf dist",
+    "prebuild": "npm run clean"
   }
-} 
+}

package/.eslintrc.json

@@ -1,112 +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.
-//
-{
-  "extends": [
-    "plugin:react/recommended",
-    "plugin:react-hooks/recommended",
-    "plugin:jsx-a11y/recommended",
-    "plugin:@typescript-eslint/recommended"
-  ],
-  "plugins": [
-    "react",
-    "react-hooks",
-    "jsx-a11y",
-    "@typescript-eslint"
-  ],
-  "rules": {
-    "no-object-rendering": "error",
-    "react/jsx-no-undef": "error",
-    "react/jsx-uses-react": "error",
-    "react/jsx-uses-vars": "error",
-    "react/no-unescaped-entities": "error",
-    "react/no-unknown-property": "error",
-    "react/self-closing-comp": "error",
-    "react/jsx-key": "error",
-    "react/jsx-no-duplicate-props": "error",
-    "react/jsx-no-target-blank": "error",
-    "react/jsx-pascal-case": "error",
-    "react/jsx-wrap-multilines": "error",
-    "react/jsx-curly-brace-presence": ["error", { "props": "never", "children": "never" }],
-    "@typescript-eslint/no-unused-vars": "error",
-    "@typescript-eslint/no-explicit-any": "warn",
-    "@typescript-eslint/explicit-function-return-type": "off",
-    "@typescript-eslint/explicit-module-boundary-types": "off",
-    "@typescript-eslint/no-non-null-assertion": "warn",
-    "react-hooks/rules-of-hooks": "error",
-    "react-hooks/exhaustive-deps": "warn",
-    "jsx-a11y/alt-text": "error",
-    "jsx-a11y/anchor-has-content": "error",
-    "jsx-a11y/anchor-is-valid": "error",
-    "jsx-a11y/aria-props": "error",
-    "jsx-a11y/aria-proptypes": "error",
-    "jsx-a11y/aria-unsupported-elements": "error",
-    "jsx-a11y/heading-has-content": "error",
-    "jsx-a11y/iframe-has-title": "error",
-    "jsx-a11y/img-redundant-alt": "error",
-    "jsx-a11y/no-access-key": "error",
-    "jsx-a11y/no-distracting-elements": "error",
-    "jsx-a11y/no-redundant-roles": "error",
-    "jsx-a11y/role-has-required-aria-props": "error",
-    "jsx-a11y/role-supports-aria-props": "error",
-    "jsx-a11y/scope": "error",
-    "jsx-a11y/label-has-associated-control": "error",
-    "jsx-a11y/control-has-associated-label": "error",
-    "jsx-a11y/click-events-have-key-events": "error",
-    "jsx-a11y/no-static-element-interactions": "error",
-    "jsx-a11y/interactive-supports-focus": "error",
-    "jsx-a11y/no-noninteractive-element-interactions": "error",
-    "jsx-a11y/no-noninteractive-tabindex": "error",
-    "jsx-a11y/tabindex-no-positive": "error",
-    "jsx-a11y/no-noninteractive-element-to-interactive-role": "error",
-    "jsx-a11y/media-has-caption": "error",
-    "jsx-a11y/no-autofocus": "error",
-    "no-console": "warn",
-    "no-debugger": "error",
-    "no-unused-vars": "off",
-    "prefer-const": "error",
-    "no-var": "error"
-  },
-  "settings": {
-    "react": {
-      "version": "detect"
-    }
-  },
-  "overrides": [
-    {
-      "files": ["**/*.ts", "**/*.tsx"],
-      "rules": {
-        "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
-        "@typescript-eslint/explicit-function-return-type": "off"
-      }
-    },
-    {
-      "files": ["**/forms/**/*.tsx", "**/*Form*.tsx", "**/*form*.tsx"],
-      "rules": {
-        "jsx-a11y/label-has-associated-control": "error",
-        "jsx-a11y/control-has-associated-label": "error",
-        "jsx-a11y/no-autofocus": "error"
-      }
-    },
-    {
-      "files": ["**/navigation/**/*.tsx", "**/*Nav*.tsx", "**/*nav*.tsx"],
-      "rules": {
-        "jsx-a11y/click-events-have-key-events": "error",
-        "jsx-a11y/no-static-element-interactions": "error",
-        "jsx-a11y/interactive-supports-focus": "error"
-      }
-    },
-    {
-      "files": ["**/modal/**/*.tsx", "**/*Modal*.tsx", "**/*modal*.tsx", "**/*Dialog*.tsx", "**/*dialog*.tsx"],
-      "rules": {
-        "jsx-a11y/no-autofocus": "error",
-        "jsx-a11y/click-events-have-key-events": "error",
-        "jsx-a11y/no-static-element-interactions": "error"
-      }
-    }
-  ]
-} 

package/.flake8

@@ -1,18 +0,0 @@
-[flake8]
-# Disable checks for:
-# E501: line too long
-# E201/E202: whitespace after/before '(', '[', or '{'
-# E203: whitespace before ':'
-# E211: whitespace before '('
-# E221/E222/E223/E224/E225/E226/E227/E228: multiple spacing errors
-# E231/E241/E242: missing or extra whitespace after/before comma
-# E261/E262: spaces before inline comment
-# E301/E302/E303/E304: blank line related
-# W291/W292/W293: trailing whitespace and newline issues
-# W391: blank line at end of file
-# Add more codes as needed
-
-ignore = E201,E202,E203,E211,E221,E222,E223,E224,E225,E226,E227,E228,E231,E241,E242,E261,E262,E301,E302,E303,E304,E501,W291,W292,W293,W391
-
-# Optionally, you can also raise the line length limit to avoid triggering it in other tools
-max-line-length = 999