@zintrust/core 0.1.24 → 0.1.26

package/src/cli/workers/QueueWorkRunner.js

@@ -1,8 +1,11 @@
 import { Broadcast } from '../../tools/broadcast/Broadcast.js';
+import { Env } from '../../config/env.js';
 import { Logger } from '../../config/logger.js';
 import { queueConfig } from '../../config/queue.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { ZintrustLang } from '../../lang/lang.js';
 import { Notification } from '../../tools/notification/Notification.js';
+import { createLockProvider, getLockProvider, registerLockProvider } from '../../tools/queue/LockProvider.js';
 import { Queue } from '../../tools/queue/Queue.js';
 import { registerQueuesFromRuntimeConfig } from '../../tools/queue/QueueRuntimeRegistration.js';
 const isKind = (value) => value === 'broadcast' || value === 'notification';
@@ -44,9 +47,119 @@ const shouldStop = (startedAtMs, timeoutSeconds) => {
     const elapsedMs = Date.now() - startedAtMs;
     return elapsedMs >= timeoutSeconds * 1000;
 };
+const QUEUE_META_KEY = '__zintrustQueueMeta';
+let lockProviderCache = null;
+const getLockProviderForQueue = () => {
+    if (lockProviderCache)
+        return lockProviderCache;
+    const providerName = Env.get('QUEUE_LOCK_PROVIDER', ZintrustLang.REDIS).trim();
+    const prefix = Env.get('QUEUE_LOCK_PREFIX', ZintrustLang.ZINTRUST_LOCKS_PREFIX).trim();
+    const defaultTtl = Env.getInt('QUEUE_DEFAULT_DEDUP_TTL', ZintrustLang.ZINTRUST_LOCKS_TTL);
+    const existing = getLockProvider(providerName);
+    if (existing) {
+        lockProviderCache = existing;
+        return existing;
+    }
+    const provider = createLockProvider({
+        type: providerName === ZintrustLang.REDIS ? ZintrustLang.REDIS : ZintrustLang.MEMORY,
+        prefix: prefix.length > 0 ? prefix : ZintrustLang.ZINTRUST_LOCKS_PREFIX,
+        defaultTtl,
+    });
+    registerLockProvider(providerName, provider);
+    lockProviderCache = provider;
+    return provider;
+};
+const extractQueueMeta = (payload) => {
+    const metaValue = payload[QUEUE_META_KEY];
+    if (metaValue !== undefined && metaValue !== null && typeof metaValue === 'object') {
+        const { [QUEUE_META_KEY]: metaRaw, ...rest } = payload;
+        return { payload: rest, meta: metaRaw };
+    }
+    return { payload, meta: undefined };
+};
+const resolveConditionStatus = (condition) => {
+    const normalized = condition.trim().toLowerCase();
+    if (normalized.includes('failed') || normalized.includes('error'))
+        return 'failed';
+    if (normalized.includes('success') || normalized.includes('completed'))
+        return 'success';
+    // Try to extract explicit comparison like: job.result.status === "completed"
+    const match = new RegExp(/status\s*={1,3}\s*['"]([a-z]+)['"]/).exec(normalized);
+    const capturedValue = match?.[1];
+    if (capturedValue !== null && capturedValue !== undefined && capturedValue.length > 0) {
+        const value = capturedValue;
+        if (value === 'failed' || value === 'error')
+            return 'failed';
+        if (value === 'success' || value === 'completed')
+            return 'success';
+    }
+    return null;
+};
+const shouldReleaseForOutcome = (releaseAfter, outcome) => {
+    if (releaseAfter === 'success')
+        return outcome === 'success';
+    if (releaseAfter === 'failed')
+        return outcome === 'failed';
+    if (typeof releaseAfter === 'string') {
+        const normalized = releaseAfter.toLowerCase();
+        if (normalized.includes('failed') || normalized.includes('error'))
+            return outcome === 'failed';
+        if (normalized.includes('success') || normalized.includes('completed'))
+            return outcome === 'success';
+        const fromCondition = resolveConditionStatus(normalized);
+        return fromCondition !== null && fromCondition === outcome;
+    }
+    if (releaseAfter !== null && releaseAfter !== undefined && typeof releaseAfter === 'object') {
+        const condition = String(releaseAfter.condition ?? '').toLowerCase();
+        const fromCondition = resolveConditionStatus(condition);
+        return fromCondition !== null && fromCondition === outcome;
+    }
+    return false;
+};
+const releaseLockAfterResult = async (meta, outcome) => {
+    if (meta === undefined)
+        return;
+    const deduplicationId = meta.deduplicationId;
+    if (deduplicationId === undefined || deduplicationId === null) {
+        return;
+    }
+    const deduplicationKey = String(deduplicationId).trim();
+    if (deduplicationKey === '')
+        return;
+    const releaseAfter = meta.releaseAfter;
+    if (releaseAfter === undefined || releaseAfter === null || releaseAfter === '')
+        return;
+    if (!shouldReleaseForOutcome(releaseAfter, outcome))
+        return;
+    const provider = getLockProviderForQueue();
+    const doRelease = async () => {
+        const status = await provider.status(deduplicationKey);
+        if (!status.exists)
+            return;
+        await provider.release({
+            key: deduplicationKey,
+            ttl: status.ttl ?? 0,
+            acquired: true,
+            expires: status.expires ?? new Date(),
+        });
+    };
+    const delay = typeof releaseAfter === 'object' && typeof releaseAfter.delay === 'number'
+        ? releaseAfter.delay
+        : 0;
+    if (delay > 0) {
+        const timeoutId = globalThis.setTimeout(() => {
+            void doRelease();
+        }, delay);
+        timeoutId.unref();
+    }
+    else {
+        await doRelease();
+    }
+};
 const processMessage = async (options, msg, maxAttempts, result) => {
     const payload = msg.payload ?? {};
-    const kind = options.kind ?? detectKindFromPayload(payload);
+    const { payload: payloadWithoutMeta, meta } = extractQueueMeta(payload);
+    const kind = options.kind ?? detectKindFromPayload(payloadWithoutMeta);
     if (kind === undefined) {
         Logger.warn('Queue worker: unknown job payload; dropping', {
             queue: options.queueName,
@@ -57,24 +170,28 @@ const processMessage = async (options, msg, maxAttempts, result) => {
         await Queue.ack(options.queueName, msg.id, options.driverName);
         return 'continue';
     }
-    const timestamp = getTimestamp(payload);
+    const timestamp = getTimestamp(payloadWithoutMeta);
     if (typeof timestamp === 'number' && timestamp > Date.now()) {
         // Not due yet: re-enqueue and stop after rotating the head once.
-        await Queue.enqueue(options.queueName, payload, options.driverName);
+        const payloadForRequeue = meta
+            ? { ...payloadWithoutMeta, [QUEUE_META_KEY]: meta }
+            : payloadWithoutMeta;
+        await Queue.enqueue(options.queueName, payloadForRequeue, options.driverName);
         await Queue.ack(options.queueName, msg.id, options.driverName);
         result.notDueRequeued++;
         return 'break';
     }
-    const attempts = getAttempts(payload);
+    const attempts = getAttempts(payloadWithoutMeta);
     try {
         if (kind === 'broadcast') {
-            const job = payload;
+            const job = payloadWithoutMeta;
             await Broadcast.send(job.channel, job.event, job.data);
         }
         else {
-            const job = payload;
+            const job = payloadWithoutMeta;
             await Notification.send(job.recipient, job.message, job.options ?? {});
         }
+        await releaseLockAfterResult(meta, 'success');
         await Queue.ack(options.queueName, msg.id, options.driverName);
         result.processed++;
         return 'continue';
@@ -91,10 +208,14 @@ const processMessage = async (options, msg, maxAttempts, result) => {
             error,
         });
         if (canRetry) {
-            await Queue.enqueue(options.queueName, withAttempts(payload, nextAttempts), options.driverName);
+            const payloadForRetry = meta
+                ? { ...payloadWithoutMeta, [QUEUE_META_KEY]: meta }
+                : payloadWithoutMeta;
+            await Queue.enqueue(options.queueName, withAttempts(payloadForRetry, nextAttempts), options.driverName);
             result.retried++;
         }
         else {
+            await releaseLockAfterResult(meta, 'failed');
             result.dropped++;
         }
         await Queue.ack(options.queueName, msg.id, options.driverName);

package/src/common/ExternalServiceUtils.d.ts

@@ -47,7 +47,7 @@ export declare const HealthUtils: {
      * Build health response
      */
     buildHealthResponse(status: "healthy" | "unhealthy" | "alive" | "ready" | "not_ready", environment: string, extra?: Record<string, unknown>): {
-        status: "unhealthy" | "ready" | "healthy" | "alive" | "not_ready";
+        status: "ready" | "unhealthy" | "healthy" | "alive" | "not_ready";
         timestamp: string;
         environment: string;
     };
@@ -55,7 +55,7 @@ export declare const HealthUtils: {
      * Build error health response
      */
     buildErrorResponse(status: "unhealthy" | "not_ready", environment: string, error: Error, extra?: Record<string, unknown>): {
-        status: "unhealthy" | "ready" | "healthy" | "alive" | "not_ready";
+        status: "ready" | "unhealthy" | "healthy" | "alive" | "not_ready";
         timestamp: string;
         environment: string;
     };

package/src/config/app.d.ts

@@ -10,6 +10,10 @@ export declare const appConfig: Readonly<{
      * Application name
      */
     readonly name: string;
+    /**
+     * Application prefix
+     */
+    readonly prefix: string;
     /**
      * Application environment
      */

package/src/config/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/config/app.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,cAAc,CAAC;AAoI3D,QAAA,MAAM,UAAU,QAAO,MAAM,CAAC,UAA2B,CAAC;AA2E1D,eAAO,MAAM,SAAS;IAjEpB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;kCACc,OAAO;IAIxB;;OAEG;iCACa,OAAO;IAIvB;;OAEG;8BACU,OAAO;IAIpB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;+BApEkB,MAAM,CAAC,UAAU;kCAhDd,MAAM;EA2HoB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/config/app.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,cAAc,CAAC;AAoI3D,QAAA,MAAM,UAAU,QAAO,MAAM,CAAC,UAA2B,CAAC;AAsF1D,eAAO,MAAM,SAAS;IAtEpB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;kCACc,OAAO;IAIxB;;OAEG;iCACa,OAAO;IAIvB;;OAEG;8BACU,OAAO;IAIpB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;+BA/EkB,MAAM,CAAC,UAAU;kCAhDd,MAAM;EAsIoB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC"}

package/src/config/app.js

@@ -117,11 +117,20 @@ const normalizeMode = () => {
         return 'testing';
     return 'development';
 };
+const Prefix = () => {
+    const app_name = (Env.APP_NAME || 'zintrust').toLowerCase().replaceAll(/\s/g, '_');
+    const env = Env.NODE_ENV;
+    return `${app_name}_zintrust_${env}`;
+};
 const appConfigObj = {
     /**
      * Application name
      */
     name: readEnvString('APP_NAME', Env.APP_NAME),
+    /**
+     * Application prefix
+     */
+    prefix: Prefix(),
     /**
      * Application environment
      */

package/src/config/constants.d.ts

@@ -23,16 +23,81 @@ declare const MIME_TYPES: {
     readonly JS: "text/javascript";
     readonly CSS: "text/css";
     readonly PNG: "image/png";
-    readonly JPG: "image/jpg";
+    readonly JPG: "image/jpeg";
+    readonly JPEG: "image/jpeg";
     readonly GIF: "image/gif";
+    readonly ICO: "image/x-icon";
     readonly SVG: "image/svg+xml";
-    readonly WAV: "audio/wav";
+    readonly WEBP: "image/webp";
+    readonly AVIF: "image/avif";
+    readonly HEIC: "image/heic";
+    readonly HEIF: "image/heif";
+    readonly BMP: "image/bmp";
+    readonly TIFF: "image/tiff";
     readonly MP4: "video/mp4";
-    readonly WOFF: "application/font-woff";
-    readonly TTF: "application/font-ttf";
+    readonly WEBM: "video/webm";
+    readonly OGG: "video/ogg";
+    readonly AVI: "video/x-msvideo";
+    readonly MOV: "video/quicktime";
+    readonly WMV: "video/x-ms-wmv";
+    readonly FLV: "video/x-flv";
+    readonly MKV: "video/x-matroska";
+    readonly M4V: "video/x-m4v";
+    readonly WAV: "audio/wav";
+    readonly MP3: "audio/mpeg";
+    readonly OGA: "audio/ogg";
+    readonly FLAC: "audio/flac";
+    readonly AAC: "audio/aac";
+    readonly M4A: "audio/mp4";
+    readonly WMA: "audio/x-ms-wma";
+    readonly WOFF: "font/woff";
+    readonly WOFF2: "font/woff2";
+    readonly TTF: "font/ttf";
+    readonly OTF: "font/otf";
     readonly EOT: "application/vnd.ms-fontobject";
-    readonly OTF: "application/font-otf";
+    readonly PDF: "application/pdf";
+    readonly DOC: "application/msword";
+    readonly DOCX: "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+    readonly XLS: "application/vnd.ms-excel";
+    readonly XLSX: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+    readonly PPT: "application/vnd.ms-powerpoint";
+    readonly PPTX: "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+    readonly ODT: "application/vnd.oasis.opendocument.text";
+    readonly ODS: "application/vnd.oasis.opendocument.spreadsheet";
+    readonly ODP: "application/vnd.oasis.opendocument.presentation";
+    readonly ZIP: "application/zip";
+    readonly RAR: "application/x-rar-compressed";
+    readonly TAR: "application/x-tar";
+    readonly GZIP: "application/gzip";
+    readonly SEVEN_Z: "application/x-7z-compressed";
+    readonly PLIST: "application/x-plist";
+    readonly IPA: "application/octet-stream";
+    readonly MOBILECONFIG: "application/x-apple-aspen-config";
+    readonly APK: "application/vnd.android.package-archive";
+    readonly AAB: "application/x-authorware-bin";
+    readonly MANIFEST: "application/manifest+json";
+    readonly WEBAPP: "application/x-web-app-manifest+json";
+    readonly XML: "application/xml";
+    readonly YAML: "application/x-yaml";
+    readonly CSV: "text/csv";
+    readonly RTF: "application/rtf";
     readonly WASM: "application/wasm";
+    readonly EXE: "application/x-msdownload";
+    readonly DMG: "application/x-apple-diskimage";
+    readonly XHTML: "application/xhtml+xml";
+    readonly ATOM: "application/atom+xml";
+    readonly RSS: "application/rss+xml";
+    readonly PEM: "application/x-pem-file";
+    readonly P12: "application/x-pkcs12";
+    readonly PFX: "application/x-pkcs12";
+    readonly CRT: "application/x-x509-ca-cert";
+    readonly CER: "application/x-x509-ca-cert";
+    readonly SQLITE: "application/x-sqlite3";
+    readonly GLTF: "model/gltf+json";
+    readonly GLB: "model/gltf-binary";
+    readonly OBJ: "model/obj";
+    readonly CUR: "image/x-icon";
+    readonly ANI: "application/x-navi-animation";
 };
 declare const ENV_KEYS: {
     readonly NODE_ENV: "NODE_ENV";
@@ -75,16 +140,81 @@ export declare const Constants: Readonly<{
         readonly JS: "text/javascript";
         readonly CSS: "text/css";
         readonly PNG: "image/png";
-        readonly JPG: "image/jpg";
+        readonly JPG: "image/jpeg";
+        readonly JPEG: "image/jpeg";
         readonly GIF: "image/gif";
+        readonly ICO: "image/x-icon";
         readonly SVG: "image/svg+xml";
-        readonly WAV: "audio/wav";
+        readonly WEBP: "image/webp";
+        readonly AVIF: "image/avif";
+        readonly HEIC: "image/heic";
+        readonly HEIF: "image/heif";
+        readonly BMP: "image/bmp";
+        readonly TIFF: "image/tiff";
         readonly MP4: "video/mp4";
-        readonly WOFF: "application/font-woff";
-        readonly TTF: "application/font-ttf";
+        readonly WEBM: "video/webm";
+        readonly OGG: "video/ogg";
+        readonly AVI: "video/x-msvideo";
+        readonly MOV: "video/quicktime";
+        readonly WMV: "video/x-ms-wmv";
+        readonly FLV: "video/x-flv";
+        readonly MKV: "video/x-matroska";
+        readonly M4V: "video/x-m4v";
+        readonly WAV: "audio/wav";
+        readonly MP3: "audio/mpeg";
+        readonly OGA: "audio/ogg";
+        readonly FLAC: "audio/flac";
+        readonly AAC: "audio/aac";
+        readonly M4A: "audio/mp4";
+        readonly WMA: "audio/x-ms-wma";
+        readonly WOFF: "font/woff";
+        readonly WOFF2: "font/woff2";
+        readonly TTF: "font/ttf";
+        readonly OTF: "font/otf";
         readonly EOT: "application/vnd.ms-fontobject";
-        readonly OTF: "application/font-otf";
+        readonly PDF: "application/pdf";
+        readonly DOC: "application/msword";
+        readonly DOCX: "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+        readonly XLS: "application/vnd.ms-excel";
+        readonly XLSX: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+        readonly PPT: "application/vnd.ms-powerpoint";
+        readonly PPTX: "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+        readonly ODT: "application/vnd.oasis.opendocument.text";
+        readonly ODS: "application/vnd.oasis.opendocument.spreadsheet";
+        readonly ODP: "application/vnd.oasis.opendocument.presentation";
+        readonly ZIP: "application/zip";
+        readonly RAR: "application/x-rar-compressed";
+        readonly TAR: "application/x-tar";
+        readonly GZIP: "application/gzip";
+        readonly SEVEN_Z: "application/x-7z-compressed";
+        readonly PLIST: "application/x-plist";
+        readonly IPA: "application/octet-stream";
+        readonly MOBILECONFIG: "application/x-apple-aspen-config";
+        readonly APK: "application/vnd.android.package-archive";
+        readonly AAB: "application/x-authorware-bin";
+        readonly MANIFEST: "application/manifest+json";
+        readonly WEBAPP: "application/x-web-app-manifest+json";
+        readonly XML: "application/xml";
+        readonly YAML: "application/x-yaml";
+        readonly CSV: "text/csv";
+        readonly RTF: "application/rtf";
         readonly WASM: "application/wasm";
+        readonly EXE: "application/x-msdownload";
+        readonly DMG: "application/x-apple-diskimage";
+        readonly XHTML: "application/xhtml+xml";
+        readonly ATOM: "application/atom+xml";
+        readonly RSS: "application/rss+xml";
+        readonly PEM: "application/x-pem-file";
+        readonly P12: "application/x-pkcs12";
+        readonly PFX: "application/x-pkcs12";
+        readonly CRT: "application/x-x509-ca-cert";
+        readonly CER: "application/x-x509-ca-cert";
+        readonly SQLITE: "application/x-sqlite3";
+        readonly GLTF: "model/gltf+json";
+        readonly GLB: "model/gltf-binary";
+        readonly OBJ: "model/obj";
+        readonly CUR: "image/x-icon";
+        readonly ANI: "application/x-navi-animation";
     };
     ENV_KEYS: {
         readonly NODE_ENV: "NODE_ENV";

package/src/config/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;CAYR,CAAC;AAEX,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;CAiBN,CAAC;AAEX,QAAA,MAAM,QAAQ;;;;;;;;;;;CAWJ,CAAC;AAEX,QAAA,MAAM,QAAQ;;;;CAIJ,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKpB,CAAC;AAGH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/config/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,QAAA,MAAM,YAAY;;;;;;;;;;;;CAYR,CAAC;AAEX,QAAA,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkHN,CAAC;AAEX,QAAA,MAAM,QAAQ;;;;;;;;;;;CAWJ,CAAC;AAEX,QAAA,MAAM,QAAQ;;;;CAIJ,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKpB,CAAC;AAGH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/src/config/constants.js

@@ -22,17 +22,98 @@ const MIME_TYPES = {
     TEXT: 'text/plain',
     JS: 'text/javascript',
     CSS: 'text/css',
+    // Images
     PNG: 'image/png',
-    JPG: 'image/jpg',
+    JPG: 'image/jpeg',
+    JPEG: 'image/jpeg',
     GIF: 'image/gif',
+    ICO: 'image/x-icon',
     SVG: 'image/svg+xml',
-    WAV: 'audio/wav',
+    WEBP: 'image/webp',
+    AVIF: 'image/avif',
+    HEIC: 'image/heic',
+    HEIF: 'image/heif',
+    BMP: 'image/bmp',
+    TIFF: 'image/tiff',
+    // Videos
     MP4: 'video/mp4',
-    WOFF: 'application/font-woff',
-    TTF: 'application/font-ttf',
+    WEBM: 'video/webm',
+    OGG: 'video/ogg',
+    AVI: 'video/x-msvideo',
+    MOV: 'video/quicktime',
+    WMV: 'video/x-ms-wmv',
+    FLV: 'video/x-flv',
+    MKV: 'video/x-matroska',
+    M4V: 'video/x-m4v',
+    // Audio
+    WAV: 'audio/wav',
+    MP3: 'audio/mpeg',
+    OGA: 'audio/ogg',
+    FLAC: 'audio/flac',
+    AAC: 'audio/aac',
+    M4A: 'audio/mp4',
+    WMA: 'audio/x-ms-wma',
+    // Fonts
+    WOFF: 'font/woff',
+    WOFF2: 'font/woff2',
+    TTF: 'font/ttf',
+    OTF: 'font/otf',
     EOT: 'application/vnd.ms-fontobject',
-    OTF: 'application/font-otf',
+    // Documents
+    PDF: 'application/pdf',
+    DOC: 'application/msword',
+    DOCX: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    XLS: 'application/vnd.ms-excel',
+    XLSX: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    PPT: 'application/vnd.ms-powerpoint',
+    PPTX: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+    ODT: 'application/vnd.oasis.opendocument.text',
+    ODS: 'application/vnd.oasis.opendocument.spreadsheet',
+    ODP: 'application/vnd.oasis.opendocument.presentation',
+    // Archives
+    ZIP: 'application/zip',
+    RAR: 'application/x-rar-compressed',
+    TAR: 'application/x-tar',
+    GZIP: 'application/gzip',
+    SEVEN_Z: 'application/x-7z-compressed',
+    // iOS specific
+    PLIST: 'application/x-plist',
+    IPA: 'application/octet-stream',
+    MOBILECONFIG: 'application/x-apple-aspen-config',
+    // Android specific
+    APK: 'application/vnd.android.package-archive',
+    AAB: 'application/x-authorware-bin',
+    // Web/App Manifests
+    MANIFEST: 'application/manifest+json',
+    WEBAPP: 'application/x-web-app-manifest+json',
+    // API/Data formats
+    XML: 'application/xml',
+    YAML: 'application/x-yaml',
+    CSV: 'text/csv',
+    RTF: 'application/rtf',
+    // Binary/Executable
     WASM: 'application/wasm',
+    EXE: 'application/x-msdownload',
+    DMG: 'application/x-apple-diskimage',
+    // Standards
+    XHTML: 'application/xhtml+xml',
+    ATOM: 'application/atom+xml',
+    RSS: 'application/rss+xml',
+    // Security/Certificates
+    PEM: 'application/x-pem-file',
+    P12: 'application/x-pkcs12',
+    PFX: 'application/x-pkcs12',
+    CRT: 'application/x-x509-ca-cert',
+    CER: 'application/x-x509-ca-cert',
+    // Database
+    SQLITE: 'application/x-sqlite3',
+    // 3D/VR
+    GLTF: 'model/gltf+json',
+    GLB: 'model/gltf-binary',
+    OBJ: 'model/obj',
+    // Other common formats
+    CUR: 'image/x-icon',
+    ANI: 'application/x-navi-animation',
 };
 const ENV_KEYS = {
     NODE_ENV: 'NODE_ENV',

package/src/config/index.d.ts

@@ -20,6 +20,7 @@ export { createRedisConnection } from './workers';
 export declare const config: Readonly<{
     readonly app: Readonly<{
         readonly name: string;
+        readonly prefix: string;
         readonly environment: import("./type").StartMode;
         readonly port: number;
         readonly host: string;

package/src/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;8BAZc,CAAC;;;;;;;;;;;;;;;;;;;;2EAAC,CAAA;;;;;;;;;;;;;;;;;;;;8BAD2B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAmBrD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;EAKA,CAAC;AAEZ,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;8BAZc,CAAC;;;;;;;;;;;;;;;;;;;;2EAAC,CAAA;;;;;;;;;;;;;;;;;;;;8BAD2B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAmBrD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;EAKA,CAAC;AAEZ,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}

package/src/config/middleware.d.ts

@@ -1,10 +1,10 @@
 import type { MiddlewareConfigType } from './type';
-export declare enum MiddlewareBody {
-    email = "email",
-    password = "password",
-    name = "name",
-    count = "count"
-}
+export declare const MiddlewareBody: {
+    readonly email: "email";
+    readonly password: "password";
+    readonly name: "name";
+    readonly count: "count";
+};
 export type MiddlewaresType = {
     skipPaths: string[];
     fillRateLimit: {

package/src/config/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/config/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AA+DzD,oBAAY,cAAc;IACxB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,qBAAqB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3E,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;EAiBuB,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,cAAc,CAAC;AA0MxD,wBAAgB,sBAAsB,IAAI,oBAAoB,CAqB7D;AA0BD,eAAO,MAAM,gBAAgB,EAAE,oBAY7B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/config/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AA+DzD,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,qBAAqB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3E,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;EAiBuB,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,cAAc,CAAC;AA0MxD,wBAAgB,sBAAsB,IAAI,oBAAoB,CAqB7D;AA0BD,eAAO,MAAM,gBAAgB,EAAE,oBAY7B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/src/config/middleware.js

@@ -12,13 +12,12 @@ import { ValidationMiddleware } from '../middleware/ValidationMiddleware.js';
 import { StartupConfigFile, StartupConfigFileRegistry } from '../runtime/StartupConfigFileRegistry.js';
 import { Sanitizer } from '../security/Sanitizer.js';
 import { Schema } from '../validation/Validator.js';
-export var MiddlewareBody;
-(function (MiddlewareBody) {
-    MiddlewareBody["email"] = "email";
-    MiddlewareBody["password"] = "password";
-    MiddlewareBody["name"] = "name";
-    MiddlewareBody["count"] = "count";
-})(MiddlewareBody || (MiddlewareBody = {}));
+export const MiddlewareBody = {
+    email: 'email',
+    password: 'password',
+    name: 'name',
+    count: 'count',
+};
 export const MiddlewareKeys = Object.freeze({
     log: true,
     error: true,

package/src/config/queue.d.ts

@@ -25,6 +25,10 @@ export type QueueConfigOverrides = Partial<{
         refreshIntervalMs: number;
     };
 }>;
+/**
+ * Helper: Create base driver configurations from environment
+ */
+export declare const createBaseDrivers: () => QueueDriversConfig;
 declare const createQueueConfig: () => {
     default: QueueDriverName;
     drivers: QueueDriversConfig;

package/src/config/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/config/queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGhG,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC;IACzC,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH,CAAC,CAAC;AA+DH,QAAA,MAAM,iBAAiB,QAAO;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACjF,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CAuEH,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAqB/D,eAAO,MAAM,WAAW,EAAE,WAYxB,CAAC"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/config/queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGhG,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC;IACzC,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH,CAAC,CAAC;AAOH;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,kBA+BnC,CAAC;AAsBH,QAAA,MAAM,iBAAiB,QAAO;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACjF,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CAuEH,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAqB/D,eAAO,MAAM,WAAW,EAAE,WAYxB,CAAC"}

package/src/config/queue.js

@@ -12,7 +12,7 @@ const getQueueDriver = (config) => {
 /**
  * Helper: Create base driver configurations from environment
  */
-const createBaseDrivers = () => ({
+export const createBaseDrivers = () => ({
     sync: {
         driver: 'sync',
     },

package/src/config/redis.d.ts

@@ -0,0 +1,17 @@
+import type { RedisBroadcastDriverConfig } from './type';
+import type { QueueMessage } from '../tools/queue/Queue';
+export type QueueDriver = {
+    enqueue<T = unknown>(queue: string, payload: T): Promise<string>;
+    dequeue<T = unknown>(queue: string): Promise<QueueMessage<T> | undefined>;
+    ack(queue: string, id: string): Promise<void>;
+    length(queue: string): Promise<number>;
+    drain(queue: string): Promise<void>;
+};
+export type RedisPublishClient = {
+    connect?: () => Promise<void>;
+    publish(channel: string, message: string): Promise<number>;
+};
+export declare const buildRedisUrl: (config?: RedisBroadcastDriverConfig) => string;
+export declare const getRedisUrl: (config?: RedisBroadcastDriverConfig) => string | null;
+export declare const ensureDriver: <T = QueueDriver>(type?: "queue" | "publish") => Promise<T>;
+//# sourceMappingURL=redis.d.ts.map

package/src/config/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../src/config/redis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1E,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5D,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,SAAS,0BAA0B,KAAG,MAYnE,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,SAAS,0BAA0B,KAAG,MAAM,GAAG,IAW1E,CAAC;AAEF,eAAO,MAAM,YAAY,GAAU,CAAC,GAAG,WAAW,EAAE,OAAO,OAAO,GAAG,SAAS,KAAG,OAAO,CAAC,CAAC,CAqCzF,CAAC"}