@salesforce/sdk-core 1.43.1 → 1.44.0

package/dist/jsonrpc-client.d.ts

@@ -20,9 +20,27 @@
 export declare class JsonRpcClient {
     private nextRequestId;
     private pending;
+    private notificationHandlers;
     constructor();
+    /**
+     * Register a handler for a specific JSON-RPC notification method
+     *
+     * Subclasses can register handlers to process specific notification types.
+     * When a notification with the registered method is received, the handler
+     * will be invoked with the notification params.
+     *
+     * @param method - The notification method to handle (e.g., "ui/notifications/host-context-changed")
+     * @param handler - Callback function to process the notification params
+     *
+     * @example
+     * this.registerNotificationHandler("ui/notifications/host-context-changed", (params) => {
+     *   this.handleHostContextChanged(params);
+     * });
+     */
+    protected registerNotificationHandler(method: string, handler: (params: unknown) => void): void;
     /**
      * Handle incoming JSON-RPC messages from parent window
+     * Processes both responses (for requests) and notifications
      */
     private onMessage;
     /**

package/dist/jsonrpc-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonrpc-client.d.ts","sourceRoot":"","sources":["../src/jsonrpc-client.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,OAAO,CAAuC;;IAOtD;;OAEG;IACH,OAAO,CAAC,SAAS,CAqBf;IAEF;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACrD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC;CAiBnB"}
+{"version":3,"file":"jsonrpc-client.d.ts","sourceRoot":"","sources":["../src/jsonrpc-client.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,oBAAoB,CAAgD;;IAO5E;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAI/F;;;OAGG;IACH,OAAO,CAAC,SAAS,CA4Bf;IAEF;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACrD,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC;CAiBnB"}

package/dist/jsonrpc-client.js

@@ -1,4 +1,4 @@
-import { isJsonRpcResponse, isJsonRpcErrorResponse } from "./jsonrpc.js";
+import { isJsonRpcResponse, isJsonRpcErrorResponse, isJsonRpcNotification } from "./jsonrpc.js";
 /**
  * Base class for JSON-RPC 2.0 clients using postMessage
  *
@@ -21,30 +21,57 @@ import { isJsonRpcResponse, isJsonRpcErrorResponse } from "./jsonrpc.js";
 export class JsonRpcClient {
     nextRequestId = 1;
     pending = new Map();
+    notificationHandlers = new Map();
     constructor() {
         // Listen for JSON-RPC messages from parent window
         window.addEventListener("message", this.onMessage);
     }
+    /**
+     * Register a handler for a specific JSON-RPC notification method
+     *
+     * Subclasses can register handlers to process specific notification types.
+     * When a notification with the registered method is received, the handler
+     * will be invoked with the notification params.
+     *
+     * @param method - The notification method to handle (e.g., "ui/notifications/host-context-changed")
+     * @param handler - Callback function to process the notification params
+     *
+     * @example
+     * this.registerNotificationHandler("ui/notifications/host-context-changed", (params) => {
+     *   this.handleHostContextChanged(params);
+     * });
+     */
+    registerNotificationHandler(method, handler) {
+        this.notificationHandlers.set(method, handler);
+    }
     /**
      * Handle incoming JSON-RPC messages from parent window
+     * Processes both responses (for requests) and notifications
      */
     onMessage = (event) => {
         const data = event.data;
-        // Use type guard for validation with type narrowing
-        if (!isJsonRpcResponse(data)) {
+        // Handle JSON-RPC responses
+        if (isJsonRpcResponse(data)) {
+            const slot = this.pending.get(data.id);
+            if (!slot) {
+                return;
+            }
+            this.pending.delete(data.id);
+            // Type guard provides proper type narrowing
+            if (isJsonRpcErrorResponse(data)) {
+                slot.reject(new Error(data.error.message || "Request failed"));
+            }
+            else {
+                slot.resolve(data.result);
+            }
             return;
         }
-        const slot = this.pending.get(data.id);
-        if (!slot) {
-            return;
-        }
-        this.pending.delete(data.id);
-        // Type guard provides proper type narrowing
-        if (isJsonRpcErrorResponse(data)) {
-            slot.reject(new Error(data.error.message || "Request failed"));
-        }
-        else {
-            slot.resolve(data.result);
+        // Handle JSON-RPC notifications
+        if (isJsonRpcNotification(data)) {
+            const handler = this.notificationHandlers.get(data.method);
+            if (handler) {
+                handler(data.params);
+            }
         }
     };
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/sdk-core",
-  "version": "1.43.1",
+  "version": "1.44.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,5 +31,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "639c5bac6d7004d13246a86c9db4b33667da7c30"
+  "gitHead": "00f5b3b58d400b13a1b1130d11f571c2e1366cb4"
 }