Implemented comprehensive offline-first state management: Redux Store Setup: - Configure Redux Toolkit with @redux-offline/redux-offline - Setup redux-persist with IndexedDB (localforage) - Custom offline config with exponential backoff retry - Normalized state with entity adapters State Slices: - activitiesSlice: Normalized activities with optimistic CRUD - childrenSlice: Normalized children with optimistic CRUD - networkSlice: Network status and connection quality - offlineSlice: Sync queue and pending actions Middleware: - offlineMiddleware: Queue actions when offline - syncMiddleware: Process pending actions when online - Conflict resolution strategies (SERVER_WINS, CLIENT_WINS, LAST_WRITE_WINS, MERGE) - Version-based conflict detection Features: - Optimistic updates for immediate UI feedback - Automatic sync queue with retry logic (5 retries max) - Network detection (browser events + periodic checks) - Connection quality monitoring (excellent/good/poor/offline) - Latency tracking - Conflict resolution with multiple strategies - Entity versioning for optimistic updates Components: - NetworkStatusIndicator: Full-screen status banner - NetworkStatusBadge: Compact app bar badge - ReduxProvider: Provider with network detection setup Custom Hooks: - useAppDispatch/useAppSelector: Typed Redux hooks - useIsOnline: Check online status - useHasPendingSync: Check for pending actions - useSyncStatus: Get sync progress info - useOptimisticAction: Combine optimistic + actual actions - useNetworkQuality: Get connection quality - useIsOptimistic: Check if entity is being synced Documentation: - Comprehensive README with usage examples - Architecture overview - Best practices guide - Troubleshooting section State Structure: - Normalized entities with byId/allIds - Optimistic metadata (_optimistic, _localId, _version) - Entity adapters with memoized selectors - Offline queue persistence to IndexedDB 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
230 lines
6.7 KiB
TypeScript
230 lines
6.7 KiB
TypeScript
import { createSlice, createAsyncThunk, createEntityAdapter, PayloadAction } from '@reduxjs/toolkit';
|
|
import { RootState } from '../store';
|
|
|
|
export interface Child {
|
|
id: string;
|
|
familyId: string;
|
|
name: string;
|
|
birthDate: string;
|
|
gender: 'male' | 'female' | 'other';
|
|
profilePhoto?: string;
|
|
metadata?: Record<string, any>;
|
|
createdAt: string;
|
|
updatedAt: string;
|
|
// Offline metadata
|
|
_optimistic?: boolean;
|
|
_localId?: string;
|
|
_version?: number;
|
|
}
|
|
|
|
// Create entity adapter
|
|
const childrenAdapter = createEntityAdapter<Child>({
|
|
selectId: (child) => child.id,
|
|
sortComparer: (a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime(),
|
|
});
|
|
|
|
// Async thunks
|
|
export const fetchChildren = createAsyncThunk(
|
|
'children/fetch',
|
|
async (familyId: string) => {
|
|
const response = await fetch(`/api/v1/children?familyId=${familyId}`);
|
|
if (!response.ok) {
|
|
throw new Error('Failed to fetch children');
|
|
}
|
|
const data = await response.json();
|
|
return data.data;
|
|
}
|
|
);
|
|
|
|
export const createChild = createAsyncThunk(
|
|
'children/create',
|
|
async (child: Omit<Child, 'id' | 'createdAt' | 'updatedAt'>, { rejectWithValue }) => {
|
|
try {
|
|
const response = await fetch('/api/v1/children', {
|
|
method: 'POST',
|
|
headers: { 'Content-Type': 'application/json' },
|
|
body: JSON.stringify(child),
|
|
});
|
|
|
|
if (!response.ok) {
|
|
throw new Error('Failed to create child');
|
|
}
|
|
|
|
return await response.json();
|
|
} catch (error: any) {
|
|
return rejectWithValue(error.message);
|
|
}
|
|
}
|
|
);
|
|
|
|
export const updateChild = createAsyncThunk(
|
|
'children/update',
|
|
async ({ id, updates }: { id: string; updates: Partial<Child> }, { rejectWithValue }) => {
|
|
try {
|
|
const response = await fetch(`/api/v1/children/${id}`, {
|
|
method: 'PATCH',
|
|
headers: { 'Content-Type': 'application/json' },
|
|
body: JSON.stringify(updates),
|
|
});
|
|
|
|
if (!response.ok) {
|
|
throw new Error('Failed to update child');
|
|
}
|
|
|
|
return await response.json();
|
|
} catch (error: any) {
|
|
return rejectWithValue(error.message);
|
|
}
|
|
}
|
|
);
|
|
|
|
const childrenSlice = createSlice({
|
|
name: 'children',
|
|
initialState: childrenAdapter.getInitialState({
|
|
loading: false,
|
|
error: null as string | null,
|
|
selectedChildId: null as string | null,
|
|
lastSyncTime: null as string | null,
|
|
}),
|
|
reducers: {
|
|
// Optimistic operations
|
|
optimisticCreate: (state, action: PayloadAction<Child>) => {
|
|
childrenAdapter.addOne(state, {
|
|
...action.payload,
|
|
_optimistic: true,
|
|
_localId: action.payload.id,
|
|
_version: 1,
|
|
});
|
|
},
|
|
optimisticUpdate: (state, action: PayloadAction<{ id: string; changes: Partial<Child> }>) => {
|
|
const { id, changes } = action.payload;
|
|
const existing = state.entities[id];
|
|
if (existing) {
|
|
childrenAdapter.updateOne(state, {
|
|
id,
|
|
changes: {
|
|
...changes,
|
|
_optimistic: true,
|
|
_version: (existing._version || 0) + 1,
|
|
},
|
|
});
|
|
}
|
|
},
|
|
rollbackOptimistic: (state, action: PayloadAction<string>) => {
|
|
const child = state.entities[action.payload];
|
|
if (child?._optimistic) {
|
|
childrenAdapter.removeOne(state, action.payload);
|
|
}
|
|
},
|
|
markSynced: (state, action: PayloadAction<{ localId: string; serverId: string; serverData: Child }>) => {
|
|
const { localId, serverId, serverData } = action.payload;
|
|
childrenAdapter.removeOne(state, localId);
|
|
childrenAdapter.addOne(state, {
|
|
...serverData,
|
|
_optimistic: false,
|
|
});
|
|
},
|
|
// Select child
|
|
selectChild: (state, action: PayloadAction<string>) => {
|
|
state.selectedChildId = action.payload;
|
|
},
|
|
clearChildren: (state) => {
|
|
childrenAdapter.removeAll(state);
|
|
state.selectedChildId = null;
|
|
state.error = null;
|
|
},
|
|
},
|
|
extraReducers: (builder) => {
|
|
builder
|
|
// Fetch children
|
|
.addCase(fetchChildren.pending, (state) => {
|
|
state.loading = true;
|
|
state.error = null;
|
|
})
|
|
.addCase(fetchChildren.fulfilled, (state, action) => {
|
|
state.loading = false;
|
|
state.lastSyncTime = new Date().toISOString();
|
|
const serverChildren = action.payload.map((c: Child) => ({
|
|
...c,
|
|
_optimistic: false,
|
|
}));
|
|
childrenAdapter.upsertMany(state, serverChildren);
|
|
})
|
|
.addCase(fetchChildren.rejected, (state, action) => {
|
|
state.loading = false;
|
|
state.error = action.error.message || 'Failed to fetch children';
|
|
})
|
|
// Create child
|
|
.addCase(createChild.pending, (state) => {
|
|
state.loading = true;
|
|
state.error = null;
|
|
})
|
|
.addCase(createChild.fulfilled, (state, action) => {
|
|
state.loading = false;
|
|
const serverChild = action.payload.data;
|
|
const optimisticId = action.meta.arg.id || action.meta.requestId;
|
|
if (state.entities[optimisticId]?._optimistic) {
|
|
childrenAdapter.removeOne(state, optimisticId);
|
|
}
|
|
childrenAdapter.addOne(state, {
|
|
...serverChild,
|
|
_optimistic: false,
|
|
});
|
|
})
|
|
.addCase(createChild.rejected, (state, action) => {
|
|
state.loading = false;
|
|
state.error = action.payload as string;
|
|
const optimisticId = action.meta.arg.id || action.meta.requestId;
|
|
if (state.entities[optimisticId]?._optimistic) {
|
|
childrenAdapter.removeOne(state, optimisticId);
|
|
}
|
|
})
|
|
// Update child
|
|
.addCase(updateChild.fulfilled, (state, action) => {
|
|
const serverChild = action.payload.data;
|
|
childrenAdapter.updateOne(state, {
|
|
id: serverChild.id,
|
|
changes: {
|
|
...serverChild,
|
|
_optimistic: false,
|
|
},
|
|
});
|
|
})
|
|
.addCase(updateChild.rejected, (state, action) => {
|
|
state.error = action.payload as string;
|
|
});
|
|
},
|
|
});
|
|
|
|
export const {
|
|
optimisticCreate,
|
|
optimisticUpdate,
|
|
rollbackOptimistic,
|
|
markSynced,
|
|
selectChild,
|
|
clearChildren,
|
|
} = childrenSlice.actions;
|
|
|
|
// Export selectors
|
|
export const childrenSelectors = childrenAdapter.getSelectors<RootState>(
|
|
(state) => state.children
|
|
);
|
|
|
|
// Custom selectors
|
|
export const selectSelectedChild = (state: RootState) => {
|
|
const id = state.children.selectedChildId;
|
|
return id ? state.children.entities[id] : null;
|
|
};
|
|
|
|
export const selectChildrenByFamily = (state: RootState, familyId: string) =>
|
|
childrenSelectors
|
|
.selectAll(state)
|
|
.filter((child) => child.familyId === familyId);
|
|
|
|
export const selectPendingChildren = (state: RootState) =>
|
|
childrenSelectors
|
|
.selectAll(state)
|
|
.filter((child) => child._optimistic);
|
|
|
|
export default childrenSlice.reducer;
|