@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/notifications/email/services/email-batch-send.batch.backend.service.js

@@ -0,0 +1,196 @@
+/**
+ * Email Batch Send Service
+ *
+ * Handles batch email sending via the queue system.
+ * Used for large recipient lists to avoid timeouts.
+ */
+import { z } from 'zod';
+import { createCustomBatchExecutionService, } from '../../../base-classes/services/batches/batches-cronjobs-custom-execution.service.js';
+import { CoreResourceType } from '@wildo-ai/saas-models';
+import { SAAS_SERVICE_TYPES } from '../../../inject/models/service-types.js';
+import { getGlobalContainer } from '../../../inject/models/container.js';
+// ═══════════════════════════════════════════════════════════════════════════
+// Input/Output Schemas
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Schema for a single email in the batch
+ */
+const EmailBatchItemSchema = z.object({
+    templateRef: z.string(),
+    locale: z.string(), // AvailableLanguage
+    type: z.string(), // EmailTemplateType
+    to: z.string(),
+    cc: z.array(z.string()).optional(),
+    bcc: z.array(z.string()).optional(),
+    replyTo: z.string().optional(),
+    from: z.string().optional(),
+    context: z.object({
+        currentObject: z.record(z.string(), z.unknown()),
+        objectContext: z.object({
+            primaryScopeContext: z.object({
+                appName: z.string(),
+                applicationId: z.string(),
+                organizationName: z.string().optional(),
+            }),
+        }),
+        userContext: z.object({
+            userId: z.string(),
+            email: z.string(),
+            name: z.string().optional(),
+            firstName: z.string().optional(),
+        }),
+        additionalContext: z.record(z.string(), z.unknown()).optional(),
+    }),
+    organizationId: z.string().optional(),
+});
+/**
+ * Input schema for batch email sending
+ */
+export const EmailBatchSendInputSchema = z.object({
+    /** Batch identifier for tracking */
+    batchId: z.string(),
+    /** List of emails to send */
+    emails: z.array(EmailBatchItemSchema),
+    /** Retry failed emails */
+    retryOnFailure: z.boolean().default(true),
+    /** Max retries per email */
+    maxRetries: z.number().default(3),
+});
+/**
+ * Result for a single email in the batch
+ */
+const EmailBatchResultItemSchema = z.object({
+    to: z.string(),
+    success: z.boolean(),
+    messageId: z.string().optional(),
+    error: z.string().optional(),
+    attempts: z.number(),
+});
+/**
+ * Output schema for batch email sending
+ */
+export const EmailBatchSendOutputSchema = z.object({
+    batchId: z.string(),
+    totalEmails: z.number(),
+    successCount: z.number(),
+    failedCount: z.number(),
+    results: z.array(EmailBatchResultItemSchema),
+    startedAt: z.string(),
+    completedAt: z.string(),
+    durationMs: z.number(),
+});
+// ═══════════════════════════════════════════════════════════════════════════
+// Batch Service Definition
+// ═══════════════════════════════════════════════════════════════════════════
+/**
+ * Create the email batch send service instance
+ */
+export const emailBatchSendService = createCustomBatchExecutionService({
+    input: EmailBatchSendInputSchema,
+    output: EmailBatchSendOutputSchema,
+    batchCronjob_Context: {
+        // Using EMAIL_TEMPLATES as the resource for access control context
+        // The actual operation is sending emails (batch), not creating templates
+        operationIdentifier: 'batch-send',
+        resourceIdentifier: CoreResourceType.EMAIL_TEMPLATES,
+    },
+    doHandle: async (input, { logger, servicesRegistry }) => {
+        const startedAt = new Date();
+        const logDebug = logger.debugByType('EmailBatchSend');
+        logDebug('Starting email batch send', {
+            batchId: input.batchId,
+            emailCount: input.emails.length,
+        });
+        // Get email service from global container since this is a batch job
+        const container = getGlobalContainer();
+        const emailService = container.get(SAAS_SERVICE_TYPES.EmailService);
+        const results = [];
+        let successCount = 0;
+        let failedCount = 0;
+        // Process each email
+        for (const emailItem of input.emails) {
+            let lastError;
+            let attempts = 0;
+            let success = false;
+            let messageId;
+            // Retry logic
+            const maxAttempts = input.retryOnFailure ? input.maxRetries : 1;
+            while (attempts < maxAttempts && !success) {
+                attempts++;
+                try {
+                    const result = await emailService.send({
+                        templateRef: emailItem.templateRef,
+                        locale: emailItem.locale,
+                        type: emailItem.type,
+                        to: emailItem.to,
+                        cc: emailItem.cc,
+                        bcc: emailItem.bcc,
+                        replyTo: emailItem.replyTo,
+                        from: emailItem.from,
+                        context: emailItem.context,
+                        organizationId: emailItem.organizationId,
+                    });
+                    if (result.success) {
+                        success = true;
+                        messageId = result.messageId;
+                        successCount++;
+                    }
+                    else {
+                        lastError = result.error || 'Unknown error';
+                    }
+                }
+                catch (error) {
+                    lastError = error instanceof Error ? error.message : String(error);
+                }
+                // Brief delay between retries
+                if (!success && attempts < maxAttempts) {
+                    await new Promise(resolve => setTimeout(resolve, 1000 * attempts));
+                }
+            }
+            if (!success) {
+                failedCount++;
+            }
+            results.push({
+                to: emailItem.to,
+                success,
+                messageId,
+                error: success ? undefined : lastError,
+                attempts,
+            });
+            // Log progress every 10 emails
+            if (results.length % 10 === 0) {
+                logDebug('Batch progress', {
+                    batchId: input.batchId,
+                    processed: results.length,
+                    total: input.emails.length,
+                    successCount,
+                    failedCount,
+                });
+            }
+        }
+        const completedAt = new Date();
+        const durationMs = completedAt.getTime() - startedAt.getTime();
+        logDebug('Email batch send completed', {
+            batchId: input.batchId,
+            totalEmails: input.emails.length,
+            successCount,
+            failedCount,
+            durationMs,
+        });
+        return {
+            batchId: input.batchId,
+            totalEmails: input.emails.length,
+            successCount,
+            failedCount,
+            results,
+            startedAt: startedAt.toISOString(),
+            completedAt: completedAt.toISOString(),
+            durationMs,
+        };
+    },
+});
+/**
+ * Batch operation identifier for queue registration
+ */
+export const EMAIL_BATCH_SEND_OPERATION = 'email.batch-send';
+//# sourceMappingURL=email-batch-send.batch.backend.service.js.map

package/dist/esm/notifications/email/services/email-batch-send.batch.backend.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-batch-send.batch.backend.service.js","sourceRoot":"","sources":["../../../../../src/notifications/email/services/email-batch-send.batch.backend.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/notifications/email/services/email-context-provider-registry.backend.service.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Email Context Provider Registry Backend Service
+ *
+ * Manages registration and resolution of email context providers.
+ * Custom apps register their providers at startup.
+ */
+import type { LoggerService } from '../../../monitoring/logger/services/logger.service.js';
+import { EmailContextProvider, EmailContextProviderInput, EmailContextProviderUtils } from '../../../notifications/email/models/email-context-provider.interface.js';
+export declare class EmailContextProviderRegistryBackendService {
+    private readonly logger;
+    private providers;
+    protected logDebug: (message: string, context?: Record<string, unknown>) => void;
+    constructor(logger: LoggerService);
+    /**
+     * Register a context provider
+     *
+     * @param provider - The provider to register
+     */
+    register(provider: EmailContextProvider): void;
+    /**
+     * Register multiple providers at once
+     */
+    registerAll(providers: EmailContextProvider[]): void;
+    /**
+     * Unregister a provider by ID
+     */
+    unregister(providerId: string): boolean;
+    /**
+     * Get all providers that match a template ref
+     */
+    getProvidersForTemplate(templateRef: string): EmailContextProvider[];
+    /**
+     * Build additional context by invoking all matching providers
+     *
+     * @param input - The context provider input
+     * @param utils - Platform utilities for providers
+     * @returns Combined additional context from all providers
+     */
+    buildAdditionalContext(input: EmailContextProviderInput, utils: EmailContextProviderUtils): Promise<Record<string, unknown>>;
+    /**
+     * Get all registered provider IDs
+     */
+    getRegisteredProviderIds(): string[];
+    /**
+     * Clear all registered providers
+     */
+    clear(): void;
+}
+//# sourceMappingURL=email-context-provider-registry.backend.service.d.ts.map

package/dist/esm/notifications/email/services/email-context-provider-registry.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-context-provider-registry.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/notifications/email/services/email-context-provider-registry.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EAE1B,MAAM,gFAAgF,CAAC;AAMxF,qBACa,0CAA0C;IAMhB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAL5D,OAAO,CAAC,SAAS,CAA8B;IAE/C,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;gBAG3B,MAAM,EAAE,aAAa;IAM3E;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAiB9C;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,oBAAoB,EAAE,GAAG,IAAI;IAMpD;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAYvC;;OAEG;IACH,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAQpE;;;;;;OAMG;IACG,sBAAsB,CAC1B,KAAK,EAAE,yBAAyB,EAChC,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAyCnC;;OAEG;IACH,wBAAwB,IAAI,MAAM,EAAE;IAIpC;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/esm/notifications/email/services/email-context-provider-registry.backend.service.js

@@ -0,0 +1,141 @@
+/**
+ * Email Context Provider Registry Backend Service
+ *
+ * Manages registration and resolution of email context providers.
+ * Custom apps register their providers at startup.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'inversify';
+import { SAAS_SERVICE_TYPES } from '../../../inject/models/service-types.js';
+import { matchesTemplateRefPattern, } from '../../../notifications/email/models/email-context-provider.interface.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// SERVICE
+// ─────────────────────────────────────────────────────────────────────────────
+let EmailContextProviderRegistryBackendService = class EmailContextProviderRegistryBackendService {
+    logger;
+    providers = [];
+    logDebug;
+    constructor(logger) {
+        this.logger = logger;
+        this.logDebug = this.logger.debugByType('EmailContextProviderRegistryBackendService');
+        this.logger.setDebugTypeLogging('EmailContextProviderRegistryBackendService', false);
+    }
+    /**
+     * Register a context provider
+     *
+     * @param provider - The provider to register
+     */
+    register(provider) {
+        // Check for duplicate provider IDs
+        const existing = this.providers.find(p => p.providerId === provider.providerId);
+        if (existing) {
+            this.logger.warn('Replacing existing email context provider', {
+                providerId: provider.providerId,
+            });
+            this.providers = this.providers.filter(p => p.providerId !== provider.providerId);
+        }
+        this.providers.push(provider);
+        this.logger.info('Email context provider registered', {
+            providerId: provider.providerId,
+            patterns: provider.templateRefPatterns,
+        });
+    }
+    /**
+     * Register multiple providers at once
+     */
+    registerAll(providers) {
+        for (const provider of providers) {
+            this.register(provider);
+        }
+    }
+    /**
+     * Unregister a provider by ID
+     */
+    unregister(providerId) {
+        const initialLength = this.providers.length;
+        this.providers = this.providers.filter(p => p.providerId !== providerId);
+        const removed = this.providers.length < initialLength;
+        if (removed) {
+            this.logger.info('Email context provider unregistered', { providerId });
+        }
+        return removed;
+    }
+    /**
+     * Get all providers that match a template ref
+     */
+    getProvidersForTemplate(templateRef) {
+        return this.providers.filter(provider => provider.templateRefPatterns.some(pattern => matchesTemplateRefPattern(templateRef, pattern)));
+    }
+    /**
+     * Build additional context by invoking all matching providers
+     *
+     * @param input - The context provider input
+     * @param utils - Platform utilities for providers
+     * @returns Combined additional context from all providers
+     */
+    async buildAdditionalContext(input, utils) {
+        const matchingProviders = this.getProvidersForTemplate(input.templateRef);
+        if (matchingProviders.length === 0) {
+            return {};
+        }
+        this.logDebug('Building additional context from providers', {
+            templateRef: input.templateRef,
+            providerCount: matchingProviders.length,
+            providerIds: matchingProviders.map(p => p.providerId),
+        });
+        // Run all providers and merge their results
+        const results = await Promise.all(matchingProviders.map(async (provider) => {
+            try {
+                const context = await provider.buildAdditionalContext(input, utils);
+                return { providerId: provider.providerId, context, success: true };
+            }
+            catch (err) {
+                const error = err;
+                this.logger.error('Email context provider failed', {
+                    providerId: provider.providerId,
+                    error: error.message,
+                });
+                return { providerId: provider.providerId, context: {}, success: false };
+            }
+        }));
+        // Merge all contexts (later providers override earlier ones)
+        const mergedContext = {};
+        for (const result of results) {
+            if (result.success) {
+                Object.assign(mergedContext, result.context);
+            }
+        }
+        return mergedContext;
+    }
+    /**
+     * Get all registered provider IDs
+     */
+    getRegisteredProviderIds() {
+        return this.providers.map(p => p.providerId);
+    }
+    /**
+     * Clear all registered providers
+     */
+    clear() {
+        this.providers = [];
+        this.logger.info('All email context providers cleared');
+    }
+};
+EmailContextProviderRegistryBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
+    __metadata("design:paramtypes", [Function])
+], EmailContextProviderRegistryBackendService);
+export { EmailContextProviderRegistryBackendService };
+//# sourceMappingURL=email-context-provider-registry.backend.service.js.map

package/dist/esm/notifications/email/services/email-context-provider-registry.backend.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-context-provider-registry.backend.service.js","sourceRoot":"","sources":["../../../../../src/notifications/email/services/email-context-provider-registry.backend.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/notifications/email/services/email-renderer.backend.service.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Email Renderer Backend Service
+ *
+ * Orchestrates the loading, compiling, and rendering of email templates.
+ * Handles template retrieval from database, caching, and React Email rendering.
+ */
+import type { LoggerService } from '../../../monitoring/logger/services/logger.service.js';
+import type { ErrorBuilderBackendService } from '../../../errors/services/error-builder.backend.service.js';
+import type { EmailTemplateCompilerBackendService } from './email-template-compiler.backend.service.js';
+import type { EmailTemplateSandboxBackendService } from './email-template-sandbox.backend.service.js';
+import { EmailTemplate, EmailTemplateContext } from '@wildo-ai/saas-models';
+import { AvailableLanguage } from '@wildo-ai/presets-components-models';
+import { type EmailBrandTokens } from '../../../notifications/email/utils/color-conversion.utils.js';
+export interface RenderedEmail {
+    subject: string;
+    bodyHtml: string;
+    bodyText: string;
+    templateRef: string;
+    locale: AvailableLanguage;
+}
+export interface RenderOptions {
+    /** Force fresh compilation (bypass cache) */
+    forceCompile?: boolean;
+    /** Organization ID for org-level header/footer override */
+    organizationId?: string;
+}
+export declare class EmailRendererBackendService {
+    private readonly logger;
+    private readonly errorBuilder;
+    private readonly compiler;
+    private readonly sandbox;
+    private compiledCache;
+    protected logDebug: (message: string, context?: Record<string, unknown>) => void;
+    constructor(logger: LoggerService, errorBuilder: ErrorBuilderBackendService, compiler: EmailTemplateCompilerBackendService, sandbox: EmailTemplateSandboxBackendService);
+    /**
+     * Render an email template with the given context
+     *
+     * @param template - The email template to render
+     * @param context - The context data for rendering
+     * @param brandTokens - Design tokens for styling (optional, uses defaults if not provided)
+     * @param options - Render options
+     * @returns Rendered email with subject and body
+     */
+    render(template: EmailTemplate, context: EmailTemplateContext, brandTokens?: EmailBrandTokens, options?: RenderOptions): Promise<RenderedEmail>;
+    /**
+     * Render subject line template with variable interpolation
+     * Supports nested paths like {{objectContext.primaryScopeContext.appName}}
+     */
+    private renderSubject;
+    /**
+     * Get a nested value from an object using dot notation path
+     */
+    private getNestedValue;
+    /**
+     * Get compiled template code, using cache or compiling fresh
+     */
+    private getCompiledTemplate;
+    /**
+     * Invalidate cache for a specific template
+     */
+    invalidateCache(templateRef: string, locale?: AvailableLanguage): void;
+    /**
+     * Clear entire template cache
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        entries: string[];
+    };
+}
+//# sourceMappingURL=email-renderer.backend.service.d.ts.map

package/dist/esm/notifications/email/services/email-renderer.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-renderer.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/notifications/email/services/email-renderer.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AACnH,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,2CAA2C,CAAC;AACrG,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,0CAA0C,CAAC;AACnG,OAAO,EACL,aAAa,EACb,oBAAoB,EAErB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,KAAK,gBAAgB,EAA+B,MAAM,qEAAqE,CAAC;AAMzI,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAYD,qBACa,2BAA2B;IAQD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACV,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR3E,OAAO,CAAC,aAAa,CAA4C;IAEjE,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;gBAG3B,MAAM,EAAE,aAAa,EACR,YAAY,EAAE,0BAA0B,EACtC,QAAQ,EAAE,mCAAmC,EAC9C,OAAO,EAAE,kCAAkC;IAM/G;;;;;;;;OAQG;IACG,MAAM,CACV,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,oBAAoB,EAC7B,WAAW,CAAC,EAAE,gBAAgB,EAC9B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,aAAa,CAAC;IA2EzB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkBtB;;OAEG;YACW,mBAAmB;IAyCjC;;OAEG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAkBtE;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;CAMrD"}