hazo_notify 1.0.2 → 1.1.1

package/dist/template_manager/index.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Template Manager Module
+ *
+ * Email template management with Handlebars rendering and database storage
+ *
+ * Usage:
+ * ```typescript
+ * import { send_template_email, seed_default_templates } from 'hazo_notify/template_manager';
+ * import { createHazoConnect } from 'hazo_connect/server';
+ *
+ * const hazo = createHazoConnect({ type: 'sqlite', sqlite: { database_path: './db.sqlite' } });
+ *
+ * // Seed default templates on app init
+ * await seed_default_templates(hazo, org_id, root_org_id);
+ *
+ * // Send templated email
+ * const result = await send_template_email({
+ *   template_name: 'welcome_email',
+ *   variables: { user_name: 'John', login_url: 'https://example.com/login' },
+ *   to: 'john@example.com',
+ *   subject: 'Welcome!'
+ * }, hazo, org_id);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERROR_MESSAGES = exports.TEMPLATE_REFERENCE_PATTERN = exports.VARIABLE_PATTERN = exports.MAX_CATEGORY_NAME_LENGTH = exports.MAX_TEMPLATE_NAME_LENGTH = exports.DEFAULT_CATEGORY_NAMES = exports.DEFAULT_TEMPLATE_NAMES = exports.TABLE_TEMPLATES = exports.TABLE_TEMPLATE_CATEGORY = exports.validate_provided_variables = exports.extract_variables_from_content = exports.validate_variable_name = exports.validate_category_name = exports.validate_template_name = exports.get_system_variable_definitions = exports.resolve_system_variables = exports.get_system_variables = exports.resolve_template_references = exports.extract_template_references = exports.resolve_variables = exports.invalidate_template_cache = exports.clear_template_cache = exports.render_handlebars_string = exports.render_handlebars = exports.seed_default_templates = exports.delete_template = exports.update_template = exports.create_template = exports.get_template_by_name = exports.get_template = exports.list_templates_by_category = exports.list_templates = exports.find_category_by_name = exports.delete_category = exports.update_category = exports.create_category = exports.get_category = exports.list_categories = exports.clear_config_cache = exports.get_all_variable_names = exports.get_template_variables = exports.load_template_config = exports.validate_template_variables = exports.preview_template = exports.render_template = exports.send_template_email = void 0;
+// Core functions
+var template_manager_1 = require("./template_manager");
+Object.defineProperty(exports, "send_template_email", { enumerable: true, get: function () { return template_manager_1.send_template_email; } });
+Object.defineProperty(exports, "render_template", { enumerable: true, get: function () { return template_manager_1.render_template; } });
+Object.defineProperty(exports, "preview_template", { enumerable: true, get: function () { return template_manager_1.preview_template; } });
+Object.defineProperty(exports, "validate_template_variables", { enumerable: true, get: function () { return template_manager_1.validate_template_variables; } });
+// Config
+var config_loader_1 = require("./config/config_loader");
+Object.defineProperty(exports, "load_template_config", { enumerable: true, get: function () { return config_loader_1.load_template_config; } });
+Object.defineProperty(exports, "get_template_variables", { enumerable: true, get: function () { return config_loader_1.get_template_variables; } });
+Object.defineProperty(exports, "get_all_variable_names", { enumerable: true, get: function () { return config_loader_1.get_all_variable_names; } });
+Object.defineProperty(exports, "clear_config_cache", { enumerable: true, get: function () { return config_loader_1.clear_config_cache; } });
+// Database operations
+var db_1 = require("./db");
+// Categories
+Object.defineProperty(exports, "list_categories", { enumerable: true, get: function () { return db_1.list_categories; } });
+Object.defineProperty(exports, "get_category", { enumerable: true, get: function () { return db_1.get_category; } });
+Object.defineProperty(exports, "create_category", { enumerable: true, get: function () { return db_1.create_category; } });
+Object.defineProperty(exports, "update_category", { enumerable: true, get: function () { return db_1.update_category; } });
+Object.defineProperty(exports, "delete_category", { enumerable: true, get: function () { return db_1.delete_category; } });
+Object.defineProperty(exports, "find_category_by_name", { enumerable: true, get: function () { return db_1.find_category_by_name; } });
+// Templates
+Object.defineProperty(exports, "list_templates", { enumerable: true, get: function () { return db_1.list_templates; } });
+Object.defineProperty(exports, "list_templates_by_category", { enumerable: true, get: function () { return db_1.list_templates_by_category; } });
+Object.defineProperty(exports, "get_template", { enumerable: true, get: function () { return db_1.get_template; } });
+Object.defineProperty(exports, "get_template_by_name", { enumerable: true, get: function () { return db_1.get_template_by_name; } });
+Object.defineProperty(exports, "create_template", { enumerable: true, get: function () { return db_1.create_template; } });
+Object.defineProperty(exports, "update_template", { enumerable: true, get: function () { return db_1.update_template; } });
+Object.defineProperty(exports, "delete_template", { enumerable: true, get: function () { return db_1.delete_template; } });
+Object.defineProperty(exports, "seed_default_templates", { enumerable: true, get: function () { return db_1.seed_default_templates; } });
+// Engine
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "render_handlebars", { enumerable: true, get: function () { return engine_1.render_handlebars; } });
+Object.defineProperty(exports, "render_handlebars_string", { enumerable: true, get: function () { return engine_1.render_handlebars_string; } });
+Object.defineProperty(exports, "clear_template_cache", { enumerable: true, get: function () { return engine_1.clear_template_cache; } });
+Object.defineProperty(exports, "invalidate_template_cache", { enumerable: true, get: function () { return engine_1.invalidate_template_cache; } });
+Object.defineProperty(exports, "resolve_variables", { enumerable: true, get: function () { return engine_1.resolve_variables; } });
+Object.defineProperty(exports, "extract_template_references", { enumerable: true, get: function () { return engine_1.extract_template_references; } });
+Object.defineProperty(exports, "resolve_template_references", { enumerable: true, get: function () { return engine_1.resolve_template_references; } });
+// Utils
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "get_system_variables", { enumerable: true, get: function () { return utils_1.get_system_variables; } });
+Object.defineProperty(exports, "resolve_system_variables", { enumerable: true, get: function () { return utils_1.resolve_system_variables; } });
+Object.defineProperty(exports, "get_system_variable_definitions", { enumerable: true, get: function () { return utils_1.get_system_variable_definitions; } });
+Object.defineProperty(exports, "validate_template_name", { enumerable: true, get: function () { return utils_1.validate_template_name; } });
+Object.defineProperty(exports, "validate_category_name", { enumerable: true, get: function () { return utils_1.validate_category_name; } });
+Object.defineProperty(exports, "validate_variable_name", { enumerable: true, get: function () { return utils_1.validate_variable_name; } });
+Object.defineProperty(exports, "extract_variables_from_content", { enumerable: true, get: function () { return utils_1.extract_variables_from_content; } });
+Object.defineProperty(exports, "validate_provided_variables", { enumerable: true, get: function () { return utils_1.validate_provided_variables; } });
+// Constants
+var constants_1 = require("./config/constants");
+Object.defineProperty(exports, "TABLE_TEMPLATE_CATEGORY", { enumerable: true, get: function () { return constants_1.TABLE_TEMPLATE_CATEGORY; } });
+Object.defineProperty(exports, "TABLE_TEMPLATES", { enumerable: true, get: function () { return constants_1.TABLE_TEMPLATES; } });
+Object.defineProperty(exports, "DEFAULT_TEMPLATE_NAMES", { enumerable: true, get: function () { return constants_1.DEFAULT_TEMPLATE_NAMES; } });
+Object.defineProperty(exports, "DEFAULT_CATEGORY_NAMES", { enumerable: true, get: function () { return constants_1.DEFAULT_CATEGORY_NAMES; } });
+Object.defineProperty(exports, "MAX_TEMPLATE_NAME_LENGTH", { enumerable: true, get: function () { return constants_1.MAX_TEMPLATE_NAME_LENGTH; } });
+Object.defineProperty(exports, "MAX_CATEGORY_NAME_LENGTH", { enumerable: true, get: function () { return constants_1.MAX_CATEGORY_NAME_LENGTH; } });
+Object.defineProperty(exports, "VARIABLE_PATTERN", { enumerable: true, get: function () { return constants_1.VARIABLE_PATTERN; } });
+Object.defineProperty(exports, "TEMPLATE_REFERENCE_PATTERN", { enumerable: true, get: function () { return constants_1.TEMPLATE_REFERENCE_PATTERN; } });
+Object.defineProperty(exports, "ERROR_MESSAGES", { enumerable: true, get: function () { return constants_1.ERROR_MESSAGES; } });
+//# sourceMappingURL=index.js.map

package/dist/template_manager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/template_manager/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;AAEH,iBAAiB;AACjB,uDAK4B;AAJ1B,uHAAA,mBAAmB,OAAA;AACnB,mHAAA,eAAe,OAAA;AACf,oHAAA,gBAAgB,OAAA;AAChB,+HAAA,2BAA2B,OAAA;AAG7B,SAAS;AACT,wDAKgC;AAJ9B,qHAAA,oBAAoB,OAAA;AACpB,uHAAA,sBAAsB,OAAA;AACtB,uHAAA,sBAAsB,OAAA;AACtB,mHAAA,kBAAkB,OAAA;AAGpB,sBAAsB;AACtB,2BAiBc;AAhBZ,aAAa;AACb,qGAAA,eAAe,OAAA;AACf,kGAAA,YAAY,OAAA;AACZ,qGAAA,eAAe,OAAA;AACf,qGAAA,eAAe,OAAA;AACf,qGAAA,eAAe,OAAA;AACf,2GAAA,qBAAqB,OAAA;AACrB,YAAY;AACZ,oGAAA,cAAc,OAAA;AACd,gHAAA,0BAA0B,OAAA;AAC1B,kGAAA,YAAY,OAAA;AACZ,0GAAA,oBAAoB,OAAA;AACpB,qGAAA,eAAe,OAAA;AACf,qGAAA,eAAe,OAAA;AACf,qGAAA,eAAe,OAAA;AACf,4GAAA,sBAAsB,OAAA;AAGxB,SAAS;AACT,mCAQkB;AAPhB,2GAAA,iBAAiB,OAAA;AACjB,kHAAA,wBAAwB,OAAA;AACxB,8GAAA,oBAAoB,OAAA;AACpB,mHAAA,yBAAyB,OAAA;AACzB,2GAAA,iBAAiB,OAAA;AACjB,qHAAA,2BAA2B,OAAA;AAC3B,qHAAA,2BAA2B,OAAA;AAG7B,QAAQ;AACR,iCASiB;AARf,6GAAA,oBAAoB,OAAA;AACpB,iHAAA,wBAAwB,OAAA;AACxB,wHAAA,+BAA+B,OAAA;AAC/B,+GAAA,sBAAsB,OAAA;AACtB,+GAAA,sBAAsB,OAAA;AACtB,+GAAA,sBAAsB,OAAA;AACtB,uHAAA,8BAA8B,OAAA;AAC9B,oHAAA,2BAA2B,OAAA;AAG7B,YAAY;AACZ,gDAU4B;AAT1B,oHAAA,uBAAuB,OAAA;AACvB,4GAAA,eAAe,OAAA;AACf,mHAAA,sBAAsB,OAAA;AACtB,mHAAA,sBAAsB,OAAA;AACtB,qHAAA,wBAAwB,OAAA;AACxB,qHAAA,wBAAwB,OAAA;AACxB,6GAAA,gBAAgB,OAAA;AAChB,uHAAA,0BAA0B,OAAA;AAC1B,2GAAA,cAAc,OAAA"}

package/dist/template_manager/template_manager.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Template Manager Core Service
+ *
+ * Core functions for rendering and sending templated emails
+ */
+import type { HazoConnectInstance, TemplateManagerConfig, SendTemplateEmailOptions, SendTemplateEmailResponse, TemplateRenderResult, Logger } from './types';
+/**
+ * Render a template with variables (without sending)
+ *
+ * This function fetches a template from the database, resolves all variables
+ * (including system variables), processes @template references, and renders
+ * the final content using Handlebars.
+ *
+ * @param template_name - Name of the template to render
+ * @param variables - User-provided variables to substitute
+ * @param hazo_connect - Database connection instance
+ * @param org_id - Organization ID
+ * @param config - Optional config override (loads from file if not provided)
+ * @param logger - Optional logger instance
+ * @returns Render result with HTML and text content
+ */
+export declare function render_template(template_name: string, variables: Record<string, string>, hazo_connect: HazoConnectInstance, org_id: string, config?: TemplateManagerConfig, logger?: Logger): Promise<TemplateRenderResult>;
+/**
+ * Send an email using a named template
+ *
+ * This function:
+ * 1. Fetches the template from the database
+ * 2. Resolves all variables (user + system)
+ * 3. Processes @template references
+ * 4. Renders with Handlebars
+ * 5. Sends via the emailer module
+ *
+ * @param options - Template email options
+ * @param hazo_connect - Database connection instance
+ * @param org_id - Organization ID
+ * @param config - Optional config override
+ * @returns Email send response
+ */
+export declare function send_template_email(options: SendTemplateEmailOptions, hazo_connect: HazoConnectInstance, org_id: string, config?: TemplateManagerConfig): Promise<SendTemplateEmailResponse>;
+/**
+ * Preview a template render without saving or sending
+ *
+ * Useful for the UI to show a preview of what the email will look like
+ *
+ * @param html_content - Raw HTML template content
+ * @param text_content - Raw text template content
+ * @param variables - Variables to substitute
+ * @param hazo_connect - Database connection (for @template resolution)
+ * @param org_id - Organization ID
+ * @returns Render result
+ */
+export declare function preview_template(html_content: string, text_content: string, variables: Record<string, string>, hazo_connect?: HazoConnectInstance, org_id?: string): Promise<TemplateRenderResult>;
+/**
+ * Validate template variables before rendering
+ *
+ * Checks that all required variables are provided
+ *
+ * @param template_name - Name of the template
+ * @param variables - Variables to validate
+ * @param hazo_connect - Database connection
+ * @param org_id - Organization ID
+ * @returns Validation result
+ */
+export declare function validate_template_variables(template_name: string, variables: Record<string, string>, hazo_connect: HazoConnectInstance, org_id: string): Promise<{
+    valid: boolean;
+    missing: string[];
+    message: string;
+}>;
+//# sourceMappingURL=template_manager.d.ts.map

package/dist/template_manager/template_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template_manager.d.ts","sourceRoot":"","sources":["../../src/lib/template_manager/template_manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,MAAM,EACP,MAAM,SAAS,CAAC;AAgBjB;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,YAAY,EAAE,mBAAmB,EACjC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,CAmH/B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,wBAAwB,EACjC,YAAY,EAAE,mBAAmB,EACjC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,yBAAyB,CAAC,CA6HpC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,YAAY,CAAC,EAAE,mBAAmB,EAClC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,oBAAoB,CAAC,CAyC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,YAAY,EAAE,mBAAmB,EACjC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA6DjE"}

package/dist/template_manager/template_manager.js

@@ -0,0 +1,335 @@
+"use strict";
+/**
+ * Template Manager Core Service
+ *
+ * Core functions for rendering and sending templated emails
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.render_template = render_template;
+exports.send_template_email = send_template_email;
+exports.preview_template = preview_template;
+exports.validate_template_variables = validate_template_variables;
+const emailer_1 = require("../emailer/emailer");
+const logger_1 = require("../emailer/utils/logger");
+const config_loader_1 = require("./config/config_loader");
+const constants_1 = require("./config/constants");
+const template_repository_1 = require("./db/template_repository");
+const engine_1 = require("./engine");
+const validation_1 = require("./utils/validation");
+/**
+ * Render a template with variables (without sending)
+ *
+ * This function fetches a template from the database, resolves all variables
+ * (including system variables), processes @template references, and renders
+ * the final content using Handlebars.
+ *
+ * @param template_name - Name of the template to render
+ * @param variables - User-provided variables to substitute
+ * @param hazo_connect - Database connection instance
+ * @param org_id - Organization ID
+ * @param config - Optional config override (loads from file if not provided)
+ * @param logger - Optional logger instance
+ * @returns Render result with HTML and text content
+ */
+async function render_template(template_name, variables, hazo_connect, org_id, config, logger) {
+    const log = logger || (0, logger_1.create_fallback_logger)('template_manager');
+    const filename = 'template_manager.ts';
+    const function_name = 'render_template';
+    try {
+        log.info('Rendering template', {
+            filename,
+            function_name,
+            template_name,
+            org_id,
+        });
+        // Validate inputs
+        if (!hazo_connect) {
+            return {
+                success: false,
+                error: constants_1.ERROR_MESSAGES.DB_CONNECTION_REQUIRED,
+                message: constants_1.ERROR_MESSAGES.DB_CONNECTION_REQUIRED,
+            };
+        }
+        // Load config
+        const cfg = config || (0, config_loader_1.load_template_config)();
+        // Fetch template from database
+        const template_result = await (0, template_repository_1.get_template_by_name)(hazo_connect, org_id, template_name);
+        if (!template_result.success || !template_result.data) {
+            log.warn('Template not found', {
+                filename,
+                function_name,
+                template_name,
+                error: template_result.error,
+            });
+            return {
+                success: false,
+                error: template_result.error || constants_1.ERROR_MESSAGES.TEMPLATE_NOT_FOUND,
+                message: template_result.message || constants_1.ERROR_MESSAGES.TEMPLATE_NOT_FOUND,
+            };
+        }
+        const template = template_result.data;
+        // Merge user variables with system variables
+        const all_variables = (0, engine_1.resolve_variables)(variables);
+        // Resolve @template references in both HTML and text
+        const resolved_result = await (0, engine_1.resolve_all_template_references)(template.template_html, template.template_text, all_variables, hazo_connect, org_id);
+        if (!resolved_result.success) {
+            log.warn('Failed to resolve template references', {
+                filename,
+                function_name,
+                template_name,
+                error: resolved_result.error,
+            });
+            return resolved_result;
+        }
+        // Render with Handlebars
+        const render_result = (0, engine_1.render_handlebars)(resolved_result.rendered_html || template.template_html, resolved_result.rendered_text || template.template_text, all_variables, template_name);
+        if (!render_result.success) {
+            log.warn('Failed to render template', {
+                filename,
+                function_name,
+                template_name,
+                error: render_result.error,
+            });
+            return render_result;
+        }
+        log.info('Template rendered successfully', {
+            filename,
+            function_name,
+            template_name,
+        });
+        return {
+            success: true,
+            rendered_html: render_result.rendered_html,
+            rendered_text: render_result.rendered_text,
+            message: 'Template rendered successfully',
+        };
+    }
+    catch (error) {
+        const error_message = error instanceof Error ? error.message : 'Unknown error occurred';
+        log.error('Error rendering template', {
+            filename,
+            function_name,
+            template_name,
+            error: error_message,
+        });
+        return {
+            success: false,
+            error: error_message,
+            message: `Failed to render template: ${error_message}`,
+        };
+    }
+}
+/**
+ * Send an email using a named template
+ *
+ * This function:
+ * 1. Fetches the template from the database
+ * 2. Resolves all variables (user + system)
+ * 3. Processes @template references
+ * 4. Renders with Handlebars
+ * 5. Sends via the emailer module
+ *
+ * @param options - Template email options
+ * @param hazo_connect - Database connection instance
+ * @param org_id - Organization ID
+ * @param config - Optional config override
+ * @returns Email send response
+ */
+async function send_template_email(options, hazo_connect, org_id, config) {
+    const log = options.logger
+        ? (0, logger_1.get_logger)(options.logger)
+        : (0, logger_1.create_fallback_logger)('template_manager');
+    const filename = 'template_manager.ts';
+    const function_name = 'send_template_email';
+    try {
+        log.info('Sending template email', {
+            filename,
+            function_name,
+            template_name: options.template_name,
+            to: options.to,
+            org_id,
+        });
+        // Validate inputs
+        if (!hazo_connect) {
+            return {
+                success: false,
+                error: constants_1.ERROR_MESSAGES.DB_CONNECTION_REQUIRED,
+                message: constants_1.ERROR_MESSAGES.DB_CONNECTION_REQUIRED,
+            };
+        }
+        // Render the template
+        const render_result = await render_template(options.template_name, options.variables, hazo_connect, org_id, config, log);
+        if (!render_result.success) {
+            return {
+                success: false,
+                error: render_result.error,
+                message: render_result.message,
+            };
+        }
+        // Build subject - use provided subject or template name as fallback
+        const subject = options.subject ||
+            options.template_name
+                .replace(/_/g, ' ')
+                .replace(/\b\w/g, (l) => l.toUpperCase());
+        // Send the email using the emailer module
+        const email_response = await (0, emailer_1.send_email)({
+            to: options.to,
+            subject,
+            content: {
+                html: render_result.rendered_html,
+                text: render_result.rendered_text,
+            },
+            from: options.from,
+            from_name: options.from_name,
+            reply_to: options.reply_to,
+            cc: options.cc,
+            bcc: options.bcc,
+            attachments: options.attachments,
+            logger: log,
+        });
+        const is_production = process.env.NODE_ENV === 'production';
+        if (email_response.success) {
+            log.info('Template email sent successfully', {
+                filename,
+                function_name,
+                template_name: options.template_name,
+                message_id: email_response.message_id,
+            });
+            return {
+                success: true,
+                message_id: email_response.message_id,
+                message: email_response.message || 'Email sent successfully',
+                rendered_html: is_production ? undefined : render_result.rendered_html,
+                rendered_text: is_production ? undefined : render_result.rendered_text,
+                raw_response: email_response.raw_response,
+            };
+        }
+        else {
+            log.warn('Failed to send template email', {
+                filename,
+                function_name,
+                template_name: options.template_name,
+                error: email_response.error,
+            });
+            return {
+                success: false,
+                error: email_response.error,
+                message: email_response.message || 'Failed to send email',
+                rendered_html: is_production ? undefined : render_result.rendered_html,
+                rendered_text: is_production ? undefined : render_result.rendered_text,
+                raw_response: email_response.raw_response,
+            };
+        }
+    }
+    catch (error) {
+        const error_message = error instanceof Error ? error.message : 'Unknown error occurred';
+        const error_string = error instanceof Error ? error.toString() : String(error);
+        const stack = error instanceof Error ? error.stack : undefined;
+        const is_production = process.env.NODE_ENV === 'production';
+        log.error('Error sending template email', {
+            filename,
+            function_name,
+            template_name: options.template_name,
+            error: error_message,
+        });
+        return {
+            success: false,
+            error: error_message,
+            message: `Failed to send template email: ${error_message}`,
+            raw_response: is_production
+                ? undefined
+                : { error: error_string, stack },
+        };
+    }
+}
+/**
+ * Preview a template render without saving or sending
+ *
+ * Useful for the UI to show a preview of what the email will look like
+ *
+ * @param html_content - Raw HTML template content
+ * @param text_content - Raw text template content
+ * @param variables - Variables to substitute
+ * @param hazo_connect - Database connection (for @template resolution)
+ * @param org_id - Organization ID
+ * @returns Render result
+ */
+async function preview_template(html_content, text_content, variables, hazo_connect, org_id) {
+    try {
+        // Merge with system variables
+        const all_variables = (0, engine_1.resolve_variables)(variables);
+        // If hazo_connect is provided, resolve @template references
+        let resolved_html = html_content;
+        let resolved_text = text_content;
+        if (hazo_connect && org_id) {
+            const resolved_result = await (0, engine_1.resolve_all_template_references)(html_content, text_content, all_variables, hazo_connect, org_id);
+            if (resolved_result.success) {
+                resolved_html = resolved_result.rendered_html || html_content;
+                resolved_text = resolved_result.rendered_text || text_content;
+            }
+        }
+        // Render with Handlebars
+        const render_result = (0, engine_1.render_handlebars)(resolved_html, resolved_text, all_variables);
+        return render_result;
+    }
+    catch (error) {
+        const error_message = error instanceof Error ? error.message : 'Unknown error occurred';
+        return {
+            success: false,
+            error: error_message,
+            message: `Failed to preview template: ${error_message}`,
+        };
+    }
+}
+/**
+ * Validate template variables before rendering
+ *
+ * Checks that all required variables are provided
+ *
+ * @param template_name - Name of the template
+ * @param variables - Variables to validate
+ * @param hazo_connect - Database connection
+ * @param org_id - Organization ID
+ * @returns Validation result
+ */
+async function validate_template_variables(template_name, variables, hazo_connect, org_id) {
+    try {
+        // Fetch template
+        const template_result = await (0, template_repository_1.get_template_by_name)(hazo_connect, org_id, template_name);
+        if (!template_result.success || !template_result.data) {
+            return {
+                valid: false,
+                missing: [],
+                message: template_result.message || constants_1.ERROR_MESSAGES.TEMPLATE_NOT_FOUND,
+            };
+        }
+        const template = template_result.data;
+        const config = (0, config_loader_1.load_template_config)();
+        // Get system variable names
+        const system_var_names = config.system_email_template_variables.map((v) => v.variable_name);
+        // Validate HTML content
+        const html_validation = (0, validation_1.validate_provided_variables)(template.template_html, variables, system_var_names);
+        // Validate text content
+        const text_validation = (0, validation_1.validate_provided_variables)(template.template_text, variables, system_var_names);
+        // Combine missing variables
+        const all_missing = [
+            ...new Set([...html_validation.missing, ...text_validation.missing]),
+        ];
+        return {
+            valid: all_missing.length === 0,
+            missing: all_missing,
+            message: all_missing.length === 0
+                ? 'All required variables provided'
+                : `Missing variables: ${all_missing.join(', ')}`,
+        };
+    }
+    catch (error) {
+        const error_message = error instanceof Error ? error.message : 'Unknown error occurred';
+        return {
+            valid: false,
+            missing: [],
+            message: `Validation error: ${error_message}`,
+        };
+    }
+}
+//# sourceMappingURL=template_manager.js.map

package/dist/template_manager/template_manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template_manager.js","sourceRoot":"","sources":["../../src/lib/template_manager/template_manager.ts"],"names":[],"mappings":"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"}