@nauth-toolkit/core 0.1.14 → 0.1.17

package/dist/storage/memory-storage.adapter.js

@@ -1,71 +1,158 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MemoryStorageAdapter = void 0;
+/**
+ * In-memory storage adapter for development and single-server deployments
+ *
+ * CRITICAL LIMITATIONS FOR PRODUCTION:
+ * - Data is lost on server restart
+ * - Data is NOT shared across multiple server instances/containers
+ * - Rate limiting may be bypassed in ECS/multi-container deployments
+ * - NOT suitable for production clusters with multiple containers
+ *
+ * RECOMMENDATIONS:
+ * - Single ECS task: Acceptable (data lost on restart)
+ * - Multi-task/container ECS: Use Redis adapter (coming soon)
+ * - Production: Plan to implement Redis-backed storage adapter
+ *
+ * CURRENT BEHAVIOR:
+ * Rate limiting works per-container, not globally across containers
+ *
+ * @example
+ * ```typescript
+ * const storage = new MemoryStorageAdapter();
+ * await storage.initialize();
+ * await storage.set('key', 'value', 60); // Set with 60 second TTL
+ * const value = await storage.get('key');
+ * ```
+ */
 class MemoryStorageAdapter {
+    // Main key-value store with expiration support
     store = new Map();
+    // Hash storage for complex data structures (similar to Redis hashes)
     hashes = new Map();
+    // List storage for ordered collections (similar to Redis lists)
     lists = new Map();
+    // Interval timer for automatic cleanup of expired keys
     cleanupInterval = null;
+    /**
+     * Initialize the storage adapter
+     * Starts a background cleanup job to remove expired keys
+     */
     async initialize() {
+        // Start cleanup interval to remove expired keys every minute
         this.cleanupInterval = setInterval(() => {
             this.cleanupExpired();
-        }, 60000);
+        }, 60000); // 60,000ms = 1 minute
     }
+    /**
+     * Check if the storage adapter is healthy and operational
+     * @returns Always returns true for in-memory storage
+     */
     async isHealthy() {
         return true;
     }
+    // ============================================================================
+    // Basic Key-Value Operations
+    // ============================================================================
+    /**
+     * Get a value by key
+     * Automatically removes and returns null if the key has expired
+     *
+     * @param key - The key to retrieve
+     * @returns The stored value or null if not found/expired
+     */
     async get(key) {
         const stored = this.store.get(key);
+        // Key doesn't exist
         if (!stored)
             return null;
+        // Check if key has expired
         if (stored.expiresAt && stored.expiresAt < Date.now()) {
-            this.store.delete(key);
+            this.store.delete(key); // Clean up expired key
             return null;
         }
         return stored.value;
     }
+    /**
+     * Set a key-value pair with optional TTL (time to live)
+     *
+     * @param key - The key to store
+     * @param value - The value to store
+     * @param ttl - Time to live in seconds (optional)
+     */
     async set(key, value, ttlSeconds, options) {
+        // For NX option, check if key exists and is not expired
         if (options?.nx) {
             const existing = this.store.get(key);
             if (existing) {
+                // Check if existing key is expired
                 if (existing.expiresAt && existing.expiresAt < Date.now()) {
+                    // Key exists but is expired - treat as non-existent and allow set
                     this.store.delete(key);
                 }
                 else {
+                    // Key exists and is not expired - NX failed
                     return null;
                 }
             }
         }
         const stored = { value };
+        // If TTL is provided, calculate expiration timestamp
         if (ttlSeconds) {
-            stored.expiresAt = Date.now() + ttlSeconds * 1000;
+            stored.expiresAt = Date.now() + ttlSeconds * 1000; // Convert seconds to milliseconds
         }
         this.store.set(key, stored);
         return value;
     }
+    /**
+     * Delete a key from storage
+     * @param key - The key to delete
+     */
     async del(key) {
         this.store.delete(key);
     }
+    /**
+     * Check if a key exists and is not expired
+     * @param key - The key to check
+     * @returns True if key exists and is valid, false otherwise
+     */
     async exists(key) {
         const value = await this.get(key);
         return value !== null;
     }
+    // ============================================================================
+    // Atomic Operations (for counters and rate limiting)
+    // ============================================================================
+    /**
+     * Increment a counter stored at key
+     * If the key doesn't exist, it's initialized to 0 before incrementing
+     * Preserves TTL if the key already exists with an expiration
+     *
+     * @param key - The key to increment
+     * @param ttlSeconds - Optional TTL in seconds to set when creating a new key (only applied if key doesn't exist)
+     * @returns The new value after incrementing
+     */
     async incr(key, ttlSeconds) {
         const stored = this.store.get(key);
+        // Check if key exists and is not expired
         let currentValue = '0';
         let existingExpiry;
         const wasNewKey = !stored || (stored.expiresAt && stored.expiresAt < Date.now());
         if (stored) {
             if (stored.expiresAt && stored.expiresAt < Date.now()) {
+                // Key expired - treat as non-existent
                 this.store.delete(key);
             }
             else {
+                // Key exists and is valid - preserve expiry
                 currentValue = stored.value;
                 existingExpiry = stored.expiresAt;
             }
         }
         const newValue = (parseInt(currentValue || '0', 10) + 1).toString();
         const newStored = { value: newValue };
+        // Use provided TTL for new keys, otherwise preserve existing expiry
         if (wasNewKey && ttlSeconds !== undefined) {
             newStored.expiresAt = Date.now() + ttlSeconds * 1000;
         }
@@ -75,32 +162,67 @@ class MemoryStorageAdapter {
         this.store.set(key, newStored);
         return parseInt(newValue, 10);
     }
+    /**
+     * Decrement a counter stored at key
+     * If the key doesn't exist, it's initialized to 0 before decrementing
+     *
+     * @param key - The key to decrement
+     * @returns The new value after decrementing
+     */
     async decr(key) {
         const current = await this.get(key);
         const newValue = (parseInt(current || '0', 10) - 1).toString();
         await this.set(key, newValue);
         return parseInt(newValue, 10);
     }
+    /**
+     * Set expiration time on an existing key
+     * @param key - The key to set expiration on
+     * @param ttl - Time to live in seconds
+     */
     async expire(key, ttl) {
         const stored = this.store.get(key);
         if (stored) {
-            stored.expiresAt = Date.now() + ttl * 1000;
+            stored.expiresAt = Date.now() + ttl * 1000; // Convert to milliseconds
             this.store.set(key, stored);
         }
     }
+    /**
+     * Get the time to live (TTL) for a key
+     * @param key - The key to check
+     * @returns Seconds until expiration, -1 if no expiration, -2 if key doesn't exist
+     */
     async ttl(key) {
         const stored = this.store.get(key);
+        // Key doesn't exist
         if (!stored)
             return -2;
+        // Key exists but has no expiration
         if (!stored.expiresAt)
             return -1;
+        // Calculate remaining seconds
         const remaining = Math.floor((stored.expiresAt - Date.now()) / 1000);
-        return remaining > 0 ? remaining : -2;
+        return remaining > 0 ? remaining : -2; // Return -2 if already expired
     }
+    // ============================================================================
+    // Hash Operations (for complex data structures)
+    // ============================================================================
+    /**
+     * Get a field value from a hash
+     * @param key - Hash key
+     * @param field - Field name
+     * @returns Field value or null if not found
+     */
     async hget(key, field) {
         const hash = this.hashes.get(key);
         return hash?.get(field) ?? null;
     }
+    /**
+     * Set a field value in a hash
+     * @param key - Hash key
+     * @param field - Field name
+     * @param value - Field value
+     */
     async hset(key, field, value) {
         let hash = this.hashes.get(key);
         if (!hash) {
@@ -109,12 +231,23 @@ class MemoryStorageAdapter {
         }
         hash.set(field, value);
     }
+    /**
+     * Get all fields and values from a hash
+     * @param key - Hash key
+     * @returns Object with all field-value pairs
+     */
     async hgetall(key) {
         const hash = this.hashes.get(key);
         if (!hash)
             return {};
         return Object.fromEntries(hash.entries());
     }
+    /**
+     * Delete one or more fields from a hash
+     * @param key - Hash key
+     * @param fields - Field names to delete
+     * @returns Number of fields deleted
+     */
     async hdel(key, ...fields) {
         const hash = this.hashes.get(key);
         if (!hash)
@@ -125,19 +258,35 @@ class MemoryStorageAdapter {
                 deleted++;
             }
         }
+        // Clean up empty hash
         if (hash.size === 0) {
             this.hashes.delete(key);
         }
         return deleted;
     }
+    // ============================================================================
+    // List Operations (for ordered collections)
+    // ============================================================================
+    /**
+     * Push value to the left (beginning) of a list
+     * @param key - List key
+     * @param value - Value to push
+     */
     async lpush(key, value) {
         let list = this.lists.get(key);
         if (!list) {
             list = [];
             this.lists.set(key, list);
         }
-        list.unshift(value);
+        list.unshift(value); // Add to beginning
     }
+    /**
+     * Get a range of elements from a list
+     * @param key - List key
+     * @param start - Start index (0-based)
+     * @param stop - Stop index (-1 for end of list)
+     * @returns Array of values in range
+     */
     async lrange(key, start, stop) {
         const list = this.lists.get(key);
         if (!list)
@@ -145,14 +294,34 @@ class MemoryStorageAdapter {
         const end = stop === -1 ? list.length : stop + 1;
         return list.slice(start, end);
     }
+    /**
+     * Get the length of a list
+     * @param key - List key
+     * @returns List length
+     */
     async llen(key) {
         const list = this.lists.get(key);
         return list?.length ?? 0;
     }
+    // ============================================================================
+    // Pattern Operations (for bulk operations)
+    // ============================================================================
+    /**
+     * Find all keys matching a pattern
+     * @param pattern - Glob pattern (* and ? wildcards supported)
+     * @returns Array of matching keys
+     */
     async keys(pattern) {
         const regex = this.patternToRegex(pattern);
         return Array.from(this.store.keys()).filter((key) => regex.test(key));
     }
+    /**
+     * Iterate over keys matching a pattern (cursor-based)
+     * @param cursor - Cursor position (0 to start)
+     * @param pattern - Glob pattern
+     * @param count - Number of keys to return
+     * @returns Tuple of [new cursor, keys array]
+     */
     async scan(cursor, pattern, count) {
         const allKeys = await this.keys(pattern);
         const start = cursor;
@@ -161,32 +330,58 @@ class MemoryStorageAdapter {
         const newCursor = end >= allKeys.length ? 0 : end;
         return [newCursor, keys];
     }
+    // ============================================================================
+    // Cleanup & Lifecycle
+    // ============================================================================
+    /**
+     * Run cleanup of expired keys
+     */
     async cleanup() {
         this.cleanupExpired();
     }
+    /**
+     * Disconnect and cleanup all resources
+     */
     async disconnect() {
+        // Stop cleanup interval
         if (this.cleanupInterval) {
             clearInterval(this.cleanupInterval);
             this.cleanupInterval = null;
         }
+        // Clear all storage
         this.store.clear();
         this.hashes.clear();
         this.lists.clear();
     }
+    // ============================================================================
+    // Private Helper Methods
+    // ============================================================================
+    /**
+     * Remove all expired keys from storage
+     */
     cleanupExpired() {
         const now = Date.now();
         const keysToDelete = [];
+        // Find all expired keys
         for (const [key, stored] of this.store.entries()) {
             if (stored.expiresAt && stored.expiresAt < now) {
                 keysToDelete.push(key);
             }
         }
+        // Delete expired keys
         for (const key of keysToDelete) {
             this.store.delete(key);
         }
     }
+    /**
+     * Convert a glob pattern to a regular expression
+     * @param pattern - Glob pattern (* and ? wildcards)
+     * @returns RegExp for pattern matching
+     */
     patternToRegex(pattern) {
+        // Escape regex special characters except * and ?
         const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+        // Convert glob wildcards to regex
         const regex = escaped.replace(/\*/g, '.*').replace(/\?/g, '.');
         return new RegExp(`^${regex}$`);
     }

package/dist/storage/memory-storage.adapter.js.map

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

package/dist/storage/rate-limit-storage.service.d.ts

@@ -1,4 +1,7 @@
 import { RateLimitStorage, StorageAdapter } from '../interfaces/storage-adapter.interface';
+/**
+ * Rate limit storage implementation using StorageAdapter (Platform-Agnostic)
+ */
 export declare class RateLimitStorageService implements RateLimitStorage {
     private readonly storageAdapter;
     private readonly keyPrefix;

package/dist/storage/rate-limit-storage.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limit-storage.service.d.ts","sourceRoot":"","sources":["../../src/storage/rate-limit-storage.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAK3F,qBAAa,uBAAwB,YAAW,gBAAgB;IAGlD,OAAO,CAAC,QAAQ,CAAC,cAAc;IAF3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;gBAEnB,cAAc,EAAE,cAAc;IAErD,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAa3F,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE,OAAO,CAAC,MAAM;CAGf"}
+{"version":3,"file":"rate-limit-storage.service.d.ts","sourceRoot":"","sources":["../../src/storage/rate-limit-storage.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAE3F;;GAEG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAGlD,OAAO,CAAC,QAAQ,CAAC,cAAc;IAF3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;gBAEnB,cAAc,EAAE,cAAc;IAErD,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAa3F,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE,OAAO,CAAC,MAAM;CAGf"}

package/dist/storage/rate-limit-storage.service.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RateLimitStorageService = void 0;
+/**
+ * Rate limit storage implementation using StorageAdapter (Platform-Agnostic)
+ */
 class RateLimitStorageService {
     storageAdapter;
     keyPrefix = 'nauth:ratelimit:';
@@ -11,6 +14,7 @@ class RateLimitStorageService {
         const key = this.getKey(identifier, endpoint);
         const count = await this.storageAdapter.incr(key);
         if (count === 1) {
+            // First request in this window, set expiry
             const ttl = Math.ceil(windowMs / 1000);
             await this.storageAdapter.expire(key, ttl);
         }

package/dist/storage/rate-limit-storage.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limit-storage.service.js","sourceRoot":"","sources":["../../src/storage/rate-limit-storage.service.ts"],"names":[],"mappings":";;;AAKA,MAAa,uBAAuB;IAGL;IAFZ,SAAS,GAAG,kBAAkB,CAAC;IAEhD,YAA6B,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAAG,CAAC;IAE/D,KAAK,CAAC,kBAAkB,CAAC,UAAkB,EAAE,QAAgB,EAAE,QAAgB;QAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAElD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAEhB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;YACvC,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,UAAkB,EAAE,QAAgB;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjD,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAAkB,EAAE,QAAgB;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAEO,MAAM,CAAC,UAAkB,EAAE,QAAgB;QACjD,OAAO,GAAG,IAAI,CAAC,SAAS,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;IACtD,CAAC;CACF;AAhCD,0DAgCC"}
+{"version":3,"file":"rate-limit-storage.service.js","sourceRoot":"","sources":["../../src/storage/rate-limit-storage.service.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,MAAa,uBAAuB;IAGL;IAFZ,SAAS,GAAG,kBAAkB,CAAC;IAEhD,YAA6B,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAAG,CAAC;IAE/D,KAAK,CAAC,kBAAkB,CAAC,UAAkB,EAAE,QAAgB,EAAE,QAAgB;QAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAElD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,2CAA2C;YAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;YACvC,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,UAAkB,EAAE,QAAgB;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjD,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAAkB,EAAE,QAAgB;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAEO,MAAM,CAAC,UAAkB,EAAE,QAAgB;QACjD,OAAO,GAAG,IAAI,CAAC,SAAS,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;IACtD,CAAC;CACF;AAhCD,0DAgCC"}

package/dist/storage.d.ts

@@ -1,2 +1,10 @@
+/**
+ * Storage barrel export (shim)
+ *
+ * This file exists to ensure TypeScript's emitted declaration paths (e.g. `./storage.js`)
+ * resolve correctly for consumers.
+ *
+ * See `packages/core/src/dto.ts` for background.
+ */
 export * from './storage/index';
 //# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAQA,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,iBAAiB,CAAC"}

package/dist/storage.js

@@ -14,5 +14,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Storage barrel export (shim)
+ *
+ * This file exists to ensure TypeScript's emitted declaration paths (e.g. `./storage.js`)
+ * resolve correctly for consumers.
+ *
+ * See `packages/core/src/dto.ts` for background.
+ */
 __exportStar(require("./storage/index"), exports);
 //# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAQA,kDAAgC"}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;GAOG;AACH,kDAAgC"}

package/dist/templates/html-template.engine.d.ts

@@ -1,16 +1,126 @@
 import { TemplateEngine, TemplateType, TemplateVariables, EmailTemplate } from '../interfaces/template.interface';
+/**
+ * HTML Template Engine
+ *
+ * Simple yet powerful template engine for email templates using HTML with placeholder tokens.
+ * Supports {{variable}} syntax for variable injection.
+ *
+ * Features:
+ * - Simple {{variable}} placeholder syntax
+ * - Built-in default templates for all email types
+ * - Custom template registration
+ * - Automatic HTML entity escaping for security
+ * - Plain text generation from HTML
+ *
+ * @example
+ * ```typescript
+ * const engine = new HtmlTemplateEngine();
+ * const result = await engine.render(
+ *   TemplateType.VERIFICATION,
+ *   { userName: 'John', code: '123456', expiryMinutes: 60 }
+ * );
+ * ```
+ */
 export declare class HtmlTemplateEngine implements TemplateEngine {
+    /**
+     * Storage for registered templates
+     * Maps template type to template definition
+     */
     private templates;
+    /**
+     * Constructor
+     * Initializes the engine with default templates
+     */
     constructor();
+    /**
+     * Render a template with variables
+     *
+     * Replaces all {{variable}} placeholders with actual values.
+     * Variables are HTML-escaped for security.
+     * Handles firstName/username fallback for greetings.
+     *
+     * @param type - Template type to render
+     * @param variables - Variables to inject
+     * @returns Rendered email template
+     * @throws {Error} If template type not found
+     */
     render(type: TemplateType | string, variables: TemplateVariables): Promise<EmailTemplate>;
+    /**
+     * Register a custom template
+     *
+     * @param type - Template type identifier
+     * @param template - Template definition
+     */
     registerTemplate(type: TemplateType | string, template: EmailTemplate): void;
+    /**
+     * Get all available template types
+     *
+     * @returns Array of template type identifiers
+     */
     getAvailableTemplates(): string[];
+    /**
+     * Check if a template exists
+     *
+     * @param type - Template type to check
+     * @returns True if template is registered
+     */
     hasTemplate(type: TemplateType | string): boolean;
+    /**
+     * Replace {{variable}} placeholders with values
+     *
+     * Escapes HTML entities in variables for security.
+     * Handles missing variables gracefully (replaces with empty string).
+     * Supports firstName/username fallback logic and simple conditionals.
+     *
+     * @param template - Template string with {{placeholders}}
+     * @param variables - Variables to inject
+     * @returns Template with variables replaced
+     * @private
+     */
     private replaceVariables;
+    /**
+     * Replace {{variable}} placeholders with values for text content
+     *
+     * Similar to replaceVariables but doesn't escape HTML entities for plain text.
+     *
+     * @param template - Template string with {{placeholders}}
+     * @param variables - Variables to inject
+     * @returns Template with variables replaced
+     * @private
+     */
     private replaceVariablesForText;
+    /**
+     * Get greeting name with firstName/username fallback logic
+     *
+     * @param variables - Template variables
+     * @returns Greeting name or empty string
+     * @private
+     */
     private getGreetingName;
+    /**
+     * Escape HTML entities to prevent XSS
+     *
+     * @param text - Text to escape
+     * @returns HTML-safe text
+     * @private
+     */
     private escapeHtml;
+    /**
+     * Convert HTML to plain text
+     *
+     * Simple conversion: strips HTML tags and decodes entities.
+     *
+     * @param html - HTML content
+     * @returns Plain text
+     * @private
+     */
     private htmlToText;
+    /**
+     * Register default templates for all email types
+     *
+     * These templates can be overridden using registerTemplate().
+     * @private
+     */
     private registerDefaultTemplates;
 }
 //# sourceMappingURL=html-template.engine.d.ts.map

package/dist/templates/html-template.engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-template.engine.d.ts","sourceRoot":"","sources":["../../src/templates/html-template.engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AA0BlH,qBAAa,kBAAmB,YAAW,cAAc;IAKvD,OAAO,CAAC,SAAS,CAAyC;;IAsBpD,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAiC/F,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAS5E,qBAAqB,IAAI,MAAM,EAAE;IAUjC,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,OAAO;IAgBjD,OAAO,CAAC,gBAAgB;IA0CxB,OAAO,CAAC,uBAAuB;IAuC/B,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,UAAU;IAwBlB,OAAO,CAAC,wBAAwB;CAuajC"}
+{"version":3,"file":"html-template.engine.d.ts","sourceRoot":"","sources":["../../src/templates/html-template.engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAIlH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAyC;IAE1D;;;OAGG;;IAKH;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IA2B/F;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI5E;;;;OAIG;IACH,qBAAqB,IAAI,MAAM,EAAE;IAIjC;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,OAAO;IAIjD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;IAgCxB;;;;;;;;;OASG;IACH,OAAO,CAAC,uBAAuB;IAgC/B;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAUvB;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAYlB;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAU;IAkBlB;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;CAuajC"}