strapi-plugin-magic-mail 1.0.1

package/server/src/content-types/email-event/schema.json

@@ -0,0 +1,57 @@
+{
+  "kind": "collectionType",
+  "collectionName": "magic_mail_email_events",
+  "info": {
+    "singularName": "email-event",
+    "pluralName": "email-events",
+    "displayName": "Email Event",
+    "description": "Individual email tracking events (opens, clicks, bounces)"
+  },
+  "options": {
+    "draftAndPublish": false
+  },
+  "pluginOptions": {
+    "content-manager": {
+      "visible": false
+    },
+    "content-type-builder": {
+      "visible": false
+    }
+  },
+  "attributes": {
+    "emailLog": {
+      "type": "relation",
+      "relation": "manyToOne",
+      "target": "plugin::magic-mail.email-log",
+      "inversedBy": "events"
+    },
+    "type": {
+      "type": "enumeration",
+      "enum": ["open", "click", "bounce", "complaint", "unsubscribe"],
+      "required": true
+    },
+    "timestamp": {
+      "type": "datetime",
+      "required": true
+    },
+    "ipAddress": {
+      "type": "string"
+    },
+    "userAgent": {
+      "type": "text"
+    },
+    "location": {
+      "type": "json"
+    },
+    "linkUrl": {
+      "type": "text"
+    },
+    "linkText": {
+      "type": "string"
+    },
+    "metadata": {
+      "type": "json"
+    }
+  }
+}
+

package/server/src/content-types/email-link/index.js

@@ -0,0 +1,8 @@
+'use strict';
+
+const schema = require('./schema.json');
+
+module.exports = {
+  schema,
+};
+

package/server/src/content-types/email-link/schema.json

@@ -0,0 +1,49 @@
+{
+  "kind": "collectionType",
+  "collectionName": "magic_mail_email_links",
+  "info": {
+    "singularName": "email-link",
+    "pluralName": "email-links",
+    "displayName": "Email Link",
+    "description": "Stores click tracking links for emails"
+  },
+  "options": {
+    "draftAndPublish": false
+  },
+  "pluginOptions": {
+    "content-manager": {
+      "visible": false
+    },
+    "content-type-builder": {
+      "visible": false
+    }
+  },
+  "attributes": {
+    "emailLog": {
+      "type": "relation",
+      "relation": "manyToOne",
+      "target": "plugin::magic-mail.email-log",
+      "inversedBy": "links"
+    },
+    "linkHash": {
+      "type": "string",
+      "required": true,
+      "unique": false
+    },
+    "originalUrl": {
+      "type": "text",
+      "required": true
+    },
+    "clickCount": {
+      "type": "integer",
+      "default": 0
+    },
+    "firstClickedAt": {
+      "type": "datetime"
+    },
+    "lastClickedAt": {
+      "type": "datetime"
+    }
+  }
+}
+

package/server/src/content-types/email-log/index.js

@@ -0,0 +1,8 @@
+'use strict';
+
+const schema = require('./schema.json');
+
+module.exports = {
+  schema,
+};
+

package/server/src/content-types/email-log/schema.json

@@ -0,0 +1,106 @@
+{
+  "kind": "collectionType",
+  "collectionName": "magic_mail_email_logs",
+  "info": {
+    "singularName": "email-log",
+    "pluralName": "email-logs",
+    "displayName": "Email Log",
+    "description": "Tracks all sent emails with user association"
+  },
+  "options": {
+    "draftAndPublish": false
+  },
+  "pluginOptions": {
+    "content-manager": {
+      "visible": false
+    },
+    "content-type-builder": {
+      "visible": false
+    }
+  },
+  "attributes": {
+    "emailId": {
+      "type": "string",
+      "required": true,
+      "unique": true
+    },
+    "user": {
+      "type": "relation",
+      "relation": "manyToOne",
+      "target": "plugin::users-permissions.user"
+    },
+    "recipient": {
+      "type": "email",
+      "required": true
+    },
+    "recipientName": {
+      "type": "string"
+    },
+    "subject": {
+      "type": "string",
+      "required": true
+    },
+    "templateId": {
+      "type": "integer"
+    },
+    "templateName": {
+      "type": "string"
+    },
+    "accountId": {
+      "type": "integer"
+    },
+    "accountName": {
+      "type": "string"
+    },
+    "sentAt": {
+      "type": "datetime",
+      "required": true
+    },
+    "deliveredAt": {
+      "type": "datetime"
+    },
+    "firstOpenedAt": {
+      "type": "datetime"
+    },
+    "lastOpenedAt": {
+      "type": "datetime"
+    },
+    "openCount": {
+      "type": "integer",
+      "default": 0
+    },
+    "clickCount": {
+      "type": "integer",
+      "default": 0
+    },
+    "bounced": {
+      "type": "boolean",
+      "default": false
+    },
+    "bounceReason": {
+      "type": "text"
+    },
+    "unsubscribed": {
+      "type": "boolean",
+      "default": false
+    },
+    "unsubscribedAt": {
+      "type": "datetime"
+    },
+    "metadata": {
+      "type": "json"
+    },
+    "events": {
+      "type": "relation",
+      "relation": "oneToMany",
+      "target": "plugin::magic-mail.email-event",
+      "mappedBy": "emailLog"
+    },
+    "links": {
+      "type": "relation",
+      "relation": "oneToMany",
+      "target": "plugin::magic-mail.email-link",
+      "mappedBy": "emailLog"
+    }
+  }
+}

package/server/src/content-types/email-template/schema.json

@@ -0,0 +1,74 @@
+{
+  "kind": "collectionType",
+  "collectionName": "magic_mail_email_templates",
+  "info": {
+    "singularName": "email-template",
+    "pluralName": "email-templates",
+    "displayName": "Email Template",
+    "description": "Email templates created with the visual designer"
+  },
+  "options": {
+    "draftAndPublish": false,
+    "timestamps": true
+  },
+  "pluginOptions": {
+    "content-manager": {
+      "visible": false
+    },
+    "content-type-builder": {
+      "visible": false
+    }
+  },
+  "attributes": {
+    "templateReferenceId": {
+      "type": "integer",
+      "required": true,
+      "unique": true,
+      "configurable": false
+    },
+    "name": {
+      "type": "string",
+      "required": true,
+      "configurable": false
+    },
+    "subject": {
+      "type": "string",
+      "required": true,
+      "configurable": false
+    },
+    "design": {
+      "type": "json",
+      "configurable": false
+    },
+    "bodyHtml": {
+      "type": "text",
+      "configurable": false
+    },
+    "bodyText": {
+      "type": "text",
+      "configurable": false
+    },
+    "category": {
+      "type": "enumeration",
+      "enum": ["transactional", "marketing", "notification", "custom"],
+      "default": "custom",
+      "configurable": false
+    },
+    "isActive": {
+      "type": "boolean",
+      "default": true,
+      "configurable": false
+    },
+    "tags": {
+      "type": "json",
+      "configurable": false
+    },
+    "versions": {
+      "type": "relation",
+      "relation": "oneToMany",
+      "target": "plugin::magic-mail.email-template-version",
+      "mappedBy": "template"
+    }
+  }
+}
+

package/server/src/content-types/email-template-version/schema.json

@@ -0,0 +1,60 @@
+{
+  "kind": "collectionType",
+  "collectionName": "magic_mail_email_template_versions",
+  "info": {
+    "singularName": "email-template-version",
+    "pluralName": "email-template-versions",
+    "displayName": "Email Template Version",
+    "description": "Version history for email templates"
+  },
+  "options": {
+    "draftAndPublish": false,
+    "timestamps": true
+  },
+  "pluginOptions": {
+    "content-manager": {
+      "visible": false
+    },
+    "content-type-builder": {
+      "visible": false
+    }
+  },
+  "attributes": {
+    "template": {
+      "type": "relation",
+      "relation": "manyToOne",
+      "target": "plugin::magic-mail.email-template",
+      "inversedBy": "versions"
+    },
+    "versionNumber": {
+      "type": "integer",
+      "required": true,
+      "configurable": false
+    },
+    "name": {
+      "type": "string",
+      "configurable": false
+    },
+    "subject": {
+      "type": "string",
+      "configurable": false
+    },
+    "design": {
+      "type": "json",
+      "configurable": false
+    },
+    "bodyHtml": {
+      "type": "text",
+      "configurable": false
+    },
+    "bodyText": {
+      "type": "text",
+      "configurable": false
+    },
+    "tags": {
+      "type": "json",
+      "configurable": false
+    }
+  }
+}
+

package/server/src/content-types/index.js

@@ -0,0 +1,33 @@
+'use strict';
+
+const emailAccount = require('./email-account/schema.json');
+const routingRule = require('./routing-rule/schema.json');
+const emailLog = require('./email-log/schema.json');
+const emailEvent = require('./email-event/schema.json');
+const emailLink = require('./email-link/schema.json');
+const emailTemplate = require('./email-template/schema.json');
+const emailTemplateVersion = require('./email-template-version/schema.json');
+
+module.exports = {
+  'email-account': {
+    schema: emailAccount,
+  },
+  'routing-rule': {
+    schema: routingRule,
+  },
+  'email-log': {
+    schema: emailLog,
+  },
+  'email-event': {
+    schema: emailEvent,
+  },
+  'email-link': {
+    schema: emailLink,
+  },
+  'email-template': {
+    schema: emailTemplate,
+  },
+  'email-template-version': {
+    schema: emailTemplateVersion,
+  },
+};

package/server/src/content-types/routing-rule/schema.json

@@ -0,0 +1,59 @@
+{
+  "kind": "collectionType",
+  "collectionName": "magic_mail_routing_rules",
+  "info": {
+    "singularName": "routing-rule",
+    "pluralName": "routing-rules",
+    "displayName": "Email Routing Rule",
+    "description": "Rules for routing emails to specific accounts"
+  },
+  "options": {
+    "draftAndPublish": false
+  },
+  "pluginOptions": {
+    "content-manager": {
+      "visible": false
+    },
+    "content-type-builder": {
+      "visible": false
+    }
+  },
+  "attributes": {
+    "name": {
+      "type": "string",
+      "required": true,
+      "unique": true
+    },
+    "description": {
+      "type": "text"
+    },
+    "isActive": {
+      "type": "boolean",
+      "default": true,
+      "required": true
+    },
+    "priority": {
+      "type": "integer",
+      "default": 1,
+      "min": 1
+    },
+    "matchType": {
+      "type": "enumeration",
+      "enum": ["emailType", "subject", "recipient", "template", "custom"],
+      "required": true,
+      "default": "emailType"
+    },
+    "matchValue": {
+      "type": "text",
+      "required": true
+    },
+    "accountName": {
+      "type": "string",
+      "required": true
+    },
+    "fallbackAccountName": {
+      "type": "string"
+    }
+  }
+}
+

package/server/src/controllers/accounts.js

@@ -0,0 +1,220 @@
+'use strict';
+
+/**
+ * Accounts Controller
+ * Manages email accounts CRUD operations
+ */
+
+module.exports = {
+  /**
+   * Get all email accounts
+   */
+  async getAll(ctx) {
+    try {
+      const accountManager = strapi.plugin('magic-mail').service('account-manager');
+      const accounts = await accountManager.getAllAccounts();
+
+      ctx.body = {
+        data: accounts,
+        meta: { count: accounts.length },
+      };
+    } catch (err) {
+      strapi.log.error('[magic-mail] Error getting accounts:', err);
+      ctx.throw(500, 'Error fetching email accounts');
+    }
+  },
+
+  /**
+   * Create new email account
+   */
+  async create(ctx) {
+    try {
+      const licenseGuard = strapi.plugin('magic-mail').service('license-guard');
+      const accountData = ctx.request.body;
+
+      // Check if provider is allowed by license
+      const providerAllowed = await licenseGuard.isProviderAllowed(accountData.provider);
+      if (!providerAllowed) {
+        ctx.throw(403, `Provider "${accountData.provider}" requires a Premium license or higher. Please upgrade your license.`);
+        return;
+      }
+
+      // Check account limit
+      const currentAccounts = await strapi.entityService.count('plugin::magic-mail.email-account');
+      const maxAccounts = await licenseGuard.getMaxAccounts();
+      
+      if (maxAccounts !== -1 && currentAccounts >= maxAccounts) {
+        ctx.throw(403, `Account limit reached (${maxAccounts}). Upgrade your license to add more accounts.`);
+        return;
+      }
+
+      const accountManager = strapi.plugin('magic-mail').service('account-manager');
+      const account = await accountManager.createAccount(accountData);
+
+      ctx.body = {
+        data: account,
+        message: 'Email account created successfully',
+      };
+    } catch (err) {
+      strapi.log.error('[magic-mail] Error creating account:', err);
+      ctx.throw(err.status || 500, err.message || 'Error creating email account');
+    }
+  },
+
+  /**
+   * Get single account with decrypted config (for editing)
+   */
+  async getOne(ctx) {
+    try {
+      const { accountId } = ctx.params;
+      const accountManager = strapi.plugin('magic-mail').service('account-manager');
+      const account = await accountManager.getAccountWithDecryptedConfig(accountId);
+
+      ctx.body = {
+        data: account,
+      };
+    } catch (err) {
+      strapi.log.error('[magic-mail] Error getting account:', err);
+      ctx.throw(500, 'Error fetching email account');
+    }
+  },
+
+  /**
+   * Update email account
+   */
+  async update(ctx) {
+    try {
+      const { accountId } = ctx.params;
+      const accountManager = strapi.plugin('magic-mail').service('account-manager');
+      const account = await accountManager.updateAccount(accountId, ctx.request.body);
+
+      ctx.body = {
+        data: account,
+        message: 'Email account updated successfully',
+      };
+    } catch (err) {
+      strapi.log.error('[magic-mail] Error updating account:', err);
+      ctx.throw(500, err.message || 'Error updating email account');
+    }
+  },
+
+  /**
+   * Test email account
+   */
+  async test(ctx) {
+    try {
+      const { accountId } = ctx.params;
+      const { testEmail, priority, type, unsubscribeUrl } = ctx.request.body;
+      
+      const testOptions = {
+        priority: priority || 'normal',
+        type: type || 'transactional',
+        unsubscribeUrl: unsubscribeUrl || null,
+      };
+      
+      const accountManager = strapi.plugin('magic-mail').service('account-manager');
+      const result = await accountManager.testAccount(accountId, testEmail, testOptions);
+
+      ctx.body = result;
+    } catch (err) {
+      strapi.log.error('[magic-mail] Error testing account:', err);
+      ctx.throw(500, 'Error testing email account');
+    }
+  },
+
+  /**
+   * Test Strapi Email Service Integration
+   * Tests if MagicMail intercepts native Strapi email service
+   */
+  async testStrapiService(ctx) {
+    try {
+      const { testEmail, accountName } = ctx.request.body;
+
+      if (!testEmail) {
+        ctx.throw(400, 'testEmail is required');
+      }
+
+      strapi.log.info('[magic-mail] 🧪 Testing Strapi Email Service integration...');
+      strapi.log.info('[magic-mail] 📧 Calling strapi.plugin("email").service("email").send()');
+      if (accountName) {
+        strapi.log.info(`[magic-mail] 🎯 Forcing specific account: ${accountName}`);
+      }
+
+      // Call native Strapi email service - should be intercepted by MagicMail!
+      const result = await strapi.plugin('email').service('email').send({
+        to: testEmail,
+        from: 'test@magicmail.com',
+        subject: 'MagicMail Integration Test',
+        text: 'This email was sent using Strapi\'s native email service but routed through MagicMail!',
+        html: `
+          <div style="font-family: Arial, sans-serif; max-width: 600px; margin: 0 auto; padding: 20px;">
+            <h1 style="color: #0EA5E9;">MagicMail Integration Test</h1>
+            <p style="font-size: 16px; color: #374151;">
+              This email was sent using <strong>Strapi's native email service</strong> 
+              but <strong>routed through MagicMail's smart routing</strong>!
+            </p>
+            <div style="background: #F0F9FF; border-left: 4px solid #0EA5E9; padding: 15px; margin: 20px 0;">
+              <h3 style="margin-top: 0; color: #0369A1;">Integration Working</h3>
+              <p style="margin: 0;">
+                MagicMail successfully intercepted the email and applied:
+              </p>
+              <ul style="margin: 10px 0;">
+                <li>Smart routing rules</li>
+                <li>Account selection (${accountName ? 'Forced: ' + accountName : 'Primary or by routing rules'})</li>
+                <li>Rate limiting</li>
+                <li>Email logging</li>
+                <li>Statistics tracking</li>
+              </ul>
+            </div>
+            <p style="color: #6B7280; font-size: 14px; margin-top: 30px;">
+              Sent at: ${new Date().toLocaleString()}<br>
+              Via: MagicMail Email Router
+            </p>
+          </div>
+        `,
+        type: 'transactional',
+        accountName: accountName || null, // Force specific account if provided
+      });
+
+      strapi.log.info('[magic-mail] ✅ Strapi Email Service test completed');
+
+      ctx.body = {
+        success: true,
+        message: 'Email sent via Strapi Email Service (intercepted by MagicMail)',
+        result,
+        info: {
+          method: 'strapi.plugin("email").service("email").send()',
+          intercepted: true,
+          routedThrough: 'MagicMail',
+        },
+      };
+    } catch (err) {
+      strapi.log.error('[magic-mail] ❌ Strapi Email Service test failed:', err);
+      ctx.body = {
+        success: false,
+        message: 'Failed to send test email',
+        error: err.message,
+      };
+      ctx.status = 500;
+    }
+  },
+
+  /**
+   * Delete email account
+   */
+  async delete(ctx) {
+    try {
+      const { accountId } = ctx.params;
+      const accountManager = strapi.plugin('magic-mail').service('account-manager');
+      await accountManager.deleteAccount(accountId);
+
+      ctx.body = {
+        message: 'Email account deleted successfully',
+      };
+    } catch (err) {
+      strapi.log.error('[magic-mail] Error deleting account:', err);
+      ctx.throw(500, 'Error deleting email account');
+    }
+  },
+};
+