@seifer-webapp-factory/kits 0.1.0

package/dist/frontend/data/core/cache.js

@@ -0,0 +1,189 @@
+const IDLE_STATE = Object.freeze({
+    status: 'idle',
+    data: undefined,
+    error: undefined,
+    updatedAt: 0,
+    fetching: false,
+});
+/** Stabiele serialisatie: strings blijven zichzelf, tuples worden JSON. */
+function serializeKey(key) {
+    return typeof key === 'string' ? key : JSON.stringify(key);
+}
+export function createQueryCache(options) {
+    const { clock } = options;
+    const entries = new Map();
+    const listeners = new Set();
+    function notify(serial) {
+        for (const listener of listeners)
+            listener(serial);
+    }
+    function ensure(serial) {
+        let entry = entries.get(serial);
+        if (entry === undefined) {
+            entry = {
+                status: 'idle',
+                data: undefined,
+                error: undefined,
+                updatedAt: 0,
+                staleTime: 0,
+                fetching: false,
+                invalidated: false,
+                inFlight: null,
+            };
+            entries.set(serial, entry);
+        }
+        return entry;
+    }
+    function toState(entry) {
+        if (entry === undefined)
+            return IDLE_STATE;
+        return {
+            status: entry.status,
+            data: entry.data,
+            error: entry.error,
+            updatedAt: entry.updatedAt,
+            fetching: entry.fetching,
+        };
+    }
+    function isStaleEntry(entry) {
+        if (entry === undefined)
+            return true;
+        if (entry.invalidated)
+            return true;
+        if (entry.status !== 'success')
+            return true;
+        return clock.now() - entry.updatedAt >= entry.staleTime;
+    }
+    return {
+        get(key) {
+            return toState(entries.get(serializeKey(key)));
+        },
+        has(key) {
+            return entries.has(serializeKey(key));
+        },
+        isStale(key) {
+            return isStaleEntry(entries.get(serializeKey(key)));
+        },
+        setData(key, data, staleTime) {
+            const serial = serializeKey(key);
+            const entry = ensure(serial);
+            entry.status = 'success';
+            entry.data = data;
+            entry.error = undefined;
+            entry.updatedAt = clock.now();
+            entry.invalidated = false;
+            if (staleTime !== undefined)
+                entry.staleTime = staleTime;
+            notify(serial);
+        },
+        invalidate(key) {
+            const serial = serializeKey(key);
+            const entry = ensure(serial);
+            entry.invalidated = true;
+            notify(serial);
+        },
+        invalidatePrefix(prefix) {
+            for (const [serial, entry] of entries) {
+                if (serial.startsWith(prefix)) {
+                    entry.invalidated = true;
+                    notify(serial);
+                }
+            }
+        },
+        invalidateWhere(predicate) {
+            for (const [serial, entry] of entries) {
+                if (predicate(serial)) {
+                    entry.invalidated = true;
+                    notify(serial);
+                }
+            }
+        },
+        snapshot(key) {
+            const entry = entries.get(serializeKey(key));
+            if (entry === undefined)
+                return undefined;
+            return Object.freeze({
+                status: entry.status,
+                data: entry.data,
+                error: entry.error,
+                updatedAt: entry.updatedAt,
+                staleTime: entry.staleTime,
+                fetching: entry.fetching,
+                invalidated: entry.invalidated,
+            });
+        },
+        restore(key, snap) {
+            const serial = serializeKey(key);
+            if (snap === undefined) {
+                // Bewaar een lopende in-flight-registratie niet verkeerd: verwijder de hele entry.
+                entries.delete(serial);
+                notify(serial);
+                return;
+            }
+            const entry = ensure(serial);
+            entry.status = snap.status;
+            entry.data = snap.data;
+            entry.error = snap.error;
+            entry.updatedAt = snap.updatedAt;
+            entry.staleTime = snap.staleTime;
+            entry.fetching = snap.fetching;
+            entry.invalidated = snap.invalidated;
+            notify(serial);
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        keys() {
+            return [...entries.keys()];
+        },
+        serialize(key) {
+            return serializeKey(key);
+        },
+        markPending(key) {
+            const serial = serializeKey(key);
+            const entry = ensure(serial);
+            entry.fetching = true;
+            // Alleen naar 'pending' als er nog geen bruikbare data is; anders blijft de stale data
+            // zichtbaar (stale-while-revalidate) met status 'success'.
+            if (entry.status !== 'success')
+                entry.status = 'pending';
+            notify(serial);
+        },
+        resolve(key, data, staleTime) {
+            const serial = serializeKey(key);
+            const entry = ensure(serial);
+            entry.status = 'success';
+            entry.data = data;
+            entry.error = undefined;
+            entry.updatedAt = clock.now();
+            entry.staleTime = staleTime;
+            entry.fetching = false;
+            entry.invalidated = false;
+            notify(serial);
+        },
+        reject(key, error) {
+            const serial = serializeKey(key);
+            const entry = ensure(serial);
+            entry.status = 'error';
+            entry.error = error;
+            entry.fetching = false;
+            // data blijft behouden: laatst bekende waarde blijft beschikbaar.
+            notify(serial);
+        },
+        getInFlight(key) {
+            return entries.get(serializeKey(key))?.inFlight ?? undefined;
+        },
+        setInFlight(key, promise) {
+            ensure(serializeKey(key)).inFlight = promise;
+        },
+        clearInFlight(key) {
+            const entry = entries.get(serializeKey(key));
+            if (entry !== undefined)
+                entry.inFlight = null;
+        },
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/frontend/data/core/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../../frontend/src/data/core/cache.ts"],"names":[],"mappings":"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"}

package/dist/frontend/data/core/mutation.d.ts

@@ -0,0 +1,27 @@
+import type { QueryCache } from './cache.js';
+import type { QueryFetcher, QueryKey } from './ports.js';
+/**
+ * Mutation-runner (US-F0602): voert een schrijfactie uit en invalideert na succes de opgegeven
+ * query-keys, zodat afhankelijke queries bij volgend gebruik hervaliseren. Bij een fout wordt er
+ * niets geïnvalideerd — de bestaande cache blijft consistent en onaangetast.
+ *
+ * Geen framework, geen domeinkennis: de mutatie-functie, de invalidatie-keys en/of het predicaat
+ * worden geïnjecteerd.
+ */
+export interface RunMutationOptions<TData> {
+    /** Keys die na succes als stale worden gemarkeerd. */
+    readonly invalidateKeys?: readonly QueryKey[];
+    /** Predicaat op de geserialiseerde key voor selectieve invalidatie (bv. prefix "facturen/"). */
+    readonly invalidatePredicate?: (key: string) => boolean;
+    /** Callback na succes (bv. verzoening of navigatie). Mag async zijn. */
+    readonly onSuccess?: (data: TData) => void | Promise<void>;
+    /** Callback bij een fout (voordat de fout opnieuw geworpen wordt). */
+    readonly onError?: (error: unknown) => void;
+}
+/**
+ * Voer `fn` uit; invalideer bij succes de geconfigureerde keys/predicaat en roep `onSuccess` aan.
+ * De fout wordt ongewijzigd doorgegeven (geen mapping — de kit kent de fetcher-fout niet) en
+ * opnieuw geworpen, zodat de aanroeper hem kan afhandelen. De cache blijft bij een fout ongemoeid.
+ */
+export declare function runMutation<TData>(cache: QueryCache, fn: QueryFetcher<TData>, options?: RunMutationOptions<TData>): Promise<TData>;
+//# sourceMappingURL=mutation.d.ts.map

package/dist/frontend/data/core/mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.d.ts","sourceRoot":"","sources":["../../../../frontend/src/data/core/mutation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;;;GAOG;AAEH,MAAM,WAAW,kBAAkB,CAAC,KAAK;IACvC,sDAAsD;IACtD,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC9C,gGAAgG;IAChG,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACxD,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,KAAK,EACrC,KAAK,EAAE,UAAU,EACjB,EAAE,EAAE,YAAY,CAAC,KAAK,CAAC,EACvB,OAAO,GAAE,kBAAkB,CAAC,KAAK,CAAM,GACtC,OAAO,CAAC,KAAK,CAAC,CAehB"}

package/dist/frontend/data/core/mutation.js

@@ -0,0 +1,24 @@
+/**
+ * Voer `fn` uit; invalideer bij succes de geconfigureerde keys/predicaat en roep `onSuccess` aan.
+ * De fout wordt ongewijzigd doorgegeven (geen mapping — de kit kent de fetcher-fout niet) en
+ * opnieuw geworpen, zodat de aanroeper hem kan afhandelen. De cache blijft bij een fout ongemoeid.
+ */
+export async function runMutation(cache, fn, options = {}) {
+    try {
+        const data = await fn();
+        if (options.invalidateKeys !== undefined) {
+            for (const key of options.invalidateKeys)
+                cache.invalidate(key);
+        }
+        if (options.invalidatePredicate !== undefined) {
+            cache.invalidateWhere(options.invalidatePredicate);
+        }
+        await options.onSuccess?.(data);
+        return data;
+    }
+    catch (error) {
+        options.onError?.(error);
+        throw error;
+    }
+}
+//# sourceMappingURL=mutation.js.map

package/dist/frontend/data/core/mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation.js","sourceRoot":"","sources":["../../../../frontend/src/data/core/mutation.ts"],"names":[],"mappings":"AAuBA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAiB,EACjB,EAAuB,EACvB,UAAqC,EAAE;IAEvC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,EAAE,CAAC;QACxB,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACzC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,cAAc;gBAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,OAAO,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;YAC9C,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/frontend/data/core/optimistic.d.ts

@@ -0,0 +1,35 @@
+import type { QueryCache } from './cache.js';
+import type { QueryKey } from './ports.js';
+/**
+ * Optimistic-update-helper (US-F0604): neemt per betrokken key een momentopname, past de
+ * optimistische wijziging direct op de cache toe, en rolt bij een fout deterministisch terug naar
+ * die momentopname. Bij succes wordt de cache verzoend met het serverantwoord (via `reconcile`) of
+ * geïnvalideerd.
+ *
+ * Elke aanroep bewaart zijn eigen momentopname, zodat overlappende optimistic mutaties elkaars
+ * rollback niet corrumperen. Geen framework, geen domeinkennis: keys en wijziging worden geïnjecteerd.
+ */
+export interface OptimisticMutationOptions<TData> {
+    /** Query-keys waarvan de cache optimistisch bijgewerkt (en bij falen teruggerold) wordt. */
+    readonly keys: readonly QueryKey[];
+    /** Bereken de optimistische waarde uit de huidige cache-data voor een (geserialiseerde) key. */
+    readonly applyOptimistic: (key: string, current: unknown) => unknown;
+    /** De schrijfactie zelf. */
+    readonly mutation: () => Promise<TData>;
+    /**
+     * Verzoen de cache met het serverantwoord per key. Zonder `reconcile` worden de betrokken keys
+     * (of `invalidateKeys`) na succes geïnvalideerd, zodat een verse fetch volgt.
+     */
+    readonly reconcile?: (data: TData, key: string, current: unknown) => unknown;
+    /** Keys om na succes te invalideren wanneer er geen `reconcile` is (default: `keys`). */
+    readonly invalidateKeys?: readonly QueryKey[];
+    /** Callback bij een fout (na de rollback, voordat de fout opnieuw geworpen wordt). */
+    readonly onError?: (error: unknown) => void;
+}
+/**
+ * Pas de optimistische wijziging toe, voer de mutatie uit en:
+ *  - bij succes: verzoen via `reconcile` of invalideer de keys;
+ *  - bij een fout: rol elke key terug naar zijn eigen vóór-mutatie-momentopname en herwerp de fout.
+ */
+export declare function runOptimisticMutation<TData>(cache: QueryCache, options: OptimisticMutationOptions<TData>): Promise<TData>;
+//# sourceMappingURL=optimistic.d.ts.map

package/dist/frontend/data/core/optimistic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimistic.d.ts","sourceRoot":"","sources":["../../../../frontend/src/data/core/optimistic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;GAQG;AAEH,MAAM,WAAW,yBAAyB,CAAC,KAAK;IAC9C,4FAA4F;IAC5F,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAC;IACnC,gGAAgG;IAChG,QAAQ,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IACrE,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IAC7E,yFAAyF;IACzF,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC9C,sFAAsF;IACtF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAC/C,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,yBAAyB,CAAC,KAAK,CAAC,GACxC,OAAO,CAAC,KAAK,CAAC,CAgChB"}

package/dist/frontend/data/core/optimistic.js

@@ -0,0 +1,41 @@
+/**
+ * Pas de optimistische wijziging toe, voer de mutatie uit en:
+ *  - bij succes: verzoen via `reconcile` of invalideer de keys;
+ *  - bij een fout: rol elke key terug naar zijn eigen vóór-mutatie-momentopname en herwerp de fout.
+ */
+export async function runOptimisticMutation(cache, options) {
+    // 1. Momentopname per key (eigen snapshot → rollbacks corrumperen elkaar niet).
+    const snapshots = options.keys.map((key) => ({
+        key,
+        snapshot: cache.snapshot(key),
+    }));
+    // 2. Optimistische wijziging direct toepassen (vóór het serverantwoord).
+    for (const key of options.keys) {
+        const serial = cache.serialize(key);
+        const next = options.applyOptimistic(serial, cache.get(key).data);
+        cache.setData(key, next);
+    }
+    try {
+        const data = await options.mutation();
+        // 3a. Verzoening met het serverantwoord, of invalidatie.
+        if (options.reconcile !== undefined) {
+            for (const key of options.keys) {
+                const serial = cache.serialize(key);
+                cache.setData(key, options.reconcile(data, serial, cache.get(key).data));
+            }
+        }
+        else {
+            for (const key of options.invalidateKeys ?? options.keys)
+                cache.invalidate(key);
+        }
+        return data;
+    }
+    catch (error) {
+        // 3b. Deterministische rollback naar de eigen momentopname per key.
+        for (const { key, snapshot } of snapshots)
+            cache.restore(key, snapshot);
+        options.onError?.(error);
+        throw error;
+    }
+}
+//# sourceMappingURL=optimistic.js.map

package/dist/frontend/data/core/optimistic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimistic.js","sourceRoot":"","sources":["../../../../frontend/src/data/core/optimistic.ts"],"names":[],"mappings":"AA+BA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAiB,EACjB,OAAyC;IAEzC,gFAAgF;IAChF,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC3C,GAAG;QACH,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;KAC9B,CAAC,CAAC,CAAC;IAEJ,yEAAyE;IACzE,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;QAClE,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,yDAAyD;QACzD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACpC,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;gBAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBACpC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,IAAI;gBAAE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,oEAAoE;QACpE,KAAK,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,SAAS;YAAE,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACxE,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QACzB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/frontend/data/core/pagination.d.ts

@@ -0,0 +1,36 @@
+import type { QueryCache } from './cache.js';
+import type { QueryKey } from './ports.js';
+/**
+ * Paginatie-/infinite-scroll-helper (US-F0603): beheert pagina-/cursor-state en het aaneenrijgen
+ * van pagina's bovenop de query-runner. Elke pagina wordt onder een afgeleide query-key gecacht.
+ * De paginatie-strategie (offset, page-nummer of cursor) wordt geïnjecteerd via `getNextPageParam`;
+ * de helper kent de vorm van een page-response niet.
+ *
+ * Puur en per-instantie: de pagina-state zit in de closure — geen module-globale mutable state.
+ */
+export interface InfiniteQueryOptions<TPage, TParam> {
+    /** Basissleutel; elke pagina cachet onder een hiervan afgeleide key. */
+    readonly queryKey: QueryKey;
+    /** Haal één pagina op voor de gegeven param. */
+    readonly fetchPage: (param: TParam) => Promise<TPage>;
+    /** Bepaal de param voor de volgende pagina, of `undefined` als er geen volgende is. */
+    readonly getNextPageParam: (lastPage: TPage, allPages: readonly TPage[]) => TParam | undefined;
+    /** Param voor de eerste pagina. */
+    readonly initialPageParam: TParam;
+    /** Staleness (ms) per gecachte pagina. Default 0. */
+    readonly staleTime?: number;
+}
+export interface InfiniteQuery<TPage> {
+    /** Laad de volgende pagina en rijg haar achter de bestaande pagina's; no-op aan het einde. */
+    fetchNext(): Promise<void>;
+    /** Is er (mogelijk) nog een volgende pagina te laden? */
+    hasNextPage(): boolean;
+    /** Loopt er op dit moment een pagina-fetch? */
+    isFetching(): boolean;
+    /** Momentopname van de geladen pagina's, in volgorde. */
+    getPages(): readonly TPage[];
+    /** Abonneer op wijzigingen; geeft een unsubscribe-functie terug. */
+    subscribe(listener: () => void): () => void;
+}
+export declare function createInfiniteQuery<TPage, TParam>(cache: QueryCache, options: InfiniteQueryOptions<TPage, TParam>): InfiniteQuery<TPage>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/frontend/data/core/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../../../frontend/src/data/core/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;GAOG;AAEH,MAAM,WAAW,oBAAoB,CAAC,KAAK,EAAE,MAAM;IACjD,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IACtD,uFAAuF;IACvF,QAAQ,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,KAAK,EAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/F,mCAAmC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa,CAAC,KAAK;IAClC,8FAA8F;IAC9F,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,yDAAyD;IACzD,WAAW,IAAI,OAAO,CAAC;IACvB,+CAA+C;IAC/C,UAAU,IAAI,OAAO,CAAC;IACtB,yDAAyD;IACzD,QAAQ,IAAI,SAAS,KAAK,EAAE,CAAC;IAC7B,oEAAoE;IACpE,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CAC7C;AAOD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAC/C,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,GAC3C,aAAa,CAAC,KAAK,CAAC,CAkDtB"}

package/dist/frontend/data/core/pagination.js

@@ -0,0 +1,53 @@
+import { fetchQuery } from './query.js';
+/** Leid de cache-key van een pagina af uit de basissleutel + param. */
+function pageKey(cache, queryKey, param) {
+    return `${cache.serialize(queryKey)}::page::${JSON.stringify(param)}`;
+}
+export function createInfiniteQuery(cache, options) {
+    const pages = [];
+    const listeners = new Set();
+    let nextParam = options.initialPageParam;
+    let done = false;
+    let fetching = false;
+    function notify() {
+        for (const listener of listeners)
+            listener();
+    }
+    async function fetchNext() {
+        if (done || fetching)
+            return;
+        if (nextParam === undefined) {
+            done = true;
+            return;
+        }
+        const param = nextParam;
+        fetching = true;
+        notify();
+        try {
+            const page = await fetchQuery(cache, pageKey(cache, options.queryKey, param), () => options.fetchPage(param), { staleTime: options.staleTime });
+            pages.push(page);
+            nextParam = options.getNextPageParam(page, pages);
+            if (nextParam === undefined)
+                done = true;
+        }
+        finally {
+            // Bij een fout blijven pages/nextParam ongewijzigd → een nieuwe fetchNext hervat vanaf
+            // dezelfde param zonder de al geladen pagina's opnieuw op te halen.
+            fetching = false;
+            notify();
+        }
+    }
+    return {
+        fetchNext,
+        hasNextPage: () => !done,
+        isFetching: () => fetching,
+        getPages: () => pages.slice(),
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}
+//# sourceMappingURL=pagination.js.map

package/dist/frontend/data/core/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../../../frontend/src/data/core/pagination.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAsCxC,uEAAuE;AACvE,SAAS,OAAO,CAAC,KAAiB,EAAE,QAAkB,EAAE,KAAc;IACpE,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAiB,EACjB,OAA4C;IAE5C,MAAM,KAAK,GAAY,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IACxC,IAAI,SAAS,GAAuB,OAAO,CAAC,gBAAgB,CAAC;IAC7D,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,SAAS,MAAM;QACb,KAAK,MAAM,QAAQ,IAAI,SAAS;YAAE,QAAQ,EAAE,CAAC;IAC/C,CAAC;IAED,KAAK,UAAU,SAAS;QACtB,IAAI,IAAI,IAAI,QAAQ;YAAE,OAAO;QAC7B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,IAAI,GAAG,IAAI,CAAC;YACZ,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,CAAC;QACxB,QAAQ,GAAG,IAAI,CAAC;QAChB,MAAM,EAAE,CAAC;QACT,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,UAAU,CAC3B,KAAK,EACL,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,EACvC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAC9B,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CACjC,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAClD,IAAI,SAAS,KAAK,SAAS;gBAAE,IAAI,GAAG,IAAI,CAAC;QAC3C,CAAC;gBAAS,CAAC;YACT,uFAAuF;YACvF,oEAAoE;YACpE,QAAQ,GAAG,KAAK,CAAC;YACjB,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC;IAED,OAAO;QACL,SAAS;QACT,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI;QACxB,UAAU,EAAE,GAAG,EAAE,CAAC,QAAQ;QAC1B,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE;QAC7B,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7B,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/frontend/data/core/ports.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Ports voor de data-kit. De core kent alleen deze abstracties; het project levert de adapters
+ * (de fetcher-functie, de klok). Geen domeinkennis, geen endpoints, geen framework en — cruciaal —
+ * geen afhankelijkheid van de http-client-kit: de fetcher wordt geïnjecteerd als kale async-functie.
+ *
+ * Door de `Clock` te injecteren blijft staleness/stale-while-revalidate deterministisch testbaar,
+ * en doordat alle state per cache-instantie leeft (zie `createQueryCache`) is er geen module-globale
+ * mutable state — SSR/hydratie-veilig.
+ */
+/** Klok-port: levert de huidige tijd in ms. Adapter: `systemClock()`. Fake in tests. */
+export interface Clock {
+    now(): number;
+}
+/**
+ * Query-key: een string of een tuple van primitieven. Arrays worden stabiel geserialiseerd, zodat
+ * `['facturen', id]` en dezelfde tuple naar dezelfde cache-entry wijzen. Prefix-invalidatie werkt
+ * op de geserialiseerde string (bv. prefix `"facturen"`).
+ */
+export type QueryKey = string | readonly (string | number | boolean)[];
+/**
+ * Fetcher-port: een kale async-functie die de data ophaalt. Bewust géén http-client-type — het
+ * project bindt hier zijn eigen ophaal-logica aan (fetch, http-client-kit, mock, …). De data-kit
+ * kent de vorm van het resultaat niet.
+ */
+export type QueryFetcher<T> = () => Promise<T>;
+/** Levenscyclus-status van een cache-entry. */
+export type QueryStatus = 'idle' | 'pending' | 'success' | 'error';
+/**
+ * Onveranderlijke momentopname van een cache-entry voor de render-laag. `data` blijft behouden
+ * tijdens een achtergrond-revalidatie (stale-while-revalidate); `fetching` geeft aan of er een
+ * request loopt.
+ */
+export interface QueryState<T> {
+    readonly status: QueryStatus;
+    readonly data: T | undefined;
+    readonly error: unknown;
+    /** Tijdstip (ms, via de Clock) van de laatste succesvolle vulling. 0 als er nooit data was. */
+    readonly updatedAt: number;
+    /** Loopt er op dit moment een (achtergrond-)request voor deze key? */
+    readonly fetching: boolean;
+}
+/**
+ * Opake momentopname voor optimistic-update-rollback. Bevat de volledige interne entry-staat
+ * (inclusief `staleTime`/`invalidated`) zodat een rollback deterministisch de vóór-mutatie-staat
+ * herstelt. Alleen te gebruiken met `QueryCache.restore`.
+ */
+export interface QuerySnapshot {
+    readonly status: QueryStatus;
+    readonly data: unknown;
+    readonly error: unknown;
+    readonly updatedAt: number;
+    readonly staleTime: number;
+    readonly fetching: boolean;
+    readonly invalidated: boolean;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/frontend/data/core/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../../frontend/src/data/core/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wFAAwF;AACxF,MAAM,WAAW,KAAK;IACpB,GAAG,IAAI,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;AAE/C,+CAA+C;AAC/C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,+FAA+F;IAC/F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B"}

package/dist/frontend/data/core/ports.js

@@ -0,0 +1,11 @@
+/**
+ * Ports voor de data-kit. De core kent alleen deze abstracties; het project levert de adapters
+ * (de fetcher-functie, de klok). Geen domeinkennis, geen endpoints, geen framework en — cruciaal —
+ * geen afhankelijkheid van de http-client-kit: de fetcher wordt geïnjecteerd als kale async-functie.
+ *
+ * Door de `Clock` te injecteren blijft staleness/stale-while-revalidate deterministisch testbaar,
+ * en doordat alle state per cache-instantie leeft (zie `createQueryCache`) is er geen module-globale
+ * mutable state — SSR/hydratie-veilig.
+ */
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/frontend/data/core/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../../frontend/src/data/core/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/frontend/data/core/query.d.ts

@@ -0,0 +1,26 @@
+import type { QueryCache } from './cache.js';
+import type { QueryFetcher, QueryKey } from './ports.js';
+/**
+ * Query-runner (US-F0601): haalt data op met caching, request-dedupe en stale-while-revalidate,
+ * bovenop de pure `QueryCache`. Geen framework, geen domeinkennis — de fetcher en de key worden
+ * geïnjecteerd.
+ */
+export interface FetchQueryOptions {
+    /** Hoe lang (ms) een succesvolle waarde vers blijft. Default 0 (direct stale). */
+    readonly staleTime?: number;
+    /** Forceer een refetch, ook als de cache nog vers is (dedupe blijft van kracht). */
+    readonly force?: boolean;
+}
+/**
+ * Haal `key` op via `fetcher` met:
+ *  - cache-hit: verse data wordt direct (zonder fetch) teruggegeven;
+ *  - dedupe: gelijktijdige aanroepen met dezelfde key delen één in-flight request;
+ *  - stale-while-revalidate: bij stale data blijft de oude waarde in de cache zichtbaar terwijl op
+ *    de achtergrond wordt gerevalideerd; na succes wordt ze bijgewerkt.
+ *
+ * Bij een fout krijgt de entry status 'error' met de (ongewijzigd doorgegeven) fout, terwijl de
+ * laatst bekende data behouden blijft; de teruggegeven promise rejecteert zodat de aanroeper het
+ * ook direct ziet.
+ */
+export declare function fetchQuery<T>(cache: QueryCache, key: QueryKey, fetcher: QueryFetcher<T>, options?: FetchQueryOptions): Promise<T>;
+//# sourceMappingURL=query.d.ts.map

package/dist/frontend/data/core/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../../frontend/src/data/core/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,CAAC,CAAC,CA6BZ"}

package/dist/frontend/data/core/query.js

@@ -0,0 +1,42 @@
+/**
+ * Haal `key` op via `fetcher` met:
+ *  - cache-hit: verse data wordt direct (zonder fetch) teruggegeven;
+ *  - dedupe: gelijktijdige aanroepen met dezelfde key delen één in-flight request;
+ *  - stale-while-revalidate: bij stale data blijft de oude waarde in de cache zichtbaar terwijl op
+ *    de achtergrond wordt gerevalideerd; na succes wordt ze bijgewerkt.
+ *
+ * Bij een fout krijgt de entry status 'error' met de (ongewijzigd doorgegeven) fout, terwijl de
+ * laatst bekende data behouden blijft; de teruggegeven promise rejecteert zodat de aanroeper het
+ * ook direct ziet.
+ */
+export function fetchQuery(cache, key, fetcher, options = {}) {
+    const staleTime = options.staleTime ?? 0;
+    const current = cache.get(key);
+    // Cache-hit: verse, succesvolle data zonder geforceerde refetch.
+    if (current.status === 'success' && !cache.isStale(key) && options.force !== true) {
+        return Promise.resolve(current.data);
+    }
+    // Dedupe: er loopt al een request voor deze key.
+    const existing = cache.getInFlight(key);
+    if (existing !== undefined)
+        return existing;
+    // Nieuw request. markPending houdt bestaande (stale) data zichtbaar tijdens revalidatie.
+    cache.markPending(key);
+    const promise = (async () => {
+        try {
+            const data = await fetcher();
+            cache.resolve(key, data, staleTime);
+            return data;
+        }
+        catch (error) {
+            cache.reject(key, error);
+            throw error;
+        }
+        finally {
+            cache.clearInFlight(key);
+        }
+    })();
+    cache.setInFlight(key, promise);
+    return promise;
+}
+//# sourceMappingURL=query.js.map

package/dist/frontend/data/core/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../../frontend/src/data/core/query.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CACxB,KAAiB,EACjB,GAAa,EACb,OAAwB,EACxB,UAA6B,EAAE;IAE/B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;IAElC,iEAAiE;IACjE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAClF,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAS,CAAC,CAAC;IAC5C,CAAC;IAED,iDAAiD;IACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAAI,GAAG,CAAC,CAAC;IAC3C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAE5C,yFAAyF;IACzF,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACvB,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;YAC7B,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACzB,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IACL,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/frontend/data/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * data-kit (frontend) — lichtgewicht, dependency-vrije query-laag: caching, request-dedupe,
+ * stale-while-revalidate, mutaties met cache-invalidatie, paginatie/infinite-scroll en optimistic
+ * updates met rollback. Pure core + referentie-klok-adapter; framework-vrij, deterministisch
+ * testbaar (geïnjecteerde klok + fetcher) en SSR/hydratie-veilig (geen module-globale mutable state).
+ *
+ * De fetcher is een geïnjecteerde async-functie — géén afhankelijkheid van de http-client-kit. De
+ * eigen minimale query-kern kan later achter dezelfde `QueryCache`-port door een TanStack-adapter
+ * vervangen worden zonder de composables te breken.
+ */
+export type { Clock, QueryKey, QueryFetcher, QueryStatus, QueryState, QuerySnapshot, } from './core/ports.js';
+export { createQueryCache } from './core/cache.js';
+export type { QueryCache, QueryCacheOptions, QueryCacheListener } from './core/cache.js';
+export { fetchQuery } from './core/query.js';
+export type { FetchQueryOptions } from './core/query.js';
+export { runMutation } from './core/mutation.js';
+export type { RunMutationOptions } from './core/mutation.js';
+export { createInfiniteQuery } from './core/pagination.js';
+export type { InfiniteQuery, InfiniteQueryOptions } from './core/pagination.js';
+export { runOptimisticMutation } from './core/optimistic.js';
+export type { OptimisticMutationOptions } from './core/optimistic.js';
+export { systemClock } from './adapters/clock.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/frontend/data/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../frontend/src/data/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,YAAY,EACV,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}