@cross-deck/web 1.1.0 → 1.2.0

package/dist/react.d.mts

@@ -1,3 +1,6 @@
+import { ReactNode } from 'react';
+import { C as CrossdeckOptions } from './types-BzoKor4z.mjs';
+
 /**
  * @cross-deck/web/react — React hooks for the Crossdeck SDK.
  *
@@ -27,6 +30,26 @@
  * ships). Android => Compose `State<Boolean>` wrapper (when Android
  * SDK ships).
  */
+
+interface CrossdeckProviderProps extends Omit<CrossdeckOptions, "userId"> {
+    /**
+     * Optional. When defined, the provider calls Crossdeck.identify(userId)
+     * after init and on every change. When the prop flips back to undefined
+     * (logout), the provider calls Crossdeck.reset().
+     *
+     * Pass your auth library's stable user id directly:
+     *   <CrossdeckProvider userId={session?.user?.id} … />          // NextAuth
+     *   <CrossdeckProvider userId={user?.uid} … />                  // Firebase
+     *   <CrossdeckProvider userId={supabase.auth.user()?.id} … />   // Supabase
+     *
+     * Anonymous (pre-login) traffic stays anonymous until userId becomes
+     * defined — the SDK's anonymousId follows the same user record once
+     * identify lands, so attribution survives sign-up.
+     */
+    userId?: string | null | undefined;
+    children: ReactNode;
+}
+declare function CrossdeckProvider(props: CrossdeckProviderProps): ReactNode;
 /**
  * Subscribe a React component to a single entitlement key.
  *
@@ -65,4 +88,4 @@ declare function useEntitlement(key: string): boolean;
  */
 declare function useEntitlements(): readonly string[];
 
-export { useEntitlement, useEntitlements };
+export { CrossdeckProvider, useEntitlement, useEntitlements };

package/dist/react.d.ts

@@ -1,3 +1,6 @@
+import { ReactNode } from 'react';
+import { C as CrossdeckOptions } from './types-BzoKor4z.js';
+
 /**
  * @cross-deck/web/react — React hooks for the Crossdeck SDK.
  *
@@ -27,6 +30,26 @@
  * ships). Android => Compose `State<Boolean>` wrapper (when Android
  * SDK ships).
  */
+
+interface CrossdeckProviderProps extends Omit<CrossdeckOptions, "userId"> {
+    /**
+     * Optional. When defined, the provider calls Crossdeck.identify(userId)
+     * after init and on every change. When the prop flips back to undefined
+     * (logout), the provider calls Crossdeck.reset().
+     *
+     * Pass your auth library's stable user id directly:
+     *   <CrossdeckProvider userId={session?.user?.id} … />          // NextAuth
+     *   <CrossdeckProvider userId={user?.uid} … />                  // Firebase
+     *   <CrossdeckProvider userId={supabase.auth.user()?.id} … />   // Supabase
+     *
+     * Anonymous (pre-login) traffic stays anonymous until userId becomes
+     * defined — the SDK's anonymousId follows the same user record once
+     * identify lands, so attribution survives sign-up.
+     */
+    userId?: string | null | undefined;
+    children: ReactNode;
+}
+declare function CrossdeckProvider(props: CrossdeckProviderProps): ReactNode;
 /**
  * Subscribe a React component to a single entitlement key.
  *
@@ -65,4 +88,4 @@ declare function useEntitlement(key: string): boolean;
  */
 declare function useEntitlements(): readonly string[];
 
-export { useEntitlement, useEntitlements };
+export { CrossdeckProvider, useEntitlement, useEntitlements };

package/dist/react.mjs

@@ -1,5 +1,5 @@
 // src/react.ts
-import { useEffect, useState } from "react";
+import { useEffect, useRef, useState } from "react";
 
 // src/errors.ts
 var CrossdeckError = class _CrossdeckError extends Error {
@@ -3565,6 +3565,39 @@ function installUnloadFlush(onUnload) {
 }
 
 // src/react.ts
+var _moduleInitDone = false;
+function CrossdeckProvider(props) {
+  const { userId, children, ...initOptions } = props;
+  const lastUserIdRef = useRef(void 0);
+  useEffect(() => {
+    if (_moduleInitDone) return;
+    try {
+      Crossdeck.init(initOptions);
+      _moduleInitDone = true;
+    } catch (err) {
+      if (typeof console !== "undefined") {
+        console.error("[CrossdeckProvider] init failed:", err);
+      }
+    }
+  }, []);
+  useEffect(() => {
+    if (!_moduleInitDone) return;
+    if (lastUserIdRef.current === userId) return;
+    lastUserIdRef.current = userId;
+    try {
+      if (userId) {
+        void Crossdeck.identify(userId);
+      } else {
+        Crossdeck.reset();
+      }
+    } catch (err) {
+      if (typeof console !== "undefined") {
+        console.error("[CrossdeckProvider] identity sync failed:", err);
+      }
+    }
+  }, [userId]);
+  return children;
+}
 function useEntitlement(key) {
   const [isEntitled, setIsEntitled] = useState(() => safeIsEntitled(key));
   useEffect(() => {
@@ -3614,6 +3647,7 @@ function safeListKeys() {
   }
 }
 export {
+  CrossdeckProvider,
   useEntitlement,
   useEntitlements
 };