@octopus-community/react-native 1.0.7 → 1.9.1

package/lib/module/addNavigateToUrlListener.js

@@ -0,0 +1,41 @@
+"use strict";
+
+import { eventEmitter } from "./internals/eventEmitter.js";
+import { OctopusReactNativeSdk } from "./internals/nativeModule.js";
+import { UrlOpeningStrategy as UrlOpeningStrategyEnum } from "./types/urlOpeningStrategy.js";
+/**
+ * Adds a listener for URL navigation events from the Octopus Community UI.
+ *
+ * Only has an effect when the UI was opened with `openUI({ interceptUrls: true })`.
+ * When the user taps a link, this callback is invoked with the URL. Return
+ * `handledByApp` if your app handles the URL (e.g. in-app web view), or
+ * `handledByOctopus` to let the SDK open it in the system browser.
+ *
+ * @param callback - Function called with the tapped URL. Can be async.
+ *   Return `UrlOpeningStrategy.handledByApp` or `UrlOpeningStrategy.handledByOctopus`.
+ * @returns A subscription object with a `remove()` method to unsubscribe.
+ *
+ * @example
+ * ```typescript
+ * const subscription = addNavigateToUrlListener(async (url) => {
+ *   if (url.startsWith('https://myapp.com/')) {
+ *     // Handle deep link in-app
+ *     Linking.openURL(url);
+ *     return UrlOpeningStrategy.handledByApp;
+ *   }
+ *   return UrlOpeningStrategy.handledByOctopus; // Open in system browser
+ * });
+ *
+ * // Later, to unsubscribe:
+ * subscription.remove();
+ * ```
+ */
+export function addNavigateToUrlListener(callback) {
+  return eventEmitter.addListener('navigateToUrl', async data => {
+    const strategy = await Promise.resolve(callback(data.url));
+    if (strategy === UrlOpeningStrategyEnum.handledByOctopus) {
+      OctopusReactNativeSdk.handleUrlStrategy(data.url, UrlOpeningStrategyEnum.handledByOctopus);
+    }
+  });
+}
+//# sourceMappingURL=addNavigateToUrlListener.js.map

package/lib/module/addNavigateToUrlListener.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["eventEmitter","OctopusReactNativeSdk","UrlOpeningStrategy","UrlOpeningStrategyEnum","addNavigateToUrlListener","callback","addListener","data","strategy","Promise","resolve","url","handledByOctopus","handleUrlStrategy"],"sourceRoot":"../../src","sources":["addNavigateToUrlListener.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,6BAA0B;AACvD,SAASC,qBAAqB,QAAQ,6BAA0B;AAChE,SAEEC,kBAAkB,IAAIC,sBAAsB,QACvC,+BAA4B;AAMnC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,wBAAwBA,CACtCC,QAAuC,EACvC;EACA,OAAOL,YAAY,CAACM,WAAW,CAC7B,eAAe,EACf,MAAOC,IAAqB,IAAK;IAC/B,MAAMC,QAAQ,GAAG,MAAMC,OAAO,CAACC,OAAO,CAACL,QAAQ,CAACE,IAAI,CAACI,GAAG,CAAC,CAAC;IAC1D,IAAIH,QAAQ,KAAKL,sBAAsB,CAACS,gBAAgB,EAAE;MACxDX,qBAAqB,CAACY,iBAAiB,CACrCN,IAAI,CAACI,GAAG,EACRR,sBAAsB,CAACS,gBACzB,CAAC;IACH;EACF,CACF,CAAC;AACH","ignoreList":[]}

package/lib/module/addNotSeenNotificationsCountListener.js

@@ -0,0 +1,30 @@
+"use strict";
+
+import { eventEmitter } from "./internals/eventEmitter.js";
+/**
+ * Adds a listener for not seen notifications count changes.
+ *
+ * This listener is triggered whenever the count of unseen notifications changes.
+ * The count is automatically updated by the SDK, but can also be manually refreshed
+ * using `updateNotSeenNotificationsCount()`.
+ *
+ * @param callback - Function called when the notification count changes
+ * @returns A subscription object with a `remove()` method to unsubscribe
+ *
+ * @example
+ * ```typescript
+ * const subscription = addNotSeenNotificationsCountListener((count) => {
+ *   console.log(`Unseen notifications: ${count}`);
+ *   // Update your app's badge or UI
+ * });
+ *
+ * // Later, to unsubscribe:
+ * subscription.remove();
+ * ```
+ */
+export function addNotSeenNotificationsCountListener(callback) {
+  return eventEmitter.addListener('notSeenNotificationsCountChanged', data => {
+    callback(data.count);
+  });
+}
+//# sourceMappingURL=addNotSeenNotificationsCountListener.js.map

package/lib/module/addNotSeenNotificationsCountListener.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["eventEmitter","addNotSeenNotificationsCountListener","callback","addListener","data","count"],"sourceRoot":"../../src","sources":["addNotSeenNotificationsCountListener.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,6BAA0B;AAIvD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,oCAAoCA,CAClDC,QAAmD,EACnD;EACA,OAAOF,YAAY,CAACG,WAAW,CAC7B,kCAAkC,EACjCC,IAAuB,IAAK;IAC3BF,QAAQ,CAACE,IAAI,CAACC,KAAK,CAAC;EACtB,CACF,CAAC;AACH","ignoreList":[]}

package/lib/module/addSDKEventListener.js

@@ -0,0 +1,48 @@
+"use strict";
+
+import { eventEmitter } from "./internals/eventEmitter.js";
+/**
+ * Adds a listener for SDK events.
+ *
+ * This listener receives all SDK events including:
+ * - Content creation (posts, comments, replies)
+ * - Content deletion
+ * - Reactions and interactions
+ * - Gamification events
+ * - Screen navigation
+ * - Profile modifications
+ * - Session events
+ * - And more...
+ *
+ * Use TypeScript type guards to narrow down specific event types:
+ *
+ * @param callback - Function called when any SDK event occurs
+ * @returns A subscription object with a `remove()` method to unsubscribe
+ *
+ * @example
+ * ```typescript
+ * const subscription = addSDKEventListener((event) => {
+ *   switch (event.type) {
+ *     case 'postCreated':
+ *       console.log(`Post created: ${event.postId}`);
+ *       break;
+ *     case 'reactionModified':
+ *       console.log(`Reaction changed on ${event.contentId}`);
+ *       break;
+ *     case 'gamificationPointsGained':
+ *       console.log(`Gained ${event.points} points for ${event.action}`);
+ *       break;
+ *     // ... handle other event types
+ *   }
+ * });
+ *
+ * // Later, to unsubscribe:
+ * subscription.remove();
+ * ```
+ */
+export function addSDKEventListener(callback) {
+  return eventEmitter.addListener('sdkEvent', data => {
+    callback(data);
+  });
+}
+//# sourceMappingURL=addSDKEventListener.js.map

package/lib/module/addSDKEventListener.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["eventEmitter","addSDKEventListener","callback","addListener","data"],"sourceRoot":"../../src","sources":["addSDKEventListener.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,6BAA0B;AAKvD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAACC,QAAkC,EAAE;EACtE,OAAOF,YAAY,CAACG,WAAW,CAAC,UAAU,EAAGC,IAAc,IAAK;IAC9DF,QAAQ,CAACE,IAAI,CAAC;EAChB,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/module/connectUser.js

@@ -4,9 +4,30 @@ import { OctopusReactNativeSdk } from "./internals/nativeModule.js";
 /**
  * Connects a user using SSO authentication.
  *
- * This function establishes a connection between your app's user and Octopus.
- * It requires that you have configured SSO mode during SDK initialization
- * and have set up a token provider using `useUserTokenProvider` or `addUserTokenRequestListener`.
+ * This function establishes a connection between your app's user and Octopus. It requires that you
+ * have configured SSO mode during SDK initialization and have set up a token provider using
+ * `useUserTokenProvider` or `addUserTokenRequestListener`. The token is obtained via your token
+ * provider; you do not pass it directly to `connectUser`. Call `connectUser` after the user logs in;
+ * call `disconnectUser` when they log out.
+ *
+ * @param params - User id and optional profile (username, profilePicture, biography). See {@link ConnectUserParams}.
+ * @returns A promise that resolves when the user is connected. Rejects if the SDK is not initialized,
+ *          SSO is not configured, or the token provider fails.
+ * @see {@link useUserTokenProvider} – provide JWT from React components.
+ * @see {@link addUserTokenRequestListener} – provide JWT without React.
+ * @see {@link disconnectUser} – disconnect the current user.
+ *
+ * @example
+ * ```typescript
+ * await connectUser({
+ *   userId: 'unique-user-id-from-your-backend',
+ *   profile: {
+ *     username: 'john_doe',
+ *     profilePicture: 'https://example.com/avatar.jpg',
+ *     biography: 'Software developer'
+ *   }
+ * });
+ * ```
  */
 export function connectUser(params) {
   return OctopusReactNativeSdk.connectUser(params);

package/lib/module/connectUser.js.map

@@ -1 +1 @@
-{"version":3,"names":["OctopusReactNativeSdk","connectUser","params"],"sourceRoot":"../../src","sources":["connectUser.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,6BAA0B;AAwBhE;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAACC,MAAyB,EAAiB;EACpE,OAAOF,qBAAqB,CAACC,WAAW,CAACC,MAAM,CAAC;AAClD","ignoreList":[]}
+{"version":3,"names":["OctopusReactNativeSdk","connectUser","params"],"sourceRoot":"../../src","sources":["connectUser.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,6BAA0B;AAmBhE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAACC,MAAyB,EAAiB;EACpE,OAAOF,qBAAqB,CAACC,WAAW,CAACC,MAAM,CAAC;AAClD","ignoreList":[]}

package/lib/module/index.js

@@ -5,11 +5,23 @@ export * from "./openUI.js";
 export * from "./closeUI.js";
 export * from "./connectUser.js";
 export * from "./disconnectUser.js";
+export * from "./trackCustomEvent.js";
+export * from "./overrideDefaultLocale.js";
+export * from "./updateNotSeenNotificationsCount.js";
+export * from "./overrideCommunityAccess.js";
+export * from "./trackCommunityAccess.js";
 export * from "./addUserTokenRequestListener.js";
 export * from "./useUserTokenProvider.js";
 export * from "./addLoginRequiredListener.js";
 export * from "./addEditUserListener.js";
+export * from "./addNotSeenNotificationsCountListener.js";
+export * from "./addHasAccessToCommunityListener.js";
+export * from "./addSDKEventListener.js";
+export * from "./addNavigateToUrlListener.js";
 export * from "./types/userProfileField.js";
+export * from "./types/sdkEvents.js";
+export * from "./types/urlOpeningStrategy.js";
 export * from "./logger.js";
 export * from "./enums/LogLevel.enum.js";
+export { OctopusUIView } from "./OctopusUIView.js";
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":[],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,cAAc,iBAAc;AAC5B,cAAc,aAAU;AACxB,cAAc,cAAW;AACzB,cAAc,kBAAe;AAC7B,cAAc,qBAAkB;AAChC,cAAc,kCAA+B;AAC7C,cAAc,2BAAwB;AACtC,cAAc,+BAA4B;AAC1C,cAAc,0BAAuB;AACrC,cAAc,6BAA0B;AACxC,cAAc,aAAU;AACxB,cAAc,0BAAuB","ignoreList":[]}
+{"version":3,"names":["OctopusUIView"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,cAAc,iBAAc;AAC5B,cAAc,aAAU;AACxB,cAAc,cAAW;AACzB,cAAc,kBAAe;AAC7B,cAAc,qBAAkB;AAChC,cAAc,uBAAoB;AAClC,cAAc,4BAAyB;AACvC,cAAc,sCAAmC;AACjD,cAAc,8BAA2B;AACzC,cAAc,2BAAwB;AACtC,cAAc,kCAA+B;AAC7C,cAAc,2BAAwB;AACtC,cAAc,+BAA4B;AAC1C,cAAc,0BAAuB;AACrC,cAAc,2CAAwC;AACtD,cAAc,sCAAmC;AACjD,cAAc,0BAAuB;AACrC,cAAc,+BAA4B;AAC1C,cAAc,6BAA0B;AACxC,cAAc,sBAAmB;AACjC,cAAc,+BAA4B;AAC1C,cAAc,aAAU;AACxB,cAAc,0BAAuB;AACrC,SAASA,aAAa,QAAQ,oBAAiB","ignoreList":[]}

package/lib/module/initialize.js

@@ -33,6 +33,10 @@ import { parseFontConfig } from "./internals/fontParser.js";
  * 2. Dual mode colors - separate color sets for light and dark modes
  */
 
+/**
+ * UI customization options for platform-specific layout adjustments.
+ */
+
 /**
  * Configuration params for initializing the Octopus SDK.
  */
@@ -40,26 +44,23 @@ import { parseFontConfig } from "./internals/fontParser.js";
 /**
  * Initializes the Octopus SDK with the provided configuration.
  *
- * This function must be called before using any other Octopus SDK features.
- * It sets up the SDK with your API key and configures the authentication mode.
+ * This function must be called before using any other Octopus SDK features. It sets up the SDK
+ * with your API key, connection mode (SSO or Octopus-managed authentication), and optional theme
+ * and UI options. For SSO, you also need to set up a token provider with `useUserTokenProvider` or
+ * `addUserTokenRequestListener` before calling `connectUser`.
+ *
+ * @param params - See {@link InitializeParams} (including `theme`, `ui`). For theming guide see the main README.
+ * @see {@link connectUser} – connect a user after initialization (SSO mode).
  *
  * @example
  * ```typescript
- * // Initialize with SSO mode
  * await initialize({
  *   apiKey: 'your-api-key',
- *   connectionMode: {
- *     type: 'sso',
- *     appManagedFields: ['username', 'profilePicture']
- *   }
+ *   connectionMode: { type: 'sso', appManagedFields: ['username', 'profilePicture'] }
  * });
- *
- * // Initialize with Octopus authentication
  * await initialize({
  *   apiKey: 'your-api-key',
- *   connectionMode: {
- *     type: 'octopus'
- *   }
+ *   connectionMode: { type: 'octopus' }
  * });
  * ```
  */

package/lib/module/initialize.js.map

@@ -1 +1 @@
-{"version":3,"names":["OctopusReactNativeSdk","Appearance","colorSchemeManager","parseFontConfig","initialize","params","colorScheme","getColorScheme","processedTheme","theme","fonts","parsedConfig","undefined","paramsWithColorScheme","setTheme","startListening"],"sourceRoot":"../../src","sources":["initialize.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,6BAA0B;AAGhE,SAASC,UAAU,QAAQ,cAAc;AACzC,SAASC,kBAAkB,QAAQ,mCAAgC;AACnE,SAASC,eAAe,QAA+B,2BAAwB;;AAE/E;AACA;AACA;;AAYA;AACA;AACA;;AAGA;AACA;AACA;;AAMA;AACA;AACA;;AAQA;AACA;AACA;;AA0BA;AACA;AACA;AACA;AACA;AACA;AACA;;AAyBA;AACA;AACA;;AAwBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,MAAwB,EAAiB;EAClE;EACA,MAAMC,WAAW,GAAGL,UAAU,CAACM,cAAc,CAAC,CAAC;;EAE/C;EACA,MAAMC,cAAc,GAAGH,MAAM,CAACI,KAAK,GAC/B;IACE,GAAGJ,MAAM,CAACI,KAAK;IACfC,KAAK,EAAEL,MAAM,CAACI,KAAK,CAACC,KAAK,GACrB;MACE,GAAGL,MAAM,CAACI,KAAK,CAACC,KAAK;MACrBC,YAAY,EAAER,eAAe,CAACE,MAAM,CAACI,KAAK,CAACC,KAAK;IAClD,CAAC,GACDE;EACN,CAAC,GACDA,SAAS;EAEb,MAAMC,qBAAqB,GAAG;IAC5B,GAAGR,MAAM;IACTI,KAAK,EAAED,cAAc;IACrBF,WAAW,EAAEA,WAAW,IAAIM;EAC9B,CAAC;;EAED;EACAV,kBAAkB,CAACY,QAAQ,CAACN,cAAc,IAAI,IAAI,CAAC;;EAEnD;EACAN,kBAAkB,CAACa,cAAc,CAAC,CAAC;EAEnC,OAAOf,qBAAqB,CAACI,UAAU,CAACS,qBAAqB,CAAC;AAChE","ignoreList":[]}
+{"version":3,"names":["OctopusReactNativeSdk","Appearance","colorSchemeManager","parseFontConfig","initialize","params","colorScheme","getColorScheme","processedTheme","theme","fonts","parsedConfig","undefined","paramsWithColorScheme","setTheme","startListening"],"sourceRoot":"../../src","sources":["initialize.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,6BAA0B;AAGhE,SAASC,UAAU,QAAQ,cAAc;AACzC,SAASC,kBAAkB,QAAQ,mCAAgC;AACnE,SAASC,eAAe,QAA+B,2BAAwB;;AAE/E;AACA;AACA;;AAYA;AACA;AACA;;AAGA;AACA;AACA;;AAMA;AACA;AACA;;AAQA;AACA;AACA;;AA0BA;AACA;AACA;AACA;AACA;AACA;AACA;;AAyBA;AACA;AACA;;AAUA;AACA;AACA;;AA0BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,UAAUA,CAACC,MAAwB,EAAiB;EAClE;EACA,MAAMC,WAAW,GAAGL,UAAU,CAACM,cAAc,CAAC,CAAC;;EAE/C;EACA,MAAMC,cAAc,GAAGH,MAAM,CAACI,KAAK,GAC/B;IACE,GAAGJ,MAAM,CAACI,KAAK;IACfC,KAAK,EAAEL,MAAM,CAACI,KAAK,CAACC,KAAK,GACrB;MACE,GAAGL,MAAM,CAACI,KAAK,CAACC,KAAK;MACrBC,YAAY,EAAER,eAAe,CAACE,MAAM,CAACI,KAAK,CAACC,KAAK;IAClD,CAAC,GACDE;EACN,CAAC,GACDA,SAAS;EAEb,MAAMC,qBAAqB,GAAG;IAC5B,GAAGR,MAAM;IACTI,KAAK,EAAED,cAAc;IACrBF,WAAW,EAAEA,WAAW,IAAIM;EAC9B,CAAC;;EAED;EACAV,kBAAkB,CAACY,QAAQ,CAACN,cAAc,IAAI,IAAI,CAAC;;EAEnD;EACAN,kBAAkB,CAACa,cAAc,CAAC,CAAC;EAEnC,OAAOf,qBAAqB,CAACI,UAAU,CAACS,qBAAqB,CAAC;AAChE","ignoreList":[]}

package/lib/module/openUI.js

@@ -2,10 +2,31 @@
 
 import { OctopusReactNativeSdk } from "./internals/nativeModule.js";
 
+/**
+ * Options for opening the Octopus UI.
+ */
+
 /**
  * Opens the Octopus UI home screen.
+ *
+ * @param options - Optional configuration. Use `interceptUrls: true` to receive
+ *   URL taps via `addNavigateToUrlListener` instead of having the SDK open them.
+ * @returns A promise that resolves when the UI has been opened.
+ *
+ * @example
+ * ```typescript
+ * // Open UI with default behaviour (SDK opens links in system browser)
+ * await openUI();
+ *
+ * // Open UI with URL interception (app receives links via addNavigateToUrlListener)
+ * await openUI({ interceptUrls: true });
+ * ```
  */
-export function openUI() {
-  return OctopusReactNativeSdk.openUI();
+export function openUI(options) {
+  const opts = options ?? {};
+  const interceptUrls = opts.interceptUrls === true;
+  return OctopusReactNativeSdk.openUI({
+    interceptUrls
+  });
 }
 //# sourceMappingURL=openUI.js.map

package/lib/module/openUI.js.map

@@ -1 +1 @@
-{"version":3,"names":["OctopusReactNativeSdk","openUI"],"sourceRoot":"../../src","sources":["openUI.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,6BAA0B;;AAEhE;AACA;AACA;AACA,OAAO,SAASC,MAAMA,CAAA,EAAkB;EACtC,OAAOD,qBAAqB,CAACC,MAAM,CAAC,CAAC;AACvC","ignoreList":[]}
+{"version":3,"names":["OctopusReactNativeSdk","openUI","options","opts","interceptUrls"],"sourceRoot":"../../src","sources":["openUI.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,6BAA0B;;AAEhE;AACA;AACA;;AAaA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,MAAMA,CAACC,OAAuB,EAAiB;EAC7D,MAAMC,IAAI,GAAGD,OAAO,IAAI,CAAC,CAAC;EAC1B,MAAME,aAAa,GAAGD,IAAI,CAACC,aAAa,KAAK,IAAI;EACjD,OAAOJ,qBAAqB,CAACC,MAAM,CAAC;IAAEG;EAAc,CAAC,CAAC;AACxD","ignoreList":[]}

package/lib/module/overrideCommunityAccess.js

@@ -0,0 +1,36 @@
+"use strict";
+
+import { OctopusReactNativeSdk } from "./internals/nativeModule.js";
+
+/**
+ * Override the community access cohort for the current user.
+ *
+ * **When to use:** When the **Octopus SDK manages the A/B logic** — i.e. Octopus assigns
+ * the cohort and decides who has access to the community. In that case, the "Has access
+ * to community" state is the cohort value. Use this function to override that cohort
+ * (e.g. for testing or feature gating). The new state is reflected via `addHasAccessToCommunityListener`.
+ *
+ * **When not to use:** If **your app** decides who has access (e.g. your own feature flag or A/B logic),
+ * do not use `overrideCommunityAccess`. Use `trackCommunityAccess` instead to report the access
+ * value to Octopus for analytics only; that does not change the actual access state in the SDK.
+ *
+ * @param hasAccess - `true` to grant access, `false` to deny access.
+ * @returns A promise that resolves when the override has been applied.
+ * @throws An error if the SDK is not initialized or the call fails.
+ * @see {@link addHasAccessToCommunityListener} – subscribe to the Octopus-managed community access state.
+ * @see {@link trackCommunityAccess} – when your app manages access, report it for analytics only (no change to SDK state).
+ *
+ * @example
+ * ```typescript
+ * const subscription = addHasAccessToCommunityListener((hasAccess) => {
+ *   console.log(`Has access to community: ${hasAccess}`);
+ * });
+ * await overrideCommunityAccess(true);
+ * await overrideCommunityAccess(false);
+ * subscription.remove();
+ * ```
+ */
+export function overrideCommunityAccess(hasAccess) {
+  return OctopusReactNativeSdk.overrideCommunityAccess(hasAccess);
+}
+//# sourceMappingURL=overrideCommunityAccess.js.map

package/lib/module/overrideCommunityAccess.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OctopusReactNativeSdk","overrideCommunityAccess","hasAccess"],"sourceRoot":"../../src","sources":["overrideCommunityAccess.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,6BAA0B;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CAACC,SAAkB,EAAiB;EACzE,OAAOF,qBAAqB,CAACC,uBAAuB,CAACC,SAAS,CAAC;AACjE","ignoreList":[]}

package/lib/module/overrideDefaultLocale.js

@@ -0,0 +1,75 @@
+"use strict";
+
+import { OctopusReactNativeSdk } from "./internals/nativeModule.js";
+
+/**
+ * Parameters for overriding the default locale used by the Octopus SDK UI.
+ * Uses ISO 639-1 language code and optional ISO 3166-1 alpha-2 country code.
+ */
+
+/** ISO 639-1: exactly 2 alphabetic characters (case-insensitive, normalized to lowercase). */
+const LANGUAGE_CODE_REGEX = /^[a-zA-Z]{2}$/;
+
+/** ISO 3166-1 alpha-2: exactly 2 alphabetic characters (case-insensitive, normalized to uppercase). */
+const COUNTRY_CODE_REGEX = /^[a-zA-Z]{2}$/;
+function validateAndNormalizeLocale(locale) {
+  const lang = locale.languageCode?.trim() ?? '';
+  if (!LANGUAGE_CODE_REGEX.test(lang)) {
+    throw new Error("overrideDefaultLocale: languageCode must be a 2-letter ISO 639-1 code (e.g. 'en', 'fr')");
+  }
+  const country = locale.countryCode?.trim();
+  if (country !== undefined && country !== '') {
+    if (!COUNTRY_CODE_REGEX.test(country)) {
+      throw new Error("overrideDefaultLocale: countryCode must be a 2-letter ISO 3166-1 alpha-2 code (e.g. 'US', 'FR')");
+    }
+    return {
+      languageCode: lang.toLowerCase(),
+      countryCode: country.toUpperCase()
+    };
+  }
+  return {
+    languageCode: lang.toLowerCase(),
+    countryCode: null
+  };
+}
+
+/**
+ * Override the default locale used by the Octopus SDK for its UI.
+ *
+ * The change takes effect immediately for subsequently displayed SDK screens.
+ * Pass `null` to reset to the system default locale.
+ *
+ * @param locale - Object with `languageCode` and optional `countryCode`
+ *   (e.g. `{ languageCode: 'fr' }` or `{ languageCode: 'en', countryCode: 'US' }`).
+ *   Pass `null` to use the system default (no override).
+ * @returns A promise that resolves when the override has been applied.
+ * @throws An error if the SDK is not initialized or the call fails.
+ * @throws An error if locale is invalid (e.g. non-ISO language/country codes).
+ *
+ * @example
+ * ```typescript
+ * // Use French
+ * await overrideDefaultLocale({ languageCode: 'fr' });
+ *
+ * // Use English (US)
+ * await overrideDefaultLocale({ languageCode: 'en', countryCode: 'US' });
+ *
+ * // Reset to system default
+ * await overrideDefaultLocale(null);
+ * ```
+ */
+export function overrideDefaultLocale(locale) {
+  if (locale === null) {
+    return OctopusReactNativeSdk.overrideDefaultLocale(null, null);
+  }
+  try {
+    const {
+      languageCode,
+      countryCode
+    } = validateAndNormalizeLocale(locale);
+    return OctopusReactNativeSdk.overrideDefaultLocale(languageCode, countryCode);
+  } catch (e) {
+    return Promise.reject(e);
+  }
+}
+//# sourceMappingURL=overrideDefaultLocale.js.map

package/lib/module/overrideDefaultLocale.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OctopusReactNativeSdk","LANGUAGE_CODE_REGEX","COUNTRY_CODE_REGEX","validateAndNormalizeLocale","locale","lang","languageCode","trim","test","Error","country","countryCode","undefined","toLowerCase","toUpperCase","overrideDefaultLocale","e","Promise","reject"],"sourceRoot":"../../src","sources":["overrideDefaultLocale.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,6BAA0B;;AAEhE;AACA;AACA;AACA;;AAQA;AACA,MAAMC,mBAAmB,GAAG,eAAe;;AAE3C;AACA,MAAMC,kBAAkB,GAAG,eAAe;AAE1C,SAASC,0BAA0BA,CAACC,MAA4B,EAG9D;EACA,MAAMC,IAAI,GAAGD,MAAM,CAACE,YAAY,EAAEC,IAAI,CAAC,CAAC,IAAI,EAAE;EAC9C,IAAI,CAACN,mBAAmB,CAACO,IAAI,CAACH,IAAI,CAAC,EAAE;IACnC,MAAM,IAAII,KAAK,CACb,yFACF,CAAC;EACH;EACA,MAAMC,OAAO,GAAGN,MAAM,CAACO,WAAW,EAAEJ,IAAI,CAAC,CAAC;EAC1C,IAAIG,OAAO,KAAKE,SAAS,IAAIF,OAAO,KAAK,EAAE,EAAE;IAC3C,IAAI,CAACR,kBAAkB,CAACM,IAAI,CAACE,OAAO,CAAC,EAAE;MACrC,MAAM,IAAID,KAAK,CACb,iGACF,CAAC;IACH;IACA,OAAO;MACLH,YAAY,EAAED,IAAI,CAACQ,WAAW,CAAC,CAAC;MAChCF,WAAW,EAAED,OAAO,CAACI,WAAW,CAAC;IACnC,CAAC;EACH;EACA,OAAO;IACLR,YAAY,EAAED,IAAI,CAACQ,WAAW,CAAC,CAAC;IAChCF,WAAW,EAAE;EACf,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASI,qBAAqBA,CACnCX,MAAmC,EACpB;EACf,IAAIA,MAAM,KAAK,IAAI,EAAE;IACnB,OAAOJ,qBAAqB,CAACe,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC;EAChE;EACA,IAAI;IACF,MAAM;MAAET,YAAY;MAAEK;IAAY,CAAC,GAAGR,0BAA0B,CAACC,MAAM,CAAC;IACxE,OAAOJ,qBAAqB,CAACe,qBAAqB,CAChDT,YAAY,EACZK,WACF,CAAC;EACH,CAAC,CAAC,OAAOK,CAAC,EAAE;IACV,OAAOC,OAAO,CAACC,MAAM,CAACF,CAAC,CAAC;EAC1B;AACF","ignoreList":[]}

package/lib/module/trackCommunityAccess.js

@@ -0,0 +1,33 @@
+"use strict";
+
+import { OctopusReactNativeSdk } from "./internals/nativeModule.js";
+
+/**
+ * Track community access for analytics without changing the actual access.
+ *
+ * **When to use:** When **your app manages its own A/B logic** — i.e. your app decides who can see
+ * the community (e.g. via your own feature flag or experiment). Call this to report that decision
+ * to Octopus for analytics only. It does not grant or restrict access in the SDK; it only records
+ * the value for reporting.
+ *
+ * **When not to use:** If the **Octopus SDK manages the cohort** (Octopus assigns who has access),
+ * use `overrideCommunityAccess` to change the cohort and `addHasAccessToCommunityListener` to react
+ * to it. Use `trackCommunityAccess` only when the access decision is owned by your app and you just
+ * need to report it.
+ *
+ * @param hasAccess - The access value to report (e.g. the variant your app decided).
+ * @returns A promise that resolves when the tracking call has completed.
+ * @throws An error if the SDK is not initialized or the call fails.
+ * @see {@link overrideCommunityAccess} – when Octopus manages the cohort, override it (and use addHasAccessToCommunityListener to react).
+ * @see {@link addHasAccessToCommunityListener} – subscribe to the Octopus-managed access state (relevant when Octopus or override sets it).
+ *
+ * @example
+ * ```typescript
+ * await trackCommunityAccess(true);
+ * await trackCommunityAccess(false);
+ * ```
+ */
+export function trackCommunityAccess(hasAccess) {
+  return OctopusReactNativeSdk.trackCommunityAccess(hasAccess);
+}
+//# sourceMappingURL=trackCommunityAccess.js.map

package/lib/module/trackCommunityAccess.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OctopusReactNativeSdk","trackCommunityAccess","hasAccess"],"sourceRoot":"../../src","sources":["trackCommunityAccess.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,6BAA0B;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAACC,SAAkB,EAAiB;EACtE,OAAOF,qBAAqB,CAACC,oBAAoB,CAACC,SAAS,CAAC;AAC9D","ignoreList":[]}

package/lib/module/trackCustomEvent.js

@@ -0,0 +1,36 @@
+"use strict";
+
+import { OctopusReactNativeSdk } from "./internals/nativeModule.js";
+
+/**
+ * Track custom events that are merged into Octopus analytics reports.
+ *
+ * Use this to send app-specific business events (e.g. purchases, feature usage)
+ * so they appear alongside Octopus Community analytics.
+ *
+ * All property values must be strings. Non-string values should be stringified
+ * before calling (e.g. numbers as `"123"`, booleans as `"true"`).
+ *
+ * @param name - The name of the custom event (e.g. `"purchase"`, `"screen_view"`).
+ * @param properties - Optional map of string key-value pairs attached to the event.
+ * @returns A promise that resolves when the event has been tracked.
+ * @throws An error if the SDK is not initialized or tracking fails.
+ *
+ * @example
+ * ```typescript
+ * await trackCustomEvent('purchase', {
+ *   product_id: '123',
+ *   price: '9.99',
+ *   currency: 'EUR',
+ * });
+ *
+ * await trackCustomEvent('feature_used', {
+ *   feature: 'community_search',
+ *   source: 'home_screen',
+ * });
+ * ```
+ */
+export function trackCustomEvent(name, properties) {
+  return OctopusReactNativeSdk.trackCustomEvent(name, properties ?? {});
+}
+//# sourceMappingURL=trackCustomEvent.js.map

package/lib/module/trackCustomEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OctopusReactNativeSdk","trackCustomEvent","name","properties"],"sourceRoot":"../../src","sources":["trackCustomEvent.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,6BAA0B;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAC9BC,IAAY,EACZC,UAAmC,EACpB;EACf,OAAOH,qBAAqB,CAACC,gBAAgB,CAACC,IAAI,EAAEC,UAAU,IAAI,CAAC,CAAC,CAAC;AACvE","ignoreList":[]}

package/lib/module/types/sdkEvents.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=sdkEvents.js.map

package/lib/module/types/sdkEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["types/sdkEvents.ts"],"mappings":"","ignoreList":[]}

package/lib/module/types/urlOpeningStrategy.js

@@ -0,0 +1,23 @@
+"use strict";
+
+/**
+ * Strategy for handling URLs tapped inside the Octopus Community UI.
+ *
+ * When URL interception is enabled via `openUI({ interceptUrls: true })`,
+ * the app receives each tapped URL via `addNavigateToUrlListener`. The callback
+ * returns one of these strategies to decide who handles the URL.
+ */
+export let UrlOpeningStrategy = /*#__PURE__*/function (UrlOpeningStrategy) {
+  /**
+   * The URL has been handled by the app. The SDK will not open it.
+   * Use this when you open the URL in an in-app web view or handle it yourself.
+   */
+  UrlOpeningStrategy["handledByApp"] = "handledByApp";
+  /**
+   * The URL should be opened by the Octopus SDK (system browser).
+   * The native layer will open the URL in the default browser when this is returned.
+   */
+  UrlOpeningStrategy["handledByOctopus"] = "handledByOctopus";
+  return UrlOpeningStrategy;
+}({});
+//# sourceMappingURL=urlOpeningStrategy.js.map

package/lib/module/types/urlOpeningStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["UrlOpeningStrategy"],"sourceRoot":"../../../src","sources":["types/urlOpeningStrategy.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,WAAYA,kBAAkB,0BAAlBA,kBAAkB;EAC5B;AACF;AACA;AACA;EAJYA,kBAAkB;EAO5B;AACF;AACA;AACA;EAVYA,kBAAkB;EAAA,OAAlBA,kBAAkB;AAAA","ignoreList":[]}

package/lib/module/updateNotSeenNotificationsCount.js

@@ -0,0 +1,33 @@
+"use strict";
+
+import { OctopusReactNativeSdk } from "./internals/nativeModule.js";
+
+/**
+ * Force refresh the unseen notification count from the server.
+ *
+ * This method triggers a manual update of the notification badge count.
+ * The updated count will be emitted via the notSeenNotificationsCountChanged event.
+ * Use `addNotSeenNotificationsCountListener` to listen for count changes.
+ *
+ * @returns A promise that resolves when the update is complete.
+ * @throws An error if the SDK is not initialized or if the update fails.
+ *
+ * @example
+ * ```typescript
+ * // Listen to count changes
+ * const subscription = addNotSeenNotificationsCountListener((count) => {
+ *   console.log(`Unseen notifications: ${count}`);
+ *   // Update your badge UI
+ * });
+ *
+ * // Manually refresh the count
+ * await updateNotSeenNotificationsCount();
+ *
+ * // Later, unsubscribe
+ * subscription.remove();
+ * ```
+ */
+export function updateNotSeenNotificationsCount() {
+  return OctopusReactNativeSdk.updateNotSeenNotificationsCount();
+}
+//# sourceMappingURL=updateNotSeenNotificationsCount.js.map

package/lib/module/updateNotSeenNotificationsCount.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OctopusReactNativeSdk","updateNotSeenNotificationsCount"],"sourceRoot":"../../src","sources":["updateNotSeenNotificationsCount.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAAQ,6BAA0B;;AAEhE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,+BAA+BA,CAAA,EAAkB;EAC/D,OAAOD,qBAAqB,CAACC,+BAA+B,CAAC,CAAC;AAChE","ignoreList":[]}

package/lib/typescript/src/OctopusUIView.d.ts

@@ -0,0 +1,32 @@
+import { type StyleProp, type ViewStyle } from 'react-native';
+export interface OctopusUIViewProps {
+    /**
+     * When `true`, URLs tapped inside the community UI are not opened by the SDK.
+     * Instead, a `navigateToUrl` event is emitted. Subscribe with
+     * `addNavigateToUrlListener` to receive the URL.
+     *
+     * @default false
+     */
+    interceptUrls?: boolean;
+    style?: StyleProp<ViewStyle>;
+}
+/**
+ * Embeds the Octopus Community UI as a native view inside your screen.
+ * Use this when you want to keep your app navigation (e.g. bottom tab bar) visible
+ * instead of opening the SDK in fullscreen with `openUI()`.
+ *
+ * You must call `initialize()` before rendering this component.
+ *
+ * @example
+ * ```tsx
+ * function CommunityTab() {
+ *   return (
+ *     <View style={{ flex: 1 }}>
+ *       <OctopusUIView interceptUrls={true} style={StyleSheet.absoluteFill} />
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export declare function OctopusUIView({ interceptUrls, style, }: OctopusUIViewProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=OctopusUIView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OctopusUIView.d.ts","sourceRoot":"","sources":["../../../src/OctopusUIView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B;AAKD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,EAC5B,aAAqB,EACrB,KAAK,GACN,EAAE,kBAAkB,2CAOpB"}

package/lib/typescript/src/addHasAccessToCommunityListener.d.ts

@@ -0,0 +1,27 @@
+export type HasAccessToCommunityListenerCallback = (hasAccess: boolean) => void;
+/**
+ * Adds a listener for community access changes.
+ *
+ * This listener receives the **Octopus-managed** access state: the cohort value that determines
+ * whether the user has access to the community (when the SDK manages the A/B logic). It is triggered
+ * when that state changes — e.g. after you call `overrideCommunityAccess`, or when the cohort is
+ * updated by Octopus. Use it to show or hide community entry points in your UI. If your app manages
+ * access itself (and only reports it via `trackCommunityAccess`), this listener is less relevant,
+ * since the SDK is not the source of the access decision.
+ *
+ * @param callback - Function called when the access status changes
+ * @returns A subscription object with a `remove()` method to unsubscribe
+ * @see {@link overrideCommunityAccess} – set the cohort when Octopus manages A/B.
+ * @see {@link trackCommunityAccess} – report access for analytics when your app manages access.
+ *
+ * @example
+ * ```typescript
+ * const subscription = addHasAccessToCommunityListener((hasAccess) => {
+ *   console.log(`Has access to community: ${hasAccess}`);
+ *   // Show or hide community features based on access
+ * });
+ * subscription.remove();
+ * ```
+ */
+export declare function addHasAccessToCommunityListener(callback: HasAccessToCommunityListenerCallback): import("react-native").EmitterSubscription;
+//# sourceMappingURL=addHasAccessToCommunityListener.d.ts.map