insert-affiliate-react-native-sdk 1.14.0 → 1.15.0

package/dist/DeepLinkIapProvider.d.ts

@@ -29,8 +29,15 @@ type T_DEEPLINK_IAP_CONTEXT = {
     setInsertAffiliateIdentifierChangeCallback: (callback: InsertAffiliateIdentifierChangeCallback | null) => void;
     handleInsertLinks: (url: string) => Promise<boolean>;
     initialize: (code: string | null, verboseLogging?: boolean, insertLinksEnabled?: boolean, insertLinksClipboardEnabled?: boolean, affiliateAttributionActiveTime?: number, preventAffiliateTransfer?: boolean) => Promise<void>;
+    setLogger: (logger: InsertAffiliateLogger) => void;
     isInitialized: boolean;
 };
+export type InsertAffiliateLogger = {
+    debug: (message: string, ...args: any[]) => void;
+    info: (message: string, ...args: any[]) => void;
+    warn: (message: string, ...args: any[]) => void;
+    error: (message: string, ...args: any[]) => void;
+};
 export declare const DeepLinkIapContext: React.Context<T_DEEPLINK_IAP_CONTEXT>;
 declare const DeepLinkIapProvider: React.FC<T_DEEPLINK_IAP_PROVIDER>;
 export default DeepLinkIapProvider;

package/dist/DeepLinkIapProvider.js

@@ -58,6 +58,12 @@ const ASYNC_KEYS = {
     REPORTED_AFFILIATE_ASSOCIATIONS: '@app_reported_affiliate_associations',
     SYSTEM_INFO_SENT: '@app_system_info_sent',
 };
+const DEFAULT_LOGGER = {
+    debug: (message, ...args) => console.debug(`[Insert Affiliate] ${message}`, ...args),
+    info: (message, ...args) => console.log(`[Insert Affiliate] ${message}`, ...args),
+    warn: (message, ...args) => console.warn(`[Insert Affiliate] ${message}`, ...args),
+    error: (message, ...args) => console.error(`[Insert Affiliate] ${message}`, ...args),
+};
 // STARTING CONTEXT IMPLEMENTATION
 exports.DeepLinkIapContext = (0, react_1.createContext)({
     referrerLink: '',
@@ -77,6 +83,7 @@ exports.DeepLinkIapContext = (0, react_1.createContext)({
     setInsertAffiliateIdentifierChangeCallback: (callback) => { },
     handleInsertLinks: (url) => __awaiter(void 0, void 0, void 0, function* () { return false; }),
     initialize: (code, verboseLogging, insertLinksEnabled, insertLinksClipboardEnabled, affiliateAttributionActiveTime, preventAffiliateTransfer) => __awaiter(void 0, void 0, void 0, function* () { }),
+    setLogger: (logger) => { },
     isInitialized: false,
 });
 const DeepLinkIapProvider = ({ children, }) => {
@@ -92,6 +99,8 @@ const DeepLinkIapProvider = ({ children, }) => {
     const [preventAffiliateTransfer, setPreventAffiliateTransfer] = (0, react_1.useState)(false);
     const insertAffiliateIdentifierChangeCallbackRef = (0, react_1.useRef)(null);
     const isInitializingRef = (0, react_1.useRef)(false);
+    // Logger ref - defaults to console-based logging, can be swapped via setLogger()
+    const loggerRef = (0, react_1.useRef)(DEFAULT_LOGGER);
     // Refs for values that need to be current inside callbacks (to avoid stale closures)
     const companyCodeRef = (0, react_1.useRef)(null);
     const verboseLoggingRef = (0, react_1.useRef)(false);
@@ -127,28 +136,28 @@ const DeepLinkIapProvider = ({ children, }) => {
         setPreventAffiliateTransfer(preventAffiliateTransferParam);
         preventAffiliateTransferRef.current = preventAffiliateTransferParam;
         if (verboseLoggingParam) {
-            console.log('[Insert Affiliate] [VERBOSE] Starting SDK initialization...');
-            console.log('[Insert Affiliate] [VERBOSE] Company code provided:', companyCodeParam ? 'Yes' : 'No');
-            console.log('[Insert Affiliate] [VERBOSE] Verbose logging enabled');
+            loggerRef.current.debug('[VERBOSE] Starting SDK initialization...');
+            loggerRef.current.debug('[VERBOSE] Company code provided:', companyCodeParam ? 'Yes' : 'No');
+            loggerRef.current.debug('[VERBOSE] Verbose logging enabled');
         }
         if (companyCodeParam && companyCodeParam.trim() !== '') {
             setCompanyCode(companyCodeParam);
             companyCodeRef.current = companyCodeParam;
             yield saveValueInAsync(ASYNC_KEYS.COMPANY_CODE, companyCodeParam);
             setIsInitialized(true);
-            console.log(`[Insert Affiliate] SDK initialized with company code: ${companyCodeParam}`);
+            loggerRef.current.info(`SDK initialized with company code: ${companyCodeParam}`);
             if (verboseLoggingParam) {
-                console.log('[Insert Affiliate] [VERBOSE] Company code saved to AsyncStorage');
-                console.log('[Insert Affiliate] [VERBOSE] SDK marked as initialized');
+                loggerRef.current.debug('[VERBOSE] Company code saved to AsyncStorage');
+                loggerRef.current.debug('[VERBOSE] SDK marked as initialized');
             }
             // Report SDK initialization for onboarding verification (fire and forget)
             reportSdkInitIfNeeded(companyCodeParam, verboseLoggingParam);
         }
         else {
-            console.warn('[Insert Affiliate] SDK initialized without a company code.');
+            loggerRef.current.warn('SDK initialized without a company code.');
             setIsInitialized(true);
             if (verboseLoggingParam) {
-                console.log('[Insert Affiliate] [VERBOSE] No company code provided, SDK initialized in limited mode');
+                loggerRef.current.debug('[VERBOSE] No company code provided, SDK initialized in limited mode');
             }
         }
         if (insertLinksEnabledParam && react_native_1.Platform.OS === 'ios') {
@@ -241,7 +250,7 @@ const DeepLinkIapProvider = ({ children, }) => {
                 }
             }
             catch (error) {
-                console.error('[Insert Affiliate] Error getting initial URL:', error);
+                loggerRef.current.error('Error getting initial URL:', error);
             }
         });
         // Handle URL opening while app is running (equivalent to open url)
@@ -257,7 +266,7 @@ const DeepLinkIapProvider = ({ children, }) => {
                 }
             }
             catch (error) {
-                console.error('[Insert Affiliate] Error handling URL change:', error);
+                loggerRef.current.error('Error handling URL change:', error);
             }
         });
         // Platform-specific deep link handler
@@ -332,7 +341,7 @@ const DeepLinkIapProvider = ({ children, }) => {
     const reset = () => {
         setCompanyCode(null);
         setIsInitialized(false);
-        console.log('[Insert Affiliate] SDK has been reset.');
+        loggerRef.current.info('SDK has been reset.');
     };
     // MARK: Deep Link Handling
     // Helper function to parse URLs in React Native compatible way
@@ -521,14 +530,14 @@ const DeepLinkIapProvider = ({ children, }) => {
     // Handles Insert Links deep linking - equivalent to iOS handleInsertLinks
     const handleInsertLinksImpl = (url) => __awaiter(void 0, void 0, void 0, function* () {
         try {
-            console.log(`[Insert Affiliate] Attempting to handle URL: ${url}`);
+            loggerRef.current.info(`Attempting to handle URL: ${url}`);
             if (!url || typeof url !== 'string') {
-                console.log('[Insert Affiliate] Invalid URL provided to handleInsertLinks');
+                loggerRef.current.info('Invalid URL provided to handleInsertLinks');
                 return false;
             }
             // Check if deep links are enabled synchronously
             if (!insertLinksEnabled) {
-                console.log('[Insert Affiliate] Deep links are disabled, not handling URL');
+                loggerRef.current.info('Deep links are disabled, not handling URL');
                 return false;
             }
             const urlObj = parseURL(url);
@@ -543,7 +552,7 @@ const DeepLinkIapProvider = ({ children, }) => {
             return false;
         }
         catch (error) {
-            console.error('[Insert Affiliate] Error handling Insert Link:', error);
+            loggerRef.current.error('Error handling Insert Link:', error);
             verboseLog(`Error in handleInsertLinks: ${error}`);
             return false;
         }
@@ -559,14 +568,14 @@ const DeepLinkIapProvider = ({ children, }) => {
             const companyCode = scheme.substring(3);
             const shortCode = parseShortCodeFromURLString(url);
             if (!shortCode) {
-                console.log(`[Insert Affiliate] Failed to parse short code from deep link: ${url}`);
+                loggerRef.current.info(`Failed to parse short code from deep link: ${url}`);
                 return false;
             }
-            console.log(`[Insert Affiliate] Custom URL scheme detected - Company: ${companyCode}, Short code: ${shortCode}`);
+            loggerRef.current.info(`Custom URL scheme detected - Company: ${companyCode}, Short code: ${shortCode}`);
             // Validate company code matches initialized one
             const activeCompanyCode = yield getActiveCompanyCode();
             if (activeCompanyCode && companyCode.toLowerCase() !== activeCompanyCode.toLowerCase()) {
-                console.log(`[Insert Affiliate] Warning: URL company code (${companyCode}) doesn't match initialized company code (${activeCompanyCode})`);
+                loggerRef.current.info(`Warning: URL company code (${companyCode}) doesn't match initialized company code (${activeCompanyCode})`);
             }
             // If URL scheme is used, we can straight away store the short code as the referring link
             yield storeInsertAffiliateIdentifier({ link: shortCode, source: 'deep_link_ios' });
@@ -574,7 +583,7 @@ const DeepLinkIapProvider = ({ children, }) => {
             return true;
         }
         catch (error) {
-            console.error('[Insert Affiliate] Error handling custom URL scheme:', error);
+            loggerRef.current.error('Error handling custom URL scheme:', error);
             return false;
         }
     });
@@ -584,22 +593,22 @@ const DeepLinkIapProvider = ({ children, }) => {
     //     const pathComponents = url.pathname.split('/').filter(segment => segment.length > 0);
     //     // Expected format: /V1/companycode/shortcode
     //     if (pathComponents.length < 3 || pathComponents[0] !== 'V1') {
-    //       console.log(`[Insert Affiliate] Invalid universal link format: ${url.href}`);
+    //       loggerRef.current.info(`Invalid universal link format: ${url.href}`);
     //       return false;
     //     }
     //     const companyCode = pathComponents[1];
     //     const shortCode = pathComponents[2];
-    //     console.log(`[Insert Affiliate] Universal link detected - Company: ${companyCode}, Short code: ${shortCode}`);
+    //     loggerRef.current.info(`Universal link detected - Company: ${companyCode}, Short code: ${shortCode}`);
     //     // Validate company code matches initialized one
     //     const activeCompanyCode = await getActiveCompanyCode();
     //     if (activeCompanyCode && companyCode.toLowerCase() !== activeCompanyCode.toLowerCase()) {
-    //       console.log(`[Insert Affiliate] Warning: URL company code (${companyCode}) doesn't match initialized company code (${activeCompanyCode})`);
+    //       loggerRef.current.info(`Warning: URL company code (${companyCode}) doesn't match initialized company code (${activeCompanyCode})`);
     //     }
     //     // Process the affiliate attribution
     //     await storeInsertAffiliateIdentifier({ link: shortCode });
     //     return true;
     //   } catch (error) {
-    //     console.error('[Insert Affiliate] Error handling universal link:', error);
+    //     loggerRef.current.error('Error handling universal link:', error);
     //     return false;
     //   }
     // };
@@ -641,7 +650,7 @@ const DeepLinkIapProvider = ({ children, }) => {
             // First try to extract from query parameter (new format: scheme://insert-affiliate?code=SHORTCODE)
             const queryCode = parseShortCodeFromQuery(url);
             if (queryCode) {
-                console.log(`[Insert Affiliate] Found short code in query parameter: ${queryCode}`);
+                loggerRef.current.info(`Found short code in query parameter: ${queryCode}`);
                 return queryCode;
             }
             // Fall back to path format (legacy: scheme://SHORTCODE)
@@ -654,7 +663,7 @@ const DeepLinkIapProvider = ({ children, }) => {
                 if (shortCode === 'insert-affiliate' || shortCode.startsWith('insert-affiliate?')) {
                     return null;
                 }
-                console.log(`[Insert Affiliate] Found short code in URL path (legacy format): ${shortCode}`);
+                loggerRef.current.info(`Found short code in URL path (legacy format): ${shortCode}`);
                 return shortCode;
             }
             return null;
@@ -696,20 +705,20 @@ const DeepLinkIapProvider = ({ children, }) => {
     // Helper function for verbose logging (uses ref to avoid stale closures)
     const verboseLog = (message) => {
         if (verboseLoggingRef.current) {
-            console.log(`[Insert Affiliate] [VERBOSE] ${message}`);
+            loggerRef.current.debug(`[VERBOSE] ${message}`);
         }
     };
     // Helper function to log errors
     const errorLog = (message, type) => {
         switch (type) {
             case 'error':
-                console.error(`ENCOUNTER ERROR ~ ${message}`);
+                loggerRef.current.error(`ENCOUNTER ERROR ~ ${message}`);
                 break;
             case 'warn':
-                console.warn(`ENCOUNTER WARNING ~ ${message}`);
+                loggerRef.current.warn(`ENCOUNTER WARNING ~ ${message}`);
                 break;
             default:
-                console.log(`LOGGING ~ ${message}`);
+                loggerRef.current.info(`LOGGING ~ ${message}`);
                 break;
         }
     };
@@ -768,7 +777,7 @@ const DeepLinkIapProvider = ({ children, }) => {
                 return;
             }
             if (verboseLogging) {
-                console.log('[Insert Affiliate] Reporting SDK initialization for onboarding verification...');
+                loggerRef.current.info('Reporting SDK initialization for onboarding verification...');
             }
             const response = yield fetch('https://api.insertaffiliate.com/V1/onboarding/sdk-init', {
                 method: 'POST',
@@ -780,17 +789,17 @@ const DeepLinkIapProvider = ({ children, }) => {
             if (response.ok) {
                 yield async_storage_1.default.setItem(ASYNC_KEYS.SDK_INIT_REPORTED, 'true');
                 if (verboseLogging) {
-                    console.log('[Insert Affiliate] SDK initialization reported successfully');
+                    loggerRef.current.info('SDK initialization reported successfully');
                 }
             }
             else if (verboseLogging) {
-                console.log(`[Insert Affiliate] SDK initialization report failed with status: ${response.status}`);
+                loggerRef.current.info(`SDK initialization report failed with status: ${response.status}`);
             }
         }
         catch (error) {
             // Silently fail - this is non-critical telemetry
             if (verboseLogging) {
-                console.log(`[Insert Affiliate] SDK initialization report error: ${error}`);
+                loggerRef.current.info(`SDK initialization report error: ${error}`);
             }
         }
     });
@@ -1003,7 +1012,7 @@ const DeepLinkIapProvider = ({ children, }) => {
             systemInfo.deviceType = 'unknown';
         }
         if (verboseLogging) {
-            console.log('[Insert Affiliate] system info:', systemInfo);
+            loggerRef.current.info('system info:', systemInfo);
         }
         return systemInfo;
     });
@@ -1139,7 +1148,7 @@ const DeepLinkIapProvider = ({ children, }) => {
     // Sends enhanced system info to the backend API for deep link event tracking
     const sendSystemInfoToBackend = (systemInfo) => __awaiter(void 0, void 0, void 0, function* () {
         if (verboseLogging) {
-            console.log('[Insert Affiliate] Sending system info to backend...');
+            loggerRef.current.info('Sending system info to backend...');
         }
         try {
             const apiUrlString = 'https://insertaffiliate.link/V1/appDeepLinkEvents';
@@ -1262,12 +1271,12 @@ const DeepLinkIapProvider = ({ children, }) => {
         }
         catch (error) {
             verboseLog(`Error getting affiliate details: ${error}`);
-            console.error('[Insert Affiliate] Error getting affiliate details:', error);
+            loggerRef.current.error('Error getting affiliate details:', error);
             return null;
         }
     });
     const setShortCodeImpl = (shortCode) => __awaiter(void 0, void 0, void 0, function* () {
-        console.log('[Insert Affiliate] Setting short code.');
+        loggerRef.current.info('Setting short code.');
         yield generateThenSetUserID();
         // Validate it is a short code
         const capitalisedShortCode = shortCode.toUpperCase();
@@ -1277,11 +1286,11 @@ const DeepLinkIapProvider = ({ children, }) => {
         if (exists) {
             // If affiliate exists, set the Insert Affiliate Identifier
             yield storeInsertAffiliateIdentifier({ link: capitalisedShortCode, source: 'short_code_manual' });
-            console.log(`[Insert Affiliate] Short code ${capitalisedShortCode} validated and stored successfully.`);
+            loggerRef.current.info(`Short code ${capitalisedShortCode} validated and stored successfully.`);
             return true;
         }
         else {
-            console.warn(`[Insert Affiliate] Short code ${capitalisedShortCode} does not exist. Not storing.`);
+            loggerRef.current.warn(`Short code ${capitalisedShortCode} does not exist. Not storing.`);
             return false;
         }
     });
@@ -1300,13 +1309,13 @@ const DeepLinkIapProvider = ({ children, }) => {
         try {
             const shortCode = yield returnInsertAffiliateIdentifierImpl();
             if (!shortCode) {
-                console.log('[Insert Affiliate] No affiliate stored - not saving expected transaction.');
+                loggerRef.current.info('No affiliate stored - not saving expected transaction.');
                 return null;
             }
             const userAccountToken = yield getOrCreateUserAccountToken();
-            console.log('[Insert Affiliate] User account token:', userAccountToken);
+            loggerRef.current.info('User account token:', userAccountToken);
             if (!userAccountToken) {
-                console.error('[Insert Affiliate] Failed to generate user account token.');
+                loggerRef.current.error('Failed to generate user account token.');
                 return null;
             }
             else {
@@ -1319,12 +1328,12 @@ const DeepLinkIapProvider = ({ children, }) => {
             if ((error === null || error === void 0 ? void 0 : error.code) === 'E_IAP_NOT_AVAILABLE' ||
                 (error instanceof Error && error.message.includes('E_IAP_NOT_AVAILABLE'))) {
                 if (isDevelopmentEnvironment) {
-                    console.warn('[Insert Affiliate] IAP not available in development environment. Cannot store expected transaction.');
+                    loggerRef.current.warn('IAP not available in development environment. Cannot store expected transaction.');
                     verboseLog('E_IAP_NOT_AVAILABLE error in returnUserAccountTokenAndStoreExpectedTransaction - gracefully handling in development');
                 }
                 return null; // Return null but don't crash
             }
-            console.error('[Insert Affiliate] Error in returnUserAccountTokenAndStoreExpectedTransaction:', error);
+            loggerRef.current.error('Error in returnUserAccountTokenAndStoreExpectedTransaction:', error);
             return null;
         }
         ;
@@ -1440,15 +1449,15 @@ const DeepLinkIapProvider = ({ children, }) => {
     });
     // MARK: Insert Affiliate Identifier
     const setInsertAffiliateIdentifierImpl = (referringLink) => __awaiter(void 0, void 0, void 0, function* () {
-        console.log('[Insert Affiliate] Setting affiliate identifier.');
+        loggerRef.current.info('Setting affiliate identifier.');
         verboseLog(`Input referringLink: ${referringLink}`);
         try {
             verboseLog('Generating or retrieving user ID...');
             const customerID = yield generateThenSetUserID();
-            console.log('[Insert Affiliate] Completed generateThenSetUserID within setInsertAffiliateIdentifier.');
+            loggerRef.current.info('Completed generateThenSetUserID within setInsertAffiliateIdentifier.');
             verboseLog(`Customer ID: ${customerID}`);
             if (!referringLink) {
-                console.warn('[Insert Affiliate] Referring link is invalid.');
+                loggerRef.current.warn('Referring link is invalid.');
                 verboseLog('Referring link is empty or invalid, storing as-is');
                 yield storeInsertAffiliateIdentifier({ link: referringLink, source: 'referring_link' });
                 return `${referringLink}-${customerID}`;
@@ -1458,14 +1467,14 @@ const DeepLinkIapProvider = ({ children, }) => {
             const activeCompanyCode = yield getActiveCompanyCode();
             verboseLog(`Active company code: ${activeCompanyCode || 'Not found'}`);
             if (!activeCompanyCode) {
-                console.error('[Insert Affiliate] Company code is not set. Please initialize the SDK with a valid company code.');
+                loggerRef.current.error('Company code is not set. Please initialize the SDK with a valid company code.');
                 verboseLog('Company code missing, cannot proceed with API call');
                 return;
             }
             // Check if referring link is already a short code, if so save it and stop here.
             verboseLog('Checking if referring link is already a short code...');
             if (isShortCode(referringLink)) {
-                console.log('[Insert Affiliate] Referring link is already a short code.');
+                loggerRef.current.info('Referring link is already a short code.');
                 verboseLog('Link is already a short code, storing directly');
                 yield storeInsertAffiliateIdentifier({ link: referringLink, source: 'referring_link' });
                 return `${referringLink}-${customerID}`;
@@ -1476,14 +1485,14 @@ const DeepLinkIapProvider = ({ children, }) => {
             verboseLog('Encoding referring link for API call...');
             const encodedAffiliateLink = encodeURIComponent(referringLink);
             if (!encodedAffiliateLink) {
-                console.error('[Insert Affiliate] Failed to encode affiliate link.');
+                loggerRef.current.error('Failed to encode affiliate link.');
                 verboseLog('Failed to encode link, storing original');
                 yield storeInsertAffiliateIdentifier({ link: referringLink, source: 'referring_link' });
                 return `${referringLink}-${customerID}`;
             }
             // Create the request URL
             const urlString = `https://api.insertaffiliate.com/V1/convert-deep-link-to-short-link?companyId=${activeCompanyCode}&deepLinkUrl=${encodedAffiliateLink}`;
-            console.log('[Insert Affiliate] urlString .', urlString);
+            loggerRef.current.info('urlString .', urlString);
             verboseLog('Making API request to convert deep link to short code...');
             const response = yield axios_1.default.get(urlString, {
                 headers: {
@@ -1494,7 +1503,7 @@ const DeepLinkIapProvider = ({ children, }) => {
             // Call to the backend for the short code and save the resolse in valid
             if (response.status === 200 && response.data.shortLink) {
                 const shortLink = response.data.shortLink;
-                console.log('[Insert Affiliate] Short link received:', shortLink);
+                loggerRef.current.info('Short link received:', shortLink);
                 verboseLog(`Successfully converted to short link: ${shortLink}`);
                 verboseLog('Storing short link to AsyncStorage...');
                 yield storeInsertAffiliateIdentifier({ link: shortLink, source: 'referring_link' });
@@ -1502,7 +1511,7 @@ const DeepLinkIapProvider = ({ children, }) => {
                 return `${shortLink}-${customerID}`;
             }
             else {
-                console.warn('[Insert Affiliate] Unexpected response format.');
+                loggerRef.current.warn('Unexpected response format.');
                 verboseLog(`Unexpected API response. Status: ${response.status}, Data: ${JSON.stringify(response.data)}`);
                 verboseLog('Storing original link as fallback');
                 yield storeInsertAffiliateIdentifier({ link: referringLink, source: 'referring_link' });
@@ -1510,7 +1519,7 @@ const DeepLinkIapProvider = ({ children, }) => {
             }
         }
         catch (error) {
-            console.error('[Insert Affiliate] Error:', error);
+            loggerRef.current.error('Error:', error);
             verboseLog(`Error in setInsertAffiliateIdentifier: ${error}`);
         }
     });
@@ -1562,11 +1571,11 @@ const DeepLinkIapProvider = ({ children, }) => {
                 (jsonIapPurchase === null || jsonIapPurchase === void 0 ? void 0 : jsonIapPurchase.code) === 'E_IAP_NOT_AVAILABLE' ||
                 (typeof jsonIapPurchase === 'string' && jsonIapPurchase.includes('E_IAP_NOT_AVAILABLE'))) {
                 if (isDevelopmentEnvironment) {
-                    console.warn('[Insert Affiliate] IAP not available in development environment. This is expected behavior.');
+                    loggerRef.current.warn('IAP not available in development environment. This is expected behavior.');
                     verboseLog('E_IAP_NOT_AVAILABLE error detected in development - gracefully handling');
                 }
                 else {
-                    console.error('[Insert Affiliate] IAP not available in production environment. Please check your IAP configuration.');
+                    loggerRef.current.error('IAP not available in production environment. Please check your IAP configuration.');
                 }
                 return false; // Return false but don't crash
             }
@@ -1610,11 +1619,11 @@ const DeepLinkIapProvider = ({ children, }) => {
                 data: requestBody,
             });
             if (response.status === 200) {
-                console.log('Validation successful:', response.data);
+                loggerRef.current.info('Validation successful:', response.data);
                 return true;
             }
             else {
-                console.error('Validation failed:', response.data);
+                loggerRef.current.error('Validation failed:', response.data);
                 return false;
             }
         }
@@ -1623,19 +1632,19 @@ const DeepLinkIapProvider = ({ children, }) => {
             if ((error === null || error === void 0 ? void 0 : error.code) === 'E_IAP_NOT_AVAILABLE' ||
                 (error instanceof Error && error.message.includes('E_IAP_NOT_AVAILABLE'))) {
                 if (isDevelopmentEnvironment) {
-                    console.warn('[Insert Affiliate] IAP not available in development environment. SDK will continue without purchase validation.');
+                    loggerRef.current.warn('IAP not available in development environment. SDK will continue without purchase validation.');
                     verboseLog('E_IAP_NOT_AVAILABLE error caught in validatePurchaseWithIapticAPI - gracefully handling in development');
                 }
                 else {
-                    console.error('[Insert Affiliate] IAP not available in production environment. Please check your IAP configuration.');
+                    loggerRef.current.error('IAP not available in production environment. Please check your IAP configuration.');
                 }
                 return false; // Return false but don't crash
             }
             if (error instanceof Error) {
-                console.error(`validatePurchaseWithIapticAPI Error: ${error.message}`);
+                loggerRef.current.error(`validatePurchaseWithIapticAPI Error: ${error.message}`);
             }
             else {
-                console.error(`validatePurchaseWithIapticAPI Unknown Error: ${JSON.stringify(error)}`);
+                loggerRef.current.error(`validatePurchaseWithIapticAPI Unknown Error: ${JSON.stringify(error)}`);
             }
             return false;
         }
@@ -1644,13 +1653,13 @@ const DeepLinkIapProvider = ({ children, }) => {
         verboseLog(`Storing expected store transaction with token: ${purchaseToken}`);
         const activeCompanyCode = yield getActiveCompanyCode();
         if (!activeCompanyCode) {
-            console.error("[Insert Affiliate] Company code is not set. Please initialize the SDK with a valid company code.");
+            loggerRef.current.error("Company code is not set. Please initialize the SDK with a valid company code.");
             verboseLog("Cannot store transaction: no company code available");
             return;
         }
         const shortCode = yield returnInsertAffiliateIdentifierImpl();
         if (!shortCode) {
-            console.error("[Insert Affiliate] No affiliate identifier found. Please set one before tracking events.");
+            loggerRef.current.error("No affiliate identifier found. Please set one before tracking events.");
             verboseLog("Cannot store transaction: no affiliate identifier available");
             return;
         }
@@ -1662,7 +1671,7 @@ const DeepLinkIapProvider = ({ children, }) => {
             shortCode,
             storedDate: new Date().toISOString(), // ISO8601 format
         };
-        console.log("[Insert Affiliate] Storing expected transaction: ", payload);
+        loggerRef.current.info("Storing expected transaction: ", payload);
         verboseLog("Making API call to store expected transaction...");
         try {
             const response = yield fetch("https://api.insertaffiliate.com/v1/api/app-store-webhook/create-expected-transaction", {
@@ -1674,17 +1683,17 @@ const DeepLinkIapProvider = ({ children, }) => {
             });
             verboseLog(`API response status: ${response.status}`);
             if (response.ok) {
-                console.info("[Insert Affiliate] Expected transaction stored successfully.");
+                loggerRef.current.info("Expected transaction stored successfully.");
                 verboseLog("Expected transaction stored successfully on server");
             }
             else {
                 const errorText = yield response.text();
-                console.error(`[Insert Affiliate] Failed to store expected transaction with status code: ${response.status}. Response: ${errorText}`);
+                loggerRef.current.error(`Failed to store expected transaction with status code: ${response.status}. Response: ${errorText}`);
                 verboseLog(`API error response: ${errorText}`);
             }
         }
         catch (error) {
-            console.error(`[Insert Affiliate] Error storing expected transaction: ${error}`);
+            loggerRef.current.error(`Error storing expected transaction: ${error}`);
             verboseLog(`Network error storing transaction: ${error}`);
         }
     });
@@ -1694,13 +1703,13 @@ const DeepLinkIapProvider = ({ children, }) => {
             verboseLog(`Tracking event: ${eventName}`);
             const activeCompanyCode = yield getActiveCompanyCode();
             if (!activeCompanyCode) {
-                console.error("[Insert Affiliate] Company code is not set. Please initialize the SDK with a valid company code.");
+                loggerRef.current.error("Company code is not set. Please initialize the SDK with a valid company code.");
                 verboseLog("Cannot track event: no company code available");
                 return Promise.resolve();
             }
-            console.log("track event called with - companyCode: ", activeCompanyCode);
+            loggerRef.current.info("track event called with - companyCode: ", activeCompanyCode);
             if (!referrerLink || !userId) {
-                console.warn('[Insert Affiliate] No affiliate identifier found. Please set one before tracking events.');
+                loggerRef.current.warn('No affiliate identifier found. Please set one before tracking events.');
                 verboseLog("Cannot track event: no affiliate identifier available");
                 return Promise.resolve();
             }
@@ -1718,16 +1727,16 @@ const DeepLinkIapProvider = ({ children, }) => {
             });
             verboseLog(`Track event API response status: ${response.status}`);
             if (response.status === 200) {
-                console.log('[Insert Affiliate] Event tracked successfully');
+                loggerRef.current.info('Event tracked successfully');
                 verboseLog("Event tracked successfully on server");
             }
             else {
-                console.error(`[Insert Affiliate] Failed to track event with status code: ${response.status}`);
+                loggerRef.current.error(`Failed to track event with status code: ${response.status}`);
                 verboseLog(`Track event API error: status ${response.status}, response: ${JSON.stringify(response.data)}`);
             }
         }
         catch (error) {
-            console.error('[Insert Affiliate] Error tracking event:', error);
+            loggerRef.current.error('Error tracking event:', error);
             verboseLog(`Network error tracking event: ${error}`);
             return Promise.reject(error);
         }
@@ -1759,7 +1768,7 @@ const DeepLinkIapProvider = ({ children, }) => {
                     offerCode.includes("errorAffiliateoffercodenotfoundinanycompany") ||
                     offerCode.includes("errorAffiliateoffercodenotfoundinanycompanyAffiliatelinkwas") ||
                     offerCode.includes("Routenotfound"))) {
-                    console.warn(`[Insert Affiliate] Offer code not found or invalid: ${offerCode}`);
+                    loggerRef.current.warn(`Offer code not found or invalid: ${offerCode}`);
                     verboseLog(`Offer code not found or invalid: ${offerCode}`);
                     return null;
                 }
@@ -1768,13 +1777,13 @@ const DeepLinkIapProvider = ({ children, }) => {
                 return cleanedOfferCode;
             }
             else {
-                console.error(`[Insert Affiliate] Failed to fetch offer code. Status code: ${response.status}, Response: ${JSON.stringify(response.data)}`);
+                loggerRef.current.error(`Failed to fetch offer code. Status code: ${response.status}, Response: ${JSON.stringify(response.data)}`);
                 verboseLog(`Failed to fetch offer code. Status code: ${response.status}, Response: ${JSON.stringify(response.data)}`);
                 return null;
             }
         }
         catch (error) {
-            console.error('[Insert Affiliate] Error fetching offer code:', error);
+            loggerRef.current.error('Error fetching offer code:', error);
             verboseLog(`Error fetching offer code: ${error}`);
             return null;
         }
@@ -1788,7 +1797,7 @@ const DeepLinkIapProvider = ({ children, }) => {
                 yield saveValueInAsync(ASYNC_KEYS.OFFER_CODE, offerCode);
                 setOfferCode(offerCode);
                 verboseLog(`Successfully stored offer code: ${offerCode}`);
-                console.log('[Insert Affiliate] Offer code retrieved and stored successfully');
+                loggerRef.current.info('Offer code retrieved and stored successfully');
                 return offerCode;
             }
             else {
@@ -1800,7 +1809,7 @@ const DeepLinkIapProvider = ({ children, }) => {
             }
         }
         catch (error) {
-            console.error('[Insert Affiliate] Error retrieving and storing offer code:', error);
+            loggerRef.current.error('Error retrieving and storing offer code:', error);
             verboseLog(`Error in retrieveAndStoreOfferCode: ${error}`);
             return null;
         }
@@ -1890,6 +1899,9 @@ const DeepLinkIapProvider = ({ children, }) => {
     const handleInsertLinks = (0, react_1.useCallback)((url) => __awaiter(void 0, void 0, void 0, function* () {
         return handleInsertLinksImplRef.current(url);
     }), []);
+    const setLogger = (0, react_1.useCallback)((logger) => {
+        loggerRef.current = logger;
+    }, []);
     return (react_1.default.createElement(exports.DeepLinkIapContext.Provider, { value: {
             referrerLink,
             userId,
@@ -1908,6 +1920,7 @@ const DeepLinkIapProvider = ({ children, }) => {
             setInsertAffiliateIdentifierChangeCallback: setInsertAffiliateIdentifierChangeCallbackHandler,
             handleInsertLinks,
             initialize,
+            setLogger,
             isInitialized,
         } }, children));
 };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 import DeepLinkIapProvider from "./DeepLinkIapProvider";
 import useDeepLinkIapProvider from "./useDeepLinkIapProvider";
 export { DeepLinkIapProvider, useDeepLinkIapProvider };
-export type { InsertAffiliateIdentifierChangeCallback, AffiliateDetails } from "./DeepLinkIapProvider";
+export type { InsertAffiliateIdentifierChangeCallback, AffiliateDetails, InsertAffiliateLogger } from "./DeepLinkIapProvider";

package/dist/useDeepLinkIapProvider.d.ts

@@ -17,6 +17,7 @@ declare const useDeepLinkIapProvider: () => {
     setInsertAffiliateIdentifierChangeCallback: (callback: import("./DeepLinkIapProvider").InsertAffiliateIdentifierChangeCallback | null) => void;
     handleInsertLinks: (url: string) => Promise<boolean>;
     initialize: (code: string | null, verboseLogging?: boolean, insertLinksEnabled?: boolean, insertLinksClipboardEnabled?: boolean, affiliateAttributionActiveTime?: number, preventAffiliateTransfer?: boolean) => Promise<void>;
+    setLogger: (logger: import("./DeepLinkIapProvider").InsertAffiliateLogger) => void;
     isInitialized: boolean;
     OfferCode: string | null;
 };