@kevairy/template 0.1.3 → 0.1.5

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 (74) hide show
  1. package/package.json +1 -1
  2. package/template/.env +2 -5
  3. package/template/.env.production +6 -0
  4. package/template/README.md +12 -0
  5. package/template/package.json +5 -5
  6. package/template/scripts/build-info.ts +76 -0
  7. package/template/src/adapters/auth/index.ts +1 -1
  8. package/template/src/adapters/auth/types.ts +6 -1
  9. package/template/src/api/auth.ts +3 -2
  10. package/template/src/components/core/layouts/art-guide/index.vue +9 -1
  11. package/template/src/components/core/layouts/art-page-content/index.vue +8 -1
  12. package/template/src/config/index.ts +4 -0
  13. package/template/src/directives/core/access.ts +125 -0
  14. package/template/src/directives/core/auth.ts +7 -62
  15. package/template/src/directives/core/roles.ts +5 -83
  16. package/template/src/env.d.ts +2 -0
  17. package/template/src/hooks/core/useAuth.ts +2 -74
  18. package/template/src/hooks/core/useGuide.ts +6 -0
  19. package/template/src/hooks/core/usePermission.ts +41 -0
  20. package/template/src/hooks/index.ts +1 -0
  21. package/template/src/locales/langs/en.json +11 -1
  22. package/template/src/locales/langs/zh.json +11 -1
  23. package/template/src/main.ts +18 -10
  24. package/template/src/router/core/IframeRouteManager.ts +4 -2
  25. package/template/src/router/core/MenuProcessor.ts +5 -40
  26. package/template/src/router/core/RoutePermissionValidator.ts +6 -149
  27. package/template/src/router/core/access.ts +79 -0
  28. package/template/src/router/guards/afterEach.ts +6 -10
  29. package/template/src/router/guards/beforeEach.ts +143 -100
  30. package/template/src/router/guards/error.ts +42 -0
  31. package/template/src/router/index.ts +2 -0
  32. package/template/src/router/modules/examples.ts +4 -3
  33. package/template/src/router/routes/staticRoutes.ts +5 -3
  34. package/template/src/services/auth.ts +32 -10
  35. package/template/src/services/permission.ts +21 -0
  36. package/template/src/store/modules/menu.ts +28 -8
  37. package/template/src/store/modules/user.ts +72 -35
  38. package/template/src/store/modules/worktab.ts +1 -1
  39. package/template/src/types/api/api.d.ts +4 -1
  40. package/template/src/types/build-info.ts +11 -0
  41. package/template/src/types/config/index.ts +5 -2
  42. package/template/src/types/directive/directive.d.ts +1 -0
  43. package/template/src/types/router/index.ts +6 -0
  44. package/template/src/utils/http/contract.ts +51 -19
  45. package/template/src/utils/http/error.ts +73 -26
  46. package/template/src/utils/http/index.ts +160 -167
  47. package/template/src/utils/http/request-manager.ts +124 -0
  48. package/template/src/utils/http/status.ts +1 -0
  49. package/template/src/utils/permission/index.ts +66 -0
  50. package/template/src/utils/session.ts +24 -0
  51. package/template/src/utils/storage/storage-config.ts +15 -0
  52. package/template/src/utils/storage/storage.ts +5 -3
  53. package/template/src/utils/sys/console.ts +63 -7
  54. package/template/src/utils/sys/diagnostics.ts +180 -0
  55. package/template/src/utils/sys/error-handle.ts +56 -126
  56. package/template/src/utils/sys/recovery.ts +31 -0
  57. package/template/src/views/examples/permissions/index.vue +69 -13
  58. package/template/src/views/exception/403/index.vue +33 -0
  59. package/template/src/views/exception/500/index.vue +52 -10
  60. package/template/tests/e2e/permissions.spec.ts +53 -0
  61. package/template/tests/e2e/session-recovery.spec.ts +49 -0
  62. package/template/tests/unit/build/build-info.spec.ts +151 -0
  63. package/template/tests/unit/diagnostics/diagnostics.spec.ts +132 -0
  64. package/template/tests/unit/diagnostics/router.spec.ts +84 -0
  65. package/template/tests/unit/http/auth-lifecycle.spec.ts +203 -0
  66. package/template/tests/unit/http/contract.spec.ts +46 -0
  67. package/template/tests/unit/http/request.spec.ts +487 -0
  68. package/template/tests/unit/permissions/guard.spec.ts +261 -0
  69. package/template/tests/unit/permissions/guide.spec.ts +30 -0
  70. package/template/tests/unit/permissions/rules.spec.ts +106 -0
  71. package/template/tests/unit/permissions/state-and-directives.spec.ts +176 -0
  72. package/template/tests/unit/router/examples.spec.ts +5 -1
  73. package/template/tsconfig.json +8 -1
  74. package/template/vite.config.ts +19 -9
@@ -0,0 +1,203 @@
1
+ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
2
+ import { createPinia, setActivePinia } from 'pinia'
3
+ import { useUserStore } from '@/store/modules/user'
4
+ import { signOut } from '@/services/auth'
5
+ import { beginRequest, SIGN_OUT_REQUEST_SCOPE } from '@/utils/http/request-manager'
6
+ import { registerSessionCleanup } from '@/utils/session'
7
+ import { useWorktabStore } from '@/store/modules/worktab'
8
+ import { useSettingStore } from '@/store/modules/setting'
9
+ import { StorageConfig } from '@/utils/storage/storage-config'
10
+ import { IframeRouteManager } from '@/router/core/IframeRouteManager'
11
+
12
+ const fixtures = vi.hoisted(() => ({ logout: vi.fn() }))
13
+ vi.mock('@/api/auth', () => ({ fetchLogout: fixtures.logout }))
14
+ vi.mock('@/router', () => ({
15
+ HOME_PAGE_PATH: '/home',
16
+ router: {
17
+ currentRoute: { value: { path: '/home', fullPath: '/home' } },
18
+ replace: vi.fn().mockResolvedValue(undefined)
19
+ }
20
+ }))
21
+ vi.mock('@/router/guards/beforeEach', () => ({ resetRouterState: vi.fn() }))
22
+ beforeEach(() => {
23
+ setActivePinia(createPinia())
24
+ localStorage.clear()
25
+ sessionStorage.clear()
26
+ fixtures.logout.mockReset().mockResolvedValue(undefined)
27
+ })
28
+ afterEach(() => {
29
+ vi.useRealTimers()
30
+ vi.restoreAllMocks()
31
+ })
32
+
33
+ describe('session request cleanup', () => {
34
+ it('cancels managed requests when auth state is cleared, including 401 cleanup', () => {
35
+ const user = useUserStore()
36
+ user.establishSession('token')
37
+ const request = beginRequest({})
38
+ user.clearAuthState(false)
39
+ expect(request.signal.aborted).toBe(true)
40
+ expect(user.accessToken).toBe('')
41
+ expect(user.isLogin).toBe(false)
42
+ })
43
+
44
+ it('cancels the old session even when the same token is used for a fresh login', () => {
45
+ const user = useUserStore()
46
+ user.establishSession('token')
47
+ const old = beginRequest({})
48
+ user.establishSession('token')
49
+ expect(old.signal.aborted).toBe(true)
50
+ const next = beginRequest({})
51
+ expect(next.signal.aborted).toBe(false)
52
+ user.setToken('another-token')
53
+ expect(next.signal.aborted).toBe(true)
54
+ })
55
+
56
+ it('cancels before the logout request and always clears local state if remote logout fails', async () => {
57
+ const user = useUserStore()
58
+ user.establishSession('token')
59
+ const old = beginRequest({})
60
+ vi.spyOn(console, 'warn').mockImplementation(() => {})
61
+ fixtures.logout.mockImplementation(async () => {
62
+ expect(old.signal.aborted).toBe(true)
63
+ throw new Error('Offline')
64
+ })
65
+ await signOut()
66
+ expect(user.isLogin).toBe(false)
67
+ expect(user.accessToken).toBe('')
68
+ })
69
+
70
+ it('does not let a delayed logout clear a newer authenticated session', async () => {
71
+ const user = useUserStore()
72
+ user.establishSession('token')
73
+ let complete!: () => void
74
+ fixtures.logout.mockImplementation(
75
+ () =>
76
+ new Promise<void>((resolve) => {
77
+ complete = resolve
78
+ })
79
+ )
80
+ const logout = signOut()
81
+ user.establishSession('token')
82
+ complete()
83
+ await logout
84
+ expect(user.accessToken).toBe('token')
85
+ expect(user.isLogin).toBe(true)
86
+ })
87
+
88
+ it('still completes sign-out if only the access token rotates during logout', async () => {
89
+ const user = useUserStore()
90
+ user.establishSession('token')
91
+ let complete!: () => void
92
+ fixtures.logout.mockImplementation(
93
+ () =>
94
+ new Promise<void>((resolve) => {
95
+ complete = resolve
96
+ })
97
+ )
98
+ const logout = signOut()
99
+ user.setToken('refreshed-token')
100
+ complete()
101
+ await logout
102
+ expect(user.isLogin).toBe(false)
103
+ expect(user.accessToken).toBe('')
104
+ })
105
+
106
+ it('shares repeated sign-out, blocks business requests and permits the scoped remote logout', async () => {
107
+ const user = useUserStore()
108
+ user.establishSession('token')
109
+ let complete!: () => void
110
+ fixtures.logout.mockImplementation(
111
+ () =>
112
+ new Promise<void>((resolve) => {
113
+ complete = resolve
114
+ })
115
+ )
116
+ const first = signOut()
117
+ expect(signOut()).toBe(first)
118
+ expect(fixtures.logout).toHaveBeenCalledOnce()
119
+ expect(fixtures.logout).toHaveBeenCalledWith({ requestScope: SIGN_OUT_REQUEST_SCOPE })
120
+ expect(user.isSigningOut).toBe(true)
121
+ expect(beginRequest({}).signal.aborted).toBe(true)
122
+ const remote = beginRequest({ scope: SIGN_OUT_REQUEST_SCOPE })
123
+ expect(remote.signal.aborted).toBe(false)
124
+ complete()
125
+ await first
126
+ expect(remote.signal.aborted).toBe(true)
127
+ expect(user.isSigningOut).toBe(false)
128
+ expect(beginRequest({}).signal.aborted).toBe(false)
129
+ })
130
+
131
+ it('cleans local state even if a custom remote logout never settles', async () => {
132
+ vi.useFakeTimers()
133
+ vi.spyOn(console, 'error').mockImplementation(() => {})
134
+ const user = useUserStore()
135
+ user.establishSession('token')
136
+ fixtures.logout.mockImplementation(() => new Promise(() => {}))
137
+ const task = signOut()
138
+ await vi.advanceTimersByTimeAsync(10000)
139
+ await task
140
+ expect(user.isLogin).toBe(false)
141
+ expect(user.isSigningOut).toBe(false)
142
+ })
143
+
144
+ it('clears account data and runs all project cleanups while preserving preferences and same-account tab metadata', () => {
145
+ vi.spyOn(console, 'error').mockImplementation(() => {})
146
+ const user = useUserStore()
147
+ const tabs = useWorktabStore()
148
+ const settings = useSettingStore()
149
+ user.establishSession('token')
150
+ user.setUserInfo({ userId: '0', userName: 'A', email: '', roles: [] })
151
+ user.searchHistory = [{ path: '/private', meta: { title: 'Private' } }]
152
+ tabs.opened = [{ path: '/private', title: 'Private' }] as typeof tabs.opened
153
+ tabs.current = tabs.opened[0]
154
+ const preferences = JSON.stringify(settings.$state)
155
+ const epoch = user.sessionEpoch
156
+ const stopBroken = registerSessionCleanup(() => {
157
+ throw new Error('Cleanup failed')
158
+ })
159
+ const cleanup = vi.fn()
160
+ const stop = registerSessionCleanup(cleanup)
161
+ try {
162
+ user.clearAuthState(false)
163
+ expect(user.searchHistory).toEqual([])
164
+ expect(user.info).toEqual({})
165
+ expect(user.sessionEpoch).toBeGreaterThan(epoch)
166
+ expect(tabs.current).toEqual({})
167
+ expect(cleanup).toHaveBeenCalledOnce()
168
+ expect(JSON.stringify(settings.$state)).toBe(preferences)
169
+ user.establishSession('next')
170
+ user.setUserInfo({ userId: '0', userName: 'A', email: '', roles: [] })
171
+ user.checkAndClearWorktabs()
172
+ expect(tabs.opened).toHaveLength(1)
173
+ user.establishSession('other')
174
+ user.setUserInfo({ userId: 'B', userName: 'B', email: '', roles: [] })
175
+ user.checkAndClearWorktabs()
176
+ expect(tabs.opened).toEqual([])
177
+ expect(tabs.current).toEqual({})
178
+ } finally {
179
+ stop()
180
+ stopBroken()
181
+ }
182
+ })
183
+
184
+ it('drops tabs with unknown ownership and namespaces iframe and recovery storage', () => {
185
+ const user = useUserStore()
186
+ const tabs = useWorktabStore()
187
+ tabs.opened = [{ path: '/private' }] as typeof tabs.opened
188
+ user.setUserInfo({ userId: 'A', userName: 'A', email: '', roles: [] })
189
+ user.checkAndClearWorktabs()
190
+ expect(tabs.opened).toEqual([])
191
+ const manager = IframeRouteManager.getInstance()
192
+ manager.add({ path: '/iframe', meta: { title: 'Iframe' } })
193
+ manager.save()
194
+ expect(sessionStorage.getItem(StorageConfig.IFRAME_ROUTES_KEY)).not.toBeNull()
195
+ manager.clear()
196
+ expect(sessionStorage.getItem(StorageConfig.IFRAME_ROUTES_KEY)).toBeNull()
197
+ localStorage.setItem('neighbor-token', 'keep')
198
+ localStorage.setItem(StorageConfig.generateStorageKey('user'), 'remove')
199
+ StorageConfig.clearApplicationStorage(localStorage)
200
+ expect(localStorage.getItem('neighbor-token')).toBe('keep')
201
+ expect(localStorage.getItem(StorageConfig.generateStorageKey('user'))).toBeNull()
202
+ })
203
+ })
@@ -44,4 +44,50 @@ describe('HTTP contract helpers', () => {
44
44
 
45
45
  expect(left).toBe(right)
46
46
  })
47
+
48
+ it('does not collide on types, delimiters, sparse arrays or nested values', () => {
49
+ const pairs = [
50
+ [{ a: 'x,b:y' }, { a: 'x', b: 'y' }],
51
+ [1, '1'],
52
+ [null, undefined],
53
+ [
54
+ [1, 2],
55
+ ['1', '2']
56
+ ],
57
+ [[undefined], Array(1)],
58
+ [{ a: ['x,y'] }, { a: ['x', 'y'] }]
59
+ ]
60
+ for (const [left, right] of pairs)
61
+ expect(stableSerialize(left)).not.toBe(stableSerialize(right))
62
+ })
63
+
64
+ it('skips automatic comparison for uploads, binary data, custom serialization and cycles', () => {
65
+ const circular: Record<string, unknown> = {}
66
+ circular.self = circular
67
+ for (const data of [
68
+ new FormData(),
69
+ new Blob(['x']),
70
+ new ArrayBuffer(2),
71
+ new Uint8Array(2),
72
+ new Date(),
73
+ circular
74
+ ]) {
75
+ expect(createRequestKey({ url: '/upload', data })).toBeUndefined()
76
+ }
77
+ expect(createRequestKey({ url: '/list', paramsSerializer: () => 'custom' })).toBeUndefined()
78
+ expect(createRequestKey({ url: '/list', transformRequest: [(data) => data] })).toBeUndefined()
79
+ })
80
+
81
+ it('distinguishes origins, response modes and authentication contexts', () => {
82
+ const base = { url: '/list', baseURL: '/api', params: { page: 1 } }
83
+ for (const extra of [
84
+ { baseURL: '/other' },
85
+ { responseType: 'blob' as const },
86
+ { headers: { 'X-Tenant': 'other' } },
87
+ { withCredentials: true },
88
+ { auth: { username: 'other', password: 'test' } }
89
+ ]) {
90
+ expect(createRequestKey({ ...base, ...extra })).not.toBe(createRequestKey(base))
91
+ }
92
+ })
47
93
  })