@scpxl/nodejs-framework 1.0.22 → 1.0.24

package/dist/queue/manager.interface.d.ts

@@ -0,0 +1,18 @@
+import type { ApplicationConfig } from '../application/base-application.interface.js';
+import type DatabaseInstance from '../database/instance.js';
+import type EventManager from '../event/manager.js';
+import type { RedisInstance } from '../redis/index.js';
+import type { QueueItem } from './index.interface.js';
+export interface QueueManagerOptions {
+    /** Queue processors directory */
+    processorsDirectory: string;
+}
+export interface QueueManagerConstructorParams {
+    applicationConfig: ApplicationConfig;
+    options?: QueueManagerOptions;
+    queues: QueueItem[];
+    redisInstance: RedisInstance;
+    databaseInstance: DatabaseInstance | null;
+    eventManager?: EventManager;
+}
+//# sourceMappingURL=manager.interface.d.ts.map

package/dist/queue/manager.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.interface.d.ts","sourceRoot":"","sources":["../../src/queue/manager.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,KAAK,gBAAgB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,YAAY,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,6BAA6B;IAC5C,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1C,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B"}

package/dist/queue/processor/base.d.ts

@@ -0,0 +1,29 @@
+import type { Job } from 'bullmq';
+import type { QueueManager } from '../../queue/index.js';
+import type { DatabaseInstance } from '../../database/index.js';
+import type { ApplicationConfig } from '../../application/base-application.interface.js';
+import type { RedisInstance } from '../../redis/index.js';
+import type EventManager from '../../event/manager.js';
+import type { QueueJobData } from '../job.interface.js';
+export default abstract class BaseProcessor<TQueueManager extends QueueManager = QueueManager, TJobData extends QueueJobData = QueueJobData, TResult = unknown> {
+    protected queueManager: TQueueManager;
+    protected applicationConfig: ApplicationConfig;
+    protected redisInstance: RedisInstance;
+    protected databaseInstance: DatabaseInstance | null;
+    protected eventManager?: EventManager | undefined;
+    private logger;
+    constructor(queueManager: TQueueManager, applicationConfig: ApplicationConfig, redisInstance: RedisInstance, databaseInstance: DatabaseInstance | null, eventManager?: EventManager | undefined);
+    abstract process({ job }: {
+        job: Job<TJobData, TResult>;
+    }): Promise<TResult>;
+    /**
+     * Enhanced logger with structured methods
+     */
+    log: {
+        error: (error: Error | unknown, message?: string, meta?: Record<string, unknown>) => void;
+        info: (message: string, meta?: Record<string, unknown>) => void;
+        warn: (message: string, meta?: Record<string, unknown>) => void;
+        debug: (message: string, meta?: Record<string, unknown>) => void;
+    };
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/queue/processor/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/queue/processor/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAEzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,YAAY,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,aAAa,CACzC,aAAa,SAAS,YAAY,GAAG,YAAY,EACjD,QAAQ,SAAS,YAAY,GAAG,YAAY,EAC5C,OAAO,GAAG,OAAO;IAKf,SAAS,CAAC,YAAY,EAAE,aAAa;IACrC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB;IAC9C,SAAS,CAAC,aAAa,EAAE,aAAa;IACtC,SAAS,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,IAAI;IACnD,SAAS,CAAC,YAAY,CAAC,EAAE,YAAY;IAPvC,OAAO,CAAC,MAAM,CAAyB;gBAG3B,YAAY,EAAE,aAAa,EAC3B,iBAAiB,EAAE,iBAAiB,EACpC,aAAa,EAAE,aAAa,EAC5B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,EACzC,YAAY,CAAC,EAAE,YAAY,YAAA;aAGvB,OAAO,CAAC,EAAE,GAAG,EAAE,EAAE;QAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAEnF;;OAEG;IACI,GAAG;uBACO,KAAK,GAAG,OAAO,YAAY,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;wBAavE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;wBAI7C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;yBAI5C,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;MAG9D;CACH"}

package/dist/queue/processor/processor.interface.d.ts

@@ -0,0 +1,16 @@
+import type QueueManager from '../manager.js';
+import type { ApplicationConfig } from '../../application/base-application.interface.js';
+import type { RedisInstance } from '../../redis/index.js';
+import type { DatabaseInstance } from '../../database/index.js';
+import type EventManager from '../../event/manager.js';
+import type BaseProcessor from './base.js';
+import type { QueueJobData } from '../job.interface.js';
+export interface ProcessorConstructorParams<TQueueManager extends QueueManager = QueueManager, _TJobData extends QueueJobData = QueueJobData, _TResult = unknown> {
+    queueManager: TQueueManager;
+    applicationConfig: ApplicationConfig;
+    redisInstance: RedisInstance;
+    databaseInstance: DatabaseInstance | null;
+    eventManager?: EventManager;
+}
+export type ProcessorConstructor<TQueueManager extends QueueManager = QueueManager, TJobData extends QueueJobData = QueueJobData, TResult = unknown> = new (queueManager: TQueueManager, applicationConfig: ApplicationConfig, redisInstance: RedisInstance, databaseInstance: DatabaseInstance | null, eventManager?: EventManager) => BaseProcessor<TQueueManager, TJobData, TResult>;
+//# sourceMappingURL=processor.interface.d.ts.map

package/dist/queue/processor/processor.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.interface.d.ts","sourceRoot":"","sources":["../../../src/queue/processor/processor.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,YAAY,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,aAAa,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,0BAA0B,CACzC,aAAa,SAAS,YAAY,GAAG,YAAY,EACjD,SAAS,SAAS,YAAY,GAAG,YAAY,EAC7C,QAAQ,GAAG,OAAO;IAElB,YAAY,EAAE,aAAa,CAAC;IAC5B,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC1C,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,MAAM,oBAAoB,CAC9B,aAAa,SAAS,YAAY,GAAG,YAAY,EACjD,QAAQ,SAAS,YAAY,GAAG,YAAY,EAC5C,OAAO,GAAG,OAAO,IACf,KACF,YAAY,EAAE,aAAa,EAC3B,iBAAiB,EAAE,iBAAiB,EACpC,aAAa,EAAE,aAAa,EAC5B,gBAAgB,EAAE,gBAAgB,GAAG,IAAI,EACzC,YAAY,CAAC,EAAE,YAAY,KACxB,aAAa,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC"}

package/dist/queue/worker.d.ts

@@ -0,0 +1,14 @@
+import { Worker } from 'bullmq';
+import type { QueueWorkerConstructorParams } from './worker.interface.js';
+export default class QueueWorker extends Worker {
+    private applicationConfig;
+    private queueManager;
+    private redisInstance;
+    constructor({ applicationConfig, queueManager, name, processor, options, redisInstance, }: QueueWorkerConstructorParams);
+    private onWorkerActive;
+    private onWorkerError;
+    private onWorkerFailed;
+    private onWorkerStalled;
+    private onWorkerCompleted;
+}
+//# sourceMappingURL=worker.d.ts.map

package/dist/queue/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/queue/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC1D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAQ1E,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,MAAM;IAC7C,OAAO,CAAC,iBAAiB,CAAoB;IAE7C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,EACV,iBAAiB,EACjB,YAAY,EACZ,IAAI,EACJ,SAAS,EACT,OAAO,EACP,aAAa,GACd,EAAE,4BAA4B;IAe/B,OAAO,CAAC,cAAc,CAMpB;IAEF,OAAO,CAAC,aAAa,CAEnB;IAEF,OAAO,CAAC,cAAc,CAcpB;IAEF,OAAO,CAAC,eAAe,CAErB;IAEF,OAAO,CAAC,iBAAiB,CAwBvB;CACH"}

package/dist/queue/worker.interface.d.ts

@@ -0,0 +1,13 @@
+import type { Processor, WorkerOptions } from 'bullmq';
+import type { RedisInstance } from '../redis/index.js';
+import type { ApplicationConfig } from '../application/base-application.interface.js';
+import type QueueManager from './manager.js';
+export interface QueueWorkerConstructorParams {
+    applicationConfig: ApplicationConfig;
+    queueManager: QueueManager;
+    name: string;
+    processor: string | URL | Processor<any, any, string> | null | undefined;
+    options?: WorkerOptions;
+    redisInstance: RedisInstance;
+}
+//# sourceMappingURL=worker.interface.d.ts.map

package/dist/queue/worker.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.interface.d.ts","sourceRoot":"","sources":["../../src/queue/worker.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,KAAK,YAAY,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,4BAA4B;IAC3C,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,YAAY,EAAE,YAAY,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACzE,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,aAAa,EAAE,aAAa,CAAC;CAC9B"}

package/dist/redis/index.d.ts

@@ -0,0 +1,3 @@
+export { default as RedisManager } from './manager.js';
+export { default as RedisInstance } from './instance.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/redis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/redis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/redis/instance.d.ts

@@ -0,0 +1,32 @@
+import type { Redis } from 'ioredis';
+import type { RedisInstanceProps } from './instance.interface.js';
+export default class RedisInstance {
+    private redisManager;
+    client: Redis;
+    publisherClient: Redis;
+    subscriberClient: Redis;
+    constructor({ redisManager, client, publisherClient, subscriberClient }: RedisInstanceProps);
+    disconnect(): Promise<void>;
+    isConnected(): Promise<boolean>;
+    /**
+     * Sets a value in the cache with an optional expiration time.
+     *
+     * @param key - The key to set in the cache.
+     * @param value - The value to set in the cache.
+     * @param expiration - The expiration time in seconds (optional).
+     * @throws Error if the value type is not supported.
+     * @returns A Promise that resolves when the value is set in the cache.
+     */
+    setCache({ key, value, expiration, }: {
+        key: string;
+        value: unknown;
+        expiration?: number;
+    }): Promise<void>;
+    getCache({ key }: {
+        key: string;
+    }): Promise<string | null>;
+    deleteCache({ key }: {
+        key: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=instance.d.ts.map

package/dist/redis/instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../src/redis/instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC,OAAO,CAAC,YAAY,CAAe;IAE5B,MAAM,EAAE,KAAK,CAAC;IACd,eAAe,EAAE,KAAK,CAAC;IACvB,gBAAgB,EAAE,KAAK,CAAC;gBAEnB,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,gBAAgB,EAAE,EAAE,kBAAkB;IAQ9E,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBjC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBtC;;;;;;;;OAQG;IACU,QAAQ,CAAC,EACpB,GAAG,EACH,KAAK,EACL,UAAU,GACX,EAAE;QACD,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBJ,QAAQ,CAAC,EAAE,GAAG,EAAE,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM1D,WAAW,CAAC,EAAE,GAAG,EAAE,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlE"}

package/dist/redis/instance.interface.d.ts

@@ -0,0 +1,9 @@
+import type { Redis } from 'ioredis';
+import type { RedisManager } from './index.js';
+export interface RedisInstanceProps {
+    redisManager: RedisManager;
+    client: Redis;
+    publisherClient: Redis;
+    subscriberClient: Redis;
+}
+//# sourceMappingURL=instance.interface.d.ts.map

package/dist/redis/instance.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.interface.d.ts","sourceRoot":"","sources":["../../src/redis/instance.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,EAAE,KAAK,CAAC;IACd,eAAe,EAAE,KAAK,CAAC;IACvB,gBAAgB,EAAE,KAAK,CAAC;CACzB"}

package/dist/redis/manager.d.ts

@@ -0,0 +1,15 @@
+import type { RedisManagerConfig as RedisManagerOptions } from './manager.interface.js';
+import RedisInstance from './instance.js';
+export default class RedisManager {
+    private logger;
+    private options;
+    instances: RedisInstance[];
+    constructor(config: RedisManagerOptions);
+    connect(): Promise<RedisInstance>;
+    disconnect(): Promise<void>;
+    /**
+     * Log Redis message
+     */
+    log(message: string, meta?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/redis/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/redis/manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,aAAa,MAAM,eAAe,CAAC;AAuJ1C,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,OAAO,CAAC,MAAM,CAAyB;IAEvC,OAAO,CAAC,OAAO,CAAsB;IAE9B,SAAS,EAAE,aAAa,EAAE,CAAM;gBAE3B,MAAM,EAAE,mBAAmB;IAI1B,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IAkGjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiDxC;;OAEG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGlE"}

package/dist/redis/manager.interface.d.ts

@@ -0,0 +1,8 @@
+import type { ApplicationConfig } from '../application/base-application.interface.js';
+export interface RedisManagerConfig {
+    applicationConfig: ApplicationConfig;
+    host: string;
+    port: number;
+    password?: string;
+}
+//# sourceMappingURL=manager.interface.d.ts.map

package/dist/redis/manager.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.interface.d.ts","sourceRoot":"","sources":["../../src/redis/manager.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAEtF,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/redis/manager.js

@@ -9,6 +9,16 @@ const truthyPattern = /^(1|true|yes|on)$/i;
 const scheduleMicrotask = typeof globalThis.queueMicrotask === "function" ? globalThis.queueMicrotask.bind(globalThis) : (callback) => {
   void Promise.resolve().then(callback);
 };
+let globalInMemoryRedisState = null;
+function getGlobalInMemoryRedisState() {
+  globalInMemoryRedisState ??= {
+    store: /* @__PURE__ */ new Map(),
+    expirations: /* @__PURE__ */ new Map(),
+    subscriptions: /* @__PURE__ */ new Map()
+  };
+  return globalInMemoryRedisState;
+}
+__name(getGlobalInMemoryRedisState, "getGlobalInMemoryRedisState");
 class InMemoryRedisClient extends EventEmitter {
   static {
     __name(this, "InMemoryRedisClient");
@@ -96,14 +106,14 @@ class InMemoryRedisClient extends EventEmitter {
   }
   async quit() {
     this.cleanupSubscriptions();
-    this.removeAllListeners();
     this.emit("end");
+    this.removeAllListeners();
     return "OK";
   }
   disconnect() {
     this.cleanupSubscriptions();
-    this.removeAllListeners();
     this.emit("end");
+    this.removeAllListeners();
   }
 }
 class RedisManager {
@@ -129,20 +139,9 @@ class RedisManager {
           // Needed for bullmq
         };
         const useInMemoryRedis = truthyPattern.test(process.env.PXL_REDIS_IN_MEMORY ?? "") || truthyPattern.test(process.env.REDIS_IN_MEMORY ?? "");
-        let sharedState;
-        if (useInMemoryRedis) {
-          sharedState = {
-            store: /* @__PURE__ */ new Map(),
-            expirations: /* @__PURE__ */ new Map(),
-            subscriptions: /* @__PURE__ */ new Map()
-          };
-        }
         const createClient = /* @__PURE__ */ __name(() => {
           if (useInMemoryRedis) {
-            if (!sharedState) {
-              throw new Error("In-memory Redis shared state not initialized");
-            }
-            return new InMemoryRedisClient(sharedState);
+            return new InMemoryRedisClient(getGlobalInMemoryRedisState());
           }
           return new Redis(redisOptions);
         }, "createClient");

package/dist/redis/manager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/redis/manager.ts"],
-  "sourcesContent": ["import { Redis, type RedisOptions } from 'ioredis';\nimport { EventEmitter } from 'node:events';\nimport type { RedisManagerConfig as RedisManagerOptions } from './manager.interface.js';\nimport RedisInstance from './instance.js';\nimport { Logger } from '../logger/index.js';\nimport { CachePerformanceWrapper } from '../performance/index.js';\n\nconst truthyPattern = /^(1|true|yes|on)$/i;\nconst scheduleMicrotask =\n  typeof (globalThis as any).queueMicrotask === 'function'\n    ? (globalThis as any).queueMicrotask.bind(globalThis)\n    : (callback: () => void) => {\n        void Promise.resolve().then(callback);\n      };\n\ntype RedisCallback = (error: Error | null, result?: string) => void;\n\ninterface InMemoryRedisSharedState {\n  store: Map<string, string | Buffer>;\n  expirations: Map<string, NodeJS.Timeout>;\n  subscriptions: Map<string, Set<InMemoryRedisClient>>;\n}\n\nclass InMemoryRedisClient extends EventEmitter {\n  private shared: InMemoryRedisSharedState;\n\n  constructor(shared: InMemoryRedisSharedState) {\n    super();\n    this.shared = shared;\n\n    scheduleMicrotask(() => {\n      this.emit('ready');\n    });\n  }\n\n  private cleanupSubscriptions(): void {\n    for (const subscribers of this.shared.subscriptions.values()) {\n      subscribers.delete(this);\n    }\n  }\n\n  private clearExpirationForKey(key: string): void {\n    const timer = this.shared.expirations.get(key);\n    if (timer) {\n      clearTimeout(timer);\n      this.shared.expirations.delete(key);\n    }\n  }\n\n  public ping(callback?: RedisCallback): Promise<string> {\n    if (callback) {\n      callback(null, 'PONG');\n      return Promise.resolve('PONG');\n    }\n\n    return Promise.resolve('PONG');\n  }\n\n  public async set(...args: any[]): Promise<'OK'> {\n    const [key, value, mode, expiration] = args;\n    const serializedValue: string | Buffer = value instanceof Buffer ? value : String(value);\n\n    this.shared.store.set(key, serializedValue);\n    this.clearExpirationForKey(key);\n\n    if (typeof mode === 'string' && mode.toUpperCase() === 'EX' && typeof expiration === 'number') {\n      const timer = setTimeout(() => {\n        this.shared.store.delete(key);\n        this.shared.expirations.delete(key);\n      }, expiration * 1000);\n\n      if (typeof timer.unref === 'function') {\n        timer.unref();\n      }\n\n      this.shared.expirations.set(key, timer);\n    }\n\n    return 'OK';\n  }\n\n  public async get(key: string): Promise<string | null> {\n    return (this.shared.store.get(key) as string | undefined) ?? null;\n  }\n\n  public async del(key: string): Promise<number> {\n    const existed = this.shared.store.delete(key);\n    this.clearExpirationForKey(key);\n    return existed ? 1 : 0;\n  }\n\n  public async publish(channel: string, message: string): Promise<number> {\n    const subscribers = this.shared.subscriptions.get(channel);\n\n    if (!subscribers || subscribers.size === 0) {\n      return 0;\n    }\n\n    for (const subscriber of subscribers) {\n      scheduleMicrotask(() => {\n        subscriber.emit('message', channel, message);\n      });\n    }\n\n    return subscribers.size;\n  }\n\n  public async subscribe(channel: string): Promise<number> {\n    let subscribers = this.shared.subscriptions.get(channel);\n    if (!subscribers) {\n      subscribers = new Set<InMemoryRedisClient>();\n      this.shared.subscriptions.set(channel, subscribers);\n    }\n    subscribers.add(this);\n    return subscribers.size;\n  }\n\n  public async unsubscribe(channel: string): Promise<number> {\n    const subscribers = this.shared.subscriptions.get(channel);\n\n    if (!subscribers) {\n      return 0;\n    }\n\n    subscribers.delete(this);\n    return subscribers.size;\n  }\n\n  public async quit(): Promise<'OK'> {\n    this.cleanupSubscriptions();\n    this.removeAllListeners();\n    this.emit('end');\n    return 'OK';\n  }\n\n  public disconnect(): void {\n    this.cleanupSubscriptions();\n    this.removeAllListeners();\n    this.emit('end');\n  }\n}\n\nexport default class RedisManager {\n  private logger: typeof Logger = Logger;\n\n  private options: RedisManagerOptions;\n\n  public instances: RedisInstance[] = [];\n\n  constructor(config: RedisManagerOptions) {\n    this.options = config;\n  }\n\n  public async connect(): Promise<RedisInstance> {\n    return CachePerformanceWrapper.monitorConnection(\n      'connect',\n      async () => {\n        const startTime = performance.now();\n\n        const redisOptions: RedisOptions = {\n          host: this.options.host,\n          port: this.options.port,\n          password: this.options.password,\n          maxRetriesPerRequest: null, // Needed for bullmq\n        };\n\n        const useInMemoryRedis =\n          truthyPattern.test(process.env.PXL_REDIS_IN_MEMORY ?? '') ||\n          truthyPattern.test(process.env.REDIS_IN_MEMORY ?? '');\n\n        let sharedState: InMemoryRedisSharedState | undefined;\n        if (useInMemoryRedis) {\n          sharedState = {\n            store: new Map<string, string | Buffer>(),\n            expirations: new Map<string, NodeJS.Timeout>(),\n            subscriptions: new Map<string, Set<InMemoryRedisClient>>(),\n          };\n        }\n\n        const createClient = (): Redis => {\n          if (useInMemoryRedis) {\n            if (!sharedState) {\n              throw new Error('In-memory Redis shared state not initialized');\n            }\n            return new InMemoryRedisClient(sharedState) as unknown as Redis;\n          }\n\n          return new Redis(redisOptions);\n        };\n\n        const client = createClient();\n        const publisherClient = createClient();\n        const subscriberClient = createClient();\n\n        try {\n          // Wait for all three clients to be ready\n          await Promise.all([\n            new Promise<void>((resolve, reject) => {\n              client.once('ready', () => resolve());\n              client.once('error', (error: Error) => reject(error));\n            }),\n            new Promise<void>((resolve, reject) => {\n              publisherClient.once('ready', () => resolve());\n              publisherClient.once('error', (error: Error) => reject(error));\n            }),\n            new Promise<void>((resolve, reject) => {\n              subscriberClient.once('ready', () => resolve());\n              subscriberClient.once('error', (error: Error) => reject(error));\n            }),\n          ]);\n\n          const redisInstance = new RedisInstance({\n            redisManager: this,\n            client,\n            publisherClient,\n            subscriberClient,\n          });\n\n          this.instances.push(redisInstance);\n\n          const duration = performance.now() - startTime;\n          const meta = {\n            Host: this.options.host,\n            Port: this.options.port,\n            Duration: `${duration.toFixed(2)}ms`,\n            Mode: useInMemoryRedis ? 'in-memory' : 'network',\n          };\n\n          if (this.options.applicationConfig.log?.startUp) {\n            this.log('Connected', meta);\n          } else {\n            this.logger.debug({ message: 'Redis connected', meta });\n          }\n\n          if (useInMemoryRedis) {\n            this.logger.debug({ message: 'Using in-memory Redis stub' });\n          }\n\n          return redisInstance;\n        } catch (error) {\n          const duration = performance.now() - startTime;\n\n          // Clean up clients on error\n          await Promise.allSettled([client.quit(), publisherClient.quit(), subscriberClient.quit()]);\n\n          this.logger.error({\n            error: error instanceof Error ? error : new Error(String(error)),\n            message: 'Redis connection failed',\n            meta: {\n              Host: this.options.host,\n              Port: this.options.port,\n              Duration: `${duration.toFixed(2)}ms`,\n              Mode: useInMemoryRedis ? 'in-memory' : 'network',\n            },\n          });\n\n          throw error;\n        }\n      },\n      { host: this.options.host, port: this.options.port },\n    );\n  }\n\n  public async disconnect(): Promise<void> {\n    await CachePerformanceWrapper.monitorConnection(\n      'disconnect',\n      async () => {\n        const startTime = performance.now();\n        const instanceCount = this.instances.length;\n\n        try {\n          await Promise.all(this.instances.map(instance => instance.disconnect()));\n\n          const duration = performance.now() - startTime;\n\n          if (instanceCount > 0) {\n            const meta = {\n              Instances: instanceCount,\n              Host: this.options.host,\n              Port: this.options.port,\n              Duration: `${duration.toFixed(2)}ms`,\n            };\n\n            if (this.options.applicationConfig.log?.startUp) {\n              this.log('Disconnected all Redis instances', meta);\n            } else {\n              this.logger.debug({ message: 'Redis instances disconnected', meta });\n            }\n          }\n\n          this.instances = [];\n        } catch (error) {\n          const duration = performance.now() - startTime;\n\n          this.logger.error({\n            error: error instanceof Error ? error : new Error(String(error)),\n            message: 'Redis disconnection failed',\n            meta: {\n              Host: this.options.host,\n              Port: this.options.port,\n              Instances: instanceCount,\n              Duration: `${duration.toFixed(2)}ms`,\n            },\n          });\n\n          throw error;\n        }\n      },\n      { host: this.options.host, port: this.options.port },\n    );\n  }\n\n  /**\n   * Log Redis message\n   */\n  public log(message: string, meta?: Record<string, unknown>): void {\n    this.logger.custom({ level: 'redis', message, meta });\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { Redis, type RedisOptions } from 'ioredis';\nimport { EventEmitter } from 'node:events';\nimport type { RedisManagerConfig as RedisManagerOptions } from './manager.interface.js';\nimport RedisInstance from './instance.js';\nimport { Logger } from '../logger/index.js';\nimport { CachePerformanceWrapper } from '../performance/index.js';\n\nconst truthyPattern = /^(1|true|yes|on)$/i;\nconst scheduleMicrotask =\n  typeof (globalThis as any).queueMicrotask === 'function'\n    ? (globalThis as any).queueMicrotask.bind(globalThis)\n    : (callback: () => void) => {\n        void Promise.resolve().then(callback);\n      };\n\ntype RedisCallback = (error: Error | null, result?: string) => void;\n\ninterface InMemoryRedisSharedState {\n  store: Map<string, string | Buffer>;\n  expirations: Map<string, NodeJS.Timeout>;\n  subscriptions: Map<string, Set<InMemoryRedisClient>>;\n}\n\n// Global singleton shared state for in-memory Redis\nlet globalInMemoryRedisState: InMemoryRedisSharedState | null = null;\n\nfunction getGlobalInMemoryRedisState(): InMemoryRedisSharedState {\n  globalInMemoryRedisState ??= {\n    store: new Map<string, string | Buffer>(),\n    expirations: new Map<string, NodeJS.Timeout>(),\n    subscriptions: new Map<string, Set<InMemoryRedisClient>>(),\n  };\n  return globalInMemoryRedisState;\n}\n\nclass InMemoryRedisClient extends EventEmitter {\n  private shared: InMemoryRedisSharedState;\n\n  constructor(shared: InMemoryRedisSharedState) {\n    super();\n    this.shared = shared;\n\n    scheduleMicrotask(() => {\n      this.emit('ready');\n    });\n  }\n\n  private cleanupSubscriptions(): void {\n    for (const subscribers of this.shared.subscriptions.values()) {\n      subscribers.delete(this);\n    }\n  }\n\n  private clearExpirationForKey(key: string): void {\n    const timer = this.shared.expirations.get(key);\n    if (timer) {\n      clearTimeout(timer);\n      this.shared.expirations.delete(key);\n    }\n  }\n\n  public ping(callback?: RedisCallback): Promise<string> {\n    if (callback) {\n      callback(null, 'PONG');\n      return Promise.resolve('PONG');\n    }\n\n    return Promise.resolve('PONG');\n  }\n\n  public async set(...args: any[]): Promise<'OK'> {\n    const [key, value, mode, expiration] = args;\n    const serializedValue: string | Buffer = value instanceof Buffer ? value : String(value);\n\n    this.shared.store.set(key, serializedValue);\n    this.clearExpirationForKey(key);\n\n    if (typeof mode === 'string' && mode.toUpperCase() === 'EX' && typeof expiration === 'number') {\n      const timer = setTimeout(() => {\n        this.shared.store.delete(key);\n        this.shared.expirations.delete(key);\n      }, expiration * 1000);\n\n      if (typeof timer.unref === 'function') {\n        timer.unref();\n      }\n\n      this.shared.expirations.set(key, timer);\n    }\n\n    return 'OK';\n  }\n\n  public async get(key: string): Promise<string | null> {\n    return (this.shared.store.get(key) as string | undefined) ?? null;\n  }\n\n  public async del(key: string): Promise<number> {\n    const existed = this.shared.store.delete(key);\n    this.clearExpirationForKey(key);\n    return existed ? 1 : 0;\n  }\n\n  public async publish(channel: string, message: string): Promise<number> {\n    const subscribers = this.shared.subscriptions.get(channel);\n\n    if (!subscribers || subscribers.size === 0) {\n      return 0;\n    }\n\n    for (const subscriber of subscribers) {\n      scheduleMicrotask(() => {\n        subscriber.emit('message', channel, message);\n      });\n    }\n\n    return subscribers.size;\n  }\n\n  public async subscribe(channel: string): Promise<number> {\n    let subscribers = this.shared.subscriptions.get(channel);\n    if (!subscribers) {\n      subscribers = new Set<InMemoryRedisClient>();\n      this.shared.subscriptions.set(channel, subscribers);\n    }\n    subscribers.add(this);\n    return subscribers.size;\n  }\n\n  public async unsubscribe(channel: string): Promise<number> {\n    const subscribers = this.shared.subscriptions.get(channel);\n\n    if (!subscribers) {\n      return 0;\n    }\n\n    subscribers.delete(this);\n    return subscribers.size;\n  }\n\n  public async quit(): Promise<'OK'> {\n    this.cleanupSubscriptions();\n    this.emit('end');\n    this.removeAllListeners();\n    return 'OK';\n  }\n\n  public disconnect(): void {\n    this.cleanupSubscriptions();\n    this.emit('end');\n    this.removeAllListeners();\n  }\n}\n\nexport default class RedisManager {\n  private logger: typeof Logger = Logger;\n\n  private options: RedisManagerOptions;\n\n  public instances: RedisInstance[] = [];\n\n  constructor(config: RedisManagerOptions) {\n    this.options = config;\n  }\n\n  public async connect(): Promise<RedisInstance> {\n    return CachePerformanceWrapper.monitorConnection(\n      'connect',\n      async () => {\n        const startTime = performance.now();\n\n        const redisOptions: RedisOptions = {\n          host: this.options.host,\n          port: this.options.port,\n          password: this.options.password,\n          maxRetriesPerRequest: null, // Needed for bullmq\n        };\n\n        const useInMemoryRedis =\n          truthyPattern.test(process.env.PXL_REDIS_IN_MEMORY ?? '') ||\n          truthyPattern.test(process.env.REDIS_IN_MEMORY ?? '');\n\n        const createClient = (): Redis => {\n          if (useInMemoryRedis) {\n            return new InMemoryRedisClient(getGlobalInMemoryRedisState()) as unknown as Redis;\n          }\n\n          return new Redis(redisOptions);\n        };\n\n        const client = createClient();\n        const publisherClient = createClient();\n        const subscriberClient = createClient();\n\n        try {\n          // Wait for all three clients to be ready\n          await Promise.all([\n            new Promise<void>((resolve, reject) => {\n              client.once('ready', () => resolve());\n              client.once('error', (error: Error) => reject(error));\n            }),\n            new Promise<void>((resolve, reject) => {\n              publisherClient.once('ready', () => resolve());\n              publisherClient.once('error', (error: Error) => reject(error));\n            }),\n            new Promise<void>((resolve, reject) => {\n              subscriberClient.once('ready', () => resolve());\n              subscriberClient.once('error', (error: Error) => reject(error));\n            }),\n          ]);\n\n          const redisInstance = new RedisInstance({\n            redisManager: this,\n            client,\n            publisherClient,\n            subscriberClient,\n          });\n\n          this.instances.push(redisInstance);\n\n          const duration = performance.now() - startTime;\n          const meta = {\n            Host: this.options.host,\n            Port: this.options.port,\n            Duration: `${duration.toFixed(2)}ms`,\n            Mode: useInMemoryRedis ? 'in-memory' : 'network',\n          };\n\n          if (this.options.applicationConfig.log?.startUp) {\n            this.log('Connected', meta);\n          } else {\n            this.logger.debug({ message: 'Redis connected', meta });\n          }\n\n          if (useInMemoryRedis) {\n            this.logger.debug({ message: 'Using in-memory Redis stub' });\n          }\n\n          return redisInstance;\n        } catch (error) {\n          const duration = performance.now() - startTime;\n\n          // Clean up clients on error\n          await Promise.allSettled([client.quit(), publisherClient.quit(), subscriberClient.quit()]);\n\n          this.logger.error({\n            error: error instanceof Error ? error : new Error(String(error)),\n            message: 'Redis connection failed',\n            meta: {\n              Host: this.options.host,\n              Port: this.options.port,\n              Duration: `${duration.toFixed(2)}ms`,\n              Mode: useInMemoryRedis ? 'in-memory' : 'network',\n            },\n          });\n\n          throw error;\n        }\n      },\n      { host: this.options.host, port: this.options.port },\n    );\n  }\n\n  public async disconnect(): Promise<void> {\n    await CachePerformanceWrapper.monitorConnection(\n      'disconnect',\n      async () => {\n        const startTime = performance.now();\n        const instanceCount = this.instances.length;\n\n        try {\n          await Promise.all(this.instances.map(instance => instance.disconnect()));\n\n          const duration = performance.now() - startTime;\n\n          if (instanceCount > 0) {\n            const meta = {\n              Instances: instanceCount,\n              Host: this.options.host,\n              Port: this.options.port,\n              Duration: `${duration.toFixed(2)}ms`,\n            };\n\n            if (this.options.applicationConfig.log?.startUp) {\n              this.log('Disconnected all Redis instances', meta);\n            } else {\n              this.logger.debug({ message: 'Redis instances disconnected', meta });\n            }\n          }\n\n          this.instances = [];\n        } catch (error) {\n          const duration = performance.now() - startTime;\n\n          this.logger.error({\n            error: error instanceof Error ? error : new Error(String(error)),\n            message: 'Redis disconnection failed',\n            meta: {\n              Host: this.options.host,\n              Port: this.options.port,\n              Instances: instanceCount,\n              Duration: `${duration.toFixed(2)}ms`,\n            },\n          });\n\n          throw error;\n        }\n      },\n      { host: this.options.host, port: this.options.port },\n    );\n  }\n\n  /**\n   * Log Redis message\n   */\n  public log(message: string, meta?: Record<string, unknown>): void {\n    this.logger.custom({ level: 'redis', message, meta });\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/request-context/index.d.ts

@@ -0,0 +1,3 @@
+export type { RequestContext, RunWithContextOptions } from './request-context.interface.js';
+export { getRequestContext, getRequestId, getUserId, setUserId, getContextMetadata, setContextMetadata, runWithContext, runWithContextAsync, enterRequestContext, requestContextStorage, } from './request-context.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/request-context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/request-context/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC"}

package/dist/request-context/request-context.d.ts

@@ -0,0 +1,108 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import type { RequestContext, RunWithContextOptions } from './request-context.interface.js';
+/**
+ * AsyncLocalStorage instance for request context
+ *
+ * This provides request-scoped storage that automatically propagates through
+ * async operations, enabling correlation IDs and request metadata to be
+ * accessible throughout the request lifecycle without explicit passing.
+ */
+declare const requestContextStorage: AsyncLocalStorage<RequestContext>;
+/**
+ * Get the current request context
+ *
+ * @returns The current request context, or undefined if not in a request context
+ *
+ * @example
+ * const context = getRequestContext();
+ * if (context) {
+ *   console.log('Request ID:', context.requestId);
+ * }
+ */
+export declare function getRequestContext(): RequestContext | undefined;
+/**
+ * Get the current request ID
+ *
+ * @returns The current request ID, or undefined if not in a request context
+ *
+ * @example
+ * const requestId = getRequestId();
+ * logger.info({ message: 'Processing request', requestId });
+ */
+export declare function getRequestId(): string | undefined;
+/**
+ * Set metadata in the current request context
+ *
+ * @param key - Metadata key
+ * @param value - Metadata value
+ *
+ * @example
+ * setContextMetadata('operation', 'userLookup');
+ * setContextMetadata('cacheHit', true);
+ */
+export declare function setContextMetadata(key: string, value: unknown): void;
+/**
+ * Get metadata from the current request context
+ *
+ * @param key - Metadata key
+ * @returns Metadata value, or undefined if not found
+ */
+export declare function getContextMetadata(key: string): unknown;
+/**
+ * Run a function within a new request context
+ *
+ * @param options - Context options (requestId will be generated if not provided)
+ * @param fn - Function to run within the context
+ * @returns The result of the function
+ *
+ * @example
+ * await runWithContext({ requestId: 'custom-id' }, async () => {
+ *   await processRequest();
+ * });
+ */
+export declare function runWithContext<T>(options: RunWithContextOptions | undefined, fn: () => T): T;
+/**
+ * Run a function within a new request context (async version)
+ *
+ * @param options - Context options (requestId will be generated if not provided)
+ * @param fn - Async function to run within the context
+ * @returns Promise resolving to the result of the function
+ *
+ * @example
+ * await runWithContextAsync({ requestId: 'custom-id' }, async () => {
+ *   await processRequest();
+ * });
+ */
+export declare function runWithContextAsync<T>(options: RunWithContextOptions | undefined, fn: () => Promise<T>): Promise<T>;
+/**
+ * Update the user ID in the current request context
+ *
+ * @param userId - User ID to set
+ *
+ * @example
+ * // After authentication
+ * setUserId(authenticatedUser.id);
+ */
+export declare function setUserId(userId: string): void;
+/**
+ * Get the user ID from the current request context
+ *
+ * @returns The current user ID, or undefined if not set
+ */
+export declare function getUserId(): string | undefined;
+/**
+ * Enter a new request context (advanced usage for middleware)
+ *
+ * This sets the context for the current async execution context without
+ * wrapping in a callback. Use with caution - prefer runWithContext when possible.
+ *
+ * @param options - Context options
+ *
+ * @example
+ * // In Fastify middleware
+ * const requestId = req.headers['x-request-id'] || crypto.randomUUID();
+ * enterRequestContext({ requestId });
+ */
+export declare function enterRequestContext(options: RunWithContextOptions): void;
+export { requestContextStorage };
+//# sourceMappingURL=request-context.d.ts.map

package/dist/request-context/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/request-context/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5F;;;;;;GAMG;AACH,QAAA,MAAM,qBAAqB,mCAA0C,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAEjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAOpE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,qBAAqB,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAS5F;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,OAAO,EAAE,qBAAqB,GAAG,SAAS,EAC1C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAK9C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAE9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CASxE;AAGD,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/request-context/request-context.interface.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Request context interface
+ *
+ * This interface defines the shape of the context stored in AsyncLocalStorage
+ * for each HTTP request, providing correlation IDs and request metadata.
+ */
+export interface RequestContext {
+    /**
+     * Unique request ID (UUID v4/v7) for tracing/correlation
+     */
+    requestId: string;
+    /**
+     * Request start time (performance.now() timestamp)
+     */
+    startTime?: number;
+    /**
+     * Authenticated user ID (if available)
+     */
+    userId?: string;
+    /**
+     * Additional custom metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for running code within a request context
+ */
+export interface RunWithContextOptions {
+    /**
+     * Request ID to use (generated if not provided)
+     */
+    requestId?: string;
+    /**
+     * Request start time
+     */
+    startTime?: number;
+    /**
+     * User ID
+     */
+    userId?: string;
+    /**
+     * Additional metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=request-context.interface.d.ts.map

package/dist/request-context/request-context.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.interface.d.ts","sourceRoot":"","sources":["../../src/request-context/request-context.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/services/aws/index.d.ts

@@ -0,0 +1,2 @@
+export { default as AwsS3 } from './s3.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/aws/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/aws/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC"}

package/dist/services/aws/s3.d.ts

@@ -0,0 +1,54 @@
+import { S3Client } from '@aws-sdk/client-s3';
+import type { AwsS3ConstructorOptions } from './s3.interface.js';
+interface DownloadFileOptions {
+    bucketName: string;
+    key: string;
+    destinationFilePath: string;
+}
+export default class AwsS3 {
+    client: S3Client;
+    private options;
+    constructor(options: Partial<AwsS3ConstructorOptions>);
+    private getBucketUrl;
+    uploadFile({ bucketName, path, body, contentType, forceDownload, publicRead, }: {
+        bucketName: string;
+        path: string;
+        body: Buffer;
+        contentType?: string;
+        forceDownload?: boolean;
+        publicRead?: boolean;
+    }): Promise<string>;
+    startMultipartUpload({ bucketName, path, publicRead, }: {
+        bucketName: string;
+        path: string;
+        publicRead?: boolean;
+    }): Promise<string | undefined>;
+    uploadPart({ bucketName, path, partNumber, uploadId, body, }: {
+        bucketName: string;
+        path: string;
+        partNumber: number;
+        uploadId: string;
+        body: any;
+    }): Promise<string | undefined>;
+    completeMultipartUpload({ bucketName, path, uploadId, parts, }: {
+        bucketName: string;
+        path: string;
+        uploadId: string;
+        parts: {
+            PartNumber: number;
+            ETag: string;
+        }[];
+    }): Promise<string>;
+    downloadFile({ bucketName, key, destinationFilePath, onStart, onProgress, onComplete, onError, }: DownloadFileOptions & {
+        onStart?: () => void;
+        onProgress?: (progress: number) => void;
+        onComplete?: () => void;
+        onError?: (error: Error) => void;
+    }): Promise<void>;
+    generateSignedUrl({ bucket, key }: {
+        bucket: string;
+        key: string;
+    }): Promise<string>;
+}
+export {};
+//# sourceMappingURL=s3.d.ts.map

package/dist/services/aws/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../../src/services/aws/s3.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,QAAQ,EAGT,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AASjE,UAAU,mBAAmB;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,CAAC,OAAO,OAAO,KAAK;IACjB,MAAM,EAAE,QAAQ,CAAC;IAExB,OAAO,CAAC,OAAO,CAA0B;gBAE7B,OAAO,EAAE,OAAO,CAAC,uBAAuB,CAAC;IA4CrD,OAAO,CAAC,YAAY;IAYP,UAAU,CAAC,EACtB,UAAU,EACV,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,aAAa,EACb,UAAU,GACX,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBN,oBAAoB,CAAC,EAChC,UAAU,EACV,IAAI,EACJ,UAAU,GACX,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB;IAYY,UAAU,CAAC,EACtB,UAAU,EACV,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,IAAI,GACL,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,GAAG,CAAC;KACX,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAclB,uBAAuB,CAAC,EACnC,UAAU,EACV,IAAI,EACJ,QAAQ,EACR,KAAK,GACN,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC/C;IA0BK,YAAY,CAAC,EACjB,UAAU,EACV,GAAG,EACH,mBAAmB,EACnB,OAAO,EACP,UAAU,EACV,UAAU,EACV,OAAO,GACR,EAAE,mBAAmB,GAAG;QACvB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;QACrB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;QACxC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;QACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;KAClC,GAAG,OAAO,CAAC,IAAI,CAAC;IA+EJ,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CA2BlG"}

package/dist/services/aws/s3.interface.d.ts

@@ -0,0 +1,14 @@
+export interface AwsS3LocalstackOptions {
+    enabled?: boolean;
+    port?: number;
+}
+export interface AwsS3ConstructorOptions {
+    region: string;
+    localstack: AwsS3LocalstackOptions;
+    credentials?: {
+        accessKeyId?: string;
+        secretAccessKey?: string;
+    };
+    endpoint?: string;
+}
+//# sourceMappingURL=s3.interface.d.ts.map

package/dist/services/aws/s3.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.interface.d.ts","sourceRoot":"","sources":["../../../src/services/aws/s3.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,sBAAsB,CAAC;IACnC,WAAW,CAAC,EAAE;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/services/index.d.ts

@@ -0,0 +1,2 @@
+export * from './aws/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}