index.spec.ts

/**
 * Copyright 2025, 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
 *
 * http://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.
 */
import { USER_PROFILE_LOOKUP_ERROR, USER_PROFILE_SAVE_ERROR } from 'error_message';
import {
  SAVED_VARIATION_NOT_FOUND,
  USER_HAS_NO_FORCED_VARIATION
} from 'log_message';
import { beforeEach, describe, expect, it, MockInstance, vi } from 'vitest';
import { CMAB_DUMMY_ENTITY_ID, CMAB_FETCH_FAILED, DecisionService } from '.';
import OptimizelyUserContext from '../../optimizely_user_context';
import { createProjectConfig, ProjectConfig } from '../../project_config/project_config';
import { BucketerParams, Experiment, ExperimentBucketMap, Holdout, OptimizelyDecideOption, UserAttributes, UserProfile } from '../../shared_types';
import { getDecisionTestDatafile } from '../../tests/decision_test_datafile';
import { getMockLogger } from '../../tests/mock/mock_logger';
import { getTestProjectConfig, getTestProjectConfigWithFeatures } from '../../tests/test_data';
import { CONTROL_ATTRIBUTES, DECISION_SOURCES } from '../../utils/enums';
import { Value } from '../../utils/promise/operation_value';
import { bucket } from '../bucketer/index';
import {
  AUDIENCE_EVALUATION_RESULT_COMBINED,
  EVALUATING_AUDIENCES_COMBINED,
  EXPERIMENT_NOT_RUNNING,
  RETURNING_STORED_VARIATION,
  USER_FORCED_IN_VARIATION,
  USER_NOT_IN_EXPERIMENT
} from '../decision_service/index';

type MockLogger = ReturnType<typeof getMockLogger>;

type MockFnType = ReturnType<typeof vi.fn>;

type MockUserProfileService = {
  lookup: MockFnType;
  save: MockFnType;
};

type MockCmabService = {
  getDecision: MockFnType;
}

type DecisionServiceInstanceOpt = {
  logger?: boolean;
  userProfileService?: boolean;
  userProfileServiceAsync?: boolean;
}

type DecisionServiceInstance = {
  logger?: MockLogger;
  userProfileService?: MockUserProfileService;
  userProfileServiceAsync?: MockUserProfileService;
  cmabService: MockCmabService;
  decisionService: DecisionService;
}

const getDecisionService = (opt: DecisionServiceInstanceOpt = {}): DecisionServiceInstance => {
  const logger = opt.logger ? getMockLogger() : undefined;
  const userProfileService = opt.userProfileService ? {
    lookup: vi.fn(),
    save: vi.fn(),
  } : undefined;

  const userProfileServiceAsync = opt.userProfileServiceAsync ? {
    lookup: vi.fn(),
    save: vi.fn(),
  } : undefined;

  const cmabService = {
    getDecision: vi.fn(),
  };

  const decisionService = new DecisionService({
    logger,
    userProfileService,
    userProfileServiceAsync,
    UNSTABLE_conditionEvaluators: {},
    cmabService,
  });

  return {
    logger,
    userProfileService,
    userProfileServiceAsync,
    decisionService,
    cmabService,
  };
};

vi.mock('../bucketer/index', { spy: true });

const cloneDeep = (d: any) => JSON.parse(JSON.stringify(d));

const testData = getTestProjectConfig();
const testDataWithFeatures = getTestProjectConfigWithFeatures();

// Utility function to create test datafile with holdout configurations
const getHoldoutTestDatafile = () => {
  const datafile = getDecisionTestDatafile();
  
  // Add holdouts to the datafile
  datafile.holdouts = [
    {
      id: 'holdout_running_id',
      key: 'holdout_running',
      status: 'Running',
      includedFlags: [],
      excludedFlags: [],
      audienceIds: ['4001'], // age_22 audience
      audienceConditions: ['or', '4001'],
      variations: [
        {
          id: 'holdout_variation_running_id',
          key: 'holdout_variation_running',
          variables: []
        }
      ],
      trafficAllocation: [
        {
          entityId: 'holdout_variation_running_id',
          endOfRange: 5000
        }
      ]
    },
    {
      id: "holdout_not_bucketed_id",
      key: "holdout_not_bucketed",
      status: "Running",
      includedFlags: [],
      excludedFlags: [],
      audienceIds: ['4002'],
      audienceConditions: ['or', '4002'],
      variations: [
        {
          id: 'holdout_not_bucketed_variation_id',
          key: 'holdout_not_bucketed_variation',
          variables: []
        }
      ],
      trafficAllocation: [
        {
          entityId: 'holdout_not_bucketed_variation_id',
          endOfRange:  0,
        }
      ]
    },
  ];

  return datafile;
};

const verifyBucketCall = (
  mockBucket: MockInstance<typeof bucket>,
  call: number,
  projectConfig: ProjectConfig,
  experiment: Experiment,
  user: OptimizelyUserContext,
  bucketIdFromAttribute = false,
) => {
  const {
    experimentId,
    experimentKey,
    userId,
    trafficAllocationConfig,
    experimentKeyMap,
    experimentIdMap,
    groupIdMap,
    variationIdMap,
    bucketingId,
  } = mockBucket.mock.calls[call][0];
  let expectedTrafficAllocation = experiment.trafficAllocation;
  if (experiment.cmab) {
    expectedTrafficAllocation = [{
      endOfRange: experiment.cmab.trafficAllocation,
      entityId: CMAB_DUMMY_ENTITY_ID,
    }];
  }

  expect(experimentId).toBe(experiment.id);
  expect(experimentKey).toBe(experiment.key);
  expect(userId).toBe(user.getUserId());
  expect(trafficAllocationConfig).toEqual(expectedTrafficAllocation);
  expect(experimentKeyMap).toBe(projectConfig.experimentKeyMap);
  expect(experimentIdMap).toBe(projectConfig.experimentIdMap);
  expect(groupIdMap).toBe(projectConfig.groupIdMap);
  expect(variationIdMap).toBe(projectConfig.variationIdMap);
  expect(bucketingId).toBe(bucketIdFromAttribute ? user.getAttributes()[CONTROL_ATTRIBUTES.BUCKETING_ID] : user.getUserId());
};

describe('DecisionService', () => {
  const mockBucket: MockInstance<typeof bucket> = bucket as any;

  describe('getVariation', function() {
    beforeEach(() => {
      mockBucket.mockClear();
    });

    it('should return the correct variation from bucketer for the given experiment key and user ID for a running experiment', () => {
      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester'
      });

      const config = createProjectConfig(cloneDeep(testData));

      const fakeDecisionResponse = {
        result: '111128',
        reasons: [],
      };

      const experiment = config.experimentIdMap['111127'];

      mockBucket.mockReturnValue(fakeDecisionResponse); // contains variation ID of the 'control' variation from `test_data`

      const { decisionService } = getDecisionService();

      const variation = decisionService.getVariation(config, experiment, user);

      expect(variation.result).toBe('control');

      expect(mockBucket).toHaveBeenCalledTimes(1);
      verifyBucketCall(mockBucket, 0, config, experiment, user);
    });

    it('should use $opt_bucketing_id attribute as bucketing id if provided', () => {
      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          $opt_bucketing_id: 'test_bucketing_id',
        },
      });

      const config = createProjectConfig(cloneDeep(testData));

      const fakeDecisionResponse = {
        result: '111128',
        reasons: [],
      };

      const experiment = config.experimentIdMap['111127'];

      mockBucket.mockReturnValue(fakeDecisionResponse); // contains variation ID of the 'control' variation from `test_data`

      const { decisionService } = getDecisionService();

      const variation = decisionService.getVariation(config, experiment, user);

      expect(variation.result).toBe('control');

      expect(mockBucket).toHaveBeenCalledTimes(1);
      verifyBucketCall(mockBucket, 0, config, experiment, user, true);
    });

    it('should return the whitelisted variation if the user is whitelisted', function() {
      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'user2'
      });

      const config = createProjectConfig(cloneDeep(testData));

      const experiment = config.experimentIdMap['122227'];

      const { decisionService, logger } = getDecisionService({ logger: true });

      const variation = decisionService.getVariation(config, experiment, user);

      expect(variation.result).toBe('variationWithAudience');
      expect(mockBucket).not.toHaveBeenCalled();
      expect(logger?.debug).toHaveBeenCalledTimes(1);
      expect(logger?.info).toHaveBeenCalledTimes(1);

      expect(logger?.debug).toHaveBeenNthCalledWith(1, USER_HAS_NO_FORCED_VARIATION, 'user2');
      expect(logger?.info).toHaveBeenNthCalledWith(1, USER_FORCED_IN_VARIATION, 'user2', 'variationWithAudience');
    });

    it('should return null if the user does not meet audience conditions', () => {
      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'user3'
      });

      const config = createProjectConfig(cloneDeep(testData));

      const experiment = config.experimentIdMap['122227'];

      const { decisionService, logger } = getDecisionService({ logger: true });

      const variation = decisionService.getVariation(config, experiment, user);

      expect(variation.result).toBe(null);
      expect(mockBucket).not.toHaveBeenCalled();

      expect(logger?.debug).toHaveBeenNthCalledWith(1, USER_HAS_NO_FORCED_VARIATION, 'user3');
      expect(logger?.debug).toHaveBeenNthCalledWith(2, EVALUATING_AUDIENCES_COMBINED, 'experiment', 'testExperimentWithAudiences', JSON.stringify(["11154"]));

      expect(logger?.info).toHaveBeenNthCalledWith(1, AUDIENCE_EVALUATION_RESULT_COMBINED, 'experiment', 'testExperimentWithAudiences', 'FALSE');
      expect(logger?.info).toHaveBeenNthCalledWith(2, USER_NOT_IN_EXPERIMENT, 'user3', 'testExperimentWithAudiences');
    });

    it('should return the forced variation set using setForcedVariation \
        in presence of a whitelisted variation', function() {
      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'user2'
      });

      const config = createProjectConfig(cloneDeep(testData));

      const experiment = config.experimentIdMap['122227'];

      const { decisionService } = getDecisionService();

      const forcedVariation = 'controlWithAudience';

      decisionService.setForcedVariation(config, experiment.key, user.getUserId(), forcedVariation);

      const variation = decisionService.getVariation(config, experiment, user);
      expect(variation.result).toBe(forcedVariation);

      const whitelistedVariation = experiment.forcedVariations?.[user.getUserId()];
      expect(whitelistedVariation).toBeDefined();
      expect(whitelistedVariation).not.toEqual(forcedVariation);
    });

    it('should return the forced variation set using setForcedVariation \
        even if user does not satisfy audience condition', function() {
      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'user3', // no attributes are set, should not satisfy audience condition 11154
      });

      const config = createProjectConfig(cloneDeep(testData));

      const experiment = config.experimentIdMap['122227'];

      const { decisionService } = getDecisionService();

      const forcedVariation = 'controlWithAudience';

      decisionService.setForcedVariation(config, experiment.key, user.getUserId(), forcedVariation);

      const variation = decisionService.getVariation(config, experiment, user);
      expect(variation.result).toBe(forcedVariation);
    });

    it('should return null if the experiment is not running', function() {
      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'user1'
      });

      const config = createProjectConfig(cloneDeep(testData));
            
      const experiment = config.experimentIdMap['133337'];

      const { decisionService, logger } = getDecisionService({ logger: true });

      const variation = decisionService.getVariation(config, experiment, user);

      expect(variation.result).toBe(null);
      expect(mockBucket).not.toHaveBeenCalled();
      expect(logger?.info).toHaveBeenCalledTimes(1);
      expect(logger?.info).toHaveBeenNthCalledWith(1, EXPERIMENT_NOT_RUNNING, 'testExperimentNotRunning');
    });

    it('should respect the sticky bucketing information for attributes when attributes.$opt_experiment_bucket_map is supplied', () => {
      const fakeDecisionResponse = {
        result: '111128',
        reasons: [],
      };

      const config = createProjectConfig(cloneDeep(testData)); 
      const experiment = config.experimentIdMap['111127'];

      const attributes: UserAttributes = {
        $opt_experiment_bucket_map: {
          '111127': {
            variation_id: '111129', // ID of the 'variation' variation
          },
        },
      };

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'decision_service_user',
        attributes,
      });
  
      mockBucket.mockReturnValue(fakeDecisionResponse); // contains variation ID of the 'control' variation from `test_data`

      const { decisionService } = getDecisionService();

      const variation = decisionService.getVariation(config, experiment, user);

      expect(variation.result).toBe('variation');
      expect(mockBucket).not.toHaveBeenCalled();
    });

    describe('when a user profile service is provided', function() {
      beforeEach(() => {
        mockBucket.mockClear();
      });

      it('should return the previously bucketed variation', () => {
        const { decisionService, userProfileService, logger } = getDecisionService({ userProfileService: true, logger: true });

        userProfileService?.lookup.mockReturnValue({
          user_id: 'decision_service_user',
          experiment_bucket_map: {
            '111127': {
              variation_id: '111129', // ID of the 'variation' variation
            },
          },
        });

        mockBucket.mockReturnValue({
          result: '111128', // ID of the 'control' variation
          reasons: [],
        });

        const config = createProjectConfig(cloneDeep(testData));
        const experiment = config.experimentIdMap['111127'];

        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'decision_service_user',
        });

        const variation = decisionService.getVariation(config, experiment, user);
        expect(variation.result).toBe('variation');

        expect(userProfileService?.lookup).toHaveBeenCalledTimes(1);
        expect(userProfileService?.lookup).toHaveBeenCalledWith('decision_service_user');
        expect(mockBucket).not.toHaveBeenCalled();

        expect(logger?.debug).toHaveBeenCalledTimes(1);
        expect(logger?.info).toHaveBeenCalledTimes(1);

        expect(logger?.debug).toHaveBeenNthCalledWith(1, USER_HAS_NO_FORCED_VARIATION, 'decision_service_user');
        expect(logger?.info).toHaveBeenNthCalledWith(1, RETURNING_STORED_VARIATION, 'variation', 'testExperiment', 'decision_service_user');
      });

      it('should bucket and save user profile if there was no prevously bucketed variation', function() {
        mockBucket.mockReturnValue({
          result: '111128', // ID of the 'control' variation
          reasons: [],
        });

        const { decisionService, userProfileService, logger } = getDecisionService({ userProfileService: true, logger: true });

        userProfileService?.lookup.mockReturnValue({
          user_id: 'decision_service_user',
          experiment_bucket_map: {},
        });

        const config = createProjectConfig(cloneDeep(testData));
        const experiment = config.experimentIdMap['111127'];

        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'decision_service_user',
        });

        const variation = decisionService.getVariation(config, experiment, user);
        expect(variation.result).toBe('control');

        expect(userProfileService?.lookup).toHaveBeenCalledTimes(1);
        expect(userProfileService?.lookup).toHaveBeenCalledWith('decision_service_user');

        expect(mockBucket).toHaveBeenCalledTimes(1);
        verifyBucketCall(mockBucket, 0, config, experiment, user);

        expect(userProfileService?.save).toHaveBeenCalledTimes(1);
        expect(userProfileService?.save).toHaveBeenCalledWith({
          user_id: 'decision_service_user',
          experiment_bucket_map: {
            '111127': {
              variation_id: '111128',
            },
          },
        });
      });
    
      it('should bucket if the user profile service returns null', function() {
        mockBucket.mockReturnValue({
          result: '111128', // ID of the 'control' variation
          reasons: [],
        });

        const { decisionService, userProfileService, logger } = getDecisionService({ userProfileService: true, logger: true });

        userProfileService?.lookup.mockReturnValue(null);

        const config = createProjectConfig(cloneDeep(testData));
        const experiment = config.experimentIdMap['111127'];

        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'decision_service_user',
        });

        const variation = decisionService.getVariation(config, experiment, user);
        expect(variation.result).toBe('control');

        expect(userProfileService?.lookup).toHaveBeenCalledTimes(1);
        expect(userProfileService?.lookup).toHaveBeenCalledWith('decision_service_user');

        expect(mockBucket).toHaveBeenCalledTimes(1);
        verifyBucketCall(mockBucket, 0, config, experiment, user);

        expect(userProfileService?.save).toHaveBeenCalledTimes(1);
        expect(userProfileService?.save).toHaveBeenCalledWith({
          user_id: 'decision_service_user',
          experiment_bucket_map: {
            '111127': {
              variation_id: '111128',
            },
          },
        });
      });

      it('should re-bucket if the stored variation is no longer valid', function() {
        mockBucket.mockReturnValue({
          result: '111128', // ID of the 'control' variation
          reasons: [],
        });

        const { decisionService, userProfileService, logger } = getDecisionService({ userProfileService: true, logger: true });

        userProfileService?.lookup.mockReturnValue({
          user_id: 'decision_service_user',
          experiment_bucket_map: {
            '111127': {
              variation_id: 'not valid variation',
            },
          },
        });

        const config = createProjectConfig(cloneDeep(testData));
        const experiment = config.experimentIdMap['111127'];

        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'decision_service_user',
        });

        const variation = decisionService.getVariation(config, experiment, user);
        expect(variation.result).toBe('control');

        expect(userProfileService?.lookup).toHaveBeenCalledTimes(1);
        expect(userProfileService?.lookup).toHaveBeenCalledWith('decision_service_user');

        expect(mockBucket).toHaveBeenCalledTimes(1);
        verifyBucketCall(mockBucket, 0, config, experiment, user);

        expect(logger?.debug).toHaveBeenCalledWith(USER_HAS_NO_FORCED_VARIATION, 'decision_service_user');
        expect(logger?.info).toHaveBeenCalledWith(SAVED_VARIATION_NOT_FOUND, 'decision_service_user', 'not valid variation', 'testExperiment');

        expect(userProfileService?.save).toHaveBeenCalledTimes(1);
        expect(userProfileService?.save).toHaveBeenCalledWith({
          user_id: 'decision_service_user',
          experiment_bucket_map: {
            '111127': {
              variation_id: '111128',
            },
          },
        });
      });

      it('should store the bucketed variation for the user', function() {
        mockBucket.mockReturnValue({
          result: '111128', // ID of the 'control' variation
          reasons: [],
        });

        const { decisionService, userProfileService, logger } = getDecisionService({ userProfileService: true, logger: true });

        userProfileService?.lookup.mockReturnValue({
          user_id: 'decision_service_user',
          experiment_bucket_map: {},
        });

        const config = createProjectConfig(cloneDeep(testData));
        const experiment = config.experimentIdMap['111127'];

        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'decision_service_user',
        });

        const variation = decisionService.getVariation(config, experiment, user);
        expect(variation.result).toBe('control');
        
        expect(userProfileService?.lookup).toHaveBeenCalledTimes(1);
        expect(userProfileService?.lookup).toHaveBeenCalledWith('decision_service_user');

        expect(mockBucket).toHaveBeenCalledTimes(1);
        verifyBucketCall(mockBucket, 0, config, experiment, user);

        expect(userProfileService?.save).toHaveBeenCalledTimes(1);
        expect(userProfileService?.save).toHaveBeenCalledWith({
          user_id: 'decision_service_user',
          experiment_bucket_map: {
            '111127': {
              variation_id: '111128',
            },
          },
        });
      });


      it('should log an error message and bucket if "lookup" throws an error', () => {
        mockBucket.mockReturnValue({
          result: '111128', // ID of the 'control' variation
          reasons: [],
        });

        const { decisionService, userProfileService, logger } = getDecisionService({ userProfileService: true, logger: true });

        userProfileService?.lookup.mockImplementation(() => {
          throw new Error('I am an error');
        });

        const config = createProjectConfig(cloneDeep(testData));
        const experiment = config.experimentIdMap['111127'];

        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'decision_service_user',
        });

        const variation = decisionService.getVariation(config, experiment, user);
        expect(variation.result).toBe('control');
        
        expect(userProfileService?.lookup).toHaveBeenCalledTimes(1);
        expect(userProfileService?.lookup).toHaveBeenCalledWith('decision_service_user');

        expect(mockBucket).toHaveBeenCalledTimes(1);
        verifyBucketCall(mockBucket, 0, config, experiment, user);

        expect(logger?.debug).toHaveBeenCalledWith(USER_HAS_NO_FORCED_VARIATION, 'decision_service_user');
        expect(logger?.error).toHaveBeenCalledWith(USER_PROFILE_LOOKUP_ERROR, 'decision_service_user', 'I am an error');

        expect(userProfileService?.save).toHaveBeenCalledTimes(1);
        expect(userProfileService?.save).toHaveBeenCalledWith({
          user_id: 'decision_service_user',
          experiment_bucket_map: {
            '111127': {
              variation_id: '111128',
            },
          },
        });
      });

      it('should log an error message if "save" throws an error', () => {
        mockBucket.mockReturnValue({
          result: '111128', // ID of the 'control' variation
          reasons: [],
        });

        const { decisionService, userProfileService, logger } = getDecisionService({ userProfileService: true, logger: true });

        userProfileService?.lookup.mockReturnValue(null);
        userProfileService?.save.mockImplementation(() => {
          throw new Error('I am an error');
        });

        const config = createProjectConfig(cloneDeep(testData));
        const experiment = config.experimentIdMap['111127'];

        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'decision_service_user',
        });

        const variation = decisionService.getVariation(config, experiment, user);
        expect(variation.result).toBe('control');
        
        expect(userProfileService?.lookup).toHaveBeenCalledTimes(1);
        expect(userProfileService?.lookup).toHaveBeenCalledWith('decision_service_user');

        expect(mockBucket).toHaveBeenCalledTimes(1);
        verifyBucketCall(mockBucket, 0, config, experiment, user);

        expect(userProfileService?.save).toHaveBeenCalledTimes(1);
        expect(userProfileService?.save).toHaveBeenCalledWith({
          user_id: 'decision_service_user',
          experiment_bucket_map: {
            '111127': {
              variation_id: '111128',
            },
          },
        });

        expect(logger?.error).toHaveBeenCalledWith(USER_PROFILE_SAVE_ERROR, 'decision_service_user', 'I am an error');
      });

      it('should respect $opt_experiment_bucket_map attribute over the userProfileService for the matching experiment id', function() {
        const { decisionService, userProfileService, logger } = getDecisionService({ userProfileService: true, logger: true });

        userProfileService?.lookup.mockReturnValue({
          user_id: 'decision_service_user',
          experiment_bucket_map: {
            '111127': {
              variation_id: '111128', // ID of the 'control' variation
            },
          },
        });

        const config = createProjectConfig(cloneDeep(testData));
        const experiment = config.experimentIdMap['111127'];

        const attributes: UserAttributes = {
          $opt_experiment_bucket_map: {
            '111127': {
              variation_id: '111129', // ID of the 'variation' variation
            },
          },
        };

        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'decision_service_user',
          attributes,
        });

        const variation = decisionService.getVariation(config, experiment, user);
        expect(variation.result).toBe('variation');
      });

      it('should ignore attributes for a different experiment id', function() {
        const { decisionService, userProfileService, logger } = getDecisionService({ userProfileService: true, logger: true });

        userProfileService?.lookup.mockReturnValue({
          user_id: 'decision_service_user',
          experiment_bucket_map: {
            '111127': {
              variation_id: '111128', // ID of the 'control' variation
            },
          },
        });

        const config = createProjectConfig(cloneDeep(testData));
        const experiment = config.experimentIdMap['111127'];

        const attributes: UserAttributes = {
          $opt_experiment_bucket_map: {
            '122227': {
              variation_id: '111129', // ID of the 'variation' variation
            },
          },
        };

        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'decision_service_user',
          attributes,
        });

        const variation = decisionService.getVariation(config, experiment, user);
        expect(variation.result).toBe('control');
      });

      it('should use $ opt_experiment_bucket_map attribute when the userProfile contains variations for other experiments', function() {
        const { decisionService, userProfileService, logger } = getDecisionService({ userProfileService: true, logger: true });

        userProfileService?.lookup.mockReturnValue({
          user_id: 'decision_service_user',
          experiment_bucket_map: {
            '122227': {
              variation_id: '122229', // ID of the 'variationWithAudience' variation
            },
          },
        });

        const config = createProjectConfig(cloneDeep(testData));
        const experiment = config.experimentIdMap['111127'];

        const attributes: UserAttributes = {
          $opt_experiment_bucket_map: {
            '111127': {
              variation_id: '111129', // ID of the 'variation' variation
            },
          },
        };

        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'decision_service_user',
          attributes,
        });

        const variation = decisionService.getVariation(config, experiment, user);
        expect(variation.result).toBe('variation');
      });

      it('should use attributes when the userProfileLookup returns null', function() {
        const { decisionService, userProfileService, logger } = getDecisionService({ userProfileService: true, logger: true });

        userProfileService?.lookup.mockReturnValue(null);

        const config = createProjectConfig(cloneDeep(testData));
        const experiment = config.experimentIdMap['111127'];

        const attributes: UserAttributes = {
          $opt_experiment_bucket_map: {
            '111127': {
              variation_id: '111129', // ID of the 'variation' variation
            },
          },
        };

        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'decision_service_user',
          attributes,
        });

        const variation = decisionService.getVariation(config, experiment, user);
        expect(variation.result).toBe('variation');
      });
    });
  });

  describe('getVariationForFeature - sync', () => {
    beforeEach(() => {
      mockBucket.mockReset();
    });

    it('should return variation from the first experiment for which a variation is available', () => {
      const { decisionService } = getDecisionService();

      const resolveVariationSpy = vi.spyOn(decisionService as any, 'resolveVariation')
        .mockImplementation((
          op,
          config,
          experiment: any,
          user,
          decideOptions,
          userProfileTracker: any,
        ) => {
          if (experiment.key === 'exp_2') {
            return Value.of('sync', {
              result: { variationKey: 'variation_2' },
              reasons: [],
            });
          }
          return Value.of('sync', {
            result: {},
            reasons: [],
          });
        });

      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          age: 40,
        },
      });

      const feature = config.featureKeyMap['flag_1'];
      const variation = decisionService.getVariationForFeature(config, feature, user);

      expect(variation.result).toEqual({
        experiment: config.experimentKeyMap['exp_2'],
        variation: config.variationIdMap['5002'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(resolveVariationSpy).toHaveBeenCalledTimes(2);
      expect(resolveVariationSpy).toHaveBeenNthCalledWith(1, 
        'sync', config, config.experimentKeyMap['exp_1'], user, expect.anything(), expect.anything());
      expect(resolveVariationSpy).toHaveBeenNthCalledWith(2,
        'sync', config, config.experimentKeyMap['exp_2'], user, expect.anything(), expect.anything());
    });

    it('should return the variation forced for an experiment in the userContext if available', () => {
      const { decisionService } = getDecisionService();

      const resolveVariationSpy = vi.spyOn(decisionService as any, 'resolveVariation')
        .mockImplementation((
          op,
          config,
          experiment: any,
          user,
          decideOptions,
          userProfileTracker: any,
        ) => {
          if (experiment.key === 'exp_2') {
            return Value.of('sync', {
              result: { varationKey: 'variation_2' },
              reasons: [],
            });
          }
          return Value.of('sync', {
            result: {},
            reasons: [],
          });
        });

      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          age: 40,
        },
      });

      user.setForcedDecision(
        { flagKey: 'flag_1', ruleKey: 'exp_2' }, 
        { variationKey: 'variation_5' }
      );

      const feature = config.featureKeyMap['flag_1'];
      const variation = decisionService.getVariationForFeature(config, feature, user);

      expect(variation.result).toEqual({
        experiment: config.experimentKeyMap['exp_2'],
        variation: config.variationIdMap['5005'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });
    });

    it('should save the variation found for an experiment in the user profile', () => {
      const { decisionService, userProfileService } = getDecisionService({ userProfileService: true });

      const resolveVariationSpy = vi.spyOn(decisionService as any, 'resolveVariation')
        .mockImplementation((
          op,
          config,
          experiment: any,
          user,
          decideOptions,
          userProfileTracker: any,
        ) => {
          if (experiment.key === 'exp_2') {
            const variation = 'variation_2';

            userProfileTracker.userProfile[experiment.id] = {
              variation_id: '5002',
            };
            userProfileTracker.isProfileUpdated = true;

            return Value.of('sync', {
              result: { variationKey: 'variation_2' },
              reasons: [],
            });
          }
          return Value.of('sync', {
            result: {},
            reasons: [],
          });
        });

      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          age: 40,
        },
      });

      userProfileService?.lookup.mockImplementation((userId: string) => {
        if (userId === 'tester') {
          return {
            user_id: 'tester',
            experiment_bucket_map: {
              '2001': {
                variation_id: '5001',
              },
            },
          };
        }
        return null;
      });


      const feature = config.featureKeyMap['flag_1'];
      const variation = decisionService.getVariationForFeature(config, feature, user);

      expect(variation.result).toEqual({
        experiment: config.experimentKeyMap['exp_2'],
        variation: config.variationIdMap['5002'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(userProfileService?.lookup).toHaveBeenCalledTimes(1);
      expect(userProfileService?.lookup).toHaveBeenCalledWith('tester');

      expect(userProfileService?.save).toHaveBeenCalledTimes(1);
      expect(userProfileService?.save).toHaveBeenCalledWith({
        user_id: 'tester',
        experiment_bucket_map: {
          '2001': {
            variation_id: '5001',
          },
          '2002': {
            variation_id: '5002',
          },
        },
      });
    });

    describe('when no variation is found for any experiment and a targeted delivery \
        audience condition is satisfied', () => {
      beforeEach(() => {
        mockBucket.mockReset();
      });

      it('should return variation from the target delivery for which audience condition \
          is satisfied if the user is bucketed into it', () => {
        const { decisionService } = getDecisionService();

        const resolveVariationSpy = vi.spyOn(decisionService as any, 'resolveVariation')
          .mockReturnValue(Value.of('sync', {
            result: {},
            reasons: [],
          }));

        const config = createProjectConfig(getDecisionTestDatafile());

        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'tester',
          attributes: {
            age: 55, // this should satisfy the audience condition for the targeted delivery with key delivery_2 and delivery_3
          },
        });

        mockBucket.mockImplementation((param: BucketerParams) => {
          const ruleKey = param.experimentKey;
          if (ruleKey === 'delivery_2') {
            return {
              result: '5005',
              reasons: [],
            };
          }
          return {
            result: null,
            reasons: [],
          };
        });

        const feature = config.featureKeyMap['flag_1'];
        const variation = decisionService.getVariationForFeature(config, feature, user);

        expect(variation.result).toEqual({
          experiment: config.experimentKeyMap['delivery_2'],
          variation: config.variationIdMap['5005'],
          decisionSource: DECISION_SOURCES.ROLLOUT,
        });

        expect(resolveVariationSpy).toHaveBeenCalledTimes(3);
        expect(resolveVariationSpy).toHaveBeenNthCalledWith(1, 
          'sync', config, config.experimentKeyMap['exp_1'], user, expect.anything(), expect.anything());
        expect(resolveVariationSpy).toHaveBeenNthCalledWith(2,
          'sync', config, config.experimentKeyMap['exp_2'], user, expect.anything(), expect.anything());
        expect(resolveVariationSpy).toHaveBeenNthCalledWith(3,
          'sync', config, config.experimentKeyMap['exp_3'], user, expect.anything(), expect.anything());

        expect(mockBucket).toHaveBeenCalledTimes(1);
        verifyBucketCall(mockBucket, 0, config, config.experimentIdMap['3002'], user);
      });

      it('should return variation from the target delivery and use $opt_bucketing_id attribute as bucketing id', () => {
        const { decisionService } = getDecisionService();

        const resolveVariationSpy = vi.spyOn(decisionService as any, 'resolveVariation')
          .mockReturnValue(Value.of('sync', {
            result: {},
            reasons: [],
          }));

        const config = createProjectConfig(getDecisionTestDatafile());

        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'tester',
          attributes: {
            age: 55, // this should satisfy the audience condition for the targeted delivery with key delivery_2 and delivery_3
            $opt_bucketing_id: 'test_bucketing_id',
          },
        });

        mockBucket.mockImplementation((param: BucketerParams) => {
          const ruleKey = param.experimentKey;
          if (ruleKey === 'delivery_2') {
            return {
              result: '5005',
              reasons: [],
            };
          }
          return {
            result: null,
            reasons: [],
          };
        });

        const feature = config.featureKeyMap['flag_1'];
        const variation = decisionService.getVariationForFeature(config, feature, user);

        expect(variation.result).toEqual({
          experiment: config.experimentKeyMap['delivery_2'],
          variation: config.variationIdMap['5005'],
          decisionSource: DECISION_SOURCES.ROLLOUT,
        });

        expect(resolveVariationSpy).toHaveBeenCalledTimes(3);
        expect(resolveVariationSpy).toHaveBeenNthCalledWith(1, 
          'sync', config, config.experimentKeyMap['exp_1'], user, expect.anything(), expect.anything());
        expect(resolveVariationSpy).toHaveBeenNthCalledWith(2,
          'sync', config, config.experimentKeyMap['exp_2'], user, expect.anything(), expect.anything());
        expect(resolveVariationSpy).toHaveBeenNthCalledWith(3,
          'sync', config, config.experimentKeyMap['exp_3'], user, expect.anything(), expect.anything());

        expect(mockBucket).toHaveBeenCalledTimes(1);
        verifyBucketCall(mockBucket, 0, config, config.experimentIdMap['3002'], user, true);
      });

      it('should skip to everyone else targeting rule if the user is not bucketed \
          into the targeted delivery for which audience condition is satisfied', () => {
        const { decisionService } = getDecisionService();

        const resolveVariationSpy = vi.spyOn(decisionService as any, 'resolveVariation')
          .mockReturnValue(Value.of('sync', {
            result: {},
            reasons: [],
          }));

        const config = createProjectConfig(getDecisionTestDatafile());

        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'tester',
          attributes: {
            age: 55, // this should satisfy the audience condition for the targeted delivery with key delivery_2 and delivery_3
          },
        });

        mockBucket.mockImplementation((param: BucketerParams) => {
          const ruleKey = param.experimentKey;
          if (ruleKey === 'default-rollout-key') {
            return {
              result: '5007',
              reasons: [],
            };
          }
          return {
            result: null,
            reasons: [],
          };
        });

        const feature = config.featureKeyMap['flag_1'];
        const variation = decisionService.getVariationForFeature(config, feature, user);

        expect(variation.result).toEqual({
          experiment: config.experimentIdMap['default-rollout-id'],
          variation: config.variationIdMap['5007'],
          decisionSource: DECISION_SOURCES.ROLLOUT,
        });

        expect(resolveVariationSpy).toHaveBeenCalledTimes(3);
        expect(resolveVariationSpy).toHaveBeenNthCalledWith(1, 
          'sync', config, config.experimentKeyMap['exp_1'], user, expect.anything(), expect.anything());
        expect(resolveVariationSpy).toHaveBeenNthCalledWith(2,
          'sync', config, config.experimentKeyMap['exp_2'], user, expect.anything(), expect.anything());
        expect(resolveVariationSpy).toHaveBeenNthCalledWith(3,
          'sync', config, config.experimentKeyMap['exp_3'], user, expect.anything(), expect.anything());

        expect(mockBucket).toHaveBeenCalledTimes(2);
        verifyBucketCall(mockBucket, 0, config, config.experimentIdMap['3002'], user);
        verifyBucketCall(mockBucket, 1, config, config.experimentIdMap['default-rollout-id'], user);
      });
    });

    it('should return the forced variation for targeted delivery rule when no variation \
        is found for any experiment and a there is a forced decision \
        for a targeted delivery in the userContext', () => {
      const { decisionService } = getDecisionService();

      const resolveVariationSpy = vi.spyOn(decisionService as any, 'resolveVariation')
        .mockImplementation((
          op,
          config,
          experiment: any,
          user,
          decideOptions,
          userProfileTracker: any,
        ) => {
          return Value.of('sync', {
            result: {},
            reasons: [],
          });
        });

      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester', 
      });

      user.setForcedDecision(
        { flagKey: 'flag_1', ruleKey: 'delivery_2' }, 
        { variationKey: 'variation_1' }
      );

      const feature = config.featureKeyMap['flag_1'];
      const variation = decisionService.getVariationForFeature(config, feature, user);

      expect(variation.result).toEqual({
        experiment: config.experimentKeyMap['delivery_2'],
        variation: config.variationIdMap['5001'],
        decisionSource: DECISION_SOURCES.ROLLOUT,
      });
    });

    it('should return variation from the everyone else targeting rule if no variation \
        is found for any experiment or targeted delivery', () => {
      const { decisionService } = getDecisionService();

      const resolveVariationSpy = vi.spyOn(decisionService as any, 'resolveVariation')
        .mockReturnValue(Value.of('sync', {
          result: {},
          reasons: [],
        }));

      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          age: 100, // this should not satisfy any audience condition for any targeted delivery
        },
      });

      mockBucket.mockImplementation((param: BucketerParams) => {
        const ruleKey = param.experimentKey;
        if (ruleKey === 'default-rollout-key') {
          return {
            result: '5007',
            reasons: [],
          };
        }
        return {
          result: null,
          reasons: [],
        };
      });

      const feature = config.featureKeyMap['flag_1'];
      const variation = decisionService.getVariationForFeature(config, feature, user);

      expect(variation.result).toEqual({
        experiment: config.experimentIdMap['default-rollout-id'],
        variation: config.variationIdMap['5007'],
        decisionSource: DECISION_SOURCES.ROLLOUT,
      });

      expect(resolveVariationSpy).toHaveBeenCalledTimes(3);
      expect(resolveVariationSpy).toHaveBeenNthCalledWith(1, 
        'sync', config, config.experimentKeyMap['exp_1'], user, expect.anything(), expect.anything());
      expect(resolveVariationSpy).toHaveBeenNthCalledWith(2,
        'sync', config, config.experimentKeyMap['exp_2'], user, expect.anything(), expect.anything());
      expect(resolveVariationSpy).toHaveBeenNthCalledWith(3,
        'sync', config, config.experimentKeyMap['exp_3'], user, expect.anything(), expect.anything());

      expect(mockBucket).toHaveBeenCalledTimes(1);
      verifyBucketCall(mockBucket, 0, config, config.experimentIdMap['default-rollout-id'], user);
    });

    it('should return null if no variation is found for any experiment, targeted delivery, or everyone else targeting rule', () => {
      const { decisionService } = getDecisionService();

      const resolveVariationSpy = vi.spyOn(decisionService as any, 'resolveVariation')
        .mockReturnValue(Value.of('sync', {
          result: {},
          reasons: [],
        }));
      
      const config = createProjectConfig(getDecisionTestDatafile());
      const rolloutId = config.featureKeyMap['flag_1'].rolloutId;
      config.rolloutIdMap[rolloutId].experiments = []; // remove the experiments from the rollout

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          age: 10,
        },
      });

      const feature = config.featureKeyMap['flag_1'];
      const variation = decisionService.getVariationForFeature(config, feature, user);

      expect(variation.result).toEqual({
        experiment: null,
        variation: null,
        decisionSource: DECISION_SOURCES.ROLLOUT,
      });

      expect(resolveVariationSpy).toHaveBeenCalledTimes(3);
      expect(resolveVariationSpy).toHaveBeenNthCalledWith(1, 
        'sync', config, config.experimentKeyMap['exp_1'], user, expect.anything(), expect.anything());
      expect(resolveVariationSpy).toHaveBeenNthCalledWith(2,
        'sync', config, config.experimentKeyMap['exp_2'], user, expect.anything(), expect.anything());
      expect(resolveVariationSpy).toHaveBeenNthCalledWith(3,
        'sync', config, config.experimentKeyMap['exp_3'], user, expect.anything(), expect.anything());

      expect(mockBucket).toHaveBeenCalledTimes(0);
    });
  });

  describe('resolveVariationForFeatureList - async', () => {
    beforeEach(() => {
      mockBucket.mockReset();
    });

    it('should return variation from the first experiment for which a variation is available', async () => {
      const { decisionService } = getDecisionService();
      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          age: 15, // should satisfy audience condition for all experiments
        },
      });

      mockBucket.mockImplementation((param: BucketerParams) => {
        const ruleKey = param.experimentKey;
        if (ruleKey === 'exp_2') {
          return {
            result: '5002',
            reasons: [],
          };
        }
        return {
          result: null,
          reasons: [],
        };
      });

      const feature = config.featureKeyMap['flag_1'];
      const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();
      expect(value).toBeInstanceOf(Promise);

      const variation = (await value)[0];
      expect(variation.result).toEqual({
        experiment: config.experimentKeyMap['exp_2'],
        variation: config.variationIdMap['5002'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });
    });

    it('should not return variation and should not call cmab service \
        for cmab experiment if user is not bucketed into it', async () => {
      const { decisionService, cmabService } = getDecisionService();
      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          country: 'BD',
          age: 80, // should satisfy audience condition for exp_3 which is cmab and not others
        },
      });

      mockBucket.mockImplementation((param: BucketerParams) => {
        const ruleKey = param.experimentKey;
        if (ruleKey == 'default-rollout-key') {
          return { result: param.trafficAllocationConfig[0].entityId, reasons: [] }
        }
        return {
          result: null,
          reasons: [],
        }
      });

      const feature = config.featureKeyMap['flag_1'];
      const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();
      expect(value).toBeInstanceOf(Promise);

      const variation = (await value)[0];
      expect(variation.result).toEqual({
        experiment: config.experimentKeyMap['default-rollout-key'],
        variation: config.variationIdMap['5007'],
        decisionSource: DECISION_SOURCES.ROLLOUT,
      });

      verifyBucketCall(mockBucket, 0, config, config.experimentKeyMap['exp_3'], user);
      expect(cmabService.getDecision).not.toHaveBeenCalled();
    });

    it('should get decision from the cmab service if the experiment is a cmab experiment \
        and user is bucketed into it', async () => {
      const { decisionService, cmabService } = getDecisionService();
      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          country: 'BD',
          age: 80, // should satisfy audience condition for exp_3 which is cmab and not others
        },
      });

      mockBucket.mockImplementation((param: BucketerParams) => {
        const ruleKey = param.experimentKey;
        if (ruleKey == 'exp_3') {
          return { result: param.trafficAllocationConfig[0].entityId, reasons: [] }
        }
        return {
          result: null,
          reasons: [],
        }
      });

      cmabService.getDecision.mockResolvedValue({
        variationId: '5003',
        cmabUuid: 'uuid-test',
      });

      const feature = config.featureKeyMap['flag_1'];
      const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();
      expect(value).toBeInstanceOf(Promise);

      const variation = (await value)[0];
      expect(variation.result).toEqual({
        cmabUuid: 'uuid-test',
        experiment: config.experimentKeyMap['exp_3'],
        variation: config.variationIdMap['5003'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      verifyBucketCall(mockBucket, 0, config, config.experimentKeyMap['exp_3'], user);

      expect(cmabService.getDecision).toHaveBeenCalledTimes(1);
      expect(cmabService.getDecision).toHaveBeenCalledWith(
        config,
        user,
        '2003', // id of exp_3
        {},
      );
    });

    it('should pass the correct DecideOptionMap to cmabService', async () => {
      const { decisionService, cmabService } = getDecisionService();
      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          country: 'BD',
          age: 80, // should satisfy audience condition for exp_3 which is cmab and not others
        },
      });

      mockBucket.mockImplementation((param: BucketerParams) => {
        const ruleKey = param.experimentKey;
        if (ruleKey == 'exp_3') {
          return { result: param.trafficAllocationConfig[0].entityId, reasons: [] }
        }
        return {
          result: null,
          reasons: [],
        }
      });

      cmabService.getDecision.mockResolvedValue({
        variationId: '5003',
        cmabUuid: 'uuid-test',
      });

      const feature = config.featureKeyMap['flag_1'];
      const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {
        [OptimizelyDecideOption.RESET_CMAB_CACHE]: true,
        [OptimizelyDecideOption.INVALIDATE_USER_CMAB_CACHE]: true,
      }).get();
      expect(value).toBeInstanceOf(Promise);

      const variation = (await value)[0];
      expect(variation.result).toEqual({
        cmabUuid: 'uuid-test',
        experiment: config.experimentKeyMap['exp_3'],
        variation: config.variationIdMap['5003'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(cmabService.getDecision).toHaveBeenCalledTimes(1);
      expect(cmabService.getDecision).toHaveBeenCalledWith(
        config,
        user,
        '2003', // id of exp_3
        {
          [OptimizelyDecideOption.RESET_CMAB_CACHE]: true,
          [OptimizelyDecideOption.INVALIDATE_USER_CMAB_CACHE]: true,
        },
      );
    });

    it('should return error if cmab getDecision fails', async () => {
      const { decisionService, cmabService } = getDecisionService();
      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          country: 'BD',
          age: 80, // should satisfy audience condition for exp_3 which is cmab and not others
        },
      });

      mockBucket.mockImplementation((param: BucketerParams) => {
        const ruleKey = param.experimentKey;
        if (ruleKey == 'exp_3') {
          return { result: param.trafficAllocationConfig[0].entityId, reasons: [] }
        }
        return {
          result: null,
          reasons: [],
        }
      });

      cmabService.getDecision.mockRejectedValue(new Error('I am an error'));

      const feature = config.featureKeyMap['flag_1'];
      const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();
      expect(value).toBeInstanceOf(Promise);

      const variation = (await value)[0];

      expect(variation.error).toBe(true);
      expect(variation.result).toEqual({
        experiment: config.experimentKeyMap['exp_3'],
        variation: null,
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(variation.reasons).toContainEqual(
        [CMAB_FETCH_FAILED, 'exp_3'],
      );

      expect(cmabService.getDecision).toHaveBeenCalledTimes(1);
      expect(cmabService.getDecision).toHaveBeenCalledWith(
        config,
        user,
        '2003', // id of exp_3
        {},
      );
    });

    it('should use userProfileServiceAsync if available and sync user profile service is unavialable', async () => {
      const { decisionService, cmabService, userProfileServiceAsync } = getDecisionService({
        userProfileService: false,
        userProfileServiceAsync: true,
      });

      userProfileServiceAsync?.lookup.mockImplementation((userId: string) => {
        if (userId === 'tester-1') {
          return Promise.resolve({
            user_id: 'tester-1',
            experiment_bucket_map: {
              '2001': {
                variation_id: '5002',
              },
            },
          });
        }
        return Promise.resolve(null);
      });

      userProfileServiceAsync?.save.mockImplementation(() => Promise.resolve());

      mockBucket.mockImplementation((param: BucketerParams) => {
        const ruleKey = param.experimentKey;
        if (ruleKey == 'exp_1') {
          return { result: param.trafficAllocationConfig[0].entityId, reasons: [] }
        }
        return {
          result: null,
          reasons: [],
        }
      });

      const config = createProjectConfig(getDecisionTestDatafile());

      const user1 = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester-1',
        attributes: {
          country: 'BD',
          age: 22, // should satisfy audience condition for exp_1 which is not a cmab
        },
      });

      const user2 = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester-2',
        attributes: {
          country: 'BD',
          age: 22, // should satisfy audience condition for exp_1 which is not a cmab
        },
      });

      const feature = config.featureKeyMap['flag_1'];
      const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user1, {}).get();
      expect(value).toBeInstanceOf(Promise);

      const variation = (await value)[0];

      expect(variation.result).toEqual({
        experiment: config.experimentKeyMap['exp_1'],
        variation: config.variationIdMap['5002'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(userProfileServiceAsync?.lookup).toHaveBeenCalledTimes(1);
      expect(userProfileServiceAsync?.lookup).toHaveBeenCalledWith('tester-1');

      const value2 = decisionService.resolveVariationsForFeatureList('async', config, [feature], user2, {}).get();
      expect(value2).toBeInstanceOf(Promise);

      const variation2 = (await value2)[0];
      expect(variation2.result).toEqual({
        experiment: config.experimentKeyMap['exp_1'],
        variation: config.variationIdMap['5001'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(userProfileServiceAsync?.lookup).toHaveBeenCalledTimes(2);
      expect(userProfileServiceAsync?.lookup).toHaveBeenNthCalledWith(2, 'tester-2');
      expect(userProfileServiceAsync?.save).toHaveBeenCalledTimes(1);
      expect(userProfileServiceAsync?.save).toHaveBeenCalledWith({
        user_id: 'tester-2',
        experiment_bucket_map: {
          '2001': {
            variation_id: '5001',
          },
        },
      });
    });

    it('should log error and perform normal decision fetch if async userProfile lookup fails', async () => {
      const { decisionService, cmabService, userProfileServiceAsync, logger } = getDecisionService({
        userProfileService: false,
        userProfileServiceAsync: true,
        logger: true,
      });

      userProfileServiceAsync?.lookup.mockImplementation((userId: string) => {
        return Promise.reject(new Error('I am an error'));
      });

      userProfileServiceAsync?.save.mockImplementation(() => Promise.resolve());

      mockBucket.mockImplementation((param: BucketerParams) => {
        const ruleKey = param.experimentKey;
        if (ruleKey == 'exp_3') {
          return { result: param.trafficAllocationConfig[0].entityId, reasons: [] }
        }
        return {
          result: null,
          reasons: [],
        }
      });

      cmabService.getDecision.mockResolvedValue({
        variationId: '5003',
        cmabUuid: 'uuid-test',
      });

      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          country: 'BD',
          age: 80, // should satisfy audience condition for exp_3 which is cmab and not others
        },
      });

      const feature = config.featureKeyMap['flag_1'];
      const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();
      expect(value).toBeInstanceOf(Promise);

      const variation = (await value)[0];

      expect(variation.result).toEqual({
        cmabUuid: 'uuid-test',
        experiment: config.experimentKeyMap['exp_3'],
        variation: config.variationIdMap['5003'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(userProfileServiceAsync?.lookup).toHaveBeenCalledWith('tester');
      expect(cmabService.getDecision).toHaveBeenCalledTimes(1);
      expect(cmabService.getDecision).toHaveBeenCalledWith(
        config,
        user,
        '2003', // id of exp_3
        {},
      );

      expect(logger?.error).toHaveBeenCalledTimes(1);
      expect(logger?.error).toHaveBeenCalledWith(USER_PROFILE_LOOKUP_ERROR, 'tester', 'I am an error');
    });

    it('should log error async userProfile save fails', async () => {
      const { decisionService, cmabService, userProfileServiceAsync, logger } = getDecisionService({
        userProfileService: false,
        userProfileServiceAsync: true,
        logger: true,
      });

      userProfileServiceAsync?.lookup.mockResolvedValue(null);

      userProfileServiceAsync?.save.mockRejectedValue(new Error('I am an error'));

      mockBucket.mockImplementation((param: BucketerParams) => {
        const ruleKey = param.experimentKey;
        if (ruleKey == 'exp_1') {
          return { result: param.trafficAllocationConfig[0].entityId, reasons: [] }
        }
        return {
          result: null,
          reasons: [],
        }
      });

      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          country: 'BD',
          age: 22, // should satisfy audience condition for exp_1 which is not cmab
        },
      });

      const feature = config.featureKeyMap['flag_1'];
      const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();
      expect(value).toBeInstanceOf(Promise);

      const variation = (await value)[0];

      expect(variation.result).toEqual({
        experiment: config.experimentKeyMap['exp_1'],
        variation: config.variationIdMap['5001'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(userProfileServiceAsync?.lookup).toHaveBeenCalledWith('tester');

      expect(userProfileServiceAsync?.save).toHaveBeenCalledTimes(1);
      expect(userProfileServiceAsync?.save).toHaveBeenCalledWith({
        user_id: 'tester',
        experiment_bucket_map: {
          '2001': {
            variation_id: '5001',
          },
        },
      });
      expect(logger?.error).toHaveBeenCalledTimes(1);
      expect(logger?.error).toHaveBeenCalledWith(USER_PROFILE_SAVE_ERROR, 'tester', 'I am an error');
    });
 
    it('should use the sync user profile service if both sync and async ups are provided', async () => {
      const { decisionService, userProfileService, userProfileServiceAsync, cmabService } = getDecisionService({ 
        userProfileService: true,
        userProfileServiceAsync: true,
      });

      userProfileService?.lookup.mockReturnValue(null);
      userProfileService?.save.mockReturnValue(null);

      userProfileServiceAsync?.lookup.mockResolvedValue(null);
      userProfileServiceAsync?.save.mockResolvedValue(null);

      mockBucket.mockImplementation((param: BucketerParams) => {
        const ruleKey = param.experimentKey;
        if (ruleKey == 'exp_1') {
          return { result: param.trafficAllocationConfig[0].entityId, reasons: [] }
        }
        return {
          result: null,
          reasons: [],
        }
      });

      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          country: 'BD',
          age: 22, // should satisfy audience condition for exp_1 which is not cmab
        },
      });

      const feature = config.featureKeyMap['flag_1'];
      const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();
      expect(value).toBeInstanceOf(Promise);

      const variation = (await value)[0];

      expect(variation.result).toEqual({
        experiment: config.experimentKeyMap['exp_1'],
        variation: config.variationIdMap['5001'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(userProfileService?.lookup).toHaveBeenCalledTimes(1);
      expect(userProfileService?.lookup).toHaveBeenCalledWith('tester');

      expect(userProfileService?.save).toHaveBeenCalledTimes(1);
      expect(userProfileService?.save).toHaveBeenCalledWith({
        user_id: 'tester',
        experiment_bucket_map: {
          '2001': {
            variation_id: '5001',
          },
        },
      });

      expect(userProfileServiceAsync?.lookup).not.toHaveBeenCalled();
      expect(userProfileServiceAsync?.save).not.toHaveBeenCalled();
    });

    it('should not save cmab decisions to user profile service', async () => {
      const { decisionService, userProfileService, cmabService } = getDecisionService({ 
        userProfileService: true,
        userProfileServiceAsync: true,
      });

      const upsSyncMap: Record<string, ExperimentBucketMap> = {};
      const upsAsyncMap: Record<string, ExperimentBucketMap> = {};

      userProfileService?.lookup.mockImplementation((userId: string) => {
        return upsSyncMap[userId] || null;
      });

      userProfileService?.save.mockImplementation((userProfile: UserProfile) => {
        upsSyncMap[userProfile.user_id] = userProfile.experiment_bucket_map;
      });

      mockBucket.mockImplementation((param: BucketerParams) => {
        const ruleKey = param.experimentKey;
        if (ruleKey == 'exp_3') {
          return { result: param.trafficAllocationConfig[0].entityId, reasons: [] }
        }
        return {
          result: null,
          reasons: [],
        }
      });

      cmabService.getDecision.mockResolvedValueOnce({
        variationId: '5003',
        cmabUuid: 'uuid-test',
      }).mockResolvedValueOnce({
        variationId: '5001',
        cmabUuid: 'uuid-test-2',
      });

      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          country: 'BD',
          age: 80, // should satisfy audience condition for exp_3 which is a cmab and not others
        },
      });

      const feature = config.featureKeyMap['flag_1'];
      const [variation] = await decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();

      expect(variation.result).toEqual({
        cmabUuid: 'uuid-test',
        experiment: config.experimentKeyMap['exp_3'],
        variation: config.variationIdMap['5003'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(userProfileService?.lookup).toHaveBeenCalledTimes(1);
      expect(userProfileService?.lookup).toHaveBeenCalledWith('tester');
      expect(userProfileService?.save).not.toHaveBeenCalled;
      expect(cmabService.getDecision).toHaveBeenCalledTimes(1);

      // decide again for the same user, now cmab service should return variation 5001
      const [variation2] = await decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();
      expect(variation2.result).toEqual({
        cmabUuid: 'uuid-test-2',
        experiment: config.experimentKeyMap['exp_3'],
        variation: config.variationIdMap['5001'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(userProfileService?.lookup).toHaveBeenCalledTimes(2);
      expect(userProfileService?.lookup).toHaveBeenNthCalledWith(2, 'tester');
      expect(userProfileService?.save).not.toHaveBeenCalled;
      expect(cmabService.getDecision).toHaveBeenCalledTimes(2);
    });


    describe('holdout', () => {
      it('should return holdout variation when user is bucketed into running holdout', async () => {
        const { decisionService } = getDecisionService();
        const config = createProjectConfig(getHoldoutTestDatafile());
        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'tester',
          attributes: {
            age: 20,
          },
        });
        const feature = config.featureKeyMap['flag_1'];
        const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();

        expect(value).toBeInstanceOf(Promise);

        const variation = (await value)[0];

        expect(variation.result).toEqual({
          experiment: config.holdoutIdMap && config.holdoutIdMap['holdout_running_id'],
          variation: config.variationIdMap['holdout_variation_running_id'],
          decisionSource: DECISION_SOURCES.HOLDOUT,
        });
      });

      it("should consider next global holdout if misses previous holdouts", async () => {
        const { decisionService } = getDecisionService();
        const datafile = getHoldoutTestDatafile();
        
        datafile.holdouts.push({
          id: 'holdout_included_specific_id',
          key: 'holdout_included_specific',
          status: 'Running',
          includedFlags: [],
          excludedFlags: [], 
          audienceIds: ['4002'], // age_60 audience (age <= 60)
          audienceConditions: ['or', '4002'],
          variations: [
            {
              id: 'holdout_variation_included_specific_id',
              key: 'holdout_variation_included_specific',
              variables: []
            }
          ],
          trafficAllocation: [
            {
              entityId: 'holdout_variation_included_specific_id',
              endOfRange: 5000
            }
          ]
        });
        const config = createProjectConfig(datafile);
        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'test_holdout_user',
          attributes: {
            age: 50, // Does not satisfy first global holdout (age_22, age <= 22) but satisfies newly added holdout (age_60, age <= 60)
          },
        });
        const feature = config.featureKeyMap['flag_1'];
        const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();

        expect(value).toBeInstanceOf(Promise);

        const variation = (await value)[0];

        expect(variation.result).toEqual({
          experiment: config.holdoutIdMap && config.holdoutIdMap['holdout_included_specific_id'],
          variation: config.variationIdMap['holdout_variation_included_specific_id'],
          decisionSource: DECISION_SOURCES.HOLDOUT,
        });
      });

      it('should fallback to experiment when holdout status is not running', async () => {
        const { decisionService } = getDecisionService();
        const datafile = getHoldoutTestDatafile();
        
        datafile.holdouts = datafile.holdouts.map((holdout: Holdout) => {
          if(holdout.id === 'holdout_running_id') {
            return {
              ...holdout,
              status: "Draft"
            }
          }
          return holdout;
        });

        const config = createProjectConfig(datafile);
        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'tester',
          attributes: {
            age: 15,
          },
        });
        const feature = config.featureKeyMap['flag_1'];
        const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();

        expect(value).toBeInstanceOf(Promise);

        const variation = (await value)[0];

        expect(variation.result).toEqual({
          experiment: config.experimentKeyMap['exp_1'],
          variation: config.variationIdMap['5001'],
          decisionSource: DECISION_SOURCES.FEATURE_TEST,
        });
      });

      it('should fallback to experiment when user does not meet holdout audience conditions', async () => {
        const { decisionService } = getDecisionService();
        const config = createProjectConfig(getHoldoutTestDatafile());
        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'tester',
          attributes: {
            age: 30, // does not satisfy age_22 audience condition for holdout_running
          },
        });
        const feature = config.featureKeyMap['flag_1'];
        const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();

        expect(value).toBeInstanceOf(Promise);

        const variation = (await value)[0];

        expect(variation.result).toEqual({
          experiment: config.experimentKeyMap['exp_2'],
          variation: config.variationIdMap['5002'],
          decisionSource: DECISION_SOURCES.FEATURE_TEST,
        });
      });

      it('should fallback to experiment when user is not bucketed into holdout traffic', async () => {
        const { decisionService } = getDecisionService();
        const config = createProjectConfig(getHoldoutTestDatafile());
        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'tester',
          attributes: {
            age: 50, 
          },
        });
        const feature = config.featureKeyMap['flag_1'];
        const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();

        expect(value).toBeInstanceOf(Promise);

        const variation = (await value)[0];

        expect(variation.result).toEqual({
          experiment: config.experimentKeyMap['exp_2'],
          variation: config.variationIdMap['5002'],
          decisionSource: DECISION_SOURCES.FEATURE_TEST,
        });
      });

      it('should fallback to rollout when no holdout or experiment matches', async () => {
        const { decisionService } = getDecisionService();
        const datafile = getHoldoutTestDatafile();
        // Modify the datafile to create proper audience conditions for this test
        // Make exp_1 and exp_2 use age conditions that won't match our test user
        datafile.audiences = datafile.audiences.map((audience: any) => {
          if (audience.id === '4001') { // age_22
            return {
              ...audience,
              conditions: JSON.stringify(["or", {"match": "exact", "name": "age", "type": "custom_attribute", "value": 22}])
            };
          }
          if (audience.id === '4002') { // age_60 
            return {
              ...audience,
              conditions: JSON.stringify(["or", {"match": "exact", "name": "age", "type": "custom_attribute", "value": 60}])
            };
          }
          return audience;
        });
        
        // Make exp_2 use a different audience so it won't conflict with delivery_2
        datafile.experiments = datafile.experiments.map((experiment: any) => {
          if (experiment.key === 'exp_2') {
            return {
              ...experiment,
              audienceIds: ['4001'], // Change from 4002 to 4001 (age_22)
              audienceConditions: ['or', '4001']
            };
          }
          return experiment;
        });

        const config = createProjectConfig(datafile);
        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'tester',
          attributes: {
            age: 60, // matches audience 4002 (age_60) used by delivery_2, but not experiments
          },
        });
        const feature = config.featureKeyMap['flag_1'];
        const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();

        expect(value).toBeInstanceOf(Promise);

        const variation = (await value)[0];

        expect(variation.result).toEqual({
          experiment: config.experimentKeyMap['delivery_2'],
          variation: config.variationIdMap['5005'],
          decisionSource: DECISION_SOURCES.ROLLOUT,
        });
      });

      it('should handle multiple holdouts and use first matching one', async () => {
        const { decisionService } = getDecisionService();
        const datafile = getHoldoutTestDatafile();

        datafile.holdouts.push({
          id: 'holdout_second_id',
          key: 'holdout_second',
          status: 'Running',
          includedFlags: [],
          excludedFlags: [],
          audienceIds: [], // no audience requirements
          audienceConditions: [],
          variations: [
            {
              id: 'holdout_variation_second_id',
              key: 'holdout_variation_second',
              variables: []
            }
          ],
          trafficAllocation: [
            {
              entityId: 'holdout_variation_second_id',
              endOfRange: 5000
            }
          ]
        });

        const config = createProjectConfig(datafile);
        const user = new OptimizelyUserContext({
          optimizely: {} as any,
          userId: 'tester',
          attributes: {
            age: 20, // satisfies audience for holdout_running
          },
        });

        const feature = config.featureKeyMap['flag_1'];
        const value = decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();

        expect(value).toBeInstanceOf(Promise);

        const variation = (await value)[0];

        expect(variation.result).toEqual({
          experiment: config.holdoutIdMap && config.holdoutIdMap['holdout_running_id'],
          variation: config.variationIdMap['holdout_variation_running_id'],
          decisionSource: DECISION_SOURCES.HOLDOUT,
        });
      });
    });
  });

  describe('resolveVariationForFeatureList - sync', () => {
    beforeEach(() => {
      mockBucket.mockReset();
    });

    it('should skip cmab experiments', async () => {
      const { decisionService, cmabService } = getDecisionService();
      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          age: 15, // should satisfy audience condition for all experiments and targeted delivery
        },
      });

      mockBucket.mockImplementation((param: BucketerParams) => {
        const ruleKey = param.experimentKey;
        if (ruleKey === 'delivery_1') {
          return {
            result: '5004',
            reasons: [],
          };
        }
        return {
          result: null,
          reasons: [],
        };
      });

      const feature = config.featureKeyMap['flag_1'];
      const value = decisionService.resolveVariationsForFeatureList('sync', config, [feature], user, {}).get();

      const variation = value[0];

      expect(variation.result).toEqual({
        experiment: config.experimentKeyMap['delivery_1'],
        variation: config.variationIdMap['5004'],
        decisionSource: DECISION_SOURCES.ROLLOUT,
      });

      expect(mockBucket).toHaveBeenCalledTimes(3);
      verifyBucketCall(mockBucket, 0, config, config.experimentKeyMap['exp_1'], user);
      verifyBucketCall(mockBucket, 1, config, config.experimentKeyMap['exp_2'], user);
      verifyBucketCall(mockBucket, 2, config, config.experimentKeyMap['delivery_1'], user);

      expect(cmabService.getDecision).not.toHaveBeenCalled();
    });

    it('should ignore async user profile service', async () => {
      const { decisionService, userProfileServiceAsync } = getDecisionService({
        userProfileService: false,
        userProfileServiceAsync: true,
      });

      userProfileServiceAsync?.lookup.mockResolvedValue({
        user_id: 'tester',
        experiment_bucket_map: {
          '2002': {
            variation_id: '5001',
          },
        },
      });
      userProfileServiceAsync?.save.mockResolvedValue(null);

      mockBucket.mockImplementation((param: BucketerParams) => {
        const ruleKey = param.experimentKey;
        if (ruleKey === 'exp_2') {
          return {
            result: '5002',
            reasons: [],
          };
        }
        return {
          result: null,
          reasons: [],
        };
      });

      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          age: 55, // should satisfy audience condition for exp_2 and exp_3
        },
      });

      const feature = config.featureKeyMap['flag_1'];
      const value = decisionService.resolveVariationsForFeatureList('sync', config, [feature], user, {}).get();

      const variation = value[0];

      expect(variation.result).toEqual({
        experiment: config.experimentKeyMap['exp_2'],
        variation: config.variationIdMap['5002'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(userProfileServiceAsync?.lookup).not.toHaveBeenCalled();
      expect(userProfileServiceAsync?.save).not.toHaveBeenCalled();
    });

    it('should use sync user profile service', async () => {
      const { decisionService, userProfileService, userProfileServiceAsync } = getDecisionService({
        userProfileService: true,
        userProfileServiceAsync: true,
      });

      userProfileService?.lookup.mockImplementation((userId: string) => {
        if (userId === 'tester-1') {
          return {
            user_id: 'tester-1',
            experiment_bucket_map: {
              '2002': {
                variation_id: '5001',
              },
            },
          };
        }
        return null;
      });

      userProfileServiceAsync?.lookup.mockResolvedValue(null);
      userProfileServiceAsync?.save.mockResolvedValue(null);

      mockBucket.mockImplementation((param: BucketerParams) => {
        const ruleKey = param.experimentKey;
        if (ruleKey === 'exp_2') {
          return {
            result: '5002',
            reasons: [],
          };
        }
        return {
          result: null,
          reasons: [],
        };
      });

      const config = createProjectConfig(getDecisionTestDatafile());

      const user1 = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester-1',
        attributes: {
          age: 55, // should satisfy audience condition for exp_2 and exp_3
        },
      });

      const feature = config.featureKeyMap['flag_1'];
      const value = decisionService.resolveVariationsForFeatureList('sync', config, [feature], user1, {}).get();

      const variation = value[0];

      expect(variation.result).toEqual({
        experiment: config.experimentKeyMap['exp_2'],
        variation: config.variationIdMap['5001'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(userProfileService?.lookup).toHaveBeenCalledTimes(1);
      expect(userProfileService?.lookup).toHaveBeenCalledWith('tester-1');

      const user2 = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester-2',
        attributes: {
          age: 55, // should satisfy audience condition for exp_2 and exp_3
        },
      });

      const value2 = decisionService.resolveVariationsForFeatureList('sync', config, [feature], user2, {}).get();
      const variation2 = value2[0];
      expect(variation2.result).toEqual({
        experiment: config.experimentKeyMap['exp_2'],
        variation: config.variationIdMap['5002'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(userProfileService?.lookup).toHaveBeenCalledTimes(2);
      expect(userProfileService?.lookup).toHaveBeenNthCalledWith(2, 'tester-2');
      expect(userProfileService?.save).toHaveBeenCalledTimes(1);
      expect(userProfileService?.save).toHaveBeenCalledWith({
        user_id: 'tester-2',
        experiment_bucket_map: {
          '2002': {
            variation_id: '5002',
          },
        },
      });

      expect(userProfileServiceAsync?.lookup).not.toHaveBeenCalled();
      expect(userProfileServiceAsync?.save).not.toHaveBeenCalled();
    });
  });

  describe('getVariationsForFeatureList', () => {
    beforeEach(() => {
      mockBucket.mockReset();
    });

    it('should return correct results for all features in the feature list', () => {
      const { decisionService } = getDecisionService();

      const resolveVariationSpy = vi.spyOn(decisionService as any, 'resolveVariation')
        .mockImplementation((
          op,
          config,
          experiment: any,
          user,
          decideOptions,
          userProfileTracker: any,
        ) => {
          if (experiment.key === 'exp_2') {
            return Value.of('sync', {
              result: { variationKey: 'variation_2' },
              reasons: [],
            });
          } else if (experiment.key === 'exp_4') {
            return Value.of('sync', {
              result: { variationKey: 'variation_flag_2' },
              reasons: [],
            });
          }
          return Value.of('sync', {
            result: {},
            reasons: [],
          });
        });

      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          age: 40,
        },
      });

      const featureList = [
        config.featureKeyMap['flag_1'],
        config.featureKeyMap['flag_2'],
      ];

      const variations = decisionService.getVariationsForFeatureList(config, featureList, user);

      expect(variations[0].result).toEqual({
        experiment: config.experimentKeyMap['exp_2'],
        variation: config.variationIdMap['5002'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(variations[1].result).toEqual({
        experiment: config.experimentKeyMap['exp_4'],
        variation: config.variationIdMap['5100'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      const variations2 = decisionService.getVariationsForFeatureList(config, featureList.reverse(), user);

      expect(variations2[0].result).toEqual({
        experiment: config.experimentKeyMap['exp_4'],
        variation: config.variationIdMap['5100'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(variations2[1].result).toEqual({
        experiment: config.experimentKeyMap['exp_2'],
        variation: config.variationIdMap['5002'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });
    });

    it('should batch user profile lookup and save', () => {
      const { decisionService, userProfileService } = getDecisionService({ userProfileService: true });

      const resolveVariationSpy = vi.spyOn(decisionService as any, 'resolveVariation')
        .mockImplementation((
          op,
          config,
          experiment: any,
          user,
          decideOptions,
          userProfileTracker: any,
        ) => {
          if (experiment.key === 'exp_2') {
            userProfileTracker.userProfile[experiment.id] = {
              variation_id: '5002',
            };
            userProfileTracker.isProfileUpdated = true;

            return Value.of('sync', {
              result: { variationKey: 'variation_2' },
              reasons: [],
            });
          } else if (experiment.key === 'exp_4') {
            userProfileTracker.userProfile[experiment.id] = {
              variation_id: '5100',
            };
            userProfileTracker.isProfileUpdated = true;

            return Value.of('sync', {
              result: { variationKey: 'variation_flag_2' },
              reasons: [],
            });
          }
          return Value.of('sync', {
            result: {},
            reasons: [],
          });
        });

      const config = createProjectConfig(getDecisionTestDatafile());

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'tester',
        attributes: {
          age: 40,
        },
      });

      const featureList = [
        config.featureKeyMap['flag_1'],
        config.featureKeyMap['flag_2'],
      ];

      const variations = decisionService.getVariationsForFeatureList(config, featureList, user);

      expect(variations[0].result).toEqual({
        experiment: config.experimentKeyMap['exp_2'],
        variation: config.variationIdMap['5002'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(variations[1].result).toEqual({
        experiment: config.experimentKeyMap['exp_4'],
        variation: config.variationIdMap['5100'],
        decisionSource: DECISION_SOURCES.FEATURE_TEST,
      });

      expect(userProfileService?.lookup).toHaveBeenCalledTimes(1);
      expect(userProfileService?.lookup).toHaveBeenCalledWith('tester');

      expect(userProfileService?.save).toHaveBeenCalledTimes(1);
      expect(userProfileService?.save).toHaveBeenCalledWith({
        user_id: 'tester',
        experiment_bucket_map: {
          '2002': {
            variation_id: '5002',
          },
          '2004': {
            variation_id: '5100',
          },
        },
      });
    });
  });


  describe('forced variation management', () => {
    it('should return true for a valid forcedVariation in setForcedVariation', function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();

      const didSetVariation = decisionService.setForcedVariation(
        config,
        'testExperiment',
        'user1',
        'control'
      );
      expect(didSetVariation).toBe(true);
    });

    it('should return the same variation from getVariation as was set in setVariation', function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();
      decisionService.setForcedVariation(
        config,
        'testExperiment',
        'user1',
        'control'
      );

      const variation = decisionService.getForcedVariation(config, 'testExperiment', 'user1').result;
      expect(variation).toBe('control');
    });

    it('should return null from getVariation if no forced variation was set for a valid experimentKey', function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();

      expect(config.experimentKeyMap['testExperiment']).toBeDefined();
      const variation = decisionService.getForcedVariation(config, 'testExperiment', 'user1').result;

      expect(variation).toBe(null);
    });

    it('should return null from getVariation for an invalid experimentKey', function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();

      expect(config.experimentKeyMap['definitely_not_valid_exp_key']).not.toBeDefined();
      const variation = decisionService.getForcedVariation(config, 'definitely_not_valid_exp_key', 'user1').result;

      expect(variation).toBe(null);
    });

    it('should return null when a forced decision is set on another experiment key', function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();

      decisionService.setForcedVariation(config, 'testExperiment', 'user1', 'control');
      const variation = decisionService.getForcedVariation(config, 'testExperimentLaunched', 'user1').result;
      expect(variation).toBe(null);
    });

    it('should not set forced variation for an invalid variation key and return false', function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();

      const wasSet = decisionService.setForcedVariation(
        config,
        'testExperiment',
        'user1',
        'definitely_not_valid_variation_key'
      );

      expect(wasSet).toBe(false);
      const variation = decisionService.getForcedVariation(config, 'testExperiment', 'user1').result;
      expect(variation).toBe(null);
    });

    it('should reset the forcedVariation if null is passed to setForcedVariation', function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();

      const didSetVariation = decisionService.setForcedVariation(
        config,
        'testExperiment',
        'user1',
        'control'
      );

      expect(didSetVariation).toBe(true);

      let variation = decisionService.getForcedVariation(config, 'testExperiment', 'user1').result;
      expect(variation).toBe('control');

      const didSetVariationAgain = decisionService.setForcedVariation(
        config,
        'testExperiment',
        'user1',
        null
      );

      expect(didSetVariationAgain).toBe(true);

      variation = decisionService.getForcedVariation(config, 'testExperiment', 'user1').result;
      expect(variation).toBe(null);
    });

    it('should be able to add variations for multiple experiments for one user', function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();
    
      const didSetVariation1 = decisionService.setForcedVariation(
        config,
        'testExperiment',
        'user1',
        'control'
      );
      expect(didSetVariation1).toBe(true);
    
      const didSetVariation2 = decisionService.setForcedVariation(
        config,
        'testExperimentLaunched',
        'user1',
        'controlLaunched'
      );
      expect(didSetVariation2).toBe(true);
    
      const variation = decisionService.getForcedVariation(config, 'testExperiment', 'user1').result;
      const variation2 = decisionService.getForcedVariation(config, 'testExperimentLaunched', 'user1').result;
      expect(variation).toBe('control');
      expect(variation2).toBe('controlLaunched');
    });

    it('should be able to forced variation to same experiment for multiple users', function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();

      const didSetVariation1 = decisionService.setForcedVariation(
        config,
        'testExperiment',
        'user1',
        'control'
      );
      expect(didSetVariation1).toBe(true);

      const didSetVariation2 = decisionService.setForcedVariation(
        config,
        'testExperiment',
        'user2',
        'variation'
      );
      expect(didSetVariation2).toBe(true);

      const variationControl = decisionService.getForcedVariation(config, 'testExperiment', 'user1').result;
      const variationVariation = decisionService.getForcedVariation(config, 'testExperiment', 'user2').result;

      expect(variationControl).toBe('control');
      expect(variationVariation).toBe('variation');
    });

    it('should be able to reset a variation for a user with multiple experiments', function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();

      // Set the first time
      const didSetVariation1 = decisionService.setForcedVariation(
        config,
        'testExperiment',
        'user1',
        'control'
      );
      expect(didSetVariation1).toBe(true);

      const didSetVariation2 = decisionService.setForcedVariation(
        config,
        'testExperimentLaunched',
        'user1',
        'controlLaunched'
      );
      expect(didSetVariation2).toBe(true);

      let variation1 = decisionService.getForcedVariation(config, 'testExperiment', 'user1').result;
      let variation2 = decisionService.getForcedVariation(config, 'testExperimentLaunched', 'user1').result;

      expect(variation1).toBe('control');
      expect(variation2).toBe('controlLaunched');

      // Reset for one of the experiments
      const didSetVariationAgain = decisionService.setForcedVariation(
        config,
        'testExperiment',
        'user1',
        'variation'
      );
      expect(didSetVariationAgain).toBe(true);

      variation1 = decisionService.getForcedVariation(config, 'testExperiment', 'user1').result;
      variation2 = decisionService.getForcedVariation(config, 'testExperimentLaunched', 'user1').result;

      expect(variation1).toBe('variation');
      expect(variation2).toBe('controlLaunched');
    });

    it('should be able to unset a variation for a user with multiple experiments', function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();

      // Set the first time
      const didSetVariation1 = decisionService.setForcedVariation(
        config,
        'testExperiment',
        'user1',
        'control'
      );
      expect(didSetVariation1).toBe(true);

      const didSetVariation2 = decisionService.setForcedVariation(
        config,
        'testExperimentLaunched',
        'user1',
        'controlLaunched'
      );
      expect(didSetVariation2).toBe(true);

      let variation1 = decisionService.getForcedVariation(config, 'testExperiment', 'user1').result;
      let variation2 = decisionService.getForcedVariation(config, 'testExperimentLaunched', 'user1').result;

      expect(variation1).toBe('control');
      expect(variation2).toBe('controlLaunched');

      // Unset for one of the experiments
      decisionService.setForcedVariation(config, 'testExperiment', 'user1', null);

      variation1 = decisionService.getForcedVariation(config, 'testExperiment', 'user1').result;
      variation2 = decisionService.getForcedVariation(config, 'testExperimentLaunched', 'user1').result;

      expect(variation1).toBe(null);
      expect(variation2).toBe('controlLaunched');
    });

    it('should return false for an empty variation key', function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();

      const didSetVariation = decisionService.setForcedVariation(config, 'testExperiment', 'user1', '');
      expect(didSetVariation).toBe(false);
    });

    it('should return null when a variation was previously set, and that variation no longer exists on the config object', function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();

      const didSetVariation = decisionService.setForcedVariation(
        config,
        'testExperiment',
        'user1',
        'control'
      );
      expect(didSetVariation).toBe(true);

      const newDatafile = cloneDeep(testData);
      // Remove 'control' variation from variations, traffic allocation, and datafile forcedVariations.
      newDatafile.experiments[0].variations = [
        {
          key: 'variation',
          id: '111129',
        },
      ];
      newDatafile.experiments[0].trafficAllocation = [
        {
          entityId: '111129',
          endOfRange: 9000,
        },
      ];
      newDatafile.experiments[0].forcedVariations = {
        user1: 'variation',
        user2: 'variation',
      };
      // Now the only variation in testExperiment is 'variation'
      const newConfigObj = createProjectConfig(newDatafile);
      const forcedVar = decisionService.getForcedVariation(newConfigObj, 'testExperiment', 'user1').result;
      expect(forcedVar).toBe(null);
    });

    it("should return null when a variation was previously set, and that variation's experiment no longer exists on the config object", function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();

      const didSetVariation = decisionService.setForcedVariation(
        config,
        'testExperiment',
        'user1',
        'control'
      );
      expect(didSetVariation).toBe(true);

      const newConfigObj = createProjectConfig(cloneDeep(testDataWithFeatures));
      const forcedVar = decisionService.getForcedVariation(newConfigObj, 'testExperiment', 'user1').result;
      expect(forcedVar).toBe(null);
    });

    it('should return false from setForcedVariation and not set for invalid experiment key', function() {
      const config = createProjectConfig(cloneDeep(testData));
      const { decisionService } = getDecisionService();

      const didSetVariation = decisionService.setForcedVariation(
        config,
        'definitelyNotAValidExperimentKey',
        'user1',
        'control'
      );
      expect(didSetVariation).toBe(false);

      const variation = decisionService.getForcedVariation(
        config,
        'definitelyNotAValidExperimentKey',
        'user1'
      ).result;
      expect(variation).toBe(null);
    });
  });

  describe('local holdouts', () => {
    // Helper: build a datafile that has a local holdout targeting a specific experiment or delivery rule.
    const makeLocalHoldoutDatafile = (targetRuleId: string, ruleIds: string[] = [targetRuleId]) => {
      const datafile = getDecisionTestDatafile();
      (datafile as any).holdouts = [
        {
          id: 'local_holdout_id',
          key: 'local_holdout',
          status: 'Running',
          includedFlags: [],
          excludedFlags: [],
          includedRules: ruleIds,
          audienceIds: [],
          audienceConditions: [],
          variations: [
            {
              id: 'local_holdout_variation_id',
              key: 'local_holdout_variation',
              variables: []
            }
          ],
          trafficAllocation: [
            { entityId: 'local_holdout_variation_id', endOfRange: 10000 }
          ]
        }
      ];
      return datafile;
    };

    beforeEach(() => {
      mockBucket.mockReset();
    });

    it('global holdout branch: global holdout is evaluated before per-rule logic', async () => {
      const datafile = getDecisionTestDatafile();
      (datafile as any).holdouts = [
        {
          id: 'global_holdout_id',
          key: 'global_holdout',
          status: 'Running',
          includedFlags: [],
          excludedFlags: [],
          // No includedRules → global holdout
          audienceIds: [],
          audienceConditions: [],
          variations: [
            { id: 'global_holdout_var_id', key: 'global_holdout_var', variables: [] }
          ],
          trafficAllocation: [{ entityId: 'global_holdout_var_id', endOfRange: 10000 }]
        }
      ];
      const config = createProjectConfig(datafile);
      const { decisionService } = getDecisionService();

      // bucket returns the global holdout variation for the holdout, nothing for experiments
      mockBucket.mockImplementation((params: BucketerParams) => {
        if (params.experimentId === 'global_holdout_id') {
          return { result: 'global_holdout_var_id', reasons: [] };
        }
        return { result: null, reasons: [] };
      });

      const user = new OptimizelyUserContext({ optimizely: {} as any, userId: 'user1' });
      const feature = config.featureKeyMap['flag_1'];
      const value = await decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();

      // Decision should be from the global holdout, not from any experiment
      expect(value[0].result.decisionSource).toBe(DECISION_SOURCES.HOLDOUT);
      expect(value[0].result.experiment?.id).toBe('global_holdout_id');
    });

    it('local holdout hit branch: user bucketed into local holdout for experiment rule returns holdout variation; audience and traffic not evaluated for that rule', async () => {
      // exp_1 has id '2001'
      const config = createProjectConfig(makeLocalHoldoutDatafile('2001'));
      const { decisionService } = getDecisionService();

      // bucket returns holdout variation when evaluating the local holdout
      mockBucket.mockImplementation((params: BucketerParams) => {
        if (params.experimentId === 'local_holdout_id') {
          return { result: 'local_holdout_variation_id', reasons: [] };
        }
        return { result: null, reasons: [] };
      });

      const user = new OptimizelyUserContext({ optimizely: {} as any, userId: 'user1' });
      const feature = config.featureKeyMap['flag_1'];
      const value = await decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();

      // Should return holdout decision for the local holdout
      expect(value[0].result.decisionSource).toBe(DECISION_SOURCES.HOLDOUT);
      expect(value[0].result.experiment?.id).toBe('local_holdout_id');
      expect(value[0].result.variation?.id).toBe('local_holdout_variation_id');
    });

    it('local holdout miss branch: user not bucketed into local holdout falls through to regular rule evaluation', async () => {
      // exp_1 has id '2001' and audience 4001 (age <= 22)
      const config = createProjectConfig(makeLocalHoldoutDatafile('2001'));
      const { decisionService } = getDecisionService();

      // bucket returns null for the local holdout, then succeeds for the experiment
      mockBucket.mockImplementation((params: BucketerParams) => {
        if (params.experimentId === 'local_holdout_id') {
          return { result: null, reasons: [] };
        }
        if (params.experimentId === '2001') {
          return { result: '5001', reasons: [] }; // variation_1 in exp_1
        }
        return { result: null, reasons: [] };
      });

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'user1',
        attributes: { age: 15 }, // satisfies 4001 audience (age <= 22)
      });
      const feature = config.featureKeyMap['flag_1'];
      const value = await decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();

      // Should fall through to experiment evaluation (not holdout)
      expect(value[0].result.decisionSource).toBe(DECISION_SOURCES.FEATURE_TEST);
      expect(value[0].result.variation?.id).toBe('5001');
    });

    it('rule specificity: local holdout targeting experiment rule X does not affect experiment rule Y', async () => {
      // exp_1 = '2001', exp_2 = '2002'. Local holdout targets only '2002' (exp_2).
      // Audience for exp_1: 4001 (age <= 22). User satisfies exp_1 audience but not exp_2.
      const config = createProjectConfig(makeLocalHoldoutDatafile('2002'));
      const { decisionService } = getDecisionService();

      // bucket returns holdout variation only for the local holdout when evaluating for '2002',
      // and returns experiment variation for '2001'
      mockBucket.mockImplementation((params: BucketerParams) => {
        if (params.experimentId === 'local_holdout_id') {
          return { result: 'local_holdout_variation_id', reasons: [] };
        }
        if (params.experimentId === '2001') {
          return { result: '5001', reasons: [] };
        }
        return { result: null, reasons: [] };
      });

      // User satisfies exp_1 audience (age <= 22)
      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'user1',
        attributes: { age: 15 },
      });
      const feature = config.featureKeyMap['flag_1'];
      const value = await decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();

      // exp_1 is evaluated first; local holdout targets '2002' not '2001', so exp_1 is evaluated normally
      expect(value[0].result.decisionSource).toBe(DECISION_SOURCES.FEATURE_TEST);
      expect(value[0].result.experiment?.id).toBe('2001');
    });

    it('local holdout applies to delivery rules (rollouts) as well as experiment rules', async () => {
      // delivery_1 has id '3001'
      const config = createProjectConfig(makeLocalHoldoutDatafile('3001'));
      const { decisionService } = getDecisionService();

      // bucket returns null for all experiments and the local holdout variation for delivery rule
      mockBucket.mockImplementation((params: BucketerParams) => {
        if (params.experimentId === 'local_holdout_id') {
          return { result: 'local_holdout_variation_id', reasons: [] };
        }
        return { result: null, reasons: [] };
      });

      // No audience attributes → experiments won't match, falls through to rollout
      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'user1',
        attributes: { age: 15 }, // satisfies 4001 used by delivery_1
      });
      const feature = config.featureKeyMap['flag_1'];
      const value = await decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();

      // Should be a holdout decision from the local holdout targeting the delivery rule
      expect(value[0].result.decisionSource).toBe(DECISION_SOURCES.HOLDOUT);
      expect(value[0].result.experiment?.id).toBe('local_holdout_id');
    });

    it('forced decision beats a 100% traffic local holdout: forced decision takes precedence over local holdout', async () => {
      // exp_1 has id '2001', key 'exp_1', variation key 'variation_1' (id '5001')
      // Local holdout targets '2001' with 100% traffic allocation.
      // User also has a forced decision set for exp_1.
      // Expected: forced decision wins; decisionSource is FEATURE_TEST, not HOLDOUT.
      const config = createProjectConfig(makeLocalHoldoutDatafile('2001'));
      const { decisionService } = getDecisionService();

      // bucket should NOT be called for local_holdout_id because forced decision short-circuits first
      mockBucket.mockImplementation((params: BucketerParams) => {
        if (params.experimentId === 'local_holdout_id') {
          // returning holdout variation here to prove the test fails if ordering is wrong
          return { result: 'local_holdout_variation_id', reasons: [] };
        }
        return { result: null, reasons: [] };
      });

      const user = new OptimizelyUserContext({
        optimizely: {} as any,
        userId: 'user1',
        attributes: { age: 15 },
      });

      // Set forced decision for exp_1 → variation_1
      user.setForcedDecision(
        { flagKey: 'flag_1', ruleKey: 'exp_1' },
        { variationKey: 'variation_1' }
      );

      const feature = config.featureKeyMap['flag_1'];
      const value = await decisionService.resolveVariationsForFeatureList('async', config, [feature], user, {}).get();

      // Forced decision must win — source must be FEATURE_TEST, not HOLDOUT
      expect(value[0].result.decisionSource).toBe(DECISION_SOURCES.FEATURE_TEST);
      expect(value[0].result.variation?.key).toBe('variation_1');
    });
  });
});