@event-driven-platform/reader 0.0.3

package/dist/lib/errors/read-cancelled.error.js

@@ -0,0 +1,7 @@
+export class ReadCancelledError extends Error {
+    constructor() {
+        super('Read execution was cancelled.');
+        this.name = 'ReadCancelledError';
+    }
+}
+//# sourceMappingURL=read-cancelled.error.js.map

package/dist/lib/errors/read-cancelled.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-cancelled.error.js","sourceRoot":"","sources":["../../../src/lib/errors/read-cancelled.error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACzC;QACI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACrC,CAAC;CACJ"}

package/dist/lib/errors/read-execution-coordination-not-configured.error.d.ts

@@ -0,0 +1,4 @@
+export declare class ReadExecutionCoordinationNotConfiguredError extends Error {
+    constructor(reason: string);
+}
+//# sourceMappingURL=read-execution-coordination-not-configured.error.d.ts.map

package/dist/lib/errors/read-execution-coordination-not-configured.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-execution-coordination-not-configured.error.d.ts","sourceRoot":"","sources":["../../../src/lib/errors/read-execution-coordination-not-configured.error.ts"],"names":[],"mappings":"AAAA,qBAAa,2CAA4C,SAAQ,KAAK;gBACtD,MAAM,EAAE,MAAM;CAI7B"}

package/dist/lib/errors/read-execution-coordination-not-configured.error.js

@@ -0,0 +1,7 @@
+export class ReadExecutionCoordinationNotConfiguredError extends Error {
+    constructor(reason) {
+        super(`Distributed read coordination is not configured: ${reason}`);
+        this.name = 'ReadExecutionCoordinationNotConfiguredError';
+    }
+}
+//# sourceMappingURL=read-execution-coordination-not-configured.error.js.map

package/dist/lib/errors/read-execution-coordination-not-configured.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-execution-coordination-not-configured.error.js","sourceRoot":"","sources":["../../../src/lib/errors/read-execution-coordination-not-configured.error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,2CAA4C,SAAQ,KAAK;IAClE,YAAY,MAAc;QACtB,KAAK,CAAC,oDAAoD,MAAM,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,6CAA6C,CAAC;IAC9D,CAAC;CACJ"}

package/dist/lib/errors/read-execution-coordinator-unavailable.error.d.ts

@@ -0,0 +1,4 @@
+export declare class ReadExecutionCoordinatorUnavailableError extends Error {
+    constructor(reason: string);
+}
+//# sourceMappingURL=read-execution-coordinator-unavailable.error.d.ts.map

package/dist/lib/errors/read-execution-coordinator-unavailable.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-execution-coordinator-unavailable.error.d.ts","sourceRoot":"","sources":["../../../src/lib/errors/read-execution-coordinator-unavailable.error.ts"],"names":[],"mappings":"AAAA,qBAAa,wCAAyC,SAAQ,KAAK;gBACnD,MAAM,EAAE,MAAM;CAI7B"}

package/dist/lib/errors/read-execution-coordinator-unavailable.error.js

@@ -0,0 +1,7 @@
+export class ReadExecutionCoordinatorUnavailableError extends Error {
+    constructor(reason) {
+        super(`Read execution coordinator is unavailable: ${reason}`);
+        this.name = 'ReadExecutionCoordinatorUnavailableError';
+    }
+}
+//# sourceMappingURL=read-execution-coordinator-unavailable.error.js.map

package/dist/lib/errors/read-execution-coordinator-unavailable.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-execution-coordinator-unavailable.error.js","sourceRoot":"","sources":["../../../src/lib/errors/read-execution-coordinator-unavailable.error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,wCAAyC,SAAQ,KAAK;IAC/D,YAAY,MAAc;QACtB,KAAK,CAAC,8CAA8C,MAAM,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,0CAA0C,CAAC;IAC3D,CAAC;CACJ"}

package/dist/lib/errors/read-execution-ownership-lost.error.d.ts

@@ -0,0 +1,4 @@
+export declare class ReadExecutionOwnershipLostError extends Error {
+    constructor();
+}
+//# sourceMappingURL=read-execution-ownership-lost.error.d.ts.map

package/dist/lib/errors/read-execution-ownership-lost.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-execution-ownership-lost.error.d.ts","sourceRoot":"","sources":["../../../src/lib/errors/read-execution-ownership-lost.error.ts"],"names":[],"mappings":"AAAA,qBAAa,+BAAgC,SAAQ,KAAK;;CAKzD"}

package/dist/lib/errors/read-execution-ownership-lost.error.js

@@ -0,0 +1,7 @@
+export class ReadExecutionOwnershipLostError extends Error {
+    constructor() {
+        super('Distributed read execution ownership was lost before the result could be published.');
+        this.name = 'ReadExecutionOwnershipLostError';
+    }
+}
+//# sourceMappingURL=read-execution-ownership-lost.error.js.map

package/dist/lib/errors/read-execution-ownership-lost.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-execution-ownership-lost.error.js","sourceRoot":"","sources":["../../../src/lib/errors/read-execution-ownership-lost.error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,+BAAgC,SAAQ,KAAK;IACtD;QACI,KAAK,CAAC,qFAAqF,CAAC,CAAC;QAC7F,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;IAClD,CAAC;CACJ"}

package/dist/lib/errors/read-handler-ambiguous.error.d.ts

@@ -0,0 +1,5 @@
+export declare class ReadHandlerAmbiguousError extends Error {
+    readonly reason: string;
+    constructor(reason: string);
+}
+//# sourceMappingURL=read-handler-ambiguous.error.d.ts.map

package/dist/lib/errors/read-handler-ambiguous.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-handler-ambiguous.error.d.ts","sourceRoot":"","sources":["../../../src/lib/errors/read-handler-ambiguous.error.ts"],"names":[],"mappings":"AAAA,qBAAa,yBAA0B,SAAQ,KAAK;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAItC"}

package/dist/lib/errors/read-handler-ambiguous.error.js

@@ -0,0 +1,9 @@
+export class ReadHandlerAmbiguousError extends Error {
+    reason;
+    constructor(reason) {
+        super(`ReadHandler resolution is ambiguous: ${reason}`);
+        this.reason = reason;
+        this.name = 'ReadHandlerAmbiguousError';
+    }
+}
+//# sourceMappingURL=read-handler-ambiguous.error.js.map

package/dist/lib/errors/read-handler-ambiguous.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-handler-ambiguous.error.js","sourceRoot":"","sources":["../../../src/lib/errors/read-handler-ambiguous.error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAC3B;IAArB,YAAqB,MAAc;QAC/B,KAAK,CAAC,wCAAwC,MAAM,EAAE,CAAC,CAAC;QADvC,WAAM,GAAN,MAAM,CAAQ;QAE/B,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC5C,CAAC;CACJ"}

package/dist/lib/errors/read-handler-not-found.error.d.ts

@@ -0,0 +1,4 @@
+export declare class ReadHandlerNotFoundError extends Error {
+    constructor();
+}
+//# sourceMappingURL=read-handler-not-found.error.d.ts.map

package/dist/lib/errors/read-handler-not-found.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-handler-not-found.error.d.ts","sourceRoot":"","sources":["../../../src/lib/errors/read-handler-not-found.error.ts"],"names":[],"mappings":"AAAA,qBAAa,wBAAyB,SAAQ,KAAK;;CAKlD"}

package/dist/lib/errors/read-handler-not-found.error.js

@@ -0,0 +1,7 @@
+export class ReadHandlerNotFoundError extends Error {
+    constructor() {
+        super('No ReadHandler is available for the requested Read.');
+        this.name = 'ReadHandlerNotFoundError';
+    }
+}
+//# sourceMappingURL=read-handler-not-found.error.js.map

package/dist/lib/errors/read-handler-not-found.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-handler-not-found.error.js","sourceRoot":"","sources":["../../../src/lib/errors/read-handler-not-found.error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAC/C;QACI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,CAAC;CACJ"}

package/dist/lib/errors/read-timed-out.error.d.ts

@@ -0,0 +1,5 @@
+export declare class ReadTimedOutError extends Error {
+    readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+}
+//# sourceMappingURL=read-timed-out.error.d.ts.map

package/dist/lib/errors/read-timed-out.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-timed-out.error.d.ts","sourceRoot":"","sources":["../../../src/lib/errors/read-timed-out.error.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;CAIzC"}

package/dist/lib/errors/read-timed-out.error.js

@@ -0,0 +1,9 @@
+export class ReadTimedOutError extends Error {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`Read execution timed out after ${timeoutMs}ms.`);
+        this.timeoutMs = timeoutMs;
+        this.name = 'ReadTimedOutError';
+    }
+}
+//# sourceMappingURL=read-timed-out.error.js.map

package/dist/lib/errors/read-timed-out.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-timed-out.error.js","sourceRoot":"","sources":["../../../src/lib/errors/read-timed-out.error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACnB;IAArB,YAAqB,SAAiB;QAClC,KAAK,CAAC,kCAAkC,SAAS,KAAK,CAAC,CAAC;QADvC,cAAS,GAAT,SAAS,CAAQ;QAElC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACpC,CAAC;CACJ"}

package/dist/lib/inflight/distributed-read-flight.d.ts

@@ -0,0 +1,26 @@
+import type { ReadExecutionCoordinator } from '@event-driven-platform/read-execution-coordinator';
+import type { ReadCacheKey } from '@event-driven-platform/query';
+type SharedReadResult<TResult> = {
+    readonly status: 'hit';
+    readonly value: TResult;
+} | {
+    readonly status: 'miss';
+};
+interface DistributedReadFlightRequest<TResult> {
+    readonly key: ReadCacheKey;
+    readonly ownerId: string;
+    readonly leaseDurationMs: number;
+    readonly readShared: () => Promise<SharedReadResult<TResult>>;
+    readonly executeSource: () => Promise<TResult>;
+    readonly publishSourceResult: (result: TResult) => Promise<void>;
+}
+export declare class DistributedReadFlight {
+    private readonly coordinator;
+    constructor(coordinator: ReadExecutionCoordinator);
+    run<TResult>(request: DistributedReadFlightRequest<TResult>): Promise<TResult>;
+    private waitForCurrentFlight;
+    private runAsOwner;
+    private assertOwnership;
+}
+export {};
+//# sourceMappingURL=distributed-read-flight.d.ts.map

package/dist/lib/inflight/distributed-read-flight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distributed-read-flight.d.ts","sourceRoot":"","sources":["../../../src/lib/inflight/distributed-read-flight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,wBAAwB,EAE3B,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAKjE,KAAK,gBAAgB,CAAC,OAAO,IACvB;IAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,UAAU,4BAA4B,CAAC,OAAO;IAC1C,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,QAAQ,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE;AAED,qBAAa,qBAAqB;IAClB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,wBAAwB;IAE5D,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,4BAA4B,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;YAyBtE,oBAAoB;YAepB,UAAU;IA2FxB,OAAO,CAAC,eAAe;CAc1B"}

package/dist/lib/inflight/distributed-read-flight.js

@@ -0,0 +1,122 @@
+import { ReadExecutionCoordinatorUnavailableError } from '../errors/read-execution-coordinator-unavailable.error.js';
+import { ReadExecutionOwnershipLostError } from '../errors/read-execution-ownership-lost.error.js';
+export class DistributedReadFlight {
+    coordinator;
+    constructor(coordinator) {
+        this.coordinator = coordinator;
+    }
+    async run(request) {
+        while (true) {
+            const claim = await this.coordinator.claim({
+                key: request.key,
+                ownerId: request.ownerId,
+                leaseDurationMs: request.leaseDurationMs,
+            });
+            if (claim.status === 'unavailable') {
+                throw new ReadExecutionCoordinatorUnavailableError(claim.reason);
+            }
+            if (claim.status === 'already-in-progress') {
+                const afterWait = await this.waitForCurrentFlight(request);
+                if (afterWait.status === 'hit') {
+                    return afterWait.value;
+                }
+                continue;
+            }
+            return this.runAsOwner(request, claim.lease);
+        }
+    }
+    async waitForCurrentFlight(request) {
+        const wait = await this.coordinator.wait({
+            key: request.key,
+            timeoutMs: request.leaseDurationMs,
+        });
+        if (wait.status === 'unavailable') {
+            throw new ReadExecutionCoordinatorUnavailableError(wait.reason);
+        }
+        return request.readShared();
+    }
+    async runAsOwner(request, lease) {
+        let leaseState = 'owned';
+        let unavailableReason;
+        let stopped = false;
+        let timer;
+        let renewing;
+        const intervalMs = Math.max(1, Math.floor(request.leaseDurationMs / 2));
+        const scheduleRenewal = () => {
+            timer = setTimeout(() => {
+                renewing = renew().finally(() => {
+                    renewing = undefined;
+                });
+            }, intervalMs);
+        };
+        const renew = async () => {
+            if (stopped || leaseState !== 'owned') {
+                return;
+            }
+            const result = await this.coordinator.renew({
+                key: request.key,
+                lease,
+                leaseDurationMs: request.leaseDurationMs,
+            });
+            if (result.status === 'ownership-lost') {
+                leaseState = 'lost';
+                return;
+            }
+            if (result.status === 'unavailable') {
+                leaseState = 'unavailable';
+                unavailableReason = result.reason;
+                return;
+            }
+            if (!stopped) {
+                scheduleRenewal();
+            }
+        };
+        const synchronizeRenewal = async () => {
+            if (renewing !== undefined) {
+                await renewing;
+            }
+            this.assertOwnership(leaseState, unavailableReason);
+        };
+        scheduleRenewal();
+        try {
+            const sharedResult = await request.readShared();
+            if (sharedResult.status === 'hit') {
+                return sharedResult.value;
+            }
+            const sourceResult = await request.executeSource();
+            await synchronizeRenewal();
+            await request.publishSourceResult(sourceResult);
+            await synchronizeRenewal();
+            return sourceResult;
+        }
+        finally {
+            stopped = true;
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+            if (renewing !== undefined) {
+                try {
+                    await renewing;
+                }
+                catch {
+                    // Renewal failure has already been represented through coordinator outcomes.
+                }
+            }
+            try {
+                await this.coordinator.release({ key: request.key, lease });
+            }
+            catch {
+                // The lease is TTL-bounded; release failure must not replace a completed business read.
+            }
+        }
+    }
+    assertOwnership(leaseState, unavailableReason) {
+        if (leaseState === 'lost') {
+            throw new ReadExecutionOwnershipLostError();
+        }
+        if (leaseState === 'unavailable') {
+            throw new ReadExecutionCoordinatorUnavailableError(unavailableReason ?? 'lease renewal failed');
+        }
+    }
+}
+//# sourceMappingURL=distributed-read-flight.js.map

package/dist/lib/inflight/distributed-read-flight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distributed-read-flight.js","sourceRoot":"","sources":["../../../src/lib/inflight/distributed-read-flight.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wCAAwC,EAAE,MAAM,2DAA2D,CAAC;AACrH,OAAO,EAAE,+BAA+B,EAAE,MAAM,kDAAkD,CAAC;AAenG,MAAM,OAAO,qBAAqB;IACD;IAA7B,YAA6B,WAAqC;QAArC,gBAAW,GAAX,WAAW,CAA0B;IAAG,CAAC;IAEtE,KAAK,CAAC,GAAG,CAAU,OAA8C;QAC7D,OAAO,IAAI,EAAE,CAAC;YACV,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;gBACvC,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,eAAe,EAAE,OAAO,CAAC,eAAe;aAC3C,CAAC,CAAC;YAEH,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;gBACjC,MAAM,IAAI,wCAAwC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACrE,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,qBAAqB,EAAE,CAAC;gBACzC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;gBAC3D,IAAI,SAAS,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;oBAC7B,OAAO,SAAS,CAAC,KAAK,CAAC;gBAC3B,CAAC;gBAED,SAAS;YACb,CAAC;YAED,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACjD,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAC9B,OAA8C;QAE9C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YACrC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS,EAAE,OAAO,CAAC,eAAe;SACrC,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YAChC,MAAM,IAAI,wCAAwC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpE,CAAC;QAED,OAAO,OAAO,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;IAEO,KAAK,CAAC,UAAU,CACpB,OAA8C,EAC9C,KAAkC;QAElC,IAAI,UAAU,GAAqC,OAAO,CAAC;QAC3D,IAAI,iBAAqC,CAAC;QAC1C,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,KAAgD,CAAC;QACrD,IAAI,QAAmC,CAAC;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC;QAExE,MAAM,eAAe,GAAG,GAAS,EAAE;YAC/B,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACpB,QAAQ,GAAG,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;oBAC5B,QAAQ,GAAG,SAAS,CAAC;gBACzB,CAAC,CAAC,CAAC;YACP,CAAC,EAAE,UAAU,CAAC,CAAC;QACnB,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;YACpC,IAAI,OAAO,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;gBACpC,OAAO;YACX,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;gBACxC,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,KAAK;gBACL,eAAe,EAAE,OAAO,CAAC,eAAe;aAC3C,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,MAAM,KAAK,gBAAgB,EAAE,CAAC;gBACrC,UAAU,GAAG,MAAM,CAAC;gBACpB,OAAO;YACX,CAAC;YAED,IAAI,MAAM,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;gBAClC,UAAU,GAAG,aAAa,CAAC;gBAC3B,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;gBAClC,OAAO;YACX,CAAC;YAED,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,eAAe,EAAE,CAAC;YACtB,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,kBAAkB,GAAG,KAAK,IAAmB,EAAE;YACjD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,QAAQ,CAAC;YACnB,CAAC;YAED,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;QACxD,CAAC,CAAC;QAEF,eAAe,EAAE,CAAC;QAElB,IAAI,CAAC;YACD,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;YAChD,IAAI,YAAY,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBAChC,OAAO,YAAY,CAAC,KAAK,CAAC;YAC9B,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;YAEnD,MAAM,kBAAkB,EAAE,CAAC;YAC3B,MAAM,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;YAChD,MAAM,kBAAkB,EAAE,CAAC;YAE3B,OAAO,YAAY,CAAC;QACxB,CAAC;gBAAS,CAAC;YACP,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACtB,YAAY,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC;YAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACD,MAAM,QAAQ,CAAC;gBACnB,CAAC;gBAAC,MAAM,CAAC;oBACL,6EAA6E;gBACjF,CAAC;YACL,CAAC;YAED,IAAI,CAAC;gBACD,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;YAChE,CAAC;YAAC,MAAM,CAAC;gBACL,wFAAwF;YAC5F,CAAC;QACL,CAAC;IACL,CAAC;IAEO,eAAe,CACnB,UAA4C,EAC5C,iBAAqC;QAErC,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,+BAA+B,EAAE,CAAC;QAChD,CAAC;QAED,IAAI,UAAU,KAAK,aAAa,EAAE,CAAC;YAC/B,MAAM,IAAI,wCAAwC,CAC9C,iBAAiB,IAAI,sBAAsB,CAC9C,CAAC;QACN,CAAC;IACL,CAAC;CACJ"}

package/dist/lib/inflight/local-read-in-flight.d.ts

@@ -0,0 +1,7 @@
+import type { ReadCacheKey } from '@event-driven-platform/query';
+export declare class LocalReadInFlight {
+    private readonly flights;
+    run<TResult>(key: ReadCacheKey, execute: () => Promise<TResult>): Promise<TResult>;
+    private identityOf;
+}
+//# sourceMappingURL=local-read-in-flight.d.ts.map

package/dist/lib/inflight/local-read-in-flight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-read-in-flight.d.ts","sourceRoot":"","sources":["../../../src/lib/inflight/local-read-in-flight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEjE,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAE/D,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBlF,OAAO,CAAC,UAAU;CAGrB"}

package/dist/lib/inflight/local-read-in-flight.js

@@ -0,0 +1,21 @@
+export class LocalReadInFlight {
+    flights = new Map();
+    run(key, execute) {
+        const identity = this.identityOf(key);
+        const active = this.flights.get(identity);
+        if (active !== undefined) {
+            return active;
+        }
+        const flight = execute().finally(() => {
+            if (this.flights.get(identity) === flight) {
+                this.flights.delete(identity);
+            }
+        });
+        this.flights.set(identity, flight);
+        return flight;
+    }
+    identityOf(key) {
+        return JSON.stringify([key.namespace, key.version, key.partition, key.value]);
+    }
+}
+//# sourceMappingURL=local-read-in-flight.js.map

package/dist/lib/inflight/local-read-in-flight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-read-in-flight.js","sourceRoot":"","sources":["../../../src/lib/inflight/local-read-in-flight.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iBAAiB;IACT,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE/D,GAAG,CAAU,GAAiB,EAAE,OAA+B;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAE1C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,MAA0B,CAAC;QACtC,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YAClC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,MAAM,EAAE,CAAC;gBACxC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEnC,OAAO,MAAM,CAAC;IAClB,CAAC;IAEO,UAAU,CAAC,GAAiB;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAClF,CAAC;CACJ"}

package/dist/lib/reader/default-reader-dependencies.d.ts

@@ -0,0 +1,10 @@
+import type { ReadExecutionCoordinator } from '@event-driven-platform/read-execution-coordinator';
+import type { ReadHandlerResolver } from '@event-driven-platform/read-handler-resolver';
+import type { ReadTimeout } from '../control/read-timeout.js';
+export interface DefaultReaderDependencies {
+    readonly readHandlerResolver: ReadHandlerResolver;
+    readonly readTimeout?: ReadTimeout;
+    readonly readExecutionCoordinator?: ReadExecutionCoordinator;
+    readonly readExecutionOwnerIdFactory?: () => string;
+}
+//# sourceMappingURL=default-reader-dependencies.d.ts.map

package/dist/lib/reader/default-reader-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-reader-dependencies.d.ts","sourceRoot":"","sources":["../../../src/lib/reader/default-reader-dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mDAAmD,CAAC;AAClG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAExF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,MAAM,WAAW,yBAAyB;IACtC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IAC7D,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,MAAM,CAAC;CACvD"}

package/dist/lib/reader/default-reader-dependencies.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=default-reader-dependencies.js.map

package/dist/lib/reader/default-reader-dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-reader-dependencies.js","sourceRoot":"","sources":["../../../src/lib/reader/default-reader-dependencies.ts"],"names":[],"mappings":""}

package/dist/lib/reader/default-reader.d.ts

@@ -0,0 +1,13 @@
+import type { Query } from '@event-driven-platform/query';
+import type { AnyRead, ReadResultOf } from '@event-driven-platform/read';
+import type { DefaultReaderDependencies } from './default-reader-dependencies.js';
+import type { Reader } from './reader.js';
+export type { DefaultReaderDependencies } from './default-reader-dependencies.js';
+export declare class DefaultReader implements Reader {
+    private readonly sourceExecutor;
+    private readonly cachedExecutor;
+    private readonly executionControl;
+    constructor(dependencies: DefaultReaderDependencies);
+    execute<TRead extends AnyRead>(query: Query<TRead>): Promise<ReadResultOf<TRead>>;
+}
+//# sourceMappingURL=default-reader.d.ts.map

package/dist/lib/reader/default-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-reader.d.ts","sourceRoot":"","sources":["../../../src/lib/reader/default-reader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAMzE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,YAAY,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAElF,qBAAa,aAAc,YAAW,MAAM;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuB;gBAErC,YAAY,EAAE,yBAAyB;IAYnD,OAAO,CAAC,KAAK,SAAS,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;CAS3F"}

package/dist/lib/reader/default-reader.js

@@ -0,0 +1,27 @@
+import { randomUUID } from 'node:crypto';
+import { CachedReadExecutor } from '../cache/cached-read-executor.js';
+import { DefaultReadTimeout } from '../control/default-read-timeout.js';
+import { ReadExecutionControl } from '../control/read-execution-control.js';
+import { ReadSourceExecutor } from '../source/read-source-executor.js';
+export class DefaultReader {
+    sourceExecutor;
+    cachedExecutor;
+    executionControl;
+    constructor(dependencies) {
+        this.sourceExecutor = new ReadSourceExecutor(dependencies.readHandlerResolver);
+        this.cachedExecutor = new CachedReadExecutor({
+            sourceExecutor: this.sourceExecutor,
+            readExecutionCoordinator: dependencies.readExecutionCoordinator,
+            ownerIdFactory: dependencies.readExecutionOwnerIdFactory ?? randomUUID,
+        });
+        this.executionControl = new ReadExecutionControl(dependencies.readTimeout ?? new DefaultReadTimeout());
+    }
+    execute(query) {
+        const cachePlan = query.options?.cache;
+        const work = cachePlan === undefined
+            ? () => this.sourceExecutor.execute(query.read)
+            : () => this.cachedExecutor.execute(query, cachePlan);
+        return this.executionControl.execute(work, query.options);
+    }
+}
+//# sourceMappingURL=default-reader.js.map

package/dist/lib/reader/default-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-reader.js","sourceRoot":"","sources":["../../../src/lib/reader/default-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAMvE,MAAM,OAAO,aAAa;IACL,cAAc,CAAqB;IACnC,cAAc,CAAqB;IACnC,gBAAgB,CAAuB;IAExD,YAAmB,YAAuC;QACtD,IAAI,CAAC,cAAc,GAAG,IAAI,kBAAkB,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;QAC/E,IAAI,CAAC,cAAc,GAAG,IAAI,kBAAkB,CAAC;YACzC,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,wBAAwB,EAAE,YAAY,CAAC,wBAAwB;YAC/D,cAAc,EAAE,YAAY,CAAC,2BAA2B,IAAI,UAAU;SACzE,CAAC,CAAC;QACH,IAAI,CAAC,gBAAgB,GAAG,IAAI,oBAAoB,CAC5C,YAAY,CAAC,WAAW,IAAI,IAAI,kBAAkB,EAAE,CACvD,CAAC;IACN,CAAC;IAEM,OAAO,CAAwB,KAAmB;QACrD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC;QACvC,MAAM,IAAI,GACN,SAAS,KAAK,SAAS;YACnB,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;YAC/C,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAE9D,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC;CACJ"}

package/dist/lib/reader/reader.d.ts

@@ -0,0 +1,6 @@
+import type { Query } from '@event-driven-platform/query';
+import type { AnyRead, ReadResultOf } from '@event-driven-platform/read';
+export interface Reader {
+    execute<TRead extends AnyRead>(query: Query<TRead>): Promise<ReadResultOf<TRead>>;
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/lib/reader/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../../src/lib/reader/reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEzE,MAAM,WAAW,MAAM;IACnB,OAAO,CAAC,KAAK,SAAS,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;CACrF"}

package/dist/lib/reader/reader.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reader.js.map

package/dist/lib/reader/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../../../src/lib/reader/reader.ts"],"names":[],"mappings":""}

package/dist/lib/source/read-source-executor.d.ts

@@ -0,0 +1,9 @@
+import type { AnyRead, ReadResultOf } from '@event-driven-platform/read';
+import type { ReadHandlerResolver } from '@event-driven-platform/read-handler-resolver';
+export declare class ReadSourceExecutor {
+    private readonly readHandlerResolver;
+    constructor(readHandlerResolver: ReadHandlerResolver);
+    execute<TRead extends AnyRead>(read: TRead): Promise<ReadResultOf<TRead>>;
+    private resolveHandler;
+}
+//# sourceMappingURL=read-source-executor.d.ts.map

package/dist/lib/source/read-source-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-source-executor.d.ts","sourceRoot":"","sources":["../../../src/lib/source/read-source-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAyB,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AAK/G,qBAAa,kBAAkB;IACR,OAAO,CAAC,QAAQ,CAAC,mBAAmB;gBAAnB,mBAAmB,EAAE,mBAAmB;IAErE,OAAO,CAAC,KAAK,SAAS,OAAO,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAOhF,OAAO,CAAC,cAAc;CAUzB"}

package/dist/lib/source/read-source-executor.js

@@ -0,0 +1,24 @@
+import { ReadHandlerAmbiguousError } from '../errors/read-handler-ambiguous.error.js';
+import { ReadHandlerNotFoundError } from '../errors/read-handler-not-found.error.js';
+export class ReadSourceExecutor {
+    readHandlerResolver;
+    constructor(readHandlerResolver) {
+        this.readHandlerResolver = readHandlerResolver;
+    }
+    execute(read) {
+        const resolution = this.readHandlerResolver.resolve(read);
+        const handler = this.resolveHandler(resolution);
+        return handler.execute(read);
+    }
+    resolveHandler(resolution) {
+        switch (resolution.status) {
+            case 'resolved':
+                return resolution.handlers[0];
+            case 'not-found':
+                throw new ReadHandlerNotFoundError();
+            case 'ambiguous':
+                throw new ReadHandlerAmbiguousError(resolution.reason);
+        }
+    }
+}
+//# sourceMappingURL=read-source-executor.js.map

package/dist/lib/source/read-source-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-source-executor.js","sourceRoot":"","sources":["../../../src/lib/source/read-source-executor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAErF,MAAM,OAAO,kBAAkB;IACS;IAApC,YAAoC,mBAAwC;QAAxC,wBAAmB,GAAnB,mBAAmB,CAAqB;IAAG,CAAC;IAEzE,OAAO,CAAwB,IAAW;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAEhD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAEO,cAAc,CAAwB,UAAwC;QAClF,QAAQ,UAAU,CAAC,MAAM,EAAE,CAAC;YACxB,KAAK,UAAU;gBACX,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAClC,KAAK,WAAW;gBACZ,MAAM,IAAI,wBAAwB,EAAE,CAAC;YACzC,KAAK,WAAW;gBACZ,MAAM,IAAI,yBAAyB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/D,CAAC;IACL,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@event-driven-platform/reader",
+  "version": "0.0.3",
+  "description": "Centralized execution engine for Queries, cache traversal, coalescing, and ReadHandler dispatch.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sanshan/event-driven-platform.git",
+    "directory": "packages/reader"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0",
+    "@event-driven-platform/query": "0.0.4",
+    "@event-driven-platform/read": "0.0.4",
+    "@event-driven-platform/read-execution-coordinator": "0.0.3",
+    "@event-driven-platform/read-handler-resolver": "0.0.3"
+  },
+  "devDependencies": {
+    "redis": "^6.2.1",
+    "@event-driven-platform/read-cache-in-memory": "0.0.3",
+    "@event-driven-platform/read-cache-redis": "0.0.3",
+    "@event-driven-platform/read-execution-coordinator-redis": "0.0.3"
+  }
+}