@zintrust/core 0.4.28 → 0.4.30

package/routes/apiDev.js

@@ -1,92 +0,0 @@
-/**
- * Example Routes
- * Demonstrates routing patterns
- */
-// import { MultiLoginController } from '@app/Controllers/MultiLoginController';
-import { Router } from '../src/routes/Router.js';
-import { registerMailUiPag } from './mail.js';
-import registerDirectMysqlTestRoutes from './TestRoutes.js';
-import { JobStateTracker } from '../src/index.js';
-const trackerStatuses = new Set([
-    'pending',
-    'active',
-    'completed',
-    'failed',
-    'stalled',
-    'timeout',
-    'pending_recovery',
-    'dead_letter',
-    'manual_review',
-    'delayed',
-]);
-const getQueryValue = (req, key) => {
-    const raw = req.getQueryParam(key);
-    if (Array.isArray(raw)) {
-        return raw.length > 0 ? String(raw[0]) : undefined;
-    }
-    if (typeof raw === 'string')
-        return raw;
-    return undefined;
-};
-const parseLimit = (value) => {
-    if (value === undefined || value.trim().length === 0)
-        return 200;
-    const parsed = Number.parseInt(value, 10);
-    if (!Number.isFinite(parsed) || parsed <= 0)
-        return 200;
-    return Math.min(5000, parsed);
-};
-const normalizeOptional = (value) => {
-    if (value === undefined)
-        return undefined;
-    const trimmed = value.trim();
-    if (trimmed.length === 0)
-        return undefined;
-    return trimmed;
-};
-const parseStatus = (value) => {
-    const normalized = normalizeOptional(value);
-    if (normalized === undefined)
-        return undefined;
-    if (!trackerStatuses.has(normalized))
-        return undefined;
-    return normalized;
-};
-const buildTrackerResponse = (req) => {
-    const queueName = normalizeOptional(getQueryValue(req, 'queue'));
-    const status = parseStatus(getQueryValue(req, 'status'));
-    const jobId = normalizeOptional(getQueryValue(req, 'jobId'));
-    const limit = parseLimit(getQueryValue(req, 'limit'));
-    const records = JobStateTracker.list({
-        queueName,
-        status,
-        limit,
-    });
-    const transitions = JobStateTracker.getTransitions({
-        queueName,
-        jobId,
-        limit,
-    });
-    const processId = typeof process === 'undefined' ? null : process.pid;
-    return {
-        processId,
-        queueName: queueName ?? null,
-        status: status ?? null,
-        jobId: jobId ?? null,
-        limit,
-        records,
-        transitions,
-        summary: JobStateTracker.getSummary(queueName),
-        generatedAt: new Date().toISOString(),
-    };
-};
-const registerQueueTrackerDebugRoute = (_router) => {
-    Router.get(_router, '/_debug/queue/tracker', async (req, res) => {
-        res.json(buildTrackerResponse(req));
-    });
-};
-export function registerDevRoutes(_router) {
-    registerDirectMysqlTestRoutes(_router);
-    registerQueueTrackerDebugRoute(_router);
-    registerMailUiPag(_router);
-}

package/routes/broadcast.d.ts

@@ -1,9 +0,0 @@
-/**
- * Broadcast Routes
- *
- * Runtime-only endpoints for broadcast.
- * Provider setup and secret provisioning remain CLI-only.
- */
-import { type IRouter } from '../src/routes/Router';
-export declare function registerBroadcastRoutes(router: IRouter): void;
-//# sourceMappingURL=broadcast.d.ts.map

package/routes/broadcast.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../routes/broadcast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,qBAAqB,CAAC;AAE3D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAsB7D"}

package/routes/broadcast.js

@@ -1,27 +0,0 @@
-/**
- * Broadcast Routes
- *
- * Runtime-only endpoints for broadcast.
- * Provider setup and secret provisioning remain CLI-only.
- */
-import { Router } from '../src/routes/Router.js';
-export function registerBroadcastRoutes(router) {
-    Router.get(router, '/broadcast/health', async (_req, res) => {
-        res.json({ ok: true });
-    });
-    Router.post(router, '/broadcast/send', async (req, res) => {
-        const body = (req.body ?? {});
-        const channel = typeof body['channel'] === 'string' ? body['channel'] : '';
-        const event = typeof body['event'] === 'string' ? body['event'] : '';
-        const data = body['data'];
-        if (!channel || !event) {
-            res
-                .setStatus(400)
-                .json({ ok: false, error: 'Invalid payload: channel and event are required' });
-            return;
-        }
-        const { Broadcast } = await import('../src/tools/broadcast/Broadcast.js');
-        const result = await Broadcast.send(channel, event, data);
-        res.json({ ok: true, result });
-    });
-}

package/routes/mail.d.ts

@@ -1,12 +0,0 @@
-import { type IRouter } from '../src/index.js';
-import '../app/Workers/TestWorker';
-export declare const demonstrateDelayScheduling: () => Promise<void>;
-export declare const demonstratePriorityJobOrdering: () => Promise<void>;
-export declare const demonstrateRetryControl: () => Promise<void>;
-export declare const demonstrateDeduplication: () => Promise<void>;
-export declare const demonstrateCustomLockProvider: () => Promise<void>;
-export declare const demonstrateBulkProcessing: () => Promise<void>;
-export declare const demonstrateMetadataTracking: () => Promise<void>;
-export declare const demonstrateCombinedAdvancedOptions: () => Promise<void>;
-export declare const registerMailUiPag: (router: IRouter) => Promise<void>;
-//# sourceMappingURL=mail.d.ts.map

package/routes/mail.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../routes/mail.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG9D,OAAO,yBAAyB,CAAC;AAEjC,eAAO,MAAM,0BAA0B,QAAa,OAAO,CAAC,IAAI,CAU/D,CAAC;AAEF,eAAO,MAAM,8BAA8B,QAAa,OAAO,CAAC,IAAI,CAUnE,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAAa,OAAO,CAAC,IAAI,CAS5D,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAAa,OAAO,CAAC,IAAI,CA4B7D,CAAC;AAEF,eAAO,MAAM,6BAA6B,QAAa,OAAO,CAAC,IAAI,CA4BlE,CAAC;AAEF,eAAO,MAAM,yBAAyB,QAAa,OAAO,CAAC,IAAI,CAU9D,CAAC;AAEF,eAAO,MAAM,2BAA2B,QAAa,OAAO,CAAC,IAAI,CAehE,CAAC;AAEF,eAAO,MAAM,kCAAkC,QAAa,OAAO,CAAC,IAAI,CAcvE,CAAC;AA4CF,eAAO,MAAM,iBAAiB,GAAU,QAAQ,OAAO,KAAG,OAAO,CAAC,IAAI,CAkDrE,CAAC"}

package/routes/mail.js

@@ -1,138 +0,0 @@
-/* istanbul ignore file */
-import AdvancedEmailJobService from '../app/Jobs/AdvancedEmailJobService.js';
-import { Mail } from '../src/tools/mail/Mail.js';
-import { Logger, Router } from '../src/index.js';
-// Ensure TestWorker is registered for dashboard visibility
-import '../app/Workers/TestWorker.js';
-export const demonstrateDelayScheduling = async () => {
-    // Schedule email for 1 hour from now - job won't process until delay expires
-    await AdvancedEmailJobService.sendScheduledLock('scheduled@zintrust.com', 'Meeting Reminder', 'welcome', { meetingTime: '2026-02-01T10:00:00Z' }, 3600000 // 1 hour delay in milliseconds
-    );
-    // AdvancedEmailJobService.processAll();
-};
-export const demonstratePriorityJobOrdering = async () => {
-    // High priority urgent email - processes before lower priority jobs
-    await AdvancedEmailJobService.sendHighPriority('urgent@zintrust.com', 'URGENT: System Alert', 'welcome', { alertType: 'critical' }, { priority: 10, attempts: 5 }, // Higher number = higher priority,
-    'advanced-queue-redis');
-};
-export const demonstrateRetryControl = async () => {
-    // Email with custom retry attempts and exponential backoff
-    await AdvancedEmailJobService.sendHighPriority('retry@zintrust.com', 'Retry Test', 'welcome', { test: 'retry-logic' }, { attempts: 7, delay: 0 } // Will retry 7 times with exponential backoff
-    );
-};
-export const demonstrateDeduplication = async () => {
-    // Prevents duplicate emails from being sent within 24-hour window
-    await AdvancedEmailJobService.sendWithDeduplication('dedup@zintrust.com', 'Welcome Email', 'welcome', { name: 'User' }, 'welcome-user-123', // Same uniqueId = same job
-    'example-redis1');
-    await AdvancedEmailJobService.sendWithDeduplication('dedup-2@zintrust.com', 'Weekly Digest', 'welcome', { digest: 'week-1', delay: 300000 }, 'weekly-digest-001', 'example-redis1');
-    await AdvancedEmailJobService.sendWithDeduplication('dedup-3@zintrust.com', 'Invoice Ready', 'welcome', { invoiceId: 'inv-8899', delay: 300000 }, 'invoice-inv-8899', 'advanced-queue');
-};
-export const demonstrateCustomLockProvider = async () => {
-    // Use custom lock provider (redis/database/memory) for uniqueness
-    await AdvancedEmailJobService.sendWithUniqueLock('unique@zintrust.com', 'Password Reset', 'welcome', { token: 'abc123' }, 'redis', // uniqueVia: 'redis' | 'database' | 'memory'
-    'example-redis1');
-    await AdvancedEmailJobService.sendWithUniqueLock('unique-2@zintrust.com', 'Email Verification', 'welcome', { token: 'verify-456' }, 'memory', 'advanced-queue');
-    await AdvancedEmailJobService.sendWithUniqueLock('unique-3@zintrust.com', 'Account Recovery', 'welcome', { token: 'recover-789' }, 'database', 'example-redis1');
-};
-export const demonstrateBulkProcessing = async () => {
-    // Send bulk emails with batch ID and per-recipient deduplication
-    await AdvancedEmailJobService.sendBulk(['bulk1@zintrust.com', 'bulk2@zintrust.com', 'bulk3@zintrust.com'], 'Monthly Newsletter', 'welcome', { campaign: 'Q1-2026', issue: 'January' }, 'batch-newsletter-202601', // batchId for tracking
-    'advanced-queue');
-};
-export const demonstrateMetadataTracking = async () => {
-    // Email with campaign tracking metadata
-    await AdvancedEmailJobService.sendWithMetadata('metadata@zintrust.com', 'Campaign Email', 'welcome', { userName: 'Alice' }, {
-        campaign: 'winter-sale',
-        source: 'web-signup',
-        priority: 'high',
-        tags: ['marketing', 'promotion', 'new-user'],
-    }, 'example-redis1');
-};
-export const demonstrateCombinedAdvancedOptions = async () => {
-    // High-priority scheduled email with retry logic
-    await AdvancedEmailJobService.sendHighPriority('combined@zintrust.com', 'VIP Scheduled Notification', 'welcome', { vipLevel: 'platinum' }, {
-        priority: 10, // High priority
-        delay: 300000, // 5 minutes delay
-        attempts: 5, // Retry up to 5 times
-    }, 'example-redis1');
-};
-const TestAdvancedJob = async () => {
-    // ====================================================================
-    // SCENARIO 1: Delay Scheduling (delay option)
-    // ====================================================================
-    // await demonstrateDelayScheduling();
-    // ====================================================================
-    // SCENARIO 2: Priority Job Ordering (priority option)
-    // ====================================================================
-    await demonstratePriorityJobOrdering();
-    // ====================================================================
-    // SCENARIO 3: Retry Control (attempts + backoff options)
-    // ====================================================================
-    // await demonstrateRetryControl();
-    // ====================================================================
-    // SCENARIO 4: Deduplication Support (uniqueId + deduplication options)
-    // ====================================================================
-    // await demonstrateDeduplication();
-    // ====================================================================
-    // SCENARIO 5: Custom Lock Provider (uniqueVia option)
-    // ====================================================================
-    // await demonstrateCustomLockProvider();
-    // ====================================================================
-    // SCENARIO 6: Bulk Processing with Deduplication
-    // ====================================================================
-    // await demonstrateBulkProcessing();
-    // ====================================================================
-    // SCENARIO 7: Metadata Tracking (custom envelope data)
-    // ====================================================================
-    // await demonstrateMetadataTracking();
-    // ====================================================================
-    // SCENARIO 8: Combined Advanced Options
-    // ====================================================================
-    // await demonstrateCombinedAdvancedOptions();
-};
-export const registerMailUiPag = async (router) => {
-    /* istanbul ignore next */
-    // const { EmailJobService } = await import('../app/Jobs/EmailJobService');
-    const handler = async (req, res) => {
-        try {
-            await TestAdvancedJob();
-        }
-        catch (error) {
-            Logger.warn('Mail preview queue trigger failed', {
-                route: '/mail/:template',
-                template: req.getParam('template') ?? 'welcome',
-                error: error instanceof Error ? error.message : String(error),
-            });
-        }
-        const templateName = req.getParam('template') ?? 'welcome';
-        const templates = {
-            welcome: 'welcome',
-            general: 'general',
-            custom: 'custom',
-            'job-completed': 'job-completed',
-            'performance-report': 'performance-report',
-            'password-reset': 'password-reset',
-            'worker-alert': 'worker-alert',
-        };
-        const finalTemplate = templates[templateName] ?? 'welcome';
-        const variablesByTemplate = {
-            welcome: { name: 'Alice' },
-            general: {
-                name: 'Alice',
-                headline: 'Hello Alice',
-                message: 'Welcome to ZinTrust platform.',
-                primary_color: '#0ea5e9',
-            },
-            custom: { name: 'Alice' },
-        };
-        const html = await Mail.render({
-            template: finalTemplate,
-            variables: variablesByTemplate[finalTemplate] ?? { name: 'Alice' },
-        });
-        res.html(html);
-    };
-    if (typeof Router?.get !== 'function') {
-        return;
-    }
-    Router.get(router, '/mail/:template', handler);
-};

package/routes/storage.d.ts

@@ -1,4 +0,0 @@
-import { type IRouter } from '../src/routes/Router';
-export declare function registerStorageRoutes(router: IRouter): void;
-export default registerStorageRoutes;
-//# sourceMappingURL=storage.d.ts.map

package/routes/storage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../routes/storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,qBAAqB,CAAC;AAI3D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAiC3D;AAED,eAAe,qBAAqB,CAAC"}

package/routes/storage.js

@@ -1,35 +0,0 @@
-import { HTTP_HEADERS } from '../src/config/constants.js';
-import { Env } from '../src/config/env.js';
-import { Router } from '../src/routes/Router.js';
-import { LocalSignedUrl } from '../src/tools/storage/LocalSignedUrl.js';
-import { Storage } from '../src/tools/storage/index.js';
-export function registerStorageRoutes(router) {
-    Router.get(router, '/storage/download', async (req, res) => {
-        const tokenRaw = req.getQueryParam('token');
-        const token = typeof tokenRaw === 'string' ? tokenRaw : '';
-        if (token.trim() === '') {
-            res.setStatus(400).json({ message: 'Missing token' });
-            return;
-        }
-        const appKey = Env.get('APP_KEY', '');
-        if (appKey.trim() === '') {
-            res.setStatus(500).json({ message: 'Storage signing is not configured' });
-            return;
-        }
-        try {
-            const payload = LocalSignedUrl.verifyToken(token, appKey);
-            // Only local disk is supported by this route.
-            if (payload.disk !== 'local') {
-                res.setStatus(400).json({ message: 'Unsupported disk' });
-                return;
-            }
-            const contents = await Storage.get('local', payload.key);
-            res.setHeader(HTTP_HEADERS.CONTENT_TYPE, 'application/octet-stream');
-            res.setStatus(200).send(contents);
-        }
-        catch {
-            res.setStatus(403).json({ message: 'Invalid or expired token' });
-        }
-    });
-}
-export default registerStorageRoutes;

package/start.d.ts

@@ -1 +0,0 @@
-export * from './src/start'; export { default } from './src/start';

package/start.js

@@ -1 +0,0 @@
-export * from './src/start.js'; export { default } from './src/start.js';