@incodetech/core 2.0.0-alpha.1 → 2.0.0-alpha.3

package/src/flow/flowManager.test.ts

@@ -1,560 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import {
-  createDelayedGetFlow,
-  createFailingGetFlow,
-  createMockGetFlow,
-  mockFlow,
-  mockModules,
-} from './__mocks__/flowMocks';
-import { createFlowManager } from './flowManager';
-import type { Flow } from './types';
-
-type FlowState =
-  | { status: 'idle' }
-  | { status: 'loading' }
-  | {
-      status: 'ready';
-      flow: Flow;
-      steps: string[];
-      currentStepIndex: number;
-      currentStep: string | undefined;
-      config: unknown;
-    }
-  | { status: 'finished'; flow: Flow }
-  | { status: 'error'; error: string };
-
-describe('createFlowManager', () => {
-  describe('Initial state', () => {
-    it('should create a flow manager', () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      expect(manager).toBeDefined();
-      expect(manager.getState).toBeDefined();
-      expect(manager.subscribe).toBeDefined();
-      expect(manager.stop).toBeDefined();
-      expect(manager.load).toBeDefined();
-      expect(manager.cancel).toBeDefined();
-      expect(manager.reset).toBeDefined();
-      expect(manager.nextStep).toBeDefined();
-      expect(manager.prevStep).toBeDefined();
-      expect(manager.getModuleConfig).toBeDefined();
-      expect(manager.isModuleEnabled).toBeDefined();
-    });
-
-    it('should start in idle state', () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      expect(manager.getState()).toEqual({ status: 'idle' });
-      manager.stop();
-    });
-  });
-
-  describe('api.load()', () => {
-    it('should transition to loading state', () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      expect(manager.getState().status).toBe('loading');
-      manager.stop();
-    });
-
-    it('should transition to ready state on success', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      manager.stop();
-    });
-
-    it('should include flow data in ready state', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      const state = manager.getState() as Extract<
-        FlowState,
-        { status: 'ready' }
-      >;
-      expect(state.flow).toEqual(mockFlow);
-      expect(state.steps).toEqual(['TUTORIAL_ID', 'SELFIE', 'FACE_MATCH']);
-      expect(state.currentStepIndex).toBe(0);
-
-      manager.stop();
-    });
-
-    it('should transition to error state on failure', async () => {
-      const getFlow = createFailingGetFlow('Network error');
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('error');
-      });
-
-      const state = manager.getState() as Extract<
-        FlowState,
-        { status: 'error' }
-      >;
-      expect(state.error).toContain('Network error');
-
-      manager.stop();
-    });
-  });
-
-  describe('api.cancel()', () => {
-    it('should cancel loading and return to idle', async () => {
-      const getFlow = createDelayedGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-      expect(manager.getState().status).toBe('loading');
-
-      manager.cancel();
-      expect(manager.getState().status).toBe('idle');
-
-      manager.stop();
-    });
-  });
-
-  describe('api.reset()', () => {
-    it('should reset from ready state', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      manager.reset();
-
-      expect(manager.getState().status).toBe('idle');
-      manager.stop();
-    });
-
-    it('should reset from error state', async () => {
-      const getFlow = createFailingGetFlow('Error');
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('error');
-      });
-
-      manager.reset();
-
-      expect(manager.getState().status).toBe('idle');
-      manager.stop();
-    });
-  });
-
-  describe('api.nextStep()', () => {
-    it('should advance to next step', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      const initialState = manager.getState() as Extract<
-        FlowState,
-        { status: 'ready' }
-      >;
-      expect(initialState.currentStepIndex).toBe(0);
-
-      manager.nextStep();
-
-      const nextState = manager.getState() as Extract<
-        FlowState,
-        { status: 'ready' }
-      >;
-      expect(nextState.currentStepIndex).toBe(1);
-
-      manager.stop();
-    });
-
-    it('should transition to finished on last step', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      manager.nextStep();
-      manager.nextStep();
-      manager.nextStep();
-
-      expect(manager.getState().status).toBe('finished');
-
-      manager.stop();
-    });
-  });
-
-  describe('api.prevStep()', () => {
-    it('should go back to previous step', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      manager.nextStep();
-      expect(
-        (manager.getState() as Extract<FlowState, { status: 'ready' }>)
-          .currentStepIndex,
-      ).toBe(1);
-
-      manager.prevStep();
-      expect(
-        (manager.getState() as Extract<FlowState, { status: 'ready' }>)
-          .currentStepIndex,
-      ).toBe(0);
-
-      manager.stop();
-    });
-
-    it('should not go below 0', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      manager.prevStep();
-
-      expect(
-        (manager.getState() as Extract<FlowState, { status: 'ready' }>)
-          .currentStepIndex,
-      ).toBe(0);
-
-      manager.stop();
-    });
-  });
-
-  describe('state.currentStep', () => {
-    it('should return current step key', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      const state = manager.getState() as Extract<
-        FlowState,
-        { status: 'ready' }
-      >;
-      expect(state.currentStep).toBe('TUTORIAL_ID');
-
-      manager.nextStep();
-      const nextState = manager.getState() as Extract<
-        FlowState,
-        { status: 'ready' }
-      >;
-      expect(nextState.currentStep).toBe('SELFIE');
-
-      manager.stop();
-    });
-
-    it('should not have currentStep when not ready', () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      const state = manager.getState();
-      expect(state.status).toBe('idle');
-      expect('currentStep' in state).toBe(false);
-
-      manager.stop();
-    });
-  });
-
-  describe('state.config', () => {
-    it('should return current module config', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      const state = manager.getState() as Extract<
-        FlowState,
-        { status: 'ready' }
-      >;
-      expect(state.config).toEqual(mockModules[0].configuration);
-
-      manager.nextStep();
-      const nextState = manager.getState() as Extract<
-        FlowState,
-        { status: 'ready' }
-      >;
-      expect(nextState.config).toEqual(mockModules[1].configuration);
-
-      manager.stop();
-    });
-
-    it('should not have config when not ready', () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      const state = manager.getState();
-      expect(state.status).toBe('idle');
-      expect('config' in state).toBe(false);
-
-      manager.stop();
-    });
-  });
-
-  describe('api.canNext', () => {
-    it('should return true when can go next', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      expect(manager.canNext).toBe(true);
-
-      manager.stop();
-    });
-
-    it('should return false on last step', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      manager.nextStep();
-      manager.nextStep();
-
-      expect(manager.canNext).toBe(false);
-
-      manager.stop();
-    });
-
-    it('should return false when not ready', () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      expect(manager.canNext).toBe(false);
-
-      manager.stop();
-    });
-  });
-
-  describe('api.canPrev', () => {
-    it('should return false on first step', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      expect(manager.canPrev).toBe(false);
-
-      manager.stop();
-    });
-
-    it('should return true when not on first step', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      manager.nextStep();
-
-      expect(manager.canPrev).toBe(true);
-
-      manager.stop();
-    });
-  });
-
-  describe('api.getModuleConfig()', () => {
-    it('should return module configuration', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      const config = manager.getModuleConfig('TUTORIAL_ID');
-      expect(config).toEqual(mockModules[0].configuration);
-
-      manager.stop();
-    });
-
-    it('should return undefined for non-existent module', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      const config = manager.getModuleConfig('NON_EXISTENT');
-      expect(config).toBeUndefined();
-
-      manager.stop();
-    });
-
-    it('should return undefined when not ready', () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      const config = manager.getModuleConfig('TUTORIAL_ID');
-      expect(config).toBeUndefined();
-
-      manager.stop();
-    });
-  });
-
-  describe('api.isModuleEnabled()', () => {
-    it('should return true for enabled module', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      expect(manager.isModuleEnabled('TUTORIAL_ID')).toBe(true);
-      expect(manager.isModuleEnabled('SELFIE')).toBe(true);
-
-      manager.stop();
-    });
-
-    it('should return false for non-existent module', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      expect(manager.isModuleEnabled('NON_EXISTENT')).toBe(false);
-
-      manager.stop();
-    });
-
-    it('should return false when not ready', () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      expect(manager.isModuleEnabled('TUTORIAL_ID')).toBe(false);
-
-      manager.stop();
-    });
-  });
-
-  describe('subscribe()', () => {
-    it('should notify on state changes', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      const states: FlowState[] = [];
-      const unsubscribe = manager.subscribe((state) => {
-        states.push(state);
-      });
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      expect(states.some((s) => s.status === 'loading')).toBe(true);
-      expect(states.some((s) => s.status === 'ready')).toBe(true);
-
-      unsubscribe();
-      manager.stop();
-    });
-
-    it('should return unsubscribe function', async () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      const listener = vi.fn();
-      const unsubscribe = manager.subscribe(listener);
-
-      manager.load();
-
-      await vi.waitFor(() => {
-        expect(manager.getState().status).toBe('ready');
-      });
-
-      listener.mockClear();
-      unsubscribe();
-
-      manager.nextStep();
-
-      expect(listener).not.toHaveBeenCalled();
-
-      manager.stop();
-    });
-  });
-
-  describe('stop()', () => {
-    it('should stop the flow manager', () => {
-      const getFlow = createMockGetFlow();
-      const manager = createFlowManager({ getFlow });
-
-      manager.stop();
-    });
-  });
-});