Reducer/flux normalized, framework-agnostic data store. Includes managers/middleware, global referential equality guarantees, automatic expiry policies, data normalization. Consumes TypeScript Standard Endpoints

Framework Implementations

• React
• React-Redux

Sample React Hook suspense implementation

1function useSuspense(endpoint, ...args)
2  const state = useCacheState();
3  const controller = useController();
4
5  const key = args[0] !== null ? endpoint.key(...args) : '';
6  const cacheResults = key && state.results[key];
7  const meta = state.meta[key];
8
9  // Compute denormalized value
10  const { data, expiryStatus, expiresAt } = useMemo(() => {
11    return controller.getResponse(endpoint, ...args, state);
12  }, [
13    cacheResults,
14    state.indexes,
15    state.entities,
16    state.entityMeta,
17    meta,
18    key,
19  ]);
20
21  const error = controller.getError(endpoint, ...args, state);
22
23  // If we are hard invalid we must fetch regardless of triggering or staleness
24  const forceFetch = expiryStatus === ExpiryStatus.Invalid;
25
26  const maybePromise = useMemo(() => {
27    // null params mean don't do anything
28    if ((Date.now() <= expiresAt && !forceFetch) || !key) return;
29
30    return controller.fetch(endpoint, ...args);
31    // we need to check against serialized params, since params can change frequently
32  }, [expiresAt, controller, key, forceFetch, state.lastReset]);
33
34  // fully "valid" data will not suspend even if it is not fresh
35  if (expiryStatus !== ExpiryStatus.Valid && maybePromise) {
36    throw maybePromise;
37  }
38
39  if (error) throw error;
40
41  return data;
42}