expo-callkit-telecom 0.1.0

package/android/src/main/java/expo/modules/callkittelecom/store/CallStore.kt

@@ -0,0 +1,181 @@
+package expo.modules.callkittelecom.store
+
+import expo.modules.callkittelecom.events.CallEventEmitter
+import expo.modules.callkittelecom.events.CallEvents
+import expo.modules.callkittelecom.models.CallSession
+import expo.modules.callkittelecom.models.CallSessionStatus
+import kotlinx.coroutines.channels.awaitClose
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.callbackFlow
+import java.util.LinkedHashMap
+import java.util.UUID
+
+/**
+ * Thread-safe in-memory store for active call sessions.
+ *
+ * Emits session add/update/remove events whenever the backing state changes.
+ */
+object CallStore {
+    private val lock = Any()
+    private val sessions = LinkedHashMap<UUID, CallSession>()
+
+    private data class SessionObserver(
+        val callback: (CallSession) -> Unit,
+        val filter: (CallSession) -> Boolean,
+    )
+
+    private val sessionObservers = mutableMapOf<UUID, MutableMap<UUID, SessionObserver>>()
+
+    /** Returns the first active session (single-call model). */
+    fun firstSession(): CallSession? =
+        synchronized(lock) {
+            sessions.values.firstOrNull()
+        }
+
+    /** Returns all sessions in insertion order. */
+    fun allSessions(): List<CallSession> =
+        synchronized(lock) {
+            sessions.values.toList()
+        }
+
+    /** Returns a session by call UUID, or null if missing. */
+    fun session(id: UUID): CallSession? =
+        synchronized(lock) {
+            sessions[id]
+        }
+
+    /** Adds a session and emits `onCallSessionAdded` if it did not already exist. */
+    fun add(session: CallSession) {
+        val sessionMap: Map<String, Any?>?
+        synchronized(lock) {
+            if (sessions.containsKey(session.id)) {
+                sessionMap = null
+            } else {
+                sessions[session.id] = session
+                sessionMap = session.toMap()
+            }
+        }
+        if (sessionMap != null) {
+            CallEventEmitter.send(
+                CallEvents.CALL_SESSION_ADDED,
+                mapOf("session" to sessionMap),
+            )
+        }
+    }
+
+    /** Removes a session and emits `onCallSessionRemoved` when present. */
+    fun remove(id: UUID) {
+        val removed =
+            synchronized(lock) {
+                sessions.remove(id) != null
+            }
+        if (removed) {
+            CallEventEmitter.send(CallEvents.CALL_SESSION_REMOVED, mapOf("id" to id.toString()))
+        }
+    }
+
+    /** Removes all sessions and emits `onCallSessionRemoved` for each prior ID. */
+    fun removeAll() {
+        val ids =
+            synchronized(lock) {
+                val sessionIds = sessions.keys.toList()
+                sessions.clear()
+                sessionIds
+            }
+        ids.forEach { id ->
+            CallEventEmitter.send(CallEvents.CALL_SESSION_REMOVED, mapOf("id" to id.toString()))
+        }
+    }
+
+    /** Applies a copy-on-write transform and emits `onCallSessionUpdated` when changed. */
+    fun update(
+        id: UUID,
+        transform: (CallSession) -> CallSession,
+    ) {
+        val sessionMap: Map<String, Any?>
+        val matchingObservers: List<Pair<SessionObserver, CallSession>>
+
+        synchronized(lock) {
+            val current = sessions[id] ?: return
+            val updated = transform(current)
+            if (updated == current) return
+            sessions[id] = updated
+            sessionMap = updated.toMap()
+
+            matchingObservers =
+                sessionObservers[id]?.values?.mapNotNull { observer ->
+                    if (observer.filter(updated)) observer to updated else null
+                } ?: emptyList()
+        }
+
+        matchingObservers.forEach { (observer, session) ->
+            observer.callback(session)
+        }
+
+        CallEventEmitter.send(
+            CallEvents.CALL_SESSION_UPDATED,
+            mapOf("session" to sessionMap),
+        )
+    }
+
+    /** Convenience status-only update helper. */
+    fun updateStatus(
+        id: UUID,
+        status: CallSessionStatus,
+    ) {
+        update(id) { it.copy(status = status) }
+    }
+
+    /** Convenience mute-state update helper. */
+    fun updateMuted(
+        id: UUID,
+        isMuted: Boolean,
+    ) {
+        update(id) { it.copy(isMuted = isMuted) }
+    }
+
+    /** Convenience hold-state update helper. */
+    fun updateHeld(
+        id: UUID,
+        isOnHold: Boolean,
+    ) {
+        update(id) { it.copy(isOnHold = isOnHold) }
+    }
+
+    /**
+     * Returns a [Flow] that emits session updates matching the optional filter.
+     *
+     * Immediately emits the current session if it exists and matches the filter.
+     * Useful for observing status transitions on a specific call.
+     */
+    fun sessionUpdates(
+        callId: UUID,
+        filter: (CallSession) -> Boolean = { true },
+    ): Flow<CallSession> =
+        callbackFlow {
+            val observerId = UUID.randomUUID()
+
+            synchronized(lock) {
+                val current = sessions[callId]
+                if (current != null && filter(current)) {
+                    trySend(current)
+                }
+
+                val observers = sessionObservers.getOrPut(callId) { mutableMapOf() }
+                observers[observerId] =
+                    SessionObserver(
+                        callback = { session -> trySend(session) },
+                        filter = filter,
+                    )
+            }
+
+            awaitClose {
+                synchronized(lock) {
+                    sessionObservers[callId]?.remove(observerId)
+                    if (sessionObservers[callId]?.isEmpty() == true) {
+                        sessionObservers.remove(callId)
+                    }
+                }
+            }
+        }
+}

package/android/src/main/java/expo/modules/callkittelecom/utils/CallKitTelecomLog.kt

@@ -0,0 +1,52 @@
+package expo.modules.callkittelecom.utils
+
+import android.content.Context
+import android.content.pm.ApplicationInfo
+import android.util.Log
+
+/**
+ * Debug-only logging wrapper for expo-calls.
+ *
+ * All log calls are no-ops in release builds (where `FLAG_DEBUGGABLE` is unset),
+ * eliminating both the I/O cost and the string-building cost of log messages.
+ * The `msg` parameter is an `inline` lambda so the string is never allocated
+ * when logging is disabled.
+ */
+object CallKitTelecomLog {
+    @Volatile
+    @PublishedApi
+    internal var enabled = false
+        private set
+
+    /** Call once during module/manager init to auto-detect debuggable flag. */
+    fun init(context: Context) {
+        enabled = (context.applicationInfo.flags and ApplicationInfo.FLAG_DEBUGGABLE) != 0
+    }
+
+    /** Allows tests or developer settings to override the auto-detected value. */
+    fun setEnabled(value: Boolean) {
+        enabled = value
+    }
+
+    inline fun d(
+        tag: String,
+        msg: () -> String,
+    ) {
+        if (enabled) Log.d(tag, msg())
+    }
+
+    inline fun w(
+        tag: String,
+        msg: () -> String,
+    ) {
+        if (enabled) Log.w(tag, msg())
+    }
+
+    inline fun e(
+        tag: String,
+        tr: Throwable? = null,
+        msg: () -> String,
+    ) {
+        if (enabled) Log.e(tag, msg(), tr)
+    }
+}

package/android/src/main/java/expo/modules/callkittelecom/utils/PermissionUtils.kt

@@ -0,0 +1,28 @@
+package expo.modules.callkittelecom.utils
+
+import android.Manifest
+import android.content.Context
+import android.content.pm.PackageManager
+import androidx.core.content.ContextCompat
+
+/** Utility helpers that map Android runtime permission checks to shared string statuses. */
+object PermissionUtils {
+    /** Returns `granted` or `denied` for a specific Android permission. */
+    private fun permissionStatus(
+        context: Context,
+        permission: String,
+    ): String =
+        if (
+            ContextCompat.checkSelfPermission(context, permission) == PackageManager.PERMISSION_GRANTED
+        ) {
+            "granted"
+        } else {
+            "denied"
+        }
+
+    /** Returns microphone permission status for `RECORD_AUDIO`. */
+    fun microphonePermission(context: Context): String = permissionStatus(context, Manifest.permission.RECORD_AUDIO)
+
+    /** Returns camera permission status for `CAMERA`. */
+    fun cameraPermission(context: Context): String = permissionStatus(context, Manifest.permission.CAMERA)
+}

package/android/src/main/res/drawable/expo_callkit_telecom_bg_answer.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<ripple xmlns:android="http://schemas.android.com/apk/res/android"
+    android:color="#4DFFFFFF">
+    <item>
+        <shape android:shape="oval">
+            <solid android:color="#34C759" />
+        </shape>
+    </item>
+</ripple>

package/android/src/main/res/drawable/expo_callkit_telecom_bg_avatar.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+    android:shape="oval">
+    <solid android:color="#1C1C2E" />
+</shape>

package/android/src/main/res/drawable/expo_callkit_telecom_bg_decline.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<ripple xmlns:android="http://schemas.android.com/apk/res/android"
+    android:color="#4DFFFFFF">
+    <item>
+        <shape android:shape="oval">
+            <solid android:color="#FF3B30" />
+        </shape>
+    </item>
+</ripple>

package/android/src/main/res/drawable/expo_callkit_telecom_ic_answer.xml

@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="28dp"
+    android:height="28dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M6.62,10.79c1.44,2.83 3.76,5.14 6.59,6.59l2.2,-2.2c0.27,-0.27 0.67,-0.36 1.02,-0.24 1.12,0.37 2.33,0.57 3.57,0.57 0.55,0 1,0.45 1,1V20c0,0.55 -0.45,1 -1,1 -9.39,0 -17,-7.61 -17,-17 0,-0.55 0.45,-1 1,-1h3.5c0.55,0 1,0.45 1,1 0,1.25 0.2,2.45 0.57,3.57 0.11,0.35 0.03,0.74 -0.25,1.02l-2.2,2.2z" />
+</vector>

package/android/src/main/res/drawable/expo_callkit_telecom_ic_decline.xml

@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="28dp"
+    android:height="28dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M12,9c-1.6,0 -3.15,0.25 -4.6,0.72v3.1c0,0.39 -0.23,0.74 -0.56,0.9 -0.98,0.49 -1.87,1.12 -2.66,1.85 -0.18,0.18 -0.43,0.28 -0.7,0.28 -0.28,0 -0.53,-0.11 -0.71,-0.29L0.29,13.08c-0.18,-0.17 -0.29,-0.42 -0.29,-0.7 0,-0.28 0.11,-0.53 0.29,-0.71C3.34,8.78 7.46,7 12,7s8.66,1.78 11.71,4.67c0.18,0.18 0.29,0.43 0.29,0.71 0,0.28 -0.11,0.53 -0.29,0.71l-2.48,2.48c-0.18,0.18 -0.43,0.29 -0.71,0.29 -0.27,0 -0.52,-0.11 -0.7,-0.28 -0.79,-0.74 -1.69,-1.36 -2.67,-1.85 -0.33,-0.16 -0.56,-0.5 -0.56,-0.9v-3.1C15.15,9.25 13.6,9 12,9z" />
+</vector>

package/android/src/main/res/drawable/expo_callkit_telecom_ic_videocam.xml

@@ -0,0 +1,9 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="28dp"
+    android:height="28dp"
+    android:viewportWidth="24"
+    android:viewportHeight="24">
+    <path
+        android:fillColor="#FFFFFF"
+        android:pathData="M17,10.5V7c0,-0.55 -0.45,-1 -1,-1H4c-0.55,0 -1,0.45 -1,1v10c0,0.55 0.45,1 1,1h12c0.55,0 1,-0.45 1,-1v-3.5l4,4v-11l-4,4z" />
+</vector>

package/android/src/main/res/layout/activity_incoming_call.xml

@@ -0,0 +1,169 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:background="#0D0D0D"
+    android:gravity="center_horizontal"
+    android:orientation="vertical">
+
+    <!-- App branding -->
+    <LinearLayout
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="56dp"
+        android:gravity="center_vertical"
+        android:orientation="horizontal">
+
+        <ImageView
+            android:id="@+id/expo_callkit_telecom_app_icon"
+            android:layout_width="20dp"
+            android:layout_height="20dp"
+            android:layout_marginEnd="6dp"
+            android:importantForAccessibility="no" />
+
+        <TextView
+            android:id="@+id/expo_callkit_telecom_app_name"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:fontFamily="sans-serif-medium"
+            android:textColor="#8E8E93"
+            android:textSize="14sp" />
+    </LinearLayout>
+
+    <!-- Top spacer pushes caller info toward upper-center -->
+    <View
+        android:layout_width="0dp"
+        android:layout_height="0dp"
+        android:layout_weight="2" />
+
+    <!-- Caller avatar circle with image or initial fallback -->
+    <FrameLayout
+        android:layout_width="88dp"
+        android:layout_height="88dp"
+        android:background="@drawable/expo_callkit_telecom_bg_avatar">
+
+        <ImageView
+            android:id="@+id/expo_callkit_telecom_avatar_image"
+            android:layout_width="match_parent"
+            android:layout_height="match_parent"
+            android:importantForAccessibility="no"
+            android:scaleType="centerCrop"
+            android:visibility="gone" />
+
+        <TextView
+            android:id="@+id/expo_callkit_telecom_avatar_text"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:layout_gravity="center"
+            android:fontFamily="sans-serif-medium"
+            android:textColor="#FFFFFF"
+            android:textSize="34sp" />
+    </FrameLayout>
+
+    <View
+        android:layout_width="0dp"
+        android:layout_height="24dp" />
+
+    <!-- Caller display name -->
+    <TextView
+        android:id="@+id/expo_callkit_telecom_caller_name"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:fontFamily="sans-serif-medium"
+        android:letterSpacing="-0.01"
+        android:textColor="#FFFFFF"
+        android:textSize="26sp" />
+
+    <View
+        android:layout_width="0dp"
+        android:layout_height="8dp" />
+
+    <!-- Call type subtitle -->
+    <TextView
+        android:id="@+id/expo_callkit_telecom_subtitle"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:fontFamily="sans-serif"
+        android:textColor="#8E8E93"
+        android:textSize="16sp" />
+
+    <!-- Middle spacer pushes buttons toward bottom -->
+    <View
+        android:layout_width="0dp"
+        android:layout_height="0dp"
+        android:layout_weight="3" />
+
+    <!-- Answer and decline buttons -->
+    <LinearLayout
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:gravity="center"
+        android:orientation="horizontal">
+
+        <!-- Decline button column -->
+        <LinearLayout
+            android:layout_width="0dp"
+            android:layout_height="wrap_content"
+            android:layout_weight="1"
+            android:gravity="center_horizontal"
+            android:orientation="vertical">
+
+            <ImageButton
+                android:id="@+id/expo_callkit_telecom_decline_button"
+                android:layout_width="64dp"
+                android:layout_height="64dp"
+                android:background="@drawable/expo_callkit_telecom_bg_decline"
+                android:contentDescription="Decline"
+                android:scaleType="center"
+                android:src="@drawable/expo_callkit_telecom_ic_decline" />
+
+            <View
+                android:layout_width="0dp"
+                android:layout_height="12dp" />
+
+            <TextView
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:fontFamily="sans-serif"
+                android:text="Decline"
+                android:textColor="#8E8E93"
+                android:textSize="13sp" />
+        </LinearLayout>
+
+        <!-- Answer button column -->
+        <LinearLayout
+            android:layout_width="0dp"
+            android:layout_height="wrap_content"
+            android:layout_weight="1"
+            android:gravity="center_horizontal"
+            android:orientation="vertical">
+
+            <ImageButton
+                android:id="@+id/expo_callkit_telecom_answer_button"
+                android:layout_width="64dp"
+                android:layout_height="64dp"
+                android:background="@drawable/expo_callkit_telecom_bg_answer"
+                android:contentDescription="Answer"
+                android:scaleType="center"
+                android:src="@drawable/expo_callkit_telecom_ic_answer" />
+
+            <View
+                android:layout_width="0dp"
+                android:layout_height="12dp" />
+
+            <TextView
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:fontFamily="sans-serif"
+                android:text="Answer"
+                android:textColor="#8E8E93"
+                android:textSize="13sp" />
+        </LinearLayout>
+    </LinearLayout>
+
+    <!-- Bottom padding -->
+    <View
+        android:layout_width="0dp"
+        android:layout_height="56dp" />
+
+</LinearLayout>

package/app.json

@@ -0,0 +1,8 @@
+{
+  "android": {
+    "package": "com.mfairley.expocallkittelecom"
+  },
+  "ios": {
+    "bundleIdentifier": "com.mfairley.expocallkittelecom"
+  }
+}

package/app.plugin.js

@@ -0,0 +1 @@
+module.exports = require("./plugin/build/withExpoCallKitTelecom");