Skip to content

feat: add Domains (formerly Clients) (#185) #231

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mstepien wants to merge 13 commits into
base: main
Choose a base branch
from
Open

feat: add Domains (formerly Clients) (#185) #231

Show file tree
Hide file tree
Changes from 12 commits
Commits
Show all changes
13 commits
Select commit Hold shift + click to select a range
52c395e
feat: add Domains (formerly Clients) (#185)
mstepien Apr 13, 2026
3f6388c
feat: context merging (Spec 3.2.3) (#185)
mstepien Apr 22, 2026
8e3a573
perf: cache domain context merging (#185)
mstepien Apr 22, 2026
14d917e
refactor: hide state objects (#185)
mstepien Apr 22, 2026
ef16933
fix: memoize default domain state flow (#185)
mstepien Apr 22, 2026
89e32ba
fix: harden against race conditions and event pollution (#185)
mstepien Apr 22, 2026
ca14dfa
feat: manage eval. context (Spec 3.2.2.4) (#185)
mstepien Apr 22, 2026
aaf3bcf
chore: resolve upstream rebase conflicts (#185)
mstepien Apr 22, 2026
b4aecf8
feat: domain-isolated client event observing (spec 5.2.1, 5.2.7) (#185)
mstepien Apr 23, 2026
874b776
feat: domain-isolated events (spec 5.3.4.1-3)(#185)
mstepien Apr 23, 2026
c922e30
fix(lifecycle): thread-safe provider reference counting (spec 1.1.2.3…
mstepien Apr 23, 2026
cb98c09
feat: sync shared provider state (specs 1.1.2.2-3)(#185)
mstepien Apr 23, 2026
16b88f1
refactor: move domain-scoped setProvider to Client (#185)
mstepien May 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
65 changes: 61 additions & 4 deletions kotlin-sdk/api/android/kotlin-sdk.api
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,9 +20,11 @@ public abstract interface class dev/openfeature/kotlin/sdk/Client : dev/openfeat
public abstract fun getHooks ()Ljava/util/List;
public abstract fun getMetadata ()Ldev/openfeature/kotlin/sdk/ClientMetadata;
public abstract fun getStatusFlow ()Lkotlinx/coroutines/flow/Flow;
public abstract fun observeEvents ()Lkotlinx/coroutines/flow/Flow;
}

public abstract interface class dev/openfeature/kotlin/sdk/ClientMetadata {
public abstract fun getDomain ()Ljava/lang/String;
public abstract fun getName ()Ljava/lang/String;
}

Expand Down Expand Up @@ -219,6 +221,10 @@ public final class dev/openfeature/kotlin/sdk/ImmutableContext : dev/openfeature
public fun withTargetingKey (Ljava/lang/String;)Ldev/openfeature/kotlin/sdk/ImmutableContext;
}

public final class dev/openfeature/kotlin/sdk/ImmutableContextKt {
public static final fun mergeWith (Ldev/openfeature/kotlin/sdk/EvaluationContext;Ldev/openfeature/kotlin/sdk/EvaluationContext;)Ldev/openfeature/kotlin/sdk/EvaluationContext;
}

public final class dev/openfeature/kotlin/sdk/ImmutableStructure : dev/openfeature/kotlin/sdk/Structure {
public fun <init> ()V
public fun <init> (Ljava/util/Map;)V
Expand Down Expand Up @@ -265,24 +271,45 @@ public final class dev/openfeature/kotlin/sdk/NoOpProvider$NoOpProviderMetadata
public final class dev/openfeature/kotlin/sdk/OpenFeatureAPI {
public static final field INSTANCE Ldev/openfeature/kotlin/sdk/OpenFeatureAPI;
public final fun addHooks (Ljava/util/List;)V
public final fun clearEvaluationContext (Ljava/lang/String;Lkotlinx/coroutines/CoroutineDispatcher;)V
public final fun clearEvaluationContext (Lkotlinx/coroutines/CoroutineDispatcher;)V
public static synthetic fun clearEvaluationContext$default (Ldev/openfeature/kotlin/sdk/OpenFeatureAPI;Ljava/lang/String;Lkotlinx/coroutines/CoroutineDispatcher;ILjava/lang/Object;)V
public static synthetic fun clearEvaluationContext$default (Ldev/openfeature/kotlin/sdk/OpenFeatureAPI;Lkotlinx/coroutines/CoroutineDispatcher;ILjava/lang/Object;)V
public final fun clearEvaluationContextAndWait (Ljava/lang/String;Lkotlin/coroutines/Continuation;)Ljava/lang/Object;
public final fun clearEvaluationContextAndWait (Lkotlin/coroutines/Continuation;)Ljava/lang/Object;
public final fun clearHooks ()V
public final fun clearProvider (Lkotlin/coroutines/Continuation;)Ljava/lang/Object;
public final fun getClient (Ljava/lang/String;Ljava/lang/String;)Ldev/openfeature/kotlin/sdk/Client;
public static synthetic fun getClient$default (Ldev/openfeature/kotlin/sdk/OpenFeatureAPI;Ljava/lang/String;Ljava/lang/String;ILjava/lang/Object;)Ldev/openfeature/kotlin/sdk/Client;
public final fun getEvaluationContext ()Ldev/openfeature/kotlin/sdk/EvaluationContext;
public final fun getEvaluationContext (Ljava/lang/String;)Ldev/openfeature/kotlin/sdk/EvaluationContext;
public final fun getEventsFlowForDomain (Ljava/lang/String;)Lkotlinx/coroutines/flow/Flow;
public final fun getHooks ()Ljava/util/List;
public final fun getProvider ()Ldev/openfeature/kotlin/sdk/FeatureProvider;
public final fun getProvider (Ljava/lang/String;)Ldev/openfeature/kotlin/sdk/FeatureProvider;
public final fun getProviderMetadata ()Ldev/openfeature/kotlin/sdk/ProviderMetadata;
public final fun getProvidersFlow ()Lkotlinx/coroutines/flow/MutableStateFlow;
public final fun getProviderMetadata (Ljava/lang/String;)Ldev/openfeature/kotlin/sdk/ProviderMetadata;
public final fun getProviderStatus (Ljava/lang/String;)Ldev/openfeature/kotlin/sdk/OpenFeatureStatus;
public final fun getProviderStatusFlow (Ljava/lang/String;)Lkotlinx/coroutines/flow/Flow;
public final fun getProvidersFlow ()Lkotlinx/coroutines/flow/Flow;
public final fun getProvidersFlowForDomain (Ljava/lang/String;)Lkotlinx/coroutines/flow/Flow;
public final fun getRepository ()Ldev/openfeature/kotlin/sdk/ProviderRepository;
public final fun getStatus ()Ldev/openfeature/kotlin/sdk/OpenFeatureStatus;
public final fun getStatusFlow ()Lkotlinx/coroutines/flow/Flow;
public final fun setEvaluationContext (Ldev/openfeature/kotlin/sdk/EvaluationContext;Lkotlinx/coroutines/CoroutineDispatcher;)V
public final fun setEvaluationContext (Ljava/lang/String;Ldev/openfeature/kotlin/sdk/EvaluationContext;Lkotlinx/coroutines/CoroutineDispatcher;)V
public static synthetic fun setEvaluationContext$default (Ldev/openfeature/kotlin/sdk/OpenFeatureAPI;Ldev/openfeature/kotlin/sdk/EvaluationContext;Lkotlinx/coroutines/CoroutineDispatcher;ILjava/lang/Object;)V
public static synthetic fun setEvaluationContext$default (Ldev/openfeature/kotlin/sdk/OpenFeatureAPI;Ljava/lang/String;Ldev/openfeature/kotlin/sdk/EvaluationContext;Lkotlinx/coroutines/CoroutineDispatcher;ILjava/lang/Object;)V
public final fun setEvaluationContextAndWait (Ldev/openfeature/kotlin/sdk/EvaluationContext;Lkotlin/coroutines/Continuation;)Ljava/lang/Object;
public final fun setEvaluationContextAndWait (Ljava/lang/String;Ldev/openfeature/kotlin/sdk/EvaluationContext;Lkotlin/coroutines/Continuation;)Ljava/lang/Object;
public final fun setProvider (Ldev/openfeature/kotlin/sdk/FeatureProvider;Lkotlinx/coroutines/CoroutineDispatcher;Ldev/openfeature/kotlin/sdk/EvaluationContext;)V
public final fun setProvider (Ljava/lang/String;Ldev/openfeature/kotlin/sdk/FeatureProvider;Lkotlinx/coroutines/CoroutineDispatcher;Ldev/openfeature/kotlin/sdk/EvaluationContext;)V
public static synthetic fun setProvider$default (Ldev/openfeature/kotlin/sdk/OpenFeatureAPI;Ldev/openfeature/kotlin/sdk/FeatureProvider;Lkotlinx/coroutines/CoroutineDispatcher;Ldev/openfeature/kotlin/sdk/EvaluationContext;ILjava/lang/Object;)V
public static synthetic fun setProvider$default (Ldev/openfeature/kotlin/sdk/OpenFeatureAPI;Ljava/lang/String;Ldev/openfeature/kotlin/sdk/FeatureProvider;Lkotlinx/coroutines/CoroutineDispatcher;Ldev/openfeature/kotlin/sdk/EvaluationContext;ILjava/lang/Object;)V
public final fun setProviderAndWait (Ldev/openfeature/kotlin/sdk/FeatureProvider;Ldev/openfeature/kotlin/sdk/EvaluationContext;Lkotlinx/coroutines/CoroutineDispatcher;Lkotlin/coroutines/Continuation;)Ljava/lang/Object;
public final fun setProviderAndWait (Ljava/lang/String;Ldev/openfeature/kotlin/sdk/FeatureProvider;Ldev/openfeature/kotlin/sdk/EvaluationContext;Lkotlinx/coroutines/CoroutineDispatcher;Lkotlin/coroutines/Continuation;)Ljava/lang/Object;
public static synthetic fun setProviderAndWait$default (Ldev/openfeature/kotlin/sdk/OpenFeatureAPI;Ldev/openfeature/kotlin/sdk/FeatureProvider;Ldev/openfeature/kotlin/sdk/EvaluationContext;Lkotlinx/coroutines/CoroutineDispatcher;Lkotlin/coroutines/Continuation;ILjava/lang/Object;)Ljava/lang/Object;
public static synthetic fun setProviderAndWait$default (Ldev/openfeature/kotlin/sdk/OpenFeatureAPI;Ljava/lang/String;Ldev/openfeature/kotlin/sdk/FeatureProvider;Ldev/openfeature/kotlin/sdk/EvaluationContext;Lkotlinx/coroutines/CoroutineDispatcher;Lkotlin/coroutines/Continuation;ILjava/lang/Object;)Ljava/lang/Object;
public final fun shutdown (Lkotlin/coroutines/Continuation;)Ljava/lang/Object;
}

Expand Down Expand Up @@ -313,15 +340,19 @@ public final class dev/openfeature/kotlin/sdk/OpenFeatureClient : dev/openfeatur
public fun getStringDetails (Ljava/lang/String;Ljava/lang/String;Ldev/openfeature/kotlin/sdk/FlagEvaluationOptions;)Ldev/openfeature/kotlin/sdk/FlagEvaluationDetails;
public fun getStringValue (Ljava/lang/String;Ljava/lang/String;)Ljava/lang/String;
public fun getStringValue (Ljava/lang/String;Ljava/lang/String;Ldev/openfeature/kotlin/sdk/FlagEvaluationOptions;)Ljava/lang/String;
public fun observeEvents ()Lkotlinx/coroutines/flow/Flow;
public fun track (Ljava/lang/String;Ldev/openfeature/kotlin/sdk/TrackingEventDetails;)V
}

public final class dev/openfeature/kotlin/sdk/OpenFeatureClient$Metadata : dev/openfeature/kotlin/sdk/ClientMetadata {
public fun <init> (Ljava/lang/String;)V
public fun <init> (Ljava/lang/String;Ljava/lang/String;)V
public synthetic fun <init> (Ljava/lang/String;Ljava/lang/String;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
public final fun component1 ()Ljava/lang/String;
public final fun copy (Ljava/lang/String;)Ldev/openfeature/kotlin/sdk/OpenFeatureClient$Metadata;
public static synthetic fun copy$default (Ldev/openfeature/kotlin/sdk/OpenFeatureClient$Metadata;Ljava/lang/String;ILjava/lang/Object;)Ldev/openfeature/kotlin/sdk/OpenFeatureClient$Metadata;
public final fun component2 ()Ljava/lang/String;
public final fun copy (Ljava/lang/String;Ljava/lang/String;)Ldev/openfeature/kotlin/sdk/OpenFeatureClient$Metadata;
public static synthetic fun copy$default (Ldev/openfeature/kotlin/sdk/OpenFeatureClient$Metadata;Ljava/lang/String;Ljava/lang/String;ILjava/lang/Object;)Ldev/openfeature/kotlin/sdk/OpenFeatureClient$Metadata;
public fun equals (Ljava/lang/Object;)Z
public fun getDomain ()Ljava/lang/String;
public fun getName ()Ljava/lang/String;
public fun hashCode ()I
public fun toString ()Ljava/lang/String;
Expand Down Expand Up @@ -672,6 +703,19 @@ public final class dev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$P
public fun toString ()Ljava/lang/String;
}

public final class dev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$ProviderContextChanged : dev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents {
public fun <init> ()V
public fun <init> (Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$EventDetails;)V
public synthetic fun <init> (Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$EventDetails;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
public final fun component1 ()Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$EventDetails;
public final fun copy (Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$EventDetails;)Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$ProviderContextChanged;
public static synthetic fun copy$default (Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$ProviderContextChanged;Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$EventDetails;ILjava/lang/Object;)Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$ProviderContextChanged;
public fun equals (Ljava/lang/Object;)Z
public fun getEventDetails ()Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$EventDetails;
public fun hashCode ()I
public fun toString ()Ljava/lang/String;
}

public final class dev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$ProviderError : dev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents {
public fun <init> ()V
public fun <init> (Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$EventDetails;Ldev/openfeature/kotlin/sdk/exceptions/OpenFeatureError;)V
Expand Down Expand Up @@ -709,6 +753,19 @@ public final class dev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$P
public fun toString ()Ljava/lang/String;
}

public final class dev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$ProviderReconciling : dev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents {
public fun <init> ()V
public fun <init> (Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$EventDetails;)V
public synthetic fun <init> (Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$EventDetails;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
public final fun component1 ()Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$EventDetails;
public final fun copy (Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$EventDetails;)Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$ProviderReconciling;
public static synthetic fun copy$default (Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$ProviderReconciling;Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$EventDetails;ILjava/lang/Object;)Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$ProviderReconciling;
public fun equals (Ljava/lang/Object;)Z
public fun getEventDetails ()Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$EventDetails;
public fun hashCode ()I
public fun toString ()Ljava/lang/String;
}

public final class dev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$ProviderStale : dev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents {
public fun <init> ()V
public fun <init> (Ldev/openfeature/kotlin/sdk/events/OpenFeatureProviderEvents$EventDetails;)V
Expand Down
Loading
Loading