@rentman/rm-core 9.2.1 → 9.2.3

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 (106) hide show
  1. package/changelog.md +1341 -1005
  2. package/dist/rm-core.js +1815 -1643
  3. package/dist/rm-core.min.js +1 -1
  4. package/dist/types/classes/ApiFormatter.d.ts +73 -73
  5. package/dist/types/classes/ApiRequestService.d.ts +18 -18
  6. package/dist/types/classes/ApiResponseProcessor.d.ts +29 -29
  7. package/dist/types/classes/CacheSyncer.d.ts +44 -44
  8. package/dist/types/classes/ChangesCompilation.d.ts +33 -33
  9. package/dist/types/classes/ChangesDelta.d.ts +61 -61
  10. package/dist/types/classes/ChangesDeltaBase.d.ts +78 -78
  11. package/dist/types/classes/ChangesProcessor.d.ts +40 -40
  12. package/dist/types/classes/CollectionEntryService.d.ts +24 -24
  13. package/dist/types/classes/CollectionResourceService.d.ts +6 -6
  14. package/dist/types/classes/ColumnCache.d.ts +19 -19
  15. package/dist/types/classes/ColumnExpansion.d.ts +19 -19
  16. package/dist/types/classes/ColumnHandler.d.ts +20 -20
  17. package/dist/types/classes/ColumnInfo.d.ts +15 -15
  18. package/dist/types/classes/ColumnSet.d.ts +37 -37
  19. package/dist/types/classes/ColumnSubsetCache.d.ts +14 -14
  20. package/dist/types/classes/ColumnUtil.d.ts +108 -101
  21. package/dist/types/classes/ConversionMapService.d.ts +25 -25
  22. package/dist/types/classes/CreateRequest.d.ts +17 -17
  23. package/dist/types/classes/CreatedChangesDelta.d.ts +17 -17
  24. package/dist/types/classes/InternalChangesDelta.d.ts +43 -43
  25. package/dist/types/classes/ItemCache.d.ts +27 -27
  26. package/dist/types/classes/ItemCreateService.d.ts +18 -18
  27. package/dist/types/classes/ItemEntryService.d.ts +32 -32
  28. package/dist/types/classes/KeyService.d.ts +18 -18
  29. package/dist/types/classes/LockService.d.ts +29 -29
  30. package/dist/types/classes/ModuleChangesCompilation.d.ts +18 -18
  31. package/dist/types/classes/ParentChangesDelta.d.ts +39 -39
  32. package/dist/types/classes/QueryColumnExtractor.d.ts +18 -18
  33. package/dist/types/classes/QueryContainsLocalIdParser.d.ts +17 -17
  34. package/dist/types/classes/QueryLinkedToParser.d.ts +17 -17
  35. package/dist/types/classes/QueryLocallyMatchableParser.d.ts +20 -20
  36. package/dist/types/classes/QueryMatcher.d.ts +24 -24
  37. package/dist/types/classes/QueryParser.d.ts +25 -25
  38. package/dist/types/classes/QueryParserBase.d.ts +20 -20
  39. package/dist/types/classes/QueryParserIdUpdater.d.ts +17 -17
  40. package/dist/types/classes/QueryService.d.ts +12 -12
  41. package/dist/types/classes/RequestBuffer.d.ts +24 -24
  42. package/dist/types/classes/RequestBufferManager.d.ts +32 -32
  43. package/dist/types/classes/RequestColumnExpansion.d.ts +15 -15
  44. package/dist/types/classes/SocketMessageHandler.d.ts +34 -34
  45. package/dist/types/classes/TemplateCache.d.ts +62 -62
  46. package/dist/types/classes/Util.d.ts +28 -28
  47. package/dist/types/classes/cache/AbstractCache.d.ts +85 -85
  48. package/dist/types/classes/cache/CachedQueryHandlerBase.d.ts +68 -68
  49. package/dist/types/classes/cache/ItemHandlerBase.d.ts +102 -102
  50. package/dist/types/classes/cache/server/ServerCache.d.ts +78 -78
  51. package/dist/types/classes/cache/server/ServerCachedQueryHandler.d.ts +25 -25
  52. package/dist/types/classes/cache/server/ServerItemHandler.d.ts +43 -43
  53. package/dist/types/classes/cache/transaction/TransactionCache.d.ts +318 -318
  54. package/dist/types/classes/cache/transaction/TransactionCachedQueryHandler.d.ts +37 -36
  55. package/dist/types/classes/cache/transaction/TransactionCollectionHandler.d.ts +24 -24
  56. package/dist/types/classes/cache/transaction/TransactionEventHandler.d.ts +21 -21
  57. package/dist/types/classes/cache/transaction/TransactionItemHandler.d.ts +90 -90
  58. package/dist/types/classes/cache/transaction/TransactionValidator.d.ts +33 -33
  59. package/dist/types/constants.d.ts +7 -7
  60. package/dist/types/core.d.ts +45 -45
  61. package/dist/types/factories/ApiResponseProcessorFactory.d.ts +6 -6
  62. package/dist/types/factories/CacheSyncerFactory.d.ts +10 -10
  63. package/dist/types/factories/ChangesCompilationFactory.d.ts +5 -5
  64. package/dist/types/factories/ChangesDeltaFactory.d.ts +13 -13
  65. package/dist/types/factories/ChangesProcessorFactory.d.ts +13 -13
  66. package/dist/types/factories/CollectionEntryFactory.d.ts +11 -11
  67. package/dist/types/factories/CollectionResourceFactory.d.ts +18 -18
  68. package/dist/types/factories/ColumnExpansionFactory.d.ts +7 -7
  69. package/dist/types/factories/ColumnInfoFactory.d.ts +7 -7
  70. package/dist/types/factories/ColumnSetFactory.d.ts +18 -18
  71. package/dist/types/factories/ColumnSubsetCacheFactory.d.ts +8 -8
  72. package/dist/types/factories/CreateRequestFactory.d.ts +9 -9
  73. package/dist/types/factories/ItemCacheFactory.d.ts +6 -6
  74. package/dist/types/factories/ItemEntryFactory.d.ts +12 -12
  75. package/dist/types/factories/ItemResourceFactory.d.ts +11 -11
  76. package/dist/types/factories/ModuleChangesCompilationFactory.d.ts +4 -4
  77. package/dist/types/factories/QueryMatcherFactory.d.ts +7 -7
  78. package/dist/types/factories/QueryParserFactory.d.ts +5 -5
  79. package/dist/types/factories/RequestColumnExpansionFactory.d.ts +8 -8
  80. package/dist/types/factories/TemplateFactory.d.ts +8 -8
  81. package/dist/types/factories/TransactionCacheFactory.d.ts +13 -13
  82. package/dist/types/index.d.ts +1 -1
  83. package/dist/types/interfaces/AbstractCacheDependencyInterface.d.ts +36 -36
  84. package/dist/types/interfaces/ApiRequestServiceInterface.d.ts +12 -12
  85. package/dist/types/interfaces/AuthInterface.d.ts +10 -10
  86. package/dist/types/interfaces/ErrorHandlerInterface.d.ts +5 -5
  87. package/dist/types/interfaces/ExceptionHandlerInterface.d.ts +3 -3
  88. package/dist/types/interfaces/LinkTreeServiceInterface.d.ts +4 -4
  89. package/dist/types/interfaces/PromiseLibraryInterface.d.ts +25 -25
  90. package/dist/types/interfaces/ServerCacheDependencyInterface.d.ts +5 -5
  91. package/dist/types/interfaces/SocketMessageInterface.d.ts +3 -3
  92. package/dist/types/interfaces/TransactionCollectionHandlerDependencyInterface.d.ts +17 -17
  93. package/dist/types/interfaces/TransactionItemHandlerDependencyInterface.d.ts +22 -22
  94. package/dist/types/internal.d.ts +104 -104
  95. package/dist/types/models/CachedQueryItem.d.ts +19 -19
  96. package/dist/types/models/CollectionEntry.d.ts +21 -21
  97. package/dist/types/models/CollectionOptions.d.ts +44 -44
  98. package/dist/types/models/CollectionResource.d.ts +87 -87
  99. package/dist/types/models/ItemEntry.d.ts +18 -18
  100. package/dist/types/models/ItemEntryOptions.d.ts +8 -8
  101. package/dist/types/models/ItemResource.d.ts +90 -90
  102. package/dist/types/models/Template.d.ts +11 -11
  103. package/dist/types/types/ItemTypesCollection.d.ts +345 -345
  104. package/dist/types/types/PromiseInterface.d.ts +2 -2
  105. package/package.json +50 -50
  106. package/readme.md +15 -15
package/changelog.md CHANGED
@@ -1,1005 +1,1341 @@
1
- #Changelog
2
- Contains new features, breaking changes and their reasoning
3
-
4
- ## 9.2.1
5
- - Fix bug in 9.2.0 that caused updates of date fields not to be processed.
6
-
7
- ## 9.2.0
8
- - Greatly speed up core processing on large datasets
9
- - Refactor the way ChangesDeltaBase.setItemUpdated processes fields to reduce `Object.getOwnPropertyDescriptor` calls
10
- - Refactor the way CacheSyncer.processDelta processes updated values to prevent unneeded field copying and `Object.getOwnPropertyDescriptor` calls
11
- - Add `RequestBufferManagerPrioritySettings` to give finer control over request buffering to the caller
12
-
13
- ## 9.1.2
14
- - Delete item lock when transaction is destroyed
15
- > We never deleted item locks causing the items to be locked forever, even though a user wasn't editing them anymore
16
-
17
- ## 9.1.1
18
- - Fix handling of multiple create requests in one transaction
19
-
20
- ## 9.1.0
21
- - Implement cascading deletes based on backend delete relations
22
-
23
- ## 9.0.5
24
- - Prevent an error occurring when `fetchItemEntryData` did not return an itemEntry
25
-
26
- ## 9.0.4
27
- - Remove `MAYBE` matches that did not get returned after the API query from cached queries and collections in `CacheSyncer`
28
-
29
- ## 9.0.3
30
- - Check for empty changesDeltas in `TransactionCache.applyChangesFromParent` to prevent unnecessary calls
31
-
32
- ## 9.0.2
33
- - Improve the way `getLinkCollections` fetches its data to greatly improve performance
34
-
35
- ## 9.0.1
36
- - Accept any version (apposed to `latest`) for @rentman/backend-types
37
-
38
- ## 9.0.0
39
- - **Breaking:** Align item changes in server cache and transaction cache: add `fields` property in server item changes,
40
- rename `changes` in transaction item changes to fields. Remove `getChangesFromItemChanges`.
41
-
42
- ## 8.2.11
43
- - Only copy over cachedQueries when saving child transactions if the parent transaction doesn't have one with the query yet
44
-
45
- ## 8.2.10
46
- - Fix displayname for 'CustomfieldGroup'
47
- - Also set displayname when creating ItemEntries
48
-
49
- ## 8.2.9
50
- - Fixes a bug in which items on the ServerCache would not properly be added to collections
51
-
52
- ## 8.2.8
53
- - Fixes a bug in which newly created items do not appear in collections caused in 8.2.6
54
-
55
- ## 8.2.7
56
- - Merge tabRequestParameters when saving a TransactionCache into another TransactionCache
57
-
58
- ## 8.2.6
59
- - Fixed issue where deleted equipment re-appear
60
-
61
- ## 8.2.5
62
- - Skipped
63
-
64
- ## 8.2.4
65
- - Fixed issue where non-local items were expanded locally.
66
- - Fixed hypothetical situation where an item entry in a local cached query could have an incomplete column set.
67
-
68
- ## 8.2.3
69
- - Did a performance optimization which will cause aggregated columns not to be re-fetched unnecessarily
70
-
71
- ## 8.2.2
72
- - Fixed a bug where derived values would not be fetched for newly created local items
73
- - Did a performance optimization which will cause aggregated columns not to be re-fetched unnecessarily
74
-
75
- ## 8.2.1
76
- - Skipped
77
-
78
- ## 8.2.0
79
- - Added support for collection trees. Now, when requesting a collection you can add the `children` property, which is
80
- a map of collection options. The collection resources will be available in the item resources of the resulting
81
- collection resource. For more information, see [Confluence](https://rentman.atlassian.net/wiki/spaces/~652789241/pages/948404231/Child+collections).
82
-
83
- ## 8.1.9
84
- - RM4-16796 Fixed a bug where loading the same query in quick succession would cause columns/data to be missing
85
-
86
- ## 8.1.8
87
- - Reorganize imports: move all exports to `internal.ts`. This is the only place where things should be exported. All files should import from this file. Resolve duplicate declaration of `InternalCreateDelta` type.
88
- - Improve performance of copying over values in `ChangesDelta`s and `CollectionMatcherBase`
89
- - Merge all `CollectionMatcher` classes into one `CacheSyncer`, so that `processDelta` only has to be done once
90
- - Increase performance of the ApiFormatter on large datasets
91
-
92
- ## 8.1.7
93
- - Fixed a bug where copied over CachedQueryItems weren't resolved (causing them to hang forever)
94
-
95
- ## 8.1.6
96
- - Add missing return statement in ServerCache.applyChangesDelta
97
-
98
- ## 8.1.5
99
- - Only extend missing derived values while resolving local items in `TransactionCachedQueryHandler.__fetchItemEntriesByQueryData`
100
-
101
- ## 8.1.4
102
- - Remove non-created items if they are not returned in the response of a Create request
103
- > If a create would fail, the whole request would fail. So we can assume that if an item isn't returned from a create
104
- > request, the backend has left it out on purpose
105
- - Move cached queries to parent transactions only when saving a child transaction
106
- > Only then you know for sure that items that matched on the child transaction will also match in the parent transaction,
107
- > since you're taking over the changes, this behaviour was changed somewhere in a refactor but was incorrect
108
- - No longer move cached queries to the ServerCache when saving a root transaction
109
- > You probably don't need the result of *all* those cached queries anymore (and it's also inefficient to keep them because the matcher keeps the up-to-date)
110
- - No longer wait for child transactions to sync when applying changes in a parent
111
- > A child transaction can only influence a parent transaction by calling `TransactionCache.save`, which doens't happen whilst applying changes,
112
- > so you don't have to wait for child transactions when applying changes in a parent
113
-
114
- ## 8.1.3
115
- - Allow passing TransactionOptions to TransactionCacheFactory.construct
116
-
117
- ## 8.1.2
118
- - Fixed a bug in which derived values for local items wouldn't be properly be fetched
119
-
120
- ## 8.1.1
121
- - Fixed a bug in which a `Template` request's columns weren't processed
122
-
123
- ## 8.1.0
124
- - Add `cloneCreatedChanges` function to `ChangesDeltaFactory`. This function clone the `created` component of a changes
125
- delta into a destination changes delta.
126
- - Add `TransactionOptions`, implement `transparent` transaction option
127
- - Allow core-mapped TS types instead of backend-mapped TS types in `ApiFormatter.compareFields`
128
- - Fixed a bug where empty update requests where sometimes done
129
- - Fixed a bug where derived values of items returned in a Template request weren't properly resolved
130
-
131
- ## 8.0.3
132
- - Changed the flow of a create request so that it includes all the required columns for all transactions and also processes additionally returned (derived) items
133
- - Fixed a bug where fields referencing local items would already be updated in the `previous` before the `onChange` callbacks were called
134
- - Moved logic of updating IDs in cached queries/collections to TransactionCachedQueryHandler and TransactionCollectionHandler
135
-
136
- ## 8.0.2
137
- - Fixed a bug where deleted entries on a child transaction where not handled properly
138
- - Fixed a bug where saving a child transaction, and then undoing those changes and saving again would not update the parent transaction
139
-
140
- ## 8.0.1
141
- - Uppercase operators and comparators in QueryMatcher, QueryParser and QueryService
142
- - Fix parsing short-hand `IN` queryies
143
-
144
- ## 8.0.0
145
- - Implement `@rentman/backend-types`
146
- > You will now have autocomplete and typing checking on all columns/fields 🥳
147
- - Remove `ChangesDeltaResult.rollback`
148
- > It was never really used/implemented
149
-
150
- ## 7.2.0
151
- - Add the `preventCaching` option to `CollectionOptions`
152
- > Prevents a CachedQueryItem from being cached (the CollectionResource will still be cached), you can use this when you fetch an Itemtype for which the backend doesn't send socket messages (so it never automatically updates)
153
-
154
- ## 7.1.1
155
- - Properly handle moved items in ServerCache.applyChangesFromParent (technically the backend won't ever generate a linkTo (only updates)) but it can happen when manually syncing the server cache (by doing `InternalChangesDelta.setItemMoved`)
156
-
157
- ## 7.1.0
158
- - Automatically keep aggregated values up-to-date by always refetching them
159
-
160
- ## 7.0.15
161
- - Remove an accidentally left in place debugger
162
-
163
- ## 7.0.14
164
- - Take into account collections with a 'limit' (of which the query result isn't cached) when matching socket items
165
-
166
- ## 7.0.13
167
- - Only overwrite the displayname if the required columns are present, instead of defaulting to an empty string
168
-
169
- ## 7.0.12
170
- - Fixed a bug where the core would try to update the cache key (ID) of `fieldChangeCallbacks` even when there were no callbacks for the given itemType
171
-
172
- ## 7.0.11
173
- - Fixed a bug where date values would not be compared if the descriptor was uncalled, this could lead to problems when applying changes from a parent transaction
174
-
175
- ## 7.0.10
176
- - Update references to local IDs in other items when a local ID gets updated
177
-
178
- ## 7.0.9
179
- - Take over `tabRequestParameters` when saving TransactionCache -> TransactionCache
180
-
181
- ## 7.0.8
182
- - Fixed a race condition and loop iteration error which in very rare cases caused itemEntries to be `undefined` and erroring
183
- - Add missing error handling in transaction functions
184
-
185
- ## 7.0.7
186
- - Properly handle `reverse` linkedTo's in QueryColumnExtractor and QueryLocallyMatchableParser
187
- - Implement refreshing of cached queries/collections
188
-
189
- ## 7.0.6
190
- Move fetching of lock from `TransactionItemHandler.processItemEntryChanges` to `TransactionCache.appyChangesDelta` to also capture creates and deletes.
191
-
192
- ## 7.0.5
193
- - Remove automatic fetching of derived values for not-yet-created items
194
-
195
- ## 7.0.4
196
- - Automatically resolve derived values when a new item is created
197
- - Fixed a bug where `AbstractCache.getParentFromFields` would still return `null` incorrectly
198
-
199
- ## 7.0.3
200
- - Fixed a bug where `AbstractCache.getParentFromFields` would still return `undefined` parent values
201
-
202
- ## 7.0.2
203
- - Check if any of the parent fields (`itemtype`, `item`) is `null`, in which case it won't be treated as a valid parent in `AbstractCache.getParentFromFields`
204
-
205
- ## 7.0.1
206
- - Ignore columns in ApiFormatter::hasChanges if the `modified` object does not contain a value for it.
207
-
208
- ## 7.0.0
209
- - **Breaking**: Remove `enableChangesWatcher` and `disableChangesWatcher` in `TransactionCache`.
210
- - Fetch lock token in `TransactionItemHandler.processItemEntryChanges`.
211
-
212
- ## 6.3.10
213
- - Only call `onRemove` of a collection if there are actually any items removed
214
- - Expand cached columns anyways if there are no items to expand in `TransactionCachedQueryHandler.__expandCachedQuery`
215
-
216
- ## 6.3.9
217
- - Fixed a bug where deleted local items would still appear as unsaved changes
218
-
219
- ## 6.3.8
220
- - Always fetch 'id' and 'permissions' columns so that they are always available
221
-
222
- ## 6.3.7
223
- - Fixed a bug where items in a socket message that _might_ fit (`MAYBE`) in a collection would not be checked/added.
224
-
225
- ## 6.3.6
226
- - Fixed a bug where `AbstractCache.fetchUpdatedDerivedValuesFromDelta` would attempt to use ItemChanges not cached on the transaction
227
- resulting in an error
228
-
229
- ## 6.3.5
230
- - Fixed a bug where after creating items derived values would needlessly be refetched
231
- > The core now properly detect that even though an ItemId is updated (after a create) it's still the same item so no request has to be done
232
- - Fixed a bug where ItemEntry's would not be re-cached under their new ItemIds
233
-
234
- ## 6.3.4
235
- - Fixed a bug where already cached itemEntries would not properly be detected when calling `ServerCache.processResponse`
236
- - Fixed a bug where calling `CreatedChangesDelta.remove` would add `empty` values in the array instead of removing the entry
237
-
238
- ## 6.3.3
239
- - Fixed a bug where local ItemEntries were not properly updated after saving
240
-
241
- ## 6.3.2
242
- - Fixed updating item entry itemId field after processing changes
243
-
244
- ## 6.3.1
245
-
246
- - Fixed a bug where query with a local ID would do a request to the server
247
- ```
248
- // This example should now no longer do a request
249
- transaction.getItemsByQuery(
250
- 'Tijd',
251
- {
252
- project: -11,
253
- }
254
- );
255
- ```
256
-
257
- ## 6.3.0
258
- - Allow strict typing of `FieldMap`
259
-
260
- ## 6.2.5
261
- - Remove overwriting itemType with itemType of rootItem during create
262
-
263
- ## 6.2.4
264
- - Fixed a bug where items would not appear in a collection after changes propagated from a parent transaction
265
-
266
- ## 6.2.3
267
- - Fixed a bug where `previous` would actually contain new values because the `previous` object was made after the values were already synced
268
-
269
- ## 6.2.2
270
- - Fixed a bug in syncing of initial values after saving an item causing the item to still be marked having changes
271
-
272
- ## 6.2.1
273
- - Fixed a bug where `ItemEntry`s created on the `ServerCache` where not matched on child `TransactionCache`s
274
-
275
- ## 6.2.0
276
- - Fixed a bug where synchronous validators would leave the validator in `pending` state
277
- - Only re-match items when values are actually changed
278
- - Removed `defered` from `CachedQueryItem` and added `resolve` and `reject`
279
- - Check if ItemEntries are already created before creating new ones, if that is the case treat it like an update
280
- > What could happen was that a faster request created an ItemEntry for the same item as another request
281
- > which caused the double creation of an ItemEntry
282
-
283
- ## 6.1.3
284
- - Add `isPending` function to `TransactionValidator`
285
- - `TransactionCache`s will now be invalid until all pending transaction validators are done
286
-
287
- ## 6.1.2
288
- - Check if an error key exists before deleting it in `TransactionCache.clearItemError`
289
-
290
- ## 6.1.1
291
- - Correctly pass `ErrorHandlerInterface` to `ChangesDeltaFactory`.
292
-
293
- ## 6.1.0
294
- - Return `ChangesDelta` instance in `setItemUpdated`, `setItemDeleted`, `setItemsDeleted` methods, and a promise that resolves to the instance in `setItemCreated` and `setItemsCreated`.
295
-
296
- ## 6.0.2
297
- - Update `query` parameter of `getByQuery`, `getLocalByQuery`, `batchGetLocalByParent`, and `matchQuery` in `ItemCache`.
298
-
299
- ## 6.0.1
300
- - Fixed a bug where a local item wouldn't be found when using `TransactionCache.getItemByState` on a child transaction
301
-
302
- ## 6.0.0
303
- - Refactored query caching structure
304
- - Properly implemented `limit` in collections
305
- - Removed extending of collections
306
-
307
- ## 5.0.1
308
- - Add 'icon' column type to non-selectable column types
309
-
310
- ## 5.0.0
311
- - Fixed a bug where created, creator and permissions was always set to default values
312
- - **Breaking:** Remove `onItemsCreated` collection callback.
313
-
314
- ## 4.0.4
315
- - Fixed a bug where ModuleChangesCompilation wouldn't include all changes
316
-
317
- ## 4.0.3
318
- - Local collections are now correctly identified when using a local ID in a linkTo request instead of the `parent` option
319
- - Fix issue where local collection entries were not moved to server cache after save.
320
-
321
- ## 4.0.2
322
- - Fixed a bug where clearing collections would error after saving a transaction
323
-
324
- ## 4.0.1
325
- - Remove thrown error in `ItemResource.callOnChange`
326
- > The frontend still relied on this and we won't refactor that at this point
327
-
328
- ## 4.0.0
329
- - Removed `ItemResourceOptions.onChange`, this is replaced by `TransactionCache.registerFieldChangeCallback`
330
- > Because the `onChange` is no longer stored on the ItemResource, the ItemResource doesn't have to be cached.
331
- > This way you don't have to call `ItemResource.clearResource` anymore (you do need to deregister the fieldChange callbacks)
332
-
333
- ## 3.1.0
334
- - **Breaking:** Remove `fields` property, add `getFields` method in `Template` class.
335
- - **Breaking:** Add `ConversionMapService`. Update `updateItemValues` to take a `source` and `destination` parameter.
336
- - Update `entry.itemId` for items created items in `TransactionCache.getDelta`.
337
- > This fixes an issue with updating IDs of local items.
338
- - Add dependency interfaces for `AbstractCache`, `ServerCache`, `TransactionCache`, `TransactionCollectionHandler`, `TransactionItemHandler`.
339
- - Add `CreatedChangesDelta` class, which replaces the `created` component of the `ChangesDelta` and includes some query methods. Add `isEmpty` method to `ChangesDelta`.
340
-
341
- ## 3.0.1
342
- - Fixed a bug where the `StateKeyType` enum couldn't be used when imported
343
-
344
- ## 3.0.0
345
- - Remove ViewResource, EditResource, CollectionViewResource and CollectionEditResource
346
- > There was no real distinction between them anymore since the core 2.0 update.
347
- > You can now use the base ItemResource and CollectionResource types instead
348
-
349
- ## 2.4.0
350
- - Update Typescript version to `3.7.2`, also update other plugins
351
-
352
- ## 2.3.0
353
- - Add callbacks when errors are set/cleared to `TransactionEventHandler`
354
- - Added the possibility to differentiate between errors to display below a field and on the save button in `TransactionValidator`
355
- - Changed the format of the error translations from `string` to `() => string` in `TransactionValidator`
356
- > Now the translation function will only be called when the error is actually set, not when it's cleared
357
-
358
- ## 2.2.1
359
- - Fixed a bug where resolving derived values for new items (in `TransactionCache.applyChangesDelta`) would sometimes error
360
-
361
- ## 2.2.0
362
- - `ChangesDelta.setItem(s)Created` will now accept incomplete input values
363
- > It will now fetch a template for you and process the items, so you no longer need to do that yourself
364
-
365
- ## 2.1.2
366
- - Fixed a bug where deleted ItemEntries weren't picked up when detecting transaction changes
367
-
368
- ## 2.1.1
369
- - Fixed a bug where an ItemEntry's errors wouldn't be deleted when the ItemEntry was deleted on a transaction
370
-
371
- ## 2.1.0
372
- - Refactor `TransactionCache.getItemsByQuery` to check cached entries (just like a collection)
373
- - Add `TransactionValidator`, allow passing of a `TransactionValidatorFactory` to a transaction
374
- > You can use these validators to set errors using `setItemError` and `setGlobalError`
375
- - Fixed a bug where `TransactionItemHandler.cloneItemEntry` could only clone entry with changes on the target transaction.
376
- > It will not look for changes recursively on the transaction change
377
-
378
- ## 2.0.19
379
- - Ensure all requestColumns for newly created ItemEntries from a template are available
380
- - Ensure derived values for newly created ItemEntries from a template are available
381
-
382
- ## 2.0.18
383
- - Include read-only columns when detecting changes in TransactionItemHandler.processItemEntryChanges
384
- > Read-only columns shouldn't count as changes on the tab, but they should be taking into account when deciding whether or not to call `onChange`
385
-
386
- ## 2.0.17
387
- - Fixed a bug where deleting an item that isn't in the transaction's item entry cache would result in an error
388
- - Fixed a bug where response columns weren't set for newly created local CollectionEntries
389
- - Fixed a bug where items weren't matched for newly created local CollectionEntries
390
-
391
- ## 2.0.16
392
- - Fixed a bug where queries with a link to a local parent item weren't updated on save
393
-
394
- ## 2.0.15
395
- - Cache ItemEntries that fit collections on the CollectionEntry's query instead of the CollectionEntry's id
396
- - Add a 'hint' to ChangesDeltas which allows skipping the extra request to validate `maybe` query matches
397
- - Create transaction changes for ItemEntry updates in the changesDelta if non exist yet when calling `TransactionCache.applyChangesDelta`
398
- > This allows you to update values on a transaction without having to fetch a resource for it by calling
399
- > `ChangesDelta.setItemUpdated()`
400
-
401
- ## 2.0.14
402
- - Fixed reading of derived values in `getItemIdByColumn` when a ChangesDelta is passed
403
-
404
- ## 2.0.13
405
- - Fixed a bug where the incorrect fields where applied to the ChangesDelta in `TransactionItemHandler.cloneItemEntry`
406
- - A RequestBuffer's promise will now resolve after the ServerCache.processResponse promise is done, ensuring all values are present before continuing
407
- - Request columns for the request ItemType will now properly be taken into account in ServerCache.processResponse ensuring root columns are always properly set. (This is used to update derived values)
408
-
409
- ## 2.0.12
410
- - Fixed a bug where created changes weren't copied to the itemchanges
411
- - Only take readonly parent columns instead of all readonly columns in `ApiFormatter.hasChanges`
412
- - Fixed a bug where ItemEntry's where still in `ItemCache.entriesByEntryId` after clearing them
413
-
414
- ## 2.0.11
415
- - Fixed a bug where changes weren't copied to the itemchanges
416
- - Fixed correct isCalledAfterApiSave values on calls to ServerCache.processResponse
417
-
418
- ## 2.0.10
419
- - Construct `ColumnSet` with proper `requestColumns` when creating a `Template` with additional columns
420
-
421
- ## 2.0.9
422
- - Properly process linked items from the template request in `TransactionItemHandler.createItems`
423
-
424
- ## 2.0.8
425
- - Fixed a bug where not all fields where available even tough an ItemResource with specific columns was created
426
-
427
- ## 2.0.7
428
- - Define abstract copyTransactionItemEntryChanges on ItemHandlerBase
429
- - Implement copyTransactionItemEntryChanges on TransactionItemHandler and ServerItemHandler
430
- - Fix AbstractCache/ServerCache/TransactionCache `getParent` function arguments
431
- > With the newly added arguments the function definitions didn't align anymore causing typescript errors
432
- > Even though the arguments aren't used in the `ServerCache` they're added in there
433
-
434
- ## 2.0.6
435
- - Remove `ApiFormatter.lazyClone`
436
- > You can't lazily clone moment objects because the moment you wanted to clone could be changed in the time the getter isn't invoked, resulting in a different value
437
-
438
- - Create a copy of the child transaction's field instead of copying the object reference in `TransactionCache.applyChangeFromChild` and `ChangesProcessor.executeCreateRequest`
439
- > When writing to the object references you're changing multiple transactions at once, while this should be handled by applyCHangesFromParent
440
-
441
- ## 2.0.5
442
- - Add `callOnAddWithInitialItems` option to `CollectionResourceOptions`
443
- > If `true` the `onAdd` callback will be called with the initial set of items
444
-
445
-
446
- ## 2.0.4
447
- - Add `isCalledAfterSocketUpdate` to `onAdd`, `onRemove` and `onChange` callbacks
448
- > You can use this if a data change should only trigger an action when the user caused it himself
449
-
450
- ## 2.0.3
451
- - Fix `CollectionEditResource.removeItems`
452
- - Move `getCurrentCollectionEntryCache` and `getCurrentItemEntryCache` from `TransactionCache` to `AbstractCache`
453
-
454
- ## 2.0.2
455
- - Fix marking entries as deleted and compiling this into a request
456
-
457
- ## 2.0.1
458
- - Expand CollectionEntry's columns in `ServerCollectionHandler.fetchCollectionData`
459
-
460
- ## 2.0.0 - Major caching refactor
461
- - Completely reworked internal caching structure, see [this Confluence page](https://rentman.atlassian.net/wiki/spaces/DEV/pages/704872456/) for the motivations behind it.
462
-
463
-
464
- ## 1.9.0
465
- - Don't create ItemResources when not returning links in `ItemAdministrator.getNewResourceWithId` and in `ItemAdministrator.constructOnItemsExpanded`
466
-
467
- ## 1.8.0
468
- - Remove `ResourceCache` and `resourceLevel`
469
- > You should now manually call `resource.clearResource` when you no longer need a resource
470
- - Add `onConstruct` function to `ItemResource` and `CollectionResource`
471
- > This is overwritten by the frontend to track resource creation
472
-
473
- ## 1.7.6
474
- - Add priority parameter to local cache callbacks. The callback condition (`always` / `onClose` / `skipOnClose`) no longer has any effect on the order in which the callbacks get executed.
475
- - **Breaking:** Remove `LocalCacheCallbackCondition` enum.
476
- - Add `itemId` parameter to `ItemHandler.fetchNewItem`. An error is thrown when an ID already exists. Add `getNewResourceWithId` to ItemAdministrator. Deprecate `getItemByState`.
477
-
478
- ## 1.7.5
479
- - For template column sets it is no longer assumed all columns are present. This fixes an issue with incomplete column
480
- sets in the front-end.
481
- - Fix issue where `changesProcessor` instance was undefined in `itemResourceFactory` and `collectionResourceFactory`.
482
- Create variables for each core service in order to get a TypeScript error when a dependency hasn't been initialized yet.
483
-
484
- ## 1.7.4
485
- - Add support for strict ItemType type checking in `FieldMap`
486
-
487
- ## 1.7.3
488
- - Add support for strict ItemType type checking
489
- > This is temporarily defaulted to `any` to prevent compile errors in the frontend
490
-
491
- ## 1.7.2
492
- - Fix some typing issues in:
493
- - ApiResponseProcessor
494
- - ItemCache
495
- - KeyService
496
-
497
- ## 1.7.1
498
- - Fix issue where `CreateRequestFactory` would be undefined in `ChangesProcessor`.
499
-
500
- ## 1.7.0
501
- - **Breaking:** remove `ChangesProcessorFactory`. Add `ChangesProcessor` instance to core directly.
502
-
503
- ### Resource caching
504
- - **Breaking:** the following properties are removed:
505
- - On `ItemEntry`: `clearResources`, `deactivateResources`.
506
- - On `CollectionEntry`: `clearResources`, `getCurrentResource`.
507
- - On `CollectionResourceOptions`: `clearOnTabChange`, `clearOnSubTabChange`.
508
- - An additional `level` parameter has been added to all methods that return resources.
509
- - When creating resources using `ItemResourceFactory` or `CollectionResourceFactory`, this parameter is mandatory.
510
- A `defaultResourceLevel` parameter has been added to the `LocalCache` constructor.
511
- - A `clearResources` method has been added to `ItemAdministrator`. When calling this method, all item / collection
512
- and collection resources with a level of `level` or higher will be removed.
513
- - The `clearResources` method has been removed from `LocalCache`.
514
- - The `setCurrentLocalCache` function has been removed from `LocalCacheManagerInterface`.
515
-
516
- ## 1.6.13
517
- - When encountering a collection entry with `PROMISED_EXPAND` status, call `getCachedEntryStatus` after the initial
518
- promise has been resolved.
519
-
520
- > This is the likely cause of the issue where `_resolve` is called on a non-deferred collection entry.
521
-
522
- ## 1.6.12
523
- - Fix error that occurs when trying to resolve a non-deferred collection entry.
524
-
525
- ## 1.6.11
526
- - Fix issue where `QueryMatcher.matchComplexQuery` would return the wrong value.
527
-
528
- ## 1.6.10
529
- - **Breaking**: Remove `linkType`, `linkIdArray` properties from `LinkCollectionDefinition`. Add `linkType`,
530
- `linkIdArray` parameters to `ItemAdministrator.getLinkCollectionsFromDef`.
531
-
532
- ## 1.6.9
533
- - Redeploy of `1.6.8`
534
-
535
- ## 1.6.8
536
- - Add support for `not` in queries
537
-
538
- ## 1.6.7
539
- - Fix issue where `CollectionMatcher.addToCollections` wouldn't return the correct type.
540
-
541
- ## 1.6.6
542
- - Add `callOnAdd` parameter in `CollectionHandler.batchExtend`. Set `updateInitial` to true. Remove `updateInitial` parameter in `CollectionEntry.extend`, as it should always be true.
543
- > The `extend` function only concerns itself with remote items, so no local changes should be generated.
544
-
545
- ## 1.6.5
546
- - Fix issue where a derived column could be marked as the `link` (parent) column in the column set.
547
- > This could lead to instances where a different column would be set to the value of the parent.
548
-
549
- ## 1.6.4
550
- - Fix issue where the `onChange` collection callback would not be called when updating it in the options.
551
- - Add `callOnAdd` parameter to collection matcher. When set to `false`, `onAdd` is not called for the `resultCollectionResource`.
552
-
553
- ## 1.6.3
554
- - Properly type ApiResponseProcessor - fetchObjectArray
555
-
556
- ## 1.6.2
557
- - Fix issue where the collection handler would return collection entries before they were resolved when calling `batchFetch`.
558
-
559
- ## 1.6.1-3
560
- - Check for linkedTo before checking for subqueries in QueryMatcher
561
- > Linkedto also has `.query` and was incorrectly marked as a subquery
562
-
563
- ## 1.6.1-2
564
- - Fixed shorthand query with null values
565
- > The QueryParser would incorrectly identify subqueries when using null in a shorthand
566
-
567
- ## 1.6.1-1
568
- - Fixed shorthand query with Moment values
569
- > The QueryParser would incorrectly identify Moment objects as a subquery
570
-
571
- ## 1.6.1
572
- - Added support for subqueries in QueryParser and QueryMatcher
573
- > Collections using subqueries will always return 'maybe' in the QueryMatcher
574
-
575
- ## 1.6.0
576
- - All external callbacks are now wrapped in a `try ... catch` block. This prevents them from breaking core functionality.
577
- - **Breaking**: Add `ExceptionHandlerInterface` parameter to core constructor.
578
-
579
- ## 1.5.9
580
- - Fix issue that occurs when trying to resolve a `ColumnSet` using a single non-existing column.
581
- Catch exceptions that might occur when resolving an `ItemEntry`.
582
- - Add `mergeRequestColumns`, `mergeResponseColumns` to `ColumnSet`. When encountering new items while expanding a collection, add them to the collection.
583
-
584
- ## 1.5.8
585
- - Introduce `RemoteViewResource` and `LocalViewResource`.
586
- > The `fields` property of a `RemoteViewResource` represents
587
- server values, while the `fields` property of a `LocalViewResource` represents local values.
588
- - The `fields` property of a `ViewResource` is now read only.
589
-
590
- ## 1.5.7-1
591
- - Make ItemResource/CollectionResource base class abstract
592
- - Add missing overload functions in some places
593
- - Fix default comparator `QueryMatcher.parseSimpleQuery`
594
- - Fix `ExtendedCollectionMatchResult` `collection` property type
595
-
596
- ## 1.5.7
597
- - Properly type Collections & ItemResources (and return values) in the whole core.
598
- > The core will now properly return Collections & ItemResources based on the passed CollectionOptions.
599
- > You can now also type the expected collection type
600
-
601
- ```
602
- // Expects a collection with editCollection and editItems both `true`
603
- // Will properly return EditResources for all collection functions
604
- const collection: CollectionEditResource<EditResource>;
605
-
606
- // other variations are:
607
- // CollectionViewResource<ViewResource>
608
- // CollectionViewResource<EditResource>
609
- // CollectionEditResource<ViewResource>
610
-
611
- this.core.itemAdministrator.getCollection(
612
- 'Notitie',
613
- {
614
- editCollection: true, // Will return a CollectionEditResource
615
- editItems: true // Will return EditResources instead of ViewResources in `.items`
616
- }
617
- )
618
- ```
619
-
620
- ## 1.5.6
621
- - Add `getAllLocalCaches` to `LocalCacheManagerInterface`, remove item entries from all local caches on socket delete.
622
-
623
- ## 1.5.5
624
- - Add 'order' column type handling to ApiFormatter functions
625
-
626
- ## 1.5.4
627
- - Fix issue where parent would be incorrectly set when cloning a single item.
628
- - Type functions related to expansion maps in `ItemEntryService`.
629
-
630
- ## 1.5.3
631
- - Fix issue where the `enableSave` collection resource option would default to `false`. This would throw an error when
632
- calling `save` on a collection resource where this option was not explicitly set.
633
-
634
- ## 1.5.2
635
- - Type functions in `ColumnUtil` class.
636
- - Add `getRequestColumnId` and `containsDerivedColumns` to `ColumnUtil`.
637
- > `getRequestColumnId` should be used instead of `Util.getFirstProperty` when retrieving a column ID.
638
- - **Breaking:** Remove `ColumnUtil.isColumnSubset`. Use `ColumnSet.isSuperSetOf` instead.
639
- - Remove `findColumnObject`. Rename `findColumn` to `findRequestColumn`.
640
-
641
- ## 1.5.1
642
- - Properly remove item entry stub from (local) cache when request fails.
643
- - Fix issue where item or collection options could be set to undefined.
644
-
645
- ## 1.5.0
646
- - Add `SocketMessage` type and add types to `SocketMessageHandler`
647
- - Expand local items requested using `getItemById` or `getItemsById` in `ItemAdministrator`.
648
- (`fetchItem` or `fetchItems` in `ItemHandler`.)
649
- - Implement expanding of local collections. This no longer leads to invalid requests.
650
- - **Breaking:** The `expand` function in `CollectionEntry` now has an `ItemCache` parameter.
651
- - **Warning:** This version contains major changes.
652
-
653
- ### Introduce typing of item and collection options
654
- - **Breaking:** Removed `QueryItemType` collection entry option.
655
- - **Breaking:** Removed `ItemResourceService`.
656
- - Removed `processOptions` parameter from `createCollectionResource` (`ItemAdministrator`). It is now equivalent to
657
- `addCollection`.
658
- - When creating an item resource using `ItemResourceFactory`, a collection entry using `CollectionResourceFactory` or a
659
- collection resource using `CollectionResourceFactory` it is no longer necessary to process options beforehand. It is
660
- still necessary when interacting with `CollectionHandler` or `ItemHandler` directly.
661
-
662
- ## v1.4.0
663
- - Add `expandProcessLinkedItems` and `expandAddToCollections` to `ItemAdministrator`. These are analogues to
664
- `processLinkedItems` and `addToCollections`, but also expand the items with (derived) values and columns as necessary.
665
- They have a slightly different type signature.
666
- - Whenever a collection is requested, the `CollectionHandler` now makes sure that added local items are expanded as
667
- necessary.
668
- - **Breaking:** Last parameter of `ItemHandler.createLocalEntries` is now a callback function.
669
- - **Breaking:** Rename `TemplateLinkedItemEntryMap` type to `TemplateItemEntryMap`.
670
-
671
- ## v1.3.8
672
- - Add `isSaving` to `LocalCache`
673
- > We use this to disable the cancel/save buttons while the localCache is saving in the frontend
674
-
675
- ## v1.3.7
676
- - Fix issues that generate invalid requests / changes when moving existing item to another collection, then deleting the parent.
677
- - Remove slip workarounds
678
- - Add api request types
679
- - Add types to `ModuleChangesCompilation`
680
-
681
- ## v1.3.6
682
- - Skip add / remove collection callbacks when calling `revertChanges` (`LocalCache`).
683
-
684
- ## v1.3.5
685
- - Fix issue where items added to collections when resolving wouldn't be removed in `revertChanges` (`LocalCache`).
686
-
687
- ## v1.3.4
688
- - Add country to isFilteredColumn in ColumnUtil
689
-
690
- ## v1.3.3
691
- - Move processLocalConfigColumns and consolidateColumns from ColumnUtil to frontend
692
- > These functions are specifically used for rendering ui-grid in the frontend, so there's
693
- no reason to have them in the core
694
-
695
- ## v1.3.2
696
- - Fix types path in package.json
697
-
698
- ## v1.3.1
699
- - Fix types path in package.json
700
-
701
- ## v1.3.0
702
- - Rename PromiseInterface to PromiseLibraryInterface
703
- > PromiseInterface is now used for the internal promise type
704
-
705
- - Use PromiseInterface instead of Promise as internal promise type
706
- > This allows us to overwrite the PromiseInterface definition in the frontend indicate usage of ng.IPromise
707
-
708
- ## v1.2.9
709
- - Call processOptions in fetchDerivedValuesByColumn
710
- > Bug was introduced earlier but got enabled in v1.2.7
711
-
712
- ## v1.2.8
713
- - Add toJSON methods for ItemResources, ItemEntries, and ColumnSets to fix circular dependencies in JSON.stringify
714
-
715
- ## v1.2.7
716
- - Set itemEntry parent when generating a stub
717
-
718
- ## v1.2.6
719
- - Fix an issue introduced in v1.2.5.
720
-
721
- ## v1.2.5
722
- - When a local item cannot by found, return a newly created item in `getItemByState` (`ItemAdministrator`) only. This
723
- solves an issue with refreshing on a local edit view.
724
-
725
- ## v1.2.4
726
- - **Breaking:** When a local item cannot by found, instead of a new item being created an error is thrown. This means it
727
- is no longer possible to create local items using `getItemById` or `getItemsById` in the `ItemAdministrator` class.
728
- - **Breaking:** Removed `getItemDefinition` and `getItemByDef` in the `ItemAdministrator` class. Added `getItemByState`.
729
- - Renamed types `TemplateResponseItemEntryMap` to `TemplateItemEntryMap` and `TemplateResponseLinkedItemEntryMap` to
730
- `TemplateLinkedItemEntryMap`.
731
- - Removed `getCollectionCacheKey` in `KeyService`. (Legacy code.)
732
-
733
- ## v1.2.3
734
- - Fixed issue where derived values deeper than one layer couldn't be resolved.
735
-
736
- ## v1.2.2
737
- - Fixed issue where in derived values weren't set after create request.
738
-
739
- ## v1.2.1
740
- - **Breaking:** Replaced the `initial` parameter with the `callOnChange` parameter (`true` by default) in the `commit`
741
- function of the `EditResource` class.
742
- - Fixed issue in `setLocalFields` (`ItemEntry`) where some values were wrongly assumed to be present in `initialValues`.
743
- - Optimization: Disabled automatic resolution of derived values in `addItems` (`CollectionEditResource`) when `modInstant` is set to true.
744
-
745
- ## v1.2.0
746
- - **Breaking:** When calling `addItems` or `addItem` on the `CollectionEditResource` class derived values are now
747
- resolved automatically. Instead of a compound object like `{fields: {key: 'value'}, derived: {}}` an object like
748
- `{key: 'value'}` should now be used as argument when calling these functions.
749
- - **Breaking:** Added `localCache` parameter to `CollectionResource` constructor.
750
-
751
- ## v1.1.20
752
- - Fixed minor issue where collection wouldn't be deferred properly before expanding.
753
- - `onChange` is now called automatically when when calling `commit` on an edit resource.
754
-
755
- ## v1.1.19
756
- - **Breaking:** Renamed `getCurrentChanges` to `getModuleChanges` in the `ItemAdministrator` class. Added optional
757
- `localCache` parameter.
758
-
759
- ### Local cache callback refactoring
760
- - Removed `onSaveWithoutClosing` event.
761
- - Added `condition` parameter to `onBeforeSave` and `onSaveSuccess` (possible values are `always`, `onClose` or
762
- `skipOnClose`, defaults to `always`). Callbacks registered with `condition: always` will get executed before other
763
- callbacks.
764
- - Pass the local cache itself to all registered callback functions. Pass the item ID conversion map as second argument
765
- to `onSaveSuccess` callback functions.
766
-
767
- ## v1.1.18
768
- - Calling `expand` on a `CollectionEntry` manually no longer defers the collection entry.
769
- - The `batchFetch` and `batchExpand` functions in the `CollectionHandler` class now properly defer and resolve the
770
- collection entries.
771
-
772
- ## v1.1.17
773
- - Fixed issue where the `getLocalByQuery` function in the `ItemCache` class wouldn't return any items.
774
- - When batch resolving collection entries, `CollectionHandler` now looks for matching items using `getByQuery` instead
775
- of `getByParent`.
776
-
777
- ### Cache invalidation
778
- - Added `queueReload` function to `ItemEntry` class. This will reload the item when the item entry itself or a
779
- collection entry containing the item is requested.
780
- - The `queueReload` function in the `CollectionEntry` class no longer directly defers the item.
781
- - Added `invalidateCache` function to the `ItemAdministrator` class. This will call `queueReload` on all item entries
782
- and collection entries.
783
-
784
- ### Item entry refactoring
785
- - Renamed `process` to `setFields`.
786
- - Replaced `processLocal` with `setLocalFields`. This function no longer has a `modified` parameter.
787
- - `setModified` now also sets local default values.
788
- - Removed `setCreator`. This function was called twice in some instances.
789
- - **Breaking:** Added `derived` parameter to `updateFields`
790
-
791
- ##v1.16
792
- - Pass `hasChanges` as second argument to `onBeforeSave` callbacks in the `LocalCache` class. This fixes an issue with
793
- project financial values in the front-end. [RM4-9577]
794
- - Added `callOnActivate` parameter to `addItems` function in `CollectionEditResource` class. Use this to prevent items
795
- from being added to the local cache.
796
-
797
- ##v1.15
798
- - Fix `fetchItemTypesTranslations` function in `ColumnHandler` class.
799
- - Fix type definition of `PromiseInterface.all`.
800
-
801
- ##v1.14
802
- - The `ChangesCompiler` now always processes local collections. (Even if they don't have edit resources.) This fixes an
803
- issue with recurring appointments in the front-end.
804
-
805
- ##v1.13
806
- - Add option to exclude itemTypes during createLocalEntries.
807
-
808
- ##v1.12
809
- - **Breaking:** `ItemResource.isNew` returns true *only* if the resource was created using
810
- `ItemAdministrator.getNewResource` or `ItemAdministrator.getItemByDef`. This fixes an issue where items where removed
811
- from the local cache inadvertently.
812
- - The `start`, `commit` and `rollback` functions of `EditResource` now return the resource itself to facilitate chaining.
813
- - When calling `CollectionEntry.revertChanges`, callbacks like `onAdd` / `onRemove` and `onActivate` / `onDeactivate`
814
- are now respected. This fixes an issue where items where *not* removed from the local cache.
815
- - When removing *local* items from collections, they are removed from `initial` as well as `modified`. This fixes an
816
- issue where changes were being detected continuously.
817
- - Updated the order of requests in `changesProcessor`. The `update` request is now executed before the `delete` request,
818
- except when updating documents. This fixes several issues.
819
- - `CollectionCache` now uses a map instead of an array to store collections. This fixes an issue where the same
820
- collection was added multiple times.
821
- - Updated all models to use dependency objects. This increases ease of debugging.
822
-
823
- ##v.1.11
824
- - Fixed issue that occurs when saving when having an existing item refer to a newly created item.
825
- - **Breaking:** Removed `ItemResourceService.isNewResource`.
826
- - **Breaking:** Renamed `ItemResource.isNewResource` to `ItemResource.isNew`. Removed parameter.
827
- - `ItemResource.isNew` is equivalent to `ItemResource.isLocal`, while `EditResource.isNew` checks also checks for
828
- completed transactions.
829
-
830
- ##v.1.10
831
- - Fixed issue where changes on different subtabs were not detected.
832
-
833
- ##v1.1.9
834
- - Exposed `noop` function on `RmCore` class.
835
- > This is used in order to check whether a callback has a default value.
836
- - Added `copyRequestColumns` function to `ColumnUtil` class.
837
- - Made parameters of `ItemAdministrator.saveCurrentLocalCache` and `LocalCache.save` optional.
838
- - **Breaking:** Reordered parameters of `ChangesProcessor.execute` to be consistent with
839
- `ItemAdministrator.saveCurrentLocalCache`. The new order is `singleItems` - `collections` - `parameters` -
840
- `breakUpByParent` - `onAfterCreateCallback`.
841
-
842
- ##v1.1.8
843
- - Set default value for `params` to `{filter: false}` in `request` function in `ColumnHandler` class.
844
-
845
- ##v1.1.7
846
- - Fixed issue where cached item entries or collection entries wouldn't be added to the local cache.
847
-
848
- ##v1.1.6
849
- - Fixed issue with deferred item entries.
850
- - Re-enable changes watcher after save.
851
- - Added optional `id` parameter to `LocalCache` constructor.
852
-
853
- ##v1.1.5
854
- - Added `clearItem` function to `LocalCache` class.
855
-
856
- ##v.1.1.4
857
- - Fix issue where items where not added to the local cache automatically when they where added to a collection.
858
- > This depends on the `callOnActivate` parameter. I've added this mainly because extending collections should *not* add
859
- the items to the local cache.
860
- > In other instances this might be debatable because it doesn't do any real harm. *Not*
861
- doing it however can definitely be harmful.
862
-
863
- ##v.1.1.3
864
- - Fixed an issue where all collections in a local cache would be cleared.
865
- - **Breaking:** Renamed `getCacheManager` to `getCurrentLocalCache` and `setCacheManager` to `setCurrentLocalCache` in
866
- `LocalCacheManagerInterface`.
867
-
868
- ##v1.1.2
869
- - Fixed an issue concerning derived values.
870
-
871
- ## v1.1.1
872
- - Fixed an issue where changes wouldn't be detected.
873
- - **Breaking:** Removed the `_hasChanges` function in the `localCache` class. If you want to force changes detection,
874
- call `detectChanges` instead. Otherwise, rely on the `hasChanges` variable.
875
- - **Breaking:** Removed the `enableWatcher` and `disableWatcher` functions. Use `enableChangesWatcher` and
876
- `disableChangesWatcher` instead.
877
-
878
- ## v1.1.0
879
- ### Development
880
-
881
- #### Strict TypeScript compilation
882
- Added the following TypeScript compiler options:
883
- - noImplicitThis
884
- - noImplicitReturns
885
- - strictNullChecks
886
- - noUnusedLocals
887
- - noUnusedParameters
888
-
889
- I would advise enabling these for all TypeScript projects from now on.
890
-
891
- #### Ordered imports and dependencies
892
- Imports are now ordered alphabetically and grouped by folder. Added a TSLint option to enforce this.
893
- Please note that this also applies for imports from the folder the file is currently in.
894
- For example, in `models/ItemResource.ts`, `itemEntry` should be imported like so:
895
- `import { ItemEntry } from '../models';`
896
-
897
- Also, factory and class dependencies should be ordered alphabetically as well. This will make it easier to add and
898
- remove dependencies in the future.
899
-
900
- ### Breaking changes
901
-
902
- - Renamed `changesCompiler` to `changesCompilation`, `changesCompilerFactory` to `changesCompilationFactory`,
903
- `moduleChangesCompiler` to `moduleChangesCompilation` and `moduleChangesCompilerFactory` to
904
- `moduleChangesCompilationFactory`.
905
- - Removed the `allLinks` parameter from the `query` function definition in the `ApiRequestServiceInterface`. This is
906
- no longer supported in the back-end.
907
-
908
- #### Item and collection entries
909
- - Moved *all* functions that handle item entries from the `ItemEntryService` to the `ItemEntry` class.
910
- - Added the following functions to `ItemEntryService`:
911
- - `createLocalConversionMap`;
912
- - `expandLocalConversionMap`;
913
- - `expandConversionMap`;
914
- - `batchExpandConversionMap`;
915
- - `batchClone`.
916
- - Cloning of item entries now works slightly differently. The function will attempt to generate a new
917
- item ID, and update the conversion map accordingly, but will respect the item ID that is already there.
918
-
919
- #### Rework item caching
920
- Newly created item entries and collection entries are no longer added to the global *or* local cache by default.
921
- All entries are added to the global cache on save. Item entries are added to the local cache when resources are created
922
- using the item administrator or when resources are created when adding the items to a collection.
923
-
924
- > This will increase reliability by ensuring the global cache is no longer 'polluted' with local items. Also, this will
925
- > allow for the creation item and collection entries without caching them directly. This is required for the copying and
926
- > pasting of items.
927
-
928
- Other changes:
929
-
930
- - Moved `saveLocal` to `ItemAdministrator`;
931
- - `ItemAdministrator.fetchTitle` should now be called instead of `ItemHandler.fetchTitle`;
932
- - The `ItemAdministrator` collection matching functions (`addToCollections`, `removeFromCollections`) should now be
933
- called instead of those in the `CollectionHandler`. The `CollectionHandler` should only be used to reflect changes
934
- already on the backend. (Use `getCollectionMatcher`.)
935
-
936
-
937
- ##v1.0.33
938
- - Really fix types path
939
-
940
- ##v1.0.33
941
- - Fix types path
942
-
943
- ##v1.0.32
944
- - Update `tsconfig.json` to put definitions in the root folder
945
- > The app had an issue with AOT compilation because of this
946
-
947
- ##v1.0.31
948
- - Fix `columnHandler.fetchItemTypeTranslations`
949
- > It incorrectly looped over the response map, it should now work again
950
-
951
- ##v1.0.30
952
- - Remove `updateTabParams` from LocalCacheManagerInterface
953
- > The function wasn't used
954
-
955
- - Reworked class export
956
- > Imports are now done from @rentman/rm-core, old imports are broken. This is because the old export structure didn't always work
957
-
958
- ##v1.0.29
959
- - Fix inverted inArray check in CollectionEntry.removeItems
960
- > A delete message from the socket deleted all BUT the deleted items, this should now be fixed
961
-
962
- ##v1.0.28
963
- Bug fixes only
964
-
965
- ##v1.0.27
966
- - `ItemEntry.initial` is now undefined by default
967
- > In the SocketMessageHandler we use this check to see if an ItemEntry is a stub
968
-
969
- ##v1.0.26
970
- Bundle both minified and unminified code, include sourcemaps from dev build
971
-
972
- ##v1.0.24, v1.0.25
973
- ! Use version `v1.0.26` !
974
-
975
- - The core now expects a `promiseInterface` that should implement the provided `promiseInterface`
976
- > We need to be able to hook into the promises in order to call a digest cycle to update the ui in the frontend
977
-
978
- - Rename `ItemEntry.entryId` to `ItemEntry.id
979
- > It used to be called `id`, but it was changed in the seperation of the core.
980
- > You can use the `id` to uniquely identify an entry, since itemId can be updated (local to saved id)
981
-
982
- - Rename ItemResource `startTransaction` to `start`
983
- > Other functions are called `commit` and `rollback` so having 'transaction' only for start doesn't make much sense
984
-
985
- - `SocketMessageHandler.onMessageReceived` now returns a promise
986
- > You can now use the updated items or hook into the result to update the ui for example
987
-
988
-
989
- ##v1.0.23
990
- - Rename ResourceCache to LocalCache
991
- > LocalCache only caches local items (name better reflects functionality)
992
-
993
- - Remove getter/setter for hasChanges
994
- > hasChanges is called in a digest loop in the frontend, so for performance reasons we don't want to recompute the value every time
995
-
996
- - Remove `_getCollection` from ItemAdministrator
997
- > `_getCollection` is now named `getCollection` and the old `getCollection` is removed. The query is part of the
998
- > options and should not be given as a separate argument. This was included to support the frontend
999
-
1000
- - Remove `saveCurrentTab` from ItemAdministrator
1001
- > `saveCurrentTab` makes no sense because the core has no concept of tabs, you should use `saveCurrentLocalCache` instead
1002
-
1003
- - Remove `getTabEntry` and `resetTabEntry` from ItemAdministrator
1004
- > `getTabEntry` and `resetTabEntry` make no sense because the core has no concept of tabs, you should use `getLocalCache` and `resetLocalCache` instead
1005
-
1
+ # Changelog
2
+
3
+ Contains new features, breaking changes and their reasoning
4
+
5
+ ## 9.2.3
6
+
7
+ - Fixed a bug in which multiple requests for the same item could result in incorrect expanded columns
8
+ - Increased performance of ColumnUtil by using string comparison over enums
9
+ - Increased performance of caching new items (in ChangesDelta._setItemCreated) by not creating default local values for
10
+ items from API responses
11
+
12
+ ## 9.2.2
13
+
14
+ - Optimize requests for collection trees with three levels. (E.g. MateriaalCat -> Planningmateriaal -> Missing)
15
+
16
+ ## 9.2.1
17
+
18
+ - Fix bug in 9.2.0 that caused updates of date fields not to be processed.
19
+
20
+ ## 9.2.0
21
+
22
+ - Greatly speed up core processing on large datasets
23
+ - Refactor the way ChangesDeltaBase.setItemUpdated processes fields to reduce `Object.getOwnPropertyDescriptor`
24
+ calls
25
+ - Refactor the way CacheSyncer.processDelta processes updated values to prevent unneeded field copying
26
+ and `Object.getOwnPropertyDescriptor` calls
27
+ - Add `RequestBufferManagerPrioritySettings` to give finer control over request buffering to the caller
28
+
29
+ ## 9.1.2
30
+
31
+ - Delete item lock when transaction is destroyed
32
+
33
+ > We never deleted item locks causing the items to be locked forever, even though a user wasn't editing them anymore
34
+
35
+ ## 9.1.1
36
+
37
+ - Fix handling of multiple create requests in one transaction
38
+
39
+ ## 9.1.0
40
+
41
+ - Implement cascading deletes based on backend delete relations
42
+
43
+ ## 9.0.5
44
+
45
+ - Prevent an error occurring when `fetchItemEntryData` did not return an itemEntry
46
+
47
+ ## 9.0.4
48
+
49
+ - Remove `MAYBE` matches that did not get returned after the API query from cached queries and collections
50
+ in `CacheSyncer`
51
+
52
+ ## 9.0.3
53
+
54
+ - Check for empty changesDeltas in `TransactionCache.applyChangesFromParent` to prevent unnecessary calls
55
+
56
+ ## 9.0.2
57
+
58
+ - Improve the way `getLinkCollections` fetches its data to greatly improve performance
59
+
60
+ ## 9.0.1
61
+
62
+ - Accept any version (apposed to `latest`) for @rentman/backend-types
63
+
64
+ ## 9.0.0
65
+
66
+ - **Breaking:** Align item changes in server cache and transaction cache: add `fields` property in server item changes,
67
+ rename `changes` in transaction item changes to fields. Remove `getChangesFromItemChanges`.
68
+
69
+ ## 8.2.11
70
+
71
+ - Only copy over cachedQueries when saving child transactions if the parent transaction doesn't have one with the query
72
+ yet
73
+
74
+ ## 8.2.10
75
+
76
+ - Fix displayname for 'CustomfieldGroup'
77
+ - Also set displayname when creating ItemEntries
78
+
79
+ ## 8.2.9
80
+
81
+ - Fixes a bug in which items on the ServerCache would not properly be added to collections
82
+
83
+ ## 8.2.8
84
+
85
+ - Fixes a bug in which newly created items do not appear in collections caused in 8.2.6
86
+
87
+ ## 8.2.7
88
+
89
+ - Merge tabRequestParameters when saving a TransactionCache into another TransactionCache
90
+
91
+ ## 8.2.6
92
+
93
+ - Fixed issue where deleted equipment re-appear
94
+
95
+ ## 8.2.5
96
+
97
+ - Skipped
98
+
99
+ ## 8.2.4
100
+
101
+ - Fixed issue where non-local items were expanded locally.
102
+ - Fixed hypothetical situation where an item entry in a local cached query could have an incomplete column set.
103
+
104
+ ## 8.2.3
105
+
106
+ - Did a performance optimization which will cause aggregated columns not to be re-fetched unnecessarily
107
+
108
+ ## 8.2.2
109
+
110
+ - Fixed a bug where derived values would not be fetched for newly created local items
111
+ - Did a performance optimization which will cause aggregated columns not to be re-fetched unnecessarily
112
+
113
+ ## 8.2.1
114
+
115
+ - Skipped
116
+
117
+ ## 8.2.0
118
+
119
+ - Added support for collection trees. Now, when requesting a collection you can add the `children` property, which is a
120
+ map of collection options. The collection resources will be available in the item resources of the resulting
121
+ collection resource. For more information,
122
+ see [Confluence](https://rentman.atlassian.net/wiki/spaces/~652789241/pages/948404231/Child+collections).
123
+
124
+ ## 8.1.9
125
+
126
+ - RM4-16796 Fixed a bug where loading the same query in quick succession would cause columns/data to be missing
127
+
128
+ ## 8.1.8
129
+
130
+ - Reorganize imports: move all exports to `internal.ts`. This is the only place where things should be exported. All
131
+ files should import from this file. Resolve duplicate declaration of `InternalCreateDelta` type.
132
+ - Improve performance of copying over values in `ChangesDelta`s and `CollectionMatcherBase`
133
+ - Merge all `CollectionMatcher` classes into one `CacheSyncer`, so that `processDelta` only has to be done once
134
+ - Increase performance of the ApiFormatter on large datasets
135
+
136
+ ## 8.1.7
137
+
138
+ - Fixed a bug where copied over CachedQueryItems weren't resolved (causing them to hang forever)
139
+
140
+ ## 8.1.6
141
+
142
+ - Add missing return statement in ServerCache.applyChangesDelta
143
+
144
+ ## 8.1.5
145
+
146
+ - Only extend missing derived values while resolving local items
147
+ in `TransactionCachedQueryHandler.__fetchItemEntriesByQueryData`
148
+
149
+ ## 8.1.4
150
+
151
+ - Remove non-created items if they are not returned in the response of a Create request
152
+
153
+ > If a create would fail, the whole request would fail. So we can assume that if an item isn't returned from a create
154
+ > request, the backend has left it out on purpose
155
+
156
+ - Move cached queries to parent transactions only when saving a child transaction
157
+
158
+ > Only then you know for sure that items that matched on the child transaction will also match in the parent transaction,
159
+ > since you're taking over the changes, this behaviour was changed somewhere in a refactor but was incorrect
160
+
161
+ - No longer move cached queries to the ServerCache when saving a root transaction
162
+
163
+ > You probably don't need the result of *all* those cached queries anymore (and it's also inefficient to keep them because the matcher keeps the up-to-date)
164
+
165
+ - No longer wait for child transactions to sync when applying changes in a parent
166
+
167
+ > A child transaction can only influence a parent transaction by calling `TransactionCache.save`, which doens't happen whilst applying changes,
168
+ > so you don't have to wait for child transactions when applying changes in a parent
169
+
170
+ ## 8.1.3
171
+
172
+ - Allow passing TransactionOptions to TransactionCacheFactory.construct
173
+
174
+ ## 8.1.2
175
+
176
+ - Fixed a bug in which derived values for local items wouldn't be properly be fetched
177
+
178
+ ## 8.1.1
179
+
180
+ - Fixed a bug in which a `Template` request's columns weren't processed
181
+
182
+ ## 8.1.0
183
+
184
+ - Add `cloneCreatedChanges` function to `ChangesDeltaFactory`. This function clone the `created` component of a changes
185
+ delta into a destination changes delta.
186
+ - Add `TransactionOptions`, implement `transparent` transaction option
187
+ - Allow core-mapped TS types instead of backend-mapped TS types in `ApiFormatter.compareFields`
188
+ - Fixed a bug where empty update requests where sometimes done
189
+ - Fixed a bug where derived values of items returned in a Template request weren't properly resolved
190
+
191
+ ## 8.0.3
192
+
193
+ - Changed the flow of a create request so that it includes all the required columns for all transactions and also
194
+ processes additionally returned (derived) items
195
+ - Fixed a bug where fields referencing local items would already be updated in the `previous` before the `onChange`
196
+ callbacks were called
197
+ - Moved logic of updating IDs in cached queries/collections to TransactionCachedQueryHandler and
198
+ TransactionCollectionHandler
199
+
200
+ ## 8.0.2
201
+
202
+ - Fixed a bug where deleted entries on a child transaction where not handled properly
203
+ - Fixed a bug where saving a child transaction, and then undoing those changes and saving again would not update the
204
+ parent transaction
205
+
206
+ ## 8.0.1
207
+
208
+ - Uppercase operators and comparators in QueryMatcher, QueryParser and QueryService
209
+ - Fix parsing short-hand `IN` queryies
210
+
211
+ ## 8.0.0
212
+
213
+ - Implement `@rentman/backend-types`
214
+
215
+ > You will now have autocomplete and typing checking on all columns/fields 🥳
216
+
217
+ - Remove `ChangesDeltaResult.rollback`
218
+
219
+ > It was never really used/implemented
220
+
221
+ ## 7.2.0
222
+
223
+ - Add the `preventCaching` option to `CollectionOptions`
224
+
225
+ > Prevents a CachedQueryItem from being cached (the CollectionResource will still be cached), you can use this when you fetch an Itemtype for which the backend doesn't send socket messages (so it never automatically updates)
226
+
227
+ ## 7.1.1
228
+
229
+ - Properly handle moved items in ServerCache.applyChangesFromParent (technically the backend won't ever generate a
230
+ linkTo (only updates)) but it can happen when manually syncing the server cache (by
231
+ doing `InternalChangesDelta.setItemMoved`)
232
+
233
+ ## 7.1.0
234
+
235
+ - Automatically keep aggregated values up-to-date by always refetching them
236
+
237
+ ## 7.0.15
238
+
239
+ - Remove an accidentally left in place debugger
240
+
241
+ ## 7.0.14
242
+
243
+ - Take into account collections with a 'limit' (of which the query result isn't cached) when matching socket items
244
+
245
+ ## 7.0.13
246
+
247
+ - Only overwrite the displayname if the required columns are present, instead of defaulting to an empty string
248
+
249
+ ## 7.0.12
250
+
251
+ - Fixed a bug where the core would try to update the cache key (ID) of `fieldChangeCallbacks` even when there were no
252
+ callbacks for the given itemType
253
+
254
+ ## 7.0.11
255
+
256
+ - Fixed a bug where date values would not be compared if the descriptor was uncalled, this could lead to problems when
257
+ applying changes from a parent transaction
258
+
259
+ ## 7.0.10
260
+
261
+ - Update references to local IDs in other items when a local ID gets updated
262
+
263
+ ## 7.0.9
264
+
265
+ - Take over `tabRequestParameters` when saving TransactionCache -> TransactionCache
266
+
267
+ ## 7.0.8
268
+
269
+ - Fixed a race condition and loop iteration error which in very rare cases caused itemEntries to be `undefined` and
270
+ erroring
271
+ - Add missing error handling in transaction functions
272
+
273
+ ## 7.0.7
274
+
275
+ - Properly handle `reverse` linkedTo's in QueryColumnExtractor and QueryLocallyMatchableParser
276
+ - Implement refreshing of cached queries/collections
277
+
278
+ ## 7.0.6
279
+
280
+ Move fetching of lock from `TransactionItemHandler.processItemEntryChanges` to `TransactionCache.appyChangesDelta` to
281
+ also capture creates and deletes.
282
+
283
+ ## 7.0.5
284
+
285
+ - Remove automatic fetching of derived values for not-yet-created items
286
+
287
+ ## 7.0.4
288
+
289
+ - Automatically resolve derived values when a new item is created
290
+ - Fixed a bug where `AbstractCache.getParentFromFields` would still return `null` incorrectly
291
+
292
+ ## 7.0.3
293
+
294
+ - Fixed a bug where `AbstractCache.getParentFromFields` would still return `undefined` parent values
295
+
296
+ ## 7.0.2
297
+
298
+ - Check if any of the parent fields (`itemtype`, `item`) is `null`, in which case it won't be treated as a valid parent
299
+ in `AbstractCache.getParentFromFields`
300
+
301
+ ## 7.0.1
302
+
303
+ - Ignore columns in ApiFormatter::hasChanges if the `modified` object does not contain a value for it.
304
+
305
+ ## 7.0.0
306
+
307
+ - **Breaking**: Remove `enableChangesWatcher` and `disableChangesWatcher` in `TransactionCache`.
308
+ - Fetch lock token in `TransactionItemHandler.processItemEntryChanges`.
309
+
310
+ ## 6.3.10
311
+
312
+ - Only call `onRemove` of a collection if there are actually any items removed
313
+ - Expand cached columns anyways if there are no items to expand in `TransactionCachedQueryHandler.__expandCachedQuery`
314
+
315
+ ## 6.3.9
316
+
317
+ - Fixed a bug where deleted local items would still appear as unsaved changes
318
+
319
+ ## 6.3.8
320
+
321
+ - Always fetch 'id' and 'permissions' columns so that they are always available
322
+
323
+ ## 6.3.7
324
+
325
+ - Fixed a bug where items in a socket message that _might_ fit (`MAYBE`) in a collection would not be checked/added.
326
+
327
+ ## 6.3.6
328
+
329
+ - Fixed a bug where `AbstractCache.fetchUpdatedDerivedValuesFromDelta` would attempt to use ItemChanges not cached on
330
+ the transaction resulting in an error
331
+
332
+ ## 6.3.5
333
+
334
+ - Fixed a bug where after creating items derived values would needlessly be refetched
335
+
336
+ > The core now properly detect that even though an ItemId is updated (after a create) it's still the same item so no request has to be done
337
+
338
+ - Fixed a bug where ItemEntry's would not be re-cached under their new ItemIds
339
+
340
+ ## 6.3.4
341
+
342
+ - Fixed a bug where already cached itemEntries would not properly be detected when calling `ServerCache.processResponse`
343
+ - Fixed a bug where calling `CreatedChangesDelta.remove` would add `empty` values in the array instead of removing the
344
+ entry
345
+
346
+ ## 6.3.3
347
+
348
+ - Fixed a bug where local ItemEntries were not properly updated after saving
349
+
350
+ ## 6.3.2
351
+
352
+ - Fixed updating item entry itemId field after processing changes
353
+
354
+ ## 6.3.1
355
+
356
+ - Fixed a bug where query with a local ID would do a request to the server
357
+
358
+ ```
359
+ // This example should now no longer do a request
360
+ transaction.getItemsByQuery(
361
+ 'Tijd',
362
+ {
363
+ project: -11,
364
+ }
365
+ );
366
+ ```
367
+
368
+ ## 6.3.0
369
+
370
+ - Allow strict typing of `FieldMap`
371
+
372
+ ## 6.2.5
373
+
374
+ - Remove overwriting itemType with itemType of rootItem during create
375
+
376
+ ## 6.2.4
377
+
378
+ - Fixed a bug where items would not appear in a collection after changes propagated from a parent transaction
379
+
380
+ ## 6.2.3
381
+
382
+ - Fixed a bug where `previous` would actually contain new values because the `previous` object was made after the values
383
+ were already synced
384
+
385
+ ## 6.2.2
386
+
387
+ - Fixed a bug in syncing of initial values after saving an item causing the item to still be marked having changes
388
+
389
+ ## 6.2.1
390
+
391
+ - Fixed a bug where `ItemEntry`s created on the `ServerCache` where not matched on child `TransactionCache`s
392
+
393
+ ## 6.2.0
394
+
395
+ - Fixed a bug where synchronous validators would leave the validator in `pending` state
396
+ - Only re-match items when values are actually changed
397
+ - Removed `defered` from `CachedQueryItem` and added `resolve` and `reject`
398
+ - Check if ItemEntries are already created before creating new ones, if that is the case treat it like an update
399
+
400
+ > What could happen was that a faster request created an ItemEntry for the same item as another request
401
+ > which caused the double creation of an ItemEntry
402
+
403
+ ## 6.1.3
404
+
405
+ - Add `isPending` function to `TransactionValidator`
406
+ - `TransactionCache`s will now be invalid until all pending transaction validators are done
407
+
408
+ ## 6.1.2
409
+
410
+ - Check if an error key exists before deleting it in `TransactionCache.clearItemError`
411
+
412
+ ## 6.1.1
413
+
414
+ - Correctly pass `ErrorHandlerInterface` to `ChangesDeltaFactory`.
415
+
416
+ ## 6.1.0
417
+
418
+ - Return `ChangesDelta` instance in `setItemUpdated`, `setItemDeleted`, `setItemsDeleted` methods, and a promise that
419
+ resolves to the instance in `setItemCreated` and `setItemsCreated`.
420
+
421
+ ## 6.0.2
422
+
423
+ - Update `query` parameter of `getByQuery`, `getLocalByQuery`, `batchGetLocalByParent`, and `matchQuery` in `ItemCache`.
424
+
425
+ ## 6.0.1
426
+
427
+ - Fixed a bug where a local item wouldn't be found when using `TransactionCache.getItemByState` on a child transaction
428
+
429
+ ## 6.0.0
430
+
431
+ - Refactored query caching structure
432
+ - Properly implemented `limit` in collections
433
+ - Removed extending of collections
434
+
435
+ ## 5.0.1
436
+
437
+ - Add 'icon' column type to non-selectable column types
438
+
439
+ ## 5.0.0
440
+
441
+ - Fixed a bug where created, creator and permissions was always set to default values
442
+ - **Breaking:** Remove `onItemsCreated` collection callback.
443
+
444
+ ## 4.0.4
445
+
446
+ - Fixed a bug where ModuleChangesCompilation wouldn't include all changes
447
+
448
+ ## 4.0.3
449
+
450
+ - Local collections are now correctly identified when using a local ID in a linkTo request instead of the `parent`
451
+ option
452
+ - Fix issue where local collection entries were not moved to server cache after save.
453
+
454
+ ## 4.0.2
455
+
456
+ - Fixed a bug where clearing collections would error after saving a transaction
457
+
458
+ ## 4.0.1
459
+
460
+ - Remove thrown error in `ItemResource.callOnChange`
461
+
462
+ > The frontend still relied on this and we won't refactor that at this point
463
+
464
+ ## 4.0.0
465
+
466
+ - Removed `ItemResourceOptions.onChange`, this is replaced by `TransactionCache.registerFieldChangeCallback`
467
+
468
+ > Because the `onChange` is no longer stored on the ItemResource, the ItemResource doesn't have to be cached.
469
+ > This way you don't have to call `ItemResource.clearResource` anymore (you do need to deregister the fieldChange callbacks)
470
+
471
+ ## 3.1.0
472
+
473
+ - **Breaking:** Remove `fields` property, add `getFields` method in `Template` class.
474
+ - **Breaking:** Add `ConversionMapService`. Update `updateItemValues` to take a `source` and `destination` parameter.
475
+ - Update `entry.itemId` for items created items in `TransactionCache.getDelta`.
476
+
477
+ > This fixes an issue with updating IDs of local items.
478
+
479
+ - Add dependency interfaces for `AbstractCache`, `ServerCache`, `TransactionCache`, `TransactionCollectionHandler`
480
+ , `TransactionItemHandler`.
481
+ - Add `CreatedChangesDelta` class, which replaces the `created` component of the `ChangesDelta` and includes some query
482
+ methods. Add `isEmpty` method to `ChangesDelta`.
483
+
484
+ ## 3.0.1
485
+
486
+ - Fixed a bug where the `StateKeyType` enum couldn't be used when imported
487
+
488
+ ## 3.0.0
489
+
490
+ - Remove ViewResource, EditResource, CollectionViewResource and CollectionEditResource
491
+
492
+ > There was no real distinction between them anymore since the core 2.0 update.
493
+ > You can now use the base ItemResource and CollectionResource types instead
494
+
495
+ ## 2.4.0
496
+
497
+ - Update Typescript version to `3.7.2`, also update other plugins
498
+
499
+ ## 2.3.0
500
+
501
+ - Add callbacks when errors are set/cleared to `TransactionEventHandler`
502
+ - Added the possibility to differentiate between errors to display below a field and on the save button
503
+ in `TransactionValidator`
504
+ - Changed the format of the error translations from `string` to `() => string` in `TransactionValidator`
505
+
506
+ > Now the translation function will only be called when the error is actually set, not when it's cleared
507
+
508
+ ## 2.2.1
509
+
510
+ - Fixed a bug where resolving derived values for new items (in `TransactionCache.applyChangesDelta`) would sometimes
511
+ error
512
+
513
+ ## 2.2.0
514
+
515
+ - `ChangesDelta.setItem(s)Created` will now accept incomplete input values
516
+
517
+ > It will now fetch a template for you and process the items, so you no longer need to do that yourself
518
+
519
+ ## 2.1.2
520
+
521
+ - Fixed a bug where deleted ItemEntries weren't picked up when detecting transaction changes
522
+
523
+ ## 2.1.1
524
+
525
+ - Fixed a bug where an ItemEntry's errors wouldn't be deleted when the ItemEntry was deleted on a transaction
526
+
527
+ ## 2.1.0
528
+
529
+ - Refactor `TransactionCache.getItemsByQuery` to check cached entries (just like a collection)
530
+ - Add `TransactionValidator`, allow passing of a `TransactionValidatorFactory` to a transaction
531
+
532
+ > You can use these validators to set errors using `setItemError` and `setGlobalError`
533
+
534
+ - Fixed a bug where `TransactionItemHandler.cloneItemEntry` could only clone entry with changes on the target
535
+ transaction.
536
+
537
+ > It will not look for changes recursively on the transaction change
538
+
539
+ ## 2.0.19
540
+
541
+ - Ensure all requestColumns for newly created ItemEntries from a template are available
542
+ - Ensure derived values for newly created ItemEntries from a template are available
543
+
544
+ ## 2.0.18
545
+
546
+ - Include read-only columns when detecting changes in TransactionItemHandler.processItemEntryChanges
547
+
548
+ > Read-only columns shouldn't count as changes on the tab, but they should be taking into account when deciding whether or not to call `onChange`
549
+
550
+ ## 2.0.17
551
+
552
+ - Fixed a bug where deleting an item that isn't in the transaction's item entry cache would result in an error
553
+ - Fixed a bug where response columns weren't set for newly created local CollectionEntries
554
+ - Fixed a bug where items weren't matched for newly created local CollectionEntries
555
+
556
+ ## 2.0.16
557
+
558
+ - Fixed a bug where queries with a link to a local parent item weren't updated on save
559
+
560
+ ## 2.0.15
561
+
562
+ - Cache ItemEntries that fit collections on the CollectionEntry's query instead of the CollectionEntry's id
563
+ - Add a 'hint' to ChangesDeltas which allows skipping the extra request to validate `maybe` query matches
564
+ - Create transaction changes for ItemEntry updates in the changesDelta if non exist yet when
565
+ calling `TransactionCache.applyChangesDelta`
566
+
567
+ > This allows you to update values on a transaction without having to fetch a resource for it by calling
568
+ > `ChangesDelta.setItemUpdated()`
569
+
570
+ ## 2.0.14
571
+
572
+ - Fixed reading of derived values in `getItemIdByColumn` when a ChangesDelta is passed
573
+
574
+ ## 2.0.13
575
+
576
+ - Fixed a bug where the incorrect fields where applied to the ChangesDelta in `TransactionItemHandler.cloneItemEntry`
577
+ - A RequestBuffer's promise will now resolve after the ServerCache.processResponse promise is done, ensuring all values
578
+ are present before continuing
579
+ - Request columns for the request ItemType will now properly be taken into account in ServerCache.processResponse
580
+ ensuring root columns are always properly set. (This is used to update derived values)
581
+
582
+ ## 2.0.12
583
+
584
+ - Fixed a bug where created changes weren't copied to the itemchanges
585
+ - Only take readonly parent columns instead of all readonly columns in `ApiFormatter.hasChanges`
586
+ - Fixed a bug where ItemEntry's where still in `ItemCache.entriesByEntryId` after clearing them
587
+
588
+ ## 2.0.11
589
+
590
+ - Fixed a bug where changes weren't copied to the itemchanges
591
+ - Fixed correct isCalledAfterApiSave values on calls to ServerCache.processResponse
592
+
593
+ ## 2.0.10
594
+
595
+ - Construct `ColumnSet` with proper `requestColumns` when creating a `Template` with additional columns
596
+
597
+ ## 2.0.9
598
+
599
+ - Properly process linked items from the template request in `TransactionItemHandler.createItems`
600
+
601
+ ## 2.0.8
602
+
603
+ - Fixed a bug where not all fields where available even tough an ItemResource with specific columns was created
604
+
605
+ ## 2.0.7
606
+
607
+ - Define abstract copyTransactionItemEntryChanges on ItemHandlerBase
608
+ - Implement copyTransactionItemEntryChanges on TransactionItemHandler and ServerItemHandler
609
+ - Fix AbstractCache/ServerCache/TransactionCache `getParent` function arguments
610
+
611
+ > With the newly added arguments the function definitions didn't align anymore causing typescript errors
612
+ > Even though the arguments aren't used in the `ServerCache` they're added in there
613
+
614
+ ## 2.0.6
615
+
616
+ - Remove `ApiFormatter.lazyClone`
617
+
618
+ > You can't lazily clone moment objects because the moment you wanted to clone could be changed in the time the getter isn't invoked, resulting in a different value
619
+
620
+ - Create a copy of the child transaction's field instead of copying the object reference
621
+ in `TransactionCache.applyChangeFromChild` and `ChangesProcessor.executeCreateRequest`
622
+
623
+ > When writing to the object references you're changing multiple transactions at once, while this should be handled by applyCHangesFromParent
624
+
625
+ ## 2.0.5
626
+
627
+ - Add `callOnAddWithInitialItems` option to `CollectionResourceOptions`
628
+
629
+ > If `true` the `onAdd` callback will be called with the initial set of items
630
+
631
+ ## 2.0.4
632
+
633
+ - Add `isCalledAfterSocketUpdate` to `onAdd`, `onRemove` and `onChange` callbacks
634
+
635
+ > You can use this if a data change should only trigger an action when the user caused it himself
636
+
637
+ ## 2.0.3
638
+
639
+ - Fix `CollectionEditResource.removeItems`
640
+ - Move `getCurrentCollectionEntryCache` and `getCurrentItemEntryCache` from `TransactionCache` to `AbstractCache`
641
+
642
+ ## 2.0.2
643
+
644
+ - Fix marking entries as deleted and compiling this into a request
645
+
646
+ ## 2.0.1
647
+
648
+ - Expand CollectionEntry's columns in `ServerCollectionHandler.fetchCollectionData`
649
+
650
+ ## 2.0.0 - Major caching refactor
651
+
652
+ - Completely reworked internal caching structure,
653
+ see [this Confluence page](https://rentman.atlassian.net/wiki/spaces/DEV/pages/704872456/) for the motivations behind
654
+ it.
655
+
656
+ ## 1.9.0
657
+
658
+ - Don't create ItemResources when not returning links in `ItemAdministrator.getNewResourceWithId` and
659
+ in `ItemAdministrator.constructOnItemsExpanded`
660
+
661
+ ## 1.8.0
662
+
663
+ - Remove `ResourceCache` and `resourceLevel`
664
+
665
+ > You should now manually call `resource.clearResource` when you no longer need a resource
666
+
667
+ - Add `onConstruct` function to `ItemResource` and `CollectionResource`
668
+
669
+ > This is overwritten by the frontend to track resource creation
670
+
671
+ ## 1.7.6
672
+
673
+ - Add priority parameter to local cache callbacks. The callback condition (`always` / `onClose` / `skipOnClose`) no
674
+ longer has any effect on the order in which the callbacks get executed.
675
+ - **Breaking:** Remove `LocalCacheCallbackCondition` enum.
676
+ - Add `itemId` parameter to `ItemHandler.fetchNewItem`. An error is thrown when an ID already exists.
677
+ Add `getNewResourceWithId` to ItemAdministrator. Deprecate `getItemByState`.
678
+
679
+ ## 1.7.5
680
+
681
+ - For template column sets it is no longer assumed all columns are present. This fixes an issue with incomplete column
682
+ sets in the front-end.
683
+ - Fix issue where `changesProcessor` instance was undefined in `itemResourceFactory` and `collectionResourceFactory`.
684
+ Create variables for each core service in order to get a TypeScript error when a dependency hasn't been initialized
685
+ yet.
686
+
687
+ ## 1.7.4
688
+
689
+ - Add support for strict ItemType type checking in `FieldMap`
690
+
691
+ ## 1.7.3
692
+
693
+ - Add support for strict ItemType type checking
694
+
695
+ > This is temporarily defaulted to `any` to prevent compile errors in the frontend
696
+
697
+ ## 1.7.2
698
+
699
+ - Fix some typing issues in:
700
+ - ApiResponseProcessor
701
+ - ItemCache
702
+ - KeyService
703
+
704
+ ## 1.7.1
705
+
706
+ - Fix issue where `CreateRequestFactory` would be undefined in `ChangesProcessor`.
707
+
708
+ ## 1.7.0
709
+
710
+ - **Breaking:** remove `ChangesProcessorFactory`. Add `ChangesProcessor` instance to core directly.
711
+
712
+ ### Resource caching
713
+
714
+ - **Breaking:** the following properties are removed:
715
+ - On `ItemEntry`: `clearResources`, `deactivateResources`.
716
+ - On `CollectionEntry`: `clearResources`, `getCurrentResource`.
717
+ - On `CollectionResourceOptions`: `clearOnTabChange`, `clearOnSubTabChange`.
718
+ - An additional `level` parameter has been added to all methods that return resources.
719
+ - When creating resources using `ItemResourceFactory` or `CollectionResourceFactory`, this parameter is mandatory.
720
+ A `defaultResourceLevel` parameter has been added to the `LocalCache` constructor.
721
+ - A `clearResources` method has been added to `ItemAdministrator`. When calling this method, all item / collection and
722
+ collection resources with a level of `level` or higher will be removed.
723
+ - The `clearResources` method has been removed from `LocalCache`.
724
+ - The `setCurrentLocalCache` function has been removed from `LocalCacheManagerInterface`.
725
+
726
+ ## 1.6.13
727
+
728
+ - When encountering a collection entry with `PROMISED_EXPAND` status, call `getCachedEntryStatus` after the initial
729
+ promise has been resolved.
730
+
731
+ > This is the likely cause of the issue where `_resolve` is called on a non-deferred collection entry.
732
+
733
+ ## 1.6.12
734
+
735
+ - Fix error that occurs when trying to resolve a non-deferred collection entry.
736
+
737
+ ## 1.6.11
738
+
739
+ - Fix issue where `QueryMatcher.matchComplexQuery` would return the wrong value.
740
+
741
+ ## 1.6.10
742
+
743
+ - **Breaking**: Remove `linkType`, `linkIdArray` properties from `LinkCollectionDefinition`. Add `linkType`,
744
+ `linkIdArray` parameters to `ItemAdministrator.getLinkCollectionsFromDef`.
745
+
746
+ ## 1.6.9
747
+
748
+ - Redeploy of `1.6.8`
749
+
750
+ ## 1.6.8
751
+
752
+ - Add support for `not` in queries
753
+
754
+ ## 1.6.7
755
+
756
+ - Fix issue where `CollectionMatcher.addToCollections` wouldn't return the correct type.
757
+
758
+ ## 1.6.6
759
+
760
+ - Add `callOnAdd` parameter in `CollectionHandler.batchExtend`. Set `updateInitial` to true. Remove `updateInitial`
761
+ parameter in `CollectionEntry.extend`, as it should always be true.
762
+
763
+ > The `extend` function only concerns itself with remote items, so no local changes should be generated.
764
+
765
+ ## 1.6.5
766
+
767
+ - Fix issue where a derived column could be marked as the `link` (parent) column in the column set.
768
+
769
+ > This could lead to instances where a different column would be set to the value of the parent.
770
+
771
+ ## 1.6.4
772
+
773
+ - Fix issue where the `onChange` collection callback would not be called when updating it in the options.
774
+ - Add `callOnAdd` parameter to collection matcher. When set to `false`, `onAdd` is not called for
775
+ the `resultCollectionResource`.
776
+
777
+ ## 1.6.3
778
+
779
+ - Properly type ApiResponseProcessor - fetchObjectArray
780
+
781
+ ## 1.6.2
782
+
783
+ - Fix issue where the collection handler would return collection entries before they were resolved when
784
+ calling `batchFetch`.
785
+
786
+ ## 1.6.1-3
787
+
788
+ - Check for linkedTo before checking for subqueries in QueryMatcher
789
+
790
+ > Linkedto also has `.query` and was incorrectly marked as a subquery
791
+
792
+ ## 1.6.1-2
793
+
794
+ - Fixed shorthand query with null values
795
+
796
+ > The QueryParser would incorrectly identify subqueries when using null in a shorthand
797
+
798
+ ## 1.6.1-1
799
+
800
+ - Fixed shorthand query with Moment values
801
+
802
+ > The QueryParser would incorrectly identify Moment objects as a subquery
803
+
804
+ ## 1.6.1
805
+
806
+ - Added support for subqueries in QueryParser and QueryMatcher
807
+
808
+ > Collections using subqueries will always return 'maybe' in the QueryMatcher
809
+
810
+ ## 1.6.0
811
+
812
+ - All external callbacks are now wrapped in a `try ... catch` block. This prevents them from breaking core
813
+ functionality.
814
+ - **Breaking**: Add `ExceptionHandlerInterface` parameter to core constructor.
815
+
816
+ ## 1.5.9
817
+
818
+ - Fix issue that occurs when trying to resolve a `ColumnSet` using a single non-existing column. Catch exceptions that
819
+ might occur when resolving an `ItemEntry`.
820
+ - Add `mergeRequestColumns`, `mergeResponseColumns` to `ColumnSet`. When encountering new items while expanding a
821
+ collection, add them to the collection.
822
+
823
+ ## 1.5.8
824
+
825
+ - Introduce `RemoteViewResource` and `LocalViewResource`.
826
+
827
+ > The `fields` property of a `RemoteViewResource` represents server values, while the `fields` property of a `LocalViewResource` represents local values.
828
+
829
+ - The `fields` property of a `ViewResource` is now read only.
830
+
831
+ ## 1.5.7-1
832
+
833
+ - Make ItemResource/CollectionResource base class abstract
834
+ - Add missing overload functions in some places
835
+ - Fix default comparator `QueryMatcher.parseSimpleQuery`
836
+ - Fix `ExtendedCollectionMatchResult` `collection` property type
837
+
838
+ ## 1.5.7
839
+
840
+ - Properly type Collections & ItemResources (and return values) in the whole core.
841
+
842
+ > The core will now properly return Collections & ItemResources based on the passed CollectionOptions.
843
+ > You can now also type the expected collection type
844
+
845
+ ```
846
+ // Expects a collection with editCollection and editItems both `true`
847
+ // Will properly return EditResources for all collection functions
848
+ const collection: CollectionEditResource<EditResource>;
849
+
850
+ // other variations are:
851
+ // CollectionViewResource<ViewResource>
852
+ // CollectionViewResource<EditResource>
853
+ // CollectionEditResource<ViewResource>
854
+
855
+ this.core.itemAdministrator.getCollection(
856
+ 'Notitie',
857
+ {
858
+ editCollection: true, // Will return a CollectionEditResource
859
+ editItems: true // Will return EditResources instead of ViewResources in `.items`
860
+ }
861
+ )
862
+ ```
863
+
864
+ ## 1.5.6
865
+
866
+ - Add `getAllLocalCaches` to `LocalCacheManagerInterface`, remove item entries from all local caches on socket delete.
867
+
868
+ ## 1.5.5
869
+
870
+ - Add 'order' column type handling to ApiFormatter functions
871
+
872
+ ## 1.5.4
873
+
874
+ - Fix issue where parent would be incorrectly set when cloning a single item.
875
+ - Type functions related to expansion maps in `ItemEntryService`.
876
+
877
+ ## 1.5.3
878
+
879
+ - Fix issue where the `enableSave` collection resource option would default to `false`. This would throw an error when
880
+ calling `save` on a collection resource where this option was not explicitly set.
881
+
882
+ ## 1.5.2
883
+
884
+ - Type functions in `ColumnUtil` class.
885
+ - Add `getRequestColumnId` and `containsDerivedColumns` to `ColumnUtil`.
886
+
887
+ > `getRequestColumnId` should be used instead of `Util.getFirstProperty` when retrieving a column ID.
888
+
889
+ - **Breaking:** Remove `ColumnUtil.isColumnSubset`. Use `ColumnSet.isSuperSetOf` instead.
890
+ - Remove `findColumnObject`. Rename `findColumn` to `findRequestColumn`.
891
+
892
+ ## 1.5.1
893
+
894
+ - Properly remove item entry stub from (local) cache when request fails.
895
+ - Fix issue where item or collection options could be set to undefined.
896
+
897
+ ## 1.5.0
898
+
899
+ - Add `SocketMessage` type and add types to `SocketMessageHandler`
900
+ - Expand local items requested using `getItemById` or `getItemsById` in `ItemAdministrator`.
901
+ (`fetchItem` or `fetchItems` in `ItemHandler`.)
902
+ - Implement expanding of local collections. This no longer leads to invalid requests.
903
+ - **Breaking:** The `expand` function in `CollectionEntry` now has an `ItemCache` parameter.
904
+ - **Warning:** This version contains major changes.
905
+
906
+ ### Introduce typing of item and collection options
907
+
908
+ - **Breaking:** Removed `QueryItemType` collection entry option.
909
+ - **Breaking:** Removed `ItemResourceService`.
910
+ - Removed `processOptions` parameter from `createCollectionResource` (`ItemAdministrator`). It is now equivalent to
911
+ `addCollection`.
912
+ - When creating an item resource using `ItemResourceFactory`, a collection entry using `CollectionResourceFactory` or a
913
+ collection resource using `CollectionResourceFactory` it is no longer necessary to process options beforehand. It is
914
+ still necessary when interacting with `CollectionHandler` or `ItemHandler` directly.
915
+
916
+ ## v1.4.0
917
+
918
+ - Add `expandProcessLinkedItems` and `expandAddToCollections` to `ItemAdministrator`. These are analogues to
919
+ `processLinkedItems` and `addToCollections`, but also expand the items with (derived) values and columns as necessary.
920
+ They have a slightly different type signature.
921
+ - Whenever a collection is requested, the `CollectionHandler` now makes sure that added local items are expanded as
922
+ necessary.
923
+ - **Breaking:** Last parameter of `ItemHandler.createLocalEntries` is now a callback function.
924
+ - **Breaking:** Rename `TemplateLinkedItemEntryMap` type to `TemplateItemEntryMap`.
925
+
926
+ ## v1.3.8
927
+
928
+ - Add `isSaving` to `LocalCache`
929
+
930
+ > We use this to disable the cancel/save buttons while the localCache is saving in the frontend
931
+
932
+ ## v1.3.7
933
+
934
+ - Fix issues that generate invalid requests / changes when moving existing item to another collection, then deleting the
935
+ parent.
936
+ - Remove slip workarounds
937
+ - Add api request types
938
+ - Add types to `ModuleChangesCompilation`
939
+
940
+ ## v1.3.6
941
+
942
+ - Skip add / remove collection callbacks when calling `revertChanges` (`LocalCache`).
943
+
944
+ ## v1.3.5
945
+
946
+ - Fix issue where items added to collections when resolving wouldn't be removed in `revertChanges` (`LocalCache`).
947
+
948
+ ## v1.3.4
949
+
950
+ - Add country to isFilteredColumn in ColumnUtil
951
+
952
+ ## v1.3.3
953
+
954
+ - Move processLocalConfigColumns and consolidateColumns from ColumnUtil to frontend
955
+
956
+ > These functions are specifically used for rendering ui-grid in the frontend, so there's no reason to have them in the core
957
+
958
+ ## v1.3.2
959
+
960
+ - Fix types path in package.json
961
+
962
+ ## v1.3.1
963
+
964
+ - Fix types path in package.json
965
+
966
+ ## v1.3.0
967
+
968
+ - Rename PromiseInterface to PromiseLibraryInterface
969
+
970
+ > PromiseInterface is now used for the internal promise type
971
+
972
+ - Use PromiseInterface instead of Promise as internal promise type
973
+
974
+ > This allows us to overwrite the PromiseInterface definition in the frontend indicate usage of ng.IPromise
975
+
976
+ ## v1.2.9
977
+
978
+ - Call processOptions in fetchDerivedValuesByColumn
979
+
980
+ > Bug was introduced earlier but got enabled in v1.2.7
981
+
982
+ ## v1.2.8
983
+
984
+ - Add toJSON methods for ItemResources, ItemEntries, and ColumnSets to fix circular dependencies in JSON.stringify
985
+
986
+ ## v1.2.7
987
+
988
+ - Set itemEntry parent when generating a stub
989
+
990
+ ## v1.2.6
991
+
992
+ - Fix an issue introduced in v1.2.5.
993
+
994
+ ## v1.2.5
995
+
996
+ - When a local item cannot by found, return a newly created item in `getItemByState` (`ItemAdministrator`) only. This
997
+ solves an issue with refreshing on a local edit view.
998
+
999
+ ## v1.2.4
1000
+
1001
+ - **Breaking:** When a local item cannot by found, instead of a new item being created an error is thrown. This means it
1002
+ is no longer possible to create local items using `getItemById` or `getItemsById` in the `ItemAdministrator` class.
1003
+ - **Breaking:** Removed `getItemDefinition` and `getItemByDef` in the `ItemAdministrator` class. Added `getItemByState`.
1004
+ - Renamed types `TemplateResponseItemEntryMap` to `TemplateItemEntryMap` and `TemplateResponseLinkedItemEntryMap` to
1005
+ `TemplateLinkedItemEntryMap`.
1006
+ - Removed `getCollectionCacheKey` in `KeyService`. (Legacy code.)
1007
+
1008
+ ## v1.2.3
1009
+
1010
+ - Fixed issue where derived values deeper than one layer couldn't be resolved.
1011
+
1012
+ ## v1.2.2
1013
+
1014
+ - Fixed issue where in derived values weren't set after create request.
1015
+
1016
+ ## v1.2.1
1017
+
1018
+ - **Breaking:** Replaced the `initial` parameter with the `callOnChange` parameter (`true` by default) in the `commit`
1019
+ function of the `EditResource` class.
1020
+ - Fixed issue in `setLocalFields` (`ItemEntry`) where some values were wrongly assumed to be present in `initialValues`.
1021
+ - Optimization: Disabled automatic resolution of derived values in `addItems` (`CollectionEditResource`)
1022
+ when `modInstant` is set to true.
1023
+
1024
+ ## v1.2.0
1025
+
1026
+ - **Breaking:** When calling `addItems` or `addItem` on the `CollectionEditResource` class derived values are now
1027
+ resolved automatically. Instead of a compound object like `{fields: {key: 'value'}, derived: {}}` an object like
1028
+ `{key: 'value'}` should now be used as argument when calling these functions.
1029
+ - **Breaking:** Added `localCache` parameter to `CollectionResource` constructor.
1030
+
1031
+ ## v1.1.20
1032
+
1033
+ - Fixed minor issue where collection wouldn't be deferred properly before expanding.
1034
+ - `onChange` is now called automatically when when calling `commit` on an edit resource.
1035
+
1036
+ ## v1.1.19
1037
+
1038
+ - **Breaking:** Renamed `getCurrentChanges` to `getModuleChanges` in the `ItemAdministrator` class. Added optional
1039
+ `localCache` parameter.
1040
+
1041
+ ### Local cache callback refactoring
1042
+
1043
+ - Removed `onSaveWithoutClosing` event.
1044
+ - Added `condition` parameter to `onBeforeSave` and `onSaveSuccess` (possible values are `always`, `onClose` or
1045
+ `skipOnClose`, defaults to `always`). Callbacks registered with `condition: always` will get executed before other
1046
+ callbacks.
1047
+ - Pass the local cache itself to all registered callback functions. Pass the item ID conversion map as second argument
1048
+ to `onSaveSuccess` callback functions.
1049
+
1050
+ ## v1.1.18
1051
+
1052
+ - Calling `expand` on a `CollectionEntry` manually no longer defers the collection entry.
1053
+ - The `batchFetch` and `batchExpand` functions in the `CollectionHandler` class now properly defer and resolve the
1054
+ collection entries.
1055
+
1056
+ ## v1.1.17
1057
+
1058
+ - Fixed issue where the `getLocalByQuery` function in the `ItemCache` class wouldn't return any items.
1059
+ - When batch resolving collection entries, `CollectionHandler` now looks for matching items using `getByQuery` instead
1060
+ of `getByParent`.
1061
+
1062
+ ### Cache invalidation
1063
+
1064
+ - Added `queueReload` function to `ItemEntry` class. This will reload the item when the item entry itself or a
1065
+ collection entry containing the item is requested.
1066
+ - The `queueReload` function in the `CollectionEntry` class no longer directly defers the item.
1067
+ - Added `invalidateCache` function to the `ItemAdministrator` class. This will call `queueReload` on all item entries
1068
+ and collection entries.
1069
+
1070
+ ### Item entry refactoring
1071
+
1072
+ - Renamed `process` to `setFields`.
1073
+ - Replaced `processLocal` with `setLocalFields`. This function no longer has a `modified` parameter.
1074
+ - `setModified` now also sets local default values.
1075
+ - Removed `setCreator`. This function was called twice in some instances.
1076
+ - **Breaking:** Added `derived` parameter to `updateFields`
1077
+
1078
+ ## v1.16
1079
+
1080
+ - Pass `hasChanges` as second argument to `onBeforeSave` callbacks in the `LocalCache` class. This fixes an issue with
1081
+ project financial values in the front-end. [RM4-9577]
1082
+ - Added `callOnActivate` parameter to `addItems` function in `CollectionEditResource` class. Use this to prevent items
1083
+ from being added to the local cache.
1084
+
1085
+ ## v1.15
1086
+
1087
+ - Fix `fetchItemTypesTranslations` function in `ColumnHandler` class.
1088
+ - Fix type definition of `PromiseInterface.all`.
1089
+
1090
+ ## v1.14
1091
+
1092
+ - The `ChangesCompiler` now always processes local collections. (Even if they don't have edit resources.) This fixes an
1093
+ issue with recurring appointments in the front-end.
1094
+
1095
+ ## v1.13
1096
+
1097
+ - Add option to exclude itemTypes during createLocalEntries.
1098
+
1099
+ ## v1.12
1100
+
1101
+ - **Breaking:** `ItemResource.isNew` returns true *only* if the resource was created using
1102
+ `ItemAdministrator.getNewResource` or `ItemAdministrator.getItemByDef`. This fixes an issue where items where removed
1103
+ from the local cache inadvertently.
1104
+ - The `start`, `commit` and `rollback` functions of `EditResource` now return the resource itself to facilitate
1105
+ chaining.
1106
+ - When calling `CollectionEntry.revertChanges`, callbacks like `onAdd` / `onRemove` and `onActivate` / `onDeactivate`
1107
+ are now respected. This fixes an issue where items where *not* removed from the local cache.
1108
+ - When removing *local* items from collections, they are removed from `initial` as well as `modified`. This fixes an
1109
+ issue where changes were being detected continuously.
1110
+ - Updated the order of requests in `changesProcessor`. The `update` request is now executed before the `delete` request,
1111
+ except when updating documents. This fixes several issues.
1112
+ - `CollectionCache` now uses a map instead of an array to store collections. This fixes an issue where the same
1113
+ collection was added multiple times.
1114
+ - Updated all models to use dependency objects. This increases ease of debugging.
1115
+
1116
+ ## v.1.11
1117
+
1118
+ - Fixed issue that occurs when saving when having an existing item refer to a newly created item.
1119
+ - **Breaking:** Removed `ItemResourceService.isNewResource`.
1120
+ - **Breaking:** Renamed `ItemResource.isNewResource` to `ItemResource.isNew`. Removed parameter.
1121
+ - `ItemResource.isNew` is equivalent to `ItemResource.isLocal`, while `EditResource.isNew` checks also checks for
1122
+ completed transactions.
1123
+
1124
+ ## v.1.10
1125
+
1126
+ - Fixed issue where changes on different subtabs were not detected.
1127
+
1128
+ ## v1.1.9
1129
+
1130
+ - Exposed `noop` function on `RmCore` class.
1131
+
1132
+ > This is used in order to check whether a callback has a default value.
1133
+
1134
+ - Added `copyRequestColumns` function to `ColumnUtil` class.
1135
+ - Made parameters of `ItemAdministrator.saveCurrentLocalCache` and `LocalCache.save` optional.
1136
+ - **Breaking:** Reordered parameters of `ChangesProcessor.execute` to be consistent with
1137
+ `ItemAdministrator.saveCurrentLocalCache`. The new order is `singleItems` - `collections` - `parameters` -
1138
+ `breakUpByParent` - `onAfterCreateCallback`.
1139
+
1140
+ ## v1.1.8
1141
+
1142
+ - Set default value for `params` to `{filter: false}` in `request` function in `ColumnHandler` class.
1143
+
1144
+ ## v1.1.7
1145
+
1146
+ - Fixed issue where cached item entries or collection entries wouldn't be added to the local cache.
1147
+
1148
+ ## v1.1.6
1149
+
1150
+ - Fixed issue with deferred item entries.
1151
+ - Re-enable changes watcher after save.
1152
+ - Added optional `id` parameter to `LocalCache` constructor.
1153
+
1154
+ ## v1.1.5
1155
+
1156
+ - Added `clearItem` function to `LocalCache` class.
1157
+
1158
+ ## v.1.1.4
1159
+
1160
+ - Fix issue where items where not added to the local cache automatically when they where added to a collection.
1161
+
1162
+ > This depends on the `callOnActivate` parameter. I've added this mainly because extending collections should *not* add the items to the local cache.
1163
+ > In other instances this might be debatable because it doesn't do any real harm. *Not*
1164
+ doing it however can definitely be harmful.
1165
+
1166
+ ## v.1.1.3
1167
+
1168
+ - Fixed an issue where all collections in a local cache would be cleared.
1169
+ - **Breaking:** Renamed `getCacheManager` to `getCurrentLocalCache` and `setCacheManager` to `setCurrentLocalCache` in
1170
+ `LocalCacheManagerInterface`.
1171
+
1172
+ ## v1.1.2
1173
+
1174
+ - Fixed an issue concerning derived values.
1175
+
1176
+ ## v1.1.1
1177
+
1178
+ - Fixed an issue where changes wouldn't be detected.
1179
+ - **Breaking:** Removed the `_hasChanges` function in the `localCache` class. If you want to force changes detection,
1180
+ call `detectChanges` instead. Otherwise, rely on the `hasChanges` variable.
1181
+ - **Breaking:** Removed the `enableWatcher` and `disableWatcher` functions. Use `enableChangesWatcher` and
1182
+ `disableChangesWatcher` instead.
1183
+
1184
+ ## v1.1.0
1185
+
1186
+ ### Development
1187
+
1188
+ #### Strict TypeScript compilation
1189
+
1190
+ Added the following TypeScript compiler options:
1191
+
1192
+ - noImplicitThis
1193
+ - noImplicitReturns
1194
+ - strictNullChecks
1195
+ - noUnusedLocals
1196
+ - noUnusedParameters
1197
+
1198
+ I would advise enabling these for all TypeScript projects from now on.
1199
+
1200
+ #### Ordered imports and dependencies
1201
+
1202
+ Imports are now ordered alphabetically and grouped by folder. Added a TSLint option to enforce this. Please note that
1203
+ this also applies for imports from the folder the file is currently in. For example, in `models/ItemResource.ts`
1204
+ , `itemEntry` should be imported like so:
1205
+ `import { ItemEntry } from '../models';`
1206
+
1207
+ Also, factory and class dependencies should be ordered alphabetically as well. This will make it easier to add and
1208
+ remove dependencies in the future.
1209
+
1210
+ ### Breaking changes
1211
+
1212
+ - Renamed `changesCompiler` to `changesCompilation`, `changesCompilerFactory` to `changesCompilationFactory`,
1213
+ `moduleChangesCompiler` to `moduleChangesCompilation` and `moduleChangesCompilerFactory` to
1214
+ `moduleChangesCompilationFactory`.
1215
+ - Removed the `allLinks` parameter from the `query` function definition in the `ApiRequestServiceInterface`. This is no
1216
+ longer supported in the back-end.
1217
+
1218
+ #### Item and collection entries
1219
+
1220
+ - Moved *all* functions that handle item entries from the `ItemEntryService` to the `ItemEntry` class.
1221
+ - Added the following functions to `ItemEntryService`:
1222
+ - `createLocalConversionMap`;
1223
+ - `expandLocalConversionMap`;
1224
+ - `expandConversionMap`;
1225
+ - `batchExpandConversionMap`;
1226
+ - `batchClone`.
1227
+ - Cloning of item entries now works slightly differently. The function will attempt to generate a new item ID, and
1228
+ update the conversion map accordingly, but will respect the item ID that is already there.
1229
+
1230
+ #### Rework item caching
1231
+
1232
+ Newly created item entries and collection entries are no longer added to the global *or* local cache by default. All
1233
+ entries are added to the global cache on save. Item entries are added to the local cache when resources are created
1234
+ using the item administrator or when resources are created when adding the items to a collection.
1235
+
1236
+ > This will increase reliability by ensuring the global cache is no longer 'polluted' with local items. Also, this will
1237
+ > allow for the creation item and collection entries without caching them directly. This is required for the copying and
1238
+ > pasting of items.
1239
+
1240
+ Other changes:
1241
+
1242
+ - Moved `saveLocal` to `ItemAdministrator`;
1243
+ - `ItemAdministrator.fetchTitle` should now be called instead of `ItemHandler.fetchTitle`;
1244
+ - The `ItemAdministrator` collection matching functions (`addToCollections`, `removeFromCollections`) should now be
1245
+ called instead of those in the `CollectionHandler`. The `CollectionHandler` should only be used to reflect changes
1246
+ already on the backend. (Use `getCollectionMatcher`.)
1247
+
1248
+ ## v1.0.33
1249
+
1250
+ - Really fix types path
1251
+
1252
+ ## v1.0.33
1253
+
1254
+ - Fix types path
1255
+
1256
+ ## v1.0.32
1257
+
1258
+ - Update `tsconfig.json` to put definitions in the root folder
1259
+
1260
+ > The app had an issue with AOT compilation because of this
1261
+
1262
+ ## v1.0.31
1263
+
1264
+ - Fix `columnHandler.fetchItemTypeTranslations`
1265
+
1266
+ > It incorrectly looped over the response map, it should now work again
1267
+
1268
+ ## v1.0.30
1269
+
1270
+ - Remove `updateTabParams` from LocalCacheManagerInterface
1271
+
1272
+ > The function wasn't used
1273
+
1274
+ - Reworked class export
1275
+
1276
+ > Imports are now done from @rentman/rm-core, old imports are broken. This is because the old export structure didn't always work
1277
+
1278
+ ## v1.0.29
1279
+
1280
+ - Fix inverted inArray check in CollectionEntry.removeItems
1281
+
1282
+ > A delete message from the socket deleted all BUT the deleted items, this should now be fixed
1283
+
1284
+ ## v1.0.28
1285
+
1286
+ Bug fixes only
1287
+
1288
+ ## v1.0.27
1289
+
1290
+ - `ItemEntry.initial` is now undefined by default
1291
+
1292
+ > In the SocketMessageHandler we use this check to see if an ItemEntry is a stub
1293
+
1294
+ ## v1.0.26
1295
+
1296
+ Bundle both minified and unminified code, include sourcemaps from dev build
1297
+
1298
+ ## v1.0.24, v1.0.25
1299
+
1300
+ ! Use version `v1.0.26` !
1301
+
1302
+ - The core now expects a `promiseInterface` that should implement the provided `promiseInterface`
1303
+
1304
+ > We need to be able to hook into the promises in order to call a digest cycle to update the ui in the frontend
1305
+
1306
+ - Rename `ItemEntry.entryId` to `ItemEntry.id
1307
+
1308
+ > It used to be called `id`, but it was changed in the seperation of the core.
1309
+ > You can use the `id` to uniquely identify an entry, since itemId can be updated (local to saved id)
1310
+
1311
+ - Rename ItemResource `startTransaction` to `start`
1312
+
1313
+ > Other functions are called `commit` and `rollback` so having 'transaction' only for start doesn't make much sense
1314
+
1315
+ - `SocketMessageHandler.onMessageReceived` now returns a promise
1316
+
1317
+ > You can now use the updated items or hook into the result to update the ui for example
1318
+
1319
+ ## v1.0.23
1320
+
1321
+ - Rename ResourceCache to LocalCache
1322
+
1323
+ > LocalCache only caches local items (name better reflects functionality)
1324
+
1325
+ - Remove getter/setter for hasChanges
1326
+
1327
+ > hasChanges is called in a digest loop in the frontend, so for performance reasons we don't want to recompute the value every time
1328
+
1329
+ - Remove `_getCollection` from ItemAdministrator
1330
+
1331
+ > `_getCollection` is now named `getCollection` and the old `getCollection` is removed. The query is part of the
1332
+ > options and should not be given as a separate argument. This was included to support the frontend
1333
+
1334
+ - Remove `saveCurrentTab` from ItemAdministrator
1335
+
1336
+ > `saveCurrentTab` makes no sense because the core has no concept of tabs, you should use `saveCurrentLocalCache` instead
1337
+
1338
+ - Remove `getTabEntry` and `resetTabEntry` from ItemAdministrator
1339
+
1340
+ > `getTabEntry` and `resetTabEntry` make no sense because the core has no concept of tabs, you should use `getLocalCache` and `resetLocalCache` instead
1341
+