@jskit-ai/users-web 0.1.173 → 0.1.175

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 (113) hide show
  1. package/package.json +18 -149
  2. package/src/client/composables/account-settings/accountSettingsAvatarUploadRuntime.js +2 -2
  3. package/src/client/composables/useAccountSettingsRuntime.js +3 -3
  4. package/src/client/index.js +0 -11
  5. package/src/client/providers/UsersWebClientProvider.js +0 -2
  6. package/test/exportsContract.test.js +3 -29
  7. package/test/settingsPlacementContract.test.js +10 -0
  8. package/fixtures/crud-list-date-filters/App.vue +0 -107
  9. package/fixtures/crud-list-date-filters/index.html +0 -12
  10. package/fixtures/crud-list-date-filters/main.js +0 -24
  11. package/fixtures/crud-list-date-filters/vite.config.mjs +0 -18
  12. package/src/client/bulkActions.js +0 -47
  13. package/src/client/components/CrudAddEditScreen.vue +0 -186
  14. package/src/client/components/CrudDeleteAction.vue +0 -93
  15. package/src/client/components/CrudListBulkActionSurface.vue +0 -126
  16. package/src/client/components/CrudListDateFilterControl.vue +0 -188
  17. package/src/client/components/CrudListFilterSurface.vue +0 -388
  18. package/src/client/components/CrudListRecordActionMenu.vue +0 -120
  19. package/src/client/components/CrudListScreen.vue +0 -501
  20. package/src/client/components/CrudViewScreen.vue +0 -197
  21. package/src/client/composables/crud/crudBindingSupport.js +0 -75
  22. package/src/client/composables/crud/crudHttpClientSupport.js +0 -57
  23. package/src/client/composables/crud/crudJsonApiTransportSupport.js +0 -145
  24. package/src/client/composables/crud/crudLookupFieldLabelSupport.js +0 -151
  25. package/src/client/composables/crud/crudLookupFieldRuntime.js +0 -251
  26. package/src/client/composables/crud/crudSchemaFormHelpers.js +0 -464
  27. package/src/client/composables/internal/crudListFilterLookupSupport.js +0 -161
  28. package/src/client/composables/internal/crudListParentTitleSupport.js +0 -171
  29. package/src/client/composables/internal/useOperationScope.js +0 -144
  30. package/src/client/composables/records/useAddEdit.js +0 -224
  31. package/src/client/composables/records/useCrudAddEdit.js +0 -227
  32. package/src/client/composables/records/useCrudList.js +0 -101
  33. package/src/client/composables/records/useCrudView.js +0 -47
  34. package/src/client/composables/records/useList.js +0 -500
  35. package/src/client/composables/records/useView.js +0 -164
  36. package/src/client/composables/runtime/addEditUiRuntime.js +0 -130
  37. package/src/client/composables/runtime/listUiRuntime.js +0 -123
  38. package/src/client/composables/runtime/modelStateHelpers.js +0 -90
  39. package/src/client/composables/runtime/operationAdapters.js +0 -34
  40. package/src/client/composables/runtime/operationUiHelpers.js +0 -125
  41. package/src/client/composables/runtime/operationValidationHelpers.js +0 -51
  42. package/src/client/composables/runtime/useAddEditCore.js +0 -112
  43. package/src/client/composables/runtime/useCommandCore.js +0 -123
  44. package/src/client/composables/runtime/useEndpointResource.js +0 -199
  45. package/src/client/composables/runtime/useFieldErrorBag.js +0 -61
  46. package/src/client/composables/runtime/useListCore.js +0 -112
  47. package/src/client/composables/runtime/useUiFeedback.js +0 -98
  48. package/src/client/composables/runtime/useViewCore.js +0 -93
  49. package/src/client/composables/runtime/viewUiRuntime.js +0 -96
  50. package/src/client/composables/support/errorMessageHelpers.js +0 -66
  51. package/src/client/composables/support/listQueryParamSupport.js +0 -473
  52. package/src/client/composables/support/listSearchSupport.js +0 -70
  53. package/src/client/composables/support/refValueHelpers.js +0 -19
  54. package/src/client/composables/support/requestQueryRuntimeSupport.js +0 -141
  55. package/src/client/composables/support/resourceLoadStateHelpers.js +0 -208
  56. package/src/client/composables/support/routeTemplateHelpers.js +0 -285
  57. package/src/client/composables/support/scopeHelpers.js +0 -145
  58. package/src/client/composables/useAccess.js +0 -109
  59. package/src/client/composables/useCommand.js +0 -118
  60. package/src/client/composables/useCrudAddEditScreen.js +0 -88
  61. package/src/client/composables/useCrudDeleteAction.js +0 -160
  62. package/src/client/composables/useCrudListBulkActions.js +0 -147
  63. package/src/client/composables/useCrudListFilterLookups.js +0 -146
  64. package/src/client/composables/useCrudListFilters.js +0 -339
  65. package/src/client/composables/useCrudListParentTitle.js +0 -151
  66. package/src/client/composables/useCrudListRowActions.js +0 -144
  67. package/src/client/composables/useCrudListScreen.js +0 -237
  68. package/src/client/composables/useCrudViewScreen.js +0 -77
  69. package/src/client/composables/usePagedCollection.js +0 -181
  70. package/src/client/composables/useRealtimeQueryInvalidation.js +0 -156
  71. package/src/client/composables/useScopeRuntime.js +0 -135
  72. package/src/client/filters.js +0 -15
  73. package/src/client/lib/httpClient.js +0 -47
  74. package/src/client/lib/permissions.js +0 -34
  75. package/src/client/rowActions.js +0 -47
  76. package/src/client/support/contractGuards.js +0 -34
  77. package/src/client/support/crudListDateFilterSupport.js +0 -91
  78. package/test/addEditUiRuntime.test.js +0 -110
  79. package/test/crudBindingSupport.test.js +0 -110
  80. package/test/crudHttpClientSupport.test.js +0 -77
  81. package/test/crudJsonApiTransportSupport.test.js +0 -179
  82. package/test/crudListBulkActionSurface.test.js +0 -27
  83. package/test/crudListDateFilterSupport.test.js +0 -92
  84. package/test/crudListDateFilterSurface.browser.test.js +0 -182
  85. package/test/crudListFilterSurface.test.js +0 -90
  86. package/test/crudLookupFieldRuntime.test.js +0 -264
  87. package/test/crudScreenComponents.test.js +0 -117
  88. package/test/errorIntentContract.test.js +0 -31
  89. package/test/errorMessageHelpers.test.js +0 -28
  90. package/test/listQueryParamSupport.test.js +0 -223
  91. package/test/listUiRuntime.test.js +0 -102
  92. package/test/operationValidationHelpers.test.js +0 -64
  93. package/test/permissions.test.js +0 -35
  94. package/test/refValueHelpers.test.js +0 -14
  95. package/test/requestTransportOptions.test.js +0 -457
  96. package/test/resourceLoadStateHelpers.test.js +0 -189
  97. package/test/routeTemplateHelpers.test.js +0 -85
  98. package/test/scopeHelpers.test.js +0 -57
  99. package/test/useAddEditCore.test.js +0 -124
  100. package/test/useAddEditRequestQueryParams.test.js +0 -190
  101. package/test/useCrudAddEdit.test.js +0 -415
  102. package/test/useCrudDeleteAction.test.js +0 -139
  103. package/test/useCrudListBulkActions.test.js +0 -65
  104. package/test/useCrudListFilterLookups.test.js +0 -114
  105. package/test/useCrudListFilters.test.js +0 -293
  106. package/test/useCrudListParentTitle.test.js +0 -262
  107. package/test/useCrudListRowActions.test.js +0 -77
  108. package/test/useListRouteInitialization.test.js +0 -337
  109. package/test/useListSearchSupport.test.js +0 -61
  110. package/test/usePagedCollection.test.js +0 -53
  111. package/test/useViewRequestQueryParams.test.js +0 -20
  112. package/test/viewCoreLoading.test.js +0 -44
  113. package/test/viewUiRuntime.test.js +0 -95
@@ -1,227 +0,0 @@
1
- import { computed, proxyRefs, reactive, watch } from "vue";
2
- import { useRoute, useRouter } from "vue-router";
3
- import { asPlainObject } from "../support/scopeHelpers.js";
4
- import { resolveCrudJsonApiTransport } from "../crud/crudJsonApiTransportSupport.js";
5
- import { resolveCrudHttpClient } from "../crud/crudHttpClientSupport.js";
6
- import { useAddEdit } from "./useAddEdit.js";
7
- import {
8
- resolveCrudBoundValues,
9
- } from "../crud/crudBindingSupport.js";
10
- import { resolveOperationRealtimeOptions } from "../useRealtimeQueryInvalidation.js";
11
- import {
12
- normalizeCrudFormFields,
13
- createCrudFormModel,
14
- buildCrudFormPayload,
15
- applyCrudPayloadToForm,
16
- resolveCrudRouteBoundFieldValues,
17
- resolveCrudFieldErrors
18
- } from "../crud/crudSchemaFormHelpers.js";
19
- import { hasResolvedQueryData } from "../support/resourceLoadStateHelpers.js";
20
-
21
- function normalizeFieldErrorKeys(keys = []) {
22
- return Array.isArray(keys)
23
- ? keys.map((entry) => String(entry || "").trim()).filter(Boolean)
24
- : [];
25
- }
26
-
27
- function normalizeSaveSuccessOptions(options = {}) {
28
- const source = asPlainObject(options);
29
- const invalidateQueryKey = Array.isArray(source.invalidateQueryKey)
30
- ? source.invalidateQueryKey
31
- : null;
32
- const listUrlTemplate = String(source.listUrlTemplate || "").trim();
33
- const navigateToView = source.navigateToView !== false;
34
- const navigateToList = source.navigateToList !== false;
35
-
36
- return Object.freeze({
37
- invalidateQueryKey,
38
- listUrlTemplate,
39
- navigateToView,
40
- navigateToList
41
- });
42
- }
43
-
44
- function useCrudAddEdit({
45
- resource = null,
46
- operationName = "",
47
- formFields = [],
48
- addEditOptions = {},
49
- saveSuccess = {},
50
- fieldBinding = null,
51
- createModel = null,
52
- buildPayload = null,
53
- mapPayloadToModel = null,
54
- input = null
55
- } = {}) {
56
- const router = useRouter();
57
- const route = useRoute();
58
- const normalizedFields = normalizeCrudFormFields(formFields);
59
- const normalizedAddEditOptions = asPlainObject(addEditOptions);
60
- const resolvedResource = normalizedAddEditOptions.resource || resource;
61
- const resolvedTransport = resolveCrudJsonApiTransport(
62
- normalizedAddEditOptions.transport,
63
- resolvedResource,
64
- {
65
- mode: "add-edit",
66
- operationName
67
- }
68
- );
69
- const resolvedRealtime = resolveOperationRealtimeOptions({
70
- realtime: normalizedAddEditOptions.realtime,
71
- fallbackRealtime: resolvedResource?.operations?.[operationName]?.realtime ||
72
- resolvedResource?.operations?.list?.realtime ||
73
- null
74
- });
75
- const saveSuccessOptions = normalizeSaveSuccessOptions(saveSuccess);
76
- const defaultFieldErrorKeys = normalizedFields.map((field) => field.key);
77
- const providedFieldErrorKeys = normalizeFieldErrorKeys(normalizedAddEditOptions.fieldErrorKeys);
78
- const fieldErrorKeys = providedFieldErrorKeys.length > 0 ? providedFieldErrorKeys : defaultFieldErrorKeys;
79
- const providedModel = normalizedAddEditOptions.model;
80
- const hasProvidedModel = Boolean(providedModel && typeof providedModel === "object" && !Array.isArray(providedModel));
81
- const defaultModel = typeof createModel === "function"
82
- ? asPlainObject(createModel(normalizedFields))
83
- : createCrudFormModel(normalizedFields);
84
- const form = hasProvidedModel ? providedModel : reactive(defaultModel);
85
- const boundFieldValues = computed(() => {
86
- return resolveCrudBoundValues({
87
- binding: fieldBinding,
88
- routeValues: resolveCrudRouteBoundFieldValues(normalizedFields, route?.params || {}),
89
- context: Object.freeze({
90
- route,
91
- fields: normalizedFields
92
- })
93
- });
94
- });
95
-
96
- function applyBoundFieldValues(target = {}) {
97
- Object.assign(target, boundFieldValues.value);
98
- return target;
99
- }
100
-
101
- watch(
102
- boundFieldValues,
103
- () => {
104
- applyBoundFieldValues(form);
105
- },
106
- {
107
- immediate: true,
108
- deep: true
109
- }
110
- );
111
- const inputOverride = input || normalizedAddEditOptions.input || null;
112
- const buildPayloadOverride = typeof buildPayload === "function"
113
- ? buildPayload
114
- : (typeof normalizedAddEditOptions.buildRawPayload === "function" ? normalizedAddEditOptions.buildRawPayload : null);
115
- const mapPayloadToModelOverride = typeof mapPayloadToModel === "function"
116
- ? mapPayloadToModel
117
- : (typeof normalizedAddEditOptions.mapLoadedToModel === "function" ? normalizedAddEditOptions.mapLoadedToModel : null);
118
- const onSaveSuccessOverride = typeof normalizedAddEditOptions.onSaveSuccess === "function"
119
- ? normalizedAddEditOptions.onSaveSuccess
120
- : null;
121
- const shouldApplyDefaultMapPayload = normalizedAddEditOptions.readEnabled !== false;
122
- const resolvedInput = inputOverride || resolvedResource?.operations?.[operationName]?.body || null;
123
-
124
- function resolveBuildRawPayload(model = {}, context = {}) {
125
- const payload = buildPayloadOverride
126
- ? buildPayloadOverride(model, {
127
- ...context,
128
- fields: normalizedFields
129
- })
130
- : buildCrudFormPayload(normalizedFields, model);
131
- applyBoundFieldValues(payload);
132
-
133
- return payload;
134
- }
135
-
136
- const effectiveMapLoadedToModel = mapPayloadToModelOverride
137
- ? (model = {}, payload = {}, context = {}) => {
138
- mapPayloadToModelOverride(model, payload, {
139
- ...context,
140
- fields: normalizedFields
141
- });
142
- applyBoundFieldValues(model);
143
- }
144
- : (shouldApplyDefaultMapPayload
145
- ? (model = {}, payload = {}) => {
146
- applyCrudPayloadToForm(normalizedFields, model, payload);
147
- applyBoundFieldValues(model);
148
- }
149
- : undefined);
150
-
151
- let addEditRuntime = null;
152
-
153
- async function handleSaveSuccess(payload, context = {}) {
154
- if (onSaveSuccessOverride) {
155
- await onSaveSuccessOverride(payload, context);
156
- return;
157
- }
158
-
159
- const queryClient = context?.queryClient;
160
- if (queryClient && saveSuccessOptions.invalidateQueryKey?.length > 0) {
161
- await queryClient.invalidateQueries({
162
- queryKey: saveSuccessOptions.invalidateQueryKey
163
- });
164
- }
165
-
166
- if (saveSuccessOptions.navigateToView) {
167
- const viewUrl = addEditRuntime?.resolveSavedViewUrl(payload) ||
168
- addEditRuntime?.resolveViewUrl(addEditRuntime?.recordId);
169
- if (viewUrl) {
170
- await router.push(viewUrl);
171
- return;
172
- }
173
- }
174
-
175
- if (!saveSuccessOptions.navigateToList) {
176
- return;
177
- }
178
-
179
- const listUrlTemplate = saveSuccessOptions.listUrlTemplate ||
180
- String(normalizedAddEditOptions.listUrlTemplate || "").trim();
181
- const listUrl = addEditRuntime?.resolveParams(listUrlTemplate);
182
- if (listUrl) {
183
- await router.push(listUrl);
184
- }
185
- }
186
-
187
- const addEdit = useAddEdit({
188
- ...normalizedAddEditOptions,
189
- resource: resolvedResource,
190
- client: resolveCrudHttpClient(resolvedResource, {
191
- client: normalizedAddEditOptions.client
192
- }),
193
- transport: resolvedTransport,
194
- model: form,
195
- fieldErrorKeys,
196
- input: resolvedInput,
197
- buildRawPayload: resolveBuildRawPayload,
198
- mapLoadedToModel: effectiveMapLoadedToModel,
199
- realtime: resolvedRealtime,
200
- onSaveSuccess: handleSaveSuccess
201
- });
202
- addEditRuntime = addEdit;
203
-
204
- function resolveFieldErrors(fieldKey = "") {
205
- return resolveCrudFieldErrors(addEdit.fieldErrors, fieldKey);
206
- }
207
-
208
- const showFormSkeleton = computed(() => {
209
- const hasResolvedData = hasResolvedQueryData({
210
- query: addEdit?.resource?.query,
211
- data: addEdit?.resource?.data
212
- });
213
-
214
- return Boolean(addEdit.isInitialLoading) && !hasResolvedData;
215
- });
216
-
217
- return proxyRefs({
218
- formFields: normalizedFields,
219
- fieldErrorKeys,
220
- form,
221
- addEdit,
222
- showFormSkeleton,
223
- resolveFieldErrors
224
- });
225
- }
226
-
227
- export { useCrudAddEdit };
@@ -1,101 +0,0 @@
1
- import { computed, unref } from "vue";
2
- import { useRoute } from "vue-router";
3
- import { resolveCrudJsonApiTransport } from "../crud/crudJsonApiTransportSupport.js";
4
- import { resolveCrudHttpClient } from "../crud/crudHttpClientSupport.js";
5
- import {
6
- resolveLookupFieldDisplayValue,
7
- resolveRecordTitle
8
- } from "../crud/crudLookupFieldLabelSupport.js";
9
- import { resolveCrudBoundValues } from "../crud/crudBindingSupport.js";
10
- import { resolveCrudListParentDescriptor } from "../internal/crudListParentTitleSupport.js";
11
- import {
12
- resolveRouteParamsSource,
13
- toRouteParamValue
14
- } from "../support/routeTemplateHelpers.js";
15
- import { asPlainObject } from "../support/scopeHelpers.js";
16
- import { resolveOperationRealtimeOptions } from "../useRealtimeQueryInvalidation.js";
17
- import { useList } from "./useList.js";
18
-
19
- function resolveRequestQueryParamsInput(requestQueryParams, context = {}) {
20
- if (typeof requestQueryParams === "function") {
21
- return asPlainObject(requestQueryParams(context));
22
- }
23
-
24
- return asPlainObject(unref(requestQueryParams));
25
- }
26
-
27
- function resolveCrudParentRequestQueryParams({ resource = {}, route = null, recordIdParam = "recordId" } = {}) {
28
- const descriptor = resolveCrudListParentDescriptor({
29
- resource,
30
- route,
31
- recordIdParam
32
- });
33
- if (!descriptor?.fieldKey || !descriptor?.routeParamKey) {
34
- return {};
35
- }
36
-
37
- const routeParams = resolveRouteParamsSource(route?.params || {});
38
- const routeParamValue = toRouteParamValue(routeParams[descriptor.routeParamKey]);
39
- if (!routeParamValue) {
40
- return {};
41
- }
42
-
43
- return {
44
- [descriptor.fieldKey]: routeParamValue
45
- };
46
- }
47
-
48
- function useCrudList({
49
- resource = null,
50
- requestQueryParams = null,
51
- parentBinding = null,
52
- recordIdParam = "recordId",
53
- route = null,
54
- realtime = undefined,
55
- ...listOptions
56
- } = {}) {
57
- const sourceRoute = route && typeof route === "object" ? route : useRoute();
58
- const boundParentRequestQueryParams = computed(() => {
59
- return resolveCrudBoundValues({
60
- binding: parentBinding,
61
- routeValues: resolveCrudParentRequestQueryParams({
62
- resource,
63
- route: sourceRoute,
64
- recordIdParam
65
- }),
66
- context: Object.freeze({
67
- route: sourceRoute,
68
- resource,
69
- recordIdParam
70
- })
71
- });
72
- });
73
- const records = useList({
74
- ...listOptions,
75
- client: resolveCrudHttpClient(resource, {
76
- client: listOptions.client
77
- }),
78
- transport: resolveCrudJsonApiTransport(listOptions.transport, resource, {
79
- mode: "list"
80
- }),
81
- realtime: resolveOperationRealtimeOptions({
82
- realtime,
83
- fallbackRealtime: resource?.operations?.list?.realtime || null
84
- }),
85
- recordIdParam,
86
- requestQueryParams(context = {}) {
87
- const baseRequestQueryParams = resolveRequestQueryParamsInput(requestQueryParams, context);
88
-
89
- return {
90
- ...baseRequestQueryParams,
91
- ...boundParentRequestQueryParams.value
92
- };
93
- }
94
- });
95
-
96
- records.resolveFieldDisplay = resolveLookupFieldDisplayValue;
97
- records.resolveRecordTitle = resolveRecordTitle;
98
- return records;
99
- }
100
-
101
- export { useCrudList };
@@ -1,47 +0,0 @@
1
- import { computed } from "vue";
2
- import { useRoute } from "vue-router";
3
- import {
4
- resolveCrudJsonApiTransport
5
- } from "../crud/crudJsonApiTransportSupport.js";
6
- import { resolveCrudHttpClient } from "../crud/crudHttpClientSupport.js";
7
- import {
8
- resolveLookupFieldDisplayValue,
9
- resolveRecordTitle
10
- } from "../crud/crudLookupFieldLabelSupport.js";
11
- import { resolveCrudBoundValues } from "../crud/crudBindingSupport.js";
12
- import { asPlainObject } from "../support/scopeHelpers.js";
13
- import { useView } from "./useView.js";
14
-
15
- function useCrudView({
16
- resource = null,
17
- paramBinding = null,
18
- route = null,
19
- ...viewOptions
20
- } = {}) {
21
- const sourceRoute = route && typeof route === "object" ? route : useRoute();
22
- const boundRouteParams = computed(() => {
23
- return resolveCrudBoundValues({
24
- binding: paramBinding,
25
- routeValues: asPlainObject(sourceRoute?.params || {}),
26
- context: Object.freeze({
27
- route: sourceRoute
28
- })
29
- });
30
- });
31
- const view = useView({
32
- ...viewOptions,
33
- resource,
34
- client: resolveCrudHttpClient(resource, {
35
- client: viewOptions.client
36
- }),
37
- transport: resolveCrudJsonApiTransport(viewOptions.transport, resource, {
38
- mode: "view"
39
- }),
40
- routeParams: boundRouteParams
41
- });
42
- view.resolveFieldDisplay = resolveLookupFieldDisplayValue;
43
- view.resolveRecordTitle = resolveRecordTitle;
44
- return view;
45
- }
46
-
47
- export { useCrudView };