@bonsae/node-red-salesforce 0.4.1 → 0.6.0

package/README.md

@@ -18,7 +18,8 @@ Salesforce nodes for [Node-RED](https://nodered.org) built with [@bonsae/nrg](ht
 | **Bulk** | Bulk API 2.0 operations for large data volumes |
 | **Describe** | Retrieve SObject metadata (fields, relationships, record types) |
 | **Streaming** | Subscribe to Platform Events and Change Data Capture via Pub/Sub API (gRPC) |
-| **Apex** | Invoke Apex REST endpoints |
+| **Apex Invocation** | Call existing Apex REST endpoints or Invocable Actions |
+| **Apex Code** | Deploy and execute custom inline Apex code (Invocable or REST) |
 
 ## Prerequisites
 
@@ -66,7 +67,16 @@ Set the operation (create, read, update, delete, upsert) and SObject type. Pass
 
 ### Bulk API 2.0
 
-For large data volumes. Pass an array of records in `msg.payload` for ingest operations, or a SOQL string for bulk queries.
+For large data volumes. Supports three input types:
+
+- **Record array**: `msg.payload` as `Record[]` for ingest operations
+- **CSV string**: `msg.payload` as a CSV string
+- **Readable stream**: `msg.payload` as a Node.js `Readable` stream (for streaming from files)
+- **SOQL string**: `msg.payload` as a SOQL query string when operation is "query"
+
+Operations: insert, update, upsert, delete, hardDelete, query.
+
+For ingest operations, the output `msg.payload` contains `{ successfulResults, failedResults, unprocessedRecords }`. For queries, each record is streamed as a separate message. Job lifecycle progress is reported via the status port.
 
 ### Describe
 
@@ -78,9 +88,77 @@ Subscribes to Salesforce Platform Events and Change Data Capture events using th
 
 Configure the channel (e.g., `/event/MyEvent__e`), subscribe type (LATEST, EARLIEST, or CUSTOM with a replay ID), and batch size.
 
-### Apex REST
+### Apex Invocation
+
+Call existing Apex endpoints deployed in your Salesforce org. Select the type (REST or Invocable), then pick the endpoint or action from a dropdown that queries your org. For REST, choose the HTTP method and endpoint path. For Invocable, select the action by name. The payload is passed in `msg.payload`.
+
+### Apex Code
+
+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.
+
+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
+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
+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 Node-RED `settings.js`:
+
+```javascript
+salesforceApexCodeClassPrefix: "MY_"
+```
+
+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"
+```
 
-Invoke custom Apex REST endpoints. Set the HTTP method and path (e.g., `/MyEndpoint`). For POST/PUT/PATCH, the request body is taken from `msg.payload`.
+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

@@ -3,6 +3,7 @@ import { Connection } from 'jsforce';
 import { Infer } from '@bonsae/nrg/server';
 import { IONode } from '@bonsae/nrg/server';
 import { ModuleDefinition } from '@bonsae/nrg/server';
+import { Readable } from 'stream';
 import { RED } from '@bonsae/nrg/server';
 import { Schema } from '@bonsae/nrg/server';
 import { TAny } from '@sinclair/typebox';
@@ -17,38 +18,44 @@ import { TString } from '@sinclair/typebox';
 import { TTypedInput } from '@bonsae/nrg/server';
 import { TUnion } from '@sinclair/typebox';
 
-declare type Config = Infer<typeof SalesforceApexConfigSchema>;
+declare type Config = Infer<typeof SalesforceApexCodeConfigSchema>;
 
 declare type Config_2 = Infer<typeof SalesforceConnectionConfigSchema>;
 
-declare type Config_3 = Infer<typeof SalesforceBulkConfigSchema>;
+declare type Config_3 = Infer<typeof SalesforceApexInvocationConfigSchema>;
 
-declare type Config_4 = Infer<typeof SalesforceDescribeConfigSchema>;
+declare type Config_4 = Infer<typeof SalesforceBulkConfigSchema>;
 
-declare type Config_5 = Infer<typeof SalesforceDmlConfigSchema>;
+declare type Config_5 = Infer<typeof SalesforceDescribeConfigSchema>;
 
-declare type Config_6 = Infer<typeof SalesforceSoqlConfigSchema>;
+declare type Config_6 = Infer<typeof SalesforceDmlConfigSchema>;
 
-declare type Config_7 = Infer<typeof SalesforceStreamingConfigSchema>;
+declare type Config_7 = Infer<typeof SalesforceSoqlConfigSchema>;
+
+declare type Config_8 = Infer<typeof SalesforceStreamingConfigSchema>;
 
 declare type Credentials = Infer<typeof SalesforceConnectionCredentialsSchema>;
 
 declare const _default: ModuleDefinition;
 export default _default;
 
-declare type Input = Infer<typeof SalesforceApexInputSchema>;
+declare type Input = Infer<typeof SalesforceApexCodeInputSchema>;
+
+declare type Input_2 = Infer<typeof SalesforceApexInvocationInputSchema>;
 
-declare type Input_2 = Infer<typeof SalesforceBulkInputSchema>;
+declare type Input_3 = {
+    payload: string | Record<string, unknown>[] | Readable;
+};
 
-declare type Input_3 = Infer<typeof SalesforceDescribeInputSchema>;
+declare type Input_4 = Infer<typeof SalesforceDescribeInputSchema>;
 
-declare type Input_4 = Infer<typeof SalesforceDmlInputSchema>;
+declare type Input_5 = Infer<typeof SalesforceDmlInputSchema>;
 
-declare type Input_5 = Infer<typeof SalesforceSoqlInputSchema>;
+declare type Input_6 = Infer<typeof SalesforceSoqlInputSchema>;
 
-declare type Output = Infer<typeof SalesforceApexOutputsSchema>;
+declare type Output = Infer<typeof SalesforceApexCodeOutputsSchema>;
 
-declare type Output_2 = Infer<typeof outputsSchema>;
+declare type Output_2 = Infer<typeof SalesforceApexInvocationOutputsSchema>;
 
 declare type Output_3 = Infer<typeof SalesforceDescribeOutputsSchema>;
 
@@ -58,59 +65,96 @@ declare type Output_5 = Infer<typeof SalesforceSoqlOutputsSchema>;
 
 declare type Output_6 = Infer<typeof SalesforceStreamingOutputsSchema>;
 
-declare const outputsSchema: {
-    record: Schema<{}>;
-    jobCreated: Schema<{}>;
-};
-
-export declare class SalesforceApex extends IONode<Config, any, Input, Output> {
-    static readonly type = "salesforce-apex";
+export declare class SalesforceApexCode extends IONode<Config, any, Input, Output, Settings> {
+    static readonly type = "salesforce-apex-code";
     static readonly category = "salesforce";
     static readonly color: `#${string}`;
     static readonly configSchema: Schema;
     static readonly inputSchema: Schema;
     static readonly outputsSchema: Schema;
+    static readonly settingsSchema: Schema;
+    private deployed;
+    private getFullClassName;
+    private buildApexBody;
+    created(): Promise<void>;
     input(msg: Input): Promise<void>;
+    closed(removed?: boolean): Promise<void>;
+}
+
+export declare const SalesforceApexCodeConfigSchema: Schema<    {
+name: TString;
+connection: TNodeRef<SalesforceConnection>;
+apexType: TUnion<[TLiteral<"invocable">, TLiteral<"rest">]>;
+className: TString;
+urlMapping: TString;
+httpMethod: TUnion<[TLiteral<"HttpGet">, TLiteral<"HttpPost">, TLiteral<"HttpPut">, TLiteral<"HttpPatch">, TLiteral<"HttpDelete">]>;
+code: TString;
+errorPort: TBoolean;
+completePort: TBoolean;
+statusPort: TBoolean;
+}>;
+
+export declare const SalesforceApexCodeInputSchema: Schema<    {
+payload: TAny;
+}>;
+
+export declare const SalesforceApexCodeOutputsSchema: Schema<    {
+payload: TAny;
+}>;
+
+export declare const SalesforceApexCodeSettingsSchema: Schema<    {
+classPrefix: TString;
+languageServerUrl: TString;
+}>;
+
+export declare class SalesforceApexInvocation extends IONode<Config_3, any, Input_2, Output_2> {
+    static readonly type = "salesforce-apex-invocation";
+    static readonly category = "salesforce";
+    static readonly color: `#${string}`;
+    static readonly configSchema: Schema;
+    static readonly inputSchema: Schema;
+    static readonly outputsSchema: Schema;
+    input(msg: Input_2): Promise<void>;
 }
 
-export declare const SalesforceApexConfigSchema: Schema<    {
+export declare const SalesforceApexInvocationConfigSchema: Schema<    {
 name: TString;
 connection: TNodeRef<SalesforceConnection>;
+apexType: TUnion<[TLiteral<"rest">, TLiteral<"invocable">]>;
 method: TUnion<[TLiteral<"GET">, TLiteral<"POST">, TLiteral<"PUT">, TLiteral<"PATCH">, TLiteral<"DELETE">]>;
 path: TTypedInput<string>;
+actionName: TString;
 errorPort: TBoolean;
 completePort: TBoolean;
 statusPort: TBoolean;
 }>;
 
-export declare const SalesforceApexInputSchema: Schema<    {
+export declare const SalesforceApexInvocationInputSchema: Schema<    {
 payload: TAny;
 }>;
 
-export declare const SalesforceApexOutputsSchema: Schema<    {
+export declare const SalesforceApexInvocationOutputsSchema: Schema<    {
 payload: TAny;
 }>;
 
-export declare class SalesforceBulk extends IONode<Config_3, any, Input_2, Output_2> {
+export declare class SalesforceBulk extends IONode<Config_4, any, Input_3> {
     static readonly type = "salesforce-bulk";
     static readonly category = "salesforce";
     static readonly color: `#${string}`;
     static readonly configSchema: Schema;
     static readonly inputSchema: Schema;
-    static readonly outputsSchema: {
-        record: Schema<{}>;
-        jobCreated: Schema<{}>;
-    };
-    private sendRecord;
-    private sendJobCreated;
-    input(msg: Input_2): Promise<void>;
+    static readonly outputsSchema: Schema;
+    input(msg: Input_3): Promise<void>;
+    private executeQuery;
+    private executeIngest;
 }
 
 export declare const SalesforceBulkConfigSchema: Schema<    {
 name: TString;
 connection: TNodeRef<SalesforceConnection>;
-operation: TUnion<[TLiteral<"insert">, TLiteral<"update">, TLiteral<"upsert">, TLiteral<"delete">, TLiteral<"query">]>;
+operation: TUnion<[TLiteral<"insert">, TLiteral<"update">, TLiteral<"upsert">, TLiteral<"delete">, TLiteral<"hardDelete">, TLiteral<"query">]>;
 sObjectType: TTypedInput<string>;
+query: TTypedInput<string>;
 externalIdField: TOptional<TString>;
 assignmentRuleId: TOptional<TString>;
 columnDelimiter: TUnion<[TLiteral<"COMMA">, TLiteral<"TAB">, TLiteral<"PIPE">, TLiteral<"SEMICOLON">, TLiteral<"CARET">, TLiteral<"BACKQUOTE">]>;
@@ -126,6 +170,10 @@ export declare const SalesforceBulkInputSchema: Schema<    {
 payload: TAny;
 }>;
 
+export declare const SalesforceBulkOutputsSchema: Schema<    {
+payload: TAny;
+}>;
+
 export declare class SalesforceConnection extends ConfigNode<Config_2, Credentials> {
     static readonly type = "salesforce-connection";
     static readonly configSchema: Schema;
@@ -152,14 +200,14 @@ refreshToken: TString;
 instanceUrl: TString;
 }>;
 
-export declare class SalesforceDescribe extends IONode<Config_4, any, Input_3, Output_3> {
+export declare class SalesforceDescribe extends IONode<Config_5, any, Input_4, Output_3> {
     static readonly type = "salesforce-describe";
     static readonly category = "salesforce";
     static readonly color: `#${string}`;
     static readonly configSchema: Schema;
     static readonly inputSchema: Schema;
     static readonly outputsSchema: Schema;
-    input(msg: Input_3): Promise<void>;
+    input(msg: Input_4): Promise<void>;
 }
 
 export declare const SalesforceDescribeConfigSchema: Schema<    {
@@ -184,14 +232,14 @@ recordTypeInfos: TArray<TAny>;
 }>;
 }>;
 
-export declare class SalesforceDml extends IONode<Config_5, any, Input_4, Output_4> {
+export declare class SalesforceDml extends IONode<Config_6, any, Input_5, Output_4> {
     static readonly type = "salesforce-dml";
     static readonly category = "salesforce";
     static readonly color: `#${string}`;
     static readonly configSchema: Schema;
     static readonly inputSchema: Schema;
     static readonly outputsSchema: Schema;
-    input(msg: Input_4): Promise<void>;
+    input(msg: Input_5): Promise<void>;
 }
 
 export declare const SalesforceDmlConfigSchema: Schema<    {
@@ -214,14 +262,14 @@ export declare const SalesforceDmlOutputsSchema: Schema<    {
 payload: TAny;
 }>;
 
-export declare class SalesforceSoql extends IONode<Config_6, any, Input_5, Output_5> {
+export declare class SalesforceSoql extends IONode<Config_7, any, Input_6, Output_5> {
     static readonly type = "salesforce-soql";
     static readonly category = "salesforce";
     static readonly color: `#${string}`;
     static readonly configSchema: Schema;
     static readonly inputSchema: Schema;
     static readonly outputsSchema: Schema;
-    input(msg: Input_5): Promise<void>;
+    input(msg: Input_6): Promise<void>;
 }
 
 export declare const SalesforceSoqlConfigSchema: Schema<    {
@@ -243,7 +291,7 @@ totalSize: TNumber;
 done: TBoolean;
 }>;
 
-export declare class SalesforceStreaming extends IONode<Config_7, any, any, Output_6> {
+export declare class SalesforceStreaming extends IONode<Config_8, any, any, Output_6> {
     static readonly type = "salesforce-streaming";
     static readonly category = "salesforce";
     static readonly color: `#${string}`;
@@ -281,4 +329,6 @@ channel: TString;
 topic: TString;
 }>;
 
+declare type Settings = Infer<typeof SalesforceApexCodeSettingsSchema>;
+
 export { }

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.FDBQSjT7.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">