@octopus-community/react-native 1.0.0

package/src/internals/nativeModule.ts

@@ -0,0 +1,18 @@
+import { NativeModules, Platform } from 'react-native';
+
+const LINKING_ERROR =
+  `The package '@octopus-community/react-native' doesn't seem to be linked. Make sure: \n\n` +
+  Platform.select({ ios: "- You have run 'pod install'\n", default: '' }) +
+  '- You rebuilt the app after installing the package\n' +
+  '- You are not using Expo Go\n';
+
+export const OctopusReactNativeSdk = NativeModules.OctopusReactNativeSdk
+  ? NativeModules.OctopusReactNativeSdk
+  : new Proxy(
+      {},
+      {
+        get() {
+          throw new Error(LINKING_ERROR);
+        },
+      }
+    );

package/src/logger.ts

@@ -0,0 +1,7 @@
+export {
+  setLogger,
+  resetLogger,
+  setLogLevel,
+  getLogLevel,
+} from './internals/logger';
+export type { LoggerFunction } from './internals/logger';

package/src/openUI.ts

@@ -0,0 +1,8 @@
+import { OctopusReactNativeSdk } from './internals/nativeModule';
+
+/**
+ * Opens the Octopus UI home screen.
+ */
+export function openUI(): Promise<void> {
+  return OctopusReactNativeSdk.openUI();
+}

package/src/types/userProfileField.ts

@@ -0,0 +1,13 @@
+/**
+ * Represents the different user profile fields that can be managed by your application.
+ *
+ * These fields are used in SSO mode to specify which profile data your app
+ * will handle directly, rather than letting Octopus manage them.
+ */
+export type UserProfileField =
+  /** The user's display name, nickname or username */
+  | 'username'
+  /** The user's biography or about section */
+  | 'biography'
+  /** The user's profile picture URL */
+  | 'profilePicture';

package/src/useUserTokenProvider.ts

@@ -0,0 +1,36 @@
+import { useEffect, useRef } from 'react';
+import { addUserTokenRequestListener } from './addUserTokenRequestListener';
+
+/**
+ * A function that provides user tokens for authentication.
+ *
+ * @returns A promise that resolves to a valid user token string.
+ * @throws Should throw an error if the token cannot be provided (e.g., user not logged in).
+ */
+export type UserTokenProvider = () => Promise<string>;
+
+/**
+ * React hook that registers a user token provider for SSO authentication.
+ *
+ * This hook automatically handles token requests from the Octopus SDK by calling
+ * the provided `userTokenProvider` function whenever a fresh token is needed.
+ * The hook manages the subscription lifecycle and ensures the latest token provider
+ * is always used.
+ */
+export function useUserTokenProvider(userTokenProvider: UserTokenProvider) {
+  const userTokenProviderRef = useRef(userTokenProvider);
+
+  useEffect(() => {
+    userTokenProviderRef.current = userTokenProvider;
+  }, [userTokenProvider]);
+
+  useEffect(() => {
+    const subscription = addUserTokenRequestListener(() =>
+      userTokenProviderRef.current()
+    );
+
+    return () => {
+      subscription.remove();
+    };
+  }, []);
+}