@kevairy/template 0.1.2 → 0.1.4

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 (95) hide show
  1. package/package.json +1 -1
  2. package/template/.env +4 -0
  3. package/template/.env.production +6 -0
  4. package/template/.prettierignore +2 -0
  5. package/template/_gitignore +4 -1
  6. package/template/package.json +10 -0
  7. package/template/scripts/gen-offline-icons.mjs +84 -0
  8. package/template/src/adapters/auth/index.ts +1 -1
  9. package/template/src/adapters/auth/types.ts +6 -1
  10. package/template/src/api/auth.ts +3 -2
  11. package/template/src/components/core/forms/art-wang-editor/index.vue +0 -5
  12. package/template/src/components/core/layouts/art-guide/index.vue +131 -0
  13. package/template/src/components/core/layouts/art-header-bar/index.vue +26 -26
  14. package/template/src/components/core/layouts/art-header-bar/widget/ArtUserMenu.vue +17 -1
  15. package/template/src/components/core/layouts/art-page-content/index.vue +8 -1
  16. package/template/src/components/core/layouts/art-screen-lock/index.vue +325 -0
  17. package/template/src/components/core/layouts/art-settings-panel/widget/SettingActions.vue +0 -1
  18. package/template/src/components/core/media/art-cutter-img/index.vue +0 -1
  19. package/template/src/components/core/media/art-video-player/index.vue +0 -10
  20. package/template/src/config/index.ts +8 -1
  21. package/template/src/config/modules/component.ts +14 -0
  22. package/template/src/config/modules/guide.ts +122 -0
  23. package/template/src/config/modules/headerBar.ts +4 -0
  24. package/template/src/config/setting.ts +2 -2
  25. package/template/src/directives/core/access.ts +125 -0
  26. package/template/src/directives/core/auth.ts +7 -62
  27. package/template/src/directives/core/roles.ts +5 -83
  28. package/template/src/env.d.ts +1 -0
  29. package/template/src/hooks/core/useAuth.ts +2 -74
  30. package/template/src/hooks/core/useGuide.ts +122 -0
  31. package/template/src/hooks/core/useHeaderBar.ts +6 -0
  32. package/template/src/hooks/core/usePermission.ts +41 -0
  33. package/template/src/hooks/index.ts +1 -0
  34. package/template/src/locales/index.ts +0 -1
  35. package/template/src/locales/langs/en.json +77 -6
  36. package/template/src/locales/langs/zh.json +77 -6
  37. package/template/src/main.ts +19 -9
  38. package/template/src/router/core/IframeRouteManager.ts +4 -2
  39. package/template/src/router/core/MenuProcessor.ts +5 -40
  40. package/template/src/router/core/RoutePermissionValidator.ts +6 -149
  41. package/template/src/router/core/access.ts +79 -0
  42. package/template/src/router/guards/afterEach.ts +6 -10
  43. package/template/src/router/guards/beforeEach.ts +143 -100
  44. package/template/src/router/guards/error.ts +42 -0
  45. package/template/src/router/index.ts +2 -0
  46. package/template/src/router/modules/examples.ts +4 -3
  47. package/template/src/router/routes/staticRoutes.ts +5 -3
  48. package/template/src/services/auth.ts +32 -10
  49. package/template/src/services/permission.ts +21 -0
  50. package/template/src/store/modules/lock.ts +125 -0
  51. package/template/src/store/modules/menu.ts +28 -8
  52. package/template/src/store/modules/setting.ts +8 -15
  53. package/template/src/store/modules/user.ts +73 -33
  54. package/template/src/store/modules/worktab.ts +1 -1
  55. package/template/src/types/api/api.d.ts +4 -1
  56. package/template/src/types/config/index.ts +9 -0
  57. package/template/src/types/directive/directive.d.ts +1 -0
  58. package/template/src/types/import/components.d.ts +2 -0
  59. package/template/src/types/router/index.ts +6 -0
  60. package/template/src/utils/http/contract.ts +51 -19
  61. package/template/src/utils/http/error.ts +73 -26
  62. package/template/src/utils/http/index.ts +160 -165
  63. package/template/src/utils/http/request-manager.ts +124 -0
  64. package/template/src/utils/http/status.ts +1 -0
  65. package/template/src/utils/permission/index.ts +66 -0
  66. package/template/src/utils/session.ts +24 -0
  67. package/template/src/utils/socket/index.ts +27 -2
  68. package/template/src/utils/storage/storage-config.ts +15 -0
  69. package/template/src/utils/storage/storage.ts +5 -3
  70. package/template/src/utils/sys/diagnostics.ts +180 -0
  71. package/template/src/utils/sys/error-handle.ts +56 -126
  72. package/template/src/utils/sys/mittBus.ts +5 -0
  73. package/template/src/utils/sys/recovery.ts +31 -0
  74. package/template/src/utils/ui/iconify-loader.ts +32 -18
  75. package/template/src/utils/ui/offline-icons.json +77 -0
  76. package/template/src/views/examples/permissions/index.vue +69 -13
  77. package/template/src/views/examples/search-table/index.vue +2 -3
  78. package/template/src/views/exception/403/index.vue +33 -0
  79. package/template/src/views/exception/500/index.vue +52 -10
  80. package/template/tests/e2e/auth.spec.ts +24 -6
  81. package/template/tests/e2e/helpers/guide.ts +9 -0
  82. package/template/tests/e2e/permissions.spec.ts +53 -0
  83. package/template/tests/e2e/search-table.spec.ts +2 -0
  84. package/template/tests/e2e/session-recovery.spec.ts +49 -0
  85. package/template/tests/unit/diagnostics/diagnostics.spec.ts +132 -0
  86. package/template/tests/unit/diagnostics/router.spec.ts +84 -0
  87. package/template/tests/unit/http/auth-lifecycle.spec.ts +203 -0
  88. package/template/tests/unit/http/contract.spec.ts +46 -0
  89. package/template/tests/unit/http/request.spec.ts +487 -0
  90. package/template/tests/unit/permissions/guard.spec.ts +261 -0
  91. package/template/tests/unit/permissions/guide.spec.ts +30 -0
  92. package/template/tests/unit/permissions/rules.spec.ts +106 -0
  93. package/template/tests/unit/permissions/state-and-directives.spec.ts +176 -0
  94. package/template/tests/unit/router/examples.spec.ts +5 -1
  95. package/template/vite.config.ts +8 -2
@@ -0,0 +1,487 @@
1
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
2
+ import {
3
+ AxiosError,
4
+ AxiosHeaders,
5
+ type AxiosAdapter,
6
+ type AxiosResponse,
7
+ type InternalAxiosRequestConfig
8
+ } from 'axios'
9
+ import api, { cancelAllPendingRequests, isRequestCanceled } from '@/utils/http'
10
+ import { invalidateSessionRequests } from '@/utils/http/request-manager'
11
+
12
+ const fixtures = vi.hoisted(() => ({
13
+ user: { accessToken: 'first-token', clearAuthState: vi.fn() },
14
+ error: vi.fn(),
15
+ success: vi.fn()
16
+ }))
17
+ vi.mock('@/store/modules/user', () => ({ useUserStore: () => fixtures.user }))
18
+ vi.mock('@/locales', () => ({ $t: (key: string) => key }))
19
+ vi.mock('element-plus', () => ({ ElMessage: { error: fixtures.error, success: fixtures.success } }))
20
+
21
+ let time = Date.parse('2026-11-11T00:00:00Z')
22
+ beforeEach(() => {
23
+ vi.useFakeTimers()
24
+ vi.setSystemTime((time += 10000))
25
+ vi.spyOn(console, 'error').mockImplementation(() => {})
26
+ fixtures.user.accessToken = 'first-token'
27
+ fixtures.user.clearAuthState.mockReset().mockImplementation(invalidateSessionRequests)
28
+ fixtures.error.mockClear()
29
+ fixtures.success.mockClear()
30
+ })
31
+ afterEach(() => {
32
+ cancelAllPendingRequests()
33
+ vi.useRealTimers()
34
+ vi.unstubAllEnvs()
35
+ })
36
+
37
+ function response(
38
+ config: InternalAxiosRequestConfig,
39
+ data: unknown = { code: 0, data: 'ok' },
40
+ status = 200
41
+ ): AxiosResponse {
42
+ return { config, data, status, statusText: '', headers: new AxiosHeaders() }
43
+ }
44
+
45
+ function pendingTransport() {
46
+ const pending: Array<{
47
+ config: InternalAxiosRequestConfig
48
+ resolve: (value: AxiosResponse) => void
49
+ }> = []
50
+ const adapter: AxiosAdapter = vi.fn(
51
+ (config) => new Promise((resolve) => pending.push({ config, resolve }))
52
+ )
53
+ const finish = (index: number, data: unknown = { code: 0, data: 'ok' }) =>
54
+ pending[index].resolve(response(pending[index].config, data))
55
+ return { adapter, pending, finish }
56
+ }
57
+
58
+ const flush = () => vi.advanceTimersByTimeAsync(0)
59
+ const rejected = (promise: Promise<unknown>) => promise.catch((error: unknown) => error)
60
+ const httpFailure = (config: InternalAxiosRequestConfig, status = 503) =>
61
+ new AxiosError('HTTP error', 'ERR_BAD_RESPONSE', config, undefined, response(config, {}, status))
62
+
63
+ describe('request cancellation and deduplication through Axios', () => {
64
+ it('links caller cancellation, cleans listeners and does not show an error', async () => {
65
+ const source = new AbortController()
66
+ const add = vi.spyOn(source.signal, 'addEventListener')
67
+ const remove = vi.spyOn(source.signal, 'removeEventListener')
68
+ const transport = pendingTransport()
69
+ const result = rejected(
70
+ api.get({ url: '/list', signal: source.signal, adapter: transport.adapter })
71
+ )
72
+ await flush()
73
+ expect(transport.pending).toHaveLength(1)
74
+ source.abort()
75
+ expect(await result).toMatchObject({
76
+ kind: 'cancelled',
77
+ code: 499,
78
+ url: '/list',
79
+ method: 'GET'
80
+ })
81
+ expect(isRequestCanceled(await result)).toBe(true)
82
+ expect(transport.pending[0].config.signal?.aborted).toBe(true)
83
+ expect(add).toHaveBeenCalledOnce()
84
+ expect(remove).toHaveBeenCalledWith('abort', add.mock.calls[0][1])
85
+ expect(fixtures.error).not.toHaveBeenCalled()
86
+ transport.finish(0)
87
+ await flush()
88
+ })
89
+
90
+ it('does not send already-cancelled requests or let them replace a live request', async () => {
91
+ const transport = pendingTransport()
92
+ const first = api.get({ url: '/list', adapter: transport.adapter, cancelPrevious: true })
93
+ await flush()
94
+ const source = new AbortController()
95
+ source.abort()
96
+ const cancelled = rejected(
97
+ api.get({
98
+ url: '/list',
99
+ signal: source.signal,
100
+ adapter: transport.adapter,
101
+ cancelPrevious: true
102
+ })
103
+ )
104
+ expect(await cancelled).toMatchObject({ kind: 'cancelled' })
105
+ expect(transport.adapter).toHaveBeenCalledOnce()
106
+ expect(transport.pending[0].config.signal?.aborted).toBe(false)
107
+ transport.finish(0)
108
+ await expect(first).resolves.toBe('ok')
109
+ })
110
+
111
+ it('does not collapse a disabled default header into an unspecified header', async () => {
112
+ const transport = pendingTransport()
113
+ const options = { url: '/list', adapter: transport.adapter, cancelPrevious: true }
114
+ const first = api.get(options)
115
+ const second = api.get({ ...options, headers: { Accept: false } })
116
+ await flush()
117
+ expect(transport.pending.every(({ config }) => !config.signal?.aborted)).toBe(true)
118
+ transport.finish(0)
119
+ transport.finish(1)
120
+ await Promise.all([first, second])
121
+ })
122
+
123
+ it('keeps identical requests parallel by default, including writes', async () => {
124
+ const transport = pendingTransport()
125
+ const first = api.post({ url: '/save', data: { name: 'A' }, adapter: transport.adapter })
126
+ const second = api.post({ url: '/save', data: { name: 'A' }, adapter: transport.adapter })
127
+ await flush()
128
+ expect(transport.pending).toHaveLength(2)
129
+ expect(transport.pending.every(({ config }) => !config.signal?.aborted)).toBe(true)
130
+ transport.finish(0)
131
+ transport.finish(1)
132
+ await Promise.all([first, second])
133
+ })
134
+
135
+ it('replaces only same-scope keys and does not let old cleanup untrack a replacement', async () => {
136
+ const transport = pendingTransport()
137
+ const scope = Symbol('component')
138
+ const options = {
139
+ url: '/list',
140
+ adapter: transport.adapter,
141
+ requestScope: scope,
142
+ requestKey: 'latest',
143
+ cancelPrevious: true
144
+ }
145
+ const first = rejected(api.get({ ...options, params: { q: 'A' } }))
146
+ await flush()
147
+ const other = api.get({ ...options, requestScope: Symbol('component') })
148
+ const second = rejected(api.get({ ...options, params: { q: 'B' } }))
149
+ await flush()
150
+ expect(await first).toMatchObject({ kind: 'cancelled' })
151
+ expect(transport.pending[1].config.signal?.aborted).toBe(false)
152
+ const third = api.get({ ...options, params: { q: 'C' } })
153
+ await flush()
154
+ expect(await second).toMatchObject({ kind: 'cancelled' })
155
+ transport.finish(0, { code: 401, message: 'Late old response' })
156
+ transport.finish(2)
157
+ transport.finish(1)
158
+ transport.finish(3)
159
+ await Promise.all([other, third])
160
+ expect(fixtures.user.clearAuthState).not.toHaveBeenCalled()
161
+ })
162
+
163
+ it('automatically compares stable JSON and distinguishes significant headers', async () => {
164
+ const transport = pendingTransport()
165
+ const options = { url: '/list', adapter: transport.adapter, cancelPrevious: true }
166
+ const first = rejected(
167
+ api.get({ ...options, params: { page: 1, size: 10 }, headers: { 'X-Tenant': 'A' } })
168
+ )
169
+ await flush()
170
+ const second = api.get({
171
+ ...options,
172
+ params: { size: 10, page: 1 },
173
+ headers: { 'x-tenant': 'A' }
174
+ })
175
+ const other = api.get({
176
+ ...options,
177
+ params: { page: 1, size: 10 },
178
+ headers: { 'X-Tenant': 'B' }
179
+ })
180
+ await flush()
181
+ expect(await first).toMatchObject({ kind: 'cancelled' })
182
+ expect(transport.pending[1].config.signal?.aborted).toBe(false)
183
+ transport.pending.forEach((_, index) => transport.finish(index))
184
+ await Promise.all([second, other])
185
+ })
186
+
187
+ it('does not automatically cancel different uploads and allows an explicit upload key', async () => {
188
+ const transport = pendingTransport()
189
+ const firstData = new FormData()
190
+ firstData.append('file', 'A')
191
+ const secondData = new FormData()
192
+ secondData.append('file', 'B')
193
+ const options = { url: '/upload', adapter: transport.adapter, cancelPrevious: true }
194
+ const first = api.post({ ...options, data: firstData })
195
+ const second = api.post({ ...options, data: secondData })
196
+ await flush()
197
+ expect(transport.pending.every(({ config }) => !config.signal?.aborted)).toBe(true)
198
+ transport.finish(0)
199
+ transport.finish(1)
200
+ await Promise.all([first, second])
201
+ const third = rejected(api.post({ ...options, data: firstData, requestKey: 'upload' }))
202
+ await flush()
203
+ const fourth = api.post({ ...options, data: secondData, requestKey: 'upload' })
204
+ await flush()
205
+ expect(await third).toMatchObject({ kind: 'cancelled' })
206
+ transport.finish(2)
207
+ transport.finish(3)
208
+ await fourth
209
+ })
210
+
211
+ it('removes caller listeners on success and on final failure', async () => {
212
+ const source = new AbortController()
213
+ const remove = vi.spyOn(source.signal, 'removeEventListener')
214
+ let completedSignal: InternalAxiosRequestConfig['signal']
215
+ const ok: AxiosAdapter = async (config) => {
216
+ completedSignal = config.signal
217
+ return response(config)
218
+ }
219
+ await api.get({ url: '/list', signal: source.signal, adapter: ok })
220
+ await rejected(
221
+ api.get({
222
+ url: '/list',
223
+ signal: source.signal,
224
+ adapter: async (config) => {
225
+ throw httpFailure(config)
226
+ }
227
+ })
228
+ )
229
+ expect(remove).toHaveBeenCalledTimes(2)
230
+ source.abort()
231
+ expect(completedSignal?.aborted).toBe(false)
232
+ })
233
+
234
+ it('preserves response decoding, success options, headers and 204 responses', async () => {
235
+ const adapter: AxiosAdapter = vi.fn(async (config) => {
236
+ expect(config.headers.get('Authorization')).toBe('first-token')
237
+ expect(config.headers.get('X-Shared')).toBe('common')
238
+ return response(config, { code: '200', data: { id: 1 }, message: 'Saved' })
239
+ })
240
+ await expect(
241
+ api.post({
242
+ url: '/save',
243
+ headers: { common: { 'X-Shared': 'common' } },
244
+ showSuccessMessage: true,
245
+ adapter
246
+ })
247
+ ).resolves.toEqual({ id: 1 })
248
+ expect(fixtures.success).toHaveBeenCalledExactlyOnceWith('Saved')
249
+ await expect(
250
+ api.request({
251
+ url: '/head',
252
+ method: 'HEAD',
253
+ adapter: async (config) => response(config, undefined, 204)
254
+ })
255
+ ).resolves.toBeUndefined()
256
+ await expect(
257
+ api.request({
258
+ url: '/head',
259
+ method: 'HEAD',
260
+ adapter: async (config) => response(config, '', 200)
261
+ })
262
+ ).resolves.toBeUndefined()
263
+ })
264
+ })
265
+
266
+ describe('retry policy', () => {
267
+ it('recognizes Axios cancellation codes without retrying or showing a failure', async () => {
268
+ const adapter: AxiosAdapter = vi.fn(async (config) => {
269
+ throw new AxiosError('Cancelled', 'ERR_CANCELED', config)
270
+ })
271
+ const error = await rejected(api.get({ url: '/list', adapter, retry: { retries: 2 } }))
272
+ expect(error).toMatchObject({ kind: 'cancelled' })
273
+ expect(isRequestCanceled(error)).toBe(true)
274
+ expect(adapter).toHaveBeenCalledOnce()
275
+ expect(fixtures.error).not.toHaveBeenCalled()
276
+ })
277
+ it('retries transient HTTP failures and only reports the final success', async () => {
278
+ let attempts = 0
279
+ const adapter: AxiosAdapter = vi.fn(async (config) => {
280
+ if (++attempts < 3) throw httpFailure(config)
281
+ return response(config, { code: 0, data: 'recovered', message: 'Done' })
282
+ })
283
+ const result = api.get({
284
+ url: '/list',
285
+ adapter,
286
+ retry: { retries: 2, delay: 100 },
287
+ showSuccessMessage: true
288
+ })
289
+ await flush()
290
+ expect(attempts).toBe(1)
291
+ expect(fixtures.error).not.toHaveBeenCalled()
292
+ await vi.advanceTimersByTimeAsync(200)
293
+ await expect(result).resolves.toBe('recovered')
294
+ expect(attempts).toBe(3)
295
+ expect(fixtures.success).toHaveBeenCalledOnce()
296
+ expect(fixtures.error).not.toHaveBeenCalled()
297
+ })
298
+
299
+ it('classifies Axios timeouts and shows one error after all attempts fail', async () => {
300
+ const adapter: AxiosAdapter = vi.fn(async (config) => {
301
+ throw new AxiosError('timeout', 'ECONNABORTED', config)
302
+ })
303
+ const result = rejected(api.get({ url: '/list', adapter, retry: { retries: 1, delay: 100 } }))
304
+ await flush()
305
+ expect(fixtures.error).not.toHaveBeenCalled()
306
+ await vi.advanceTimersByTimeAsync(100)
307
+ expect(await result).toMatchObject({ code: 408, kind: 'timeout' })
308
+ expect(adapter).toHaveBeenCalledTimes(2)
309
+ expect(fixtures.error).toHaveBeenCalledExactlyOnceWith('httpMsg.requestTimeout')
310
+ })
311
+
312
+ it.each(['POST', 'PUT', 'DELETE'])(
313
+ 'does not retry %s from the global setting without explicit opt-in',
314
+ async (method) => {
315
+ vi.stubEnv('VITE_HTTP_MAX_RETRIES', '2')
316
+ const adapter: AxiosAdapter = vi.fn(async (config) => {
317
+ throw httpFailure(config)
318
+ })
319
+ await expect(api.request({ url: '/write', method, adapter })).rejects.toMatchObject({
320
+ code: 503,
321
+ kind: 'http'
322
+ })
323
+ expect(adapter).toHaveBeenCalledOnce()
324
+ }
325
+ )
326
+
327
+ it('allows explicit idempotent write retries and a per-request opt-out', async () => {
328
+ let attempts = 0
329
+ const adapter: AxiosAdapter = vi.fn(async (config) => {
330
+ expect(config.headers.get('Idempotency-Key')).toBe('operation-1')
331
+ if (++attempts === 1) throw httpFailure(config)
332
+ return response(config)
333
+ })
334
+ const result = api.post({
335
+ url: '/write',
336
+ adapter,
337
+ headers: { 'Idempotency-Key': 'operation-1' },
338
+ retry: { retries: 1, delay: 100, allowUnsafe: true }
339
+ })
340
+ await flush()
341
+ await vi.advanceTimersByTimeAsync(100)
342
+ await expect(result).resolves.toBe('ok')
343
+ vi.stubEnv('VITE_HTTP_MAX_RETRIES', '3')
344
+ const fail: AxiosAdapter = vi.fn(async (config) => {
345
+ throw httpFailure(config)
346
+ })
347
+ await expect(
348
+ api.get({ url: '/list', adapter: fail, retry: false, showErrorMessage: false })
349
+ ).rejects.toMatchObject({ code: 503 })
350
+ expect(fail).toHaveBeenCalledOnce()
351
+ expect(fixtures.error).not.toHaveBeenCalled()
352
+ })
353
+
354
+ it('does not retry business errors even when they use a 500-like code', async () => {
355
+ const adapter: AxiosAdapter = vi.fn(async (config) =>
356
+ response(config, { code: 500, message: 'Business rule' })
357
+ )
358
+ await expect(api.get({ url: '/list', adapter, retry: { retries: 2 } })).rejects.toMatchObject({
359
+ code: 500,
360
+ kind: 'business',
361
+ message: 'Business rule'
362
+ })
363
+ expect(adapter).toHaveBeenCalledOnce()
364
+ })
365
+
366
+ it('classifies configuration failures without retrying or leaking caller listeners', async () => {
367
+ const source = new AbortController()
368
+ const remove = vi.spyOn(source.signal, 'removeEventListener')
369
+ const adapter: AxiosAdapter = vi.fn(async (config) => {
370
+ throw new AxiosError('Invalid option', 'ERR_BAD_OPTION_VALUE', config)
371
+ })
372
+ await expect(
373
+ api.get({ url: '/list', signal: source.signal, adapter, retry: { retries: 2 } })
374
+ ).rejects.toMatchObject({ kind: 'config' })
375
+ expect(adapter).toHaveBeenCalledOnce()
376
+ expect(remove).toHaveBeenCalledOnce()
377
+ })
378
+
379
+ it.each([400, 401, 403, 404])('does not retry HTTP %i', async (status) => {
380
+ const adapter: AxiosAdapter = vi.fn(async (config) => {
381
+ throw httpFailure(config, status)
382
+ })
383
+ await expect(api.get({ url: '/list', adapter, retry: { retries: 2 } })).rejects.toMatchObject({
384
+ code: status,
385
+ kind: 'http'
386
+ })
387
+ expect(adapter).toHaveBeenCalledOnce()
388
+ })
389
+
390
+ it('uses global retries for network failures on reads and rejects non-finite configuration', async () => {
391
+ vi.stubEnv('VITE_HTTP_MAX_RETRIES', '1')
392
+ let attempts = 0
393
+ const adapter: AxiosAdapter = vi.fn(async (config) => {
394
+ if (++attempts === 1) throw new AxiosError('offline', 'ERR_NETWORK', config)
395
+ return response(config)
396
+ })
397
+ const result = api.get({ url: '/list', adapter })
398
+ await flush()
399
+ await vi.advanceTimersByTimeAsync(1000)
400
+ await expect(result).resolves.toBe('ok')
401
+ vi.stubEnv('VITE_HTTP_MAX_RETRIES', 'Infinity')
402
+ const failure: AxiosAdapter = vi.fn(async (config) => {
403
+ throw new AxiosError('offline', 'ERR_NETWORK', config)
404
+ })
405
+ await expect(api.get({ url: '/list', adapter: failure })).rejects.toMatchObject({
406
+ kind: 'network'
407
+ })
408
+ expect(failure).toHaveBeenCalledOnce()
409
+ })
410
+
411
+ it('cancels backoff immediately and never sends another attempt', async () => {
412
+ const controller = new AbortController()
413
+ const adapter: AxiosAdapter = vi.fn(async (config) => {
414
+ throw httpFailure(config)
415
+ })
416
+ const result = rejected(
417
+ api.get({
418
+ url: '/list',
419
+ signal: controller.signal,
420
+ adapter,
421
+ retry: { retries: 3, delay: 1000 }
422
+ })
423
+ )
424
+ await flush()
425
+ expect(vi.getTimerCount()).toBe(1)
426
+ controller.abort()
427
+ expect(await result).toMatchObject({ kind: 'cancelled' })
428
+ expect(vi.getTimerCount()).toBe(0)
429
+ await vi.advanceTimersByTimeAsync(5000)
430
+ expect(adapter).toHaveBeenCalledOnce()
431
+ expect(fixtures.error).not.toHaveBeenCalled()
432
+ })
433
+
434
+ it('tracks requests across backoff so replacements and session cleanup also stop retries', async () => {
435
+ const failure: AxiosAdapter = vi.fn(async (config) => {
436
+ throw httpFailure(config)
437
+ })
438
+ const options = {
439
+ url: '/list',
440
+ cancelPrevious: true,
441
+ requestKey: 'list',
442
+ retry: { retries: 2, delay: 1000 }
443
+ }
444
+ const old = rejected(api.get({ ...options, adapter: failure }))
445
+ await flush()
446
+ const next = api.get({ ...options, adapter: async (config) => response(config) })
447
+ expect(await old).toMatchObject({ kind: 'cancelled' })
448
+ await next
449
+ const waiting = rejected(api.get({ ...options, adapter: failure }))
450
+ await flush()
451
+ cancelAllPendingRequests()
452
+ expect(await waiting).toMatchObject({ kind: 'cancelled' })
453
+ await vi.advanceTimersByTimeAsync(3000)
454
+ expect(failure).toHaveBeenCalledTimes(2)
455
+ })
456
+
457
+ it('does not deliver a late 401 from a cancelled session and still accepts new requests', async () => {
458
+ const transport = pendingTransport()
459
+ const old = rejected(api.get({ url: '/list', adapter: transport.adapter }))
460
+ await flush()
461
+ invalidateSessionRequests()
462
+ fixtures.user.accessToken = 'second-token'
463
+ expect(await old).toMatchObject({ kind: 'cancelled' })
464
+ const next = api.get({ url: '/list', adapter: transport.adapter })
465
+ await flush()
466
+ expect(transport.pending[1].config.headers.get('Authorization')).toBe('second-token')
467
+ transport.finish(0, { code: 401 })
468
+ transport.finish(1)
469
+ await expect(next).resolves.toBe('ok')
470
+ expect(fixtures.user.clearAuthState).not.toHaveBeenCalled()
471
+ })
472
+
473
+ it('always clears an unauthorized session while debouncing only the notification', async () => {
474
+ const adapter: AxiosAdapter = async (config) =>
475
+ response(config, { code: 401, message: 'Expired' })
476
+ await expect(api.get({ url: '/list', adapter })).rejects.toMatchObject({
477
+ code: 401,
478
+ kind: 'business'
479
+ })
480
+ await expect(api.get({ url: '/list', adapter })).rejects.toMatchObject({
481
+ code: 401,
482
+ kind: 'business'
483
+ })
484
+ expect(fixtures.user.clearAuthState).toHaveBeenCalledTimes(2)
485
+ expect(fixtures.error).toHaveBeenCalledOnce()
486
+ })
487
+ })