@epam/uui-db 5.3.0-rc.0 → 5.3.0

package/benchmark/results/query-100000.json

@@ -0,0 +1,63 @@
+{
+  "name": "Find N entities in 100000 dataset by departmentId, sorted by name",
+  "date": "2020-06-10T00:31:03.956Z",
+  "version": "1.0.0",
+  "results": [
+    {
+      "name": "Array - scan",
+      "ops": 1830,
+      "margin": 4.74,
+      "percentSlower": 99.91
+    },
+    {
+      "name": "Array - with filterPredicate/orderComparer",
+      "ops": 668,
+      "margin": 3.19,
+      "percentSlower": 99.97
+    },
+    {
+      "name": "BTree - toArray/scan",
+      "ops": 183,
+      "margin": 5.36,
+      "percentSlower": 99.99
+    },
+    {
+      "name": "I.Map - iterable.filter.sort, then toArray",
+      "ops": 50,
+      "margin": 2.33,
+      "percentSlower": 100
+    },
+    {
+      "name": "I.Map - toArray, then filter/sort",
+      "ops": 36,
+      "margin": 14.94,
+      "percentSlower": 100
+    },
+    {
+      "name": "IxSet - with indexes",
+      "ops": 76943,
+      "margin": 7.77,
+      "percentSlower": 96.16
+    },
+    {
+      "name": "IxSet - no indexes",
+      "ops": 135,
+      "margin": 8.63,
+      "percentSlower": 99.99
+    },
+    {
+      "name": "DbTable - with index",
+      "ops": 2003311,
+      "margin": 4.35,
+      "percentSlower": 0
+    }
+  ],
+  "fastest": {
+    "name": "DbTable - with index",
+    "index": 7
+  },
+  "slowest": {
+    "name": "I.Map - toArray, then filter/sort",
+    "index": 4
+  }
+}

package/benchmark/results/sorting.json

@@ -0,0 +1,33 @@
+{
+  "name": "Sort array",
+  "date": "2020-04-27T23:07:24.758Z",
+  "version": "1.0.0",
+  "results": [
+    {
+      "name": "array.sort, hard-coded",
+      "ops": 2645,
+      "margin": 2.18,
+      "percentSlower": 0
+    },
+    {
+      "name": "_.sort, hard-coded",
+      "ops": 464,
+      "margin": 1.96,
+      "percentSlower": 82.46
+    },
+    {
+      "name": "array.sort, getOrderComparer",
+      "ops": 1939,
+      "margin": 0.47,
+      "percentSlower": 26.69
+    }
+  ],
+  "fastest": {
+    "name": "array.sort, hard-coded",
+    "index": 0
+  },
+  "slowest": {
+    "name": "_.sort, hard-coded",
+    "index": 1
+  }
+}

package/build/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@epam/uui-db",
+  "version": "5.3.0",
+  "description": "UUI - client-side relational state cache",
+  "author": "EPAM",
+  "license": "MIT",
+  "module": "index.esm.js",
+  "main": "index.js",
+  "typings": "index.d.ts",
+  "scripts": {
+    "build": "node ../uui-build/scripts/buildModule",
+    "perf": "npx ts-node -T ./src/__benchmarks__/index.ts",
+    "perf-prof": "node -r ts-node/register/transpile-only --prof ./src/__benchmarks__/index.ts",
+    "prepublish": "yarn build"
+  },
+  "dependencies": {
+    "@epam/uui-core": "5.3.0",
+    "@types/lodash.countby": "4.6.6",
+    "@types/lodash.filter": "4.6.6",
+    "@types/lodash.foreach": "4.5.6",
+    "@types/lodash.groupby": "4.6.6",
+    "@types/lodash.isempty": "4.4.6",
+    "@types/lodash.isequal": "4.5.5",
+    "@types/lodash.map": "4.6.13",
+    "@types/lodash.merge": "4.6.6",
+    "@types/lodash.orderby": "4.6.6",
+    "@types/lodash.pick": "4.4.6",
+    "@types/lodash.range": "3.2.6",
+    "@types/lodash.sortby": "4.7.6",
+    "@types/lodash.transform": "4.6.6",
+    "@types/lodash.zip": "4.2.6",
+    "@types/shallowequal": "^1.1.1",
+    "immutable": "3.8.2",
+    "lodash.countby": "4.6.0",
+    "lodash.filter": "4.6.0",
+    "lodash.foreach": "4.5.0",
+    "lodash.groupby": "4.6.0",
+    "lodash.isempty": "4.4.0",
+    "lodash.isequal": "4.5.0",
+    "lodash.map": "4.6.0",
+    "lodash.merge": "4.6.2",
+    "lodash.orderby": "4.6.0",
+    "lodash.pick": "4.4.0",
+    "lodash.range": "3.2.0",
+    "lodash.sortby": "4.7.0",
+    "lodash.transform": "4.6.0",
+    "lodash.zip": "4.2.0",
+    "shallowequal": "^1.1.0",
+    "sorted-btree": "^1.2.1"
+  },
+  "devDependencies": {
+    "@types/benchmark": "^1.0.31",
+    "benny": "^3.6.14",
+    "ts-node": "10.9.1"
+  },
+  "peerDependencies": {
+    "prop-types": "*",
+    "react": ">=16.0.0",
+    "react-dom": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/epam/UUI"
+  },
+  "gitHead": "e5bbda766f5bdfd7c42a3c62c34afd9c03fffedd",
+  "publishConfig": {
+    "directory": "build"
+  }
+}

package/build/readme.md

@@ -0,0 +1,17 @@
+# UUI DB package
+
+This package is a part of [EPAM UUI](https://github.com/epam/UUI) library.
+
+@epam/uui-db is an experimental state-management solution. It maintains immutable relational database on client, provides means to load data from server, update it both from client, and save it to server asynchronously with UI operations.
+
+## Features
+
+- relation data model for state, providing a normalized storage for UI state
+- data loading from server, with automatic GraphQL response normalization into tables
+- synchronous and transactional updates of state from UI
+- asynchronous bi-directional state synchronization between UI and server. UI changes in terms of 'patches' are batched and sent to server. Server can also push updates to UI state
+- GIT-like branch-rebase approach to handle state concurrency
+- tables can be indexed to speed-up queries
+- Views to build arbitrary state projections
+- subscriptions to subscribe parts of UI to changes in Views
+

package/{stats.html → build/stats.html}

@@ -4818,7 +4818,7 @@ var drawChart = (function (exports) {
   </script>
   <script>
     /*<!--*/
-    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.esm.js","children":[{"name":"build/rollup:/@epam/uui-db","children":[{"name":"src","children":[{"uid":"416a-54","name":"types.ts"},{"uid":"416a-56","name":"utils.ts"},{"uid":"416a-58","name":"Db.ts"},{"uid":"416a-62","name":"DbTable.ts"},{"uid":"416a-64","name":"patchHelpers.ts"},{"uid":"416a-66","name":"tempIds.tsx"},{"uid":"416a-68","name":"Loader.ts"},{"uid":"416a-70","name":"SimpleLoadingTracker.ts"},{"uid":"416a-72","name":"ListLoadingTracker.ts"},{"uid":"416a-74","name":"DbRef.ts"},{"uid":"416a-76","name":"reactHooks.ts"}]},{"name":"node_modules/tslib/tslib.es6.js","uid":"416a-60"}]}]}],"isRoot":true},"nodeParts":{"416a-54":{"renderedLength":232,"gzipLength":0,"brotliLength":0,"metaUid":"416a-53"},"416a-56":{"renderedLength":777,"gzipLength":0,"brotliLength":0,"metaUid":"416a-55"},"416a-58":{"renderedLength":2104,"gzipLength":0,"brotliLength":0,"metaUid":"416a-57"},"416a-60":{"renderedLength":2229,"gzipLength":0,"brotliLength":0,"metaUid":"416a-59"},"416a-62":{"renderedLength":6566,"gzipLength":0,"brotliLength":0,"metaUid":"416a-61"},"416a-64":{"renderedLength":6098,"gzipLength":0,"brotliLength":0,"metaUid":"416a-63"},"416a-66":{"renderedLength":6249,"gzipLength":0,"brotliLength":0,"metaUid":"416a-65"},"416a-68":{"renderedLength":2277,"gzipLength":0,"brotliLength":0,"metaUid":"416a-67"},"416a-70":{"renderedLength":291,"gzipLength":0,"brotliLength":0,"metaUid":"416a-69"},"416a-72":{"renderedLength":2894,"gzipLength":0,"brotliLength":0,"metaUid":"416a-71"},"416a-74":{"renderedLength":5956,"gzipLength":0,"brotliLength":0,"metaUid":"416a-73"},"416a-76":{"renderedLength":442,"gzipLength":0,"brotliLength":0,"metaUid":"416a-75"}},"nodeMetas":{"416a-53":{"id":"/build/rollup:/@epam/uui-db/src/types.ts","moduleParts":{"index.esm.js":"416a-54"},"imported":[],"importedBy":[]},"416a-55":{"id":"/build/rollup:/@epam/uui-db/src/utils.ts","moduleParts":{"index.esm.js":"416a-56"},"imported":[],"importedBy":[]},"416a-57":{"id":"/build/rollup:/@epam/uui-db/src/Db.ts","moduleParts":{"index.esm.js":"416a-58"},"imported":[],"importedBy":[]},"416a-59":{"id":"/build/rollup:/@epam/uui-db/node_modules/tslib/tslib.es6.js","moduleParts":{"index.esm.js":"416a-60"},"imported":[],"importedBy":[]},"416a-61":{"id":"/build/rollup:/@epam/uui-db/src/DbTable.ts","moduleParts":{"index.esm.js":"416a-62"},"imported":[],"importedBy":[]},"416a-63":{"id":"/build/rollup:/@epam/uui-db/src/patchHelpers.ts","moduleParts":{"index.esm.js":"416a-64"},"imported":[],"importedBy":[]},"416a-65":{"id":"/build/rollup:/@epam/uui-db/src/tempIds.tsx","moduleParts":{"index.esm.js":"416a-66"},"imported":[],"importedBy":[]},"416a-67":{"id":"/build/rollup:/@epam/uui-db/src/Loader.ts","moduleParts":{"index.esm.js":"416a-68"},"imported":[],"importedBy":[]},"416a-69":{"id":"/build/rollup:/@epam/uui-db/src/SimpleLoadingTracker.ts","moduleParts":{"index.esm.js":"416a-70"},"imported":[],"importedBy":[]},"416a-71":{"id":"/build/rollup:/@epam/uui-db/src/ListLoadingTracker.ts","moduleParts":{"index.esm.js":"416a-72"},"imported":[],"importedBy":[]},"416a-73":{"id":"/build/rollup:/@epam/uui-db/src/DbRef.ts","moduleParts":{"index.esm.js":"416a-74"},"imported":[],"importedBy":[]},"416a-75":{"id":"/build/rollup:/@epam/uui-db/src/reactHooks.ts","moduleParts":{"index.esm.js":"416a-76"},"imported":[],"importedBy":[]},"416a-77":{"id":"/index.tsx","moduleParts":{},"imported":[{"uid":"416a-78"}],"importedBy":[],"isEntry":true},"416a-78":{"id":"/src/index.ts","moduleParts":{},"imported":[{"uid":"416a-79"},{"uid":"416a-80"},{"uid":"416a-81"},{"uid":"416a-82"},{"uid":"416a-83"},{"uid":"416a-84"},{"uid":"416a-85"},{"uid":"416a-86"}],"importedBy":[{"uid":"416a-77"}]},"416a-79":{"id":"/src/types.ts","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-78"},{"uid":"416a-85"}]},"416a-80":{"id":"/src/Db.ts","moduleParts":{},"imported":[{"uid":"416a-84"},{"uid":"416a-87"}],"importedBy":[{"uid":"416a-78"}]},"416a-81":{"id":"/src/DbTable.ts","moduleParts":{},"imported":[{"uid":"416a-88"},{"uid":"416a-89"},{"uid":"416a-90"}],"importedBy":[{"uid":"416a-78"}]},"416a-82":{"id":"/src/DbRef.ts","moduleParts":{},"imported":[{"uid":"416a-88"},{"uid":"416a-85"},{"uid":"416a-83"},{"uid":"416a-84"},{"uid":"416a-91"},{"uid":"416a-92"},{"uid":"416a-90"},{"uid":"416a-93"},{"uid":"416a-94"}],"importedBy":[{"uid":"416a-78"}]},"416a-83":{"id":"/src/tempIds.tsx","moduleParts":{},"imported":[{"uid":"416a-84"}],"importedBy":[{"uid":"416a-78"},{"uid":"416a-82"}]},"416a-84":{"id":"/src/utils.ts","moduleParts":{},"imported":[{"uid":"416a-95"},{"uid":"416a-96"},{"uid":"416a-97"},{"uid":"416a-87"}],"importedBy":[{"uid":"416a-78"},{"uid":"416a-80"},{"uid":"416a-82"},{"uid":"416a-83"},{"uid":"416a-85"}]},"416a-85":{"id":"/src/patchHelpers.ts","moduleParts":{},"imported":[{"uid":"416a-79"},{"uid":"416a-89"},{"uid":"416a-84"},{"uid":"416a-98"},{"uid":"416a-99"},{"uid":"416a-100"},{"uid":"416a-101"},{"uid":"416a-102"},{"uid":"416a-103"},{"uid":"416a-104"}],"importedBy":[{"uid":"416a-78"},{"uid":"416a-82"}]},"416a-86":{"id":"/src/reactHooks.ts","moduleParts":{},"imported":[{"uid":"416a-105"}],"importedBy":[{"uid":"416a-78"}]},"416a-87":{"id":"lodash.isequal","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-80"},{"uid":"416a-84"}],"isExternal":true},"416a-88":{"id":"/Users/Aliaksei_Manetau/WebstormProjects/uui/node_modules/tslib/tslib.es6.js","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-81"},{"uid":"416a-82"},{"uid":"416a-94"}]},"416a-89":{"id":"immutable","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-81"},{"uid":"416a-85"}],"isExternal":true},"416a-90":{"id":"@epam/uui-core","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-81"},{"uid":"416a-82"}],"isExternal":true},"416a-91":{"id":"lodash.isempty","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-82"}],"isExternal":true},"416a-92":{"id":"/src/Loader.ts","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-82"}]},"416a-93":{"id":"/src/SimpleLoadingTracker.ts","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-82"}]},"416a-94":{"id":"/src/ListLoadingTracker.ts","moduleParts":{},"imported":[{"uid":"416a-88"}],"importedBy":[{"uid":"416a-82"}]},"416a-95":{"id":"shallowequal","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-84"}],"isExternal":true},"416a-96":{"id":"lodash.zip","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-84"}],"isExternal":true},"416a-97":{"id":"lodash.transform","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-84"}],"isExternal":true},"416a-98":{"id":"lodash.groupby","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-85"}],"isExternal":true},"416a-99":{"id":"lodash.map","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-85"}],"isExternal":true},"416a-100":{"id":"lodash.merge","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-85"}],"isExternal":true},"416a-101":{"id":"lodash.countby","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-85"}],"isExternal":true},"416a-102":{"id":"lodash.filter","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-85"}],"isExternal":true},"416a-103":{"id":"lodash.foreach","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-85"}],"isExternal":true},"416a-104":{"id":"lodash.pick","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-85"}],"isExternal":true},"416a-105":{"id":"react","moduleParts":{},"imported":[],"importedBy":[{"uid":"416a-86"}],"isExternal":true}},"env":{"rollup":"3.26.2"},"options":{"gzip":false,"brotli":false,"sourcemap":true}};
+    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.esm.js","children":[{"name":"build/rollup:/@epam/uui-db","children":[{"name":"src","children":[{"uid":"d5ef-54","name":"types.ts"},{"uid":"d5ef-56","name":"utils.ts"},{"uid":"d5ef-58","name":"Db.ts"},{"uid":"d5ef-62","name":"DbTable.ts"},{"uid":"d5ef-64","name":"patchHelpers.ts"},{"uid":"d5ef-66","name":"tempIds.tsx"},{"uid":"d5ef-68","name":"Loader.ts"},{"uid":"d5ef-70","name":"SimpleLoadingTracker.ts"},{"uid":"d5ef-72","name":"ListLoadingTracker.ts"},{"uid":"d5ef-74","name":"DbRef.ts"},{"uid":"d5ef-76","name":"reactHooks.ts"}]},{"name":"node_modules/tslib/tslib.es6.js","uid":"d5ef-60"}]}]}],"isRoot":true},"nodeParts":{"d5ef-54":{"renderedLength":232,"gzipLength":0,"brotliLength":0,"metaUid":"d5ef-53"},"d5ef-56":{"renderedLength":777,"gzipLength":0,"brotliLength":0,"metaUid":"d5ef-55"},"d5ef-58":{"renderedLength":2104,"gzipLength":0,"brotliLength":0,"metaUid":"d5ef-57"},"d5ef-60":{"renderedLength":2229,"gzipLength":0,"brotliLength":0,"metaUid":"d5ef-59"},"d5ef-62":{"renderedLength":6566,"gzipLength":0,"brotliLength":0,"metaUid":"d5ef-61"},"d5ef-64":{"renderedLength":6098,"gzipLength":0,"brotliLength":0,"metaUid":"d5ef-63"},"d5ef-66":{"renderedLength":6249,"gzipLength":0,"brotliLength":0,"metaUid":"d5ef-65"},"d5ef-68":{"renderedLength":2277,"gzipLength":0,"brotliLength":0,"metaUid":"d5ef-67"},"d5ef-70":{"renderedLength":291,"gzipLength":0,"brotliLength":0,"metaUid":"d5ef-69"},"d5ef-72":{"renderedLength":2894,"gzipLength":0,"brotliLength":0,"metaUid":"d5ef-71"},"d5ef-74":{"renderedLength":5956,"gzipLength":0,"brotliLength":0,"metaUid":"d5ef-73"},"d5ef-76":{"renderedLength":442,"gzipLength":0,"brotliLength":0,"metaUid":"d5ef-75"}},"nodeMetas":{"d5ef-53":{"id":"/build/rollup:/@epam/uui-db/src/types.ts","moduleParts":{"index.esm.js":"d5ef-54"},"imported":[],"importedBy":[]},"d5ef-55":{"id":"/build/rollup:/@epam/uui-db/src/utils.ts","moduleParts":{"index.esm.js":"d5ef-56"},"imported":[],"importedBy":[]},"d5ef-57":{"id":"/build/rollup:/@epam/uui-db/src/Db.ts","moduleParts":{"index.esm.js":"d5ef-58"},"imported":[],"importedBy":[]},"d5ef-59":{"id":"/build/rollup:/@epam/uui-db/node_modules/tslib/tslib.es6.js","moduleParts":{"index.esm.js":"d5ef-60"},"imported":[],"importedBy":[]},"d5ef-61":{"id":"/build/rollup:/@epam/uui-db/src/DbTable.ts","moduleParts":{"index.esm.js":"d5ef-62"},"imported":[],"importedBy":[]},"d5ef-63":{"id":"/build/rollup:/@epam/uui-db/src/patchHelpers.ts","moduleParts":{"index.esm.js":"d5ef-64"},"imported":[],"importedBy":[]},"d5ef-65":{"id":"/build/rollup:/@epam/uui-db/src/tempIds.tsx","moduleParts":{"index.esm.js":"d5ef-66"},"imported":[],"importedBy":[]},"d5ef-67":{"id":"/build/rollup:/@epam/uui-db/src/Loader.ts","moduleParts":{"index.esm.js":"d5ef-68"},"imported":[],"importedBy":[]},"d5ef-69":{"id":"/build/rollup:/@epam/uui-db/src/SimpleLoadingTracker.ts","moduleParts":{"index.esm.js":"d5ef-70"},"imported":[],"importedBy":[]},"d5ef-71":{"id":"/build/rollup:/@epam/uui-db/src/ListLoadingTracker.ts","moduleParts":{"index.esm.js":"d5ef-72"},"imported":[],"importedBy":[]},"d5ef-73":{"id":"/build/rollup:/@epam/uui-db/src/DbRef.ts","moduleParts":{"index.esm.js":"d5ef-74"},"imported":[],"importedBy":[]},"d5ef-75":{"id":"/build/rollup:/@epam/uui-db/src/reactHooks.ts","moduleParts":{"index.esm.js":"d5ef-76"},"imported":[],"importedBy":[]},"d5ef-77":{"id":"/index.tsx","moduleParts":{},"imported":[{"uid":"d5ef-78"}],"importedBy":[],"isEntry":true},"d5ef-78":{"id":"/src/index.ts","moduleParts":{},"imported":[{"uid":"d5ef-79"},{"uid":"d5ef-80"},{"uid":"d5ef-81"},{"uid":"d5ef-82"},{"uid":"d5ef-83"},{"uid":"d5ef-84"},{"uid":"d5ef-85"},{"uid":"d5ef-86"}],"importedBy":[{"uid":"d5ef-77"}]},"d5ef-79":{"id":"/src/types.ts","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-78"},{"uid":"d5ef-85"}]},"d5ef-80":{"id":"/src/Db.ts","moduleParts":{},"imported":[{"uid":"d5ef-84"},{"uid":"d5ef-87"}],"importedBy":[{"uid":"d5ef-78"}]},"d5ef-81":{"id":"/src/DbTable.ts","moduleParts":{},"imported":[{"uid":"d5ef-88"},{"uid":"d5ef-89"},{"uid":"d5ef-90"}],"importedBy":[{"uid":"d5ef-78"}]},"d5ef-82":{"id":"/src/DbRef.ts","moduleParts":{},"imported":[{"uid":"d5ef-88"},{"uid":"d5ef-85"},{"uid":"d5ef-83"},{"uid":"d5ef-84"},{"uid":"d5ef-91"},{"uid":"d5ef-92"},{"uid":"d5ef-90"},{"uid":"d5ef-93"},{"uid":"d5ef-94"}],"importedBy":[{"uid":"d5ef-78"}]},"d5ef-83":{"id":"/src/tempIds.tsx","moduleParts":{},"imported":[{"uid":"d5ef-84"}],"importedBy":[{"uid":"d5ef-78"},{"uid":"d5ef-82"}]},"d5ef-84":{"id":"/src/utils.ts","moduleParts":{},"imported":[{"uid":"d5ef-95"},{"uid":"d5ef-96"},{"uid":"d5ef-97"},{"uid":"d5ef-87"}],"importedBy":[{"uid":"d5ef-78"},{"uid":"d5ef-80"},{"uid":"d5ef-82"},{"uid":"d5ef-83"},{"uid":"d5ef-85"}]},"d5ef-85":{"id":"/src/patchHelpers.ts","moduleParts":{},"imported":[{"uid":"d5ef-79"},{"uid":"d5ef-89"},{"uid":"d5ef-84"},{"uid":"d5ef-98"},{"uid":"d5ef-99"},{"uid":"d5ef-100"},{"uid":"d5ef-101"},{"uid":"d5ef-102"},{"uid":"d5ef-103"},{"uid":"d5ef-104"}],"importedBy":[{"uid":"d5ef-78"},{"uid":"d5ef-82"}]},"d5ef-86":{"id":"/src/reactHooks.ts","moduleParts":{},"imported":[{"uid":"d5ef-105"}],"importedBy":[{"uid":"d5ef-78"}]},"d5ef-87":{"id":"lodash.isequal","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-80"},{"uid":"d5ef-84"}],"isExternal":true},"d5ef-88":{"id":"/Users/Aliaksei_Manetau/WebstormProjects/UUI_new/node_modules/tslib/tslib.es6.js","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-81"},{"uid":"d5ef-82"},{"uid":"d5ef-94"}]},"d5ef-89":{"id":"immutable","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-81"},{"uid":"d5ef-85"}],"isExternal":true},"d5ef-90":{"id":"@epam/uui-core","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-81"},{"uid":"d5ef-82"}],"isExternal":true},"d5ef-91":{"id":"lodash.isempty","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-82"}],"isExternal":true},"d5ef-92":{"id":"/src/Loader.ts","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-82"}]},"d5ef-93":{"id":"/src/SimpleLoadingTracker.ts","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-82"}]},"d5ef-94":{"id":"/src/ListLoadingTracker.ts","moduleParts":{},"imported":[{"uid":"d5ef-88"}],"importedBy":[{"uid":"d5ef-82"}]},"d5ef-95":{"id":"shallowequal","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-84"}],"isExternal":true},"d5ef-96":{"id":"lodash.zip","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-84"}],"isExternal":true},"d5ef-97":{"id":"lodash.transform","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-84"}],"isExternal":true},"d5ef-98":{"id":"lodash.groupby","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-85"}],"isExternal":true},"d5ef-99":{"id":"lodash.map","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-85"}],"isExternal":true},"d5ef-100":{"id":"lodash.merge","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-85"}],"isExternal":true},"d5ef-101":{"id":"lodash.countby","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-85"}],"isExternal":true},"d5ef-102":{"id":"lodash.filter","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-85"}],"isExternal":true},"d5ef-103":{"id":"lodash.foreach","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-85"}],"isExternal":true},"d5ef-104":{"id":"lodash.pick","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-85"}],"isExternal":true},"d5ef-105":{"id":"react","moduleParts":{},"imported":[],"importedBy":[{"uid":"d5ef-86"}],"isExternal":true}},"env":{"rollup":"3.26.2"},"options":{"gzip":false,"brotli":false,"sourcemap":true}};
 
     const run = () => {
       const width = window.innerWidth;

package/globals.d.ts

@@ -0,0 +1,9 @@
+/// <reference path="../uui_globals.d.ts" />
+
+declare module 'jsurl';
+declare module 'query-string';
+declare module 'draft-js-plugins-editor';
+declare module 'draft-js-clear-formatting';
+declare module 'draft-convert';
+declare module 'draft-js-plugins-utils';
+declare module 'draft-js/lib/*';

package/index.tsx

@@ -0,0 +1 @@
+export * from './src';

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@epam/uui-db",
-  "version": "5.3.0-rc.0",
+  "version": "5.3.0",
   "description": "UUI - client-side relational state cache",
   "author": "EPAM",
   "license": "MIT",
-  "module": "index.esm.js",
   "main": "index.js",
+  "epam:uui:main": "build/index.esm.js",
   "typings": "index.d.ts",
   "scripts": {
     "build": "node ../uui-build/scripts/buildModule",
@@ -14,7 +14,7 @@
     "prepublish": "yarn build"
   },
   "dependencies": {
-    "@epam/uui-core": "5.3.0-rc.0",
+    "@epam/uui-core": "5.3.0",
     "@types/lodash.countby": "4.6.6",
     "@types/lodash.filter": "4.6.6",
     "@types/lodash.foreach": "4.5.6",
@@ -66,4 +66,4 @@
   "publishConfig": {
     "directory": "build"
   }
-}
+}

package/src/Db.ts

@@ -0,0 +1,89 @@
+import {
+    DbPatch, DbTablesSet, DbTableEntityByTable, DbView, DbRelationType, ViewCacheItem,
+} from './types';
+import { objectKeys, defaultCompareViewDependencies, difference } from './utils';
+import isEqual from 'lodash.isequal';
+
+type ViewCache = Map<DbView<any, any, any, any>, Map<string, ViewCacheItem>>;
+
+export abstract class Db<TTables extends DbTablesSet<TTables>> {
+    private viewCache: ViewCache = new Map();
+    constructor(public tables: TTables, reusedCache?: ViewCache) {
+        if (reusedCache) {
+            this.viewCache = new Map(reusedCache);
+        } else {
+            this.viewCache = new Map();
+        }
+    }
+
+    private update(mutate: (db: this) => void): this {
+        const clone = new (this.constructor as any)(this.tables, this.viewCache);
+        clone.tables = { ...this.tables };
+        mutate(clone);
+        return clone;
+    }
+
+    public with(patch: DbPatch<TTables>): this {
+        return this.update((db) => {
+            objectKeys(db.tables).forEach((entityName) => {
+                if (patch[entityName]) {
+                    db.tables[entityName] = db.tables[entityName].with(patch[entityName]);
+                }
+            });
+        });
+    }
+
+    /* Views (cached db projections) */
+
+    valueAbsent = Symbol('ValueAbsent');
+    public runView<TResult, TParams = void, TDependencies = void>(view: DbView<this, TResult, TParams, TDependencies>, params?: TParams) {
+        let cache = this.viewCache.get(view);
+
+        if (!cache) {
+            cache = new Map();
+            this.viewCache.set(view, cache);
+        }
+
+        const key = view.getKey ? view.getKey(params) : JSON.stringify(params);
+
+        let cacheItem: ViewCacheItem = cache.get(key);
+
+        if (!cacheItem) {
+            cacheItem = {
+                dependencies: this.valueAbsent,
+                currentValue: this.valueAbsent,
+                computedOnDb: this.valueAbsent,
+            };
+            cache.set(key, cacheItem);
+        }
+
+        let shouldUpdate = this !== cacheItem.computedOnDb;
+        let dependencies: any = this.valueAbsent;
+
+        if (view.getDependencies) {
+            const compare = view.compareDependencies || defaultCompareViewDependencies;
+            dependencies = view.getDependencies(this, params);
+            shouldUpdate = !compare(cacheItem.dependencies, dependencies);
+        }
+
+        const previousValue = cacheItem.currentValue;
+
+        if (shouldUpdate) {
+            cacheItem.dependencies = dependencies;
+            const newValue = view.compute(this, params, dependencies);
+            cacheItem.computedOnDb = this;
+
+            const compareResults = view.compareResults || isEqual;
+
+            if (!compareResults(previousValue, newValue)) {
+                if (view.traceDiff) {
+                    console.debug(difference(previousValue, newValue));
+                }
+
+                cacheItem.currentValue = newValue;
+            }
+        }
+
+        return cacheItem.currentValue as TResult;
+    }
+}

package/src/DbRef.ts

@@ -0,0 +1,254 @@
+import { Db } from './Db';
+import {
+    DbPatch, DbTablesSet, ServerError, DbSaveResponse, DbView, ViewCacheItem, DbSubscription, DbPkFieldType,
+} from './types';
+import {
+    makeCumulativePatch, unionPatches, mergeEntityPatches, flattenResponse,
+} from './patchHelpers';
+import { TempIdMap, IClientIdsMap } from './tempIds';
+import { objectKeys, defaultCompareViewDependencies, difference } from './utils';
+import isEmpty from 'lodash.isempty';
+import { Loader, LoaderOptions } from './Loader';
+import { DataQuery, LazyDataSourceApiResponse, batch } from '@epam/uui-core';
+import { SimpleLoadingTracker } from './SimpleLoadingTracker';
+import { ListLoadingTracker, ListLoadingTrackerOptions } from './ListLoadingTracker';
+
+export class DbRef<TTables extends DbTablesSet<TTables>, TDb extends Db<TTables>> {
+    private base: TDb;
+    private log: { patch: DbPatch<TTables> }[] = [];
+    private autoSave = true;
+    private savedPoint = 0;
+    private tempIdMap: TempIdMap<TTables>;
+    public db: TDb;
+    protected throttleSaveMs = 1000;
+    public readonly idMap: IClientIdsMap;
+    constructor(public blank: TDb) {
+        this.db = blank;
+        this.base = blank;
+        this.tempIdMap = new TempIdMap(blank);
+        this.idMap = this.tempIdMap;
+
+        window.addEventListener('beforeunload', this.handleBeforeUnload);
+    }
+
+    /** Saves all committed patches. Useful only if autoSave is off. */
+    public save() {
+        return this.enqueueSave();
+    }
+
+    public getAutoSave() {
+        return this.autoSave;
+    }
+
+    public setAutoSave(val: boolean) {
+        if (this.autoSave != val) {
+            this.autoSave = val;
+            this.autoSave && this.enqueueSave();
+            this.update();
+        }
+    }
+
+    public revert() {
+        this.db = this.base;
+        this.log = this.log.slice(0, this.savedPoint);
+        this.update();
+    }
+
+    /** Concrete DbRef instances should override and implement their save logic in this method */
+    protected savePatch(patch: DbPatch<TTables>): Promise<DbSaveResponse<TTables>> {
+        return Promise.resolve({ submit: {} });
+    }
+
+    /* Db Update logic */
+
+    public commit(patch: DbPatch<TTables>): void {
+        const dbBeforeUpdate = this.db.with(patch);
+        patch = this.beforeUpdate(patch, dbBeforeUpdate.tables, this.db.tables);
+        patch = mergeEntityPatches(this.db.tables, patch);
+        this.log.push({ patch });
+        this.db = this.db.with(patch);
+
+        this.autoSave && this.enqueueSave(null, { throttleMs: this.throttleSaveMs });
+        this.update();
+    }
+
+    private beforeUpdate(patch: DbPatch<TTables>, tables: TTables, prevTables: TTables): DbPatch<TTables> {
+        let patchAndDependencies: DbPatch<TTables> = {};
+
+        objectKeys(tables)
+            .filter((entityName) => patch[entityName] && !tables[entityName].schema.beforeUpdate)
+            .forEach((entityName) => {
+                patchAndDependencies[entityName] = patch[entityName];
+            });
+
+        objectKeys(tables)
+            .filter((entityName) => patch[entityName] && tables[entityName].schema.beforeUpdate)
+            .forEach((entityName) => {
+                const schema = tables[entityName].schema;
+                const { beforeUpdate } = schema;
+                const context = {
+                    clientIdsMap: this.tempIdMap,
+                    schema,
+                    tables,
+                    prevTables,
+                };
+
+                const results = patch[entityName].map((e) => beforeUpdate(e, context));
+                const updatedPatch = { [entityName]: results.map((result) => result.entity) } as DbPatch<TTables>;
+                const dependentEntityPatchesForUpdate = unionPatches(results.filter((result) => result.dependentEntities).map((result) => result.dependentEntities));
+                const dependentEntityPatches = this.beforeUpdate(dependentEntityPatchesForUpdate, tables, prevTables);
+
+                patchAndDependencies = mergeEntityPatches(tables, unionPatches([
+                    patchAndDependencies, updatedPatch, dependentEntityPatches,
+                ]));
+            });
+        return patchAndDependencies;
+    }
+
+    public commitFetch(patch: DbPatch<TTables>): void {
+        patch = this.tempIdMap.serverToClientPatch(patch);
+        this.rebase(this.base.with(patch));
+        this.update();
+    }
+
+    private rebase(newBase: TDb) {
+        this.base = newBase;
+        this.db = newBase;
+        for (let n = this.savedPoint; n < this.log.length; n++) {
+            this.db = this.db.with(this.log[n].patch);
+        }
+    }
+
+    private makeCumulativePatch() {
+        const lastLogEntry = this.log.length;
+        const logEntriesToSave = this.log.slice(this.savedPoint, lastLogEntry);
+        let cumulativePatch = makeCumulativePatch(
+            this.db,
+            logEntriesToSave.map((t) => t.patch),
+            this.tempIdMap,
+        );
+        cumulativePatch = this.tempIdMap.clientToServerPatch(cumulativePatch);
+
+        return cumulativePatch;
+    }
+
+    private applyResponse(response: DbSaveResponse<TTables>, newSavedPoint: number) {
+        this.tempIdMap.appendServerMapping(response);
+
+        let serverPatch = flattenResponse(response.submit, this.db.tables);
+        serverPatch = mergeEntityPatches(this.db.tables, serverPatch);
+        this.savedPoint = newSavedPoint;
+        this.base = this.db;
+        this.commitFetch(serverPatch);
+    }
+
+    /* Update subscriptions (aka live views) */
+
+    private lastSubscriptionId = 1;
+    private subscriptions: Map<number, DbSubscription<any, any>> = new Map();
+    public subscribe<TValue, TParams, TDependencies>(
+        view: DbView<TDb, TValue, TParams, TDependencies>,
+        params: TParams,
+        onUpdate: (newValue: TValue) => any,
+    ): DbSubscription<TValue, TParams> {
+        const id = this.lastSubscriptionId++;
+
+        const subscription: DbSubscription<TValue, TParams> = {
+            update: (subscriptionParams: TParams) => {
+                subscription.currentParams = subscriptionParams;
+                subscription.currentValue = this.db.runView(view, subscriptionParams);
+                return subscription.currentValue;
+            },
+            currentParams: null,
+            currentValue: null,
+            onUpdate,
+            unsubscribe: () => {
+                this.subscriptions.delete(id);
+            },
+        };
+
+        subscription.update(params);
+
+        this.subscriptions.set(id, subscription);
+
+        return subscription;
+    }
+
+    updateHandlers: (() => any)[] = [];
+    public onUpdate(handler: () => any) {
+        this.subscribe(
+            {
+                compute: (db) => db,
+                compareResults: (a, b) => a === b,
+            },
+            null,
+            handler,
+        );
+    }
+
+    private update() {
+        this.subscriptions.forEach((subscription) => {
+            const previousValue = subscription.currentValue;
+            subscription.update(subscription.currentParams);
+            if (subscription.currentValue !== previousValue && subscription.onUpdate) {
+                subscription.onUpdate(subscription.currentValue);
+            }
+        });
+    }
+
+    /* Error Subscriptions */
+
+    public saveErrorHandlers: ((request: DbPatch<TTables>, error: any) => void)[] = [];
+    public onSaveError(handler: (request: DbPatch<TTables>, error: any) => void) {
+        this.saveErrorHandlers.push(handler);
+    }
+
+    private saveError(request: DbPatch<TTables>, error: any) {
+        this.saveErrorHandlers.forEach((handler) => handler(request, error));
+    }
+
+    /* Save scheduling */
+
+    private enqueueSave = batch(async () => {
+        const cumulativePatch = this.makeCumulativePatch();
+        const lastLogEntry = this.log.length;
+        if (isEmpty(cumulativePatch)) {
+            return;
+        }
+        try {
+            const response = await this.savePatch(cumulativePatch);
+            this.applyResponse(response, lastLogEntry);
+            this.update();
+        } catch (error) {
+            this.saveError(cumulativePatch, error);
+            this.update();
+            throw error;
+        }
+    });
+
+    private handleBeforeUnload = (e: BeforeUnloadEvent) => {
+        if (this.enqueueSave.isBusy) {
+            e.returnValue = false;
+            return false;
+        }
+    };
+
+    loaders: Loader<TTables, any, any>[] = [];
+    protected makeLoader<TResponse, TRequest>(options: LoaderOptions<TTables, TResponse, TRequest>) {
+        const loader = new Loader<TTables, TResponse, TRequest>(this as any, () => new SimpleLoadingTracker<TRequest, TResponse>(), options);
+        this.loaders.push(loader);
+        return loader;
+    }
+
+    protected makeListLoader<TItem, TResponse = DataQuery<TItem>, TRequest extends DataQuery<TItem> = DataQuery<TItem>>(
+        options: LoaderOptions<TTables, TResponse, TRequest> & ListLoadingTrackerOptions<TItem, TResponse>,
+    ) {
+        const loader = new Loader<TTables, TResponse, TRequest>(this as any, () => new ListLoadingTracker<TItem, TRequest, TResponse>(), options);
+        this.loaders.push(loader);
+        return loader;
+    }
+
+    reload() {
+        this.loaders = [];
+    }
+}