@stackable-labs/sdk-extension-react 1.44.0 → 1.45.0

package/dist/index.d.ts

@@ -97,6 +97,21 @@ declare const useExtension: () => ExtensionContextValue;
  */
 declare const useAuthEvent: (eventType: AuthEventType, handler: (event: AuthEvent) => void) => void;
 
+/**
+ * useIdentityExtend — 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.
+ * The handler returns additional claims to merge into the JWT before signing.
+ *
+ * @example
+ * useIdentityExtend((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;
+
 interface SurfaceProps {
     /** The extension point target ID (e.g., "slot.header") */
     id: string;
@@ -508,4 +523,4 @@ type UseContextDataResult = ContextData & {
 };
 declare const useContextData: () => UseContextDataResult;
 
-export { type Store, Surface, createExtension, createStore, ui, useAuthEvent, useCapabilities, useContextData, useExtension, useStore, useSurfaceContext };
+export { type Store, Surface, createExtension, createStore, ui, useAuthEvent, useCapabilities, useContextData, useExtension, useIdentityExtend, useStore, useSurfaceContext };

package/dist/index.js

@@ -20,6 +20,7 @@ var getWebCrypto = () => _webCrypto ??= new WebCrypto({ crypto: globalThis.crypt
 var requestCounter = 0;
 var registeredExtensionId = "unknown";
 var encryptionKey = null;
+var identityExtendHandler = null;
 var pendingRequests = /* @__PURE__ */ new Map();
 var extensionEventHandlers = /* @__PURE__ */ new Set();
 var onExtensionEvent = (handler) => {
@@ -28,6 +29,12 @@ var onExtensionEvent = (handler) => {
     extensionEventHandlers.delete(handler);
   };
 };
+var registerIdentityExtendHandler = (handler) => {
+  identityExtendHandler = handler;
+  return () => {
+    if (identityExtendHandler === handler) identityExtendHandler = null;
+  };
+};
 var generateRequestId = () => `req_${++requestCounter}_${Date.now()}`;
 var setEncryptionKey = async (keyBase64) => {
   encryptionKey = await getWebCrypto().importRawKey("secret", base64ToBytes(keyBase64), { extractable: false });
@@ -50,6 +57,18 @@ var initRpcListener = (extensionId) => {
       }
       return;
     }
+    if (msg?.type === "identity-extend-request") {
+      if (identityExtendHandler) {
+        const { id, claims } = msg;
+        Promise.resolve(identityExtendHandler(claims)).then((additionalClaims) => {
+          window.parent.postMessage({ type: "identity-extend-response", id, additionalClaims }, "*");
+        }).catch((e) => {
+          console.error("[rpc-client] identity-extend handler error:", e);
+          window.parent.postMessage({ type: "identity-extend-response", id, additionalClaims: {} }, "*");
+        });
+      }
+      return;
+    }
     if (msg?.type === "capability-response") {
       const response = msg;
       const pending = pendingRequests.get(response.id);
@@ -186,6 +205,12 @@ var useAuthEvent = (eventType, handler) => {
     return unsubscribe;
   }, [eventType, handler]);
 };
+var useIdentityExtend = (handler) => {
+  useEffect(() => {
+    const unregister = registerIdentityExtendHandler(handler);
+    return unregister;
+  }, [handler]);
+};
 var useExtensionId = () => {
   const ctx = React.useContext(ExtensionContext);
   return ctx?.extensionId ?? "unknown";
@@ -425,4 +450,4 @@ var useContextData = () => {
   return { ...contextData, loading };
 };
 
-export { Surface, createExtension, createStore, ui_exports as ui, useAuthEvent, useCapabilities, useContextData, useExtension, useStore, useSurfaceContext };
+export { Surface, createExtension, createStore, ui_exports as ui, useAuthEvent, useCapabilities, useContextData, useExtension, useIdentityExtend, useStore, useSurfaceContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackable-labs/sdk-extension-react",
-  "version": "1.44.0",
+  "version": "1.45.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.44.0"
+    "@stackable-labs/sdk-extension-contracts": "1.45.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0 <19.0.0",