@bonsae/nrg 0.10.0 → 0.11.0

package/README.md

@@ -155,6 +155,9 @@ src/
 │   │   └── index.ts             # registerTypes, exports
 │   ├── constants.ts
 │   └── validator.ts             # AJV-based validation
+├── test/                        # Test utilities for consumers
+│   ├── index.ts                 # createNode, receive, close, reset
+│   └── mocks.ts                 # RED and Node-RED node mocks
 ├── vite/                        # Build tooling
 │   ├── plugin.ts                # Vite plugin factory
 │   ├── plugins/                 # Dev server, build orchestration
@@ -167,6 +170,37 @@ src/
     └── server.json
 ```
 
+## Testing
+
+Test your nodes' server-side logic with `@bonsae/nrg/test`:
+
+```bash
+pnpm add -D vitest
+```
+
+```typescript
+// tests/my-node.test.ts
+import { describe, it, expect } from "vitest";
+import { createNode } from "@bonsae/nrg/test";
+import MyNode from "../src/server/nodes/my-node";
+
+describe("my-node", () => {
+  it("should process messages", async () => {
+    const { node } = await createNode(MyNode, {
+      config: { greeting: "hello" },
+    });
+
+    await node.receive({ payload: "world" });
+
+    expect(node.sent(0)).toEqual([{ payload: "hello world" }]);
+  });
+});
+```
+
+```bash
+npx vitest run
+```
+
 ## Development
 
 ```bash

package/package.json

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

package/schemas/labels.schema.json

@@ -14,10 +14,23 @@
       "type": "string",
       "description": "Display name shown in the palette and workspace"
     },
+    "paletteLabel": {
+      "type": "string",
+      "description": "Label shown in the palette. Falls back to 'label' if not set."
+    },
     "description": {
       "type": "string",
       "description": "Node description for this language. Overrides the class-level description in auto-generated help docs."
     },
+    "inputLabels": {
+      "type": "string",
+      "description": "Label for the input port."
+    },
+    "outputLabels": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Labels for output ports, one per port."
+    },
     "configs": {
       "$ref": "#/$defs/labelMap",
       "description": "Labels for config properties"

package/server/index.cjs

@@ -39,6 +39,7 @@ __export(index_exports, {
   defineIONode: () => defineIONode,
   defineModule: () => defineModule,
   defineSchema: () => defineSchema,
+  initValidator: () => initValidator,
   registerType: () => registerType,
   registerTypes: () => registerTypes
 });
@@ -530,12 +531,8 @@ var Node = class {
 var IONode = class extends Node {
   static align;
   static color;
-  static labelStyle;
-  static paletteLabel;
   static inputs = 0;
   static outputs = 0;
-  static inputLabels;
-  static outputLabels;
   static inputSchema;
   static outputsSchema;
   static validateInput = false;
@@ -688,11 +685,7 @@ function defineIONode(def) {
     static color = def.color ?? "#a6bbcf";
     static inputs = def.inputs ?? 1;
     static outputs = def.outputs ?? 1;
-    static paletteLabel = def.paletteLabel;
-    static inputLabels = def.inputLabels;
-    static outputLabels = def.outputLabels;
     static align = def.align;
-    static labelStyle = def.labelStyle;
     static configSchema = def.configSchema;
     static credentialsSchema = def.credentialsSchema;
     static settingsSchema = def.settingsSchema;
@@ -1043,6 +1036,7 @@ function defineModule(definition) {
   defineIONode,
   defineModule,
   defineSchema,
+  initValidator,
   registerType,
   registerTypes
 });