@bonsae/node-red-salesforce 0.4.0 → 0.5.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,35 @@ 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 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.
+
+Your code receives the input as a `payload` string and returns any value:
+
+```apex
+// Invocable example
+Map<String, Object> data = (Map<String, Object>) JSON.deserializeUntyped(payload);
+String name = (String) data.get('name');
+return 'Hello, ' + name + '!';
+```
+
+```apex
+// REST example
+return new Map<String, Object>{ 'message' => 'Received: ' + payload };
+```
+
+The class name prefix defaults to `NRG_` and can be overridden in `settings.js`:
+
+```javascript
+salesforceApexCodeClassPrefix: "MY_"
+```
 
-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`.
+For REST mode, you also configure the URL mapping (e.g., `/my/endpoint/*`).
 
 ## 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,105 +18,161 @@ 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_3 = {
+    payload: string | Record<string, unknown>[] | Readable;
+};
 
-declare type Input_2 = Infer<typeof SalesforceBulkInputSchema>;
+declare type Input_4 = Infer<typeof SalesforceDescribeInputSchema>;
 
-declare type Input_3 = Infer<typeof SalesforceDescribeInputSchema>;
+declare type Input_5 = Infer<typeof SalesforceDmlInputSchema>;
 
-declare type Input_4 = Infer<typeof SalesforceDmlInputSchema>;
+declare type Input_6 = Infer<typeof SalesforceSoqlInputSchema>;
 
-declare type Input_5 = Infer<typeof SalesforceSoqlInputSchema>;
+declare type Output = Infer<typeof SalesforceApexCodeOutputsSchema>;
 
-declare type Output = Infer<typeof SalesforceApexOutputsSchema>;
+declare type Output_2 = Infer<typeof SalesforceApexInvocationOutputsSchema>;
 
-declare type Output_2 = Infer<typeof SalesforceDescribeOutputsSchema>;
+declare type Output_3 = Infer<typeof SalesforceDescribeOutputsSchema>;
 
-declare type Output_3 = Infer<typeof SalesforceDmlOutputsSchema>;
+declare type Output_4 = Infer<typeof SalesforceDmlOutputsSchema>;
 
-declare type Output_4 = Infer<typeof SalesforceSoqlOutputsSchema>;
+declare type Output_5 = Infer<typeof SalesforceSoqlOutputsSchema>;
 
-declare type Output_5 = Infer<typeof SalesforceStreamingOutputsSchema>;
+declare type Output_6 = Infer<typeof SalesforceStreamingOutputsSchema>;
 
-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 SalesforceApexConfigSchema: Schema<    {
+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;
+}>;
+
+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 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>;
-emitError: TBoolean;
-emitComplete: TBoolean;
-emitStatus: TBoolean;
+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> {
+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: 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">]>;
 lineEnding: TUnion<[TLiteral<"LF">, TLiteral<"CRLF">]>;
 pollInterval: TNumber;
 pollTimeout: TNumber;
-emitError: TBoolean;
-emitComplete: TBoolean;
-emitStatus: TBoolean;
+errorPort: TBoolean;
+completePort: TBoolean;
+statusPort: TBoolean;
 }>;
 
 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;
@@ -142,23 +199,23 @@ refreshToken: TString;
 instanceUrl: TString;
 }>;
 
-export declare class SalesforceDescribe extends IONode<Config_4, any, Input_3, Output_2> {
+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<    {
 name: TString;
 connection: TNodeRef<SalesforceConnection>;
 sObjectType: TTypedInput<string>;
-emitError: TBoolean;
-emitComplete: TBoolean;
-emitStatus: TBoolean;
+errorPort: TBoolean;
+completePort: TBoolean;
+statusPort: TBoolean;
 }>;
 
 export declare const SalesforceDescribeInputSchema: Schema<    {
@@ -174,14 +231,14 @@ recordTypeInfos: TArray<TAny>;
 }>;
 }>;
 
-export declare class SalesforceDml extends IONode<Config_5, any, Input_4, Output_3> {
+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<    {
@@ -191,9 +248,9 @@ operation: TUnion<[TLiteral<"create">, TLiteral<"read">, TLiteral<"update">, TLi
 sObjectType: TTypedInput<string>;
 record: TTypedInput<any>;
 externalIdField: TOptional<TString>;
-emitError: TBoolean;
-emitComplete: TBoolean;
-emitStatus: TBoolean;
+errorPort: TBoolean;
+completePort: TBoolean;
+statusPort: TBoolean;
 }>;
 
 export declare const SalesforceDmlInputSchema: Schema<    {
@@ -204,20 +261,23 @@ export declare const SalesforceDmlOutputsSchema: Schema<    {
 payload: TAny;
 }>;
 
-export declare class SalesforceSoql extends IONode<Config_6, any, Input_5, Output_4> {
+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<    {
 name: TString;
 connection: TNodeRef<SalesforceConnection>;
 query: TTypedInput<string>;
+errorPort: TBoolean;
+completePort: TBoolean;
+statusPort: TBoolean;
 }>;
 
 export declare const SalesforceSoqlInputSchema: Schema<    {
@@ -230,7 +290,7 @@ totalSize: TNumber;
 done: TBoolean;
 }>;
 
-export declare class SalesforceStreaming extends IONode<Config_7, any, any, Output_5> {
+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}`;
@@ -256,8 +316,9 @@ channelName: TString;
 subscribeType: TUnion<[TLiteral<"LATEST">, TLiteral<"EARLIEST">, TLiteral<"CUSTOM">]>;
 replayId: TOptional<TString>;
 numRequested: TNumber;
-emitError: TBoolean;
-emitStatus: TBoolean;
+errorPort: TBoolean;
+completePort: TBoolean;
+statusPort: TBoolean;
 }>;
 
 export declare const SalesforceStreamingOutputsSchema: Schema<    {
@@ -267,4 +328,6 @@ channel: TString;
 topic: TString;
 }>;
 
+declare type Settings = Infer<typeof SalesforceApexCodeSettingsSchema>;
+
 export { }

package/index.html

@@ -63,4 +63,4 @@ 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.BmVSYWAa.js" defer></script>
+<script type="module" src="resources/@bonsae/node-red-salesforce/index.dnWzY-T-.js" defer></script>