strapi-plugin-magic-mail 2.2.4 → 2.2.5

package/server/src/services/email-designer.js

@@ -1,717 +0,0 @@
-/**
- * Email Designer Service
- * 
- * Handles email template creation, updates, versioning, and rendering
- * 
- * [SUCCESS] Migrated to strapi.documents() API (Strapi v5 Best Practice)
- */
-
-'use strict';
-
-const Mustache = require('mustache');
-const htmlToTextLib = require('html-to-text');
-const decode = require('decode-html');
-
-// Content Type UIDs
-const EMAIL_TEMPLATE_UID = 'plugin::magic-mail.email-template';
-const EMAIL_TEMPLATE_VERSION_UID = 'plugin::magic-mail.email-template-version';
-
-// ============================================================
-// HELPER FUNCTIONS
-// ============================================================
-
-/**
- * Safely convert HTML to plain text
- * Handles various html-to-text library versions
- */
-const convertHtmlToText = (html, options = { wordwrap: 130 }) => {
-  try {
-    if (!html || typeof html !== 'string') {
-      return '';
-    }
-    
-    if (!htmlToTextLib) {
-      return html.replace(/<[^>]*>/g, '');
-    }
-    
-    // Try different API styles
-    if (htmlToTextLib.htmlToText && typeof htmlToTextLib.htmlToText === 'function') {
-      return htmlToTextLib.htmlToText(html, options);
-    } else if (htmlToTextLib.convert && typeof htmlToTextLib.convert === 'function') {
-      return htmlToTextLib.convert(html, options);
-    } else if (typeof htmlToTextLib === 'function') {
-      return htmlToTextLib(html, options);
-    } else if (htmlToTextLib.default) {
-      if (typeof htmlToTextLib.default.htmlToText === 'function') {
-        return htmlToTextLib.default.htmlToText(html, options);
-      } else if (typeof htmlToTextLib.default.convert === 'function') {
-        return htmlToTextLib.default.convert(html, options);
-      } else if (typeof htmlToTextLib.default === 'function') {
-        return htmlToTextLib.default(html, options);
-      }
-    }
-    
-    // Fallback
-    return html.replace(/<[^>]*>/g, '');
-  } catch (error) {
-    strapi.log.error('[magic-mail] Error converting HTML to text:', error);
-    return (html || '').replace(/<[^>]*>/g, '');
-  }
-};
-
-// ============================================================
-// SERVICE
-// ============================================================
-
-module.exports = ({ strapi }) => ({
-  
-  // ============================================================
-  // TEMPLATE CRUD OPERATIONS
-  // ============================================================
-
-  /**
-   * Get all templates
-   */
-  async findAll(filters = {}) {
-    return strapi.documents(EMAIL_TEMPLATE_UID).findMany({
-      filters,
-      sort: [{ createdAt: 'desc' }],
-    });
-  },
-
-  /**
-   * Get template by ID (documentId) with populated versions
-   */
-  async findOne(documentId) {
-    return strapi.documents(EMAIL_TEMPLATE_UID).findOne({
-      documentId,
-      populate: ['versions'],
-    });
-  },
-
-  /**
-   * Get template by numeric ID (for backward compatibility)
-   */
-  async findById(id) {
-    const results = await strapi.documents(EMAIL_TEMPLATE_UID).findMany({
-      filters: { id },
-      limit: 1,
-      populate: ['versions'],
-    });
-    return results.length > 0 ? results[0] : null;
-  },
-
-  /**
-   * Get template by reference ID
-   */
-  async findByReferenceId(templateReferenceId) {
-    const results = await strapi.documents(EMAIL_TEMPLATE_UID).findMany({
-      filters: { templateReferenceId },
-      limit: 1,
-    });
-    return results.length > 0 ? results[0] : null;
-  },
-
-  /**
-   * Create new template with automatic initial version
-   */
-  async create(data) {
-    strapi.log.info('[magic-mail] [TEST] Creating new template...');
-
-    // 1. Check license limits
-    const maxTemplates = await strapi
-      .plugin('magic-mail')
-      .service('license-guard')
-      .getMaxEmailTemplates();
-
-    // Use native count() method for efficiency
-    const currentCount = await strapi.documents(EMAIL_TEMPLATE_UID).count();
-
-    if (maxTemplates !== -1 && currentCount >= maxTemplates) {
-      throw new Error(
-        `Template limit reached (${maxTemplates}). Upgrade your license to create more templates.`
-      );
-    }
-
-    // 2. Validate reference ID is unique
-    if (data.templateReferenceId) {
-      const existing = await this.findByReferenceId(data.templateReferenceId);
-      if (existing) {
-        throw new Error(`Template with reference ID ${data.templateReferenceId} already exists`);
-      }
-    }
-
-    // 3. Create template
-    const template = await strapi.documents(EMAIL_TEMPLATE_UID).create({
-      data: {
-        ...data,
-        isActive: data.isActive !== undefined ? data.isActive : true,
-      },
-    });
-
-    strapi.log.info(`[magic-mail] [SUCCESS] Template created: documentId=${template.documentId}, name="${template.name}"`);
-
-    // 4. Create initial version if versioning enabled
-    const hasVersioning = await strapi
-      .plugin('magic-mail')
-      .service('license-guard')
-      .hasFeature('email-designer-versioning');
-
-    if (hasVersioning) {
-      strapi.log.info('[magic-mail] [SAVE] Creating initial version...');
-      
-      await this.createVersion(template.documentId, {
-        name: data.name,
-        subject: data.subject,
-        design: data.design,
-        bodyHtml: data.bodyHtml,
-        bodyText: data.bodyText,
-        tags: data.tags,
-      });
-      
-      strapi.log.info('[magic-mail] [SUCCESS] Initial version created');
-    } else {
-      strapi.log.info('[magic-mail] [SKIP] Versioning not enabled, skipping initial version');
-    }
-
-    return template;
-  },
-
-  /**
-   * Update template with automatic version snapshot
-   */
-  async update(documentId, data) {
-    strapi.log.info(`[magic-mail] [UPDATE] Updating template documentId: ${documentId}`);
-    
-    // 1. Load existing template
-    const template = await this.findOne(documentId);
-    if (!template) {
-      throw new Error('Template not found');
-    }
-
-    strapi.log.info(`[magic-mail] [INFO] Found template: documentId=${template.documentId}, name="${template.name}"`);
-
-    // 2. Create version snapshot BEFORE update (if versioning enabled)
-    const hasVersioning = await strapi
-      .plugin('magic-mail')
-      .service('license-guard')
-      .hasFeature('email-designer-versioning');
-
-    if (hasVersioning) {
-      strapi.log.info('[magic-mail] [SAVE] Creating version snapshot before update...');
-      
-      await this.createVersion(template.documentId, {
-        name: template.name,
-        subject: template.subject,
-        design: template.design,
-        bodyHtml: template.bodyHtml,
-        bodyText: template.bodyText,
-        tags: template.tags,
-      });
-      
-      strapi.log.info('[magic-mail] [SUCCESS] Version snapshot created');
-    }
-
-    // 3. Update template
-    const updateData = { ...data };
-    if ('versions' in updateData) {
-      delete updateData.versions;
-      strapi.log.warn('[magic-mail] [WARNING]  Removed versions field from update data');
-    }
-    
-    const updated = await strapi.documents(EMAIL_TEMPLATE_UID).update({
-      documentId,
-      data: updateData,
-    });
-    
-    strapi.log.info(`[magic-mail] [SUCCESS] Template updated: documentId=${updated.documentId}`);
-    return updated;
-  },
-
-  /**
-   * Delete template and all its versions
-   */
-  async delete(documentId) {
-    strapi.log.info(`[magic-mail] [DELETE]  Deleting template documentId: ${documentId}`);
-    
-    const template = await this.findOne(documentId);
-      if (!template) {
-        throw new Error('Template not found');
-      }
-
-    strapi.log.info(`[magic-mail] [DELETE]  Template: documentId=${template.documentId}, name="${template.name}"`);
-
-    // Delete all versions
-    const allVersions = await strapi.documents(EMAIL_TEMPLATE_VERSION_UID).findMany({
-        filters: {
-          template: {
-            documentId: template.documentId,
-          },
-        },
-      });
-
-      strapi.log.info(`[magic-mail] [DELETE]  Found ${allVersions.length} versions to delete`);
-
-      for (const version of allVersions) {
-        try {
-        await strapi.documents(EMAIL_TEMPLATE_VERSION_UID).delete({ 
-          documentId: version.documentId 
-        });
-        strapi.log.info(`[magic-mail] [DELETE]  Deleted version #${version.versionNumber}`);
-        } catch (versionError) {
-        strapi.log.warn(`[magic-mail] [WARNING]  Failed to delete version: ${versionError.message}`);
-        }
-      }
-
-    // Delete template
-    const result = await strapi.documents(EMAIL_TEMPLATE_UID).delete({ documentId });
-      
-    strapi.log.info(`[magic-mail] [SUCCESS] Template "${template.name}" and ${allVersions.length} versions deleted`);
-      return result;
-  },
-
-  /**
-   * Duplicate template
-   */
-  async duplicate(documentId) {
-    strapi.log.info(`[magic-mail] [INFO] Duplicating template documentId: ${documentId}`);
-
-    const original = await this.findOne(documentId);
-    if (!original) {
-      throw new Error('Template not found');
-    }
-
-    strapi.log.info(`[magic-mail] [PACKAGE] Original template: documentId=${original.documentId}, name="${original.name}"`);
-
-    const duplicateData = {
-      name: `${original.name} copy`,
-      subject: original.subject,
-      design: original.design,
-      bodyHtml: original.bodyHtml,
-      bodyText: original.bodyText,
-      category: original.category,
-      tags: original.tags,
-      isActive: original.isActive,
-      templateReferenceId: Date.now() + Math.floor(Math.random() * 1000),
-    };
-
-    const duplicated = await this.create(duplicateData);
-
-    strapi.log.info(`[magic-mail] [SUCCESS] Template duplicated: documentId=${duplicated.documentId}`);
-    return duplicated;
-  },
-
-  // ============================================================
-  // VERSIONING OPERATIONS
-  // ============================================================
-
-  /**
-   * Create a new version for a template
-   */
-  async createVersion(templateDocumentId, data) {
-    strapi.log.info(`[magic-mail] [SNAPSHOT] Creating version for template documentId: ${templateDocumentId}`);
-
-    // 1. Verify template exists
-    const template = await strapi.documents(EMAIL_TEMPLATE_UID).findOne({
-      documentId: templateDocumentId,
-    });
-    if (!template) {
-      throw new Error(`Template ${templateDocumentId} not found`);
-    }
-
-    strapi.log.info(`[magic-mail] [PACKAGE] Template found: documentId=${template.documentId}, name="${template.name}"`);
-
-    // 2. Calculate next version number
-    const existingVersions = await strapi.documents(EMAIL_TEMPLATE_VERSION_UID).findMany({
-      filters: {
-        template: {
-          documentId: templateDocumentId,
-        },
-      },
-      sort: [{ versionNumber: 'desc' }],
-    });
-
-    const versionNumber = existingVersions.length > 0 
-      ? Math.max(...existingVersions.map(v => v.versionNumber || 0)) + 1
-      : 1;
-
-    strapi.log.info(`[magic-mail] [STATS] Existing versions: ${existingVersions.length} → Next version: #${versionNumber}`);
-
-    // 3. Create version WITH template relation
-    const createdVersion = await strapi.documents(EMAIL_TEMPLATE_VERSION_UID).create({
-      data: {
-        versionNumber,
-        ...data,
-        template: templateDocumentId, // Document Service handles relations with documentId
-      },
-    });
-
-    strapi.log.info(`[magic-mail] [SUCCESS] Version created: documentId=${createdVersion.documentId}, v${versionNumber}`);
-    return createdVersion;
-  },
-
-  /**
-   * Get all versions for a template
-   */
-  async getVersions(templateDocumentId) {
-    strapi.log.info(`[magic-mail] 📜 Fetching versions for template documentId: ${templateDocumentId}`);
-
-    const template = await strapi.documents(EMAIL_TEMPLATE_UID).findOne({
-      documentId: templateDocumentId,
-      populate: ['versions'],
-    });
-    
-    if (!template) {
-      throw new Error('Template not found');
-    }
-
-    strapi.log.info(`[magic-mail] [PACKAGE] Template has ${template.versions?.length || 0} versions`);
-
-    if (template.versions && template.versions.length > 0) {
-      const sortedVersions = [...template.versions].sort((a, b) => b.versionNumber - a.versionNumber);
-      return sortedVersions;
-    }
-
-    // Fallback: find via filter
-    const versions = await strapi.documents(EMAIL_TEMPLATE_VERSION_UID).findMany({
-      filters: {
-        template: {
-          documentId: templateDocumentId,
-        },
-      },
-      sort: [{ versionNumber: 'desc' }],
-    });
-
-    strapi.log.info(`[magic-mail] [SUCCESS] Found ${versions.length} versions`);
-    return versions;
-  },
-
-  /**
-   * Restore template from a specific version
-   */
-  async restoreVersion(templateDocumentId, versionDocumentId) {
-    strapi.log.info(`[magic-mail] [RESTORE] Restoring template ${templateDocumentId} from version ${versionDocumentId}`);
-
-    const version = await strapi.documents(EMAIL_TEMPLATE_VERSION_UID).findOne({
-      documentId: versionDocumentId,
-      populate: ['template'],
-    });
-
-    if (!version) {
-      throw new Error('Version not found');
-    }
-
-    // Verify version belongs to this template
-    if (version.template?.documentId !== templateDocumentId) {
-      throw new Error('Version does not belong to this template');
-    }
-
-    // Update template with version data (creates new version via update)
-    const restored = await this.update(templateDocumentId, {
-      name: version.name,
-      subject: version.subject,
-      design: version.design,
-      bodyHtml: version.bodyHtml,
-      bodyText: version.bodyText,
-      tags: version.tags,
-    });
-
-    strapi.log.info(`[magic-mail] [SUCCESS] Template restored from version #${version.versionNumber}`);
-    return restored;
-  },
-
-  /**
-   * Delete a single version
-   */
-  async deleteVersion(templateDocumentId, versionDocumentId) {
-    strapi.log.info(`[magic-mail] [DELETE]  Deleting version ${versionDocumentId}`);
-
-    const version = await strapi.documents(EMAIL_TEMPLATE_VERSION_UID).findOne({
-      documentId: versionDocumentId,
-      populate: ['template'],
-    });
-
-    if (!version) {
-      throw new Error('Version not found');
-    }
-
-    if (version.template?.documentId !== templateDocumentId) {
-        throw new Error('Version does not belong to this template');
-      }
-
-    await strapi.documents(EMAIL_TEMPLATE_VERSION_UID).delete({ 
-      documentId: versionDocumentId 
-    });
-
-    strapi.log.info(`[magic-mail] [SUCCESS] Version v${version.versionNumber} deleted`);
-    return { success: true, message: 'Version deleted' };
-  },
-
-  /**
-   * Delete all versions for a template
-   */
-  async deleteAllVersions(templateDocumentId) {
-    strapi.log.info(`[magic-mail] [DELETE]  Deleting all versions for template ${templateDocumentId}`);
-
-    const template = await strapi.documents(EMAIL_TEMPLATE_UID).findOne({
-      documentId: templateDocumentId,
-      populate: ['versions'],
-    });
-
-    if (!template) {
-      throw new Error('Template not found');
-    }
-
-    const versionCount = template.versions?.length || 0;
-    if (versionCount === 0) {
-      return { success: true, message: 'No versions to delete', deletedCount: 0 };
-    }
-
-    let deletedCount = 0;
-    for (const version of template.versions) {
-      try {
-        await strapi.documents(EMAIL_TEMPLATE_VERSION_UID).delete({ 
-          documentId: version.documentId 
-        });
-        deletedCount++;
-      } catch (error) {
-        strapi.log.error(`[magic-mail] [ERROR] Failed to delete version: ${error.message}`);
-      }
-    }
-
-    strapi.log.info(`[magic-mail] [SUCCESS] Deleted ${deletedCount}/${versionCount} versions`);
-    return { success: true, deletedCount };
-  },
-
-  // ============================================================
-  // RENDERING
-  // ============================================================
-
-  /**
-   * Render template with dynamic data using Mustache
-   */
-  async renderTemplate(templateReferenceId, data = {}) {
-    const template = await this.findByReferenceId(templateReferenceId);
-
-    if (!template) {
-      throw new Error(`Template with reference ID ${templateReferenceId} not found`);
-    }
-
-    if (!template.isActive) {
-      throw new Error(`Template ${template.name} is inactive`);
-    }
-
-    let { bodyHtml = '', bodyText = '', subject = '' } = template;
-
-    // Convert <% %> to {{ }} for Mustache
-    bodyHtml = bodyHtml.replace(/<%/g, '{{').replace(/%>/g, '}}');
-    bodyText = bodyText.replace(/<%/g, '{{').replace(/%>/g, '}}');
-    subject = subject.replace(/<%/g, '{{').replace(/%>/g, '}}');
-
-    if ((!bodyText || !bodyText.length) && bodyHtml && bodyHtml.length) {
-      bodyText = convertHtmlToText(bodyHtml, { wordwrap: 130 });
-    }
-
-    const decodedHtml = decode(bodyHtml);
-    const decodedText = decode(bodyText);
-    const decodedSubject = decode(subject);
-
-    const renderedHtml = Mustache.render(decodedHtml, data);
-    const renderedText = Mustache.render(decodedText, data);
-    const renderedSubject = Mustache.render(decodedSubject, data);
-
-    return {
-      html: renderedHtml,
-      text: renderedText,
-      subject: renderedSubject,
-      templateName: template.name,
-      category: template.category,
-    };
-  },
-
-  // ============================================================
-  // IMPORT/EXPORT
-  // ============================================================
-
-  /**
-   * Export templates as JSON
-   */
-  async exportTemplates(templateDocumentIds = []) {
-    strapi.log.info('[magic-mail] [EXPORT] Exporting templates...');
-
-    let templates;
-    if (templateDocumentIds.length > 0) {
-      templates = await strapi.documents(EMAIL_TEMPLATE_UID).findMany({
-        filters: { documentId: { $in: templateDocumentIds } },
-      });
-    } else {
-      templates = await this.findAll();
-    }
-
-    const exported = templates.map((template) => ({
-      templateReferenceId: template.templateReferenceId,
-      name: template.name,
-      subject: template.subject,
-      design: template.design,
-      bodyHtml: template.bodyHtml,
-      bodyText: template.bodyText,
-      category: template.category,
-      tags: template.tags,
-    }));
-
-    strapi.log.info(`[magic-mail] [SUCCESS] Exported ${exported.length} templates`);
-    return exported;
-  },
-
-  /**
-   * Import templates from JSON
-   */
-  async importTemplates(templates) {
-    strapi.log.info(`[magic-mail] [IMPORT] Importing ${templates.length} templates...`);
-
-    const results = [];
-
-    for (const templateData of templates) {
-      try {
-        const existing = await this.findByReferenceId(templateData.templateReferenceId);
-
-        if (existing) {
-          const updated = await this.update(existing.documentId, templateData);
-          results.push({ success: true, action: 'updated', template: updated });
-        } else {
-          const created = await this.create(templateData);
-          results.push({ success: true, action: 'created', template: created });
-        }
-      } catch (error) {
-        results.push({
-          success: false,
-          action: 'failed',
-          error: error.message,
-          templateName: templateData.name,
-        });
-      }
-    }
-
-    return results;
-  },
-
-  // ============================================================
-  // STATISTICS
-  // ============================================================
-
-  /**
-   * Get template statistics
-   */
-  async getStats() {
-    const allTemplates = await strapi.documents(EMAIL_TEMPLATE_UID).findMany({
-      fields: ['isActive', 'category'],
-    });
-    
-    const total = allTemplates.length;
-    const active = allTemplates.filter(t => t.isActive === true).length;
-
-    const categoryMap = allTemplates.reduce((acc, template) => {
-      const category = template.category || 'custom';
-      acc[category] = (acc[category] || 0) + 1;
-      return acc;
-    }, {});
-    
-    const byCategory = Object.entries(categoryMap).map(([category, count]) => ({ category, count }));
-
-    const maxTemplates = await strapi
-      .plugin('magic-mail')
-      .service('license-guard')
-      .getMaxEmailTemplates();
-
-    return {
-      total,
-      active,
-      inactive: total - active,
-      byCategory,
-      maxTemplates,
-      remaining: maxTemplates === -1 ? -1 : Math.max(0, maxTemplates - total),
-    };
-  },
-
-  // ============================================================
-  // STRAPI CORE EMAIL TEMPLATES
-  // ============================================================
-
-  /**
-   * Get Strapi core email template
-   */
-  async getCoreTemplate(coreEmailType) {
-      if (!['reset-password', 'email-confirmation'].includes(coreEmailType)) {
-        throw new Error('Invalid core email type');
-      }
-
-      const pluginStoreEmailKey =
-        coreEmailType === 'email-confirmation' ? 'email_confirmation' : 'reset_password';
-
-      const pluginStore = await strapi.store({
-        environment: '',
-        type: 'plugin',
-        name: 'users-permissions',
-      });
-
-      const emailConfig = await pluginStore.get({ key: 'email' });
-      
-      let data = null;
-      if (emailConfig && emailConfig[pluginStoreEmailKey]) {
-        data = emailConfig[pluginStoreEmailKey];
-      }
-
-    const messageConverted = data?.options?.message
-        ? data.options.message.replace(/<%|&#x3C;%/g, '{{').replace(/%>|%&#x3E;/g, '}}')
-        : '';
-      
-    const subjectConverted = data?.options?.object
-        ? data.options.object.replace(/<%|&#x3C;%/g, '{{').replace(/%>|%&#x3E;/g, '}}')
-        : '';
-
-    return {
-        from: data?.options?.from || null,
-        message: messageConverted || '',
-        subject: subjectConverted || '',
-        bodyHtml: messageConverted || '',
-        bodyText: messageConverted ? convertHtmlToText(messageConverted, { wordwrap: 130 }) : '',
-        coreEmailType,
-        design: data?.design || null,
-      };
-  },
-
-  /**
-   * Update Strapi core email template
-   */
-  async updateCoreTemplate(coreEmailType, data) {
-      if (!['reset-password', 'email-confirmation'].includes(coreEmailType)) {
-        throw new Error('Invalid core email type');
-      }
-
-      const pluginStoreEmailKey =
-        coreEmailType === 'email-confirmation' ? 'email_confirmation' : 'reset_password';
-
-      const pluginStore = await strapi.store({
-        environment: '',
-        type: 'plugin',
-        name: 'users-permissions',
-      });
-
-      const emailsConfig = await pluginStore.get({ key: 'email' });
-
-      emailsConfig[pluginStoreEmailKey] = {
-        ...emailsConfig[pluginStoreEmailKey],
-        options: {
-        ...(emailsConfig[pluginStoreEmailKey]?.options || {}),
-          message: data.message.replace(/{{/g, '<%').replace(/}}/g, '%>'),
-          object: data.subject.replace(/{{/g, '<%').replace(/}}/g, '%>'),
-        },
-        design: data.design,
-      };
-
-      await pluginStore.set({ key: 'email', value: emailsConfig });
-
-      strapi.log.info(`[magic-mail] [SUCCESS] Core email template updated: ${pluginStoreEmailKey}`);
-      return { message: 'Saved' };
-  },
-});