react-redux-cache 0.22.1 → 0.22.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/dist/cjs/createActions.js +63 -63
- package/dist/cjs/createCache.js +216 -131
- package/dist/cjs/createReducer.js +355 -290
- package/dist/cjs/createSelectors.js +66 -58
- package/dist/cjs/index.js +87 -26
- package/dist/cjs/mutate.js +153 -70
- package/dist/cjs/query.js +161 -70
- package/dist/cjs/types.js +2 -2
- package/dist/cjs/useMutation.js +81 -42
- package/dist/cjs/useQuery.js +127 -56
- package/dist/cjs/utilsAndConstants.js +204 -151
- package/dist/esm/createActions.js +60 -59
- package/dist/esm/createCache.js +218 -127
- package/dist/esm/createReducer.js +349 -286
- package/dist/esm/createSelectors.js +63 -54
- package/dist/esm/index.js +3 -3
- package/dist/esm/mutate.js +143 -66
- package/dist/esm/query.js +149 -66
- package/dist/esm/types.js +1 -1
- package/dist/esm/useMutation.js +77 -38
- package/dist/esm/useQuery.js +119 -52
- package/dist/esm/utilsAndConstants.js +190 -140
- package/dist/types/createActions.d.ts +109 -83
- package/dist/types/createCache.d.ts +734 -409
- package/dist/types/createReducer.d.ts +11 -3
- package/dist/types/createSelectors.d.ts +80 -18
- package/dist/types/index.d.ts +3 -3
- package/dist/types/mutate.d.ts +94 -4
- package/dist/types/query.d.ts +123 -4
- package/dist/types/types.d.ts +360 -184
- package/dist/types/useMutation.d.ts +39 -4
- package/dist/types/useQuery.d.ts +40 -4
- package/dist/types/utilsAndConstants.d.ts +56 -23
- package/package.json +4 -5
package/dist/types/types.d.ts
CHANGED
|
@@ -1,206 +1,382 @@
|
|
|
1
|
-
import type {
|
|
2
|
-
import type {
|
|
3
|
-
|
|
1
|
+
import type {Actions} from './createActions'
|
|
2
|
+
import type {Selectors} from './createSelectors'
|
|
3
|
+
|
|
4
|
+
export type Key = string | number | symbol
|
|
5
|
+
|
|
4
6
|
export type Mutable = {
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
}
|
|
11
|
-
|
|
7
|
+
/**
|
|
8
|
+
* Used only when mutable cache enabled. Always incremented when collection changed by reducer to allow subscribe on changes.
|
|
9
|
+
* Should not be used for comparing different collections as supposed to be compared only with previously saved changeKey of the same collection.
|
|
10
|
+
*/
|
|
11
|
+
_changeKey?: number
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
export type Dict<T> = Record<Key, T> & Mutable
|
|
15
|
+
|
|
12
16
|
export type OptionalPartial<T, K extends keyof T> = Partial<{
|
|
13
|
-
|
|
14
|
-
}> &
|
|
17
|
+
[A in K]: Partial<T[A]>
|
|
18
|
+
}> &
|
|
19
|
+
Omit<T, K>
|
|
20
|
+
|
|
15
21
|
/** Entity changes to be merged to the state. */
|
|
16
22
|
export type EntityChanges<T extends Typenames> = {
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
}
|
|
23
|
+
/** Entities that will be merged with existing. */
|
|
24
|
+
merge?: PartialEntitiesMap<T>
|
|
25
|
+
/** Entities that will replace existing. */
|
|
26
|
+
replace?: Partial<EntitiesMap<T>>
|
|
27
|
+
/** Ids of entities that will be removed. */
|
|
28
|
+
remove?: EntityIds<T>
|
|
29
|
+
/** Alias for `merge` to support normalizr. */
|
|
30
|
+
entities?: EntityChanges<T>['merge']
|
|
31
|
+
}
|
|
32
|
+
|
|
26
33
|
export type Store<S = unknown> = {
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
}
|
|
34
|
+
dispatch: (action: ReturnType<Actions[keyof Actions]>) => unknown
|
|
35
|
+
getState: () => S
|
|
36
|
+
}
|
|
37
|
+
|
|
30
38
|
/** Record of typename and its corresponding entity type */
|
|
31
|
-
export type Typenames = Record<string, object
|
|
39
|
+
export type Typenames = Record<string, object>
|
|
40
|
+
|
|
32
41
|
export type Cache<N extends string, T extends Typenames, QP, QR, MP, MR> = {
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
42
|
+
/** Used as prefix for actions and in default cacheStateSelector for selecting cache state from store root state. */
|
|
43
|
+
name: N
|
|
44
|
+
/** Cache options. */
|
|
45
|
+
options: CacheOptions
|
|
46
|
+
/** Default options for queries and mutations. */
|
|
47
|
+
globals: Globals<N, T, QP, QR, MP, MR>
|
|
48
|
+
/** Hooks to access and subscribe to the store. Imported from react-redux if not overridden. */
|
|
49
|
+
storeHooks: {
|
|
50
|
+
useStore: () => Store
|
|
51
|
+
useSelector: <R>(selector: (state: unknown) => R, comparer?: (x: R, y: R) => boolean) => R
|
|
52
|
+
}
|
|
53
|
+
/** Should return cache state from store root state. Default implementation returns `state[name]`. */
|
|
54
|
+
cacheStateSelector: (state: any) => CacheState<T, QP, QR, MP, MR>
|
|
55
|
+
/** Queries. */
|
|
56
|
+
queries: {
|
|
57
|
+
[QK in keyof (QP & QR)]: QK extends keyof (QP | QR)
|
|
58
|
+
? QueryInfo<N, T, QP[QK], QR[QK], QP, QR, MP, MR>
|
|
59
|
+
: never
|
|
60
|
+
}
|
|
61
|
+
/** Mutations. */
|
|
62
|
+
mutations: {
|
|
63
|
+
[MK in keyof (MP & MR)]: MK extends keyof (MP | MR)
|
|
64
|
+
? MutationInfo<N, T, MP[MK], MR[MK], QP, QR, MP, MR>
|
|
65
|
+
: never
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
export type QueryStateComparer<T extends Typenames, P, R> = (
|
|
70
|
+
x: QueryState<T, P, R> | undefined,
|
|
71
|
+
y: QueryState<T, P, R> | undefined,
|
|
72
|
+
) => boolean
|
|
73
|
+
|
|
56
74
|
export type Globals<N extends string, T extends Typenames, QP, QR, MP, MR> = {
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
75
|
+
/** Handles errors, not handled by onError from queries and mutations. @Default undefined. */
|
|
76
|
+
onError?: (
|
|
77
|
+
error: unknown,
|
|
78
|
+
key: string,
|
|
79
|
+
params: unknown,
|
|
80
|
+
store: Store,
|
|
81
|
+
actions: Actions<N, T, QP, QR, MP, MR>,
|
|
82
|
+
selectors: Selectors<N, T, QP, QR, MP, MR>,
|
|
83
|
+
) => void
|
|
84
|
+
/** Query options. */
|
|
85
|
+
queries: {
|
|
86
|
+
/** Determines when useQuery fetch triggers should start fetching. Fetch is performed if function returns true.
|
|
87
|
+
* Fetch triggers are: 1) mount 2) cache key change 3) skipFetch value change to false.
|
|
88
|
+
* @Default FetchPolicy.NoCacheOrExpired */
|
|
89
|
+
fetchPolicy: (
|
|
90
|
+
expired: boolean,
|
|
91
|
+
params: unknown,
|
|
92
|
+
state: QueryState<T, unknown, unknown>,
|
|
93
|
+
store: Store,
|
|
94
|
+
selectors: Selectors<N, T, QP, QR, MP, MR>,
|
|
95
|
+
) => boolean
|
|
96
|
+
/** Disables any fetches when set to true. Triggers fetch when changed to false. @Default false */
|
|
97
|
+
skipFetch: boolean
|
|
98
|
+
/** If set, this value updates expiresAt value of query state when query result is received. @Default undefined */
|
|
99
|
+
secondsToLive?: number
|
|
100
|
+
/** Either comparer function, or array of keys to subscribe by useQuery's useSelector. @Default compares result, loading, params, error. */
|
|
101
|
+
selectorComparer?: QueryStateComparer<T, unknown, unknown> | (keyof QueryState<T, unknown, unknown>)[]
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
|
|
73
105
|
export type CacheOptions = {
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
}
|
|
106
|
+
/**
|
|
107
|
+
* BETA: Optimization that makes state collections mutable.
|
|
108
|
+
* Subscription to mutable collecitons will work only when subscribed to both collection and its change key - collections
|
|
109
|
+
* still can be replaced with the new ones instead of mutating e.g. when clearing state.
|
|
110
|
+
* @Default false
|
|
111
|
+
* */
|
|
112
|
+
mutableCollections: boolean
|
|
113
|
+
/** Enables additional validation with logging to console.warn. Recommended to enable in dev/testing mode. @Default true in dev mode. */
|
|
114
|
+
additionalValidation: boolean
|
|
115
|
+
/** Enables debug logs. @Default false */
|
|
116
|
+
logsEnabled: boolean
|
|
117
|
+
/**
|
|
118
|
+
* Enables deep comparison before merging entities to the state.
|
|
119
|
+
* Re-rendering is a heavier operation than comparison, so disabling it can lead to performance drop.
|
|
120
|
+
* Makes sense to disable only if merging equal results & entities to the state is a rare case.
|
|
121
|
+
* @Default true
|
|
122
|
+
*/
|
|
123
|
+
deepComparisonEnabled: boolean
|
|
124
|
+
}
|
|
125
|
+
|
|
93
126
|
export type PartialEntitiesMap<T extends Typenames> = {
|
|
94
|
-
|
|
95
|
-
}
|
|
127
|
+
[K in keyof T]?: Dict<Partial<T[K]>>
|
|
128
|
+
}
|
|
129
|
+
|
|
96
130
|
export type EntitiesMap<T extends Typenames> = {
|
|
97
|
-
|
|
98
|
-
}
|
|
131
|
+
[K in keyof T]?: Dict<T[K]>
|
|
132
|
+
}
|
|
133
|
+
|
|
99
134
|
export type EntityIds<T extends Typenames> = {
|
|
100
|
-
|
|
101
|
-
}
|
|
135
|
+
[K in keyof T]?: Key[]
|
|
136
|
+
}
|
|
137
|
+
|
|
102
138
|
export type CacheState<T extends Typenames, QP, QR, MP, MR> = {
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
}
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
139
|
+
entities: EntitiesMap<T> & Mutable
|
|
140
|
+
queries: {
|
|
141
|
+
[QK in keyof (QP | QR)]: Dict<QueryState<T, QP[QK], QR[QK]> | undefined>
|
|
142
|
+
} & Mutable
|
|
143
|
+
mutations: {
|
|
144
|
+
[MK in keyof (MP | MR)]: MutationState<T, MP[MK], MR[MK]>
|
|
145
|
+
} & Mutable
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
export type QueryInfo<
|
|
149
|
+
N extends string,
|
|
150
|
+
T extends Typenames = Typenames,
|
|
151
|
+
P = unknown,
|
|
152
|
+
R = unknown,
|
|
153
|
+
QP = unknown,
|
|
154
|
+
QR = unknown,
|
|
155
|
+
MP = unknown,
|
|
156
|
+
MR = unknown,
|
|
157
|
+
> = Partial<Pick<Globals<N, T, QP, QR, MP, MR>['queries'], 'skipFetch' | 'secondsToLive'>> & {
|
|
158
|
+
query: NormalizedQuery<T, P, R>
|
|
159
|
+
/** Determines when useQuery fetch triggers should start fetching. Fetch is performed if function returns true.
|
|
160
|
+
* Fetch triggers are: 1) mount 2) cache key change 3) skipFetch value change to false.
|
|
161
|
+
* @Default FetchPolicy.NoCacheOrExpired */
|
|
162
|
+
fetchPolicy?: (
|
|
163
|
+
expired: boolean,
|
|
164
|
+
params: P,
|
|
165
|
+
queryState: QueryState<T, P, R>,
|
|
166
|
+
store: Store,
|
|
167
|
+
selectors: Selectors<N, T, QP, QR, MP, MR>,
|
|
168
|
+
) => boolean
|
|
169
|
+
/** Merges results before saving to the store. Default implementation is using the latest result. */
|
|
170
|
+
mergeResults?: (
|
|
171
|
+
oldResult: R | undefined,
|
|
172
|
+
response: NormalizedQueryResponse<T, R>,
|
|
173
|
+
params: P | undefined,
|
|
174
|
+
store: Store,
|
|
175
|
+
actions: Actions<N, T, QP, QR, MP, MR>,
|
|
176
|
+
selectors: Selectors<N, T, QP, QR, MP, MR>,
|
|
177
|
+
) => R
|
|
178
|
+
/**
|
|
179
|
+
* Cache key is used for storing the query state and for performing a fetch when it changes. Queries with the same cache key share their state.
|
|
180
|
+
* Default implementation uses `String()` or `JSON.stringify` depending on type.
|
|
181
|
+
* It is recommended to override it when default implementation is not optimal or when keys in params object can be sorted in random order etc.
|
|
182
|
+
*/
|
|
183
|
+
getCacheKey?: (params: P) => Key
|
|
184
|
+
/** Called after fetch completed either successfully or not. */
|
|
185
|
+
onCompleted?: (
|
|
186
|
+
response: NormalizedQueryResponse<T, R> | undefined,
|
|
187
|
+
error: unknown | undefined,
|
|
188
|
+
params: P | undefined,
|
|
189
|
+
store: Store,
|
|
190
|
+
actions: Actions<N, T, QP, QR, MP, MR>,
|
|
191
|
+
selectors: Selectors<N, T, QP, QR, MP, MR>,
|
|
192
|
+
) => void
|
|
193
|
+
/** Called after fetch finished successfully. */
|
|
194
|
+
onSuccess?: (
|
|
195
|
+
response: NormalizedQueryResponse<T, R>,
|
|
196
|
+
params: P | undefined,
|
|
197
|
+
store: Store,
|
|
198
|
+
actions: Actions<N, T, QP, QR, MP, MR>,
|
|
199
|
+
selectors: Selectors<N, T, QP, QR, MP, MR>,
|
|
200
|
+
) => void
|
|
201
|
+
/** Called after fetch finished with error. Should return true if error was handled and does not require global onError handling. */
|
|
202
|
+
onError?: (
|
|
203
|
+
error: unknown,
|
|
204
|
+
params: P | undefined,
|
|
205
|
+
store: Store,
|
|
206
|
+
actions: Actions<N, T, QP, QR, MP, MR>,
|
|
207
|
+
selectors: Selectors<N, T, QP, QR, MP, MR>,
|
|
208
|
+
) => boolean | void | null | undefined
|
|
209
|
+
/** Either comparer function, or array of keys to subscribe by useQuery's useSelector. Default compares params, result, loading, error. */
|
|
210
|
+
selectorComparer?: QueryStateComparer<T, P, R> | (keyof QueryState<T, P, R>)[]
|
|
211
|
+
}
|
|
212
|
+
|
|
134
213
|
export type Query<P = unknown, R = unknown> = (
|
|
135
|
-
/** Query parameters */
|
|
136
|
-
params: P,
|
|
137
|
-
/** Store */
|
|
138
|
-
store: Store
|
|
139
|
-
|
|
214
|
+
/** Query parameters */
|
|
215
|
+
params: P,
|
|
216
|
+
/** Store */
|
|
217
|
+
store: Store,
|
|
218
|
+
) => Promise<QueryResponse<R>>
|
|
219
|
+
|
|
220
|
+
export type NormalizedQuery<T extends Typenames = Typenames, P = unknown, R = unknown> = (
|
|
221
|
+
...args: Parameters<Query<P, R>>
|
|
222
|
+
) => Promise<NormalizedQueryResponse<T, R>>
|
|
223
|
+
|
|
140
224
|
export type QueryState<T extends Typenames, P, R> = MutationState<T, P, R> & {
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
}
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
225
|
+
/**
|
|
226
|
+
* Timestamp in milliseconds, after which state is considered expired.
|
|
227
|
+
* Hooks may refetch the query again when component mounts, cache key or skip option change, depending on the fetch policy.
|
|
228
|
+
* Client query calls also start making fetch if onlyIfExpired argument is truthy.
|
|
229
|
+
* */
|
|
230
|
+
expiresAt?: number
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
export type UseQueryOptions<
|
|
234
|
+
N extends string,
|
|
235
|
+
T extends Typenames,
|
|
236
|
+
QK extends keyof (QP & QR),
|
|
237
|
+
QP,
|
|
238
|
+
QR,
|
|
239
|
+
MP,
|
|
240
|
+
MR,
|
|
241
|
+
> = {
|
|
242
|
+
query: QK
|
|
243
|
+
params: QK extends keyof (QP | QR) ? QP[QK] : never
|
|
244
|
+
} & Pick<
|
|
245
|
+
QueryInfo<
|
|
246
|
+
N,
|
|
247
|
+
T,
|
|
248
|
+
QK extends keyof (QP | QR) ? QP[QK] : never,
|
|
249
|
+
QK extends keyof (QP | QR) ? QR[QK] : never,
|
|
250
|
+
QP,
|
|
251
|
+
QR,
|
|
252
|
+
MP,
|
|
253
|
+
MR
|
|
254
|
+
>,
|
|
255
|
+
| 'fetchPolicy'
|
|
256
|
+
| 'skipFetch'
|
|
257
|
+
| 'secondsToLive'
|
|
258
|
+
| 'selectorComparer'
|
|
259
|
+
| 'mergeResults'
|
|
260
|
+
| 'onCompleted'
|
|
261
|
+
| 'onSuccess'
|
|
262
|
+
| 'onError'
|
|
263
|
+
>
|
|
264
|
+
|
|
265
|
+
export type QueryOptions<
|
|
266
|
+
N extends string,
|
|
267
|
+
T extends Typenames,
|
|
268
|
+
QP,
|
|
269
|
+
QR,
|
|
270
|
+
QK extends keyof (QP & QR),
|
|
271
|
+
MP,
|
|
272
|
+
MR,
|
|
273
|
+
> = Pick<
|
|
274
|
+
UseQueryOptions<N, T, QK, QP, QR, MP, MR>,
|
|
275
|
+
| 'query'
|
|
276
|
+
| 'params'
|
|
277
|
+
| 'skipFetch'
|
|
278
|
+
| 'secondsToLive'
|
|
279
|
+
| 'mergeResults'
|
|
280
|
+
| 'onCompleted'
|
|
281
|
+
| 'onSuccess'
|
|
282
|
+
| 'onError'
|
|
283
|
+
> & {
|
|
284
|
+
/** If set to true, query will run only if it is expired or result not yet cached. */
|
|
285
|
+
onlyIfExpired?: boolean
|
|
286
|
+
}
|
|
287
|
+
|
|
156
288
|
export type QueryResponse<R = unknown> = {
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
}
|
|
161
|
-
|
|
289
|
+
result: R
|
|
290
|
+
/** If defined, overrides this value in the query state, ignoring `secondsToLive` option. */
|
|
291
|
+
expiresAt?: number
|
|
292
|
+
}
|
|
293
|
+
|
|
294
|
+
export type NormalizedQueryResponse<T extends Typenames = Typenames, R = unknown> = EntityChanges<T> &
|
|
295
|
+
QueryResponse<R>
|
|
296
|
+
|
|
162
297
|
/** Result is always returned, even if cancelled or finished with error. */
|
|
163
298
|
export type QueryResult<R = unknown> = {
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
}
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
299
|
+
error?: unknown
|
|
300
|
+
/**
|
|
301
|
+
* Fetch cancelled reason.
|
|
302
|
+
* @value loading - already loading. Result of current fetch is returned.
|
|
303
|
+
* @value not-expired - not expired yet. Current state result is returned.
|
|
304
|
+
*/
|
|
305
|
+
cancelled?: 'loading' | 'not-expired'
|
|
306
|
+
result?: R
|
|
307
|
+
}
|
|
308
|
+
|
|
309
|
+
export type MutationInfo<
|
|
310
|
+
N extends string,
|
|
311
|
+
T extends Typenames = Typenames,
|
|
312
|
+
P = unknown,
|
|
313
|
+
R = unknown,
|
|
314
|
+
QP = unknown,
|
|
315
|
+
QR = unknown,
|
|
316
|
+
MP = unknown,
|
|
317
|
+
MR = unknown,
|
|
318
|
+
> = Pick<QueryInfo<N, T, P, R, QP, QR, MP, MR>, 'onCompleted' | 'onSuccess' | 'onError'> & {
|
|
319
|
+
mutation: NormalizedMutation<T, P, R>
|
|
320
|
+
}
|
|
321
|
+
|
|
176
322
|
export type Mutation<P = unknown, R = unknown> = (
|
|
177
|
-
/** Mutation parameters */
|
|
178
|
-
params: P,
|
|
179
|
-
/** Store */
|
|
180
|
-
store: Store,
|
|
181
|
-
/** Signal is aborted for current mutation when the same mutation was called once again. */
|
|
182
|
-
abortSignal: AbortSignal
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
323
|
+
/** Mutation parameters */
|
|
324
|
+
params: P,
|
|
325
|
+
/** Store */
|
|
326
|
+
store: Store,
|
|
327
|
+
/** Signal is aborted for current mutation when the same mutation was called once again. */
|
|
328
|
+
abortSignal: AbortSignal,
|
|
329
|
+
) => Promise<MutationResponse<R>>
|
|
330
|
+
|
|
331
|
+
export type NormalizedMutation<T extends Typenames = Typenames, P = unknown, R = unknown> = (
|
|
332
|
+
...args: Parameters<Mutation<P, R>>
|
|
333
|
+
) => Promise<NormalizedMutationResponse<T, R>>
|
|
334
|
+
|
|
335
|
+
export type MutateOptions<
|
|
336
|
+
N extends string,
|
|
337
|
+
T extends Typenames,
|
|
338
|
+
QP,
|
|
339
|
+
QR,
|
|
340
|
+
MP,
|
|
341
|
+
MR,
|
|
342
|
+
MK extends keyof (MP & MR),
|
|
343
|
+
> = Pick<
|
|
344
|
+
MutationInfo<
|
|
345
|
+
N,
|
|
346
|
+
T,
|
|
347
|
+
MK extends keyof (MP | MR) ? MP[MK] : never,
|
|
348
|
+
MK extends keyof (MP | MR) ? MR[MK] : never,
|
|
349
|
+
QP,
|
|
350
|
+
QR,
|
|
351
|
+
MP,
|
|
352
|
+
MR
|
|
353
|
+
>,
|
|
354
|
+
'onCompleted' | 'onSuccess' | 'onError'
|
|
355
|
+
> & {
|
|
356
|
+
mutation: MK
|
|
357
|
+
params: MK extends keyof (MP | MR) ? MP[MK] : never
|
|
358
|
+
}
|
|
359
|
+
|
|
188
360
|
export type MutationResponse<R = unknown> = {
|
|
189
|
-
|
|
190
|
-
}
|
|
191
|
-
|
|
361
|
+
result?: R
|
|
362
|
+
}
|
|
363
|
+
|
|
364
|
+
export type NormalizedMutationResponse<T extends Typenames = Typenames, R = unknown> = EntityChanges<T> &
|
|
365
|
+
MutationResponse<R>
|
|
366
|
+
|
|
192
367
|
export type MutationResult<R = unknown> = {
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
}
|
|
368
|
+
error?: unknown
|
|
369
|
+
aborted?: true
|
|
370
|
+
result?: R
|
|
371
|
+
}
|
|
372
|
+
|
|
197
373
|
export type MutationState<T extends Typenames, P, R> = {
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
}
|
|
374
|
+
/** Set when fetch is currently in progress. */
|
|
375
|
+
loading?: Promise<NormalizedQueryResponse<T, R>>
|
|
376
|
+
/** Result of the latest successfull response. */
|
|
377
|
+
result?: R
|
|
378
|
+
/** Error of the latest response. */
|
|
379
|
+
error?: Error
|
|
380
|
+
/** Parameters of the latest request. */
|
|
381
|
+
params?: P
|
|
382
|
+
}
|
|
@@ -1,4 +1,39 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
4
|
-
|
|
1
|
+
import {Actions} from './createActions'
|
|
2
|
+
import {Selectors} from './createSelectors'
|
|
3
|
+
import {Cache, Key, MutateOptions, MutationState, Store, Typenames} from './types'
|
|
4
|
+
|
|
5
|
+
export declare const useMutation: <
|
|
6
|
+
N extends string,
|
|
7
|
+
T extends Typenames,
|
|
8
|
+
QP,
|
|
9
|
+
QR,
|
|
10
|
+
MP,
|
|
11
|
+
MR,
|
|
12
|
+
MK extends keyof (MP & MR),
|
|
13
|
+
>(
|
|
14
|
+
cache: Pick<Cache<N, T, QP, QR, MP, MR>, 'options' | 'globals' | 'mutations' | 'storeHooks'>,
|
|
15
|
+
actions: Actions<N, T, QP, QR, MP, MR>,
|
|
16
|
+
selectors: Selectors<N, T, QP, QR, MP, MR>,
|
|
17
|
+
options: Omit<MutateOptions<N, T, QP, QR, MP, MR, MK>, 'params'>,
|
|
18
|
+
abortControllers: WeakMap<Store, Record<Key, AbortController>>,
|
|
19
|
+
) => readonly [
|
|
20
|
+
(
|
|
21
|
+
params: MK extends keyof MP & keyof MR ? MP[MK] : never,
|
|
22
|
+
) => Promise<
|
|
23
|
+
import('./types').MutationResult<
|
|
24
|
+
MK extends infer T_1
|
|
25
|
+
? T_1 extends MK
|
|
26
|
+
? T_1 extends keyof MP & keyof MR
|
|
27
|
+
? MR[T_1]
|
|
28
|
+
: never
|
|
29
|
+
: never
|
|
30
|
+
: never
|
|
31
|
+
>
|
|
32
|
+
>,
|
|
33
|
+
MutationState<
|
|
34
|
+
T,
|
|
35
|
+
MK extends keyof MP & keyof MR ? MP[MK] : never,
|
|
36
|
+
MK extends keyof MP & keyof MR ? MP[MK] : never
|
|
37
|
+
>,
|
|
38
|
+
() => boolean,
|
|
39
|
+
]
|