[FSSDK-9984] fix: initialization and setUser errors (#255)

* fix: remove successful fetch requirement for onReady

* Revert "fix: remove successful fetch requirement for onReady"

This reverts commit 566daaf.

* fix: error with OnReadyResult being undefined

* fix: setUser should use VUID if possible

* revert: timeout of undefined

* docs: update copyright year

* revert: Provider.tsx copyright since no code change

* build: bump JS SDK version

* refactor: `res` should never be `undefined`

* docs: add clarifying comment

* revert: retrieval & use of current user context

* wip: partial solution; needs collab

* refactor: setUser logic updated

* revert: move setUser back to Provider constructor

* style: remove commented code

* fix: fetchQualifiedSegments under SSR/sync scenario

* ci: VS Code jest settings to run via extension

* test: use NotReadyReason enum

* test: use NotReadyReason & add missing getUserId in mock user context

* fix: add onInitStateChange for default ready result

* fix: logic in Promise.all user & client readiness

* refactor: isReady() to isReactClientReady()

* test: fixes for uses of getUserId() in setUser()

* wip: fixing tests

* wip: fixed more tests

* revert: refactor of isReactClientReady()

* docs: Update copyrights

* fix: later setUser not getting new usercontext (manual testing)

* fix: PR review changes

* test: add initial OptimizelyProvider tests

* fix: PR review changes

* docs: add clarification inline comments

* build: bump underlying JS SDK version to 5.3.0

* fix: add missing getProjectConfig() from JS SDK

* refactor: omit getProjectConfig instead of implementing it

* style: remove unused import

---------

Co-authored-by: Mike Chu <michael.chu@optmizely.com>

.vscode/launch.json

@@ -0,0 +1,25 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "name": "vscode-jest-tests.v2.react-sdk",
+      "request": "launch",
+      "args": [
+        "--runInBand",
+        "--watchAll=false",
+        "--testNamePattern",
+        "${jest.testNamePattern}",
+        "--runTestsByPath",
+        "${jest.testFile}"
+      ],
+      "cwd": "${workspaceFolder}",
+      "console": "integratedTerminal",
+      "internalConsoleOptions": "neverOpen",
+      "program": "${workspaceFolder}/node_modules/.bin/jest",
+      "windows": {
+        "program": "${workspaceFolder}/node_modules/jest/bin/jest"
+      }
+    }
+  ]
+}

.vscode/settings.json

@@ -1,5 +1,4 @@
 {
-  "jest.autoRun": {
-    "onStartup": ["all-tests"]
-  }
+  "jest.runMode": "on-demand",
+  "jest.jestCommandLine": "~/.nvm/nvm-exec yarn test"
 }

package.json

@@ -34,7 +34,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@optimizely/optimizely-sdk": "^5.2.0",
+    "@optimizely/optimizely-sdk": "^5.3.0",
     "hoist-non-react-statics": "^3.3.0",
     "prop-types": "^15.6.2",
     "utility-types": "^2.1.0 || ^3.0.0"

src/Feature.spec.tsx

@@ -1,5 +1,5 @@
 /**
- * Copyright 2018-2019, 2023 Optimizely
+ * Copyright 2018-2019, 2023-2024 Optimizely
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -22,7 +22,7 @@ import { render, screen, waitFor } from '@testing-library/react';
 import '@testing-library/jest-dom/extend-expect';
 
 import { OptimizelyProvider } from './Provider';
-import { ReactSDKClient, VariableValuesObject } from './client';
+import { NotReadyReason, ReactSDKClient, VariableValuesObject } from './client';
 import { OptimizelyFeature } from './Feature';
 
 describe('<OptimizelyFeature>', () => {
@@ -298,7 +298,7 @@ describe('<OptimizelyFeature>', () => {
 
         // while it's waiting for onReady()
         expect(container.innerHTML).toBe('');
-        resolver.resolve({ success: false, reason: 'fail', dataReadyPromise: Promise.resolve() });
+        resolver.resolve({ success: false, reason: NotReadyReason.TIMEOUT, dataReadyPromise: Promise.resolve() });
 
         // Simulate config update notification firing after datafile fetched
         await optimizelyMock.onReady().then(res => res.dataReadyPromise);

src/Provider.spec.tsx

@@ -0,0 +1,95 @@
+/**
+ * Copyright 2024 Optimizely
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/// <reference types="jest" />
+
+//jest.mock('./client');
+
+import React from 'react';
+import { render, act } from '@testing-library/react';
+import { OptimizelyProvider } from './Provider';
+import { DefaultUser, ReactSDKClient, createInstance } from './client';
+
+describe('OptimizelyProvider', () => {
+  let mockReactClient: ReactSDKClient;
+  const config = {
+    datafile: {},
+  };
+
+  beforeEach(() => {
+    mockReactClient = ({
+      user: {
+        id: 'test-id',
+        attributes: {},
+      },
+      setUser: jest.fn().mockResolvedValue(undefined),
+    } as unknown) as ReactSDKClient;
+  });
+
+  it('should render successfully with user provided', () => {
+    act(() => {
+      render(<OptimizelyProvider optimizely={mockReactClient} user={{ id: 'user1' }} />);
+    });
+
+    expect(mockReactClient.setUser).toHaveBeenCalledWith({
+      id: 'user1',
+      attributes: {},
+    });
+  });
+
+  it('should render successfully with userId provided', () => {
+    act(() => {
+      render(<OptimizelyProvider optimizely={mockReactClient} userId="user1" />);
+    });
+
+    expect(mockReactClient.setUser).toHaveBeenCalledWith({
+      id: 'user1',
+      attributes: {},
+    });
+  });
+
+  it('should render successfully without user or userId provided', () => {
+    act(() => {
+      render(<OptimizelyProvider optimizely={mockReactClient} />);
+    });
+
+    expect(mockReactClient.setUser).toHaveBeenCalledWith(DefaultUser);
+  });
+
+  it('should render successfully with user id & attributes provided', () => {
+    act(() => {
+      render(
+        <OptimizelyProvider optimizely={mockReactClient} user={{ id: 'user1', attributes: { attr1: 'value1' } }} />
+      );
+    });
+
+    expect(mockReactClient.setUser).toHaveBeenCalledWith({
+      id: 'user1',
+      attributes: { attr1: 'value1' },
+    });
+  });
+
+  it('should succeed just userAttributes provided', () => {
+    act(() => {
+      render(<OptimizelyProvider optimizely={mockReactClient} userAttributes={{ attr1: 'value1' }} />);
+    });
+
+    expect(mockReactClient.setUser).toHaveBeenCalledWith({
+      id: DefaultUser.id,
+      attributes: { attr1: 'value1' },
+    });
+  });
+});

src/Provider.tsx

@@ -1,5 +1,5 @@
 /**
- * Copyright 2022-2023, Optimizely
+ * Copyright 2022-2024, Optimizely
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -43,9 +43,7 @@ interface OptimizelyProviderState {
 export class OptimizelyProvider extends React.Component<OptimizelyProviderProps, OptimizelyProviderState> {
   constructor(props: OptimizelyProviderProps) {
     super(props);
-  }
 
-  componentDidMount(): void {
     this.setUserInOptimizely();
   }
 
@@ -78,12 +76,15 @@ export class OptimizelyProvider extends React.Component<OptimizelyProviderProps,
       // deprecation warning
       logger.warn('Passing userId and userAttributes as props is deprecated, please switch to using `user` prop');
     } else {
-      finalUser = DefaultUser;
+      finalUser = {
+        id: DefaultUser.id,
+        attributes: userAttributes || DefaultUser.attributes,
+      };
     }
 
+    // if user is a promise, setUser occurs in the then block above
     if (finalUser) {
       try {
-        await optimizely.onReady();
         await optimizely.setUser(finalUser);
       } catch {
         logger.error('Error while trying to set user.');