adds graceful failure mode; all public functions have a try/catch (FF…

src/client/eppo-client.spec.ts

@@ -130,6 +130,67 @@ describe('EppoClient E2E test', () => {
     },
   };
 
+  describe('error encountered', () => {
+    let client: EppoClient;
+    const mockHooks = td.object<IAssignmentHooks>();
+
+    beforeAll(() => {
+      storage.setEntries({ [flagKey]: mockExperimentConfig });
+      client = new EppoClient(storage);
+
+      td.replace(EppoClient.prototype, 'getAssignmentVariation', function () {
+        throw new Error('So Graceful Error');
+      });
+    });
+
+    afterAll(() => {
+      td.reset();
+    });
+
+    it('returns null when graceful failure if error encountered', async () => {
+      client.setIsGracefulFailureMode(true);
+
+      expect(client.getAssignment('subject-identifer', flagKey, {}, mockHooks)).toBeNull();
+      expect(client.getBoolAssignment('subject-identifer', flagKey, {}, mockHooks)).toBeNull();
+      expect(
+        client.getJSONStringAssignment('subject-identifer', flagKey, {}, mockHooks),
+      ).toBeNull();
+      expect(client.getNumericAssignment('subject-identifer', flagKey, {}, mockHooks)).toBeNull();
+      expect(
+        client.getParsedJSONAssignment('subject-identifer', flagKey, {}, mockHooks),
+      ).toBeNull();
+      expect(client.getStringAssignment('subject-identifer', flagKey, {}, mockHooks)).toBeNull();
+    });
+
+    it('throws error when graceful failure is false', async () => {
+      client.setIsGracefulFailureMode(false);
+
+      expect(() => {
+        client.getAssignment('subject-identifer', flagKey, {}, mockHooks);
+      }).toThrow();
+
+      expect(() => {
+        client.getBoolAssignment('subject-identifer', flagKey, {}, mockHooks);
+      }).toThrow();
+
+      expect(() => {
+        client.getJSONStringAssignment('subject-identifer', flagKey, {}, mockHooks);
+      }).toThrow();
+
+      expect(() => {
+        client.getParsedJSONAssignment('subject-identifer', flagKey, {}, mockHooks);
+      }).toThrow();
+
+      expect(() => {
+        client.getNumericAssignment('subject-identifer', flagKey, {}, mockHooks);
+      }).toThrow();
+
+      expect(() => {
+        client.getStringAssignment('subject-identifer', flagKey, {}, mockHooks);
+      }).toThrow();
+    });
+  });
+
   describe('setLogger', () => {
     beforeAll(() => {
       storage.setEntries({ [flagKey]: mockExperimentConfig });

src/client/eppo-client.ts

@@ -89,6 +89,7 @@ export interface IEppoClient {
 export default class EppoClient implements IEppoClient {
   private queuedEvents: IAssignmentEvent[] = [];
   private assignmentLogger: IAssignmentLogger | undefined;
+  private isGracefulFailureMode = true;
 
   constructor(private configurationStore: IConfigurationStore) {}
 
@@ -100,10 +101,14 @@ export default class EppoClient implements IEppoClient {
     subjectAttributes: Record<string, any> = {},
     assignmentHooks?: IAssignmentHooks | undefined,
   ): string | null {
-    return (
-      this.getAssignmentVariation(subjectKey, flagKey, subjectAttributes, assignmentHooks)
-        .stringValue ?? null
-    );
+    try {
+      return (
+        this.getAssignmentVariation(subjectKey, flagKey, subjectAttributes, assignmentHooks)
+          .stringValue ?? null
+      );
+    } catch (error) {
+      return this.rethrowIfNotGraceful(error);
+    }
   }
 
   public getStringAssignment(
@@ -113,15 +118,19 @@ export default class EppoClient implements IEppoClient {
     subjectAttributes: Record<string, any> = {},
     assignmentHooks?: IAssignmentHooks | undefined,
   ): string | null {
-    return (
-      this.getAssignmentVariation(
-        subjectKey,
-        flagKey,
-        subjectAttributes,
-        assignmentHooks,
-        ValueType.StringType,
-      ).stringValue ?? null
-    );
+    try {
+      return (
+        this.getAssignmentVariation(
+          subjectKey,
+          flagKey,
+          subjectAttributes,
+          assignmentHooks,
+          ValueType.StringType,
+        ).stringValue ?? null
+      );
+    } catch (error) {
+      return this.rethrowIfNotGraceful(error);
+    }
   }
 
   getBoolAssignment(
@@ -131,15 +140,19 @@ export default class EppoClient implements IEppoClient {
     subjectAttributes: Record<string, any> = {},
     assignmentHooks?: IAssignmentHooks | undefined,
   ): boolean | null {
-    return (
-      this.getAssignmentVariation(
-        subjectKey,
-        flagKey,
-        subjectAttributes,
-        assignmentHooks,
-        ValueType.BoolType,
-      ).boolValue ?? null
-    );
+    try {
+      return (
+        this.getAssignmentVariation(
+          subjectKey,
+          flagKey,
+          subjectAttributes,
+          assignmentHooks,
+          ValueType.BoolType,
+        ).boolValue ?? null
+      );
+    } catch (error) {
+      return this.rethrowIfNotGraceful(error);
+    }
   }
 
   getNumericAssignment(
@@ -148,15 +161,19 @@ export default class EppoClient implements IEppoClient {
     subjectAttributes?: Record<string, EppoValue>,
     assignmentHooks?: IAssignmentHooks | undefined,
   ): number | null {
-    return (
-      this.getAssignmentVariation(
-        subjectKey,
-        flagKey,
-        subjectAttributes,
-        assignmentHooks,
-        ValueType.NumericType,
-      ).numericValue ?? null
-    );
+    try {
+      return (
+        this.getAssignmentVariation(
+          subjectKey,
+          flagKey,
+          subjectAttributes,
+          assignmentHooks,
+          ValueType.NumericType,
+        ).numericValue ?? null
+      );
+    } catch (error) {
+      return this.rethrowIfNotGraceful(error);
+    }
   }
 
   public getJSONStringAssignment(
@@ -166,15 +183,19 @@ export default class EppoClient implements IEppoClient {
     subjectAttributes: Record<string, any> = {},
     assignmentHooks?: IAssignmentHooks | undefined,
   ): string | null {
-    return (
-      this.getAssignmentVariation(
-        subjectKey,
-        flagKey,
-        subjectAttributes,
-        assignmentHooks,
-        ValueType.JSONType,
-      ).stringValue ?? null
-    );
+    try {
+      return (
+        this.getAssignmentVariation(
+          subjectKey,
+          flagKey,
+          subjectAttributes,
+          assignmentHooks,
+          ValueType.JSONType,
+        ).stringValue ?? null
+      );
+    } catch (error) {
+      return this.rethrowIfNotGraceful(error);
+    }
   }
 
   public getParsedJSONAssignment(
@@ -184,15 +205,27 @@ export default class EppoClient implements IEppoClient {
     subjectAttributes: Record<string, any> = {},
     assignmentHooks?: IAssignmentHooks | undefined,
   ): object | null {
-    return (
-      this.getAssignmentVariation(
-        subjectKey,
-        flagKey,
-        subjectAttributes,
-        assignmentHooks,
-        ValueType.JSONType,
-      ).objectValue ?? null
-    );
+    try {
+      return (
+        this.getAssignmentVariation(
+          subjectKey,
+          flagKey,
+          subjectAttributes,
+          assignmentHooks,
+          ValueType.JSONType,
+        ).objectValue ?? null
+      );
+    } catch (error) {
+      return this.rethrowIfNotGraceful(error);
+    }
+  }
+
+  private rethrowIfNotGraceful(err: Error): null {
+    if (this.isGracefulFailureMode) {
+      console.error(`[Eppo SDK] Error getting assignment: ${err.message}`);
+      return null;
+    }
+    throw err;
   }
 
   private getAssignmentVariation(
@@ -288,6 +321,10 @@ export default class EppoClient implements IEppoClient {
     this.flushQueuedEvents(); // log any events that may have been queued while initializing
   }
 
+  public setIsGracefulFailureMode(gracefulFailureMode: boolean) {
+    this.isGracefulFailureMode = gracefulFailureMode;
+  }
+
   private flushQueuedEvents() {
     const eventsToFlush = this.queuedEvents;
     this.queuedEvents = [];