/** * @file quoteAutomat.js * @description Manages cached and chunk-paginated company sales quotes (Angebote) (`GET /api/quote`). * * Implements a multi-filter chunk cache: * - Each filter combination has its own isolated cache entry (total, items array, loadedChunks). * - Total chunk capacity across all filter combinations is bounded by a global LRU limit of 50 chunks. * - When filter settings change, previously loaded chunks remain cached in memory up to the 50-chunk limit. * - Switching back to a previously used filter is instant with zero network requests if its chunks are in RAM. * - Real-time stats and events can be observed via `subscribeChunkStats` or the dev ChunkCacheMonitor. * * Upstream Triggers: * - `authAutomat`: Triggers `actions.reset()` on `'anon'` or when `selectedCompanyId` changes. * - UI / Routes: Calls `getItems()`, `requireChunk(chunkIndex)`, `loadChunk(chunkIndex)`, or `reload()`. */ import { Automat } from 'react-automat'; import { quote as quoteApi } from '../api'; import authAutomat from './authAutomat'; /** * @typedef {Object} QuoteLine * @property {number} id * @property {string|null} sku * @property {string|null} name * @property {number} pu * @property {number} amount * @property {number} net * @property {number} rebate * @property {number} taxrate * @property {string|null} comment */ /** * @typedef {Object} Quote * @property {number} id Quote id. * @property {string} number Quote number. * @property {'quote'} type Always `'quote'`. * @property {number|null} entityId Customer id. * @property {string|null} customerName Customer first and last name. * @property {string|null} externalNumber External reference. * @property {string} date Expiry/offer date (ISO). * @property {string} createdAt Creation timestamp (ISO). * @property {number} [positions] Pre-computed line item count. * @property {number} [grossTotal] Pre-computed gross sum. * @property {number} [totalQuantity] Pre-computed sum of line amounts. * @property {QuoteLine[]} [lines] Quote line items. */ /** * @typedef {Object} QuoteAutomatState * @property {Quote[]|null} items Pre-filled array of quotes/nulls, initially null. * @property {number} total Total unpaged count for pagination calculation. * @property {number} unfilteredTotal Unfiltered total count. * @property {string} filter Search term. * @property {number} seekMonths Seek month count. * @property {number} seekYears Seek year count. * @property {number} negativeSeekMonths Negative seek months offset. * @property {'idle'|'loading'|'ready'|'failed'} status Load lifecycle state. * @property {Error|string|null} error Last load error. */ export const CHUNK_SIZE = 50; export const MAX_LRU_CHUNKS = 50; const PREFETCH_CHUNKS = 1; const CHUNK_DEBOUNCE_MS = 130; const initialState = { items: null, total: 0, unfilteredTotal: 0, filter: '', seekMonths: 0, seekYears: 0, negativeSeekMonths: 0, status: 'idle', error: null, }; let automat; let queryEpoch = 0; let filterDebounceTimer = null; let chunkDebounceTimer = null; let currentEventTick = 0; let lastRequireChunkTick = -1; const pendingTargetChunks = new Set(); let pendingChunkPromise = null; let pendingChunkResolve = null; let pendingChunkReject = null; // Multi-Filter Cache & Global LRU Management const filterCaches = new Map(); const lruChunks = new Map(); const inflightChunks = new Map(); // Dev / Observability: Chunk event history and subscriber registry const MAX_CHUNK_EVENTS = 150; let nextEventId = 0; const chunkEvents = []; const chunkStatsListeners = new Set(); export function makeLruKey(filterKey, chunkIndex) { return `${filterKey}:::${chunkIndex}`; } export function parseLruKey(key) { const [filterKey, chunkStr] = key.split(':::'); return { filterKey, chunkIndex: Number(chunkStr) }; } // MARK: pure filter helpers export function getFilterParams(state = automat?.state || initialState) { const filter = String(state.filter ?? '').trim(); const negativeSeekMonths = (state.negativeSeekMonths != null && Number(state.negativeSeekMonths) < 0) ? Number(state.negativeSeekMonths) : 0; return { filter, negativeSeekMonths }; } export function getFilterKey(state = automat?.state || initialState) { const { filter, negativeSeekMonths } = getFilterParams(state); return JSON.stringify({ f: filter, s: negativeSeekMonths }); } export function formatFilterLabel(filterKeyOrState) { let f, s; if (typeof filterKeyOrState === 'string') { try { const parsed = JSON.parse(filterKeyOrState); f = parsed.f; s = parsed.s; } catch { return filterKeyOrState; } } else if (filterKeyOrState && typeof filterKeyOrState === 'object') { if ('f' in filterKeyOrState) { f = filterKeyOrState.f; s = filterKeyOrState.s; } else { const params = getFilterParams(filterKeyOrState); f = params.filter; s = params.negativeSeekMonths; } } const parts = []; if (f) parts.push(`Suche: „${f}“`); if (s < 0) parts.push(`Seek: ${formatNegativeSeek(s)}`); if (parts.length === 0) return 'Standard (Alle Angebote)'; return parts.join(' · '); } function countNonNullItems(items) { if (!Array.isArray(items)) return 0; let count = 0; for (let i = 0; i < items.length; i++) { if (items[i] != null) count++; } return count; } function getOrCreateFilterCache(filterKey, filterState = automat?.state || initialState) { let entry = filterCaches.get(filterKey); if (!entry) { const params = getFilterParams(filterState); entry = { key: filterKey, label: formatFilterLabel(params), params, total: 0, unfilteredTotal: automat?.state?.unfilteredTotal || 0, items: null, loadedChunks: new Set(), status: 'idle', error: null, lastAccessed: Date.now(), epoch: queryEpoch, }; filterCaches.set(filterKey, entry); } return entry; } function touchChunkLRU(filterKey, chunkIndex) { const key = makeLruKey(filterKey, chunkIndex); const existing = lruChunks.get(key); if (existing) { lruChunks.delete(key); lruChunks.set(key, { ...existing, accessedAt: Date.now() }); } } function registerChunkLRU(filterKey, chunkIndex, quoteCount = 0) { const key = makeLruKey(filterKey, chunkIndex); if (lruChunks.has(key)) { lruChunks.delete(key); } const now = Date.now(); lruChunks.set(key, { filterKey, chunkIndex, loadedAt: now, accessedAt: now, quoteCount, }); while (lruChunks.size > MAX_LRU_CHUNKS) { const oldestKey = lruChunks.keys().next().value; const oldestInfo = lruChunks.get(oldestKey); lruChunks.delete(oldestKey); if (oldestInfo) { evictChunkFromMemory(oldestInfo.filterKey, oldestInfo.chunkIndex, 'lru'); } } } function evictChunkFromMemory(filterKey, chunkIndex, reason = 'manual') { const entry = filterCaches.get(filterKey); if (!entry) return; if (entry.loadedChunks.has(chunkIndex)) { entry.loadedChunks.delete(chunkIndex); if (Array.isArray(entry.items)) { const offset = chunkIndex * CHUNK_SIZE; for (let i = offset; i < offset + CHUNK_SIZE && i < entry.items.length; i++) { entry.items[i] = null; } } const currentKey = getFilterKey(automat.state); if (filterKey === currentKey) { automat.setState({ items: [...entry.items] }); } const eventType = reason === 'lru' ? 'lru_evict' : 'evict'; const msg = reason === 'lru' ? `LRU-Eviction: Chunk #${chunkIndex} von Filter "${entry.label}" verworfen (${lruChunks.size}/${MAX_LRU_CHUNKS} im Cache)` : `Chunk #${chunkIndex} von Filter "${entry.label}" verworfen`; recordChunkEvent({ type: eventType, chunkIndex, filterKey, message: msg, }); notifyChunkStats(); } } function recordChunkEvent(entry) { const event = { id: ++nextEventId, time: Date.now(), epoch: queryEpoch, filterKey: entry.filterKey ?? getFilterKey(automat?.state), ...entry, }; chunkEvents.push(event); if (chunkEvents.length > MAX_CHUNK_EVENTS) { chunkEvents.shift(); } notifyChunkStats(); } function notifyChunkStats() { if (chunkStatsListeners.size === 0) return; const stats = getChunkStats(); for (const listener of chunkStatsListeners) { try { listener(stats); } catch (e) { console.error('[quoteAutomat] chunkStatsListener error', e); } } } export function getChunkStats() { const currentKey = getFilterKey(automat?.state); const activeEntry = filterCaches.get(currentKey); const total = activeEntry?.total ?? automat?.state?.total ?? 0; const activeLoaded = activeEntry?.loadedChunks ?? new Set(); const chunkCount = total > 0 ? Math.ceil(total / CHUNK_SIZE) : 0; const activeInflight = []; for (const key of inflightChunks.keys()) { const info = parseLruKey(key); if (info.filterKey === currentKey) { activeInflight.push(info.chunkIndex); } } const cachedFiltersSummary = Array.from(filterCaches.values()).map((fc) => ({ key: fc.key, label: fc.label, params: fc.params, total: fc.total, loadedChunksCount: fc.loadedChunks.size, loadedChunks: Array.from(fc.loadedChunks).sort((a, b) => a - b), chunkCount: fc.total > 0 ? Math.ceil(fc.total / CHUNK_SIZE) : 0, loadedItemsCount: countNonNullItems(fc.items), isActive: fc.key === currentKey, lastAccessed: fc.lastAccessed, items: fc.items, status: fc.status, })); const lruEntries = []; let rank = 1; for (const [key, val] of lruChunks.entries()) { const fc = filterCaches.get(val.filterKey); lruEntries.push({ key, filterKey: val.filterKey, filterLabel: fc?.label || val.filterKey, chunkIndex: val.chunkIndex, loadedAt: val.loadedAt, accessedAt: val.accessedAt, quoteCount: val.quoteCount, lruRank: rank++, }); } const items = activeEntry?.items ?? automat?.state?.items ?? null; const loadedItemsCount = countNonNullItems(items); return { chunkSize: CHUNK_SIZE, maxLruChunks: MAX_LRU_CHUNKS, lruChunksCount: lruChunks.size, total, unfilteredTotal: activeEntry?.unfilteredTotal ?? automat?.state?.unfilteredTotal ?? total, chunkCount, loadedChunks: Array.from(activeLoaded).sort((a, b) => a - b), inflightChunks: activeInflight.sort((a, b) => a - b), pendingChunks: Array.from(pendingTargetChunks).sort((a, b) => a - b), loadedItemsCount, status: automat?.state?.status ?? 'idle', queryEpoch, filter: automat?.state?.filter ?? '', negativeSeekMonths: automat?.state?.negativeSeekMonths ?? 0, items, activeFilterKey: currentKey, activeFilterLabel: formatFilterLabel(currentKey), filterCaches: cachedFiltersSummary, lruEntries, events: [...chunkEvents], }; } export function subscribeChunkStats(listener) { chunkStatsListeners.add(listener); try { listener(getChunkStats()); } catch (e) { console.error(e); } return () => { chunkStatsListeners.delete(listener); }; } function clearChunkDebounce() { if (chunkDebounceTimer) { clearTimeout(chunkDebounceTimer); chunkDebounceTimer = null; } if (pendingTargetChunks.size > 0) { pendingTargetChunks.clear(); notifyChunkStats(); } pendingChunkPromise = null; pendingChunkResolve = null; pendingChunkReject = null; } function _executeRequiredChunks(chunks, targetEpoch, prefetch = true, targetFilterKey = getFilterKey(automat.state)) { if (targetEpoch !== queryEpoch) { return Promise.resolve(automat.state.items); } const chunkList = Array.from(chunks).sort((a, b) => a - b); if (chunkList.length === 0) { return Promise.resolve(automat.state.items); } recordChunkEvent({ type: 'execute', chunks: chunkList, filterKey: targetFilterKey, message: `Lade Chunks [${chunkList.join(', ')}] für "${formatFilterLabel(targetFilterKey)}" (Epoch ${targetEpoch})`, }); const promises = []; for (const c of chunkList) { promises.push(actions.loadChunk(c, targetEpoch, targetFilterKey)); } return Promise.all(promises).then(() => { if (targetEpoch !== queryEpoch) return automat.state.items; if (prefetch) { const maxChunk = chunkList[chunkList.length - 1]; const entry = filterCaches.get(targetFilterKey); const total = entry?.total || automat.state.total || 0; for (let c = maxChunk + 1; c <= maxChunk + PREFETCH_CHUNKS; c++) { if (total > 0 && c * CHUNK_SIZE >= total) { break; } recordChunkEvent({ type: 'prefetch', chunkIndex: c, filterKey: targetFilterKey, message: `Prefetch Chunk #${c} für "${formatFilterLabel(targetFilterKey)}"`, }); void actions.loadChunk(c, targetEpoch, targetFilterKey); } } return automat.state.items; }); } export function formatNegativeSeek(months) { if (!months || months >= 0) return ''; const total = Math.abs(months); const years = Math.floor(total / 12); const remMonths = total % 12; const parts = []; if (years > 0) { parts.push(`${years} ${years === 1 ? 'Jahr' : 'Jahre'}`); } if (remMonths > 0) { parts.push(`${remMonths} ${remMonths === 1 ? 'Monat' : 'Monate'}`); } return `-${parts.join(' ')}`; } function buildQueryParamsFor(filterParams, offset = 0, limit = CHUNK_SIZE) { const params = { offset, limit }; const trimmed = String(filterParams.filter ?? '').trim(); if (trimmed) params.search = trimmed; if (filterParams.negativeSeekMonths != null && Number(filterParams.negativeSeekMonths) < 0) { params.seekMonths = Number(filterParams.negativeSeekMonths); } return params; } async function fetchQuotesPageFor(filterParams, offset = 0, limit = CHUNK_SIZE) { const params = buildQueryParamsFor(filterParams, offset, limit); const res = await quoteApi.list(params); const quotes = Array.isArray(res?.quotes) ? res.quotes : []; const total = Number(res?.total ?? quotes.length); const unfilteredTotal = res?.unfilteredTotal != null ? Number(res.unfilteredTotal) : total; return { quotes, total, unfilteredTotal }; } function onFilterChange(immediate = false) { if (filterDebounceTimer) { clearTimeout(filterDebounceTimer); filterDebounceTimer = null; } if (immediate) { applyFilterReload(); } else { filterDebounceTimer = setTimeout(() => { filterDebounceTimer = null; applyFilterReload(); }, 200); } } function applyFilterReload() { queryEpoch++; clearChunkDebounce(); const currentKey = getFilterKey(automat.state); const cached = filterCaches.get(currentKey); if (cached && cached.items !== null) { cached.lastAccessed = Date.now(); for (const c of cached.loadedChunks) { touchChunkLRU(currentKey, c); } automat.setState({ items: cached.items, total: cached.total, unfilteredTotal: cached.unfilteredTotal ?? automat.state.unfilteredTotal ?? 0, status: cached.status || 'ready', error: cached.error || null, }); recordChunkEvent({ type: 'filter_hit', epoch: queryEpoch, filterKey: currentKey, message: `Filter gewechselt: "${cached.label}" (Cache-Hit: ${cached.loadedChunks.size} Chunks / ${countNonNullItems(cached.items)} Angebote im RAM)`, }); notifyChunkStats(); if (!cached.loadedChunks.has(0)) { void actions.loadChunk(0, queryEpoch, currentKey); } } else { const entry = getOrCreateFilterCache(currentKey, automat.state); entry.lastAccessed = Date.now(); automat.setState({ items: null, total: 0, unfilteredTotal: automat.state.unfilteredTotal ?? 0, status: 'loading', error: null, }); recordChunkEvent({ type: 'filter_miss', epoch: queryEpoch, filterKey: currentKey, message: `Filter gewechselt: "${entry.label}" (Cache-Miss: Lade Chunk #0)`, }); notifyChunkStats(); void actions.loadChunk(0, queryEpoch, currentKey); } } const actions = { getItems() { if (automat.state.items === null) { void actions.requireChunk(0, 0, { prefetch: false, immediate: true }); return null; } return automat.state.items; }, requireChunk(chunkIndex, endOrOptions = chunkIndex, maybeOptions = {}) { let start; let end; let options = {}; if (Array.isArray(chunkIndex)) { start = chunkIndex[0] ?? 0; end = chunkIndex[chunkIndex.length - 1] ?? start; if (typeof endOrOptions === 'object' && endOrOptions !== null) { options = endOrOptions; } } else { start = Number(chunkIndex) || 0; if (typeof endOrOptions === 'object' && endOrOptions !== null) { end = start; options = endOrOptions; } else { end = Number(endOrOptions ?? start) || start; if (typeof maybeOptions === 'object' && maybeOptions !== null) { options = maybeOptions; } } } start = Math.max(0, Math.floor(start)); end = Math.max(start, Math.floor(end)); const prefetch = options.prefetch !== false; const currentKey = getFilterKey(automat.state); if (options.immediate || automat.state.items === null) { clearChunkDebounce(); const chunks = new Set(); for (let c = start; c <= end; c++) chunks.add(c); recordChunkEvent({ type: 'require_immediate', chunks: Array.from(chunks), filterKey: currentKey, message: `Sofortige Anforderung: Chunks ${start}..${end} (${formatFilterLabel(currentKey)})`, }); return _executeRequiredChunks(chunks, queryEpoch, prefetch, currentKey); } if (lastRequireChunkTick !== currentEventTick) { pendingTargetChunks.clear(); lastRequireChunkTick = currentEventTick; if (typeof queueMicrotask === 'function') { queueMicrotask(() => { currentEventTick++; }); } else { Promise.resolve().then(() => { currentEventTick++; }); } } for (let c = start; c <= end; c++) { pendingTargetChunks.add(c); } recordChunkEvent({ type: 'pending', chunks: Array.from(pendingTargetChunks), filterKey: currentKey, message: `Debounce vorgemerkt (${CHUNK_DEBOUNCE_MS}ms): Chunks [${Array.from(pendingTargetChunks).join(', ')}]`, }); notifyChunkStats(); if (chunkDebounceTimer) { clearTimeout(chunkDebounceTimer); chunkDebounceTimer = null; } if (!pendingChunkPromise) { pendingChunkPromise = new Promise((resolve, reject) => { pendingChunkResolve = resolve; pendingChunkReject = reject; }); } const captureEpoch = queryEpoch; chunkDebounceTimer = setTimeout(() => { chunkDebounceTimer = null; const chunksToLoad = new Set(pendingTargetChunks); pendingTargetChunks.clear(); notifyChunkStats(); const resolve = pendingChunkResolve; const reject = pendingChunkReject; pendingChunkPromise = null; pendingChunkResolve = null; pendingChunkReject = null; recordChunkEvent({ type: 'debounce_fire', chunks: Array.from(chunksToLoad), filterKey: currentKey, message: `Debounce abgelaufen: Starte Chunks [${Array.from(chunksToLoad).join(', ')}]`, }); _executeRequiredChunks(chunksToLoad, captureEpoch, true, currentKey) .then((res) => resolve?.(res)) .catch((err) => reject?.(err)); }, CHUNK_DEBOUNCE_MS); return pendingChunkPromise; }, loadChunk(chunkIndex, targetEpoch = queryEpoch, targetFilterKey = getFilterKey(automat.state)) { const index = Math.max(0, Number(chunkIndex) || 0); const entry = getOrCreateFilterCache(targetFilterKey, automat.state); if (targetEpoch !== queryEpoch && targetFilterKey !== getFilterKey(automat.state)) { return Promise.resolve(entry.items); } if (entry.loadedChunks.has(index)) { touchChunkLRU(targetFilterKey, index); recordChunkEvent({ type: 'hit', chunkIndex: index, filterKey: targetFilterKey, message: `Cache-Hit: Chunk #${index} für Filter "${entry.label}" bereits im Speicher`, }); return Promise.resolve(targetFilterKey === getFilterKey(automat.state) ? automat.state.items : entry.items); } const inflightKey = makeLruKey(targetFilterKey, index); if (inflightChunks.has(inflightKey)) { recordChunkEvent({ type: 'inflight_hit', chunkIndex: index, filterKey: targetFilterKey, message: `Inflight-Hit: Chunk #${index} für Filter "${entry.label}" lädt bereits`, }); return inflightChunks.get(inflightKey); } const offset = index * CHUNK_SIZE; const limit = CHUNK_SIZE; const isActiveFilter = targetFilterKey === getFilterKey(automat.state); if (index === 0 && (entry.items === null || (isActiveFilter && automat.state.items === null))) { entry.status = 'loading'; entry.error = null; if (isActiveFilter) { automat.setState({ status: 'loading', error: null }); } } const startTime = Date.now(); recordChunkEvent({ type: 'start', chunkIndex: index, filterKey: targetFilterKey, message: `Netzwerk-Request: Lade Chunk #${index} (Offset ${offset}..${offset + limit - 1}) für "${entry.label}"`, }); const filterParams = entry.params || getFilterParams(automat.state); const promise = fetchQuotesPageFor(filterParams, offset, limit) .then(({ quotes, total, unfilteredTotal }) => { const currentTotal = total > 0 ? total : 0; entry.total = currentTotal; entry.unfilteredTotal = unfilteredTotal; if (entry.items === null || entry.items.length !== currentTotal) { entry.items = new Array(currentTotal).fill(null); } else { entry.items = [...entry.items]; } for (let i = 0; i < quotes.length; i++) { const idx = offset + i; if (idx < entry.items.length) { entry.items[idx] = quotes[i]; } } entry.loadedChunks.add(index); entry.status = 'ready'; entry.error = null; entry.lastAccessed = Date.now(); registerChunkLRU(targetFilterKey, index, quotes.length); const currentActive = targetFilterKey === getFilterKey(automat.state); if (currentActive) { automat.setState({ items: entry.items, total: currentTotal, unfilteredTotal, status: 'ready', error: null, }); } const duration = Date.now() - startTime; recordChunkEvent({ type: 'loaded', chunkIndex: index, filterKey: targetFilterKey, count: quotes.length, duration, message: `Chunk #${index} geladen (${quotes.length} Angebote in ${duration}ms) für "${entry.label}"`, }); return currentActive ? automat.state.items : entry.items; }) .catch((err) => { entry.status = 'failed'; entry.error = err; const currentActive = targetFilterKey === getFilterKey(automat.state); if (currentActive) { if (index === 0 && automat.state.items === null) { automat.setState({ status: 'failed', error: err }); } } const duration = Date.now() - startTime; console.error(`[quoteAutomat] loadChunk(${index}, ${targetFilterKey}) error:`, err); recordChunkEvent({ type: 'error', chunkIndex: index, filterKey: targetFilterKey, duration, error: err?.message || String(err), message: `Fehler bei Chunk #${index} ("${entry.label}"): ${err?.message || err}`, }); throw err; }) .finally(() => { inflightChunks.delete(inflightKey); notifyChunkStats(); }); inflightChunks.set(inflightKey, promise); notifyChunkStats(); return promise; }, filter(query) { automat.setState({ filter: String(query ?? '') }); onFilterChange(false); }, addSeekMonth() { const seekMonths = (automat.state.seekMonths ?? 0) + 1; const seekYears = automat.state.seekYears ?? 0; const totalMonths = -(seekMonths + seekYears * 12); automat.setState({ seekMonths, negativeSeekMonths: totalMonths }); onFilterChange(true); }, addSeekYear() { const seekMonths = automat.state.seekMonths ?? 0; const seekYears = (automat.state.seekYears ?? 0) + 1; const totalMonths = -(seekMonths + seekYears * 12); automat.setState({ seekYears, negativeSeekMonths: totalMonths }); onFilterChange(true); }, addNegativeSeek(months) { if (months === -12) { actions.addSeekYear(); } else if (months === -1) { actions.addSeekMonth(); } else { const current = Math.min(0, Number(automat.state.negativeSeekMonths ?? 0)); const next = current + months; automat.setState({ negativeSeekMonths: Math.min(0, next) }); onFilterChange(true); } }, resetNegativeSeek() { automat.setState({ seekMonths: 0, seekYears: 0, negativeSeekMonths: 0 }); onFilterChange(true); }, resetFilters() { automat.setState({ filter: '', seekMonths: 0, seekYears: 0, negativeSeekMonths: 0, }); onFilterChange(true); }, load() { return actions.loadChunk(0, queryEpoch, getFilterKey(automat.state)); }, ensureLoaded() { if (automat.state.items !== null) { return Promise.resolve(automat.state.items); } return actions.loadChunk(0, queryEpoch, getFilterKey(automat.state)); }, async reload(onlyCurrent = false) { queryEpoch++; clearChunkDebounce(); if (onlyCurrent) { const currentKey = getFilterKey(automat.state); actions.clearFilterCache(currentKey); } else { actions.clearCache(); } await actions.loadChunk(0, queryEpoch, getFilterKey(automat.state)); return automat.state.items; }, replace(items) { clearChunkDebounce(); const currentKey = getFilterKey(automat.state); actions.clearFilterCache(currentKey); const count = Array.isArray(items) ? items.length : 0; const entry = getOrCreateFilterCache(currentKey, automat.state); entry.items = items; entry.total = count; entry.status = 'ready'; entry.error = null; const chunkCount = count > 0 ? Math.ceil(count / CHUNK_SIZE) : 0; for (let c = 0; c < chunkCount; c++) { entry.loadedChunks.add(c); registerChunkLRU(currentKey, c, Math.min(CHUNK_SIZE, count - c * CHUNK_SIZE)); } automat.setState({ items, total: count, unfilteredTotal: count, status: 'ready', error: null, }); notifyChunkStats(); }, patchQuote(quoteId, patch) { if (quoteId == null || !patch) return; for (const [fKey, entry] of filterCaches.entries()) { if (Array.isArray(entry.items)) { let changed = false; const newItems = entry.items.map((item) => { if (item && item.id === quoteId) { changed = true; return { ...item, ...patch }; } return item; }); if (changed) { entry.items = newItems; if (fKey === getFilterKey(automat.state)) { automat.setState({ items: newItems }); } } } } notifyChunkStats(); }, evictChunk(chunkIndex, filterKey = getFilterKey(automat.state)) { const key = makeLruKey(filterKey, chunkIndex); lruChunks.delete(key); evictChunkFromMemory(filterKey, chunkIndex, 'manual'); }, clearFilterCache(filterKey) { const entry = filterCaches.get(filterKey); if (entry) { for (const c of entry.loadedChunks) { lruChunks.delete(makeLruKey(filterKey, c)); } entry.items = null; entry.loadedChunks.clear(); entry.status = 'idle'; entry.error = null; if (filterKey === getFilterKey(automat.state)) { automat.setState({ items: null, status: 'idle', error: null }); } recordChunkEvent({ type: 'clear_filter', filterKey, message: `Filter-Cache "${entry.label}" geleert`, }); notifyChunkStats(); } }, clearCache() { clearChunkDebounce(); lruChunks.clear(); inflightChunks.clear(); for (const entry of filterCaches.values()) { entry.items = null; entry.loadedChunks.clear(); entry.status = 'idle'; entry.error = null; } recordChunkEvent({ type: 'clear_all', message: 'Gesamter Quote-Chunk-Cache geleert', }); notifyChunkStats(); automat.setState({ items: null, status: 'idle', error: null, }); }, prefetchAllChunks(filterKey = getFilterKey(automat.state)) { const entry = filterCaches.get(filterKey); if (!entry || entry.total <= 0) return; const chunkCount = Math.ceil(entry.total / CHUNK_SIZE); const toLoad = []; for (let c = 0; c < chunkCount; c++) { if (!entry.loadedChunks.has(c)) { toLoad.push(c); } } if (toLoad.length === 0) return; recordChunkEvent({ type: 'prefetch_all', filterKey, chunks: toLoad, message: `Starte Vorladen aller ${toLoad.length} fehlenden Chunks für "${entry.label}"`, }); for (const c of toLoad) { void actions.loadChunk(c, queryEpoch, filterKey); } }, reset() { if (filterDebounceTimer) { clearTimeout(filterDebounceTimer); filterDebounceTimer = null; } clearChunkDebounce(); filterCaches.clear(); lruChunks.clear(); inflightChunks.clear(); recordChunkEvent({ type: 'reset', message: 'Quote-Automat und sämtliche Caches zurückgesetzt', }); notifyChunkStats(); automat.setState(initialState); }, }; export const quoteAutomat = new Automat(initialState, actions, { name: 'quote' }); automat = quoteAutomat; export function getItems() { return actions.getItems(); } export function requireChunk(chunkIndex, endOrOptions, maybeOptions) { return actions.requireChunk(chunkIndex, endOrOptions, maybeOptions); } quoteAutomat.getItems = getItems; quoteAutomat.requireChunk = requireChunk; quoteAutomat.CHUNK_SIZE = CHUNK_SIZE; quoteAutomat.MAX_LRU_CHUNKS = MAX_LRU_CHUNKS; quoteAutomat.getChunkStats = getChunkStats; quoteAutomat.subscribeChunkStats = subscribeChunkStats; quoteAutomat.evictChunk = actions.evictChunk; quoteAutomat.clearFilterCache = actions.clearFilterCache; quoteAutomat.clearCache = actions.clearCache; quoteAutomat.prefetchAllChunks = actions.prefetchAllChunks; quoteAutomat.getFilterKey = getFilterKey; quoteAutomat.formatFilterLabel = formatFilterLabel; // Reset on logout or company change let lastCompanyId = null; authAutomat.subscribe((auth) => { const companyId = auth.user?.selectedCompanyId ?? null; if (auth.status === 'anon') { actions.reset(); lastCompanyId = null; return; } if (lastCompanyId !== null && companyId !== lastCompanyId) { actions.reset(); } if (auth.status === 'authed' && companyId != null) { lastCompanyId = companyId; } }); /** Selects current quotes */ export function selectQuotes(state = automat.state) { return state.items; } /** Selects total unpaged count */ export function selectQuoteTotal(state = automat.state) { return state.total; } /** Selects unfiltered total count */ export function selectQuoteUnfilteredTotal(state = automat.state) { return state.unfilteredTotal ?? 0; } /** Selects negative seek offset in months */ export function selectNegativeSeekMonths(state = automat.state) { return state.negativeSeekMonths; } /** Selects seek month count */ export function selectSeekMonths(state = automat.state) { return state.seekMonths ?? 0; } /** Selects seek year count */ export function selectSeekYears(state = automat.state) { return state.seekYears ?? 0; } /** * Calculates client pagination metadata. */ export function selectQuotePagination(state = automat.state) { const total = state.total ?? 0; return { total, offset: 0, limit: CHUNK_SIZE, currentPage: 1, pageCount: Math.max(1, Math.ceil(total / CHUNK_SIZE)), }; } export default quoteAutomat;