@osano/osano-cmp-react-native 0.17.0 → 0.17.1

package/README.dev.md

@@ -396,6 +396,136 @@ const {
 } = React.useContext(OsanoContext);
 ```
 
+#### Internal Developer API Reference
+
+The following methods are exposed through the `OsanoContext` for internal development and debugging:
+
+##### `getConsent(category?: ConsentCategory): boolean | ConsentCategory[]`
+
+**Internal Implementation Details:**
+- Delegates to `consentManager.current.hasConsent(category)` for specific category checks
+- Returns `consentManager.current.consent ?? [ConsentCategory.ESSENTIAL]` for all categories
+- Backed by the `getConsent` selector in `src/selectors.ts` which reads from `state.consent`
+- State is managed through the reducer pattern with thunk middleware
+
+```js
+// Development usage examples:
+const analyticsConsent = getConsent('ANALYTICS'); // boolean check
+const allCategories = getConsent(); // array of consented categories
+
+// Available categories from src/constants.ts:
+// ESSENTIAL, ANALYTICS, MARKETING, PERSONALIZATION, OPT_OUT, STORAGE
+```
+
+##### `clearConsent(): void`
+
+**Internal Implementation Details:**
+- Dispatches `CLEAR_CONSENT` action to reset state
+- Triggers Google Consent Mode update with only `ConsentCategory.ESSENTIAL`
+- Clears both local storage and remote consent records
+- Implemented in `handleClearConsent` with `useCallback` optimization
+
+```js
+// Development debugging:
+clearConsent(); // Resets to clean slate for testing
+```
+
+##### `getDeviceId(): string`
+
+**Internal Implementation Details:**
+- Returns `consentManager.current.deviceId` property
+- Device ID is fetched asynchronously via native module in `src/native/OsanoCmp.ts`
+- Used for cross-device consent tracking and analytics correlation
+- Persisted across app sessions for consistent identification
+
+```js
+// Development debugging:
+const deviceId = getDeviceId();
+console.log(`[DevDebug] Device ID: ${deviceId}`);
+```
+
+##### `locale: string`
+
+**Internal Implementation Details:**
+- Read from `consentManager.current.translator.locale`
+- Managed by the `Translator` class in `src/utils/Translator.ts`
+- Default is `Translator.DEFAULT_LANGUAGE` ('en')
+- Triggers UI re-renders when changed via dependency array
+
+```js
+// Development debugging:
+console.log(`[DevDebug] Current locale: ${locale}`);
+```
+
+##### `setLocale(locale: string): void`
+
+**Internal Implementation Details:**
+- Calls `consentManager.current.translator.load()` with success/failure callbacks
+- Dispatches `setLocale(value)` action on successful load
+- Uses exponential backoff retry logic for network failures
+- Locale files fetched from `env.LOCALE_URI` endpoint
+
+```js
+// Development testing:
+setLocale('es'); // Test Spanish localization
+setLocale('invalid'); // Test error handling
+```
+
+##### `showBanner(): void`
+
+**Internal Implementation Details:**
+- Uses `retryWithBackoff` helper with 3 retries and exponential delay (100ms base)
+- Dispatches `showDialog()` thunk action
+- Checks `consentManager.current.loaded` state before execution
+- Geographic location determines UI variant and timeout behavior
+
+```js
+// Development debugging:
+try {
+  showBanner();
+} catch (error) {
+  console.log('[DevDebug] Banner show failed:', error);
+}
+```
+
+##### `showDrawer(): void`
+
+**Internal Implementation Details:**
+- Similar retry logic to `showBanner()` but dispatches `showDrawer()` thunk
+- No automatic timeout - requires explicit user interaction
+- Renders all consent categories with toggle controls
+- State managed through drawer stack in `state.stack`
+
+```js
+// Development testing:
+showDrawer(); // Always requires user interaction to dismiss
+```
+
+##### `isReady: boolean`
+
+**Internal Implementation Details:**
+- Reflects `consentManager.current.loaded` property
+- Set to `true` after successful config loading in `ConsentManager.load()`
+- Dependency in `useMemo` for context value - triggers re-renders
+- Critical for preventing race conditions in consent operations
+
+```js
+// Development pattern:
+useEffect(() => {
+  if (isReady) {
+    console.log('[DevDebug] SDK ready for operations');
+    // Safe to call other methods
+  }
+}, [isReady]);
+```
+
+**Development Notes:**
+- All methods use `useCallback` for performance optimization
+- State management follows Redux-like pattern with actions and reducers
+- Native bridge communication handled through `react-native` `NativeModules`
+- Error boundaries should wrap components using these methods
+- Testing with both Legacy and New Architecture supported via test scripts
+
 ### UI Builder
 
 Now that you have created an instance of the `ConsentManager`, you can

package/README.md

@@ -1,3 +1,3 @@
 # Osano CMP SDK for React Native
 
-Visit the [Developer Docs](https://developers.osano.com/cmp/react-native/) to learn more about installation and usage.
+Visit the [Developer Docs](https://developers.osano.com/cmp/mobile-sdks/react-native/) to learn more about installation and usage.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@osano/osano-cmp-react-native",
-	"version": "0.17.0",
+	"version": "0.17.1",
 	"description": "Package and example for the react-native Osano CMP SDK",
 	"main": "lib/commonjs/index",
 	"module": "lib/module/index",
@@ -41,7 +41,7 @@
 		"update:locale": "node ./scripts/updateLocalization.js",
 		"prepare": "bob build",
 		"release": "release-it",
-		"release:prod": "release-it minor --no-git --ci -VV",
+		"release:prod": "release-it --no-increment --no-git --ci -VV",
 		"doc:start": "docusaurus start ./documentation",
 		"doc:build": "docusaurus build ./documentation",
 		"doc:clear": "docusaurus clear ./documentation",
@@ -54,14 +54,14 @@
 	],
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/osano/osano-consentmgr-react-native.git"
+		"url": ""
 	},
 	"author": "Osano (A Public Benefit Company) <engineering@osano.com> (https://www.osano.com)",
 	"license": "UNLICENSED",
 	"bugs": {
 		"url": "https://github.com/osano/osano-consentmgr-react-native/issues"
 	},
-	"homepage": "https://github.com/osano/osano-consentmgr-react-native#readme",
+	"homepage": "https://developers.osano.com/cmp/mobile-sdks/",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/",
 		"access": "public"
@@ -135,11 +135,21 @@
 		]
 	},
 	"release-it": {
+		"git": {
+			"requireBranch": false,
+			"commit": false,
+			"tag": false,
+			"push": false
+		},
 		"npm": {
-			"publish": true
+			"publish": true,
+			"versionArgs": "--no-git-tag-version"
 		},
 		"github": {
 			"release": false
+		},
+		"hooks": {
+			"before:init": "echo 'Using version from package.json: ${version}'"
 		}
 	},
 	"react-native-builder-bob": {