@stackable-labs/sdk-extension-react 1.70.0 → 1.71.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { ApiRequest, FetchRequestInit, FetchResponse, ToastPayload, InvokeAction, ContextData, IdentityBaseClaims, IdentityEventType, IdentityEvent, ExtendIdentityHandler, MessagingEventType, MessagingEventHandler, AllowedIconName } from '@stackable-labs/sdk-extension-contracts';
+import { ApiRequest, FetchRequestInit, FetchResponse, ToastPayload, InvokeAction, ContextData, IdentityBaseClaims, IdentityEventType, IdentityEvent, ExtendIdentityHandler, MessagingEventType, MessagingEventHandler, ActivityEventType, ActivityEventHandler, EventType, AllowedIconName } from '@stackable-labs/sdk-extension-contracts';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
@@ -88,14 +88,16 @@ declare const useExtension: () => ExtensionContextValue;
 /**
  * useIdentityEvent — subscribe to identity events pushed from the host.
  *
- * Spike-only: no encryption, no loading state management.
+ * Parameters are domain-stripped (e.g., 'login' not 'identity:login').
+ * Use '*' to receive all identity events.
  */
 
 /**
- * Register a callback for a specific identity event type (e.g. 'identity.login').
+ * Register a callback for a specific identity event type (e.g. 'login').
+ * Use '*' to receive all identity events.
  * The callback receives the full IdentityEvent payload.
  */
-declare const useIdentityEvent: (eventType: IdentityEventType, handler: (event: IdentityEvent) => void) => void;
+declare const useIdentityEvent: (eventType: IdentityEventType | "*", handler: (event: IdentityEvent) => void) => void;
 
 /**
  * useExtendIdentity — register a handler for identity claim enrichment.
@@ -115,17 +117,47 @@ 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.
+ * Supports wildcard ('*'), sub-domain ('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.
+ * this hook applies a secondary eventName/actionName match within the extension.
  */
 
 /**
  * Register a callback for messaging events.
- * - 'postback' — receive ALL postback events (requires elevated marketplace review)
+ * - '*' — receive ALL messaging events (requires elevated marketplace review)
+ * - 'postback' — receive all postback events
  * - 'postback:<actionName>' — receive only events matching actionName
  */
-declare const useMessagingEvent: (eventType: MessagingEventType, handler: MessagingEventHandler) => void;
+declare const useMessagingEvent: (eventType: MessagingEventType | "*", handler: MessagingEventHandler) => void;
+
+/**
+ * useActivityEvent — subscribe to activity events pushed from the host.
+ *
+ * Parameters are domain-stripped (e.g., 'product_view' not 'activity:product_view').
+ * Use '*' to receive all activity events.
+ */
+
+/**
+ * Register a callback for a specific activity event type (e.g. 'product_view').
+ * Use '*' to receive all activity events.
+ * The callback receives the full ActivityEvent payload.
+ */
+declare const useActivityEvent: (eventType: ActivityEventType | "*", handler: ActivityEventHandler) => void;
+
+/**
+ * useEvent — generic cross-domain event hook.
+ *
+ * Accepts fully-qualified event types (e.g., 'activity:product_view', 'identity:login', 'messaging:postback').
+ * Use bare domain name (e.g., 'activity', 'identity') as wildcard to receive all events in that domain.
+ */
+
+/**
+ * Register a callback for any event type across all domains.
+ * - 'activity' / 'identity' / 'messaging' — domain wildcard, receives all events in that domain
+ * - 'identity:login' / 'messaging:postback' / 'activity:product_view' — specific event
+ * - 'messaging:postback:add_to_cart' — specific event with sub-filter
+ */
+declare const useEvent: (eventType: EventType, handler: (payload: unknown) => void) => void;
 
 interface SurfaceProps {
     /** The extension point target ID (e.g., "slot.header") */
@@ -538,4 +570,4 @@ type UseContextDataResult = ContextData & {
 };
 declare const useContextData: () => UseContextDataResult;
 
-export { type Store, Surface, createExtension, createStore, ui, useCapabilities, useContextData, useExtendIdentity, useExtension, useIdentityEvent, useMessagingEvent, useStore, useSurfaceContext };
+export { type Store, Surface, createExtension, createStore, ui, useActivityEvent, useCapabilities, useContextData, useEvent, useExtendIdentity, useExtension, useIdentityEvent, useMessagingEvent, useStore, useSurfaceContext };

package/dist/index.js

@@ -231,10 +231,13 @@ var useExtension = () => {
 var useIdentityEvent = (eventType, handler) => {
   useEffect(() => {
     const unsubscribe = onExtensionEvent((type, payload) => {
-      if (type !== eventType) {
+      if (type !== "identity") {
         return;
       }
-      handler(payload);
+      const event = payload;
+      if (eventType === "*" || event.eventName === eventType) {
+        handler(event);
+      }
     });
     return unsubscribe;
   }, [eventType, handler]);
@@ -248,15 +251,53 @@ var useExtendIdentity = (handler) => {
 var useMessagingEvent = (eventType, handler) => {
   useEffect(() => {
     const unsubscribe = onExtensionEvent((type, payload) => {
-      if (type !== "messaging:postback") return;
+      if (type !== "messaging") {
+        return;
+      }
       const event = payload;
-      if (eventType === "postback" || eventType === `postback:${event.actionName}`) {
+      if (eventType === "*" || event.eventName === eventType || `${event.eventName}:${event.data.actionName}` === eventType) {
         handler(event);
       }
     });
     return unsubscribe;
   }, [eventType, handler]);
 };
+var useActivityEvent = (eventType, handler) => {
+  useEffect(() => {
+    const unsubscribe = onExtensionEvent((type, payload) => {
+      if (type !== "activity") {
+        return;
+      }
+      const event = payload;
+      if (eventType === "*" || event.eventName === eventType) {
+        handler(event);
+      }
+    });
+    return unsubscribe;
+  }, [eventType, handler]);
+};
+var useEvent = (eventType, handler) => {
+  useEffect(() => {
+    const [domain, ...rest] = eventType.split(":");
+    const targetEventName = rest.join(":");
+    const unsubscribe = onExtensionEvent((type, payload) => {
+      if (type !== domain) {
+        return;
+      }
+      if (targetEventName) {
+        const event = payload;
+        if (event.eventName === targetEventName) ; else if (targetEventName.startsWith(`${event.eventName}:`)) {
+          const subFilter = targetEventName.slice(event.eventName.length + 1);
+          if (event.data?.actionName !== subFilter) return;
+        } else {
+          return;
+        }
+      }
+      handler(payload);
+    });
+    return unsubscribe;
+  }, [eventType, handler]);
+};
 var useExtensionId = () => {
   const ctx = React2.useContext(ExtensionContext);
   return ctx?.extensionId ?? "unknown";
@@ -506,4 +547,4 @@ var useContextData = () => {
   return { ...contextData, loading };
 };
 
-export { Surface, createExtension, createStore, ui_exports as ui, useCapabilities, useContextData, useExtendIdentity, useExtension, useIdentityEvent, useMessagingEvent, useStore, useSurfaceContext };
+export { Surface, createExtension, createStore, ui_exports as ui, useActivityEvent, useCapabilities, useContextData, useEvent, useExtendIdentity, useExtension, useIdentityEvent, useMessagingEvent, useStore, useSurfaceContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackable-labs/sdk-extension-react",
-  "version": "1.70.0",
+  "version": "1.71.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.70.0"
+    "@stackable-labs/sdk-extension-contracts": "1.71.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0 <19.0.0",