@bernierllc/email-sendgrid-plugin 1.4.5 → 1.7.0

package/__tests__/safety/ownership-validator.test.ts

@@ -1,130 +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 { OwnershipValidator } from '../../src/safety/ownership-validator';
-import { UnauthorizedTemplateAccessError } from '../../src/api/errors';
-
-describe('OwnershipValidator', () => {
-  describe('constructor', () => {
-    it('should create validator with specified safety mode', () => {
-      const validator = new OwnershipValidator('strict');
-      expect(validator).toBeDefined();
-    });
-  });
-
-  describe('registerTemplate', () => {
-    it('should register template successfully', () => {
-      const validator = new OwnershipValidator('strict');
-
-      validator.registerTemplate('template-123');
-
-      expect(validator.isOwnedTemplate('template-123')).toBe(true);
-    });
-
-    it('should not add duplicate registrations', () => {
-      const validator = new OwnershipValidator('strict');
-
-      validator.registerTemplate('template-123');
-      validator.registerTemplate('template-123');
-
-      expect(validator.getOwnedTemplates()).toEqual(['template-123']);
-    });
-  });
-
-  describe('unregisterTemplate', () => {
-    it('should unregister template successfully', () => {
-      const validator = new OwnershipValidator('strict');
-
-      validator.registerTemplate('template-123');
-      expect(validator.isOwnedTemplate('template-123')).toBe(true);
-
-      validator.unregisterTemplate('template-123');
-      expect(validator.isOwnedTemplate('template-123')).toBe(false);
-    });
-
-    it('should handle unregistering non-existent template', () => {
-      const validator = new OwnershipValidator('strict');
-
-      expect(() => validator.unregisterTemplate('non-existent')).not.toThrow();
-    });
-  });
-
-  describe('validateOwnership', () => {
-    it('should pass validation for owned template in strict mode', () => {
-      const validator = new OwnershipValidator('strict');
-      validator.registerTemplate('template-123');
-
-      expect(() => validator.validateOwnership('template-123')).not.toThrow();
-    });
-
-    it('should throw error for unowned template in strict mode', () => {
-      const validator = new OwnershipValidator('strict');
-
-      expect(() => validator.validateOwnership('template-123')).toThrow(UnauthorizedTemplateAccessError);
-    });
-
-    it('should pass validation for any template in permissive mode', () => {
-      const validator = new OwnershipValidator('permissive');
-
-      expect(() => validator.validateOwnership('template-123')).not.toThrow();
-      expect(() => validator.validateOwnership('unregistered')).not.toThrow();
-    });
-  });
-
-  describe('isOwnedTemplate', () => {
-    it('should return true for registered templates', () => {
-      const validator = new OwnershipValidator('strict');
-      validator.registerTemplate('template-123');
-
-      expect(validator.isOwnedTemplate('template-123')).toBe(true);
-    });
-
-    it('should return false for unregistered templates', () => {
-      const validator = new OwnershipValidator('strict');
-
-      expect(validator.isOwnedTemplate('template-123')).toBe(false);
-    });
-  });
-
-  describe('getOwnedTemplates', () => {
-    it('should return all registered templates', () => {
-      const validator = new OwnershipValidator('strict');
-
-      validator.registerTemplate('template-1');
-      validator.registerTemplate('template-2');
-      validator.registerTemplate('template-3');
-
-      const owned = validator.getOwnedTemplates();
-      expect(owned).toHaveLength(3);
-      expect(owned).toContain('template-1');
-      expect(owned).toContain('template-2');
-      expect(owned).toContain('template-3');
-    });
-
-    it('should return empty array when no templates registered', () => {
-      const validator = new OwnershipValidator('strict');
-
-      expect(validator.getOwnedTemplates()).toEqual([]);
-    });
-  });
-
-  describe('clearRegistrations', () => {
-    it('should clear all registered templates', () => {
-      const validator = new OwnershipValidator('strict');
-
-      validator.registerTemplate('template-1');
-      validator.registerTemplate('template-2');
-
-      expect(validator.getOwnedTemplates()).toHaveLength(2);
-
-      validator.clearRegistrations();
-
-      expect(validator.getOwnedTemplates()).toEqual([]);
-    });
-  });
-});

package/__tests__/safety/prefix-enforcer.test.ts

@@ -1,136 +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 { PrefixEnforcer } from '../../src/safety/prefix-enforcer';
-
-describe('PrefixEnforcer', () => {
-  describe('constructor', () => {
-    it('should create enforcer with specified prefix', () => {
-      const enforcer = new PrefixEnforcer('MyApp - ');
-      expect(enforcer.getPrefix()).toBe('MyApp - ');
-    });
-  });
-
-  describe('applyPrefix', () => {
-    it('should add prefix to name without prefix', () => {
-      const enforcer = new PrefixEnforcer('MyApp - ');
-
-      const result = enforcer.applyPrefix('Welcome Email');
-
-      expect(result).toBe('MyApp - Welcome Email');
-    });
-
-    it('should not add prefix if already present', () => {
-      const enforcer = new PrefixEnforcer('MyApp - ');
-
-      const result = enforcer.applyPrefix('MyApp - Welcome Email');
-
-      expect(result).toBe('MyApp - Welcome Email');
-    });
-
-    it('should handle empty string', () => {
-      const enforcer = new PrefixEnforcer('MyApp - ');
-
-      const result = enforcer.applyPrefix('');
-
-      expect(result).toBe('MyApp - ');
-    });
-
-    it('should work with different prefix formats', () => {
-      const enforcer = new PrefixEnforcer('[PROD]');
-
-      expect(enforcer.applyPrefix('template')).toBe('[PROD]template');
-      expect(enforcer.applyPrefix('[PROD]template')).toBe('[PROD]template');
-    });
-  });
-
-  describe('stripPrefix', () => {
-    it('should remove prefix from name', () => {
-      const enforcer = new PrefixEnforcer('MyApp - ');
-
-      const result = enforcer.stripPrefix('MyApp - Welcome Email');
-
-      expect(result).toBe('Welcome Email');
-    });
-
-    it('should return name unchanged if no prefix', () => {
-      const enforcer = new PrefixEnforcer('MyApp - ');
-
-      const result = enforcer.stripPrefix('Welcome Email');
-
-      expect(result).toBe('Welcome Email');
-    });
-
-    it('should handle empty string', () => {
-      const enforcer = new PrefixEnforcer('MyApp - ');
-
-      const result = enforcer.stripPrefix('');
-
-      expect(result).toBe('');
-    });
-
-    it('should only strip the prefix once', () => {
-      const enforcer = new PrefixEnforcer('App - ');
-
-      const result = enforcer.stripPrefix('App - App - Template');
-
-      expect(result).toBe('App - Template');
-    });
-  });
-
-  describe('hasPrefix', () => {
-    it('should return true for names with prefix', () => {
-      const enforcer = new PrefixEnforcer('MyApp - ');
-
-      expect(enforcer.hasPrefix('MyApp - Welcome')).toBe(true);
-    });
-
-    it('should return false for names without prefix', () => {
-      const enforcer = new PrefixEnforcer('MyApp - ');
-
-      expect(enforcer.hasPrefix('Welcome')).toBe(false);
-    });
-
-    it('should return false for empty string', () => {
-      const enforcer = new PrefixEnforcer('MyApp - ');
-
-      expect(enforcer.hasPrefix('')).toBe(false);
-    });
-
-    it('should be case-sensitive', () => {
-      const enforcer = new PrefixEnforcer('MyApp - ');
-
-      expect(enforcer.hasPrefix('myapp - Welcome')).toBe(false);
-    });
-  });
-
-  describe('getPrefix', () => {
-    it('should return the configured prefix', () => {
-      const enforcer = new PrefixEnforcer('Test - ');
-
-      expect(enforcer.getPrefix()).toBe('Test - ');
-    });
-  });
-
-  describe('edge cases', () => {
-    it('should handle prefix-only names', () => {
-      const enforcer = new PrefixEnforcer('Prefix');
-
-      expect(enforcer.applyPrefix('Prefix')).toBe('Prefix');
-      expect(enforcer.stripPrefix('Prefix')).toBe('');
-      expect(enforcer.hasPrefix('Prefix')).toBe(true);
-    });
-
-    it('should handle special characters in prefix', () => {
-      const enforcer = new PrefixEnforcer('[App-v1.0]_');
-
-      expect(enforcer.applyPrefix('template')).toBe('[App-v1.0]_template');
-      expect(enforcer.stripPrefix('[App-v1.0]_template')).toBe('template');
-    });
-  });
-});

package/jest.config.js

@@ -1,26 +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.
-*/
-
-module.exports = {
-  preset: 'ts-jest',
-  // Use fixed environment to handle Node.js v25+ localStorage issue
-  testEnvironment: '<rootDir>/../../../jest-environment-node-fixed.cjs',
-  collectCoverageFrom: [
-    'src/**/*.{ts,tsx}',
-    '!src/**/*.d.ts',
-    '!src/index.ts'
-  ],
-  coverageThreshold: {
-    global: {
-      branches: 60,
-      functions: 75,
-      lines: 65,
-      statements: 65
-    }
-  }
-};

package/src/api/errors.ts

@@ -1,49 +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.
-*/
-
-export class SendGridApiError extends Error {
-  constructor(
-    message: string,
-    public statusCode?: number,
-    public response?: unknown
-  ) {
-    super(message);
-    this.name = 'SendGridApiError';
-  }
-}
-
-export class TemplateNotFoundError extends Error {
-  constructor(public templateId: string) {
-    super(`Template not found: ${templateId}`);
-    this.name = 'TemplateNotFoundError';
-  }
-}
-
-export class UnauthorizedTemplateAccessError extends Error {
-  constructor(message: string) {
-    super(message);
-    this.name = 'UnauthorizedTemplateAccessError';
-  }
-}
-
-export class TemplateConflictError extends Error {
-  constructor(
-    public templateId: string,
-    public conflicts: string[]
-  ) {
-    super(`Template conflicts detected: ${conflicts.join(', ')}`);
-    this.name = 'TemplateConflictError';
-  }
-}
-
-export class RateLimitError extends Error {
-  constructor(message: string) {
-    super(message);
-    this.name = 'RateLimitError';
-  }
-}

package/src/api/rate-limiter.ts

@@ -1,79 +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 { RateLimitError } from './errors';
-
-export interface RateLimiterConfig {
-  maxRequestsPerSecond: number;
-  maxRequestsPerMinute: number;
-}
-
-export class SimpleRateLimiter {
-  private requestTimestamps: number[] = [];
-  private readonly maxRequestsPerSecond: number;
-  private readonly maxRequestsPerMinute: number;
-
-  constructor(config: RateLimiterConfig) {
-    this.maxRequestsPerSecond = config.maxRequestsPerSecond;
-    this.maxRequestsPerMinute = config.maxRequestsPerMinute;
-  }
-
-  async acquire(): Promise<void> {
-    const now = Date.now();
-
-    // Clean up old timestamps
-    this.requestTimestamps = this.requestTimestamps.filter(
-      timestamp => now - timestamp < 60000 // Keep last minute
-    );
-
-    // Check per-second limit
-    const lastSecond = this.requestTimestamps.filter(
-      timestamp => now - timestamp < 1000
-    );
-
-    if (lastSecond.length >= this.maxRequestsPerSecond) {
-      const waitTime = 1000 - (now - lastSecond[0]);
-      await this.sleep(waitTime);
-      return this.acquire();
-    }
-
-    // Check per-minute limit
-    if (this.requestTimestamps.length >= this.maxRequestsPerMinute) {
-      const waitTime = 60000 - (now - this.requestTimestamps[0]);
-      if (waitTime > 5000) {
-        throw new RateLimitError(`Rate limit exceeded, would need to wait ${Math.ceil(waitTime / 1000)}s`);
-      }
-      await this.sleep(waitTime);
-      return this.acquire();
-    }
-
-    // Add timestamp and proceed
-    this.requestTimestamps.push(now);
-  }
-
-  release(): void {
-    // No-op for simple implementation
-  }
-
-  private sleep(ms: number): Promise<void> {
-    return new Promise(resolve => setTimeout(resolve, Math.max(0, ms)));
-  }
-
-  getRemainingCapacity(): { perSecond: number; perMinute: number } {
-    const now = Date.now();
-    const lastSecond = this.requestTimestamps.filter(
-      timestamp => now - timestamp < 1000
-    ).length;
-    const lastMinute = this.requestTimestamps.length;
-
-    return {
-      perSecond: Math.max(0, this.maxRequestsPerSecond - lastSecond),
-      perMinute: Math.max(0, this.maxRequestsPerMinute - lastMinute)
-    };
-  }
-}

package/src/api/sendgrid-client.ts

@@ -1,86 +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 { ApiRequestOptions, ApiResponse } from '../types/config-types';
-import { SendGridApiError } from './errors';
-import { SimpleRateLimiter } from './rate-limiter';
-
-export interface SendGridClientConfig {
-  apiKey: string;
-  rateLimiter?: SimpleRateLimiter;
-  logger?: {
-    debug: (message: string) => void;
-    error: (message: string) => void;
-    info: (message: string) => void;
-  };
-}
-
-export class SendGridClient {
-  private readonly apiKey: string;
-  private readonly rateLimiter?: SimpleRateLimiter;
-  private readonly logger?: SendGridClientConfig['logger'];
-  private readonly baseUrl = 'https://api.sendgrid.com/v3';
-
-  constructor(config: SendGridClientConfig) {
-    this.apiKey = config.apiKey;
-    this.rateLimiter = config.rateLimiter;
-    this.logger = config.logger;
-  }
-
-  async request(endpoint: string, options: ApiRequestOptions): Promise<ApiResponse> {
-    // Apply rate limiting if configured
-    if (this.rateLimiter) {
-      await this.rateLimiter.acquire();
-    }
-
-    try {
-      const url = `${this.baseUrl}${endpoint}`;
-
-      const response = await fetch(url, {
-        method: options.method,
-        headers: {
-          'Authorization': `Bearer ${this.apiKey}`,
-          'Content-Type': 'application/json',
-          ...options.headers
-        },
-        body: options.body
-      });
-
-      const body = await response.text();
-
-      // Log all API calls for audit trail
-      this.logger?.debug(`SendGrid API ${options.method} ${endpoint}: ${response.status}`);
-
-      return {
-        statusCode: response.status,
-        headers: Object.fromEntries(response.headers.entries()),
-        body
-      };
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-      this.logger?.error(`SendGrid API error: ${errorMessage}`);
-      throw new SendGridApiError(`API request failed: ${errorMessage}`, undefined, error);
-    } finally {
-      if (this.rateLimiter) {
-        this.rateLimiter.release();
-      }
-    }
-  }
-
-  isSuccessResponse(response: ApiResponse): boolean {
-    return response.statusCode >= 200 && response.statusCode < 300;
-  }
-
-  parseResponseBody<T>(response: ApiResponse): T {
-    try {
-      return JSON.parse(response.body) as T;
-    } catch (error) {
-      throw new SendGridApiError('Failed to parse response body', response.statusCode, response.body);
-    }
-  }
-}

package/src/converters/sender-converter.ts

@@ -1,138 +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 {
-  VerifiedSender,
-  SendGridVerifiedSenderData,
-  EmailAttachment,
-  SendGridAttachment,
-  SendGridMailPayload
-} from '../types/sendgrid-types';
-
-export class SenderConverter {
-  convertToVerifiedSender(sendgridData: SendGridVerifiedSenderData): VerifiedSender {
-    const domain = this.extractDomain(sendgridData.from_email);
-
-    return {
-      id: sendgridData.id.toString(),
-      email: sendgridData.from_email,
-      name: sendgridData.from_name || sendgridData.nickname,
-      isVerified: sendgridData.verified,
-      domain,
-      verificationStatus: sendgridData.verified ? 'verified' : 'pending',
-      createdAt: new Date(), // SendGrid doesn't provide creation date
-      lastVerifiedAt: sendgridData.verified ? new Date() : undefined
-    };
-  }
-
-  /**
-   * Convert a single EmailAttachment to SendGrid's attachment format.
-   */
-  convertAttachment(attachment: EmailAttachment): SendGridAttachment {
-    const sgAttachment: SendGridAttachment = {
-      content: attachment.content,
-      filename: attachment.filename,
-    };
-
-    if (attachment.contentType) {
-      sgAttachment.type = attachment.contentType;
-    }
-
-    if (attachment.disposition) {
-      sgAttachment.disposition = attachment.disposition;
-    }
-
-    return sgAttachment;
-  }
-
-  /**
-   * Convert an array of EmailAttachment objects to SendGrid format.
-   * Returns undefined if the array is empty or undefined (so the field
-   * can be omitted from the payload).
-   */
-  convertAttachments(attachments?: EmailAttachment[]): SendGridAttachment[] | undefined {
-    if (!attachments || attachments.length === 0) {
-      return undefined;
-    }
-
-    return attachments.map(a => this.convertAttachment(a));
-  }
-
-  /**
-   * Convert custom headers to the format expected by SendGrid's v3 mail send API.
-   * Filters out reserved SendGrid headers that must not be overridden.
-   * Returns undefined if no valid headers remain.
-   */
-  convertHeaders(headers?: Record<string, string>): Record<string, string> | undefined {
-    if (!headers || Object.keys(headers).length === 0) {
-      return undefined;
-    }
-
-    const RESERVED_HEADERS = new Set([
-      'x-sg-id',
-      'x-sg-eid',
-      'received',
-      'dkim-signature',
-      'content-type',
-      'content-transfer-encoding',
-      'to',
-      'from',
-      'subject',
-      'reply-to',
-      'cc',
-      'bcc',
-    ]);
-
-    const filtered: Record<string, string> = {};
-    for (const [key, value] of Object.entries(headers)) {
-      if (!RESERVED_HEADERS.has(key.toLowerCase())) {
-        filtered[key] = value;
-      }
-    }
-
-    return Object.keys(filtered).length > 0 ? filtered : undefined;
-  }
-
-  /**
-   * Build the attachment and header portion of a SendGrid mail payload
-   * from canonical email data.
-   */
-  buildMailPayload(options: {
-    attachments?: EmailAttachment[];
-    headers?: Record<string, string>;
-  }): SendGridMailPayload {
-    const payload: SendGridMailPayload = {};
-
-    const attachments = this.convertAttachments(options.attachments);
-    if (attachments) {
-      payload.attachments = attachments;
-    }
-
-    const headers = this.convertHeaders(options.headers);
-    if (headers) {
-      payload.headers = headers;
-    }
-
-    return payload;
-  }
-
-  extractDomain(email: string): string {
-    return email.split('@')[1]?.toLowerCase() || '';
-  }
-
-  isDomainMatch(domain1: string, domain2: string): boolean {
-    // Exact match
-    if (domain1 === domain2) return true;
-
-    // Subdomain match (e.g., app.example.com matches example.com)
-    if (domain1.endsWith(`.${domain2}`)) return true;
-    if (domain2.endsWith(`.${domain1}`)) return true;
-
-    return false;
-  }
-}