@zintrust/core 0.1.24 → 0.1.26

package/src/tools/queue/drivers/Redis.js

@@ -1,96 +1,25 @@
-import { generateUuid } from '../../../common/utility.js';
-import { Env } from '../../../config/env.js';
-import { ErrorFactory } from '../../../exceptions/ZintrustError.js';
-const getRedisUrl = () => {
-    const anyEnv = Env;
-    const fromEnv = typeof anyEnv.get === 'function' ? anyEnv.get('REDIS_URL', '') : '';
-    const hasProcess = typeof process === 'object' && process !== null;
-    const fallback = hasProcess ? (process.env?.['REDIS_URL'] ?? '') : '';
-    const trimmed = fromEnv.trim();
-    const url = (trimmed.length > 0 ? fromEnv : String(fallback)).trim();
-    return url.length > 0 ? url : null;
-};
+import { ensureDriver } from '../../../config/redis.js';
 export const RedisQueue = (() => {
-    let client = null;
-    let connected = false;
-    const ensureClient = async () => {
-        if (connected && client !== null)
-            return client;
-        const url = getRedisUrl();
-        if (url === null)
-            throw ErrorFactory.createConfigError('Redis queue driver requires REDIS_URL');
-        // Import lazily so package is optional for environments that don't use Redis
-        // Prefer real 'redis' package when available, otherwise allow tests to inject a fake client
-        try {
-            // Dynamically import the redis package if available (optional dependency)
-            // Tests can inject a fake client on `globalThis.__fakeRedisClient` if the package is absent.
-            // Dynamically import the redis package if available (optional dependency)
-            const mod = (await import('redis'));
-            const createClient = mod.createClient;
-            client = createClient({ url });
-            if (typeof client.connect === 'function') {
-                try {
-                    // Await connect to ensure readiness; network errors will be surfaced
-                    await client.connect();
-                    connected = true;
-                }
-                catch (connectionError) {
-                    connected = false;
-                    // log non-fatally — operations will surface errors as needed
-                    // eslint-disable-next-line no-console
-                    console.warn('Redis client connect failed:', String(connectionError));
-                }
-            }
-            else {
-                connected = true;
-            }
-        }
-        catch {
-            const globalFake = globalThis
-                .__fakeRedisClient;
-            if (globalFake === undefined) {
-                throw ErrorFactory.createConfigError("Redis queue driver requires the 'redis' package (run `zin add queue:redis` / `zin plugin install queue:redis`, or `npm install redis`) or a test fake client set in globalThis.__fakeRedisClient");
-            }
-            client = globalFake;
-            connected = true;
-        }
-        if (client === null)
-            throw ErrorFactory.createConfigError('Redis client could not be initialized');
-        return client;
-    };
     return {
         async enqueue(queue, payload) {
-            const cli = await ensureClient();
-            const id = generateUuid();
-            const msg = JSON.stringify({ id, payload, attempts: 0 });
-            await cli.rPush(queue, msg);
-            return id;
+            const driver = await ensureDriver();
+            return driver.enqueue(queue, payload);
         },
         async dequeue(queue) {
-            const cli = await ensureClient();
-            const raw = await cli.lPop(queue);
-            if (raw === null)
-                return undefined;
-            try {
-                const parsed = JSON.parse(raw);
-                return parsed;
-            }
-            catch (err) {
-                throw ErrorFactory.createTryCatchError('Failed to parse queue message', err);
-            }
+            const driver = await ensureDriver();
+            return driver.dequeue(queue);
         },
         async ack(_queue, _id) {
-            // Simple list-based queue removes on dequeue, so ack is a no-op here.
-            // For visibility timeout or retry semantics, implement BRPOPLPUSH and a processing list.
-            return Promise.resolve(); // NOSONAR
+            const driver = await ensureDriver();
+            await driver.ack(_queue, _id);
         },
         async length(queue) {
-            const cli = await ensureClient();
-            return cli.lLen(queue);
+            const driver = await ensureDriver();
+            return driver.length(queue);
         },
         async drain(queue) {
-            const cli = await ensureClient();
-            await cli.del(queue);
+            const driver = await ensureDriver();
+            await driver.drain(queue);
         },
     };
 })();

package/src/tools/queue/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Queue Module Exports
+ * Centralized exports for advanced queue patterns
+ */
+export { createAdvancedQueue, type AdvancedQueue } from './AdvancedQueue';
+export { createDeduplicationBuilder, type DeduplicationBuilder } from './DeduplicationBuilder';
+export { createLockProvider, createMemoryLockProvider, createRedisLockProvider, getLockProvider, registerLockProvider, } from './LockProvider';
+export type { AdvancedJobOptions, DeduplicationOptions, JobResult, Lock, LockOptions, LockProvider, LockProviderConfig, LockStatus, QueueConfig, ReleaseCondition, } from '../../types/Queue';
+//# sourceMappingURL=index.d.ts.map

package/src/tools/queue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,0BAA0B,EAAE,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,EACT,IAAI,EACJ,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/src/tools/queue/index.js

@@ -0,0 +1,7 @@
+/**
+ * Queue Module Exports
+ * Centralized exports for advanced queue patterns
+ */
+export { createAdvancedQueue } from './AdvancedQueue.js';
+export { createDeduplicationBuilder } from './DeduplicationBuilder.js';
+export { createLockProvider, createMemoryLockProvider, createRedisLockProvider, getLockProvider, registerLockProvider, } from './LockProvider.js';

package/src/tools/redis/RedisKeyManager.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Creates a prefixed Redis key
+ * @param key - Original key name
+ * @returns Prefixed key in format: {prefix}-{key}
+ */
+export declare function createRedisKey(key: string): string;
+/**
+ * Creates a prefixed queue key
+ * @param queueName - Original queue name
+ * @returns Prefixed queue key
+ */
+export declare function createQueueKey(queueName: string): string;
+/**
+ * Creates a prefixed BullMQ queue key
+ * BullMQ uses specific patterns like 'bull:queue-name'
+ * @param queueName - Original queue name
+ * @returns Prefixed BullMQ queue key
+ */
+export declare function createBullMQKey(queueName: string): string;
+/**
+ * Creates a prefixed worker key
+ * @param workerName - Original worker name
+ * @returns Prefixed worker key
+ */
+export declare function createWorkerKey(workerName: string): string;
+/**
+ * Creates a prefixed session key
+ * @param sessionId - Session ID
+ * @returns Prefixed session key
+ */
+export declare function createSessionKey(sessionId: string): string;
+/**
+ * Creates a prefixed cache key
+ * @param cacheKey - Cache key
+ * @returns Prefixed cache key
+ */
+export declare function createCacheKey(cacheKey: string): string;
+/**
+ * Extracts original key from prefixed key
+ * @param prefixedKey - Full prefixed key
+ * @returns Original key without prefix
+ */
+export declare function extractOriginalKey(prefixedKey: string): string;
+/**
+ * Checks if a key belongs to this application
+ * @param key - Redis key to check
+ * @returns True if key belongs to this application
+ */
+export declare function isAppKey(key: string): boolean;
+/**
+ * Gets the current prefix
+ * @returns Current application prefix
+ */
+export declare function getPrefix(): string;
+export declare const getBullMQSafeQueueName: () => string;
+export type RedisKeyType = 'queue' | 'bullmq' | 'worker' | 'session' | 'cache' | 'custom';
+/**
+ * Creates a prefixed key based on type
+ * @param type - Type of key
+ * @param key - Original key
+ * @returns Prefixed key
+ */
+export declare function createKeyByType(type: RedisKeyType, key: string): string;
+//# sourceMappingURL=RedisKeyManager.d.ts.map

package/src/tools/redis/RedisKeyManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisKeyManager.d.ts","sourceRoot":"","sources":["../../../../src/tools/redis/RedisKeyManager.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBlD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,eAAO,MAAM,sBAAsB,QAAO,MAEzC,CAAC;AAGF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1F;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAiBvE"}

package/src/tools/redis/RedisKeyManager.js

@@ -0,0 +1,124 @@
+import { appConfig } from '../../config/app.js';
+import { Logger } from '../../config/logger.js';
+/**
+ * Redis Key Management Utility
+ *
+ * Centralizes Redis key prefixing using appConfigObj.prefix
+ * to prevent key collisions across different applications/environments
+ */
+const PREFIX = appConfig.prefix;
+/**
+ * Creates a prefixed Redis key
+ * @param key - Original key name
+ * @returns Prefixed key in format: {prefix}-{key}
+ */
+export function createRedisKey(key) {
+    if (!key) {
+        Logger.warn('RedisKeyManager: Empty key provided');
+        return PREFIX;
+    }
+    // Remove leading/trailing colons and ensure proper format
+    // Using safe string operations instead of regex to prevent ReDoS
+    let cleanKey = key;
+    while (cleanKey.startsWith(':')) {
+        cleanKey = cleanKey.slice(1);
+    }
+    while (cleanKey.endsWith(':')) {
+        cleanKey = cleanKey.slice(0, -1);
+    }
+    return `${PREFIX}:${cleanKey}`;
+}
+/**
+ * Creates a prefixed queue key
+ * @param queueName - Original queue name
+ * @returns Prefixed queue key
+ */
+export function createQueueKey(queueName) {
+    return createRedisKey(`queue:${queueName}`);
+}
+/**
+ * Creates a prefixed BullMQ queue key
+ * BullMQ uses specific patterns like 'bull:queue-name'
+ * @param queueName - Original queue name
+ * @returns Prefixed BullMQ queue key
+ */
+export function createBullMQKey(queueName) {
+    return createRedisKey(`bull:${queueName}`);
+}
+/**
+ * Creates a prefixed worker key
+ * @param workerName - Original worker name
+ * @returns Prefixed worker key
+ */
+export function createWorkerKey(workerName) {
+    return createRedisKey(`worker:${workerName}`);
+}
+/**
+ * Creates a prefixed session key
+ * @param sessionId - Session ID
+ * @returns Prefixed session key
+ */
+export function createSessionKey(sessionId) {
+    return createRedisKey(`session:${sessionId}`);
+}
+/**
+ * Creates a prefixed cache key
+ * @param cacheKey - Cache key
+ * @returns Prefixed cache key
+ */
+export function createCacheKey(cacheKey) {
+    return createRedisKey(`cache:${cacheKey}`);
+}
+/**
+ * Extracts original key from prefixed key
+ * @param prefixedKey - Full prefixed key
+ * @returns Original key without prefix
+ */
+export function extractOriginalKey(prefixedKey) {
+    if (!prefixedKey.startsWith(`${PREFIX}:`)) {
+        return prefixedKey;
+    }
+    return prefixedKey.substring(`${PREFIX}:`.length);
+}
+/**
+ * Checks if a key belongs to this application
+ * @param key - Redis key to check
+ * @returns True if key belongs to this application
+ */
+export function isAppKey(key) {
+    return key.startsWith(`${PREFIX}:`);
+}
+/**
+ * Gets the current prefix
+ * @returns Current application prefix
+ */
+export function getPrefix() {
+    return PREFIX;
+}
+export const getBullMQSafeQueueName = () => {
+    return PREFIX;
+};
+/**
+ * Creates a prefixed key based on type
+ * @param type - Type of key
+ * @param key - Original key
+ * @returns Prefixed key
+ */
+export function createKeyByType(type, key) {
+    switch (type) {
+        case 'queue':
+            return createQueueKey(key);
+        case 'bullmq':
+            return createBullMQKey(key);
+        case 'worker':
+            return createWorkerKey(key);
+        case 'session':
+            return createSessionKey(key);
+        case 'cache':
+            return createCacheKey(key);
+        case 'custom':
+            return createRedisKey(key);
+        default:
+            return createRedisKey(key);
+    }
+}

package/src/types/Queue.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Queue Types for Advanced Queue Patterns
+ * Defines all interfaces and types for deduplication and lock management
+ */
+export interface DeduplicationOptions {
+    id: string;
+    ttl?: number;
+    dontRelease?: boolean;
+    replace?: boolean;
+    releaseAfter?: string | number | ReleaseCondition;
+}
+export interface ReleaseCondition {
+    condition: string;
+    delay?: number;
+}
+export interface LockOptions {
+    ttl?: number;
+    autoExtend?: boolean;
+    retryDelay?: number;
+}
+export interface Lock {
+    key: string;
+    ttl: number;
+    acquired: boolean;
+    expires: Date;
+}
+export interface LockStatus {
+    exists: boolean;
+    ttl?: number;
+    expires?: Date;
+}
+export interface LockProviderConfig {
+    type: 'redis' | 'database' | 'memory';
+    connection?: unknown;
+    prefix?: string;
+    defaultTtl?: number;
+}
+export interface QueueConfig {
+    name: string;
+    connection?: unknown;
+    defaultDedupTtl?: number;
+    lockProvider?: string;
+}
+export interface AdvancedJobOptions {
+    uniqueId?: string;
+    uniqueVia?: string;
+    deduplication?: DeduplicationOptions;
+}
+export interface JobResult {
+    id: string;
+    deduplicated: boolean;
+    lockId?: string;
+    status: 'queued' | 'deduplicated' | 'failed';
+}
+export interface LockProvider {
+    acquire(key: string, options: LockOptions): Promise<Lock>;
+    release(lock: Lock): Promise<void>;
+    extend(lock: Lock, ttl: number): Promise<boolean>;
+    status(key: string): Promise<LockStatus>;
+    list(pattern?: string): Promise<string[]>;
+}
+//# sourceMappingURL=Queue.d.ts.map

package/src/types/Queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../../src/types/Queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,gBAAgB,CAAC;CACnD;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,IAAI;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,IAAI,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,cAAc,GAAG,QAAQ,CAAC;CAC9C;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC3C"}

package/src/types/Queue.js

@@ -0,0 +1,5 @@
+/**
+ * Queue Types for Advanced Queue Patterns
+ * Defines all interfaces and types for deduplication and lock management
+ */
+export {};

package/src/features/Auth.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Auth.d.ts","sourceRoot":"","sources":["../../../src/features/Auth.ts"],"names":[],"mappings":"AAEA,OAAY,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAIlE,eAAO,MAAM,IAAI;IACf;;OAEG;mBACkB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7C;;OAEG;sBACqB,MAAM,QAAQ,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D;;OAEG;2BAEQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UACxB,MAAM,cACH,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,GAC/C,MAAM;IAKT;;OAEG;gBACS,CAAC,SAAS,MAAM,UAAU,MAAM,GAAG,CAAC;EAGhD,CAAC"}

package/src/features/Queue.d.ts

@@ -1,21 +0,0 @@
-export interface QueueJob {
-    id: string;
-    data: unknown;
-    timestamp: number;
-}
-/**
- * Simple In-Memory Queue
- * For production, replace with Redis or similar.
- */
-export declare const Queue: Readonly<{
-    jobs: QueueJob[];
-    /**
-     * Add a job to the queue
-     */
-    add<T>(data: T): string;
-    /**
-     * Process jobs (Placeholder)
-     */
-    process(handler: (job: QueueJob) => Promise<void>): Promise<void>;
-}>;
-//# sourceMappingURL=Queue.d.ts.map

package/src/features/Queue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../../src/features/Queue.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,eAAO,MAAM,KAAK;UACJ,QAAQ,EAAE;IAEtB;;OAEG;QACC,CAAC,QAAQ,CAAC,GAAG,MAAM;IAcvB;;OAEG;qBACoB,CAAC,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;EAMvE,CAAC"}

package/src/features/Queue.js

@@ -1,33 +0,0 @@
-import { generateSecureJobId } from '../common/utility.js';
-import { Logger } from '../config/logger.js';
-/**
- * Simple In-Memory Queue
- * For production, replace with Redis or similar.
- */
-export const Queue = Object.freeze({
-    jobs: [],
-    /**
-     * Add a job to the queue
-     */
-    add(data) {
-        const id = generateSecureJobId();
-        const job = {
-            id,
-            data,
-            timestamp: Date.now(),
-        };
-        // In a real implementation, this would push to Redis/SQS
-        Queue.jobs.push(job);
-        Logger.info(`[Queue] Job added: ${id}`);
-        return id;
-    },
-    /**
-     * Process jobs (Placeholder)
-     */
-    async process(handler) {
-        Logger.info('[Queue] Processing jobs...');
-        const jobsToProcess = [...Queue.jobs];
-        Queue.jobs.length = 0;
-        await Promise.all(jobsToProcess.map(async (job) => handler(job)));
-    },
-});

package/src/templates/features/Queue.ts.tpl

@@ -1,47 +0,0 @@
-// TEMPLATE_START
-
-import { generateSecureJobId } from '@zintrust/core';
-import { Logger } from '@zintrust/core';
-
-export interface QueueJob {
-  id: string;
-  data: unknown;
-  timestamp: number;
-}
-
-/**
- * Simple In-Memory Queue
- * For production, replace with Redis or similar.
- */
-export const Queue = Object.freeze({
-  jobs: [] as QueueJob[],
-
-  /**
-   * Add a job to the queue
-   */
-  add<T>(data: T): string {
-    const id = generateSecureJobId();
-    const job: QueueJob = {
-      id,
-      data,
-      timestamp: Date.now(),
-    };
-
-    // In a real implementation, this would push to Redis/SQS
-    Queue.jobs.push(job);
-    Logger.info(`[Queue] Job added: ${id}`);
-    return id;
-  },
-
-  /**
-   * Process jobs (Placeholder)
-   */
-  async process(handler: (job: QueueJob) => Promise<void>): Promise<void> {
-    Logger.info('[Queue] Processing jobs...');
-    const jobsToProcess = [...Queue.jobs];
-    Queue.jobs.length = 0;
-    await Promise.all(jobsToProcess.map(async (job) => handler(job)));
-  },
-});
-
-// TEMPLATE_END

package/src/tools/mail/templates/markdown/index.d.ts

@@ -1,17 +0,0 @@
-export declare const loadTemplate: (name: string) => {
-    subject?: string;
-    preheader?: string;
-    variables?: string[];
-    content: string;
-};
-export { listTemplates, renderTemplate } from '../../templates/markdown/registry';
-declare const _default: {
-    loadTemplate: (name: string) => {
-        subject?: string;
-        preheader?: string;
-        variables?: string[];
-        content: string;
-    };
-};
-export default _default;
-//# sourceMappingURL=index.d.ts.map

package/src/tools/mail/templates/markdown/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/mail/templates/markdown/index.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,GACvB,MAAM,MAAM,KACX;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAkD/E,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;;yBArD1E,MAAM,KACX;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;;AAsDlF,wBAAgC"}

package/src/tools/mail/templates/markdown/index.js

@@ -1,49 +0,0 @@
-import { readFileSync } from '../../../../node-singletons/fs.js';
-import { join } from '../../../../node-singletons/path.js';
-export const loadTemplate = (name) => {
-    // name e.g. 'auth/welcome'
-    const parts = name.split('/');
-    // Safe parser for top comment metadata <!-- Key: Value --> lines to avoid regex backtracking
-    const dir = join(process.cwd(), 'src', 'tools', 'mail', 'templates', 'markdown', ...parts.slice(0, -1));
-    const leaf = parts.at(-1) ?? '';
-    const filePath = join(dir, `${leaf}.md`);
-    const raw = readFileSync(filePath, 'utf-8');
-    const meta = {};
-    const parseMetaLine = (line) => {
-        // Must start with <!-- and end with --> exactly; trim the inner part and split at first colon
-        if (!line.startsWith('<!--') || !line.endsWith('-->'))
-            return null;
-        const inner = line.slice('<!--'.length, -'-->'.length).trim();
-        const idx = inner.indexOf(':');
-        if (idx === -1)
-            return null;
-        const key = inner.slice(0, idx).trim().toLowerCase();
-        const val = inner.slice(idx + 1).trim();
-        if (!key)
-            return null;
-        return [key, val];
-    };
-    // Parse top comment metadata <!-- Key: Value --> lines
-    const lines = raw.split(/\r?\n/);
-    let i = 0;
-    for (; i < lines.length; i++) {
-        const kv = parseMetaLine(lines[i]);
-        if (!kv)
-            break;
-        const [key, val] = kv;
-        if (key === 'subject')
-            meta.subject = val;
-        if (key === 'preheader')
-            meta.preheader = val;
-        if (key === 'variables') {
-            meta.variables = val
-                .split(',')
-                .map((s) => s.trim())
-                .filter(Boolean);
-        }
-    }
-    const content = lines.slice(i).join('\n').trim();
-    return { content, ...meta };
-};
-export { listTemplates, renderTemplate } from '../../templates/markdown/registry.js';
-export default { loadTemplate };

package/src/tools/mail/templates/markdown/registry.d.ts

@@ -1,15 +0,0 @@
-import { loadTemplate } from '../../templates/markdown';
-export declare const listTemplates: () => string[];
-export declare const renderTemplate: (name: string, vars?: Record<string, unknown>) => {
-    html: string;
-    meta: ReturnType<typeof loadTemplate>;
-};
-declare const _default: {
-    listTemplates: () => string[];
-    renderTemplate: (name: string, vars?: Record<string, unknown>) => {
-        html: string;
-        meta: ReturnType<typeof loadTemplate>;
-    };
-};
-export default _default;
-//# sourceMappingURL=registry.d.ts.map

package/src/tools/mail/templates/markdown/registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/mail/templates/markdown/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AA2BxD,eAAO,MAAM,aAAa,QAAO,MAAM,EAEtC,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,OAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,KACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA;CAKvD,CAAC;;yBAZ+B,MAAM,EAAE;2BAKjC,MAAM,SACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA;KAAE;;AAO1D,wBAAiD"}

package/src/tools/mail/templates/markdown/registry.js

@@ -1,34 +0,0 @@
-import { loadTemplate } from '../../templates/markdown/index.js';
-import { validateTemplateMeta } from '../../templates/markdown/validator.js';
-import { readdirSync, statSync } from '../../../../node-singletons/fs.js';
-import { join, relative } from '../../../../node-singletons/path.js';
-import { MarkdownRenderer } from '../../../templates/index.js';
-const BASE = join(process.cwd(), 'src', 'tools', 'mail', 'templates', 'markdown');
-const walkDir = (dir, base = dir) => {
-    const entries = readdirSync(dir);
-    let files = [];
-    for (const e of entries) {
-        const p = join(dir, e);
-        const s = statSync(p);
-        if (s.isDirectory()) {
-            files = files.concat(walkDir(p, base));
-            continue;
-        }
-        if (e.endsWith('.md')) {
-            const rel = relative(base, p).replaceAll('\\', '/');
-            const withoutExt = rel.toLowerCase().endsWith('.md') ? rel.slice(0, -3) : rel;
-            files.push(withoutExt);
-        }
-    }
-    return files;
-};
-export const listTemplates = () => {
-    return walkDir(BASE);
-};
-export const renderTemplate = (name, vars = {}) => {
-    const tpl = loadTemplate(name);
-    validateTemplateMeta(name, tpl);
-    const html = MarkdownRenderer.render(tpl.content, vars);
-    return { html, meta: tpl };
-};
-export default { listTemplates, renderTemplate };

package/src/tools/mail/templates/markdown/validator.d.ts

@@ -1,16 +0,0 @@
-export declare const validateTemplateMeta: (name: string, tpl: {
-    subject?: string;
-    preheader?: string;
-    variables?: string[];
-    content: string;
-}) => true;
-declare const _default: {
-    validateTemplateMeta: (name: string, tpl: {
-        subject?: string;
-        preheader?: string;
-        variables?: string[];
-        content: string;
-    }) => true;
-};
-export default _default;
-//# sourceMappingURL=validator.d.ts.map

package/src/tools/mail/templates/markdown/validator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/mail/templates/markdown/validator.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EACZ,KAAK;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,KACA,IA0BF,CAAC;;iCAjCM,MAAM,OACP;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;KACjB,KACA,IAAI;;AA4BP,wBAAwC"}