feat: Implement offline-first Redux architecture with optimistic updates
Some checks failed
CI/CD Pipeline / Lint and Test (push) Has been cancelled
CI/CD Pipeline / E2E Tests (push) Has been cancelled
CI/CD Pipeline / Build Application (push) Has been cancelled

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>
This commit is contained in:
2025-10-01 19:24:46 +00:00
parent aaa239121e
commit 7cb2ff97de
12 changed files with 1469 additions and 563 deletions

View File

@@ -0,0 +1,94 @@
'use client';
import { Alert, Snackbar, Box, Typography, CircularProgress } from '@mui/material';
import { CloudOff, CloudQueue, CloudDone, Wifi, WifiOff } from '@mui/icons-material';
import { useIsOnline, useSyncStatus } from '@/store/hooks';
export const NetworkStatusIndicator: React.FC = () => {
const isOnline = useIsOnline();
const { syncing, pendingCount } = useSyncStatus();
// Show nothing if online and no pending sync
if (isOnline && !syncing && pendingCount === 0) {
return null;
}
return (
<Snackbar
open={true}
anchorOrigin={{ vertical: 'top', horizontal: 'center' }}
sx={{ top: 80 }}
>
<Alert
severity={isOnline ? (syncing ? 'info' : 'warning') : 'error'}
icon={
syncing ? (
<CircularProgress size={20} />
) : isOnline ? (
<CloudQueue />
) : (
<WifiOff />
)
}
sx={{
width: '100%',
maxWidth: 400,
borderRadius: 2,
}}
>
<Box>
<Typography variant="body2" fontWeight="600">
{!isOnline && 'You are offline'}
{isOnline && syncing && 'Syncing changes...'}
{isOnline && !syncing && pendingCount > 0 && `${pendingCount} changes pending`}
</Typography>
<Typography variant="caption">
{!isOnline && 'Your changes will be saved and synced when you reconnect'}
{isOnline && syncing && 'Please wait while we sync your data'}
{isOnline && !syncing && pendingCount > 0 && 'Waiting to sync'}
</Typography>
</Box>
</Alert>
</Snackbar>
);
};
/**
* Small status badge for the app bar
*/
export const NetworkStatusBadge: React.FC = () => {
const isOnline = useIsOnline();
const { syncing, pendingCount } = useSyncStatus();
if (isOnline && !syncing && pendingCount === 0) {
return null;
}
return (
<Box
sx={{
display: 'flex',
alignItems: 'center',
gap: 0.5,
px: 1.5,
py: 0.5,
borderRadius: 2,
bgcolor: isOnline ? 'warning.light' : 'error.light',
color: isOnline ? 'warning.dark' : 'error.dark',
}}
>
{syncing ? (
<CircularProgress size={14} />
) : isOnline ? (
<CloudQueue sx={{ fontSize: 16 }} />
) : (
<WifiOff sx={{ fontSize: 16 }} />
)}
<Typography variant="caption" fontWeight="600">
{!isOnline && 'Offline'}
{isOnline && syncing && 'Syncing'}
{isOnline && !syncing && pendingCount > 0 && pendingCount}
</Typography>
</Box>
);
};

View File

@@ -0,0 +1,24 @@
'use client';
import { useEffect, useRef } from 'react';
import { Provider } from 'react-redux';
import { store } from '@/store/store';
import { setupNetworkDetection } from '@/store/middleware/offlineMiddleware';
export function ReduxProvider({ children }: { children: React.Node }) {
const cleanupRef = useRef<(() => void) | null>(null);
useEffect(() => {
// Setup network detection
cleanupRef.current = setupNetworkDetection(store.dispatch);
// Cleanup on unmount
return () => {
if (cleanupRef.current) {
cleanupRef.current();
}
};
}, []);
return <Provider store={store}>{children}</Provider>;
}

View File

@@ -14,11 +14,13 @@
"@mui/icons-material": "^5.18.0",
"@mui/material": "^5.18.0",
"@mui/material-nextjs": "^7.3.2",
"@redux-offline/redux-offline": "^2.6.0",
"@reduxjs/toolkit": "^2.9.0",
"@tanstack/react-query": "^5.90.2",
"axios": "^1.12.2",
"date-fns": "^4.1.0",
"framer-motion": "^11.18.2",
"localforage": "^1.10.0",
"next": "14.2.0",
"next-pwa": "^5.6.0",
"react": "^18",
@@ -3161,7 +3163,7 @@
"version": "1.55.1",
"resolved": "https://registry.npmjs.org/@playwright/test/-/test-1.55.1.tgz",
"integrity": "sha512-IVAh/nOJaw6W9g+RJVlIQJ6gSiER+ae6mKQ5CX1bERzQgbC1VSeBlwdvczT7pxb0GWiyrxH4TGKbMfDb4Sq/ig==",
"devOptional": true,
"dev": true,
"license": "Apache-2.0",
"dependencies": {
"playwright": "1.55.1"
@@ -3183,6 +3185,30 @@
"url": "https://opencollective.com/popperjs"
}
},
"node_modules/@redux-offline/redux-offline": {
"version": "2.6.0",
"resolved": "https://registry.npmjs.org/@redux-offline/redux-offline/-/redux-offline-2.6.0.tgz",
"integrity": "sha512-h11HBMVnFSuJBtRm9cwasGnLC+zimY7ghKOyUslHp3gOjJjX4eCurvNDyKqxZAyPg4glp4X+4s2rOXNvLC9FRA==",
"license": "MIT",
"dependencies": {
"@babel/runtime": "^7.9.6",
"redux-persist": "^4.6.0"
},
"peerDependencies": {
"redux": ">=3"
}
},
"node_modules/@redux-offline/redux-offline/node_modules/redux-persist": {
"version": "4.10.2",
"resolved": "https://registry.npmjs.org/redux-persist/-/redux-persist-4.10.2.tgz",
"integrity": "sha512-U+e0ieMGC69Zr72929iJW40dEld7Mflh6mu0eJtVMLGfMq/aJqjxUM1hzyUWMR1VUyAEEdPHuQmeq5ti9krIgg==",
"license": "MIT",
"dependencies": {
"json-stringify-safe": "^5.0.1",
"lodash": "^4.17.4",
"lodash-es": "^4.17.4"
}
},
"node_modules/@reduxjs/toolkit": {
"version": "2.9.0",
"resolved": "https://registry.npmjs.org/@reduxjs/toolkit/-/toolkit-2.9.0.tgz",
@@ -3453,27 +3479,6 @@
"react": "^18 || ^19"
}
},
"node_modules/@testing-library/dom": {
"version": "10.4.1",
"resolved": "https://registry.npmjs.org/@testing-library/dom/-/dom-10.4.1.tgz",
"integrity": "sha512-o4PXJQidqJl82ckFaXUeoAW+XysPLauYI43Abki5hABd853iMhitooc6znOnczgbTYmEP6U6/y1ZyKAIsvMKGg==",
"dev": true,
"license": "MIT",
"peer": true,
"dependencies": {
"@babel/code-frame": "^7.10.4",
"@babel/runtime": "^7.12.5",
"@types/aria-query": "^5.0.1",
"aria-query": "5.3.0",
"dom-accessibility-api": "^0.5.9",
"lz-string": "^1.5.0",
"picocolors": "1.1.1",
"pretty-format": "^27.0.2"
},
"engines": {
"node": ">=18"
}
},
"node_modules/@testing-library/jest-dom": {
"version": "6.9.0",
"resolved": "https://registry.npmjs.org/@testing-library/jest-dom/-/jest-dom-6.9.0.tgz",
@@ -3554,19 +3559,11 @@
"tslib": "^2.4.0"
}
},
"node_modules/@types/aria-query": {
"version": "5.0.4",
"resolved": "https://registry.npmjs.org/@types/aria-query/-/aria-query-5.0.4.tgz",
"integrity": "sha512-rfT93uj5s0PRL7EzccGMs3brplhcrghnDoV26NqKhCAS1hVo+WdNsPvE/yb6ilfr5hi2MEk6d5EWJTKdxg8jVw==",
"dev": true,
"license": "MIT",
"peer": true
},
"node_modules/@types/babel__core": {
"version": "7.20.5",
"resolved": "https://registry.npmjs.org/@types/babel__core/-/babel__core-7.20.5.tgz",
"integrity": "sha512-qoQprZvz5wQFJwMDqeseRXWv3rqMvhgpbXFfVyWhbx9X47POIA6i/+dXefEmZKoAgOaTdaIgNSMqMIU61yRyzA==",
"devOptional": true,
"dev": true,
"license": "MIT",
"dependencies": {
"@babel/parser": "^7.20.7",
@@ -3580,7 +3577,7 @@
"version": "7.27.0",
"resolved": "https://registry.npmjs.org/@types/babel__generator/-/babel__generator-7.27.0.tgz",
"integrity": "sha512-ufFd2Xi92OAVPYsy+P4n7/U7e68fex0+Ee8gSG9KX7eo084CWiQ4sdxktvdl0bOPupXtVJPY19zk6EwWqUQ8lg==",
"devOptional": true,
"dev": true,
"license": "MIT",
"dependencies": {
"@babel/types": "^7.0.0"
@@ -3590,7 +3587,7 @@
"version": "7.4.4",
"resolved": "https://registry.npmjs.org/@types/babel__template/-/babel__template-7.4.4.tgz",
"integrity": "sha512-h/NUaSyG5EyxBIp8YRxo4RMe2/qQgvyowRwVMzhYhBCONbW8PUsg4lkFMrhgZhUe5z3L3MiLDuvyJ/CaPa2A8A==",
"devOptional": true,
"dev": true,
"license": "MIT",
"dependencies": {
"@babel/parser": "^7.1.0",
@@ -3601,7 +3598,7 @@
"version": "7.28.0",
"resolved": "https://registry.npmjs.org/@types/babel__traverse/-/babel__traverse-7.28.0.tgz",
"integrity": "sha512-8PvcXf70gTDZBgt9ptxJ8elBeBjcLOAcOtoO/mPJjtji1+CdGbHgm77om1GrsPxsiE+uXIpNSK64UYaIwQXd4Q==",
"devOptional": true,
"dev": true,
"license": "MIT",
"dependencies": {
"@babel/types": "^7.28.2"
@@ -3670,28 +3667,6 @@
"integrity": "sha512-Ps3T8E8dZDam6fUyNiMkekK3XUsaUEik+idO9/YjPtfj2qruF8tFBXS7XhtE4iIXBLxhmLjP3SXpLhVf21I9Lw==",
"license": "MIT"
},
"node_modules/@types/eslint": {
"version": "9.6.1",
"resolved": "https://registry.npmjs.org/@types/eslint/-/eslint-9.6.1.tgz",
"integrity": "sha512-FXx2pKgId/WyYo2jXw63kk7/+TY7u7AziEJxJAnSFzHlqTAS3Ync6SvgYAN/k4/PQpnnVuzoMuVnByKK2qp0ag==",
"license": "MIT",
"peer": true,
"dependencies": {
"@types/estree": "*",
"@types/json-schema": "*"
}
},
"node_modules/@types/eslint-scope": {
"version": "3.7.7",
"resolved": "https://registry.npmjs.org/@types/eslint-scope/-/eslint-scope-3.7.7.tgz",
"integrity": "sha512-MzMFlSLBqNF2gcHWO0G1vP/YQyfvrxZ0bF+u7mzUdZ1/xK4A4sru+nraZz5i3iEIk1l1uyicaDVTB4QbbEkAYg==",
"license": "MIT",
"peer": true,
"dependencies": {
"@types/eslint": "*",
"@types/estree": "*"
}
},
"node_modules/@types/estree": {
"version": "1.0.8",
"resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
@@ -3830,6 +3805,7 @@
"version": "18.3.25",
"resolved": "https://registry.npmjs.org/@types/react/-/react-18.3.25.tgz",
"integrity": "sha512-oSVZmGtDPmRZtVDqvdKUi/qgCsWp5IDY29wp8na8Bj4B3cc99hfNzvNhlMkVVxctkAOGUA3Km7MMpBHAnWfcIA==",
"dev": true,
"license": "MIT",
"dependencies": {
"@types/prop-types": "*",
@@ -4180,181 +4156,6 @@
"win32"
]
},
"node_modules/@webassemblyjs/ast": {
"version": "1.14.1",
"resolved": "https://registry.npmjs.org/@webassemblyjs/ast/-/ast-1.14.1.tgz",
"integrity": "sha512-nuBEDgQfm1ccRp/8bCQrx1frohyufl4JlbMMZ4P1wpeOfDhF6FQkxZJ1b/e+PLwr6X1Nhw6OLme5usuBWYBvuQ==",
"license": "MIT",
"peer": true,
"dependencies": {
"@webassemblyjs/helper-numbers": "1.13.2",
"@webassemblyjs/helper-wasm-bytecode": "1.13.2"
}
},
"node_modules/@webassemblyjs/floating-point-hex-parser": {
"version": "1.13.2",
"resolved": "https://registry.npmjs.org/@webassemblyjs/floating-point-hex-parser/-/floating-point-hex-parser-1.13.2.tgz",
"integrity": "sha512-6oXyTOzbKxGH4steLbLNOu71Oj+C8Lg34n6CqRvqfS2O71BxY6ByfMDRhBytzknj9yGUPVJ1qIKhRlAwO1AovA==",
"license": "MIT",
"peer": true
},
"node_modules/@webassemblyjs/helper-api-error": {
"version": "1.13.2",
"resolved": "https://registry.npmjs.org/@webassemblyjs/helper-api-error/-/helper-api-error-1.13.2.tgz",
"integrity": "sha512-U56GMYxy4ZQCbDZd6JuvvNV/WFildOjsaWD3Tzzvmw/mas3cXzRJPMjP83JqEsgSbyrmaGjBfDtV7KDXV9UzFQ==",
"license": "MIT",
"peer": true
},
"node_modules/@webassemblyjs/helper-buffer": {
"version": "1.14.1",
"resolved": "https://registry.npmjs.org/@webassemblyjs/helper-buffer/-/helper-buffer-1.14.1.tgz",
"integrity": "sha512-jyH7wtcHiKssDtFPRB+iQdxlDf96m0E39yb0k5uJVhFGleZFoNw1c4aeIcVUPPbXUVJ94wwnMOAqUHyzoEPVMA==",
"license": "MIT",
"peer": true
},
"node_modules/@webassemblyjs/helper-numbers": {
"version": "1.13.2",
"resolved": "https://registry.npmjs.org/@webassemblyjs/helper-numbers/-/helper-numbers-1.13.2.tgz",
"integrity": "sha512-FE8aCmS5Q6eQYcV3gI35O4J789wlQA+7JrqTTpJqn5emA4U2hvwJmvFRC0HODS+3Ye6WioDklgd6scJ3+PLnEA==",
"license": "MIT",
"peer": true,
"dependencies": {
"@webassemblyjs/floating-point-hex-parser": "1.13.2",
"@webassemblyjs/helper-api-error": "1.13.2",
"@xtuc/long": "4.2.2"
}
},
"node_modules/@webassemblyjs/helper-wasm-bytecode": {
"version": "1.13.2",
"resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-bytecode/-/helper-wasm-bytecode-1.13.2.tgz",
"integrity": "sha512-3QbLKy93F0EAIXLh0ogEVR6rOubA9AoZ+WRYhNbFyuB70j3dRdwH9g+qXhLAO0kiYGlg3TxDV+I4rQTr/YNXkA==",
"license": "MIT",
"peer": true
},
"node_modules/@webassemblyjs/helper-wasm-section": {
"version": "1.14.1",
"resolved": "https://registry.npmjs.org/@webassemblyjs/helper-wasm-section/-/helper-wasm-section-1.14.1.tgz",
"integrity": "sha512-ds5mXEqTJ6oxRoqjhWDU83OgzAYjwsCV8Lo/N+oRsNDmx/ZDpqalmrtgOMkHwxsG0iI//3BwWAErYRHtgn0dZw==",
"license": "MIT",
"peer": true,
"dependencies": {
"@webassemblyjs/ast": "1.14.1",
"@webassemblyjs/helper-buffer": "1.14.1",
"@webassemblyjs/helper-wasm-bytecode": "1.13.2",
"@webassemblyjs/wasm-gen": "1.14.1"
}
},
"node_modules/@webassemblyjs/ieee754": {
"version": "1.13.2",
"resolved": "https://registry.npmjs.org/@webassemblyjs/ieee754/-/ieee754-1.13.2.tgz",
"integrity": "sha512-4LtOzh58S/5lX4ITKxnAK2USuNEvpdVV9AlgGQb8rJDHaLeHciwG4zlGr0j/SNWlr7x3vO1lDEsuePvtcDNCkw==",
"license": "MIT",
"peer": true,
"dependencies": {
"@xtuc/ieee754": "^1.2.0"
}
},
"node_modules/@webassemblyjs/leb128": {
"version": "1.13.2",
"resolved": "https://registry.npmjs.org/@webassemblyjs/leb128/-/leb128-1.13.2.tgz",
"integrity": "sha512-Lde1oNoIdzVzdkNEAWZ1dZ5orIbff80YPdHx20mrHwHrVNNTjNr8E3xz9BdpcGqRQbAEa+fkrCb+fRFTl/6sQw==",
"license": "Apache-2.0",
"peer": true,
"dependencies": {
"@xtuc/long": "4.2.2"
}
},
"node_modules/@webassemblyjs/utf8": {
"version": "1.13.2",
"resolved": "https://registry.npmjs.org/@webassemblyjs/utf8/-/utf8-1.13.2.tgz",
"integrity": "sha512-3NQWGjKTASY1xV5m7Hr0iPeXD9+RDobLll3T9d2AO+g3my8xy5peVyjSag4I50mR1bBSN/Ct12lo+R9tJk0NZQ==",
"license": "MIT",
"peer": true
},
"node_modules/@webassemblyjs/wasm-edit": {
"version": "1.14.1",
"resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-edit/-/wasm-edit-1.14.1.tgz",
"integrity": "sha512-RNJUIQH/J8iA/1NzlE4N7KtyZNHi3w7at7hDjvRNm5rcUXa00z1vRz3glZoULfJ5mpvYhLybmVcwcjGrC1pRrQ==",
"license": "MIT",
"peer": true,
"dependencies": {
"@webassemblyjs/ast": "1.14.1",
"@webassemblyjs/helper-buffer": "1.14.1",
"@webassemblyjs/helper-wasm-bytecode": "1.13.2",
"@webassemblyjs/helper-wasm-section": "1.14.1",
"@webassemblyjs/wasm-gen": "1.14.1",
"@webassemblyjs/wasm-opt": "1.14.1",
"@webassemblyjs/wasm-parser": "1.14.1",
"@webassemblyjs/wast-printer": "1.14.1"
}
},
"node_modules/@webassemblyjs/wasm-gen": {
"version": "1.14.1",
"resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-gen/-/wasm-gen-1.14.1.tgz",
"integrity": "sha512-AmomSIjP8ZbfGQhumkNvgC33AY7qtMCXnN6bL2u2Js4gVCg8fp735aEiMSBbDR7UQIj90n4wKAFUSEd0QN2Ukg==",
"license": "MIT",
"peer": true,
"dependencies": {
"@webassemblyjs/ast": "1.14.1",
"@webassemblyjs/helper-wasm-bytecode": "1.13.2",
"@webassemblyjs/ieee754": "1.13.2",
"@webassemblyjs/leb128": "1.13.2",
"@webassemblyjs/utf8": "1.13.2"
}
},
"node_modules/@webassemblyjs/wasm-opt": {
"version": "1.14.1",
"resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-opt/-/wasm-opt-1.14.1.tgz",
"integrity": "sha512-PTcKLUNvBqnY2U6E5bdOQcSM+oVP/PmrDY9NzowJjislEjwP/C4an2303MCVS2Mg9d3AJpIGdUFIQQWbPds0Sw==",
"license": "MIT",
"peer": true,
"dependencies": {
"@webassemblyjs/ast": "1.14.1",
"@webassemblyjs/helper-buffer": "1.14.1",
"@webassemblyjs/wasm-gen": "1.14.1",
"@webassemblyjs/wasm-parser": "1.14.1"
}
},
"node_modules/@webassemblyjs/wasm-parser": {
"version": "1.14.1",
"resolved": "https://registry.npmjs.org/@webassemblyjs/wasm-parser/-/wasm-parser-1.14.1.tgz",
"integrity": "sha512-JLBl+KZ0R5qB7mCnud/yyX08jWFw5MsoalJ1pQ4EdFlgj9VdXKGuENGsiCIjegI1W7p91rUlcB/LB5yRJKNTcQ==",
"license": "MIT",
"peer": true,
"dependencies": {
"@webassemblyjs/ast": "1.14.1",
"@webassemblyjs/helper-api-error": "1.13.2",
"@webassemblyjs/helper-wasm-bytecode": "1.13.2",
"@webassemblyjs/ieee754": "1.13.2",
"@webassemblyjs/leb128": "1.13.2",
"@webassemblyjs/utf8": "1.13.2"
}
},
"node_modules/@webassemblyjs/wast-printer": {
"version": "1.14.1",
"resolved": "https://registry.npmjs.org/@webassemblyjs/wast-printer/-/wast-printer-1.14.1.tgz",
"integrity": "sha512-kPSSXE6De1XOR820C90RIo2ogvZG+c3KiHzqUoO/F34Y2shGzesfqv7o57xrxovZJH/MetF5UjroJ/R/3isoiw==",
"license": "MIT",
"peer": true,
"dependencies": {
"@webassemblyjs/ast": "1.14.1",
"@xtuc/long": "4.2.2"
}
},
"node_modules/@xtuc/ieee754": {
"version": "1.2.0",
"resolved": "https://registry.npmjs.org/@xtuc/ieee754/-/ieee754-1.2.0.tgz",
"integrity": "sha512-DX8nKgqcGwsc0eJSqYt5lwP4DH5FlHnmuWWBRy7X0NcaGR0ZtuyeESgMwTYVEtxmsNGY+qit4QYT/MIYTOTPeA==",
"license": "BSD-3-Clause",
"peer": true
},
"node_modules/@xtuc/long": {
"version": "4.2.2",
"resolved": "https://registry.npmjs.org/@xtuc/long/-/long-4.2.2.tgz",
"integrity": "sha512-NuHqBY1PB/D8xU6s/thBgOAiAP7HOYDQ32+BFZILJ8ivkUkAHQnWfn6WhL79Owj1qmUnoN/YPhktdIoucipkAQ==",
"license": "Apache-2.0",
"peer": true
},
"node_modules/acorn": {
"version": "8.15.0",
"resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz",
@@ -4367,19 +4168,6 @@
"node": ">=0.4.0"
}
},
"node_modules/acorn-import-phases": {
"version": "1.0.4",
"resolved": "https://registry.npmjs.org/acorn-import-phases/-/acorn-import-phases-1.0.4.tgz",
"integrity": "sha512-wKmbr/DDiIXzEOiWrTTUcDm24kQ2vGfZQvM2fwg2vXqR5uW6aapr7ObPtj1th32b9u90/Pf4AItvdTh42fBmVQ==",
"license": "MIT",
"peer": true,
"engines": {
"node": ">=10.13.0"
},
"peerDependencies": {
"acorn": "^8.14.0"
}
},
"node_modules/agent-base": {
"version": "7.1.4",
"resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz",
@@ -5183,16 +4971,6 @@
"node": ">= 6"
}
},
"node_modules/chrome-trace-event": {
"version": "1.0.4",
"resolved": "https://registry.npmjs.org/chrome-trace-event/-/chrome-trace-event-1.0.4.tgz",
"integrity": "sha512-rNjApaLzuwaOTjCiT8lSDdGN1APCiqkChLMJxJPWLunPAt5fy8xgU9/jNOchV84wfIxrA0lRQB7oCT8jrn/wrQ==",
"license": "MIT",
"peer": true,
"engines": {
"node": ">=6.0"
}
},
"node_modules/ci-info": {
"version": "4.3.0",
"resolved": "https://registry.npmjs.org/ci-info/-/ci-info-4.3.0.tgz",
@@ -6022,14 +5800,6 @@
"dev": true,
"license": "MIT"
},
"node_modules/dom-accessibility-api": {
"version": "0.5.16",
"resolved": "https://registry.npmjs.org/dom-accessibility-api/-/dom-accessibility-api-0.5.16.tgz",
"integrity": "sha512-X7BJ2yElsnOJ30pZF4uIIDfBEVgF4XEBxL9Bxhy6dnrm5hkzqmsWHGTiHqRiITNhMyFLyAiWndIJP7Z1NTteDg==",
"dev": true,
"license": "MIT",
"peer": true
},
"node_modules/dom-helpers": {
"version": "5.2.1",
"resolved": "https://registry.npmjs.org/dom-helpers/-/dom-helpers-5.2.1.tgz",
@@ -6150,20 +5920,6 @@
"node": ">=10.0.0"
}
},
"node_modules/enhanced-resolve": {
"version": "5.18.3",
"resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.18.3.tgz",
"integrity": "sha512-d4lC8xfavMeBjzGr2vECC3fsGXziXZQyJxD868h2M/mBI3PwAuODxAkLkq5HYuvrPYcUtiLzsTo8U3PgX3Ocww==",
"license": "MIT",
"peer": true,
"dependencies": {
"graceful-fs": "^4.2.4",
"tapable": "^2.2.0"
},
"engines": {
"node": ">=10.13.0"
}
},
"node_modules/entities": {
"version": "6.0.1",
"resolved": "https://registry.npmjs.org/entities/-/entities-6.0.1.tgz",
@@ -6272,13 +6028,6 @@
"node": ">= 0.4"
}
},
"node_modules/es-module-lexer": {
"version": "1.7.0",
"resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-1.7.0.tgz",
"integrity": "sha512-jEQoCwk8hyb2AZziIOLhDqpm5+2ww5uIE6lkO/6jcOCusfk6LhMHpXXfBLXTZ7Ydyt0j4VoUQv6uGNYbdW+kBA==",
"license": "MIT",
"peer": true
},
"node_modules/es-object-atoms": {
"version": "1.1.1",
"resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
@@ -6354,20 +6103,6 @@
"url": "https://github.com/sponsors/sindresorhus"
}
},
"node_modules/eslint-scope": {
"version": "5.1.1",
"resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-5.1.1.tgz",
"integrity": "sha512-2NxwbF/hZ0KpepYN0cNbo+FN6XoK7GaHlQhgx/hIZl6Va0bF45RQOOwhLIy8lQDbuCiadSLCBnH2CFYquit5bw==",
"license": "BSD-2-Clause",
"peer": true,
"dependencies": {
"esrecurse": "^4.3.0",
"estraverse": "^4.1.1"
},
"engines": {
"node": ">=8.0.0"
}
},
"node_modules/esprima": {
"version": "4.0.1",
"resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
@@ -6382,39 +6117,6 @@
"node": ">=4"
}
},
"node_modules/esrecurse": {
"version": "4.3.0",
"resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz",
"integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==",
"license": "BSD-2-Clause",
"peer": true,
"dependencies": {
"estraverse": "^5.2.0"
},
"engines": {
"node": ">=4.0"
}
},
"node_modules/esrecurse/node_modules/estraverse": {
"version": "5.3.0",
"resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz",
"integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==",
"license": "BSD-2-Clause",
"peer": true,
"engines": {
"node": ">=4.0"
}
},
"node_modules/estraverse": {
"version": "4.3.0",
"resolved": "https://registry.npmjs.org/estraverse/-/estraverse-4.3.0.tgz",
"integrity": "sha512-39nnKffWz8xN1BU/2c79n9nB9HDzo0niYUqx6xyqUnyoAnQyyWpOTdZEeiCch8BBu515t4wp9ZmgVfVhn9EBpw==",
"license": "BSD-2-Clause",
"peer": true,
"engines": {
"node": ">=4.0"
}
},
"node_modules/estree-walker": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-1.0.1.tgz",
@@ -6436,16 +6138,6 @@
"integrity": "sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA==",
"license": "MIT"
},
"node_modules/events": {
"version": "3.3.0",
"resolved": "https://registry.npmjs.org/events/-/events-3.3.0.tgz",
"integrity": "sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==",
"license": "MIT",
"peer": true,
"engines": {
"node": ">=0.8.x"
}
},
"node_modules/execa": {
"version": "5.1.1",
"resolved": "https://registry.npmjs.org/execa/-/execa-5.1.1.tgz",
@@ -6953,13 +6645,6 @@
"node": ">=10.13.0"
}
},
"node_modules/glob-to-regexp": {
"version": "0.4.1",
"resolved": "https://registry.npmjs.org/glob-to-regexp/-/glob-to-regexp-0.4.1.tgz",
"integrity": "sha512-lkX1HJXwyMcprw/5YUZc2s7DrpAiHB21/V+E1rHUrVNokkvB6bqMzT0VfV6/86ZNabt1k14YOIaT7nDvOX3Iiw==",
"license": "BSD-2-Clause",
"peer": true
},
"node_modules/globalthis": {
"version": "1.0.4",
"resolved": "https://registry.npmjs.org/globalthis/-/globalthis-1.0.4.tgz",
@@ -7254,6 +6939,12 @@
"node": ">= 4"
}
},
"node_modules/immediate": {
"version": "3.0.6",
"resolved": "https://registry.npmjs.org/immediate/-/immediate-3.0.6.tgz",
"integrity": "sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==",
"license": "MIT"
},
"node_modules/immer": {
"version": "10.1.3",
"resolved": "https://registry.npmjs.org/immer/-/immer-10.1.3.tgz",
@@ -9325,6 +9016,12 @@
"integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
"license": "MIT"
},
"node_modules/json-stringify-safe": {
"version": "5.0.1",
"resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz",
"integrity": "sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA==",
"license": "ISC"
},
"node_modules/json5": {
"version": "2.2.3",
"resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
@@ -9367,6 +9064,15 @@
"node": ">=6"
}
},
"node_modules/lie": {
"version": "3.1.1",
"resolved": "https://registry.npmjs.org/lie/-/lie-3.1.1.tgz",
"integrity": "sha512-RiNhHysUjhrDQntfYSfY4MU24coXXdEOgw9WGcKHNeEwffDYbF//u87M1EWaMGzuFoSbqW0C9C6lEEhDOAswfw==",
"license": "MIT",
"dependencies": {
"immediate": "~3.0.5"
}
},
"node_modules/lilconfig": {
"version": "3.1.3",
"resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-3.1.3.tgz",
@@ -9386,16 +9092,6 @@
"integrity": "sha512-7ylylesZQ/PV29jhEDl3Ufjo6ZX7gCqJr5F7PKrqc93v7fzSymt1BpwEU8nAUXs8qzzvqhbjhK5QZg6Mt/HkBg==",
"license": "MIT"
},
"node_modules/loader-runner": {
"version": "4.3.0",
"resolved": "https://registry.npmjs.org/loader-runner/-/loader-runner-4.3.0.tgz",
"integrity": "sha512-3R/1M+yS3j5ou80Me59j7F9IMs4PXs3VqRrm0TU3AbKPxlmpoY1TNscJV/oGJXo8qCatFGTfDbY6W6ipGOYXfg==",
"license": "MIT",
"peer": true,
"engines": {
"node": ">=6.11.5"
}
},
"node_modules/loader-utils": {
"version": "2.0.4",
"resolved": "https://registry.npmjs.org/loader-utils/-/loader-utils-2.0.4.tgz",
@@ -9410,6 +9106,15 @@
"node": ">=8.9.0"
}
},
"node_modules/localforage": {
"version": "1.10.0",
"resolved": "https://registry.npmjs.org/localforage/-/localforage-1.10.0.tgz",
"integrity": "sha512-14/H1aX7hzBBmmh7sGPd+AOMkkIrHM3Z1PAyGgZigA1H1p5O5ANnMyWzvpAETtG68/dC4pC0ncy3+PPGzXZHPg==",
"license": "Apache-2.0",
"dependencies": {
"lie": "3.1.1"
}
},
"node_modules/locate-path": {
"version": "5.0.0",
"resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz",
@@ -9428,6 +9133,12 @@
"integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==",
"license": "MIT"
},
"node_modules/lodash-es": {
"version": "4.17.21",
"resolved": "https://registry.npmjs.org/lodash-es/-/lodash-es-4.17.21.tgz",
"integrity": "sha512-mKnC+QJ9pWVzv+C4/U3rRsHapFfHvQFoFB92e52xeyGMcX6/OlIl78je1u8vePzYZSkkogMPJ2yjxxsb89cxyw==",
"license": "MIT"
},
"node_modules/lodash.debounce": {
"version": "4.0.8",
"resolved": "https://registry.npmjs.org/lodash.debounce/-/lodash.debounce-4.0.8.tgz",
@@ -9473,17 +9184,6 @@
"dev": true,
"license": "ISC"
},
"node_modules/lz-string": {
"version": "1.5.0",
"resolved": "https://registry.npmjs.org/lz-string/-/lz-string-1.5.0.tgz",
"integrity": "sha512-h5bgJWpxJNswbU7qCrV0tIKQCaS3blPDrqKWx+QxzuzL1zGUzij9XCWLrSLsJPu5t+eWA/ycetzYAO5IOMcWAQ==",
"dev": true,
"license": "MIT",
"peer": true,
"bin": {
"lz-string": "bin/bin.js"
}
},
"node_modules/magic-string": {
"version": "0.25.9",
"resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.25.9.tgz",
@@ -9717,6 +9417,7 @@
"version": "2.6.2",
"resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz",
"integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==",
"dev": true,
"license": "MIT"
},
"node_modules/next": {
@@ -10550,7 +10251,7 @@
"version": "1.55.1",
"resolved": "https://registry.npmjs.org/playwright/-/playwright-1.55.1.tgz",
"integrity": "sha512-cJW4Xd/G3v5ovXtJJ52MAOclqeac9S/aGGgRzLabuF8TnIb6xHvMzKIa6JmrRzUkeXJgfL1MhukP0NK6l39h3A==",
"devOptional": true,
"dev": true,
"license": "Apache-2.0",
"dependencies": {
"playwright-core": "1.55.1"
@@ -10569,7 +10270,7 @@
"version": "1.55.1",
"resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.55.1.tgz",
"integrity": "sha512-Z6Mh9mkwX+zxSlHqdr5AOcJnfp+xUWLCt9uKV18fhzA8eyxUd8NUWzAjxUh55RZKSYwDGX0cfaySdhZJGMoJ+w==",
"devOptional": true,
"dev": true,
"license": "Apache-2.0",
"bin": {
"playwright-core": "cli.js"
@@ -10734,55 +10435,6 @@
"url": "https://github.com/sponsors/sindresorhus"
}
},
"node_modules/pretty-format": {
"version": "27.5.1",
"resolved": "https://registry.npmjs.org/pretty-format/-/pretty-format-27.5.1.tgz",
"integrity": "sha512-Qb1gy5OrP5+zDf2Bvnzdl3jsTf1qXVMazbvCoKhtKqVs4/YK4ozX4gKQJJVyNe+cajNPn0KoC0MC3FUmaHWEmQ==",
"dev": true,
"license": "MIT",
"peer": true,
"dependencies": {
"ansi-regex": "^5.0.1",
"ansi-styles": "^5.0.0",
"react-is": "^17.0.1"
},
"engines": {
"node": "^10.13.0 || ^12.13.0 || ^14.15.0 || >=15.0.0"
}
},
"node_modules/pretty-format/node_modules/ansi-regex": {
"version": "5.0.1",
"resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
"integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
"dev": true,
"license": "MIT",
"peer": true,
"engines": {
"node": ">=8"
}
},
"node_modules/pretty-format/node_modules/ansi-styles": {
"version": "5.2.0",
"resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz",
"integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==",
"dev": true,
"license": "MIT",
"peer": true,
"engines": {
"node": ">=10"
},
"funding": {
"url": "https://github.com/chalk/ansi-styles?sponsor=1"
}
},
"node_modules/pretty-format/node_modules/react-is": {
"version": "17.0.2",
"resolved": "https://registry.npmjs.org/react-is/-/react-is-17.0.2.tgz",
"integrity": "sha512-w2GsyukL62IJnlaff/nRegPQR94C/XXamvMWmSHRJ4y7Ts/4ocGRmTHvOs8PSE6pB3dWOrD/nueuU5sduBsQ4w==",
"dev": true,
"license": "MIT",
"peer": true
},
"node_modules/prop-types": {
"version": "15.8.1",
"resolved": "https://registry.npmjs.org/prop-types/-/prop-types-15.8.1.tgz",
@@ -12314,20 +11966,6 @@
}
}
},
"node_modules/tapable": {
"version": "2.2.3",
"resolved": "https://registry.npmjs.org/tapable/-/tapable-2.2.3.tgz",
"integrity": "sha512-ZL6DDuAlRlLGghwcfmSn9sK3Hr6ArtyudlSAiCqQ6IfE+b+HHbydbYDIG15IfS5do+7XQQBdBiubF/cV2dnDzg==",
"license": "MIT",
"peer": true,
"engines": {
"node": ">=6"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/webpack"
}
},
"node_modules/temp-dir": {
"version": "2.0.0",
"resolved": "https://registry.npmjs.org/temp-dir/-/temp-dir-2.0.0.tgz",
@@ -13085,20 +12723,6 @@
"makeerror": "1.0.12"
}
},
"node_modules/watchpack": {
"version": "2.4.4",
"resolved": "https://registry.npmjs.org/watchpack/-/watchpack-2.4.4.tgz",
"integrity": "sha512-c5EGNOiyxxV5qmTtAB7rbiXxi1ooX1pQKMLX/MIabJjRA0SJBQOjKF+KSVfHkr9U1cADPon0mRiVe/riyaiDUA==",
"license": "MIT",
"peer": true,
"dependencies": {
"glob-to-regexp": "^0.4.1",
"graceful-fs": "^4.1.2"
},
"engines": {
"node": ">=10.13.0"
}
},
"node_modules/web-vitals": {
"version": "5.1.0",
"resolved": "https://registry.npmjs.org/web-vitals/-/web-vitals-5.1.0.tgz",
@@ -13111,122 +12735,6 @@
"integrity": "sha512-YQ+BmxuTgd6UXZW3+ICGfyqRyHXVlD5GtQr5+qjiNW7bF0cqrzX500HVXPBOvgXb5YnzDd+h0zqyv61KUD7+Sg==",
"license": "BSD-2-Clause"
},
"node_modules/webpack": {
"version": "5.102.0",
"resolved": "https://registry.npmjs.org/webpack/-/webpack-5.102.0.tgz",
"integrity": "sha512-hUtqAR3ZLVEYDEABdBioQCIqSoguHbFn1K7WlPPWSuXmx0031BD73PSE35jKyftdSh4YLDoQNgK4pqBt5Q82MA==",
"license": "MIT",
"peer": true,
"dependencies": {
"@types/eslint-scope": "^3.7.7",
"@types/estree": "^1.0.8",
"@types/json-schema": "^7.0.15",
"@webassemblyjs/ast": "^1.14.1",
"@webassemblyjs/wasm-edit": "^1.14.1",
"@webassemblyjs/wasm-parser": "^1.14.1",
"acorn": "^8.15.0",
"acorn-import-phases": "^1.0.3",
"browserslist": "^4.24.5",
"chrome-trace-event": "^1.0.2",
"enhanced-resolve": "^5.17.3",
"es-module-lexer": "^1.2.1",
"eslint-scope": "5.1.1",
"events": "^3.2.0",
"glob-to-regexp": "^0.4.1",
"graceful-fs": "^4.2.11",
"json-parse-even-better-errors": "^2.3.1",
"loader-runner": "^4.2.0",
"mime-types": "^2.1.27",
"neo-async": "^2.6.2",
"schema-utils": "^4.3.2",
"tapable": "^2.2.3",
"terser-webpack-plugin": "^5.3.11",
"watchpack": "^2.4.4",
"webpack-sources": "^3.3.3"
},
"bin": {
"webpack": "bin/webpack.js"
},
"engines": {
"node": ">=10.13.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/webpack"
},
"peerDependenciesMeta": {
"webpack-cli": {
"optional": true
}
}
},
"node_modules/webpack-sources": {
"version": "3.3.3",
"resolved": "https://registry.npmjs.org/webpack-sources/-/webpack-sources-3.3.3.tgz",
"integrity": "sha512-yd1RBzSGanHkitROoPFd6qsrxt+oFhg/129YzheDGqeustzX0vTZJZsSsQjVQC4yzBQ56K55XU8gaNCtIzOnTg==",
"license": "MIT",
"peer": true,
"engines": {
"node": ">=10.13.0"
}
},
"node_modules/webpack/node_modules/ajv": {
"version": "8.17.1",
"resolved": "https://registry.npmjs.org/ajv/-/ajv-8.17.1.tgz",
"integrity": "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==",
"license": "MIT",
"peer": true,
"dependencies": {
"fast-deep-equal": "^3.1.3",
"fast-uri": "^3.0.1",
"json-schema-traverse": "^1.0.0",
"require-from-string": "^2.0.2"
},
"funding": {
"type": "github",
"url": "https://github.com/sponsors/epoberezkin"
}
},
"node_modules/webpack/node_modules/ajv-keywords": {
"version": "5.1.0",
"resolved": "https://registry.npmjs.org/ajv-keywords/-/ajv-keywords-5.1.0.tgz",
"integrity": "sha512-YCS/JNFAUyr5vAuhk1DWm1CBxRHW9LbJ2ozWeemrIqpbsqKjHVxYPyi5GC0rjZIT5JxJ3virVTS8wk4i/Z+krw==",
"license": "MIT",
"peer": true,
"dependencies": {
"fast-deep-equal": "^3.1.3"
},
"peerDependencies": {
"ajv": "^8.8.2"
}
},
"node_modules/webpack/node_modules/json-schema-traverse": {
"version": "1.0.0",
"resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
"integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
"license": "MIT",
"peer": true
},
"node_modules/webpack/node_modules/schema-utils": {
"version": "4.3.2",
"resolved": "https://registry.npmjs.org/schema-utils/-/schema-utils-4.3.2.tgz",
"integrity": "sha512-Gn/JaSk/Mt9gYubxTtSn/QCV4em9mpAPiR1rqy/Ocu19u/G9J5WWdNoUT4SiV6mFC3y6cxyFcFwdzPM3FgxGAQ==",
"license": "MIT",
"peer": true,
"dependencies": {
"@types/json-schema": "^7.0.9",
"ajv": "^8.9.0",
"ajv-formats": "^2.1.1",
"ajv-keywords": "^5.1.0"
},
"engines": {
"node": ">= 10.13.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/webpack"
}
},
"node_modules/whatwg-encoding": {
"version": "3.1.1",
"resolved": "https://registry.npmjs.org/whatwg-encoding/-/whatwg-encoding-3.1.1.tgz",

View File

@@ -21,11 +21,13 @@
"@mui/icons-material": "^5.18.0",
"@mui/material": "^5.18.0",
"@mui/material-nextjs": "^7.3.2",
"@redux-offline/redux-offline": "^2.6.0",
"@reduxjs/toolkit": "^2.9.0",
"@tanstack/react-query": "^5.90.2",
"axios": "^1.12.2",
"date-fns": "^4.1.0",
"framer-motion": "^11.18.2",
"localforage": "^1.10.0",
"next": "14.2.0",
"next-pwa": "^5.6.0",
"react": "^18",

View File

@@ -0,0 +1,286 @@
# Offline-First Redux Architecture
This directory contains the offline-first Redux store implementation for the Maternal App.
## Architecture Overview
The store is built with:
- **Redux Toolkit** - Modern Redux with less boilerplate
- **@redux-offline/redux-offline** - Offline-first middleware
- **redux-persist** - State persistence to IndexedDB
- **Entity Adapters** - Normalized state management
## Key Features
### 1. Normalized State
All entities (activities, children) are stored in a normalized format with `byId` and `allIds` structures for optimal performance and consistency.
### 2. Optimistic Updates
Actions are immediately applied to the UI, then synced with the server:
```typescript
// Component usage
const dispatch = useAppDispatch();
// Optimistic create - UI updates immediately
dispatch(optimisticCreate(newActivity));
// Actual API call - syncs with server
dispatch(createActivity(newActivity));
```
### 3. Offline Queue
When offline, mutations are queued and automatically synced when connection is restored:
- Automatic exponential backoff retry (1s, 2s, 4s, 8s, 16s)
- Discard after 5 retries or on 4xx errors
- Persisted to IndexedDB
### 4. Conflict Resolution
Multiple strategies available:
- `SERVER_WINS` - Server data takes precedence
- `CLIENT_WINS` - Local data takes precedence
- `LAST_WRITE_WINS` - Compare timestamps (default)
- `MERGE` - Merge local and server data
### 5. Network Detection
- Browser online/offline events
- Periodic server connectivity checks (every 30s)
- Latency-based connection quality (`excellent`, `good`, `poor`, `offline`)
## Directory Structure
```
store/
├── store.ts # Main store configuration
├── hooks.ts # Custom Redux hooks
├── slices/ # Redux slices
│ ├── activitiesSlice.ts # Activities with normalized state
│ ├── childrenSlice.ts # Children with normalized state
│ ├── networkSlice.ts # Network status
│ └── offlineSlice.ts # Offline sync queue
└── middleware/ # Custom middleware
├── offlineMiddleware.ts # Offline action queuing
└── syncMiddleware.ts # Sync and conflict resolution
```
## Usage Examples
### Basic Component Usage
```typescript
import { useAppDispatch, useAppSelector, useIsOnline } from '@/store/hooks';
import { createActivity, optimisticCreate } from '@/store/slices/activitiesSlice';
function TrackingComponent() {
const dispatch = useAppDispatch();
const isOnline = useIsOnline();
const activities = useAppSelector(activitiesSelectors.selectAll);
const handleAddActivity = async (activity) => {
// 1. Optimistic update (immediate UI feedback)
const localId = `temp_${Date.now()}`;
dispatch(optimisticCreate({ ...activity, id: localId }));
// 2. Actual API call (will be queued if offline)
try {
await dispatch(createActivity(activity));
} catch (error) {
// Rollback handled automatically
console.error('Failed to create activity:', error);
}
};
return (
<div>
{!isOnline && <p>You are offline. Changes will sync when you reconnect.</p>}
{/* ... */}
</div>
);
}
```
### Using Custom Hooks
```typescript
import { useOptimisticAction, useSyncStatus, useHasPendingSync } from '@/store/hooks';
function MyComponent() {
// Check sync status
const { syncing, pendingCount, lastSync } = useSyncStatus();
const hasPending = useHasPendingSync();
// Optimistic action hook (combines optimistic + actual)
const handleCreate = useOptimisticAction(
optimisticCreate,
createActivity
);
return (
<div>
{syncing && <p>Syncing {pendingCount} changes...</p>}
<button onClick={() => handleCreate(newActivity)}>
Add Activity
</button>
</div>
);
}
```
### Network Status Indicator
```typescript
import { NetworkStatusIndicator, NetworkStatusBadge } from '@/components/common/NetworkStatusIndicator';
function AppLayout() {
return (
<>
<NetworkStatusIndicator /> {/* Snackbar at top */}
<AppBar>
<NetworkStatusBadge /> {/* Small badge in app bar */}
</AppBar>
</>
);
}
```
### Checking if Entity is Optimistic
```typescript
import { useIsOptimistic } from '@/store/hooks';
function ActivityCard({ activityId }) {
const isOptimistic = useIsOptimistic('activities', activityId);
return (
<Card>
{isOptimistic && (
<Chip label="Syncing..." size="small" />
)}
{/* ... */}
</Card>
);
}
```
## State Shape
```typescript
{
activities: {
ids: ['act_1', 'act_2', 'temp_123'],
entities: {
'act_1': {
id: 'act_1',
childId: 'child_1',
type: 'feeding',
timestamp: '2025-10-01T12:00:00Z',
data: { amount: 120, unit: 'ml' },
_optimistic: false,
_version: 1
},
'temp_123': {
id: 'temp_123',
childId: 'child_1',
type: 'sleep',
timestamp: '2025-10-01T14:00:00Z',
data: { duration: 90 },
_optimistic: true, // Not yet synced
_localId: 'temp_123',
_version: 1
}
},
loading: false,
error: null,
syncStatus: 'synced',
lastSyncTime: '2025-10-01T14:05:00Z'
},
children: { /* similar structure */ },
network: {
isOnline: true,
isConnected: true,
lastOnlineTime: '2025-10-01T14:00:00Z',
connectionQuality: 'excellent',
latency: 45
},
offline: {
isOnline: true,
pendingActions: [],
lastSyncTime: '2025-10-01T14:05:00Z',
syncInProgress: false
}
}
```
## Metadata Fields
All entities have optional metadata fields for offline support:
- `_optimistic` (boolean) - True if not yet synced with server
- `_localId` (string) - Temporary ID before server assigns real ID
- `_version` (number) - Version counter for conflict detection
## Best Practices
1. **Always use optimistic updates** for write operations (create, update, delete)
2. **Use entity selectors** instead of accessing state directly
3. **Handle offline state** in your UI
4. **Show sync indicators** to users
5. **Test offline scenarios** thoroughly
6. **Use normalized state** for related entities
7. **Implement proper error handling** and rollback logic
## Testing Offline Behavior
### In Chrome DevTools:
1. Open DevTools → Network tab
2. Change "Online" dropdown to "Offline"
3. Try creating/updating activities
4. Go back "Online"
5. Watch automatic sync happen
### Programmatically:
```typescript
// Simulate offline
dispatch(setOnlineStatus(false));
// Simulate online
dispatch(setOnlineStatus(true));
```
## Performance Considerations
- **IndexedDB** used for persistence (faster than localStorage)
- **Entity adapters** provide memoized selectors
- **Normalized state** prevents duplication
- **Selective persistence** (blacklist for sensitive data)
- **Batched updates** when syncing multiple actions
## Security Notes
- Sensitive data can be excluded from persistence using `persistOptions.blacklist`
- Auth tokens should NOT be stored in Redux (use secure cookie or AuthContext)
- Offline queue is cleared on logout
- All API calls still require valid authentication
## Troubleshooting
### Actions not being queued
- Check if action type includes '/create', '/update', or '/delete'
- Ensure `meta.requestId` exists on the action
### Sync not happening
- Check browser console for network errors
- Verify API endpoints are correct
- Check if `isOnline` state is accurate
### State not persisting
- Check browser IndexedDB (DevTools → Application → IndexedDB)
- Verify localforage is configured correctly
- Check for storage quota issues
## Future Enhancements
- [ ] Batch sync for multiple actions
- [ ] Conflict UI for user resolution
- [ ] Sync progress indicators
- [ ] Selective sync (by entity type)
- [ ] Background sync (Service Workers)
- [ ] Delta sync (only changed fields)

View File

@@ -0,0 +1,93 @@
import { useDispatch, useSelector, TypedUseSelectorHook } from 'react-redux';
import type { RootState, AppDispatch } from './store';
import { useCallback } from 'react';
// Use throughout your app instead of plain `useDispatch` and `useSelector`
export const useAppDispatch = () => useDispatch<AppDispatch>();
export const useAppSelector: TypedUseSelectorHook<RootState> = useSelector;
// Custom hooks for common patterns
/**
* Hook to check if the app is online
*/
export const useIsOnline = () => {
return useAppSelector((state) => state.network?.isOnline ?? true);
};
/**
* Hook to check if there are pending sync actions
*/
export const useHasPendingSync = () => {
const pendingActions = useAppSelector((state) => state.offline?.pendingActions ?? []);
return pendingActions.length > 0;
};
/**
* Hook to get sync status
*/
export const useSyncStatus = () => {
const syncInProgress = useAppSelector((state) => state.offline?.syncInProgress ?? false);
const lastSyncTime = useAppSelector((state) => state.offline?.lastSyncTime);
const pendingCount = useAppSelector((state) => state.offline?.pendingActions?.length ?? 0);
return {
syncing: syncInProgress,
lastSync: lastSyncTime,
pendingCount,
};
};
/**
* Hook for optimistic updates
* Provides a function that dispatches both optimistic and actual actions
*/
export const useOptimisticAction = <T extends any[], R>(
optimisticAction: (...args: T) => any,
actualAction: (...args: T) => any
) => {
const dispatch = useAppDispatch();
const isOnline = useIsOnline();
return useCallback(
async (...args: T) => {
// Always dispatch optimistic action for immediate UI update
dispatch(optimisticAction(...args));
// If online, dispatch actual action
if (isOnline) {
try {
const result = await dispatch(actualAction(...args));
return result;
} catch (error) {
// Rollback will be handled by the rejected case in the slice
throw error;
}
}
// If offline, the action will be queued by the middleware
return Promise.resolve();
},
[dispatch, optimisticAction, actualAction, isOnline]
);
};
/**
* Hook to get network quality information
*/
export const useNetworkQuality = () => {
const quality = useAppSelector((state) => state.network?.connectionQuality ?? 'excellent');
const latency = useAppSelector((state) => state.network?.latency);
return { quality, latency };
};
/**
* Hook to check if a specific entity is being optimistically updated
*/
export const useIsOptimistic = (entityType: 'activities' | 'children', id: string) => {
return useAppSelector((state) => {
const entity = state[entityType]?.entities?.[id];
return entity?._optimistic ?? false;
});
};

View File

@@ -0,0 +1,92 @@
import { Middleware } from '@reduxjs/toolkit';
import { RootState } from '../store';
import { setOnlineStatus } from '../slices/networkSlice';
import { addPendingAction, removePendingAction, incrementRetryCount } from '../slices/offlineSlice';
/**
* Offline middleware - intercepts actions and queues them when offline
*/
export const offlineMiddleware: Middleware<{}, RootState> = (store) => (next) => (action: any) => {
const state = store.getState();
const isOnline = state.network?.isOnline ?? true;
// Check if this is an async action that should be queued
const isOfflineableAction =
action.type?.includes('/create') ||
action.type?.includes('/update') ||
action.type?.includes('/delete');
// If offline and action should be queued
if (!isOnline && isOfflineableAction && action.meta?.requestId) {
console.log('[Offline Middleware] Queuing action:', action.type);
// Queue the action
store.dispatch(
addPendingAction({
type: action.type,
payload: action.payload,
})
);
// Still process the optimistic update
return next(action);
}
// If online, process normally
return next(action);
};
/**
* Network status detector - listens for online/offline events
*/
export const setupNetworkDetection = (dispatch: any) => {
if (typeof window === 'undefined') return;
const handleOnline = () => {
console.log('[Network] Connection restored');
dispatch(setOnlineStatus(true));
};
const handleOffline = () => {
console.log('[Network] Connection lost');
dispatch(setOnlineStatus(false));
};
// Listen to browser online/offline events
window.addEventListener('online', handleOnline);
window.addEventListener('offline', handleOffline);
// Periodic connectivity check
const checkConnectivity = async () => {
try {
const startTime = Date.now();
const response = await fetch('/api/health', {
method: 'HEAD',
cache: 'no-cache',
});
const latency = Date.now() - startTime;
if (response.ok) {
dispatch(setOnlineStatus(true));
// You could also dispatch latency here
} else {
dispatch(setOnlineStatus(false));
}
} catch (error) {
dispatch(setOnlineStatus(false));
}
};
// Check connectivity every 30 seconds
const intervalId = setInterval(checkConnectivity, 30000);
// Initial check
checkConnectivity();
// Cleanup function
return () => {
window.removeEventListener('online', handleOnline);
window.removeEventListener('offline', handleOffline);
clearInterval(intervalId);
};
};

View File

@@ -0,0 +1,129 @@
import { Middleware } from '@reduxjs/toolkit';
import { RootState } from '../store';
import { removePendingAction, incrementRetryCount, setSyncInProgress, updateLastSyncTime } from '../slices/offlineSlice';
import { setOnlineStatus } from '../slices/networkSlice';
/**
* Sync middleware - processes pending actions when coming back online
*/
export const syncMiddleware: Middleware<{}, RootState> = (store) => (next) => (action: any) => {
// Check if we just came back online
if (action.type === 'network/setOnlineStatus' && action.payload === true) {
const state = store.getState();
const pendingActions = state.offline?.pendingActions || [];
if (pendingActions.length > 0) {
console.log(`[Sync] Processing ${pendingActions.length} pending actions`);
store.dispatch(setSyncInProgress(true));
// Process pending actions sequentially
processPendingActions(store, pendingActions);
}
}
return next(action);
};
/**
* Process pending actions with retry logic
*/
async function processPendingActions(store: any, pendingActions: any[]) {
const MAX_RETRIES = 5;
for (const pendingAction of pendingActions) {
try {
console.log(`[Sync] Processing action: ${pendingAction.type}`, pendingAction);
// Reconstruct the action
const action = {
type: pendingAction.type,
payload: pendingAction.payload,
};
// Dispatch the action (which will make the API call)
await store.dispatch(action);
// If successful, remove from queue
store.dispatch(removePendingAction(pendingAction.id));
console.log(`[Sync] Successfully synced action: ${pendingAction.type}`);
} catch (error) {
console.error(`[Sync] Failed to sync action: ${pendingAction.type}`, error);
// Increment retry count
store.dispatch(incrementRetryCount(pendingAction.id));
// If max retries reached, remove from queue
if (pendingAction.retryCount >= MAX_RETRIES) {
console.error(`[Sync] Max retries reached for action: ${pendingAction.type}`);
store.dispatch(removePendingAction(pendingAction.id));
}
}
}
// Mark sync as complete
store.dispatch(setSyncInProgress(false));
store.dispatch(updateLastSyncTime());
console.log('[Sync] Sync complete');
}
/**
* Conflict resolution strategies
*/
export enum ConflictStrategy {
SERVER_WINS = 'server_wins',
CLIENT_WINS = 'client_wins',
LAST_WRITE_WINS = 'last_write_wins',
MERGE = 'merge',
}
/**
* Resolve conflicts between local and server data
*/
export function resolveConflict<T extends { _version?: number; updatedAt?: string }>(
localData: T,
serverData: T,
strategy: ConflictStrategy = ConflictStrategy.LAST_WRITE_WINS
): T {
switch (strategy) {
case ConflictStrategy.SERVER_WINS:
return serverData;
case ConflictStrategy.CLIENT_WINS:
return localData;
case ConflictStrategy.LAST_WRITE_WINS:
// Compare timestamps
const localTime = localData.updatedAt ? new Date(localData.updatedAt).getTime() : 0;
const serverTime = serverData.updatedAt ? new Date(serverData.updatedAt).getTime() : 0;
return serverTime > localTime ? serverData : localData;
case ConflictStrategy.MERGE:
// Simple merge strategy - prefer server for system fields, local for user fields
return {
...serverData,
...localData,
// System fields from server
id: serverData.id,
createdAt: serverData.createdAt,
updatedAt: serverData.updatedAt,
// Metadata
_version: Math.max(localData._version || 0, serverData._version || 0) + 1,
};
default:
return serverData;
}
}
/**
* Version-based conflict detection
*/
export function hasConflict<T extends { _version?: number }>(
localData: T,
serverData: T
): boolean {
if (!localData._version || !serverData._version) {
return false;
}
return localData._version !== serverData._version;
}

View File

@@ -0,0 +1,281 @@
import { createSlice, createAsyncThunk, PayloadAction, createEntityAdapter } from '@reduxjs/toolkit';
import { RootState } from '../store';
// Define Activity type
export interface Activity {
id: string;
childId: string;
type: 'feeding' | 'sleep' | 'diaper' | 'medication' | 'milestone' | 'note';
timestamp: string;
data: Record<string, any>;
notes?: string;
createdBy: string;
createdAt: string;
updatedAt: string;
// Offline metadata
_optimistic?: boolean;
_localId?: string;
_version?: number;
}
// Create entity adapter for normalized state
const activitiesAdapter = createEntityAdapter<Activity>({
selectId: (activity) => activity.id,
sortComparer: (a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime(),
});
// Async thunks with offline support
export const createActivity = createAsyncThunk(
'activities/create',
async (activity: Omit<Activity, 'id' | 'createdAt' | 'updatedAt'>, { rejectWithValue }) => {
try {
const response = await fetch('/api/v1/activities', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(activity),
});
if (!response.ok) {
throw new Error('Failed to create activity');
}
return await response.json();
} catch (error: any) {
return rejectWithValue(error.message);
}
}
);
export const fetchActivities = createAsyncThunk(
'activities/fetch',
async ({ childId, startDate, endDate }: { childId: string; startDate?: string; endDate?: string }) => {
const params = new URLSearchParams({
childId,
...(startDate && { startDate }),
...(endDate && { endDate }),
});
const response = await fetch(`/api/v1/activities?${params}`);
if (!response.ok) {
throw new Error('Failed to fetch activities');
}
const data = await response.json();
return data.data;
}
);
export const updateActivity = createAsyncThunk(
'activities/update',
async ({ id, updates }: { id: string; updates: Partial<Activity> }, { rejectWithValue }) => {
try {
const response = await fetch(`/api/v1/activities/${id}`, {
method: 'PATCH',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(updates),
});
if (!response.ok) {
throw new Error('Failed to update activity');
}
return await response.json();
} catch (error: any) {
return rejectWithValue(error.message);
}
}
);
export const deleteActivity = createAsyncThunk(
'activities/delete',
async (id: string, { rejectWithValue }) => {
try {
const response = await fetch(`/api/v1/activities/${id}`, {
method: 'DELETE',
});
if (!response.ok) {
throw new Error('Failed to delete activity');
}
return id;
} catch (error: any) {
return rejectWithValue(error.message);
}
}
);
const activitiesSlice = createSlice({
name: 'activities',
initialState: activitiesAdapter.getInitialState({
loading: false,
error: null as string | null,
syncStatus: 'idle' as 'idle' | 'syncing' | 'synced' | 'error',
lastSyncTime: null as string | null,
}),
reducers: {
// Optimistic create - immediately add to local state
optimisticCreate: (state, action: PayloadAction<Activity>) => {
const optimisticActivity = {
...action.payload,
_optimistic: true,
_localId: action.payload.id,
_version: 1,
};
activitiesAdapter.addOne(state, optimisticActivity);
},
// Optimistic update
optimisticUpdate: (state, action: PayloadAction<{ id: string; changes: Partial<Activity> }>) => {
const { id, changes } = action.payload;
const existing = state.entities[id];
if (existing) {
activitiesAdapter.updateOne(state, {
id,
changes: {
...changes,
_optimistic: true,
_version: (existing._version || 0) + 1,
},
});
}
},
// Optimistic delete
optimisticDelete: (state, action: PayloadAction<string>) => {
activitiesAdapter.removeOne(state, action.payload);
},
// Rollback optimistic action
rollbackOptimistic: (state, action: PayloadAction<string>) => {
// Remove optimistic entry or restore previous version
const activity = state.entities[action.payload];
if (activity?._optimistic) {
activitiesAdapter.removeOne(state, action.payload);
}
},
// Clear all activities (for logout)
clearActivities: (state) => {
activitiesAdapter.removeAll(state);
state.error = null;
state.lastSyncTime = null;
},
// Mark activity as synced
markSynced: (state, action: PayloadAction<{ localId: string; serverId: string; serverData: Activity }>) => {
const { localId, serverId, serverData } = action.payload;
// Remove optimistic entry
activitiesAdapter.removeOne(state, localId);
// Add server version
activitiesAdapter.addOne(state, {
...serverData,
_optimistic: false,
});
},
},
extraReducers: (builder) => {
builder
// Create activity
.addCase(createActivity.pending, (state) => {
state.loading = true;
state.error = null;
})
.addCase(createActivity.fulfilled, (state, action) => {
state.loading = false;
const serverActivity = action.payload.data;
// Replace optimistic entry with server data
const optimisticId = action.meta.arg.id || action.meta.requestId;
if (state.entities[optimisticId]?._optimistic) {
activitiesAdapter.removeOne(state, optimisticId);
}
activitiesAdapter.addOne(state, {
...serverActivity,
_optimistic: false,
});
})
.addCase(createActivity.rejected, (state, action) => {
state.loading = false;
state.error = action.payload as string;
// Rollback optimistic entry
const optimisticId = action.meta.arg.id || action.meta.requestId;
if (state.entities[optimisticId]?._optimistic) {
activitiesAdapter.removeOne(state, optimisticId);
}
})
// Fetch activities
.addCase(fetchActivities.pending, (state) => {
state.loading = true;
state.syncStatus = 'syncing';
})
.addCase(fetchActivities.fulfilled, (state, action) => {
state.loading = false;
state.syncStatus = 'synced';
state.lastSyncTime = new Date().toISOString();
// Merge server data with local optimistic entries
const serverActivities = action.payload.map((a: Activity) => ({
...a,
_optimistic: false,
}));
activitiesAdapter.upsertMany(state, serverActivities);
})
.addCase(fetchActivities.rejected, (state, action) => {
state.loading = false;
state.syncStatus = 'error';
state.error = action.error.message || 'Failed to fetch activities';
})
// Update activity
.addCase(updateActivity.fulfilled, (state, action) => {
const serverActivity = action.payload.data;
activitiesAdapter.updateOne(state, {
id: serverActivity.id,
changes: {
...serverActivity,
_optimistic: false,
},
});
})
.addCase(updateActivity.rejected, (state, action) => {
state.error = action.payload as string;
// Rollback optimistic update
const id = action.meta.arg.id;
if (state.entities[id]?._optimistic) {
// TODO: Restore previous version from history
}
})
// Delete activity
.addCase(deleteActivity.fulfilled, (state, action) => {
activitiesAdapter.removeOne(state, action.payload);
})
.addCase(deleteActivity.rejected, (state, action) => {
state.error = action.payload as string;
});
},
});
export const {
optimisticCreate,
optimisticUpdate,
optimisticDelete,
rollbackOptimistic,
clearActivities,
markSynced,
} = activitiesSlice.actions;
// Export selectors
export const activitiesSelectors = activitiesAdapter.getSelectors<RootState>(
(state) => state.activities
);
// Custom selectors
export const selectActivitiesByChild = (state: RootState, childId: string) =>
activitiesSelectors
.selectAll(state)
.filter((activity) => activity.childId === childId);
export const selectPendingActivities = (state: RootState) =>
activitiesSelectors
.selectAll(state)
.filter((activity) => activity._optimistic);
export const selectActivitiesByType = (state: RootState, type: Activity['type']) =>
activitiesSelectors
.selectAll(state)
.filter((activity) => activity.type === type);
export default activitiesSlice.reducer;

View File

@@ -0,0 +1,229 @@
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;

View File

@@ -0,0 +1,64 @@
import { createSlice, PayloadAction } from '@reduxjs/toolkit';
interface NetworkState {
isOnline: boolean;
isConnected: boolean; // API server reachability
lastOnlineTime: string | null;
lastOfflineTime: string | null;
connectionQuality: 'excellent' | 'good' | 'poor' | 'offline';
latency: number | null;
}
const initialState: NetworkState = {
isOnline: typeof navigator !== 'undefined' ? navigator.onLine : true,
isConnected: true,
lastOnlineTime: null,
lastOfflineTime: null,
connectionQuality: 'excellent',
latency: null,
};
const networkSlice = createSlice({
name: 'network',
initialState,
reducers: {
setOnlineStatus: (state, action: PayloadAction<boolean>) => {
const wasOnline = state.isOnline;
state.isOnline = action.payload;
if (action.payload && !wasOnline) {
// Just came online
state.lastOnlineTime = new Date().toISOString();
} else if (!action.payload && wasOnline) {
// Just went offline
state.lastOfflineTime = new Date().toISOString();
}
},
setServerConnection: (state, action: PayloadAction<boolean>) => {
state.isConnected = action.payload;
},
setConnectionQuality: (state, action: PayloadAction<NetworkState['connectionQuality']>) => {
state.connectionQuality = action.payload;
},
setLatency: (state, action: PayloadAction<number>) => {
state.latency = action.payload;
// Update connection quality based on latency
if (action.payload < 100) {
state.connectionQuality = 'excellent';
} else if (action.payload < 300) {
state.connectionQuality = 'good';
} else {
state.connectionQuality = 'poor';
}
},
},
});
export const {
setOnlineStatus,
setServerConnection,
setConnectionQuality,
setLatency,
} = networkSlice.actions;
export default networkSlice.reducer;

104
maternal-web/store/store.ts Normal file
View File

@@ -0,0 +1,104 @@
import { configureStore, Middleware } from '@reduxjs/toolkit';
import { offline } from '@redux-offline/redux-offline';
import offlineConfig from '@redux-offline/redux-offline/lib/defaults';
import localforage from 'localforage';
// Slices
import offlineReducer from './slices/offlineSlice';
import activitiesReducer from './slices/activitiesSlice';
import childrenReducer from './slices/childrenSlice';
import networkReducer from './slices/networkSlice';
// Middleware
import { offlineMiddleware } from './middleware/offlineMiddleware';
import { syncMiddleware } from './middleware/syncMiddleware';
// Configure localforage for IndexedDB storage
localforage.config({
name: 'maternal-app',
storeName: 'offline_data',
driver: [localforage.INDEXEDDB, localforage.LOCALSTORAGE],
});
// Custom offline configuration
const customOfflineConfig = {
...offlineConfig,
persistOptions: {
blacklist: ['_persist'], // Don't persist the persist state
},
// Effect function - how to execute side effects
effect: async (effect: any, action: any) => {
const { url, method = 'GET', body, headers = {} } = effect;
try {
const response = await fetch(url, {
method,
body: body ? JSON.stringify(body) : undefined,
headers: {
'Content-Type': 'application/json',
...headers,
},
});
if (!response.ok) {
throw new Error(`HTTP ${response.status}: ${response.statusText}`);
}
return await response.json();
} catch (error) {
throw error;
}
},
// Discard function - when to discard failed actions
discard: (error: any, action: any, retries: number) => {
// Discard after 5 retries or if it's a 4xx error
const is4xxError = error.message?.includes('HTTP 4');
return retries >= 5 || is4xxError;
},
// Retry function - calculate retry delay with exponential backoff
retry: (action: any, retries: number) => {
// Exponential backoff: 1s, 2s, 4s, 8s, 16s
return Math.min(1000 * Math.pow(2, retries), 16000);
},
persistCallback: () => {
console.log('[Redux Offline] State persisted to storage');
},
persistAutoRehydrate: true,
};
export const store = configureStore({
reducer: {
offline: offlineReducer,
activities: activitiesReducer,
children: childrenReducer,
network: networkReducer,
},
middleware: (getDefaultMiddleware) =>
getDefaultMiddleware({
serializableCheck: {
// Ignore these action types for serialization check
ignoredActions: ['persist/PERSIST', 'persist/REHYDRATE'],
// Ignore these field paths in all actions
ignoredActionPaths: ['meta.arg', 'payload.timestamp'],
// Ignore these paths in the state
ignoredPaths: ['items.dates'],
},
}).concat(
offlineMiddleware as Middleware,
syncMiddleware as Middleware,
// Add redux-offline middleware
offline(customOfflineConfig).middleware as Middleware
),
enhancers: (getDefaultEnhancers) =>
getDefaultEnhancers().concat(
// Add redux-offline enhancer
offline(customOfflineConfig).enhancer
),
});
// Infer the `RootState` and `AppDispatch` types from the store itself
export type RootState = ReturnType<typeof store.getState>;
export type AppDispatch = typeof store.dispatch;
// Export store instance
export default store;