@stackable-labs/sdk-extension-react 1.64.0 → 1.66.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { ApiRequest, FetchRequestInit, FetchResponse, ToastPayload, InvokeAction, ContextData, IdentityBaseClaims, IdentityEventType, IdentityEvent, AllowedIconName } from '@stackable-labs/sdk-extension-contracts';
+import { ApiRequest, FetchRequestInit, FetchResponse, ToastPayload, InvokeAction, ContextData, IdentityBaseClaims, IdentityEventType, IdentityEvent, ExtendIdentityHandler, MessagingEventType, MessagingEventHandler, AllowedIconName } from '@stackable-labs/sdk-extension-contracts';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
@@ -98,20 +98,34 @@ declare const useExtension: () => ExtensionContextValue;
 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 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 ExtendIdentityHandler = (claims: IdentityBaseClaims) => Record<string, unknown> | Promise<Record<string, unknown>>;
-declare const useIdentityExtend: (handler: ExtendIdentityHandler) => void;
+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: MessagingEventHandler) => void;
 
 interface SurfaceProps {
     /** The extension point target ID (e.g., "slot.header") */
@@ -524,4 +538,4 @@ type UseContextDataResult = ContextData & {
 };
 declare const useContextData: () => UseContextDataResult;
 
-export { type Store, Surface, createExtension, createStore, ui, useCapabilities, useContextData, useExtension, useIdentityEvent, useIdentityExtend, useStore, useSurfaceContext };
+export { type Store, Surface, createExtension, createStore, ui, useCapabilities, useContextData, useExtendIdentity, useExtension, useIdentityEvent, useMessagingEvent, useStore, useSurfaceContext };

package/dist/index.js

@@ -239,12 +239,24 @@ var useIdentityEvent = (eventType, handler) => {
     return unsubscribe;
   }, [eventType, handler]);
 };
-var useIdentityExtend = (handler) => {
+var useExtendIdentity = (handler) => {
   useEffect(() => {
     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";
@@ -484,4 +496,4 @@ var useContextData = () => {
   return { ...contextData, loading };
 };
 
-export { Surface, createExtension, createStore, ui_exports as ui, useCapabilities, useContextData, useExtension, useIdentityEvent, 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.64.0",
+  "version": "1.66.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.64.0"
+    "@stackable-labs/sdk-extension-contracts": "1.66.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0 <19.0.0",