@nightx.co/pulsar 0.0.0-stage → 1.0.15

package/dist/storage/repositories/PostgresEngineOperationRepository.d.ts

@@ -0,0 +1,39 @@
+import { PostgresDriver } from "../drivers/PostgresDriver.d.ts";
+import type { EngineQueuesConfig } from "../../types/queue.types.d.ts";
+import type { IConfigurationObject, IConfigSyncResult } from "../../types/config.types.d.ts";
+export interface IPulsarPostgresEngineOperationRepository {
+    addRestart(queues: EngineQueuesConfig[]): Promise<void>;
+    deleteRestart(queue: string): Promise<void>;
+    checkFencingTokenValidity(queue: string, token: string | number): Promise<boolean>;
+    verifyAndSyncConfiguration(host: string, instanceId: string, url: string, configurations: IConfigurationObject): Promise<IConfigSyncResult>;
+    subscribeToDatabaseEvents<T extends unknown>(channel: string, onEvent: (event: T) => Promise<void>, onListen?: () => void): Promise<void>;
+    getPollingQueueEntries(queueName: string, limit: number): Promise<Array<IPoolQueueEntry>>;
+    deletePollingQueueEntry(id: number): Promise<void>;
+}
+export interface IPoolQueueEntry {
+    id: number;
+    queue: string;
+    payload: {
+        queue_name: string;
+        fencing_token: number;
+        execution_at: string;
+    };
+    created_at: string;
+}
+export declare class PostgresEngineOperationRepository implements IPulsarPostgresEngineOperationRepository {
+    private driver;
+    private readonly logger;
+    constructor(driver: PostgresDriver);
+    private get sql();
+    addRestart(queues: EngineQueuesConfig[]): Promise<void>;
+    updateRestartOwnership(queue: string | null | undefined, owner: string): Promise<void>;
+    deleteRestart(queue: string | '__GLOBAL__'): Promise<void>;
+    pingHealthCheck(): Promise<void>;
+    checkFencingTokenValidity(queue: string, token: string | number): Promise<boolean>;
+    verifyAndSyncConfiguration(host: 'PULSAR_STANDALONE' | 'NEBULA_CLUSTER', instanceId: string, url: string, configurations: IConfigurationObject): Promise<IConfigSyncResult>;
+    private synchronizeQueueTriggers;
+    subscribeToDatabaseEvents<T extends unknown>(channel: string, onEvent: (event: T) => Promise<void>, onListen?: () => void): Promise<void>;
+    getPollingQueueEntries(queueName: string, limit?: number): Promise<Array<IPoolQueueEntry>>;
+    deletePollingQueueEntry(id: number): Promise<void>;
+}
+//# sourceMappingURL=PostgresEngineOperationRepository.d.ts.map

package/dist/storage/repositories/PostgresEngineOperationRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresEngineOperationRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/PostgresEngineOperationRepository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAM9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAG3F,MAAM,WAAW,wCAAwC;IACrD,UAAU,CAAC,MAAM,EAAG,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,yBAAyB,CAAC,KAAK,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAG,MAAM,GAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACtF,0BAA0B,CAAC,IAAI,EAAG,MAAM,EAAE,UAAU,EAAG,MAAM,EAAE,GAAG,EAAG,MAAM,EAAE,cAAc,EAAG,oBAAoB,GAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACjJ,yBAAyB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,CAAC,KAAK,EAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9I,sBAAsB,CAAC,SAAS,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAI,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;IAC7F,uBAAuB,CAAC,EAAE,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAG,MAAM,CAAC;IACZ,KAAK,EAAG,MAAM,CAAC;IACf,OAAO,EAAG;QACN,UAAU,EAAG,MAAM,CAAC;QACpB,aAAa,EAAG,MAAM,CAAC;QACvB,YAAY,EAAG,MAAM,CAAC;KACzB,CAAC;IACF,UAAU,EAAG,MAAM,CAAC;CACvB;AAED,qBAAa,iCAAkC,YAAW,wCAAwC;IAGlF,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;gBAEd,MAAM,EAAG,cAAc;IAI3C,OAAO,KAAK,GAAG,GAEd;IAEK,UAAU,CAAC,MAAM,EAAG,kBAAkB,EAAE;IAiCxC,sBAAsB,CAAC,KAAK,EAAG,MAAM,GAAG,IAAI,YAAO,EAAE,KAAK,EAAG,MAAM;IAYnE,aAAa,CAAC,KAAK,EAAG,MAAM,GAAG,YAAY;IAO3C,eAAe;IAUf,yBAAyB,CAAC,KAAK,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAG,MAAM;IAmBjE,0BAA0B,CAAE,IAAI,EAAG,mBAAmB,GAAG,gBAAgB,EAAE,UAAU,EAAG,MAAM,EAAE,GAAG,EAAG,MAAM,EAAE,cAAc,EAAG,oBAAoB,GAAI,OAAO,CAAC,iBAAiB,CAAC;YAkDzK,wBAAwB;IAgDhC,yBAAyB,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,CAAC,KAAK,EAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI;IAY5H,sBAAsB,CAAC,SAAS,EAAG,MAAM,EAAE,KAAK,GAAG,MAAW,GAAI,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAajG,uBAAuB,CAAC,EAAE,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;CAM7D"}

package/dist/storage/repositories/PostgresQueueRepository.d.ts

@@ -0,0 +1,26 @@
+import type { PostgresDriver } from "../drivers/PostgresDriver.d.ts";
+import type { IBatchCandidate } from "../../modules/Tick.module.d.ts";
+import { BaseQueueRepository } from "./QueueRepository.d.ts";
+export declare class PostgresQueueRepository extends BaseQueueRepository {
+    private readonly driver;
+    constructor(driver: PostgresDriver);
+    private get sql();
+    private get prefix();
+    registerWorker(queue: string, candidateBatches: IBatchCandidate[], concurrency: number, globalMaxConcurrency?: number): Promise<string[]>;
+    deregisterWorker(workerId: string, queue: string): Promise<void>;
+    getActiveWorkersCount(queue: string): Promise<number>;
+    setFutureSchedule(queue: string, scheduleAt: string): Promise<void>;
+    getGlobalActiveWorkersCount(): Promise<number>;
+    refundGlobalJobBudget(amount: number, window: string): Promise<void>;
+    private budgetKeyPrefix;
+    claimGlobalJobBudget(requested: number, maxGlobalJobsPerTick: number): Promise<{
+        granted: number;
+        window: string;
+    }>;
+    acquireQueueLock(lockKey: string, ownerId: string, ttlMs: number): Promise<boolean>;
+    releaseQueueLock(lockKey: string, ownerId: string): Promise<boolean>;
+    evaluateDeadRun(queueName: string, poolerType: "interval-driven-pooler" | "event-driven-pooler", totalJobs: number, continuationOwnerId: string, dispatchTtlMs?: number, idpLockKey?: string, edpLockPrefix?: string): Promise<boolean>;
+    clearDispatchPending(lockKey: string): Promise<void>;
+    getStopSignal(): Promise<boolean>;
+}
+//# sourceMappingURL=PostgresQueueRepository.d.ts.map

package/dist/storage/repositories/PostgresQueueRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresQueueRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/PostgresQueueRepository.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAM3D,qBAAa,uBAAwB,SAAQ,mBAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAG,cAAc;IAKpD,OAAO,KAAK,GAAG,GAEd;IAED,OAAO,KAAK,MAAM,GAKjB;IAEc,cAAc,CAAE,KAAK,EAAG,MAAM,EAAE,gBAAgB,EAAG,eAAe,EAAE,EAAE,WAAW,EAAG,MAAM,EAAE,oBAAoB,GAAG,MAAiB;IAyBpI,gBAAgB,CAAC,QAAQ,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM;IAclD,qBAAqB,CAAC,KAAK,EAAG,MAAM;IAYpC,iBAAiB,CAAC,KAAK,EAAG,MAAM,EAAE,UAAU,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;IAWtE,2BAA2B;IAY3B,qBAAqB,CAAC,MAAM,EAAG,MAAM,EAAE,MAAM,EAAG,MAAM;IAYrE,OAAO,CAAC,eAAe;IAIR,oBAAoB,CAAC,SAAS,EAAG,MAAM,EAAE,oBAAoB,EAAG,MAAM;;;;IAgDtE,gBAAgB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBtF,gBAAgB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAetE,eAAe,CAC1B,SAAS,EAAG,MAAM,EAClB,UAAU,EAAG,wBAAwB,GAAG,qBAAqB,EAC7D,SAAS,EAAG,MAAM,EAClB,mBAAmB,EAAG,MAAM,EAC5B,aAAa,GAAG,MAAc,EAC9B,UAAU,GAAG,MAAmB,EAChC,aAAa,GAAG,MAAoB,GACpC,OAAO,CAAC,OAAO,CAAC;IAuDL,oBAAoB,CAAC,OAAO,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;IAStD,aAAa,IAAK,OAAO,CAAC,OAAO,CAAC;CAGpD"}

package/dist/storage/repositories/QueueRepository.d.ts

@@ -0,0 +1,20 @@
+import type { IBatchCandidate } from "../../modules/Tick.module";
+export declare abstract class BaseQueueRepository {
+    abstract getActiveWorkersCount(queue: string): Promise<number>;
+    abstract getGlobalActiveWorkersCount(): Promise<number>;
+    abstract registerWorker(queue: string, candidateBatches: IBatchCandidate[], concurrency: number, globalMaxConcurrency: number): Promise<string[]>;
+    abstract deregisterWorker(workerId: string, queue: string): Promise<void>;
+    abstract claimGlobalJobBudget(requested: number, maxGlobalJobsPerTick: number): Promise<{
+        granted: number;
+        window: string;
+    }>;
+    abstract refundGlobalJobBudget(amount: number, window: string): Promise<void>;
+    abstract acquireQueueLock(lockKey: string, ownerId: string, ttlMs: number): Promise<boolean>;
+    abstract releaseQueueLock(lockKey: string, ownerId: string): Promise<boolean>;
+    abstract evaluateDeadRun(queueName: string, poolerType: "interval-driven-pooler" | "event-driven-pooler", totalJobs: number, continuationOwnerId: string, dispatchTtlMs: number, idpLockKey?: string, edpLockPrefix?: string): Promise<boolean>;
+    abstract clearDispatchPending(lockKey: string): Promise<void>;
+    abstract setFutureSchedule(queue: string, scheduleAt: string): Promise<void>;
+    abstract getStopSignal(queue: string): Promise<boolean>;
+}
+export type IQueueRepository = BaseQueueRepository;
+//# sourceMappingURL=QueueRepository.d.ts.map

package/dist/storage/repositories/QueueRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/QueueRepository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,8BAAsB,mBAAmB;aACrB,qBAAqB,CAAC,KAAK,EAAG,MAAM,GAAI,OAAO,CAAC,MAAM,CAAC;aACvD,2BAA2B,IAAM,OAAO,CAAC,MAAM,CAAC;aAEhD,cAAc,CAAC,KAAK,EAAG,MAAM,EAAE,gBAAgB,EAAG,eAAe,EAAE,EAAE,WAAW,EAAG,MAAM,EAAE,oBAAoB,EAAG,MAAM,GAAI,OAAO,CAAC,MAAM,EAAE,CAAC;aAC7I,gBAAgB,CAAC,QAAQ,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;aAEnE,oBAAoB,CAAC,SAAS,EAAG,MAAM,EAAE,oBAAoB,EAAG,MAAM,GAAI,OAAO,CAAC;QAAE,OAAO,EAAG,MAAM,CAAC;QAAC,MAAM,EAAG,MAAM,CAAA;KAAE,CAAC;aACxH,qBAAqB,CAAC,MAAM,EAAG,MAAM,EAAE,MAAM,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;aAEvE,gBAAgB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAI,OAAO,CAAC,OAAO,CAAC;aACvF,gBAAgB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,MAAM,GAAI,OAAO,CAAC,OAAO,CAAC;aAEvE,eAAe,CAC3B,SAAS,EAAG,MAAM,EAClB,UAAU,EAAG,wBAAwB,GAAG,qBAAqB,EAC7D,SAAS,EAAG,MAAM,EAClB,mBAAmB,EAAG,MAAM,EAC5B,aAAa,EAAG,MAAM,EACtB,UAAU,CAAC,EAAG,MAAM,EACpB,aAAa,CAAC,EAAG,MAAM,GACvB,OAAO,CAAC,OAAO,CAAC;aAEJ,oBAAoB,CAAC,OAAO,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;aAEtD,iBAAiB,CAAC,KAAK,EAAG,MAAM,EAAE,UAAU,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;aAEtE,aAAa,CAAC,KAAK,EAAG,MAAM,GAAI,OAAO,CAAC,OAAO,CAAC;CACnE;AAED,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC"}

package/dist/storage/repositories/RedisQueueRepository.d.ts

@@ -0,0 +1,28 @@
+import type { RedisDriver } from "../drivers/RedisDriver.d.ts";
+import type { IBatchCandidate } from "../../modules/Tick.module.d.ts";
+import { BaseQueueRepository } from "./QueueRepository.d.ts";
+export declare class RedisQueueRepository extends BaseQueueRepository {
+    private readonly driver;
+    private protocol;
+    constructor(driver: RedisDriver);
+    private get redis();
+    private get prefix();
+    registerWorker(queue: string, candidateBatches: IBatchCandidate[], concurrency: number, globalMaxConcurrency?: number): Promise<string[]>;
+    deregisterWorker(workerId: string, queue: string): Promise<void>;
+    getActiveWorkersCount(queue: string): Promise<number>;
+    getGlobalActiveWorkersCount(): Promise<number>;
+    setFutureSchedule(queue: string, scheduleAt: string): Promise<void>;
+    private budgetKeyPrefix;
+    claimGlobalJobBudget(requested: number, maxGlobalJobsPerTick: number): Promise<{
+        granted: number;
+        window: string;
+    }>;
+    refundGlobalJobBudget(amount: number, window: string): Promise<void>;
+    acquireQueueLock(lockKey: string, ownerId: string, ttlMs: number): Promise<boolean>;
+    releaseQueueLock(lockKey: string, ownerId: string): Promise<boolean>;
+    clearDispatchPending(lockKey: string): Promise<void>;
+    evaluateDeadRun(queueName: string, poolerType: "interval-driven-pooler" | "event-driven-pooler", totalJobs: number, continuationOwnerId: string, dispatchTtlMs?: number, idpLockKey?: string, edpLockPrefix?: string): Promise<boolean>;
+    private evalScript;
+    getStopSignal(queue: string): Promise<boolean>;
+}
+//# sourceMappingURL=RedisQueueRepository.d.ts.map

package/dist/storage/repositories/RedisQueueRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisQueueRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/RedisQueueRepository.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAWpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAK3D,qBAAa,oBAAqB,SAAQ,mBAAmB;IAG7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAkB;gBAEL,MAAM,EAAG,WAAW;IAMjD,OAAO,KAAK,KAAK,GAEhB;IAED,OAAO,KAAK,MAAM,GAKjB;IAEc,cAAc,CAAE,KAAK,EAAG,MAAM,EAAE,gBAAgB,EAAG,eAAe,EAAE,EAAE,WAAW,EAAG,MAAM,EAAE,oBAAoB,GAAG,MAAiB;IAoCpI,gBAAgB,CAAC,QAAQ,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM;IAalD,qBAAqB,CAAC,KAAK,EAAG,MAAM;IAMpC,2BAA2B;IAM3B,iBAAiB,CAAC,KAAK,EAAG,MAAM,EAAE,UAAU,EAAG,MAAM;IAKpE,OAAO,CAAC,eAAe;IAIR,oBAAoB,CAAC,SAAS,EAAG,MAAM,EAAE,oBAAoB,EAAG,MAAM;;;;IAetE,qBAAqB,CAAC,MAAM,EAAG,MAAM,EAAE,MAAM,EAAG,MAAM;IAOtD,gBAAgB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM,GAAI,OAAO,CAAC,OAAO,CAAC;IAKvF,gBAAgB,CAAC,OAAO,EAAG,MAAM,EAAE,OAAO,EAAG,MAAM,GAAI,OAAO,CAAC,OAAO,CAAC;IAKvE,oBAAoB,CAAC,OAAO,EAAG,MAAM,GAAI,OAAO,CAAC,IAAI,CAAC;IAKtD,eAAe,CAC1B,SAAS,EAAG,MAAM,EAClB,UAAU,EAAG,wBAAwB,GAAG,qBAAqB,EAC7D,SAAS,EAAG,MAAM,EAClB,mBAAmB,EAAG,MAAM,EAC5B,aAAa,GAAG,MAAc,EAC9B,UAAU,GAAG,MAAmB,EAChC,aAAa,GAAG,MAAoB,GACpC,OAAO,CAAC,OAAO,CAAC;YAiBN,UAAU;IAST,aAAa,CAAC,KAAK,EAAG,MAAM,GAAI,OAAO,CAAC,OAAO,CAAC;CAMlE"}

package/dist/subsys/DeferredTickEvaluator.d.ts

@@ -0,0 +1,23 @@
+import type { PulsarEventBus } from "../service/PulsarEventBus";
+import type { PulsarClock } from "./PulsarClock";
+import type { Scheduler } from "../modules/Scheduler.module";
+import type { ILogger } from "./LoggerService";
+import type { EngineQueuesConfig } from "@package/src/types/queue.types";
+export declare class DeferredTickEvaluator {
+    private minBootRequirementSec;
+    private scheduler;
+    private events;
+    private clock;
+    private logger;
+    constructor(minBootRequirementSec: number, scheduler: Scheduler, events: PulsarEventBus, clock: PulsarClock, logger: ILogger);
+    private timers;
+    private watchdogTimer;
+    private isShutdownTriggered;
+    evaluateUpcomingDelayedNext(upcomingTimeMs: number, queue: string): void;
+    private startDelayedSleepWatchdog;
+    private triggerGracefulShutdown;
+    stopRuntimeWatchdog(): void;
+    clearTimer(queue: string): void;
+    forceExecuteTickLater(queue: EngineQueuesConfig, targetTimestamp: number): void;
+}
+//# sourceMappingURL=DeferredTickEvaluator.d.ts.map

package/dist/subsys/DeferredTickEvaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeferredTickEvaluator.d.ts","sourceRoot":"","sources":["../../src/subsys/DeferredTickEvaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,qBAAa,qBAAqB;IAE1B,OAAO,CAAC,qBAAqB;IAC7B,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;gBAJN,qBAAqB,EAAG,MAAM,EAC9B,SAAS,EAAG,SAAS,EACrB,MAAM,EAAG,cAAc,EACvB,KAAK,EAAG,WAAW,EACnB,MAAM,EAAG,OAAO;IAG5B,OAAO,CAAC,MAAM,CAAoD;IAClE,OAAO,CAAC,aAAa,CAAgD;IACrE,OAAO,CAAC,mBAAmB,CAAS;IAE7B,2BAA2B,CAAC,cAAc,EAAG,MAAM,EAAE,KAAK,EAAG,MAAM;IAwB1E,OAAO,CAAC,yBAAyB;IAoBjC,OAAO,CAAC,uBAAuB;IAcxB,mBAAmB;IAOnB,UAAU,CAAC,KAAK,EAAG,MAAM;IASzB,qBAAqB,CAAC,KAAK,EAAG,kBAAkB,EAAE,eAAe,EAAG,MAAM;CAyBpF"}

package/dist/subsys/EventBus.d.ts

@@ -0,0 +1,13 @@
+type EventCallback<T = any> = (payload: T) => void;
+export type AppModule = () => void;
+export declare class EventBus {
+    private events;
+    private globalListeners;
+    get listenerCount(): number;
+    on(event: string, callback: EventCallback): void;
+    off(event: string, callback: EventCallback): void;
+    emit<T>(event: string, payload: T): void;
+}
+declare const AppEvents: EventBus;
+export default AppEvents;
+//# sourceMappingURL=EventBus.d.ts.map

package/dist/subsys/EventBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.d.ts","sourceRoot":"","sources":["../../src/subsys/EventBus.ts"],"names":[],"mappings":"AAAA,KAAK,aAAa,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;AAEnD,MAAM,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC;AAEnC,qBAAa,QAAQ;IACjB,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,eAAe,CAAuB;IAE9C,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa;IAgBzC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa;IAW1C,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;CAMpC;AAED,QAAA,MAAM,SAAS,UAAiB,CAAC;AAEjC,eAAe,SAAS,CAAC"}

package/dist/subsys/ExecutionProfileSwitcher.d.ts

@@ -0,0 +1,10 @@
+import type { EngineQueuesConfig } from "../types/queue.types";
+import type { ILogger } from "./LoggerService";
+export declare class ExecutionProfileSwitcher {
+    private logger;
+    private transitionItems;
+    constructor(logger: ILogger);
+    transitionToIdleMode({ queue, stateTransitionPolicy }: EngineQueuesConfig): void;
+    transitionToActiveMode({ queue, profile, stateTransitionPolicy }: EngineQueuesConfig): void;
+}
+//# sourceMappingURL=ExecutionProfileSwitcher.d.ts.map

package/dist/subsys/ExecutionProfileSwitcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionProfileSwitcher.d.ts","sourceRoot":"","sources":["../../src/subsys/ExecutionProfileSwitcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI/C,qBAAa,wBAAwB;IAGrB,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,eAAe,CAAqB;gBAExB,MAAM,EAAG,OAAO;IAEpC,oBAAoB,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAG,kBAAkB;IAuB1E,sBAAsB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,EAAG,kBAAkB;CASxF"}

package/dist/subsys/LoggerService.d.ts

@@ -0,0 +1,15 @@
+export interface ILogger {
+    log(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    debug?(message: string, ...args: any[]): void;
+}
+export declare class LoggerService implements ILogger {
+    private static provider;
+    setProvider(customLogger: ILogger): void;
+    log(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+}
+//# sourceMappingURL=LoggerService.d.ts.map

package/dist/subsys/LoggerService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoggerService.d.ts","sourceRoot":"","sources":["../../src/subsys/LoggerService.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACpB,GAAG,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE,GAAI,IAAI,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE,GAAI,IAAI,CAAC;IAC/C,KAAK,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE,GAAI,IAAI,CAAC;IAChD,KAAK,CAAC,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE,GAAI,IAAI,CAAC;CACpD;AASD,qBAAa,aAAc,YAAW,OAAO;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IAEjD,WAAW,CAAC,YAAY,EAAE,OAAO;IAIjC,GAAG,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE;IAIrC,IAAI,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE;IAItC,KAAK,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE;IAIvC,KAAK,CAAC,OAAO,EAAG,MAAM,EAAE,GAAG,IAAI,EAAG,GAAG,EAAE;CAKjD"}

package/dist/subsys/PulsarClock.d.ts

@@ -0,0 +1,32 @@
+export interface ClockOptions {
+    /** Maximum allowed runtime in milliseconds for the entire engine execution (e.g., 25000 for 25s) */
+    maxExecutionBudgetMs?: number;
+    /** Safety margin in milliseconds reserved for graceful cleanup/shutdown */
+    safetyBufferMs?: number;
+    /** Maximum number of execution spans to retain in memory */
+    maxTrackHistory?: number;
+    enabled?: boolean;
+}
+export declare class PulsarClock {
+    private tracks;
+    private startTime;
+    private maxExecutionBudgetMs;
+    private safetyBufferMs;
+    private maxTrackHistory;
+    private enabled;
+    cpuExecutionMicroseconds: number;
+    constructor(options?: ClockOptions);
+    trackExecutionTime<T>({ contextId }: {
+        contextId: string;
+    }, fn: () => Promise<T>): Promise<T>;
+    getElapsedTotalTime(): number;
+    getTimeRemaining(): number;
+    getAverageTickDuration(lastN?: number): number;
+    /**
+     * Determines if executing another tick is safe.
+     * Uses recent average tick duration to estimate whether another tick will exceed the deadline.
+     */
+    isSafeToContinue(): boolean;
+    clear(contextId: string): void;
+}
+//# sourceMappingURL=PulsarClock.d.ts.map

package/dist/subsys/PulsarClock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PulsarClock.d.ts","sourceRoot":"","sources":["../../src/subsys/PulsarClock.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IACzB,oGAAoG;IACpG,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAA8D;IAC5E,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,OAAO,CAAU;IAElB,wBAAwB,SAAK;gBAExB,OAAO,GAAE,YAAiB;IAQzB,kBAAkB,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,EAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBpG,mBAAmB,IAAK,MAAM;IAI9B,gBAAgB,IAAK,MAAM;IAM3B,sBAAsB,CAAC,KAAK,SAAI,GAAG,MAAM;IAOhD;;;OAGG;IACI,gBAAgB,IAAK,OAAO;IAe5B,KAAK,CAAC,SAAS,EAAG,MAAM;CAGlC"}

package/dist/subsys/RuntimeCacheStorage.d.ts

@@ -0,0 +1,18 @@
+export declare class RuntimeCacheStorage {
+    static store: Map<string, any>;
+    kv: {
+        set: <V>(key: string, value: V) => void;
+        get: <K>(key: string) => K | undefined;
+        has: (key: string) => boolean;
+        delete: (key: string) => boolean;
+        clear: () => void;
+    };
+    lists: {
+        add: (key: string, value: string) => void;
+        remove: (key: string, value: string) => boolean;
+        get: (key: string) => Set<string> | undefined;
+        has: (key: string, value: string) => boolean;
+    };
+}
+export declare const createRuntimeCacheStorage: () => RuntimeCacheStorage;
+//# sourceMappingURL=RuntimeCacheStorage.d.ts.map

package/dist/subsys/RuntimeCacheStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeCacheStorage.d.ts","sourceRoot":"","sources":["../../src/subsys/RuntimeCacheStorage.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAmB;IAC5B,OAAc,KAAK,EAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAa;IAE5C,EAAE;cACC,CAAC,OAAQ,MAAM,SAAU,CAAC;cAI1B,CAAC,OAAQ,MAAM,KAAI,CAAC,GAAG,SAAS;mBAI1B,MAAM,KAAI,OAAO;sBAId,MAAM,KAAI,OAAO;;MAOnC;IAEM,KAAK;mBACI,MAAM,SAAU,MAAM;sBAUnB,MAAM,SAAU,MAAM;mBAQzB,MAAM,KAAI,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS;mBAKjC,MAAM,SAAU,MAAM,KAAI,OAAO;MAOhD;CACJ;AAED,eAAO,MAAM,yBAAyB,2BAAkC,CAAC"}

package/dist/subsys/RuntimeEventBridge.d.ts

@@ -0,0 +1,16 @@
+import type { PulsarUnifiedStorage } from "../storage/PulsarStorage";
+import type { IRuntimeExecutionContext } from "../runtimes/runtimeTypes";
+import type { ILogger } from "./LoggerService";
+export declare class RuntimeEventBridge {
+    protected readonly storage: PulsarUnifiedStorage;
+    protected readonly logger: ILogger;
+    protected readonly runtimeExecutionId: string;
+    private readonly pgNotifyChannel;
+    private events;
+    constructor(storage: PulsarUnifiedStorage, logger: ILogger, runtimeExecutionId: string);
+    registerPgNotifyHandler(ctx: IRuntimeExecutionContext): Promise<void>;
+    registerPollingHandler(ctx: IRuntimeExecutionContext): Promise<void>;
+    httpEventDrivenQueueTrigger(queueName: string, fencingToken: string, ctx: IRuntimeExecutionContext): Promise<void>;
+    private handleTriggerValidity;
+}
+//# sourceMappingURL=RuntimeEventBridge.d.ts.map

package/dist/subsys/RuntimeEventBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeEventBridge.d.ts","sourceRoot":"","sources":["../../src/subsys/RuntimeEventBridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAI/C,qBAAa,kBAAkB;IAMvB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAG,oBAAoB;IACjD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAG,OAAO;IACnC,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAG,MAAM;IAPlD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgD;IAEhF,OAAO,CAAC,MAAM,CAAkB;gBAGT,OAAO,EAAG,oBAAoB,EAC9B,MAAM,EAAG,OAAO,EAChB,kBAAkB,EAAG,MAAM;IAKrC,uBAAuB,CAAC,GAAG,EAAG,wBAAwB;IAoBtD,sBAAsB,CAAC,GAAG,EAAG,wBAAwB;IAkBrD,2BAA2B,CAAC,SAAS,EAAG,MAAM,EAAE,YAAY,EAAG,MAAM,EAAE,GAAG,EAAG,wBAAwB;YAepG,qBAAqB;CAoCtC"}

package/dist/types/base.types.d.ts

@@ -0,0 +1,65 @@
+import type { QueueModule } from "../helpers/defineQueue.d.ts";
+import type { ILogger } from "../subsys/LoggerService.d.ts";
+import type { PulsarUnifiedStorage } from "../storage/PulsarStorage.d.ts";
+import type { IIntegration, IntegrationConstructor } from "./integrations.types.d.ts";
+import type { NebulaClusterConfig } from "./nebula.types.d.ts";
+import type { PersistentConfig, ServerlessVMConfig, V8IsolateConfig } from "./runtime.types.d.ts";
+export interface EngineSwarmConfig {
+    maxGlobalConcurrency?: number;
+    spawnerAlgorithm?: "LEAST_CONNECTIONS" | "ROUND_ROBIN" | "CBS";
+    globalMaxJobsPerTick?: number;
+}
+export type BaseEngineConfig = {
+    instanceId: string;
+    /**
+     * Specifies the shared API key for this instance.
+     * The key is generated once and must be identical across
+     * all consumer configurations targeting this instance.
+     *
+     * Generate a secure API key using:
+     * @example
+     * openssl rand -hex 32
+     * @or generate online
+     * https://generate-random.org/api-keys
+     */
+    apiKey: string;
+    nebula?: NebulaClusterConfig;
+    /**
+     * The unified storage layer responsible for state management, queue operations, and distributed locks.
+     *
+     * The engine requires **PostgreSQL** as its core underlying storage driver to handle fundamental database
+     * functions and lock tables. However, adding **Redis** to the unified storage driver unlocks an optimized
+     * dual-layer storage architecture.
+     *
+     * When Redis is configured alongside PostgreSQL, the engine automatically offloads high frequency,
+     * heavy throughput read and write operations—such as worker registration, batch dispatches, and job
+     * acknowledgments to Redis memory.
+     *
+     * ### Storage Mode Behavior:
+     * * **PostgreSQL Only:** Handles all state persistence, transactional safety, and queue operations directly on the database.
+     * * **PostgreSQL + Redis (Recommended):** Offloads runtime operational load from PostgreSQL to Redis memory,
+     *   significantly reducing database pressure and boosting overall engine processing speeds and throughput by 25% or more.
+     */
+    storage: PulsarUnifiedStorage;
+    queues: QueueModule[];
+    /**
+     * Consumer configuration for HTTP endpoints.
+     * When provided, Pulsar will make POST requests to this URL for each job.
+     * The job payload will be sent in the request body.
+     */
+    swarmConfig?: EngineSwarmConfig;
+    integrations?: Array<IntegrationConstructor | IIntegration>;
+    logger?: ILogger;
+    onEvents?: {
+        queueComplete?: (ctx: {
+            queue: string;
+            at: number;
+        }) => Promise<void> | void;
+        engineRestart?: () => Promise<void>;
+    };
+};
+/**
+ * Primary engine configuration union with runtime-level type enforcement.
+ */
+export type EngineConfig = V8IsolateConfig | ServerlessVMConfig | PersistentConfig;
+//# sourceMappingURL=base.types.d.ts.map

package/dist/types/base.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.types.d.ts","sourceRoot":"","sources":["../../src/types/base.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEhG,MAAM,WAAW,iBAAiB;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,mBAAmB,GAAG,aAAa,GAAG,KAAK,CAAC;IAC/D,oBAAoB,CAAC,EAAG,MAAM,CAAC;CAClC;AAID,MAAM,MAAM,gBAAgB,GAAG;IAC3B,UAAU,EAAG,MAAM,CAAC;IACpB;;;;;;;;;;OAUG;IACH,MAAM,EAAG,MAAM,CAAC;IAEhB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAE7B;;;;;;;;;;;;;;;OAeG;IACH,OAAO,EAAG,oBAAoB,CAAC;IAE/B,MAAM,EAAG,WAAW,EAAE,CAAC;IAEvB;;;;OAIG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC,YAAY,CAAC,EAAE,KAAK,CAAC,sBAAsB,GAAG,YAAY,CAAC,CAAC;IAE5D,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,QAAQ,CAAC,EAAG;QACR,aAAa,CAAC,EAAG,CAAC,GAAG,EAAG;YAAE,KAAK,EAAG,MAAM,CAAC;YAAC,EAAE,EAAG,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACjF,aAAa,CAAC,EAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;KACxC,CAAA;CACJ,CAAA;AAGD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,kBAAkB,GAAG,gBAAgB,CAAC"}

package/dist/types/config.types.d.ts

@@ -0,0 +1,56 @@
+import type { EventTriggerStrategy } from "./eventTriggerStrategry.types";
+import type { PulsarRuntime } from "./runtime.types";
+type RawPathKeys<T> = T extends object ? {
+    [K in keyof T & (string | number)]: T[K] extends Array<any> ? `${K}` : T[K] extends object ? `${K}` | `${K}.${RawPathKeys<T[K]>}` : `${K}`;
+}[keyof T & (string | number)] : never;
+/**
+ * Define exact paths or prefix patterns that MUST NOT be mutated via set().
+ *    - 'storage' | 'storage.${string}': Storage instance should not be swapped on the fly.
+ *    - 'runtime': Prevents switching execution environment at runtime.
+ *    - 'onEvents' | 'onEvents.${string}': Prevents overwriting event hooks.
+ */
+type BlockedPaths = "storage" | `storage.${string}` | "runtime" | "onEvents" | `onEvents.${string}` | "isolate" | `isolate.${string}`;
+/**
+ * Filtered paths allowed specifically for `set()` operations.
+ */
+export type SettablePathKeys<T> = Exclude<RawPathKeys<T>, BlockedPaths>;
+/**
+ * All paths available for `get()` operations (unrestricted read access).
+ */
+export type ReadablePathKeys<T> = RawPathKeys<T>;
+/**
+ * Type utility to infer the value type corresponding to a dot-notation path string.
+ */
+export type PathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? PathValue<T[K], Rest> : never : P extends keyof T ? T[P] : never;
+export interface IConfigurationObject {
+    queues: Array<{
+        queue: string;
+        pooler: string;
+    }>;
+    self_url: string;
+    runtime: PulsarRuntime;
+    event_trigger_strategy: EventTriggerStrategy;
+}
+export interface IConfigSyncResult {
+    isChanged: boolean;
+    isNew: boolean;
+    oldConfigurations?: IConfigurationObject;
+    delta?: {
+        urlChanged: boolean;
+        addedQueues: Array<{
+            queue: string;
+            pooler: string;
+        }>;
+        removedQueues: Array<{
+            queue: string;
+            pooler: string;
+        }>;
+        modifiedQueues: Array<{
+            queue: string;
+            oldPooler: string;
+            newPooler: string;
+        }>;
+    };
+}
+export {};
+//# sourceMappingURL=config.types.d.ts.map

package/dist/types/config.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.types.d.ts","sourceRoot":"","sources":["../../src/types/config.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAClC;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,GACvD,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAC5B,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE;CAClD,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,GAC9B,KAAK,CAAC;AAEV;;;;;GAKG;AACH,KAAK,YAAY,GACb,SAAS,GACT,WAAW,MAAM,EAAE,GACnB,SAAS,GACT,UAAU,GACV,YAAY,MAAM,EAAE,GACpB,SAAS,GACT,WAAW,MAAM,EAAE,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,IAAI,EAAE,GAC7E,CAAC,SAAS,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,KAAK,GACjD,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;AAGrC,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAG,KAAK,CAAC;QAAE,KAAK,EAAG,MAAM,CAAC;QAAC,MAAM,EAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,QAAQ,EAAG,MAAM,CAAC;IAClB,OAAO,EAAG,aAAa,CAAC;IACxB,sBAAsB,EAAG,oBAAoB,CAAA;CAChD;AAED,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;IACzC,KAAK,CAAC,EAAE;QACJ,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACtD,aAAa,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACxD,cAAc,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClF,CAAA;CACJ"}

package/dist/types/consumer.types.d.ts

@@ -0,0 +1,36 @@
+export type JobContext<T = any> = {
+    /**
+     * The ID Of Worker Which Picked This Batch
+     *
+     * When using callback, the consumer must deregister using this worker id for freeing up the slot
+    ***/
+    workerId: string;
+    /***
+     * The ID Of The Queue From Which This Batch Was Picked
+    ***/
+    queue: string;
+    /***
+     * The Payloads Of The Batch
+    ***/
+    payload: T;
+    /***
+     * The Number Of Attempts This Job Has Undergone
+    ***/
+    attempts: number;
+    timestamp: number;
+};
+export type EngineConsumerConfig = {
+    type: "http";
+    queue: string;
+    url: string;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+} | {
+    type: "socket";
+    queue: string;
+} | {
+    type: "callback";
+    queue: string;
+    handler(job: JobContext): Promise<void>;
+};
+//# sourceMappingURL=consumer.types.d.ts.map

package/dist/types/consumer.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.types.d.ts","sourceRoot":"","sources":["../../src/types/consumer.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,GAAG,IAAI;IAC9B;;;;QAII;IACJ,QAAQ,EAAG,MAAM,CAAC;IAElB;;QAEI;IACJ,KAAK,EAAG,MAAM,CAAC;IAEf;;QAEI;IACJ,OAAO,EAAG,CAAC,CAAC;IAEZ;;QAEI;IACJ,QAAQ,EAAG,MAAM,CAAC;IAClB,SAAS,EAAG,MAAM,CAAC;CACtB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAC5B;IACE,IAAI,EAAG,MAAM,CAAC;IACd,KAAK,EAAG,MAAM,CAAC;IACf,GAAG,EAAG,MAAM,CAAC;IACb,OAAO,CAAC,EAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,EAAG,MAAM,CAAC;CACrB,GACD;IACE,IAAI,EAAG,QAAQ,CAAC;IAChB,KAAK,EAAG,MAAM,CAAC;CAChB,GACD;IACA,IAAI,EAAG,UAAU,CAAC;IAClB,KAAK,EAAG,MAAM,CAAC;IACf,OAAO,CAAC,GAAG,EAAG,UAAU,GAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,CAAC"}

package/dist/types/engine.types.d.ts

@@ -0,0 +1,139 @@
+export type EnginePoolingMode = 'interval-driven-pooler' | 'event-driven-pooler';
+export type EngineSelfInvocation = {
+    selfURL: string;
+    selfInvocationMethod?: "auto_using_pgnet";
+} | {
+    selfURL: string;
+    selfInvocationMethod?: "manual";
+    handler: (selfUrl: string) => Promise<void> | void;
+};
+type BaseEngineOptions = {
+    /**
+     * The global maximum ceiling for total tick executions across ALL queues in a single execution run.
+     *
+     * Once the cumulative number of ticks executed across all queues reaches this limit,
+     * the engine terminates the current execution cycle and triggers a self-invocation restart.
+     *
+     * ### Execution Flow:
+     * ```
+     * [ Queue Ticks Executed ] ──(Count reaches cycleTickLimit)──> [ Terminate Cycle & Self-Invoke ]
+     * ```
+     *
+     * For example, with 10 queues and `cycleTickLimit: 10`, each queue executes 1 tick before
+     * the engine reaches the global limit and restarts, ensuring no single queue consumes
+     * the entire execution window.
+     *
+     * @default Infinity
+    */
+    cycleTickLimit?: number;
+    /**
+     * Controls the execution strategy for dispatching tick cycles across target queues.
+     *
+     * This setting dictates whether the engine evaluates and triggers ticks across multiple
+     * configured queues sequentially (one queue at a time) or in parallel (simultaneously).
+     *
+     * ### Execution Flow Comparison:
+     *
+     * **`sequential` (Default - CPU & Memory Safe):**
+     * ```
+     * [ Queue A Tick ] ──(await completion)──> [ Queue B Tick ] ──(await completion)──> [ Queue C Tick ]
+     * ```
+     * * **Behavior:** Processes queue ticks strictly one after another in serial order.
+     * * **Pros:** Keeps CPU usage steady and avoids sudden spike loads on database connections and memory isolates.
+     * * **Cons:** Takes longer total clock time to complete a single tick cycle across all queues.
+     *
+     * **`parallel` (High Throughput - Higher Resource Demand):**
+     * ```
+     * ┌─> [ Queue A Tick ]
+     * ├─> [ Queue B Tick ]  ─── (Fired simultaneously via Promise.allSettled)
+     * └─> [ Queue C Tick ]
+     * ```
+     * * **Behavior:** Dispatches tick evaluations for all candidate queues at the exact same moment.
+     * * **Pros:** Dramatically lowers cycle latency and maximizes total job processing throughput.
+     * * **Cons:** Produces concurrent CPU spikes, higher transient V8 memory allocations, and heavier concurrent database query bursts.
+     *
+     * > **Performance Note:** Choosing between `sequential` and `parallel` directly impacts engine resource utilization.
+     * > In environments with strict CPU time allocations or tight database connection limits, `sequential` prevents resource starvation.
+     * > For high-capacity environments prioritizing low dispatch latency across many queues, `parallel` delivers optimal speed.
+     *
+     * @default "sequential"
+     */
+    tickConcurrency?: "parallel" | "sequential";
+    /**
+     * How often (in seconds) the engine checks its own internal health and runtime state.
+     *
+     * @default 15
+     */
+    healthCheckIntervalSec?: number;
+    /**
+     * Defines the default engine wide intervention policy for handling external cancellation or stop signals.
+     *
+     * Queues configured with a policy of `"inherit"` will automatically adopt this global setting.
+     * When an external stop or intervention signal is triggered this policy dictates how the engine
+     * evaluates the signal and terminates the tick process:
+     *
+     * - `tick`: The engine checks the intervention flag on every single atomic tick iteration.
+     *   When a stop signal is detected, the engine aborts execution immediately within the current tick
+     *   boundary, ensuring near instantaneous cessation at the cost of higher cache/storage I/O.
+     * ---
+     * - `cycle`: The engine allows the active tick loop to run continuously through the completion
+     *   of a full batch cycle. The signal is only evaluated during the cycle reset boundary after
+     *   which the engine cleanly exits the loop (zero runtime overhead during active crunching but
+     *   introduces latency proportional to cycle length).
+     * ---
+     *- `disabled`: All external cancellation and intervention signals are ignored.
+     *   The engine will not evaluate, acknowledge, or act upon incoming stop signals,
+     *   allowing active tick processes to continue uninterrupted until normal completion.
+     *   This effectively disables external intervention across all queues inheriting this policy.
+     *
+     * @default "disabled"
+     */
+    interventionPolicy?: 'tick' | 'cycle' | 'disabled';
+};
+export type SelfInvokingEngine = BaseEngineOptions & {
+    selfURL: string;
+    selfInvocationMethod?: "auto_using_pgnet" | {
+        method: "manual";
+        handler: (selfUrl: string) => Promise<void> | void;
+    };
+    /**
+     * Specifies how often (in seconds) the engine should invoke itself.
+     *
+     * The minimum value is **1 second**. A higher number increases the delay
+     * between self-invocations.
+     *
+     * ### Recommendations & Workload Pacing
+     * * It is generally **recommended to keep the default (1 second)**.
+     * * Increasing this value introduces processing latency before jobs are picked up.
+     * * **Lower values (e.g., 1s)** process jobs faster and are recommended if you have
+     *   multiple interval-driven queues with frequent, predictable workloads.
+     * * **Higher values (e.g., 5s)** process jobs slower but significantly reduce the
+     *   total number of engine invocations over time.
+     *
+     * ### Estimated Monthly Invocations
+     * The lower this setting is, the higher the total invocation count will be at the
+     * end of the month.
+     *
+     * **1 Second Interval:**
+     * * Formula: `1 second * 60 seconds * 60 minutes * 24 hours * 30 days`
+     * * Total: **~2,592,000 invocations / month**
+     *
+     * **5 Seconds Interval:**
+     * * Formula: `(1 second / 5) * 60 seconds * 60 minutes * 24 hours * 30 days`
+     * * Total: **~518,400 invocations / month**
+     *
+     * *(Note: Depending on your hosting platform, actual invocation counts may be slightly
+     * higher or lower based on execution overhead).*
+     *
+     * @default 1
+     * @minimum 1
+    */
+    selfInvocationIntervalSec?: number;
+    selfRestartIntervalSec?: number;
+};
+export type PersistentEngine = BaseEngineOptions & {
+    poolingMode?: EnginePoolingMode;
+    poolingIntervalMS?: number;
+};
+export {};
+//# sourceMappingURL=engine.types.d.ts.map

package/dist/types/engine.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.types.d.ts","sourceRoot":"","sources":["../../src/types/engine.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,GAAG,qBAAqB,CAAC;AAEjF,MAAM,MAAM,oBAAoB,GAC5B;IAAE,OAAO,EAAG,MAAM,CAAC;IAAC,oBAAoB,CAAC,EAAG,kBAAkB,CAAA;CAAE,GAChE;IAAE,OAAO,EAAG,MAAM,CAAC;IAAC,oBAAoB,CAAC,EAAG,QAAQ,CAAC;IAAC,OAAO,EAAG,CAAC,OAAO,EAAG,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAAE,CAAA;AAEhH,KAAK,iBAAiB,GAAG;IACrB;;;;;;;;;;;;;;;;MAgBE;IACF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,eAAe,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IAC5C;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,kBAAkB,CAAC,EAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;CACvD,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,kBAAkB,GAAG;QAAE,MAAM,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;IACrH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA+BE;IACF,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACnC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG;IAC/C,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAA"}