@bonsae/nrg 0.21.0 → 0.21.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bonsae/nrg",
-  "version": "0.21.0",
+  "version": "0.21.2",
   "description": "NRG framework — build Node-RED nodes with Vue 3, TypeScript, and JSON Schema",
   "author": "Allan Oricil <allanoricil@duck.com>",
   "license": "MIT",

package/server/index.cjs

@@ -471,6 +471,18 @@ var IONode = class extends Node {
     }
     return keys.length;
   }
+  /**
+   * The names of the base output ports when `outputsSchema` is a record of
+   * named ports (`{ success, failure }`), in declaration order — otherwise
+   * `undefined` (a single schema or a positional array). Resolved here, where
+   * TypeBox's `Kind` symbol is intact, so the editor reads the names directly
+   * instead of guessing them from a serialized (symbol-stripped) schema.
+   */
+  static get outputPortNames() {
+    const s = this.outputsSchema;
+    if (!s || Array.isArray(s) || isSchemaLike(s)) return void 0;
+    return Object.keys(s);
+  }
   #send;
   /**
    * Most recent input message — the spread base for output wrapping. Not
@@ -573,19 +585,14 @@ var IONode = class extends Node {
       this.#send = void 0;
     }
   }
-  send(msg, options) {
+  send(msg) {
     const sendsValue = this.baseOutputs <= 1;
-    const defaultMode = options?.defaultMode;
     if (Array.isArray(msg) && !sendsValue) {
       const slots = msg.slice(0, this.baseOutputs);
       const out = slots.map((m, port) => {
         if (m == null) return m;
         this.#validatePort(m, port);
-        return this.#wrapOutgoing(
-          m,
-          this.#resolveContextMode(port, defaultMode),
-          port
-        );
+        return this.#wrapOutgoing(m, this.#resolveContextMode(port), port);
       });
       this.#deliver(out);
       return;
@@ -595,9 +602,7 @@ var IONode = class extends Node {
       return;
     }
     this.#validatePort(msg, 0);
-    this.#deliver(
-      this.#wrapOutgoing(msg, this.#resolveContextMode(0, defaultMode), 0)
-    );
+    this.#deliver(this.#wrapOutgoing(msg, this.#resolveContextMode(0), 0));
   }
   #deliver(out) {
     if (this.#send) {
@@ -648,13 +653,12 @@ var IONode = class extends Node {
     return "output";
   }
   /**
-   * Resolves the context mode for a base-output port. Precedence: the flow
-   * author's per-port override (`config.contextModes[port]`) → the node author's
-   * `defaultMode` → `"carry"`.
+   * Resolves the context mode for a base-output port from the flow author's
+   * per-port config (`config.outputContextModes[port]`, written by the editor
+   * when the node declares `outputContextModes`), falling back to `"carry"`.
    */
-  #resolveContextMode(port, defaultMode) {
-    const configured = this.config.contextModes?.[port];
-    return configured ?? defaultMode ?? "carry";
+  #resolveContextMode(port) {
+    return this.config.outputContextModes?.[port] ?? "carry";
   }
   /**
    * Merges a sent value into the incoming message at the returnProperty key so
@@ -694,14 +698,14 @@ var IONode = class extends Node {
    * throw an error or call `this.error()` for the error port, and the complete
    * port is sent automatically on successful input processing.
    */
-  sendToPort(port, msg, options) {
+  sendToPort(port, msg) {
     if (port === "error" || port === "complete" || port === "status") {
       throw new NrgError(
         `sendToPort("${port}") is not allowed. Built-in ports are managed by the framework.`
       );
     }
     const portIndex = typeof port === "number" ? port : this.#getNamedPortIndex(port);
-    const mode = this.#resolveContextMode(portIndex ?? 0, options?.defaultMode);
+    const mode = this.#resolveContextMode(portIndex ?? 0);
     this.#sendToPort(
       port,
       msg == null ? msg : this.#wrapOutgoing(msg, mode, portIndex ?? 0)
@@ -1183,10 +1187,26 @@ function OutputReturnProperties(options) {
     }
   );
 }
+function OutputContextModes(options) {
+  return import_typebox2.Type.Record(
+    import_typebox2.Type.Number(),
+    import_typebox2.Type.Union([
+      import_typebox2.Type.Literal("carry"),
+      import_typebox2.Type.Literal("trace"),
+      import_typebox2.Type.Literal("reset")
+    ]),
+    {
+      description: "Per-port context mode, keyed by output port index. A missing entry falls back to `carry`.",
+      default: {},
+      ...options
+    }
+  );
+}
 var SchemaType = Object.assign({}, import_typebox2.Type, {
   NodeRef,
   TypedInput: TypedInput2,
-  OutputReturnProperties
+  OutputReturnProperties,
+  OutputContextModes
 });
 function markNonValidatable(schema) {
   const type = schema.type;