@osano/osano-cmp-react-native 0.11.0 → 0.13.0

package/lib/typescript/src/native/OsanoCmp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OsanoCmp.d.ts","sourceRoot":"","sources":["../../../../src/native/OsanoCmp.ts"],"names":[],"mappings":"AAoBA,wBAAgB,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAEhE;AACD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtE;AACD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAE1E;AACD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvD"}
+{"version":3,"file":"OsanoCmp.d.ts","sourceRoot":"","sources":["../../../../src/native/OsanoCmp.ts"],"names":[],"mappings":"AAoBA,wBAAgB,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAEhE;AACD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtE;AACD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAE1E;AACD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvD;AACD,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAIjB;AACD,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAIjB;AACD,wBAAgB,uBAAuB,CACtC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,CAAC,CAIlB;AACD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlE"}

package/lib/typescript/src/reducer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../../../src/reducer.ts"],"names":[],"mappings":"AAmBA,OAAO,EACN,eAAe,EAEf,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAc,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIzE,eAAO,MAAM,eAAe,mBAAiC,CAAC;AAE9D,eAAO,MAAM,YAAY,EAAE,UA2B1B,CAAC;AAEF,eAAO,MAAM,IAAI,gBAAiB,UAAU,GAAG,GAAG,KAAG,UAiBpD,CAAC;AAkCF,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,UAAU,CA+S1E"}
+{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../../../src/reducer.ts"],"names":[],"mappings":"AAmBA,OAAO,EACN,eAAe,EAEf,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAc,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIzE,eAAO,MAAM,eAAe,mBAAiC,CAAC;AAE9D,eAAO,MAAM,YAAY,EAAE,UA2B1B,CAAC;AAEF,eAAO,MAAM,IAAI,GAAI,aAAa,UAAU,GAAG,GAAG,KAAG,UAiBpD,CAAC;AAkCF,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,GAAG,UAAU,CA+S1E"}

package/lib/typescript/src/selectors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../../../src/selectors.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,eAAe,IAAI,mBAAmB,EACtC,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAI5D,eAAO,MAAM,kBAAkB,UACvB,UAAU,YACP,mBAAmB,YACW,CAAC;AAE1C,eAAO,MAAM,wBAAwB,UAAW,UAAU,YACrB,CAAC;AACtC,eAAO,MAAM,kBAAkB,UACvB,UAAU,YACP,mBAAmB,YAMuB,CAAC;AAEtD,eAAO,MAAM,YAAY,UAAW,UAAU,YAA2B,CAAC;AAC1E,eAAO,MAAM,YAAY,UAAW,UAAU,YACL,CAAC;AAE1C,eAAO,MAAM,mBAAmB,UAAW,UAAU,YAKmB,CAAC;AACzE,eAAO,MAAM,kBAAkB,UAAW,UAAU,gBAAgB,OAAO,YAK3D,CAAC;AAEjB,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,EAAE,CAAC;AACrE,wBAAgB,UAAU,CACzB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,mBAAmB,GAC3B,OAAO,CAAC;AASX,eAAO,MAAM,mBAAmB,UAAW,UAAU,KAAG,MACpB,CAAC;AAQrC,eAAO,MAAM,cAAc,UAAW,UAAU,YACpB,CAAC;AAC7B,eAAO,MAAM,oBAAoB,UAAW,UAAU,YAErD,CAAC;AACF,eAAO,MAAM,gCAAgC,UACrC,UAAU,YACP,mBAAmB,YAO7B,CAAC;AACF,eAAO,MAAM,sBAAsB,UAC3B,UAAU,YACP,mBAAmB,KAC3B,UAAU,EAUZ,CAAC;AAEF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAAC;AACtD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC"}
+{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../../../src/selectors.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,eAAe,IAAI,mBAAmB,EACtC,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAI5D,eAAO,MAAM,kBAAkB,GAC9B,OAAO,UAAU,EACjB,UAAU,mBAAmB,YACW,CAAC;AAE1C,eAAO,MAAM,wBAAwB,GAAI,OAAO,UAAU,YACrB,CAAC;AACtC,eAAO,MAAM,kBAAkB,GAC9B,OAAO,UAAU,EACjB,UAAU,mBAAmB,YAMuB,CAAC;AAEtD,eAAO,MAAM,YAAY,GAAI,OAAO,UAAU,YAA2B,CAAC;AAC1E,eAAO,MAAM,YAAY,GAAI,OAAO,UAAU,YACL,CAAC;AAE1C,eAAO,MAAM,mBAAmB,GAAI,OAAO,UAAU,YAMmB,CAAC;AACzE,eAAO,MAAM,kBAAkB,GAAI,OAAO,UAAU,EAAE,cAAc,OAAO,YAK3D,CAAC;AAEjB,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,EAAE,CAAC;AACrE,wBAAgB,UAAU,CACzB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,mBAAmB,GAC3B,OAAO,CAAC;AASX,eAAO,MAAM,mBAAmB,GAAI,OAAO,UAAU,KAAG,MACpB,CAAC;AAQrC,eAAO,MAAM,cAAc,GAAI,OAAO,UAAU,YACpB,CAAC;AAC7B,eAAO,MAAM,oBAAoB,GAAI,OAAO,UAAU,YAErD,CAAC;AACF,eAAO,MAAM,gCAAgC,GAC5C,OAAO,UAAU,EACjB,UAAU,mBAAmB,YAO7B,CAAC;AACF,eAAO,MAAM,sBAAsB,GAClC,OAAO,UAAU,EACjB,UAAU,mBAAmB,KAC3B,UAAU,EAUZ,CAAC;AAEF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAAC;AACtD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC"}

package/lib/typescript/src/services/consent.d.ts

@@ -1,6 +1,6 @@
+import type { ConsentManager } from '../ConsentManager';
 import { ConsentCategory, ConsentCategory as ConsentCategoryType } from '../constants';
 import type { Config } from '../types/consent-config';
-import type { ConsentManager } from '../ConsentManager';
 export type ConsentPayload = {
     customerId: string;
     configId: string;
@@ -28,5 +28,16 @@ export declare const clearConsent: (cmp: ConsentManager) => Promise<ConsentCateg
 export declare const recordConsent: (cmp: ConsentManager, consent?: ConsentCategoryType[]) => Promise<ConsentCategory[]>;
 export declare function hashExtUsrData(customerId: string, configId: string, extUsrData: string): string;
 export declare const fetchConsent: (cmp: ConsentManager) => Promise<ConsentCategory[]>;
-export declare const fetchConfig: (customerId: string, configId: string) => Promise<Config | null>;
+export declare const fetchConfig: (customerId: string, configId: string) => Promise<Config>;
+export declare const getStoredConfig: (configId: string) => Promise<Config | null>;
+export declare const storeConfig: (configId: string, config: Config) => Promise<void>;
+export declare const getConfigLastStoredAt: (configId: string) => Promise<Date | null>;
+/**
+ * Determine if a cached config is stale
+ *
+ * @async
+ * @param {string} configId
+ * @returns {Promise<boolean>}
+ */
+export declare const hasStaleConfig: (configId: string) => Promise<boolean>;
 //# sourceMappingURL=consent.d.ts.map

package/lib/typescript/src/services/consent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../../../src/services/consent.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,eAAe,IAAI,mBAAmB,EACtC,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAgBxD,MAAM,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACvC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;CACtB,CAAC;AA2EF,eAAO,MAAM,YAAY,QAAe,cAAc,+BAgBrD,CAAC;AAyDF,eAAO,MAAM,aAAa,QACpB,cAAc,YACT,mBAAmB,EAAE,+BAY/B,CAAC;AAEF,wBAAgB,cAAc,CAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAChB,MAAM,CAgBR;AAED,eAAO,MAAM,YAAY,QAAe,cAAc,+BAmDrD,CAAC;AAEF,eAAO,MAAM,WAAW,eAAgB,MAAM,YAAY,MAAM,2BAsB/D,CAAC"}
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../../../src/services/consent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EACN,eAAe,EACf,eAAe,IAAI,mBAAmB,EAEtC,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AActD,MAAM,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACvC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;CACtB,CAAC;AA2EF,eAAO,MAAM,YAAY,GAAU,KAAK,cAAc,+BAgBrD,CAAC;AAyDF,eAAO,MAAM,aAAa,GACzB,KAAK,cAAc,EACnB,UAAU,mBAAmB,EAAE,+BAY/B,CAAC;AAEF,wBAAgB,cAAc,CAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAChB,MAAM,CAgBR;AAED,eAAO,MAAM,YAAY,GAAU,KAAK,cAAc,+BAoDrD,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,YAAY,MAAM,EAAE,UAAU,MAAM,oBAsB/D,CAAC;AAEF,eAAO,MAAM,eAAe,GAC3B,UAAU,MAAM,KACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAUvB,CAAC;AAEF,eAAO,MAAM,WAAW,GACvB,UAAU,MAAM,EAChB,QAAQ,MAAM,KACZ,OAAO,CAAC,IAAI,CAYd,CAAC;AAEF,eAAO,MAAM,qBAAqB,GACjC,UAAU,MAAM,KACd,OAAO,CAAC,IAAI,GAAG,IAAI,CAYrB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,OAAO,CAStE,CAAC"}

package/lib/typescript/src/services/google-consent-mode-mapper.d.ts

@@ -0,0 +1,66 @@
+import { ConsentCategory } from '../constants';
+import type { GoogleConsentMap } from '../types/google-consent-mode';
+import { GoogleConsentParameter, GoogleConsentStatus } from '../types/google-consent-mode';
+/**
+ * Google Consent Mode Category Mapper
+ *
+ * Converts Osano consent categories to Google Consent Mode v2 parameters.
+ *
+ * **Mapping Logic (matching iOS/Android SDKs):**
+ * - ANALYTICS category → analytics_storage parameter
+ * - MARKETING category → ad_storage, ad_user_data, ad_personalization parameters
+ *
+ * All Google Consent Mode parameters default to "denied" until explicitly granted through category mapping.
+ */
+export declare class GoogleConsentModeMapper {
+    private static readonly GOOGLE_CATEGORIES_MAP;
+    /**
+     * Build a Google Consent Map from a set of Osano consent categories
+     *
+     * @param categories - Set of Osano consent categories that the user has granted
+     * @returns GoogleConsentMap with appropriate Google Consent Mode v2 parameters
+     *
+     * @example
+     * ```typescript
+     * const categories = new Set([ConsentCategory.ANALYTICS, ConsentCategory.MARKETING]);
+     * const consentMap = GoogleConsentModeMapper.buildGoogleConsentMap(categories);
+     *
+     * // Results in:
+     * // {
+     * //   analytics_storage: 'granted',
+     * //   ad_storage: 'granted',
+     * //   ad_user_data: 'granted',
+     * //   ad_personalization: 'granted'
+     * // }
+     * ```
+     */
+    static buildGoogleConsentMap(categories: Set<ConsentCategory>): GoogleConsentMap;
+    /**
+     * Create a GoogleConsentMap from a raw consent map
+     *
+     * @param consentMap - Raw mapping of Google Consent Mode parameters to status
+     * @returns GoogleConsentMap implementation with helper methods
+     */
+    static createGoogleConsentMap(consentMap: Record<GoogleConsentParameter, GoogleConsentStatus>): GoogleConsentMap;
+    /**
+     * Check if a consent category is mapped to Google Consent Mode parameters
+     *
+     * @param category - Osano consent category to check
+     * @returns true if the category is mapped to Google Consent Mode parameters
+     */
+    static isGoogleConsentCategory(category: ConsentCategory): boolean;
+    /**
+     * Get Google Consent Mode parameters for a specific consent category
+     *
+     * @param category - Osano consent category
+     * @returns Array of Google Consent Mode parameters mapped to this category
+     */
+    static getGoogleParametersForCategory(category: ConsentCategory): GoogleConsentParameter[];
+    /**
+     * Get readonly copy of the categories mapping
+     *
+     * @returns Readonly mapping of Osano categories to Google Consent Mode parameters
+     */
+    static getCategoriesMapping(): Readonly<Record<string, GoogleConsentParameter[]>>;
+}
+//# sourceMappingURL=google-consent-mode-mapper.d.ts.map

package/lib/typescript/src/services/google-consent-mode-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-consent-mode-mapper.d.ts","sourceRoot":"","sources":["../../../../src/services/google-consent-mode-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAEN,sBAAsB,EACtB,mBAAmB,EACnB,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,qBAAa,uBAAuB;IACnC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAU3C;IAEF;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,qBAAqB,CAC3B,UAAU,EAAE,GAAG,CAAC,eAAe,CAAC,GAC9B,gBAAgB;IAuBnB;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAC5B,UAAU,EAAE,MAAM,CAAC,sBAAsB,EAAE,mBAAmB,CAAC,GAC7D,gBAAgB;IAInB;;;;;OAKG;IACH,MAAM,CAAC,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO;IAIlE;;;;;OAKG;IACH,MAAM,CAAC,8BAA8B,CACpC,QAAQ,EAAE,eAAe,GACvB,sBAAsB,EAAE;IAI3B;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,IAAI,QAAQ,CACtC,MAAM,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,CACxC;CAGD"}

package/lib/typescript/src/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,kBAAkB,CAAC;AA8BjE,eAAO,MAAM,mBAAmB,UACxB,MAAM,4BAOb,CAAC;AAEF,eAAO,MAAM,kBAAkB,YAAa,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgKxD,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,kBAAkB,CAAC;AA8BjE,eAAO,MAAM,mBAAmB,GAC/B,OAAO,MAAM,EACb,eAA6B,WAM7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,SAAS,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgKxD,CAAC"}

package/lib/typescript/src/types/google-consent-mode.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Google Consent Mode v2 parameters as defined by Google
+ * @see https://developers.google.com/tag-platform/security/guides/consent?consentmode=advanced
+ */
+export declare enum GoogleConsentParameter {
+    ANALYTICS_STORAGE = "analytics_storage",
+    AD_STORAGE = "ad_storage",
+    AD_USER_DATA = "ad_user_data",
+    AD_PERSONALIZATION = "ad_personalization"
+}
+/**
+ * Google Consent Mode v2 status values
+ */
+export declare enum GoogleConsentStatus {
+    GRANTED = "granted",
+    DENIED = "denied"
+}
+/**
+ * Immutable consent map that provides Google Consent Mode v2 parameters
+ * with their corresponding status values and helper methods.
+ */
+export interface GoogleConsentMap {
+    readonly consentMap: Record<GoogleConsentParameter, GoogleConsentStatus>;
+    /**
+     * Convert the consent map to a string-based record for easier Firebase integration
+     * @returns Object with string keys and string values
+     */
+    toStringMap(): Record<string, string>;
+    /**
+     * Check if analytics storage consent is granted
+     * @returns true if analytics_storage is granted
+     */
+    isAnalyticsStorageGranted(): boolean;
+    /**
+     * Check if ad storage consent is granted
+     * @returns true if ad_storage is granted
+     */
+    isAdStorageGranted(): boolean;
+    /**
+     * Check if ad user data consent is granted
+     * @returns true if ad_user_data is granted
+     */
+    isAdUserDataGranted(): boolean;
+    /**
+     * Check if ad personalization consent is granted
+     * @returns true if ad_personalization is granted
+     */
+    isAdPersonalizationGranted(): boolean;
+}
+/**
+ * Callback function type for Google Consent Mode updates
+ *
+ * This callback is triggered whenever consent status changes and provides
+ * the Google Consent Mode v2 parameters in a format ready for Firebase integration.
+ *
+ * @param consentMap - Object containing the four Google Consent Mode v2 parameters:
+ *   - "analytics_storage": "granted" or "denied"
+ *   - "ad_storage": "granted" or "denied"
+ *   - "ad_user_data": "granted" or "denied"
+ *   - "ad_personalization": "granted" or "denied"
+ */
+export interface GoogleConsentModeCallback {
+    (consentMap: Record<string, string>): void;
+}
+/**
+ * Concrete implementation of GoogleConsentMap interface
+ */
+export declare class GoogleConsentMapImpl implements GoogleConsentMap {
+    readonly consentMap: Record<GoogleConsentParameter, GoogleConsentStatus>;
+    constructor(consentMap: Record<GoogleConsentParameter, GoogleConsentStatus>);
+    toStringMap(): Record<string, string>;
+    isAnalyticsStorageGranted(): boolean;
+    isAdStorageGranted(): boolean;
+    isAdUserDataGranted(): boolean;
+    isAdPersonalizationGranted(): boolean;
+}
+//# sourceMappingURL=google-consent-mode.d.ts.map

package/lib/typescript/src/types/google-consent-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-consent-mode.d.ts","sourceRoot":"","sources":["../../../../src/types/google-consent-mode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,sBAAsB;IACjC,iBAAiB,sBAAsB;IACvC,UAAU,eAAe;IACzB,YAAY,iBAAiB;IAC7B,kBAAkB,uBAAuB;CACzC;AAED;;GAEG;AACH,oBAAY,mBAAmB;IAC9B,OAAO,YAAY;IACnB,MAAM,WAAW;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,sBAAsB,EAAE,mBAAmB,CAAC,CAAC;IAEzE;;;OAGG;IACH,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC;;;OAGG;IACH,yBAAyB,IAAI,OAAO,CAAC;IAErC;;;OAGG;IACH,kBAAkB,IAAI,OAAO,CAAC;IAE9B;;;OAGG;IACH,mBAAmB,IAAI,OAAO,CAAC;IAE/B;;;OAGG;IACH,0BAA0B,IAAI,OAAO,CAAC;CACtC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,yBAAyB;IACzC,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,sBAAsB,EAAE,mBAAmB,CAAC,CAAC;gBAE7D,UAAU,EAAE,MAAM,CAAC,sBAAsB,EAAE,mBAAmB,CAAC;IAK3E,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAUrC,yBAAyB,IAAI,OAAO;IAOpC,kBAAkB,IAAI,OAAO;IAO7B,mBAAmB,IAAI,OAAO;IAO9B,0BAA0B,IAAI,OAAO;CAMrC"}

package/lib/typescript/src/utils/Color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../../../../src/utils/Color.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,kCAEP,MAAM,KACnB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,CA6C9C,CAAC;AAEF,eAAO,MAAM,WAAW,YAAa,MAAM,EAAE,aACN,CAAC;AACxC,eAAO,MAAM,cAAc,YAAa,MAAM,EAAE,WAIqB,CAAC;AAEtE,eAAO,MAAM,QAAQ,MAAO,MAAM,WAA4B,CAAC;AAG/D,eAAO,MAAM,aAAa,MAAO,MAAM,WAAsC,CAAC;AAC9E,eAAO,MAAM,gBAAgB,YAAa,MAAM,EAAE,WAIhD,CAAC;AAEH,eAAO,MAAM,WAAW,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,OAAO,MAAM,UAKvE,CAAC;AAEF,eAAO,MAAM,mBAAmB,MAC5B,MAAM,KACN,MAAM,KACN,MAAM,OACJ,MAAM,WACsC,CAAC;AACnD,eAAO,MAAM,kBAAkB,QACzB,MAAM,GAAG,MAAM,EAAE,cACV,MAAM,WAsClB,CAAC;AAEF,eAAO,MAAM,MAAM,QAAS,MAAM,GAAG,MAAM,EAAE,OAAO,MAAM,WAC5B,CAAC;AAC/B,eAAO,MAAM,OAAO,QAAS,MAAM,GAAG,MAAM,EAAE,OAAO,MAAM,WAC9B,CAAC"}
+{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../../../../src/utils/Color.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,GACtB,cAAU,EACV,eAAe,MAAM,KACnB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,CA6C9C,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,GAAG,MAAM,MAAM,EAAE,aACN,CAAC;AACxC,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,MAAM,EAAE,WAIqB,CAAC;AAEtE,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,WAA4B,CAAC;AAG/D,eAAO,MAAM,aAAa,GAAI,GAAG,MAAM,WAAsC,CAAC;AAC9E,eAAO,MAAM,gBAAgB,GAAI,GAAG,MAAM,MAAM,EAAE,WAIhD,CAAC;AAEH,eAAO,MAAM,WAAW,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK,MAAM,UAKvE,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC/B,GAAG,MAAM,EACT,GAAG,MAAM,EACT,GAAG,MAAM,EACT,KAAK,MAAM,WACsC,CAAC;AACnD,eAAO,MAAM,kBAAkB,GAC9B,KAAK,MAAM,GAAG,MAAM,EAAE,EACtB,YAAY,MAAM,WAsClB,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,MAAM,WAC5B,CAAC;AAC/B,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,GAAG,MAAM,EAAE,EAAE,KAAK,MAAM,WAC9B,CAAC"}

package/lib/typescript/src/utils/EventEmitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../../../src/utils/EventEmitter.ts"],"names":[],"mappings":"AACA,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAW;gBAEhB,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;IAMpE,MAAM;CAGN;AAED,qBAAa,YAAY;IACxB,OAAO,CAAC,OAAO,CAAkC;IAEjD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;IAUpC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;IAUrC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAMtC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;CAOtC"}
+{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../../../src/utils/EventEmitter.ts"],"names":[],"mappings":"AACA,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAW;gBAEhB,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;IAMpE,MAAM;CAGN;AAED,qBAAa,YAAY;IACxB,OAAO,CAAC,OAAO,CAAkC;IAEjD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;IASpC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;IASrC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAMtC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;CAOtC"}

package/lib/typescript/src/utils/OsanoLogger.d.ts

@@ -0,0 +1,15 @@
+export declare class OsanoLogger {
+    private readonly TAG;
+    private isEnabled;
+    setEnabled(enabled: boolean): void;
+    getEnabled(): boolean;
+    error(message: string, error?: Error): void;
+    warn(message: string): void;
+    info(message: string): void;
+    debug(message: string): void;
+    verbose(message: string): void;
+    metric(name: string, durationMs: number): void;
+    log(message: string): void;
+}
+export declare const osanoLogger: OsanoLogger;
+//# sourceMappingURL=OsanoLogger.d.ts.map

package/lib/typescript/src/utils/OsanoLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OsanoLogger.d.ts","sourceRoot":"","sources":["../../../../src/utils/OsanoLogger.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,SAAS,CAAQ;IAEzB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,UAAU,IAAI,OAAO;IAIrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAS3C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAK9C,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAI1B;AAED,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/lib/typescript/src/utils/index.d.ts

@@ -3,4 +3,5 @@ export declare function get<TData, TPath extends string | string[], TDefault = G
 export declare function set(object: Record<string, any>, pathOrArray: string | string[], value: any): void;
 export declare function merge(object: Record<string, any>, ...sources: Record<string, any>[]): Record<string, any>;
 export declare function noop(): void;
+export { osanoLogger as OsanoLogger } from './OsanoLogger';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAW5C,wBAAgB,GAAG,CAClB,KAAK,EACL,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,EAC/B,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,EAErC,MAAM,EAAE,KAAK,EACb,WAAW,EAAE,KAAK,EAClB,YAAY,CAAC,EAAE,QAAQ,GACrB,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,QAAQ,CAOvC;AAED,wBAAgB,GAAG,CAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,EAC9B,KAAK,EAAE,GAAG,QAeV;AA2ED,wBAAgB,KAAK,CACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,GAAG,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,uBAGjC;AAED,wBAAgB,IAAI,SAAK"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAW5C,wBAAgB,GAAG,CAClB,KAAK,EACL,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,EAC/B,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,EAErC,MAAM,EAAE,KAAK,EACb,WAAW,EAAE,KAAK,EAClB,YAAY,CAAC,EAAE,QAAQ,GACrB,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,QAAQ,CAOvC;AAED,wBAAgB,GAAG,CAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,EAC9B,KAAK,EAAE,GAAG,QAeV;AA2ED,wBAAgB,KAAK,CACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,GAAG,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,uBAGjC;AAED,wBAAgB,IAAI,SAAK;AAEzB,OAAO,EAAE,WAAW,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@osano/osano-cmp-react-native",
-	"version": "0.11.0",
+	"version": "0.13.0",
 	"description": "Package and example for the react-native Osano CMP SDK",
 	"main": "lib/commonjs/index",
 	"module": "lib/module/index",
@@ -31,7 +31,8 @@
 	],
 	"scripts": {
 		"example": "yarn workspace osano-cmp-sdk-example",
-		"test": "jest src/services/__tests__/consent.test.ts src/__tests__/index.test.tsx",
+		"test": "jest src/services/__tests__/consent.test.ts src/__tests__/index.test.tsx src/services/__tests__/google-consent-mode.test.ts src/__tests__/OsanoLogger.test.ts",
+		"test:google-consent-mode": "jest src/services/__tests__/google-consent-mode.test.ts",
 		"typecheck": "tsc --noEmit",
 		"lint": "eslint \"**/*.{js,ts,tsx}\"",
 		"clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
@@ -64,6 +65,7 @@
 		"access": "public"
 	},
 	"devDependencies": {
+		"@biomejs/biome": "2.1.2",
 		"@commitlint/config-conventional": "^17.0.2",
 		"@docusaurus/core": "3.5.2",
 		"@docusaurus/module-type-aliases": "3.5.2",

package/src/ConsentManager.ts

@@ -1,5 +1,16 @@
-import type { Config, Mode, Palette } from './types/consent-config';
-import { EventEmitter, type EventSubscription } from './utils/EventEmitter';
+import { NativeModules, Platform } from 'react-native';
+import { CLEAR_CONSENT, SAVE_SUCCESS } from './actions';
+import { ConsentCategory, mappedJurisdictions } from './constants';
+import flavors, { defaultFlavor, type Flavor } from './flavors';
+import type { Store } from './hooks/useThunkReducer';
+import Tcf from './iab/tcf';
+import type {
+	GppVersionType,
+	TcfController,
+	TcfVersionType,
+	Tcf_v2,
+	UspVersionType,
+} from './iab/tcf/types';
 import type {
 	GvlVendor_v2,
 	GvlVendor_v3,
@@ -7,30 +18,25 @@ import type {
 	IabFrameworkType,
 	IabState,
 } from './iab/types';
-import { NativeModules, Platform } from 'react-native';
+import { getDeviceId } from './native/OsanoCmp';
+import { getConsent } from './selectors';
 import {
 	clearConsent as clearStoredConsent,
 	fetchConfig,
 	fetchConsent,
+	getStoredConfig,
+	hasStaleConfig,
+	storeConfig,
 } from './services/consent';
-import flavors, { defaultFlavor, type Flavor } from './flavors';
-import { get, merge } from './utils';
+import { GoogleConsentModeMapper } from './services/google-consent-mode-mapper';
 import type { OsanoOverrides } from './types';
-import type {
-	GppVersionType,
-	TcfController,
-	TcfVersionType,
-	Tcf_v2,
-	UspVersionType,
-} from './iab/tcf/types';
-import Tcf from './iab/tcf';
-import Translator from './utils/Translator';
-import { ConsentCategory, mappedJurisdictions } from './constants';
-import { getDeviceId } from './native/OsanoCmp';
-import type { Store } from './hooks/useThunkReducer';
+import type { Config, Mode, Palette } from './types/consent-config';
+import type { GoogleConsentModeCallback } from './types/google-consent-mode';
 import type { OsanoAction, OsanoState } from './types/store';
-import { CLEAR_CONSENT, SAVE_SUCCESS } from './actions';
-import { getConsent } from './selectors';
+import { get, merge } from './utils';
+import { EventEmitter, type EventSubscription } from './utils/EventEmitter';
+import { osanoLogger as OsanoLogger } from './utils/OsanoLogger';
+import Translator from './utils/Translator';
 
 const CONFIG_ID_ERROR = new Error('customerId and configId must be set');
 const CONFIG_NOT_FOUND_ERROR = new Error('Config not found');
@@ -137,6 +143,43 @@ const migrateIabConfig = (
 
 const emptyArray: never[] = [];
 
+async function fetchConfigWithRetries(
+	customerId: string,
+	configId: string,
+	retries: number = 3,
+	delay: number = 500,
+): Promise<Config | null> {
+	const isStale = await hasStaleConfig(configId);
+
+	if (!isStale) {
+		// If the config is not stale, we can return the cached config
+		const cachedConfig = await getStoredConfig(configId);
+
+		if (cachedConfig) {
+			return cachedConfig;
+		}
+	}
+
+	for (let attempt = 1; attempt <= retries; attempt++) {
+		try {
+			const config = await fetchConfig(customerId, configId);
+			return config;
+		} catch (error) {
+			if (attempt < retries) {
+				OsanoLogger.warn(
+					`Attempt ${attempt} failed. Retrying in ${delay}ms...`,
+				);
+				await new Promise((resolve) => setTimeout(resolve, delay));
+				delay *= 2; // Exponential backoff
+			} else {
+				throw error;
+			}
+		}
+	}
+
+	return null;
+}
+
 export class ConsentConfig extends EventEmitter {
 	private _config: Config;
 	private _customerId: string;
@@ -154,7 +197,7 @@ export class ConsentConfig extends EventEmitter {
 			this.emit('loadFailure', CONFIG_ID_ERROR);
 			return;
 		}
-		return fetchConfig(this._customerId, this._configId)
+		return fetchConfigWithRetries(this._customerId, this._configId)
 			.then((config: Config | null) => {
 				if (!config || Object.keys(config).length === 0) {
 					throw CONFIG_NOT_FOUND_ERROR;
@@ -175,12 +218,16 @@ export class ConsentConfig extends EventEmitter {
 					config.palette,
 				) as Palette;
 				this._config = merge(this._config, config) as Config;
+				storeConfig(this._configId, this._config);
 				this.emit('loadSuccess', this._config);
 			})
 			.catch((err) => {
 				this.emit('loadFailure', err);
 			});
 	}
+	get config(): Config {
+		return this._config;
+	}
 	set customerId(value: string) {
 		this._customerId = value || this._customerId;
 	}
@@ -575,6 +622,7 @@ export class ConsentManager {
 	private _consent?: ConsentCategory[];
 	private _translator: Translator = new Translator(this);
 	private _overridePalette?: Palette;
+	private _googleConsentModeCallback?: GoogleConsentModeCallback;
 
 	private _deviceId = '';
 	public get deviceId(): string {
@@ -629,7 +677,10 @@ export class ConsentManager {
 				try {
 					getDeviceId().then(setDeviceId);
 				} catch (err) {
-					console.log(`Error getting device id: ${err}`);
+					OsanoLogger.error(
+						`Error getting device id: ${err}`,
+						err instanceof Error ? err : undefined,
+					);
 				}
 				this._locale = NativeModules.I18nManager.localeIdentifier;
 				break;
@@ -638,7 +689,10 @@ export class ConsentManager {
 				try {
 					getDeviceId().then(setDeviceId);
 				} catch (err) {
-					console.log(`Error getting device id: ${err}`);
+					OsanoLogger.error(
+						`Error getting device id: ${err}`,
+						err instanceof Error ? err : undefined,
+					);
 				}
 				this._locale =
 					NativeModules.SettingsManager.settings.AppleLanguages[0] || //iOS 13
@@ -742,6 +796,7 @@ export class ConsentManager {
 							})
 							.then((consent) => {
 								this.consent = consent;
+								this.triggerGoogleConsentUpdate(consent);
 								return this._translator
 									.load(locale, onLangLoadSuccess, onLangLoadFailure)
 									.then((results) => {
@@ -806,6 +861,60 @@ export class ConsentManager {
 		return this._consent?.includes(category) ?? false;
 	}
 
+	/**
+	 * Set the Google Consent Mode callback function
+	 *
+	 * @param callback - Function to call when consent updates occur
+	 * @returns this ConsentManager instance for method chaining
+	 */
+	public setGoogleConsentModeCallback(
+		callback: GoogleConsentModeCallback,
+	): this {
+		this._googleConsentModeCallback = callback;
+		return this;
+	}
+
+	/**
+	 * Trigger Google Consent Mode update with current consent categories
+	 *
+	 * @param categories - Array of consent categories that have been granted
+	 * @public
+	 */
+	public triggerGoogleConsentUpdate(categories: ConsentCategory[]): void {
+		if (!this._config.googleConsent) {
+			OsanoLogger.debug('Google Consent Mode: disabled in configuration');
+			return;
+		}
+
+		if (!this._googleConsentModeCallback) {
+			OsanoLogger.debug('Google Consent Mode: callback not set');
+			return;
+		}
+
+		try {
+			OsanoLogger.debug(
+				`Google Consent Mode: triggering callback with categories: ${JSON.stringify(categories)}`,
+			);
+
+			const categorySet = new Set(categories);
+			const googleConsentMap =
+				GoogleConsentModeMapper.buildGoogleConsentMap(categorySet);
+
+			const consentStringMap = googleConsentMap.toStringMap();
+
+			OsanoLogger.debug(
+				`Google Consent Mode: consent map: ${JSON.stringify(consentStringMap)}`,
+			);
+			this._googleConsentModeCallback(consentStringMap);
+			OsanoLogger.debug('Google Consent Mode: callback executed successfully');
+		} catch (error) {
+			OsanoLogger.warn(
+				`Google Consent Mode: Error triggering callback: ${error}`,
+			);
+			// Don't re-throw - callback errors shouldn't break consent flow
+		}
+	}
+
 	public get loaded(): boolean {
 		return this._loaded;
 	}

package/src/ConsentUiBuilder.tsx

@@ -1,25 +1,26 @@
+import React, { useCallback, useEffect, useMemo } from 'react';
+import { StyleSheet, View } from 'react-native';
 import {
 	type GetState,
 	type MiddlewareNext,
 	type Store,
 	type ThunkDispatch,
 } from './hooks/useThunkReducer';
+import type { GoogleConsentModeCallback } from './types/google-consent-mode';
 import { type OsanoAction, type OsanoState } from './types/store';
-import React, { useCallback, useEffect, useMemo } from 'react';
-import { StyleSheet, View } from 'react-native';
 
+import { setConfig } from './actions';
 import { ConsentManager } from './ConsentManager';
-import { Dialog } from './views/Dialog';
-import { Drawer } from './views/Drawer';
 import { OsanoPrivateContext } from './context';
 import { createSharedStyles } from './styles';
-import { setConfig } from './actions';
+import { Dialog } from './views/Dialog';
+import { Drawer } from './views/Drawer';
 
 export const ConsentUiBuilder: React.FC<{
 	addMiddleware: (
 		m: (
-			store: Store<OsanoState, OsanoAction>
-		) => (next: MiddlewareNext<OsanoAction>) => MiddlewareNext<OsanoAction>
+			store: Store<OsanoState, OsanoAction>,
+		) => (next: MiddlewareNext<OsanoAction>) => MiddlewareNext<OsanoAction>,
 	) => void;
 	cmp: React.MutableRefObject<ConsentManager>;
 	dispatch: ThunkDispatch<OsanoState, OsanoAction, any>;
@@ -27,8 +28,8 @@ export const ConsentUiBuilder: React.FC<{
 	hideDisclosures: boolean;
 	removeMiddleware: (
 		m: (
-			store: Store<OsanoState, OsanoAction<any, any>>
-		) => (next: MiddlewareNext<OsanoAction>) => MiddlewareNext<OsanoAction>
+			store: Store<OsanoState, OsanoAction<any, any>>,
+		) => (next: MiddlewareNext<OsanoAction>) => MiddlewareNext<OsanoAction>,
 	) => void;
 }> = (props): React.ReactElement<View> => {
 	const {
@@ -45,16 +46,23 @@ export const ConsentUiBuilder: React.FC<{
 		(
 			path: string | string[],
 			translationProps = {},
-			defaultPhrase?: string
+			defaultPhrase?: string,
 		) => {
 			const translated = cmp.current.translator.translate(
 				path,
 				translationProps,
-				defaultPhrase
+				defaultPhrase,
 			);
 			return translated;
 		},
-		[cmp]
+		[cmp],
+	);
+
+	const setGoogleConsentModeCallback = useCallback(
+		(callback: GoogleConsentModeCallback) => {
+			cmp.current.setGoogleConsentModeCallback(callback);
+		},
+		[cmp],
 	);
 
 	const privateContext = useMemo(() => {
@@ -71,6 +79,7 @@ export const ConsentUiBuilder: React.FC<{
 			locale: cmp.current.translator.locale,
 			sharedStyles: createSharedStyles(cmp.current.config || {}),
 			stack,
+			setGoogleConsentModeCallback,
 		};
 	}, [
 		addMiddleware,
@@ -82,6 +91,7 @@ export const ConsentUiBuilder: React.FC<{
 		handleTranslate,
 		getState,
 		stack,
+		setGoogleConsentModeCallback,
 	]);
 
 	// Update our store with the config when CMP loads or config changes
@@ -92,7 +102,7 @@ export const ConsentUiBuilder: React.FC<{
 					config: cmp.current.config,
 					customerId: cmp.current.customerId,
 					configId: cmp.current.configId,
-				})
+				}),
 			);
 		}
 	}, [cmp, dispatch, cmp.current.loaded, cmp.current.config]);