@plitzi/sdk-shared 0.35.8 → 0.35.9

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @plitzi/sdk-shared
 
+## 0.35.9
+
+### Patch Changes
+
+- Debug a server action's whole flow from the dev-tools, not just its answer.
+
+  A run now reports an OUTLINE of what it did: every step in order, with its task, how it ended, how long it took, and
+  the redacted error of the one that broke the flow — the compensation steps `flow.onFailure` ran included. It carries
+  nothing a step was given or returned, so it goes to any page whose debugging the deployment authorized (`devMode`, or
+  a space that switched dev tools on for its published site) and to no other. The full trace, with each step's results,
+  still reaches only an authoring request or a development server.
+
+  Runs the SERVER started while rendering a page — the ones feeding `runtime: 'server'` elements — reach the dev-tools
+  too, seeded into the page and added to by every `/_rsc` refresh, under the same authorization: a page nobody
+  authorized is not told they happened. A response carrying them is never cached. A run that died on its deadline now
+  reports the step it was on rather than nothing at all.
+
+  The Actions tab was rebuilt around it: filters and search over the log, a run list that names the step that broke,
+  and a detail panel with the flow's timeline, its compensation shown apart, and what the run carried in and out.
+
 ## 0.35.8
 
 ### Patch Changes

package/dist/server/rsc/refreshRsc.mjs

@@ -1,34 +1,35 @@
 import { authFailureFromResponse as e, reportAuthFailure as t } from "../../auth/failureChannel.mjs";
 import { hasServerElements as n } from "../../schema/serverElements.mjs";
-import { getPaths as r, matchRoutePath as i } from "../../navigation/routes.mjs";
+import { recordRenderActionRuns as r } from "../../store/actionRuns/actionRunsRecorder.mjs";
+import { getPaths as i, matchRoutePath as a } from "../../navigation/routes.mjs";
 //#region src/server/rsc/refreshRsc.ts
-var a = (e, t, n) => {
+var o = (e, t, n) => {
 	if (!e) return;
-	let a = e.pages.reduce((t, n) => (n in e.flat && (t[n] = e.flat[n]), t), {});
-	return i(r(a, e.pageFolders, n), t.split("?")[0], n).pageId;
-}, o = (e) => `rsc.data.${e}`, s = () => typeof window > "u" ? "" : `${window.location.pathname}${window.location.search}`, c = async (r, i, c, l) => {
-	let { enabled: u, endpoint: d } = r.get("rsc") ?? {};
-	if (!u || !d || typeof window > "u") return;
-	let f = l ?? s(), p = r.get("schema"), m = r.get("runtime.sources.auth"), h = l ? a(p, l, !!m?.details) : r.get("navigation.currentPageId");
-	if (p && n(p, h)) try {
-		let n = new URLSearchParams({ location: f });
-		i?.length && n.set("ids", i.join(",")), Object.entries(c ?? {}).forEach(([e, t]) => n.set(e, t));
-		let a = await fetch(`${d}?${n.toString()}`, { headers: { Accept: "application/json" } });
-		if (!a.ok) {
-			let n = e(a.status, await a.json().catch(() => void 0));
+	let r = e.pages.reduce((t, n) => (n in e.flat && (t[n] = e.flat[n]), t), {});
+	return a(i(r, e.pageFolders, n), t.split("?")[0], n).pageId;
+}, s = (e) => `rsc.data.${e}`, c = () => typeof window > "u" ? "" : `${window.location.pathname}${window.location.search}`, l = async (i, a, l, u) => {
+	let { enabled: d, endpoint: f } = i.get("rsc") ?? {};
+	if (!d || !f || typeof window > "u") return;
+	let p = u ?? c(), m = i.get("schema"), h = i.get("runtime.sources.auth"), g = u ? o(m, u, !!h?.details) : i.get("navigation.currentPageId");
+	if (m && n(m, g)) try {
+		let n = new URLSearchParams({ location: p });
+		a?.length && n.set("ids", a.join(",")), Object.entries(l ?? {}).forEach(([e, t]) => n.set(e, t));
+		let o = await fetch(`${f}?${n.toString()}`, { headers: { Accept: "application/json" } });
+		if (!o.ok) {
+			let n = e(o.status, await o.json().catch(() => void 0));
 			n && t({
 				reason: n,
-				url: d
-			}), r.set("rsc.stale", !0);
+				url: f
+			}), i.set("rsc.stale", !0);
 			return;
 		}
-		let { serverData: s } = await a.json();
-		r.batch(() => {
-			i?.length ? Object.entries(s ?? {}).forEach(([e, t]) => r.set(o(e), t)) : r.set("rsc.data", s ?? {}), r.set("rsc.loaded", !0), r.set("rsc.stale", !1), r.set("rsc.location", f);
+		let { serverData: c, actionRuns: u } = await o.json();
+		u?.length && r(u), i.batch(() => {
+			a?.length ? Object.entries(c ?? {}).forEach(([e, t]) => i.set(s(e), t)) : i.set("rsc.data", c ?? {}), i.set("rsc.loaded", !0), i.set("rsc.stale", !1), i.set("rsc.location", p);
 		});
 	} catch {
-		r.set("rsc.stale", !0);
+		i.set("rsc.stale", !0);
 	}
 };
 //#endregion
-export { s as currentRscLocation, c as default, c as refreshRsc, o as rscDataPath };
+export { c as currentRscLocation, l as default, l as refreshRsc, s as rscDataPath };

package/dist/store/actionRuns/actionRunsRecorder.d.ts

@@ -1,4 +1,4 @@
-import { ActionRunEntry } from '../../types';
+import { ActionRunEntry, ActionRunSummary } from '../../types';
 /** Registered by whatever started the run, for as long as stopping it means anything. */
 export declare const registerActionCanceller: (id: string, cancel: () => void) => void;
 export declare const releaseActionCanceller: (id: string) => void;
@@ -18,6 +18,15 @@ export declare const cancelActionRun: (id: string) => void;
  * A record that only appeared on success would be missing exactly the runs somebody is looking for.
  */
 export declare const recordActionRun: (entry: Omit<ActionRunEntry, "id" | "startedAt" | "status" | "progress">) => string;
+/**
+ * Records the runs the SERVER did while building this page, or while answering a refresh of part of it.
+ *
+ * Nobody here started them, so without this they are the one kind of run a page cannot see at all — an empty
+ * section and no way to learn why. Deduped by the server's own run id, because a section refreshing itself
+ * re-reports a run that was joined or reused rather than started again: the same run twice would leave a person
+ * comparing two entries that are one.
+ */
+export declare const recordRenderActionRuns: (summaries: ActionRunSummary[]) => void;
 /** How it ended, or what it reported on the way. Unknown ids are ignored: a swept-out run is not an error. */
 export declare const updateActionRun: (id: string, patch: Partial<Omit<ActionRunEntry, "id">>) => void;
 /**

package/dist/store/actionRuns/actionRunsRecorder.mjs

@@ -17,23 +17,38 @@ var t = 0, n = (t) => e.setState("runs", t), r = /* @__PURE__ */ new Map(), i =
 		progress: [],
 		cancellable: !0
 	}, ...e.getState().runs].slice(0, 100)), i;
-}, c = (t, r) => {
+}, c = (e) => ({
+	id: `render-${e.runId}`,
+	actionId: e.actionId,
+	mode: "render",
+	runId: e.runId,
+	status: e.status,
+	steps: e.steps,
+	progress: [],
+	startedAt: e.startedAt,
+	endedAt: e.endedAt,
+	...e.error === void 0 ? {} : { error: e.error },
+	...e.elementId === void 0 ? {} : { elementId: e.elementId }
+}), l = (t) => {
+	let { runs: r } = e.getState(), i = new Set(r.map((e) => e.runId)), a = t.filter((e) => !i.has(e.runId)).map(c);
+	a.length !== 0 && n([...a.reverse(), ...r].slice(0, 100));
+}, u = (t, r) => {
 	let { runs: i } = e.getState();
 	i.some((e) => e.id === t) && n(i.map((e) => e.id === t ? {
 		...e,
 		...r
 	} : e));
-}, l = (t, r) => {
+}, d = (t, r) => {
 	let { runs: i } = e.getState();
 	n(i.map((e) => e.id === t ? {
 		...e,
 		progress: [...e.progress, r].slice(-500)
 	} : e));
-}, u = () => {
+}, f = () => {
 	let t = new Set(e.getState().runs.filter((e) => e.cancellable).map((e) => e.id));
 	[...r.keys()].forEach((e) => {
 		t.has(e) || r.delete(e);
 	}), n([]);
 };
 //#endregion
-export { o as cancelActionRun, u as clearActionRuns, l as recordActionProgress, s as recordActionRun, i as registerActionCanceller, a as releaseActionCanceller, c as updateActionRun };
+export { o as cancelActionRun, f as clearActionRuns, d as recordActionProgress, s as recordActionRun, l as recordRenderActionRuns, i as registerActionCanceller, a as releaseActionCanceller, u as updateActionRun };

package/dist/store/actionRuns/index.d.ts

@@ -1,6 +1,6 @@
 import { default as actionRunsStore } from './actionRunsStore';
 import { default as useActionRuns } from './useActionRuns';
 export { MAX_RUNS, createActionRunsState } from './actionRunsStore';
-export { cancelActionRun, clearActionRuns, recordActionProgress, recordActionRun, registerActionCanceller, releaseActionCanceller, updateActionRun } from './actionRunsRecorder';
+export { cancelActionRun, clearActionRuns, recordActionProgress, recordActionRun, recordRenderActionRuns, registerActionCanceller, releaseActionCanceller, updateActionRun } from './actionRunsRecorder';
 export type { UseActionRunsReturn } from './useActionRuns';
 export { actionRunsStore, useActionRuns };

package/dist/store/actionRuns/index.mjs

@@ -1,4 +1,4 @@
 import e, { MAX_RUNS as t, createActionRunsState as n } from "./actionRunsStore.mjs";
-import { cancelActionRun as r, clearActionRuns as i, recordActionProgress as a, recordActionRun as o, registerActionCanceller as s, releaseActionCanceller as c, updateActionRun as l } from "./actionRunsRecorder.mjs";
-import u from "./useActionRuns.mjs";
-export { t as MAX_RUNS, e as actionRunsStore, r as cancelActionRun, i as clearActionRuns, n as createActionRunsState, a as recordActionProgress, o as recordActionRun, s as registerActionCanceller, c as releaseActionCanceller, l as updateActionRun, u as useActionRuns };
+import { cancelActionRun as r, clearActionRuns as i, recordActionProgress as a, recordActionRun as o, recordRenderActionRuns as s, registerActionCanceller as c, releaseActionCanceller as l, updateActionRun as u } from "./actionRunsRecorder.mjs";
+import d from "./useActionRuns.mjs";
+export { t as MAX_RUNS, e as actionRunsStore, r as cancelActionRun, i as clearActionRuns, n as createActionRunsState, a as recordActionProgress, o as recordActionRun, s as recordRenderActionRuns, c as registerActionCanceller, l as releaseActionCanceller, u as updateActionRun, d as useActionRuns };

package/dist/store/index.d.ts

@@ -192,4 +192,4 @@ export declare const useBuilderStore: {
     <P extends "style" | "displayMode" | "runtime" | "schema" | "segments" | "render" | "styleVariant" | "rsc" | "navigation" | "actions" | "styleSelector" | "selector" | "styleState" | "theme" | "render.previewMode" | "render.debugMode" | "render.renderMode" | "render.environment" | "render.isHydrating" | "render.hydrated" | "render.overQuota" | "render.testAttributes" | "prevSchema" | "pageDefinitions" | "sources" | "style.mode" | "style.variables" | "style.platform" | "style.cache" | "style.theme" | "style.fonts" | "style.variables.color" | "style.variables.spacing" | "style.variables.shadow" | "style.variables.custom" | "style.platform.desktop" | "style.platform.tablet" | "style.platform.mobile" | `style.platform.desktop.${string}` | `style.platform.tablet.${string}` | `style.platform.mobile.${string}` | "style.theme.default" | "style.theme.schemes" | `style.theme.schemes.${number}` | `style.fonts.${number}` | `style.fonts.${number}.display` | `style.fonts.${number}.fallback` | `style.fonts.${number}.stylesheet` | `style.fonts.${number}.preload` | `style.fonts.${number}.source` | `style.fonts.${number}.family` | `style.fonts.${number}.files` | `style.fonts.${number}.weights` | `style.fonts.${number}.styles` | `style.fonts.${number}.subsets` | `style.fonts.${number}.weights.${number}` | `style.fonts.${number}.styles.${number}` | `style.fonts.${number}.subsets.${number}` | `style.fonts.${number}.files.${number}` | `style.fonts.${number}.files.${number}.style` | `style.fonts.${number}.files.${number}.format` | `style.fonts.${number}.files.${number}.weight` | `style.fonts.${number}.files.${number}.unicodeRange` | `style.fonts.${number}.files.${number}.url` | `style.fonts.${number}.files.${number}.path` | `sources.${string}` | "runtime.host" | "runtime.state" | "runtime.elements" | "runtime.sources" | `runtime.host.${string}` | `runtime.state.${string}` | `runtime.elements.${string}` | `runtime.sources.${string}` | "rsc.enabled" | "schema.flat" | "schema.definition" | "schema.settings" | "schema.rsc" | "schema.variables" | "schema.pages" | "schema.pageFolders" | `schema.flat.${string}` | "schema.definition.name" | "schema.definition.permanentUrl" | "schema.settings.keepState" | "schema.settings.stateStorage" | "schema.settings.customCss" | "schema.settings.userProvider" | "schema.settings.tokenStorage" | "schema.settings.loginUrl" | "schema.settings.userUrl" | "schema.settings.refreshUrl" | "schema.settings.logoutUrl" | "schema.settings.detailsPath" | "schema.settings.tokenPath" | "schema.settings.refreshTokenPath" | "schema.settings.expirationTimePath" | "schema.settings.refreshExpirationTimePath" | "schema.settings.sessionHintCookie" | "schema.settings.sessionExchangeUrl" | "schema.settings.sessionGate" | "schema.settings.sessionRevalidateSeconds" | "schema.settings.devTools" | "schema.rsc.enabled" | "schema.rsc.transport" | `schema.variables.${number}` | `schema.variables.${number}.type` | `schema.variables.${number}.name` | `schema.variables.${number}.value` | `schema.variables.${number}.category` | `schema.variables.${number}.subValues` | `schema.variables.${number}.subValues.${number}` | `schema.variables.${number}.subValues.${number}.value` | `schema.variables.${number}.subValues.${number}.when` | `schema.variables.${number}.subValues.${number}.when.id` | `schema.variables.${number}.subValues.${number}.when.enabled` | `schema.variables.${number}.subValues.${number}.when.combinator` | `schema.variables.${number}.subValues.${number}.when.rules` | `schema.variables.${number}.subValues.${number}.when.rules.${number}` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.id` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.field` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.operator` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.enabled` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.isBinding` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.toString` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.toLocaleString` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.valueOf` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.toDateString` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.toTimeString` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.toLocaleDateString` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.toLocaleTimeString` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getTime` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getFullYear` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCFullYear` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getMonth` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCMonth` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getDate` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCDate` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getDay` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCDay` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getHours` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCHours` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getMinutes` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCMinutes` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getSeconds` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCSeconds` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getMilliseconds` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCMilliseconds` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.getTimezoneOffset` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setTime` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setMilliseconds` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setUTCMilliseconds` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setSeconds` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setUTCSeconds` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setMinutes` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setUTCMinutes` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setHours` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setUTCHours` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setDate` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setUTCDate` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setMonth` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setUTCMonth` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setFullYear` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.setUTCFullYear` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.toUTCString` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.toISOString` | `schema.variables.${number}.subValues.${number}.when.rules.${number}.value.toJSON` | `schema.pages.${number}` | `schema.pageFolders.${number}` | `schema.pageFolders.${number}.id` | `schema.pageFolders.${number}.name` | `schema.pageFolders.${number}.parentId` | `schema.pageFolders.${number}.slug` | `segments.${string}` | "rsc.data" | "rsc.endpoint" | "rsc.loaded" | "rsc.stale" | "rsc.location" | "navigation.routeParams" | "navigation.queryParams" | "navigation.hostname" | "navigation.urlSearchParams" | "navigation.origin" | "navigation.currentPageId" | "navigation.navigate" | `navigation.routeParams.${string}` | `navigation.queryParams.${string}` | "navigation.urlSearchParams.toString" | "navigation.urlSearchParams.sort" | "navigation.urlSearchParams.forEach" | "navigation.urlSearchParams.entries" | "navigation.urlSearchParams.keys" | "navigation.urlSearchParams.values" | "navigation.urlSearchParams.set" | "navigation.urlSearchParams.delete" | "navigation.urlSearchParams.append" | "navigation.urlSearchParams.get" | "navigation.urlSearchParams.has" | "navigation.urlSearchParams.getAll" | "navigation.urlSearchParams.size" | "actions.endpoint" | "actions.catalog" | "actions.available" | `actions.catalog.${number}` | `actions.catalog.${number}.name` | `actions.catalog.${number}.input` | `actions.catalog.${number}.identifier` | "theme.mode" | "theme.resolved" | "theme.areas" | `theme.areas.${string}` | "prevSchema.flat" | "prevSchema.definition" | "prevSchema.settings" | "prevSchema.rsc" | "prevSchema.variables" | "prevSchema.pages" | "prevSchema.pageFolders" | `prevSchema.flat.${string}` | "prevSchema.definition.name" | "prevSchema.definition.permanentUrl" | "prevSchema.settings.keepState" | "prevSchema.settings.stateStorage" | "prevSchema.settings.customCss" | "prevSchema.settings.userProvider" | "prevSchema.settings.tokenStorage" | "prevSchema.settings.loginUrl" | "prevSchema.settings.userUrl" | "prevSchema.settings.refreshUrl" | "prevSchema.settings.logoutUrl" | "prevSchema.settings.detailsPath" | "prevSchema.settings.tokenPath" | "prevSchema.settings.refreshTokenPath" | "prevSchema.settings.expirationTimePath" | "prevSchema.settings.refreshExpirationTimePath" | "prevSchema.settings.sessionHintCookie" | "prevSchema.settings.sessionExchangeUrl" | "prevSchema.settings.sessionGate" | "prevSchema.settings.sessionRevalidateSeconds" | "prevSchema.settings.devTools" | "prevSchema.rsc.enabled" | "prevSchema.rsc.transport" | `prevSchema.variables.${number}` | `prevSchema.variables.${number}.type` | `prevSchema.variables.${number}.name` | `prevSchema.variables.${number}.value` | `prevSchema.variables.${number}.category` | `prevSchema.variables.${number}.subValues` | `prevSchema.variables.${number}.subValues.${number}` | `prevSchema.variables.${number}.subValues.${number}.value` | `prevSchema.variables.${number}.subValues.${number}.when` | `prevSchema.variables.${number}.subValues.${number}.when.id` | `prevSchema.variables.${number}.subValues.${number}.when.enabled` | `prevSchema.variables.${number}.subValues.${number}.when.combinator` | `prevSchema.variables.${number}.subValues.${number}.when.rules` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.id` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.field` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.operator` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.enabled` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.isBinding` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.toString` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.toLocaleString` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.valueOf` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.toDateString` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.toTimeString` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.toLocaleDateString` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.toLocaleTimeString` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getTime` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getFullYear` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCFullYear` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getMonth` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCMonth` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getDate` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCDate` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getDay` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCDay` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getHours` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCHours` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getMinutes` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCMinutes` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getSeconds` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCSeconds` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getMilliseconds` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getUTCMilliseconds` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.getTimezoneOffset` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setTime` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setMilliseconds` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setUTCMilliseconds` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setSeconds` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setUTCSeconds` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setMinutes` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setUTCMinutes` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setHours` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setUTCHours` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setDate` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setUTCDate` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setMonth` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setUTCMonth` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setFullYear` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.setUTCFullYear` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.toUTCString` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.toISOString` | `prevSchema.variables.${number}.subValues.${number}.when.rules.${number}.value.toJSON` | `prevSchema.pages.${number}` | `prevSchema.pageFolders.${number}` | `prevSchema.pageFolders.${number}.id` | `prevSchema.pageFolders.${number}.name` | `prevSchema.pageFolders.${number}.parentId` | `prevSchema.pageFolders.${number}.slug` | `pageDefinitions.${string}` | "collaboration" | "connectors" | "hasServerRendering" | "urlTest" | "elementHovered" | "elementSelected" | "setHovered" | "setSelected" | "collaboration.collaborators" | "collaboration.pointers" | `collaboration.collaborators.${number}` | `collaboration.collaborators.${number}.color` | `collaboration.collaborators.${number}.user` | `collaboration.collaborators.${number}.instanceId` | `collaboration.collaborators.${number}.elementState` | `collaboration.collaborators.${number}.user.firstName` | `collaboration.collaborators.${number}.user.surName` | `collaboration.collaborators.${number}.elementState.hovered` | `collaboration.collaborators.${number}.elementState.selected` | `collaboration.collaborators.${number}.elementState.hovered.rootId` | `collaboration.collaborators.${number}.elementState.hovered.elementId` | `collaboration.collaborators.${number}.elementState.selected.rootId` | `collaboration.collaborators.${number}.elementState.selected.elementId` | `collaboration.pointers.${string}` | `connectors.${string}` | "urlTest.routeParams" | "urlTest.queryParams" | "urlTest.hostname" | `urlTest.routeParams.${string}` | `urlTest.queryParams.${string}`>(basePath: P, options?: import('@plitzi/nexus').UseStoreSetterOptions<BuilderState> | undefined): import('@plitzi/nexus').SetFromBaseFn<P extends `${infer K}.${infer Rest}` ? K extends "displayMode" | "styleVariant" | "styleSelector" | "selector" | "styleState" | keyof CommonState | "collaboration" | "connectors" | "hasServerRendering" | "urlTest" | "elementHovered" | "elementSelected" | "setHovered" | "setSelected" ? NonNullable<BuilderState>[K] extends (infer U)[] ? Rest extends `${number}.${infer R}` ? import('@plitzi/nexus').PathValue<U, R> : Rest extends `${number}` ? U : never : import('@plitzi/nexus').PathValue<NonNullable<BuilderState>[K], Rest> : never : P extends "displayMode" | "styleVariant" | "styleSelector" | "selector" | "styleState" | keyof CommonState | "collaboration" | "connectors" | "hasServerRendering" | "urlTest" | "elementHovered" | "elementSelected" | "setHovered" | "setSelected" ? NonNullable<BuilderState>[P] : never>;
 };
 export { default as useRenderSettings, useRenderOverride, DEFAULT_RENDER_SETTINGS } from './renderSettings';
-export { actionRunsStore, cancelActionRun, clearActionRuns, recordActionProgress, recordActionRun, registerActionCanceller, releaseActionCanceller, updateActionRun, useActionRuns } from './actionRuns';
+export { actionRunsStore, cancelActionRun, clearActionRuns, recordActionProgress, recordActionRun, recordRenderActionRuns, registerActionCanceller, releaseActionCanceller, updateActionRun, useActionRuns } from './actionRuns';

package/dist/store/index.mjs

@@ -1,9 +1,9 @@
 import e, { DEFAULT_RENDER_SETTINGS as t, useRenderOverride as n } from "./renderSettings.mjs";
 import r from "./actionRuns/actionRunsStore.mjs";
-import { cancelActionRun as i, clearActionRuns as a, recordActionProgress as o, recordActionRun as s, registerActionCanceller as c, releaseActionCanceller as l, updateActionRun as u } from "./actionRuns/actionRunsRecorder.mjs";
-import d from "./actionRuns/useActionRuns.mjs";
-import { createStoreHook as f } from "@plitzi/nexus/react";
+import { cancelActionRun as i, clearActionRuns as a, recordActionProgress as o, recordActionRun as s, recordRenderActionRuns as c, registerActionCanceller as l, releaseActionCanceller as u, updateActionRun as d } from "./actionRuns/actionRunsRecorder.mjs";
+import f from "./actionRuns/useActionRuns.mjs";
+import { createStoreHook as p } from "@plitzi/nexus/react";
 //#region src/store/index.ts
-var { useStore: p, useStoreSync: m, useStoreGetter: h, useStoreSetter: g } = f(), { useStore: _, useStoreSync: v, useStoreGetter: y, useStoreSetter: b } = f(), { useStore: x, useStoreSync: S, useStoreGetter: C, useStoreSetter: w } = f();
+var { useStore: m, useStoreSync: h, useStoreGetter: g, useStoreSetter: _ } = p(), { useStore: v, useStoreSync: y, useStoreGetter: b, useStoreSetter: x } = p(), { useStore: S, useStoreSync: C, useStoreGetter: w, useStoreSetter: T } = p();
 //#endregion
-export { t as DEFAULT_RENDER_SETTINGS, r as actionRunsStore, i as cancelActionRun, a as clearActionRuns, o as recordActionProgress, s as recordActionRun, c as registerActionCanceller, l as releaseActionCanceller, u as updateActionRun, d as useActionRuns, x as useBuilderStore, C as useBuilderStoreGetter, w as useBuilderStoreSetter, S as useBuilderStoreSync, p as useCommonStore, h as useCommonStoreGetter, g as useCommonStoreSetter, m as useCommonStoreSync, n as useRenderOverride, e as useRenderSettings, _ as useSdkStore, y as useSdkStoreGetter, b as useSdkStoreSetter, v as useSdkStoreSync };
+export { t as DEFAULT_RENDER_SETTINGS, r as actionRunsStore, i as cancelActionRun, a as clearActionRuns, o as recordActionProgress, s as recordActionRun, c as recordRenderActionRuns, l as registerActionCanceller, u as releaseActionCanceller, d as updateActionRun, f as useActionRuns, S as useBuilderStore, w as useBuilderStoreGetter, T as useBuilderStoreSetter, C as useBuilderStoreSync, m as useCommonStore, g as useCommonStoreGetter, _ as useCommonStoreSetter, h as useCommonStoreSync, n as useRenderOverride, e as useRenderSettings, v as useSdkStore, b as useSdkStoreGetter, x as useSdkStoreSetter, y as useSdkStoreSync };

package/dist/types/ActionTypes.d.ts

@@ -1,4 +1,5 @@
 import { Environment } from './CommonTypes';
+import { InteractionNodeStatus } from './InteractionTypes';
 import { ElementInteraction } from './SchemaTypes';
 import { SmtpSettings } from '../actions/smtp';
 /**
@@ -314,6 +315,45 @@ export type ActionRunRecord = {
     /** Present when the run ended badly. Already redacted of credential values. */
     error?: string;
 };
+/**
+ * One step of a server action run, as a debugger may show it to anybody allowed to debug the page.
+ *
+ * What ran, in what order, how it ended and how long it took — never what the step was given or what it returned.
+ * Those can hold another visitor's data or a flow's internals (an endpoint, a query), so they stay in the full trace,
+ * which only authoring requests and development servers receive.
+ */
+export type ActionRunStep = {
+    id: string;
+    title: string;
+    /** The task it ran, e.g. `kv.increment`. */
+    action: string;
+    status: InteractionNodeStatus;
+    /** `undo` for `flow.onFailure` and the steps after it: they ran because the flow before them failed. */
+    phase: 'flow' | 'undo';
+    startTime: number;
+    endTime: number;
+    /** Why it failed, redacted of every credential value the run resolved. */
+    error?: string;
+};
+/**
+ * A run a page RENDER started, reported to a page whose debugging is authorized.
+ *
+ * Nobody in the browser sent it — the server ran it while building the page, or while answering a refresh — so this is
+ * the only way it reaches a debugger. The same outline a call reports, and nothing more.
+ */
+export type ActionRunSummary = {
+    actionId: string;
+    runId: string;
+    trigger: 'render';
+    status: ActionRunStatus;
+    /** The server element it fed. */
+    elementId?: string;
+    startedAt: number;
+    endedAt: number;
+    steps: ActionRunStep[];
+    /** Why a run ended before its steps could say — a deadline, a refusal. Never a provider's own message. */
+    error?: string;
+};
 /**
  * One message a flow asked to send.
  *

package/dist/types/ServerTypes.d.ts

@@ -1,4 +1,4 @@
-import { ActionEmailConfig, ActionEntry, ActionLimits, ActionRejectReason, ActionRejectRecord, ActionRunRecord, ActionRunStatus, ActionTaskDescriptor, ActionTriggerType } from './ActionTypes';
+import { ActionEmailConfig, ActionEntry, ActionLimits, ActionRejectReason, ActionRunSummary, ActionRejectRecord, ActionRunRecord, ActionRunStatus, ActionTaskDescriptor, ActionTriggerType } from './ActionTypes';
 import { Environment } from './CommonTypes';
 import { ConnectorEntry } from './ConnectorTypes';
 import { Schema } from './SchemaTypes';
@@ -855,6 +855,11 @@ export type SSRContext = {
     /** What {@link SSRAdapters.meter} answered for this request, so the render reads the decision instead of
      *  asking for it a second time. */
     meter?: SSRMeterDecision;
+    /**
+     * The runs this request's server elements started, as the action resolver ran them. Read once the render or the
+     * refresh is done, and handed on only to a page whose debugging is authorized.
+     */
+    actionRuns?: ActionRunSummary[];
 };
 export type SSRServer = {
     listen: (port: number, host?: string) => void;

package/dist/types/StoreTypes.d.ts

@@ -1,4 +1,4 @@
-import { ActionField } from './ActionTypes';
+import { ActionField, ActionRunStep } from './ActionTypes';
 import { SubscriptionCollaborator, SubscriptionCollaboratorPointer } from './BuilderTypes';
 import { Environment, RenderMode } from './CommonTypes';
 import { Source } from './DataSourceTypes';
@@ -256,15 +256,16 @@ export type TracingTree = Record<string, TracingTreeNode>;
  * One server action this page started, as the dev-tools show it back.
  *
  * Recorded by the `runServerAction` step itself, so it covers what no network tab makes legible: which action was
- * named, in which mode, what the server answered, and — when the deployment is a dev one, which is the only time
- * the server sends it — the STEPS the flow ran on the other side. A `detached` run has no answer to await and a
- * `stream` returns before its frames arrive, so both are invisible without a record of their own.
+ * named, in which mode, what the server answered, and — when debugging this page is authorized — the STEPS the flow
+ * ran on the other side. A `detached` run has no answer to await and a `stream` returns before its frames arrive, so
+ * both are invisible without a record of their own; a `render` run is invisible by nature, since the server did it
+ * while building the page and no step here ever called it.
  */
 export type ActionRunEntry = {
     /** Local to this page: assigned when the run is SENT, which is before any server run id exists. */
     id: string;
     actionId: string;
-    mode: 'await' | 'detached' | 'stream';
+    mode: 'await' | 'detached' | 'stream' | 'render';
     /** The server's own id, once it answers. Absent for a run that never reached one. */
     runId?: string;
     status: 'running' | 'completed' | 'failed' | 'accepted' | 'streaming' | 'skipped' | 'aborted';
@@ -276,7 +277,16 @@ export type ActionRunEntry = {
     output?: Record<string, unknown>;
     /** Chunks a streaming run emitted, in order. */
     progress: unknown[];
-    /** The server-side steps, when the deployment sent them: authoring requests and dev servers only. */
+    /**
+     * What the flow DID, step by step — its order, each step's outcome, and the one that broke it.
+     *
+     * Sent to any page whose debugging is authorized, because it says nothing a step was given or returned: those
+     * are in the trace below.
+     */
+    steps?: ActionRunStep[];
+    /** The server element a `render` run fed. A page has several, and each is a different flow. */
+    elementId?: string;
+    /** The steps WITH what each one read and answered. Authoring requests and dev servers only. */
     trace?: Record<string, unknown>[];
     /**
      * Whether this run can still be stopped from the panel.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plitzi/sdk-shared",
-  "version": "0.35.8",
+  "version": "0.35.9",
   "license": "AGPL-3.0",
   "files": [
     "dist",