@plitzi/sdk-shared 0.35.7 → 0.35.9

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/SchemaTypes.d.ts

@@ -155,6 +155,13 @@ export type Schema = {
         sessionGate?: 'optimistic' | 'strict';
         /** How old a confirmation may get before the SDK re-checks on the next focus. Defaults to 300. */
         sessionRevalidateSeconds?: number;
+        /**
+         * Lets the published site open the dev tools — elements, state, interactions — for anybody who visits it.
+         *
+         * The space's own answer, read by a page server that left the decision open: a server that sets `debugMode`
+         * decides for every space it renders, and an explicit `false` there cannot be turned around from here.
+         */
+        devTools?: boolean;
     };
     rsc?: SchemaRsc;
     pages: Element['id'][];

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';
@@ -738,7 +738,9 @@ export type SSRServerConfig = {
     devMode?: boolean;
     /** Authorizes debugging on the pages this server renders. An SSR page loads the very same SDK, so this is the
      *  server-side face of the SDK's `debugMode` prop: the page decides, and the visitor's 'plitzi_debug' cookie can
-     *  only narrow it. Defaults to `devMode`, so a development server debugs without being told to. */
+     *  only narrow it. Left unset, `devMode` authorizes it — a development server debugs without being told to — and
+     *  so does a space whose settings switched `devTools` on. Set, it decides for every space: `false` is a refusal
+     *  no space can turn around. */
     debugMode?: boolean;
     cacheTtlMs?: number;
     loginPath?: string | false;
@@ -853,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.7",
+  "version": "0.35.9",
   "license": "AGPL-3.0",
   "files": [
     "dist",