effect-jobs 0.1.0-alpha.0

package/dist/JobPayloadCodec.js

@@ -0,0 +1,78 @@
+import { Effect, Schema, SchemaAST } from "effect";
+import { JobPayloadCodecError, jobPayloadFormatVersion, maximumJobPayloadBytes, maximumJobSemanticProjectionBytes } from "./JobContract.js";
+import { bytesEqual, canonicalBytes, checkDecodedContainers } from "./internal/codec/CanonicalJson.js";
+import { prepareProjection, project } from "./internal/codec/ProtectedProjection.js";
+const strict = { onExcessProperty: "error" };
+/**
+ * Encodes the validated wire representation, not the decoded domain object.
+ * Structs, arrays, absent optional keys and unions are supported. Domain
+ * transforms must have a JSON encoded side; transforms across protected markers,
+ * recursive/custom shapes, records and tuples fail with invalid-schema.
+ * Each returned buffer is owned independently by this execution. Receivers must
+ * copy buffers before retaining them; readonly properties do not freeze bytes.
+ */
+export const encodeJobPayload = Effect.fnUntraced(function* (schema, payload) {
+    const ast = yield* prepareProjection(schema);
+    yield* checkDecodedContainers(payload);
+    // Check own marker fields before Schema can rebuild inherited properties.
+    yield* project(SchemaAST.toType(schema.ast), payload);
+    const value = yield* Schema.encodeEffect(schema, strict)(payload).pipe(Effect.mapError(() => new JobPayloadCodecError({ reason: "invalid-schema" })));
+    const payloadBytes = yield* canonicalBytes(value, maximumJobPayloadBytes, "payload-too-large");
+    yield* Schema.decodeUnknownEffect(Schema.make(ast), strict)(value).pipe(Effect.mapError(() => new JobPayloadCodecError({ reason: "invalid-schema" })));
+    const projection = yield* project(ast, value);
+    const semanticProjectionBytes = yield* canonicalBytes(projection, maximumJobSemanticProjectionBytes, "projection-too-large", 
+    // The representation envelope is not an application-data depth level.
+    -1);
+    return { formatVersion: jobPayloadFormatVersion, payloadBytes, semanticProjectionBytes };
+});
+const readArtifact = (encoded) => Effect.try({
+    try: () => {
+        if (encoded.formatVersion !== jobPayloadFormatVersion ||
+            !(encoded.payloadBytes instanceof Uint8Array) ||
+            !(encoded.semanticProjectionBytes instanceof Uint8Array)) {
+            throw new JobPayloadCodecError({ reason: "invalid-encoding" });
+        }
+        if (encoded.payloadBytes.byteLength > maximumJobPayloadBytes) {
+            throw new JobPayloadCodecError({ reason: "payload-too-large" });
+        }
+        if (encoded.semanticProjectionBytes.byteLength > maximumJobSemanticProjectionBytes) {
+            throw new JobPayloadCodecError({ reason: "projection-too-large" });
+        }
+        // Snapshot before any application service can yield or mutate retained input.
+        return {
+            payloadBytes: new Uint8Array(encoded.payloadBytes),
+            semanticProjectionBytes: new Uint8Array(encoded.semanticProjectionBytes)
+        };
+    },
+    catch: (error) => error instanceof JobPayloadCodecError
+        ? error
+        : new JobPayloadCodecError({ reason: "invalid-encoding" })
+});
+const parse = (bytes) => Effect.try({
+    try: () => JSON.parse(new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(bytes)),
+    catch: () => new JobPayloadCodecError({ reason: "invalid-encoding" })
+});
+/** Validates canonical format, bounds, schema and semantic projection before
+ * invoking domain decoding. Consistent projection bytes are not authenticity. */
+export const decodeJobPayload = Effect.fnUntraced(function* (schema, encoded) {
+    const snapshot = yield* readArtifact(encoded);
+    const ast = yield* prepareProjection(schema);
+    const value = yield* parse(snapshot.payloadBytes);
+    const payloadBytes = yield* canonicalBytes(value, maximumJobPayloadBytes, "payload-too-large");
+    const suppliedProjection = yield* parse(snapshot.semanticProjectionBytes);
+    const suppliedBytes = yield* canonicalBytes(suppliedProjection, maximumJobSemanticProjectionBytes, "projection-too-large", -1);
+    if (!bytesEqual(payloadBytes, snapshot.payloadBytes) ||
+        !bytesEqual(suppliedBytes, snapshot.semanticProjectionBytes)) {
+        return yield* new JobPayloadCodecError({ reason: "invalid-encoding" });
+    }
+    yield* Schema.decodeUnknownEffect(Schema.make(ast), strict)(value).pipe(Effect.mapError(() => new JobPayloadCodecError({ reason: "invalid-schema" })));
+    const projection = yield* project(ast, value);
+    const projectionBytes = yield* canonicalBytes(projection, maximumJobSemanticProjectionBytes, "projection-too-large", -1);
+    if (!bytesEqual(projectionBytes, snapshot.semanticProjectionBytes)) {
+        return yield* new JobPayloadCodecError({ reason: "projection-mismatch" });
+    }
+    const decoded = yield* Schema.decodeUnknownEffect(schema, strict)(value).pipe(Effect.mapError(() => new JobPayloadCodecError({ reason: "invalid-schema" })));
+    yield* checkDecodedContainers(decoded);
+    return decoded;
+});
+//# sourceMappingURL=JobPayloadCodec.js.map

package/dist/JobPayloadCodec.js.map

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

package/dist/JobPolicy.d.ts

@@ -0,0 +1,50 @@
+import { Duration, Schema } from "effect";
+export declare const maximumMillis = 253402300799999;
+export declare const PositiveMillis: Schema.Int;
+/** Preserve the source's positive, bounded epoch-millisecond boundary. */
+export declare const EpochMillis: Schema.Int;
+export declare const JobRetention: Schema.Union<readonly [Schema.TaggedStruct<"Forever", {}>, Schema.TaggedStruct<"Duration", {
+    readonly millis: Schema.Int;
+}>]>;
+export type JobRetention = typeof JobRetention.Type;
+export declare const FixedDelayV1: Schema.TaggedStruct<"FixedDelayV1", {
+    readonly delayMillis: Schema.Int;
+}>;
+/** Complete version-1 durable representation; never resolve defaults while decoding storage. */
+export declare const PersistedJobPolicy: Schema.Struct<{
+    readonly leaseDurationMillis: Schema.Int;
+    readonly attemptTimeoutMillis: Schema.Int;
+    readonly maxAttempts: Schema.Int;
+    readonly maxStalledCount: Schema.Int;
+    readonly retrySchedule: Schema.TaggedStruct<"FixedDelayV1", {
+        readonly delayMillis: Schema.Int;
+    }>;
+    readonly completedRetention: Schema.Union<readonly [Schema.TaggedStruct<"Forever", {}>, Schema.TaggedStruct<"Duration", {
+        readonly millis: Schema.Int;
+    }>]>;
+    readonly deadRetention: Schema.Union<readonly [Schema.TaggedStruct<"Forever", {}>, Schema.TaggedStruct<"Duration", {
+        readonly millis: Schema.Int;
+    }>]>;
+}>;
+export type JobPolicy = typeof PersistedJobPolicy.Type;
+export interface JobPolicyOptions {
+    readonly leaseDuration?: Duration.Duration;
+    readonly attemptTimeout?: Duration.Duration;
+    readonly retryDelay?: Duration.Duration;
+    readonly maxAttempts?: number;
+    readonly maxStalledCount?: number;
+    readonly completedRetention?: Duration.Duration;
+    readonly deadRetention?: Duration.Duration;
+}
+declare const JobPolicyConfigurationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "JobPolicyConfigurationError";
+} & Readonly<A>;
+export declare class JobPolicyConfigurationError extends JobPolicyConfigurationError_base<{
+    readonly field: keyof JobPolicyOptions;
+    readonly expected: string;
+}> {
+}
+/** Synchronous immutable configuration, like job and producer declarations. */
+export declare const make: (options?: JobPolicyOptions) => JobPolicy;
+export {};
+//# sourceMappingURL=JobPolicy.d.ts.map

package/dist/JobPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobPolicy.d.ts","sourceRoot":"","sources":["../src/JobPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/C,eAAO,MAAM,aAAa,kBAAsB,CAAA;AAChD,eAAO,MAAM,cAAc,YAE1B,CAAA;AACD,0EAA0E;AAC1E,eAAO,MAAM,WAAW,YAAiB,CAAA;AAEzC,eAAO,MAAM,YAAY;;IAGvB,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAEnD,eAAO,MAAM,YAAY;;EAEvB,CAAA;AAcF,gGAAgG;AAChG,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;EAE9B,CAAA;AACD,MAAM,MAAM,SAAS,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAA;IAC1C,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAA;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAA;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAA;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAA;CAC3C;;;;AAED,qBAAa,2BAA4B,SAAQ,iCAE/C;IACA,QAAQ,CAAC,KAAK,EAAE,MAAM,gBAAgB,CAAA;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,CAAC;CAAG;AAgCL,+EAA+E;AAC/E,eAAO,MAAM,IAAI,aAAa,gBAAgB,KAAQ,SA4CrD,CAAA"}

package/dist/JobPolicy.js

@@ -0,0 +1,85 @@
+import { Data, Duration, Schema } from "effect";
+export const maximumMillis = 253_402_300_799_999;
+export const PositiveMillis = Schema.Int.pipe(Schema.check(Schema.isBetween({ minimum: 1, maximum: maximumMillis })));
+/** Preserve the source's positive, bounded epoch-millisecond boundary. */
+export const EpochMillis = PositiveMillis;
+export const JobRetention = Schema.Union([
+    Schema.TaggedStruct("Forever", {}),
+    Schema.TaggedStruct("Duration", { millis: PositiveMillis })
+]);
+export const FixedDelayV1 = Schema.TaggedStruct("FixedDelayV1", {
+    delayMillis: PositiveMillis
+});
+const PolicyStruct = Schema.Struct({
+    leaseDurationMillis: PositiveMillis,
+    attemptTimeoutMillis: PositiveMillis,
+    maxAttempts: Schema.Int.pipe(Schema.check(Schema.isBetween({ minimum: 1, maximum: 100 }))),
+    maxStalledCount: Schema.Int.pipe(Schema.check(Schema.isBetween({ minimum: 0, maximum: 100 }))),
+    retrySchedule: FixedDelayV1,
+    completedRetention: JobRetention,
+    deadRetention: JobRetention
+});
+/** Complete version-1 durable representation; never resolve defaults while decoding storage. */
+export const PersistedJobPolicy = PolicyStruct.pipe(Schema.check(Schema.makeFilter((p) => p.attemptTimeoutMillis < p.leaseDurationMillis)));
+export class JobPolicyConfigurationError extends Data.TaggedError("JobPolicyConfigurationError") {
+}
+const millis = (value, field) => {
+    const n = Duration.match(value, {
+        onMillis: (n) => n,
+        onNanos: (nanos) => nanos % 1000000n === 0n &&
+            nanos > 0n &&
+            nanos <= BigInt(maximumMillis) * 1000000n
+            ? Number(nanos / 1000000n)
+            : NaN,
+        onInfinity: () => Infinity,
+        onNegativeInfinity: () => -Infinity
+    });
+    if (!Schema.is(PositiveMillis)(n)) {
+        throw new JobPolicyConfigurationError({
+            field,
+            expected: `finite integer milliseconds in 1–${maximumMillis}`
+        });
+    }
+    return n;
+};
+const retention = (value, field) => Object.freeze(!Duration.isFinite(value) && Duration.toMillis(value) === Infinity
+    ? { _tag: "Forever" }
+    : { _tag: "Duration", millis: millis(value, field) });
+/** Synchronous immutable configuration, like job and producer declarations. */
+export const make = (options = {}) => {
+    const leaseDurationMillis = millis(options.leaseDuration ?? Duration.seconds(90), "leaseDuration");
+    const attemptTimeoutMillis = millis(options.attemptTimeout ?? Duration.seconds(30), "attemptTimeout");
+    if (attemptTimeoutMillis >= leaseDurationMillis) {
+        throw new JobPolicyConfigurationError({
+            field: "attemptTimeout",
+            expected: "strictly less than leaseDuration"
+        });
+    }
+    const maxAttempts = options.maxAttempts ?? 3;
+    const maxStalledCount = options.maxStalledCount ?? 1;
+    if (!Schema.is(PolicyStruct.fields.maxAttempts)(maxAttempts)) {
+        throw new JobPolicyConfigurationError({
+            field: "maxAttempts",
+            expected: "integer in 1–100"
+        });
+    }
+    if (!Schema.is(PolicyStruct.fields.maxStalledCount)(maxStalledCount)) {
+        throw new JobPolicyConfigurationError({
+            field: "maxStalledCount",
+            expected: "integer in 0–100"
+        });
+    }
+    return Object.freeze({
+        leaseDurationMillis,
+        attemptTimeoutMillis,
+        maxAttempts,
+        maxStalledCount,
+        retrySchedule: Object.freeze({
+            _tag: "FixedDelayV1",
+            delayMillis: millis(options.retryDelay ?? Duration.seconds(5), "retryDelay")
+        }),
+        completedRetention: retention(options.completedRetention ?? Duration.days(90), "completedRetention"),
+        deadRetention: retention(options.deadRetention ?? Duration.infinity, "deadRetention")
+    });
+};
+//# sourceMappingURL=JobPolicy.js.map

package/dist/JobPolicy.js.map

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

package/dist/JobProducer.d.ts

@@ -0,0 +1,14 @@
+import type { ProducerIdentity } from "./JobIdentity.js";
+export interface JobProducer<Operation extends string, Slots extends ReadonlyArray<string>> {
+    readonly operation: Operation;
+    readonly slots: Readonly<Slots>;
+    readonly identity: <const Slot extends Slots[number]>(input: {
+        readonly operationId: string;
+        readonly slot: Slot;
+    }) => ProducerIdentity<Operation, Slot>;
+}
+export declare const make: <const Operation extends string, const Slots extends ReadonlyArray<string>>(options: {
+    readonly operation: Operation;
+    readonly slots: Slots;
+}) => JobProducer<Operation, Slots>;
+//# sourceMappingURL=JobProducer.d.ts.map

package/dist/JobProducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobProducer.d.ts","sourceRoot":"","sources":["../src/JobProducer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD,MAAM,WAAW,WAAW,CAC1B,SAAS,SAAS,MAAM,EACxB,KAAK,SAAS,aAAa,CAAC,MAAM,CAAC;IAEnC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC/B,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE;QAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;KACpB,KAAK,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;CACxC;AAED,eAAO,MAAM,IAAI,GACf,KAAK,CAAC,SAAS,SAAS,MAAM,EAC9B,KAAK,CAAC,KAAK,SAAS,aAAa,CAAC,MAAM,CAAC,WAChC;IACT,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CACtB,KAAG,WAAW,CAAC,SAAS,EAAE,KAAK,CAuB/B,CAAA"}

package/dist/JobProducer.js

@@ -0,0 +1,23 @@
+import { JobDeclarationError, validateOperationId, validateProducerDeclaration } from "./JobIdentity.js";
+export const make = (options) => {
+    validateProducerDeclaration(options);
+    const operation = options.operation;
+    // The copy retains tuple positions without retaining the caller's mutable array.
+    const slots = Object.freeze([...options.slots]);
+    return Object.freeze({
+        operation,
+        slots,
+        identity: (input) => {
+            validateOperationId(input.operationId);
+            if (!slots.includes(input.slot)) {
+                throw new JobDeclarationError({ field: "slots", expected: "a declared slot" });
+            }
+            return Object.freeze({
+                operation,
+                operationId: input.operationId,
+                slot: input.slot
+            });
+        }
+    });
+};
+//# sourceMappingURL=JobProducer.js.map

package/dist/JobProducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobProducer.js","sourceRoot":"","sources":["../src/JobProducer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,kBAAkB,CAAA;AAezB,MAAM,CAAC,MAAM,IAAI,GAAG,CAGlB,OAGD,EAAiC,EAAE;IAClC,2BAA2B,CAAC,OAAO,CAAC,CAAA;IACpC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;IACnC,iFAAiF;IACjF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAA+B,CAAA;IAC7E,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS;QACT,KAAK;QACL,QAAQ,EAAE,CAAmC,KAG5C,EAAqC,EAAE;YACtC,mBAAmB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;YACtC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,mBAAmB,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAA;YAChF,CAAC;YACD,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,SAAS;gBACT,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC,CAAA;QACJ,CAAC;KACF,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/JobQueue.d.ts

@@ -0,0 +1,16 @@
+declare const JobQueueTypeId: unique symbol;
+export interface JobQueue<Name extends string = string> {
+    readonly [JobQueueTypeId]: typeof JobQueueTypeId;
+    readonly name: Name;
+}
+declare const InvalidJobQueue_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "InvalidJobQueue";
+} & Readonly<A>;
+export declare class InvalidJobQueue extends InvalidJobQueue_base<{
+    readonly expected: string;
+}> {
+}
+/** Logical configuration only; creates no storage or worker. */
+export declare const make: <const Name extends string>(name: Name) => JobQueue<Name>;
+export {};
+//# sourceMappingURL=JobQueue.d.ts.map

package/dist/JobQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobQueue.d.ts","sourceRoot":"","sources":["../src/JobQueue.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,cAAc,EAAE,OAAO,MAAuC,CAAA;AAEpE,MAAM,WAAW,QAAQ,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;IACpD,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAE,OAAO,cAAc,CAAA;IAChD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;CACpB;;;;AAED,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,CAAC;CAAG;AAEL,gEAAgE;AAChE,eAAO,MAAM,IAAI,GAAI,KAAK,CAAC,IAAI,SAAS,MAAM,QAAQ,IAAI,KAAG,QAAQ,CAAC,IAAI,CAQzE,CAAA"}

package/dist/JobQueue.js

@@ -0,0 +1,16 @@
+import { Data, Schema } from "effect";
+import { QueueName } from "./JobIdentity.js";
+const JobQueueTypeId = Symbol("effect-jobs/JobQueue");
+export class InvalidJobQueue extends Data.TaggedError("InvalidJobQueue") {
+}
+/** Logical configuration only; creates no storage or worker. */
+export const make = (name) => {
+    if (!Schema.is(QueueName)(name)) {
+        throw new InvalidJobQueue({
+            expected: "1–64 ASCII characters matching ^[a-z][a-z0-9.-]*$"
+        });
+    }
+    const queue = { [JobQueueTypeId]: JobQueueTypeId, name };
+    return Object.freeze(queue);
+};
+//# sourceMappingURL=JobQueue.js.map

package/dist/JobQueue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobQueue.js","sourceRoot":"","sources":["../src/JobQueue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE5C,MAAM,cAAc,GAAkB,MAAM,CAAC,sBAAsB,CAAC,CAAA;AAOpE,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAErE;CAAG;AAEL,gEAAgE;AAChE,MAAM,CAAC,MAAM,IAAI,GAAG,CAA4B,IAAU,EAAkB,EAAE;IAC5E,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,eAAe,CAAC;YACxB,QAAQ,EAAE,mDAAmD;SAC9D,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,KAAK,GAAmB,EAAE,CAAC,cAAc,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAA;IACxE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC7B,CAAC,CAAA"}

package/dist/JobRegistry.d.ts

@@ -0,0 +1,37 @@
+import { Context, Effect, Layer } from "effect";
+import type { EncodedJobPayload, HandlerContext, JobPayloadCodecError } from "./JobContract.js";
+import type { JobFailure } from "./JobFailure.js";
+import type { CatalogIdentity } from "./JobIdentity.js";
+export interface JobHandler {
+    readonly catalog: CatalogIdentity;
+    /** Decodes first; services were captured by the definition's handler Layer. */
+    readonly execute: (encoded: EncodedJobPayload, context: HandlerContext) => Effect.Effect<void, JobFailure | JobPayloadCodecError>;
+}
+declare const DuplicateJobHandler_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "DuplicateJobHandler";
+} & Readonly<A>;
+export declare class DuplicateJobHandler extends DuplicateJobHandler_base<CatalogIdentity> {
+    get message(): string;
+}
+declare const DuplicateJobCatalogEntry_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "DuplicateJobCatalogEntry";
+} & Readonly<A>;
+export declare class DuplicateJobCatalogEntry extends DuplicateJobCatalogEntry_base<CatalogIdentity> {
+    get message(): string;
+}
+export interface JobRegistryService {
+    readonly install: (handler: JobHandler) => Effect.Effect<void, DuplicateJobHandler>;
+    readonly find: (catalog: CatalogIdentity) => JobHandler | undefined;
+}
+declare const JobRegistry_base: Context.ServiceClass<JobRegistry, "effect-jobs/JobRegistry", JobRegistryService>;
+export declare class JobRegistry extends JobRegistry_base {
+}
+/** Each Layer build owns its registry; imports and construction start no fibers. */
+export declare const layer: Layer.Layer<JobRegistry, never, never>;
+export interface CatalogEntry {
+    readonly catalog: CatalogIdentity;
+}
+/** Preserve definition types; validate duplicate identities without a global catalog. */
+export declare const catalog: <const Entries extends ReadonlyArray<CatalogEntry>>(...entries: Entries) => Effect.Effect<Readonly<Entries>, DuplicateJobCatalogEntry>;
+export {};
+//# sourceMappingURL=JobRegistry.d.ts.map

package/dist/JobRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobRegistry.d.ts","sourceRoot":"","sources":["../src/JobRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAQ,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AACrD,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACrB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,CAChB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,cAAc,KACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,oBAAoB,CAAC,CAAA;CAC5D;;;;AAED,qBAAa,mBAAoB,SAAQ,yBAEvC,eAAe,CAAC;IAChB,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF;;;;AAED,qBAAa,wBAAyB,SAAQ,8BAE5C,eAAe,CAAC;IAChB,IAAa,OAAO,IAAI,MAAM,CAE7B;CACF;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAA;IACnF,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,UAAU,GAAG,SAAS,CAAA;CACpE;;AAED,qBAAa,WAAY,SAAQ,gBAEhC;CAAG;AAKJ,oFAAoF;AACpF,eAAO,MAAM,KAAK,wCAmBhB,CAAA;AAEF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAClC;AAED,yFAAyF;AACzF,eAAO,MAAM,OAAO,GAAI,KAAK,CAAC,OAAO,SAAS,aAAa,CAAC,YAAY,CAAC,cAC3D,OAAO,KAClB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAWxD,CAAA"}

package/dist/JobRegistry.js

@@ -0,0 +1,47 @@
+import { Context, Data, Effect, Layer } from "effect";
+export class DuplicateJobHandler extends Data.TaggedError("DuplicateJobHandler") {
+    get message() {
+        return `Handler already installed for ${this.queue}/${this.kind}@${this.version}; install one handler per catalog entry`;
+    }
+}
+export class DuplicateJobCatalogEntry extends Data.TaggedError("DuplicateJobCatalogEntry") {
+    get message() {
+        return `Duplicate catalog entry ${this.queue}/${this.kind}@${this.version}; use a unique queue/kind/version`;
+    }
+}
+export class JobRegistry extends Context.Service()("effect-jobs/JobRegistry") {
+}
+const key = (catalog) => `${catalog.queue}\u0000${catalog.kind}\u0000${catalog.version}`;
+/** Each Layer build owns its registry; imports and construction start no fibers. */
+export const layer = Layer.sync(JobRegistry, () => {
+    const handlers = new Map();
+    return JobRegistry.of({
+        install: (handler) => Effect.suspend(() => {
+            const catalogKey = key(handler.catalog);
+            if (handlers.has(catalogKey)) {
+                return Effect.fail(new DuplicateJobHandler(handler.catalog));
+            }
+            const catalog = Object.freeze({
+                queue: handler.catalog.queue,
+                kind: handler.catalog.kind,
+                version: handler.catalog.version
+            });
+            handlers.set(catalogKey, Object.freeze({ catalog, execute: handler.execute }));
+            return Effect.void;
+        }),
+        find: (catalog) => handlers.get(key(catalog))
+    });
+});
+/** Preserve definition types; validate duplicate identities without a global catalog. */
+export const catalog = (...entries) => Effect.suspend(() => {
+    const seen = new Set();
+    for (const entry of entries) {
+        const catalogKey = key(entry.catalog);
+        if (seen.has(catalogKey)) {
+            return Effect.fail(new DuplicateJobCatalogEntry(entry.catalog));
+        }
+        seen.add(catalogKey);
+    }
+    return Effect.succeed(Object.freeze([...entries]));
+});
+//# sourceMappingURL=JobRegistry.js.map

package/dist/JobRegistry.js.map

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