about summary refs log tree commit diff
path: root/src/lib/async/revertible.ts
blob: 43383b61e836da9f94bd1b5a280844360fbb607e (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
import {runInAction} from 'mobx'
import {deepObserve} from 'mobx-utils'
import set from 'lodash.set'

const ongoingActions = new Set<any>()

/**
 * This is a TypeScript function that optimistically updates data on the client-side before sending a
 * request to the server and rolling back changes if the request fails.
 * @param {T} model - The object or record that needs to be updated optimistically.
 * @param preUpdate - `preUpdate` is a function that is called before the server update is executed. It
 * can be used to perform any necessary actions or updates on the model or UI before the server update
 * is initiated.
 * @param serverUpdate - `serverUpdate` is a function that returns a Promise representing the server
 * update operation. This function is called after the previous state of the model has been recorded
 * and the `preUpdate` function has been executed. If the server update is successful, the `postUpdate`
 * function is called with the result
 * @param [postUpdate] - `postUpdate` is an optional callback function that will be called after the
 * server update is successful. It takes in the response from the server update as its parameter. If
 * this parameter is not provided, nothing will happen after the server update.
 * @returns A Promise that resolves to `void`.
 */
export const updateDataOptimistically = async <
  T extends Record<string, any>,
  U,
>(
  model: T,
  preUpdate: () => void,
  serverUpdate: () => Promise<U>,
  postUpdate?: (res: U) => void,
): Promise<void> => {
  if (ongoingActions.has(model)) {
    return
  }
  ongoingActions.add(model)

  const prevState: Map<string, any> = new Map<string, any>()
  const dispose = deepObserve(model, (change, path) => {
    if (change.observableKind === 'object') {
      if (change.type === 'update') {
        prevState.set(
          [path, change.name].filter(Boolean).join('.'),
          change.oldValue,
        )
      } else if (change.type === 'add') {
        prevState.set([path, change.name].filter(Boolean).join('.'), undefined)
      }
    }
  })
  preUpdate()
  dispose()

  try {
    const res = await serverUpdate()
    runInAction(() => {
      postUpdate?.(res)
    })
  } catch (error) {
    runInAction(() => {
      prevState.forEach((value, path) => {
        set(model, path, value)
      })
    })
    throw error
  } finally {
    ongoingActions.delete(model)
  }
}