@plitzi/sdk-interactions 0.38.3 → 0.38.5

package/dist/InteractionsHelper.mjs

@@ -1,30 +1,31 @@
-import e from "./utility/index.mjs";
-import { get as t, omit as n } from "@plitzi/plitzi-ui/helpers";
-import { QueryBuilderEvaluator as r } from "@plitzi/plitzi-ui/QueryBuilder";
-import { pConsole as i } from "@plitzi/sdk-shared/devTools/utils/PlitziConsole";
-import { MAX_PARAM_PASSES as a, resolveStepParam as o } from "@plitzi/sdk-shared/helpers/twigWrapper";
-import { Fragment as s, jsx as c, jsxs as l } from "react/jsx-runtime";
+import { coerceDeclaredParams as e } from "./helpers/coerceDeclaredParams.mjs";
+import t from "./utility/index.mjs";
+import { get as n, omit as r } from "@plitzi/plitzi-ui/helpers";
+import { QueryBuilderEvaluator as i } from "@plitzi/plitzi-ui/QueryBuilder";
+import { pConsole as a } from "@plitzi/sdk-shared/devTools/utils/PlitziConsole";
+import { MAX_PARAM_PASSES as o, resolveStepParam as s } from "@plitzi/sdk-shared/helpers/twigWrapper";
+import { Fragment as c, jsx as l, jsxs as u } from "react/jsx-runtime";
 //#region src/InteractionsHelper.tsx
-var u = 5, d = (e, t, n, r, s) => {
-	if (e === "utility" && s === "twigTemplate") return t;
-	let d = {
+var d = 5, f = (e, t, n, r, i) => {
+	if (e === "utility" && i === "twigTemplate") return t;
+	let c = {
 		...n,
 		...r
 	}, f = (e, t, n) => {
 		if (typeof e == "string") {
-			let { value: n, unresolved: r } = o(e, d);
-			return r && i.warning("interactions", /* @__PURE__ */ l("span", { children: [
+			let { value: n, unresolved: r } = s(e, c);
+			return r && a.warning("interactions", /* @__PURE__ */ u("span", { children: [
 				"Twig token resolution exceeded ",
-				a,
+				o,
 				" passes for ",
-				/* @__PURE__ */ c("b", { children: t }),
+				/* @__PURE__ */ l("b", { children: t }),
 				", leaving unresolved tokens"
 			] }), {
 				param: t,
 				value: n
 			}), n;
 		}
-		return n >= u || typeof e != "object" || !e ? e : Array.isArray(e) ? e.map((e) => f(e, t, n + 1)) : Object.fromEntries(Object.entries(e).map(([e, r]) => [e, f(r, t, n + 1)]));
+		return n >= d || typeof e != "object" || !e ? e : Array.isArray(e) ? e.map((e) => f(e, t, n + 1)) : Object.fromEntries(Object.entries(e).map(([e, r]) => [e, f(r, t, n + 1)]));
 	};
 	return Object.keys(t).reduce((n, r) => {
 		let i = e === "trigger" ? t[r] : f(t[r], r, 0);
@@ -33,132 +34,133 @@ var u = 5, d = (e, t, n, r, s) => {
 			[r]: i
 		};
 	}, {});
-}, f = (e) => typeof e != "function" && typeof e != "symbol" && typeof e != "bigint", p = (e) => Object.fromEntries(Object.entries(e).filter((e) => f(e[1]))), m = (e) => typeof e == "object" && !!e && "then" in e && typeof e.then == "function", h = (n, a = {}, o = {}, s = {}, u = {}) => {
-	let f = [], { id: h, action: g, enabled: _, params: v, elementId: y, type: b, when: x } = n;
-	if (!g || !_) return {
+}, p = (e) => typeof e != "function" && typeof e != "symbol" && typeof e != "bigint", m = (e) => Object.fromEntries(Object.entries(e).filter((e) => p(e[1]))), h = (e) => typeof e == "object" && !!e && "then" in e && typeof e.then == "function", g = (r, o = {}, s = {}, c = {}, d = {}) => {
+	let p = [], { id: g, action: _, enabled: v, params: y, elementId: b, type: x, when: S } = r;
+	if (!_ || !v) return {
 		status: "disabled",
 		result: {},
-		postCallbacks: f
+		postCallbacks: p
 	};
-	let S = p({
+	let C = m({
+		...c,
 		...s,
-		...o,
-		[h]: v
+		[g]: y
 	});
-	if (x && !r(x, S)) return {
+	if (S && !i(S, C)) return {
 		status: "skipped",
 		result: {},
-		postCallbacks: f,
-		whenParams: S
+		postCallbacks: p,
+		whenParams: C
 	};
-	let C = (e) => (i.danger("interactions", /* @__PURE__ */ l("span", { children: ["Interaction node failed ", /* @__PURE__ */ c("b", { children: g })] }), {
+	let w = (e) => (a.danger("interactions", /* @__PURE__ */ u("span", { children: ["Interaction node failed ", /* @__PURE__ */ l("b", { children: _ })] }), {
 		error: e instanceof Error ? e.message : String(e),
-		node: n
+		node: r
 	}), {
 		status: "failed",
 		result: {},
-		postCallbacks: f,
-		whenParams: S
-	}), w;
-	switch (b) {
+		postCallbacks: p,
+		whenParams: C
+	}), T;
+	switch (x) {
 		case "callback":
 		case "globalCallback":
-			if (!y) return i.warning("interactions", /* @__PURE__ */ l("span", { children: [
+			if (!b) return a.warning("interactions", /* @__PURE__ */ u("span", { children: [
 				"Step ",
-				/* @__PURE__ */ c("b", { children: g }),
+				/* @__PURE__ */ l("b", { children: _ }),
 				" names no element, so there is nothing to run it on"
-			] }), { node: n }), {
+			] }), { node: r }), {
 				status: "failed",
 				result: {},
-				postCallbacks: f,
-				whenParams: S
+				postCallbacks: p,
+				whenParams: C
 			};
-			if (w = t(a, `${y}.${g}`), !w) return i.warning("interactions", /* @__PURE__ */ l("span", { children: [
+			if (T = n(o, `${b}.${_}`), !T) return a.warning("interactions", /* @__PURE__ */ u("span", { children: [
 				"Nothing is registered as ",
-				/* @__PURE__ */ c("b", { children: `${y}.${g}` }),
+				/* @__PURE__ */ l("b", { children: `${b}.${_}` }),
 				", so this step did nothing"
 			] }), {
-				node: n,
-				available: Object.keys(t(a, y, {}))
+				node: r,
+				available: Object.keys(n(o, b, {}))
 			}), {
 				status: "failed",
 				result: {},
-				postCallbacks: f,
-				whenParams: S
+				postCallbacks: p,
+				whenParams: C
 			};
 			break;
 		case "utility":
-			w = t(e, g, {});
+			T = n(t, _, {});
 			break;
 		default: return {
 			status: "success",
 			result: {},
-			postCallbacks: f,
-			whenParams: S
+			postCallbacks: p,
+			whenParams: C
 		};
 	}
 	try {
-		let e = {
-			...o,
+		let t = {
 			...s,
-			...d(b, v, o, s, g)
-		}, { callback: t, postCallback: n } = w, r = (t) => (n && f.push({
-			id: h,
-			callback: n,
+			...c,
+			...e(T.params, f(x, y, s, c, _))
+		}, { callback: n, postCallback: r } = T, i = (e) => (r && p.push({
+			id: g,
+			callback: r,
 			params: {
-				...e,
-				[h]: t
+				...t,
+				[g]: e
 			}
 		}), {
 			status: "success",
-			result: t,
-			postCallbacks: f,
-			whenParams: S
-		}), i = t ? t(e, u) : {};
-		return m(i) ? Promise.resolve(i).then(r, C) : r(i);
+			result: e,
+			postCallbacks: p,
+			whenParams: C
+		}), a = n ? n(t, d) : {};
+		return h(a) ? Promise.resolve(a).then(i, w) : i(a);
 	} catch (e) {
-		return C(e);
+		return w(e);
 	}
-}, g = async (e = []) => {
+}, _ = async (e = []) => {
 	let t = {};
-	return await Promise.all(e.reverse().map(async ({ id: e, callback: r, params: i }) => {
-		t[e] = await r?.(n(i, [e]), i[e]);
+	return await Promise.all(e.reverse().map(async ({ id: e, callback: n, params: i }) => {
+		t[e] = await n?.(r(i, [e]), i[e]);
 	})), t;
-}, _ = () => ({}), v = async (e, n = {}, r = {}, a = {}, o = _, s = [], c = {}, l = {}) => {
-	let u = e, d = a;
+}, v = () => ({}), y = async (e, t = {}, r = {}, i = {}, o = v, s = [], c = {}, l = {}) => {
+	let u = e, d = i;
 	for (; u;) {
-		let e = t(n, u.afterNode);
-		if (!e) return s.length > 0 && await g(s), c;
-		let a = i.getTime().valueOf(), f = h(e, r, d, o(), l), { status: p, result: _, postCallbacks: v, whenParams: y } = m(f) ? await f : f;
+		if (l.signal?.aborted) return c;
+		let e = n(t, u.afterNode);
+		if (!e) return s.length > 0 && await _(s), c;
+		let i = a.getTime().valueOf(), f = g(e, r, d, o(), l), p = h(f) ? await f : f, { result: m, postCallbacks: v, whenParams: y } = p, b = p.status === "failed" && l.signal?.aborted ? "skipped" : p.status;
 		c[e.id] = {
 			node: e,
-			status: p,
-			result: _,
+			status: b,
+			result: m,
 			postCallbacks: v,
 			whenParams: y,
-			startTime: a,
-			endTime: i.getTime().valueOf()
+			startTime: i,
+			endTime: a.getTime().valueOf()
 		}, s.push(...v), d = {
 			...d,
-			[e.id]: _
+			[e.id]: m
 		}, u = e;
 	}
 	return c;
-}, y = (e, t, n = {}, r, a) => {
-	let o = i.getTime().valueOf(), u = r === "skipped" ? "skipped" : "success", d = /* @__PURE__ */ l("span", { children: [
+}, b = (e, t, n = {}, r, i) => {
+	let o = a.getTime().valueOf(), s = r === "skipped" ? "skipped" : "success", d = /* @__PURE__ */ u("span", { children: [
 		"Interaction triggered ",
-		/* @__PURE__ */ c("b", { children: `${e.title} [${e.action}]` }),
-		a ? /* @__PURE__ */ l(s, { children: [" on ", /* @__PURE__ */ c("b", { children: a })] }) : null
+		/* @__PURE__ */ l("b", { children: `${e.title} [${e.action}]` }),
+		i ? /* @__PURE__ */ u(c, { children: [" on ", /* @__PURE__ */ l("b", { children: i })] }) : null
 	] }), f = {
 		status: r,
 		node: e,
 		elementId: e.elementId,
-		hostElementId: a,
+		hostElementId: i,
 		nodes: {
 			...n,
 			[e.id]: {
 				node: e,
-				status: u,
+				status: s,
 				result: void 0,
 				postCallbacks: [],
 				startTime: t,
@@ -169,21 +171,24 @@ var u = 5, d = (e, t, n, r, s) => {
 		endTime: o
 	};
 	if (r === "failed") {
-		i.danger("interactions", d, f);
+		a.danger("interactions", d, f);
 		return;
 	}
-	i.info("interactions", d, f);
-}, b = (e) => Object.values(e).some(({ status: e }) => e === "failed") ? "failed" : "completed", x = async (e, t = {}, n = {}, a = {}, o = _, s, c = []) => {
-	let l = i.getTime().valueOf(), { action: u, enabled: d, when: f } = e;
-	if (!u || !d || f && !r(f, p({
+	a.info("interactions", d, f);
+}, x = (e) => Object.values(e).some(({ status: e }) => e === "failed") ? "failed" : "completed", S = async (e, t = {}, n = {}, r = {}, o = v, s, c, l = []) => {
+	let u = a.getTime().valueOf(), { action: d, enabled: f, when: p } = e;
+	if (!d || !f || p && !i(p, m({
 		...o(),
-		...a
+		...r
 	}))) {
-		y(e, l, {}, "skipped", s);
+		b(e, u, {}, "skipped", s);
 		return;
 	}
-	let m = await v(e, t, n, a, o, c, {}, { hostElementId: s });
-	y(e, l, m, b(m), s);
-}, S = { flowTrigger: x };
+	let h = await y(e, t, n, r, o, l, {}, {
+		hostElementId: s,
+		...c ? { signal: c } : {}
+	});
+	b(e, u, h, x(h), s);
+}, C = { flowTrigger: S };
 //#endregion
-export { S as default, x as flowTrigger };
+export { C as default, S as flowTrigger };

package/dist/InteractionsManager.d.ts

@@ -13,6 +13,8 @@ declare class InteractionsManager {
      * event: two flows on one click are two things, and one still running says nothing about the other.
      */
     private flowsRunning;
+    /** The run a `latest` flow is on now, by the same key: what the next firing stops. */
+    private latestRuns;
     lastUpdate: number;
     private listeners;
     constructor(currentPageId?: string, routeParams?: RouteParams, queryParams?: QueryParams);

package/dist/InteractionsManager.mjs

@@ -18,6 +18,7 @@ var s = (e, t) => {
 	subscriptors;
 	callbacksAvailables;
 	flowsRunning = /* @__PURE__ */ new Map();
+	latestRuns = /* @__PURE__ */ new Map();
 	lastUpdate;
 	listeners = /* @__PURE__ */ new Set();
 	constructor(e = "", t = {}, n = {}) {
@@ -35,13 +36,20 @@ var s = (e, t) => {
 			...this.interactionsData,
 			...typeof c == "function" ? c().dataSource : void 0
 		}), u = Object.values(n).filter((e) => e.type === "trigger" && e.action === i && e.enabled && s(e, a));
-		await Promise.all(u.map((t) => this.runFlow(`${r}.${t.id}`, t.whileRunning ?? "skip", () => e(t, n, this.getCallbacksAvailables(), { [t.id]: a }, l, r))));
+		await Promise.all(u.map((t) => this.runFlow(`${r}.${t.id}`, t.whileRunning ?? "skip", (i) => e(t, n, this.getCallbacksAvailables(), { [t.id]: a }, l, r, i))));
 	};
 	runFlow(e, t, n) {
+		if (t === "latest") {
+			this.latestRuns.get(e)?.abort();
+			let t = new AbortController();
+			return this.latestRuns.set(e, t), n(t.signal).finally(() => {
+				this.latestRuns.get(e) === t && this.latestRuns.delete(e);
+			});
+		}
 		let r = this.flowsRunning.get(e);
 		if (t === "parallel") return n();
 		if (r && t === "skip") return Promise.resolve();
-		let i = (r ? r.then(n, n) : n()).finally(() => {
+		let i = (r ? r.then(() => n(), () => n()) : n()).finally(() => {
 			this.flowsRunning.get(e) === i && this.flowsRunning.delete(e);
 		});
 		return this.flowsRunning.set(e, i), i;

package/dist/helpers/coerceDeclaredParams.d.ts

@@ -0,0 +1,11 @@
+import { InteractionCallback } from '@plitzi/sdk-shared';
+/**
+ * A step's params, each as the type its callback DECLARES: a `number` param written `5000` — or bound to text that
+ * says it — arrives as the number, a `boolean` one written `'true'` as `true`, an empty number as nothing at all (so the
+ * component's default applies). Everything else arrives as written.
+ *
+ * The callback declares the type, so the conversion happens once, here, for every action — a plugin's above all, whose
+ * author otherwise wrote `Number(params.interval)` in every callback. Only the step's own params: what the flow and
+ * the page hand along beside them is theirs.
+ */
+export declare const coerceDeclaredParams: (declared: InteractionCallback["params"] | undefined, params: Record<string, unknown>) => Record<string, unknown>;

package/dist/helpers/coerceDeclaredParams.mjs

@@ -0,0 +1,18 @@
+//#region src/helpers/coerceDeclaredParams.ts
+var e = (e, t) => typeof e.type == "function" ? e.type(t) : e.type, t = (e, t) => {
+	if (typeof t != "string") return t;
+	if (e === "number") {
+		let e = t.trim();
+		if (e === "") return;
+		let n = Number(e);
+		return Number.isFinite(n) ? n : t;
+	}
+	return e === "boolean" && (t === "true" || t === "false") ? t === "true" : t;
+}, n = (n, r) => {
+	if (!n) return r;
+	let i = typeof n == "function" ? n(r) : n, a = { ...r };
+	for (let [n, o] of Object.entries(i)) Object.hasOwn(r, n) && (a[n] = t(e(o, r), r[n]));
+	return a;
+};
+//#endregion
+export { n as coerceDeclaredParams };

package/dist/sources/ActionsSource/ActionInteractions.mjs

@@ -85,8 +85,7 @@ var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 			actionId: n,
 			mode: r,
 			input: o
-		}), _ = new AbortController(), v = "";
-		p(g, () => {
+		}), _ = new AbortController(), v = "", T = () => {
 			_.abort(), h(g, {
 				status: "aborted",
 				endedAt: Date.now(),
@@ -95,9 +94,12 @@ var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 				method: "DELETE",
 				credentials: "same-origin"
 			}).catch(() => void 0);
-		});
-		let T = (t) => {
-			m(g), h(g, {
+		};
+		p(g, T);
+		let D = t?.signal;
+		D?.addEventListener("abort", T, { once: !0 });
+		let O = (t) => {
+			D?.removeEventListener("abort", T), m(g), h(g, {
 				endedAt: Date.now(),
 				cancellable: !1,
 				...t
@@ -125,7 +127,7 @@ var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 		}).then(async (e) => {
 			let i = await e.json().catch(() => ({}));
 			if (!e.ok) {
-				w(e.status, i, E), T({
+				w(e.status, i, E), O({
 					status: "failed",
 					...i.runId ? { runId: i.runId } : {},
 					...i.reason ? { reason: i.reason } : {},
@@ -139,7 +141,7 @@ var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 				});
 				return;
 			}
-			T({
+			O({
 				status: i.status === "completed" ? "completed" : "accepted",
 				...i.runId ? { runId: i.runId } : {},
 				...i.output ? { output: i.output } : {},
@@ -162,7 +164,7 @@ var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 				output: i.output ?? {}
 			});
 		}).catch((e) => {
-			T(C(_, e)), a.warning("actions", /* @__PURE__ */ u("span", { children: [
+			O(C(_, e)), a.warning("actions", /* @__PURE__ */ u("span", { children: [
 				"Server action ",
 				/* @__PURE__ */ l("b", { children: n }),
 				" could not be sent"
@@ -205,7 +207,7 @@ var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 					body: s
 				});
 			} catch (e) {
-				return T(C(_, e)), a.warning("actions", /* @__PURE__ */ u("span", { children: [
+				return O(C(_, e)), a.warning("actions", /* @__PURE__ */ u("span", { children: [
 					"Server action ",
 					/* @__PURE__ */ l("b", { children: n }),
 					" could not be reached"
@@ -222,7 +224,7 @@ var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 			}
 			if (!e.ok || !e.body) {
 				let r = await e.json().catch(() => ({}));
-				return w(e.status, r, E), T({
+				return w(e.status, r, E), O({
 					status: "failed",
 					...r.runId ? { runId: r.runId } : {},
 					...r.reason ? { reason: r.reason } : {},
@@ -256,7 +258,7 @@ var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 				}
 				if (e.event === "error") {
 					let r = y(e.data.steps);
-					T({
+					O({
 						status: "failed",
 						...typeof e.data.reason == "string" ? { reason: e.data.reason } : {},
 						...typeof e.data.error == "string" ? { error: e.data.error } : {},
@@ -270,7 +272,7 @@ var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 				}
 				if (e.event === "done") {
 					let r = y(e.data.steps);
-					T({
+					O({
 						status: e.data.status === "completed" ? "completed" : "failed",
 						...e.data.output ? { output: e.data.output } : {},
 						...typeof e.data.error == "string" ? { error: e.data.error } : {},
@@ -284,7 +286,7 @@ var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 			}).catch((e) => {
 				if (_.signal.aborted) return;
 				let o = e instanceof Error ? e.message : String(e);
-				T({
+				O({
 					status: "failed",
 					error: o
 				}), a.warning("actions", /* @__PURE__ */ u("span", { children: [
@@ -309,9 +311,9 @@ var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 				output: {}
 			};
 		}
-		let D;
+		let A;
 		try {
-			D = await fetch(E, {
+			A = await fetch(E, {
 				method: "POST",
 				headers: { "Content-Type": "application/json" },
 				credentials: "same-origin",
@@ -319,7 +321,7 @@ var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 				body: s
 			});
 		} catch (e) {
-			return T(C(_, e)), a.warning("interactions", /* @__PURE__ */ u("span", { children: [
+			return O(C(_, e)), a.warning("interactions", /* @__PURE__ */ u("span", { children: [
 				"Server action ",
 				/* @__PURE__ */ l("b", { children: n }),
 				" could not be reached"
@@ -333,25 +335,25 @@ var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 				reason: "failed"
 			}), S;
 		}
-		let O = await D.json().catch(() => ({}));
-		return D.ok ? (T({
-			status: O.status === "completed" ? "completed" : "failed",
-			...O.runId ? { runId: O.runId } : {},
-			...O.output ? { output: O.output } : {},
-			...O.error ? { error: O.error } : {},
-			...O.steps ? { steps: O.steps } : {},
-			...O.trace ? { trace: O.trace } : {}
+		let j = await A.json().catch(() => ({}));
+		return A.ok ? (O({
+			status: j.status === "completed" ? "completed" : "failed",
+			...j.runId ? { runId: j.runId } : {},
+			...j.output ? { output: j.output } : {},
+			...j.error ? { error: j.error } : {},
+			...j.steps ? { steps: j.steps } : {},
+			...j.trace ? { trace: j.trace } : {}
 		}), {
-			status: O.status ?? "completed",
-			runId: O.runId ?? "",
-			output: O.output ?? {},
-			...O.error ? { error: O.error } : {}
-		}) : (w(D.status, O, E), T({
+			status: j.status ?? "completed",
+			runId: j.runId ?? "",
+			output: j.output ?? {},
+			...j.error ? { error: j.error } : {}
+		}) : (w(A.status, j, E), O({
 			status: "failed",
-			...O.runId ? { runId: O.runId } : {},
-			...O.reason ? { reason: O.reason } : {},
-			...O.error ? { error: O.error } : {},
-			...O.steps ? { steps: O.steps } : {}
+			...j.runId ? { runId: j.runId } : {},
+			...j.reason ? { reason: j.reason } : {},
+			...j.error ? { error: j.error } : {},
+			...j.steps ? { steps: j.steps } : {}
 		}), a.warning("actions", /* @__PURE__ */ u("span", { children: [
 			"Server action ",
 			/* @__PURE__ */ l("b", { children: n }),
@@ -359,16 +361,16 @@ var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 		] }), {
 			actionId: n,
 			mode: r,
-			runId: O.runId,
-			reason: O.reason,
-			error: O.error,
-			status: String(D.status)
+			runId: j.runId,
+			reason: j.reason,
+			error: j.error,
+			status: String(A.status)
 		}), {
 			status: "failed",
-			reason: O.reason ?? "failed",
-			runId: O.runId ?? "",
+			reason: j.reason ?? "failed",
+			runId: j.runId ?? "",
 			output: {},
-			...O.error ? { error: O.error } : {}
+			...j.error ? { error: j.error } : {}
 		});
 	}, [E, k]), j = r(async (e) => {
 		if (!E || !e.runId) return { cancelled: !1 };

package/dist/utility/delayTime.d.ts

@@ -1,4 +1,11 @@
 import { InteractionCallback } from '@plitzi/sdk-shared';
+/**
+ * Waits `time` milliseconds before the next step.
+ *
+ * The wait ends early when the flow is superseded (`whileRunning: 'latest'`): the run is over, and holding a timer
+ * for it only keeps it alive for nothing. That pair is how a flow is debounced — `whileRunning('latest')` and a
+ * `delay(450)` first: every new firing stops the one still waiting, and only the last gets past the wait.
+ */
 declare const delayTime: InteractionCallback<{
     time: number;
 }>;

package/dist/utility/delayTime.mjs

@@ -5,11 +5,19 @@ var e = {
 	type: "utility",
 	params: { time: {
 		label: "Time (Milliseconds)",
-		type: "text"
+		type: "number"
 	} },
 	preview: {},
-	callback: ({ time: e }) => new Promise((t) => {
-		setTimeout(t, e);
+	callback: ({ time: e }, t) => new Promise((n) => {
+		let r = t?.signal;
+		if (r?.aborted) {
+			n(void 0);
+			return;
+		}
+		let i = () => {
+			clearTimeout(a), r?.removeEventListener("abort", i), n(void 0);
+		}, a = setTimeout(i, e);
+		r?.addEventListener("abort", i, { once: !0 });
 	})
 };
 //#endregion

package/dist/utility/webHook.mjs

@@ -9,41 +9,42 @@ var a = /* @__PURE__ */ new Set(["GET", "HEAD"]), o = /* @__PURE__ */ new Set([
 ]), s = (t) => {
 	let n = Number(t);
 	return (Number.isFinite(n) && n >= 0 ? n : Number(e.params.staleTime.default)) * 1e3;
-}, c = (e) => e ? { Authorization: `Bearer ${e}` } : {}, l = (e) => typeof e == "object" && e ? e : {}, u = /* @__PURE__ */ new Set(["authorization", "content-type"]), d = (e) => typeof e == "object" && e ? Object.fromEntries(Object.entries(e).flatMap(([e, t]) => (typeof t == "string" || typeof t == "number") && t !== "" && !u.has(e.toLowerCase()) ? [[e, String(t)]] : [])) : {}, f = async ({ url: e, authorizationToken: t, headers: n, body: r, credentials: i }, a) => {
-	let s = l(r), u = Object.values(s).some((e) => e instanceof Blob), f = {
+}, c = (e) => e ? { Authorization: `Bearer ${e}` } : {}, l = (e) => typeof e == "object" && e ? e : {}, u = /* @__PURE__ */ new Set(["authorization", "content-type"]), d = (e) => typeof e == "object" && e ? Object.fromEntries(Object.entries(e).flatMap(([e, t]) => (typeof t == "string" || typeof t == "number") && t !== "" && !u.has(e.toLowerCase()) ? [[e, String(t)]] : [])) : {}, f = async ({ url: e, authorizationToken: t, headers: n, body: r, credentials: i }, a, s) => {
+	let u = l(r), f = Object.values(u).some((e) => e instanceof Blob), p = {
 		method: a,
 		headers: {
 			...d(n),
-			...u ? {} : { "Content-Type": "application/json" },
+			...f ? {} : { "Content-Type": "application/json" },
 			...c(t)
 		},
-		credentials: i
+		credentials: i,
+		...s ? { signal: s } : {}
 	};
 	if (!o.has(a)) {
-		if (!u) f.body = JSON.stringify(s);
+		if (!f) p.body = JSON.stringify(u);
 		else {
 			let e = new FormData();
-			Object.entries(s).forEach(([t, n]) => {
+			Object.entries(u).forEach(([t, n]) => {
 				e.append(t, n);
-			}), f.body = e;
+			}), p.body = e;
 		}
 	}
-	let p = await fetch(e, f).catch((t) => {
+	let m = await fetch(e, p).catch((t) => {
 		throw Error(`${a} ${e} got no answer: ${t instanceof Error ? t.message : String(t)}`);
-	}), m = "";
+	}), h = "";
 	try {
-		m = await p.json();
+		h = await m.json();
 	} catch {}
 	return {
-		status: p.status,
-		data: m
+		status: m.status,
+		data: h
 	};
-}, p = t("webHook", e, async (e) => {
-	let t = (e.method || "get").toUpperCase();
-	if (a.has(t)) {
-		if (e.cache !== !0 && e.cache !== "true") return { response: await f(e, t) };
+}, p = t("webHook", e, async (e, t) => {
+	let o = (e.method || "get").toUpperCase();
+	if (a.has(o)) {
+		if (e.cache !== !0 && e.cache !== "true") return { response: await f(e, o, t?.signal) };
 		let n = i({
-			method: t,
+			method: o,
 			url: e.url,
 			credentials: e.credentials,
 			headers: {
@@ -53,18 +54,18 @@ var a = /* @__PURE__ */ new Set(["GET", "HEAD"]), o = /* @__PURE__ */ new Set([
 		});
 		return { response: await r.fetchQuery(n, {
 			meta: { url: e.url },
-			fetcher: () => f(e, t),
+			fetcher: () => f(e, o),
 			staleTime: s(e.staleTime),
 			isCacheable: (e) => e.status < 400
 		}) };
 	}
-	let o = await f(e, t);
-	return o.status >= 200 && o.status < 300 && n({
+	let l = await f(e, o, t?.signal);
+	return l.status >= 200 && l.status < 300 && n({
 		mode: e.invalidateQueries,
 		fallback: "origin",
 		elements: e.invalidateElements,
 		url: e.url
-	}), { response: o };
+	}), { response: l };
 });
 //#endregion
 export { p as default };