rename from Instance to FeaturevisorInstance

Author: fahad19

README.md

@@ -117,7 +117,7 @@ See example application here: [https://github.com/featurevisor/featurevisor-exam
 The SDK can be initialized by passing [datafile](https://featurevisor.com/docs/building-datafiles/) content directly:
 
 ```java
-import com.featurevisor.sdk.Instance;
+import com.featurevisor.sdk.FeaturevisorInstance;
 import com.featurevisor.types.DatafileContent;
 
 // Load datafile content
@@ -128,8 +128,8 @@ String datafileContent = "..." // ... load your datafile content
 DatafileContent datafile = DatafileContent.fromJson(datafileContent);
 
 // Create SDK instance
-Instance f = new Instance(
-    new Instance.InstanceOptions()
+FeaturevisorInstance f = new FeaturevisorInstance(
+    new FeaturevisorInstance.InstanceOptions()
         .datafile(datafileContent)
 );
 ```
@@ -170,7 +170,7 @@ Map<String, Object> initialContext = new HashMap<>();
 initialContext.put("deviceId", "123");
 initialContext.put("country", "nl");
 
-Instance f = new Instance(new Instance.InstanceOptions()
+FeaturevisorInstance f = new FeaturevisorInstance(new FeaturevisorInstance.InstanceOptions()
     .datafile(datafile)
     .context(initialContext));
 ```
@@ -357,7 +357,7 @@ Map<String, Object> anotherFeatureSticky = new HashMap<>();
 anotherFeatureSticky.put("enabled", false);
 stickyFeatures.put("anotherFeatureKey", anotherFeatureSticky);
 
-Instance f = new Instance(new Instance.InstanceOptions()
+FeaturevisorInstance f = new FeaturevisorInstance(new FeaturevisorInstance.InstanceOptions()
     .datafile(datafile)
     .sticky(stickyFeatures));
 ```
@@ -433,7 +433,7 @@ Setting `debug` level will print out all logs, including `info`, `warn`, and `er
 ```java
 import com.featurevisor.sdk.Logger;
 
-Instance f = new Instance(new Instance.InstanceOptions()
+FeaturevisorInstance f = new FeaturevisorInstance(new FeaturevisorInstance.InstanceOptions()
     .datafile(datafile)
     .logLevel(Logger.LogLevel.DEBUG));
 ```
@@ -457,7 +457,7 @@ Logger customLogger = Logger.createLogger(new Logger.CreateLoggerOptions()
         System.out.println("[" + level + "] " + message);
     }));
 
-Instance f = new Instance(new Instance.InstanceOptions()
+FeaturevisorInstance f = new FeaturevisorInstance(new FeaturevisorInstance.InstanceOptions()
     .datafile(datafile)
     .logger(customLogger));
 ```
@@ -470,7 +470,7 @@ Logger customLogger = new Logger(Logger.LogLevel.INFO, (level, message, details)
     System.out.println("[" + level + "] " + message);
 });
 
-Instance f = new Instance(new Instance.InstanceOptions()
+FeaturevisorInstance f = new FeaturevisorInstance(new FeaturevisorInstance.InstanceOptions()
     .datafile(datafile)
     .logger(customLogger));
 ```
@@ -637,7 +637,7 @@ You can register hooks at the time of SDK initialization:
 List<Map<String, Object>> hooks = new ArrayList<>();
 hooks.add(myCustomHook);
 
-Instance f = new Instance(new Instance.InstanceOptions()
+FeaturevisorInstance f = new FeaturevisorInstance(new FeaturevisorInstance.InstanceOptions()
     .datafile(datafile)
     .hooks(hooks));
 ```
@@ -662,7 +662,7 @@ That's where child instances come in handy:
 Map<String, Object> childContext = new HashMap<>();
 childContext.put("userId", "123");
 
-Instance childF = f.spawn(childContext);
+FeaturevisorInstance childF = f.spawn(childContext);
 ```
 
 Now you can pass the child instance where your individual request is being handled, and you can continue to evaluate features targeting that specific user alone:

src/main/java/com/featurevisor/cli/CLI.java

@@ -6,7 +6,7 @@
 import picocli.CommandLine.Parameters;
 
 import com.featurevisor.sdk.Featurevisor;
-import com.featurevisor.sdk.Instance;
+import com.featurevisor.sdk.FeaturevisorInstance;
 import com.featurevisor.sdk.Logger;
 import com.featurevisor.sdk.DatafileReader;
 import com.featurevisor.types.DatafileContent;
@@ -250,9 +250,9 @@ private TestResult testFeature(Map<String, Object> assertion, String featureKey,
         Map<String, Object> sticky = (Map<String, Object>) assertion.getOrDefault("sticky", new HashMap<>());
 
         // Update the SDK instance context and sticky values for this assertion
-        if (f instanceof Instance) {
-            ((Instance) f).setContext(context, true);
-            ((Instance) f).setSticky(sticky, true);
+        if (f instanceof FeaturevisorInstance) {
+            ((FeaturevisorInstance) f).setContext(context, true);
+            ((FeaturevisorInstance) f).setSticky(sticky, true);
         } else if (f instanceof com.featurevisor.sdk.ChildInstance) {
             ((com.featurevisor.sdk.ChildInstance) f).setContext(context, true);
             ((com.featurevisor.sdk.ChildInstance) f).setSticky(sticky, true);
@@ -274,7 +274,7 @@ private TestResult testFeature(Map<String, Object> assertion, String featureKey,
 
         // Test expectedVariation
         if (assertion.containsKey("expectedVariation")) {
-            Instance.OverrideOptions options = new Instance.OverrideOptions();
+            FeaturevisorInstance.OverrideOptions options = new FeaturevisorInstance.OverrideOptions();
             if (assertion.containsKey("defaultVariationValue")) {
                 options.setDefaultVariationValue(assertion.get("defaultVariationValue").toString());
             }
@@ -308,7 +308,7 @@ private TestResult testFeature(Map<String, Object> assertion, String featureKey,
                     }
                 }
 
-                Instance.OverrideOptions options = new Instance.OverrideOptions();
+                FeaturevisorInstance.OverrideOptions options = new FeaturevisorInstance.OverrideOptions();
                 if (defaultVariableValues.containsKey(variableKey)) {
                     options.setDefaultVariableValue(defaultVariableValues.get(variableKey));
                 }
@@ -347,7 +347,7 @@ private TestResult testFeature(Map<String, Object> assertion, String featureKey,
                     if (expectedEvaluations.containsKey("variation")) {
             @SuppressWarnings("unchecked")
             Map<String, Object> variationEvaluation = (Map<String, Object>) expectedEvaluations.get("variation");
-            Instance.OverrideOptions options = new Instance.OverrideOptions();
+            FeaturevisorInstance.OverrideOptions options = new FeaturevisorInstance.OverrideOptions();
             if (assertion.containsKey("defaultVariationValue")) {
                 options.setDefaultVariationValue(assertion.get("defaultVariationValue").toString());
             }
@@ -378,7 +378,7 @@ private TestResult testFeature(Map<String, Object> assertion, String featureKey,
                     @SuppressWarnings("unchecked")
                     Map<String, Object> expectedEvaluation = (Map<String, Object>) entry.getValue();
 
-                    Instance.OverrideOptions options = new Instance.OverrideOptions();
+                    FeaturevisorInstance.OverrideOptions options = new FeaturevisorInstance.OverrideOptions();
                     if (defaultVariableValues.containsKey(variableKey)) {
                         options.setDefaultVariableValue(defaultVariableValues.get(variableKey));
                     }
@@ -427,55 +427,55 @@ private TestResult testFeature(Map<String, Object> assertion, String featureKey,
      * Helper methods to work with both Instance and ChildInstance
      */
     private boolean isEnabled(Object f, String featureKey, Map<String, Object> context) {
-        if (f instanceof Instance) {
-            return ((Instance) f).isEnabled(featureKey, context);
+        if (f instanceof FeaturevisorInstance) {
+            return ((FeaturevisorInstance) f).isEnabled(featureKey, context);
         } else if (f instanceof com.featurevisor.sdk.ChildInstance) {
             return ((com.featurevisor.sdk.ChildInstance) f).isEnabled(featureKey, context);
         }
         return false;
     }
 
-    private Object getVariation(Object f, String featureKey, Map<String, Object> context, Instance.OverrideOptions options) {
-        if (f instanceof Instance) {
-            return ((Instance) f).getVariation(featureKey, context, options);
+    private Object getVariation(Object f, String featureKey, Map<String, Object> context, FeaturevisorInstance.OverrideOptions options) {
+        if (f instanceof FeaturevisorInstance) {
+            return ((FeaturevisorInstance) f).getVariation(featureKey, context, options);
         } else if (f instanceof com.featurevisor.sdk.ChildInstance) {
             return ((com.featurevisor.sdk.ChildInstance) f).getVariation(featureKey, context, options);
         }
         return null;
     }
 
-    private Object getVariable(Object f, String featureKey, String variableKey, Map<String, Object> context, Instance.OverrideOptions options) {
-        if (f instanceof Instance) {
-            return ((Instance) f).getVariable(featureKey, variableKey, context, options);
+    private Object getVariable(Object f, String featureKey, String variableKey, Map<String, Object> context, FeaturevisorInstance.OverrideOptions options) {
+        if (f instanceof FeaturevisorInstance) {
+            return ((FeaturevisorInstance) f).getVariable(featureKey, variableKey, context, options);
         } else if (f instanceof com.featurevisor.sdk.ChildInstance) {
             return ((com.featurevisor.sdk.ChildInstance) f).getVariable(featureKey, variableKey, context, options);
         }
         return null;
     }
 
     private com.featurevisor.sdk.Evaluation evaluateFlag(Object f, String featureKey, Map<String, Object> context) {
-        if (f instanceof Instance) {
-            return ((Instance) f).evaluateFlag(featureKey, context);
+        if (f instanceof FeaturevisorInstance) {
+            return ((FeaturevisorInstance) f).evaluateFlag(featureKey, context);
         } else if (f instanceof com.featurevisor.sdk.ChildInstance) {
             // ChildInstance doesn't have evaluateFlag, so we'll skip this test for child instances
             return null;
         }
         return null;
     }
 
-    private com.featurevisor.sdk.Evaluation evaluateVariation(Object f, String featureKey, Map<String, Object> context, Instance.OverrideOptions options) {
-        if (f instanceof Instance) {
-            return ((Instance) f).evaluateVariation(featureKey, context, options);
+    private com.featurevisor.sdk.Evaluation evaluateVariation(Object f, String featureKey, Map<String, Object> context, FeaturevisorInstance.OverrideOptions options) {
+        if (f instanceof FeaturevisorInstance) {
+            return ((FeaturevisorInstance) f).evaluateVariation(featureKey, context, options);
         } else if (f instanceof com.featurevisor.sdk.ChildInstance) {
             // ChildInstance doesn't have evaluateVariation, so we'll skip this test for child instances
             return null;
         }
         return null;
     }
 
-    private com.featurevisor.sdk.Evaluation evaluateVariable(Object f, String featureKey, String variableKey, Map<String, Object> context, Instance.OverrideOptions options) {
-        if (f instanceof Instance) {
-            return ((Instance) f).evaluateVariable(featureKey, variableKey, context, options);
+    private com.featurevisor.sdk.Evaluation evaluateVariable(Object f, String featureKey, String variableKey, Map<String, Object> context, FeaturevisorInstance.OverrideOptions options) {
+        if (f instanceof FeaturevisorInstance) {
+            return ((FeaturevisorInstance) f).evaluateVariable(featureKey, variableKey, context, options);
         } else if (f instanceof com.featurevisor.sdk.ChildInstance) {
             // ChildInstance doesn't have evaluateVariable, so we'll skip this test for child instances
             return null;
@@ -484,8 +484,8 @@ private com.featurevisor.sdk.Evaluation evaluateVariable(Object f, String featur
     }
 
     private com.featurevisor.sdk.ChildInstance spawn(Object f, Map<String, Object> context) {
-        if (f instanceof Instance) {
-            return ((Instance) f).spawn(context);
+        if (f instanceof FeaturevisorInstance) {
+            return ((FeaturevisorInstance) f).spawn(context);
         } else if (f instanceof com.featurevisor.sdk.ChildInstance) {
             // ChildInstance doesn't have spawn, so we'll return null
             return null;
@@ -577,11 +577,11 @@ private void test() {
                 return;
             }
 
-            // Create SDK instances for each environment
-            Map<String, Instance> sdkInstancesByEnvironment = new HashMap<>();
+                    // Create SDK instances for each environment
+        Map<String, FeaturevisorInstance> sdkInstancesByEnvironment = new HashMap<>();
             for (String environment : environments) {
                 DatafileContent datafile = datafilesByEnvironment.get(environment);
-                Instance instance = Featurevisor.createInstance(new Instance.InstanceOptions()
+                FeaturevisorInstance instance = Featurevisor.createInstance(new FeaturevisorInstance.InstanceOptions()
                     .datafile(datafile)
                     .logLevel(level));
                 sdkInstancesByEnvironment.put(environment, instance);
@@ -610,7 +610,7 @@ private void test() {
 
                     if (test.containsKey("feature")) {
                         String environment = (String) assertion.get("environment");
-                        Instance f = sdkInstancesByEnvironment.get(environment);
+                        FeaturevisorInstance f = sdkInstancesByEnvironment.get(environment);
 
                         // If "at" parameter is provided, create a new SDK instance with the specific hook
                         if (assertion.containsKey("at")) {
@@ -631,7 +631,7 @@ private void test() {
                             hooksManager.add(new HooksManager.Hook("at-parameter")
                                 .bucketValue((options) -> (int) (atValue * 1000)));
 
-                            f = Featurevisor.createInstance(new Instance.InstanceOptions()
+                            f = Featurevisor.createInstance(new FeaturevisorInstance.InstanceOptions()
                                 .datafile(datafile)
                                 .logLevel(level)
                                 .hooks(hooksManager.getAll()));
@@ -710,7 +710,7 @@ private void benchmark() {
             Logger.LogLevel level = getLoggerLevel();
             Map<String, DatafileContent> datafilesByEnvironment = buildDatafiles(rootDirectoryPath, Arrays.asList(environment));
 
-            Instance f = Featurevisor.createInstance(new Instance.InstanceOptions()
+            FeaturevisorInstance f = Featurevisor.createInstance(new FeaturevisorInstance.InstanceOptions()
                 .datafile(datafilesByEnvironment.get(environment))
                 .logLevel(level));
 
@@ -773,7 +773,7 @@ private void assessDistribution() {
 
             Map<String, DatafileContent> datafilesByEnvironment = buildDatafiles(rootDirectoryPath, Arrays.asList(environment));
 
-            Instance f = Featurevisor.createInstance(new Instance.InstanceOptions()
+            FeaturevisorInstance f = Featurevisor.createInstance(new FeaturevisorInstance.InstanceOptions()
                 .datafile(datafilesByEnvironment.get(environment))
                 .logLevel(getLoggerLevel()));