@hyper-fetch/react 9.6.0 → 9.6.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.
Files changed (102) hide show
  1. package/__tests__/features/helpers/use-request-events/use-request-events.async-mapper.spec.ts +243 -0
  2. package/__tests__/features/helpers/use-tracked-state/use-tacked-state.actions.spec.ts +1 -1
  3. package/__tests__/features/helpers/use-tracked-state/use-tracked-state.keys.spec.ts +294 -0
  4. package/__tests__/features/helpers/utils.spec.ts +127 -0
  5. package/__tests__/features/provider/provider.config.spec.tsx +172 -0
  6. package/__tests__/features/use-app-manager/use-app-manager.events.spec.tsx +497 -0
  7. package/__tests__/features/use-cache/use-cache.state.spec.tsx +326 -0
  8. package/__tests__/features/use-emitter/use-emitter.lifecycle.spec.tsx +417 -0
  9. package/__tests__/features/use-fetch/use-fetch.bounce-timers.spec.ts +199 -0
  10. package/__tests__/features/use-fetch/use-fetch.cache-events.spec.ts +212 -0
  11. package/__tests__/features/use-fetch/use-fetch.callbacks.spec.tsx +359 -0
  12. package/__tests__/features/use-fetch/use-fetch.cancel.spec.ts +6 -3
  13. package/__tests__/features/use-fetch/use-fetch.debounce.spec.ts +72 -80
  14. package/__tests__/features/use-fetch/use-fetch.hydration.spec.tsx +126 -0
  15. package/__tests__/features/use-fetch/use-fetch.infinite.spec.ts +146 -0
  16. package/__tests__/features/use-fetch/use-fetch.initial-state.spec.ts +340 -0
  17. package/__tests__/features/use-fetch/use-fetch.keys.spec.tsx +559 -0
  18. package/__tests__/features/use-fetch/use-fetch.lifecycle.spec.ts +348 -0
  19. package/__tests__/features/use-fetch/use-fetch.mounting.spec.tsx +411 -0
  20. package/__tests__/features/use-fetch/use-fetch.pagination.spec.ts +177 -0
  21. package/__tests__/features/use-fetch/use-fetch.refresh-interval.spec.ts +355 -0
  22. package/__tests__/features/use-fetch/use-fetch.refresh.spec.ts +36 -13
  23. package/__tests__/features/use-fetch/use-fetch.response-order.spec.ts +105 -0
  24. package/__tests__/features/use-fetch/use-fetch.retry.spec.ts +235 -0
  25. package/__tests__/features/use-fetch/use-fetch.return-types.spec.ts +186 -0
  26. package/__tests__/features/use-fetch/use-fetch.scope.spec.ts +333 -0
  27. package/__tests__/features/use-fetch/use-fetch.ssr.spec.tsx +195 -0
  28. package/__tests__/features/use-fetch/use-fetch.suspense-edge.spec.tsx +391 -0
  29. package/__tests__/features/use-fetch/use-fetch.throwing-callbacks.spec.tsx +112 -0
  30. package/__tests__/features/use-fetch/use-fetch.tracking.spec.tsx +364 -0
  31. package/__tests__/features/use-fetch/use-fetch.utils.spec.ts +11 -2
  32. package/__tests__/features/use-fetch/use-fetch.window-events.spec.ts +300 -0
  33. package/__tests__/features/use-infinite-fetch/use-infinite-fetch.parity.spec.tsx +1027 -0
  34. package/__tests__/features/use-infinite-fetch/use-infinite-fetch.resubscribe.spec.tsx +267 -0
  35. package/__tests__/features/use-infinite-fetch/use-infinite-fetch.typescript.spec.ts +64 -1
  36. package/__tests__/features/use-is-fetching/use-is-fetching.base.spec.tsx +19 -9
  37. package/__tests__/features/use-is-fetching/use-is-fetching.lifecycle.spec.tsx +301 -0
  38. package/__tests__/features/use-listener/use-listener.lifecycle.spec.tsx +507 -0
  39. package/__tests__/features/use-listener/use-listener.ssr.spec.tsx +89 -0
  40. package/__tests__/features/use-queue/use-queue.controls.spec.tsx +593 -0
  41. package/__tests__/features/use-queue/use-queue.list.spec.tsx +560 -0
  42. package/__tests__/features/use-queue/use-queue.progress.spec.tsx +650 -0
  43. package/__tests__/features/use-submit/use-submit.abort.spec.tsx +270 -0
  44. package/__tests__/features/use-submit/use-submit.actions.spec.tsx +446 -0
  45. package/__tests__/features/use-submit/use-submit.arguments.spec.tsx +732 -0
  46. package/__tests__/features/use-submit/use-submit.bounce.spec.tsx +644 -0
  47. package/__tests__/features/use-submit/use-submit.callbacks.spec.tsx +860 -0
  48. package/__tests__/features/use-submit/use-submit.chaining.spec.tsx +167 -0
  49. package/__tests__/features/use-submit/use-submit.concurrency.spec.ts +2 -1
  50. package/__tests__/features/use-submit/use-submit.debounce.spec.ts +100 -124
  51. package/__tests__/features/use-submit/use-submit.double-submit.spec.tsx +552 -0
  52. package/__tests__/features/use-submit/use-submit.offline.spec.tsx +285 -0
  53. package/__tests__/features/use-submit/use-submit.optimistic-cache.spec.tsx +619 -0
  54. package/__tests__/features/use-submit/use-submit.optimistic-settlement.spec.ts +8 -1
  55. package/__tests__/features/use-submit/use-submit.optimistic.spec.ts +5 -1
  56. package/__tests__/features/use-submit/use-submit.retry.spec.ts +51 -35
  57. package/__tests__/features/use-submit/use-submit.state.spec.tsx +1025 -0
  58. package/__tests__/features/use-submit/use-submit.submit-types.spec.ts +194 -0
  59. package/__tests__/features/use-submit/use-submit.submitting.spec.tsx +180 -0
  60. package/__tests__/features/use-submit/use-submit.unmount.spec.ts +2 -1
  61. package/__tests__/utils/gate.utils.ts +103 -0
  62. package/__tests__/utils/gated-client.utils.ts +158 -0
  63. package/__tests__/utils/helpers.utils.ts +19 -0
  64. package/__tests__/utils/use-queue.utils.ts +8 -4
  65. package/dist/helpers/use-request-events/use-request-events.hooks.d.ts.map +1 -1
  66. package/dist/helpers/use-request-events/use-request-events.types.d.ts +1 -1
  67. package/dist/helpers/use-request-events/use-request-events.types.d.ts.map +1 -1
  68. package/dist/helpers/use-tracked-state/use-tracked-state.hooks.d.ts.map +1 -1
  69. package/dist/helpers/use-tracked-state/use-tracked-state.utils.d.ts +8 -0
  70. package/dist/helpers/use-tracked-state/use-tracked-state.utils.d.ts.map +1 -1
  71. package/dist/hooks/use-cache/use-cache.hooks.d.ts.map +1 -1
  72. package/dist/hooks/use-fetch/use-fetch.hooks.d.ts.map +1 -1
  73. package/dist/hooks/use-infinite-fetch/use-infinite-fetch.hooks.d.ts.map +1 -1
  74. package/dist/hooks/use-infinite-fetch/use-infinite-fetch.store.d.ts +3 -0
  75. package/dist/hooks/use-infinite-fetch/use-infinite-fetch.store.d.ts.map +1 -1
  76. package/dist/hooks/use-infinite-fetch/use-infinite-fetch.types.d.ts +5 -3
  77. package/dist/hooks/use-infinite-fetch/use-infinite-fetch.types.d.ts.map +1 -1
  78. package/dist/hooks/use-infinite-fetch/use-infinite-fetch.utils.d.ts +11 -1
  79. package/dist/hooks/use-infinite-fetch/use-infinite-fetch.utils.d.ts.map +1 -1
  80. package/dist/hooks/use-listener/use-listener.hooks.d.ts.map +1 -1
  81. package/dist/hooks/use-queue/use-queue.hooks.d.ts.map +1 -1
  82. package/dist/hooks/use-submit/use-submit.hooks.d.ts.map +1 -1
  83. package/dist/index.mjs +633 -347
  84. package/dist/index.mjs.map +1 -1
  85. package/dist/provider/provider.d.ts.map +1 -1
  86. package/package.json +1 -1
  87. package/src/helpers/use-request-events/use-request-events.hooks.ts +147 -32
  88. package/src/helpers/use-request-events/use-request-events.types.ts +1 -1
  89. package/src/helpers/use-tracked-state/use-tracked-state.hooks.ts +148 -101
  90. package/src/helpers/use-tracked-state/use-tracked-state.utils.ts +26 -5
  91. package/src/hooks/use-cache/use-cache.hooks.ts +20 -5
  92. package/src/hooks/use-fetch/use-fetch.hooks.ts +194 -113
  93. package/src/hooks/use-infinite-fetch/use-infinite-fetch.hooks.ts +55 -26
  94. package/src/hooks/use-infinite-fetch/use-infinite-fetch.store.ts +35 -29
  95. package/src/hooks/use-infinite-fetch/use-infinite-fetch.types.ts +5 -3
  96. package/src/hooks/use-infinite-fetch/use-infinite-fetch.utils.ts +25 -1
  97. package/src/hooks/use-listener/use-listener.hooks.ts +2 -1
  98. package/src/hooks/use-queue/use-queue.hooks.ts +85 -60
  99. package/src/hooks/use-submit/use-submit.hooks.ts +163 -53
  100. package/src/provider/provider.tsx +9 -1
  101. package/__tests__/features/use-fetch/use-fetch.pagination.ts +0 -36
  102. package/__tests__/features/use-fetch/use-fetch.retry.ts +0 -38
@@ -1,18 +1,42 @@
1
+ import type { RequestInstance } from "@hyper-fetch/core";
1
2
  import { createHttpMockingServer } from "@hyper-fetch/testing";
2
3
  import { act, waitFor } from "@testing-library/react";
3
4
 
4
- import { client, createRequest, renderUseSubmit, waitForRender } from "../../utils";
5
+ import { client, createRequest, renderUseSubmit } from "../../utils";
5
6
 
6
7
  const { resetMocks, startServer, stopServer, mockRequest } = createHttpMockingServer();
7
8
 
8
9
  describe("useSubmit [ Retry ]", () => {
9
10
  let request = createRequest<{ response: null; payload: null }>({ method: "POST" });
10
11
 
12
+ /**
13
+ * Submits and resolves once the last attempt has responded, so the attempt count is final.
14
+ * Waiting for a fixed time instead loses attempts on a slow machine.
15
+ */
16
+ const submitUntilSettled = async (retryRequest: RequestInstance) => {
17
+ const onStart = vi.fn();
18
+ const onFinished = vi.fn();
19
+ const response = renderUseSubmit(retryRequest);
20
+
21
+ act(() => {
22
+ response.result.current.onSubmitRequestStart(onStart);
23
+ response.result.current.onSubmitFinished(({ details }) => onFinished(details.willRetry));
24
+ response.result.current.submit();
25
+ });
26
+
27
+ await waitFor(() => {
28
+ expect(onFinished).toHaveBeenLastCalledWith(false);
29
+ });
30
+
31
+ return { onStart, onFinished };
32
+ };
33
+
11
34
  beforeAll(() => {
12
35
  startServer();
13
36
  });
14
37
 
15
38
  afterEach(() => {
39
+ vi.useRealTimers();
16
40
  resetMocks();
17
41
  });
18
42
 
@@ -28,65 +52,57 @@ describe("useSubmit [ Retry ]", () => {
28
52
 
29
53
  describe("when request retry attribute is set to false", () => {
30
54
  it("should not retry request on failure", async () => {
31
- const spy = vi.fn();
32
55
  mockRequest(request, { status: 400, delay: 5 });
33
- const response = renderUseSubmit(request.setRetry(0).setRetryTime(0));
34
56
 
35
- act(() => {
36
- response.result.current.onSubmitRequestStart(spy);
37
- response.result.current.submit();
38
- });
57
+ const { onStart, onFinished } = await submitUntilSettled(request.setRetry(0).setRetryTime(0));
39
58
 
40
- await waitForRender(150);
41
-
42
- expect(spy).toHaveBeenCalledTimes(1);
59
+ expect(onStart).toHaveBeenCalledTimes(1);
60
+ expect(onFinished).toHaveBeenCalledTimes(1);
43
61
  });
44
62
  });
45
63
  describe("when request retry attribute is set to true", () => {
46
64
  it("should retry request once", async () => {
47
- const spy = vi.fn();
48
65
  mockRequest(request, { status: 400, delay: 5 });
49
- const response = renderUseSubmit(request.setRetry(1).setRetryTime(10));
50
-
51
- act(() => {
52
- response.result.current.onSubmitRequestStart(spy);
53
- response.result.current.submit();
54
- });
55
66
 
56
- await waitForRender(150);
67
+ const { onStart, onFinished } = await submitUntilSettled(request.setRetry(1).setRetryTime(10));
57
68
 
58
- expect(spy).toHaveBeenCalledTimes(2);
69
+ expect(onStart).toHaveBeenCalledTimes(2);
70
+ expect(onFinished.mock.calls).toStrictEqual([[true], [false]]);
59
71
  });
60
72
  it("should retry request twice", async () => {
61
- const spy = vi.fn();
62
73
  mockRequest(request, { status: 400, delay: 5 });
63
- const response = renderUseSubmit(request.setRetry(2).setRetryTime(10));
64
-
65
- act(() => {
66
- response.result.current.onSubmitRequestStart(spy);
67
- response.result.current.submit();
68
- });
69
74
 
70
- await waitForRender(150);
75
+ const { onStart, onFinished } = await submitUntilSettled(request.setRetry(2).setRetryTime(10));
71
76
 
72
- expect(spy).toHaveBeenCalledTimes(3);
77
+ expect(onStart).toHaveBeenCalledTimes(3);
78
+ expect(onFinished.mock.calls).toStrictEqual([[true], [true], [false]]);
73
79
  });
74
80
  it("should trigger retries with the config interval", async () => {
75
- const time: number[] = [];
76
- mockRequest(request, { status: 400, delay: 0 });
77
- const response = renderUseSubmit(request.setRetry(1).setRetryTime(100));
81
+ // Node can fire a real timer earlier than Date.now() says, so the interval is measured on a fake clock
82
+ vi.useFakeTimers({ toFake: ["setTimeout", "clearTimeout", "Date"] });
83
+ const retryTime = 100;
84
+ const startTimes: number[] = [];
85
+ const finishTimes: number[] = [];
86
+ mockRequest(request, { status: 400, delay: 5 });
87
+ const response = renderUseSubmit(request.setRetry(1).setRetryTime(retryTime));
78
88
 
79
89
  act(() => {
80
90
  response.result.current.onSubmitRequestStart(() => {
81
- time.push(Date.now());
91
+ startTimes.push(Date.now());
92
+ });
93
+ response.result.current.onSubmitFinished(() => {
94
+ finishTimes.push(Date.now());
82
95
  });
83
96
  response.result.current.submit();
84
97
  });
85
98
 
86
- await waitFor(() => {
87
- expect(time[1] - time[0]);
88
- expect(time[1] - time[0]).toBeGreaterThan(99);
99
+ // vi.waitFor polls on real timers - the RTL waitFor would wait on the faked setTimeout forever
100
+ await vi.waitFor(async () => {
101
+ await act(() => vi.advanceTimersByTimeAsync(20));
102
+ expect(startTimes).toHaveLength(2);
89
103
  });
104
+
105
+ expect(startTimes[1] - finishTimes[0]).toBeGreaterThanOrEqual(retryTime);
90
106
  });
91
107
  });
92
108
  });