@nightx.co/pulsar 0.0.0-stage → 1.0.15

package/dist/server/helpers/acquireRedisLock.d.ts

@@ -0,0 +1,14 @@
+import type { IQueueRepository } from "../../storage/repositories/QueueRepository";
+interface IAquireInstanceLock {
+    repository: IQueueRepository;
+    isEventDriven: boolean;
+    targetQueue: string;
+    lastExecutionId: string;
+    instanceId: string;
+}
+export declare function aquireInstanceLock({ repository, isEventDriven, lastExecutionId, targetQueue, instanceId }: IAquireInstanceLock): Promise<string | {
+    message: string;
+    status: number;
+}>;
+export {};
+//# sourceMappingURL=acquireRedisLock.d.ts.map

package/dist/server/helpers/acquireRedisLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acquireRedisLock.d.ts","sourceRoot":"","sources":["../../../src/server/helpers/acquireRedisLock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAEnF,UAAU,mBAAmB;IACzB,UAAU,EAAG,gBAAgB,CAAC;IAC9B,aAAa,EAAG,OAAO,CAAC;IACxB,WAAW,EAAG,MAAM,CAAC;IACrB,eAAe,EAAG,MAAM,CAAC;IACzB,UAAU,EAAG,MAAM,CAAC;CACvB;AAED,wBAAsB,kBAAkB,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,EAAG,mBAAmB;;;GAsBrI"}

package/dist/server/helpers/checkFencingValidity.d.ts

@@ -0,0 +1,14 @@
+import type { IPulsarPostgresEngineOperationRepository } from "../../storage/repositories/PostgresEngineOperationRepository";
+interface ICheckFencingTokenValidity {
+    isEventDriven: boolean;
+    executionOwner: string;
+    fencingToken?: string;
+    targetQueue: string;
+    ops: IPulsarPostgresEngineOperationRepository;
+}
+export declare function checkFencingTokenValidity({ executionOwner, fencingToken, isEventDriven, targetQueue, ops }: ICheckFencingTokenValidity): Promise<{
+    message: string;
+    status: number;
+} | undefined>;
+export {};
+//# sourceMappingURL=checkFencingValidity.d.ts.map

package/dist/server/helpers/checkFencingValidity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkFencingValidity.d.ts","sourceRoot":"","sources":["../../../src/server/helpers/checkFencingValidity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wCAAwC,EAAE,MAAM,8DAA8D,CAAC;AAE7H,UAAU,0BAA0B;IAChC,aAAa,EAAG,OAAO,CAAC;IACxB,cAAc,EAAG,MAAM,CAAC;IACxB,YAAY,CAAC,EAAG,MAAM,CAAC;IACvB,WAAW,EAAG,MAAM,CAAC;IACrB,GAAG,EAAG,wCAAwC,CAAC;CAClD;AAED,wBAAsB,yBAAyB,CAAC,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,EAAE,EAAG,0BAA0B;;;eA8B7I"}

package/dist/server/helpers/performIsolateRestart.d.ts

@@ -0,0 +1,20 @@
+import type { Pulsar } from "../../service/Pulsar.service";
+import type { IsolateInstance } from "../../service/Isolate.service";
+import type { EnginePoolingMode } from "../../types/engine.types";
+interface IEnginePerformRestart {
+    isRestarted: boolean;
+    isV8Isolate: boolean;
+    isolate?: IsolateInstance;
+    executionOwner: string;
+    lastIsolateId: string;
+    lastExecutionId: string;
+    poolerMode: EnginePoolingMode;
+    targetQueue: string;
+    engine: Pulsar;
+}
+export declare function performEngineRestart({ targetQueue, isRestarted, isV8Isolate, isolate, executionOwner, lastExecutionId, lastIsolateId, poolerMode, engine }: IEnginePerformRestart): Promise<{
+    message: string;
+    status: number;
+} | undefined>;
+export {};
+//# sourceMappingURL=performIsolateRestart.d.ts.map

package/dist/server/helpers/performIsolateRestart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performIsolateRestart.d.ts","sourceRoot":"","sources":["../../../src/server/helpers/performIsolateRestart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,UAAU,qBAAqB;IAC3B,WAAW,EAAG,OAAO,CAAC;IACtB,WAAW,EAAG,OAAO,CAAC;IACtB,OAAO,CAAC,EAAG,eAAe,CAAC;IAC3B,cAAc,EAAG,MAAM,CAAC;IACxB,aAAa,EAAG,MAAM,CAAC;IACvB,eAAe,EAAG,MAAM,CAAC;IACzB,UAAU,EAAG,iBAAiB,CAAC;IAC/B,WAAW,EAAG,MAAM,CAAC;IACrB,MAAM,EAAG,MAAM,CAAC;CACnB;AAED,wBAAsB,oBAAoB,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,EAAG,qBAAqB;;;eA6CxL"}

package/dist/server/index.d.ts

@@ -0,0 +1,2 @@
+export { type GetEngine, createPulsarRequestHandler, type ErrorHook } from "./PulsarRequestHandler";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/server/index.js

@@ -0,0 +1,8 @@
+/**
+ * Pulsar by NightX
+ * Copyright (c) 2026 NightX. All rights reserved.
+ */
+import{a as S,b as x,c as k}from"../chunk-a9kye38b.js";import"../chunk-3sg08kqp.js";async function D({repository:t,isEventDriven:i,lastExecutionId:n,targetQueue:o,instanceId:c}){let r=i?`lock:edp:${o}`:"lock:idp",l=120000;if(await t.acquireQueueLock(r,n,120000))await t.clearDispatchPending(r);else return console.log(`[LOCK REJECTED] : Active execution lock already held for key: ${r}`),{message:"Isolate active, skipping redundant run.",status:200};return r}async function $({executionOwner:t,fencingToken:i,isEventDriven:n,targetQueue:o,ops:c}){if(n&&t=="trigger"){if(!i||i=="NOT_INCLUDED"){let l=`[EventDrivenPoller]-[ExecutionTrigger]-[${o}] : Engine execution rejected: Fencing token is missing.`;return console.error(l),{message:l,status:200}}if(!await c.checkFencingTokenValidity(o,i)){let l=`[EventDrivenPoller]-[ExecutionTrigger]-[${o}] : Engine execution rejected : Invalid fencing token.`;return console.error(l),{message:l,status:200}}else console.log("[EventDrivenPoller] : Engine started via DB trigger",{queue:o,currentToken:i,previousToken:isNaN(parseInt(i,10))?null:parseInt(i,10)-1})}}async function m({targetQueue:t,isRestarted:i,isV8Isolate:n,isolate:o,executionOwner:c,lastExecutionId:r,lastIsolateId:l,poolerMode:a,engine:s}){let f=o?.uptime??0,e=o?.maxTime??1/0,p=n&&f>=e;if(i&&n&&o){if(console.log(`[Pulsar] : Engine Restarted By (${c==="watchdog"?"watchdog":"self"})`),o.isSameIsolate(l))console.log(`[Pulsar] : Engine Restarted in same isolate (${o.id}), Header Isolate (${l})`);if(p){console.log(`[${new Date().toISOString()}]: Engine Restarted With Network Call due to isolate recycling.`);let y={"content-type":"application/json","x-last-execution-id":r,"x-last-execution-at":new Date().toISOString(),"x-execution-owner":c,"x-restart":i?"true":"false","x-pooler":a,...t!==void 0&&{"x-target-queue":t}};return await s.restartForSameIsolate(y),{message:"Engine Restarted Due To Same Isolate with no time to process.",status:200}}await s.deleteScheduledRestart(t??"__GLOBAL__")}if(p&&n)return console.log(`[${new Date().toISOString()}] : Scheduling restart for (${t})`),await s.scheduleRestart(t),{message:"Engine Started Successfully",status:200}}class L{opts;onErrorHook;constructor(t){this.opts=t}onError(t){return this.onErrorHook=t,this}async handle(t){let{url:i,method:n,body:o,headers:c}=await x(t),r=new URL(i),l={headers:c,body:o};if(r.pathname.endsWith("/ack")&&n=="POST")return await this.handleAck(l);if(r.pathname.endsWith("/nack")&&n=="POST")return await this.handleNack(l);if(r.pathname.endsWith("/retry")&&n=="POST")return await this.handleRetry(l);if(r.pathname.endsWith("/validate_config")&&n=="POST")return await this.handleReconcileConfiguration();return await this.handleEngineExecution(t)}async getMessageIds(t){let{headers:i}=t,n=t.body;if(typeof n==="string")try{n=JSON.parse(n)}catch(a){throw Error(a)}let o=i["x-queue"],c=i["x-worker-id"];if(!o)throw Error("[getMessageIds] : Queue Not Found In Headers");if(!c)throw Error("[getMessageIds] : Worker Id Not Found In Headers");let l=(Array.isArray(n?.msg_ids)?n.msg_ids:[]).map((a)=>Number.parseInt(String(a),10)).filter((a)=>Number.isInteger(a)&&a>=0);if(l.length==0)throw Error("[getMessageIds] : No message ids were found");return{queue:o,messageIds:l,workerId:c}}async performBatchAction(t,i,n,o){try{await this.opts.unifiedStorage.connect();let c=new S(this.opts.unifiedStorage);switch(o){case"ACK":await c.ackBatch(t,n);break;case"NACK":await c.ackBatch(t,n);break;case"RETRY":await c.retryBatch(t,n);break}}catch(c){console.log(c)}finally{await this.opts.unifiedStorage.repository.deregisterWorker(i,t)}}async handleAck(t){let{messageIds:i,queue:n,workerId:o}=await this.getMessageIds(t);return await this.performBatchAction(n,o,i,"ACK"),{message:"Jobs Acknowledged",status:200}}async handleNack(t){let{queue:i,workerId:n,messageIds:o}=await this.getMessageIds(t);return console.log(`[NACK] : Queue ${i} : Message IDs ${o}`),await this.performBatchAction(i,n,o,"NACK"),{message:"Jobs Nack Applied",status:200}}async handleRetry(t){let{queue:i,workerId:n,messageIds:o}=await this.getMessageIds(t);return console.log(`[RETRY] : Queue ${i} : Message IDs ${o}`),await this.performBatchAction(i,n,o,"RETRY"),{message:"Jobs Retry Applied",status:200}}async handleReconcileConfiguration(){return await this.opts.getEngine(this.opts.instanceId).validateConfiguration()}async handleEngineExecution(t){let{headers:i}=await x(t),n=k(i),{executionOwner:o,isRestarted:c,lastExecutionId:r,lastIsolateId:l,poolerMode:a,targetQueue:s,fencingToken:f}=n,e=a==="event-driven-pooler";if(e&&!s)return{message:"Target queue is not defined.",status:400};console.log("[PulsarRequestHandlerBuilder] : Executing request for engine startup."),await this.opts.unifiedStorage.connect(),this.opts.unifiedStorage.bindInstanceId(this.opts.instanceId);let p=await $({executionOwner:o,isEventDriven:e,targetQueue:s,fencingToken:f,ops:this.opts.unifiedStorage.ops});if(p)return p;let y=await D({isEventDriven:e,lastExecutionId:r,targetQueue:s,repository:this.opts.unifiedStorage.repository,instanceId:this.opts.instanceId});if(typeof y=="object")return y;if(this.opts.isolate)this.opts.isolate.set("current_execution_id",r),this.opts.isolate.set("lock_key",y);let g=this.opts.getEngine(this.opts.instanceId);g.setCurrentExecutionId(r);let P=g.runtime==="V8_ISOLATE",T=this.opts.isolate;if(P&&!T)throw Error("[Pulsar SDK] : 'isolate' option must be provided when runtime is V8_ISOLATE.");try{let E=await m({engine:g,isolate:T,executionOwner:o,isRestarted:c,isV8Isolate:P,lastExecutionId:r,lastIsolateId:l,poolerMode:a,targetQueue:s});if(E)return E;if(e&&s)await g.triggerQueue(s);else await g.start();return{message:"Engine Started Successfully",status:200}}catch(E){if(this.onErrorHook){if(this.onErrorHook(E))return{message:"Interval Exception Raised",status:200}}throw E}finally{await g.awaitPendingShutdown()}}}function O(t){return new L(t)}export{O as createPulsarRequestHandler};
+/* Powered by NightX - Pulsar Engine */
+
+//# debugId=B4777F1937E60F9B64756E2164756E21

package/dist/server/index.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["..\\src\\server\\helpers\\acquireRedisLock.ts", "..\\src\\server\\helpers\\checkFencingValidity.ts", "..\\src\\server\\helpers\\performIsolateRestart.ts", "..\\src\\server\\PulsarRequestHandler.ts"],
+  "sourcesContent": [
+    "import type { IQueueRepository } from \"../../storage/repositories/QueueRepository\";\r\n\r\ninterface IAquireInstanceLock {\r\n    repository : IQueueRepository;\r\n    isEventDriven : boolean;\r\n    targetQueue : string;\r\n    lastExecutionId : string;\r\n    instanceId : string;\r\n}\r\n\r\nexport async function aquireInstanceLock({ repository, isEventDriven, lastExecutionId, targetQueue, instanceId } : IAquireInstanceLock) {\r\n    const lockKey = isEventDriven ? `lock:edp:${targetQueue}` : `lock:idp`;\r\n    const lockTTL = 120_000;\r\n\r\n    const lockAcquired = await repository.acquireQueueLock(\r\n        lockKey,\r\n        lastExecutionId,\r\n        lockTTL\r\n    )\r\n\r\n    if (lockAcquired) {\r\n        await repository.clearDispatchPending(lockKey);\r\n    }\r\n    else {\r\n        console.log(`[LOCK REJECTED] : Active execution lock already held for key: ${lockKey}`);\r\n        return {\r\n            message: \"Isolate active, skipping redundant run.\",\r\n            status: 200\r\n        }\r\n    }\r\n\r\n    return lockKey;\r\n}",
+    "import type { IPulsarPostgresEngineOperationRepository } from \"../../storage/repositories/PostgresEngineOperationRepository\";\r\n\r\ninterface ICheckFencingTokenValidity {\r\n    isEventDriven : boolean;\r\n    executionOwner : string;\r\n    fencingToken? : string;\r\n    targetQueue : string;\r\n    ops : IPulsarPostgresEngineOperationRepository;\r\n}\r\n\r\nexport async function checkFencingTokenValidity({ executionOwner, fencingToken, isEventDriven, targetQueue, ops } : ICheckFencingTokenValidity) {\r\n    if(isEventDriven && executionOwner == \"trigger\") {\r\n        if(!fencingToken || fencingToken == \"NOT_INCLUDED\") {\r\n            const errorMsg = `[EventDrivenPoller]-[ExecutionTrigger]-[${targetQueue}] : Engine execution rejected: Fencing token is missing.`;\r\n            console.error(errorMsg);\r\n            return {\r\n                message: errorMsg,\r\n                status: 200\r\n            }\r\n        }\r\n\r\n        const isValidToken = await ops.checkFencingTokenValidity(targetQueue, fencingToken);\r\n\r\n        if(!isValidToken) {\r\n            const errorMsg = `[EventDrivenPoller]-[ExecutionTrigger]-[${targetQueue}] : Engine execution rejected : Invalid fencing token.`;\r\n            console.error(errorMsg);\r\n            return {\r\n                message: errorMsg,\r\n                status: 200\r\n            }\r\n        }\r\n\r\n        else {\r\n            console.log(\"[EventDrivenPoller] : Engine started via DB trigger\", {\r\n                queue: targetQueue,\r\n                currentToken: fencingToken,\r\n                previousToken: isNaN(parseInt(fencingToken, 10)) ? null : parseInt(fencingToken, 10) - 1\r\n            })\r\n        }\r\n    }\r\n}",
+    "import type { Pulsar } from \"../../service/Pulsar.service\";\r\nimport type { IsolateInstance } from \"../../service/Isolate.service\";\r\nimport type { EnginePoolingMode } from \"../../types/engine.types\";\r\n\r\ninterface IEnginePerformRestart {\r\n    isRestarted : boolean;\r\n    isV8Isolate : boolean;\r\n    isolate? : IsolateInstance;\r\n    executionOwner : string;\r\n    lastIsolateId : string;\r\n    lastExecutionId : string;\r\n    poolerMode : EnginePoolingMode;\r\n    targetQueue : string;\r\n    engine : Pulsar;\r\n}\r\n\r\nexport async function performEngineRestart({ targetQueue, isRestarted, isV8Isolate, isolate, executionOwner, lastExecutionId, lastIsolateId, poolerMode, engine } : IEnginePerformRestart) {\r\n    const isolateUptime = isolate?.uptime ?? 0;\r\n    const isolateMaxTime = isolate?.maxTime ?? Infinity;\r\n    const shouldRecycleIsolate = isV8Isolate && isolateUptime >= isolateMaxTime;\r\n\r\n    if (isRestarted && isV8Isolate && isolate) {\r\n        console.log(`[Pulsar] : Engine Restarted By (${executionOwner === \"watchdog\" ? \"watchdog\" : \"self\"})`);\r\n\r\n        if (isolate.isSameIsolate(lastIsolateId)) {\r\n            console.log(`[Pulsar] : Engine Restarted in same isolate (${isolate.id}), Header Isolate (${lastIsolateId})`);\r\n        }\r\n\r\n        if (shouldRecycleIsolate) {\r\n            console.log(`[${new Date().toISOString()}]: Engine Restarted With Network Call due to isolate recycling.`);\r\n\r\n            const nextHeaders: Record<string, string> = {\r\n                \"content-type\": \"application/json\",\r\n                \"x-last-execution-id\": lastExecutionId,\r\n                \"x-last-execution-at\": new Date().toISOString(),\r\n                \"x-execution-owner\": executionOwner,\r\n                \"x-restart\": isRestarted ? \"true\" : \"false\",\r\n                \"x-pooler\": poolerMode,\r\n                ...(targetQueue !== undefined && { \"x-target-queue\": targetQueue })\r\n            }\r\n\r\n            await engine.restartForSameIsolate(nextHeaders);\r\n\r\n            return {\r\n                message: \"Engine Restarted Due To Same Isolate with no time to process.\",\r\n                status: 200\r\n            }\r\n        }\r\n\r\n        await engine.deleteScheduledRestart(targetQueue ?? \"__GLOBAL__\");\r\n    }\r\n\r\n    if (shouldRecycleIsolate && isV8Isolate) {\r\n        console.log(`[${new Date().toISOString()}] : Scheduling restart for (${targetQueue})`);\r\n        await engine.scheduleRestart(targetQueue as string);\r\n\r\n        return {\r\n            message: \"Engine Started Successfully\",\r\n            status: 200\r\n        }\r\n    }\r\n}",
+    "import { QueueService } from \"../modules/Queue.module\";\r\nimport { aquireInstanceLock } from \"./helpers/acquireRedisLock\";\r\nimport { checkFencingTokenValidity } from \"./helpers/checkFencingValidity\";\r\nimport { performEngineRestart } from \"./helpers/performIsolateRestart\";\r\nimport { parseRequest } from \"./parser/parseRequest\";\r\nimport { extractHeaders } from \"./utility/extract-headers\";\r\n\r\nimport type { IsolateInstance } from \"../service/Isolate.service\";\r\nimport type { Pulsar } from \"../service/Pulsar.service\";\r\nimport type { PulsarUnifiedStorage } from \"../storage/PulsarStorage\";\r\n\r\ninterface PulsarHandlerOptions {\r\n    unifiedStorage : PulsarUnifiedStorage;\r\n    getEngine: (instanceId : string) => Pulsar;\r\n    instanceId : string;\r\n    /**\r\n     * Optional isolate instance. Required only when Pulsar runtime is V8_ISOLATE.\r\n     */\r\n    isolate? : IsolateInstance;\r\n}\r\n\r\n\r\nexport type GetEngine = {\r\n    lockKey : string;\r\n    instanceId : string;\r\n}\r\n\r\ntype StandardResponse = {\r\n    status : number;\r\n    message : string;\r\n}\r\n\r\ntype StandardArgs = {\r\n    headers : Record<string, string>;\r\n    body: any;\r\n}\r\n\r\nexport type ErrorHook = (error : unknown) => Response | void;\r\n\r\nclass PulsarRequestHandlerBuilder {\r\n    private onErrorHook? : ErrorHook;\r\n\r\n    constructor(private readonly opts : PulsarHandlerOptions) {}\r\n\r\n    public onError(fn : ErrorHook): this {\r\n        this.onErrorHook = fn;\r\n        return this;\r\n    }\r\n\r\n    public async handle(req : Request) {\r\n        const { url : rawUrl, method, body, headers } = await parseRequest(req);\r\n\r\n        const url = new URL(rawUrl);\r\n        const args = { headers, body };\r\n\r\n        if (url.pathname.endsWith(\"/ack\") && method == \"POST\") {\r\n            return await this.handleAck(args);\r\n        }\r\n\r\n        if (url.pathname.endsWith(\"/nack\") && method == \"POST\") {\r\n            return await this.handleNack(args);\r\n        }\r\n\r\n        if (url.pathname.endsWith(\"/retry\") && method == \"POST\") {\r\n            return await this.handleRetry(args);\r\n        }\r\n\r\n        if (url.pathname.endsWith(\"/validate_config\") && method == \"POST\") {\r\n            return await this.handleReconcileConfiguration();\r\n        }\r\n\r\n        return await this.handleEngineExecution(req);\r\n    }\r\n\r\n    private async getMessageIds(args : StandardArgs) : Promise<{queue : string, messageIds : number[], workerId : string}> {\r\n        const { headers } = args;\r\n\r\n        let parsedBody = args.body;\r\n        if (typeof parsedBody === \"string\") {\r\n            try {\r\n                parsedBody = JSON.parse(parsedBody);\r\n            }\r\n            catch (err : any) {\r\n                throw new Error(err);\r\n            }\r\n        }\r\n\r\n        const queue = headers[\"x-queue\"];\r\n        const workerId = headers[\"x-worker-id\"];\r\n\r\n        if(!queue) throw new Error(\"[getMessageIds] : Queue Not Found In Headers\");\r\n        if(!workerId) throw new Error(\"[getMessageIds] : Worker Id Not Found In Headers\");\r\n\r\n        const rawMsgIds = (Array.isArray(parsedBody?.msg_ids) ? parsedBody.msg_ids : []) as number[];\r\n        const messageIds : number[] = rawMsgIds.map((id) => Number.parseInt(String(id), 10)).filter((id) => Number.isInteger(id) && id >= 0);\r\n\r\n        if(messageIds.length == 0) throw new Error(\"[getMessageIds] : No message ids were found\");\r\n\r\n        return { queue, messageIds, workerId };\r\n    }\r\n\r\n    private async performBatchAction(queue : string, workerId : string, messageIds : number[], action : \"ACK\" | \"NACK\" | \"RETRY\") {\r\n        try {\r\n            await this.opts.unifiedStorage.connect();\r\n\r\n            const queueService = new QueueService(this.opts.unifiedStorage);\r\n\r\n            switch (action) {\r\n                case \"ACK\":\r\n                    await queueService.ackBatch(queue, messageIds);\r\n                    break;\r\n                case \"NACK\":\r\n                    await queueService.ackBatch(queue, messageIds);\r\n                    break;\r\n                case \"RETRY\":\r\n                    await queueService.retryBatch(queue, messageIds);\r\n                    break;\r\n            }\r\n        }\r\n        catch (error) {\r\n            console.log(error);\r\n        }\r\n        finally {\r\n            await this.opts.unifiedStorage.repository.deregisterWorker(workerId, queue);\r\n        }\r\n    }\r\n\r\n    private async handleAck(args : StandardArgs) : Promise<StandardResponse> {\r\n        const { messageIds, queue, workerId } = await this.getMessageIds(args);\r\n\r\n        //console.log(`[ACK] : Queue ${queue} : Message IDs ${messageIds}`);\r\n\r\n        await this.performBatchAction(queue, workerId, messageIds, \"ACK\");\r\n\r\n        return { message : \"Jobs Acknowledged\", status : 200 }\r\n    }\r\n\r\n    private async handleNack(args : StandardArgs) : Promise<StandardResponse> {\r\n        const { queue, workerId, messageIds } = await this.getMessageIds(args);\r\n\r\n        console.log(`[NACK] : Queue ${queue} : Message IDs ${messageIds}`);\r\n\r\n        await this.performBatchAction(queue, workerId, messageIds, \"NACK\");\r\n\r\n        return { message : \"Jobs Nack Applied\", status : 200 }\r\n    }\r\n\r\n    private async handleRetry(args : StandardArgs) : Promise<StandardResponse> {\r\n        const { queue, workerId, messageIds } = await this.getMessageIds(args);\r\n\r\n        console.log(`[RETRY] : Queue ${queue} : Message IDs ${messageIds}`);\r\n\r\n        await this.performBatchAction(queue, workerId, messageIds, \"RETRY\");\r\n\r\n        return { message : \"Jobs Retry Applied\", status : 200 }\r\n    }\r\n\r\n    private async handleReconcileConfiguration () : Promise<StandardResponse> {\r\n        const engine = this.opts.getEngine(this.opts.instanceId);\r\n        return await engine.validateConfiguration();\r\n    }\r\n\r\n    /**\r\n     * Handles the HTTP request lifecycle for Pulsar Engine.\r\n     */\r\n    public async handleEngineExecution(req : Request) : Promise<StandardResponse> {\r\n        const { headers : rawHeaders } = await parseRequest(req);\r\n        const headers = extractHeaders(rawHeaders);\r\n\r\n        const {\r\n            executionOwner,\r\n            isRestarted,\r\n            lastExecutionId,\r\n            lastIsolateId,\r\n            poolerMode,\r\n            targetQueue,\r\n            fencingToken,\r\n        } = headers;\r\n\r\n        const isEventDriven = poolerMode === \"event-driven-pooler\";\r\n\r\n        if (isEventDriven && !targetQueue) {\r\n            return {\r\n                message: \"Target queue is not defined.\",\r\n                status: 400\r\n            }\r\n        }\r\n\r\n        console.log(`[PulsarRequestHandlerBuilder] : Executing request for engine startup.`);\r\n\r\n        await this.opts.unifiedStorage.connect();\r\n        this.opts.unifiedStorage.bindInstanceId(this.opts.instanceId);\r\n\r\n        const invalidFencingResponse = await checkFencingTokenValidity({\r\n            executionOwner,\r\n            isEventDriven,\r\n            targetQueue : targetQueue as string,\r\n            fencingToken,\r\n            ops : this.opts.unifiedStorage.ops\r\n        })\r\n\r\n        if(invalidFencingResponse) return invalidFencingResponse;\r\n\r\n        const lockAquiredResponse = await aquireInstanceLock({\r\n            isEventDriven,\r\n            lastExecutionId,\r\n            targetQueue : targetQueue as string,\r\n            repository : this.opts.unifiedStorage.repository,\r\n            instanceId : this.opts.instanceId\r\n        })\r\n\r\n        if(typeof lockAquiredResponse == \"object\") {\r\n            return lockAquiredResponse;\r\n        }\r\n\r\n        if(this.opts.isolate) {\r\n            this.opts.isolate.set('current_execution_id', lastExecutionId);\r\n            this.opts.isolate.set('lock_key', lockAquiredResponse);\r\n        }\r\n\r\n        const engine = this.opts.getEngine(this.opts.instanceId);\r\n        engine.setCurrentExecutionId(lastExecutionId);\r\n        const isV8Isolate = engine.runtime === \"V8_ISOLATE\";\r\n\r\n        const isolate = this.opts.isolate;\r\n        if (isV8Isolate && !isolate) {\r\n            throw new Error(\"[Pulsar SDK] : 'isolate' option must be provided when runtime is V8_ISOLATE.\");\r\n        }\r\n\r\n        try {\r\n            const blockResponse = await performEngineRestart({\r\n                engine,\r\n                isolate,\r\n                executionOwner,\r\n                isRestarted,\r\n                isV8Isolate,\r\n                lastExecutionId,\r\n                lastIsolateId,\r\n                poolerMode,\r\n                targetQueue : targetQueue as string \r\n            })\r\n\r\n            if(blockResponse) {\r\n                return blockResponse;\r\n            }\r\n\r\n            if (isEventDriven && targetQueue) {\r\n                await engine.triggerQueue(targetQueue);\r\n            }\r\n            else {\r\n                await engine.start();\r\n            }\r\n\r\n            return {\r\n                message: \"Engine Started Successfully\",\r\n                status: 200\r\n            }\r\n        }\r\n        catch (err) {\r\n            if (this.onErrorHook) {\r\n                const customErrResponse = this.onErrorHook(err);\r\n                if (customErrResponse) {\r\n                    return {\r\n                        message : \"Interval Exception Raised\",\r\n                        status : 200\r\n                    }\r\n                }\r\n            }\r\n            throw err;\r\n        }\r\n        finally {\r\n            await engine.awaitPendingShutdown();\r\n        }\r\n    }\r\n}\r\n\r\nexport function createPulsarRequestHandler(opts : PulsarHandlerOptions) : PulsarRequestHandlerBuilder {\r\n    return new PulsarRequestHandlerBuilder(opts);\r\n}"
+  ],
+  "mappings": "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",
+  "debugId": "B4777F1937E60F9B64756E2164756E21",
+  "names": []
+}

package/dist/server/parser/parseRequest.d.ts

@@ -0,0 +1,10 @@
+export interface ParsedRequest {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    query: Record<string, string>;
+    body: any;
+    rawBody: string | null;
+}
+export declare function parseRequest(rawInput: any): Promise<ParsedRequest>;
+//# sourceMappingURL=parseRequest.d.ts.map

package/dist/server/parser/parseRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseRequest.d.ts","sourceRoot":"","sources":["../../../src/server/parser/parseRequest.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAwID,wBAAsB,YAAY,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,CAsHxE"}

package/dist/server/utility/extract-headers.d.ts

@@ -0,0 +1,14 @@
+import type { EnginePoolingMode } from "../../types/engine.types";
+export type ResponseHeaders = {
+    isRestarted: boolean;
+    poolerMode: EnginePoolingMode;
+    lastExecutionId: string;
+    lastExecutionAt: string;
+    lastIsolateId: string;
+    executionOwner: "watchdog" | "engine" | "trigger";
+    targetQueue?: string;
+    fencingToken?: string;
+    workerId?: string;
+};
+export declare const extractHeaders: (rawHeaders: Record<string, string>) => ResponseHeaders;
+//# sourceMappingURL=extract-headers.d.ts.map

package/dist/server/utility/extract-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-headers.d.ts","sourceRoot":"","sources":["../../../src/server/utility/extract-headers.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,MAAM,MAAM,eAAe,GAAG;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAG,MAAM,CAAC;CACtB,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,YAAa,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAI,eAYrE,CAAA"}

package/dist/service/ConfigurationStore.d.ts

@@ -0,0 +1,23 @@
+import type { EngineConfig } from "../types/base.types.d.ts";
+import type { PostgresEngineOperationRepository } from "../storage/repositories/PostgresEngineOperationRepository";
+import type { EngineQueuesConfig } from "../types/queue.types";
+import type { PathValue, SettablePathKeys, ReadablePathKeys } from "../types/config.types";
+export declare class ConfigurationStore {
+    private static instance;
+    protected _config?: EngineConfig;
+    private initialSnapshot?;
+    private logger;
+    constructor();
+    static getInstance(): ConfigurationStore;
+    initialize(baseConfig: EngineConfig): void;
+    private throwExpectionOnInvalidConfiguration;
+    private ensureInitialized;
+    get raw(): Readonly<EngineConfig>;
+    get<P extends ReadablePathKeys<EngineConfig>>(path: P): PathValue<EngineConfig, P>;
+    getInitialSnapshot(): Readonly<EngineConfig>;
+    set<P extends SettablePathKeys<EngineConfig>>(path: P, value: PathValue<EngineConfig, P>): void;
+    modifyQueue<K extends keyof EngineQueuesConfig, P extends SettablePathKeys<EngineQueuesConfig>>(queue: string, key: K, value: PathValue<EngineQueuesConfig, P>): void;
+    reconcileConfiguration(repository: PostgresEngineOperationRepository): Promise<"[Configuration] status : [VALID]." | "[Configuration] status : [INVALID & Reconciled].">;
+}
+export declare const config: ConfigurationStore;
+//# sourceMappingURL=ConfigurationStore.d.ts.map

package/dist/service/ConfigurationStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigurationStore.d.ts","sourceRoot":"","sources":["../../src/service/ConfigurationStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,2DAA2D,CAAC;AACnH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAwB,MAAM,uBAAuB,CAAC;AAWjH,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAC7C,SAAS,CAAC,OAAO,CAAC,EAAG,YAAY,CAAC;IAClC,OAAO,CAAC,eAAe,CAAC,CAAgB;IACxC,OAAO,CAAC,MAAM,CAAW;;WAMX,WAAW,IAAK,kBAAkB;IAOzC,UAAU,CAAC,UAAU,EAAG,YAAY;IA8C3C,OAAO,CAAC,oCAAoC;IAmF5C,OAAO,CAAC,iBAAiB;IASzB,IAAW,GAAG,IAAK,QAAQ,CAAC,YAAY,CAAC,CAGxC;IAEM,GAAG,CAAC,CAAC,SAAS,gBAAgB,CAAC,YAAY,CAAC,EAAE,IAAI,EAAG,CAAC,GAAI,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC;IAgBpF,kBAAkB,IAAK,QAAQ,CAAC,YAAY,CAAC;IAK7C,GAAG,CAAC,CAAC,SAAS,gBAAgB,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,GAAG,IAAI;IAuB/F,WAAW,CAAC,CAAC,SAAS,MAAM,kBAAkB,EAAE,CAAC,SAAS,gBAAgB,CAAC,kBAAkB,CAAC,EACjG,KAAK,EAAG,MAAM,EACd,GAAG,EAAG,CAAC,EACP,KAAK,EAAG,SAAS,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAiB/B,sBAAsB,CAAC,UAAU,EAAG,iCAAiC;CAoDrF;AAED,eAAO,MAAM,MAAM,oBAAmC,CAAC"}

package/dist/service/Isolate.service.d.ts

@@ -0,0 +1,12 @@
+export declare class IsolateInstance {
+    private MAX_ISOLATE_LIFESPAN_MS;
+    constructor(MAX_ISOLATE_LIFESPAN_MS: number);
+    isSameIsolate(id: string): boolean;
+    get id(): string;
+    get remainingTime(): number;
+    get uptime(): number;
+    get maxTime(): number;
+    set<T = unknown>(key: string, value: T): void;
+    get<T = unknown>(key: string): T | undefined;
+}
+//# sourceMappingURL=Isolate.service.d.ts.map

package/dist/service/Isolate.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Isolate.service.d.ts","sourceRoot":"","sources":["../../src/service/Isolate.service.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAe;IACZ,OAAO,CAAC,uBAAuB;gBAAvB,uBAAuB,EAAG,MAAM;IAM7C,aAAa,CAAC,EAAE,EAAG,MAAM,GAAI,OAAO;IAI3C,IAAI,EAAE,IAAM,MAAM,CAEjB;IAED,IAAI,aAAa,IAAK,MAAM,CAU3B;IAED,IAAI,MAAM,IAAK,MAAM,CAGpB;IAED,IAAI,OAAO,IAAK,MAAM,CAErB;IAED,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAI,IAAI;IAI9C,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAI,CAAC,GAAG,SAAS;CAGhD"}

package/dist/service/Pulsar.service.d.ts

@@ -0,0 +1,41 @@
+import { PulsarCore } from "./PulsarBaseService.d.ts";
+import type { ConfigForRuntime, PulsarRuntimeType } from "../types/runtime.types.d.ts";
+export type SpawnerAlgorithm = "ROUND_ROBIN" | "LEAST_CONNECTIONS" | "CBS";
+/**
+ * Main orchestrator engine for Pulsar responsible for managing queue execution loops,
+ * dynamic scheduling, non-blocking worker dispatching, telemetry collection,
+*/
+export declare class Pulsar<R extends PulsarRuntimeType = PulsarRuntimeType> extends PulsarCore {
+    private baseConfig;
+    private isolateId;
+    private currentExecutionId;
+    private lockKey;
+    private shutdownPromise;
+    private eventCleanUps;
+    private activeQueues;
+    constructor(baseConfig: ConfigForRuntime<R> & {
+        runtime: R;
+    });
+    start(): Promise<void>;
+    triggerQueue(queue: string): Promise<void>;
+    validateConfiguration(): Promise<{
+        status: number;
+        message: string;
+    }>;
+    private configureQueueProfiles;
+    private runTick;
+    shutdown(): Promise<void>;
+    private doShutdown;
+    scheduleRestart(queue: string): Promise<void>;
+    restartForSameIsolate(headers: Record<string, string>): Promise<void>;
+    private get executionContext();
+    setCurrentExecutionId(id: string): void;
+    private generateCurrentExecutionIdFromConfig;
+    private registerEvents;
+    private removeRegisteredEvents;
+    awaitPendingShutdown(): Promise<void>;
+    deleteScheduledRestart(queue: string | '__GLOBAL__'): Promise<void>;
+    acquireExecutionLock(lockKey: string, ownerId: string, ttlMs: number): Promise<boolean>;
+    releaseExecutionLock(lockKey: string, ownerId: string): Promise<boolean>;
+}
+//# sourceMappingURL=Pulsar.service.d.ts.map

package/dist/service/Pulsar.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pulsar.service.d.ts","sourceRoot":"","sources":["../../src/service/Pulsar.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAMrF,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,mBAAmB,GAAG,KAAK,CAAC;AAE3E;;;EAGE;AACF,qBAAa,MAAM,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,CAAE,SAAQ,UAAU;IActE,OAAO,CAAC,UAAU;IAZ/B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,kBAAkB,CAAU;IACpC,OAAO,CAAC,OAAO,CAAU;IAIzB,OAAO,CAAC,eAAe,CAA+B;IAEtD,OAAO,CAAC,aAAa,CAA0B;IAE/C,OAAO,CAAC,YAAY,CAAiC;gBAEhC,UAAU,EAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,EAAG,CAAC,CAAA;KAAE;IAoB1D,KAAK;IASL,YAAY,CAAC,KAAK,EAAG,MAAM;IAW3B,qBAAqB;;;;IAKlC,OAAO,CAAC,sBAAsB;YAOhB,OAAO;IAKR,QAAQ;YAKP,UAAU;IAwBX,eAAe,CAAC,KAAK,EAAG,MAAM;IAmB9B,qBAAqB,CAAC,OAAO,EAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAkBnE,OAAO,KAAK,gBAAgB,GAU3B;IAEM,qBAAqB,CAAC,EAAE,EAAG,MAAM;IAIxC,OAAO,CAAC,oCAAoC;IAK5C,OAAO,CAAC,cAAc;IA6CtB,OAAO,CAAC,sBAAsB;IAKjB,oBAAoB;IAKpB,sBAAsB,CAAC,KAAK,EAAG,MAAM,GAAG,YAAY;IAIpD,oBAAoB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM;IAIvE,oBAAoB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,MAAM;CAGvE"}

package/dist/service/PulsarBaseService.d.ts

@@ -0,0 +1,49 @@
+import { PulsarUnifiedStorage } from '../storage/PulsarStorage.d.ts';
+import { PulsarEventBus } from './PulsarEventBus.d.ts';
+import { PulsarClock } from '../subsys/PulsarClock.d.ts';
+import { QueueService } from '../modules/Queue.module.d.ts';
+import { SwarmManager } from './SwarmBudgetTracker.d.ts';
+import { Scheduler } from "../modules/Scheduler.module.d.ts";
+import { TickService } from '../modules/Tick.module.d.ts';
+import { TickController } from '../modules/TickController.module.d.ts';
+import { PulsarRuntime } from '../types/runtime.types.d.ts';
+import type { EngineQueuesConfig } from '../types/queue.types.d.ts';
+import type { EngineConsumerConfig } from '../types/consumer.types.d.ts';
+import type { IsolateInstance } from './Isolate.service.d.ts';
+import type { EngineConfig } from '../types/base.types.d.ts';
+import type { IIntegration, IntegrationConstructor, IntegrationMap } from '../types/integrations.types.d.ts';
+import type { PulsarRuntimeCore } from '../shared/PulsarRuntimeCore.d.ts';
+import { UnifiedTransportManager } from '../network/UnifiedTransportManager.d.ts';
+import { LoggerService } from '../subsys/LoggerService.d.ts';
+/**
+ * Core abstract base class for the Pulsar engine ecosystem.
+ *
+ * Provides foundational lifecycle management, centralized event emitting, unified storage
+ * initialization, queue registration
+*/
+export declare abstract class PulsarCore {
+    protected storage: PulsarUnifiedStorage;
+    protected tickService: TickService;
+    protected tickController: TickController;
+    protected unifiedTransportManager: UnifiedTransportManager;
+    protected swarmManager: SwarmManager;
+    protected scheduler: Scheduler;
+    protected queueService: QueueService;
+    protected clock: PulsarClock;
+    protected events: PulsarEventBus;
+    protected queues: EngineQueuesConfig[];
+    protected consumers: EngineConsumerConfig[];
+    protected runtimeStrategy: PulsarRuntimeCore;
+    readonly logger: LoggerService;
+    private readonly integrations;
+    constructor(baseConfig: EngineConfig);
+    private resolveRuntimeStrategy;
+    protected runIntegrations(integrations: Array<IntegrationConstructor | IIntegration>): Promise<void>;
+    getIntegration<K extends keyof IntegrationMap>(moduleOrClass: K): IntegrationMap[K];
+    getIntegration<T extends IIntegration>(moduleOrClass: new (...args: any[]) => T): T;
+    get runtime(): keyof typeof PulsarRuntime;
+    get isV8Isolate(): boolean;
+    get V8Isolate(): IsolateInstance;
+    protected exit(): Promise<void>;
+}
+//# sourceMappingURL=PulsarBaseService.d.ts.map

package/dist/service/PulsarBaseService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PulsarBaseService.d.ts","sourceRoot":"","sources":["../../src/service/PulsarBaseService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAC3G,OAAO,KAAK,EAAE,iBAAiB,EAAuB,MAAM,gCAAgC,CAAC;AAG7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D;;;;;EAKE;AACF,8BAAsB,UAAU;IAC5B,SAAS,CAAC,OAAO,EAAG,oBAAoB,CAAC;IAEzC,SAAS,CAAC,WAAW,EAAG,WAAW,CAAC;IACpC,SAAS,CAAC,cAAc,EAAE,cAAc,CAAC;IAEzC,SAAS,CAAC,uBAAuB,EAAG,uBAAuB,CAAC;IAC5D,SAAS,CAAC,YAAY,EAAG,YAAY,CAAC;IACtC,SAAS,CAAC,SAAS,EAAG,SAAS,CAAC;IAChC,SAAS,CAAC,YAAY,EAAG,YAAY,CAAC;IAEtC,SAAS,CAAC,KAAK,EAAG,WAAW,CAAC;IAC9B,SAAS,CAAC,MAAM,EAAG,cAAc,CAAC;IAElC,SAAS,CAAC,MAAM,EAAG,kBAAkB,EAAE,CAAM;IAC7C,SAAS,CAAC,SAAS,EAAG,oBAAoB,EAAE,CAAM;IAElD,SAAS,CAAC,eAAe,EAAE,iBAAiB,CAAC;IAE7C,SAAgB,MAAM,EAAG,aAAa,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;gBAEnD,UAAU,EAAG,YAAY;IAwGtC,OAAO,CAAC,sBAAsB;cAuBd,eAAe,CAAC,YAAY,EAAG,KAAK,CAAC,sBAAsB,GAAG,YAAY,CAAC;IAiBpF,cAAc,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,aAAa,EAAG,CAAC,GAAI,cAAc,CAAC,CAAC,CAAC;IACrF,cAAc,CAAC,CAAC,SAAS,YAAY,EAAE,aAAa,EAAG,KAAK,GAAG,IAAI,EAAG,GAAG,EAAE,KAAK,CAAC,GAAI,CAAC;IAiB7F,IAAI,OAAO,IAAK,MAAM,OAAO,aAAa,CAEzC;IAED,IAAI,WAAW,YAEd;IAED,IAAI,SAAS,IAAK,eAAe,CAEhC;cAEe,IAAI;CAGvB"}

package/dist/service/PulsarEventBus.d.ts

@@ -0,0 +1,36 @@
+import type { EngineQueuesConfig } from "../types/queue.types";
+type PulsarEventMap = {
+    "tick:time-exceeded": {
+        queue: string;
+        elapsedMs: number;
+    };
+    "tick:cycle-completed": {
+        queue: string;
+        cycles: number;
+    };
+    "tick:force-run": {
+        queue: EngineQueuesConfig;
+        reason?: string;
+    };
+    "tick:end": {
+        queue: string;
+        reason?: string;
+    };
+    "engine:shutdown-requested": {
+        reason: string;
+    };
+    "engine:health-check-requested": {
+        timestamp: number;
+    };
+};
+export declare class PulsarEventBus {
+    private target;
+    private pending;
+    private track;
+    emit<K extends keyof PulsarEventMap>(event: K, payload: PulsarEventMap[K]): void;
+    on<K extends keyof PulsarEventMap>(event: K, handler: (payload: PulsarEventMap[K]) => Promise<void> | void): () => void;
+    once<K extends keyof PulsarEventMap>(event: K, handler: (payload: PulsarEventMap[K]) => Promise<void> | void): void;
+    drain(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=PulsarEventBus.d.ts.map

package/dist/service/PulsarEventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PulsarEventBus.d.ts","sourceRoot":"","sources":["../../src/service/PulsarEventBus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,KAAK,cAAc,GAAG;IAClB,oBAAoB,EAAG;QAAE,KAAK,EAAG,MAAM,CAAC;QAAC,SAAS,EAAG,MAAM,CAAA;KAAE,CAAC;IAC9D,sBAAsB,EAAG;QAAE,KAAK,EAAG,MAAM,CAAC;QAAC,MAAM,EAAG,MAAM,CAAA;KAAE,CAAC;IAC7D,gBAAgB,EAAG;QAAE,KAAK,EAAG,kBAAkB,CAAC;QAAC,MAAM,CAAC,EAAG,MAAM,CAAA;KAAE,CAAC;IACpE,UAAU,EAAG;QAAE,KAAK,EAAG,MAAM,CAAC;QAAC,MAAM,CAAC,EAAG,MAAM,CAAA;KAAE,CAAC;IAClD,2BAA2B,EAAG;QAAE,MAAM,EAAG,MAAM,CAAA;KAAE,CAAC;IAClD,+BAA+B,EAAG;QAAE,SAAS,EAAG,MAAM,CAAA;KAAE,CAAC;CAC5D,CAAA;AAED,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAA+B;IAG9C,OAAO,CAAC,KAAK;IAQN,IAAI,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,KAAK,EAAG,CAAC,EAAE,OAAO,EAAG,cAAc,CAAC,CAAC,CAAC,GAAI,IAAI;IAInF,EAAE,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,KAAK,EAAG,CAAC,EAAE,OAAO,EAAG,CAAC,OAAO,EAAG,cAAc,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAI,MAAM,IAAI;IAU3H,IAAI,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,KAAK,EAAG,CAAC,EAAE,OAAO,EAAE,CAAC,OAAO,EAAG,cAAc,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAI,IAAI;IAKhH,KAAK;CAKrB"}

package/dist/service/SwarmBudgetTracker.d.ts

@@ -0,0 +1,14 @@
+export declare class SwarmManager {
+    private maxGlobalJobsPerTick;
+    private maxGlobalConcurrency;
+    constructor(maxGlobalJobsPerTick: number, maxGlobalConcurrency: number);
+    /**
+     * Getter for configured maximum global worker concurrency.
+     */
+    getMaxGlobalConcurrency(): number;
+    /**
+     * Getter for configured maximum global jobs per 1s tick window.
+     */
+    getMaxGlobalJobsPerTick(): number;
+}
+//# sourceMappingURL=SwarmBudgetTracker.d.ts.map

package/dist/service/SwarmBudgetTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwarmBudgetTracker.d.ts","sourceRoot":"","sources":["../../src/service/SwarmBudgetTracker.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;IAEjB,OAAO,CAAC,oBAAoB;IAC5B,OAAO,CAAC,oBAAoB;gBADpB,oBAAoB,EAAE,MAAM,EAC5B,oBAAoB,EAAE,MAAM;IAGxC;;OAEG;IACI,uBAAuB,IAAI,MAAM;IAIxC;;OAEG;IACI,uBAAuB,IAAI,MAAM;CAG3C"}

package/dist/service/consumers/PulsarWorker.d.ts

@@ -0,0 +1,10 @@
+export interface ParsedRequest {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    query: Record<string, string>;
+    body: any;
+    rawBody: string | null;
+}
+export declare function parseAnyPayload(rawInput: any): Promise<ParsedRequest>;
+//# sourceMappingURL=PulsarWorker.d.ts.map

package/dist/service/consumers/PulsarWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PulsarWorker.d.ts","sourceRoot":"","sources":["../../../src/service/consumers/PulsarWorker.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAwID,wBAAsB,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,CAsH3E"}

package/dist/shared/PulsarRuntimeCore.d.ts

@@ -0,0 +1,55 @@
+import type { QueueService } from "../modules/Queue.module.d.ts";
+import type { PulsarClock } from "../subsys/PulsarClock.d.ts";
+import type { IPulsarRuntime, IRuntimeExecutionContext } from "../runtimes/runtimeTypes.d.ts";
+import type { EngineQueuesConfig } from "../types/queue.types.d.ts";
+import type { IsolateInstance } from "../service/Isolate.service.d.ts";
+import type { PulsarUnifiedStorage } from "../storage/PulsarStorage.d.ts";
+import type { PulsarEventBus } from "../service/PulsarEventBus.d.ts";
+import type { Scheduler } from "../modules/Scheduler.module.d.ts";
+import { type ILogger } from "../subsys/LoggerService.d.ts";
+export interface RuntimeDependencies {
+    queueService: QueueService;
+    clock: PulsarClock;
+    storage: PulsarUnifiedStorage;
+    queues: EngineQueuesConfig[];
+    events: PulsarEventBus;
+    isolate: IsolateInstance;
+    scheduler: Scheduler;
+}
+interface ISelfInvocationState {
+    idpInvoked: boolean;
+    continuationScheduledForCurrentLock: boolean;
+}
+interface ExecuteSelfInvocation {
+    queue: string;
+    pooler: string;
+    delaySec: number;
+    continuationOwnerId: string;
+    isIdpLock: boolean;
+    isEdpLock: boolean;
+    targetEdpQueue: string | null;
+}
+export declare abstract class PulsarRuntimeCore implements IPulsarRuntime {
+    abstract readonly type: "PERSISTENT" | "SERVERLESS_VM" | "V8_ISOLATE";
+    abstract readonly shouldShutdownOnCycleComplete: boolean;
+    /** Minimum runtime required to make booting up the engine worth it (in seconds) */
+    abstract readonly minBootRequirementSec: number;
+    protected queueService: QueueService;
+    protected clock: PulsarClock;
+    protected queues: EngineQueuesConfig[];
+    protected storage: PulsarUnifiedStorage;
+    protected isolate: IsolateInstance;
+    protected events: PulsarEventBus;
+    protected scheduler: Scheduler;
+    protected logger: ILogger;
+    constructor(deps: RuntimeDependencies);
+    abstract onStart(ctx: IRuntimeExecutionContext): Promise<void>;
+    abstract handleCycleCompletion(ctx: IRuntimeExecutionContext): Promise<boolean>;
+    abstract handleRestart(ctx: IRuntimeExecutionContext): Promise<void>;
+    abstract executeTick(queueConfig: EngineQueuesConfig, tickRunner: () => Promise<void>): Promise<void>;
+    abstract scheduleTick(queueConfig: EngineQueuesConfig, tickRunner: () => Promise<void>): Promise<void>;
+    protected executeQueuesTick(runTick: IRuntimeExecutionContext["runTick"]): Promise<void>;
+    protected triggerSelfInvocation(args: ExecuteSelfInvocation): Promise<ISelfInvocationState>;
+}
+export {};
+//# sourceMappingURL=PulsarRuntimeCore.d.ts.map

package/dist/shared/PulsarRuntimeCore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PulsarRuntimeCore.d.ts","sourceRoot":"","sources":["../../src/shared/PulsarRuntimeCore.ts"],"names":[],"mappings":"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"}

package/dist/static/TimingProfile.d.ts

@@ -0,0 +1,9 @@
+export type TimingProfileType = 'REALTIME' | 'STANDARD' | 'RELAXED' | 'ULTRA_EFFICIENT' | 'BALANCED' | 'CUSTOM';
+export interface TimingProfile {
+    activePollMs: number;
+    backoffPollMs: number;
+    idlePollMs?: number;
+    maxTimerMs: number;
+}
+export declare const TIMING_PROFILES: Record<Exclude<TimingProfileType, 'CUSTOM'>, TimingProfile>;
+//# sourceMappingURL=TimingProfile.d.ts.map

package/dist/static/TimingProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimingProfile.d.ts","sourceRoot":"","sources":["../../src/static/TimingProfile.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,iBAAiB,GAAG,UAAU,GAAI,QAAQ,CAAC;AAEjH,MAAM,WAAW,aAAa;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,QAAQ,CAAC,EAAE,aAAa,CAoCvF,CAAA"}

package/dist/static/static.d.ts

@@ -0,0 +1,3 @@
+export type QUEUE = "q_1" | "q_2" | "q_3" | "q_4" | "q_5";
+export declare const WORKER_TTL_MS: number;
+//# sourceMappingURL=static.d.ts.map

package/dist/static/static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.d.ts","sourceRoot":"","sources":["../../src/static/static.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAG1D,eAAO,MAAM,aAAa,QAAY,CAAC"}

package/dist/storage/PulsarStorage.d.ts

@@ -0,0 +1,42 @@
+import type { PostgresDriver } from "./drivers/PostgresDriver.d.ts";
+import type { RedisDriver } from "./drivers/RedisDriver.d.ts";
+import type { IQueueRepository } from "./repositories/QueueRepository.d.ts";
+import { PostgresEngineOperationRepository } from "./repositories/PostgresEngineOperationRepository.d.ts";
+export type StorageStrategy = "AUTO" | "REDIS_CACHE" | "PG_UNLOGGED";
+export interface PulsarStorageOptions {
+    cache?: RedisDriver;
+    db: PostgresDriver;
+    /**
+     * Storage Pooling Strategies:
+     * - "AUTO"         : Uses Redis if `cache` is defined; otherwise falls back to PG_UNLOGGED.
+     * - "REDIS_CACHE"  : Forces in-memory Redis buffers for maximum speed (Requires Redis).
+     * - "PG_UNLOGGED"  : Uses Postgres Unlogged tables for fast volatile queueing (No Redis needed).
+     */
+    strategy?: StorageStrategy;
+    syncIntervalMs?: number;
+}
+/**
+ * Unified storage orchestrator for Pulsar queueing mechanics.
+ *
+ * Manages the initialization, strategy resolution, and connection lifecycles of underlying
+ * storage drivers (Postgres and optional Redis). Depending on the selected `StorageStrategy`,
+ * it dynamically delegates queue operations to a high-throughput Redis memory store or
+ * an optimized PostgreSQL repository (such as unlogged tables) while guaranteeing core
+ * database mechanics for engine orchestration.
+ */
+export declare class PulsarUnifiedStorage {
+    readonly repository: IQueueRepository;
+    readonly cache?: RedisDriver;
+    readonly db: PostgresDriver;
+    readonly ops: PostgresEngineOperationRepository;
+    private readonly logger;
+    readonly strategy: StorageStrategy;
+    readonly syncIntervalMs: number;
+    private isConnected;
+    constructor(options: PulsarStorageOptions);
+    bindInstanceId(instanceId: string): void;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<Record<string, any>>;
+}
+//# sourceMappingURL=PulsarStorage.d.ts.map

package/dist/storage/PulsarStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PulsarStorage.d.ts","sourceRoot":"","sources":["../../src/storage/PulsarStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAK1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,qDAAqD,CAAC;AAGxG,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,aAAa,GAAG,aAAa,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACjC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,EAAE,EAAE,cAAc,CAAC;IACnB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,qBAAa,oBAAoB;IAC7B,SAAgB,UAAU,EAAG,gBAAgB,CAAC;IAE9C,SAAgB,KAAK,CAAC,EAAG,WAAW,CAAC;IACrC,SAAgB,EAAE,EAAG,cAAc,CAAC;IACpC,SAAgB,GAAG,EAAG,iCAAiC,CAAC;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAElC,SAAgB,QAAQ,EAAG,eAAe,CAAC;IAC3C,SAAgB,cAAc,EAAG,MAAM,CAAC;IACxC,OAAO,CAAC,WAAW,CAAmB;gBAE1B,OAAO,EAAG,oBAAoB;IAqCnC,cAAc,CAAC,UAAU,EAAE,MAAM;IAS3B,OAAO;IAYP,UAAU;IAUV,WAAW;CAK3B"}

package/dist/storage/drivers/PostgresDriver.d.ts

@@ -0,0 +1,20 @@
+import postgres from "postgres";
+import type { IPulsarDriver, PostgresDriverOptions, StorageHealth } from "./types.d.ts";
+export declare class PostgresDriver implements IPulsarDriver {
+    readonly options: PostgresDriverOptions;
+    readonly type = "database";
+    readonly name = "PostgresDriver";
+    private sql;
+    private isConnected;
+    prefix?: string;
+    private readonly logger;
+    constructor(options: PostgresDriverOptions);
+    private initClient;
+    setKeyPrefix(instanceId: string): void;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<StorageHealth>;
+    getNativeClient<T = postgres.Sql>(): T;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=PostgresDriver.d.ts.map

package/dist/storage/drivers/PostgresDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresDriver.d.ts","sourceRoot":"","sources":["../../../src/storage/drivers/PostgresDriver.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAGhC,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGtF,qBAAa,cAAe,YAAW,aAAa;aASpB,OAAO,EAAE,qBAAqB;IAR1D,SAAgB,IAAI,cAAc;IAClC,SAAgB,IAAI,oBAAoB;IACxC,OAAO,CAAC,GAAG,CAAgB;IAC3B,OAAO,CAAC,WAAW,CAAS;IAErB,MAAM,CAAC,EAAG,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;gBAEN,OAAO,EAAE,qBAAqB;IAI1D,OAAO,CAAC,UAAU;IAMX,YAAY,CAAC,UAAU,EAAG,MAAM;IAI1B,OAAO;IAeP,UAAU;IAQV,WAAW,IAAK,OAAO,CAAC,aAAa,CAAC;IAY5C,eAAe,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,KAAM,CAAC;IAKxC,KAAK;CAGd"}

package/dist/storage/drivers/RedisDriver.d.ts

@@ -0,0 +1,20 @@
+import { Redis as RedisTCP } from "ioredis";
+import { Redis as RedisHTTP } from "@upstash/redis";
+import type { IPulsarDriver, RedisDriverOptions, StorageHealth } from "./types.d.ts";
+export declare class RedisDriver implements IPulsarDriver {
+    readonly options: RedisDriverOptions;
+    readonly type = "cache";
+    readonly name = "RedisDriver";
+    private tcpClient?;
+    private httpClient?;
+    prefix?: string;
+    private readonly logger;
+    constructor(options: RedisDriverOptions);
+    private initClients;
+    setKeyPrefix(instanceId: string): void;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<StorageHealth>;
+    getNativeClient<T = RedisTCP | RedisHTTP>(protocol?: "tcp" | "http"): T;
+}
+//# sourceMappingURL=RedisDriver.d.ts.map

package/dist/storage/drivers/RedisDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisDriver.d.ts","sourceRoot":"","sources":["../../../src/storage/drivers/RedisDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAInF,qBAAa,WAAY,YAAW,aAAa;aAUjB,OAAO,EAAG,kBAAkB;IATxD,SAAgB,IAAI,WAAW;IAC/B,SAAgB,IAAI,iBAAiB;IAErC,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,OAAO,CAAC,UAAU,CAAC,CAAY;IAExB,MAAM,CAAC,EAAG,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;gBAEN,OAAO,EAAG,kBAAkB;IAIxD,OAAO,CAAC,WAAW;IAeZ,YAAY,CAAC,UAAU,EAAG,MAAM;IAI1B,OAAO;IAkCP,UAAU;IAeV,WAAW,IAAK,OAAO,CAAC,aAAa,CAAC;IAgB5C,eAAe,CAAC,CAAC,GAAG,QAAQ,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM;CAW7E"}