π¬ A browser extension and desktop app that turns your clicks into step-by-step guides with annotated screenshots π
TypeScript browser-extensionchrome-extensiondocumentationfirefox-extensionguide-generatorlocal-firstmanifest-v3privacy-firstproductivityreactscreenshotstep-by-step-guidetutorialtypescriptworkflowwxt
import { beforeEach, describe, expect, it, vi } from 'vitest';
import { createActor } from 'xstate';
import { CaptureState, captureMachine } from '@/core/capture/machine';
const sessionGet = vi.fn();
vi.mock('@/lib/browser-api/session-storage', () => ({
sessionStorage: {
get: (key: string) => sessionGet(key),
set: vi.fn(),
remove: vi.fn(),
},
}));
vi.mock('@mimik/core/logger', () => ({ logger: { info: vi.fn(), debug: vi.fn(), warn: vi.fn(), error: vi.fn() } }));
function legacyRecordingSnapshot() {
const actor = createActor(captureMachine);
actor.start();
actor.send({ type: 'START_RECORDING', url: 'https://example.com' });
const persisted = JSON.parse(JSON.stringify(actor.getPersistedSnapshot()));
delete persisted.context.pauseReason;
return persisted;
}
function pausedSnapshot() {
const actor = createActor(captureMachine);
actor.start();
actor.send({ type: 'START_RECORDING', url: 'https://example.com' });
actor.send({ type: 'PAUSE_CAPTURE', reason: 'manual' });
return JSON.parse(JSON.stringify(actor.getPersistedSnapshot()));
}
async function loadActor(snapshot: unknown) {
vi.resetModules();
sessionGet.mockResolvedValue({ machineSnapshot: snapshot });
const mod = await import('../actor');
await mod.initActor();
return mod;
}
beforeEach(() => {
vi.clearAllMocks();
});
describe('getStateUpdate', () => {
it('reports a legacy RECORDING snapshot as recording, not paused', async () => {
const { getStateUpdate } = await loadActor(legacyRecordingSnapshot());
const update = getStateUpdate();
expect(update.state).toBe(CaptureState.RECORDING);
expect(update.pauseReason).toBeNull();
});
it('carries the pause reason when the machine really is paused', async () => {
const { getStateUpdate } = await loadActor(pausedSnapshot());
const update = getStateUpdate();
expect(update.state).toBe(CaptureState.PAUSED);
expect(update.pauseReason).toBe('manual');
});
it('starts idle when there is no snapshot to restore', async () => {
const { getStateUpdate } = await loadActor(undefined);
const update = getStateUpdate();
expect(update.state).toBe(CaptureState.IDLE);
expect(update.pauseReason).toBeNull();
expect(update.currentGuideId).toBeNull();
});
});