@octopus-community/react-native 1.0.0

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

@@ -0,0 +1,5 @@
+/**
+ * Closes the Octopus UI home screen.
+ */
+export declare function closeUI(): Promise<void>;
+//# sourceMappingURL=closeUI.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"closeUI.d.ts","sourceRoot":"","sources":["../../../src/closeUI.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvC"}

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

@@ -0,0 +1,30 @@
+export interface ConnectUserParams {
+    /**
+     * Unique identifier for the user in your system.
+     * This should be a stable, unique ID that won't change for the user.
+     */
+    userId: string;
+    profile?: {
+        username?: string;
+        /**
+         * URL or local file path to the user's profile picture.
+         * Supports HTTP/HTTPS URLs and local file paths.
+         */
+        profilePicture?: string;
+        biography?: string;
+        /**
+         * Whether the user has reached legal age.
+         * Used for age-appropriate content filtering and compliance.
+         */
+        legalAgeReached?: boolean;
+    };
+}
+/**
+ * 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`.
+ */
+export declare function connectUser(params: ConnectUserParams): Promise<void>;
+//# sourceMappingURL=connectUser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connectUser.d.ts","sourceRoot":"","sources":["../../../src/connectUser.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB;;;WAGG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB;;;WAGG;QACH,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;CACH;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE"}

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

@@ -0,0 +1,2 @@
+export declare function disconnectUser(): Promise<void>;
+//# sourceMappingURL=disconnectUser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"disconnectUser.d.ts","sourceRoot":"","sources":["../../../src/disconnectUser.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9C"}

package/lib/typescript/src/enums/LogLevel.enum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Used to categorize log messages by their severity and importance.
+ */
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+//# sourceMappingURL=LogLevel.enum.d.ts.map

package/lib/typescript/src/enums/LogLevel.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogLevel.enum.d.ts","sourceRoot":"","sources":["../../../../src/enums/LogLevel.enum.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,IAAA;IACL,IAAI,IAAA;IACJ,IAAI,IAAA;IACJ,KAAK,IAAA;CACN"}

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

@@ -0,0 +1,13 @@
+export * from './initialize';
+export * from './openUI';
+export * from './closeUI';
+export * from './connectUser';
+export * from './disconnectUser';
+export * from './addUserTokenRequestListener';
+export * from './useUserTokenProvider';
+export * from './addLoginRequiredListener';
+export * from './addEditUserListener';
+export * from './types/userProfileField';
+export * from './logger';
+export * from './enums/LogLevel.enum';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC"}

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

@@ -0,0 +1,50 @@
+import type { UserProfileField } from './types/userProfileField';
+/**
+ * Configuration params for initializing the Octopus SDK.
+ */
+export interface InitializeParams {
+    /** Your Octopus API key obtained from the Octopus dashboard */
+    apiKey: string;
+    /**
+     * The connection mode determines how user authentication is handled.
+     * - `sso`: Use Single Sign-On with your existing user system
+     * - `octopus`: Let Octopus handle user authentication
+     */
+    connectionMode: {
+        /** SSO mode configuration */
+        type: 'sso';
+        /** List of user profile fields that your app manages directly */
+        appManagedFields: UserProfileField[];
+    } | {
+        /** Octopus-managed authentication mode */
+        type: 'octopus';
+    };
+}
+/**
+ * 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.
+ *
+ * @example
+ * ```typescript
+ * // Initialize with SSO mode
+ * await initialize({
+ *   apiKey: 'your-api-key',
+ *   connectionMode: {
+ *     type: 'sso',
+ *     appManagedFields: ['username', 'profilePicture']
+ *   }
+ * });
+ *
+ * // Initialize with Octopus authentication
+ * await initialize({
+ *   apiKey: 'your-api-key',
+ *   connectionMode: {
+ *     type: 'octopus'
+ *   }
+ * });
+ * ```
+ */
+export declare function initialize(params: InitializeParams): Promise<void>;
+//# sourceMappingURL=initialize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../../../src/initialize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,cAAc,EACV;QACE,6BAA6B;QAC7B,IAAI,EAAE,KAAK,CAAC;QACZ,iEAAiE;QACjE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;KACtC,GACD;QACE,0CAA0C;QAC1C,IAAI,EAAE,SAAS,CAAC;KACjB,CAAC;CACP;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE"}

package/lib/typescript/src/internals/eventEmitter.d.ts

@@ -0,0 +1,3 @@
+import { NativeEventEmitter } from 'react-native';
+export declare const eventEmitter: NativeEventEmitter;
+//# sourceMappingURL=eventEmitter.d.ts.map

package/lib/typescript/src/internals/eventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventEmitter.d.ts","sourceRoot":"","sources":["../../../../src/internals/eventEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,eAAO,MAAM,YAAY,oBAAgD,CAAC"}

package/lib/typescript/src/internals/logger.d.ts

@@ -0,0 +1,20 @@
+import { LogLevel } from '../enums/LogLevel.enum';
+export type LoggerFunction = (level: LogLevel, message: string, data?: Error | Record<string, unknown> | unknown) => void;
+/**
+ * Set a custom logger function to handle all logs
+ *
+ * @param logger A function that takes a log level and message and handles the logging
+ */
+export declare const setLogger: (logger: LoggerFunction) => void;
+/**
+ * Get the current logger function
+ */
+export declare const getLogger: () => LoggerFunction;
+/**
+ * Reset the logger to the default implementation
+ */
+export declare const resetLogger: () => void;
+export declare const setLogLevel: (level: LogLevel) => void;
+export declare const getLogLevel: () => LogLevel;
+export declare function log(level: LogLevel, message: string, data?: Error | Record<string, unknown> | unknown): void;
+//# sourceMappingURL=logger.d.ts.map

package/lib/typescript/src/internals/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/internals/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,KAC7C,IAAI,CAAC;AAYV;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,cAAc,KAAG,IAElD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,QAAO,cAA+B,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,WAAW,QAAO,IAE9B,CAAC;AAIF,eAAO,MAAM,WAAW,GAAI,OAAO,QAAQ,SAE1C,CAAC;AAEF,eAAO,MAAM,WAAW,gBAAiB,CAAC;AAE1C,wBAAgB,GAAG,CACjB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,GAC/C,IAAI,CAQN"}

package/lib/typescript/src/internals/nativeModule.d.ts

@@ -0,0 +1,2 @@
+export declare const OctopusReactNativeSdk: any;
+//# sourceMappingURL=nativeModule.d.ts.map

package/lib/typescript/src/internals/nativeModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeModule.d.ts","sourceRoot":"","sources":["../../../../src/internals/nativeModule.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,qBAAqB,KAS7B,CAAC"}

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

@@ -0,0 +1,3 @@
+export { setLogger, resetLogger, setLogLevel, getLogLevel, } from './internals/logger';
+export type { LoggerFunction } from './internals/logger';
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,5 @@
+/**
+ * Opens the Octopus UI home screen.
+ */
+export declare function openUI(): Promise<void>;
+//# sourceMappingURL=openUI.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openUI.d.ts","sourceRoot":"","sources":["../../../src/openUI.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAEtC"}

package/lib/typescript/src/types/userProfileField.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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';
+//# sourceMappingURL=userProfileField.d.ts.map

package/lib/typescript/src/types/userProfileField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userProfileField.d.ts","sourceRoot":"","sources":["../../../../src/types/userProfileField.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB;AAC1B,oDAAoD;AAClD,UAAU;AACZ,4CAA4C;GAC1C,WAAW;AACb,qCAAqC;GACnC,gBAAgB,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * 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 declare function useUserTokenProvider(userTokenProvider: UserTokenProvider): void;
+//# sourceMappingURL=useUserTokenProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useUserTokenProvider.d.ts","sourceRoot":"","sources":["../../../src/useUserTokenProvider.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;AAEtD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,iBAAiB,EAAE,iBAAiB,QAgBxE"}

package/package.json

@@ -0,0 +1,136 @@
+{
+  "name": "@octopus-community/react-native",
+  "version": "1.0.0",
+  "description": "React Native module for the Octopus Community SDK",
+  "source": "./src/index.ts",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "scripts/octopus_pods.rb",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace @octopus-community/react-native-example",
+    "test": "yarn test:lint && yarn test:types && yarn test:unit",
+    "test:unit": "jest",
+    "test:types": "tsc",
+    "test:lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "typedoc && bob build"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Octopus-Community/octopus-sdk-react-native.git"
+  },
+  "author": "Louis Lagrange <lagrange.louis@gmail.com> (https://github.com/Minishlink)",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "bugs": {
+    "url": "https://github.com/Octopus-Community/octopus-sdk-react-native/issues"
+  },
+  "homepage": "https://github.com/Octopus-Community/octopus-sdk-react-native#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.6.0",
+    "@eslint/compat": "^1.2.7",
+    "@eslint/eslintrc": "^3.3.0",
+    "@eslint/js": "^9.22.0",
+    "@evilmartians/lefthook": "^1.5.0",
+    "@react-native/eslint-config": "^0.78.0",
+    "@types/jest": "^29.5.5",
+    "@types/react": "^19.0.0",
+    "commitlint": "^19.6.1",
+    "del-cli": "^5.1.0",
+    "eslint": "^9.22.0",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-prettier": "^5.2.3",
+    "jest": "^29.7.0",
+    "prettier": "^3.0.3",
+    "react": "19.0.0",
+    "react-native": "0.78.2",
+    "react-native-builder-bob": "^0.40.12",
+    "turbo": "^1.10.7",
+    "typedoc": "^0.28.7",
+    "typedoc-plugin-markdown": "^4.7.0",
+    "typescript": "^5.2.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@3.6.1",
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "create-react-native-library": {
+    "type": "legacy-module",
+    "languages": "kotlin-swift",
+    "version": "0.49.8"
+  }
+}

package/src/addEditUserListener.ts

@@ -0,0 +1,19 @@
+import { eventEmitter } from './internals/eventEmitter';
+import type { UserProfileField } from './types/userProfileField';
+
+export interface EditUserEventParams {
+  /** The user profile field that the user wants to edit */
+  fieldToEdit: UserProfileField | null;
+}
+
+export type EditUserListenerCallback = (params: EditUserEventParams) => void;
+
+/**
+ * Adds a listener for edit user events.
+ *
+ * This listener is triggered when the Octopus SDK needs the host app to handle
+ * user profile editing for fields marked as app-managed in SSO mode.
+ */
+export function addEditUserListener(callback: EditUserListenerCallback) {
+  return eventEmitter.addListener('editUser', callback);
+}

package/src/addLoginRequiredListener.ts

@@ -0,0 +1,16 @@
+import { eventEmitter } from './internals/eventEmitter';
+
+export type LoginRequiredListenerCallback = () => void;
+
+/**
+ * Adds a listener for login required events.
+ *
+ * This listener is triggered when the Octopus SDK detects that user
+ * authentication is required, typically in SSO mode when the user
+ * session has expired or the user is not logged in.
+ */
+export function addLoginRequiredListener(
+  callback: LoginRequiredListenerCallback
+) {
+  return eventEmitter.addListener('loginRequired', callback);
+}

package/src/addUserTokenRequestListener.ts

@@ -0,0 +1,32 @@
+import { eventEmitter } from './internals/eventEmitter';
+import { OctopusReactNativeSdk } from './internals/nativeModule';
+import { log } from './internals/logger';
+import { LogLevel } from './enums/LogLevel.enum';
+
+export type UserTokenRequestListenerCallback = () => Promise<string>;
+
+/**
+ * Adds a listener for user token requests events.
+ *
+ * This listener is triggered when the Octopus SDK needs
+ * a new user token.
+ * You may use this listener directly if you prefer not to use the useUserTokenProvider hook.
+ */
+export function addUserTokenRequestListener(
+  callback: UserTokenRequestListenerCallback
+) {
+  const handleUserTokenRequest = async (event: { requestId: string }) => {
+    try {
+      const token = await callback();
+      await OctopusReactNativeSdk.completeUserTokenRequest(
+        event.requestId,
+        token
+      );
+    } catch (error) {
+      log(LogLevel.ERROR, 'Failed to provide user token to Octopus', error);
+      await OctopusReactNativeSdk.cancelUserTokenRequest(event.requestId);
+    }
+  };
+
+  return eventEmitter.addListener('userTokenRequest', handleUserTokenRequest);
+}

package/src/closeUI.ts

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

package/src/connectUser.ts

@@ -0,0 +1,34 @@
+import { OctopusReactNativeSdk } from './internals/nativeModule';
+
+export interface ConnectUserParams {
+  /**
+   * Unique identifier for the user in your system.
+   * This should be a stable, unique ID that won't change for the user.
+   */
+  userId: string;
+  profile?: {
+    username?: string;
+    /**
+     * URL or local file path to the user's profile picture.
+     * Supports HTTP/HTTPS URLs and local file paths.
+     */
+    profilePicture?: string;
+    biography?: string;
+    /**
+     * Whether the user has reached legal age.
+     * Used for age-appropriate content filtering and compliance.
+     */
+    legalAgeReached?: boolean;
+  };
+}
+
+/**
+ * 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`.
+ */
+export function connectUser(params: ConnectUserParams): Promise<void> {
+  return OctopusReactNativeSdk.connectUser(params);
+}

package/src/disconnectUser.ts

@@ -0,0 +1,5 @@
+import { OctopusReactNativeSdk } from './internals/nativeModule';
+
+export function disconnectUser(): Promise<void> {
+  return OctopusReactNativeSdk.disconnectUser();
+}

package/src/enums/LogLevel.enum.ts

@@ -0,0 +1,9 @@
+/**
+ * Used to categorize log messages by their severity and importance.
+ */
+export enum LogLevel {
+  DEBUG,
+  INFO,
+  WARN,
+  ERROR,
+}

package/src/index.ts

@@ -0,0 +1,12 @@
+export * from './initialize';
+export * from './openUI';
+export * from './closeUI';
+export * from './connectUser';
+export * from './disconnectUser';
+export * from './addUserTokenRequestListener';
+export * from './useUserTokenProvider';
+export * from './addLoginRequiredListener';
+export * from './addEditUserListener';
+export * from './types/userProfileField';
+export * from './logger';
+export * from './enums/LogLevel.enum';

package/src/initialize.ts

@@ -0,0 +1,56 @@
+import { OctopusReactNativeSdk } from './internals/nativeModule';
+import type { UserProfileField } from './types/userProfileField';
+
+/**
+ * Configuration params for initializing the Octopus SDK.
+ */
+export interface InitializeParams {
+  /** Your Octopus API key obtained from the Octopus dashboard */
+  apiKey: string;
+  /**
+   * The connection mode determines how user authentication is handled.
+   * - `sso`: Use Single Sign-On with your existing user system
+   * - `octopus`: Let Octopus handle user authentication
+   */
+  connectionMode:
+    | {
+        /** SSO mode configuration */
+        type: 'sso';
+        /** List of user profile fields that your app manages directly */
+        appManagedFields: UserProfileField[];
+      }
+    | {
+        /** Octopus-managed authentication mode */
+        type: 'octopus';
+      };
+}
+
+/**
+ * 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.
+ *
+ * @example
+ * ```typescript
+ * // Initialize with SSO mode
+ * await initialize({
+ *   apiKey: 'your-api-key',
+ *   connectionMode: {
+ *     type: 'sso',
+ *     appManagedFields: ['username', 'profilePicture']
+ *   }
+ * });
+ *
+ * // Initialize with Octopus authentication
+ * await initialize({
+ *   apiKey: 'your-api-key',
+ *   connectionMode: {
+ *     type: 'octopus'
+ *   }
+ * });
+ * ```
+ */
+export function initialize(params: InitializeParams): Promise<void> {
+  return OctopusReactNativeSdk.initialize(params);
+}

package/src/internals/eventEmitter.ts

@@ -0,0 +1,4 @@
+import { NativeEventEmitter } from 'react-native';
+import { OctopusReactNativeSdk } from './nativeModule';
+
+export const eventEmitter = new NativeEventEmitter(OctopusReactNativeSdk);

package/src/internals/logger.ts

@@ -0,0 +1,60 @@
+import { LogLevel } from '../enums/LogLevel.enum';
+
+export type LoggerFunction = (
+  level: LogLevel,
+  message: string,
+  data?: Error | Record<string, unknown> | unknown
+) => void;
+
+const defaultLogger: LoggerFunction = (
+  _level: LogLevel,
+  message: string,
+  data?: Error | Record<string, unknown> | unknown
+): void => {
+  console.log(`[Octopus] ${message}`, data);
+};
+
+let currentLogger: LoggerFunction = defaultLogger;
+
+/**
+ * Set a custom logger function to handle all logs
+ *
+ * @param logger A function that takes a log level and message and handles the logging
+ */
+export const setLogger = (logger: LoggerFunction): void => {
+  currentLogger = logger;
+};
+
+/**
+ * Get the current logger function
+ */
+export const getLogger = (): LoggerFunction => currentLogger;
+
+/**
+ * Reset the logger to the default implementation
+ */
+export const resetLogger = (): void => {
+  currentLogger = defaultLogger;
+};
+
+let logLevel = LogLevel.WARN;
+
+export const setLogLevel = (level: LogLevel) => {
+  logLevel = level;
+};
+
+export const getLogLevel = () => logLevel;
+
+export function log(
+  level: LogLevel,
+  message: string,
+  data?: Error | Record<string, unknown> | unknown
+): void {
+  const currentLogLevel = getLogLevel();
+  if (level < currentLogLevel) {
+    return;
+  }
+
+  const logger = getLogger();
+  logger(level, message, data);
+}