@bonsae/nrg 0.23.0 → 0.25.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bonsae/nrg",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "NRG framework — build Node-RED nodes with Vue 3, TypeScript, and JSON Schema",
   "author": "Allan Oricil <allanoricil@duck.com>",
   "license": "MIT",
@@ -119,7 +119,7 @@
     }
   },
   "dependencies": {
-    "@bonsae/nrg-runtime": "0.23.0",
+    "@bonsae/nrg-runtime": "0.25.0",
     "@clack/prompts": "^1.0.1",
     "@sinclair/typebox": "^0.34.33",
     "@vitejs/plugin-vue": "^5.2.3",

package/test/server/unit/index.js

@@ -239,6 +239,18 @@ function createNodeRedNode(options = {}) {
 import { initValidator } from "@bonsae/nrg-runtime/internal/server";
 import { WIRE_HANDLERS } from "@bonsae/nrg-runtime/internal/server";
 import { Kind } from "@sinclair/typebox";
+function builtinPortIndex(node, name) {
+  if (name !== "error" && name !== "complete" && name !== "status") {
+    return void 0;
+  }
+  const config = node.config;
+  const base = node.baseOutputs;
+  if (name === "error") return config.errorPort ? base : -1;
+  let index = base + (config.errorPort ? 1 : 0);
+  if (name === "complete") return config.completePort ? index : -1;
+  index += config.completePort ? 1 : 0;
+  return config.statusPort ? index : -1;
+}
 function buildConfig(NodeClass, userConfig = {}) {
   const defaults = {};
   if (NodeClass.configSchema?.properties) {
@@ -289,16 +301,19 @@ function attachHelpers(node, nodeRedNode, NodeClass) {
     },
     sent(port) {
       if (port === void 0) return [...sentMessages];
+      const pluck = (idx) => sentMessages.map((msg) => Array.isArray(msg) ? msg[idx] : void 0).filter((msg) => msg != null);
       if (typeof port === "string") {
+        const builtin = builtinPortIndex(node, port);
+        if (builtin !== void 0) return builtin === -1 ? [] : pluck(builtin);
         const schema = NodeClass.outputsSchema;
         if (!schema || Array.isArray(schema) || typeof schema === "object" && Kind in schema) {
           return [];
         }
         const idx = Object.keys(schema).indexOf(port);
         if (idx === -1) return [];
-        return sentMessages.map((msg) => Array.isArray(msg) ? msg[idx] : void 0).filter((msg) => msg != null);
+        return pluck(idx);
       }
-      return sentMessages.map((msg) => Array.isArray(msg) ? msg[port] : void 0).filter((msg) => msg != null);
+      return pluck(port);
     },
     statuses() {
       return [...statusCalls];

package/types/server.d.ts

@@ -727,7 +727,7 @@ export declare abstract class IONode<TConfig = any, TCredentials = any, TInput =
 	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>;
+	input(msg: TInput): unknown;
 	send(msg: TOutput): void;
 	get baseOutputs(): number;
 	get totalOutputs(): number;
@@ -787,7 +787,7 @@ export interface IIONode<TConfig = any, TCredentials = any, TInput = any, TOutpu
 	readonly y: number;
 	readonly g: string | undefined;
 	readonly wires: string[][];
-	input(msg: TInput): void | Promise<void>;
+	input(msg: TInput): unknown;
 	send(msg: TOutput): void;
 	status(status: IONodeStatus): void;
 	updateWires(wires: string[][]): void;
@@ -811,7 +811,7 @@ interface IONodeDefinition<TConfigSchema extends TSchema | undefined = undefined
 	registered?(RED: RED): void | Promise<void>;
 	created?(this: BoundIONode<TConfigSchema, TCredsSchema, TSettingsSchema, TInputSchema, TOutputsSchema>): void | Promise<void>;
 	closed?(this: BoundIONode<TConfigSchema, TCredsSchema, TSettingsSchema, TInputSchema, TOutputsSchema>, removed?: boolean): void | Promise<void>;
-	input?(this: BoundIONode<TConfigSchema, TCredsSchema, TSettingsSchema, TInputSchema, TOutputsSchema>, msg: InferOr<TInputSchema, any>): void | Promise<void>;
+	input?(this: BoundIONode<TConfigSchema, TCredsSchema, TSettingsSchema, TInputSchema, TOutputsSchema>, msg: InferOr<TInputSchema, any>): unknown;
 }
 /**
  * Base class for configuration nodes that are shared across multiple nodes

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

@@ -445,6 +445,31 @@ type PortTuple<TOutput, TInput> = IsAny<TOutput> extends true ? any[] : TOutput
 ] : string extends keyof TOutput ? WrappedPort<unknown, TInput>[] : WrappedPort<TOutput[keyof TOutput], TInput>[] : [
 	WrappedPort<TOutput, TInput>
 ];
+type NodeSource = {
+	id: string;
+	type: string;
+	name: string;
+};
+type ErrorPortMessage = {
+	error: {
+		name: string;
+		message: string;
+		source: NodeSource;
+	};
+} & Record<string, unknown>;
+type CompletePortMessage = {
+	complete: {
+		source: NodeSource;
+	};
+} & Record<string, unknown>;
+type StatusPortMessage = {
+	status: {
+		fill?: string;
+		shape?: string;
+		text?: string;
+	};
+	source: NodeSource;
+} & Record<string, unknown>;
 interface TestNodeHelpers<TInput = any, TOutput = any> {
 	/** Drive the node's input handler with a Node-RED message. For an object
 	 * input the declared shape is required while arbitrary extra message
@@ -455,11 +480,13 @@ interface TestNodeHelpers<TInput = any, TOutput = any> {
 	close(removed?: boolean): Promise<void>;
 	reset(): void;
 	/** All raw emissions, each a positional array — `sent()[i][0]` is port 0 of
-	 * emission `i`, typed from the node's declared output. Built-in lifecycle
-	 * ports (error/complete/status) are emitted as their own entries here, with
-	 * slots beyond the declared ports; use `sent(port)` / `sent(name)` for typed,
-	 * per-port assertions. */
+	 * emission `i`, typed from the node's declared output. Read one port directly
+	 * with `sent(name)` / `sent(port)`, including the built-in lifecycle ports by
+	 * name: `sent("error")`, `sent("complete")`, `sent("status")`. */
 	sent(): PortTuple<TOutput, TInput>[];
+	sent(port: "error"): ErrorPortMessage[];
+	sent(port: "complete"): CompletePortMessage[];
+	sent(port: "status"): StatusPortMessage[];
 	sent<P extends PortNames<TOutput>>(port: P): WrappedPort<PortMessage<TOutput, P>, TInput>[];
 	sent(port: number): WrappedPort<unknown, TInput>[];
 	statuses(): any[];