expressa 2.1.1 → 2.1.2

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 (202) hide show
  1. package/.circleci/config.yml +21 -21
  2. package/.eslintrc.json +29 -29
  3. package/LICENSE +21 -21
  4. package/README.md +137 -137
  5. package/auth/jwt.js +31 -31
  6. package/controllers/collections.js +299 -260
  7. package/controllers/install.js +105 -105
  8. package/controllers/status.js +43 -43
  9. package/controllers/users.js +52 -52
  10. package/cypress/fixtures/example.json +4 -4
  11. package/cypress/integration/0_install_spec.js +8 -8
  12. package/cypress/integration/custom_collections.js +30 -30
  13. package/cypress/integration/home.js +9 -9
  14. package/cypress/integration/settings.js +34 -34
  15. package/cypress/integration/users.js +61 -61
  16. package/cypress/plugins/index.js +17 -17
  17. package/cypress/support/commands.js +69 -69
  18. package/cypress/support/index.js +20 -20
  19. package/cypress/support/util.js +10 -10
  20. package/cypress.config.js +18 -18
  21. package/cypress.json +4 -4
  22. package/db/cached.js +44 -44
  23. package/db/file.js +131 -131
  24. package/db/memory.js +92 -92
  25. package/db/mongo.js +93 -93
  26. package/db/postgres.js +100 -100
  27. package/doc/authentication.md +38 -38
  28. package/doc/automatic-fields.md +12 -12
  29. package/doc/blogexample.md +16 -16
  30. package/doc/custom-endpoints.md +20 -20
  31. package/doc/database.md +23 -23
  32. package/doc/development.md +33 -33
  33. package/doc/listeners.md +103 -103
  34. package/doc/modules.md +8 -8
  35. package/doc/permissions.md +14 -14
  36. package/doc/relationships.md +65 -65
  37. package/doc/testing.md +47 -47
  38. package/doc/uploading-files.md +53 -53
  39. package/listeners.js +65 -65
  40. package/listeners_collection_permissions.js +29 -29
  41. package/listeners_users.js +96 -96
  42. package/listeners_validation.js +43 -43
  43. package/middleware/logging.js +30 -30
  44. package/middleware/permissions.js +41 -41
  45. package/modules/access_keys/access_keys.js +32 -32
  46. package/modules/admin/.babelrc +8 -8
  47. package/modules/admin/.editorconfig +14 -14
  48. package/modules/admin/.eslintignore +5 -5
  49. package/modules/admin/.eslintrc.js +197 -197
  50. package/modules/admin/.postcssrc.js +10 -10
  51. package/modules/admin/.travis.yml +5 -5
  52. package/modules/admin/LICENSE +21 -21
  53. package/modules/admin/README.md +88 -88
  54. package/modules/admin/build/build.js +46 -46
  55. package/modules/admin/build/check-versions.js +64 -64
  56. package/modules/admin/build/utils.js +109 -109
  57. package/modules/admin/build/vue-loader.conf.js +5 -5
  58. package/modules/admin/build/webpack.base.conf.js +112 -112
  59. package/modules/admin/build/webpack.dev.conf.js +95 -95
  60. package/modules/admin/build/webpack.prod.conf.js +112 -112
  61. package/modules/admin/config/dev.env.js +8 -8
  62. package/modules/admin/config/index.js +86 -86
  63. package/modules/admin/config/prod.env.js +5 -5
  64. package/modules/admin/dist/css/{430.e83d8cfe.css → 430.8c9b0482.css} +4 -4
  65. package/modules/admin/dist/css/430.8c9b0482.css.gz +0 -0
  66. package/modules/admin/dist/css/{197.e66ce8d8.css → 566.7a90435e.css} +4 -4
  67. package/modules/admin/dist/css/566.7a90435e.css.gz +0 -0
  68. package/modules/admin/dist/css/569.db9a10c2.css.gz +0 -0
  69. package/modules/admin/dist/css/572.513a323e.css.gz +0 -0
  70. package/modules/admin/dist/css/{566.e66ce8d8.css → 622.7a90435e.css} +4 -4
  71. package/modules/admin/dist/css/622.7a90435e.css.gz +0 -0
  72. package/modules/admin/dist/css/651.e946bda7.css.gz +0 -0
  73. package/modules/admin/dist/css/{750.4086915d.css → 750.79723422.css} +1 -1
  74. package/modules/admin/dist/css/750.79723422.css.gz +0 -0
  75. package/modules/admin/dist/css/{451.c6646d20.css.gz → 798.c6646d20.css.gz} +0 -0
  76. package/modules/admin/dist/css/950.1fd9d57c.css.gz +0 -0
  77. package/modules/admin/dist/css/{app.1c3232a3.css → app.c25a6c6c.css} +24 -24
  78. package/modules/admin/dist/css/app.c25a6c6c.css.gz +0 -0
  79. package/modules/admin/dist/index.html +1 -1
  80. package/modules/admin/dist/static/js/311.03ef5ed9.js +1 -0
  81. package/modules/admin/dist/static/js/311.03ef5ed9.js.gz +0 -0
  82. package/modules/admin/dist/static/js/{430.86219146.js.gz → 430.ddfa4b9e.js.gz} +0 -0
  83. package/modules/admin/dist/static/js/{460.b54cbaab.js.gz → 460.770a630c.js.gz} +0 -0
  84. package/modules/admin/dist/static/js/{550.938e8b79.js → 550.e9a3a306.js} +1 -1
  85. package/modules/admin/dist/static/js/550.e9a3a306.js.gz +0 -0
  86. package/modules/admin/dist/static/js/569.711f16a3.js +1 -0
  87. package/modules/admin/dist/static/js/569.711f16a3.js.gz +0 -0
  88. package/modules/admin/dist/static/js/572.5c8cfea9.js +1 -0
  89. package/modules/admin/dist/static/js/572.5c8cfea9.js.gz +0 -0
  90. package/modules/admin/dist/static/js/603.bbe5ed23.js.gz +0 -0
  91. package/modules/admin/dist/static/js/622.9f06567e.js +1 -0
  92. package/modules/admin/dist/static/js/622.9f06567e.js.gz +0 -0
  93. package/modules/admin/dist/static/js/{651.29b10271.js.gz → 651.86d741f0.js.gz} +0 -0
  94. package/modules/admin/dist/static/js/{653.9b512bd1.js.gz → 653.7a309059.js.gz} +0 -0
  95. package/modules/admin/dist/static/js/{750.0b1c247a.js.gz → 750.10551ec8.js.gz} +0 -0
  96. package/modules/admin/dist/static/js/798.93ec90bc.js +1 -0
  97. package/modules/admin/dist/static/js/798.93ec90bc.js.gz +0 -0
  98. package/modules/admin/dist/static/js/950.d7f72b66.js.gz +0 -0
  99. package/modules/admin/dist/static/js/app.23870b61.js +2 -0
  100. package/modules/admin/dist/static/js/{app.4f835176.js.LICENSE.txt.gz → app.23870b61.js.LICENSE.txt.gz} +0 -0
  101. package/modules/admin/dist/static/js/app.23870b61.js.gz +0 -0
  102. package/modules/admin/index.html +16 -16
  103. package/modules/admin/package.json +101 -101
  104. package/modules/admin/src/App.vue +11 -11
  105. package/modules/admin/src/api/login.js +26 -26
  106. package/modules/admin/src/api/table.js +9 -9
  107. package/modules/admin/src/components/Breadcrumb/index.vue +79 -79
  108. package/modules/admin/src/components/Hamburger/index.vue +62 -62
  109. package/modules/admin/src/components/JSONEditor.vue +206 -206
  110. package/modules/admin/src/components/SvgIcon/index.vue +43 -43
  111. package/modules/admin/src/icons/index.js +9 -9
  112. package/modules/admin/src/icons/svgo.yml +22 -22
  113. package/modules/admin/src/main.js +42 -42
  114. package/modules/admin/src/permission.js +49 -49
  115. package/modules/admin/src/router/index.js +200 -200
  116. package/modules/admin/src/store/getters.js +11 -11
  117. package/modules/admin/src/store/index.js +17 -17
  118. package/modules/admin/src/store/modules/app.js +43 -43
  119. package/modules/admin/src/store/modules/user.js +104 -104
  120. package/modules/admin/src/styles/element-ui.scss +29 -29
  121. package/modules/admin/src/styles/index.scss +78 -78
  122. package/modules/admin/src/styles/mixin.scss +27 -27
  123. package/modules/admin/src/styles/sidebar.scss +133 -133
  124. package/modules/admin/src/styles/transition.scss +46 -46
  125. package/modules/admin/src/styles/variables.scss +4 -4
  126. package/modules/admin/src/utils/auth.js +15 -15
  127. package/modules/admin/src/utils/index.js +74 -74
  128. package/modules/admin/src/utils/request.js +47 -47
  129. package/modules/admin/src/utils/validate.js +31 -31
  130. package/modules/admin/src/views/404.vue +235 -235
  131. package/modules/admin/src/views/Dev.vue +33 -33
  132. package/modules/admin/src/views/EditDocument.vue +121 -121
  133. package/modules/admin/src/views/Endpoints.vue +279 -279
  134. package/modules/admin/src/views/Home.vue +84 -84
  135. package/modules/admin/src/views/Install.vue +79 -79
  136. package/modules/admin/src/views/ListDocuments.vue +72 -72
  137. package/modules/admin/src/views/ListDocuments2.vue +467 -467
  138. package/modules/admin/src/views/ManageListeners.vue +67 -67
  139. package/modules/admin/src/views/ManageMiddleware.vue +43 -43
  140. package/modules/admin/src/views/ManagePermissions.vue +75 -75
  141. package/modules/admin/src/views/ViewRequest.vue +77 -77
  142. package/modules/admin/src/views/form/index.vue +91 -91
  143. package/modules/admin/src/views/layout/Layout.vue +69 -69
  144. package/modules/admin/src/views/layout/components/AppMain.vue +41 -41
  145. package/modules/admin/src/views/layout/components/Navbar.vue +97 -97
  146. package/modules/admin/src/views/layout/components/Sidebar/Item.vue +29 -29
  147. package/modules/admin/src/views/layout/components/Sidebar/Link.vue +39 -39
  148. package/modules/admin/src/views/layout/components/Sidebar/SidebarItem.vue +103 -103
  149. package/modules/admin/src/views/layout/components/Sidebar/index.vue +62 -62
  150. package/modules/admin/src/views/layout/components/index.js +3 -3
  151. package/modules/admin/src/views/layout/mixin/ResizeHandler.js +41 -41
  152. package/modules/admin/src/views/login/index.vue +195 -195
  153. package/modules/admin/src/views/tree/index.vue +77 -77
  154. package/modules/collections/collections.js +45 -39
  155. package/modules/core/core.js +197 -197
  156. package/modules/logging/logging.js +88 -88
  157. package/modules/permissions/permissions.js +106 -106
  158. package/package.json +59 -59
  159. package/scripts/expressa +12 -12
  160. package/scripts/run_cypress_tests.sh +35 -35
  161. package/scripts/run_db_tests.sh +8 -8
  162. package/test/0-install.js +96 -96
  163. package/test/collections.js +431 -431
  164. package/test/collections.querying.js +372 -288
  165. package/test/db.js +258 -258
  166. package/test/db.strings.js +73 -73
  167. package/test/db.updating.js +186 -186
  168. package/test/logging.js +29 -29
  169. package/test/test.js +93 -93
  170. package/test/testserver.js +30 -30
  171. package/test/testutils.js +136 -136
  172. package/test/users.js +425 -425
  173. package/util.js +522 -522
  174. package/modules/admin/dist/css/197.e66ce8d8.css.gz +0 -0
  175. package/modules/admin/dist/css/430.e83d8cfe.css.gz +0 -0
  176. package/modules/admin/dist/css/566.e66ce8d8.css.gz +0 -0
  177. package/modules/admin/dist/css/750.4086915d.css.gz +0 -0
  178. package/modules/admin/dist/css/app.1c3232a3.css.gz +0 -0
  179. package/modules/admin/dist/static/js/197.f9e1ba84.js +0 -1
  180. package/modules/admin/dist/static/js/197.f9e1ba84.js.gz +0 -0
  181. package/modules/admin/dist/static/js/311.ca6d5976.js +0 -1
  182. package/modules/admin/dist/static/js/311.ca6d5976.js.gz +0 -0
  183. package/modules/admin/dist/static/js/451.5e934bb6.js +0 -1
  184. package/modules/admin/dist/static/js/451.5e934bb6.js.gz +0 -0
  185. package/modules/admin/dist/static/js/550.938e8b79.js.gz +0 -0
  186. package/modules/admin/dist/static/js/569.128a8e27.js +0 -1
  187. package/modules/admin/dist/static/js/569.128a8e27.js.gz +0 -0
  188. package/modules/admin/dist/static/js/572.b3b13b2d.js +0 -1
  189. package/modules/admin/dist/static/js/572.b3b13b2d.js.gz +0 -0
  190. package/modules/admin/dist/static/js/603.dc05e481.js.gz +0 -0
  191. package/modules/admin/dist/static/js/950.fe12a66b.js.gz +0 -0
  192. package/modules/admin/dist/static/js/app.4f835176.js +0 -2
  193. package/modules/admin/dist/static/js/app.4f835176.js.gz +0 -0
  194. /package/modules/admin/dist/css/{451.c6646d20.css → 798.c6646d20.css} +0 -0
  195. /package/modules/admin/dist/static/js/{430.86219146.js → 430.ddfa4b9e.js} +0 -0
  196. /package/modules/admin/dist/static/js/{460.b54cbaab.js → 460.770a630c.js} +0 -0
  197. /package/modules/admin/dist/static/js/{603.dc05e481.js → 603.bbe5ed23.js} +0 -0
  198. /package/modules/admin/dist/static/js/{651.29b10271.js → 651.86d741f0.js} +0 -0
  199. /package/modules/admin/dist/static/js/{653.9b512bd1.js → 653.7a309059.js} +0 -0
  200. /package/modules/admin/dist/static/js/{750.0b1c247a.js → 750.10551ec8.js} +0 -0
  201. /package/modules/admin/dist/static/js/{950.fe12a66b.js → 950.d7f72b66.js} +0 -0
  202. /package/modules/admin/dist/static/js/{app.4f835176.js.LICENSE.txt → app.23870b61.js.LICENSE.txt} +0 -0
@@ -1,30 +1,30 @@
1
- // This is for starting a server with the test configuration/data.
2
- const expressa = require('../index')
3
- const api = expressa.api({
4
- file_storage_path: 'testdata'
5
- })
6
-
7
- const express = require('express')
8
- const app = express()
9
- app.use('/api', api)
10
- app.use('/admin', expressa.admin({
11
- apiurl: 'http://localhost:3001/api/',
12
- api_timeout_ms: 10000,
13
- }))
14
-
15
- function sleep(ms) {
16
- return new Promise(resolve => setTimeout(resolve, ms))
17
- }
18
-
19
- api.get('/slow_endpoint', async (req, res) => {
20
- await sleep(7000)
21
-
22
- res.send('Hello World!')
23
- })
24
-
25
- api.addListener('ready', function onStart() {
26
- app.listen(3001, function () {
27
- // eslint-disable-next-line no-console
28
- console.log('Test server listening on port 3001!')
29
- })
30
- })
1
+ // This is for starting a server with the test configuration/data.
2
+ const expressa = require('../index')
3
+ const api = expressa.api({
4
+ file_storage_path: 'testdata'
5
+ })
6
+
7
+ const express = require('express')
8
+ const app = express()
9
+ app.use('/api', api)
10
+ app.use('/admin', expressa.admin({
11
+ apiurl: 'http://localhost:3001/api/',
12
+ api_timeout_ms: 10000,
13
+ }))
14
+
15
+ function sleep(ms) {
16
+ return new Promise(resolve => setTimeout(resolve, ms))
17
+ }
18
+
19
+ api.get('/slow_endpoint', async (req, res) => {
20
+ await sleep(7000)
21
+
22
+ res.send('Hello World!')
23
+ })
24
+
25
+ api.addListener('ready', function onStart() {
26
+ app.listen(3001, function () {
27
+ // eslint-disable-next-line no-console
28
+ console.log('Test server listening on port 3001!')
29
+ })
30
+ })
package/test/testutils.js CHANGED
@@ -1,136 +1,136 @@
1
- const fs = require('fs')
2
-
3
- const expressa = require('../')
4
- const request = require('supertest')
5
- const util = require('../util')
6
-
7
- // See https://stackoverflow.com/questions/18052762/remove-directory-which-is-not-empty
8
- const deleteFolderRecursive = function(path) {
9
- if (fs.existsSync(path)) {
10
- fs.readdirSync(path).forEach(function(file) {
11
- const curPath = path + '/' + file
12
- if (fs.lstatSync(curPath).isDirectory()) { // recurse
13
- deleteFolderRecursive(curPath)
14
- } else { // delete file
15
- fs.unlinkSync(curPath)
16
- }
17
- })
18
- fs.rmdirSync(path)
19
- }
20
- }
21
-
22
- deleteFolderRecursive('testdata')
23
- fs.mkdirSync('testdata')
24
-
25
- exports.api = expressa.api({
26
- file_storage_path: 'testdata'
27
- })
28
- const express = require('express')
29
- const randomstring = require('randomstring')
30
- exports.app = express()
31
- exports.app.use(exports.api)
32
-
33
- const tokens = {
34
- admin: ''
35
- }
36
-
37
- exports.setAdminToken = function(token) {
38
- tokens.admin = token
39
- }
40
-
41
- exports.getUserWithPermissions = async function(api, permissions) {
42
- const service = request(exports.app)
43
- if (typeof permissions === 'string') {
44
- permissions = [permissions]
45
- }
46
- permissions = permissions || []
47
- const permissionsMap = {}
48
- permissions.forEach(function (permission) {
49
- permissionsMap[permission] = true
50
- })
51
-
52
- const randId = randomstring.generate(12)
53
- const roleName = 'role' + randId
54
- const role = {
55
- _id: roleName,
56
- permissions: permissionsMap
57
- }
58
-
59
- await service.post('/role')
60
- .set('x-access-token', tokens.admin)
61
- .send(role)
62
- .expect(200)
63
-
64
- const user = {
65
- email: 'test' + randId + '@example.com',
66
- password: '123',
67
- }
68
- const registerRes = await service.post('/users/register')
69
- .send(user)
70
- .expect(200)
71
-
72
- await service.post(`/users/${registerRes.body.id}/update`)
73
- .send({ $push: { roles: roleName } })
74
- .set('x-access-token', tokens.admin)
75
- .expect(200)
76
-
77
- const loginRes = await service.post('/users/login')
78
- .send(user)
79
- .expect(200)
80
-
81
- user._id = loginRes.body.uid
82
- return loginRes.body.token
83
- }
84
-
85
- exports.getAccessKeyForUserWithPermissions = async function(api, permissions) {
86
- const service = request(exports.app)
87
- if (typeof permissions === 'string') {
88
- permissions = [permissions]
89
- }
90
- permissions = permissions || []
91
- const permissionsMap = {}
92
- permissions.forEach(function (permission) {
93
- permissionsMap[permission] = true
94
- })
95
-
96
- const randId = randomstring.generate(12)
97
- const roleName = 'role' + randId
98
- const role = {
99
- _id: roleName,
100
- permissions: permissionsMap
101
- }
102
-
103
- await service.post('/role')
104
- .set('x-access-token', tokens.admin)
105
- .send(role)
106
- .expect(200)
107
-
108
- const user = {
109
- email: 'test' + randId + '@example.com',
110
- password: '123',
111
- }
112
- const registerRes = await service.post('/users/register')
113
- .send(user)
114
- .expect(200)
115
-
116
- await service.post(`/users/${registerRes.body.id}/update`)
117
- .send({ $push: { roles: roleName } })
118
- .set('x-access-token', tokens.admin)
119
- .expect(200)
120
-
121
- const accessKey = randomstring.generate(8)
122
- await exports.api.db.access_keys.create({
123
- user_collection: 'users',
124
- user_id: registerRes.body.id,
125
- key: accessKey,
126
- expires_at: '2032-01-01T00:00:00'
127
- })
128
-
129
- return accessKey
130
- }
131
-
132
- exports.clone = util.clone
133
- exports.sleep = function sleep(ms) {
134
- return new Promise(resolve => setTimeout(resolve, ms))
135
- }
136
- exports.generateDocumentId = util.generateDocumentId
1
+ const fs = require('fs')
2
+
3
+ const expressa = require('../')
4
+ const request = require('supertest')
5
+ const util = require('../util')
6
+
7
+ // See https://stackoverflow.com/questions/18052762/remove-directory-which-is-not-empty
8
+ const deleteFolderRecursive = function(path) {
9
+ if (fs.existsSync(path)) {
10
+ fs.readdirSync(path).forEach(function(file) {
11
+ const curPath = path + '/' + file
12
+ if (fs.lstatSync(curPath).isDirectory()) { // recurse
13
+ deleteFolderRecursive(curPath)
14
+ } else { // delete file
15
+ fs.unlinkSync(curPath)
16
+ }
17
+ })
18
+ fs.rmdirSync(path)
19
+ }
20
+ }
21
+
22
+ deleteFolderRecursive('testdata')
23
+ fs.mkdirSync('testdata')
24
+
25
+ exports.api = expressa.api({
26
+ file_storage_path: 'testdata'
27
+ })
28
+ const express = require('express')
29
+ const randomstring = require('randomstring')
30
+ exports.app = express()
31
+ exports.app.use(exports.api)
32
+
33
+ const tokens = {
34
+ admin: ''
35
+ }
36
+
37
+ exports.setAdminToken = function(token) {
38
+ tokens.admin = token
39
+ }
40
+
41
+ exports.getUserWithPermissions = async function(api, permissions) {
42
+ const service = request(exports.app)
43
+ if (typeof permissions === 'string') {
44
+ permissions = [permissions]
45
+ }
46
+ permissions = permissions || []
47
+ const permissionsMap = {}
48
+ permissions.forEach(function (permission) {
49
+ permissionsMap[permission] = true
50
+ })
51
+
52
+ const randId = randomstring.generate(12)
53
+ const roleName = 'role' + randId
54
+ const role = {
55
+ _id: roleName,
56
+ permissions: permissionsMap
57
+ }
58
+
59
+ await service.post('/role')
60
+ .set('x-access-token', tokens.admin)
61
+ .send(role)
62
+ .expect(200)
63
+
64
+ const user = {
65
+ email: 'test' + randId + '@example.com',
66
+ password: '123',
67
+ }
68
+ const registerRes = await service.post('/users/register')
69
+ .send(user)
70
+ .expect(200)
71
+
72
+ await service.post(`/users/${registerRes.body.id}/update`)
73
+ .send({ $push: { roles: roleName } })
74
+ .set('x-access-token', tokens.admin)
75
+ .expect(200)
76
+
77
+ const loginRes = await service.post('/users/login')
78
+ .send(user)
79
+ .expect(200)
80
+
81
+ user._id = loginRes.body.uid
82
+ return loginRes.body.token
83
+ }
84
+
85
+ exports.getAccessKeyForUserWithPermissions = async function(api, permissions) {
86
+ const service = request(exports.app)
87
+ if (typeof permissions === 'string') {
88
+ permissions = [permissions]
89
+ }
90
+ permissions = permissions || []
91
+ const permissionsMap = {}
92
+ permissions.forEach(function (permission) {
93
+ permissionsMap[permission] = true
94
+ })
95
+
96
+ const randId = randomstring.generate(12)
97
+ const roleName = 'role' + randId
98
+ const role = {
99
+ _id: roleName,
100
+ permissions: permissionsMap
101
+ }
102
+
103
+ await service.post('/role')
104
+ .set('x-access-token', tokens.admin)
105
+ .send(role)
106
+ .expect(200)
107
+
108
+ const user = {
109
+ email: 'test' + randId + '@example.com',
110
+ password: '123',
111
+ }
112
+ const registerRes = await service.post('/users/register')
113
+ .send(user)
114
+ .expect(200)
115
+
116
+ await service.post(`/users/${registerRes.body.id}/update`)
117
+ .send({ $push: { roles: roleName } })
118
+ .set('x-access-token', tokens.admin)
119
+ .expect(200)
120
+
121
+ const accessKey = randomstring.generate(8)
122
+ await exports.api.db.access_keys.create({
123
+ user_collection: 'users',
124
+ user_id: registerRes.body.id,
125
+ key: accessKey,
126
+ expires_at: '2032-01-01T00:00:00'
127
+ })
128
+
129
+ return accessKey
130
+ }
131
+
132
+ exports.clone = util.clone
133
+ exports.sleep = function sleep(ms) {
134
+ return new Promise(resolve => setTimeout(resolve, ms))
135
+ }
136
+ exports.generateDocumentId = util.generateDocumentId