@stackable-labs/sdk-extension-react 1.63.0 → 1.65.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { ApiRequest, FetchRequestInit, FetchResponse, ToastPayload, InvokeAction, ContextData, AuthState, AuthEventType, AuthEvent, AllowedIconName } from '@stackable-labs/sdk-extension-contracts';
+import { ApiRequest, FetchRequestInit, FetchResponse, ToastPayload, InvokeAction, ContextData, IdentityBaseClaims, IdentityEventType, IdentityEvent, MessagingEventType, MessagingEvent, AllowedIconName } from '@stackable-labs/sdk-extension-contracts';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
@@ -68,10 +68,9 @@ declare const useCapabilities: () => {
     context: {
         read: () => Promise<ContextData>;
     };
-    identity: {
-        read: () => Promise<AuthState>;
-        extend: (payload: {
-            claims: Record<string, unknown>;
+    extend: {
+        identity: (payload: {
+            claims: IdentityBaseClaims;
         }) => Promise<{
             additionalClaims: Record<string, unknown>;
         }>;
@@ -87,31 +86,47 @@ declare const useStore: <T, S = T>(store: Store<T>, selector?: (state: T) => S)
 declare const useExtension: () => ExtensionContextValue;
 
 /**
- * useAuthEvent — subscribe to identity events pushed from the host.
+ * useIdentityEvent — subscribe to identity events pushed from the host.
  *
  * Spike-only: no encryption, no loading state management.
  */
 
 /**
- * Register a callback for a specific auth event type (e.g. 'identity.login').
- * The callback receives the full AuthEvent payload.
+ * Register a callback for a specific identity event type (e.g. 'identity.login').
+ * The callback receives the full IdentityEvent payload.
  */
-declare const useAuthEvent: (eventType: AuthEventType, handler: (event: AuthEvent) => void) => void;
+declare const useIdentityEvent: (eventType: IdentityEventType, handler: (event: IdentityEvent) => void) => void;
 
 /**
- * useIdentityExtend — register a handler for identity claim enrichment.
+ * useExtendIdentity — register a handler for identity claim enrichment.
  *
  * When the host platform detects a customer login, it sends base claims
- * (external_id, email, name) to extensions with the identity:extend permission.
+ * (external_id, email, name) to extensions with the extend:identity permission.
  * The handler returns additional claims to merge into the JWT before signing.
  *
  * @example
- * useIdentityExtend((claims) => ({
+ * useExtendIdentity((claims) => ({
  *   external_id: `shopify_${claims.external_id}`
  * }))
  */
-type IdentityExtendHandler = (claims: Record<string, unknown>) => Record<string, unknown> | Promise<Record<string, unknown>>;
-declare const useIdentityExtend: (handler: IdentityExtendHandler) => void;
+
+type ExtendIdentityHandler = (claims: IdentityBaseClaims) => Record<string, unknown> | Promise<Record<string, unknown>>;
+declare const useExtendIdentity: (handler: ExtendIdentityHandler) => void;
+
+/**
+ * useMessagingEvent — subscribe to messaging events pushed from the host.
+ *
+ * Supports both wildcard ('postback') and specific ('postback:add_to_cart') subscriptions.
+ * Host-side filtering ensures only matching events cross the sandbox boundary;
+ * this hook applies a secondary actionName match within the extension.
+ */
+
+/**
+ * Register a callback for messaging events.
+ * - 'postback' — receive ALL postback events (requires elevated marketplace review)
+ * - 'postback:<actionName>' — receive only events matching actionName
+ */
+declare const useMessagingEvent: (eventType: MessagingEventType, handler: (event: MessagingEvent) => void) => void;
 
 interface SurfaceProps {
     /** The extension point target ID (e.g., "slot.header") */
@@ -524,4 +539,4 @@ type UseContextDataResult = ContextData & {
 };
 declare const useContextData: () => UseContextDataResult;
 
-export { type Store, Surface, createExtension, createStore, ui, useAuthEvent, useCapabilities, useContextData, useExtension, useIdentityExtend, useStore, useSurfaceContext };
+export { type Store, Surface, createExtension, createStore, ui, useCapabilities, useContextData, useExtendIdentity, useExtension, useIdentityEvent, useMessagingEvent, useStore, useSurfaceContext };

package/dist/index.js

@@ -20,7 +20,11 @@ var getWebCrypto = () => _webCrypto ??= new WebCrypto({ crypto: globalThis.crypt
 var requestCounter = 0;
 var registeredExtensionId = "unknown";
 var encryptionKey = null;
-var identityExtendHandler = null;
+var extendIdentityHandler = null;
+var setEncryptionKey = async (keyBase64) => {
+  encryptionKey = await getWebCrypto().importRawKey("secret", base64ToBytes(keyBase64), { extractable: false });
+};
+var generateRequestId = () => `req_${++requestCounter}_${Date.now()}`;
 var pendingRequests = /* @__PURE__ */ new Map();
 var extensionEventHandlers = /* @__PURE__ */ new Set();
 var onExtensionEvent = (handler) => {
@@ -29,16 +33,14 @@ var onExtensionEvent = (handler) => {
     extensionEventHandlers.delete(handler);
   };
 };
-var registerIdentityExtendHandler = (handler) => {
-  identityExtendHandler = handler;
+var registerExtendIdentityHandler = (handler) => {
+  extendIdentityHandler = handler;
   return () => {
-    if (identityExtendHandler === handler) identityExtendHandler = null;
+    if (extendIdentityHandler === handler) {
+      extendIdentityHandler = null;
+    }
   };
 };
-var generateRequestId = () => `req_${++requestCounter}_${Date.now()}`;
-var setEncryptionKey = async (keyBase64) => {
-  encryptionKey = await getWebCrypto().importRawKey("secret", base64ToBytes(keyBase64), { extractable: false });
-};
 var initRpcListener = (extensionId) => {
   registeredExtensionId = extensionId;
   window.addEventListener("message", (event) => {
@@ -57,14 +59,14 @@ var initRpcListener = (extensionId) => {
       }
       return;
     }
-    if (msg?.type === "identity-extend-request") {
-      if (identityExtendHandler) {
+    if (msg?.type === "extend-identity-request") {
+      if (extendIdentityHandler) {
         const { id, claims } = msg;
-        Promise.resolve(identityExtendHandler(claims)).then((additionalClaims) => {
-          window.parent.postMessage({ type: "identity-extend-response", id, additionalClaims }, "*");
+        Promise.resolve(extendIdentityHandler(claims)).then((additionalClaims) => {
+          window.parent.postMessage({ type: "extend-identity-response", id, additionalClaims }, "*");
         }).catch((e) => {
-          console.error("[rpc-client] identity-extend handler error:", e);
-          window.parent.postMessage({ type: "identity-extend-response", id, additionalClaims: {} }, "*");
+          console.error("[rpc-client] extend-identity handler error:", e);
+          window.parent.postMessage({ type: "extend-identity-response", id, additionalClaims: {} }, "*");
         });
       }
       return;
@@ -92,10 +94,10 @@ var sendCapabilityRequest = (capability, payload) => new Promise((resolve, rejec
   });
   const request = {
     type: "capability-request",
-    id,
     extensionId: registeredExtensionId,
     capability,
-    payload
+    payload,
+    id
   };
   window.parent.postMessage(request, "*");
   setTimeout(() => {
@@ -109,8 +111,13 @@ var callCapability = async (capability, payload) => {
   let actualPayload = payload;
   if (capability === "data.fetch" && encryptionKey) {
     const encrypted = await getWebCrypto().encryptMessage(JSON.stringify(payload), encryptionKey);
-    if (!encrypted) throw new Error("Failed to encrypt data.fetch payload");
-    actualPayload = { encrypted: true, data: encrypted };
+    if (!encrypted) {
+      throw new Error("Failed to encrypt data.fetch payload");
+    }
+    actualPayload = {
+      encrypted: true,
+      data: encrypted
+    };
   }
   const result = await sendCapabilityRequest(capability, actualPayload);
   if (capability === "data.fetch" && encryptionKey) {
@@ -201,9 +208,8 @@ var useCapabilities = () => ({
   context: {
     read: () => callCapability("context.read")
   },
-  identity: {
-    read: () => callCapability("identity.read"),
-    extend: (payload) => callCapability("identity.extend", payload)
+  extend: {
+    identity: (payload) => callCapability("extend.identity", payload)
   }
 });
 var useStore = (store, selector) => {
@@ -222,21 +228,35 @@ var useExtension = () => {
   }
   return ctx;
 };
-var useAuthEvent = (eventType, handler) => {
+var useIdentityEvent = (eventType, handler) => {
   useEffect(() => {
     const unsubscribe = onExtensionEvent((type, payload) => {
-      if (type !== eventType) return;
+      if (type !== eventType) {
+        return;
+      }
       handler(payload);
     });
     return unsubscribe;
   }, [eventType, handler]);
 };
-var useIdentityExtend = (handler) => {
+var useExtendIdentity = (handler) => {
   useEffect(() => {
-    const unregister = registerIdentityExtendHandler(handler);
+    const unregister = registerExtendIdentityHandler(handler);
     return unregister;
   }, [handler]);
 };
+var useMessagingEvent = (eventType, handler) => {
+  useEffect(() => {
+    const unsubscribe = onExtensionEvent((type, payload) => {
+      if (type !== "messaging:postback") return;
+      const event = payload;
+      if (eventType === "postback" || eventType === `postback:${event.actionName}`) {
+        handler(event);
+      }
+    });
+    return unsubscribe;
+  }, [eventType, handler]);
+};
 var useExtensionId = () => {
   const ctx = React2.useContext(ExtensionContext);
   return ctx?.extensionId ?? "unknown";
@@ -476,4 +496,4 @@ var useContextData = () => {
   return { ...contextData, loading };
 };
 
-export { Surface, createExtension, createStore, ui_exports as ui, useAuthEvent, useCapabilities, useContextData, useExtension, useIdentityExtend, useStore, useSurfaceContext };
+export { Surface, createExtension, createStore, ui_exports as ui, useCapabilities, useContextData, useExtendIdentity, useExtension, useIdentityEvent, useMessagingEvent, useStore, useSurfaceContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackable-labs/sdk-extension-react",
-  "version": "1.63.0",
+  "version": "1.65.0",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -15,7 +15,7 @@
     "@agnostack/verifyd": "alpha",
     "@remote-dom/core": "1.x",
     "@remote-dom/react": "1.x",
-    "@stackable-labs/sdk-extension-contracts": "1.63.0"
+    "@stackable-labs/sdk-extension-contracts": "1.65.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0 <19.0.0",