API and Events domain modules

Author: gthea

api/README.md

@@ -0,0 +1,6 @@
+# API module
+
+This module contains the public API interfaces and types exposed to consumers of the Split SDK.
+
+Classes in this module are part of the public API contract and should maintain backwards compatibility.
+

api/build.gradle

@@ -0,0 +1,22 @@
+plugins {
+    id 'com.android.library'
+}
+
+apply from: "$rootDir/gradle/common-android-library.gradle"
+
+android {
+    namespace 'io.split.android.client.api'
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_1_8
+        targetCompatibility JavaVersion.VERSION_1_8
+    }
+}
+
+dependencies {
+    implementation libs.annotation
+
+    testImplementation libs.junit4
+    testImplementation libs.mockitoCore
+}
+

api/consumer-rules.pro

@@ -0,0 +1,22 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile
+

api/proguard-rules.pro

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

api/src/androidTest/java/.gitkeep

@@ -0,0 +1,58 @@
+package io.split.android.client.api;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
+import java.util.Collection;
+import java.util.Map;
+import java.util.Set;
+
+/**
+ * Represents metadata associated with SDK events.
+ * <p>
+ * Values are sanitized to only allow String, Number, Boolean, or List&lt;String&gt;.
+ */
+public interface EventMetadata {
+
+    /**
+     * Returns the set of keys in this metadata.
+     *
+     * @return set of keys
+     */
+    @NonNull
+    Set<String> keys();
+
+    /**
+     * Returns the collection of values in this metadata.
+     *
+     * @return collection of values
+     */
+    @NonNull
+    Collection<Object> values();
+
+    /**
+     * Returns the value associated with the given key.
+     *
+     * @param key the key to look up
+     * @return the value associated with the key, or null if not found
+     */
+    @Nullable
+    Object get(@NonNull String key);
+
+    /**
+     * Returns whether this metadata contains the given key.
+     *
+     * @param key the key to check
+     * @return true if the key exists, false otherwise
+     */
+    boolean containsKey(@NonNull String key);
+
+    /**
+     * Returns a copy of the underlying data as a Map.
+     *
+     * @return a copy of the metadata map
+     */
+    @NonNull
+    Map<String, Object> toMap();
+}
+

api/src/main/AndroidManifest.xml

@@ -141,6 +141,8 @@ dependencies {
     include project(':main')
     include project(':logger')
     include project(':events')
+    include project(':events-domain')
+    include project(':api')
 }
 
 def splitPOM = {

api/src/main/java/io/split/android/client/api/EventMetadata.java

@@ -0,0 +1,9 @@
+# Events Domain module
+
+This module provides Split-specific events management implementation.
+
+It builds on top of the generic `events` module to provide domain-specific event handling for the Split SDK, including:
+- Split-specific event types (SplitEvent, SplitInternalEvent)
+- Events manager implementations (SplitEventsManager, EventsManagerCoordinator)
+- Event metadata implementation (EventMetadataImpl)
+