mirror of
https://github.com/mauriceboe/TREK.git
synced 2026-06-19 13:21:46 +00:00
b194e8317d
Add genuine offline read/write capability for trips: - Dexie IndexedDB schema (trips, places, packing, todo, budget, reservations, files, mutationQueue, syncMeta, blobCache) - Repo layer for all domains: offline reads from Dexie, writes optimistically to Dexie and enqueue mutations for later replay - Mutation queue with UUID idempotency keys (X-Idempotency-Key), FIFO flush, temp-ID reconciliation on 2xx, fail-and-continue on 4xx - Trip sync manager: caches all trips with end_date >= today or null, auto-evicts 7d after end_date, fetches bundle endpoint in one request - Map tile prefetcher: bbox from place coords, zooms 10-16, 50MB cap, warms SW cache via fetch - Sync triggers: network online → flush + syncAll; WS reconnect → flush only (rate-limiter safe); visibilitychange/30s → flush only - WS remoteEventHandler writes through to Dexie on every event - Server idempotency middleware + idempotency_keys table (migration 100, 24h TTL nightly cleanup) - GET /api/trips/:id/bundle endpoint for efficient single-request sync - OfflineBanner component: amber (offline) / blue (syncing) / hidden - OfflineTab in Settings: cached trip list, re-sync and clear actions - usePendingMutations hook for per-item pending indicators Closes #505 #541
136 lines
4.8 KiB
TypeScript
136 lines
4.8 KiB
TypeScript
import { renderHook, act } from '@testing-library/react';
|
|
import { describe, it, expect, vi, beforeEach } from 'vitest';
|
|
import { useTripWebSocket } from '../../../src/hooks/useTripWebSocket';
|
|
import { useTripStore } from '../../../src/store/tripStore';
|
|
|
|
vi.mock('../../../src/api/websocket', () => ({
|
|
connect: vi.fn(),
|
|
disconnect: vi.fn(),
|
|
getSocketId: vi.fn(() => 'mock-socket-id'),
|
|
joinTrip: vi.fn(),
|
|
leaveTrip: vi.fn(),
|
|
addListener: vi.fn(),
|
|
removeListener: vi.fn(),
|
|
setRefetchCallback: vi.fn(),
|
|
setPreReconnectHook: vi.fn(),
|
|
}));
|
|
|
|
// Import the mocked module AFTER vi.mock
|
|
const wsMock = await import('../../../src/api/websocket');
|
|
|
|
describe('useTripWebSocket', () => {
|
|
beforeEach(() => {
|
|
vi.clearAllMocks();
|
|
});
|
|
|
|
it('FE-HOOK-WS-001: on mount, joinTrip(tripId) is called', () => {
|
|
const { unmount } = renderHook(() => useTripWebSocket(42));
|
|
expect(wsMock.joinTrip).toHaveBeenCalledWith(42);
|
|
unmount();
|
|
});
|
|
|
|
it('FE-HOOK-WS-002: on mount, addListener is called (registers event handlers)', () => {
|
|
const { unmount } = renderHook(() => useTripWebSocket(42));
|
|
// addListener is called twice: once for handleRemoteEvent, once for collabFileSync
|
|
expect(wsMock.addListener).toHaveBeenCalled();
|
|
expect((wsMock.addListener as ReturnType<typeof vi.fn>).mock.calls.length).toBeGreaterThanOrEqual(1);
|
|
unmount();
|
|
});
|
|
|
|
it('FE-HOOK-WS-003: on unmount, leaveTrip(tripId) is called', () => {
|
|
const { unmount } = renderHook(() => useTripWebSocket(42));
|
|
unmount();
|
|
expect(wsMock.leaveTrip).toHaveBeenCalledWith(42);
|
|
});
|
|
|
|
it('FE-HOOK-WS-004: on unmount, removeListener is called', () => {
|
|
const { unmount } = renderHook(() => useTripWebSocket(42));
|
|
unmount();
|
|
expect(wsMock.removeListener).toHaveBeenCalled();
|
|
});
|
|
|
|
it('FE-HOOK-WS-005: when tripId changes, leaves old trip and joins new one', () => {
|
|
const { rerender, unmount } = renderHook(({ id }) => useTripWebSocket(id), {
|
|
initialProps: { id: 1 as number | undefined },
|
|
});
|
|
expect(wsMock.joinTrip).toHaveBeenCalledWith(1);
|
|
|
|
rerender({ id: 2 });
|
|
|
|
expect(wsMock.leaveTrip).toHaveBeenCalledWith(1);
|
|
expect(wsMock.joinTrip).toHaveBeenCalledWith(2);
|
|
unmount();
|
|
});
|
|
|
|
it('FE-HOOK-WS-006: one of the registered listeners is handleRemoteEvent from tripStore', () => {
|
|
const handler = useTripStore.getState().handleRemoteEvent;
|
|
renderHook(() => useTripWebSocket(42));
|
|
|
|
const addListenerCalls = (wsMock.addListener as ReturnType<typeof vi.fn>).mock.calls;
|
|
const registeredFunctions = addListenerCalls.map((call) => call[0]);
|
|
expect(registeredFunctions).toContain(handler);
|
|
});
|
|
|
|
it('FE-HOOK-WS-006b: collab file sync listener is also registered (second addListener call)', () => {
|
|
const { unmount } = renderHook(() => useTripWebSocket(42));
|
|
// Two listeners registered: handleRemoteEvent + collabFileSync
|
|
expect((wsMock.addListener as ReturnType<typeof vi.fn>).mock.calls.length).toBe(2);
|
|
unmount();
|
|
});
|
|
|
|
it('FE-HOOK-WS-006c: collab file sync listener reacts to collab:note:deleted events', () => {
|
|
const mockLoadFiles = vi.fn();
|
|
useTripStore.setState({ loadFiles: mockLoadFiles } as any);
|
|
|
|
renderHook(() => useTripWebSocket(42));
|
|
|
|
// The second addListener call is the collabFileSync function
|
|
const addListenerCalls = (wsMock.addListener as ReturnType<typeof vi.fn>).mock.calls;
|
|
const collabFileSync = addListenerCalls[1]?.[0];
|
|
expect(collabFileSync).toBeTypeOf('function');
|
|
|
|
act(() => {
|
|
collabFileSync({ type: 'collab:note:deleted' });
|
|
});
|
|
|
|
expect(mockLoadFiles).toHaveBeenCalledWith(42);
|
|
});
|
|
|
|
it('FE-HOOK-WS-006d: collab file sync listener reacts to collab:note:updated events', () => {
|
|
const mockLoadFiles = vi.fn();
|
|
useTripStore.setState({ loadFiles: mockLoadFiles } as any);
|
|
|
|
renderHook(() => useTripWebSocket(42));
|
|
|
|
const addListenerCalls = (wsMock.addListener as ReturnType<typeof vi.fn>).mock.calls;
|
|
const collabFileSync = addListenerCalls[1]?.[0];
|
|
|
|
act(() => {
|
|
collabFileSync({ type: 'collab:note:updated' });
|
|
});
|
|
|
|
expect(mockLoadFiles).toHaveBeenCalledWith(42);
|
|
});
|
|
|
|
it('FE-HOOK-WS-006e: collab file sync listener ignores unrelated event types', () => {
|
|
const mockLoadFiles = vi.fn();
|
|
useTripStore.setState({ loadFiles: mockLoadFiles } as any);
|
|
|
|
renderHook(() => useTripWebSocket(42));
|
|
|
|
const addListenerCalls = (wsMock.addListener as ReturnType<typeof vi.fn>).mock.calls;
|
|
const collabFileSync = addListenerCalls[1]?.[0];
|
|
|
|
act(() => {
|
|
collabFileSync({ type: 'place:created' });
|
|
});
|
|
|
|
expect(mockLoadFiles).not.toHaveBeenCalled();
|
|
});
|
|
|
|
it('FE-HOOK-WS-007: no joinTrip call when tripId is undefined', () => {
|
|
renderHook(() => useTripWebSocket(undefined));
|
|
expect(wsMock.joinTrip).not.toHaveBeenCalled();
|
|
});
|
|
});
|