@hamim_4444/pulsar 0.0.0-stage → 1.0.0

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 type { IPulsarDriver, PostgresDriverOptions, StorageHealth } from "./types.d.ts";
+import postgres from "postgres";
+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,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGtF,OAAO,QAAQ,MAAM,UAAU,CAAC;AAGhC,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"}

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

@@ -0,0 +1,27 @@
+export interface StorageHealth {
+    status: "up" | "down" | "degraded";
+    latencyMs: number;
+    details?: Record<string, any>;
+}
+export interface IPulsarDriver {
+    readonly type: "cache" | "database";
+    readonly name: string;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<StorageHealth>;
+    setKeyPrefix(instanceId: string): void;
+    getNativeClient<T = any>(): T;
+}
+export type RedisDriverOptions = {
+    connectionString: string;
+    protocol: "tcp";
+} | {
+    protocol: "http";
+    token: string;
+    url: string;
+};
+export interface PostgresDriverOptions {
+    connectionString: string;
+    connectionProtocol: "tcp" | "transactional" | "session";
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/storage/drivers/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAG,IAAI,GAAG,MAAM,GAAG,UAAU,CAAC;IACpC,SAAS,EAAG,MAAM,CAAC;IACnB,OAAO,CAAC,EAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,OAAO,IAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,UAAU,IAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,WAAW,IAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvC,YAAY,CAAC,UAAU,EAAG,MAAM,GAAI,IAAI,CAAC;IAEzC,eAAe,CAAC,CAAC,GAAG,GAAG,KAAM,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC7B,gBAAgB,EAAG,MAAM,CAAC;IAC1B,QAAQ,EAAG,KAAK,CAAC;CACpB,GAAG;IAAE,QAAQ,EAAG,MAAM,CAAC;IAAC,KAAK,EAAG,MAAM,CAAC;IAAC,GAAG,EAAG,MAAM,CAAA;CAAE,CAAC;AAExD,MAAM,WAAW,qBAAqB;IAClC,gBAAgB,EAAG,MAAM,CAAC;IAC1B,kBAAkB,EAAG,KAAK,GAAG,eAAe,GAAG,SAAS,CAAC;CAC5D"}

package/dist/storage/index.d.ts

@@ -0,0 +1,4 @@
+export { PulsarUnifiedStorage, type PulsarStorageOptions } from "./PulsarStorage";
+export { PostgresDriver } from "./drivers/PostgresDriver";
+export { RedisDriver } from "./drivers/RedisDriver";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC"}