@bonsae/node-red-salesforce 0.5.0 → 0.6.0

package/README.md

@@ -94,29 +94,71 @@ Call existing Apex endpoints deployed in your Salesforce org. Select the type (R
 
 ### Apex Code
 
-Deploy and execute custom Apex code directly from Node-RED. Select the type (Invocable or REST), enter a class name, and write your Apex method body in the built-in code editor. The node automatically deploys the class to Salesforce on Node-RED deploy and removes it when the node is deleted.
+Deploy and execute custom Apex code directly from Node-RED. Select the type (Invocable Method or REST Resource), enter a class name, and write your Apex code in the built-in editor. The node automatically deploys the class to Salesforce on Node-RED deploy and removes it when the node is deleted.
 
-Your code receives the input as a `payload` string and returns any value:
+You write the `run()` method and any helper methods or inner classes. The node wraps your code in the required Salesforce boilerplate (annotations, Input/Output classes, etc.):
 
 ```apex
-// Invocable example
-Map<String, Object> data = (Map<String, Object>) JSON.deserializeUntyped(payload);
-String name = (String) data.get('name');
-return 'Hello, ' + name + '!';
+private static Object run(String payload) {
+    Map<String, Object> data = (Map<String, Object>) JSON.deserializeUntyped(payload);
+    String name = (String) data.get('name');
+    return 'Hello, ' + name + '!';
+}
 ```
 
+You can add helper methods and inner classes alongside `run()`:
+
 ```apex
-// REST example
-return new Map<String, Object>{ 'message' => 'Received: ' + payload };
+private static Object run(String payload) {
+    Processor p = new Processor();
+    return p.process(payload);
+}
+
+public class Processor {
+    public String process(String input) {
+        return input.reverse();
+    }
+}
 ```
 
-The class name prefix defaults to `NRG_` and can be overridden in `settings.js`:
+The class name prefix defaults to `NRG_` and can be overridden in Node-RED `settings.js`:
 
 ```javascript
 salesforceApexCodeClassPrefix: "MY_"
 ```
 
-For REST mode, you also configure the URL mapping (e.g., `/my/endpoint/*`).
+For REST Resource mode, you also configure the URL mapping (e.g., `/my/endpoint/*`) and HTTP method.
+
+#### Apex Language Server (optional)
+
+The Apex Code editor supports an optional Language Server that provides autocompletions, hover documentation, signature help, diagnostics, and SObject field completions from your connected org.
+
+**Prerequisites**: Java 11+
+
+**Setup**:
+
+```bash
+# 1. Download the Apex Language Server JAR (one-time)
+chmod +x scripts/setup-apex-lsp.sh
+./scripts/setup-apex-lsp.sh
+
+# 2. Start the WebSocket bridge
+node scripts/apex-lsp-server.mjs
+```
+
+**Configure** in Node-RED `settings.js`:
+
+```javascript
+salesforceApexCodeLanguageServerUrl: "ws://localhost:3001"
+```
+
+The bridge spawns a Java LSP process per editor session and creates a temporary SFDX workspace for type resolution. SObject definitions are fetched from the connected org and cached for 30 minutes.
+
+The bridge accepts `--port` and `--jar` flags:
+
+```bash
+node scripts/apex-lsp-server.mjs --port 3002 --jar /path/to/apex-jorje-lsp.jar
+```
 
 ## Development
 

package/index.d.ts

@@ -104,6 +104,7 @@ payload: TAny;
 
 export declare const SalesforceApexCodeSettingsSchema: Schema<    {
 classPrefix: TString;
+languageServerUrl: TString;
 }>;
 
 export declare class SalesforceApexInvocation extends IONode<Config_3, any, Input_2, Output_2> {

package/index.html

@@ -63,4 +63,5 @@ TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 LICENSED WORK OR THE USE OR OTHER DEALINGS IN THE LICENSED WORK.
 
 -->
-<script type="module" src="resources/@bonsae/node-red-salesforce/index.dnWzY-T-.js" defer></script>
+<script type="module" src="resources/@bonsae/node-red-salesforce/index.C1dzx4s2.js" defer></script>
+<link rel="stylesheet" href="resources/@bonsae/node-red-salesforce/index.zXteTlSH.css">