async-lube 2.0.0 → 2.1.0

package/src/durable/error.js

@@ -33,14 +33,25 @@ const error_types = new Map(
 export function error_from(info) {
 	const error = /** @type {Error & Record<string, unknown>} */(Error(info.message))/**/
 	const type = error_types.get(info.name)
-	if (type) Object.setPrototypeOf(error, type.prototype)
-	if (error.name != info.name) error.name = info.name
+	if (type) {
+		Object.setPrototypeOf(error, type.prototype)
+	}
+	if (error.name != info.name) {
+		error.name = info.name
+	}
 	for (const key of Object.keys(info)) {
-		if (key != "cause" && key != "message" && key != "name") error[key] = copy(info[key])
+		if (key != "cause" && key != "message" && key != "name") {
+			error[key] = copy(info[key])
+		}
+	}
+	if (info.cause) {
+		error.cause = error_from(info.cause)
+	} else if (info.name == "CancelError") {
+		error.cause = info.message
+	}
+	if (info.name != "HttpError") {
+		return error
 	}
-	if (info.cause) error.cause = error_from(info.cause)
-	else if (info.name == "CancelError") error.cause = info.message
-	if (info.name != "HttpError") return error
 	const { headers: pairs, status, statusText } = info
 	const headers = new Headers(
 		/** @type {[string, string][]} */(pairs ?? [])/**/
@@ -66,7 +77,9 @@ export function error_from(info) {
  * @returns {unknown}
  */
 export function error_of(saved) {
-	if (saved.status == "cancelled" && !saved.error) return new CancelError("Cancelled")
+	if (saved.status == "cancelled" && !saved.error) {
+		return new CancelError("Cancelled")
+	}
 	return error_from(
 		saved.error ?? {
 			message: "The run failed",
@@ -80,9 +93,11 @@ export function error_of(saved) {
  * @returns {SavedError}
  */
 export function saved_error(error, seen = []) {
-	if (!(error instanceof Error)) return {
-		message: String(error),
-		name: "Error"
+	if (!(error instanceof Error)) {
+		return {
+			message: String(error),
+			name: "Error"
+		}
 	}
 	seen.push(error)
 	/** @type {SavedError} */
@@ -93,12 +108,19 @@ export function saved_error(error, seen = []) {
 	const fields = /** @type {Error & Record<string, unknown>} */(error)/**/
 	for (const key of Object.keys(error)) {
 		const value = fields[key]
-		if (key == "cause" || key == "message" || key == "name" || key == "stack" || value === void 0) continue
-		if (value instanceof Headers) saved[key] = [ ...value ]
-		else if (!json_problem(value)) saved[key] = copy(value)
+		if (key == "cause" || key == "message" || key == "name" || key == "stack" || value === void 0) {
+			continue
+		}
+		if (value instanceof Headers) {
+			saved[key] = [ ...value ]
+		} else if (!json_problem(value)) {
+			saved[key] = copy(value)
+		}
 	}
 	const { cause } = error
-	if (cause instanceof Error && !seen.includes(cause)) saved.cause = saved_error(cause, seen)
+	if (cause instanceof Error && !seen.includes(cause)) {
+		saved.cause = saved_error(cause, seen)
+	}
 	return saved
 }
 /**
@@ -120,6 +142,8 @@ export function store_error(error) {
 export function timeout_error(entry, wait_options) {
 	const { timeout, until } = wait_options
 	const error = new TimeoutError(timeout ?? 0)
-	if (until != null && entry.until == until) error.message = `Timed out at ${new Date(until).toISOString()}`
+	if (until != null && entry.until == until) {
+		error.message = `Timed out at ${new Date(until).toISOString()}`
+	}
 	return error
 }

package/src/durable/index.js

@@ -47,15 +47,21 @@ export function durable(store, fn, options = {}) {
 	const idle_ms = options.idle ?? 1000
 	const lease_ms = options.lease ?? 30000
 	const poll_ms = options.poll ?? 500
-	if (!(typeof idle_ms == "number" && idle_ms >= 0)) throw TypeError(
-		"The idle of durable() must be a non-negative number of milliseconds"
-	)
-	if (!(Number.isFinite(lease_ms) && lease_ms > 0)) throw TypeError(
-		"The lease of durable() must be a positive number of milliseconds"
-	)
-	if (!(Number.isFinite(poll_ms) && poll_ms > 0)) throw TypeError(
-		"The poll of durable() must be a positive number of milliseconds"
-	)
+	if (!(typeof idle_ms == "number" && idle_ms >= 0)) {
+		throw TypeError(
+			"The idle of durable() must be a non-negative number of milliseconds"
+		)
+	}
+	if (!(Number.isFinite(lease_ms) && lease_ms > 0)) {
+		throw TypeError(
+			"The lease of durable() must be a positive number of milliseconds"
+		)
+	}
+	if (!(Number.isFinite(poll_ms) && poll_ms > 0)) {
+		throw TypeError(
+			"The poll of durable() must be a positive number of milliseconds"
+		)
+	}
 	/** @type {DurableWorker} */
 	const d = {
 		fn: /** @type {DurableWorker["fn"]} */(fn)/**/,
@@ -101,7 +107,9 @@ export function durable(store, fn, options = {}) {
 		) => enter(d, key, input, "start"),
 		stop() {
 			d.halted = true
-			for (const stop of [ ...d.stoppers ]) stop()
+			for (const stop of [ ...d.stoppers ]) {
+				stop()
+			}
 			for (const key of [ ...d.watchers.keys() ]) {
 				settle(
 					d,

package/src/durable/journal.js

@@ -11,9 +11,11 @@ export function entry_of(execution, name, type) {
 	const { journal } = execution.saved
 	const entry = journal[index]
 	if (entry) {
-		if (entry.name != name || entry.type != type) throw Error(
-			`The run "${execution.key}" changed: step ${index + 1} was "${entry.name}", now "${name}"`
-		)
+		if (entry.name != name || entry.type != type) {
+			throw Error(
+				`The run "${execution.key}" changed: step ${index + 1} was "${entry.name}", now "${name}"`
+			)
+		}
 		return entry
 	}
 	/** @type {JournalEntry} */
@@ -58,18 +60,25 @@ export function rewind(execution, error) {
 		seen.add(cause)
 		const failure = execution.failures.get(cause)
 		if (failure) {
-			if (execution.cursor > failure.reached) return
+			if (execution.cursor > failure.reached) {
+				return
+			}
 			const { saved } = execution
-			const index = saved.journal.indexOf(failure.entry)
-			if (index < 0) return
-			for (const later of saved.journal.splice(index).reverse()) {
-				if (later.type != "wait" || !later.done || later.timed_out) continue
+			for (const later of saved.journal.splice(
+				saved.journal.indexOf(failure.entry)
+			).reverse()) {
+				if (later.type != "wait" || !later.done || later.timed_out) {
+					continue
+				}
 				const events = saved.events ??= {}
-				;(events[later.name] ??= []).unshift({ at: 0, value: later.value })
+				const queue = events[later.name] ??= []
+				queue.unshift({ at: 0, value: later.value })
 			}
 			return
 		}
-		if (!(cause instanceof Error)) return
+		if (!(cause instanceof Error)) {
+			return
+		}
 		cause = cause.cause
 	}
 }
@@ -81,7 +90,9 @@ export function rewind(execution, error) {
  */
 export function take_waiter(execution, name, at) {
 	const list = execution.waiters.get(name)
-	if (!list) return
+	if (!list) {
+		return
+	}
 	const index = list.findIndex(
 		waiter => waiter.entry.until == null || at <= waiter.entry.until
 	)
@@ -93,8 +104,12 @@ export function take_waiter(execution, name, at) {
  * @returns {void}
  */
 export function unblock(execution, waiter) {
-	if (!waiter.block) return
-	const index = execution.blocked.indexOf(waiter.block)
-	if (index >= 0) execution.blocked.splice(index, 1)
+	if (!waiter.block) {
+		return
+	}
+	execution.blocked.splice(
+		execution.blocked.indexOf(waiter.block),
+		1
+	)
 	waiter.block = void 0
 }

package/src/durable/json.js

@@ -13,13 +13,19 @@ export function copy(value) {
  * @returns {string | undefined}
  */
 export function json_problem(value) {
-	if (value === void 0) return
+	if (value === void 0) {
+		return
+	}
 	/** @type {(number | string)[]} */
 	const path = []
 	const problem = json_problem_at(value, path, [])
-	if (!problem) return
+	if (!problem) {
+		return
+	}
 	let at = ""
-	for (const part of path) at += typeof part == "number" ? `[${part}]` : `.${part}`
+	for (const part of path) {
+		at += typeof part == "number" ? `[${part}]` : `.${part}`
+	}
 	return at ? `${problem} at ${at}` : problem
 }
 /**
@@ -38,20 +44,27 @@ function json_problem_at(value, path, parents) {
 	case "number": return Number.isFinite(value) ? void 0 : String(value)
 	case "undefined": return "undefined"
 	}
-	if (value === null) return
-	if (parents.includes(value)) return "a circular reference"
+	if (value === null) {
+		return
+	}
+	if (parents.includes(value)) {
+		return "a circular reference"
+	}
 	if (Array.isArray(value)) {
 		parents.push(value)
 		for (let index = 0; index < value.length; index++) {
 			path.push(index)
 			const problem = json_problem_at(value[index], path, parents)
-			if (problem) return problem
+			if (problem) {
+				return problem
+			}
 			path.pop()
 		}
 		parents.pop()
 		return
 	}
-	const prototype = /** @type {{ constructor?: unknown } | null} */(Object.getPrototypeOf(value))/**/
+	/** @type {{ constructor?: unknown } | null} */
+	const prototype = Object.getPrototypeOf(value)
 	if (prototype && Object.getPrototypeOf(prototype)) {
 		const { constructor } = prototype
 		return `an instance of ${typeof constructor == "function" && constructor.name || "a class"}`
@@ -60,10 +73,14 @@ function json_problem_at(value, path, parents) {
 	const record = /** @type {Record<string, unknown>} */(value)/**/
 	for (const key of Object.keys(record)) {
 		const item = record[key]
-		if (item === void 0) continue
+		if (item === void 0) {
+			continue
+		}
 		path.push(key)
 		const problem = json_problem_at(item, path, parents)
-		if (problem) return problem
+		if (problem) {
+			return problem
+		}
 		path.pop()
 	}
 	parents.pop()

package/src/durable/lease.js

@@ -12,7 +12,9 @@ export const SUSPENDED = Symbol("suspended")
  * @returns {void}
  */
 export function check_halted(d) {
-	if (d.halted) throw new CancelError("The worker stopped")
+	if (d.halted) {
+		throw new CancelError("The worker stopped")
+	}
 }
 /**
  * @param {DurableWorker} d
@@ -37,7 +39,9 @@ export async function claim(d, key, saved, input) {
 		}
 		next.status = "failed"
 	} else {
-		if (next.status == "pending") next.input = copy(input)
+		if (next.status == "pending") {
+			next.input = copy(input)
+		}
 		next.lease = Date.now() + d.lease_ms
 		next.owner = d.owner
 		next.revision = d.revision
@@ -59,7 +63,9 @@ export function expiring(d, execution) {
  * @returns {boolean}
  */
 export function is_due(d, saved) {
-	if (saved.status == "running") return is_free(d, saved)
+	if (saved.status == "running") {
+		return is_free(d, saved)
+	}
 	return (saved.status == "sleeping" || saved.status == "waiting") && saved.wake != null && saved.wake <= Date.now()
 }
 /**
@@ -76,7 +82,9 @@ function is_free(d, saved) {
  * @returns {void}
  */
 export function lose(execution, reason) {
-	if (execution.lost) return
+	if (execution.lost) {
+		return
+	}
 	execution.lost = true
 	execution.controller.abort(reason)
 	execution.interrupt(LOST)
@@ -86,7 +94,9 @@ export function lose(execution, reason) {
  * @returns {Promise<never> | undefined}
  */
 export function refuse(execution) {
-	if (!execution.lost && !execution.finished) return
+	if (!execution.lost && !execution.finished) {
+		return
+	}
 	const { signal } = execution.controller
 	return Promise.reject(
 		signal.aborted ? signal.reason : new CancelError("The run left this worker")

package/src/durable/persist.js

@@ -29,7 +29,9 @@ function deliver(execution, item) {
 		0,
 		{ at: item.at, value: item.value }
 	)
-	if (execution.finished) wake_if_sent(saved)
+	if (execution.finished) {
+		wake_if_sent(saved)
+	}
 }
 /**
  * @param {DurableExecution} execution
@@ -37,12 +39,16 @@ function deliver(execution, item) {
  */
 function drain(execution) {
 	const { saved } = execution
-	if (!saved.events || execution.finished) return
+	if (!saved.events || execution.finished) {
+		return
+	}
 	for (const name of Object.keys(saved.events)) {
 		for (;;) {
 			const event = saved.events?.[name]?.[0]
 			const waiter = event && !execution.unsaved.has(event) && take_waiter(execution, name, event.at)
-			if (!event || !waiter) break
+			if (!event || !waiter) {
+				break
+			}
 			take_event(saved, name)
 			give(execution, waiter, event.value)
 			waiter.resolve(copy(event.value))
@@ -55,10 +61,14 @@ function drain(execution) {
  * @returns {Promise<boolean>}
  */
 export async function inbox_read(d, execution) {
-	if (execution.writing) await execution.writing
+	if (execution.writing) {
+		await execution.writing
+	}
 	try {
 		const latest = await load(d.store, execution.key)
-		if (execution.lost || execution.finished) return false
+		if (execution.lost || execution.finished) {
+			return false
+		}
 		return execution.fault === void 0 && (!latest?.inbox?.length || latest.version == execution.saved.version) || await persist(d, execution)
 	} catch (error) {
 		execution.fault = error
@@ -71,7 +81,9 @@ export async function inbox_read(d, execution) {
  * @returns {Promise<boolean>}
  */
 export function persist(d, execution) {
-	if (execution.lost) return Promise.resolve(false)
+	if (execution.lost) {
+		return Promise.resolve(false)
+	}
 	if (execution.writing) {
 		execution.dirty = true
 		return execution.writing
@@ -83,9 +95,13 @@ export function persist(d, execution) {
 				const current = execution.saved
 				const next = snapshot(current)
 				const included = execution.unsaved
-				if (included.size) execution.unsaved = new Set()
+				if (included.size) {
+					execution.unsaved = new Set()
+				}
 				const attempt = ++execution.taken
-				if (next.owner) next.lease = Date.now() + d.lease_ms
+				if (next.owner) {
+					next.lease = Date.now() + d.lease_ms
+				}
 				/** @type {SavedRun | undefined} */
 				let latest
 				let putting = true
@@ -105,16 +121,26 @@ export function persist(d, execution) {
 						continue
 					}
 					putting = false
-					for (const event of included) execution.unsaved.add(event)
+					for (const event of included) {
+						execution.unsaved.add(event)
+					}
 					latest = await load(d.store, execution.key)
 				} catch (error) {
-					for (const event of included) execution.unsaved.add(event)
-					if (putting) execution.tried.push(next)
+					for (const event of included) {
+						execution.unsaved.add(event)
+					}
+					if (putting) {
+						execution.tried.push(next)
+					}
 					execution.fault = error
-					if (expiring(d, execution)) lose(execution, store_error(error))
+					if (expiring(d, execution)) {
+						lose(execution, store_error(error))
+					}
+					return false
+				}
+				if (execution.lost) {
 					return false
 				}
-				if (execution.lost) return false
 				const committed = latest && execution.tried.findLast(
 					tried => same_state(
 						/** @type {SavedRun} */(latest)/**/,
@@ -137,10 +163,12 @@ export function persist(d, execution) {
 				execution.tried = []
 				current.version = latest.version
 				const inbox = latest.inbox ?? []
-				for (let index = execution.absorbed; index < inbox.length; index++) deliver(
-					execution,
-					/** @type {NonNullable<SavedRun["inbox"]>[number]} */(inbox[index])/**/
-				)
+				for (let index = execution.absorbed; index < inbox.length; index++) {
+					deliver(
+						execution,
+						/** @type {NonNullable<SavedRun["inbox"]>[number]} */(inbox[index])/**/
+					)
+				}
 				execution.absorbed = inbox.length
 				execution.dirty = true
 			} while (execution.dirty && !execution.lost)
@@ -158,7 +186,9 @@ export function persist(d, execution) {
  */
 export async function save(d, execution) {
 	while (!await persist(d, execution)) {
-		if (execution.lost) return false
+		if (execution.lost) {
+			return false
+		}
 		await sleep(
 			d.renew_ms,
 			execution.controller.signal
@@ -174,13 +204,21 @@ export async function save(d, execution) {
 export function watch_inbox(d, execution) {
 	execution.inbox_timer ??= setInterval(
 		() => {
-			if (execution.finished || execution.lost || execution.writing) return
+			if (execution.finished || execution.lost || execution.writing) {
+				return
+			}
 			let waiting = false
-			for (const list of execution.waiters.values()) waiting ||= list.length > 0
-			if (!waiting) return
+			for (const list of execution.waiters.values()) {
+				waiting ||= list.length > 0
+			}
+			if (!waiting) {
+				return
+			}
 			void load(d.store, execution.key).then(
 				latest => {
-					if (latest?.inbox?.length && latest.version != execution.saved.version) void persist(d, execution)
+					if (latest?.inbox?.length && latest.version != execution.saved.version) {
+						void persist(d, execution)
+					}
 				},
 				noop
 			)