@account-kit/privy-integration 4.73.1-alpha.2 → 4.73.1-alpha.3

package/dist/esm/Provider.native.d.ts

@@ -0,0 +1,6 @@
+/**
+ * React Native stub for web Provider
+ * This file prevents Metro from importing web-specific code
+ */
+export declare function AlchemyProvider(): void;
+export declare function useAlchemyConfig(): void;

package/dist/esm/Provider.native.js

@@ -0,0 +1,13 @@
+/**
+ * React Native stub for web Provider
+ * This file prevents Metro from importing web-specific code
+ */
+export function AlchemyProvider() {
+    throw new Error("Web Provider is not available in React Native. " +
+        'Import from "@account-kit/privy-integration/react-native" instead.');
+}
+export function useAlchemyConfig() {
+    throw new Error("useAlchemyConfig from web Provider is not available in React Native. " +
+        'Import from "@account-kit/privy-integration/react-native" instead.');
+}
+//# sourceMappingURL=Provider.native.js.map

package/dist/esm/Provider.native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.native.js","sourceRoot":"","sources":["../../src/Provider.native.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,KAAK,CACb,iDAAiD;QAC/C,oEAAoE,CACvE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,KAAK,CACb,uEAAuE;QACrE,oEAAoE,CACvE,CAAC;AACJ,CAAC","sourcesContent":["/**\n * React Native stub for web Provider\n * This file prevents Metro from importing web-specific code\n */\n\nexport function AlchemyProvider() {\n  throw new Error(\n    \"Web Provider is not available in React Native. \" +\n      'Import from \"@account-kit/privy-integration/react-native\" instead.',\n  );\n}\n\nexport function useAlchemyConfig() {\n  throw new Error(\n    \"useAlchemyConfig from web Provider is not available in React Native. \" +\n      'Import from \"@account-kit/privy-integration/react-native\" instead.',\n  );\n}\n"]}

package/dist/esm/adapters/web.native.d.ts

@@ -0,0 +1,5 @@
+/**
+ * React Native stub for web adapter
+ * This file prevents Metro from importing @privy-io/react-auth
+ */
+export declare const webAdapter: null;

package/dist/esm/adapters/web.native.js

@@ -0,0 +1,6 @@
+/**
+ * React Native stub for web adapter
+ * This file prevents Metro from importing @privy-io/react-auth
+ */
+export const webAdapter = null;
+//# sourceMappingURL=web.native.js.map

package/dist/esm/adapters/web.native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.native.js","sourceRoot":"","sources":["../../../src/adapters/web.native.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC","sourcesContent":["/**\n * React Native stub for web adapter\n * This file prevents Metro from importing @privy-io/react-auth\n */\n\nexport const webAdapter = null;\n"]}

package/dist/esm/providers/WebProvider.native.d.ts

@@ -0,0 +1,5 @@
+/**
+ * React Native stub for WebProvider
+ * This file prevents Metro from importing web-specific code
+ */
+export declare function AlchemyProvider(): void;

package/dist/esm/providers/WebProvider.native.js

@@ -0,0 +1,9 @@
+/**
+ * React Native stub for WebProvider
+ * This file prevents Metro from importing web-specific code
+ */
+export function AlchemyProvider() {
+    throw new Error("WebProvider is not available in React Native. " +
+        'Import from "@account-kit/privy-integration/react-native" instead.');
+}
+//# sourceMappingURL=WebProvider.native.js.map

package/dist/esm/providers/WebProvider.native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebProvider.native.js","sourceRoot":"","sources":["../../../src/providers/WebProvider.native.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,KAAK,CACb,gDAAgD;QAC9C,oEAAoE,CACvE,CAAC;AACJ,CAAC","sourcesContent":["/**\n * React Native stub for WebProvider\n * This file prevents Metro from importing web-specific code\n */\n\nexport function AlchemyProvider() {\n  throw new Error(\n    \"WebProvider is not available in React Native. \" +\n      'Import from \"@account-kit/privy-integration/react-native\" instead.',\n  );\n}\n"]}

package/dist/esm/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "4.73.1-alpha.2";
+export declare const VERSION = "4.73.1-alpha.3";

package/dist/esm/version.js

@@ -1,4 +1,4 @@
 // This file is autogenerated by inject-version.ts. Any changes will be
 // overwritten on commit!
-export const VERSION = "4.73.1-alpha.2";
+export const VERSION = "4.73.1-alpha.3";
 //# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yBAAyB;AACzB,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAC","sourcesContent":["// This file is autogenerated by inject-version.ts. Any changes will be\n// overwritten on commit!\nexport const VERSION = \"4.73.1-alpha.2\";\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yBAAyB;AACzB,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAC","sourcesContent":["// This file is autogenerated by inject-version.ts. Any changes will be\n// overwritten on commit!\nexport const VERSION = \"4.73.1-alpha.3\";\n"]}

package/dist/types/Provider.native.d.ts

@@ -0,0 +1,7 @@
+/**
+ * React Native stub for web Provider
+ * This file prevents Metro from importing web-specific code
+ */
+export declare function AlchemyProvider(): void;
+export declare function useAlchemyConfig(): void;
+//# sourceMappingURL=Provider.native.d.ts.map

package/dist/types/Provider.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.native.d.ts","sourceRoot":"","sources":["../../src/Provider.native.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,eAAe,SAK9B;AAED,wBAAgB,gBAAgB,SAK/B"}

package/dist/types/adapters/web.native.d.ts

@@ -0,0 +1,6 @@
+/**
+ * React Native stub for web adapter
+ * This file prevents Metro from importing @privy-io/react-auth
+ */
+export declare const webAdapter: null;
+//# sourceMappingURL=web.native.d.ts.map

package/dist/types/adapters/web.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.native.d.ts","sourceRoot":"","sources":["../../../src/adapters/web.native.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,UAAU,MAAO,CAAC"}

package/dist/types/providers/WebProvider.native.d.ts

@@ -0,0 +1,6 @@
+/**
+ * React Native stub for WebProvider
+ * This file prevents Metro from importing web-specific code
+ */
+export declare function AlchemyProvider(): void;
+//# sourceMappingURL=WebProvider.native.d.ts.map

package/dist/types/providers/WebProvider.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebProvider.native.d.ts","sourceRoot":"","sources":["../../../src/providers/WebProvider.native.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,eAAe,SAK9B"}

package/dist/types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "4.73.1-alpha.2";
+export declare const VERSION = "4.73.1-alpha.3";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@account-kit/privy-integration",
-  "version": "4.73.1-alpha.2",
+  "version": "4.73.1-alpha.3",
   "description": "Use Alchemy gas sponsorship, swaps and more with Privy",
   "author": "Alchemy",
   "license": "MIT",
@@ -10,11 +10,19 @@
   "module": "./dist/esm/index.js",
   "types": "./dist/types/index.d.ts",
   "typings": "./dist/types/index.d.ts",
-  "react-native": "./dist/esm/react-native.js",
   "sideEffects": false,
+  "react-native": {
+    "main": "./dist/esm/react-native.js",
+    "./dist/esm/adapters/web.js": "./dist/esm/adapters/web.native.js",
+    "./dist/esm/providers/WebProvider.js": "./dist/esm/providers/WebProvider.native.js",
+    "./dist/esm/Provider.js": "./dist/esm/Provider.native.js",
+    "@privy-io/react-auth": false,
+    "@privy-io/react-auth/solana": false
+  },
   "files": [
     "dist",
     "src/**/*.ts",
+    "src/**/*.tsx",
     "!dist/**/*.tsbuildinfo",
     "!vitest.config.ts",
     "!.env",
@@ -56,8 +64,8 @@
     "typescript-template": "*"
   },
   "dependencies": {
-    "@account-kit/infra": "^4.73.1-alpha.2",
-    "@account-kit/wallet-client": "^4.73.1-alpha.2"
+    "@account-kit/infra": "^4.73.1-alpha.3",
+    "@account-kit/wallet-client": "^4.73.1-alpha.3"
   },
   "peerDependencies": {
     "@privy-io/expo": "^0.58.0",
@@ -87,5 +95,5 @@
     "url": "https://github.com/alchemyplatform/aa-sdk/issues"
   },
   "homepage": "https://github.com/alchemyplatform/aa-sdk#readme",
-  "gitHead": "a453772c21ab2fab5ff0093b4168eb8e3fe73b89"
+  "gitHead": "441fb5248356d672e1f868829bb818009f878f5c"
 }

package/src/Provider.native.tsx

@@ -0,0 +1,18 @@
+/**
+ * React Native stub for web Provider
+ * This file prevents Metro from importing web-specific code
+ */
+
+export function AlchemyProvider() {
+  throw new Error(
+    "Web Provider is not available in React Native. " +
+      'Import from "@account-kit/privy-integration/react-native" instead.',
+  );
+}
+
+export function useAlchemyConfig() {
+  throw new Error(
+    "useAlchemyConfig from web Provider is not available in React Native. " +
+      'Import from "@account-kit/privy-integration/react-native" instead.',
+  );
+}

package/src/Provider.tsx

@@ -0,0 +1,6 @@
+/**
+ * Web-specific exports
+ * Re-exports the web provider and hooks for React applications
+ */
+export { AlchemyProvider } from "./providers/WebProvider.js";
+export { useAlchemyConfig } from "./context/AlchemyContext.js";

package/src/adapters/web.native.ts

@@ -0,0 +1,6 @@
+/**
+ * React Native stub for web adapter
+ * This file prevents Metro from importing @privy-io/react-auth
+ */
+
+export const webAdapter = null;

package/src/context/AlchemyContext.tsx

@@ -0,0 +1,162 @@
+import {
+  type PropsWithChildren,
+  createContext,
+  useContext,
+  useRef,
+  useEffect,
+} from "react";
+import type { SmartWalletClient } from "@account-kit/wallet-client";
+import type { AlchemyProviderConfig } from "../types.js";
+import type { PrivyAdapter } from "../adapters/types.js";
+
+/**
+ * Context for Alchemy configuration
+ */
+const AlchemyConfigContext = createContext<AlchemyProviderConfig | null>(null);
+
+/**
+ * Context for the platform adapter
+ */
+const AdapterContext = createContext<PrivyAdapter | null>(null);
+
+/**
+ * Client cache stored in React tree (similar to QueryClient in React Query)
+ *
+ * @internal
+ */
+interface ClientCache {
+  client: SmartWalletClient | null;
+  cacheKey: string | null;
+}
+
+const ClientCacheContext = createContext<ClientCache | null>(null);
+
+/**
+ * Props for AlchemyContextProvider
+ */
+interface AlchemyContextProviderProps extends PropsWithChildren {
+  config: AlchemyProviderConfig;
+  adapter: PrivyAdapter;
+}
+
+/**
+ * Internal provider component that manages Alchemy context
+ * Used by both web and React Native providers
+ *
+ * @internal
+ * @param {AlchemyContextProviderProps} props - Component props
+ * @param {React.ReactNode} props.children - React children to wrap with context
+ * @param {AlchemyProviderConfig} props.config - Alchemy configuration
+ * @param {PrivyAdapter} props.adapter - Platform adapter
+ * @returns {JSX.Element} Context provider component
+ */
+export function AlchemyContextProvider({
+  children,
+  config,
+  adapter,
+}: AlchemyContextProviderProps) {
+  const { authenticated, user } = adapter.usePrivyAuth();
+
+  // Store cache in a ref - persists across renders but scoped to this component instance
+  // This makes it SSR-safe (each request gets its own cache) and React StrictMode-safe
+  const cache = useRef<ClientCache>({
+    client: null,
+    cacheKey: null,
+  });
+
+  // Track previous state to detect logout and wallet changes
+  const prevAuthenticatedRef = useRef(authenticated);
+  const prevWalletAddressRef = useRef(user?.wallet?.address);
+
+  // Automatically reset cache when user logs out or switches wallets
+  useEffect(() => {
+    const wasAuthenticated = prevAuthenticatedRef.current;
+    const prevWalletAddress = prevWalletAddressRef.current;
+    const currentWalletAddress = user?.wallet?.address;
+
+    // Reset cache on logout
+    if (wasAuthenticated && !authenticated) {
+      cache.current.client = null;
+      cache.current.cacheKey = null;
+    }
+
+    // Reset cache on wallet address change (account switching)
+    if (
+      authenticated &&
+      prevWalletAddress &&
+      currentWalletAddress &&
+      prevWalletAddress !== currentWalletAddress
+    ) {
+      cache.current.client = null;
+      cache.current.cacheKey = null;
+    }
+
+    // Update refs for next render
+    prevAuthenticatedRef.current = authenticated;
+    prevWalletAddressRef.current = currentWalletAddress;
+  }, [authenticated, user?.wallet?.address]);
+
+  return (
+    <AlchemyConfigContext.Provider value={config}>
+      <AdapterContext.Provider value={adapter}>
+        <ClientCacheContext.Provider value={cache.current}>
+          {children}
+        </ClientCacheContext.Provider>
+      </AdapterContext.Provider>
+    </AlchemyConfigContext.Provider>
+  );
+}
+
+/**
+ * Hook to access Alchemy provider configuration
+ * Must be used within an <AlchemyProvider> component
+ *
+ * @returns {AlchemyProviderConfig} The current Alchemy configuration
+ * @throws {Error} If used outside of AlchemyProvider
+ *
+ * @example
+ * ```tsx
+ * const config = useAlchemyConfig();
+ * console.log('Policy ID:', config.policyId);
+ * ```
+ */
+export function useAlchemyConfig(): AlchemyProviderConfig {
+  const context = useContext(AlchemyConfigContext);
+  if (!context) {
+    throw new Error("useAlchemyConfig must be used within <AlchemyProvider />");
+  }
+  return context;
+}
+
+/**
+ * Hook to access the platform adapter
+ * Must be used within an <AlchemyProvider> component
+ *
+ * @internal
+ * @returns {PrivyAdapter} The platform adapter
+ */
+export function useAdapter(): PrivyAdapter {
+  const context = useContext(AdapterContext);
+  if (!context) {
+    throw new Error(
+      "useAdapter must be used within <AlchemyProvider />. Make sure AlchemyProvider is nested inside PrivyProvider.",
+    );
+  }
+  return context;
+}
+
+/**
+ * Hook to access the client cache (internal use only)
+ *
+ * @internal
+ * @returns {ClientCache} The client cache object
+ */
+export function useClientCache(): ClientCache {
+  const context = useContext(ClientCacheContext);
+  if (!context) {
+    throw new Error(
+      "useClientCache must be used within <AlchemyProvider />. Make sure AlchemyProvider is nested inside PrivyProvider.",
+    );
+  }
+  return context;
+}

package/src/providers/ReactNativeProvider.tsx

@@ -0,0 +1,45 @@
+import type { PropsWithChildren } from "react";
+import { AlchemyContextProvider } from "../context/AlchemyContext.js";
+import { reactNativeAdapter } from "../adapters/react-native.js";
+import type { AlchemyProviderConfig } from "../types.js";
+
+/**
+ * Provider component for React Native (Expo) applications
+ * Must be nested INSIDE PrivyProvider from @privy-io/expo
+ *
+ * @param {PropsWithChildren<AlchemyProviderConfig>} props - Component props
+ * @param {React.ReactNode} props.children - React children to wrap with Alchemy configuration
+ * @param {string} [props.apiKey] - Your Alchemy API key
+ * @param {string} [props.jwt] - JWT token for authentication
+ * @param {string} [props.rpcUrl] - Custom RPC URL for EVM chains
+ * @param {string} [props.solanaRpcUrl] - Custom RPC URL for Solana
+ * @param {string | string[]} [props.policyId] - Gas Manager policy ID(s) for EVM chains
+ * @param {string | string[]} [props.solanaPolicyId] - Gas Manager policy ID(s) for Solana
+ * @param {boolean} [props.disableSponsorship] - Set to true to disable sponsorship by default (default: false)
+ * @returns {JSX.Element} Provider component
+ *
+ * @example
+ * ```tsx
+ * import { PrivyProvider } from '@privy-io/expo';
+ * import { AlchemyProvider } from '@account-kit/privy-integration/react-native';
+ *
+ * <PrivyProvider appId="..." clientId="...">
+ *   <AlchemyProvider
+ *     apiKey="your-alchemy-api-key"
+ *     policyId="your-gas-policy-id"
+ *   >
+ *     <YourApp />
+ *   </AlchemyProvider>
+ * </PrivyProvider>
+ * ```
+ */
+export function AlchemyProvider({
+  children,
+  ...config
+}: PropsWithChildren<AlchemyProviderConfig>) {
+  return (
+    <AlchemyContextProvider config={config} adapter={reactNativeAdapter}>
+      {children}
+    </AlchemyContextProvider>
+  );
+}

package/src/providers/WebProvider.native.tsx

@@ -0,0 +1,11 @@
+/**
+ * React Native stub for WebProvider
+ * This file prevents Metro from importing web-specific code
+ */
+
+export function AlchemyProvider() {
+  throw new Error(
+    "WebProvider is not available in React Native. " +
+      'Import from "@account-kit/privy-integration/react-native" instead.',
+  );
+}

package/src/providers/WebProvider.tsx

@@ -0,0 +1,45 @@
+import type { PropsWithChildren } from "react";
+import { AlchemyContextProvider } from "../context/AlchemyContext.js";
+import { webAdapter } from "../adapters/web.js";
+import type { AlchemyProviderConfig } from "../types.js";
+
+/**
+ * Provider component for React web applications
+ * Must be nested INSIDE PrivyProvider from @privy-io/react-auth
+ *
+ * @param {PropsWithChildren<AlchemyProviderConfig>} props - Component props
+ * @param {React.ReactNode} props.children - React children to wrap with Alchemy configuration
+ * @param {string} [props.apiKey] - Your Alchemy API key
+ * @param {string} [props.jwt] - JWT token for authentication
+ * @param {string} [props.rpcUrl] - Custom RPC URL for EVM chains
+ * @param {string} [props.solanaRpcUrl] - Custom RPC URL for Solana
+ * @param {string | string[]} [props.policyId] - Gas Manager policy ID(s) for EVM chains
+ * @param {string | string[]} [props.solanaPolicyId] - Gas Manager policy ID(s) for Solana
+ * @param {boolean} [props.disableSponsorship] - Set to true to disable sponsorship by default (default: false)
+ * @returns {JSX.Element} Provider component
+ *
+ * @example
+ * ```tsx
+ * import { PrivyProvider } from '@privy-io/react-auth';
+ * import { AlchemyProvider } from '@account-kit/privy-integration';
+ *
+ * <PrivyProvider appId="...">
+ *   <AlchemyProvider
+ *     apiKey="your-alchemy-api-key"
+ *     policyId="your-gas-policy-id"
+ *   >
+ *     <YourApp />
+ *   </AlchemyProvider>
+ * </PrivyProvider>
+ * ```
+ */
+export function AlchemyProvider({
+  children,
+  ...config
+}: PropsWithChildren<AlchemyProviderConfig>) {
+  return (
+    <AlchemyContextProvider config={config} adapter={webAdapter}>
+      {children}
+    </AlchemyContextProvider>
+  );
+}

package/src/version.ts

@@ -1,3 +1,3 @@
 // This file is autogenerated by inject-version.ts. Any changes will be
 // overwritten on commit!
-export const VERSION = "4.73.1-alpha.2";
+export const VERSION = "4.73.1-alpha.3";