@vortexm/vjt 0.1.3 → 0.1.4

package/dist/index.js

@@ -3682,6 +3682,16 @@ function logRuntimeError(scope, error, details) {
   }
   console.error("[VJT error]", payload);
 }
+function logRuntimeDebug(enabled, scope, payload) {
+  if (!enabled) {
+    return;
+  }
+  if (payload === void 0) {
+    console.log("[VJT debug]", scope);
+    return;
+  }
+  console.log("[VJT debug]", scope, payload);
+}
 
 // src/lib/security.ts
 var BLOCKED_OBJECT_KEYS = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
@@ -3838,6 +3848,7 @@ function sanitizeSchemaValue(schema, value, path = "value") {
 
 // src/lib/network.ts
 var NetworkRuntime = class {
+  debugLogging;
   requestsMap;
   sseConfigs;
   backendUrl;
@@ -3845,6 +3856,7 @@ var NetworkRuntime = class {
   runActions;
   rerenderRoot;
   constructor(options) {
+    this.debugLogging = options.debugLogging;
     this.requestsMap = options.requestsMap;
     this.sseConfigs = options.sseConfigs;
     this.backendUrl = options.backendUrl;
@@ -3907,12 +3919,19 @@ var NetworkRuntime = class {
     if (!safeRequestUrl) {
       throw new Error(`Request ${requestName} has unsafe url`);
     }
+    const requestBody = JSON.stringify(requestEnvelope);
+    logRuntimeDebug(this.debugLogging, "request", {
+      requestName,
+      url: safeRequestUrl,
+      envelope: requestEnvelope,
+      body: requestBody
+    });
     const response = await fetch(safeRequestUrl, {
       method: "POST",
       headers: {
         "Content-Type": "application/json"
       },
-      body: JSON.stringify(requestEnvelope)
+      body: requestBody
     });
     const responseText = await response.text();
     if (!response.ok) {
@@ -3928,12 +3947,19 @@ var NetworkRuntime = class {
       throw new Error(`Request ${requestName} returned non-JSON response: ${responseText.slice(0, 120)}`);
     }
     if (json.error) {
-      throw new Error(`Request ${requestName} returned JSON-RPC error: ${String(json.error.message ?? "unknown error")}`);
+      throw new Error(`Request ${requestName} returned JSON-RPC error: ${this.stringifyPrimitive(json.error.message ?? "unknown error")}`);
     }
     if (!definition.response) {
       throw new Error(`Request ${requestName} must define response schema`);
     }
     const result = sanitizeSchemaValue(definition.response, json.result, `response.${requestName}`);
+    logRuntimeDebug(this.debugLogging, "response", {
+      requestName,
+      url: safeRequestUrl,
+      status: response.status,
+      json,
+      result
+    });
     if (definition.onResponse?.length) {
       await this.runActions(definition.onResponse, null, {
         currentValue: null,
@@ -4011,6 +4037,12 @@ var NetworkRuntime = class {
     const message = eventDefinition.message ? sanitizeSchemaValue(eventDefinition.message, parsedMessage, `sse.${eventDefinition.name}`) : (() => {
       throw new Error(`SSE event ${eventDefinition.name} must define message schema`);
     })();
+    logRuntimeDebug(this.debugLogging, "sse", {
+      eventName: eventDefinition.name,
+      raw: event.data,
+      parsedMessage,
+      message
+    });
     if (!eventDefinition.onEvent?.length) {
       return;
     }
@@ -4452,6 +4484,7 @@ var ReferenceRuntime = class {
 
 // src/lib/action-runtime.ts
 var ActionRuntime = class {
+  debugLogging;
   actionsMap;
   actionFunctions;
   nodeById;
@@ -4476,6 +4509,7 @@ var ActionRuntime = class {
   getInlineActions;
   isWidgetEnabled;
   constructor(options) {
+    this.debugLogging = options.debugLogging;
     this.actionsMap = options.actionsMap;
     this.actionFunctions = options.actionFunctions;
     this.nodeById = options.nodeById;
@@ -4531,30 +4565,55 @@ var ActionRuntime = class {
     return this.getInlineActions(node);
   }
   async runSingleAction(action, inputValue, context) {
-    let output = await this.executeAction(action, inputValue, context);
-    if (action.andThen?.length) {
-      if (Array.isArray(output)) {
-        const collected = [];
-        for (const entry of output) {
-          if (entry === null || entry === void 0) {
-            continue;
-          }
-          const nestedOutput = await this.runActions(action.andThen, entry, { ...context, currentValue: entry });
-          if (nestedOutput !== null && nestedOutput !== void 0) {
-            collected.push(nestedOutput);
+    const actionName = action.action.trim();
+    try {
+      let output = await this.executeAction(action, inputValue, context);
+      if (action.andThen?.length) {
+        if (Array.isArray(output)) {
+          const collected = [];
+          for (const entry of output) {
+            if (entry === null || entry === void 0) {
+              continue;
+            }
+            const nestedOutput = await this.runActions(action.andThen, entry, { ...context, currentValue: entry });
+            if (nestedOutput !== null && nestedOutput !== void 0) {
+              collected.push(nestedOutput);
+            }
           }
+          output = collected;
+        } else if (output !== null && output !== void 0) {
+          output = await this.runActions(action.andThen, output, { ...context, currentValue: output });
+        } else {
+          output = null;
         }
-        output = collected;
-      } else if (output !== null && output !== void 0) {
-        output = await this.runActions(action.andThen, output, { ...context, currentValue: output });
-      } else {
-        output = null;
       }
+      logRuntimeDebug(this.debugLogging, "action-result", {
+        action: actionName,
+        output
+      });
+      return output;
+    } catch (error) {
+      logRuntimeError("action", error, {
+        action: actionName,
+        args: action.args,
+        inputValue,
+        currentValue: context.currentValue,
+        responseValue: context.responseValue,
+        pointer: context.pointer ?? null
+      });
+      throw error;
     }
-    return output;
   }
   async executeAction(action, inputValue, context) {
     const name = action.action.trim();
+    logRuntimeDebug(this.debugLogging, "action", {
+      action: name,
+      args: action.args,
+      inputValue,
+      currentValue: context.currentValue,
+      responseValue: context.responseValue,
+      pointer: context.pointer ?? null
+    });
     if (this.actionsMap[name]) {
       return this.runActions(this.actionsMap[name], inputValue, context);
     }
@@ -6112,6 +6171,7 @@ var RuntimeRenderer = class {
   systemEvents;
   resourceManager;
   actionFunctions;
+  debugLogging;
   backendUrl;
   initialRuntimeSnapshot;
   onRuntimeSnapshot;
@@ -6152,6 +6212,7 @@ var RuntimeRenderer = class {
     this.sseConfigs = Array.isArray(resolvedSseConfigs) ? resolvedSseConfigs : resolvedSseConfigs ? [resolvedSseConfigs] : [];
     this.systemEvents = options.systemEvents ?? this.resourceManager?.getSystemEvents() ?? {};
     this.actionFunctions = options.actionFunctions ?? {};
+    this.debugLogging = options.debugLogging === true;
     this.backendUrl = options.backendUrl;
     this.initialRuntimeSnapshot = options.runtimeSnapshot ? deepClone(options.runtimeSnapshot) : null;
     this.onRuntimeSnapshot = options.onRuntimeSnapshot;
@@ -6199,6 +6260,7 @@ var RuntimeRenderer = class {
       indexListElementNodes: (listNode, element, index) => this.indexListElementNodes(listNode, element, index)
     });
     this.networkRuntime = new NetworkRuntime({
+      debugLogging: this.debugLogging,
       requestsMap: this.requestsMap,
       sseConfigs: this.sseConfigs,
       backendUrl: this.backendUrl,
@@ -6207,6 +6269,7 @@ var RuntimeRenderer = class {
       rerenderRoot: () => this.rerenderRoot()
     });
     this.actionRuntime = new ActionRuntime({
+      debugLogging: this.debugLogging,
       actionsMap: this.actionsMap,
       actionFunctions: this.actionFunctions,
       nodeById: this.nodeById,
@@ -6252,7 +6315,9 @@ var RuntimeRenderer = class {
     this.applyRuntimeSnapshot(this.initialRuntimeSnapshot);
   }
   renderMarkup() {
-    return `${this.renderNode(this.description, "root", null)}${this.renderGlobalOverlays()}`;
+    const markup = `${this.renderNode(this.description, "root", null)}${this.renderGlobalOverlays()}`;
+    logRuntimeDebug(this.debugLogging, "html", markup);
+    return markup;
   }
   mount(root, options = {}) {
     if (!(root instanceof HTMLElement)) {

package/dist/lib/action-runtime.d.ts

@@ -8,6 +8,7 @@ export type ActionExecutionContext = {
     } | null;
 };
 type ActionRuntimeOptions = {
+    debugLogging: boolean;
     actionsMap: ActionMap;
     actionFunctions: Record<string, () => unknown>;
     nodeById: Map<string, DescriptionNode>;
@@ -48,6 +49,7 @@ type ActionRuntimeOptions = {
     isWidgetEnabled: (node: DescriptionNode, key: string) => boolean;
 };
 export declare class ActionRuntime {
+    private readonly debugLogging;
     private readonly actionsMap;
     private readonly actionFunctions;
     private readonly nodeById;

package/dist/lib/logging.d.ts

@@ -1 +1,2 @@
 export declare function logRuntimeError(scope: string, error: unknown, details?: Record<string, unknown>): void;
+export declare function logRuntimeDebug(enabled: boolean, scope: string, payload?: unknown): void;

package/dist/lib/network.d.ts

@@ -4,6 +4,7 @@ type ActionRunner = (actions: ActionDefinition[], inputValue: unknown, context:
     responseValue?: unknown;
 }) => Promise<unknown>;
 type NetworkRuntimeOptions = {
+    debugLogging: boolean;
     requestsMap: RequestMap;
     sseConfigs: SseConfig[];
     backendUrl?: string;
@@ -12,6 +13,7 @@ type NetworkRuntimeOptions = {
     rerenderRoot: () => Promise<void>;
 };
 export declare class NetworkRuntime {
+    private readonly debugLogging;
     private readonly requestsMap;
     private readonly sseConfigs;
     private readonly backendUrl?;

package/dist/lib/types.d.ts

@@ -132,6 +132,7 @@ export type RenderJsonOptions = {
     i18n?: I18nMap;
     language?: string;
     theme?: Theme;
+    debugLogging?: boolean;
     actionsMap?: ActionMap;
     requestsMap?: RequestMap;
     sseConfigs?: SseConfigInput;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vortexm/vjt",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",