@vielzeug/postmaster 26.10.15 → 26.10.16

package/dist/postmaster.js

@@ -1,2 +1,491 @@
-import{backoff as e,tapper as t}from"@vielzeug/arsenal";var PostmasterError=class extends Error{constructor(e,t){super(e,t),this.name=new.target.name,Object.setPrototypeOf(this,new.target.prototype)}},PostmasterDisposedError=class extends PostmasterError{},PostmasterJobError=class extends PostmasterError{};function validateRetry(e,t){if(e&&(!Number.isInteger(e.maxAttempts)||e.maxAttempts<1))throw new PostmasterError(`job "${t}" retry.maxAttempts must be a positive integer`)}function validateMigrations(e,t){let n=t.migrate;if(!n)return;let r=Object.keys(n);if(r.length===0)throw new PostmasterError(`job "${e}" migrations must not be empty`);let i=r.map(r=>{let i=Number(r);if(!Number.isInteger(i)||String(i)!==r)throw new PostmasterError(`job "${e}" has invalid migration key "${r}"`);if(i<1||i>=t.version)throw new PostmasterError(`job "${e}" has invalid migration key "${i}" (valid range: 1..${t.version-1})`);if(typeof n[i]!=`function`)throw new PostmasterError(`job "${e}" migration from version ${i} must be a function`);return i}).sort((e,t)=>e-t);for(let t=1;t<i.length;t++)if(i[t]!==i[t-1]+1)throw new PostmasterError(`job "${e}" missing migration from version ${i[t-1]+1}`);if(i.at(-1)!==t.version-1)throw new PostmasterError(`job "${e}" migrations must lead into version ${t.version}`)}function validateJob(e,t){if(!Number.isInteger(t.version)||t.version<1)throw new PostmasterError(`job "${e}" version must be a positive integer`);if(typeof t.execute!=`function`||typeof t.key!=`function`)throw new PostmasterError(`job "${e}" must define execute and key`);validateRetry(t.retry,e),validateMigrations(e,t)}function defineJobs(e){for(let[t,n]of Object.entries(e))validateJob(t,n);return e}function runValidate(e,t){return e?typeof e==`function`?e(t):e.parse(t):t}function asJsonValue(e){let t;try{t=JSON.stringify(e)}catch(e){throw new PostmasterError(`job payload must be JSON-serializable`,{cause:e})}if(t===void 0)throw new PostmasterError(`job payload must be JSON-serializable`);return JSON.parse(t)}function failureFrom(e,t){return e instanceof Error?{message:e.message,name:e.name,occurredAt:t}:{message:String(e),name:`Error`,occurredAt:t}}function isAbortError(e){return e instanceof DOMException&&e.name===`AbortError`}async function claimJob(e,t){let n=await e.findClaimable(t.now);if(!n)return;let r={...n,attempts:n.attempts+1,failure:void 0,leaseExpiresAt:t.now+t.leaseDuration,ownerId:t.ownerId,status:`running`,updatedAt:t.now};return await e.put(r),r}async function completeJob(e,t){let n=await e.get(t.id);return!n||n.status!==`running`||n.ownerId!==t.ownerId?!1:(await e.delete(t.id),!0)}async function releaseJob(e,t){let n=await e.get(t.id);return!n||n.status!==`running`||n.ownerId!==t.ownerId?!1:(await e.put({...n,leaseExpiresAt:void 0,ownerId:void 0,status:`queued`,updatedAt:t.now}),!0)}async function rescheduleJob(e,t){let n=await e.get(t.id);return!n||n.status!==`running`||n.ownerId!==t.ownerId?!1:(await e.put({...n,availableAt:t.availableAt,failure:t.failure,leaseExpiresAt:void 0,ownerId:void 0,status:`queued`,updatedAt:t.now}),!0)}async function deadLetterJob(e,t){let n=await e.get(t.id);return!n||n.status!==`running`||n.ownerId!==t.ownerId?!1:(await e.put({...n,failure:t.failure,leaseExpiresAt:void 0,ownerId:void 0,status:`dead-letter`,updatedAt:t.now}),!0)}async function renewLeaseJob(e,t){let n=await e.get(t.id);return!n||n.status!==`running`||n.ownerId!==t.ownerId?!1:(await e.put({...n,leaseExpiresAt:t.leaseExpiresAt,updatedAt:t.now}),!0)}async function requeueJob(e,t,n){let r=await e.get(t);if(!r)return{status:`not-found`};if(r.status===`running`)return{status:`running`};if(r.status!==`dead-letter`)return{status:`not-dead-letter`};let i={...r,availableAt:n,failure:void 0,status:`queued`,updatedAt:n};return await e.put(i),{entry:toEntry(i),status:`requeued`}}async function removeJob(e,t){let n=await e.get(t);return n?n.status===`running`?{status:`running`}:(await e.delete(t),{id:t,status:`removed`}):{status:`not-found`}}async function enqueueJob(e,t){if(await e.get(t.id))throw new PostmasterJobError(`Postmaster entry "${t.id}" already exists`);await e.put(t)}function toEntry(e){return{attempts:e.attempts,availableAt:e.availableAt,createdAt:e.createdAt,...e.failure?{failure:e.failure}:{},id:e.id,key:e.key,name:e.name,status:e.status,updatedAt:e.updatedAt,version:e.version}}var emptyResult=()=>({completed:0,deadLettered:0,processed:0,retryScheduled:0});function assertLeaseDuration(e){if(!Number.isInteger(e)||e<1e3)throw new PostmasterError(`leaseDuration must be a positive integer of at least 1000ms`)}function assertAvailableAt(e,t){if(e===void 0)return t;if(!Number.isFinite(e)||e<0||!Number.isSafeInteger(e))throw new PostmasterError(`availableAt must be a finite non-negative safe integer`);return e}function createPostmaster(n){let{clock:r=Date.now,jobs:i,leaseDuration:a=3e4,signal:o,store:s}=n;assertLeaseDuration(a);let c=new AbortController,l=crypto.randomUUID(),u=t(),d=!1,f=!1,p,m,h=new Map,g,error=e=>{let t=e instanceof Error?e:Error(String(e));emitTap({error:t,type:`processor-error`})},emitTap=e=>{u.emit(e)},assertLive=()=>{if(d)throw new PostmasterDisposedError(`Postmaster is disposed`)},clearWakeTimer=()=>{m!==void 0&&clearTimeout(m),m=void 0},wake=()=>{clearWakeTimer(),f&&!d&&pump()},schedule=async()=>{if(!f||d)return;let e=await s.transact(e=>e.findNextWake(r()));if(e===void 0)return;let t=Math.max(0,Math.min(e-r(),2147483647));m=setTimeout(wake,t)},resolveJob=e=>{let t=i[e.name];if(!t)throw new PostmasterJobError(`no job definition is registered for "${e.name}"`);return t},deadLetter=async(e,t)=>await s.transact(n=>deadLetterJob(n,{failure:failureFrom(t,r()),id:e.id,now:r(),ownerId:l}))?(emitTap({entry:toEntry({...e,status:`dead-letter`}),type:`dead-lettered`}),{completed:0,deadLettered:1,processed:!0,retryScheduled:0}):(emitTap({id:e.id,type:`lease-lost`}),{completed:0,deadLettered:0,processed:!0,retryScheduled:0}),execute=async(t,n)=>{let i,o;try{if(i=resolveJob(t),t.version>i.version)throw new PostmasterJobError(`job "${t.name}" version ${t.version} is newer than the registered version`);let e=t.payload;if(t.version<i.version){let n=i.migrate;if(!n)throw new PostmasterJobError(`job "${t.name}" has no migrations`);for(let r=t.version;r<i.version;r++){let i=n[r];if(typeof i!=`function`)throw new PostmasterJobError(`job "${t.name}" does not support stored version ${t.version}`);if(e=i(e),e===void 0)throw new PostmasterJobError(`job "${t.name}" migration from version ${r} returned undefined`)}}o=runValidate(i.validate,e)}catch(e){return deadLetter(t,e)}let u=new AbortController,d=AbortSignal.any([c.signal,n,u.signal].filter(e=>e!==void 0)),f=setInterval(()=>{s.transact(e=>renewLeaseJob(e,{id:t.id,leaseExpiresAt:r()+a,now:r(),ownerId:l})).then(e=>{e||(u.abort(),emitTap({id:t.id,type:`lease-lost`}))}).catch(error)},Math.max(1e3,Math.floor(a/2)));emitTap({entry:toEntry(t),type:`started`});try{return await i.execute(o,{attempt:t.attempts,entryId:t.id,key:t.key,signal:d}),d.aborted?(await s.transact(e=>releaseJob(e,{id:t.id,now:r(),ownerId:l})),{completed:0,deadLettered:0,processed:!0,retryScheduled:0}):await s.transact(e=>completeJob(e,{id:t.id,now:r(),ownerId:l}))?(emitTap({entry:toEntry(t),type:`completed`}),{completed:1,deadLettered:0,processed:!0,retryScheduled:0}):(emitTap({id:t.id,type:`lease-lost`}),{completed:0,deadLettered:0,processed:!0,retryScheduled:0})}catch(n){if(d.aborted||isAbortError(n))return await s.transact(e=>releaseJob(e,{id:t.id,now:r(),ownerId:l})),{completed:0,deadLettered:0,processed:!0,retryScheduled:0};let a=!1,o=0;try{if(a=t.attempts<(i.retry?.maxAttempts??1)&&(i.retry?.shouldRetry?.(n,t.attempts)??!0),!a)return deadLetter(t,n);if(o=i.retry?.delay?.(t.attempts-1)??e(t.attempts-1),!Number.isFinite(o)||o<0)throw new PostmasterError(`job "${t.name}" retry delay must be finite and non-negative`)}catch(e){return deadLetter(t,e)}let c=r()+o;return await s.transact(e=>rescheduleJob(e,{availableAt:c,failure:failureFrom(n,r()),id:t.id,now:r(),ownerId:l}))?(emitTap({entry:toEntry({...t,availableAt:c,status:`queued`}),type:`retry-scheduled`}),{completed:0,deadLettered:0,processed:!0,retryScheduled:1}):(emitTap({id:t.id,type:`lease-lost`}),{completed:0,deadLettered:0,processed:!0,retryScheduled:0})}finally{clearInterval(f)}},processNext=async e=>{if(e?.aborted)throw new DOMException(`The operation was aborted`,`AbortError`);if(c.signal.aborted)return{completed:0,deadLettered:0,processed:!1,retryScheduled:0};let t=await s.transact(e=>claimJob(e,{leaseDuration:a,now:r(),ownerId:l}));if(!t)return{completed:0,deadLettered:0,processed:!1,retryScheduled:0};h.set(t.id,t);try{return await execute(t,e)}finally{h.delete(t.id)}},pump=()=>{p||d||(p=(async()=>{for(;(await processNext()).processed&&!d;);await schedule()})().catch(error).finally(()=>{p=void 0}))},_=s.subscribe(wake),externalAbort=()=>{dispose()};o?.addEventListener(`abort`,externalAbort,{once:!0});let dispose=async()=>{if(d)return;d=!0,emitTap({type:`dispose`}),u.clear(),clearWakeTimer(),o?.removeEventListener(`abort`,externalAbort),_(),c.abort();let e=[...h.values()];h.clear(),await Promise.all(e.map(e=>s.transact(t=>releaseJob(t,{id:e.id,now:r(),ownerId:l}))))};return{get disposalSignal(){return c.signal},async dispose(){await dispose()},get disposed(){return d},async enqueue(e,t,n){assertLive();let a=i[e];if(!a)throw new PostmasterJobError(`no job definition is registered for "${e}"`);let o=r(),c=assertAvailableAt(n?.availableAt,o),l=runValidate(a.validate,t),u=a.key(l);if(typeof u!=`string`||u.length===0)throw new PostmasterError(`job "${e}" returned an empty key`);let d={attempts:0,availableAt:c,createdAt:o,id:crypto.randomUUID(),key:u,name:e,payload:asJsonValue(l),status:`queued`,updatedAt:o,version:a.version};await s.transact(e=>enqueueJob(e,d));let f=toEntry(d);return emitTap({entry:f,type:`enqueued`}),wake(),f},flush(e){if(assertLive(),g)return g;clearWakeTimer();let t=(async()=>{await p;let t=emptyResult();try{for(;;){let n=await processNext(e?.signal);if(!n.processed||(t.processed+=1,t.completed+=n.completed,t.deadLettered+=n.deadLettered,t.retryScheduled+=n.retryScheduled,d))return t}}finally{g=void 0,wake()}})();return g=t,t},async list(e){return assertLive(),(await s.list(e)).map(toEntry)},async remove(e){assertLive();let t=await s.transact(t=>removeJob(t,e));return t.status===`removed`&&emitTap({id:e,type:`removed`}),t},async requeue(e){assertLive();let t=await s.transact(t=>requeueJob(t,e,r()));return t.status===`requeued`&&wake(),t},start(){assertLive(),!f&&(f=!0,wake())},async stats(){return assertLive(),s.transact(e=>e.countByStatus())},tap(e,t){return assertLive(),u.tap(e,t)},async[Symbol.asyncDispose](){await dispose()}}}export{PostmasterDisposedError,PostmasterError,PostmasterJobError,createPostmaster,defineJobs};
+import { backoff as e, tapper as t } from "@vielzeug/arsenal";
+//#region src/errors.ts
+var PostmasterError = class extends Error {
+	constructor(e, t) {
+		super(e, t), this.name = new.target.name, Object.setPrototypeOf(this, new.target.prototype);
+	}
+}, PostmasterDisposedError = class extends PostmasterError {}, PostmasterJobError = class extends PostmasterError {};
+//#endregion
+//#region src/definitions.ts
+function validateRetry(e, t) {
+	if (e && (!Number.isInteger(e.maxAttempts) || e.maxAttempts < 1)) throw new PostmasterError(`job "${t}" retry.maxAttempts must be a positive integer`);
+}
+function validateMigrations(e, t) {
+	let n = t.migrate;
+	if (!n) return;
+	let r = Object.keys(n);
+	if (r.length === 0) throw new PostmasterError(`job "${e}" migrations must not be empty`);
+	let i = r.map((r) => {
+		let i = Number(r);
+		if (!Number.isInteger(i) || String(i) !== r) throw new PostmasterError(`job "${e}" has invalid migration key "${r}"`);
+		if (i < 1 || i >= t.version) throw new PostmasterError(`job "${e}" has invalid migration key "${i}" (valid range: 1..${t.version - 1})`);
+		if (typeof n[i] != "function") throw new PostmasterError(`job "${e}" migration from version ${i} must be a function`);
+		return i;
+	}).sort((e, t) => e - t);
+	for (let t = 1; t < i.length; t++) if (i[t] !== i[t - 1] + 1) throw new PostmasterError(`job "${e}" missing migration from version ${i[t - 1] + 1}`);
+	if (i.at(-1) !== t.version - 1) throw new PostmasterError(`job "${e}" migrations must lead into version ${t.version}`);
+}
+function validateJob(e, t) {
+	if (!Number.isInteger(t.version) || t.version < 1) throw new PostmasterError(`job "${e}" version must be a positive integer`);
+	if (typeof t.execute != "function" || typeof t.key != "function") throw new PostmasterError(`job "${e}" must define execute and key`);
+	validateRetry(t.retry, e), validateMigrations(e, t);
+}
+function defineJobs(e) {
+	for (let [t, n] of Object.entries(e)) validateJob(t, n);
+	return e;
+}
+//#endregion
+//#region src/_json.ts
+function runValidate(e, t) {
+	return e ? typeof e == "function" ? e(t) : e.parse(t) : t;
+}
+function asJsonValue(e) {
+	let t;
+	try {
+		t = JSON.stringify(e);
+	} catch (e) {
+		throw new PostmasterError("job payload must be JSON-serializable", { cause: e });
+	}
+	if (t === void 0) throw new PostmasterError("job payload must be JSON-serializable");
+	return JSON.parse(t);
+}
+function failureFrom(e, t) {
+	return e instanceof Error ? {
+		message: e.message,
+		name: e.name,
+		occurredAt: t
+	} : {
+		message: String(e),
+		name: "Error",
+		occurredAt: t
+	};
+}
+function isAbortError(e) {
+	return e instanceof DOMException && e.name === "AbortError";
+}
+//#endregion
+//#region src/store-ops.ts
+async function claimJob(e, t) {
+	let n = await e.findClaimable(t.now);
+	if (!n) return;
+	let r = {
+		...n,
+		attempts: n.attempts + 1,
+		failure: void 0,
+		leaseExpiresAt: t.now + t.leaseDuration,
+		ownerId: t.ownerId,
+		status: "running",
+		updatedAt: t.now
+	};
+	return await e.put(r), r;
+}
+async function completeJob(e, t) {
+	let n = await e.get(t.id);
+	return !n || n.status !== "running" || n.ownerId !== t.ownerId ? !1 : (await e.delete(t.id), !0);
+}
+async function releaseJob(e, t) {
+	let n = await e.get(t.id);
+	return !n || n.status !== "running" || n.ownerId !== t.ownerId ? !1 : (await e.put({
+		...n,
+		leaseExpiresAt: void 0,
+		ownerId: void 0,
+		status: "queued",
+		updatedAt: t.now
+	}), !0);
+}
+async function rescheduleJob(e, t) {
+	let n = await e.get(t.id);
+	return !n || n.status !== "running" || n.ownerId !== t.ownerId ? !1 : (await e.put({
+		...n,
+		availableAt: t.availableAt,
+		failure: t.failure,
+		leaseExpiresAt: void 0,
+		ownerId: void 0,
+		status: "queued",
+		updatedAt: t.now
+	}), !0);
+}
+async function deadLetterJob(e, t) {
+	let n = await e.get(t.id);
+	return !n || n.status !== "running" || n.ownerId !== t.ownerId ? !1 : (await e.put({
+		...n,
+		failure: t.failure,
+		leaseExpiresAt: void 0,
+		ownerId: void 0,
+		status: "dead-letter",
+		updatedAt: t.now
+	}), !0);
+}
+async function renewLeaseJob(e, t) {
+	let n = await e.get(t.id);
+	return !n || n.status !== "running" || n.ownerId !== t.ownerId ? !1 : (await e.put({
+		...n,
+		leaseExpiresAt: t.leaseExpiresAt,
+		updatedAt: t.now
+	}), !0);
+}
+async function requeueJob(e, t, n) {
+	let r = await e.get(t);
+	if (!r) return { status: "not-found" };
+	if (r.status === "running") return { status: "running" };
+	if (r.status !== "dead-letter") return { status: "not-dead-letter" };
+	let i = {
+		...r,
+		availableAt: n,
+		failure: void 0,
+		status: "queued",
+		updatedAt: n
+	};
+	return await e.put(i), {
+		entry: toEntry(i),
+		status: "requeued"
+	};
+}
+async function removeJob(e, t) {
+	let n = await e.get(t);
+	return n ? n.status === "running" ? { status: "running" } : (await e.delete(t), {
+		id: t,
+		status: "removed"
+	}) : { status: "not-found" };
+}
+async function enqueueJob(e, t) {
+	if (await e.get(t.id)) throw new PostmasterJobError(`Postmaster entry "${t.id}" already exists`);
+	await e.put(t);
+}
+function toEntry(e) {
+	return {
+		attempts: e.attempts,
+		availableAt: e.availableAt,
+		createdAt: e.createdAt,
+		...e.failure ? { failure: e.failure } : {},
+		id: e.id,
+		key: e.key,
+		name: e.name,
+		status: e.status,
+		updatedAt: e.updatedAt,
+		version: e.version
+	};
+}
+//#endregion
+//#region src/postmaster.ts
+var emptyResult = () => ({
+	completed: 0,
+	deadLettered: 0,
+	processed: 0,
+	retryScheduled: 0
+});
+function assertLeaseDuration(e) {
+	if (!Number.isInteger(e) || e < 1e3) throw new PostmasterError("leaseDuration must be a positive integer of at least 1000ms");
+}
+function assertAvailableAt(e, t) {
+	if (e === void 0) return t;
+	if (!Number.isFinite(e) || e < 0 || !Number.isSafeInteger(e)) throw new PostmasterError("availableAt must be a finite non-negative safe integer");
+	return e;
+}
+function createPostmaster(n) {
+	let { clock: r = Date.now, jobs: i, leaseDuration: a = 3e4, signal: o, store: s } = n;
+	assertLeaseDuration(a);
+	let c = new AbortController(), l = crypto.randomUUID(), u = t(), d = !1, f = !1, p, m, h = /* @__PURE__ */ new Map(), g, error = (e) => {
+		let t = e instanceof Error ? e : Error(String(e));
+		emitTap({
+			error: t,
+			type: "processor-error"
+		});
+	}, emitTap = (e) => {
+		u.emit(e);
+	}, assertLive = () => {
+		if (d) throw new PostmasterDisposedError("Postmaster is disposed");
+	}, clearWakeTimer = () => {
+		m !== void 0 && clearTimeout(m), m = void 0;
+	}, wake = () => {
+		clearWakeTimer(), f && !d && pump();
+	}, schedule = async () => {
+		if (!f || d) return;
+		let e = await s.transact((e) => e.findNextWake(r()));
+		if (e === void 0) return;
+		let t = Math.max(0, Math.min(e - r(), 2147483647));
+		m = setTimeout(wake, t);
+	}, resolveJob = (e) => {
+		let t = i[e.name];
+		if (!t) throw new PostmasterJobError(`no job definition is registered for "${e.name}"`);
+		return t;
+	}, deadLetter = async (e, t) => await s.transact((n) => deadLetterJob(n, {
+		failure: failureFrom(t, r()),
+		id: e.id,
+		now: r(),
+		ownerId: l
+	})) ? (emitTap({
+		entry: toEntry({
+			...e,
+			status: "dead-letter"
+		}),
+		type: "dead-lettered"
+	}), {
+		completed: 0,
+		deadLettered: 1,
+		processed: !0,
+		retryScheduled: 0
+	}) : (emitTap({
+		id: e.id,
+		type: "lease-lost"
+	}), {
+		completed: 0,
+		deadLettered: 0,
+		processed: !0,
+		retryScheduled: 0
+	}), execute = async (t, n) => {
+		let i, o;
+		try {
+			if (i = resolveJob(t), t.version > i.version) throw new PostmasterJobError(`job "${t.name}" version ${t.version} is newer than the registered version`);
+			let e = t.payload;
+			if (t.version < i.version) {
+				let n = i.migrate;
+				if (!n) throw new PostmasterJobError(`job "${t.name}" has no migrations`);
+				for (let r = t.version; r < i.version; r++) {
+					let i = n[r];
+					if (typeof i != "function") throw new PostmasterJobError(`job "${t.name}" does not support stored version ${t.version}`);
+					if (e = i(e), e === void 0) throw new PostmasterJobError(`job "${t.name}" migration from version ${r} returned undefined`);
+				}
+			}
+			o = runValidate(i.validate, e);
+		} catch (e) {
+			return deadLetter(t, e);
+		}
+		let u = new AbortController(), d = AbortSignal.any([
+			c.signal,
+			n,
+			u.signal
+		].filter((e) => e !== void 0)), f = setInterval(() => {
+			s.transact((e) => renewLeaseJob(e, {
+				id: t.id,
+				leaseExpiresAt: r() + a,
+				now: r(),
+				ownerId: l
+			})).then((e) => {
+				e || (u.abort(), emitTap({
+					id: t.id,
+					type: "lease-lost"
+				}));
+			}).catch(error);
+		}, Math.max(1e3, Math.floor(a / 2)));
+		emitTap({
+			entry: toEntry(t),
+			type: "started"
+		});
+		try {
+			return await i.execute(o, {
+				attempt: t.attempts,
+				entryId: t.id,
+				key: t.key,
+				signal: d
+			}), d.aborted ? (await s.transact((e) => releaseJob(e, {
+				id: t.id,
+				now: r(),
+				ownerId: l
+			})), {
+				completed: 0,
+				deadLettered: 0,
+				processed: !0,
+				retryScheduled: 0
+			}) : await s.transact((e) => completeJob(e, {
+				id: t.id,
+				now: r(),
+				ownerId: l
+			})) ? (emitTap({
+				entry: toEntry(t),
+				type: "completed"
+			}), {
+				completed: 1,
+				deadLettered: 0,
+				processed: !0,
+				retryScheduled: 0
+			}) : (emitTap({
+				id: t.id,
+				type: "lease-lost"
+			}), {
+				completed: 0,
+				deadLettered: 0,
+				processed: !0,
+				retryScheduled: 0
+			});
+		} catch (n) {
+			if (d.aborted || isAbortError(n)) return await s.transact((e) => releaseJob(e, {
+				id: t.id,
+				now: r(),
+				ownerId: l
+			})), {
+				completed: 0,
+				deadLettered: 0,
+				processed: !0,
+				retryScheduled: 0
+			};
+			let a = !1, o = 0;
+			try {
+				if (a = t.attempts < (i.retry?.maxAttempts ?? 1) && (i.retry?.shouldRetry?.(n, t.attempts) ?? !0), !a) return deadLetter(t, n);
+				if (o = i.retry?.delay?.(t.attempts - 1) ?? e(t.attempts - 1), !Number.isFinite(o) || o < 0) throw new PostmasterError(`job "${t.name}" retry delay must be finite and non-negative`);
+			} catch (e) {
+				return deadLetter(t, e);
+			}
+			let c = r() + o;
+			return await s.transact((e) => rescheduleJob(e, {
+				availableAt: c,
+				failure: failureFrom(n, r()),
+				id: t.id,
+				now: r(),
+				ownerId: l
+			})) ? (emitTap({
+				entry: toEntry({
+					...t,
+					availableAt: c,
+					status: "queued"
+				}),
+				type: "retry-scheduled"
+			}), {
+				completed: 0,
+				deadLettered: 0,
+				processed: !0,
+				retryScheduled: 1
+			}) : (emitTap({
+				id: t.id,
+				type: "lease-lost"
+			}), {
+				completed: 0,
+				deadLettered: 0,
+				processed: !0,
+				retryScheduled: 0
+			});
+		} finally {
+			clearInterval(f);
+		}
+	}, processNext = async (e) => {
+		if (e?.aborted) throw new DOMException("The operation was aborted", "AbortError");
+		if (c.signal.aborted) return {
+			completed: 0,
+			deadLettered: 0,
+			processed: !1,
+			retryScheduled: 0
+		};
+		let t = await s.transact((e) => claimJob(e, {
+			leaseDuration: a,
+			now: r(),
+			ownerId: l
+		}));
+		if (!t) return {
+			completed: 0,
+			deadLettered: 0,
+			processed: !1,
+			retryScheduled: 0
+		};
+		h.set(t.id, t);
+		try {
+			return await execute(t, e);
+		} finally {
+			h.delete(t.id);
+		}
+	}, pump = () => {
+		p || d || (p = (async () => {
+			for (; (await processNext()).processed && !d;);
+			await schedule();
+		})().catch(error).finally(() => {
+			p = void 0;
+		}));
+	}, _ = s.subscribe(wake), externalAbort = () => {
+		dispose();
+	};
+	o?.addEventListener("abort", externalAbort, { once: !0 });
+	let dispose = async () => {
+		if (d) return;
+		d = !0, emitTap({ type: "dispose" }), u.clear(), clearWakeTimer(), o?.removeEventListener("abort", externalAbort), _(), c.abort();
+		let e = [...h.values()];
+		h.clear(), await Promise.all(e.map((e) => s.transact((t) => releaseJob(t, {
+			id: e.id,
+			now: r(),
+			ownerId: l
+		}))));
+	};
+	return {
+		get disposalSignal() {
+			return c.signal;
+		},
+		async dispose() {
+			await dispose();
+		},
+		get disposed() {
+			return d;
+		},
+		async enqueue(e, t, n) {
+			assertLive();
+			let a = i[e];
+			if (!a) throw new PostmasterJobError(`no job definition is registered for "${e}"`);
+			let o = r(), c = assertAvailableAt(n?.availableAt, o), l = runValidate(a.validate, t), u = a.key(l);
+			if (typeof u != "string" || u.length === 0) throw new PostmasterError(`job "${e}" returned an empty key`);
+			let d = {
+				attempts: 0,
+				availableAt: c,
+				createdAt: o,
+				id: crypto.randomUUID(),
+				key: u,
+				name: e,
+				payload: asJsonValue(l),
+				status: "queued",
+				updatedAt: o,
+				version: a.version
+			};
+			await s.transact((e) => enqueueJob(e, d));
+			let f = toEntry(d);
+			return emitTap({
+				entry: f,
+				type: "enqueued"
+			}), wake(), f;
+		},
+		flush(e) {
+			if (assertLive(), g) return g;
+			clearWakeTimer();
+			let t = (async () => {
+				await p;
+				let t = emptyResult();
+				try {
+					for (;;) {
+						let n = await processNext(e?.signal);
+						if (!n.processed || (t.processed += 1, t.completed += n.completed, t.deadLettered += n.deadLettered, t.retryScheduled += n.retryScheduled, d)) return t;
+					}
+				} finally {
+					g = void 0, wake();
+				}
+			})();
+			return g = t, t;
+		},
+		async list(e) {
+			return assertLive(), (await s.list(e)).map(toEntry);
+		},
+		async remove(e) {
+			assertLive();
+			let t = await s.transact((t) => removeJob(t, e));
+			return t.status === "removed" && emitTap({
+				id: e,
+				type: "removed"
+			}), t;
+		},
+		async requeue(e) {
+			assertLive();
+			let t = await s.transact((t) => requeueJob(t, e, r()));
+			return t.status === "requeued" && wake(), t;
+		},
+		start() {
+			assertLive(), !f && (f = !0, wake());
+		},
+		async stats() {
+			return assertLive(), s.transact((e) => e.countByStatus());
+		},
+		tap(e, t) {
+			return assertLive(), u.tap(e, t);
+		},
+		async [Symbol.asyncDispose]() {
+			await dispose();
+		}
+	};
+}
+//#endregion
+export { PostmasterDisposedError, PostmasterError, PostmasterJobError, createPostmaster, defineJobs };
+
 //# sourceMappingURL=postmaster.js.map