@bernierllc/email-sendgrid-plugin 1.8.1 → 1.8.2

package/dist/plugin/template-manager.js

@@ -1,157 +0,0 @@
-"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.TemplateManager = void 0;
-const errors_1 = require("../api/errors");
-class TemplateManager {
-    client;
-    ownershipValidator;
-    prefixEnforcer;
-    converter;
-    logger;
-    constructor(client, ownershipValidator, prefixEnforcer, converter, logger) {
-        this.client = client;
-        this.ownershipValidator = ownershipValidator;
-        this.prefixEnforcer = prefixEnforcer;
-        this.converter = converter;
-        this.logger = logger;
-    }
-    async createTemplate(template) {
-        // Apply template naming convention
-        const templateName = this.prefixEnforcer.applyPrefix(template.name);
-        // Create base template in SendGrid
-        const createRequest = {
-            name: templateName,
-            generation: 'dynamic'
-        };
-        const response = await this.client.request('/templates', {
-            method: 'POST',
-            body: JSON.stringify(createRequest)
-        });
-        if (!this.client.isSuccessResponse(response)) {
-            throw new errors_1.SendGridApiError(`Failed to create template: ${response.statusCode}`, response.statusCode, response.body);
-        }
-        const templateData = this.client.parseResponseBody(response);
-        const templateId = templateData.id;
-        // Register as app-managed
-        this.ownershipValidator.registerTemplate(templateId);
-        // Create initial version with content
-        await this.createTemplateVersion(templateId, {
-            name: 'v1.0.0',
-            subject: template.subject,
-            htmlContent: template.htmlContent,
-            textContent: template.textContent,
-            active: true
-        });
-        // Log operation
-        this.logger?.info(`Created SendGrid template: ${templateName} (ID: ${templateId})`);
-        return templateId;
-    }
-    async updateTemplate(providerTemplateId, template) {
-        // Validate template ownership
-        this.ownershipValidator.validateOwnership(providerTemplateId);
-        // Get current template state
-        const currentTemplate = await this.getTemplate(providerTemplateId);
-        // Check for conflicts
-        if (this.hasConflicts(currentTemplate, template)) {
-            throw new errors_1.TemplateConflictError(providerTemplateId, this.detectConflicts(currentTemplate, template));
-        }
-        // Create new version with updated content
-        await this.createTemplateVersion(providerTemplateId, {
-            name: `v${template.version}`,
-            subject: template.subject,
-            htmlContent: template.htmlContent,
-            textContent: template.textContent,
-            active: template.isActive
-        });
-        this.logger?.info(`Updated SendGrid template: ${providerTemplateId}`);
-    }
-    async deleteTemplate(providerTemplateId) {
-        this.ownershipValidator.validateOwnership(providerTemplateId);
-        const response = await this.client.request(`/templates/${providerTemplateId}`, {
-            method: 'DELETE'
-        });
-        if (!this.client.isSuccessResponse(response)) {
-            throw new errors_1.SendGridApiError(`Failed to delete template: ${response.statusCode}`, response.statusCode, response.body);
-        }
-        this.ownershipValidator.unregisterTemplate(providerTemplateId);
-        this.logger?.info(`Deleted SendGrid template: ${providerTemplateId}`);
-    }
-    async getTemplate(providerTemplateId) {
-        this.ownershipValidator.validateOwnership(providerTemplateId);
-        const response = await this.client.request(`/templates/${providerTemplateId}`, {
-            method: 'GET'
-        });
-        if (response.statusCode === 404) {
-            throw new errors_1.TemplateNotFoundError(providerTemplateId);
-        }
-        if (!this.client.isSuccessResponse(response)) {
-            throw new errors_1.SendGridApiError(`Failed to get template: ${response.statusCode}`, response.statusCode, response.body);
-        }
-        const templateData = this.client.parseResponseBody(response);
-        return this.converter.convertToProviderTemplate(templateData);
-    }
-    async listTemplates() {
-        const response = await this.client.request('/templates?generations=dynamic', {
-            method: 'GET'
-        });
-        if (!this.client.isSuccessResponse(response)) {
-            throw new errors_1.SendGridApiError(`Failed to list templates: ${response.statusCode}`, response.statusCode, response.body);
-        }
-        const data = this.client.parseResponseBody(response);
-        // Filter to only app-managed templates
-        const appTemplates = data.result.filter(template => this.prefixEnforcer.hasPrefix(template.name));
-        // Register all app templates
-        appTemplates.forEach(template => {
-            this.ownershipValidator.registerTemplate(template.id);
-        });
-        return appTemplates.map(template => this.converter.convertToProviderTemplate(template));
-    }
-    async createTemplateVersion(templateId, version) {
-        const versionRequest = {
-            template_id: templateId,
-            name: version.name,
-            subject: version.subject,
-            html_content: version.htmlContent,
-            plain_content: version.textContent || '',
-            active: version.active ? 1 : 0
-        };
-        const response = await this.client.request(`/templates/${templateId}/versions`, {
-            method: 'POST',
-            body: JSON.stringify(versionRequest)
-        });
-        if (!this.client.isSuccessResponse(response)) {
-            throw new errors_1.SendGridApiError(`Failed to create template version: ${response.statusCode}`, response.statusCode, response.body);
-        }
-        const versionData = this.client.parseResponseBody(response);
-        return versionData.id;
-    }
-    async activateTemplateVersion(templateId, versionId) {
-        const response = await this.client.request(`/templates/${templateId}/versions/${versionId}/activate`, { method: 'POST' });
-        if (!this.client.isSuccessResponse(response)) {
-            throw new errors_1.SendGridApiError(`Failed to activate template version: ${response.statusCode}`, response.statusCode, response.body);
-        }
-        this.logger?.info(`Activated template version: ${templateId}/${versionId}`);
-    }
-    hasConflicts(current, updated) {
-        // Simple conflict detection - can be enhanced
-        return current.updatedAt > updated.updatedAt;
-    }
-    detectConflicts(current, updated) {
-        const conflicts = [];
-        if (current.subject !== updated.subject) {
-            conflicts.push('subject modified');
-        }
-        if (current.htmlContent !== updated.htmlContent) {
-            conflicts.push('HTML content modified');
-        }
-        return conflicts;
-    }
-}
-exports.TemplateManager = TemplateManager;

package/dist/safety/ownership-validator.d.ts

@@ -1,15 +0,0 @@
-export type SafetyMode = 'strict' | 'permissive';
-export declare class OwnershipValidator {
-    private appTemplateIds;
-    private readonly safetyMode;
-    private readonly logger?;
-    constructor(safetyMode: SafetyMode, logger?: {
-        debug: (message: string) => void;
-    });
-    registerTemplate(templateId: string): void;
-    unregisterTemplate(templateId: string): void;
-    validateOwnership(templateId: string): void;
-    isOwnedTemplate(templateId: string): boolean;
-    getOwnedTemplates(): string[];
-    clearRegistrations(): void;
-}

package/dist/safety/ownership-validator.js

@@ -1,44 +0,0 @@
-"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.OwnershipValidator = void 0;
-const errors_1 = require("../api/errors");
-class OwnershipValidator {
-    appTemplateIds = new Set();
-    safetyMode;
-    logger;
-    constructor(safetyMode, logger) {
-        this.safetyMode = safetyMode;
-        this.logger = logger;
-    }
-    registerTemplate(templateId) {
-        this.appTemplateIds.add(templateId);
-        this.logger?.debug(`Registered app template: ${templateId}`);
-    }
-    unregisterTemplate(templateId) {
-        this.appTemplateIds.delete(templateId);
-        this.logger?.debug(`Unregistered app template: ${templateId}`);
-    }
-    validateOwnership(templateId) {
-        if (this.safetyMode === 'strict' && !this.appTemplateIds.has(templateId)) {
-            throw new errors_1.UnauthorizedTemplateAccessError(`Template ${templateId} is not managed by this application`);
-        }
-    }
-    isOwnedTemplate(templateId) {
-        return this.appTemplateIds.has(templateId);
-    }
-    getOwnedTemplates() {
-        return Array.from(this.appTemplateIds);
-    }
-    clearRegistrations() {
-        this.appTemplateIds.clear();
-        this.logger?.debug('Cleared all template registrations');
-    }
-}
-exports.OwnershipValidator = OwnershipValidator;

package/dist/safety/prefix-enforcer.d.ts

@@ -1,8 +0,0 @@
-export declare class PrefixEnforcer {
-    private readonly prefix;
-    constructor(prefix: string);
-    applyPrefix(name: string): string;
-    stripPrefix(name: string): string;
-    hasPrefix(name: string): boolean;
-    getPrefix(): string;
-}

package/dist/safety/prefix-enforcer.js

@@ -1,35 +0,0 @@
-"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.PrefixEnforcer = void 0;
-class PrefixEnforcer {
-    prefix;
-    constructor(prefix) {
-        this.prefix = prefix;
-    }
-    applyPrefix(name) {
-        if (name.startsWith(this.prefix)) {
-            return name;
-        }
-        return `${this.prefix}${name}`;
-    }
-    stripPrefix(name) {
-        if (name.startsWith(this.prefix)) {
-            return name.substring(this.prefix.length);
-        }
-        return name;
-    }
-    hasPrefix(name) {
-        return name.startsWith(this.prefix);
-    }
-    getPrefix() {
-        return this.prefix;
-    }
-}
-exports.PrefixEnforcer = PrefixEnforcer;

package/dist/types/config-types.d.ts

@@ -1,24 +0,0 @@
-export interface SendGridPluginConfig {
-    apiKey: string;
-    templatePrefix: string;
-    sharedAccount?: boolean;
-    safetyMode: 'strict' | 'permissive';
-    rateLimits?: {
-        templatesPerMinute: number;
-        apiCallsPerSecond: number;
-    };
-    webhookConfig?: {
-        secret: string;
-        eventTypes: string[];
-    };
-}
-export interface ApiRequestOptions {
-    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
-    headers?: Record<string, string>;
-    body?: string;
-}
-export interface ApiResponse {
-    statusCode: number;
-    headers: Record<string, string>;
-    body: string;
-}

package/dist/types/config-types.js

@@ -1,9 +0,0 @@
-"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 });

package/dist/types/plugin-types.d.ts

@@ -1,79 +0,0 @@
-export interface PluginConfig {
-    [key: string]: unknown;
-}
-export interface ProviderCapability {
-    feature: string;
-    description: string;
-    methods: string[];
-    config: Record<string, unknown>;
-}
-export interface Template {
-    id: string;
-    name: string;
-    description?: string;
-    subject: string;
-    htmlContent: string;
-    textContent?: string;
-    category: string;
-    tags: string[];
-    version: string;
-    isActive: boolean;
-    context?: string;
-    variables?: Record<string, unknown>;
-    requiredVariables: string[];
-    providerTemplateIds?: Record<string, string>;
-    lastSyncedAt?: Record<string, Date>;
-    syncStatus?: Record<string, string>;
-    createdAt: Date;
-    updatedAt: Date;
-    createdBy: string;
-    lastModifiedBy: string;
-}
-export interface ProviderTemplate {
-    id: string;
-    name: string;
-    description?: string;
-    subject: string;
-    htmlContent: string;
-    textContent?: string;
-    version: string;
-    active: boolean;
-    createdAt: Date;
-    updatedAt: Date;
-}
-export interface TemplateVersion {
-    name: string;
-    subject: string;
-    htmlContent: string;
-    textContent?: string;
-    active: boolean;
-}
-export interface SyncResult {
-    success: boolean;
-    action: 'created' | 'updated' | 'deleted' | 'failed';
-    providerTemplateId?: string;
-    localTemplateId?: string;
-    error?: string;
-    metadata: Record<string, unknown>;
-}
-export interface ValidationResult {
-    isValid: boolean;
-    errors: string[];
-}
-export interface RouteConflict {
-    templateId: string;
-    conflicts: string[];
-}
-export interface DateRange {
-    start: Date;
-    end: Date;
-}
-export interface TemplateAnalytics {
-    templateId: string;
-    opens: number;
-    clicks: number;
-    bounces: number;
-    deliveries: number;
-    dateRange: DateRange;
-}
-export type FeatureConfig = Record<string, unknown>;

package/dist/types/plugin-types.js

@@ -1,9 +0,0 @@
-"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 });

package/dist/types/sendgrid-types.d.ts

@@ -1,82 +0,0 @@
-export interface VerifiedSender {
-    id: string;
-    email: string;
-    name: string;
-    isVerified: boolean;
-    domain: string;
-    verificationStatus: 'pending' | 'verified' | 'failed';
-    createdAt: Date;
-    lastVerifiedAt?: Date;
-}
-export interface SenderValidationResult {
-    isValid: boolean;
-    verifiedSender?: VerifiedSender;
-    domain: string;
-    domainMatches: VerifiedSender[];
-    errors: string[];
-    suggestions: string[];
-}
-export interface SendGridTemplateData {
-    id: string;
-    name: string;
-    generation: 'legacy' | 'dynamic';
-    updated_at: string;
-    versions?: SendGridTemplateVersion[];
-}
-export interface SendGridTemplateVersion {
-    id: string;
-    template_id: string;
-    active: number;
-    name: string;
-    html_content: string;
-    plain_content?: string;
-    subject: string;
-    updated_at: string;
-    editor: string;
-}
-export interface SendGridVerifiedSenderData {
-    id: number;
-    nickname: string;
-    from_email: string;
-    from_name: string;
-    reply_to: string;
-    reply_to_name: string;
-    address: string;
-    address2: string;
-    city: string;
-    state: string;
-    zip: string;
-    country: string;
-    verified: boolean;
-    locked: boolean;
-}
-export interface SendGridApiError extends Error {
-    statusCode?: number;
-    response?: unknown;
-}
-/**
- * Email attachment in the canonical format (matches @bernierllc/email-sender EmailAttachment).
- */
-export interface EmailAttachment {
-    filename: string;
-    content: string;
-    contentType?: string;
-    disposition?: 'attachment' | 'inline';
-}
-/**
- * SendGrid's attachment format for the v3 mail send API.
- */
-export interface SendGridAttachment {
-    content: string;
-    filename: string;
-    type?: string;
-    disposition?: string;
-}
-/**
- * SendGrid mail personalization/message payload fields related to
- * attachments and custom headers.
- */
-export interface SendGridMailPayload {
-    attachments?: SendGridAttachment[];
-    headers?: Record<string, string>;
-}

package/dist/types/sendgrid-types.js

@@ -1,9 +0,0 @@
-"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 });