@hyper-fetch/react 7.5.2 → 8.0.0

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.
Files changed (214) hide show
  1. package/.eslintrc.cjs +12 -0
  2. package/__tests__/features/helpers/use-request-events/use-request-events.base.spec.ts +115 -0
  3. package/__tests__/features/helpers/use-request-events/use-request-events.utils.spec.ts +69 -0
  4. package/__tests__/features/helpers/use-socket-state/use-socket-state.base.spec.ts +213 -0
  5. package/__tests__/features/helpers/use-tracked-state/use-tacked-state.actions.spec.ts +550 -0
  6. package/__tests__/features/helpers/use-tracked-state/use-tracked-state.base.spec.ts +566 -0
  7. package/__tests__/features/helpers/use-tracked-state/use-tracked-state.utils.spec.ts +260 -0
  8. package/__tests__/features/provider/provider.hydration.spec.tsx +165 -0
  9. package/__tests__/features/provider/use-config-provider.base.spec.tsx +69 -0
  10. package/__tests__/features/use-app-manager/use-app-manager.base.spec.ts +85 -0
  11. package/__tests__/features/use-cache/use-cache.base.spec.ts +136 -0
  12. package/__tests__/features/use-cache/use-cache.helpers.ts +40 -0
  13. package/__tests__/features/use-cache/use-cache.typescript.spec.ts +111 -0
  14. package/__tests__/features/use-emitter/use-emitter.base.spec.ts +124 -0
  15. package/__tests__/features/use-fetch/use-fetch.base.spec.ts +372 -0
  16. package/__tests__/features/use-fetch/use-fetch.cancel.spec.ts +83 -0
  17. package/__tests__/features/use-fetch/use-fetch.clear-state.spec.ts +82 -0
  18. package/__tests__/features/use-fetch/use-fetch.concurrency.spec.ts +91 -0
  19. package/__tests__/features/use-fetch/use-fetch.debounce.spec.ts +153 -0
  20. package/__tests__/features/use-fetch/use-fetch.deduplication.spec.ts +80 -0
  21. package/__tests__/features/use-fetch/use-fetch.infinite.ts +39 -0
  22. package/__tests__/features/use-fetch/use-fetch.integration.spec.tsx +172 -0
  23. package/__tests__/features/use-fetch/use-fetch.keep-previous-data.spec.ts +215 -0
  24. package/__tests__/features/use-fetch/use-fetch.methods.spec.ts +233 -0
  25. package/__tests__/features/use-fetch/use-fetch.offline.spec.ts +103 -0
  26. package/__tests__/features/use-fetch/use-fetch.pagination.ts +36 -0
  27. package/__tests__/features/use-fetch/use-fetch.prefetch.spec.tsx +73 -0
  28. package/__tests__/features/use-fetch/use-fetch.refresh.spec.ts +187 -0
  29. package/__tests__/features/use-fetch/use-fetch.rerender.spec.tsx +151 -0
  30. package/__tests__/features/use-fetch/use-fetch.retry.ts +38 -0
  31. package/__tests__/features/use-fetch/use-fetch.revalidate.spec.ts +237 -0
  32. package/__tests__/features/use-fetch/use-fetch.suspense.spec.tsx +505 -0
  33. package/__tests__/features/use-fetch/use-fetch.typescript.spec.ts +182 -0
  34. package/__tests__/features/use-fetch/use-fetch.utils.spec.ts +26 -0
  35. package/__tests__/features/use-fetch/use-fetch.window.spec.ts +131 -0
  36. package/__tests__/features/use-listener/use-listener.base.spec.ts +57 -0
  37. package/__tests__/features/use-queue/use-queue.actions.spec.ts +238 -0
  38. package/__tests__/features/use-queue/use-queue.base.spec.ts +367 -0
  39. package/__tests__/features/use-queue/use-queue.resolve.spec.ts +173 -0
  40. package/__tests__/features/use-stream/use-stream.base.spec.ts +481 -0
  41. package/__tests__/features/use-submit/use-submit.base.spec.ts +76 -0
  42. package/__tests__/features/use-submit/use-submit.cancel.spec.ts +46 -0
  43. package/__tests__/features/use-submit/use-submit.concurrency.spec.ts +62 -0
  44. package/__tests__/features/use-submit/use-submit.debounce.spec.ts +320 -0
  45. package/__tests__/features/use-submit/use-submit.methods.spec.ts +276 -0
  46. package/__tests__/features/use-submit/use-submit.optimistic.spec.ts +548 -0
  47. package/__tests__/features/use-submit/use-submit.queue.spec.ts +84 -0
  48. package/__tests__/features/use-submit/use-submit.retry.spec.ts +92 -0
  49. package/__tests__/features/use-submit/use-submit.revalidate.spec.ts +99 -0
  50. package/__tests__/features/use-submit/use-submit.submit.spec.ts +234 -0
  51. package/__tests__/features/use-submit/use-submit.typescript.spec.ts +325 -0
  52. package/__tests__/shared/index.ts +2 -0
  53. package/__tests__/shared/isolation.tests.ts +12 -0
  54. package/__tests__/shared/response.tests.ts +128 -0
  55. package/__tests__/tsconfig.json +27 -0
  56. package/__tests__/utils/cache.utils.ts +55 -0
  57. package/__tests__/utils/client.utils.ts +3 -0
  58. package/__tests__/utils/emitter.utils.ts +8 -0
  59. package/__tests__/utils/helpers.utils.ts +9 -0
  60. package/__tests__/utils/index.ts +14 -0
  61. package/__tests__/utils/listener.utils.ts +11 -0
  62. package/__tests__/utils/request.utils.ts +12 -0
  63. package/__tests__/utils/state.utils.ts +7 -0
  64. package/__tests__/utils/use-app-manager.utils.ts +10 -0
  65. package/__tests__/utils/use-cache.utils.ts +12 -0
  66. package/__tests__/utils/use-emitter.utils.ts +12 -0
  67. package/__tests__/utils/use-fetch.utils.ts +12 -0
  68. package/__tests__/utils/use-listener.utils.ts +12 -0
  69. package/__tests__/utils/use-queue.utils.ts +70 -0
  70. package/__tests__/utils/use-request-events.utils.ts +43 -0
  71. package/__tests__/utils/use-socket-state.utils.ts +12 -0
  72. package/__tests__/utils/use-submit.utils.ts +12 -0
  73. package/__tests__/utils/use-tracked-state.utils.ts +27 -0
  74. package/__tests__/vitest.setup.ts +8 -0
  75. package/dist/helpers/index.d.ts +4 -0
  76. package/dist/helpers/index.d.ts.map +1 -0
  77. package/dist/helpers/use-request-events/index.d.ts +3 -0
  78. package/dist/helpers/use-request-events/index.d.ts.map +1 -0
  79. package/dist/helpers/use-request-events/use-request-events.hooks.d.ts +10 -0
  80. package/dist/helpers/use-request-events/use-request-events.hooks.d.ts.map +1 -0
  81. package/dist/helpers/use-request-events/use-request-events.types.d.ts +78 -0
  82. package/dist/helpers/use-request-events/use-request-events.types.d.ts.map +1 -0
  83. package/dist/helpers/use-socket-state/index.d.ts +4 -0
  84. package/dist/helpers/use-socket-state/index.d.ts.map +1 -0
  85. package/dist/helpers/use-socket-state/use-socket-state.constants.d.ts +4 -0
  86. package/dist/helpers/use-socket-state/use-socket-state.constants.d.ts.map +1 -0
  87. package/dist/helpers/use-socket-state/use-socket-state.hooks.d.ts +24 -0
  88. package/dist/helpers/use-socket-state/use-socket-state.hooks.d.ts.map +1 -0
  89. package/dist/helpers/use-socket-state/use-socket-state.types.d.ts +12 -0
  90. package/dist/helpers/use-socket-state/use-socket-state.types.d.ts.map +1 -0
  91. package/dist/helpers/use-tracked-state/index.d.ts +5 -0
  92. package/dist/helpers/use-tracked-state/index.d.ts.map +1 -0
  93. package/dist/helpers/use-tracked-state/use-tracked-state.constants.d.ts +3 -0
  94. package/dist/helpers/use-tracked-state/use-tracked-state.constants.d.ts.map +1 -0
  95. package/dist/helpers/use-tracked-state/use-tracked-state.hooks.d.ts +12 -0
  96. package/dist/helpers/use-tracked-state/use-tracked-state.hooks.d.ts.map +1 -0
  97. package/dist/helpers/use-tracked-state/use-tracked-state.types.d.ts +113 -0
  98. package/dist/helpers/use-tracked-state/use-tracked-state.types.d.ts.map +1 -0
  99. package/dist/helpers/use-tracked-state/use-tracked-state.utils.d.ts +29 -0
  100. package/dist/helpers/use-tracked-state/use-tracked-state.utils.d.ts.map +1 -0
  101. package/dist/hooks/use-app-manager/index.d.ts +3 -0
  102. package/dist/hooks/use-app-manager/index.d.ts.map +1 -0
  103. package/dist/hooks/use-app-manager/use-app-manager.hooks.d.ts +4 -0
  104. package/dist/hooks/use-app-manager/use-app-manager.hooks.d.ts.map +1 -0
  105. package/dist/hooks/use-app-manager/use-app-manager.types.d.ts +19 -0
  106. package/dist/hooks/use-app-manager/use-app-manager.types.d.ts.map +1 -0
  107. package/dist/hooks/use-cache/index.d.ts +4 -0
  108. package/dist/hooks/use-cache/index.d.ts.map +1 -0
  109. package/dist/hooks/use-cache/use-cache.constants.d.ts +6 -0
  110. package/dist/hooks/use-cache/use-cache.constants.d.ts.map +1 -0
  111. package/dist/hooks/use-cache/use-cache.hooks.d.ts +4 -0
  112. package/dist/hooks/use-cache/use-cache.hooks.d.ts.map +1 -0
  113. package/dist/hooks/use-cache/use-cache.types.d.ts +24 -0
  114. package/dist/hooks/use-cache/use-cache.types.d.ts.map +1 -0
  115. package/dist/hooks/use-emitter/index.d.ts +3 -0
  116. package/dist/hooks/use-emitter/index.d.ts.map +1 -0
  117. package/dist/hooks/use-emitter/use-emitter.hooks.d.ts +26 -0
  118. package/dist/hooks/use-emitter/use-emitter.hooks.d.ts.map +1 -0
  119. package/dist/hooks/use-emitter/use-emitter.types.d.ts +4 -0
  120. package/dist/hooks/use-emitter/use-emitter.types.d.ts.map +1 -0
  121. package/dist/hooks/use-fetch/index.d.ts +5 -0
  122. package/dist/hooks/use-fetch/index.d.ts.map +1 -0
  123. package/dist/hooks/use-fetch/use-fetch.constants.d.ts +8 -0
  124. package/dist/hooks/use-fetch/use-fetch.constants.d.ts.map +1 -0
  125. package/dist/hooks/use-fetch/use-fetch.hooks.d.ts +10 -0
  126. package/dist/hooks/use-fetch/use-fetch.hooks.d.ts.map +1 -0
  127. package/dist/hooks/use-fetch/use-fetch.types.d.ts +118 -0
  128. package/dist/hooks/use-fetch/use-fetch.types.d.ts.map +1 -0
  129. package/dist/hooks/use-fetch/use-fetch.utils.d.ts +2 -0
  130. package/dist/hooks/use-fetch/use-fetch.utils.d.ts.map +1 -0
  131. package/dist/hooks/use-listener/index.d.ts +3 -0
  132. package/dist/hooks/use-listener/index.d.ts.map +1 -0
  133. package/dist/hooks/use-listener/use-listener.hooks.d.ts +31 -0
  134. package/dist/hooks/use-listener/use-listener.hooks.d.ts.map +1 -0
  135. package/dist/hooks/use-listener/use-listener.types.d.ts +4 -0
  136. package/dist/hooks/use-listener/use-listener.types.d.ts.map +1 -0
  137. package/dist/hooks/use-queue/index.d.ts +4 -0
  138. package/dist/hooks/use-queue/index.d.ts.map +1 -0
  139. package/dist/hooks/use-queue/use-queue.constants.d.ts +4 -0
  140. package/dist/hooks/use-queue/use-queue.constants.d.ts.map +1 -0
  141. package/dist/hooks/use-queue/use-queue.hooks.d.ts +10 -0
  142. package/dist/hooks/use-queue/use-queue.hooks.d.ts.map +1 -0
  143. package/dist/hooks/use-queue/use-queue.types.d.ts +58 -0
  144. package/dist/hooks/use-queue/use-queue.types.d.ts.map +1 -0
  145. package/dist/hooks/use-stream/index.d.ts +3 -0
  146. package/dist/hooks/use-stream/index.d.ts.map +1 -0
  147. package/dist/hooks/use-stream/use-stream.hooks.d.ts +11 -0
  148. package/dist/hooks/use-stream/use-stream.hooks.d.ts.map +1 -0
  149. package/dist/hooks/use-stream/use-stream.types.d.ts +52 -0
  150. package/dist/hooks/use-stream/use-stream.types.d.ts.map +1 -0
  151. package/dist/hooks/use-submit/index.d.ts +4 -0
  152. package/dist/hooks/use-submit/index.d.ts.map +1 -0
  153. package/dist/hooks/use-submit/use-submit.constants.d.ts +8 -0
  154. package/dist/hooks/use-submit/use-submit.constants.d.ts.map +1 -0
  155. package/dist/hooks/use-submit/use-submit.hooks.d.ts +10 -0
  156. package/dist/hooks/use-submit/use-submit.hooks.d.ts.map +1 -0
  157. package/dist/hooks/use-submit/use-submit.types.d.ts +115 -0
  158. package/dist/hooks/use-submit/use-submit.types.d.ts.map +1 -0
  159. package/dist/index.d.ts +12 -733
  160. package/dist/index.d.ts.map +1 -0
  161. package/dist/index.mjs +1935 -0
  162. package/dist/index.mjs.map +1 -0
  163. package/dist/provider/index.d.ts +3 -0
  164. package/dist/provider/index.d.ts.map +1 -0
  165. package/dist/provider/provider.d.ts +13 -0
  166. package/dist/provider/provider.d.ts.map +1 -0
  167. package/dist/provider/provider.types.d.ts +31 -0
  168. package/dist/provider/provider.types.d.ts.map +1 -0
  169. package/dist/utils/bounce.utils.d.ts +8 -0
  170. package/dist/utils/bounce.utils.d.ts.map +1 -0
  171. package/dist/utils/deep-equal.utils.d.ts +14 -0
  172. package/dist/utils/deep-equal.utils.d.ts.map +1 -0
  173. package/dist/utils/index.d.ts +4 -0
  174. package/dist/utils/index.d.ts.map +1 -0
  175. package/dist/utils/tracked-proxy.utils.d.ts +7 -0
  176. package/dist/utils/tracked-proxy.utils.d.ts.map +1 -0
  177. package/package.json +21 -13
  178. package/project.json +4 -0
  179. package/src/helpers/use-request-events/use-request-events.hooks.ts +60 -14
  180. package/src/helpers/use-request-events/use-request-events.types.ts +19 -12
  181. package/src/helpers/use-socket-state/use-socket-state.constants.ts +2 -2
  182. package/src/helpers/use-socket-state/use-socket-state.hooks.ts +47 -13
  183. package/src/helpers/use-socket-state/use-socket-state.types.ts +1 -1
  184. package/src/helpers/use-tracked-state/use-tracked-state.constants.ts +1 -1
  185. package/src/helpers/use-tracked-state/use-tracked-state.hooks.ts +74 -22
  186. package/src/helpers/use-tracked-state/use-tracked-state.types.ts +7 -2
  187. package/src/helpers/use-tracked-state/use-tracked-state.utils.ts +39 -4
  188. package/src/hooks/use-app-manager/use-app-manager.hooks.ts +2 -2
  189. package/src/hooks/use-cache/use-cache.hooks.ts +33 -41
  190. package/src/hooks/use-cache/use-cache.types.ts +3 -3
  191. package/src/hooks/use-emitter/use-emitter.hooks.ts +17 -16
  192. package/src/hooks/use-fetch/use-fetch.constants.ts +5 -2
  193. package/src/hooks/use-fetch/use-fetch.hooks.ts +109 -51
  194. package/src/hooks/use-fetch/use-fetch.types.ts +18 -3
  195. package/src/hooks/use-listener/use-listener.hooks.ts +19 -27
  196. package/src/hooks/use-queue/use-queue.constants.ts +2 -2
  197. package/src/hooks/use-queue/use-queue.hooks.ts +25 -6
  198. package/src/hooks/use-queue/use-queue.types.ts +8 -2
  199. package/src/hooks/use-stream/index.ts +2 -0
  200. package/src/hooks/use-stream/use-stream.hooks.ts +164 -0
  201. package/src/hooks/use-stream/use-stream.types.ts +53 -0
  202. package/src/hooks/use-submit/use-submit.constants.ts +2 -2
  203. package/src/hooks/use-submit/use-submit.hooks.ts +43 -48
  204. package/src/hooks/use-submit/use-submit.types.ts +9 -9
  205. package/src/index.ts +1 -0
  206. package/src/provider/provider.tsx +1 -1
  207. package/src/provider/provider.types.ts +8 -8
  208. package/src/utils/index.ts +1 -0
  209. package/src/utils/tracked-proxy.utils.ts +19 -0
  210. package/tsconfig.json +1 -1
  211. package/vite.config.ts +45 -0
  212. package/.eslintrc.json +0 -11
  213. package/dist/index.js +0 -1541
  214. package/dist/index.js.map +0 -7
@@ -0,0 +1,372 @@
1
+ import { act, waitFor } from "@testing-library/react";
2
+ import type { AdapterInstance, ResponseType } from "@hyper-fetch/core";
3
+ import { xhrExtra } from "@hyper-fetch/core";
4
+ import { createHttpMockingServer, sleep } from "@hyper-fetch/testing";
5
+
6
+ import { createRequest, renderUseFetch, createCacheData, client } from "../../utils";
7
+ import { testSuccessState, testErrorState, testInitialState, testCacheState, testClientIsolation } from "../../shared";
8
+
9
+ const { resetMocks, startServer, stopServer, mockRequest } = createHttpMockingServer();
10
+
11
+ describe("useFetch [ Base ]", () => {
12
+ let request = createRequest();
13
+
14
+ beforeAll(() => {
15
+ startServer();
16
+ });
17
+
18
+ afterEach(() => {
19
+ resetMocks();
20
+ });
21
+
22
+ afterAll(() => {
23
+ stopServer();
24
+ });
25
+
26
+ beforeEach(() => {
27
+ vi.resetModules();
28
+ request = createRequest();
29
+ client.clear();
30
+ });
31
+
32
+ describe("when hook is initialized", () => {
33
+ it("should initialize in loading state", async () => {
34
+ await testClientIsolation(client);
35
+ mockRequest(request);
36
+ const view = renderUseFetch(request);
37
+
38
+ testInitialState(view);
39
+ });
40
+ it("should load cached data", async () => {
41
+ await testClientIsolation(client);
42
+ const mock = mockRequest(request);
43
+ const [cache] = createCacheData(request, {
44
+ data: {
45
+ data: mock,
46
+ error: null,
47
+ status: 200,
48
+ success: true,
49
+ extra: xhrExtra,
50
+ responseTimestamp: +new Date(),
51
+ requestTimestamp: +new Date(),
52
+ },
53
+ details: {
54
+ retries: 2,
55
+ },
56
+ });
57
+ const view = renderUseFetch(request);
58
+ await testCacheState(cache, view);
59
+ });
60
+ it("should not load stale cache data", async () => {
61
+ await testClientIsolation(client);
62
+ const timestamp = +new Date() - 11;
63
+ const mock = mockRequest(request, { delay: 50 });
64
+ act(() => {
65
+ createCacheData(request, {
66
+ data: {
67
+ data: mock,
68
+ error: null,
69
+ status: 200,
70
+ success: true,
71
+ extra: xhrExtra,
72
+ responseTimestamp: timestamp,
73
+ requestTimestamp: timestamp,
74
+ },
75
+ details: {
76
+ triggerTimestamp: timestamp,
77
+ responseTimestamp: timestamp,
78
+ requestTimestamp: timestamp,
79
+ retries: 3,
80
+ },
81
+ });
82
+ });
83
+
84
+ const view = renderUseFetch(request.setStaleTime(10));
85
+
86
+ await testCacheState(
87
+ {
88
+ data: null,
89
+ error: null,
90
+ status: null,
91
+ success: true,
92
+ extra: xhrExtra,
93
+ responseTimestamp: timestamp,
94
+ requestTimestamp: timestamp,
95
+ },
96
+ view,
97
+ );
98
+ });
99
+ it("should allow to use initial data", async () => {
100
+ await testClientIsolation(client);
101
+ const initialResponse: ResponseType<unknown, Error, AdapterInstance> = {
102
+ data: { test: [1, 2, 3] },
103
+ error: null,
104
+ status: 200,
105
+ success: true,
106
+ extra: { headers: { "content-type": "application/json" } },
107
+ responseTimestamp: +new Date(),
108
+ requestTimestamp: +new Date(),
109
+ };
110
+ const view = renderUseFetch(request, { disabled: true, initialResponse });
111
+
112
+ expect(view.result.current.data).toEqual(initialResponse.data);
113
+ await testSuccessState(initialResponse.data, view);
114
+ });
115
+ it("should allow to use initial data while requesting", async () => {
116
+ await testClientIsolation(client);
117
+ mockRequest(request);
118
+ const initialResponse: ResponseType<unknown, Error, AdapterInstance> = {
119
+ data: { test: [1, 2, 3] },
120
+ error: null,
121
+ status: 200,
122
+ success: true,
123
+ extra: { headers: { "content-type": "application/json" } },
124
+ responseTimestamp: +new Date(),
125
+ requestTimestamp: +new Date(),
126
+ };
127
+ const view = renderUseFetch(request, { initialResponse });
128
+ expect(view.result.current.data).toEqual(initialResponse.data);
129
+ });
130
+ it("should prefer cache data over initial data", async () => {
131
+ // Todo
132
+ });
133
+ it("should make only one request", async () => {
134
+ const spy = vi.spyOn(client.adapter, "fetch");
135
+ await testClientIsolation(client);
136
+ const mock = mockRequest(request);
137
+ const view = renderUseFetch(request);
138
+
139
+ await testSuccessState(mock, view);
140
+ await act(async () => {
141
+ await sleep(50);
142
+ });
143
+ expect(spy).toHaveBeenCalledTimes(1);
144
+ });
145
+ });
146
+ describe("when hook get success response", () => {
147
+ it("should set state with success data", async () => {
148
+ await testClientIsolation(client);
149
+ const mock = mockRequest(request);
150
+ const view = renderUseFetch(request);
151
+
152
+ await testSuccessState(mock, view);
153
+ });
154
+ it("should map the data on deps change", async () => {
155
+ mockRequest(request);
156
+ const request1 = request
157
+ .setCacheKey("request1")
158
+ .setResponseMapper((response) => ({ ...response, data: 1 }) as typeof response);
159
+ const request2 = request
160
+ .setCacheKey("request2")
161
+ .setResponseMapper((response) => ({ ...response, data: 2 }) as typeof response);
162
+
163
+ const { result, rerender } = renderUseFetch(request1);
164
+
165
+ act(() => {
166
+ rerender({ request: request2 });
167
+ rerender({ request: request1 });
168
+ result.current.refetch();
169
+ });
170
+
171
+ await waitFor(() => {
172
+ expect(result.current.data).toBe(1);
173
+ expect(result.current.error).toBe(null);
174
+ });
175
+
176
+ act(() => {
177
+ rerender({ request: request2 });
178
+ result.current.refetch();
179
+ });
180
+
181
+ await waitFor(() => {
182
+ expect(result.current.data).toBe(2);
183
+ expect(result.current.error).toBe(null);
184
+ });
185
+ });
186
+ it("should clear previous error state once success response is returned", async () => {
187
+ await testClientIsolation(client);
188
+ const errorMock = mockRequest(request, { status: 400 });
189
+ const view = renderUseFetch(request);
190
+
191
+ await testErrorState(errorMock, view);
192
+ const mock = mockRequest(request);
193
+
194
+ act(() => {
195
+ view.result.current.refetch();
196
+ });
197
+
198
+ await testSuccessState(mock, view);
199
+ });
200
+ it("should change loading to false on success", async () => {
201
+ // Todo
202
+ });
203
+ it("should map response data", async () => {
204
+ const mappedData = { test: 1, test2: 2, test3: 3 };
205
+ const mappedRequest = request.setResponseMapper(
206
+ (response) =>
207
+ ({
208
+ ...response,
209
+ data: mappedData,
210
+ }) as typeof response,
211
+ );
212
+ mockRequest(mappedRequest);
213
+ const view = renderUseFetch(mappedRequest);
214
+
215
+ await testSuccessState(mappedData, view);
216
+ });
217
+ it("should map async response data", async () => {
218
+ const spy = vi.fn();
219
+ const mappedData = { test: 1, test2: 2, test3: 3 };
220
+ const mappedRequest = request.setResponseMapper(
221
+ async (response) =>
222
+ ({
223
+ ...response,
224
+ data: mappedData,
225
+ }) as typeof response,
226
+ );
227
+ mockRequest(mappedRequest);
228
+ const view = renderUseFetch(mappedRequest, { disabled: true });
229
+
230
+ act(() => {
231
+ view.result.current.onSuccess(() => {
232
+ expect(view.result.current.data).toEqual(null);
233
+ spy();
234
+ });
235
+ view.rerender({ disabled: false });
236
+ });
237
+
238
+ await waitFor(() => {
239
+ expect(spy).toHaveBeenCalledTimes(1);
240
+ });
241
+ await testSuccessState(mappedData, view);
242
+ });
243
+ });
244
+ describe("when hook get error response", () => {
245
+ it("should set state with error data", async () => {
246
+ await testClientIsolation(client);
247
+ const mock = mockRequest(request, { status: 400 });
248
+ const view = renderUseFetch(request);
249
+
250
+ await testErrorState(mock, view);
251
+ });
252
+ it("should keep previous success state once error response is returned", async () => {
253
+ await testClientIsolation(client);
254
+ const mock = mockRequest(request);
255
+ const view = renderUseFetch(request);
256
+
257
+ await testSuccessState(mock, view);
258
+
259
+ const errorMock = mockRequest(request, { status: 400 });
260
+
261
+ act(() => {
262
+ view.result.current.refetch();
263
+ });
264
+
265
+ await testErrorState(errorMock, view, mock);
266
+ });
267
+ it("should change loading to false on error", async () => {
268
+ // Todo
269
+ });
270
+ });
271
+ describe("when dependencies change", () => {
272
+ // Solves Issue #22
273
+ it("should fetch data when disabled prop changes", async () => {
274
+ const spy = vi.fn();
275
+ await testClientIsolation(client);
276
+ const mock = mockRequest(request);
277
+ const view = renderUseFetch(request, { disabled: true });
278
+
279
+ act(() => {
280
+ view.result.current.onRequestStart(spy);
281
+ });
282
+
283
+ await sleep(20);
284
+ expect(spy).toHaveBeenCalledTimes(0);
285
+
286
+ view.rerender({ disabled: false });
287
+
288
+ await testSuccessState(mock, view);
289
+ expect(spy).toHaveBeenCalledTimes(1);
290
+ });
291
+ it("should fetch when dependencies change", async () => {
292
+ // Todo
293
+ });
294
+ });
295
+
296
+ // GitHub Issue #126
297
+ describe("when query parameters change", () => {
298
+ it("should reset loading to true when query params change and no cache exists for new key", async () => {
299
+ await testClientIsolation(client);
300
+
301
+ const paginatedRequest = createRequest({ endpoint: "/items" });
302
+
303
+ const page1Request = paginatedRequest.setQueryParams({ page: "1" } as any);
304
+ mockRequest(page1Request, { data: { items: [1, 2, 3] } });
305
+
306
+ const view = renderUseFetch(page1Request);
307
+
308
+ await waitFor(() => {
309
+ expect(view.result.current.data).toStrictEqual({ items: [1, 2, 3] });
310
+ expect(view.result.current.loading).toBe(false);
311
+ });
312
+
313
+ const page2Request = paginatedRequest.setQueryParams({ page: "2" } as any);
314
+ mockRequest(page2Request, { data: { items: [4, 5, 6] }, delay: 100 });
315
+
316
+ view.rerender({ request: page2Request });
317
+
318
+ await waitFor(() => {
319
+ expect(view.result.current.loading).toBe(true);
320
+ });
321
+
322
+ await waitFor(() => {
323
+ expect(view.result.current.data).toStrictEqual({ items: [4, 5, 6] });
324
+ expect(view.result.current.loading).toBe(false);
325
+ });
326
+ });
327
+
328
+ it("should reset loading to true on each subsequent query param change", async () => {
329
+ await testClientIsolation(client);
330
+
331
+ const paginatedRequest = createRequest({ endpoint: "/posts" });
332
+
333
+ const page1 = paginatedRequest.setQueryParams({ page: "1" } as any);
334
+ mockRequest(page1, { data: { page: 1 } });
335
+
336
+ const view = renderUseFetch(page1);
337
+
338
+ await waitFor(() => {
339
+ expect(view.result.current.data).toStrictEqual({ page: 1 });
340
+ expect(view.result.current.loading).toBe(false);
341
+ });
342
+
343
+ const page2 = paginatedRequest.setQueryParams({ page: "2" } as any);
344
+ mockRequest(page2, { data: { page: 2 }, delay: 100 });
345
+
346
+ view.rerender({ request: page2 });
347
+
348
+ await waitFor(() => {
349
+ expect(view.result.current.loading).toBe(true);
350
+ });
351
+
352
+ await waitFor(() => {
353
+ expect(view.result.current.data).toStrictEqual({ page: 2 });
354
+ expect(view.result.current.loading).toBe(false);
355
+ });
356
+
357
+ const page3 = paginatedRequest.setQueryParams({ page: "3" } as any);
358
+ mockRequest(page3, { data: { page: 3 }, delay: 100 });
359
+
360
+ view.rerender({ request: page3 });
361
+
362
+ await waitFor(() => {
363
+ expect(view.result.current.loading).toBe(true);
364
+ });
365
+
366
+ await waitFor(() => {
367
+ expect(view.result.current.data).toStrictEqual({ page: 3 });
368
+ expect(view.result.current.loading).toBe(false);
369
+ });
370
+ });
371
+ });
372
+ });
@@ -0,0 +1,83 @@
1
+ import { getErrorMessage } from "@hyper-fetch/core";
2
+ import { act, waitFor } from "@testing-library/react";
3
+ import { createHttpMockingServer } from "@hyper-fetch/testing";
4
+
5
+ import { testErrorState } from "../../shared";
6
+ import { client, createRequest, renderUseFetch, waitForRender } from "../../utils";
7
+
8
+ const { resetMocks, startServer, stopServer, mockRequest } = createHttpMockingServer();
9
+
10
+ describe("useFetch [ Cancel ]", () => {
11
+ let request = createRequest({ cacheKey: "test", queryKey: "testQueue", cancelable: true });
12
+
13
+ beforeAll(() => {
14
+ startServer();
15
+ });
16
+
17
+ afterEach(() => {
18
+ resetMocks();
19
+ });
20
+
21
+ afterAll(() => {
22
+ stopServer();
23
+ });
24
+
25
+ beforeEach(() => {
26
+ vi.resetModules();
27
+ request = createRequest({ cacheKey: "test", queryKey: "testQueue", cancelable: true });
28
+ client.clear();
29
+ });
30
+
31
+ describe("given request is cancelable", () => {
32
+ describe("when aborting request", () => {
33
+ it("should allow to cancel the ongoing request", async () => {
34
+ mockRequest(request, { delay: 40 });
35
+ const response = renderUseFetch(request);
36
+
37
+ await waitForRender();
38
+
39
+ act(() => {
40
+ response.result.current.abort();
41
+ });
42
+
43
+ await testErrorState(getErrorMessage("abort"), response);
44
+ });
45
+
46
+ it("should allow to cancel deduplicated request", async () => {
47
+ mockRequest(request, { delay: 100 });
48
+ const response = renderUseFetch(request);
49
+ await waitForRender();
50
+ const dedupeResponse = renderUseFetch(request);
51
+ await waitForRender();
52
+
53
+ await act(() => {
54
+ dedupeResponse.result.current.abort();
55
+ });
56
+
57
+ await testErrorState(getErrorMessage("abort"), response);
58
+ await testErrorState(getErrorMessage("abort"), dedupeResponse);
59
+ });
60
+ it("should cancel previous requests when dependencies change", async () => {
61
+ const spy = vi.fn();
62
+
63
+ mockRequest(request, { delay: 50 });
64
+ const response = renderUseFetch(request, { dependencies: [{}] });
65
+ await waitForRender(1);
66
+
67
+ act(() => {
68
+ const params = { page: 1 };
69
+ response.result.current.onAbort(spy);
70
+ response.rerender({ request, dependencies: [params] });
71
+ });
72
+ await waitForRender();
73
+
74
+ await waitFor(() => {
75
+ expect(spy).toHaveBeenCalledTimes(1);
76
+ });
77
+ });
78
+ });
79
+ it("should clear request from dispatcher's queue on abort", async () => {
80
+ // TODO
81
+ });
82
+ });
83
+ });
@@ -0,0 +1,82 @@
1
+ import { act, waitFor } from "@testing-library/react";
2
+ import { createHttpMockingServer } from "@hyper-fetch/testing";
3
+
4
+ import { client, createRequest, renderUseFetch } from "../../utils";
5
+
6
+ const { resetMocks, startServer, stopServer, mockRequest } = createHttpMockingServer();
7
+
8
+ describe("useFetch [ clearState ]", () => {
9
+ let request = createRequest();
10
+
11
+ beforeAll(() => {
12
+ startServer();
13
+ });
14
+
15
+ afterEach(() => {
16
+ resetMocks();
17
+ });
18
+
19
+ afterAll(() => {
20
+ stopServer();
21
+ });
22
+
23
+ beforeEach(() => {
24
+ vi.resetModules();
25
+ request = createRequest();
26
+ client.clear();
27
+ });
28
+
29
+ describe("when clearState is called", () => {
30
+ it("should reset all state fields to initial values after successful fetch", async () => {
31
+ const mock = mockRequest(request, { data: { name: "test" } });
32
+ const view = renderUseFetch(request);
33
+
34
+ await waitFor(() => {
35
+ expect(view.result.current.data).toStrictEqual(mock);
36
+ expect(view.result.current.success).toBeTrue();
37
+ });
38
+
39
+ act(() => {
40
+ view.result.current.clearState();
41
+ });
42
+
43
+ await waitFor(() => {
44
+ expect(view.result.current.data).toBeNull();
45
+ expect(view.result.current.error).toBeNull();
46
+ expect(view.result.current.status).toBeNull();
47
+ expect(view.result.current.success).toBeFalse();
48
+ expect(view.result.current.loading).toBeFalse();
49
+ expect(view.result.current.retries).toBe(0);
50
+ expect(view.result.current.responseTimestamp).toBeNull();
51
+ expect(view.result.current.requestTimestamp).toBeNull();
52
+ });
53
+ });
54
+
55
+ it("should reset all state fields after error response", async () => {
56
+ mockRequest(request, { status: 400 });
57
+ const view = renderUseFetch(request);
58
+
59
+ await waitFor(() => {
60
+ expect(view.result.current.error).toBeDefined();
61
+ expect(view.result.current.success).toBeFalse();
62
+ });
63
+
64
+ act(() => {
65
+ view.result.current.clearState();
66
+ });
67
+
68
+ await waitFor(() => {
69
+ expect(view.result.current.data).toBeNull();
70
+ expect(view.result.current.error).toBeNull();
71
+ expect(view.result.current.status).toBeNull();
72
+ expect(view.result.current.success).toBeFalse();
73
+ expect(view.result.current.loading).toBeFalse();
74
+ });
75
+ });
76
+
77
+ it("should be a callable function", () => {
78
+ const view = renderUseFetch(request);
79
+ expect(view.result.current.clearState).toBeFunction();
80
+ });
81
+ });
82
+ });
@@ -0,0 +1,91 @@
1
+ import { act } from "@testing-library/react";
2
+ import { createHttpMockingServer } from "@hyper-fetch/testing";
3
+
4
+ import { testSuccessState } from "../../shared";
5
+ import { client, createRequest, renderUseFetch, waitForRender } from "../../utils";
6
+
7
+ const { resetMocks, startServer, stopServer, mockRequest } = createHttpMockingServer();
8
+
9
+ describe("useFetch [ Concurrency ]", () => {
10
+ let request = createRequest();
11
+
12
+ beforeAll(() => {
13
+ startServer();
14
+ });
15
+
16
+ afterEach(() => {
17
+ resetMocks();
18
+ });
19
+
20
+ afterAll(() => {
21
+ stopServer();
22
+ });
23
+
24
+ beforeEach(() => {
25
+ vi.resetModules();
26
+ request = createRequest();
27
+ client.clear();
28
+ });
29
+
30
+ describe("given multiple rendered hooks", () => {
31
+ describe("when used the same non-dedupe requests", () => {
32
+ it("should allow to trigger request for each hook", async () => {
33
+ const spyOne = vi.fn();
34
+ const spyTwo = vi.fn();
35
+
36
+ const mock = mockRequest(request);
37
+ const responseOne = renderUseFetch(request.setQueryKey("1"));
38
+ const responseTwo = renderUseFetch(request.setQueryKey("2"));
39
+
40
+ act(() => {
41
+ responseOne.result.current.onRequestStart(spyOne);
42
+ responseTwo.result.current.onRequestStart(spyTwo);
43
+ });
44
+
45
+ await testSuccessState(mock, responseOne);
46
+ await testSuccessState(mock, responseTwo);
47
+
48
+ expect(spyOne).toHaveBeenCalledTimes(1);
49
+ expect(spyTwo).toHaveBeenCalledTimes(1);
50
+ });
51
+ it("should start in loading mode when request is already handled by the queue", async () => {
52
+ mockRequest(request);
53
+ act(() => {
54
+ client.fetchDispatcher.add(request);
55
+ });
56
+ const { result } = renderUseFetch(request);
57
+ expect(result.current.loading).toBeTrue();
58
+ await waitForRender();
59
+ expect(result.current.loading).toBeTrue();
60
+ });
61
+ it("should not start in loading mode when queue is paused", async () => {
62
+ act(() => {
63
+ const queueElement = client.fetchDispatcher.createStorageItem(request);
64
+ client.fetchDispatcher.addQueueItem(request.queryKey, queueElement);
65
+ client.fetchDispatcher.stop(request.queryKey);
66
+ });
67
+ mockRequest(request);
68
+ const { result } = renderUseFetch(request);
69
+ expect(result.current.loading).toBeFalse();
70
+ await waitForRender();
71
+ expect(result.current.loading).toBeFalse();
72
+ });
73
+ it("should share data between hooks", async () => {
74
+ const mock = mockRequest(request);
75
+ const responseOne = renderUseFetch(request);
76
+ await testSuccessState(mock, responseOne);
77
+
78
+ const responseTwo = renderUseFetch(request, { revalidate: false });
79
+ await testSuccessState(mock, responseTwo);
80
+ });
81
+ it("should share data with disabled hook", async () => {
82
+ const mock = mockRequest(request);
83
+ const responseOne = renderUseFetch(request);
84
+ const responseTwo = renderUseFetch(request, { disabled: true });
85
+
86
+ await testSuccessState(mock, responseOne);
87
+ await testSuccessState(mock, responseTwo);
88
+ });
89
+ });
90
+ });
91
+ });