@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,481 @@
1
+ import { renderHook, act, waitFor } from "@testing-library/react";
2
+
3
+ import { useStream } from "hooks/use-stream";
4
+ import { client } from "../../utils";
5
+
6
+ const createStreamRequest = () => {
7
+ return client.createRequest<{ response: any }>()({
8
+ endpoint: "/stream-endpoint" as any,
9
+ method: "GET",
10
+ });
11
+ };
12
+
13
+ const createReadableStream = (chunks: string[]) => {
14
+ const encoder = new TextEncoder();
15
+ let index = 0;
16
+
17
+ return new ReadableStream<Uint8Array>({
18
+ pull(controller) {
19
+ if (index < chunks.length) {
20
+ controller.enqueue(encoder.encode(chunks[index]));
21
+ index += 1;
22
+ } else {
23
+ controller.close();
24
+ }
25
+ },
26
+ });
27
+ };
28
+
29
+ const createFailingReadableStream = (errorMessage: string) => {
30
+ return new ReadableStream<Uint8Array>({
31
+ start(controller) {
32
+ controller.error(new Error(errorMessage));
33
+ },
34
+ });
35
+ };
36
+
37
+ const renderUseStream = (request: any, options?: { autoStart?: boolean }) => {
38
+ return renderHook(() => useStream(request, options));
39
+ };
40
+
41
+ describe("useStream [ Base ]", () => {
42
+ let request = createStreamRequest();
43
+
44
+ beforeEach(() => {
45
+ vi.resetModules();
46
+ client.clear();
47
+ request = createStreamRequest();
48
+ });
49
+
50
+ describe("when hook is initialized", () => {
51
+ it("should have initial state", () => {
52
+ const { result } = renderUseStream(request);
53
+
54
+ expect(result.current.text).toBe("");
55
+ expect(result.current.chunks).toEqual([]);
56
+ expect(result.current.streaming).toBe(false);
57
+ expect(result.current.done).toBe(false);
58
+ expect(result.current.error).toBe(null);
59
+ expect(result.current.extra).toBe(null);
60
+ expect(result.current.status).toBe(null);
61
+ expect(typeof result.current.start).toBe("function");
62
+ expect(typeof result.current.abort).toBe("function");
63
+ expect(typeof result.current.reset).toBe("function");
64
+ });
65
+ });
66
+
67
+ describe("when start is called with a ReadableStream response", () => {
68
+ it("should stream text chunks and set done when complete", async () => {
69
+ const chunks = ["Hello ", "World", "!"];
70
+ const stream = createReadableStream(chunks);
71
+
72
+ const sendMock = vi.fn().mockResolvedValue({
73
+ data: stream,
74
+ error: null,
75
+ status: 200,
76
+ extra: { headers: {} },
77
+ });
78
+
79
+ const mockRequest = {
80
+ ...request,
81
+ setOptions: vi.fn().mockReturnValue({
82
+ send: sendMock,
83
+ }),
84
+ client: request.client,
85
+ abortKey: request.abortKey,
86
+ scope: request.scope,
87
+ };
88
+
89
+ const { result } = renderUseStream(mockRequest);
90
+
91
+ await act(async () => {
92
+ result.current.start();
93
+ });
94
+
95
+ await waitFor(() => {
96
+ expect(result.current.done).toBe(true);
97
+ });
98
+
99
+ expect(result.current.text).toBe("Hello World!");
100
+ expect(result.current.chunks).toHaveLength(3);
101
+ expect(result.current.streaming).toBe(false);
102
+ expect(result.current.status).toBe(200);
103
+ expect(result.current.extra).toEqual({ headers: {} });
104
+ expect(result.current.error).toBe(null);
105
+ });
106
+
107
+ it("should set streaming to true while consuming", async () => {
108
+ let resolvePull: (() => void) | null = null;
109
+ const pullPromise = new Promise<void>((r) => {
110
+ resolvePull = r;
111
+ });
112
+
113
+ const encoder = new TextEncoder();
114
+ const stream = new ReadableStream<Uint8Array>({
115
+ async pull(controller) {
116
+ controller.enqueue(encoder.encode("data"));
117
+ await pullPromise;
118
+ controller.close();
119
+ },
120
+ });
121
+
122
+ const sendMock = vi.fn().mockResolvedValue({
123
+ data: stream,
124
+ error: null,
125
+ status: 200,
126
+ extra: null,
127
+ });
128
+
129
+ const mockRequest = {
130
+ ...request,
131
+ setOptions: vi.fn().mockReturnValue({ send: sendMock }),
132
+ client: request.client,
133
+ abortKey: request.abortKey,
134
+ scope: request.scope,
135
+ };
136
+
137
+ const { result } = renderUseStream(mockRequest);
138
+
139
+ act(() => {
140
+ result.current.start();
141
+ });
142
+
143
+ await waitFor(() => {
144
+ expect(result.current.streaming).toBe(true);
145
+ });
146
+
147
+ await act(async () => {
148
+ resolvePull!();
149
+ });
150
+
151
+ await waitFor(() => {
152
+ expect(result.current.streaming).toBe(false);
153
+ expect(result.current.done).toBe(true);
154
+ });
155
+ });
156
+ });
157
+
158
+ describe("when start is called and response has an error", () => {
159
+ it("should set error state", async () => {
160
+ const errorData = { message: "Server error" };
161
+
162
+ const sendMock = vi.fn().mockResolvedValue({
163
+ data: null,
164
+ error: errorData,
165
+ status: 500,
166
+ extra: { headers: {} },
167
+ });
168
+
169
+ const mockRequest = {
170
+ ...request,
171
+ setOptions: vi.fn().mockReturnValue({ send: sendMock }),
172
+ client: request.client,
173
+ abortKey: request.abortKey,
174
+ scope: request.scope,
175
+ };
176
+
177
+ const { result } = renderUseStream(mockRequest);
178
+
179
+ await act(async () => {
180
+ result.current.start();
181
+ });
182
+
183
+ await waitFor(() => {
184
+ expect(result.current.error).toEqual(errorData);
185
+ });
186
+
187
+ expect(result.current.streaming).toBe(false);
188
+ expect(result.current.status).toBe(500);
189
+ expect(result.current.extra).toEqual({ headers: {} });
190
+ });
191
+ });
192
+
193
+ describe("when response data is a plain string (non-stream fallback)", () => {
194
+ it("should set text directly from the string data", async () => {
195
+ const sendMock = vi.fn().mockResolvedValue({
196
+ data: "plain text response",
197
+ error: null,
198
+ status: 200,
199
+ extra: null,
200
+ });
201
+
202
+ const mockRequest = {
203
+ ...request,
204
+ setOptions: vi.fn().mockReturnValue({ send: sendMock }),
205
+ client: request.client,
206
+ abortKey: request.abortKey,
207
+ scope: request.scope,
208
+ };
209
+
210
+ const { result } = renderUseStream(mockRequest);
211
+
212
+ await act(async () => {
213
+ result.current.start();
214
+ });
215
+
216
+ await waitFor(() => {
217
+ expect(result.current.done).toBe(true);
218
+ });
219
+
220
+ expect(result.current.text).toBe("plain text response");
221
+ expect(result.current.streaming).toBe(false);
222
+ });
223
+ });
224
+
225
+ describe("when response data is a non-string value (JSON.stringify fallback)", () => {
226
+ it("should JSON.stringify the data", async () => {
227
+ const objectData = { key: "value", num: 42 };
228
+
229
+ const sendMock = vi.fn().mockResolvedValue({
230
+ data: objectData,
231
+ error: null,
232
+ status: 200,
233
+ extra: null,
234
+ });
235
+
236
+ const mockRequest = {
237
+ ...request,
238
+ setOptions: vi.fn().mockReturnValue({ send: sendMock }),
239
+ client: request.client,
240
+ abortKey: request.abortKey,
241
+ scope: request.scope,
242
+ };
243
+
244
+ const { result } = renderUseStream(mockRequest);
245
+
246
+ await act(async () => {
247
+ result.current.start();
248
+ });
249
+
250
+ await waitFor(() => {
251
+ expect(result.current.done).toBe(true);
252
+ });
253
+
254
+ expect(result.current.text).toBe(JSON.stringify(objectData));
255
+ expect(result.current.streaming).toBe(false);
256
+ });
257
+ });
258
+
259
+ describe("when stream reader throws an error", () => {
260
+ it("should set error state from the reader exception", async () => {
261
+ const stream = createFailingReadableStream("Stream read error");
262
+
263
+ const sendMock = vi.fn().mockResolvedValue({
264
+ data: stream,
265
+ error: null,
266
+ status: 200,
267
+ extra: null,
268
+ });
269
+
270
+ const mockRequest = {
271
+ ...request,
272
+ setOptions: vi.fn().mockReturnValue({ send: sendMock }),
273
+ client: request.client,
274
+ abortKey: request.abortKey,
275
+ scope: request.scope,
276
+ };
277
+
278
+ const { result } = renderUseStream(mockRequest);
279
+
280
+ await act(async () => {
281
+ result.current.start();
282
+ });
283
+
284
+ await waitFor(() => {
285
+ expect(result.current.error).toBeTruthy();
286
+ });
287
+
288
+ expect(result.current.streaming).toBe(false);
289
+ });
290
+ });
291
+
292
+ describe("when abort is called", () => {
293
+ it("should stop streaming", async () => {
294
+ let resolvePull: (() => void) | null = null;
295
+ const pullPromise = new Promise<void>((r) => {
296
+ resolvePull = r;
297
+ });
298
+
299
+ const encoder = new TextEncoder();
300
+ const stream = new ReadableStream<Uint8Array>({
301
+ async pull(controller) {
302
+ controller.enqueue(encoder.encode("chunk"));
303
+ await pullPromise;
304
+ controller.close();
305
+ },
306
+ });
307
+
308
+ const abortSpy = vi.fn();
309
+
310
+ const sendMock = vi.fn().mockResolvedValue({
311
+ data: stream,
312
+ error: null,
313
+ status: 200,
314
+ extra: null,
315
+ });
316
+
317
+ const mockRequest = {
318
+ ...request,
319
+ setOptions: vi.fn().mockReturnValue({ send: sendMock }),
320
+ client: {
321
+ ...request.client,
322
+ requestManager: {
323
+ ...request.client.requestManager,
324
+ abortByKey: abortSpy,
325
+ },
326
+ },
327
+ abortKey: request.abortKey,
328
+ scope: request.scope,
329
+ };
330
+
331
+ const { result } = renderUseStream(mockRequest);
332
+
333
+ act(() => {
334
+ result.current.start();
335
+ });
336
+
337
+ await waitFor(() => {
338
+ expect(result.current.streaming).toBe(true);
339
+ });
340
+
341
+ act(() => {
342
+ result.current.abort();
343
+ });
344
+
345
+ expect(result.current.streaming).toBe(false);
346
+ expect(abortSpy).toHaveBeenCalled();
347
+
348
+ await act(async () => {
349
+ resolvePull!();
350
+ });
351
+ });
352
+ });
353
+
354
+ describe("when reset is called", () => {
355
+ it("should reset all state to initial values", async () => {
356
+ const sendMock = vi.fn().mockResolvedValue({
357
+ data: "some data",
358
+ error: null,
359
+ status: 200,
360
+ extra: { headers: {} },
361
+ });
362
+
363
+ const mockRequest = {
364
+ ...request,
365
+ setOptions: vi.fn().mockReturnValue({ send: sendMock }),
366
+ client: request.client,
367
+ abortKey: request.abortKey,
368
+ scope: request.scope,
369
+ };
370
+
371
+ const { result } = renderUseStream(mockRequest);
372
+
373
+ await act(async () => {
374
+ result.current.start();
375
+ });
376
+
377
+ await waitFor(() => {
378
+ expect(result.current.done).toBe(true);
379
+ });
380
+
381
+ expect(result.current.text).toBe("some data");
382
+
383
+ act(() => {
384
+ result.current.reset();
385
+ });
386
+
387
+ expect(result.current.text).toBe("");
388
+ expect(result.current.chunks).toEqual([]);
389
+ expect(result.current.streaming).toBe(false);
390
+ expect(result.current.done).toBe(false);
391
+ expect(result.current.error).toBe(null);
392
+ expect(result.current.extra).toBe(null);
393
+ expect(result.current.status).toBe(null);
394
+ });
395
+ });
396
+
397
+ describe("when autoStart is true", () => {
398
+ it("should start streaming automatically on mount", async () => {
399
+ const sendMock = vi.fn().mockResolvedValue({
400
+ data: "auto-started",
401
+ error: null,
402
+ status: 200,
403
+ extra: null,
404
+ });
405
+
406
+ const mockRequest = {
407
+ ...request,
408
+ setOptions: vi.fn().mockReturnValue({ send: sendMock }),
409
+ client: request.client,
410
+ abortKey: request.abortKey,
411
+ scope: request.scope,
412
+ };
413
+
414
+ const { result } = renderUseStream(mockRequest, { autoStart: true });
415
+
416
+ await waitFor(() => {
417
+ expect(result.current.done).toBe(true);
418
+ });
419
+
420
+ expect(result.current.text).toBe("auto-started");
421
+ expect(sendMock).toHaveBeenCalled();
422
+ });
423
+ });
424
+
425
+ describe("when start is called while already streaming", () => {
426
+ it("should not start a second stream", async () => {
427
+ let resolvePull: (() => void) | null = null;
428
+ const pullPromise = new Promise<void>((r) => {
429
+ resolvePull = r;
430
+ });
431
+
432
+ const encoder = new TextEncoder();
433
+ const stream = new ReadableStream<Uint8Array>({
434
+ async pull(controller) {
435
+ controller.enqueue(encoder.encode("data"));
436
+ await pullPromise;
437
+ controller.close();
438
+ },
439
+ });
440
+
441
+ const sendMock = vi.fn().mockResolvedValue({
442
+ data: stream,
443
+ error: null,
444
+ status: 200,
445
+ extra: null,
446
+ });
447
+
448
+ const mockRequest = {
449
+ ...request,
450
+ setOptions: vi.fn().mockReturnValue({ send: sendMock }),
451
+ client: request.client,
452
+ abortKey: request.abortKey,
453
+ scope: request.scope,
454
+ };
455
+
456
+ const { result } = renderUseStream(mockRequest);
457
+
458
+ act(() => {
459
+ result.current.start();
460
+ });
461
+
462
+ await waitFor(() => {
463
+ expect(result.current.streaming).toBe(true);
464
+ });
465
+
466
+ act(() => {
467
+ result.current.start();
468
+ });
469
+
470
+ expect(sendMock).toHaveBeenCalledTimes(1);
471
+
472
+ await act(async () => {
473
+ resolvePull!();
474
+ });
475
+
476
+ await waitFor(() => {
477
+ expect(result.current.done).toBe(true);
478
+ });
479
+ });
480
+ });
481
+ });
@@ -0,0 +1,76 @@
1
+ import { act, waitFor } from "@testing-library/react";
2
+ import { createHttpMockingServer } from "@hyper-fetch/testing";
3
+
4
+ import { client, createRequest, renderUseSubmit, waitForRender } from "../../utils";
5
+ import { testInitialState, testSuccessState } from "../../shared";
6
+
7
+ const { resetMocks, startServer, stopServer, mockRequest } = createHttpMockingServer();
8
+
9
+ describe("useSubmit [ Base ]", () => {
10
+ let request = createRequest({ method: "POST" });
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
+ client.clear();
27
+ request = createRequest({ method: "POST" });
28
+ });
29
+
30
+ describe("when submit method gets triggered", () => {
31
+ it("should not trigger request on mount", async () => {
32
+ mockRequest(request);
33
+ const response = renderUseSubmit(request);
34
+
35
+ await waitForRender(100);
36
+ await testInitialState(response);
37
+ });
38
+ it("should trigger request with submit method", async () => {
39
+ const mock = mockRequest(request);
40
+ const response = renderUseSubmit(request);
41
+
42
+ act(() => {
43
+ response.result.current.submit();
44
+ });
45
+
46
+ await testSuccessState(mock, response);
47
+ });
48
+ it("should listen to the data of last submitted request", async () => {
49
+ let count = 0;
50
+ let shouldThrow = false;
51
+ mockRequest(request, { data: count });
52
+ const response = renderUseSubmit(request.setRetry(1).setRetryTime(100));
53
+
54
+ act(() => {
55
+ response.result.current.onSubmitRequestStart(() => {
56
+ count += 1;
57
+ mockRequest(request, { data: count });
58
+ });
59
+ response.result.current.submit();
60
+ response.result.current.submit();
61
+ response.result.current.submit();
62
+ response.result.current.submit();
63
+ });
64
+
65
+ await waitFor(() => {
66
+ expect(shouldThrow).toBeFalse();
67
+ const { data } = response.result.current;
68
+ if (data && data !== 4) {
69
+ shouldThrow = true;
70
+ }
71
+
72
+ expect(data).toBe(4);
73
+ });
74
+ });
75
+ });
76
+ });
@@ -0,0 +1,46 @@
1
+ import { getErrorMessage } from "@hyper-fetch/core";
2
+ import { act } from "@testing-library/react";
3
+ import { createHttpMockingServer } from "@hyper-fetch/testing";
4
+
5
+ import { testErrorState } from "../../shared";
6
+ import { client, createRequest, renderUseSubmit } from "../../utils";
7
+
8
+ const { resetMocks, startServer, stopServer, mockRequest } = createHttpMockingServer();
9
+
10
+ describe("useSubmit [ Cancel ]", () => {
11
+ let request = createRequest<null, null>({ method: "POST" });
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
+ client.clear();
28
+ request = createRequest({ method: "POST" });
29
+ });
30
+
31
+ describe("when aborting request", () => {
32
+ it("should allow to cancel the ongoing request", async () => {
33
+ mockRequest(request);
34
+ const response = renderUseSubmit(request);
35
+
36
+ act(() => {
37
+ response.result.current.onSubmitRequestStart(() => {
38
+ response.result.current.abort();
39
+ });
40
+ response.result.current.submit();
41
+ });
42
+
43
+ await testErrorState(getErrorMessage("abort"), response);
44
+ });
45
+ });
46
+ });
@@ -0,0 +1,62 @@
1
+ import { act } from "@testing-library/react";
2
+ import { createClient } from "@hyper-fetch/core";
3
+ import { createHttpMockingServer } from "@hyper-fetch/testing";
4
+
5
+ import { testSuccessState } from "../../shared";
6
+ import { renderUseSubmit, waitForRender } from "../../utils";
7
+
8
+ const { resetMocks, startServer, stopServer, mockRequest } = createHttpMockingServer();
9
+
10
+ describe("useSubmit [ Concurrency ]", () => {
11
+ let client = createClient({ url: "http://localhost:3000" });
12
+ let request = client.createRequest<{ response: null; payload: null }>()({ method: "POST", endpoint: "" });
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
+ client.clear();
29
+ client = createClient({ url: "http://localhost:3000" });
30
+ request = client.createRequest<{ response: null; payload: null }>()({ method: "POST", endpoint: "" });
31
+ });
32
+
33
+ describe("given multiple rendered hooks", () => {
34
+ describe("when used requests are equal", () => {
35
+ it("should share data between hooks", async () => {
36
+ const mock = mockRequest(request);
37
+ const responseOne = renderUseSubmit(request);
38
+ const responseTwo = renderUseSubmit(request);
39
+
40
+ act(() => {
41
+ responseOne.result.current.submit();
42
+ });
43
+
44
+ await testSuccessState(mock, responseOne);
45
+ await testSuccessState(mock, responseTwo);
46
+ });
47
+ it("should start in loading mode when another request is ongoing", async () => {
48
+ mockRequest(request);
49
+ const responseOne = renderUseSubmit(request);
50
+
51
+ act(() => {
52
+ responseOne.result.current.submit();
53
+ });
54
+
55
+ await waitForRender();
56
+
57
+ const responseTwo = renderUseSubmit(request);
58
+ expect(responseTwo.result.current.submitting).toBeTrue();
59
+ });
60
+ });
61
+ });
62
+ });