mmintel/gridpilot.gg
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

feat(companion): implement hosted session automation POC with TDD approach

Browse Source
This commit is contained in:
Marc Mintel
2025-11-21 16:27:15 +01:00
parent 7a3562a844
commit 098bfc2c11
26 changed files with 6469 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

187
tests/unit/domain/value-objects/SessionState.test.ts Normal file
View File

@@ -0,0 +1,187 @@
import { describe, it, expect } from 'vitest';
import { SessionState } from '../../../../src/packages/domain/value-objects/SessionState';
describe('SessionState Value Object', () => {
describe('create', () => {
it('should create PENDING state', () => {
const state = SessionState.create('PENDING');
expect(state.value).toBe('PENDING');
});
it('should create IN_PROGRESS state', () => {
const state = SessionState.create('IN_PROGRESS');
expect(state.value).toBe('IN_PROGRESS');
});
it('should create PAUSED state', () => {
const state = SessionState.create('PAUSED');
expect(state.value).toBe('PAUSED');
});
it('should create COMPLETED state', () => {
const state = SessionState.create('COMPLETED');
expect(state.value).toBe('COMPLETED');
});
it('should create FAILED state', () => {
const state = SessionState.create('FAILED');
expect(state.value).toBe('FAILED');
});
it('should create STOPPED_AT_STEP_18 state', () => {
const state = SessionState.create('STOPPED_AT_STEP_18');
expect(state.value).toBe('STOPPED_AT_STEP_18');
});
it('should throw error for invalid state', () => {
expect(() => SessionState.create('INVALID' as any)).toThrow('Invalid session state');
});
it('should throw error for empty string', () => {
expect(() => SessionState.create('' as any)).toThrow('Invalid session state');
});
});
describe('equals', () => {
it('should return true for equal states', () => {
const state1 = SessionState.create('PENDING');
const state2 = SessionState.create('PENDING');
expect(state1.equals(state2)).toBe(true);
});
it('should return false for different states', () => {
const state1 = SessionState.create('PENDING');
const state2 = SessionState.create('IN_PROGRESS');
expect(state1.equals(state2)).toBe(false);
});
});
describe('isPending', () => {
it('should return true for PENDING state', () => {
const state = SessionState.create('PENDING');
expect(state.isPending()).toBe(true);
});
it('should return false for IN_PROGRESS state', () => {
const state = SessionState.create('IN_PROGRESS');
expect(state.isPending()).toBe(false);
});
});
describe('isInProgress', () => {
it('should return true for IN_PROGRESS state', () => {
const state = SessionState.create('IN_PROGRESS');
expect(state.isInProgress()).toBe(true);
});
it('should return false for PENDING state', () => {
const state = SessionState.create('PENDING');
expect(state.isInProgress()).toBe(false);
});
});
describe('isCompleted', () => {
it('should return true for COMPLETED state', () => {
const state = SessionState.create('COMPLETED');
expect(state.isCompleted()).toBe(true);
});
it('should return false for IN_PROGRESS state', () => {
const state = SessionState.create('IN_PROGRESS');
expect(state.isCompleted()).toBe(false);
});
});
describe('isFailed', () => {
it('should return true for FAILED state', () => {
const state = SessionState.create('FAILED');
expect(state.isFailed()).toBe(true);
});
it('should return false for COMPLETED state', () => {
const state = SessionState.create('COMPLETED');
expect(state.isFailed()).toBe(false);
});
});
describe('isStoppedAtStep18', () => {
it('should return true for STOPPED_AT_STEP_18 state', () => {
const state = SessionState.create('STOPPED_AT_STEP_18');
expect(state.isStoppedAtStep18()).toBe(true);
});
it('should return false for COMPLETED state', () => {
const state = SessionState.create('COMPLETED');
expect(state.isStoppedAtStep18()).toBe(false);
});
});
describe('canTransitionTo', () => {
it('should allow transition from PENDING to IN_PROGRESS', () => {
const state = SessionState.create('PENDING');
expect(state.canTransitionTo(SessionState.create('IN_PROGRESS'))).toBe(true);
});
it('should allow transition from IN_PROGRESS to PAUSED', () => {
const state = SessionState.create('IN_PROGRESS');
expect(state.canTransitionTo(SessionState.create('PAUSED'))).toBe(true);
});
it('should allow transition from IN_PROGRESS to STOPPED_AT_STEP_18', () => {
const state = SessionState.create('IN_PROGRESS');
expect(state.canTransitionTo(SessionState.create('STOPPED_AT_STEP_18'))).toBe(true);
});
it('should allow transition from PAUSED to IN_PROGRESS', () => {
const state = SessionState.create('PAUSED');
expect(state.canTransitionTo(SessionState.create('IN_PROGRESS'))).toBe(true);
});
it('should not allow transition from COMPLETED to IN_PROGRESS', () => {
const state = SessionState.create('COMPLETED');
expect(state.canTransitionTo(SessionState.create('IN_PROGRESS'))).toBe(false);
});
it('should not allow transition from FAILED to IN_PROGRESS', () => {
const state = SessionState.create('FAILED');
expect(state.canTransitionTo(SessionState.create('IN_PROGRESS'))).toBe(false);
});
it('should not allow transition from STOPPED_AT_STEP_18 to IN_PROGRESS', () => {
const state = SessionState.create('STOPPED_AT_STEP_18');
expect(state.canTransitionTo(SessionState.create('IN_PROGRESS'))).toBe(false);
});
});
describe('isTerminal', () => {
it('should return true for COMPLETED state', () => {
const state = SessionState.create('COMPLETED');
expect(state.isTerminal()).toBe(true);
});
it('should return true for FAILED state', () => {
const state = SessionState.create('FAILED');
expect(state.isTerminal()).toBe(true);
});
it('should return true for STOPPED_AT_STEP_18 state', () => {
const state = SessionState.create('STOPPED_AT_STEP_18');
expect(state.isTerminal()).toBe(true);
});
it('should return false for PENDING state', () => {
const state = SessionState.create('PENDING');
expect(state.isTerminal()).toBe(false);
});
it('should return false for IN_PROGRESS state', () => {
const state = SessionState.create('IN_PROGRESS');
expect(state.isTerminal()).toBe(false);
});
it('should return false for PAUSED state', () => {
const state = SessionState.create('PAUSED');
expect(state.isTerminal()).toBe(false);
});
});
});

104
tests/unit/domain/value-objects/StepId.test.ts Normal file
View File

@@ -0,0 +1,104 @@
import { describe, it, expect } from 'vitest';
import { StepId } from '../../../../src/packages/domain/value-objects/StepId';
describe('StepId Value Object', () => {
describe('create', () => {
it('should create a valid StepId for step 1', () => {
const stepId = StepId.create(1);
expect(stepId.value).toBe(1);
});
it('should create a valid StepId for step 18', () => {
const stepId = StepId.create(18);
expect(stepId.value).toBe(18);
});
it('should throw error for step 0 (below minimum)', () => {
expect(() => StepId.create(0)).toThrow('StepId must be between 1 and 18');
});
it('should throw error for step 19 (above maximum)', () => {
expect(() => StepId.create(19)).toThrow('StepId must be between 1 and 18');
});
it('should throw error for negative step', () => {
expect(() => StepId.create(-1)).toThrow('StepId must be between 1 and 18');
});
it('should throw error for non-integer step', () => {
expect(() => StepId.create(5.5)).toThrow('StepId must be an integer');
});
});
describe('equals', () => {
it('should return true for equal StepIds', () => {
const stepId1 = StepId.create(5);
const stepId2 = StepId.create(5);
expect(stepId1.equals(stepId2)).toBe(true);
});
it('should return false for different StepIds', () => {
const stepId1 = StepId.create(5);
const stepId2 = StepId.create(6);
expect(stepId1.equals(stepId2)).toBe(false);
});
});
describe('isModalStep', () => {
it('should return true for step 6 (add admin modal)', () => {
const stepId = StepId.create(6);
expect(stepId.isModalStep()).toBe(true);
});
it('should return true for step 9 (add car modal)', () => {
const stepId = StepId.create(9);
expect(stepId.isModalStep()).toBe(true);
});
it('should return true for step 12 (add track modal)', () => {
const stepId = StepId.create(12);
expect(stepId.isModalStep()).toBe(true);
});
it('should return false for non-modal step', () => {
const stepId = StepId.create(1);
expect(stepId.isModalStep()).toBe(false);
});
});
describe('isFinalStep', () => {
it('should return true for step 18', () => {
const stepId = StepId.create(18);
expect(stepId.isFinalStep()).toBe(true);
});
it('should return false for step 17', () => {
const stepId = StepId.create(17);
expect(stepId.isFinalStep()).toBe(false);
});
it('should return false for step 1', () => {
const stepId = StepId.create(1);
expect(stepId.isFinalStep()).toBe(false);
});
});
describe('next', () => {
it('should return next step for step 1', () => {
const stepId = StepId.create(1);
const nextStep = stepId.next();
expect(nextStep.value).toBe(2);
});
it('should return next step for step 17', () => {
const stepId = StepId.create(17);
const nextStep = stepId.next();
expect(nextStep.value).toBe(18);
});
it('should throw error when calling next on step 18', () => {
const stepId = StepId.create(18);
expect(() => stepId.next()).toThrow('Cannot advance beyond final step');
});
});
});