@bernierllc/email-sendgrid-plugin 1.4.5 → 1.7.0

package/__tests__/converters/template-converter.test.ts

@@ -1,230 +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 { TemplateConverter } from '../../src/converters/template-converter';
-import { PrefixEnforcer } from '../../src/safety/prefix-enforcer';
-import { SendGridTemplateData, SendGridTemplateVersion } from '../../src/types/sendgrid-types';
-
-describe('TemplateConverter', () => {
-  let converter: TemplateConverter;
-  let prefixEnforcer: PrefixEnforcer;
-
-  beforeEach(() => {
-    prefixEnforcer = new PrefixEnforcer('MyApp - ');
-    converter = new TemplateConverter(prefixEnforcer);
-  });
-
-  describe('convertToProviderTemplate', () => {
-    it('should convert SendGrid template to provider template', () => {
-      const activeVersion: SendGridTemplateVersion = {
-        id: 'ver-123',
-        template_id: 'template-123',
-        active: 1,
-        name: 'v1.0.0',
-        html_content: '<html>Hello {{name}}</html>',
-        plain_content: 'Hello {{name}}',
-        subject: 'Welcome {{name}}',
-        updated_at: '2024-01-01T00:00:00Z',
-        editor: 'code'
-      };
-
-      const sendgridData: SendGridTemplateData = {
-        id: 'template-123',
-        name: 'MyApp - Welcome Email',
-        generation: 'dynamic',
-        updated_at: '2024-01-01T00:00:00Z',
-        versions: [activeVersion]
-      };
-
-      const result = converter.convertToProviderTemplate(sendgridData, activeVersion);
-
-      expect(result).toEqual({
-        id: 'template-123',
-        name: 'Welcome Email',
-        subject: 'Welcome {{name}}',
-        htmlContent: '<html>Hello {{name}}</html>',
-        textContent: 'Hello {{name}}',
-        version: 'v1.0.0',
-        active: true,
-        createdAt: expect.any(Date),
-        updatedAt: expect.any(Date)
-      });
-    });
-
-    it('should handle template without active version', () => {
-      const sendgridData: SendGridTemplateData = {
-        id: 'template-456',
-        name: 'MyApp - Test',
-        generation: 'dynamic',
-        updated_at: '2024-01-01T00:00:00Z',
-        versions: []
-      };
-
-      const result = converter.convertToProviderTemplate(sendgridData);
-
-      expect(result.subject).toBe('');
-      expect(result.htmlContent).toBe('');
-      expect(result.version).toBe('1.0.0');
-    });
-
-    it('should find active version automatically', () => {
-      const versions: SendGridTemplateVersion[] = [
-        {
-          id: 'ver-1',
-          template_id: 'template-123',
-          active: 0,
-          name: 'v1.0.0',
-          html_content: '<html>Old</html>',
-          plain_content: 'Old',
-          subject: 'Old',
-          updated_at: '2024-01-01T00:00:00Z',
-          editor: 'code'
-        },
-        {
-          id: 'ver-2',
-          template_id: 'template-123',
-          active: 1,
-          name: 'v2.0.0',
-          html_content: '<html>New</html>',
-          plain_content: 'New',
-          subject: 'New',
-          updated_at: '2024-01-02T00:00:00Z',
-          editor: 'code'
-        }
-      ];
-
-      const sendgridData: SendGridTemplateData = {
-        id: 'template-123',
-        name: 'MyApp - Test',
-        generation: 'dynamic',
-        updated_at: '2024-01-02T00:00:00Z',
-        versions
-      };
-
-      const result = converter.convertToProviderTemplate(sendgridData);
-
-      expect(result.version).toBe('v2.0.0');
-      expect(result.subject).toBe('New');
-    });
-  });
-
-  describe('convertToLocalTemplate', () => {
-    it('should convert SendGrid template to local template', () => {
-      const activeVersion: SendGridTemplateVersion = {
-        id: 'ver-123',
-        template_id: 'template-123',
-        active: 1,
-        name: 'v1.0.0',
-        html_content: '<html>Content</html>',
-        plain_content: 'Content',
-        subject: 'Subject',
-        updated_at: '2024-01-01T00:00:00Z',
-        editor: 'code'
-      };
-
-      const sendgridData: SendGridTemplateData = {
-        id: 'template-123',
-        name: 'MyApp - Welcome',
-        generation: 'dynamic',
-        updated_at: '2024-01-01T00:00:00Z',
-        versions: [activeVersion]
-      };
-
-      const result = converter.convertToLocalTemplate(sendgridData, 'local-123', activeVersion);
-
-      expect(result).toEqual({
-        id: 'local-123',
-        name: 'Welcome',
-        subject: 'Subject',
-        htmlContent: '<html>Content</html>',
-        textContent: 'Content',
-        category: 'synced',
-        tags: ['sendgrid', 'synced'],
-        version: 'v1.0.0',
-        isActive: true,
-        requiredVariables: [],
-        providerTemplateIds: {
-          sendgrid: 'template-123'
-        },
-        lastSyncedAt: {
-          sendgrid: expect.any(Date)
-        },
-        syncStatus: {
-          sendgrid: 'success'
-        },
-        createdAt: expect.any(Date),
-        updatedAt: expect.any(Date),
-        createdBy: 'sendgrid-sync',
-        lastModifiedBy: 'sendgrid-sync'
-      });
-    });
-  });
-
-  describe('extractVariables', () => {
-    it('should extract Handlebars variables', () => {
-      const content = 'Hello {{name}}, your order {{orderId}} is ready!';
-
-      const result = converter.extractVariables(content);
-
-      expect(result).toEqual(expect.arrayContaining(['name', 'orderId']));
-      expect(result).toHaveLength(2);
-    });
-
-    it('should handle variables with whitespace', () => {
-      const content = 'Hello {{ firstName }}, welcome to {{ siteName }}!';
-
-      const result = converter.extractVariables(content);
-
-      expect(result).toEqual(expect.arrayContaining(['firstName', 'siteName']));
-    });
-
-    it('should filter out Handlebars helpers', () => {
-      const content = '{{#if condition}}{{variable}}{{/if}}';
-
-      const result = converter.extractVariables(content);
-
-      expect(result).toEqual(['variable']);
-      expect(result).not.toContain('#if');
-      expect(result).not.toContain('/if');
-    });
-
-    it('should deduplicate variables', () => {
-      const content = 'Hello {{name}}, {{name}} is a great name!';
-
-      const result = converter.extractVariables(content);
-
-      expect(result).toEqual(['name']);
-      expect(result).toHaveLength(1);
-    });
-
-    it('should return empty array for content without variables', () => {
-      const content = 'This is plain text with no variables';
-
-      const result = converter.extractVariables(content);
-
-      expect(result).toEqual([]);
-    });
-
-    it('should handle complex HTML with variables', () => {
-      const content = `
-        <html>
-          <body>
-            <h1>Hello {{userName}}</h1>
-            <p>Your account {{accountId}} is active</p>
-            <a href="{{confirmationUrl}}">Click here</a>
-          </body>
-        </html>
-      `;
-
-      const result = converter.extractVariables(content);
-
-      expect(result).toEqual(expect.arrayContaining(['userName', 'accountId', 'confirmationUrl']));
-      expect(result).toHaveLength(3);
-    });
-  });
-});

package/__tests__/plugin/sender-manager.test.ts

@@ -1,135 +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 { SenderManager } from '../../src/plugin/sender-manager';
-import { SendGridClient } from '../../src/api/sendgrid-client';
-import { SenderConverter } from '../../src/converters/sender-converter';
-
-describe('SenderManager', () => {
-  let manager: SenderManager;
-  let mockClient: jest.Mocked<SendGridClient>;
-  let converter: SenderConverter;
-
-  beforeEach(() => {
-    mockClient = {
-      request: jest.fn(),
-      isSuccessResponse: jest.fn(),
-      parseResponseBody: jest.fn()
-    } as any;
-
-    converter = new SenderConverter();
-    manager = new SenderManager(mockClient, converter);
-  });
-
-  describe('getVerifiedSenders', () => {
-    it('should fetch and cache verified senders', async () => {
-      const mockSenders = {
-        results: [
-          {
-            id: 123,
-            nickname: 'Test',
-            from_email: 'test@example.com',
-            from_name: 'Test',
-            reply_to: 'test@example.com',
-            reply_to_name: 'Test',
-            address: '',
-            address2: '',
-            city: '',
-            state: '',
-            zip: '',
-            country: 'US',
-            verified: true,
-            locked: false
-          }
-        ]
-      };
-
-      mockClient.request.mockResolvedValueOnce({
-        statusCode: 200,
-        headers: {},
-        body: JSON.stringify(mockSenders)
-      });
-
-      mockClient.isSuccessResponse.mockReturnValue(true);
-      mockClient.parseResponseBody.mockReturnValueOnce(mockSenders);
-
-      const result = await manager.getVerifiedSenders();
-
-      expect(result).toHaveLength(1);
-      expect(result[0].email).toBe('test@example.com');
-      expect(mockClient.request).toHaveBeenCalledTimes(1);
-
-      // Second call should use cache
-      const result2 = await manager.getVerifiedSenders();
-      expect(result2).toEqual(result);
-      expect(mockClient.request).toHaveBeenCalledTimes(1); // Still 1, used cache
-    });
-  });
-
-  describe('validateSender', () => {
-    beforeEach(() => {
-      const mockSenders = {
-        results: [
-          {
-            id: 123,
-            nickname: 'Test',
-            from_email: 'verified@example.com',
-            from_name: 'Test',
-            reply_to: 'verified@example.com',
-            reply_to_name: 'Test',
-            address: '',
-            address2: '',
-            city: '',
-            state: '',
-            zip: '',
-            country: 'US',
-            verified: true,
-            locked: false
-          }
-        ]
-      };
-
-      mockClient.request.mockResolvedValueOnce({
-        statusCode: 200,
-        headers: {},
-        body: JSON.stringify(mockSenders)
-      });
-
-      mockClient.isSuccessResponse.mockReturnValue(true);
-      mockClient.parseResponseBody.mockReturnValueOnce(mockSenders);
-    });
-
-    it('should validate exact match sender', async () => {
-      const result = await manager.validateSender('verified@example.com');
-
-      expect(result.isValid).toBe(true);
-      expect(result.verifiedSender).toBeDefined();
-      expect(result.errors).toEqual([]);
-    });
-
-    it('should validate sender with domain match', async () => {
-      const result = await manager.validateSender('unverified@example.com');
-
-      expect(result.isValid).toBe(true); // Domain match is valid
-      expect(result.domainMatches.length).toBeGreaterThan(0);
-    });
-
-    it('should reject sender with no domain match', async () => {
-      const result = await manager.validateSender('test@different.com');
-
-      expect(result.isValid).toBe(false);
-      expect(result.errors.length).toBeGreaterThan(0);
-    });
-  });
-
-  describe('clearCache', () => {
-    it('should clear the senders cache', () => {
-      expect(() => manager.clearCache()).not.toThrow();
-    });
-  });
-});

package/__tests__/plugin/sendgrid-plugin.test.ts

@@ -1,195 +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 { SendGridTemplatePlugin } from '../../src/plugin/sendgrid-plugin';
-import { SendGridPluginConfig } from '../../src/types/config-types';
-
-describe('SendGridTemplatePlugin', () => {
-  let plugin: SendGridTemplatePlugin;
-  let config: SendGridPluginConfig;
-
-  beforeEach(() => {
-    config = {
-      apiKey: 'test-api-key',
-      templatePrefix: 'Test - ',
-      safetyMode: 'strict' as const,
-      rateLimits: {
-        templatesPerMinute: 60,
-        apiCallsPerSecond: 10
-      }
-    };
-
-    plugin = new SendGridTemplatePlugin(config);
-  });
-
-  describe('constructor', () => {
-    it('should create plugin with configuration', () => {
-      expect(plugin).toBeDefined();
-      expect(plugin.name).toBe('sendgrid-templates');
-      expect(plugin.version).toBe('1.0.0');
-      expect(plugin.providerId).toBe('sendgrid');
-    });
-  });
-
-  describe('initialize', () => {
-    it('should initialize plugin successfully', async () => {
-      await expect(plugin.initialize({})).resolves.toBeUndefined();
-    });
-
-    it('should be idempotent', async () => {
-      await plugin.initialize({});
-      await expect(plugin.initialize({})).resolves.toBeUndefined();
-    });
-  });
-
-  describe('destroy', () => {
-    it('should destroy plugin successfully', async () => {
-      await plugin.initialize({});
-      await expect(plugin.destroy()).resolves.toBeUndefined();
-    });
-
-    it('should handle destroy without initialization', async () => {
-      await expect(plugin.destroy()).resolves.toBeUndefined();
-    });
-  });
-
-  describe('getCapabilities', () => {
-    it('should return all supported capabilities', () => {
-      const capabilities = plugin.getCapabilities();
-
-      expect(capabilities).toHaveLength(4);
-      expect(capabilities.map(c => c.feature)).toEqual([
-        'template-management',
-        'sender-verification',
-        'template-analytics',
-        'batch-operations'
-      ]);
-    });
-
-    it('should include correct methods for each capability', () => {
-      const capabilities = plugin.getCapabilities();
-
-      const templateManagement = capabilities.find(c => c.feature === 'template-management');
-      expect(templateManagement?.methods).toContain('createTemplate');
-      expect(templateManagement?.methods).toContain('updateTemplate');
-      expect(templateManagement?.methods).toContain('deleteTemplate');
-
-      const senderVerification = capabilities.find(c => c.feature === 'sender-verification');
-      expect(senderVerification?.methods).toContain('getVerifiedSenders');
-      expect(senderVerification?.methods).toContain('validateSender');
-    });
-
-    it('should include configuration for each capability', () => {
-      const capabilities = plugin.getCapabilities();
-
-      capabilities.forEach(capability => {
-        expect(capability.config).toBeDefined();
-        expect(typeof capability.config).toBe('object');
-      });
-    });
-  });
-
-  describe('supportsFeature', () => {
-    it('should return true for supported features', () => {
-      expect(plugin.supportsFeature('template-management')).toBe(true);
-      expect(plugin.supportsFeature('sender-verification')).toBe(true);
-      expect(plugin.supportsFeature('template-analytics')).toBe(true);
-      expect(plugin.supportsFeature('batch-operations')).toBe(true);
-    });
-
-    it('should return false for unsupported features', () => {
-      expect(plugin.supportsFeature('unknown-feature')).toBe(false);
-      expect(plugin.supportsFeature('custom-domains')).toBe(false);
-    });
-  });
-
-  describe('getFeatureConfig', () => {
-    it('should return config for supported features', () => {
-      const config = plugin.getFeatureConfig('template-management');
-
-      expect(config).toBeDefined();
-      expect(config?.supportsVersioning).toBe(true);
-      expect(config?.supportsActivation).toBe(true);
-    });
-
-    it('should return null for unsupported features', () => {
-      const config = plugin.getFeatureConfig('unknown-feature');
-
-      expect(config).toBeNull();
-    });
-  });
-
-  describe('validateRoute', () => {
-    it('should validate route successfully', () => {
-      const result = plugin.validateRoute({});
-
-      expect(result.isValid).toBe(true);
-      expect(result.errors).toEqual([]);
-    });
-  });
-
-  describe('template operations', () => {
-    it('should throw error when not initialized', async () => {
-      await expect(plugin.createTemplate({} as any)).rejects.toThrow('not initialized');
-      await expect(plugin.getTemplate('123')).rejects.toThrow('not initialized');
-      await expect(plugin.listTemplates()).rejects.toThrow('not initialized');
-    });
-  });
-
-  describe('sender operations', () => {
-    it('should throw error when not initialized', async () => {
-      await expect(plugin.getVerifiedSenders()).rejects.toThrow('not initialized');
-      await expect(plugin.validateSender('test@example.com')).rejects.toThrow('not initialized');
-      await expect(plugin.selectBestSender('test@example.com')).rejects.toThrow('not initialized');
-    });
-  });
-
-  describe('sync operations', () => {
-    it('should throw error when not initialized', async () => {
-      await expect(plugin.syncToProvider({} as any)).rejects.toThrow('not initialized');
-      await expect(plugin.syncFromProvider('123')).rejects.toThrow('not initialized');
-      await expect(plugin.batchSyncTemplates([])).rejects.toThrow('not initialized');
-    });
-  });
-
-  describe('configuration variations', () => {
-    it('should work with permissive safety mode', async () => {
-      const permissiveConfig: SendGridPluginConfig = {
-        ...config,
-        safetyMode: 'permissive'
-      };
-
-      const permissivePlugin = new SendGridTemplatePlugin(permissiveConfig);
-      await expect(permissivePlugin.initialize({})).resolves.toBeUndefined();
-    });
-
-    it('should work without rate limits', async () => {
-      const noLimitsConfig: SendGridPluginConfig = {
-        apiKey: 'test-key',
-        templatePrefix: 'Test - ',
-        safetyMode: 'strict'
-      };
-
-      const noLimitsPlugin = new SendGridTemplatePlugin(noLimitsConfig);
-      await expect(noLimitsPlugin.initialize({})).resolves.toBeUndefined();
-    });
-
-    it('should work with webhook config', async () => {
-      const webhookConfig: SendGridPluginConfig = {
-        ...config,
-        webhookConfig: {
-          secret: 'webhook-secret',
-          eventTypes: ['delivered', 'bounced', 'opened']
-        }
-      };
-
-      const webhookPlugin = new SendGridTemplatePlugin(webhookConfig);
-      await expect(webhookPlugin.initialize({})).resolves.toBeUndefined();
-    });
-  });
-});

package/__tests__/plugin/template-manager.test.ts

@@ -1,110 +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 { TemplateManager } from '../../src/plugin/template-manager';
-import { SendGridClient } from '../../src/api/sendgrid-client';
-import { OwnershipValidator } from '../../src/safety/ownership-validator';
-import { PrefixEnforcer } from '../../src/safety/prefix-enforcer';
-import { TemplateConverter } from '../../src/converters/template-converter';
-import { Template } from '../../src/types/plugin-types';
-
-describe('TemplateManager', () => {
-  let manager: TemplateManager;
-  let mockClient: jest.Mocked<SendGridClient>;
-  let ownershipValidator: OwnershipValidator;
-  let prefixEnforcer: PrefixEnforcer;
-  let converter: TemplateConverter;
-
-  beforeEach(() => {
-    mockClient = {
-      request: jest.fn(),
-      isSuccessResponse: jest.fn(),
-      parseResponseBody: jest.fn()
-    } as any;
-
-    ownershipValidator = new OwnershipValidator('strict');
-    prefixEnforcer = new PrefixEnforcer('Test - ');
-    converter = new TemplateConverter(prefixEnforcer);
-
-    manager = new TemplateManager(
-      mockClient,
-      ownershipValidator,
-      prefixEnforcer,
-      converter
-    );
-  });
-
-  describe('createTemplate', () => {
-    it('should create template successfully', async () => {
-      const template: Template = {
-        id: 'local-123',
-        name: 'Welcome',
-        subject: 'Welcome!',
-        htmlContent: '<html>Test</html>',
-        category: 'transactional',
-        tags: [],
-        version: '1.0.0',
-        isActive: true,
-        requiredVariables: [],
-        createdAt: new Date(),
-        updatedAt: new Date(),
-        createdBy: 'test',
-        lastModifiedBy: 'test'
-      };
-
-      mockClient.request.mockResolvedValueOnce({
-        statusCode: 201,
-        headers: {},
-        body: JSON.stringify({ id: 'sendgrid-123', name: 'Test - Welcome', generation: 'dynamic', updated_at: new Date().toISOString() })
-      });
-
-      mockClient.isSuccessResponse.mockReturnValue(true);
-      mockClient.parseResponseBody.mockReturnValueOnce({ id: 'sendgrid-123', name: 'Test - Welcome', generation: 'dynamic', updated_at: new Date().toISOString() });
-
-      mockClient.request.mockResolvedValueOnce({
-        statusCode: 201,
-        headers: {},
-        body: JSON.stringify({ id: 'version-123' })
-      });
-
-      mockClient.isSuccessResponse.mockReturnValue(true);
-      mockClient.parseResponseBody.mockReturnValueOnce({ id: 'version-123' });
-
-      const result = await manager.createTemplate(template);
-
-      expect(result).toBe('sendgrid-123');
-      expect(mockClient.request).toHaveBeenCalledTimes(2);
-    });
-  });
-
-  describe('listTemplates', () => {
-    it('should list and register templates', async () => {
-      mockClient.request.mockResolvedValueOnce({
-        statusCode: 200,
-        headers: {},
-        body: JSON.stringify({
-          result: [
-            { id: 'template-1', name: 'Test - Template 1', generation: 'dynamic', updated_at: new Date().toISOString(), versions: [] }
-          ]
-        })
-      });
-
-      mockClient.isSuccessResponse.mockReturnValue(true);
-      mockClient.parseResponseBody.mockReturnValueOnce({
-        result: [
-          { id: 'template-1', name: 'Test - Template 1', generation: 'dynamic', updated_at: new Date().toISOString(), versions: [] }
-        ]
-      });
-
-      const result = await manager.listTemplates();
-
-      expect(result).toHaveLength(1);
-      expect(ownershipValidator.isOwnedTemplate('template-1')).toBe(true);
-    });
-  });
-});