2.0.0

FloconAndroid/.vscode/settings.json

@@ -1,3 +1,3 @@
 {
-    "java.configuration.updateBuildConfiguration": "interactive"
+    "java.configuration.updateBuildConfiguration": "automatic"
 }

FloconAndroid/AGENT.md

@@ -0,0 +1,52 @@
+# Flocon Project Overview
+
+Flocon is a modular, plugin-based framework built with **Kotlin Multiplatform (KMP)**. It provides a standardized way to integrate common cross-cutting concerns like networking, database access, datastores, and deep linking into applications.
+
+## 🚀 Key Features
+
+- **Modular Architecture**: Separate modules for different functionalities (network, database, etc.).
+- **Plugin System**: Easily extensible with "no-op" variants for testing and modularity.
+- **KMP Support**: Targets Android, iOS, JVM, and WasmJs.
+- **Modern Tech Stack**: Uses Room 3, Ktor, OkHttp, gRPC, and Compose Multiplatform.
+
+## 🛠 Technical Stack
+
+- **Kotlin**: 2.1.0
+- **Build System**: Gradle with Version Catalog (`libs.versions.toml`).
+- **Dependency Injection**: Manual / Constructor injection (based on current exploration).
+- **Asynchronous Programming**: Kotlin Coroutines & Flow.
+- **Networking**: Ktor 3.x, OkHttp 4.x, gRPC 1.70.x.
+- **Database**: Room 2.x & Room 3.0.0-alpha01.
+- **UI**: Compose Multiplatform 1.9.0.
+
+## 📂 Module Structure
+
+- `:flocon`: Core library providing the plugin registration and context management.
+- `:database`: 
+    - `:database:core`: Abstractions for database providers.
+    - `:database:room` / `:database:room3`: Room-based implementations.
+- `:network`:
+    - `:network:core`: Core networking abstractions.
+    - `:network:okhttp-interceptor` / `:network:ktor-interceptor`: Client-specific interceptors.
+- `:grpc`:
+    - `:grpc-interceptor`: Interceptors for gRPC calls.
+- `:datastores`: Modules for Typed DataStore integration.
+- `:deeplinks`: Abstractions and implementations for handling deep links.
+
+## 🧩 Core Concepts
+
+### Plugins
+Flocon operates on a plugin-based architecture. Modules typically provide a "Core" or implementation module and a "No-Op" module. The No-Op modules allow the app to compile and run without the actual implementation, which is useful for specialized builds or testing.
+
+### Interceptors
+For networking and gRPC, Flocon uses an interceptor-based approach to hook into the communication pipeline of standard libraries (OkHttp, Ktor, gRPC).
+
+## 📖 Development Guidelines
+
+- **Multiplatform First**: Always consider KMP compatibility when adding new features or modules.
+- **Modularity**: Keep modules focused and avoid circular dependencies.
+- **Naming Conventions**: Follow the `io.github.openflocon.flocon` package naming structure.
+- **Version Catalog**: All dependency versions must be managed in `gradle/libs.versions.toml`.
+
+---
+*Created by Antigravity AI to assist in project understanding.*

FloconAndroid/okhttp-interceptor-no-op/build.gradle.kts → FloconAndroid/analytics-no-op/build.gradle.kts

@@ -1,13 +1,36 @@
-import org.jetbrains.kotlin.gradle.dsl.JvmTarget
-
 plugins {
+    alias(libs.plugins.kotlin.multiplatform)
     alias(libs.plugins.android.library)
-    alias(libs.plugins.kotlin.android)
-    id("com.vanniktech.maven.publish") version "0.34.0"
+    alias(libs.plugins.vanniktech.maven.publish)
+}
+
+kotlin {
+    androidTarget {
+        compilations.all {
+            kotlinOptions {
+                jvmTarget = "11"
+            }
+        }
+    }
+
+    jvm()
+
+    iosX64()
+    iosArm64()
+    iosSimulatorArm64()
+
+    sourceSets {
+        val commonMain by getting {
+            dependencies {
+                implementation(project(":flocon"))
+                implementation(libs.kotlinx.coroutines.core)
+            }
+        }
+    }
 }
 
 android {
-    namespace = "io.github.openflocon.flocon.okhttp"
+    namespace = "io.github.openflocon.flocon.analytics.noop"
     compileSdk = 36
 
     defaultConfig {
@@ -26,24 +49,12 @@ android {
             )
         }
     }
-
     compileOptions {
         sourceCompatibility = JavaVersion.VERSION_11
         targetCompatibility = JavaVersion.VERSION_11
     }
 }
 
-dependencies {
-    implementation(platform(libs.okhttp.bom))
-    implementation(libs.okhttp3.okhttp)
-}
-
-kotlin {
-    compilerOptions {
-        jvmTarget.set(JvmTarget.JVM_11)
-    }
-}
-
 mavenPublishing {
     publishToMavenCentral(automaticRelease = true)
 
@@ -55,12 +66,12 @@ mavenPublishing {
 
     coordinates(
         groupId = project.property("floconGroupId") as String,
-        artifactId = "flocon-okhttp-interceptor-no-op",
+        artifactId = "flocon-analytics-no-op",
         version = System.getenv("PROJECT_VERSION_NAME") ?: project.property("floconVersion") as String
     )
 
     pom {
-        name = "Flocon OkHttp Interceptor"
+        name = "Flocon Analytics No-Op"
         description = project.property("floconDescription") as String
         inceptionYear = "2025"
         url = "https://github.com/openflocon/Flocon"
@@ -84,4 +95,4 @@ mavenPublishing {
             developerConnection = "scm:git:ssh://git@github.com/openflocon/Flocon.git"
         }
     }
-}
+}

FloconAndroid/analytics-no-op/src/commonMain/kotlin/io/github/openflocon/flocon/plugins/analytics/FloconAnalyticsNoOp.kt

@@ -0,0 +1,47 @@
+package io.github.openflocon.flocon.plugins.analytics
+
+import io.github.openflocon.flocon.FloconConfig
+import io.github.openflocon.flocon.FloconContext
+import io.github.openflocon.flocon.FloconPlugin
+import io.github.openflocon.flocon.FloconPluginConfig
+import io.github.openflocon.flocon.FloconPluginFactory
+import io.github.openflocon.flocon.Protocol
+import io.github.openflocon.flocon.plugins.analytics.model.AnalyticsItem
+
+class FloconAnalyticsConfig : FloconPluginConfig
+
+interface FloconAnalyticsPlugin : FloconPlugin {
+    fun registerAnalytics(analyticsItems: List<AnalyticsItem>)
+}
+
+object FloconAnalytics : FloconPluginFactory<FloconAnalyticsConfig, FloconAnalyticsPlugin> {
+    override val name: String = "Analytics"
+    override val pluginId: String = Protocol.ToDevice.Analytics.Plugin
+    override fun createConfig(context: FloconContext) = FloconAnalyticsConfig()
+    override fun install(
+        pluginConfig: FloconAnalyticsConfig,
+        floconConfig: FloconConfig
+    ): FloconAnalyticsPlugin {
+        return FloconAnalyticsNoOpImpl()
+    }
+}
+
+internal class FloconAnalyticsNoOpImpl : FloconPlugin, FloconAnalyticsPlugin {
+    override val key: String
+        get() = Protocol.ToDevice.Analytics.Plugin
+
+    override suspend fun onMessageReceived(
+        method: String,
+        body: String,
+    ) {
+        // no op
+    }
+
+    override suspend fun onConnectedToServer() {
+        // no op
+    }
+
+    override fun registerAnalytics(analyticsItems: List<AnalyticsItem>) {
+        // no op
+    }
+}

FloconAndroid/analytics-no-op/src/commonMain/kotlin/io/github/openflocon/flocon/plugins/analytics/builder/AnalyticsBuilder.kt

@@ -0,0 +1,17 @@
+package io.github.openflocon.flocon.plugins.analytics.builder
+
+import io.github.openflocon.flocon.plugins.analytics.FloconAnalyticsPlugin
+import io.github.openflocon.flocon.plugins.analytics.model.AnalyticsEvent
+
+class AnalyticsBuilder(
+    val analyticsTableId: String,
+    private val analyticsPlugin: FloconAnalyticsPlugin?,
+) {
+    fun logEvents(vararg events: AnalyticsEvent) {
+        // no-op
+    }
+
+    fun logEvents(events: List<AnalyticsEvent>) {
+        // no-op
+    }
+}

FloconAndroid/flocon-base/src/commonMain/kotlin/io/github/openflocon/flocon/plugins/analytics/model/AnalyticsEvent.kt → FloconAndroid/analytics-no-op/src/commonMain/kotlin/io/github/openflocon/flocon/plugins/analytics/model/AnalyticsEvent.kt

@@ -8,4 +8,4 @@ data class AnalyticsEvent(
         eventName: String,
         vararg properties: AnalyticsPropertiesConfig,
     ) : this(eventName, properties.toList())
-}
+}

FloconAndroid/flocon-base/src/commonMain/kotlin/io/github/openflocon/flocon/plugins/analytics/model/TableItem.kt → FloconAndroid/analytics-no-op/src/commonMain/kotlin/io/github/openflocon/flocon/plugins/analytics/model/AnalyticsItem.kt

@@ -6,4 +6,4 @@ data class AnalyticsItem(
     val eventName: String,
     val createdAt: Long,
     val properties: List<AnalyticsPropertiesConfig>,
-)
+)

FloconAndroid/flocon-base/src/commonMain/kotlin/io/github/openflocon/flocon/plugins/analytics/model/AnalyticsPropertiesConfig.kt → FloconAndroid/analytics-no-op/src/commonMain/kotlin/io/github/openflocon/flocon/plugins/analytics/model/AnalyticsPropertiesConfig.kt

@@ -8,4 +8,4 @@ data class AnalyticsPropertiesConfig(
 infix fun String.analyticsProperty(value: String) = AnalyticsPropertiesConfig(
     name = this,
     value = value,
-)
+)

FloconAndroid/analytics/build.gradle.kts

@@ -0,0 +1,28 @@
+plugins {
+    id("flocon.kotlin.multiplatform")
+    id("flocon.publish")
+}
+
+kotlin {
+    sourceSets {
+        val commonMain by getting {
+            dependencies {
+                implementation(project(":flocon"))
+                implementation(libs.kotlinx.coroutines.core)
+                implementation(libs.kotlinx.serialization.json)
+            }
+        }
+    }
+}
+
+android {
+    namespace = "io.github.openflocon.flocon.analytics"
+}
+
+mavenPublishing {
+    coordinates(
+        groupId = project.property("floconGroupId") as String,
+        artifactId = "flocon-analytics",
+        version = System.getenv("PROJECT_VERSION_NAME") ?: project.property("floconVersion") as String
+    )
+}

FloconAndroid/analytics/src/commonMain/kotlin/io/github/openflocon/flocon/analytics/FloconAnalyticsPlugin.kt

@@ -0,0 +1,72 @@
+package io.github.openflocon.flocon.analytics
+
+import io.github.openflocon.flocon.FloconConfig
+import io.github.openflocon.flocon.FloconContext
+import io.github.openflocon.flocon.FloconLogger
+import io.github.openflocon.flocon.FloconPlugin
+import io.github.openflocon.flocon.FloconPluginConfig
+import io.github.openflocon.flocon.FloconPluginFactory
+import io.github.openflocon.flocon.Protocol
+import io.github.openflocon.flocon.core.FloconEncoder
+import io.github.openflocon.flocon.core.FloconMessageSender
+import io.github.openflocon.flocon.core.encode
+import io.github.openflocon.flocon.analytics.model.AnalyticsItem
+
+class FloconAnalyticsConfig : FloconPluginConfig
+
+interface FloconAnalyticsPlugin : FloconPlugin {
+    fun registerAnalytics(analyticsItems: List<AnalyticsItem>)
+}
+
+object FloconAnalytics : FloconPluginFactory<FloconAnalyticsConfig, FloconAnalyticsPlugin> {
+    override val name: String = "Analytics"
+    override val pluginId: String = Protocol.ToDevice.Analytics.Plugin
+    override fun createConfig(context: FloconContext) = FloconAnalyticsConfig()
+    override fun install(
+        pluginConfig: FloconAnalyticsConfig,
+        floconConfig: FloconConfig,
+        encoder: FloconEncoder
+    ): FloconAnalyticsPlugin {
+        return FloconAnalyticsPluginImpl(
+            sender = floconConfig.client as FloconMessageSender,
+            encoder = encoder
+        )
+    }
+}
+
+internal class FloconAnalyticsPluginImpl(
+    private val sender: FloconMessageSender,
+    private val encoder: FloconEncoder
+) : FloconPlugin, FloconAnalyticsPlugin {
+    override val key: String
+        get() = Protocol.ToDevice.Analytics.Plugin
+
+    override suspend fun onMessageReceived(
+        method: String,
+        body: String,
+    ) {
+        // no op
+    }
+
+    override suspend fun onConnectedToServer() {
+        // no op
+    }
+
+    override fun registerAnalytics(analyticsItems: List<AnalyticsItem>) {
+        sendAnalytics(analyticsItems)
+    }
+
+    private fun sendAnalytics(analyticsItems: List<AnalyticsItem>) {
+        analyticsItems.takeIf { it.isNotEmpty() }?.forEach { toSend ->
+            try {
+                sender.send(
+                    plugin = Protocol.FromDevice.Analytics.Plugin,
+                    method = Protocol.FromDevice.Analytics.Method.AddItems,
+                    body = encoder.encode(toSend)
+                )
+            } catch (t: Throwable) {
+                FloconLogger.logError("error on sendAnalytics", t)
+            }
+        }
+    }
+}

FloconAndroid/flocon-base/src/commonMain/kotlin/io/github/openflocon/flocon/plugins/analytics/builder/AnalyticsBuilder.kt → FloconAndroid/analytics/src/commonMain/kotlin/io/github/openflocon/flocon/analytics/builder/AnalyticsBuilder.kt

@@ -1,10 +1,10 @@
 @file:OptIn(ExperimentalUuidApi::class)
 
-package io.github.openflocon.flocon.plugins.analytics.builder
+package io.github.openflocon.flocon.analytics.builder
 
-import io.github.openflocon.flocon.plugins.analytics.FloconAnalyticsPlugin
-import io.github.openflocon.flocon.plugins.analytics.model.AnalyticsEvent
-import io.github.openflocon.flocon.plugins.analytics.model.AnalyticsItem
+import io.github.openflocon.flocon.analytics.FloconAnalyticsPlugin
+import io.github.openflocon.flocon.analytics.model.AnalyticsEvent
+import io.github.openflocon.flocon.analytics.model.AnalyticsItem
 import io.github.openflocon.flocon.utils.currentTimeMillis
 import kotlin.uuid.ExperimentalUuidApi
 import kotlin.uuid.Uuid
@@ -29,4 +29,4 @@ class AnalyticsBuilder(
         }
         analyticsPlugin?.registerAnalytics(analyticsItems)
     }
-}
+}

FloconAndroid/flocon/src/commonMain/kotlin/io/github/openflocon/flocon/plugins/analytics/mapper/AnalyticsItemsMapper.kt → FloconAndroid/analytics/src/commonMain/kotlin/io/github/openflocon/flocon/analytics/mapper/AnalyticsItemsMapper.kt

@@ -1,17 +1,7 @@
-package io.github.openflocon.flocon.plugins.analytics.mapper
+package io.github.openflocon.flocon.analytics.mapper
 
-import io.github.openflocon.flocon.core.FloconEncoder
-import io.github.openflocon.flocon.plugins.analytics.model.AnalyticsItem
+import io.github.openflocon.flocon.analytics.model.AnalyticsItem
 import kotlinx.serialization.Serializable
-import kotlinx.serialization.encodeToString
-
-internal fun analyticsItemsToJson(item: AnalyticsItem): String {
-    return FloconEncoder.json.encodeToString(
-        listOf(
-            item.toSerializable()
-        )
-    )
-}
 
 @Serializable
 internal class AnalyticsItemSerializable(
@@ -28,7 +18,7 @@ internal class AnalyticsPropertySerializable(
     val value: String,
 )
 
-internal fun AnalyticsItem.toSerializable(): AnalyticsItemSerializable {
+internal fun AnalyticsItem.toRemote(): AnalyticsItemSerializable {
     return AnalyticsItemSerializable(
         id = id,
         analyticsTableId = analyticsTableId,
@@ -41,4 +31,4 @@ internal fun AnalyticsItem.toSerializable(): AnalyticsItemSerializable {
             )
         }
     )
-}
+}