@rock555/frontend-core 2.0.2 → 3.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.
- package/README.md +95 -95
- package/package.json +98 -98
- package/src/components/GlobalPendingBar.vue +85 -85
- package/src/components/SearchPicker.vue +84 -84
- package/src/components/filters/DateRangeField.vue +692 -692
- package/src/components/filters/{ExportCsvButton.vue → ExportButton.vue} +62 -60
- package/src/components/filters/FiltersBar.vue +150 -150
- package/src/components/filters/MonthField.vue +309 -309
- package/src/components/filters/SortControl.vue +162 -162
- package/src/components/filters/SortControlPanel.vue +242 -242
- package/src/components/filters/sortControl.types.ts +25 -25
- package/src/components/modals/ConfirmModal.vue +58 -58
- package/src/components/modals/ImageViewerModal.vue +200 -200
- package/src/components/tables/MultiSortHeader.vue +126 -126
- package/src/components/tables/TableBodyRow.vue +62 -62
- package/src/components/tables/TableFooterRow.vue +54 -54
- package/src/components/tables/TableHeaderRow.vue +75 -75
- package/src/components/tables/TableLoadedCount.vue +61 -61
- package/src/components/tables/TableLoadedFooter.vue +44 -44
- package/src/components/tables/TableSkeletonRows.vue +40 -40
- package/src/components/tables/TableVirtualPad.vue +16 -16
- package/src/components/tables/cells/BoolBadgeCell.vue +32 -32
- package/src/components/tables/multiSortHeader.types.ts +16 -16
- package/src/components/ui/FilterCheckbox.vue +1 -1
- package/src/components/ui/FilterSelect.vue +2 -0
- package/src/components/ui/UiActionTiles.vue +92 -92
- package/src/components/ui/UiBackLink.vue +39 -39
- package/src/components/ui/UiBadge.vue +60 -60
- package/src/components/ui/UiButton.vue +126 -126
- package/src/components/ui/UiCard.vue +88 -88
- package/src/components/ui/UiCount.vue +35 -35
- package/src/components/ui/UiKpiGrid.vue +144 -142
- package/src/components/ui/UiPopover.vue +62 -62
- package/src/components/ui/UiSearchInput.vue +102 -102
- package/src/components/ui/UiSegmented.vue +145 -145
- package/src/components/ui/UiTableCard.vue +116 -116
- package/src/components/ui/inputs/DateFormInput.vue +2 -2
- package/src/components/ui/inputs/FileInput.vue +5 -0
- package/src/components/ui/inputs/RadioSegmentFormInput.vue +0 -1
- package/src/components/ui/inputs/SelectFormInput.vue +1 -2
- package/src/components/ui/inputs/SmartField.vue +15 -13
- package/src/components/ui/inputs/TextareaFormInput.vue +2 -2
- package/src/components/ui/uiActionTiles.types.ts +10 -10
- package/src/components/ui/uiBadge.types.ts +11 -11
- package/src/components/ui/uiKpi.types.ts +19 -17
- package/src/composables/useAppForm.ts +67 -67
- package/src/composables/useConfirm.ts +21 -21
- package/src/composables/useFilterState.ts +70 -70
- package/src/composables/useServerList.ts +348 -348
- package/src/composables/useServerTable.ts +117 -117
- package/src/composables/useSharedAsync.ts +51 -51
- package/src/composables/useVirtualTable.ts +77 -77
- package/src/config.ts +156 -155
- package/src/errors/actionCancelled.ts +9 -9
- package/src/errors/apiError.helper.ts +161 -161
- package/src/errors/useHandleError.ts +33 -33
- package/src/helpers/calendarRange.helper.ts +74 -74
- package/src/helpers/month.helper.ts +63 -63
- package/src/helpers/periodLabel.helper.ts +70 -70
- package/src/helpers/periodPresets.helper.ts +76 -76
- package/src/helpers/sort.helper.ts +57 -57
- package/src/helpers/tableFields.helper.ts +205 -205
- package/src/helpers/urlParams.helper.ts +99 -99
- package/src/helpers/urlSchema.helper.ts +296 -296
- package/src/plugins/modals.plugin.ts +253 -253
- package/src/plugins/table.plugin.ts +173 -173
|
@@ -1,161 +1,161 @@
|
|
|
1
|
-
// Помилка API → текст людині й помилки по полях форми.
|
|
2
|
-
//
|
|
3
|
-
// Ланцюг логіки однаковий у всіх проєктах і живе тут, а самі тексти дає проєкт
|
|
4
|
-
// (`SharedConfig.errors`): коди в кожного свої, бек тексти не шле.
|
|
5
|
-
//
|
|
6
|
-
// Ланцюг запасних варіантів:
|
|
7
|
-
// 1. код є в словнику → текст проєкту (з `meta`, якщо він її вживає);
|
|
8
|
-
// 2. коду немає (бек завів новий, збірка стара) → текст за HTTP-статусом;
|
|
9
|
-
// 3. тіло взагалі не наше (проксі, обрив) → загальний текст.
|
|
10
|
-
|
|
11
|
-
import { AppError } from '../api/errors'
|
|
12
|
-
import { type ApiProblem, ApiProblemHelper } from '../api/errors/apiProblem'
|
|
13
|
-
import { SharedConfig } from '../config'
|
|
14
|
-
|
|
15
|
-
const VALIDATION_FAILED = 'VALIDATION_FAILED'
|
|
16
|
-
|
|
17
|
-
/** Зріз форми, потрібний роздачі помилок. Дає `useMyForm`. */
|
|
18
|
-
export interface FormErrorTarget {
|
|
19
|
-
setErrors: (fields: Record<string, string>) => void
|
|
20
|
-
fieldPaths: readonly string[]
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
const texts = () => SharedConfig.get().errors
|
|
24
|
-
|
|
25
|
-
export class ApiErrorHelper {
|
|
26
|
-
/**
|
|
27
|
-
* `meta` запису саме цього коду, або `null`, коли відмова інша.
|
|
28
|
-
* Для кодів, на які фронт реагує, а не лише показує текст. Типи кодів знає проєкт.
|
|
29
|
-
*/
|
|
30
|
-
static metaOf<TMeta = unknown>(error: unknown, code: string): TMeta | null {
|
|
31
|
-
if (!(error instanceof AppError) || error.problem === null) return null
|
|
32
|
-
|
|
33
|
-
const entry = error.problem.errors.find(item => item.code === code)
|
|
34
|
-
|
|
35
|
-
return entry === undefined ? null : (entry.meta as TMeta)
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
/**
|
|
39
|
-
* Текст користувачу за будь-якою помилкою. Приймає саму помилку, а не `problem`:
|
|
40
|
-
* коли тіло не наше, підпис усе одно є, за статусом. Не `error.message`: там англійська.
|
|
41
|
-
*/
|
|
42
|
-
static message(error: unknown): string {
|
|
43
|
-
const { fallback, timeout, byStatus, serverError } = texts()
|
|
44
|
-
|
|
45
|
-
if (!(error instanceof AppError)) return fallback
|
|
46
|
-
if (error.isTimeout) return timeout
|
|
47
|
-
|
|
48
|
-
return ApiErrorHelper.byProblem(error.problem)
|
|
49
|
-
?? byStatus[error.status]
|
|
50
|
-
?? (error.status >= 500 ? serverError : fallback)
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
/** Сесія скінчилась: людині є що зробити, увійти знову. */
|
|
54
|
-
static isSessionExpired(error: unknown): boolean {
|
|
55
|
-
return error instanceof AppError && (error.status === 401 || error.status === 419)
|
|
56
|
-
}
|
|
57
|
-
|
|
58
|
-
/**
|
|
59
|
-
* Найточніший підпис із тіла: код запису → код категорії.
|
|
60
|
-
*
|
|
61
|
-
* Єдиний запис валідації — текст за його правилом: без форми він сам пояснює
|
|
62
|
-
* відмову, а словник дав би «Перевірте заповнені поля» там, де полів немає.
|
|
63
|
-
*/
|
|
64
|
-
private static byProblem(problem: ApiProblem | null): string | undefined {
|
|
65
|
-
if (problem === null) return undefined
|
|
66
|
-
|
|
67
|
-
const { rule, showDetail } = texts()
|
|
68
|
-
// Прикладний код точніший за запис валідації, навіть якщо стоїть не першим.
|
|
69
|
-
const entry = problem.errors.find(item => item.code !== VALIDATION_FAILED) ?? ApiProblemHelper.primary(problem)
|
|
70
|
-
|
|
71
|
-
if (entry?.code === VALIDATION_FAILED && problem.errors.length === 1) return rule(entry)
|
|
72
|
-
|
|
73
|
-
return ApiErrorHelper.textFor(entry?.code, entry?.meta)
|
|
74
|
-
?? ApiErrorHelper.textFor(problem.code, undefined)
|
|
75
|
-
?? (showDetail ? problem.detail : undefined)
|
|
76
|
-
}
|
|
77
|
-
|
|
78
|
-
/** Помилки полів: `{ шлях поля → текст }`, у такому вигляді їх приймає `setErrors` vee-validate. */
|
|
79
|
-
private static fieldErrors(problem: ApiProblem | null): Record<string, string> {
|
|
80
|
-
if (problem === null) return {}
|
|
81
|
-
|
|
82
|
-
const { rule, fallback, fieldsOf } = texts()
|
|
83
|
-
const result: Record<string, string> = {}
|
|
84
|
-
|
|
85
|
-
for (const entry of problem.errors) {
|
|
86
|
-
const fields = fieldsOf?.(entry) ?? (entry.field === undefined ? [] : [entry.field])
|
|
87
|
-
|
|
88
|
-
for (const field of fields) {
|
|
89
|
-
if (field in result) continue
|
|
90
|
-
|
|
91
|
-
result[field] = entry.code === VALIDATION_FAILED
|
|
92
|
-
? rule({ ...entry, field })
|
|
93
|
-
: ApiErrorHelper.textFor(entry.code, entry.meta) ?? fallback
|
|
94
|
-
}
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
return result
|
|
98
|
-
}
|
|
99
|
-
|
|
100
|
-
/** Помилки 422 за шляхом поля запиту: для списків, яких немає серед полів форми. */
|
|
101
|
-
static fieldErrorsOf(error: unknown): Record<string, string> {
|
|
102
|
-
return error instanceof AppError && error.status === 422
|
|
103
|
-
? ApiErrorHelper.fieldErrors(error.problem)
|
|
104
|
-
: {}
|
|
105
|
-
}
|
|
106
|
-
|
|
107
|
-
/**
|
|
108
|
-
* Віддати помилку 422 полям форми: `true` — вона лягла у форму.
|
|
109
|
-
*
|
|
110
|
-
* Модалку з формою при помилці НЕ закриваємо: відмову виправляють тут же, набране
|
|
111
|
-
* не має зникати разом із вікном. Текст показує onError мутації.
|
|
112
|
-
*
|
|
113
|
-
* Поля бека — імена запиту (`payment_date`), у форми свої (`month`). Шлях перекладається:
|
|
114
|
-
* точний збіг → camelCase → `map` → `SharedConfig.errors.resolveField`.
|
|
115
|
-
*
|
|
116
|
-
* @param form `setErrors` + `fieldPaths` з `useMyForm`
|
|
117
|
-
* @param map поле бека → поле форми, лише для змістовних перейменувань
|
|
118
|
-
*/
|
|
119
|
-
static applyToForm(error: unknown, form: FormErrorTarget, map: Record<string, string> = {}): boolean {
|
|
120
|
-
if (!(error instanceof AppError) || error.status !== 422) return false
|
|
121
|
-
|
|
122
|
-
const fields: Record<string, string> = {}
|
|
123
|
-
const unknownPaths: string[] = []
|
|
124
|
-
|
|
125
|
-
for (const [path, text] of Object.entries(ApiErrorHelper.fieldErrors(error.problem))) {
|
|
126
|
-
const formPath = ApiErrorHelper.formPath(path, form.fieldPaths, map)
|
|
127
|
-
|
|
128
|
-
if (formPath === undefined) unknownPaths.push(path)
|
|
129
|
-
else if (!(formPath in fields)) fields[formPath] = text
|
|
130
|
-
}
|
|
131
|
-
|
|
132
|
-
if (Object.keys(fields).length > 0) form.setErrors(fields)
|
|
133
|
-
|
|
134
|
-
// Не тост: текст людина вже бачить від onError, а це підказка розробнику, чого бракує в `map`.
|
|
135
|
-
if (unknownPaths.length > 0) console.warn('[api] field errors with no form field:', unknownPaths)
|
|
136
|
-
|
|
137
|
-
return true
|
|
138
|
-
}
|
|
139
|
-
|
|
140
|
-
/** `undefined` — такого поля у формі немає. */
|
|
141
|
-
private static formPath(path: string, fieldPaths: readonly string[], map: Record<string, string>): string | undefined {
|
|
142
|
-
const candidates = [path, ApiErrorHelper.toCamel(path), map[path], texts().resolveField?.(path, fieldPaths)]
|
|
143
|
-
|
|
144
|
-
return candidates.find((candidate): candidate is string =>
|
|
145
|
-
candidate !== undefined && fieldPaths.includes(candidate))
|
|
146
|
-
}
|
|
147
|
-
|
|
148
|
-
/** `license_plate` → `licensePlate`: більшість розбіжностей рівно така. */
|
|
149
|
-
private static toCamel(path: string): string {
|
|
150
|
-
return path.replace(/_([a-z0-9])/gu, (_, char: string) => char.toUpperCase())
|
|
151
|
-
}
|
|
152
|
-
|
|
153
|
-
/** `undefined` — коду немає в словнику: запасний варіант обирає той, хто знає контекст. */
|
|
154
|
-
private static textFor(code: string | undefined, meta: unknown): string | undefined {
|
|
155
|
-
if (code === undefined) return undefined
|
|
156
|
-
|
|
157
|
-
const text = texts().codes[code]
|
|
158
|
-
|
|
159
|
-
return typeof text === 'function' ? text(meta) : text
|
|
160
|
-
}
|
|
161
|
-
}
|
|
1
|
+
// Помилка API → текст людині й помилки по полях форми.
|
|
2
|
+
//
|
|
3
|
+
// Ланцюг логіки однаковий у всіх проєктах і живе тут, а самі тексти дає проєкт
|
|
4
|
+
// (`SharedConfig.errors`): коди в кожного свої, бек тексти не шле.
|
|
5
|
+
//
|
|
6
|
+
// Ланцюг запасних варіантів:
|
|
7
|
+
// 1. код є в словнику → текст проєкту (з `meta`, якщо він її вживає);
|
|
8
|
+
// 2. коду немає (бек завів новий, збірка стара) → текст за HTTP-статусом;
|
|
9
|
+
// 3. тіло взагалі не наше (проксі, обрив) → загальний текст.
|
|
10
|
+
|
|
11
|
+
import { AppError } from '../api/errors'
|
|
12
|
+
import { type ApiProblem, ApiProblemHelper } from '../api/errors/apiProblem'
|
|
13
|
+
import { SharedConfig } from '../config'
|
|
14
|
+
|
|
15
|
+
const VALIDATION_FAILED = 'VALIDATION_FAILED'
|
|
16
|
+
|
|
17
|
+
/** Зріз форми, потрібний роздачі помилок. Дає `useMyForm`. */
|
|
18
|
+
export interface FormErrorTarget {
|
|
19
|
+
setErrors: (fields: Record<string, string>) => void
|
|
20
|
+
fieldPaths: readonly string[]
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
const texts = () => SharedConfig.get().errors
|
|
24
|
+
|
|
25
|
+
export class ApiErrorHelper {
|
|
26
|
+
/**
|
|
27
|
+
* `meta` запису саме цього коду, або `null`, коли відмова інша.
|
|
28
|
+
* Для кодів, на які фронт реагує, а не лише показує текст. Типи кодів знає проєкт.
|
|
29
|
+
*/
|
|
30
|
+
static metaOf<TMeta = unknown>(error: unknown, code: string): TMeta | null {
|
|
31
|
+
if (!(error instanceof AppError) || error.problem === null) return null
|
|
32
|
+
|
|
33
|
+
const entry = error.problem.errors.find(item => item.code === code)
|
|
34
|
+
|
|
35
|
+
return entry === undefined ? null : (entry.meta as TMeta)
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* Текст користувачу за будь-якою помилкою. Приймає саму помилку, а не `problem`:
|
|
40
|
+
* коли тіло не наше, підпис усе одно є, за статусом. Не `error.message`: там англійська.
|
|
41
|
+
*/
|
|
42
|
+
static message(error: unknown): string {
|
|
43
|
+
const { fallback, timeout, byStatus, serverError } = texts()
|
|
44
|
+
|
|
45
|
+
if (!(error instanceof AppError)) return fallback
|
|
46
|
+
if (error.isTimeout) return timeout
|
|
47
|
+
|
|
48
|
+
return ApiErrorHelper.byProblem(error.problem)
|
|
49
|
+
?? byStatus[error.status]
|
|
50
|
+
?? (error.status >= 500 ? serverError : fallback)
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/** Сесія скінчилась: людині є що зробити, увійти знову. */
|
|
54
|
+
static isSessionExpired(error: unknown): boolean {
|
|
55
|
+
return error instanceof AppError && (error.status === 401 || error.status === 419)
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* Найточніший підпис із тіла: код запису → код категорії.
|
|
60
|
+
*
|
|
61
|
+
* Єдиний запис валідації — текст за його правилом: без форми він сам пояснює
|
|
62
|
+
* відмову, а словник дав би «Перевірте заповнені поля» там, де полів немає.
|
|
63
|
+
*/
|
|
64
|
+
private static byProblem(problem: ApiProblem | null): string | undefined {
|
|
65
|
+
if (problem === null) return undefined
|
|
66
|
+
|
|
67
|
+
const { rule, showDetail } = texts()
|
|
68
|
+
// Прикладний код точніший за запис валідації, навіть якщо стоїть не першим.
|
|
69
|
+
const entry = problem.errors.find(item => item.code !== VALIDATION_FAILED) ?? ApiProblemHelper.primary(problem)
|
|
70
|
+
|
|
71
|
+
if (entry?.code === VALIDATION_FAILED && problem.errors.length === 1) return rule(entry)
|
|
72
|
+
|
|
73
|
+
return ApiErrorHelper.textFor(entry?.code, entry?.meta)
|
|
74
|
+
?? ApiErrorHelper.textFor(problem.code, undefined)
|
|
75
|
+
?? (showDetail ? problem.detail : undefined)
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/** Помилки полів: `{ шлях поля → текст }`, у такому вигляді їх приймає `setErrors` vee-validate. */
|
|
79
|
+
private static fieldErrors(problem: ApiProblem | null): Record<string, string> {
|
|
80
|
+
if (problem === null) return {}
|
|
81
|
+
|
|
82
|
+
const { rule, fallback, fieldsOf } = texts()
|
|
83
|
+
const result: Record<string, string> = {}
|
|
84
|
+
|
|
85
|
+
for (const entry of problem.errors) {
|
|
86
|
+
const fields = fieldsOf?.(entry) ?? (entry.field === undefined ? [] : [entry.field])
|
|
87
|
+
|
|
88
|
+
for (const field of fields) {
|
|
89
|
+
if (field in result) continue
|
|
90
|
+
|
|
91
|
+
result[field] = entry.code === VALIDATION_FAILED
|
|
92
|
+
? rule({ ...entry, field })
|
|
93
|
+
: ApiErrorHelper.textFor(entry.code, entry.meta) ?? fallback
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
return result
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
/** Помилки 422 за шляхом поля запиту: для списків, яких немає серед полів форми. */
|
|
101
|
+
static fieldErrorsOf(error: unknown): Record<string, string> {
|
|
102
|
+
return error instanceof AppError && error.status === 422
|
|
103
|
+
? ApiErrorHelper.fieldErrors(error.problem)
|
|
104
|
+
: {}
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
/**
|
|
108
|
+
* Віддати помилку 422 полям форми: `true` — вона лягла у форму.
|
|
109
|
+
*
|
|
110
|
+
* Модалку з формою при помилці НЕ закриваємо: відмову виправляють тут же, набране
|
|
111
|
+
* не має зникати разом із вікном. Текст показує onError мутації.
|
|
112
|
+
*
|
|
113
|
+
* Поля бека — імена запиту (`payment_date`), у форми свої (`month`). Шлях перекладається:
|
|
114
|
+
* точний збіг → camelCase → `map` → `SharedConfig.errors.resolveField`.
|
|
115
|
+
*
|
|
116
|
+
* @param form `setErrors` + `fieldPaths` з `useMyForm`
|
|
117
|
+
* @param map поле бека → поле форми, лише для змістовних перейменувань
|
|
118
|
+
*/
|
|
119
|
+
static applyToForm(error: unknown, form: FormErrorTarget, map: Record<string, string> = {}): boolean {
|
|
120
|
+
if (!(error instanceof AppError) || error.status !== 422) return false
|
|
121
|
+
|
|
122
|
+
const fields: Record<string, string> = {}
|
|
123
|
+
const unknownPaths: string[] = []
|
|
124
|
+
|
|
125
|
+
for (const [path, text] of Object.entries(ApiErrorHelper.fieldErrors(error.problem))) {
|
|
126
|
+
const formPath = ApiErrorHelper.formPath(path, form.fieldPaths, map)
|
|
127
|
+
|
|
128
|
+
if (formPath === undefined) unknownPaths.push(path)
|
|
129
|
+
else if (!(formPath in fields)) fields[formPath] = text
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
if (Object.keys(fields).length > 0) form.setErrors(fields)
|
|
133
|
+
|
|
134
|
+
// Не тост: текст людина вже бачить від onError, а це підказка розробнику, чого бракує в `map`.
|
|
135
|
+
if (unknownPaths.length > 0) console.warn('[api] field errors with no form field:', unknownPaths)
|
|
136
|
+
|
|
137
|
+
return true
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/** `undefined` — такого поля у формі немає. */
|
|
141
|
+
private static formPath(path: string, fieldPaths: readonly string[], map: Record<string, string>): string | undefined {
|
|
142
|
+
const candidates = [path, ApiErrorHelper.toCamel(path), map[path], texts().resolveField?.(path, fieldPaths)]
|
|
143
|
+
|
|
144
|
+
return candidates.find((candidate): candidate is string =>
|
|
145
|
+
candidate !== undefined && fieldPaths.includes(candidate))
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
/** `license_plate` → `licensePlate`: більшість розбіжностей рівно така. */
|
|
149
|
+
private static toCamel(path: string): string {
|
|
150
|
+
return path.replace(/_([a-z0-9])/gu, (_, char: string) => char.toUpperCase())
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/** `undefined` — коду немає в словнику: запасний варіант обирає той, хто знає контекст. */
|
|
154
|
+
private static textFor(code: string | undefined, meta: unknown): string | undefined {
|
|
155
|
+
if (code === undefined) return undefined
|
|
156
|
+
|
|
157
|
+
const text = texts().codes[code]
|
|
158
|
+
|
|
159
|
+
return typeof text === 'function' ? text(meta) : text
|
|
160
|
+
}
|
|
161
|
+
}
|
|
@@ -1,33 +1,33 @@
|
|
|
1
|
-
// Показ помилки мутації чи запиту: ЄДИНЕ місце, де вона стає видимою людині.
|
|
2
|
-
// Як саме показати (тост, стор сповіщень, кнопка «Увійти») вирішує проєкт: `SharedConfig.notifyError`.
|
|
3
|
-
|
|
4
|
-
import axios from 'axios'
|
|
5
|
-
import { AppError } from '../api/errors'
|
|
6
|
-
import { SharedConfig } from '../config'
|
|
7
|
-
import { ActionCancelledError } from './actionCancelled'
|
|
8
|
-
import { ApiErrorHelper } from './apiError.helper'
|
|
9
|
-
|
|
10
|
-
export function handleApiError(error: unknown): void {
|
|
11
|
-
// Скасований запит — не помилка: ми самі обірвали застарілий при зміні фільтра.
|
|
12
|
-
if (axios.isCancel(error)) return
|
|
13
|
-
// Людина закрила діалог, без якого дію не виконати.
|
|
14
|
-
if (error instanceof ActionCancelledError) return
|
|
15
|
-
|
|
16
|
-
// Перехоплювач загортає все, що прийшло з мережі, в AppError. Решта — баг нашого коду.
|
|
17
|
-
if (!(error instanceof AppError)) console.error('-- Unhandled error --', error)
|
|
18
|
-
|
|
19
|
-
const text = ApiErrorHelper.message(error)
|
|
20
|
-
// Однакова помилка (ретраї, кілька запитів) — один тост, а не стос.
|
|
21
|
-
const codes = error instanceof AppError
|
|
22
|
-
? (error.problem?.errors ?? []).map(({ code }) => code).sort().join(',')
|
|
23
|
-
: ''
|
|
24
|
-
|
|
25
|
-
SharedConfig.get().notifyError(text, {
|
|
26
|
-
id: error instanceof AppError ? `${error.status}:${codes}:${text}` : text,
|
|
27
|
-
isSessionExpired: ApiErrorHelper.isSessionExpired(error),
|
|
28
|
-
})
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
export function useHandleError() {
|
|
32
|
-
return { handleError: handleApiError }
|
|
33
|
-
}
|
|
1
|
+
// Показ помилки мутації чи запиту: ЄДИНЕ місце, де вона стає видимою людині.
|
|
2
|
+
// Як саме показати (тост, стор сповіщень, кнопка «Увійти») вирішує проєкт: `SharedConfig.notifyError`.
|
|
3
|
+
|
|
4
|
+
import axios from 'axios'
|
|
5
|
+
import { AppError } from '../api/errors'
|
|
6
|
+
import { SharedConfig } from '../config'
|
|
7
|
+
import { ActionCancelledError } from './actionCancelled'
|
|
8
|
+
import { ApiErrorHelper } from './apiError.helper'
|
|
9
|
+
|
|
10
|
+
export function handleApiError(error: unknown): void {
|
|
11
|
+
// Скасований запит — не помилка: ми самі обірвали застарілий при зміні фільтра.
|
|
12
|
+
if (axios.isCancel(error)) return
|
|
13
|
+
// Людина закрила діалог, без якого дію не виконати.
|
|
14
|
+
if (error instanceof ActionCancelledError) return
|
|
15
|
+
|
|
16
|
+
// Перехоплювач загортає все, що прийшло з мережі, в AppError. Решта — баг нашого коду.
|
|
17
|
+
if (!(error instanceof AppError)) console.error('-- Unhandled error --', error)
|
|
18
|
+
|
|
19
|
+
const text = ApiErrorHelper.message(error)
|
|
20
|
+
// Однакова помилка (ретраї, кілька запитів) — один тост, а не стос.
|
|
21
|
+
const codes = error instanceof AppError
|
|
22
|
+
? (error.problem?.errors ?? []).map(({ code }) => code).sort().join(',')
|
|
23
|
+
: ''
|
|
24
|
+
|
|
25
|
+
SharedConfig.get().notifyError(text, {
|
|
26
|
+
id: error instanceof AppError ? `${error.status}:${codes}:${text}` : text,
|
|
27
|
+
isSessionExpired: ApiErrorHelper.isSessionExpired(error),
|
|
28
|
+
})
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export function useHandleError() {
|
|
32
|
+
return { handleError: handleApiError }
|
|
33
|
+
}
|
|
@@ -1,74 +1,74 @@
|
|
|
1
|
-
// Міст між нашим Period ({from,to} у 'YYYY-MM-DD') і reka-ui RangeCalendar,
|
|
2
|
-
// що працює на @internationalized/date (CalendarDate). Плюс недільний снап
|
|
3
|
-
// (Пн–Вс, локаль uk) для режиму звітів.
|
|
4
|
-
|
|
5
|
-
import { CalendarDate, type DateValue, parseDate } from '@internationalized/date'
|
|
6
|
-
import dayjs from 'dayjs'
|
|
7
|
-
import type { DateRange } from 'reka-ui'
|
|
8
|
-
import { DateHelper } from './date.helper'
|
|
9
|
-
import type { Period } from './period.helper'
|
|
10
|
-
import { PeriodLabelHelper } from './periodLabel.helper'
|
|
11
|
-
|
|
12
|
-
export class CalendarRangeHelper {
|
|
13
|
-
// Пн — reka weekStartsOn; дублюємо для снапу через dayjs (локаль uk теж Пн).
|
|
14
|
-
static readonly WEEK_STARTS_ON = 1 as const
|
|
15
|
-
|
|
16
|
-
// 'YYYY-MM-DD' → CalendarDate. Порожнє/криве — undefined (не кидаємо: у полі
|
|
17
|
-
// період може бути ще не обраний).
|
|
18
|
-
static toCalendarDate(iso: string | null | undefined): CalendarDate | undefined {
|
|
19
|
-
if (!iso) return undefined
|
|
20
|
-
try {
|
|
21
|
-
return parseDate(iso)
|
|
22
|
-
} catch {
|
|
23
|
-
return undefined
|
|
24
|
-
}
|
|
25
|
-
}
|
|
26
|
-
|
|
27
|
-
static toRange(period: Period): DateRange {
|
|
28
|
-
return {
|
|
29
|
-
start: CalendarRangeHelper.toCalendarDate(period.from),
|
|
30
|
-
end: CalendarRangeHelper.toCalendarDate(period.to),
|
|
31
|
-
}
|
|
32
|
-
}
|
|
33
|
-
|
|
34
|
-
// Обидва кінці мають бути обрані — інакше період неповний і не комітиться.
|
|
35
|
-
static toPeriod(range: DateRange): Period | null {
|
|
36
|
-
if (!range.start || !range.end) return null
|
|
37
|
-
return { from: range.start.toString(), to: range.end.toString() }
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
// Розтягує будь-який діапазон до цілих тижнів: start → понеділок, end → неділя.
|
|
41
|
-
static snapToWeeks(range: DateRange): DateRange {
|
|
42
|
-
if (!range.start) return { start: undefined, end: undefined }
|
|
43
|
-
|
|
44
|
-
const monday = CalendarRangeHelper.weekStart(range.start)
|
|
45
|
-
// Поки обрано лише один кінець — тримаємо end порожнім (reka лишається в
|
|
46
|
-
// режимі вибору, даючи дотиснути другий тиждень). Знімати до неділі рано.
|
|
47
|
-
if (!range.end) return { start: monday, end: undefined }
|
|
48
|
-
|
|
49
|
-
const [lo, hi] = CalendarRangeHelper.order(range.start, range.end)
|
|
50
|
-
return { start: CalendarRangeHelper.weekStart(lo), end: CalendarRangeHelper.weekEnd(hi) }
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
private static order(a: DateValue, b: DateValue): [DateValue, DateValue] {
|
|
54
|
-
return a.compare(b) <= 0 ? [a, b] : [b, a]
|
|
55
|
-
}
|
|
56
|
-
|
|
57
|
-
private static weekStart(date: DateValue): CalendarDate {
|
|
58
|
-
return CalendarRangeHelper.fromDayjs(dayjs(date.toString()).startOf('week'))
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
private static weekEnd(date: DateValue): CalendarDate {
|
|
62
|
-
return CalendarRangeHelper.fromDayjs(dayjs(date.toString()).endOf('week'))
|
|
63
|
-
}
|
|
64
|
-
|
|
65
|
-
private static fromDayjs(d: dayjs.Dayjs): CalendarDate {
|
|
66
|
-
return parseDate(d.format(DateHelper.DEFAULT_DATE_FORMAT))
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
// Підпис поля-тригера: розумний діапазон зі схлопуванням спільних частин
|
|
70
|
-
// ("2–8 лют. 2026" · "8 січ. – 8 лют. 2026"). Порожньо — заглушка в компоненті.
|
|
71
|
-
static label(period: Period): string {
|
|
72
|
-
return PeriodLabelHelper.range(period.from, period.to)
|
|
73
|
-
}
|
|
74
|
-
}
|
|
1
|
+
// Міст між нашим Period ({from,to} у 'YYYY-MM-DD') і reka-ui RangeCalendar,
|
|
2
|
+
// що працює на @internationalized/date (CalendarDate). Плюс недільний снап
|
|
3
|
+
// (Пн–Вс, локаль uk) для режиму звітів.
|
|
4
|
+
|
|
5
|
+
import { CalendarDate, type DateValue, parseDate } from '@internationalized/date'
|
|
6
|
+
import dayjs from 'dayjs'
|
|
7
|
+
import type { DateRange } from 'reka-ui'
|
|
8
|
+
import { DateHelper } from './date.helper'
|
|
9
|
+
import type { Period } from './period.helper'
|
|
10
|
+
import { PeriodLabelHelper } from './periodLabel.helper'
|
|
11
|
+
|
|
12
|
+
export class CalendarRangeHelper {
|
|
13
|
+
// Пн — reka weekStartsOn; дублюємо для снапу через dayjs (локаль uk теж Пн).
|
|
14
|
+
static readonly WEEK_STARTS_ON = 1 as const
|
|
15
|
+
|
|
16
|
+
// 'YYYY-MM-DD' → CalendarDate. Порожнє/криве — undefined (не кидаємо: у полі
|
|
17
|
+
// період може бути ще не обраний).
|
|
18
|
+
static toCalendarDate(iso: string | null | undefined): CalendarDate | undefined {
|
|
19
|
+
if (!iso) return undefined
|
|
20
|
+
try {
|
|
21
|
+
return parseDate(iso)
|
|
22
|
+
} catch {
|
|
23
|
+
return undefined
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
static toRange(period: Period): DateRange {
|
|
28
|
+
return {
|
|
29
|
+
start: CalendarRangeHelper.toCalendarDate(period.from),
|
|
30
|
+
end: CalendarRangeHelper.toCalendarDate(period.to),
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
// Обидва кінці мають бути обрані — інакше період неповний і не комітиться.
|
|
35
|
+
static toPeriod(range: DateRange): Period | null {
|
|
36
|
+
if (!range.start || !range.end) return null
|
|
37
|
+
return { from: range.start.toString(), to: range.end.toString() }
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
// Розтягує будь-який діапазон до цілих тижнів: start → понеділок, end → неділя.
|
|
41
|
+
static snapToWeeks(range: DateRange): DateRange {
|
|
42
|
+
if (!range.start) return { start: undefined, end: undefined }
|
|
43
|
+
|
|
44
|
+
const monday = CalendarRangeHelper.weekStart(range.start)
|
|
45
|
+
// Поки обрано лише один кінець — тримаємо end порожнім (reka лишається в
|
|
46
|
+
// режимі вибору, даючи дотиснути другий тиждень). Знімати до неділі рано.
|
|
47
|
+
if (!range.end) return { start: monday, end: undefined }
|
|
48
|
+
|
|
49
|
+
const [lo, hi] = CalendarRangeHelper.order(range.start, range.end)
|
|
50
|
+
return { start: CalendarRangeHelper.weekStart(lo), end: CalendarRangeHelper.weekEnd(hi) }
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
private static order(a: DateValue, b: DateValue): [DateValue, DateValue] {
|
|
54
|
+
return a.compare(b) <= 0 ? [a, b] : [b, a]
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
private static weekStart(date: DateValue): CalendarDate {
|
|
58
|
+
return CalendarRangeHelper.fromDayjs(dayjs(date.toString()).startOf('week'))
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
private static weekEnd(date: DateValue): CalendarDate {
|
|
62
|
+
return CalendarRangeHelper.fromDayjs(dayjs(date.toString()).endOf('week'))
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
private static fromDayjs(d: dayjs.Dayjs): CalendarDate {
|
|
66
|
+
return parseDate(d.format(DateHelper.DEFAULT_DATE_FORMAT))
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
// Підпис поля-тригера: розумний діапазон зі схлопуванням спільних частин
|
|
70
|
+
// ("2–8 лют. 2026" · "8 січ. – 8 лют. 2026"). Порожньо — заглушка в компоненті.
|
|
71
|
+
static label(period: Period): string {
|
|
72
|
+
return PeriodLabelHelper.range(period.from, period.to)
|
|
73
|
+
}
|
|
74
|
+
}
|