@bonsae/nrg 0.21.0 → 0.21.2

package/test/client/component/setup.js

@@ -1253,7 +1253,7 @@ const P = /* @__PURE__ */ E(Ne, [["render", Ce], ["__scopeId", "data-v-724dcae4"
   "validateInput",
   "validateOutputs",
   "outputs",
-  "contextModes",
+  "outputContextModes",
   "outputReturnProperties",
   ...ue
 ]);

package/test/client/e2e/index.js

@@ -1397,7 +1397,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "Default",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -1433,7 +1432,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "Standard",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -1469,7 +1467,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "Predeterminado",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -1505,7 +1502,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "Par d\xE9faut",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -1541,7 +1537,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "\uAE30\uBCF8\uAC12",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -1577,7 +1572,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "Padr\xE3o",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -1613,7 +1607,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "\u041F\u043E \u0443\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044E",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -1649,7 +1642,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "\u30C7\u30D5\u30A9\u30EB\u30C8",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -1685,7 +1677,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "\u9ED8\u8BA4",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -1721,7 +1712,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "\u9810\u8A2D",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -1939,7 +1929,6 @@ function nodeDefinitionsInliner(serverOutDir, entryPath, iconsDir, componentsDir
         }
         if (defaults && outputsSchema) {
           defaults.validateOutputs = { required: false, value: {} };
-          defaults.contextModes = { required: false, value: {} };
         }
         const credentials = getCredentialsFromSchema(credentialsSchema);
         _definitions[type] = {
@@ -1955,6 +1944,9 @@ function nodeDefinitionsInliner(serverOutDir, entryPath, iconsDir, componentsDir
           icon: iconsDir ? resolveIcon(iconsDir, type) : void 0,
           inputs: NodeClass.inputs,
           outputs: NodeClass.outputs,
+          // Resolved server-side (Kind symbol intact) so the editor labels
+          // named output ports without guessing from the serialized schema.
+          outputPortNames: NodeClass.outputPortNames ?? void 0,
           inputSchema,
           outputsSchema
         };

package/types/client.d.ts

@@ -101,13 +101,14 @@ export interface NodeRedNode {
 	completePort?: boolean;
 	statusPort?: boolean;
 	/**
-	 * Per-port output settings, indexed by base-output port; injected (empty) when
-	 * the node has an outputsSchema. Read at runtime by IONode.
-	 * `outputReturnProperties` is author-declared (SchemaType.OutputReturnProperties)
-	 * — present only when the node opts into per-port return keys.
+	 * Per-port output settings, indexed by base-output port. `validateOutputs` is
+	 * injected (empty) when the node has an outputsSchema; `outputReturnProperties`
+	 * and `outputContextModes` are author-declared (SchemaType.*) — present only
+	 * when the node opts into per-port return keys / context modes. Read at
+	 * runtime by IONode.
 	 */
 	validateOutputs?: Record<number, boolean>;
-	contextModes?: Record<number, "carry" | "trace" | "reset">;
+	outputContextModes?: Record<number, "carry" | "trace" | "reset">;
 	outputReturnProperties?: Record<number, string>;
 	[key: string]: any;
 }
@@ -173,6 +174,13 @@ export interface JsonSchemaObject extends SchemaObject {
 export interface RuntimeNodeDefinition extends NodeDefinition {
 	defaults?: NodeDefaults;
 	credentials?: NodeCredentials;
+	/**
+	 * Names of the base output ports when `outputsSchema` is a record of named
+	 * ports, in declaration order; absent for single/positional outputs. Resolved
+	 * server-side by the inliner so the editor never guesses port names from the
+	 * serialized schema.
+	 */
+	outputPortNames?: string[];
 	configSchema?: JsonSchemaObject;
 	credentialsSchema?: JsonSchemaObject;
 	inputSchema?: JsonSchemaObject;

package/types/server.d.ts

@@ -494,15 +494,23 @@ declare function TypedInput$1<T = unknown>(options?: NrgSchemaOptions): TTypedIn
 declare function OutputReturnProperties(options?: NrgSchemaOptions & {
 	default?: Record<number, string>;
 }): import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TString>;
+declare function OutputContextModes(options?: NrgSchemaOptions & {
+	default?: Record<number, "carry" | "trace" | "reset">;
+}): import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TUnion<[
+	import("@sinclair/typebox").TLiteral<"carry">,
+	import("@sinclair/typebox").TLiteral<"trace">,
+	import("@sinclair/typebox").TLiteral<"reset">
+]>>;
 /**
  * Extended TypeBox type builder with NRG-specific schema types.
- * Includes all standard TypeBox types plus {@link NodeRef}, {@link TypedInput}
- * and {@link OutputReturnProperties}.
+ * Includes all standard TypeBox types plus {@link NodeRef}, {@link TypedInput},
+ * {@link OutputReturnProperties} and {@link OutputContextModes}.
  */
 export declare const SchemaType: import("@sinclair/typebox").JavaScriptTypeBuilder & {
 	NodeRef: typeof NodeRef;
 	TypedInput: typeof TypedInput$1;
 	OutputReturnProperties: typeof OutputReturnProperties;
+	OutputContextModes: typeof OutputContextModes;
 };
 /**
  * Creates a validated object schema from a set of properties. Automatically
@@ -614,14 +622,6 @@ declare abstract class Node$1<TConfig = any, TCredentials = any, TSettings = any
 	get credentials(): NodeCredentials<TCredentials> | undefined;
 	get settings(): TSettings;
 }
-type SendOptions = {
-	/**
-	 * Node-author default for how the outgoing message carries the incoming
-	 * context. The flow author's per-port override (when set) wins; otherwise
-	 * this is used, falling back to `"carry"` when omitted.
-	 */
-	defaultMode?: ContextMode;
-};
 /**
  * Controls how an outgoing message carries the incoming message's context:
  * - `"carry"` (default): keep all incoming keys — including any upstream
@@ -643,14 +643,15 @@ export type ContextMode = "carry" | "trace" | "reset";
  * Every node has a return key (`"output"` by default): the value passed to
  * `send()` is merged into the incoming message at that key
  * (`{ ...msg, [returnKey]: result }`), so upstream properties propagate. By
- * default the context is carried without growing; pass
- * `{ defaultMode: "trace" }` to also keep the full prior message under `input`
- * as a recoverable provenance chain. The return key, output validation, and
- * context mode all resolve per output port; declaring
- * `outputReturnProperties` in the `configSchema` sets per-port default keys and
- * lets the flow author pick a key other than `output` per port — it does not
- * change that a return key always exists. `this.send(x)` always means "x is the result", never "x is the
- * whole message".
+ * default the context is carried without growing; declaring
+ * `outputContextModes` in the `configSchema` lets the flow author pick `trace`
+ * (keep the full prior message under `input` as a recoverable provenance chain)
+ * or `reset` per port. The return key, output validation, and context mode all
+ * resolve per output port; declaring `outputReturnProperties` in the
+ * `configSchema` sets per-port default keys and lets the flow author pick a key
+ * other than `output` per port — it does not change that a return key always
+ * exists. `this.send(x)` always means "x is the result", never "x is the whole
+ * message".
  *
  * @example
  * ```ts
@@ -676,12 +677,20 @@ export declare abstract class IONode<TConfig = any, TCredentials = any, TInput =
 	static readonly validateOutput: boolean;
 	static get inputs(): 0 | 1;
 	static get outputs(): number;
+	/**
+	 * 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(): string[] | undefined;
 	readonly config: IONodeConfig<TConfig>;
 	protected readonly context: IONodeContext;
 	constructor(RED: RED, node: NodeRedNode, config: IONodeConfig<TConfig>, credentials: IONodeCredentials<TCredentials>);
 	[WIRE_HANDLERS](nodeRedNode: NodeRedNode, createdPromise: Promise<void>): void;
 	input(msg: TInput): void | Promise<void>;
-	send(msg: TOutput, options?: SendOptions): void;
+	send(msg: TOutput): void;
 	get baseOutputs(): number;
 	get totalOutputs(): number;
 	/**
@@ -694,7 +703,7 @@ export declare abstract class IONode<TConfig = any, TCredentials = any, TInput =
 	 * throw an error or call `this.error()` for the error port, and the complete
 	 * port is sent automatically on successful input processing.
 	 */
-	sendToPort<P extends (TOutput extends Record<string, Record<string, any>> ? keyof TOutput & string : never) | number>(port: P, msg: P extends keyof TOutput ? TOutput[P] : unknown, options?: SendOptions): void;
+	sendToPort<P extends (TOutput extends Record<string, Record<string, any>> ? keyof TOutput & string : never) | number>(port: P, msg: P extends keyof TOutput ? TOutput[P] : unknown): void;
 	status(status: IONodeStatus): void;
 	error(message: string, msg?: any): void;
 	updateWires(wires: string[][]): void;
@@ -713,7 +722,7 @@ type IONodeConfig<TConfig = any> = NodeConfig<TConfig> & Static<typeof IONodeCon
 	/** Per-port return properties, keyed by base-output port index. */
 	outputReturnProperties?: Record<number, string>;
 	/** Per-port context modes, keyed by base-output port index. */
-	contextModes?: Record<number, "carry" | "trace" | "reset">;
+	outputContextModes?: Record<number, "carry" | "trace" | "reset">;
 };
 type IONodeCredentials<TCredentials = any> = NodeCredentials<TCredentials>;
 type IONodeStatus = {

package/types/shims/client/types.d.ts

@@ -73,13 +73,14 @@ export interface NodeRedNode {
     completePort?: boolean;
     statusPort?: boolean;
     /**
-     * Per-port output settings, indexed by base-output port; injected (empty) when
-     * the node has an outputsSchema. Read at runtime by IONode.
-     * `outputReturnProperties` is author-declared (SchemaType.OutputReturnProperties)
-     * — present only when the node opts into per-port return keys.
+     * Per-port output settings, indexed by base-output port. `validateOutputs` is
+     * injected (empty) when the node has an outputsSchema; `outputReturnProperties`
+     * and `outputContextModes` are author-declared (SchemaType.*) — present only
+     * when the node opts into per-port return keys / context modes. Read at
+     * runtime by IONode.
      */
     validateOutputs?: Record<number, boolean>;
-    contextModes?: Record<number, "carry" | "trace" | "reset">;
+    outputContextModes?: Record<number, "carry" | "trace" | "reset">;
     outputReturnProperties?: Record<number, string>;
     [key: string]: any;
 }
@@ -145,6 +146,13 @@ export interface JsonSchemaObject extends SchemaObject {
 export interface RuntimeNodeDefinition extends NodeDefinition {
     defaults?: NodeDefaults;
     credentials?: NodeCredentials;
+    /**
+     * Names of the base output ports when `outputsSchema` is a record of named
+     * ports, in declaration order; absent for single/positional outputs. Resolved
+     * server-side by the inliner so the editor never guesses port names from the
+     * serialized schema.
+     */
+    outputPortNames?: string[];
     configSchema?: JsonSchemaObject;
     credentialsSchema?: JsonSchemaObject;
     inputSchema?: JsonSchemaObject;

package/types/test-client-component.d.ts

@@ -85,13 +85,14 @@ interface NodeRedNode {
 	completePort?: boolean;
 	statusPort?: boolean;
 	/**
-	 * Per-port output settings, indexed by base-output port; injected (empty) when
-	 * the node has an outputsSchema. Read at runtime by IONode.
-	 * `outputReturnProperties` is author-declared (SchemaType.OutputReturnProperties)
-	 * — present only when the node opts into per-port return keys.
+	 * Per-port output settings, indexed by base-output port. `validateOutputs` is
+	 * injected (empty) when the node has an outputsSchema; `outputReturnProperties`
+	 * and `outputContextModes` are author-declared (SchemaType.*) — present only
+	 * when the node opts into per-port return keys / context modes. Read at
+	 * runtime by IONode.
 	 */
 	validateOutputs?: Record<number, boolean>;
-	contextModes?: Record<number, "carry" | "trace" | "reset">;
+	outputContextModes?: Record<number, "carry" | "trace" | "reset">;
 	outputReturnProperties?: Record<number, string>;
 	[key: string]: any;
 }

package/types/test-client-unit.d.ts

@@ -160,13 +160,14 @@ interface NodeRedNode {
 	completePort?: boolean;
 	statusPort?: boolean;
 	/**
-	 * Per-port output settings, indexed by base-output port; injected (empty) when
-	 * the node has an outputsSchema. Read at runtime by IONode.
-	 * `outputReturnProperties` is author-declared (SchemaType.OutputReturnProperties)
-	 * — present only when the node opts into per-port return keys.
+	 * Per-port output settings, indexed by base-output port. `validateOutputs` is
+	 * injected (empty) when the node has an outputsSchema; `outputReturnProperties`
+	 * and `outputContextModes` are author-declared (SchemaType.*) — present only
+	 * when the node opts into per-port return keys / context modes. Read at
+	 * runtime by IONode.
 	 */
 	validateOutputs?: Record<number, boolean>;
-	contextModes?: Record<number, "carry" | "trace" | "reset">;
+	outputContextModes?: Record<number, "carry" | "trace" | "reset">;
 	outputReturnProperties?: Record<number, string>;
 	[key: string]: any;
 }

package/vite/index.js

@@ -2060,7 +2060,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "Default",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -2096,7 +2095,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "Standard",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -2132,7 +2130,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "Predeterminado",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -2168,7 +2165,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "Par d\xE9faut",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -2204,7 +2200,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "\uAE30\uBCF8\uAC12",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -2240,7 +2235,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "Padr\xE3o",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -2276,7 +2270,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "\u041F\u043E \u0443\u043C\u043E\u043B\u0447\u0430\u043D\u0438\u044E",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -2312,7 +2305,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "\u30C7\u30D5\u30A9\u30EB\u30C8",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -2348,7 +2340,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "\u9ED8\u8BA4",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -2384,7 +2375,6 @@ function localesGenerator(options) {
       },
       contextModes: {
         modes: {
-          default: "\u9810\u8A2D",
           carry: "carry",
           trace: "trace",
           reset: "reset"
@@ -2602,7 +2592,6 @@ function nodeDefinitionsInliner(serverOutDir, entryPath, iconsDir, componentsDir
         }
         if (defaults && outputsSchema) {
           defaults.validateOutputs = { required: false, value: {} };
-          defaults.contextModes = { required: false, value: {} };
         }
         const credentials = getCredentialsFromSchema(credentialsSchema);
         _definitions[type] = {
@@ -2618,6 +2607,9 @@ function nodeDefinitionsInliner(serverOutDir, entryPath, iconsDir, componentsDir
           icon: iconsDir ? resolveIcon(iconsDir, type) : void 0,
           inputs: NodeClass.inputs,
           outputs: NodeClass.outputs,
+          // Resolved server-side (Kind symbol intact) so the editor labels
+          // named output ports without guessing from the serialized schema.
+          outputPortNames: NodeClass.outputPortNames ?? void 0,
           inputSchema,
           outputsSchema
         };