@bonsae/nrg 0.15.0 → 0.16.0

package/test/index.js

@@ -356,6 +356,7 @@ var ValidationError = class _ValidationError extends Error {
 
 // src/core/server/validation.ts
 function initValidator(RED) {
+  if (RED.validator) return;
   const nrg = {
     validator: new Validator({
       customKeywords: [
@@ -395,7 +396,7 @@ function initValidator(RED) {
 }
 
 // src/core/server/nodes/symbols.ts
-var WIRE_HANDLERS = Symbol("wireHandlers");
+var WIRE_HANDLERS = Symbol.for("nrg.wireHandlers");
 
 // src/test/index.ts
 function buildConfig(NodeClass, userConfig = {}) {
@@ -522,10 +523,10 @@ async function createNode(NodeClass, options = {}) {
   NodeClass.validateSettings(RED);
   await Promise.resolve(NodeClass.registered?.(RED));
   const node = new NodeClass(RED, nodeRedNode, config, credentials);
+  const augmented = attachHelpers(node, nodeRedNode);
   const createdPromise = Promise.resolve(node.created?.());
   node[WIRE_HANDLERS](nodeRedNode, createdPromise);
   await createdPromise;
-  const augmented = attachHelpers(node, nodeRedNode);
   return { node: augmented, RED };
 }
 export {

package/types/server.d.ts

@@ -516,7 +516,8 @@ export interface NodeConstructor<T = any, TConfig = any, TCredentials = any> {
 }
 type NodeConfig<TConfig = any> = TConfig & Static<typeof NodeConfigSchema>;
 type NodeCredentials<TCredentials = any> = TCredentials;
-interface INode<TConfig = any, TCredentials = any, TSettings = any> {
+/** Public instance interface for all NRG nodes. Implemented by {@link Node}. */
+export interface INode<TConfig = any, TCredentials = any, TSettings = any> {
 	readonly config: NodeConfig<TConfig>;
 	readonly id: string;
 	readonly name: string | undefined;
@@ -619,13 +620,17 @@ export declare abstract class IONode<TConfig = any, TCredentials = any, TInput =
 	get totalOutputs(): number;
 	/**
 	 * Send a message to a specific output port by index or name.
-	 * Built-in ports: `"error"`, `"complete"`, `"status"` — resolved automatically
-	 * based on the node's built-in port configuration.
+	 * Built-in port `"status"` is resolved automatically based on the node's
+	 * built-in port configuration.
 	 * Custom named ports are resolved from `outputsSchema` when it is a record.
 	 * Numeric indices refer to the base output ports (0-based).
+	 *
+	 * Note: `"error"` and `"complete"` ports are managed by the framework and
+	 * cannot be sent to directly. Throw an error to trigger the error port,
+	 * and the complete port is sent automatically on successful input processing.
 	 */
-	sendToPort<P extends (keyof TOutput & string) | number | "error" | "complete" | "status">(port: P, msg: P extends keyof TOutput ? TOutput[P] : unknown): void;
-	status(status: IONodeStatus): void;
+	sendToPort<P extends (TOutput extends Record<string, Record<string, any>> ? keyof TOutput & string : never) | number | "status">(port: P, msg: P extends keyof TOutput ? TOutput[P] : unknown): void;
+	status(status: IONodeStatus, data?: Record<string, unknown>): void;
 	error(message: string, msg?: any): void;
 	updateWires(wires: string[][]): void;
 	receive(msg: TInput): void;
@@ -669,7 +674,7 @@ export interface IIONode<TConfig = any, TCredentials = any, TInput = any, TOutpu
 	receive(msg: TInput): void;
 	readonly baseOutputs: number;
 	readonly totalOutputs: number;
-	sendToPort<P extends (keyof TOutput & string) | number | "error" | "complete" | "status">(port: P, msg: P extends keyof TOutput ? TOutput[P] : unknown): void;
+	sendToPort<P extends (TOutput extends Record<string, Record<string, any>> ? keyof TOutput & string : never) | number | "status">(port: P, msg: P extends keyof TOutput ? TOutput[P] : unknown): void;
 }
 interface IONodeDefinition<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> {
 	type: string;

package/types/shims/form/components/node-red-editor-input.vue.d.ts

@@ -27,12 +27,13 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
 }>, {}, {
     editorId: string;
     stateId: string;
+    trayElement: HTMLElement | null;
 }, {}, {
     mountEditor(): void;
     createEditorInstance(): void;
     createExpandeEditorTray(): void;
     onClickExpand(): void;
-}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, "update:value"[], "update:value", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("update:value" | "editor-ready" | "tray-open" | "tray-close")[], "update:value" | "editor-ready" | "tray-open" | "tray-close", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     value: {
         type: StringConstructor;
         default: string;
@@ -60,6 +61,9 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     };
 }>> & Readonly<{
     "onUpdate:value"?: ((...args: any[]) => any) | undefined;
+    "onEditor-ready"?: ((...args: any[]) => any) | undefined;
+    "onTray-open"?: ((...args: any[]) => any) | undefined;
+    "onTray-close"?: ((...args: any[]) => any) | undefined;
 }>, {
     label: string;
     icon: string;

package/types/shims/form/components/node-red-json-schema-form.vue.d.ts

@@ -572,12 +572,13 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     }>, {}, {
         editorId: string;
         stateId: string;
+        trayElement: HTMLElement | null;
     }, {}, {
         mountEditor(): void;
         createEditorInstance(): void;
         createExpandeEditorTray(): void;
         onClickExpand(): void;
-    }, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, "update:value"[], "update:value", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    }, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("update:value" | "editor-ready" | "tray-open" | "tray-close")[], "update:value" | "editor-ready" | "tray-open" | "tray-close", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
         value: {
             type: StringConstructor;
             default: string;
@@ -605,6 +606,9 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         };
     }>> & Readonly<{
         "onUpdate:value"?: ((...args: any[]) => any) | undefined;
+        "onEditor-ready"?: ((...args: any[]) => any) | undefined;
+        "onTray-open"?: ((...args: any[]) => any) | undefined;
+        "onTray-close"?: ((...args: any[]) => any) | undefined;
     }>, {
         label: string;
         icon: string;