@vizejs/plugin-sdk 0.471.0 → 0.475.0

package/README.md

@@ -1,7 +1,7 @@
 # @vizejs/plugin-sdk
 
 Author synchronous rules, fact providers, native template transforms and compiled
-output hooks. Install `@vizejs/native` **0.471.0 or newer** to execute plugins.
+output hooks. Install `@vizejs/native` **0.475.0 or newer** to execute plugins.
 The optional native peer lets this package install independently for authoring;
 its helpers alone do not compile or lint Vue files. Node 22 or newer is required.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizejs/plugin-sdk",
-  "version": "0.471.0",
+  "version": "0.475.0",
   "description": "Deterministic authoring and isolated execution for Vize JavaScript plugins",
   "homepage": "https://github.com/ubugeeei-prod/vize",
   "bugs": {
@@ -47,7 +47,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "@vizejs/native": "0.471.0"
+    "@vizejs/native": "0.475.0"
   },
   "peerDependencies": {
     "@vizejs/native": ">=0.429.0"

package/sandbox.d.ts

@@ -48,8 +48,19 @@ export type SandboxErrorCode =
   | "execution_stopped"
   | "execution_failed"
   | "cleanup_failed";
+/** Available decoded output can be partial after a stopped execution. */
+export interface SandboxExecutionObservation {
+  readonly phase: "run";
+  readonly elapsedMs: number;
+  readonly status: number | null;
+  readonly signal: string | null;
+  readonly stdout: string | null;
+  readonly stderr: string | null;
+}
 export declare class SandboxRuntimeError extends Error {
   readonly code: SandboxErrorCode;
+  /** Frozen and non-enumerable; the request and environment are not copied into it. */
+  readonly execution?: SandboxExecutionObservation;
   constructor(code: SandboxErrorCode, message: string, options?: ErrorOptions);
 }
 export declare const SANDBOX_IMAGE: string;

package/sandbox.js

@@ -64,6 +64,7 @@ export function createSandboxRunner(input, limits = {}) {
       let failure;
       let output;
       try {
+        const started = performance.now();
         const result = spawnSync(
           "docker",
           [
@@ -106,12 +107,26 @@ export function createSandboxRunner(input, limits = {}) {
             windowsHide: true,
           },
         );
-        if (result.error)
-          throw new SandboxRuntimeError(
+        if (result.error) {
+          const stopped = new SandboxRuntimeError(
             "execution_stopped",
             `sandbox execution stopped: ${result.error.code}`,
             { cause: result.error },
           );
+          // Preserve available captured output without automatically logging it.
+          // A stopped process does not guarantee a complete worker transcript.
+          Object.defineProperty(stopped, "execution", {
+            value: Object.freeze({
+              phase: "run",
+              elapsedMs: performance.now() - started,
+              status: result.status,
+              signal: result.signal,
+              stdout: result.stdout,
+              stderr: result.stderr,
+            }),
+          });
+          throw stopped;
+        }
         if (result.status !== 0) {
           throw new SandboxRuntimeError(
             "execution_failed",