@bonsae/nrg 0.22.2 → 0.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bonsae/nrg",
-  "version": "0.22.2",
+  "version": "0.24.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.22.2",
+    "@bonsae/nrg-runtime": "0.24.0",
     "@clack/prompts": "^1.0.1",
     "@sinclair/typebox": "^0.34.33",
     "@vitejs/plugin-vue": "^5.2.3",

package/test/server/unit/index.js

@@ -298,9 +298,7 @@ function attachHelpers(node, nodeRedNode, NodeClass) {
         if (idx === -1) return [];
         return sentMessages.map((msg) => Array.isArray(msg) ? msg[idx] : void 0).filter((msg) => msg != null);
       }
-      return sentMessages.map(
-        (msg) => Array.isArray(msg) ? msg[port] : port === 0 ? msg : void 0
-      ).filter((msg) => msg != null);
+      return sentMessages.map((msg) => Array.isArray(msg) ? msg[port] : void 0).filter((msg) => msg != null);
     },
     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
@@ -899,7 +899,7 @@ export declare function registerTypes(nodes: NodeConstructor[]): RegistrationFun
  * });
  * ```
  */
-export declare function defineIONode<TConfigSchema extends TSchema | undefined = undefined, TCredsSchema extends TSchema | undefined = undefined, TSettingsSchema extends TSchema | undefined = undefined, TInputSchema extends TSchema | undefined = undefined, TOutputsSchema extends TSchema | readonly TSchema[] | Record<string, TSchema> | undefined = undefined>(def: IONodeDefinition<TConfigSchema, TCredsSchema, TSettingsSchema, TInputSchema, TOutputsSchema>): NodeConstructor<IIONode<InferOr<TConfigSchema, any>, InferOr<TCredsSchema, any>, InferOr<TInputSchema, any>, InferOutputs<TOutputsSchema>>>;
+export declare function defineIONode<TConfigSchema extends TSchema | undefined = undefined, TCredsSchema extends TSchema | undefined = undefined, TSettingsSchema extends TSchema | undefined = undefined, TInputSchema extends TSchema | undefined = undefined, const TOutputsSchema extends TSchema | readonly TSchema[] | Record<string, TSchema> | undefined = undefined>(def: IONodeDefinition<TConfigSchema, TCredsSchema, TSettingsSchema, TInputSchema, TOutputsSchema>): NodeConstructor<IIONode<InferOr<TConfigSchema, any>, InferOr<TCredsSchema, any>, InferOr<TInputSchema, any>, InferOutputs<TOutputsSchema>>>;
 /**
  * Creates a config node class from a definition object.
  *

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

@@ -427,13 +427,41 @@ type PortNames<T> = [
 	Record<string, Record<string, any>>
 ] ? string extends keyof T ? never : keyof T & string : never;
 type PortMessage<T, P extends string> = T extends Record<string, any> ? (P extends keyof T ? T[P] : never) : never;
+type IsAny<T> = 0 extends 1 & T ? true : false;
+type WrappedPort<V, TInput> = {
+	output: V;
+} & (unknown extends TInput ? unknown : Partial<TInput>);
+type PortTuple<TOutput, TInput> = IsAny<TOutput> extends true ? any[] : TOutput extends readonly [
+	any,
+	...any[]
+] ? {
+	[K in keyof TOutput]: WrappedPort<TOutput[K], TInput>;
+} : [
+	TOutput
+] extends [
+	Record<string, Record<string, any>>
+] ? keyof TOutput extends never ? [
+	WrappedPort<TOutput, TInput>
+] : string extends keyof TOutput ? WrappedPort<unknown, TInput>[] : WrappedPort<TOutput[keyof TOutput], TInput>[] : [
+	WrappedPort<TOutput, TInput>
+];
 interface TestNodeHelpers<TInput = any, TOutput = any> {
-	receive(msg: TInput): Promise<void>;
+	/** Drive the node's input handler with a Node-RED message. For an object
+	 * input the declared shape is required while arbitrary extra message
+	 * properties (`topic`, `_msgid`, correlation ids, …) are allowed — a real
+	 * Node-RED message always carries more than the validated input schema. A
+	 * non-object input type passes through unchanged. */
+	receive(msg: TInput extends object ? TInput & Record<string, unknown> : TInput): Promise<void>;
 	close(removed?: boolean): Promise<void>;
 	reset(): void;
-	sent(): TOutput[];
-	sent<P extends PortNames<TOutput>>(port: P): PortMessage<TOutput, P>[];
-	sent(port: number): any[];
+	/** 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. */
+	sent(): PortTuple<TOutput, TInput>[];
+	sent<P extends PortNames<TOutput>>(port: P): WrappedPort<PortMessage<TOutput, P>, TInput>[];
+	sent(port: number): WrappedPort<unknown, TInput>[];
 	statuses(): any[];
 	logged(level?: "info" | "warn" | "error" | "debug"): string[];
 	warned(): string[];