effect-jobs 0.1.0-alpha.0

package/dist/JobWorker.js

@@ -0,0 +1,155 @@
+import { Cause, Context, Effect, Layer, Schema, Semaphore } from "effect";
+import { CatalogIdentity } from "./JobIdentity.js";
+import { EpochMillis } from "./JobPolicy.js";
+import { JobRegistry } from "./JobRegistry.js";
+import { observe } from "./JobTelemetry.js";
+import { JobOwnership } from "./JobLifecycle.js";
+import { DispatchResults, JobWorkerConfigurationError, JobWorkerNotReady, JobWorkerUnavailable, WorkerCapability } from "./internal/worker/Capability.js";
+import { executionFor } from "./internal/worker/Execution.js";
+export { JobWorkerConfigurationError, JobWorkerNotReady, JobWorkerUnavailable } from "./internal/worker/Capability.js";
+export class JobWorker extends Context.Service()("effect-jobs/JobWorker") {
+}
+const unavailable = (effect) => effect.pipe(Effect.catchCause((cause) => Cause.hasInterrupts(cause)
+    ? Effect.interrupt
+    : Effect.fail(new JobWorkerUnavailable())));
+/** The integrated store is a generic port (no Context tag). Capture its ordinary
+ * Effect requirements once here; providers still own pools and transactions. */
+export const make = (store, options) => Effect.gen(function* () {
+    const registry = yield* JobRegistry;
+    const services = yield* Effect.context();
+    const budget = options.operationResponseBudgetMillis;
+    if (!Schema.is(EpochMillis)(budget)) {
+        return yield* new JobWorkerConfigurationError({
+            field: "operationResponseBudgetMillis"
+        });
+    }
+    const catalogs = options.catalog.map((entry) => Object.freeze({
+        queue: entry.catalog.queue,
+        kind: entry.catalog.kind,
+        version: entry.catalog.version
+    }));
+    const keys = catalogs.map((entry) => `${entry.queue}\u0000${entry.kind}\u0000${entry.version}`);
+    if (catalogs.length === 0 ||
+        !catalogs.every(Schema.is(CatalogIdentity)) ||
+        new Set(keys).size !== keys.length) {
+        return yield* new JobWorkerConfigurationError({ field: "catalog" });
+    }
+    Object.freeze(catalogs);
+    const bound = {
+        claim: (input) => Effect.suspend(() => store.claim(input)).pipe(Effect.provide(services)),
+        reconcileClaim: (token) => Effect.suspend(() => store.reconcileClaim(token)).pipe(Effect.provide(services)),
+        release: (owner, phase) => Effect.suspend(() => store.release(owner, phase)).pipe(Effect.provide(services)),
+        finalize: (request) => Effect.suspend(() => store.finalize(request)).pipe(Effect.provide(services)),
+        reconcileFinalization: (request) => Effect.suspend(() => store.reconcileFinalization(request)).pipe(Effect.provide(services)),
+        recoverExpired: (limit) => Effect.suspend(() => store.recoverExpired(limit)).pipe(Effect.provide(services))
+    };
+    const permits = new Map();
+    const ready = (queue) => Effect.suspend(() => catalogs.some((entry) => entry.queue === queue) &&
+        catalogs.every((entry) => registry.find(entry) !== undefined)
+        ? Effect.void
+        : Effect.fail(new JobWorkerNotReady()));
+    const release = (ownership) => bound
+        .release(ownership, "BeforeExecution")
+        .pipe(Effect.interruptible, Effect.timeout(budget), observe("release", "dispatch"), Effect.ignore);
+    const started = (claim, token, queue) => {
+        if (!Schema.is(JobOwnership)(claim.ownership) ||
+            claim.ownership.leaseToken !== token) {
+            return DispatchResults.Unresolved();
+        }
+        let phase = "BeforeExecution";
+        return DispatchResults.Started({
+            execution: Effect.suspend(() => {
+                if (phase !== "BeforeExecution") {
+                    return Effect.void;
+                }
+                phase = "Executing";
+                return executionFor(bound, claim, registry.find, catalogs.filter((entry) => entry.queue === queue), budget);
+            }),
+            release: Effect.suspend(() => {
+                if (phase !== "BeforeExecution") {
+                    return Effect.void;
+                }
+                phase = "Released";
+                return release(claim.ownership);
+            })
+        });
+    };
+    const capability = {
+        ready,
+        permits: (consumer) => Effect.suspend(() => {
+            const existing = permits.get(consumer.queue.name);
+            if (existing !== undefined) {
+                if (existing.concurrency !== consumer.localConcurrency) {
+                    return Effect.fail(new JobWorkerConfigurationError({ field: "consumer" }));
+                }
+                return Effect.succeed(existing.semaphore);
+            }
+            // Lookup/create/register is synchronous: no fiber can observe a missing
+            // entry while another first drain is creating this queue's semaphore.
+            const semaphore = Semaphore.makeUnsafe(consumer.localConcurrency);
+            permits.set(consumer.queue.name, {
+                concurrency: consumer.localConcurrency,
+                semaphore
+            });
+            return Effect.succeed(semaphore);
+        }),
+        claim: (queue) => Effect.gen(function* () {
+            yield* ready(queue);
+            // Allocate when the Effect runs, not when it is constructed/reused.
+            const token = yield* Effect.sync(() => globalThis.crypto.randomUUID());
+            const result = yield* bound
+                .claim({
+                queue,
+                supportedCatalog: catalogs.filter((entry) => entry.queue === queue),
+                leaseToken: token
+            })
+                .pipe(Effect.timeoutOrElse({
+                duration: budget,
+                orElse: () => Effect.succeed({ _tag: "Unknown" })
+            }), observe("claim", "dispatch"));
+            if (result._tag === "Empty") {
+                return DispatchResults.Empty();
+            }
+            if (result._tag === "Claimed") {
+                return started(result.claim, token, queue);
+            }
+            const reconciled = yield* bound
+                .reconcileClaim(token)
+                .pipe(Effect.timeout(budget), observe("claim", "reconciliation"));
+            if (reconciled._tag === "Owned") {
+                return started(reconciled.claim, token, queue);
+            }
+            if (reconciled._tag === "InsufficientLease") {
+                if (!Schema.is(JobOwnership)(reconciled.ownership) ||
+                    reconciled.ownership.leaseToken !== token) {
+                    return DispatchResults.Unresolved();
+                }
+                yield* release(reconciled.ownership);
+                // A confirmed release is not proof the queue is empty.
+                return DispatchResults.Unresolved();
+            }
+            return DispatchResults.Unresolved();
+        }).pipe(unavailable),
+        recover: (limit) => Effect.gen(function* () {
+            let recovered = 0;
+            for (let remaining = limit; remaining > 0;) {
+                const batch = Math.min(500, remaining);
+                const count = yield* bound
+                    .recoverExpired(batch)
+                    .pipe(Effect.timeout(budget), observe("recover-expired", "maintenance"));
+                if (!Number.isInteger(count) || count < 0 || count > batch) {
+                    return yield* new JobWorkerUnavailable();
+                }
+                recovered += count;
+                remaining -= batch;
+                if (count < batch) {
+                    break;
+                }
+            }
+            return recovered;
+        }).pipe(unavailable)
+    };
+    return JobWorker.of(Object.freeze({ [WorkerCapability]: capability }));
+});
+export const layer = (store, options) => Layer.effect(JobWorker, make(store, options));
+//# sourceMappingURL=JobWorker.js.map

package/dist/JobWorker.js.map

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

package/dist/JobWorkerRuntime.d.ts

@@ -0,0 +1,18 @@
+import type { JobConsumer } from "./JobConsumer.js";
+export { DrainResults } from "./internal/worker/Results.js";
+export type { DrainResult } from "./internal/worker/Results.js";
+/** Finite drain, sharing per-runtime queue permits across concurrent invocations. */
+export declare const drain: (consumer: JobConsumer) => import("effect/Effect").Effect<{
+    readonly _tag: "Backoff";
+    readonly phase: "claim" | "recovery" | "reconciliation";
+    readonly claimed: number;
+} | {
+    readonly _tag: "Idle";
+    readonly claimed: number;
+    readonly recovered: number;
+} | {
+    readonly _tag: "MoreWork";
+    readonly claimed: number;
+    readonly recovered: number;
+}, import("./JobWorker.js").JobWorkerConfigurationError | import("./JobWorker.js").JobWorkerNotReady, import("./JobWorker.js").JobWorker>;
+//# sourceMappingURL=JobWorkerRuntime.d.ts.map

package/dist/JobWorkerRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobWorkerRuntime.d.ts","sourceRoot":"","sources":["../src/JobWorkerRuntime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAE/D,qFAAqF;AACrF,eAAO,MAAM,KAAK,aAAc,WAAW;;;;;;;;;;;;yIAA+B,CAAA"}

package/dist/JobWorkerRuntime.js

@@ -0,0 +1,5 @@
+import { drainWithOptions } from "./internal/worker/Drain.js";
+export { DrainResults } from "./internal/worker/Results.js";
+/** Finite drain, sharing per-runtime queue permits across concurrent invocations. */
+export const drain = (consumer) => drainWithOptions(consumer);
+//# sourceMappingURL=JobWorkerRuntime.js.map

package/dist/JobWorkerRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobWorkerRuntime.js","sourceRoot":"","sources":["../src/JobWorkerRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAG7D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAG3D,qFAAqF;AACrF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,QAAqB,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAA"}

package/dist/PollingJobWorker.d.ts

@@ -0,0 +1,9 @@
+import { Layer } from "effect";
+import { JobWorker, JobWorkerConfigurationError } from "./JobWorker.js";
+import type { JobPlan } from "./JobConsumer.js";
+export interface PollingJobWorkerOptions {
+    readonly idlePollMillis?: number;
+}
+/** Explicit scoped Node/Bun polling. Imports and constructors start no work. */
+export declare const layerForPlan: (plan: JobPlan, options?: PollingJobWorkerOptions) => Layer.Layer<never, JobWorkerConfigurationError | import("./JobWorker.js").JobWorkerNotReady, JobWorker>;
+//# sourceMappingURL=PollingJobWorker.d.ts.map

package/dist/PollingJobWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PollingJobWorker.d.ts","sourceRoot":"","sources":["../src/PollingJobWorker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,EAAkB,MAAM,QAAQ,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA;AAKvE,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,kBAAkB,CAAA;AAE5D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACjC;AA0CD,gFAAgF;AAChF,eAAO,MAAM,YAAY,SAAU,OAAO,YAAW,uBAAuB,4GAiBzE,CAAA"}

package/dist/PollingJobWorker.js

@@ -0,0 +1,54 @@
+import { Effect, Layer, Random, Schema } from "effect";
+import { JobWorker, JobWorkerConfigurationError } from "./JobWorker.js";
+import { EpochMillis } from "./JobPolicy.js";
+import { observe } from "./JobTelemetry.js";
+import { WorkerCapability } from "./internal/worker/Capability.js";
+import { drainWithOptions } from "./internal/worker/Drain.js";
+const backoffMillis = [1_000, 2_000, 4_000, 8_000, 16_000, 30_000];
+const sleepWithJitter = (millis) => Random.next.pipe(Effect.flatMap((random) => Effect.sleep(Math.max(1, Math.round(millis * (0.8 + random * 0.4))))));
+const loop = (consumer, idlePollMillis) => Effect.gen(function* () {
+    let failures = 0;
+    let recover = true;
+    yield* Effect.whileLoop({
+        while: () => true,
+        body: () => Effect.gen(function* () {
+            const result = yield* drainWithOptions(consumer, { recover }).pipe(observe("polling", "dispatch"));
+            if (result._tag === "Backoff") {
+                if (result.claimed > 0 || (recover && result.phase !== "recovery")) {
+                    failures = 0;
+                }
+                yield* sleepWithJitter(backoffMillis[Math.min(failures, backoffMillis.length - 1)] ?? 30_000).pipe(observe("backoff", "maintenance"));
+                failures = Math.min(failures + 1, backoffMillis.length - 1);
+                recover = result.phase === "recovery";
+            }
+            else {
+                failures = 0;
+                recover = true;
+                if (result._tag === "Idle") {
+                    yield* sleepWithJitter(idlePollMillis);
+                }
+                else {
+                    yield* Effect.yieldNow;
+                }
+            }
+        }),
+        step: () => { }
+    });
+});
+/** Explicit scoped Node/Bun polling. Imports and constructors start no work. */
+export const layerForPlan = (plan, options = {}) => Layer.effectDiscard(Effect.gen(function* () {
+    const idlePollMillis = options.idlePollMillis ?? 1_000;
+    if (!Schema.is(EpochMillis)(idlePollMillis)) {
+        return yield* new JobWorkerConfigurationError({ field: "idlePollMillis" });
+    }
+    const worker = yield* JobWorker;
+    // Validate the WHOLE plan before starting even one child fiber.
+    for (const consumer of plan.consumers) {
+        yield* worker[WorkerCapability].ready(consumer.queue.name);
+        yield* worker[WorkerCapability].permits(consumer);
+    }
+    for (const consumer of plan.consumers) {
+        yield* loop(consumer, idlePollMillis).pipe(Effect.forkScoped);
+    }
+}));
+//# sourceMappingURL=PollingJobWorker.js.map

package/dist/PollingJobWorker.js.map

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