@kaleyra/video-react-native-module 1.0.0

package/native-bridge/TypeScript/errors/IllegalArgumentError.ts

@@ -0,0 +1,9 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+/**
+ * This error will be thrown when arguments given to a function are not of the expected type
+ */
+export class IllegalArgumentError extends Error {
+  name = 'IllegalArgumentError';
+}

package/native-bridge/TypeScript/types/AccessTokenRequest.ts

@@ -0,0 +1,7 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+export interface AccessTokenRequest {
+    requestID: string;
+    userID: string;
+}

package/native-bridge/TypeScript/types/AccessTokenResponse.ts

@@ -0,0 +1,41 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+/**
+ * @ignore
+ */
+export class AccessTokenResponse {
+  constructor(
+    requestID: string,
+    success: boolean,
+    data: string,
+    error: string
+  ) {
+    this.requestID = requestID;
+    this.success = success;
+    this.data = data;
+    this.error = error;
+  }
+
+  static failed(requestID: string, reason?: string): AccessTokenResponse {
+    return {
+      requestID,
+      success: false,
+      data: '',
+      error: reason,
+    };
+  }
+
+  static success(requestID: string, token: string): AccessTokenResponse {
+    return {
+      requestID,
+      success: true,
+      data: token,
+    };
+  }
+
+  requestID: string;
+  success: boolean;
+  data: string;
+  error?: string;
+}

package/native-bridge/TypeScript/types/AudioCallOptions.ts

@@ -0,0 +1,15 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+import {CallOptions} from "./CallOptions";
+import {AudioCallType} from "./AudioCallType";
+
+/**
+ * Audio call options used for chat
+ */
+export interface AudioCallOptions extends CallOptions {
+    /**
+     * Type of audioCall to launch when an option of the chat is tapped.
+     */
+    type: AudioCallType;
+}

package/native-bridge/TypeScript/types/AudioCallType.ts

@@ -0,0 +1,17 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+/**
+ * This class defines the types of audio calls supported.
+ */
+export enum AudioCallType {
+  /**
+   * Audio only is a call that will only use the microphone
+   */
+  AUDIO = 'audio',
+
+  /**
+   * Audio Upgradable is a call a type of call that starts in audio only and may be upgraded to audio&video type
+   */
+  AUDIO_UPGRADABLE = 'audioUpgradable',
+}

package/native-bridge/TypeScript/types/CallDisplayMode.ts

@@ -0,0 +1,22 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+/**
+ * This class defines the display modes supported per call.
+ */
+export enum CallDisplayMode {
+  /**
+   * The call UI fits completely the available window.
+   */
+  FOREGROUND = 'FOREGROUND',
+
+  /**
+   * If the device has picture in picture feature the call UI is floating on the screen's device.
+   */
+  FOREGROUND_PICTURE_IN_PICTURE = 'FOREGROUND_PICTURE_IN_PICTURE',
+
+  /**
+   * The call UI is not visible to the user.
+   */
+  BACKGROUND = 'BACKGROUND',
+}

package/native-bridge/TypeScript/types/CallKitConfiguration.ts

@@ -0,0 +1,32 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+/**
+ * Configuration for callkit
+ */
+export interface CallKitConfiguration {
+
+    /**
+     * Set to false to disable
+     * <br/>
+     * <br/>
+     * <b><font color="blue">default</font>: true</b>
+     */
+    enabled?: boolean;
+
+    /**
+     * The icon resource name to be used in the callkit UI to represent the app
+     * <br/>
+     * <br/>
+     * <b><font color="blue">default</font>: null</b>
+     */
+    appIconName?: string;
+
+    /**
+     * The ringtone resource name to be used when callkit is launched
+     * <br/>
+     * <br/>
+     * <b><font color="blue">default</font>: system</b>
+     */
+    ringtoneSoundName?: string;
+}

package/native-bridge/TypeScript/types/CallOptions.ts

@@ -0,0 +1,18 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+import {RecordingType} from "./RecordingType";
+
+/**
+ * Options available for a call
+ */
+export interface CallOptions {
+
+    /**
+     * May have three different values, NONE, AUTOMATIC, MANUAL
+     * <br/>
+     * <br/>
+     * <b><font color="blue">default</font>: none</b>
+     */
+    recordingType?: RecordingType;
+}

package/native-bridge/TypeScript/types/CallType.ts

@@ -0,0 +1,22 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+/**
+ * This class defines the types of calls supported.
+ */
+export enum CallType {
+  /**
+   * Audio only is a call that will only use the microphone
+   */
+  AUDIO = 'audio',
+
+  /**
+   * Audio Upgradable is a call a type of call that starts in audio only and may be upgraded to audio&video type
+   */
+  AUDIO_UPGRADABLE = 'audioUpgradable',
+
+  /**
+   * Audio Video is a call that will use both the camera and the microphone
+   */
+  AUDIO_VIDEO = 'audioVideo',
+}

package/native-bridge/TypeScript/types/ChatToolConfiguration.ts

@@ -0,0 +1,21 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+import {CallOptions} from "./CallOptions";
+import {AudioCallOptions} from "./AudioCallOptions";
+
+/**
+ * Chat tool configuration
+ */
+export interface ChatToolConfiguration {
+
+    /**
+     * Defining this object will enable an option to start an audio call from chat UI
+     */
+    audioCallOption?: AudioCallOptions;
+
+    /**
+     * Defining this object will enable an option to start an audio&video call from chat UI
+     */
+    videoCallOption?: CallOptions;
+}

package/native-bridge/TypeScript/types/CreateCallOptions.ts

@@ -0,0 +1,20 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+import { CallType } from './CallType';
+import { CallOptions } from './CallOptions';
+
+/**
+ * Options to be used when creating a call
+ */
+export interface CreateCallOptions extends CallOptions {
+  /**
+   * Array of callees identifiers to call.
+   */
+  callees: string[];
+
+  /**
+   * Type of call to create
+   */
+  callType: CallType;
+}

package/native-bridge/TypeScript/types/Environment.ts

@@ -0,0 +1,12 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+/**
+ * An environment where your integration will run
+ */
+export interface Environment {
+  /**
+   * name of the environment
+   */
+  name: string;
+}

package/native-bridge/TypeScript/types/IosConfiguration.ts

@@ -0,0 +1,29 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+import {CallKitConfiguration} from "./CallKitConfiguration";
+import {VoipHandlingStrategy} from "./VoipHandlingStrategy";
+
+/**
+ * Configuration for iOS platform
+ */
+export interface IosConfiguration {
+
+    /**
+     * Specify the callkit configuration to enable the usage and it's behaviour
+     * <br/>
+     * <br/>
+     * <b><font color="blue">default</font>: enabled</b>
+     */
+    callkit?: CallKitConfiguration;
+
+    /**
+     * Specify the voip handling strategy.
+     * <br/>
+     * This allows you to disable or leave the plugin behaviour for handling the voip notifications.
+     * <br/>
+     * <br/>
+     * <b><font color="blue">default</font>: VoipHandlingStrategy.AUTOMATIC </b>
+     */
+    voipHandlingStrategy?: VoipHandlingStrategy;
+}

package/native-bridge/TypeScript/types/KaleyraVideoConfiguration.ts

@@ -0,0 +1,42 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+import { IosConfiguration } from "./IosConfiguration";
+import { Tools } from "./Tools";
+import { Environment } from "./Environment";
+import { Region } from "./Region";
+
+/**
+ * Generic configuration used for setup
+ */
+export interface KaleyraVideoConfiguration {
+  /**
+   * This key will be provided to you by us.
+   */
+  appID: string;
+
+  /**
+   * This variable defines the environment where you will be sandbox or production.
+   */
+  environment: Environment;
+
+  /**
+   * This variable defines the region where you will be europe, india or us.
+   */
+  region: Region;
+
+  /**
+   * Set to true to enable log, default value is false
+   */
+  logEnabled?: boolean;
+
+  /**
+   * Define the tools to use
+   */
+  tools?: Tools;
+
+  /**
+   * Define to customize the iOS configuration
+   */
+  iosConfig?: IosConfiguration;
+}

package/native-bridge/TypeScript/types/RecordingType.ts

@@ -0,0 +1,22 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+/**
+ * Recording type of the call
+ */
+export enum RecordingType {
+  /**
+   * The call will be recorded on demand
+   */
+  MANUAL = 'manual',
+
+  /**
+   * The call will be recorded as soon it starts
+   */
+  AUTOMATIC = 'automatic',
+
+  /**
+   * The call will not be recorded
+   */
+  NONE = 'none',
+}

package/native-bridge/TypeScript/types/Region.ts

@@ -0,0 +1,12 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+/**
+ * A region where your integration will run
+ */
+export interface Region {
+  /**
+   * name of the region
+   */
+  name: string;
+}

package/native-bridge/TypeScript/types/ScreenShareToolConfiguration.ts

@@ -0,0 +1,24 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+/**
+ * Screen Share tool configuration
+ */
+export interface ScreenShareToolConfiguration {
+
+    /**
+     * Set to true to enable the in app screen share
+     * <br/>
+     * <br/>
+     * <b><font color="blue">default</font>: false</b>
+     */
+    inApp?: boolean;
+
+    /**
+     * Set to true to enable the whole device screen share
+     * <br/>
+     * <br/>
+     * <b><font color="blue">default</font>: false</b>
+     */
+    wholeDevice?: boolean;
+}

package/native-bridge/TypeScript/types/Session.ts

@@ -0,0 +1,20 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+/**
+ * Session
+ */
+export interface Session {
+  /**
+   * The user id you want to connect
+   */
+  userID: string;
+
+  /**
+   * The Kaleyra Video SDK adopts a strong authentication mechanism based on JWT access tokens.
+   * Whenever the SDK needs an access token for a particular user, this component will be asked to provide an access token for a particular user.
+   * @param userId the user which requires a token refresh
+   * @returns a promise containing the access token if completed successfully.
+   */
+  accessTokenProvider(userId: string): Promise<string>;
+}

package/native-bridge/TypeScript/types/Tools.ts

@@ -0,0 +1,50 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+import {ScreenShareToolConfiguration} from "./ScreenShareToolConfiguration";
+import {ChatToolConfiguration} from "./ChatToolConfiguration";
+
+/**
+ * Video Module Tools
+ */
+export interface Tools {
+    /**
+     * Set to true to enable the file sharing feature
+     * <br/>
+     * <br/>
+     * <b><font color="blue">default</font>: false</b>
+     */
+    fileShare?: boolean;
+
+    /**
+     * Set to enable the screen sharing feature
+     * <br/>
+     * <br/>
+     * <b><font color="blue">default</font>: no screen share</b>
+     */
+    screenShare?: ScreenShareToolConfiguration;
+
+    /**
+     * Set to enable the chat feature
+     * <br/>
+     * <br/>
+     * <b><font color="blue">default</font>: no chat</b>
+     */
+    chat?: ChatToolConfiguration;
+
+    /**
+     * Set to true to enable the whiteboard feature
+     * <br/>
+     * <br/>
+     * <b><font color="blue">default</font>: false</b>
+     */
+    whiteboard?: boolean;
+
+    /**
+     * Set to true to enable the feedback request after a call ends.
+     * <br/>
+     * <br/>
+     * <b><font color="blue">default</font>: false</b>
+     */
+    feedback?: boolean;
+}

package/native-bridge/TypeScript/types/UserDetails.ts

@@ -0,0 +1,37 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+/**
+ * This is used to define the user details in the call/chat UI
+ */
+export interface UserDetails {
+  /**
+   * User identifier
+   */
+  userID: string;
+
+  /**
+   * Nickname for the user
+   */
+  nickName?: string;
+
+  /**
+   * First name of the user
+   */
+  firstName?: string;
+
+  /**
+   * Last name of the user
+   */
+  lastName?: string;
+
+  /**
+   * Email of the user
+   */
+  email?: string;
+
+  /**
+   * Image url to use as placeholder for the user.
+   */
+  profileImageUrl?: string;
+}

package/native-bridge/TypeScript/types/UserDetailsFormat.ts

@@ -0,0 +1,23 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+/**
+ * This is used to display the user details in the call/chat UI
+ */
+export interface UserDetailsFormat {
+  /**
+   * Format to be used to display a user details on the call/chat UI
+   * <br/>
+   * <br/>
+   * <b><font color="blue">default</font>: ${userAlias}</b>
+   */
+  default: string;
+
+  /**
+   * Format to be used when displaying an android notification
+   * <br/>
+   * <br/>
+   * <b><font color="blue">default</font>: equals to UserDetailsFormatter.default</b>
+   */
+  androidNotification?: string;
+}

package/native-bridge/TypeScript/types/VoipHandlingStrategy.ts

@@ -0,0 +1,17 @@
+// Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+// See LICENSE for licensing information
+
+/**
+ * This class defines the voip notification strategy per call.
+ */
+export enum VoipHandlingStrategy {
+  /**
+   * The voip notifications will not be handled
+   */
+  DISABLED = 'disabled',
+
+  /**
+   * The voip notifications will be handled automatically from the plugin
+   */
+  AUTOMATIC = 'automatic',
+}

package/native-bridge/android/build.gradle

@@ -0,0 +1,72 @@
+buildscript {
+  ext.kotlin_version = '1.6.10'
+  repositories {
+    google()
+    mavenLocal()
+    mavenCentral()
+    maven { url 'https://maven.bandyer.com/releases' }
+    maven { url 'https://jitpack.io' }
+  }
+
+  dependencies {
+    classpath 'com.android.tools.build:gradle:7.1.2'
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+  }
+}
+
+allprojects {
+  repositories {
+    google()
+    mavenLocal()
+    mavenCentral()
+    maven { url 'https://maven.bandyer.com/releases' }
+    maven { url 'https://jitpack.io' }
+  }
+}
+
+apply plugin: 'kotlin-android'
+apply plugin: 'kotlin-kapt'
+
+android {
+  compileSdkVersion 31
+
+  defaultConfig {
+    minSdkVersion 21
+    testInstrumentationRunner "com.kaleyra.video_hybrid_native_bridge.utils.RandomRunner"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  kotlinOptions {
+    jvmTarget = '1.8'
+  }
+
+  sourceSets {
+    main.java.srcDirs += 'src/main/kotlin'
+  }
+
+  testOptions {
+    unitTests.returnDefaultValues = true
+  }
+
+}
+
+dependencies {
+  implementation 'com.google.code.gson:gson:2.9.1'
+  implementation "com.kaleyra:collaboration-suite-utils:3.0.3"
+  implementation "com.bandyer:bandyer-android-sdk:3.6.1"
+  implementation "org.jetbrains.kotlin:kotlin-reflect:$kotlin_version"
+  compileOnly "org.jetbrains.kotlinx:kotlinx-serialization-json:1.3.1"
+  implementation "androidx.room:room-runtime:2.4.2"
+  kapt "androidx.room:room-compiler:2.4.2"
+
+  /*** Testing ***/
+  testImplementation 'junit:junit:4.13.2'
+  testImplementation 'io.mockk:mockk:1.13.2'
+  testImplementation "org.json:json:20180813"
+  testImplementation 'org.jetbrains.kotlinx:kotlinx-coroutines-test:1.6.4'
+  testImplementation "com.github.ologe:flow-test-observer:1.5.1"
+}

package/native-bridge/android/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,5 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.4-bin.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

package/native-bridge/android/gradle.properties

@@ -0,0 +1,22 @@
+# Copyright © 2018-2023 Kaleyra S.p.a. All Rights Reserved.
+# See LICENSE for licensing information
+
+# Project-wide Gradle settings.
+
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+android.enableJetifier=true
+android.useAndroidX=true
+org.gradle.jvmargs=-Xmx1536m
+
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true