@zintrust/core 0.4.27 → 0.4.28

package/packages/db-sqlserver/src/index.js

@@ -0,0 +1,73 @@
+import { ErrorFactory, FeatureFlags, Logger, QueryBuilder } from '../../../src/index.js';
+function ensureConnected(state) {
+    if (!state.connected)
+        throw ErrorFactory.createConnectionError('Database not connected');
+}
+function connect(state, config) {
+    if (config.host === 'error') {
+        throw ErrorFactory.createConnectionError('Failed to connect to SQL Server: Error: Connection failed');
+    }
+    state.connected = true;
+    Logger.info(`✓ SQL Server connected (${config.host}:${config.port})`);
+}
+function disconnect(state) {
+    state.connected = false;
+    Logger.info('✓ SQL Server disconnected');
+}
+async function rawQuery(state, sql, parameters) {
+    if (!FeatureFlags.isRawQueryEnabled()) {
+        throw ErrorFactory.createConfigError('Raw SQL queries are disabled. Set USE_RAW_QRY=true environment variable to enable.');
+    }
+    ensureConnected(state);
+    Logger.warn(`Raw SQL Query executed: ${sql}`, { parameters });
+    try {
+        if (sql.toUpperCase().includes('INVALID')) {
+            throw ErrorFactory.createDatabaseError('Invalid SQL syntax');
+        }
+        return [];
+    }
+    catch (error) {
+        throw ErrorFactory.createTryCatchError('Raw SQL Query failed', error);
+    }
+}
+function createSqlServerAdapter(config) {
+    const state = { connected: false };
+    const adapter = {
+        connect: async () => connect(state, config),
+        disconnect: async () => disconnect(state),
+        query: async () => {
+            ensureConnected(state);
+            return { rows: [], rowCount: 0 };
+        },
+        queryOne: async (sql, parameters) => {
+            const result = await adapter.query(sql, parameters);
+            return result.rows[0] ?? null;
+        },
+        ping: async () => {
+            await adapter.query(QueryBuilder.create('').select('1').toSQL(), []);
+        },
+        transaction: async (callback) => {
+            try {
+                return await callback(adapter);
+            }
+            catch (error) {
+                throw ErrorFactory.createTryCatchError('Transaction failed', error);
+            }
+        },
+        getType: () => 'sqlserver',
+        isConnected: () => state.connected,
+        rawQuery: async (sql, parameters) => rawQuery(state, sql, parameters),
+        getPlaceholder: (index) => `@param${index}`,
+    };
+    return adapter;
+}
+export const SQLServerAdapter = Object.freeze({
+    create: (config) => createSqlServerAdapter(config),
+});
+export default SQLServerAdapter;
+/**
+ * Package version and build metadata
+ * Available at runtime for debugging and health checks
+ */
+export const _ZINTRUST_DB_SQLSERVER_VERSION = '0.1.15';
+export const _ZINTRUST_DB_SQLSERVER_BUILD_DATE = '__BUILD_DATE__';

package/packages/db-sqlserver/src/register.d.ts

@@ -0,0 +1,6 @@
+type Registry = {
+    register: (driver: string, factory: (cfg: unknown) => unknown) => void;
+};
+export declare function registerSqlServerAdapter(registry: Registry): void;
+export {};
+//# sourceMappingURL=register.d.ts.map

package/packages/db-sqlserver/src/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../packages/db-sqlserver/src/register.ts"],"names":[],"mappings":"AAEA,KAAK,QAAQ,GAAG;IACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,KAAK,IAAI,CAAC;CACxE,CAAC;AAMF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAEjE"}

package/packages/db-sqlserver/src/register.js

@@ -0,0 +1,21 @@
+import { SQLServerAdapter } from './index.js';
+export function registerSqlServerAdapter(registry) {
+    registry.register('sqlserver', (config) => SQLServerAdapter.create(config));
+}
+const globalWithRegistry = globalThis;
+const globalRegistry = globalWithRegistry.__zintrust_db_adapter_registry__ ??
+    (globalWithRegistry.__zintrust_db_adapter_registry__ = new Map());
+registerSqlServerAdapter({
+    register: (driver, factory) => {
+        globalRegistry.set(driver, factory);
+    },
+});
+try {
+    const core = (await import('../../../src/index.js'));
+    if (core.DatabaseAdapterRegistry !== undefined) {
+        registerSqlServerAdapter(core.DatabaseAdapterRegistry);
+    }
+}
+catch {
+    // no-op
+}

package/packages/mail-sendgrid/src/register.d.ts

@@ -0,0 +1,6 @@
+type Registry = {
+    register: (driver: string, handler: (config: unknown, message: unknown) => Promise<unknown>) => void;
+};
+export declare function registerSendGridMailDriver(registry: Registry): Promise<void>;
+export {};
+//# sourceMappingURL=register.d.ts.map

package/packages/mail-sendgrid/src/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../packages/mail-sendgrid/src/register.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG;IACd,QAAQ,EAAE,CACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,KAC7D,IAAI,CAAC;CACX,CAAC;AAEF,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CASlF"}

package/packages/mail-sendgrid/src/register.js

@@ -0,0 +1,24 @@
+export async function registerSendGridMailDriver(registry) {
+    const core = (await importCore());
+    const driver = core.SendGridDriver;
+    if (driver === undefined)
+        return;
+    registry.register('sendgrid', (config, message) => driver.send(config, message));
+}
+const importCore = async () => {
+    try {
+        return await import('../../../src/index.js');
+    }
+    catch {
+        try {
+            return await import('../../../src/index.js');
+        }
+        catch {
+            return {};
+        }
+    }
+};
+const core = (await importCore());
+if (core.MailDriverRegistry !== undefined) {
+    await registerSendGridMailDriver(core.MailDriverRegistry);
+}

package/packages/mail-smtp/src/register.d.ts

@@ -0,0 +1,6 @@
+type Registry = {
+    register: (driver: string, handler: (config: unknown, message: unknown) => Promise<unknown>) => void;
+};
+export declare function registerSmtpMailDriver(registry: Registry): Promise<void>;
+export {};
+//# sourceMappingURL=register.d.ts.map

package/packages/mail-smtp/src/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../packages/mail-smtp/src/register.ts"],"names":[],"mappings":"AAEA,KAAK,QAAQ,GAAG;IACd,QAAQ,EAAE,CACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,KAC7D,IAAI,CAAC;CACX,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAc9E"}

package/packages/mail-smtp/src/register.js

@@ -0,0 +1,29 @@
+import { Logger } from '../../../src/index.js';
+export async function registerSmtpMailDriver(registry) {
+    const core = (await importCore());
+    if (core.SmtpDriver === undefined) {
+        Logger.warn('[SmtpDriver] Failed to import core SmtpDriver');
+        return;
+    }
+    const driver = core.SmtpDriver;
+    if (driver === undefined)
+        return;
+    registry.register('smtp', (config, message) => driver.send(config, message));
+}
+const importCore = async () => {
+    try {
+        return await import('../../../src/index.js');
+    }
+    catch {
+        try {
+            return await import('../../../src/index.js');
+        }
+        catch {
+            return {};
+        }
+    }
+};
+const core = (await importCore());
+if (core.MailDriverRegistry !== undefined) {
+    await registerSmtpMailDriver(core.MailDriverRegistry);
+}

package/packages/queue-monitor/src/QueueMonitoringService.d.ts

@@ -0,0 +1,35 @@
+import type { IRequest, IResponse } from '../../../src/index.js';
+import type { QueueDriver } from './driver';
+import type { LockAnalytics, QueueMonitorSnapshot } from './index';
+import type { JobSummary, Metrics } from './metrics';
+type QueueSnapshotData = {
+    type: string;
+    ts: string;
+    queue: string | null;
+    snapshot: QueueMonitorSnapshot;
+    jobs: unknown[];
+    locks: LockAnalytics;
+};
+type QueueMonitoringConfig = {
+    getSnapshot: () => Promise<QueueMonitorSnapshot>;
+    getLocks: (pattern?: string) => Promise<LockAnalytics>;
+    getRecentJobsForQueue: (queue: string, metrics: Metrics, driver: QueueDriver) => Promise<unknown[]>;
+    metrics: Metrics;
+    driver: QueueDriver;
+    queue: string;
+    pattern: string;
+    intervalMs: number;
+};
+export declare const QueueMonitoringService: Readonly<{
+    subscribe(callback: (data: QueueSnapshotData) => void): void;
+    unsubscribe(callback: (data: QueueSnapshotData) => void): void;
+    startPollingForClient(config: QueueMonitoringConfig): void;
+    stopPollingForClient(): void;
+}>;
+export declare const QueueMonitoringStream: (res: IResponse, req: IRequest, getSnapshot: () => Promise<QueueMonitorSnapshot>, getLocks: (pattern?: string) => Promise<LockAnalytics>, metrics: Metrics, driver: QueueDriver, settings: {
+    basePath: string;
+    refreshIntervalMs: number;
+}) => void;
+export declare function getRecentJobsForQueue(queueName: string, metrics: Metrics, driver: QueueDriver): Promise<JobSummary[]>;
+export {};
+//# sourceMappingURL=QueueMonitoringService.d.ts.map

package/packages/queue-monitor/src/QueueMonitoringService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueMonitoringService.d.ts","sourceRoot":"","sources":["../../../../packages/queue-monitor/src/QueueMonitoringService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAErD,KAAK,iBAAiB,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,KAAK,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,WAAW,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACjD,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACvD,qBAAqB,EAAE,CACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AA4DF,eAAO,MAAM,sBAAsB;wBACb,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI;0BAKtC,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI;kCAShC,qBAAqB,GAAG,IAAI;4BAOlC,IAAI;EAM5B,CAAC;AAOH,eAAO,MAAM,qBAAqB,GAChC,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,aAAa,MAAM,OAAO,CAAC,oBAAoB,CAAC,EAChD,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,EACtD,SAAS,OAAO,EAChB,QAAQ,WAAW,EACnB,UAAU;IACR,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,KACA,IAkEF,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CAmDvB"}

package/packages/queue-monitor/src/QueueMonitoringService.js

@@ -0,0 +1,194 @@
+import { Logger, NodeSingletons } from '../../../src/index.js';
+// Internal state
+const emitter = new NodeSingletons.EventEmitter();
+emitter.setMaxListeners(Infinity);
+let interval = null;
+let subscribers = 0;
+let currentConfig = null;
+const broadcastSnapshot = async () => {
+    try {
+        if (subscribers <= 0 || !currentConfig)
+            return;
+        const { getSnapshot, getLocks, metrics, driver, queue: initialQueue, pattern } = currentConfig;
+        const snapshot = await getSnapshot();
+        let queue = initialQueue;
+        if (!queue && snapshot.queues.length > 0) {
+            queue = snapshot.queues[0].name;
+        }
+        const jobs = queue ? await getRecentJobsForQueue(queue, metrics, driver) : [];
+        const locks = await getLocks(pattern);
+        const payload = {
+            type: 'snapshot',
+            ts: new Date().toISOString(),
+            queue: queue || null,
+            snapshot,
+            jobs,
+            locks,
+        };
+        emitter.emit('snapshot', payload);
+    }
+    catch (err) {
+        Logger.error('QueueMonitoringService.broadcastSnapshot failed', err);
+        if (emitter.listenerCount('error') > 0) {
+            emitter.emit('error', err);
+        }
+    }
+};
+const startPolling = () => {
+    if (interval || !currentConfig)
+        return;
+    Logger.debug('Starting QueueMonitoringService polling');
+    // Initial fetch
+    void broadcastSnapshot();
+    interval = setInterval(() => {
+        void broadcastSnapshot();
+    }, currentConfig.intervalMs);
+};
+const stopPolling = () => {
+    if (interval) {
+        Logger.debug('Stopping QueueMonitoringService polling');
+        clearInterval(interval);
+        interval = null;
+    }
+};
+export const QueueMonitoringService = Object.freeze({
+    subscribe(callback) {
+        emitter.on('snapshot', callback);
+        subscribers++;
+    },
+    unsubscribe(callback) {
+        emitter.off('snapshot', callback);
+        subscribers--;
+        if (subscribers <= 0) {
+            stopPolling();
+            currentConfig = null;
+        }
+    },
+    startPollingForClient(config) {
+        if (subscribers === 1) {
+            currentConfig = config;
+            startPolling();
+        }
+    },
+    stopPollingForClient() {
+        if (subscribers <= 0) {
+            stopPolling();
+            currentConfig = null;
+        }
+    },
+});
+//  settings: {
+//     basePath: string;
+//     refreshIntervalMs: number;
+//   },
+//   routeOptions: unknown,
+//   getSnapshot: () => Promise<QueueMonitorSnapshot>,
+export const QueueMonitoringStream = (res, req, getSnapshot, getLocks, metrics, driver, settings) => {
+    const raw = res.getRaw();
+    raw.writeHead(200, {
+        'Content-Type': 'text/event-stream',
+        'Cache-Control': 'no-cache, no-transform',
+        Connection: 'keep-alive',
+        'X-Accel-Buffering': 'no',
+    });
+    let closed = false;
+    const send = (payload) => {
+        if (closed)
+            return;
+        try {
+            const data = JSON.stringify(payload);
+            raw.write(`data: ${data}\n\n`);
+        }
+        catch (err) {
+            Logger.error('QueueMonitor SSE send failed', err);
+        }
+    };
+    // Send hello immediately
+    send({ type: 'hello', ts: new Date().toISOString() });
+    // Get query parameters
+    const getQuery = () => typeof req.getQuery === 'function'
+        ? req.getQuery()
+        : {};
+    const query = getQuery();
+    const queue = query['queue'] ?? '';
+    const pattern = query['pattern'] ?? '*';
+    // Define subscription callback
+    const onSnapshot = (data) => {
+        send(data);
+    };
+    // Subscribe to centralized service
+    QueueMonitoringService.subscribe(onSnapshot);
+    // Start polling for this client
+    QueueMonitoringService.startPollingForClient({
+        getSnapshot,
+        getLocks,
+        getRecentJobsForQueue,
+        metrics,
+        driver,
+        queue,
+        pattern,
+        intervalMs: settings.refreshIntervalMs,
+    });
+    // Heartbeat to keep connection alive
+    const hb = setInterval(() => {
+        if (!closed)
+            raw.write(': ping\n\n');
+    }, 15000);
+    raw.on('close', () => {
+        closed = true;
+        clearInterval(hb);
+        QueueMonitoringService.unsubscribe(onSnapshot);
+        QueueMonitoringService.stopPollingForClient();
+    });
+};
+export async function getRecentJobsForQueue(queueName, metrics, driver) {
+    const recent = await metrics.getRecentJobs(queueName);
+    const failed = await metrics.getFailedJobs(queueName);
+    const all = [...recent, ...failed].sort((a, b) => b.timestamp - a.timestamp).slice(0, 100);
+    if (all.length > 0) {
+        return all;
+    }
+    const jobs = await driver.getRecentJobs(queueName, 100);
+    const now = Date.now();
+    return jobs.map((job) => {
+        // Use the actual state from BullMQ if available
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const jobState = job._state;
+        // Fallback detection if state is not available
+        const isFailed = Boolean(job.failedReason) || jobState === 'failed';
+        const isCompleted = Boolean(job.finishedOn) || jobState === 'completed';
+        const isActive = Boolean(job.processedOn && !job.finishedOn && !job.failedReason) || jobState === 'active';
+        const isDelayed = jobState === 'delayed';
+        const isPaused = jobState === 'paused';
+        let status;
+        if (isFailed) {
+            status = 'failed';
+        }
+        else if (isCompleted) {
+            status = 'completed';
+        }
+        else if (isActive) {
+            status = 'active';
+        }
+        else if (isDelayed) {
+            status = 'delayed';
+        }
+        else if (isPaused) {
+            status = 'paused';
+        }
+        else {
+            status = 'waiting';
+        }
+        return {
+            id: job.id,
+            name: job.name,
+            data: job.data,
+            attempts: job.attemptsMade,
+            status,
+            failedReason: job.failedReason || undefined,
+            timestamp: job.timestamp ?? now,
+            processedOn: job.processedOn ?? undefined,
+            finishedOn: job.finishedOn ?? undefined,
+        };
+    });
+}

package/packages/queue-monitor/src/connection.d.ts

@@ -0,0 +1,3 @@
+export { createRedisConnection } from '../../../src/index.js';
+export type { RedisConfig } from '../../../src/index.js';
+//# sourceMappingURL=connection.d.ts.map

package/packages/queue-monitor/src/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../packages/queue-monitor/src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/packages/queue-monitor/src/connection.js

@@ -0,0 +1 @@
+export { createRedisConnection } from '../../../src/index.js';

package/packages/queue-monitor/src/dashboard-ui.d.ts

@@ -0,0 +1,7 @@
+export type DashboardUiOptions = {
+    basePath: string;
+    autoRefresh: boolean;
+    refreshIntervalMs: number;
+};
+export declare const getDashboardHtml: (options: DashboardUiOptions) => string;
+//# sourceMappingURL=dashboard-ui.d.ts.map

package/packages/queue-monitor/src/dashboard-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-ui.d.ts","sourceRoot":"","sources":["../../../../packages/queue-monitor/src/dashboard-ui.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAq/BF,eAAO,MAAM,gBAAgB,GAAI,SAAS,kBAAkB,KAAG,MAiBvD,CAAC"}