feat: add loggingConsent property to CrossmintConfig

packages/client/react-base/src/logger/init.ts

@@ -6,9 +6,15 @@ import * as datadogLogger from "@datadog/browser-logs";
  * Should be called once when the SDK is initialized (typically in CrossmintProvider)
  * This handles browser-specific Datadog sink initialization
  * @param apiKey - API key to determine environment (development/staging/production) and project ID
+ * @param loggingConsent - Whether the user has consented to logging. If false, the logger will not be initialized with Datadog sinks.
  * @returns The initialized logger instance
  */
-export function initReactLogger(apiKey: string, packageName: string, packageVersion: string): SdkLogger {
+export function initReactLogger(
+    apiKey: string,
+    packageName: string,
+    packageVersion: string,
+    loggingConsent?: boolean
+): SdkLogger {
     const validationResult = validateAPIKey(apiKey);
     if (!validationResult.isValid) {
         throw new Error(`Invalid API key: ${validationResult.message}`);
@@ -21,13 +27,15 @@ export function initReactLogger(apiKey: string, packageName: string, packageVers
         projectId,
     });
 
-    const platform = detectPlatform();
-    if (platform === "browser") {
-        const sink = new BrowserDatadogSink(environment, datadogLogger);
-        logger.addSink(sink);
-    } else if (platform === "server") {
-        const sink = new ServerDatadogSink(environment);
-        logger.addSink(sink);
+    if (loggingConsent === true) {
+        const platform = detectPlatform();
+        if (platform === "browser") {
+            const sink = new BrowserDatadogSink(environment, datadogLogger);
+            logger.addSink(sink);
+        } else if (platform === "server") {
+            const sink = new ServerDatadogSink(environment);
+            logger.addSink(sink);
+        }
     }
 
     return logger;

packages/client/react-base/src/providers/CrossmintProvider.tsx

@@ -23,12 +23,13 @@ export function CrossmintProvider({
     appId,
     extensionId,
     overrideBaseUrl,
+    loggingConsent,
 }: CrossmintConfig & {
     children: ReactNode;
 }) {
     const logger = useMemo(() => {
-        return initReactLogger(apiKey, packageJson.name, packageJson.version);
-    }, [apiKey]);
+        return initReactLogger(apiKey, packageJson.name, packageJson.version, loggingConsent);
+    }, [apiKey, loggingConsent]);
 
     const [version, setVersion] = useState(0);
     const crossmintRef = useRef<Crossmint | null>(null);

packages/client/ui/react-native/src/logger/init.ts

@@ -46,9 +46,10 @@ export async function initializeDatadog(options: InitializeDatadogOptions): Prom
  * Should be called once when the SDK is initialized (typically in CrossmintProvider)
  * This handles React Native-specific Datadog sink initialization
  * @param apiKey - API key to determine environment (development/staging/production) and project ID
+ * @param loggingConsent - Whether the user has consented to logging. If false, the logger will not be initialized with Datadog sinks.
  * @returns The initialized logger instance
  */
-export function initReactNativeLogger(apiKey: string): SdkLogger {
+export function initReactNativeLogger(apiKey: string, loggingConsent?: boolean): SdkLogger {
     const validationResult = validateAPIKey(apiKey);
     if (!validationResult.isValid) {
         throw new Error(`Invalid API key: ${validationResult.message}`);
@@ -62,17 +63,19 @@ export function initReactNativeLogger(apiKey: string): SdkLogger {
         platform: "react-native",
     });
 
-    const isExpoGo =
-        Constants.executionEnvironment === "storeClient" ||
-        Constants.appOwnership === "expo" ||
-        !!Constants.expoVersion;
+    if (loggingConsent === true) {
+        const isExpoGo =
+            Constants.executionEnvironment === "storeClient" ||
+            Constants.appOwnership === "expo" ||
+            !!Constants.expoVersion;
 
-    initializeDatadog({
-        environment,
-        isExpoGo,
-    });
-    const sink = new ReactNativeDatadogSink(environment, datadogReactNativeModule);
-    logger.addSink(sink);
+        initializeDatadog({
+            environment,
+            isExpoGo,
+        });
+        const sink = new ReactNativeDatadogSink(environment, datadogReactNativeModule);
+        logger.addSink(sink);
+    }
 
     return logger;
 }

packages/client/ui/react-native/src/providers/CrossmintProvider.tsx

@@ -11,12 +11,13 @@ export function CrossmintProvider({
     children,
     apiKey,
     overrideBaseUrl,
-}: Pick<CrossmintConfig, "apiKey" | "overrideBaseUrl"> & {
+    loggingConsent,
+}: Pick<CrossmintConfig, "apiKey" | "overrideBaseUrl" | "loggingConsent"> & {
     children: ReactNode;
 }) {
     const logger = useMemo(() => {
-        return initReactNativeLogger(apiKey);
-    }, [apiKey]);
+        return initReactNativeLogger(apiKey, loggingConsent);
+    }, [apiKey, loggingConsent]);
 
     // Get app ID from Expo constants
     const appId = Constants.expoConfig?.ios?.bundleIdentifier ?? Constants.expoConfig?.android?.package;

packages/client/ui/react-ui/src/providers/CrossmintProvider.tsx

@@ -9,13 +9,13 @@ import { useMemo, type ReactNode } from "react";
 
 export const LoggerContext = createLoggerContext();
 
-export function CrossmintProvider({ apiKey, ...props }: CrossmintConfig & { children: ReactNode }) {
+export function CrossmintProvider({ apiKey, loggingConsent, ...props }: CrossmintConfig & { children: ReactNode }) {
     const logger = useMemo(() => {
-        return initReactLogger(apiKey, packageJson.name, packageJson.version);
-    }, [apiKey]);
+        return initReactLogger(apiKey, packageJson.name, packageJson.version, loggingConsent);
+    }, [apiKey, loggingConsent]);
     return (
         <LoggerContext.Provider value={logger}>
-            <BaseCrossmintProvider apiKey={apiKey} {...props} />
+            <BaseCrossmintProvider apiKey={apiKey} loggingConsent={loggingConsent} {...props} />
         </LoggerContext.Provider>
     );
 }

packages/common/base/src/types/Crossmint.ts

@@ -22,6 +22,7 @@ export type CrossmintConfig = {
     appId?: string;
     extensionId?: string;
     experimental_customAuth?: CustomAuth;
+    loggingConsent?: boolean;
 };
 
 export type Crossmint = CrossmintConfig & {
@@ -33,7 +34,7 @@ export function createCrossmint(
     config: CrossmintConfig,
     apiKeyExpectations?: ValidateAPIKeyPrefixExpectations
 ): Crossmint {
-    const { apiKey, jwt, overrideBaseUrl, appId, extensionId, experimental_customAuth } = config;
+    const { apiKey, jwt, overrideBaseUrl, appId, extensionId, experimental_customAuth, loggingConsent } = config;
     const apiKeyValidationResult = validateAPIKey(apiKey, apiKeyExpectations);
     if (!apiKeyValidationResult.isValid) {
         throw new Error(apiKeyValidationResult.message);
@@ -54,6 +55,7 @@ export function createCrossmint(
         appId,
         extensionId,
         experimental_customAuth,
+        loggingConsent,
         experimental_setCustomAuth,
         setJwt,
     };

packages/wallets/src/logger/init.ts

@@ -18,8 +18,9 @@ export const walletsLogger = new SdkLogger();
  * Should be called once when the SDK is initialized
  * Automatically detects the platform and environment from API key
  * @param apiKey - Optional API key to determine environment (development/staging/production)
+ * @param loggingConsent - Whether the user has consented to logging. If false, the logger will not be initialized with Datadog sinks.
  */
-export function initWalletsLogger(apiKey: string): void {
+export function initWalletsLogger(apiKey: string, loggingConsent?: boolean): void {
     const platform = detectPlatform();
     const validationResult = validateAPIKey(apiKey);
     if (!validationResult.isValid) {
@@ -35,27 +36,29 @@ export function initWalletsLogger(apiKey: string): void {
         platform,
     });
 
-    // Add platform-specific Datadog sink
-    switch (platform) {
-        case "browser": {
-            const sink = new BrowserDatadogSink(environment, datadogLogger);
-            walletsLogger.addSink(sink);
-            break;
-        }
-        case "react-native": {
-            // React Native logger initialization is handled by @crossmint/client-sdk-react-native-ui
-            // This package only initializes for browser/server to avoid bundling React Native dependencies
-            // The React Native UI package will initialize the logger with the appropriate Datadog sink
-            break;
-        }
-        case "server": {
-            const sink = new ServerDatadogSink(environment);
-            walletsLogger.addSink(sink);
-            break;
-        }
-        default: {
-            // Unknown platform - only use console sink
-            break;
+    if (loggingConsent === true) {
+        // Add platform-specific Datadog sink
+        switch (platform) {
+            case "browser": {
+                const sink = new BrowserDatadogSink(environment, datadogLogger);
+                walletsLogger.addSink(sink);
+                break;
+            }
+            case "react-native": {
+                // React Native logger initialization is handled by @crossmint/client-sdk-react-native-ui
+                // This package only initializes for browser/server to avoid bundling React Native dependencies
+                // The React Native UI package will initialize the logger with the appropriate Datadog sink
+                break;
+            }
+            case "server": {
+                const sink = new ServerDatadogSink(environment);
+                walletsLogger.addSink(sink);
+                break;
+            }
+            default: {
+                // Unknown platform - only use console sink
+                break;
+            }
         }
     }
 }

packages/wallets/src/sdk.ts

@@ -10,7 +10,7 @@ export class CrossmintWallets {
     private readonly walletFactory: WalletFactory;
 
     private constructor(crossmint: Crossmint) {
-        initWalletsLogger(crossmint.apiKey);
+        initWalletsLogger(crossmint.apiKey, crossmint.loggingConsent);
         const apiClient = new ApiClient(crossmint);
         this.walletFactory = new WalletFactory(apiClient);