effect-jobs 0.1.0-alpha.0

package/dist/JobId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobId.js","sourceRoot":"","sources":["../src/JobId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,oFAAoF;AACpF,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CACrC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EACnC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAClC,CAAA"}

package/dist/JobIdentity.d.ts

@@ -0,0 +1,54 @@
+import { Schema } from "effect";
+export declare const nameFormat = "^[a-z][a-z0-9.-]*$";
+export declare const QueueName: Schema.String;
+export declare const JobKind: Schema.String;
+export declare const OperationName: Schema.String;
+export declare const SlotName: Schema.String;
+export declare const JobVersion: Schema.Int;
+export declare const CatalogIdentity: Schema.Struct<{
+    readonly queue: Schema.String;
+    readonly kind: Schema.String;
+    readonly version: Schema.Int;
+}>;
+export interface CatalogIdentity<Queue extends string = string, Kind extends string = string, Version extends number = number> {
+    readonly queue: Queue;
+    readonly kind: Kind;
+    readonly version: Version;
+}
+declare const InvalidOperationId_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: "InvalidOperationId";
+} & Readonly<A>;
+export declare class InvalidOperationId extends InvalidOperationId_base<{
+    readonly rule: "unicode-scalars" | "no-nul" | "utf8-length";
+    readonly byteLength?: number;
+}> {
+}
+/** Never echoes the possibly sensitive operation ID. Equality is exact. */
+export declare const validateOperationId: (value: string) => void;
+export declare const OperationId: Schema.String;
+export declare const ProducerIdentity: Schema.Struct<{
+    readonly operation: Schema.String;
+    readonly operationId: Schema.String;
+    readonly slot: Schema.String;
+}>;
+export interface ProducerIdentity<Operation extends string = string, Slot extends string = string> {
+    readonly operation: Operation;
+    readonly operationId: string;
+    readonly slot: Slot;
+}
+declare const JobDeclarationError_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: "JobDeclarationError";
+} & Readonly<A>;
+export declare class JobDeclarationError extends JobDeclarationError_base<{
+    readonly field: "operation" | "slots" | `slots[${number}]`;
+    readonly value?: string;
+    readonly expected: string;
+}> {
+}
+/** Called synchronously by the later producer factory, before returning a declaration. */
+export declare const validateProducerDeclaration: (input: {
+    readonly operation: string;
+    readonly slots: ReadonlyArray<string>;
+}) => void;
+export {};
+//# sourceMappingURL=JobIdentity.d.ts.map

package/dist/JobIdentity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobIdentity.d.ts","sourceRoot":"","sources":["../src/JobIdentity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,MAAM,EAAE,MAAM,QAAQ,CAAA;AAErC,eAAO,MAAM,UAAU,uBAAuB,CAAA;AAW9C,eAAO,MAAM,SAAS,eAAW,CAAA;AACjC,eAAO,MAAM,OAAO,eAAY,CAAA;AAChC,eAAO,MAAM,aAAa,eAAY,CAAA;AACtC,eAAO,MAAM,QAAQ,eAAY,CAAA;AACjC,eAAO,MAAM,UAAU,YAEtB,CAAA;AAED,eAAO,MAAM,eAAe;;;;EAI1B,CAAA;AACF,MAAM,WAAW,eAAe,CAC9B,KAAK,SAAS,MAAM,GAAG,MAAM,EAC7B,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,OAAO,SAAS,MAAM,GAAG,MAAM;IAE/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;;;;AAaD,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,QAAQ,GAAG,aAAa,CAAA;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B,CAAC;CAAG;AAEL,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,UAAW,MAAM,KAAG,IAWnD,CAAA;AAED,eAAO,MAAM,WAAW,eASvB,CAAA;AACD,eAAO,MAAM,gBAAgB;;;;EAI3B,CAAA;AACF,MAAM,WAAW,gBAAgB,CAC/B,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,IAAI,SAAS,MAAM,GAAG,MAAM;IAE5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;CACpB;;;;AAED,qBAAa,mBAAoB,SAAQ,yBAAwC;IAC/E,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,MAAM,GAAG,CAAA;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,CAAC;CAAG;AAEL,0FAA0F;AAC1F,eAAO,MAAM,2BAA2B,UAAW;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACtC,KAAG,IA6BH,CAAA"}

package/dist/JobIdentity.js

@@ -0,0 +1,82 @@
+import { Data, Schema } from "effect";
+export const nameFormat = "^[a-z][a-z0-9.-]*$";
+const namePattern = /^[a-z][a-z0-9.-]*$/u;
+const name = (maximum) => Schema.String.pipe(Schema.check(Schema.isMinLength(1), Schema.isMaxLength(maximum), Schema.isPattern(namePattern)));
+export const QueueName = name(64);
+export const JobKind = name(128);
+export const OperationName = name(128);
+export const SlotName = name(128);
+export const JobVersion = Schema.Int.pipe(Schema.check(Schema.isBetween({ minimum: 1, maximum: 32_767 })));
+export const CatalogIdentity = Schema.Struct({
+    queue: QueueName,
+    kind: JobKind,
+    version: JobVersion
+});
+const utf8 = new TextEncoder();
+const validScalars = (value) => {
+    for (const scalar of value) {
+        const code = scalar.codePointAt(0);
+        if (code >= 0xd800 && code <= 0xdfff) {
+            return false;
+        }
+    }
+    return true;
+};
+export class InvalidOperationId extends Data.TaggedError("InvalidOperationId") {
+}
+/** Never echoes the possibly sensitive operation ID. Equality is exact. */
+export const validateOperationId = (value) => {
+    if (!validScalars(value)) {
+        throw new InvalidOperationId({ rule: "unicode-scalars" });
+    }
+    if (value.includes("\u0000")) {
+        throw new InvalidOperationId({ rule: "no-nul" });
+    }
+    const byteLength = utf8.encode(value).byteLength;
+    if (byteLength < 1 || byteLength > 256) {
+        throw new InvalidOperationId({ rule: "utf8-length", byteLength });
+    }
+};
+export const OperationId = Schema.String.pipe(Schema.check(Schema.makeFilter((value) => {
+    const length = utf8.encode(value).byteLength;
+    return (validScalars(value) && !value.includes("\u0000") && length >= 1 && length <= 256);
+})));
+export const ProducerIdentity = Schema.Struct({
+    operation: OperationName,
+    operationId: OperationId,
+    slot: SlotName
+});
+export class JobDeclarationError extends Data.TaggedError("JobDeclarationError") {
+}
+/** Called synchronously by the later producer factory, before returning a declaration. */
+export const validateProducerDeclaration = (input) => {
+    const expected = `1–128 ASCII characters matching ${nameFormat}`;
+    if (!Schema.is(OperationName)(input.operation)) {
+        throw new JobDeclarationError({
+            field: "operation",
+            value: input.operation,
+            expected
+        });
+    }
+    if (input.slots.length === 0) {
+        throw new JobDeclarationError({
+            field: "slots",
+            expected: "at least one unique slot"
+        });
+    }
+    const seen = new Set();
+    input.slots.forEach((slot, index) => {
+        if (!Schema.is(SlotName)(slot)) {
+            throw new JobDeclarationError({ field: `slots[${index}]`, value: slot, expected });
+        }
+        if (seen.has(slot)) {
+            throw new JobDeclarationError({
+                field: `slots[${index}]`,
+                value: slot,
+                expected: "unique declared slot"
+            });
+        }
+        seen.add(slot);
+    });
+};
+//# sourceMappingURL=JobIdentity.js.map

package/dist/JobIdentity.js.map

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

package/dist/JobLifecycle.d.ts

@@ -0,0 +1,173 @@
+import { Data, Result, Schema } from "effect";
+/** Mechanical source bounds, not new execution-policy limits. */
+export declare const Counter: Schema.Int;
+export declare const LeaseToken: Schema.String;
+export declare const BatchLimit: Schema.Int;
+export declare const JobState: Schema.Literals<readonly ["Pending", "Active", "RetryScheduled", "Completed", "Dead", "Isolated"]>;
+export declare const JobOwnership: Schema.Struct<{
+    readonly jobId: Schema.brand<Schema.String, "effect-jobs/JobId">;
+    readonly leaseToken: Schema.String;
+    readonly leaseExpiresAt: Schema.Int;
+    readonly lifecycleVersion: Schema.Int;
+}>;
+export type JobOwnership = typeof JobOwnership.Type;
+/** Complete durable metadata. Payload validation belongs to the codec, not this Schema. */
+export declare const JobSnapshot: Schema.Struct<{
+    readonly jobId: Schema.brand<Schema.String, "effect-jobs/JobId">;
+    readonly policy: 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;
+        }>]>;
+    }>;
+    readonly state: Schema.Literals<readonly ["Pending", "Active", "RetryScheduled", "Completed", "Dead", "Isolated"]>;
+    readonly availableAt: Schema.Int;
+    readonly updatedAt: Schema.Int;
+    readonly attemptsMade: Schema.Int;
+    readonly stalledCount: Schema.Int;
+    readonly lifecycleVersion: Schema.Int;
+    readonly leaseToken: Schema.NullOr<Schema.String>;
+    readonly leaseExpiresAt: Schema.NullOr<Schema.Int>;
+    readonly completedAt: Schema.NullOr<Schema.Int>;
+    readonly lastFailureCode: Schema.NullOr<Schema.String>;
+}>;
+export type JobSnapshot = typeof JobSnapshot.Type;
+/** Retry uses the first stored policy; callers cannot replace its schedule. */
+export declare const JobFinalization: Schema.Union<readonly [Schema.TaggedStruct<"Complete", {}>, Schema.TaggedStruct<"Retry", {
+    readonly code: Schema.String;
+    readonly notAfter: Schema.optional<Schema.Int>;
+}>, Schema.TaggedStruct<"Dead", {
+    readonly code: Schema.String;
+}>, Schema.TaggedStruct<"Isolate", {
+    readonly code: Schema.String;
+}>]>;
+export type JobFinalization = typeof JobFinalization.Type;
+export declare const JobFinalizations: {
+    readonly $is: <Tag extends "Complete" | "Dead" | "Isolate" | "Retry">(tag: Tag) => (u: unknown) => u is Extract<{
+        readonly _tag: "Complete";
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "Retry";
+        readonly code: string;
+        readonly notAfter?: number | undefined;
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "Dead";
+        readonly code: string;
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "Isolate";
+        readonly code: string;
+    }, {
+        readonly _tag: Tag;
+    }>;
+    readonly $match: {
+        <Cases extends { readonly [Tag in "Complete" | "Dead" | "Isolate" | "Retry"]: (args: Extract<{
+            readonly _tag: "Complete";
+        } | {
+            readonly _tag: "Retry";
+            readonly code: string;
+            readonly notAfter?: number | undefined;
+        } | {
+            readonly _tag: "Dead";
+            readonly code: string;
+        } | {
+            readonly _tag: "Isolate";
+            readonly code: string;
+        }, {
+            readonly _tag: Tag;
+        }>) => any; }>(cases: Cases): (value: {
+            readonly _tag: "Complete";
+        } | {
+            readonly _tag: "Retry";
+            readonly code: string;
+            readonly notAfter?: number | undefined;
+        } | {
+            readonly _tag: "Dead";
+            readonly code: string;
+        } | {
+            readonly _tag: "Isolate";
+            readonly code: string;
+        }) => import("effect/Unify").Unify<ReturnType<Cases["Complete" | "Dead" | "Isolate" | "Retry"]>>;
+        <Cases extends { readonly [Tag in "Complete" | "Dead" | "Isolate" | "Retry"]: (args: Extract<{
+            readonly _tag: "Complete";
+        } | {
+            readonly _tag: "Retry";
+            readonly code: string;
+            readonly notAfter?: number | undefined;
+        } | {
+            readonly _tag: "Dead";
+            readonly code: string;
+        } | {
+            readonly _tag: "Isolate";
+            readonly code: string;
+        }, {
+            readonly _tag: Tag;
+        }>) => any; }>(value: {
+            readonly _tag: "Complete";
+        } | {
+            readonly _tag: "Retry";
+            readonly code: string;
+            readonly notAfter?: number | undefined;
+        } | {
+            readonly _tag: "Dead";
+            readonly code: string;
+        } | {
+            readonly _tag: "Isolate";
+            readonly code: string;
+        }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Complete" | "Dead" | "Isolate" | "Retry"]>>;
+    };
+    readonly Complete: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Complete";
+    }, "_tag">;
+    readonly Dead: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Dead";
+        readonly code: string;
+    }, "_tag">;
+    readonly Isolate: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Isolate";
+        readonly code: string;
+    }, "_tag">;
+    readonly Retry: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Retry";
+        readonly code: string;
+        readonly notAfter?: number | undefined;
+    }, "_tag">;
+};
+declare const JobLifecycleError_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: "JobLifecycleError";
+} & Readonly<A>;
+export declare class JobLifecycleError extends JobLifecycleError_base<{
+    readonly reason: "invalid-snapshot" | "invalid-command" | "arithmetic-bound" | "not-eligible" | "ownership-lost" | "execution-started";
+}> {
+}
+export declare const validateSnapshot: (row: unknown) => Result.Result<JobSnapshot, JobLifecycleError>;
+/** No process clock: adapters supply one DB-time snapshot for the entire atomic write. */
+export declare const addTimestamp: (dbNow: number, millis: number) => Result.Result<number, JobLifecycleError>;
+export declare const isOwned: (row: JobSnapshot, ownership: JobOwnership, dbNow: number) => boolean;
+export declare const usableLease: (row: JobSnapshot, dbNow: number, operationResponseBudgetMillis: number) => boolean;
+export declare const attemptNumber: (row: JobSnapshot) => number;
+/** A plan is not a write. The backend must lock/CAS the input and commit the whole transition atomically. */
+export declare const claim: (input: unknown, leaseToken: string, dbNow: number, operationResponseBudgetMillis: number) => Result.Result<JobSnapshot, JobLifecycleError>;
+export declare const ownershipOf: (row: JobSnapshot) => Result.Result<JobOwnership, JobLifecycleError>;
+export declare const release: (input: unknown, expected: JobOwnership, dbNow: number, phase: "BeforeExecution" | "Executing") => Result.Result<JobSnapshot, JobLifecycleError>;
+export declare const finalize: (input: unknown, expected: JobOwnership, command: JobFinalization, dbNow: number) => Result.Result<JobSnapshot, JobLifecycleError>;
+export declare const recoverExpired: (input: unknown, dbNow: number) => Result.Result<JobSnapshot, JobLifecycleError>;
+/** Only explicit validated single failures are known. Cause/defect/timeout classification is worker-owned. */
+export declare const finalizationFromFailure: (input: unknown) => Result.Result<JobFinalization | null, JobLifecycleError>;
+/** Pure eligibility only; domain reference coordination and atomic deletion remain app/backend obligations. */
+export declare const cleanupEligible: (row: JobSnapshot, dbNow: number) => Result.Result<boolean, JobLifecycleError>;
+export {};
+//# sourceMappingURL=JobLifecycle.d.ts.map

package/dist/JobLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobLifecycle.d.ts","sourceRoot":"","sources":["../src/JobLifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAK7C,iEAAiE;AACjE,eAAO,MAAM,OAAO,YAEnB,CAAA;AACD,eAAO,MAAM,UAAU,eAMtB,CAAA;AACD,eAAO,MAAM,UAAU,YAEtB,CAAA;AACD,eAAO,MAAM,QAAQ,oGAOnB,CAAA;AACF,eAAO,MAAM,YAAY;;;;;EAKvB,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAgBnD,2FAA2F;AAC3F,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBvB,CAAA;AACD,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;AAEjD,+EAA+E;AAC/E,eAAO,MAAM,eAAe;;;;;;;IAQ1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AACzD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAqC,CAAA;;;;AAElE,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC3E,QAAQ,CAAC,MAAM,EACX,kBAAkB,GAClB,iBAAiB,GACjB,kBAAkB,GAClB,cAAc,GACd,gBAAgB,GAChB,mBAAmB,CAAA;CACxB,CAAC;CAAG;AAWL,eAAO,MAAM,gBAAgB,QACtB,OAAO,KACX,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAC0B,CAAA;AAEzE,0FAA0F;AAC1F,eAAO,MAAM,YAAY,UAChB,MAAM,UACL,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAKI,CAAA;AAS9C,eAAO,MAAM,OAAO,QACb,WAAW,aACL,YAAY,SAChB,MAAM,KACZ,OAM+B,CAAA;AAElC,eAAO,MAAM,WAAW,QACjB,WAAW,SACT,MAAM,iCACkB,MAAM,KACpC,OAM8B,CAAA;AAEjC,eAAO,MAAM,aAAa,QAAS,WAAW,KAAG,MAA8B,CAAA;AAE/E,6GAA6G;AAC7G,eAAO,MAAM,KAAK,UACT,OAAO,cACF,MAAM,SACX,MAAM,iCACkB,MAAM,KACpC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,iBAAiB,CA4B3C,CAAA;AAEJ,eAAO,MAAM,WAAW,QACjB,WAAW,KACf,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,iBAAiB,CAQJ,CAAA;AAE5C,eAAO,MAAM,OAAO,UACX,OAAO,YACJ,YAAY,SACf,MAAM,SACN,iBAAiB,GAAG,WAAW,KACrC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAuB3C,CAAA;AAEJ,eAAO,MAAM,QAAQ,UACZ,OAAO,YACJ,YAAY,WACb,eAAe,SACjB,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,iBAAiB,CA0C3C,CAAA;AAEJ,eAAO,MAAM,cAAc,UAClB,OAAO,SACP,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAyB3C,CAAA;AAEJ,8GAA8G;AAC9G,eAAO,MAAM,uBAAuB,UAC3B,OAAO,KACb,MAAM,CAAC,MAAM,CAAC,eAAe,GAAG,IAAI,EAAE,iBAAiB,CAOvD,CAAA;AAEH,+GAA+G;AAC/G,eAAO,MAAM,eAAe,QACrB,WAAW,SACT,MAAM,KACZ,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAmBvC,CAAA"}

package/dist/JobLifecycle.js

@@ -0,0 +1,234 @@
+import { Data, Result, Schema } from "effect";
+import { JobId } from "./JobId.js";
+import { FailureCode, JobFailure } from "./JobFailure.js";
+import { EpochMillis, PersistedJobPolicy, maximumMillis } from "./JobPolicy.js";
+/** Mechanical source bounds, not new execution-policy limits. */
+export const Counter = Schema.Int.pipe(Schema.check(Schema.isBetween({ minimum: 0, maximum: Number.MAX_SAFE_INTEGER })));
+export const LeaseToken = Schema.String.pipe(Schema.check(Schema.isMinLength(1), Schema.isMaxLength(128), Schema.isPattern(/^[0-9a-f-]+$/iu)));
+export const BatchLimit = Schema.Int.pipe(Schema.check(Schema.isBetween({ minimum: 1, maximum: 500 })));
+export const JobState = Schema.Literals([
+    "Pending",
+    "Active",
+    "RetryScheduled",
+    "Completed",
+    "Dead",
+    "Isolated"
+]);
+export const JobOwnership = Schema.Struct({
+    jobId: JobId,
+    leaseToken: LeaseToken,
+    leaseExpiresAt: EpochMillis,
+    lifecycleVersion: Counter
+});
+const SnapshotStruct = Schema.Struct({
+    jobId: JobId,
+    policy: PersistedJobPolicy,
+    state: JobState,
+    availableAt: EpochMillis,
+    updatedAt: EpochMillis,
+    attemptsMade: Counter,
+    stalledCount: Counter,
+    lifecycleVersion: Counter,
+    leaseToken: Schema.NullOr(LeaseToken),
+    leaseExpiresAt: Schema.NullOr(EpochMillis),
+    completedAt: Schema.NullOr(EpochMillis),
+    lastFailureCode: Schema.NullOr(FailureCode)
+});
+/** Complete durable metadata. Payload validation belongs to the codec, not this Schema. */
+export const JobSnapshot = SnapshotStruct.pipe(Schema.check(Schema.makeFilter((row) => row.attemptsMade <= row.policy.maxAttempts &&
+    row.stalledCount <= row.policy.maxStalledCount + 1 &&
+    (row.state === "Active"
+        ? row.leaseToken !== null &&
+            row.leaseExpiresAt !== null &&
+            row.completedAt === null
+        : row.leaseToken === null && row.leaseExpiresAt === null) &&
+    (row.state === "Completed" || row.state === "Dead"
+        ? row.completedAt !== null
+        : row.completedAt === null) &&
+    (!(row.state === "Pending" ||
+        row.state === "RetryScheduled" ||
+        row.state === "Active") ||
+        (row.attemptsMade < row.policy.maxAttempts &&
+            row.stalledCount <= row.policy.maxStalledCount)))));
+/** Retry uses the first stored policy; callers cannot replace its schedule. */
+export const JobFinalization = Schema.Union([
+    Schema.TaggedStruct("Complete", {}),
+    Schema.TaggedStruct("Retry", {
+        code: FailureCode,
+        notAfter: Schema.optional(EpochMillis)
+    }),
+    Schema.TaggedStruct("Dead", { code: FailureCode }),
+    Schema.TaggedStruct("Isolate", { code: FailureCode })
+]);
+export const JobFinalizations = Data.taggedEnum();
+export class JobLifecycleError extends Data.TaggedError("JobLifecycleError") {
+}
+const invalid = (reason) => new JobLifecycleError({ reason });
+const decodeSnapshot = Schema.decodeUnknownResult(JobSnapshot, {
+    onExcessProperty: "error"
+});
+const decodeOwnership = Schema.decodeUnknownResult(JobOwnership, {
+    onExcessProperty: "error"
+});
+const decodeFinalization = Schema.decodeUnknownResult(JobFinalization, {
+    onExcessProperty: "error"
+});
+export const validateSnapshot = (row) => Result.mapError(decodeSnapshot(row), () => invalid("invalid-snapshot"));
+/** No process clock: adapters supply one DB-time snapshot for the entire atomic write. */
+export const addTimestamp = (dbNow, millis) => Schema.is(EpochMillis)(dbNow) &&
+    Schema.is(EpochMillis)(millis) &&
+    millis <= maximumMillis - dbNow
+    ? Result.succeed(dbNow + millis)
+    : Result.fail(invalid("arithmetic-bound"));
+const increment = (n) => n < Number.MAX_SAFE_INTEGER
+    ? Result.succeed(n + 1)
+    : Result.fail(invalid("arithmetic-bound"));
+const validateTime = (dbNow) => Schema.is(EpochMillis)(dbNow)
+    ? Result.succeed(dbNow)
+    : Result.fail(invalid("invalid-command"));
+export const isOwned = (row, ownership, dbNow) => row.state === "Active" &&
+    row.jobId === ownership.jobId &&
+    row.leaseToken === ownership.leaseToken &&
+    row.lifecycleVersion === ownership.lifecycleVersion &&
+    row.leaseExpiresAt === ownership.leaseExpiresAt &&
+    ownership.leaseExpiresAt > dbNow;
+export const usableLease = (row, dbNow, operationResponseBudgetMillis) => Schema.is(EpochMillis)(dbNow) &&
+    Schema.is(EpochMillis)(operationResponseBudgetMillis) &&
+    row.state === "Active" &&
+    row.leaseExpiresAt !== null &&
+    row.leaseExpiresAt - dbNow - row.policy.attemptTimeoutMillis >=
+        operationResponseBudgetMillis;
+export const attemptNumber = (row) => row.attemptsMade + 1;
+/** A plan is not a write. The backend must lock/CAS the input and commit the whole transition atomically. */
+export const claim = (input, leaseToken, dbNow, operationResponseBudgetMillis) => Result.gen(function* () {
+    const row = yield* validateSnapshot(input);
+    yield* validateTime(dbNow);
+    if (!Schema.is(LeaseToken)(leaseToken) ||
+        !Schema.is(EpochMillis)(operationResponseBudgetMillis)) {
+        return yield* Result.fail(invalid("invalid-command"));
+    }
+    if (!(row.state === "Pending" || row.state === "RetryScheduled") ||
+        row.availableAt > dbNow ||
+        row.policy.leaseDurationMillis - row.policy.attemptTimeoutMillis <
+            operationResponseBudgetMillis) {
+        return yield* Result.fail(invalid("not-eligible"));
+    }
+    const leaseExpiresAt = yield* addTimestamp(dbNow, row.policy.leaseDurationMillis);
+    const lifecycleVersion = yield* increment(row.lifecycleVersion);
+    return {
+        ...row,
+        state: "Active",
+        leaseToken,
+        leaseExpiresAt,
+        lifecycleVersion,
+        updatedAt: dbNow
+    };
+});
+export const ownershipOf = (row) => row.state === "Active" && row.leaseToken !== null && row.leaseExpiresAt !== null
+    ? Result.succeed({
+        jobId: row.jobId,
+        leaseToken: row.leaseToken,
+        leaseExpiresAt: row.leaseExpiresAt,
+        lifecycleVersion: row.lifecycleVersion
+    })
+    : Result.fail(invalid("ownership-lost"));
+export const release = (input, expected, dbNow, phase) => Result.gen(function* () {
+    const row = yield* validateSnapshot(input);
+    const ownership = yield* Result.mapError(decodeOwnership(expected), () => invalid("invalid-command"));
+    yield* validateTime(dbNow);
+    if (phase !== "BeforeExecution") {
+        return yield* Result.fail(invalid("execution-started"));
+    }
+    if (!isOwned(row, ownership, dbNow)) {
+        return yield* Result.fail(invalid("ownership-lost"));
+    }
+    const lifecycleVersion = yield* increment(row.lifecycleVersion);
+    return {
+        ...row,
+        state: "Pending",
+        availableAt: dbNow,
+        updatedAt: dbNow,
+        lifecycleVersion,
+        leaseToken: null,
+        leaseExpiresAt: null
+    };
+});
+export const finalize = (input, expected, command, dbNow) => Result.gen(function* () {
+    const row = yield* validateSnapshot(input);
+    const ownership = yield* Result.mapError(decodeOwnership(expected), () => invalid("invalid-command"));
+    const finalization = yield* Result.mapError(decodeFinalization(command), () => invalid("invalid-command"));
+    yield* validateTime(dbNow);
+    if (!isOwned(row, ownership, dbNow)) {
+        return yield* Result.fail(invalid("ownership-lost"));
+    }
+    const lifecycleVersion = yield* increment(row.lifecycleVersion);
+    const attemptsMade = yield* increment(row.attemptsMade);
+    const nextAvailableAt = finalization._tag === "Retry"
+        ? yield* addTimestamp(dbNow, row.policy.retrySchedule.delayMillis)
+        : row.availableAt;
+    const state = finalization._tag === "Complete"
+        ? "Completed"
+        : finalization._tag === "Isolate"
+            ? "Isolated"
+            : finalization._tag === "Dead" ||
+                attemptsMade >= row.policy.maxAttempts ||
+                (finalization.notAfter !== undefined &&
+                    nextAvailableAt >= finalization.notAfter)
+                ? "Dead"
+                : "RetryScheduled";
+    return {
+        ...row,
+        state,
+        attemptsMade,
+        lifecycleVersion,
+        availableAt: nextAvailableAt,
+        updatedAt: dbNow,
+        completedAt: state === "Completed" || state === "Dead" ? dbNow : null,
+        lastFailureCode: finalization._tag === "Complete" ? null : finalization.code,
+        leaseToken: null,
+        leaseExpiresAt: null
+    };
+});
+export const recoverExpired = (input, dbNow) => Result.gen(function* () {
+    const row = yield* validateSnapshot(input);
+    yield* validateTime(dbNow);
+    if (row.state !== "Active" ||
+        row.leaseExpiresAt === null ||
+        row.leaseExpiresAt > dbNow) {
+        return yield* Result.fail(invalid("not-eligible"));
+    }
+    const stalledCount = yield* increment(row.stalledCount);
+    const lifecycleVersion = yield* increment(row.lifecycleVersion);
+    const dead = stalledCount > row.policy.maxStalledCount;
+    return {
+        ...row,
+        state: dead ? "Dead" : "Pending",
+        stalledCount,
+        lifecycleVersion,
+        updatedAt: dbNow,
+        completedAt: dead ? dbNow : null,
+        lastFailureCode: dead ? "stall_limit_exceeded" : null,
+        leaseToken: null,
+        leaseExpiresAt: null
+    };
+});
+/** Only explicit validated single failures are known. Cause/defect/timeout classification is worker-owned. */
+export const finalizationFromFailure = (input) => Result.map(Result.mapError(Schema.decodeUnknownResult(JobFailure, { onExcessProperty: "error" })(input), () => invalid("invalid-command")), (failure) => (failure._tag === "OutcomeUnknown" ? null : failure));
+/** Pure eligibility only; domain reference coordination and atomic deletion remain app/backend obligations. */
+export const cleanupEligible = (row, dbNow) => Result.gen(function* () {
+    const stored = yield* validateSnapshot(row);
+    yield* validateTime(dbNow);
+    if ((stored.state !== "Completed" && stored.state !== "Dead") ||
+        stored.completedAt === null) {
+        return false;
+    }
+    const retention = stored.state === "Completed"
+        ? stored.policy.completedRetention
+        : stored.policy.deadRetention;
+    if (retention._tag === "Forever") {
+        return false;
+    }
+    const expiresAt = yield* addTimestamp(stored.completedAt, retention.millis);
+    return expiresAt <= dbNow;
+});
+//# sourceMappingURL=JobLifecycle.js.map

package/dist/JobLifecycle.js.map

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

package/dist/JobPayload.d.ts

@@ -0,0 +1,18 @@
+import type { Schema } from "effect";
+/**
+ * Marks an application-owned, already-protected JSON representation. Requires an
+ * own fingerprint in the encoded value. This neither proves protection nor seals
+ * or opens data. Encryption and stable fingerprint keys remain application-owned.
+ * The schema may describe any JSON fingerprint; no envelope shape or crypto key
+ * manager is imposed. Unsupported protected mappings fail when the codec runs.
+ */
+declare const protectedPayload: <S extends Schema.Top>(schema: S) => S["Rebuild"];
+export { protectedPayload as protected };
+declare module "effect/Schema" {
+    namespace Annotations {
+        interface Annotations {
+            readonly effectJobsProtectedPayload?: true | undefined;
+        }
+    }
+}
+//# sourceMappingURL=JobPayload.d.ts.map

package/dist/JobPayload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobPayload.d.ts","sourceRoot":"","sources":["../src/JobPayload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEpC;;;;;;GAMG;AACH,QAAA,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM,CAAC,GAAG,UAAU,CAAC,KAAG,CAAC,CAAC,SAAS,CAChB,CAAA;AAEvD,OAAO,EAAE,gBAAgB,IAAI,SAAS,EAAE,CAAA;AAExC,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,WAAW,CAAC;QACpB,UAAU,WAAW;YACnB,QAAQ,CAAC,0BAA0B,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;SACvD;KACF;CACF"}

package/dist/JobPayload.js

@@ -0,0 +1,10 @@
+/**
+ * Marks an application-owned, already-protected JSON representation. Requires an
+ * own fingerprint in the encoded value. This neither proves protection nor seals
+ * or opens data. Encryption and stable fingerprint keys remain application-owned.
+ * The schema may describe any JSON fingerprint; no envelope shape or crypto key
+ * manager is imposed. Unsupported protected mappings fail when the codec runs.
+ */
+const protectedPayload = (schema) => schema.annotate({ effectJobsProtectedPayload: true });
+export { protectedPayload as protected };
+//# sourceMappingURL=JobPayload.js.map

package/dist/JobPayload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobPayload.js","sourceRoot":"","sources":["../src/JobPayload.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,gBAAgB,GAAG,CAAuB,MAAS,EAAgB,EAAE,CACzE,MAAM,CAAC,QAAQ,CAAC,EAAE,0BAA0B,EAAE,IAAI,EAAE,CAAC,CAAA;AAEvD,OAAO,EAAE,gBAAgB,IAAI,SAAS,EAAE,CAAA"}

package/dist/JobPayloadCodec.d.ts

@@ -0,0 +1,14 @@
+import type { JobPayloadEncoder, JobPayloadDecoder } from "./JobContract.js";
+/**
+ * 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 declare const encodeJobPayload: JobPayloadEncoder;
+/** Validates canonical format, bounds, schema and semantic projection before
+ * invoking domain decoding. Consistent projection bytes are not authenticity. */
+export declare const decodeJobPayload: JobPayloadDecoder;
+//# sourceMappingURL=JobPayloadCodec.d.ts.map

package/dist/JobPayloadCodec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobPayloadCodec.d.ts","sourceRoot":"","sources":["../src/JobPayloadCodec.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAElB,MAAM,kBAAkB,CAAA;AAUzB;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,iBAiC7B,CAAA;AAyCF;iFACiF;AACjF,eAAO,MAAM,gBAAgB,EAAE,iBAgD7B,CAAA"}