@octopus-community/react-native 1.0.7 → 1.9.1

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

@@ -0,0 +1,222 @@
+/**
+ * Types for SDK events emitted by Octopus SDK.
+ * These events represent various user interactions and system events within the Octopus community.
+ */
+/**
+ * Content types that can be included in a post
+ */
+export type PostContentType = 'text' | 'image' | 'poll';
+/**
+ * Content kind (post, comment, or reply)
+ */
+export type ContentKind = 'post' | 'comment' | 'reply';
+/**
+ * Reaction kinds
+ */
+export type ReactionKind = 'heart' | 'joy' | 'mouthOpen' | 'clap' | 'cry' | 'rage' | 'unknown';
+/**
+ * Report reasons for content or profile reporting
+ */
+export type ReportReason = 'hateSpeech' | 'explicit' | 'violence' | 'spam' | 'suicide' | 'fakeProfile' | 'childExploitation' | 'intellectualProperty' | 'other';
+/**
+ * Gamification actions that can gain points
+ */
+export type GamificationPointsGainedAction = 'post' | 'comment' | 'reply' | 'reaction' | 'vote' | 'postCommented' | 'profileCompleted' | 'dailySession';
+/**
+ * Gamification actions that can remove points
+ */
+export type GamificationPointsRemovedAction = 'postDeleted' | 'commentDeleted' | 'replyDeleted' | 'reactionDeleted';
+/**
+ * Source of a post click
+ */
+export type PostClickedSource = 'feed' | 'profile';
+/**
+ * Screen types displayed in the Octopus UI
+ */
+export type ScreenType = 'postsFeed' | 'postDetail' | 'commentDetail' | 'createPost' | 'profile' | 'otherUserProfile' | 'editProfile' | 'reportContent' | 'reportProfile' | 'validateNickname' | 'settingsList' | 'settingsAccount' | 'settingsAbout' | 'reportExplanation' | 'deleteAccount';
+/**
+ * Base interface for all SDK events
+ */
+export interface BaseSDKEvent {
+    type: string;
+}
+/**
+ * Event emitted when a post is created
+ */
+export interface PostCreatedEvent extends BaseSDKEvent {
+    type: 'postCreated';
+    postId: string;
+    content: PostContentType[];
+    topicId: string | null;
+    textLength: number;
+}
+/**
+ * Event emitted when a comment is created
+ */
+export interface CommentCreatedEvent extends BaseSDKEvent {
+    type: 'commentCreated';
+    commentId: string;
+    postId: string;
+    textLength: number;
+}
+/**
+ * Event emitted when a reply is created
+ */
+export interface ReplyCreatedEvent extends BaseSDKEvent {
+    type: 'replyCreated';
+    replyId: string;
+    commentId: string;
+    textLength: number;
+}
+/**
+ * Event emitted when content is deleted
+ */
+export interface ContentDeletedEvent extends BaseSDKEvent {
+    type: 'contentDeleted';
+    contentId: string;
+    contentKind: ContentKind;
+}
+/**
+ * Event emitted when a reaction is modified (added, changed, or removed)
+ */
+export interface ReactionModifiedEvent extends BaseSDKEvent {
+    type: 'reactionModified';
+    contentId: string;
+    contentKind: ContentKind;
+    previousReaction: ReactionKind | null;
+    newReaction: ReactionKind | null;
+}
+/**
+ * Event emitted when a poll is voted on
+ */
+export interface PollVotedEvent extends BaseSDKEvent {
+    type: 'pollVoted';
+    contentId: string;
+    optionId: string;
+}
+/**
+ * Event emitted when content is reported
+ */
+export interface ContentReportedEvent extends BaseSDKEvent {
+    type: 'contentReported';
+    contentId: string;
+    reasons: ReportReason[];
+}
+/**
+ * Event emitted when a profile is reported
+ */
+export interface ProfileReportedEvent extends BaseSDKEvent {
+    type: 'profileReported';
+    profileId: string;
+    reasons: ReportReason[];
+}
+/**
+ * Event emitted when gamification points are gained
+ */
+export interface GamificationPointsGainedEvent extends BaseSDKEvent {
+    type: 'gamificationPointsGained';
+    points: number;
+    action: GamificationPointsGainedAction;
+}
+/**
+ * Event emitted when gamification points are removed
+ */
+export interface GamificationPointsRemovedEvent extends BaseSDKEvent {
+    type: 'gamificationPointsRemoved';
+    points: number;
+    action: GamificationPointsRemovedAction;
+}
+/**
+ * Screen information for screen displayed events
+ */
+export interface ScreenInfo {
+    type: ScreenType;
+    feedId?: string;
+    relatedTopicId?: string | null;
+    postId?: string;
+    commentId?: string;
+    profileId?: string;
+}
+/**
+ * Event emitted when a screen is displayed
+ */
+export interface ScreenDisplayedEvent extends BaseSDKEvent {
+    type: 'screenDisplayed';
+    screen: ScreenInfo;
+}
+/**
+ * Event emitted when a notification is clicked
+ */
+export interface NotificationClickedEvent extends BaseSDKEvent {
+    type: 'notificationClicked';
+    notificationId: string;
+    contentId: string | null;
+}
+/**
+ * Event emitted when a post is clicked
+ */
+export interface PostClickedEvent extends BaseSDKEvent {
+    type: 'postClicked';
+    postId: string;
+    source: PostClickedSource;
+}
+/**
+ * Event emitted when the translation button is clicked
+ */
+export interface TranslationButtonClickedEvent extends BaseSDKEvent {
+    type: 'translationButtonClicked';
+    contentId: string;
+    viewTranslated: boolean;
+    contentKind: ContentKind;
+}
+/**
+ * Event emitted when the comment button is clicked
+ */
+export interface CommentButtonClickedEvent extends BaseSDKEvent {
+    type: 'commentButtonClicked';
+    postId: string;
+}
+/**
+ * Event emitted when the reply button is clicked
+ */
+export interface ReplyButtonClickedEvent extends BaseSDKEvent {
+    type: 'replyButtonClicked';
+    commentId: string;
+}
+/**
+ * Event emitted when the "see replies" button is clicked
+ */
+export interface SeeRepliesButtonClickedEvent extends BaseSDKEvent {
+    type: 'seeRepliesButtonClicked';
+    commentId: string;
+}
+/**
+ * Event emitted when a profile is modified
+ */
+export interface ProfileModifiedEvent extends BaseSDKEvent {
+    type: 'profileModified';
+    nicknameUpdated: boolean;
+    bioUpdated: boolean;
+    bioLength: number | null;
+    pictureUpdated: boolean;
+    hasPicture: boolean | null;
+}
+/**
+ * Event emitted when a session starts
+ */
+export interface SessionStartedEvent extends BaseSDKEvent {
+    type: 'sessionStarted';
+    sessionId: string;
+}
+/**
+ * Event emitted when a session stops
+ */
+export interface SessionStoppedEvent extends BaseSDKEvent {
+    type: 'sessionStopped';
+    sessionId: string;
+}
+/**
+ * Union type of all possible SDK events
+ */
+export type SDKEvent = PostCreatedEvent | CommentCreatedEvent | ReplyCreatedEvent | ContentDeletedEvent | ReactionModifiedEvent | PollVotedEvent | ContentReportedEvent | ProfileReportedEvent | GamificationPointsGainedEvent | GamificationPointsRemovedEvent | ScreenDisplayedEvent | NotificationClickedEvent | PostClickedEvent | TranslationButtonClickedEvent | CommentButtonClickedEvent | ReplyButtonClickedEvent | SeeRepliesButtonClickedEvent | ProfileModifiedEvent | SessionStartedEvent | SessionStoppedEvent;
+//# sourceMappingURL=sdkEvents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdkEvents.d.ts","sourceRoot":"","sources":["../../../../src/types/sdkEvents.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,20 @@
+/**
+ * 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 declare enum 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.
+     */
+    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.
+     */
+    handledByOctopus = "handledByOctopus"
+}
+//# sourceMappingURL=urlOpeningStrategy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"urlOpeningStrategy.d.ts","sourceRoot":"","sources":["../../../../src/types/urlOpeningStrategy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,kBAAkB;IAC5B;;;OAGG;IACH,YAAY,iBAAiB;IAE7B;;;OAGG;IACH,gBAAgB,qBAAqB;CACtC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"updateNotSeenNotificationsCount.d.ts","sourceRoot":"","sources":["../../../src/updateNotSeenNotificationsCount.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,+BAA+B,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octopus-community/react-native",
-  "version": "1.0.7",
+  "version": "1.9.1",
   "description": "React Native module for the Octopus Community SDK",
   "source": "./src/index.ts",
   "main": "./lib/module/index.js",
@@ -38,6 +38,7 @@
     "test:unit": "jest",
     "test:types": "tsc",
     "test:lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "lint:fix": "eslint \"**/*.{js,ts,tsx}\" --fix",
     "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
     "prepare": "typedoc && bob build"
   },

package/src/OctopusUIView.tsx

@@ -0,0 +1,57 @@
+import {
+  requireNativeComponent,
+  StyleSheet,
+  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>;
+}
+
+const NativeOctopusUIView =
+  requireNativeComponent<OctopusUIViewProps>('OctopusUIView');
+
+/**
+ * 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 function OctopusUIView({
+  interceptUrls = false,
+  style,
+}: OctopusUIViewProps) {
+  return (
+    <NativeOctopusUIView
+      interceptUrls={interceptUrls}
+      style={StyleSheet.flatten([styles.default, style])}
+    />
+  );
+}
+
+const styles = StyleSheet.create({
+  default: {
+    flex: 1,
+  },
+});

package/src/addHasAccessToCommunityListener.ts

@@ -0,0 +1,38 @@
+import { eventEmitter } from './internals/eventEmitter';
+
+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 function addHasAccessToCommunityListener(
+  callback: HasAccessToCommunityListenerCallback
+) {
+  return eventEmitter.addListener(
+    'hasAccessToCommunityChanged',
+    (data: { hasAccess: boolean }) => {
+      callback(data.hasAccess);
+    }
+  );
+}

package/src/addNavigateToUrlListener.ts

@@ -0,0 +1,54 @@
+import { eventEmitter } from './internals/eventEmitter';
+import { OctopusReactNativeSdk } from './internals/nativeModule';
+import {
+  type UrlOpeningStrategy,
+  UrlOpeningStrategy as UrlOpeningStrategyEnum,
+} from './types/urlOpeningStrategy';
+
+export type NavigateToUrlListenerCallback = (
+  url: string
+) => UrlOpeningStrategy | Promise<UrlOpeningStrategy>;
+
+/**
+ * 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: NavigateToUrlListenerCallback
+) {
+  return eventEmitter.addListener(
+    'navigateToUrl',
+    async (data: { url: string }) => {
+      const strategy = await Promise.resolve(callback(data.url));
+      if (strategy === UrlOpeningStrategyEnum.handledByOctopus) {
+        OctopusReactNativeSdk.handleUrlStrategy(
+          data.url,
+          UrlOpeningStrategyEnum.handledByOctopus
+        );
+      }
+    }
+  );
+}

package/src/addNotSeenNotificationsCountListener.ts

@@ -0,0 +1,35 @@
+import { eventEmitter } from './internals/eventEmitter';
+
+export type NotSeenNotificationsCountListenerCallback = (count: number) => void;
+
+/**
+ * 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: NotSeenNotificationsCountListenerCallback
+) {
+  return eventEmitter.addListener(
+    'notSeenNotificationsCountChanged',
+    (data: { count: number }) => {
+      callback(data.count);
+    }
+  );
+}

package/src/addSDKEventListener.ts

@@ -0,0 +1,49 @@
+import { eventEmitter } from './internals/eventEmitter';
+import type { SDKEvent } from './types/sdkEvents';
+
+export type SDKEventListenerCallback = (event: SDKEvent) => void;
+
+/**
+ * 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: SDKEventListenerCallback) {
+  return eventEmitter.addListener('sdkEvent', (data: SDKEvent) => {
+    callback(data);
+  });
+}

package/src/connectUser.ts

@@ -14,20 +14,36 @@ export interface ConnectUserParams {
      */
     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`.
+ * 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: ConnectUserParams): Promise<void> {
   return OctopusReactNativeSdk.connectUser(params);

package/src/index.ts

@@ -3,10 +3,23 @@ export * from './openUI';
 export * from './closeUI';
 export * from './connectUser';
 export * from './disconnectUser';
+export * from './trackCustomEvent';
+export * from './overrideDefaultLocale';
+export * from './updateNotSeenNotificationsCount';
+export * from './overrideCommunityAccess';
+export * from './trackCommunityAccess';
 export * from './addUserTokenRequestListener';
 export * from './useUserTokenProvider';
 export * from './addLoginRequiredListener';
 export * from './addEditUserListener';
+export * from './addNotSeenNotificationsCountListener';
+export * from './addHasAccessToCommunityListener';
+export * from './addSDKEventListener';
+export * from './addNavigateToUrlListener';
 export * from './types/userProfileField';
+export * from './types/sdkEvents';
+export * from './types/urlOpeningStrategy';
 export * from './logger';
 export * from './enums/LogLevel.enum';
+export { OctopusUIView } from './OctopusUIView';
+export type { OctopusUIViewProps } from './OctopusUIView';

package/src/initialize.ts

@@ -101,6 +101,18 @@ export interface OctopusTheme {
   };
 }
 
+/**
+ * UI customization options for platform-specific layout adjustments.
+ */
+export interface OctopusUIOptions {
+  /**
+   * Additional bottom inset applied to the Octopus UI.
+   * - On iOS, mapped to `bottomSafeAreaInset` (points)
+   * - On Android, mapped to `contentPadding` bottom (dp)
+   */
+  bottomSafeAreaInset?: number;
+}
+
 /**
  * Configuration params for initializing the Octopus SDK.
  */
@@ -125,31 +137,30 @@ export interface InitializeParams {
       };
   /** Optional theme customization for the Octopus UI */
   theme?: OctopusTheme;
+  /** Optional UI customization for layout-related tweaks */
+  ui?: OctopusUIOptions;
 }
 
 /**
  * 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' }
  * });
  * ```
  */