@nice-code/action 0.8.0 → 0.9.0

package/build/ActionDevtoolsCore-B4s6aGvI.d.ts

@@ -0,0 +1,79 @@
+import { Bn as IRuntimeCoordinate, _ as TActionProgress } from "./ActionPayload.types-D28ELKXC.js";
+//#region ../nice-devtools-shared/src/components/PanelChrome.d.ts
+/** Where a devtools panel is docked. */
+type TDevtoolsPosition = "dock-bottom" | "dock-top" | "dock-left" | "dock-right";
+//#endregion
+//#region src/devtools/core/ActionDevtools.types.d.ts
+type TDevtoolsActionStatus = "running" | "success" | "action-error" | "failed" | "aborted";
+interface IDevtoolsRouteItem {
+  runtime: IRuntimeCoordinate;
+  handlerType: "local" | "external";
+  handlerClient?: {
+    envId: string;
+    perId?: string;
+    insId?: string;
+  };
+  /** Transport type string (e.g. "http", "ws", "custom"). */
+  transport?: string;
+  /** Short transport summary for chips (e.g. "POST /resolve_action"). */
+  transportSummary?: string;
+  /** Resolved endpoint (request URL / WebSocket URL), when available. */
+  transportUrl?: string;
+  time: number;
+  label?: string;
+}
+interface IDevtoolsActionMeta {
+  timeCreated: number;
+  originClient: {
+    envId: string;
+    perId?: string;
+    insId?: string;
+  };
+  routing: IDevtoolsRouteItem[];
+}
+interface IDevtoolsActionEntry {
+  cuid: string;
+  actionId: string;
+  domain: string;
+  allDomains: string[];
+  status: TDevtoolsActionStatus;
+  startTime: number;
+  endTime?: number;
+  input: unknown;
+  inputHash?: string;
+  output?: unknown;
+  outputHash?: string;
+  error?: unknown;
+  abortReason?: unknown;
+  progressUpdates: TActionProgress[];
+  meta: IDevtoolsActionMeta;
+  parentCuid?: string;
+  callSite?: string;
+  errorStack?: string;
+}
+type TDevtoolsListener = (entries: readonly IDevtoolsActionEntry[]) => void;
+interface IDevtoolsObservableDomain {
+  domain: string;
+  addActionListener(listener: (update: any) => void): () => void;
+}
+//#endregion
+//#region src/devtools/core/ActionDevtoolsCore.d.ts
+interface IActionDevtoolsCoreOptions {
+  /** Max root entries to retain. Older entries (and their children) are evicted. */
+  maxEntries?: number;
+}
+declare class ActionDevtoolsCore {
+  private _entries;
+  private _listeners;
+  private readonly _maxEntries;
+  constructor(options?: IActionDevtoolsCoreOptions);
+  attachToDomain(domain: IDevtoolsObservableDomain): () => void;
+  getEntries(): readonly IDevtoolsActionEntry[];
+  subscribe(listener: TDevtoolsListener): () => void;
+  clear(): void;
+  private _updateEntry;
+  private _notify;
+}
+//#endregion
+export { TDevtoolsActionStatus as a, IDevtoolsObservableDomain as i, IActionDevtoolsCoreOptions as n, TDevtoolsListener as o, IDevtoolsActionEntry as r, TDevtoolsPosition as s, ActionDevtoolsCore as t };
+//# sourceMappingURL=ActionDevtoolsCore-B4s6aGvI.d.ts.map

package/build/ActionDevtoolsCore-BLeY_N-3.js

@@ -0,0 +1,159 @@
+require("./RunningAction.types-DjCX1xp5.js");
+//#region src/devtools/core/ActionDevtoolsCore.ts
+function serializeErrorForDisplay(error) {
+	if (error != null && typeof error === "object" && error.name === "NiceError" && typeof error.toJsonObject === "function") return error.toJsonObject();
+	return error;
+}
+function extractRouting(context) {
+	return (context?.routing ?? []).map((item) => {
+		const handler = item.handler;
+		const isExternal = handler?.type === "external";
+		return {
+			runtime: {
+				envId: item.runtime?.envId ?? "unknown",
+				perId: item.runtime?.perId,
+				insId: item.runtime?.insId
+			},
+			handlerType: isExternal ? "external" : "local",
+			handlerClient: isExternal && handler.client != null ? {
+				envId: handler.client.envId ?? "unknown",
+				perId: handler.client.perId,
+				insId: handler.client.insId
+			} : void 0,
+			transport: isExternal ? handler.transType : void 0,
+			transportSummary: isExternal ? handler.transInfo?.summary : void 0,
+			transportUrl: isExternal ? handler.transInfo?.url : void 0,
+			time: item.time
+		};
+	});
+}
+function extractMeta(context) {
+	return {
+		timeCreated: context?.timeCreated ?? Date.now(),
+		originClient: {
+			envId: context?.originClient?.envId ?? "unknown",
+			perId: context?.originClient?.perId,
+			insId: context?.originClient?.insId
+		},
+		routing: extractRouting(context)
+	};
+}
+var ActionDevtoolsCore = class {
+	_entries = [];
+	_listeners = /* @__PURE__ */ new Set();
+	_maxEntries;
+	constructor(options = {}) {
+		this._maxEntries = options.maxEntries ?? 500;
+	}
+	attachToDomain(domain) {
+		return domain.addActionListener((update) => {
+			const { runningAction, type, time } = update;
+			if (type === "started") {
+				const entry = {
+					cuid: runningAction.cuid,
+					actionId: runningAction.id,
+					domain: runningAction.domain,
+					allDomains: [...runningAction.allDomains],
+					status: "running",
+					startTime: time,
+					input: runningAction.state?.request?.input,
+					inputHash: runningAction.state?.request?.inputHash,
+					progressUpdates: [],
+					meta: extractMeta(runningAction.context),
+					parentCuid: runningAction.parentCuid,
+					callSite: runningAction.callSite
+				};
+				this._entries = [entry, ...this._entries];
+				if (this._entries.length > this._maxEntries) this._entries.length = this._maxEntries;
+				this._notify();
+			} else if (type === "progress") this._updateEntry(runningAction.cuid, (e) => ({
+				...e,
+				progressUpdates: [...e.progressUpdates, update.progress]
+			}));
+			else if (type === "finished") this._updateEntry(runningAction.cuid, (e) => {
+				const responseRouting = extractRouting(update.response?.context);
+				const localRouting = extractRouting(runningAction.context);
+				const routing = responseRouting.length >= localRouting.length ? responseRouting : localRouting;
+				const base = {
+					...e,
+					endTime: time,
+					meta: {
+						...e.meta,
+						routing
+					}
+				};
+				const finishType = update.finishType;
+				if (finishType === "success") {
+					const result = update.response?.result;
+					const outputHash = update.response?.outputHash;
+					if (result != null && !result.ok) {
+						const rawError = result.error;
+						const errorStack = rawError instanceof Error ? rawError.stack : void 0;
+						return {
+							...base,
+							status: "action-error",
+							outputHash,
+							error: serializeErrorForDisplay(rawError),
+							errorStack
+						};
+					}
+					return {
+						...base,
+						status: "success",
+						output: result?.output,
+						outputHash
+					};
+				}
+				if (finishType === "failed") {
+					const rawError = update.error;
+					const errorStack = rawError instanceof Error ? rawError.stack : void 0;
+					return {
+						...base,
+						status: "failed",
+						error: serializeErrorForDisplay(rawError),
+						errorStack
+					};
+				}
+				const abortReason = update.reason;
+				const errorStack = abortReason instanceof Error ? abortReason.stack : void 0;
+				return {
+					...base,
+					status: "aborted",
+					abortReason: serializeErrorForDisplay(abortReason),
+					errorStack
+				};
+			});
+		});
+	}
+	getEntries() {
+		return this._entries;
+	}
+	subscribe(listener) {
+		this._listeners.add(listener);
+		listener(this._entries);
+		return () => {
+			this._listeners.delete(listener);
+		};
+	}
+	clear() {
+		this._entries = [];
+		this._notify();
+	}
+	_updateEntry(cuid, updater) {
+		this._entries = this._entries.map((e) => e.cuid === cuid ? updater(e) : e);
+		this._notify();
+	}
+	_notify() {
+		const snapshot = this._entries;
+		for (const listener of this._listeners) listener(snapshot);
+	}
+};
+//#endregion
+Object.defineProperty(exports, "ActionDevtoolsCore", {
+	enumerable: true,
+	get: function() {
+		return ActionDevtoolsCore;
+	}
+});
+
+//# sourceMappingURL=ActionDevtoolsCore-BLeY_N-3.js.map

package/build/ActionDevtoolsCore-BLeY_N-3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionDevtoolsCore-BLeY_N-3.js","names":[],"sources":["../src/devtools/core/ActionDevtoolsCore.ts"],"sourcesContent":["import {\r\n  ERunningActionFinishedType,\r\n  ERunningActionUpdateType,\r\n} from \"../../ActionDefinition/Action/RunningAction.types\";\r\nimport type {\r\n  IDevtoolsActionEntry,\r\n  IDevtoolsActionMeta,\r\n  IDevtoolsObservableDomain,\r\n  IDevtoolsRouteItem,\r\n  TDevtoolsListener,\r\n} from \"./ActionDevtools.types\";\r\n\r\nexport interface IActionDevtoolsCoreOptions {\r\n  /** Max root entries to retain. Older entries (and their children) are evicted. */\r\n  maxEntries?: number;\r\n}\r\n\r\nfunction serializeErrorForDisplay(error: unknown): unknown {\r\n  if (\r\n    error != null &&\r\n    typeof error === \"object\" &&\r\n    (error as any).name === \"NiceError\" &&\r\n    typeof (error as any).toJsonObject === \"function\"\r\n  ) {\r\n    return (error as any).toJsonObject();\r\n  }\r\n  return error;\r\n}\r\n\r\nfunction extractRouting(context: any): IDevtoolsRouteItem[] {\r\n  return (context?.routing ?? []).map((item: any): IDevtoolsRouteItem => {\r\n    const handler = item.handler;\r\n    const isExternal = handler?.type === \"external\";\r\n    return {\r\n      runtime: {\r\n        envId: item.runtime?.envId ?? \"unknown\",\r\n        perId: item.runtime?.perId,\r\n        insId: item.runtime?.insId,\r\n      },\r\n      handlerType: isExternal ? \"external\" : \"local\",\r\n      handlerClient:\r\n        isExternal && handler.client != null\r\n          ? {\r\n              envId: handler.client.envId ?? \"unknown\",\r\n              perId: handler.client.perId,\r\n              insId: handler.client.insId,\r\n            }\r\n          : undefined,\r\n      transport: isExternal ? handler.transType : undefined,\r\n      transportSummary: isExternal ? handler.transInfo?.summary : undefined,\r\n      transportUrl: isExternal ? handler.transInfo?.url : undefined,\r\n      time: item.time,\r\n    };\r\n  });\r\n}\r\n\r\nfunction extractMeta(context: any): IDevtoolsActionMeta {\r\n  return {\r\n    timeCreated: context?.timeCreated ?? Date.now(),\r\n    originClient: {\r\n      envId: context?.originClient?.envId ?? \"unknown\",\r\n      perId: context?.originClient?.perId,\r\n      insId: context?.originClient?.insId,\r\n    },\r\n    routing: extractRouting(context),\r\n  };\r\n}\r\n\r\nexport class ActionDevtoolsCore {\r\n  private _entries: IDevtoolsActionEntry[] = [];\r\n  private _listeners: Set<TDevtoolsListener> = new Set();\r\n  private readonly _maxEntries: number;\r\n\r\n  constructor(options: IActionDevtoolsCoreOptions = {}) {\r\n    this._maxEntries = options.maxEntries ?? 500;\r\n  }\r\n\r\n  attachToDomain(domain: IDevtoolsObservableDomain): () => void {\r\n    return domain.addActionListener((update) => {\r\n      const { runningAction, type, time } = update;\r\n\r\n      if (type === ERunningActionUpdateType.started) {\r\n        const entry: IDevtoolsActionEntry = {\r\n          cuid: runningAction.cuid,\r\n          actionId: runningAction.id,\r\n          domain: runningAction.domain,\r\n          allDomains: [...runningAction.allDomains],\r\n          status: \"running\",\r\n          startTime: time,\r\n          input: runningAction.state?.request?.input,\r\n          inputHash: runningAction.state?.request?.inputHash,\r\n          progressUpdates: [],\r\n          meta: extractMeta(runningAction.context),\r\n          parentCuid: runningAction.parentCuid,\r\n          callSite: runningAction.callSite,\r\n        };\r\n        this._entries = [entry, ...this._entries];\r\n        // Bound retention: entries are newest-first, so the oldest fall off the tail.\r\n        // Grouping already renders any child whose parent is gone as its own root, so\r\n        // dropping an old parent never breaks the surviving children's display.\r\n        if (this._entries.length > this._maxEntries) {\r\n          this._entries.length = this._maxEntries;\r\n        }\r\n        this._notify();\r\n      } else if (type === ERunningActionUpdateType.progress) {\r\n        this._updateEntry(runningAction.cuid, (e) => ({\r\n          ...e,\r\n          progressUpdates: [...e.progressUpdates, update.progress],\r\n        }));\r\n      } else if (type === ERunningActionUpdateType.finished) {\r\n        this._updateEntry(runningAction.cuid, (e) => {\r\n          // On success the result payload's context may carry the full routing from the handling\r\n          // runtime (including backend hops) — richer than the local context, which only has this\r\n          // side's outgoing hops. Prefer it *only when it's actually richer*: the optimized binary\r\n          // WS session strips routing from the wire and reconstructs an empty array, so an empty\r\n          // response routing must never clobber the real local hops (otherwise the entry renders as\r\n          // \"call\"/\"local\" instead of \"→ ws → backend\").\r\n          const responseRouting = extractRouting((update as any).response?.context);\r\n          const localRouting = extractRouting(runningAction.context);\r\n          const routing =\r\n            responseRouting.length >= localRouting.length ? responseRouting : localRouting;\r\n          const base: IDevtoolsActionEntry = {\r\n            ...e,\r\n            endTime: time,\r\n            meta: { ...e.meta, routing },\r\n          };\r\n          const finishType: string = update.finishType;\r\n\r\n          if (finishType === ERunningActionFinishedType.success) {\r\n            const result = update.response?.result;\r\n            const outputHash: string | undefined = update.response?.outputHash;\r\n            if (result != null && !result.ok) {\r\n              const rawError = result.error;\r\n              const errorStack = rawError instanceof Error ? rawError.stack : undefined;\r\n              return {\r\n                ...base,\r\n                status: \"action-error\",\r\n                outputHash,\r\n                error: serializeErrorForDisplay(rawError),\r\n                errorStack,\r\n              };\r\n            }\r\n            return { ...base, status: \"success\", output: result?.output, outputHash };\r\n          }\r\n          if (finishType === ERunningActionFinishedType.failed) {\r\n            const rawError = (update as any).error;\r\n            const errorStack = rawError instanceof Error ? rawError.stack : undefined;\r\n            return {\r\n              ...base,\r\n              status: \"failed\",\r\n              error: serializeErrorForDisplay(rawError),\r\n              errorStack,\r\n            };\r\n          }\r\n          const abortReason = update.reason;\r\n          const errorStack = abortReason instanceof Error ? abortReason.stack : undefined;\r\n          return {\r\n            ...base,\r\n            status: \"aborted\",\r\n            abortReason: serializeErrorForDisplay(abortReason),\r\n            errorStack,\r\n          };\r\n        });\r\n      }\r\n    });\r\n  }\r\n\r\n  getEntries(): readonly IDevtoolsActionEntry[] {\r\n    return this._entries;\r\n  }\r\n\r\n  subscribe(listener: TDevtoolsListener): () => void {\r\n    this._listeners.add(listener);\r\n    listener(this._entries);\r\n    return () => {\r\n      this._listeners.delete(listener);\r\n    };\r\n  }\r\n\r\n  clear(): void {\r\n    this._entries = [];\r\n    this._notify();\r\n  }\r\n\r\n  private _updateEntry(\r\n    cuid: string,\r\n    updater: (entry: IDevtoolsActionEntry) => IDevtoolsActionEntry,\r\n  ): void {\r\n    this._entries = this._entries.map((e) => (e.cuid === cuid ? updater(e) : e));\r\n    this._notify();\r\n  }\r\n\r\n  private _notify(): void {\r\n    const snapshot = this._entries;\r\n    for (const listener of this._listeners) listener(snapshot);\r\n  }\r\n}\r\n"],"mappings":"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"}

package/build/ActionDevtoolsCore-Pg7ERO3L.d.ts

@@ -0,0 +1,79 @@
+import { Bn as IRuntimeCoordinate, _ as TActionProgress } from "./ActionPayload.types-BN-rXFBK.js";
+//#region ../nice-devtools-shared/src/components/PanelChrome.d.ts
+/** Where a devtools panel is docked. */
+type TDevtoolsPosition = "dock-bottom" | "dock-top" | "dock-left" | "dock-right";
+//#endregion
+//#region src/devtools/core/ActionDevtools.types.d.ts
+type TDevtoolsActionStatus = "running" | "success" | "action-error" | "failed" | "aborted";
+interface IDevtoolsRouteItem {
+  runtime: IRuntimeCoordinate;
+  handlerType: "local" | "external";
+  handlerClient?: {
+    envId: string;
+    perId?: string;
+    insId?: string;
+  };
+  /** Transport type string (e.g. "http", "ws", "custom"). */
+  transport?: string;
+  /** Short transport summary for chips (e.g. "POST /resolve_action"). */
+  transportSummary?: string;
+  /** Resolved endpoint (request URL / WebSocket URL), when available. */
+  transportUrl?: string;
+  time: number;
+  label?: string;
+}
+interface IDevtoolsActionMeta {
+  timeCreated: number;
+  originClient: {
+    envId: string;
+    perId?: string;
+    insId?: string;
+  };
+  routing: IDevtoolsRouteItem[];
+}
+interface IDevtoolsActionEntry {
+  cuid: string;
+  actionId: string;
+  domain: string;
+  allDomains: string[];
+  status: TDevtoolsActionStatus;
+  startTime: number;
+  endTime?: number;
+  input: unknown;
+  inputHash?: string;
+  output?: unknown;
+  outputHash?: string;
+  error?: unknown;
+  abortReason?: unknown;
+  progressUpdates: TActionProgress[];
+  meta: IDevtoolsActionMeta;
+  parentCuid?: string;
+  callSite?: string;
+  errorStack?: string;
+}
+type TDevtoolsListener = (entries: readonly IDevtoolsActionEntry[]) => void;
+interface IDevtoolsObservableDomain {
+  domain: string;
+  addActionListener(listener: (update: any) => void): () => void;
+}
+//#endregion
+//#region src/devtools/core/ActionDevtoolsCore.d.ts
+interface IActionDevtoolsCoreOptions {
+  /** Max root entries to retain. Older entries (and their children) are evicted. */
+  maxEntries?: number;
+}
+declare class ActionDevtoolsCore {
+  private _entries;
+  private _listeners;
+  private readonly _maxEntries;
+  constructor(options?: IActionDevtoolsCoreOptions);
+  attachToDomain(domain: IDevtoolsObservableDomain): () => void;
+  getEntries(): readonly IDevtoolsActionEntry[];
+  subscribe(listener: TDevtoolsListener): () => void;
+  clear(): void;
+  private _updateEntry;
+  private _notify;
+}
+//#endregion
+export { TDevtoolsActionStatus as a, IDevtoolsObservableDomain as i, IActionDevtoolsCoreOptions as n, TDevtoolsListener as o, IDevtoolsActionEntry as r, TDevtoolsPosition as s, ActionDevtoolsCore as t };
+//# sourceMappingURL=ActionDevtoolsCore-Pg7ERO3L.d.ts.map

package/build/ActionDevtoolsCore-yfJ9tkvl.js

@@ -0,0 +1,154 @@
+import "./RunningAction.types-C176rqHG.js";
+//#region src/devtools/core/ActionDevtoolsCore.ts
+function serializeErrorForDisplay(error) {
+	if (error != null && typeof error === "object" && error.name === "NiceError" && typeof error.toJsonObject === "function") return error.toJsonObject();
+	return error;
+}
+function extractRouting(context) {
+	return (context?.routing ?? []).map((item) => {
+		const handler = item.handler;
+		const isExternal = handler?.type === "external";
+		return {
+			runtime: {
+				envId: item.runtime?.envId ?? "unknown",
+				perId: item.runtime?.perId,
+				insId: item.runtime?.insId
+			},
+			handlerType: isExternal ? "external" : "local",
+			handlerClient: isExternal && handler.client != null ? {
+				envId: handler.client.envId ?? "unknown",
+				perId: handler.client.perId,
+				insId: handler.client.insId
+			} : void 0,
+			transport: isExternal ? handler.transType : void 0,
+			transportSummary: isExternal ? handler.transInfo?.summary : void 0,
+			transportUrl: isExternal ? handler.transInfo?.url : void 0,
+			time: item.time
+		};
+	});
+}
+function extractMeta(context) {
+	return {
+		timeCreated: context?.timeCreated ?? Date.now(),
+		originClient: {
+			envId: context?.originClient?.envId ?? "unknown",
+			perId: context?.originClient?.perId,
+			insId: context?.originClient?.insId
+		},
+		routing: extractRouting(context)
+	};
+}
+var ActionDevtoolsCore = class {
+	_entries = [];
+	_listeners = /* @__PURE__ */ new Set();
+	_maxEntries;
+	constructor(options = {}) {
+		this._maxEntries = options.maxEntries ?? 500;
+	}
+	attachToDomain(domain) {
+		return domain.addActionListener((update) => {
+			const { runningAction, type, time } = update;
+			if (type === "started") {
+				const entry = {
+					cuid: runningAction.cuid,
+					actionId: runningAction.id,
+					domain: runningAction.domain,
+					allDomains: [...runningAction.allDomains],
+					status: "running",
+					startTime: time,
+					input: runningAction.state?.request?.input,
+					inputHash: runningAction.state?.request?.inputHash,
+					progressUpdates: [],
+					meta: extractMeta(runningAction.context),
+					parentCuid: runningAction.parentCuid,
+					callSite: runningAction.callSite
+				};
+				this._entries = [entry, ...this._entries];
+				if (this._entries.length > this._maxEntries) this._entries.length = this._maxEntries;
+				this._notify();
+			} else if (type === "progress") this._updateEntry(runningAction.cuid, (e) => ({
+				...e,
+				progressUpdates: [...e.progressUpdates, update.progress]
+			}));
+			else if (type === "finished") this._updateEntry(runningAction.cuid, (e) => {
+				const responseRouting = extractRouting(update.response?.context);
+				const localRouting = extractRouting(runningAction.context);
+				const routing = responseRouting.length >= localRouting.length ? responseRouting : localRouting;
+				const base = {
+					...e,
+					endTime: time,
+					meta: {
+						...e.meta,
+						routing
+					}
+				};
+				const finishType = update.finishType;
+				if (finishType === "success") {
+					const result = update.response?.result;
+					const outputHash = update.response?.outputHash;
+					if (result != null && !result.ok) {
+						const rawError = result.error;
+						const errorStack = rawError instanceof Error ? rawError.stack : void 0;
+						return {
+							...base,
+							status: "action-error",
+							outputHash,
+							error: serializeErrorForDisplay(rawError),
+							errorStack
+						};
+					}
+					return {
+						...base,
+						status: "success",
+						output: result?.output,
+						outputHash
+					};
+				}
+				if (finishType === "failed") {
+					const rawError = update.error;
+					const errorStack = rawError instanceof Error ? rawError.stack : void 0;
+					return {
+						...base,
+						status: "failed",
+						error: serializeErrorForDisplay(rawError),
+						errorStack
+					};
+				}
+				const abortReason = update.reason;
+				const errorStack = abortReason instanceof Error ? abortReason.stack : void 0;
+				return {
+					...base,
+					status: "aborted",
+					abortReason: serializeErrorForDisplay(abortReason),
+					errorStack
+				};
+			});
+		});
+	}
+	getEntries() {
+		return this._entries;
+	}
+	subscribe(listener) {
+		this._listeners.add(listener);
+		listener(this._entries);
+		return () => {
+			this._listeners.delete(listener);
+		};
+	}
+	clear() {
+		this._entries = [];
+		this._notify();
+	}
+	_updateEntry(cuid, updater) {
+		this._entries = this._entries.map((e) => e.cuid === cuid ? updater(e) : e);
+		this._notify();
+	}
+	_notify() {
+		const snapshot = this._entries;
+		for (const listener of this._listeners) listener(snapshot);
+	}
+};
+//#endregion
+export { ActionDevtoolsCore as t };
+
+//# sourceMappingURL=ActionDevtoolsCore-yfJ9tkvl.js.map

package/build/ActionDevtoolsCore-yfJ9tkvl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionDevtoolsCore-yfJ9tkvl.js","names":[],"sources":["../src/devtools/core/ActionDevtoolsCore.ts"],"sourcesContent":["import {\r\n  ERunningActionFinishedType,\r\n  ERunningActionUpdateType,\r\n} from \"../../ActionDefinition/Action/RunningAction.types\";\r\nimport type {\r\n  IDevtoolsActionEntry,\r\n  IDevtoolsActionMeta,\r\n  IDevtoolsObservableDomain,\r\n  IDevtoolsRouteItem,\r\n  TDevtoolsListener,\r\n} from \"./ActionDevtools.types\";\r\n\r\nexport interface IActionDevtoolsCoreOptions {\r\n  /** Max root entries to retain. Older entries (and their children) are evicted. */\r\n  maxEntries?: number;\r\n}\r\n\r\nfunction serializeErrorForDisplay(error: unknown): unknown {\r\n  if (\r\n    error != null &&\r\n    typeof error === \"object\" &&\r\n    (error as any).name === \"NiceError\" &&\r\n    typeof (error as any).toJsonObject === \"function\"\r\n  ) {\r\n    return (error as any).toJsonObject();\r\n  }\r\n  return error;\r\n}\r\n\r\nfunction extractRouting(context: any): IDevtoolsRouteItem[] {\r\n  return (context?.routing ?? []).map((item: any): IDevtoolsRouteItem => {\r\n    const handler = item.handler;\r\n    const isExternal = handler?.type === \"external\";\r\n    return {\r\n      runtime: {\r\n        envId: item.runtime?.envId ?? \"unknown\",\r\n        perId: item.runtime?.perId,\r\n        insId: item.runtime?.insId,\r\n      },\r\n      handlerType: isExternal ? \"external\" : \"local\",\r\n      handlerClient:\r\n        isExternal && handler.client != null\r\n          ? {\r\n              envId: handler.client.envId ?? \"unknown\",\r\n              perId: handler.client.perId,\r\n              insId: handler.client.insId,\r\n            }\r\n          : undefined,\r\n      transport: isExternal ? handler.transType : undefined,\r\n      transportSummary: isExternal ? handler.transInfo?.summary : undefined,\r\n      transportUrl: isExternal ? handler.transInfo?.url : undefined,\r\n      time: item.time,\r\n    };\r\n  });\r\n}\r\n\r\nfunction extractMeta(context: any): IDevtoolsActionMeta {\r\n  return {\r\n    timeCreated: context?.timeCreated ?? Date.now(),\r\n    originClient: {\r\n      envId: context?.originClient?.envId ?? \"unknown\",\r\n      perId: context?.originClient?.perId,\r\n      insId: context?.originClient?.insId,\r\n    },\r\n    routing: extractRouting(context),\r\n  };\r\n}\r\n\r\nexport class ActionDevtoolsCore {\r\n  private _entries: IDevtoolsActionEntry[] = [];\r\n  private _listeners: Set<TDevtoolsListener> = new Set();\r\n  private readonly _maxEntries: number;\r\n\r\n  constructor(options: IActionDevtoolsCoreOptions = {}) {\r\n    this._maxEntries = options.maxEntries ?? 500;\r\n  }\r\n\r\n  attachToDomain(domain: IDevtoolsObservableDomain): () => void {\r\n    return domain.addActionListener((update) => {\r\n      const { runningAction, type, time } = update;\r\n\r\n      if (type === ERunningActionUpdateType.started) {\r\n        const entry: IDevtoolsActionEntry = {\r\n          cuid: runningAction.cuid,\r\n          actionId: runningAction.id,\r\n          domain: runningAction.domain,\r\n          allDomains: [...runningAction.allDomains],\r\n          status: \"running\",\r\n          startTime: time,\r\n          input: runningAction.state?.request?.input,\r\n          inputHash: runningAction.state?.request?.inputHash,\r\n          progressUpdates: [],\r\n          meta: extractMeta(runningAction.context),\r\n          parentCuid: runningAction.parentCuid,\r\n          callSite: runningAction.callSite,\r\n        };\r\n        this._entries = [entry, ...this._entries];\r\n        // Bound retention: entries are newest-first, so the oldest fall off the tail.\r\n        // Grouping already renders any child whose parent is gone as its own root, so\r\n        // dropping an old parent never breaks the surviving children's display.\r\n        if (this._entries.length > this._maxEntries) {\r\n          this._entries.length = this._maxEntries;\r\n        }\r\n        this._notify();\r\n      } else if (type === ERunningActionUpdateType.progress) {\r\n        this._updateEntry(runningAction.cuid, (e) => ({\r\n          ...e,\r\n          progressUpdates: [...e.progressUpdates, update.progress],\r\n        }));\r\n      } else if (type === ERunningActionUpdateType.finished) {\r\n        this._updateEntry(runningAction.cuid, (e) => {\r\n          // On success the result payload's context may carry the full routing from the handling\r\n          // runtime (including backend hops) — richer than the local context, which only has this\r\n          // side's outgoing hops. Prefer it *only when it's actually richer*: the optimized binary\r\n          // WS session strips routing from the wire and reconstructs an empty array, so an empty\r\n          // response routing must never clobber the real local hops (otherwise the entry renders as\r\n          // \"call\"/\"local\" instead of \"→ ws → backend\").\r\n          const responseRouting = extractRouting((update as any).response?.context);\r\n          const localRouting = extractRouting(runningAction.context);\r\n          const routing =\r\n            responseRouting.length >= localRouting.length ? responseRouting : localRouting;\r\n          const base: IDevtoolsActionEntry = {\r\n            ...e,\r\n            endTime: time,\r\n            meta: { ...e.meta, routing },\r\n          };\r\n          const finishType: string = update.finishType;\r\n\r\n          if (finishType === ERunningActionFinishedType.success) {\r\n            const result = update.response?.result;\r\n            const outputHash: string | undefined = update.response?.outputHash;\r\n            if (result != null && !result.ok) {\r\n              const rawError = result.error;\r\n              const errorStack = rawError instanceof Error ? rawError.stack : undefined;\r\n              return {\r\n                ...base,\r\n                status: \"action-error\",\r\n                outputHash,\r\n                error: serializeErrorForDisplay(rawError),\r\n                errorStack,\r\n              };\r\n            }\r\n            return { ...base, status: \"success\", output: result?.output, outputHash };\r\n          }\r\n          if (finishType === ERunningActionFinishedType.failed) {\r\n            const rawError = (update as any).error;\r\n            const errorStack = rawError instanceof Error ? rawError.stack : undefined;\r\n            return {\r\n              ...base,\r\n              status: \"failed\",\r\n              error: serializeErrorForDisplay(rawError),\r\n              errorStack,\r\n            };\r\n          }\r\n          const abortReason = update.reason;\r\n          const errorStack = abortReason instanceof Error ? abortReason.stack : undefined;\r\n          return {\r\n            ...base,\r\n            status: \"aborted\",\r\n            abortReason: serializeErrorForDisplay(abortReason),\r\n            errorStack,\r\n          };\r\n        });\r\n      }\r\n    });\r\n  }\r\n\r\n  getEntries(): readonly IDevtoolsActionEntry[] {\r\n    return this._entries;\r\n  }\r\n\r\n  subscribe(listener: TDevtoolsListener): () => void {\r\n    this._listeners.add(listener);\r\n    listener(this._entries);\r\n    return () => {\r\n      this._listeners.delete(listener);\r\n    };\r\n  }\r\n\r\n  clear(): void {\r\n    this._entries = [];\r\n    this._notify();\r\n  }\r\n\r\n  private _updateEntry(\r\n    cuid: string,\r\n    updater: (entry: IDevtoolsActionEntry) => IDevtoolsActionEntry,\r\n  ): void {\r\n    this._entries = this._entries.map((e) => (e.cuid === cuid ? updater(e) : e));\r\n    this._notify();\r\n  }\r\n\r\n  private _notify(): void {\r\n    const snapshot = this._entries;\r\n    for (const listener of this._listeners) listener(snapshot);\r\n  }\r\n}\r\n"],"mappings":"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"}