@plitzi/sdk-interactions 0.35.9 → 0.36.0

package/CHANGELOG.md

@@ -1,5 +1,81 @@
 # @plitzi/sdk-interactions
 
+## 0.36.0
+
+### Minor Changes
+
+- - **An `apiContainer` can keep its browser requests in a query cache, the way react-query does.** Moving between
+    sections or pages used to ask the API again every time a provider was shown: a provider in a hidden section is
+    mounted but disabled, so showing it fired a fresh request, and a page navigation remounted it and did the same.
+    With the new `cache: true` an answer is kept for `staleTime` seconds (30 by default) and shared by every cached
+    provider asking the same thing — same method, URL, credentials and headers, the token included, so two visitors
+    never share one. Past its time the answer is still drawn at once and a fresh one is fetched behind it; an answer
+    nobody shows is forgotten after `gcTime` seconds (300 by default). A refused request (`4xx`/`5xx`) is shown but
+    never kept. **The cache is off unless an element asks for it**: an uncached provider behaves as before, asking on
+    every mount and sharing nothing.
+
+    The cache is `@plitzi/sdk-shared/queries` (`queryCache`, `useQuery`, `invalidateQueries`,
+    `invalidateQueriesForWrite`), a nexus store written with the per-path `ttl` of `@plitzi/nexus` 1.2.0, which every
+    consumer now requires. It reacts to the store's own freshness events, so anything that expires a query's path
+    makes the providers on screen ask again.
+
+    An answer stops counting as current before its time when the element's `performQuery` runs (it always asks
+    again), when a flow runs the new global `invalidateQueries` step (source `queries`: `elements`, api container ids
+    — a container's requests are tagged with its own id — and/or a `url` prefix), and after a write. Both write steps
+    gained `invalidateQueries` / `invalidateElements`: a `webHook` sent with anything but `GET`/`HEAD` refreshes the
+    requests to its own site by default, a completed `runServerAction` refreshes all of them by default, and either
+    can name containers instead or refresh nothing. A `writeRecord` refreshes all. Providers on screen ask again at
+    once; the rest when they are next shown. A sign-in, sign-out or change of account drops everything held. Server-driven
+    providers and RSC are untouched.
+
+  - **A `webHook` that reads can be cached** (`cache`, `staleTime`), in the same cache and under the same key as an api
+    container asking the same thing. Its declaration now lives beside it (`utility/webHookSpec`) and the authoring
+    catalog gathers it instead of keeping a copy. A `HEAD` is no longer sent with a body, which `fetch` refused.
+
+  - **Step params can pick several elements.** A new param type, `elementIds` (with an `elementType` filter), is drawn
+    in the flow editor as a picker: the matching elements of the space to add, and the picked ones as chips to remove —
+    an id no element answers to any more is kept and flagged. The value is a list of ids, so nobody types a
+    comma-separated list; `invalidateQueries.elements` and the write steps' `invalidateElements` use it, and the MCP
+    catalog says which element type each such param takes.
+
+  - The dev-tools' Store tab lists the paths a store holds with a TTL — how long ago each was written, what is left
+    of it, and a button to expire one or all of them. The query cache appears there as "Queries".
+
+  - `useApi` no longer takes `params`: nothing passed them, and a GET cannot carry a body anyway. A mock now answers
+    synchronously, without a loading frame, and a provider whose URL has not resolved asks for nothing.
+
+### Patch Changes
+
+- Updated dependencies
+  - @plitzi/sdk-auth@0.36.0
+  - @plitzi/sdk-dev-tools@0.36.0
+  - @plitzi/sdk-event-bridge@0.36.0
+  - @plitzi/sdk-navigation@0.36.0
+  - @plitzi/sdk-schema@0.36.0
+  - @plitzi/sdk-shared@0.36.0
+
+## 0.35.10
+
+### Patch Changes
+
+- **Breaking:** the space setting that lets a published site open the dev tools is now `settings.debugMode`, and
+  `settings.devTools` is gone.
+
+  It was always the same decision the SDK and the page server call `debugMode` — whether the dev-tools panel is
+  authorized — and having a third name for it invited confusing it with `devMode`, which is a different thing: it turns a
+  deployment into a development server (the unminified bundles, request timings, and the full action trace with every
+  step's results). A space can authorize debugging for its own site; it can never make its server a development one.
+
+  A space that stored `settings.devTools` needs it moved to `settings.debugMode`; nothing reads the old key.
+
+- Updated dependencies
+  - @plitzi/sdk-auth@0.35.10
+  - @plitzi/sdk-dev-tools@0.35.10
+  - @plitzi/sdk-event-bridge@0.35.10
+  - @plitzi/sdk-navigation@0.35.10
+  - @plitzi/sdk-schema@0.35.10
+  - @plitzi/sdk-shared@0.35.10
+
 ## 0.35.9
 
 ### Patch Changes

package/dist/InteractionsSourcesProvider.mjs

@@ -3,32 +3,33 @@ import t from "./sources/ActionsSource/ActionInteractions.mjs";
 import n from "./sources/AuthSource/AuthInteractions.mjs";
 import r from "./sources/HostSource/HostInteractions.mjs";
 import i from "./sources/NavigationSource/NavigationInteractions.mjs";
-import a from "./sources/StateSource/StateInteractions.mjs";
-import { jsx as o } from "react/jsx-runtime";
-import { useRenderSettings as s, useSdkStore as c } from "@plitzi/sdk-shared/store";
+import a from "./sources/QueriesSource/QueriesInteractions.mjs";
+import o from "./sources/StateSource/StateInteractions.mjs";
+import { jsx as s } from "react/jsx-runtime";
+import { useRenderSettings as c, useSdkStore as l } from "@plitzi/sdk-shared/store";
 //#region src/InteractionsSourcesProvider.tsx
-var l = ({ children: l, hostActions: u }) => {
-	let [[d = "basic", f, p, m]] = c([
+var u = ({ children: u, hostActions: d }) => {
+	let [[f = "basic", p, m, h]] = l([
 		"schema.settings.userProvider",
 		"navigation.routeParams",
 		"navigation.queryParams",
 		"navigation.currentPageId"
-	]), { previewMode: h } = s();
-	return /* @__PURE__ */ o(e, {
-		currentPageId: m,
-		routeParams: f,
-		queryParams: p,
-		children: /* @__PURE__ */ o(n, {
-			authProvider: d,
-			children: /* @__PURE__ */ o(a, { children: /* @__PURE__ */ o(t, { children: /* @__PURE__ */ o(i, {
-				previewMode: h,
-				children: /* @__PURE__ */ o(r, {
-					actions: u,
-					children: l
+	]), { previewMode: g } = c();
+	return /* @__PURE__ */ s(e, {
+		currentPageId: h,
+		routeParams: p,
+		queryParams: m,
+		children: /* @__PURE__ */ s(n, {
+			authProvider: f,
+			children: /* @__PURE__ */ s(o, { children: /* @__PURE__ */ s(t, { children: /* @__PURE__ */ s(a, { children: /* @__PURE__ */ s(i, {
+				previewMode: g,
+				children: /* @__PURE__ */ s(r, {
+					actions: d,
+					children: u
 				})
-			}) }) })
+			}) }) }) })
 		})
 	});
 };
 //#endregion
-export { l as default };
+export { u as default };

package/dist/index.mjs

@@ -9,6 +9,7 @@ import c from "./sources/AuthSource/AuthInteractions.mjs";
 import l from "./sources/HostSource/callbacks.mjs";
 import u from "./sources/HostSource/HostInteractions.mjs";
 import d from "./sources/NavigationSource/NavigationInteractions.mjs";
-import f from "./sources/StateSource/StateInteractions.mjs";
-import p from "./InteractionsSourcesProvider.mjs";
-export { s as ActionInteractions, c as AuthInteractions, u as HostInteractions, e as InteractionsContext, o as InteractionsContextProvider, r as InteractionsHelper, a as InteractionsManager, p as InteractionsSourcesProvider, d as NavigationInteractions, f as StateInteractions, i as flowTrigger, l as hostCallbacks, t as useInteractions, n as utility };
+import f from "./sources/QueriesSource/QueriesInteractions.mjs";
+import p from "./sources/StateSource/StateInteractions.mjs";
+import m from "./InteractionsSourcesProvider.mjs";
+export { s as ActionInteractions, c as AuthInteractions, u as HostInteractions, e as InteractionsContext, o as InteractionsContextProvider, r as InteractionsHelper, a as InteractionsManager, m as InteractionsSourcesProvider, d as NavigationInteractions, f as QueriesInteractions, p as StateInteractions, i as flowTrigger, l as hostCallbacks, t as useInteractions, n as utility };

package/dist/sources/ActionsSource/ActionInteractions.mjs

@@ -2,12 +2,13 @@ import e from "../../InteractionsContext.mjs";
 import { actionsCallbacks as t } from "./callbacks.mjs";
 import { use as n, useCallback as r, useMemo as i } from "react";
 import { pConsole as a } from "@plitzi/sdk-shared/devTools/utils/PlitziConsole";
-import { jsx as o, jsxs as s } from "react/jsx-runtime";
-import { recordActionProgress as c, recordActionRun as l, registerActionCanceller as u, releaseActionCanceller as d, updateActionRun as f, useCommonStore as p } from "@plitzi/sdk-shared/store";
-import { authFailureFromResponse as m, reportAuthFailure as h } from "@plitzi/sdk-shared/auth";
-import { toBuilderParams as g, toInteractionCallbacks as _ } from "@plitzi/sdk-shared/authoring/builder";
+import { toBuilderParams as o, toInteractionCallbacks as s } from "@plitzi/sdk-shared/authoring/builder";
+import { invalidateAfterWrite as c } from "@plitzi/sdk-shared/queries";
+import { jsx as l, jsxs as u } from "react/jsx-runtime";
+import { recordActionProgress as d, recordActionRun as f, registerActionCanceller as p, releaseActionCanceller as m, updateActionRun as h, useCommonStore as g } from "@plitzi/sdk-shared/store";
+import { authFailureFromResponse as _, reportAuthFailure as v } from "@plitzi/sdk-shared/auth";
 //#region src/sources/ActionsSource/ActionInteractions.tsx
-var v = (e) => Array.isArray(e) ? e : void 0, y = async (e, t) => {
+var y = (e) => Array.isArray(e) ? e : void 0, b = async (e, t) => {
 	let n = e.getReader(), r = new TextDecoder(), i = "";
 	for (;;) {
 		let { done: e, value: a } = await n.read();
@@ -27,7 +28,7 @@ var v = (e) => Array.isArray(e) ? e : void 0, y = async (e, t) => {
 			} catch {}
 		}
 	}
-}, b = (e) => {
+}, x = (e) => {
 	if (!e) return {};
 	if (typeof e == "object") return e;
 	try {
@@ -36,32 +37,32 @@ var v = (e) => Array.isArray(e) ? e : void 0, y = async (e, t) => {
 	} catch {
 		return {};
 	}
-}, x = {
+}, S = {
 	status: "failed",
 	reason: "failed",
 	runId: "",
 	output: {}
-}, S = (e, t) => e.signal.aborted ? {
+}, C = (e, t) => e.signal.aborted ? {
 	status: "aborted",
 	error: "Cancelled"
 } : {
 	status: "failed",
 	error: t instanceof Error ? t.message : String(t)
-}, C = (e, t, n) => {
+}, w = (e, t, n) => {
 	if (e !== 401) return;
-	let r = m(e, t);
-	r && h({
+	let r = _(e, t);
+	r && v({
 		reason: r,
 		url: n
 	});
-}, w = ({ children: m }) => {
-	let { useInteractions: h, interactionsManager: w } = n(e), [T] = p("actions.endpoint"), [[E, D]] = p(["actions.catalog", "actions.available"]), O = r((e, t, n) => {
-		e && w.interactionTrigger(e, t, n);
-	}, [w]), k = r(async (e, t) => {
+}, T = ({ children: _ }) => {
+	let { useInteractions: v, interactionsManager: T } = n(e), [E] = g("actions.endpoint"), [[D, O]] = g(["actions.catalog", "actions.available"]), k = r((e, t, n) => {
+		e && T.interactionTrigger(e, t, n);
+	}, [T]), A = r(async (e, t) => {
 		let { actionId: n, mode: r = "await", idempotencyKey: i } = e;
-		if (!T) return a.warning("actions", /* @__PURE__ */ s("span", { children: [
+		if (!E) return a.warning("actions", /* @__PURE__ */ u("span", { children: [
 			"Server action ",
-			/* @__PURE__ */ o("b", { children: n }),
+			/* @__PURE__ */ l("b", { children: n }),
 			" was skipped: this page is served without a Plitzi server"
 		] }), {
 			actionId: n,
@@ -76,57 +77,61 @@ var v = (e) => Array.isArray(e) ? e : void 0, y = async (e, t) => {
 			runId: "",
 			output: {}
 		};
-		let p = b(e.input), m = JSON.stringify({
+		let o = x(e.input), s = JSON.stringify({
 			actionId: n,
-			input: p,
+			input: o,
 			...i ? { idempotencyKey: i } : {}
-		}), h = l({
+		}), g = f({
 			actionId: n,
 			mode: r,
-			input: p
-		}), g = new AbortController(), _ = "";
-		u(h, () => {
-			g.abort(), f(h, {
+			input: o
+		}), _ = new AbortController(), v = "";
+		p(g, () => {
+			_.abort(), h(g, {
 				status: "aborted",
 				endedAt: Date.now(),
 				cancellable: !1
-			}), _ && fetch(`${T}/run/${_}`, {
+			}), v && fetch(`${E}/run/${v}`, {
 				method: "DELETE",
 				credentials: "same-origin"
 			}).catch(() => void 0);
 		});
-		let w = (e) => {
-			d(h), f(h, {
+		let T = (t) => {
+			m(g), h(g, {
 				endedAt: Date.now(),
 				cancellable: !1,
-				...e
+				...t
+			}), t.status === "completed" && c({
+				mode: e.invalidateQueries,
+				fallback: "all",
+				elements: e.invalidateElements
 			});
 		};
-		if (r === "detached") return a.info("actions", /* @__PURE__ */ s("span", { children: [
+		if (r === "detached") return a.info("actions", /* @__PURE__ */ u("span", { children: [
 			"Server action ",
-			/* @__PURE__ */ o("b", { children: n }),
+			/* @__PURE__ */ l("b", { children: n }),
 			" sent"
 		] }), {
 			actionId: n,
 			mode: r,
 			status: "accepted"
-		}), fetch(T, {
+		}), fetch(E, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			credentials: "same-origin",
 			keepalive: !0,
-			signal: g.signal,
-			body: m
+			signal: _.signal,
+			body: s
 		}).then(async (e) => {
 			let i = await e.json().catch(() => ({}));
 			if (!e.ok) {
-				C(e.status, i, T), w({
+				w(e.status, i, E), T({
 					status: "failed",
 					...i.runId ? { runId: i.runId } : {},
 					...i.reason ? { reason: i.reason } : {},
 					...i.error ? { error: i.error } : {},
 					...i.steps ? { steps: i.steps } : {}
-				}), O(t?.hostElementId, "onFlowError", {
+				}), k(t?.hostElementId, "onFlowError", {
 					actionId: n,
 					runId: i.runId ?? "",
 					error: i.error ?? "",
@@ -134,15 +139,15 @@ var v = (e) => Array.isArray(e) ? e : void 0, y = async (e, t) => {
 				});
 				return;
 			}
-			w({
+			T({
 				status: i.status === "completed" ? "completed" : "accepted",
 				...i.runId ? { runId: i.runId } : {},
 				...i.output ? { output: i.output } : {},
 				...i.steps ? { steps: i.steps } : {},
 				...i.trace ? { trace: i.trace } : {}
-			}), a.success("actions", /* @__PURE__ */ s("span", { children: [
+			}), a.success("actions", /* @__PURE__ */ u("span", { children: [
 				"Server action ",
-				/* @__PURE__ */ o("b", { children: n }),
+				/* @__PURE__ */ l("b", { children: n }),
 				" finished"
 			] }), {
 				actionId: n,
@@ -150,22 +155,22 @@ var v = (e) => Array.isArray(e) ? e : void 0, y = async (e, t) => {
 				runId: i.runId,
 				status: i.status,
 				output: i.output
-			}), O(t?.hostElementId, "onFlowEnd", {
+			}), k(t?.hostElementId, "onFlowEnd", {
 				actionId: n,
 				runId: i.runId ?? "",
 				status: i.status ?? "completed",
 				output: i.output ?? {}
 			});
 		}).catch((e) => {
-			w(S(g, e)), a.warning("actions", /* @__PURE__ */ s("span", { children: [
+			T(C(_, e)), a.warning("actions", /* @__PURE__ */ u("span", { children: [
 				"Server action ",
-				/* @__PURE__ */ o("b", { children: n }),
+				/* @__PURE__ */ l("b", { children: n }),
 				" could not be sent"
 			] }), {
 				actionId: n,
 				mode: r,
 				error: e instanceof Error ? e.message : String(e)
-			}), O(t?.hostElementId, "onFlowError", {
+			}), k(t?.hostElementId, "onFlowError", {
 				actionId: n,
 				runId: "",
 				error: "",
@@ -178,9 +183,9 @@ var v = (e) => Array.isArray(e) ? e : void 0, y = async (e, t) => {
 			output: {}
 		};
 		if (r === "stream") {
-			a.info("actions", /* @__PURE__ */ s("span", { children: [
+			a.info("actions", /* @__PURE__ */ u("span", { children: [
 				"Server action ",
-				/* @__PURE__ */ o("b", { children: n }),
+				/* @__PURE__ */ l("b", { children: n }),
 				" streaming"
 			] }), {
 				actionId: n,
@@ -189,41 +194,41 @@ var v = (e) => Array.isArray(e) ? e : void 0, y = async (e, t) => {
 			});
 			let e;
 			try {
-				e = await fetch(T, {
+				e = await fetch(E, {
 					method: "POST",
 					headers: {
 						"Content-Type": "application/json",
 						Accept: "text/event-stream"
 					},
 					credentials: "same-origin",
-					signal: g.signal,
-					body: m
+					signal: _.signal,
+					body: s
 				});
 			} catch (e) {
-				return w(S(g, e)), a.warning("actions", /* @__PURE__ */ s("span", { children: [
+				return T(C(_, e)), a.warning("actions", /* @__PURE__ */ u("span", { children: [
 					"Server action ",
-					/* @__PURE__ */ o("b", { children: n }),
+					/* @__PURE__ */ l("b", { children: n }),
 					" could not be reached"
 				] }), {
 					actionId: n,
 					mode: r,
 					error: e instanceof Error ? e.message : String(e)
-				}), O(t?.hostElementId, "onFlowError", {
+				}), k(t?.hostElementId, "onFlowError", {
 					actionId: n,
 					runId: "",
 					error: "",
 					reason: "failed"
-				}), x;
+				}), S;
 			}
 			if (!e.ok || !e.body) {
 				let r = await e.json().catch(() => ({}));
-				return C(e.status, r, T), w({
+				return w(e.status, r, E), T({
 					status: "failed",
 					...r.runId ? { runId: r.runId } : {},
 					...r.reason ? { reason: r.reason } : {},
 					...r.error ? { error: r.error } : {},
 					...r.steps ? { steps: r.steps } : {}
-				}), O(t?.hostElementId, "onFlowError", {
+				}), k(t?.hostElementId, "onFlowError", {
 					actionId: n,
 					runId: r.runId ?? "",
 					error: r.error ?? "",
@@ -236,12 +241,12 @@ var v = (e) => Array.isArray(e) ? e : void 0, y = async (e, t) => {
 				};
 			}
 			let i = e.headers.get("X-Plitzi-Run-Id") ?? "";
-			return _ = i, f(h, {
+			return v = i, h(g, {
 				status: "streaming",
 				...i ? { runId: i } : {}
-			}), y(e.body, (e) => {
+			}), b(e.body, (e) => {
 				if (e.event === "data") {
-					c(h, e.data.chunk ?? e.data), O(t?.hostElementId, "onFlowProgress", {
+					d(g, e.data.chunk ?? e.data), k(t?.hostElementId, "onFlowProgress", {
 						actionId: n,
 						runId: i,
 						...e.data
@@ -249,13 +254,13 @@ var v = (e) => Array.isArray(e) ? e : void 0, y = async (e, t) => {
 					return;
 				}
 				if (e.event === "error") {
-					let r = v(e.data.steps);
-					w({
+					let r = y(e.data.steps);
+					T({
 						status: "failed",
 						...typeof e.data.reason == "string" ? { reason: e.data.reason } : {},
 						...typeof e.data.error == "string" ? { error: e.data.error } : {},
 						...r ? { steps: r } : {}
-					}), O(t?.hostElementId, "onFlowError", {
+					}), k(t?.hostElementId, "onFlowError", {
 						actionId: n,
 						runId: i,
 						...e.data
@@ -263,36 +268,36 @@ var v = (e) => Array.isArray(e) ? e : void 0, y = async (e, t) => {
 					return;
 				}
 				if (e.event === "done") {
-					let r = v(e.data.steps);
-					w({
+					let r = y(e.data.steps);
+					T({
 						status: e.data.status === "completed" ? "completed" : "failed",
 						...e.data.output ? { output: e.data.output } : {},
 						...r ? { steps: r } : {}
-					}), O(t?.hostElementId, "onFlowEnd", {
+					}), k(t?.hostElementId, "onFlowEnd", {
 						actionId: n,
 						runId: i,
 						...e.data
 					});
 				}
 			}).catch((e) => {
-				if (g.signal.aborted) return;
-				let c = e instanceof Error ? e.message : String(e);
-				w({
+				if (_.signal.aborted) return;
+				let o = e instanceof Error ? e.message : String(e);
+				T({
 					status: "failed",
-					error: c
-				}), a.warning("actions", /* @__PURE__ */ s("span", { children: [
+					error: o
+				}), a.warning("actions", /* @__PURE__ */ u("span", { children: [
 					"Server action ",
-					/* @__PURE__ */ o("b", { children: n }),
+					/* @__PURE__ */ l("b", { children: n }),
 					" stopped mid-stream"
 				] }), {
 					actionId: n,
 					mode: r,
 					runId: i,
-					error: c
-				}), O(t?.hostElementId, "onFlowError", {
+					error: o
+				}), k(t?.hostElementId, "onFlowError", {
 					actionId: n,
 					runId: i,
-					error: c,
+					error: o,
 					reason: "failed"
 				});
 			}), {
@@ -302,74 +307,74 @@ var v = (e) => Array.isArray(e) ? e : void 0, y = async (e, t) => {
 				output: {}
 			};
 		}
-		let E;
+		let D;
 		try {
-			E = await fetch(T, {
+			D = await fetch(E, {
 				method: "POST",
 				headers: { "Content-Type": "application/json" },
 				credentials: "same-origin",
-				signal: g.signal,
-				body: m
+				signal: _.signal,
+				body: s
 			});
 		} catch (e) {
-			return w(S(g, e)), a.warning("interactions", /* @__PURE__ */ s("span", { children: [
+			return T(C(_, e)), a.warning("interactions", /* @__PURE__ */ u("span", { children: [
 				"Server action ",
-				/* @__PURE__ */ o("b", { children: n }),
+				/* @__PURE__ */ l("b", { children: n }),
 				" could not be reached"
 			] }), {
 				actionId: n,
 				error: e instanceof Error ? e.message : String(e)
-			}), O(t?.hostElementId, "onFlowError", {
+			}), k(t?.hostElementId, "onFlowError", {
 				actionId: n,
 				runId: "",
 				error: "",
 				reason: "failed"
-			}), x;
+			}), S;
 		}
-		let D = await E.json().catch(() => ({}));
-		return E.ok ? (w({
-			status: D.status === "completed" ? "completed" : "failed",
-			...D.runId ? { runId: D.runId } : {},
-			...D.output ? { output: D.output } : {},
-			...D.steps ? { steps: D.steps } : {},
-			...D.trace ? { trace: D.trace } : {}
+		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.steps ? { steps: O.steps } : {},
+			...O.trace ? { trace: O.trace } : {}
 		}), {
-			status: D.status ?? "completed",
-			runId: D.runId ?? "",
-			output: D.output ?? {}
-		}) : (C(E.status, D, T), w({
+			status: O.status ?? "completed",
+			runId: O.runId ?? "",
+			output: O.output ?? {}
+		}) : (w(D.status, O, E), T({
 			status: "failed",
-			...D.runId ? { runId: D.runId } : {},
-			...D.reason ? { reason: D.reason } : {},
-			...D.error ? { error: D.error } : {},
-			...D.steps ? { steps: D.steps } : {}
-		}), a.warning("actions", /* @__PURE__ */ s("span", { children: [
+			...O.runId ? { runId: O.runId } : {},
+			...O.reason ? { reason: O.reason } : {},
+			...O.error ? { error: O.error } : {},
+			...O.steps ? { steps: O.steps } : {}
+		}), a.warning("actions", /* @__PURE__ */ u("span", { children: [
 			"Server action ",
-			/* @__PURE__ */ o("b", { children: n }),
+			/* @__PURE__ */ l("b", { children: n }),
 			" was refused"
 		] }), {
 			actionId: n,
 			mode: r,
-			runId: D.runId,
-			reason: D.reason,
-			error: D.error,
-			status: String(E.status)
+			runId: O.runId,
+			reason: O.reason,
+			error: O.error,
+			status: String(D.status)
 		}), {
 			status: "failed",
-			reason: D.reason ?? "failed",
-			runId: D.runId ?? "",
+			reason: O.reason ?? "failed",
+			runId: O.runId ?? "",
 			output: {}
 		});
-	}, [T, O]), A = r(async (e) => {
-		if (!T || !e.runId) return { cancelled: !1 };
+	}, [E, k]), j = r(async (e) => {
+		if (!E || !e.runId) return { cancelled: !1 };
 		try {
-			let t = (await fetch(`${T}/run/${e.runId}`, {
+			let t = (await fetch(`${E}/run/${e.runId}`, {
 				method: "DELETE",
 				credentials: "same-origin"
 			})).status === 204;
-			return a.info("actions", /* @__PURE__ */ s("span", { children: [
+			return a.info("actions", /* @__PURE__ */ u("span", { children: [
 				"Server action run ",
-				/* @__PURE__ */ o("b", { children: e.runId }),
+				/* @__PURE__ */ l("b", { children: e.runId }),
 				" ",
 				t ? "cancelled" : "was not cancelled"
 			] }), {
@@ -381,25 +386,25 @@ var v = (e) => Array.isArray(e) ? e : void 0, y = async (e, t) => {
 		} catch {
 			return { cancelled: !1 };
 		}
-	}, [T]), j = i(() => (E ?? []).map((e) => ({
+	}, [E]), M = i(() => (D ?? []).map((e) => ({
 		label: `${e.name} (${e.identifier})`,
 		value: e.identifier
-	})), [E]);
-	return h({
+	})), [D]);
+	return v({
 		id: "actions",
-		callbacks: i(() => _(t, {
-			cancelServerAction: A,
-			runServerAction: k
+		callbacks: i(() => s(t, {
+			cancelServerAction: j,
+			runServerAction: A
 		}, { runServerAction: { params: (e) => {
-			let n = g(t.runServerAction.params), r = (E ?? []).find((t) => t.identifier === e.actionId), i = Object.entries(r?.input ?? {});
+			let n = o(t.runServerAction.params), r = (D ?? []).find((t) => t.identifier === e.actionId), i = Object.entries(r?.input ?? {});
 			return {
 				...n,
 				actionId: {
 					...n.actionId,
-					type: () => j.length > 0 ? "select" : "text",
+					type: () => M.length > 0 ? "select" : "text",
 					canBind: !0,
-					label: D === !1 ? "Action — this space has no server to run it" : "Action",
-					options: j
+					label: O === !1 ? "Action — this space has no server to run it" : "Action",
+					options: M
 				},
 				input: {
 					...n.input,
@@ -408,13 +413,13 @@ var v = (e) => Array.isArray(e) ? e : void 0, y = async (e, t) => {
 				}
 			};
 		} } }), [
-			k,
 			A,
 			j,
-			E,
-			D
+			M,
+			D,
+			O
 		])
-	}), m;
+	}), _;
 };
 //#endregion
-export { w as default };
+export { T as default };

package/dist/sources/ActionsSource/callbacks.mjs

@@ -1,5 +1,6 @@
+import { writeInvalidationParams as e } from "../QueriesSource/writeParams.mjs";
 //#region src/sources/ActionsSource/callbacks.ts
-var e = {
+var t = {
 	runServerAction: {
 		source: "actions",
 		title: "Run Server Action",
@@ -39,7 +40,12 @@ var e = {
 				description: "Makes a repeat of the same intent answer with the first run instead of running again.",
 				default: "",
 				when: (e) => e.mode !== "detached"
-			}
+			},
+			...e([
+				"all",
+				"elements",
+				"none"
+			])
 		},
 		preview: {
 			runId: "",
@@ -60,4 +66,4 @@ var e = {
 	}
 };
 //#endregion
-export { e as actionsCallbacks };
+export { t as actionsCallbacks };

package/dist/sources/NavigationSource/NavigationInteractions.mjs

@@ -2,11 +2,11 @@ import e from "../../InteractionsContext.mjs";
 import { navigationCallbacks as t } from "./callbacks.mjs";
 import { use as n, useCallback as r, useMemo as i } from "react";
 import { get as a, pick as o } from "@plitzi/plitzi-ui/helpers";
-import { useSdkStore as s } from "@plitzi/sdk-shared/store";
-import { toBuilderParams as c, toInteractionCallbacks as l } from "@plitzi/sdk-shared/authoring/builder";
+import { toBuilderParams as s, toInteractionCallbacks as c } from "@plitzi/sdk-shared/authoring/builder";
+import { useSdkStore as l } from "@plitzi/sdk-shared/store";
 //#region src/sources/NavigationSource/NavigationInteractions.tsx
 var u = ({ children: u, previewMode: d = !1 }) => {
-	let { useInteractions: f } = n(e), [[p, m, h]] = s([
+	let { useInteractions: f } = n(e), [[p, m, h]] = l([
 		"schema.pages",
 		"pageDefinitions",
 		"navigation.navigate"
@@ -28,8 +28,8 @@ var u = ({ children: u, previewMode: d = !1 }) => {
 	return f({
 		id: "navigation",
 		callbacks: i(() => {
-			let { urlType: e, url: n } = c(t.navigate.params);
-			return l(t, { navigate: _ }, { navigate: { params: {
+			let { urlType: e, url: n } = s(t.navigate.params);
+			return c(t, { navigate: _ }, { navigate: { params: {
 				urlType: e,
 				url: {
 					...n,

package/dist/sources/QueriesSource/QueriesInteractions.d.ts

@@ -0,0 +1,6 @@
+import { ReactNode } from 'react';
+export type QueriesInteractionsProps = {
+    children?: ReactNode;
+};
+declare const QueriesInteractions: ({ children }: QueriesInteractionsProps) => ReactNode;
+export default QueriesInteractions;

package/dist/sources/QueriesSource/QueriesInteractions.mjs

@@ -0,0 +1,18 @@
+import e from "../../InteractionsContext.mjs";
+import { queriesCallbacks as t } from "./callbacks.mjs";
+import { use as n, useCallback as r, useMemo as i } from "react";
+import { toInteractionCallbacks as a } from "@plitzi/sdk-shared/authoring/builder";
+import { invalidateQueries as o, parseIds as s } from "@plitzi/sdk-shared/queries";
+//#region src/sources/QueriesSource/QueriesInteractions.tsx
+var c = ({ children: c }) => {
+	let { useInteractions: l } = n(e), u = r((e) => o({
+		url: e.url ?? "",
+		elements: s(e.elements)
+	}), []);
+	return l({
+		id: "queries",
+		callbacks: i(() => a(t, { invalidateQueries: u }), [u])
+	}), c;
+};
+//#endregion
+export { c as default };

package/dist/sources/QueriesSource/callbacks.d.ts

@@ -0,0 +1,10 @@
+import { BuiltinGlobalCallback } from '@plitzi/sdk-shared/authoring/builder';
+/**
+ * The step that tells the page's cached requests the data behind them changed.
+ *
+ * A browser request made by an api container is served from memory until its cache time runs out, so a flow that
+ * changed something the page reads — through a route of its own, a third-party form, anything the page cannot see
+ * — says so here. The providers on screen ask again at once; the ones on a tab nobody is looking at ask when they
+ * are shown.
+ */
+export declare const queriesCallbacks: Record<string, BuiltinGlobalCallback>;

package/dist/sources/QueriesSource/callbacks.mjs

@@ -0,0 +1,24 @@
+//#region src/sources/QueriesSource/callbacks.ts
+var e = { invalidateQueries: {
+	source: "queries",
+	title: "Invalidate Queries",
+	strictParams: !0,
+	params: {
+		elements: {
+			type: "elementIds",
+			elementType: "apiContainer",
+			description: "The api containers to refresh, by element id — the way to name a request whose URL is a template. Leave both this and `url` empty to refresh every cached request on the page.",
+			default: [],
+			label: "Containers (ids)"
+		},
+		url: {
+			type: "text",
+			description: "Only the requests whose URL starts with this — `/api/orders` covers `/api/orders?page=2`. With `elements` too, a request must match both.",
+			default: "",
+			label: "URL prefix"
+		}
+	},
+	preview: {}
+} };
+//#endregion
+export { e as queriesCallbacks };

package/dist/sources/QueriesSource/index.d.ts

@@ -0,0 +1,3 @@
+import { default as QueriesInteractions } from './QueriesInteractions';
+export * from './QueriesInteractions';
+export { QueriesInteractions };

package/dist/sources/QueriesSource/index.mjs

@@ -0,0 +1,2 @@
+import e from "./QueriesInteractions.mjs";
+export { e as QueriesInteractions };

package/dist/sources/QueriesSource/writeParams.d.ts

@@ -0,0 +1,10 @@
+import { ParamSpec } from '@plitzi/sdk-shared/authoring/paramSpec';
+import { WriteInvalidation } from '@plitzi/sdk-shared/queries';
+/**
+ * The two params a step that writes carries: what to refresh once it succeeded, and — when it is a list — which
+ * containers, by id. Declared once for every such step, so a webhook and a server action offer the same choice.
+ *
+ * @param modes What this step can offer, its default first. `origin` needs a URL the step knows.
+ * @param applies When the step writes at all; a webhook that only reads shows neither param.
+ */
+export declare const writeInvalidationParams: (modes: readonly WriteInvalidation[], applies?: (params: Record<string, unknown>) => boolean) => ParamSpec;

package/dist/sources/QueriesSource/writeParams.mjs

@@ -0,0 +1,28 @@
+//#region src/sources/QueriesSource/writeParams.ts
+var e = {
+	origin: "Requests to the same site",
+	all: "All cached requests",
+	elements: "Only these containers",
+	none: "None — this only reads"
+}, t = (t, n = () => !0) => ({
+	invalidateQueries: {
+		type: "select",
+		description: "What to refresh once the write succeeded, so the page shows the new data: the cached requests to the same site, all of them, only the api containers named in `invalidateElements`, or none for a step that only reads. Containers on screen ask again at once; the rest when they are shown.",
+		default: t[0],
+		options: [...t],
+		optionLabels: Object.fromEntries(t.map((t) => [t, e[t]])),
+		label: "Refresh cached requests",
+		canBind: !1,
+		when: n
+	},
+	invalidateElements: {
+		type: "elementIds",
+		elementType: "apiContainer",
+		description: "The api containers to refresh, by element id.",
+		default: [],
+		label: "Containers (ids)",
+		when: (e) => n(e) && e.invalidateQueries === "elements"
+	}
+});
+//#endregion
+export { t as writeInvalidationParams };

package/dist/sources/StateSource/StateInteractions.mjs

@@ -1,11 +1,11 @@
 import e from "../../InteractionsContext.mjs";
 import { stateCallbacks as t } from "./callbacks.mjs";
 import { use as n, useCallback as r, useMemo as i } from "react";
-import { useCommonStoreSetter as a } from "@plitzi/sdk-shared/store";
-import { toInteractionCallbacks as o } from "@plitzi/sdk-shared/authoring/builder";
+import { toInteractionCallbacks as a } from "@plitzi/sdk-shared/authoring/builder";
+import { useCommonStoreSetter as o } from "@plitzi/sdk-shared/store";
 //#region src/sources/StateSource/StateInteractions.tsx
 var s = 0, c = () => typeof crypto < "u" && typeof crypto.randomUUID == "function" ? crypto.randomUUID() : `e${++s}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`, l = ({ children: s }) => {
-	let { useInteractions: l } = n(e), u = a(), d = r((e) => {
+	let { useInteractions: l } = n(e), u = o(), d = r((e) => {
 		let { key: t, type: n } = e, { value: r } = e;
 		n === "boolean" ? r = r === !0 || r === "true" : n === "number" && (r = parseInt(r, 10)), u(`runtime.state.${t}`, r);
 	}, [u]), f = r((e) => {
@@ -52,7 +52,7 @@ var s = 0, c = () => typeof crypto < "u" && typeof crypto.randomUUID == "functio
 	}, [u]);
 	return l({
 		id: "state",
-		callbacks: i(() => o(t, {
+		callbacks: i(() => a(t, {
 			setState: d,
 			toggleState: f,
 			appendState: m,

package/dist/sources/index.d.ts

@@ -2,10 +2,12 @@ import { ActionInteractions } from './ActionsSource';
 import { AuthInteractions } from './AuthSource';
 import { HostInteractions } from './HostSource';
 import { NavigationInteractions } from './NavigationSource';
+import { QueriesInteractions } from './QueriesSource';
 import { StateInteractions } from './StateSource';
 export * from './ActionsSource';
 export * from './AuthSource';
 export * from './HostSource';
 export * from './NavigationSource';
+export * from './QueriesSource';
 export * from './StateSource';
-export { ActionInteractions, AuthInteractions, HostInteractions, NavigationInteractions, StateInteractions };
+export { ActionInteractions, AuthInteractions, HostInteractions, NavigationInteractions, QueriesInteractions, StateInteractions };

package/dist/sources/index.mjs

@@ -3,5 +3,6 @@ import t from "./AuthSource/AuthInteractions.mjs";
 import n from "./HostSource/callbacks.mjs";
 import r from "./HostSource/HostInteractions.mjs";
 import i from "./NavigationSource/NavigationInteractions.mjs";
-import a from "./StateSource/StateInteractions.mjs";
-export { e as ActionInteractions, t as AuthInteractions, r as HostInteractions, i as NavigationInteractions, a as StateInteractions, n as hostCallbacks };
+import a from "./QueriesSource/QueriesInteractions.mjs";
+import o from "./StateSource/StateInteractions.mjs";
+export { e as ActionInteractions, t as AuthInteractions, r as HostInteractions, i as NavigationInteractions, a as QueriesInteractions, o as StateInteractions, n as hostCallbacks };

package/dist/utility/index.d.ts

@@ -12,6 +12,10 @@ declare const _default: {
         body: Record<string, string | Blob>;
         authorizationToken: string;
         credentials: RequestCredentials;
+        cache?: boolean | string;
+        staleTime?: number | string;
+        invalidateQueries?: string;
+        invalidateElements?: string[];
     }>;
 };
 export default _default;

package/dist/utility/webHook.d.ts

@@ -1,9 +1,14 @@
 import { InteractionCallback } from '@plitzi/sdk-shared';
-declare const delayTime: InteractionCallback<{
+type WebHookParams = {
     url: string;
     method: string;
     body: Record<string, string | Blob>;
     authorizationToken: string;
     credentials: RequestCredentials;
-}>;
-export default delayTime;
+    cache?: boolean | string;
+    staleTime?: number | string;
+    invalidateQueries?: string;
+    invalidateElements?: string[];
+};
+declare const webHook: InteractionCallback<WebHookParams>;
+export default webHook;

package/dist/utility/webHook.mjs

@@ -1,121 +1,70 @@
+import { webHookSpec as e } from "./webHookSpec.mjs";
+import { toInteractionCallback as t } from "@plitzi/sdk-shared/authoring/builder";
+import { invalidateAfterWrite as n, queryCache as r, requestKey as i } from "@plitzi/sdk-shared/queries";
 //#region src/utility/webHook.ts
-var e = {
-	action: "webHook",
-	title: "Webhook",
-	type: "utility",
-	params: {
-		url: {
-			canBind: !0,
-			defaultValue: "",
-			type: "text",
-			label: "Url"
-		},
-		method: {
-			label: "Method",
-			type: "select",
-			defaultValue: "get",
-			options: [
-				{
-					label: "Get",
-					value: "get"
-				},
-				{
-					label: "Post",
-					value: "post"
-				},
-				{
-					label: "Put",
-					value: "put"
-				},
-				{
-					label: "Delete",
-					value: "delete"
-				},
-				{
-					label: "Patch",
-					value: "patch"
-				},
-				{
-					label: "Head",
-					value: "head"
-				}
-			]
-		},
-		body: {
-			canBind: !0,
-			defaultValue: "",
-			type: "textarea",
-			label: "Body"
-		},
-		authorizationToken: {
-			canBind: !0,
-			defaultValue: "",
-			type: "text",
-			label: "Authorization Token"
-		},
-		credentials: {
-			canBind: !0,
-			defaultValue: "same-origin",
-			type: "select",
-			options: [
-				{
-					label: "Include",
-					value: "include"
-				},
-				{
-					label: "Omit",
-					value: "omit"
-				},
-				{
-					label: "Same Origin",
-					value: "same-origin"
-				}
-			],
-			label: "Credentials"
-		}
-	},
-	preview: { response: {
-		status: "",
-		data: ""
-	} },
-	callback: async (e) => {
-		let { url: t, authorizationToken: n, body: r, credentials: i } = e, { method: a } = e, o = {};
-		try {
-			a = a.toUpperCase();
-			let e = { "Content-Type": "application/json" };
-			n && (e.Authorization = `Bearer ${n}`), Object.values(r).forEach((t) => {
-				if (t instanceof Blob && e["Content-Type"] !== "multipart/form-data") {
-					e["Content-Type"] = "multipart/form-data";
-					return;
-				}
-			});
-			let s = {
-				method: a,
-				headers: e,
-				credentials: i
-			};
-			if (a && !["get", "delete"].includes(a.toLowerCase())) {
-				if (e["Content-Type"] === "application/json") s.body = JSON.stringify(r);
-				else if (e["Content-Type"] === "multipart/form-data") {
-					let e = new FormData();
-					Object.entries(r).forEach(([t, n]) => {
-						e?.append(t, n);
-					}), s.body = e;
-				}
+var a = /* @__PURE__ */ new Set(["GET", "HEAD"]), o = /* @__PURE__ */ new Set([
+	"GET",
+	"HEAD",
+	"DELETE"
+]), 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 = async ({ url: e, authorizationToken: t, body: n, credentials: r }, i) => {
+	try {
+		let a = {
+			"Content-Type": "application/json",
+			...c(t)
+		};
+		Object.values(n).some((e) => e instanceof Blob) && (a["Content-Type"] = "multipart/form-data");
+		let s = {
+			method: i,
+			headers: a,
+			credentials: r
+		};
+		if (!o.has(i)) {
+			if (a["Content-Type"] === "application/json") s.body = JSON.stringify(n);
+			else {
+				let e = new FormData();
+				Object.entries(n).forEach(([t, n]) => {
+					e.append(t, n);
+				}), s.body = e;
 			}
-			let c = await fetch(t, s), l = "";
-			try {
-				l = await c.json();
-			} catch {}
-			o = {
-				status: c.status,
-				data: l
-			};
-		} catch (e) {
-			console.error(e);
 		}
-		return { response: o };
+		let l = await fetch(e, s), u = "";
+		try {
+			u = await l.json();
+		} catch {}
+		return {
+			status: l.status,
+			data: u
+		};
+	} catch (e) {
+		return console.error(e), {};
+	}
+}, u = 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 l(e, t) };
+		let n = i({
+			method: t,
+			url: e.url,
+			credentials: e.credentials,
+			headers: c(e.authorizationToken)
+		});
+		return { response: await r.fetchQuery(n, {
+			meta: { url: e.url },
+			fetcher: () => l(e, t),
+			staleTime: s(e.staleTime),
+			isCacheable: (e) => e.status !== void 0 && e.status < 400
+		}) ?? {} };
 	}
-};
+	let o = await l(e, t);
+	return o.status !== void 0 && o.status >= 200 && o.status < 300 && n({
+		mode: e.invalidateQueries,
+		fallback: "origin",
+		elements: e.invalidateElements,
+		url: e.url
+	}), { response: o };
+});
 //#endregion
-export { e as default };
+export { u as default };

package/dist/utility/webHookSpec.d.ts

@@ -0,0 +1,9 @@
+import { BuiltinActionSpec } from '@plitzi/sdk-shared/authoring/builder';
+/**
+ * The webhook step, as the editor and anything authoring one offline read it.
+ *
+ * A read may be served from the page's query cache — the same one api containers use, under the same key, so a
+ * flow reading a URL a container already loaded does not ask again. A write says what it refreshes once it
+ * succeeded, which by default is every cached request to the site it wrote to.
+ */
+export declare const webHookSpec: BuiltinActionSpec;

package/dist/utility/webHookSpec.mjs

@@ -0,0 +1,79 @@
+import { writeInvalidationParams as e } from "../sources/QueriesSource/writeParams.mjs";
+//#region src/utility/webHookSpec.ts
+var t = (e) => {
+	let t = typeof e.method == "string" ? e.method.toLowerCase() : "get";
+	return t === "get" || t === "head";
+}, n = {
+	title: "Webhook",
+	type: "utility",
+	strictParams: !0,
+	params: {
+		url: {
+			type: "text",
+			description: "The URL to call.",
+			default: "",
+			label: "Url"
+		},
+		method: {
+			type: "select",
+			description: "HTTP method.",
+			default: "get",
+			options: [
+				"get",
+				"post",
+				"put",
+				"delete",
+				"patch",
+				"head"
+			],
+			canBind: !1
+		},
+		body: {
+			type: "textarea",
+			description: "Request body.",
+			default: ""
+		},
+		authorizationToken: {
+			type: "text",
+			description: "Value sent as the Authorization header.",
+			default: ""
+		},
+		credentials: {
+			type: "select",
+			description: "fetch credentials mode.",
+			default: "same-origin",
+			options: [
+				"include",
+				"omit",
+				"same-origin"
+			],
+			optionLabels: { "same-origin": "Same Origin" }
+		},
+		cache: {
+			type: "boolean",
+			description: "Serve a GET from the page’s query cache while it is fresh, and keep the answer there — shared with any api container asking the same thing.",
+			default: !1,
+			label: "Cache response",
+			when: t
+		},
+		staleTime: {
+			type: "number",
+			description: "With `cache`: seconds the answer is served without asking again.",
+			default: 30,
+			label: "Fresh for (s)",
+			when: (e) => t(e) && (e.cache === !0 || e.cache === "true")
+		},
+		...e([
+			"origin",
+			"all",
+			"elements",
+			"none"
+		], (e) => !t(e))
+	},
+	preview: { response: {
+		status: "",
+		data: ""
+	} }
+};
+//#endregion
+export { n as webHookSpec };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/sdk-interactions",
-  "version": "0.35.9",
+  "version": "0.36.0",
   "license": "AGPL-3.0",
   "files": [
     "dist"
@@ -106,6 +106,26 @@
       "types": "./dist/sources/NavigationSource/index.d.ts",
       "import": "./dist/sources/NavigationSource/index.mjs"
     },
+    "./sources/QueriesSource": {
+      "types": "./dist/sources/QueriesSource/index.d.ts",
+      "import": "./dist/sources/QueriesSource/index.mjs"
+    },
+    "./sources/QueriesSource/QueriesInteractions": {
+      "types": "./dist/sources/QueriesSource/QueriesInteractions.d.ts",
+      "import": "./dist/sources/QueriesSource/QueriesInteractions.mjs"
+    },
+    "./sources/QueriesSource/callbacks": {
+      "types": "./dist/sources/QueriesSource/callbacks.d.ts",
+      "import": "./dist/sources/QueriesSource/callbacks.mjs"
+    },
+    "./sources/QueriesSource/index": {
+      "types": "./dist/sources/QueriesSource/index.d.ts",
+      "import": "./dist/sources/QueriesSource/index.mjs"
+    },
+    "./sources/QueriesSource/writeParams": {
+      "types": "./dist/sources/QueriesSource/writeParams.d.ts",
+      "import": "./dist/sources/QueriesSource/writeParams.mjs"
+    },
     "./sources/StateSource": {
       "types": "./dist/sources/StateSource/index.d.ts",
       "import": "./dist/sources/StateSource/index.mjs"
@@ -145,6 +165,10 @@
     "./utility/webHook": {
       "types": "./dist/utility/webHook.d.ts",
       "import": "./dist/utility/webHook.mjs"
+    },
+    "./utility/webHookSpec": {
+      "types": "./dist/utility/webHookSpec.d.ts",
+      "import": "./dist/utility/webHookSpec.mjs"
     }
   },
   "scripts": {
@@ -166,11 +190,11 @@
   },
   "dependencies": {
     "@plitzi/plitzi-ui": "^1.6.21",
-    "@plitzi/sdk-auth": "0.35.9",
-    "@plitzi/sdk-dev-tools": "0.35.9",
-    "@plitzi/sdk-event-bridge": "0.35.9",
-    "@plitzi/sdk-navigation": "0.35.9",
-    "@plitzi/sdk-schema": "0.35.9",
-    "@plitzi/sdk-shared": "0.35.9"
+    "@plitzi/sdk-auth": "0.36.0",
+    "@plitzi/sdk-dev-tools": "0.36.0",
+    "@plitzi/sdk-event-bridge": "0.36.0",
+    "@plitzi/sdk-navigation": "0.36.0",
+    "@plitzi/sdk-schema": "0.36.0",
+    "@plitzi/sdk-shared": "0.36.0"
   }
 }