acebase-server 1.9.1 → 1.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (511) hide show
  1. package/.vscode/launch.json +24 -0
  2. package/create-package-files +12 -0
  3. package/dist/cjs/auth.js +89 -0
  4. package/dist/cjs/auth.js.map +1 -0
  5. package/dist/cjs/cluster.js +57 -0
  6. package/dist/cjs/cluster.js.map +1 -0
  7. package/dist/cjs/index.js +9 -0
  8. package/dist/cjs/index.js.map +1 -0
  9. package/dist/cjs/middleware/404.js +15 -0
  10. package/dist/cjs/middleware/404.js.map +1 -0
  11. package/dist/cjs/middleware/cache.js +15 -0
  12. package/dist/cjs/middleware/cache.js.map +1 -0
  13. package/dist/cjs/middleware/connection.js +50 -0
  14. package/dist/cjs/middleware/connection.js.map +1 -0
  15. package/dist/cjs/middleware/context.js +21 -0
  16. package/dist/cjs/middleware/context.js.map +1 -0
  17. package/dist/cjs/middleware/cors.js +51 -0
  18. package/dist/cjs/middleware/cors.js.map +1 -0
  19. package/dist/cjs/middleware/swagger.js +18 -0
  20. package/dist/cjs/middleware/swagger.js.map +1 -0
  21. package/dist/cjs/middleware/user.js +58 -0
  22. package/dist/cjs/middleware/user.js.map +1 -0
  23. package/dist/cjs/oauth-providers/dropbox.js +109 -0
  24. package/dist/cjs/oauth-providers/dropbox.js.map +1 -0
  25. package/dist/cjs/oauth-providers/facebook.js +85 -0
  26. package/dist/cjs/oauth-providers/facebook.js.map +1 -0
  27. package/dist/cjs/oauth-providers/google.js +125 -0
  28. package/dist/cjs/oauth-providers/google.js.map +1 -0
  29. package/dist/cjs/oauth-providers/index.js +27 -0
  30. package/dist/cjs/oauth-providers/index.js.map +1 -0
  31. package/dist/cjs/oauth-providers/instagram.js +80 -0
  32. package/dist/cjs/oauth-providers/instagram.js.map +1 -0
  33. package/dist/cjs/oauth-providers/oauth-provider.js +3 -0
  34. package/dist/cjs/oauth-providers/oauth-provider.js.map +1 -0
  35. package/dist/cjs/oauth-providers/spotify.js +113 -0
  36. package/dist/cjs/oauth-providers/spotify.js.map +1 -0
  37. package/dist/cjs/package.json +3 -0
  38. package/dist/cjs/routes/auth-change-password.js +85 -0
  39. package/dist/cjs/routes/auth-change-password.js.map +1 -0
  40. package/dist/cjs/routes/auth-delete.js +51 -0
  41. package/dist/cjs/routes/auth-delete.js.map +1 -0
  42. package/dist/cjs/routes/auth-forgot-password.js +75 -0
  43. package/dist/cjs/routes/auth-forgot-password.js.map +1 -0
  44. package/dist/cjs/routes/auth-reset-password.js +94 -0
  45. package/dist/cjs/routes/auth-reset-password.js.map +1 -0
  46. package/dist/cjs/routes/auth-signin.js +47 -0
  47. package/dist/cjs/routes/auth-signin.js.map +1 -0
  48. package/dist/cjs/routes/auth-signout.js +60 -0
  49. package/dist/cjs/routes/auth-signout.js.map +1 -0
  50. package/dist/cjs/routes/auth-signup.js +141 -0
  51. package/dist/cjs/routes/auth-signup.js.map +1 -0
  52. package/dist/cjs/routes/auth-state.js +26 -0
  53. package/dist/cjs/routes/auth-state.js.map +1 -0
  54. package/dist/cjs/routes/auth-update.js +129 -0
  55. package/dist/cjs/routes/auth-update.js.map +1 -0
  56. package/dist/cjs/routes/auth-verify-email.js +67 -0
  57. package/dist/cjs/routes/auth-verify-email.js.map +1 -0
  58. package/dist/cjs/routes/auth.js +55 -0
  59. package/dist/cjs/routes/auth.js.map +1 -0
  60. package/dist/cjs/routes/data-exists.js +34 -0
  61. package/dist/cjs/routes/data-exists.js.map +1 -0
  62. package/dist/cjs/routes/data-export.js +49 -0
  63. package/dist/cjs/routes/data-export.js.map +1 -0
  64. package/dist/cjs/routes/data-get.js +67 -0
  65. package/dist/cjs/routes/data-get.js.map +1 -0
  66. package/dist/cjs/routes/data-import.js +55 -0
  67. package/dist/cjs/routes/data-import.js.map +1 -0
  68. package/dist/cjs/routes/data-index-create.js +45 -0
  69. package/dist/cjs/routes/data-index-create.js.map +1 -0
  70. package/dist/cjs/routes/data-index-delete.js +36 -0
  71. package/dist/cjs/routes/data-index-delete.js.map +1 -0
  72. package/dist/cjs/routes/data-index-list.js +35 -0
  73. package/dist/cjs/routes/data-index-list.js.map +1 -0
  74. package/dist/cjs/routes/data-query.js +71 -0
  75. package/dist/cjs/routes/data-query.js.map +1 -0
  76. package/dist/cjs/routes/data-reflect.js +89 -0
  77. package/dist/cjs/routes/data-reflect.js.map +1 -0
  78. package/dist/cjs/routes/data-schema-get.js +39 -0
  79. package/dist/cjs/routes/data-schema-get.js.map +1 -0
  80. package/dist/cjs/routes/data-schema-set.js +33 -0
  81. package/dist/cjs/routes/data-schema-set.js.map +1 -0
  82. package/dist/cjs/routes/data-schema-test.js +46 -0
  83. package/dist/cjs/routes/data-schema-test.js.map +1 -0
  84. package/dist/cjs/routes/data-schemas-list.js +35 -0
  85. package/dist/cjs/routes/data-schemas-list.js.map +1 -0
  86. package/dist/cjs/routes/data-set.js +72 -0
  87. package/dist/cjs/routes/data-set.js.map +1 -0
  88. package/dist/cjs/routes/data-sync-changes.js +68 -0
  89. package/dist/cjs/routes/data-sync-changes.js.map +1 -0
  90. package/dist/cjs/routes/data-sync-mutations.js +68 -0
  91. package/dist/cjs/routes/data-sync-mutations.js.map +1 -0
  92. package/dist/cjs/routes/data-transaction.js +120 -0
  93. package/dist/cjs/routes/data-transaction.js.map +1 -0
  94. package/dist/cjs/routes/data-update.js +71 -0
  95. package/dist/cjs/routes/data-update.js.map +1 -0
  96. package/dist/cjs/routes/data.js +63 -0
  97. package/dist/cjs/routes/data.js.map +1 -0
  98. package/dist/cjs/routes/docs.js +249 -0
  99. package/dist/cjs/routes/docs.js.map +1 -0
  100. package/dist/cjs/routes/meta-info.js +70 -0
  101. package/dist/cjs/routes/meta-info.js.map +1 -0
  102. package/dist/cjs/routes/meta-ping.js +12 -0
  103. package/dist/cjs/routes/meta-ping.js.map +1 -0
  104. package/dist/cjs/routes/meta-stats.js +28 -0
  105. package/dist/cjs/routes/meta-stats.js.map +1 -0
  106. package/dist/cjs/routes/meta.js +17 -0
  107. package/dist/cjs/routes/meta.js.map +1 -0
  108. package/dist/cjs/routes/oauth2-init.js +52 -0
  109. package/dist/cjs/routes/oauth2-init.js.map +1 -0
  110. package/dist/cjs/routes/oauth2-refresh.js +43 -0
  111. package/dist/cjs/routes/oauth2-refresh.js.map +1 -0
  112. package/dist/cjs/routes/oauth2-signin.js +262 -0
  113. package/dist/cjs/routes/oauth2-signin.js.map +1 -0
  114. package/dist/cjs/routes/webmanager.js +27 -0
  115. package/dist/cjs/routes/webmanager.js.map +1 -0
  116. package/dist/cjs/rules.js +175 -0
  117. package/dist/cjs/rules.js.map +1 -0
  118. package/dist/cjs/schema/user.js +26 -0
  119. package/dist/cjs/schema/user.js.map +1 -0
  120. package/dist/cjs/server.js +363 -0
  121. package/dist/cjs/server.js.map +1 -0
  122. package/dist/cjs/settings/email.js +5 -0
  123. package/dist/cjs/settings/email.js.map +1 -0
  124. package/dist/cjs/settings/index.js +159 -0
  125. package/dist/cjs/settings/index.js.map +1 -0
  126. package/dist/cjs/shared/clients.js +27 -0
  127. package/dist/cjs/shared/clients.js.map +1 -0
  128. package/dist/cjs/shared/email.js +7 -0
  129. package/dist/cjs/shared/email.js.map +1 -0
  130. package/{src/oauth-providers/oauth-provider.js → dist/cjs/shared/env.js} +3 -0
  131. package/dist/cjs/shared/env.js.map +1 -0
  132. package/dist/cjs/shared/error.js +35 -0
  133. package/dist/cjs/shared/error.js.map +1 -0
  134. package/dist/cjs/shared/http.js +21 -0
  135. package/dist/cjs/shared/http.js.map +1 -0
  136. package/dist/cjs/shared/password.js +46 -0
  137. package/dist/cjs/shared/password.js.map +1 -0
  138. package/dist/cjs/shared/rootpath.js +15 -0
  139. package/dist/cjs/shared/rootpath.js.map +1 -0
  140. package/dist/cjs/shared/signin.js +139 -0
  141. package/dist/cjs/shared/signin.js.map +1 -0
  142. package/dist/cjs/shared/simple-fetch.js +77 -0
  143. package/dist/cjs/shared/simple-fetch.js.map +1 -0
  144. package/dist/cjs/shared/tokens.js +79 -0
  145. package/dist/cjs/shared/tokens.js.map +1 -0
  146. package/dist/cjs/shared/validate.js +62 -0
  147. package/dist/cjs/shared/validate.js.map +1 -0
  148. package/dist/cjs/start.js +51 -0
  149. package/dist/cjs/start.js.map +1 -0
  150. package/dist/cjs/test.js +11 -0
  151. package/dist/cjs/test.js.map +1 -0
  152. package/dist/cjs/websocket/index.js +301 -0
  153. package/dist/cjs/websocket/index.js.map +1 -0
  154. package/dist/cjs/websocket/manager.js +16 -0
  155. package/dist/cjs/websocket/manager.js.map +1 -0
  156. package/dist/cjs/websocket/socket.io.js +79 -0
  157. package/dist/cjs/websocket/socket.io.js.map +1 -0
  158. package/dist/esm/auth.js +76 -0
  159. package/dist/esm/auth.js.map +1 -0
  160. package/{src → dist/esm}/cluster.js +9 -14
  161. package/dist/esm/cluster.js.map +1 -0
  162. package/dist/esm/index.js +3 -0
  163. package/dist/esm/index.js.map +1 -0
  164. package/dist/esm/middleware/404.js +11 -0
  165. package/dist/esm/middleware/404.js.map +1 -0
  166. package/dist/esm/middleware/cache.js +11 -0
  167. package/dist/esm/middleware/cache.js.map +1 -0
  168. package/dist/esm/middleware/connection.js +46 -0
  169. package/dist/esm/middleware/connection.js.map +1 -0
  170. package/dist/esm/middleware/context.js +17 -0
  171. package/dist/esm/middleware/context.js.map +1 -0
  172. package/dist/esm/middleware/cors.js +45 -0
  173. package/dist/esm/middleware/cors.js.map +1 -0
  174. package/dist/esm/middleware/swagger.js +14 -0
  175. package/dist/esm/middleware/swagger.js.map +1 -0
  176. package/dist/esm/middleware/user.js +45 -0
  177. package/dist/esm/middleware/user.js.map +1 -0
  178. package/{src → dist/esm}/oauth-providers/dropbox.js +11 -9
  179. package/dist/esm/oauth-providers/dropbox.js.map +1 -0
  180. package/{src → dist/esm}/oauth-providers/facebook.js +6 -9
  181. package/dist/esm/oauth-providers/facebook.js.map +1 -0
  182. package/{src → dist/esm}/oauth-providers/google.js +8 -11
  183. package/dist/esm/oauth-providers/google.js.map +1 -0
  184. package/dist/esm/oauth-providers/index.js +19 -0
  185. package/dist/esm/oauth-providers/index.js.map +1 -0
  186. package/{src → dist/esm}/oauth-providers/instagram.js +6 -9
  187. package/dist/esm/oauth-providers/instagram.js.map +1 -0
  188. package/dist/esm/oauth-providers/oauth-provider.js +2 -0
  189. package/dist/esm/oauth-providers/oauth-provider.js.map +1 -0
  190. package/{src → dist/esm}/oauth-providers/spotify.js +7 -10
  191. package/dist/esm/oauth-providers/spotify.js.map +1 -0
  192. package/dist/esm/package.json +3 -0
  193. package/dist/esm/routes/auth-change-password.js +70 -0
  194. package/dist/esm/routes/auth-change-password.js.map +1 -0
  195. package/dist/esm/routes/auth-delete.js +36 -0
  196. package/dist/esm/routes/auth-delete.js.map +1 -0
  197. package/dist/esm/routes/auth-forgot-password.js +61 -0
  198. package/dist/esm/routes/auth-forgot-password.js.map +1 -0
  199. package/dist/esm/routes/auth-reset-password.js +78 -0
  200. package/dist/esm/routes/auth-reset-password.js.map +1 -0
  201. package/dist/esm/routes/auth-signin.js +34 -0
  202. package/dist/esm/routes/auth-signin.js.map +1 -0
  203. package/dist/esm/routes/auth-signout.js +46 -0
  204. package/dist/esm/routes/auth-signout.js.map +1 -0
  205. package/dist/esm/routes/auth-signup.js +126 -0
  206. package/dist/esm/routes/auth-signup.js.map +1 -0
  207. package/dist/esm/routes/auth-state.js +13 -0
  208. package/dist/esm/routes/auth-state.js.map +1 -0
  209. package/dist/esm/routes/auth-update.js +115 -0
  210. package/dist/esm/routes/auth-update.js.map +1 -0
  211. package/dist/esm/routes/auth-verify-email.js +52 -0
  212. package/dist/esm/routes/auth-verify-email.js.map +1 -0
  213. package/dist/esm/routes/auth.js +51 -0
  214. package/dist/esm/routes/auth.js.map +1 -0
  215. package/dist/esm/routes/data-exists.js +21 -0
  216. package/dist/esm/routes/data-exists.js.map +1 -0
  217. package/dist/esm/routes/data-export.js +36 -0
  218. package/dist/esm/routes/data-export.js.map +1 -0
  219. package/dist/esm/routes/data-get.js +53 -0
  220. package/dist/esm/routes/data-get.js.map +1 -0
  221. package/dist/esm/routes/data-import.js +42 -0
  222. package/dist/esm/routes/data-import.js.map +1 -0
  223. package/dist/esm/routes/data-index-create.js +31 -0
  224. package/dist/esm/routes/data-index-create.js.map +1 -0
  225. package/dist/esm/routes/data-index-delete.js +23 -0
  226. package/dist/esm/routes/data-index-delete.js.map +1 -0
  227. package/dist/esm/routes/data-index-list.js +22 -0
  228. package/dist/esm/routes/data-index-list.js.map +1 -0
  229. package/dist/esm/routes/data-query.js +57 -0
  230. package/dist/esm/routes/data-query.js.map +1 -0
  231. package/dist/esm/routes/data-reflect.js +76 -0
  232. package/dist/esm/routes/data-reflect.js.map +1 -0
  233. package/dist/esm/routes/data-schema-get.js +26 -0
  234. package/dist/esm/routes/data-schema-get.js.map +1 -0
  235. package/dist/esm/routes/data-schema-set.js +20 -0
  236. package/dist/esm/routes/data-schema-set.js.map +1 -0
  237. package/dist/esm/routes/data-schema-test.js +32 -0
  238. package/dist/esm/routes/data-schema-test.js.map +1 -0
  239. package/dist/esm/routes/data-schemas-list.js +22 -0
  240. package/dist/esm/routes/data-schemas-list.js.map +1 -0
  241. package/dist/esm/routes/data-set.js +57 -0
  242. package/dist/esm/routes/data-set.js.map +1 -0
  243. package/dist/esm/routes/data-sync-changes.js +54 -0
  244. package/dist/esm/routes/data-sync-changes.js.map +1 -0
  245. package/dist/esm/routes/data-sync-mutations.js +54 -0
  246. package/dist/esm/routes/data-sync-mutations.js.map +1 -0
  247. package/dist/esm/routes/data-transaction.js +104 -0
  248. package/dist/esm/routes/data-transaction.js.map +1 -0
  249. package/dist/esm/routes/data-update.js +56 -0
  250. package/dist/esm/routes/data-update.js.map +1 -0
  251. package/dist/esm/routes/data.js +59 -0
  252. package/dist/esm/routes/data.js.map +1 -0
  253. package/dist/esm/routes/docs.js +244 -0
  254. package/dist/esm/routes/docs.js.map +1 -0
  255. package/dist/esm/routes/meta-info.js +66 -0
  256. package/dist/esm/routes/meta-info.js.map +1 -0
  257. package/dist/esm/routes/meta-ping.js +8 -0
  258. package/dist/esm/routes/meta-ping.js.map +1 -0
  259. package/dist/esm/routes/meta-stats.js +15 -0
  260. package/dist/esm/routes/meta-stats.js.map +1 -0
  261. package/dist/esm/routes/meta.js +13 -0
  262. package/dist/esm/routes/meta.js.map +1 -0
  263. package/dist/esm/routes/oauth2-init.js +39 -0
  264. package/dist/esm/routes/oauth2-init.js.map +1 -0
  265. package/dist/esm/routes/oauth2-refresh.js +30 -0
  266. package/dist/esm/routes/oauth2-refresh.js.map +1 -0
  267. package/dist/esm/routes/oauth2-signin.js +248 -0
  268. package/dist/esm/routes/oauth2-signin.js.map +1 -0
  269. package/dist/esm/routes/webmanager.js +23 -0
  270. package/dist/esm/routes/webmanager.js.map +1 -0
  271. package/dist/esm/rules.js +171 -0
  272. package/dist/esm/rules.js.map +1 -0
  273. package/dist/esm/schema/user.js +21 -0
  274. package/dist/esm/schema/user.js.map +1 -0
  275. package/dist/esm/server.js +344 -0
  276. package/dist/esm/server.js.map +1 -0
  277. package/dist/esm/settings/email.js +4 -0
  278. package/dist/esm/settings/email.js.map +1 -0
  279. package/dist/esm/settings/index.js +152 -0
  280. package/dist/esm/settings/index.js.map +1 -0
  281. package/dist/esm/shared/clients.js +23 -0
  282. package/dist/esm/shared/clients.js.map +1 -0
  283. package/dist/esm/shared/email.js +6 -0
  284. package/dist/esm/shared/email.js.map +1 -0
  285. package/dist/esm/shared/env.js +4 -0
  286. package/dist/esm/shared/env.js.map +1 -0
  287. package/dist/esm/shared/error.js +27 -0
  288. package/dist/esm/shared/error.js.map +1 -0
  289. package/dist/esm/shared/http.js +16 -0
  290. package/dist/esm/shared/http.js.map +1 -0
  291. package/dist/esm/shared/password.js +39 -0
  292. package/dist/esm/shared/password.js.map +1 -0
  293. package/dist/esm/shared/rootpath.js +12 -0
  294. package/dist/esm/shared/rootpath.js.map +1 -0
  295. package/dist/esm/shared/signin.js +125 -0
  296. package/dist/esm/shared/signin.js.map +1 -0
  297. package/{src/oauth-providers → dist/esm/shared}/simple-fetch.js +7 -10
  298. package/dist/esm/shared/simple-fetch.js.map +1 -0
  299. package/dist/esm/shared/tokens.js +72 -0
  300. package/dist/esm/shared/tokens.js.map +1 -0
  301. package/dist/esm/shared/validate.js +42 -0
  302. package/dist/esm/shared/validate.js.map +1 -0
  303. package/dist/esm/start.js +48 -0
  304. package/dist/esm/start.js.map +1 -0
  305. package/dist/esm/test.js +9 -0
  306. package/dist/esm/test.js.map +1 -0
  307. package/dist/esm/websocket/index.js +288 -0
  308. package/dist/esm/websocket/index.js.map +1 -0
  309. package/dist/esm/websocket/manager.js +12 -0
  310. package/dist/esm/websocket/manager.js.map +1 -0
  311. package/dist/esm/websocket/socket.io.js +73 -0
  312. package/dist/esm/websocket/socket.io.js.map +1 -0
  313. package/dist/types/auth.d.ts +3 -0
  314. package/dist/types/cluster.d.ts +1 -0
  315. package/dist/types/index.d.ts +2 -0
  316. package/dist/types/middleware/404.d.ts +7 -0
  317. package/dist/types/middleware/cache.d.ts +3 -0
  318. package/dist/types/middleware/connection.d.ts +7 -0
  319. package/dist/types/middleware/context.d.ts +3 -0
  320. package/dist/types/middleware/cors.d.ts +25 -0
  321. package/dist/types/middleware/swagger.d.ts +3 -0
  322. package/dist/types/middleware/user.d.ts +2 -0
  323. package/dist/types/oauth-providers/dropbox.d.ts +63 -0
  324. package/dist/types/oauth-providers/facebook.d.ts +45 -0
  325. package/dist/types/oauth-providers/google.d.ts +47 -0
  326. package/dist/types/oauth-providers/index.d.ts +18 -0
  327. package/dist/types/oauth-providers/instagram.d.ts +54 -0
  328. package/dist/types/oauth-providers/oauth-provider.d.ts +70 -0
  329. package/dist/types/oauth-providers/spotify.d.ts +57 -0
  330. package/dist/types/routes/auth-change-password.d.ts +20 -0
  331. package/dist/types/routes/auth-delete.d.ts +16 -0
  332. package/dist/types/routes/auth-forgot-password.d.ts +16 -0
  333. package/dist/types/routes/auth-reset-password.d.ts +23 -0
  334. package/dist/types/routes/auth-signin.d.ts +24 -0
  335. package/dist/types/routes/auth-signout.d.ts +14 -0
  336. package/dist/types/routes/auth-signup.d.ts +32 -0
  337. package/dist/types/routes/auth-state.d.ts +13 -0
  338. package/dist/types/routes/auth-update.d.ts +33 -0
  339. package/dist/types/routes/auth-verify-email.d.ts +21 -0
  340. package/dist/types/routes/auth.d.ts +6 -0
  341. package/dist/types/routes/data-exists.d.ts +9 -0
  342. package/dist/types/routes/data-export.d.ts +10 -0
  343. package/dist/types/routes/data-get.d.ts +14 -0
  344. package/dist/types/routes/data-import.d.ts +13 -0
  345. package/dist/types/routes/data-index-create.d.ts +51 -0
  346. package/dist/types/routes/data-index-delete.d.ts +17 -0
  347. package/dist/types/routes/data-index-list.d.ts +21 -0
  348. package/dist/types/routes/data-query.d.ts +49 -0
  349. package/dist/types/routes/data-reflect.d.ts +29 -0
  350. package/dist/types/routes/data-schema-get.d.ts +11 -0
  351. package/dist/types/routes/data-schema-set.d.ts +19 -0
  352. package/dist/types/routes/data-schema-test.d.ts +21 -0
  353. package/dist/types/routes/data-schemas-list.d.ts +11 -0
  354. package/dist/types/routes/data-set.d.ts +27 -0
  355. package/dist/types/routes/data-sync-changes.d.ts +28 -0
  356. package/dist/types/routes/data-sync-mutations.d.ts +28 -0
  357. package/dist/types/routes/data-transaction.d.ts +34 -0
  358. package/dist/types/routes/data-update.d.ts +27 -0
  359. package/dist/types/routes/data.d.ts +3 -0
  360. package/dist/types/routes/docs.d.ts +3 -0
  361. package/dist/types/routes/meta-info.d.ts +11 -0
  362. package/dist/types/routes/meta-ping.d.ts +7 -0
  363. package/dist/types/routes/meta-stats.d.ts +13 -0
  364. package/dist/types/routes/meta.d.ts +3 -0
  365. package/dist/types/routes/oauth2-init.d.ts +13 -0
  366. package/dist/types/routes/oauth2-refresh.d.ts +17 -0
  367. package/dist/types/routes/oauth2-signin.d.ts +15 -0
  368. package/dist/types/routes/webmanager.d.ts +3 -0
  369. package/dist/types/rules.d.ts +41 -0
  370. package/dist/types/schema/user.d.ts +85 -0
  371. package/dist/types/server.d.ts +106 -0
  372. package/dist/types/settings/email.d.ts +14 -0
  373. package/dist/types/settings/index.d.ts +165 -0
  374. package/dist/types/shared/clients.d.ts +44 -0
  375. package/dist/types/shared/email.d.ts +34 -0
  376. package/dist/types/shared/env.d.ts +42 -0
  377. package/dist/types/shared/error.d.ts +15 -0
  378. package/dist/types/shared/http.d.ts +14 -0
  379. package/dist/types/shared/password.d.ts +19 -0
  380. package/dist/types/shared/rootpath.d.ts +2 -0
  381. package/dist/types/shared/signin.d.ts +31 -0
  382. package/dist/types/shared/simple-fetch.d.ts +21 -0
  383. package/dist/types/shared/tokens.d.ts +23 -0
  384. package/dist/types/shared/validate.d.ts +22 -0
  385. package/dist/types/start.d.ts +1 -0
  386. package/dist/types/test.d.ts +1 -0
  387. package/dist/types/websocket/index.d.ts +2 -0
  388. package/dist/types/websocket/manager.d.ts +99 -0
  389. package/dist/types/websocket/socket.io.d.ts +10 -0
  390. package/package.json +23 -8
  391. package/src/auth.ts +87 -0
  392. package/src/cluster.ts +62 -0
  393. package/src/index.ts +2 -0
  394. package/src/middleware/404.ts +13 -0
  395. package/src/middleware/cache.ts +15 -0
  396. package/src/middleware/connection.ts +48 -0
  397. package/src/middleware/context.ts +23 -0
  398. package/src/middleware/cors.ts +49 -0
  399. package/src/middleware/swagger.ts +19 -0
  400. package/src/middleware/user.ts +51 -0
  401. package/src/{ts/oauth-providers → oauth-providers}/dropbox.ts +1 -1
  402. package/src/{ts/oauth-providers → oauth-providers}/facebook.ts +1 -1
  403. package/src/{ts/oauth-providers → oauth-providers}/google.ts +1 -1
  404. package/src/oauth-providers/index.ts +20 -0
  405. package/src/{ts/oauth-providers → oauth-providers}/instagram.ts +1 -1
  406. package/src/{ts/oauth-providers → oauth-providers}/oauth-provider.ts +0 -0
  407. package/src/{ts/oauth-providers → oauth-providers}/spotify.ts +1 -1
  408. package/src/routes/auth-change-password.ts +89 -0
  409. package/src/{ts/routes → routes}/auth-change-password.yaml +0 -2
  410. package/src/routes/auth-delete.ts +47 -0
  411. package/src/{ts/routes → routes}/auth-delete.yaml +0 -0
  412. package/src/routes/auth-forgot-password.ts +73 -0
  413. package/src/{ts/routes → routes}/auth-forgot-password.yaml +0 -0
  414. package/src/routes/auth-reset-password.ts +93 -0
  415. package/src/{ts/routes → routes}/auth-reset-password.yaml +0 -0
  416. package/src/routes/auth-signin.ts +55 -0
  417. package/src/{ts/routes → routes}/auth-signin.yaml +5 -5
  418. package/src/routes/auth-signout.ts +61 -0
  419. package/src/{ts/routes → routes}/auth-signout.yaml +0 -0
  420. package/src/routes/auth-signup.ts +161 -0
  421. package/src/{ts/routes → routes}/auth-signup.yaml +15 -0
  422. package/src/routes/auth-state.ts +20 -0
  423. package/src/{ts/routes → routes}/auth-state.yaml +0 -0
  424. package/src/routes/auth-update.ts +147 -0
  425. package/src/{ts/routes → routes}/auth-update.yaml +22 -2
  426. package/src/routes/auth-verify-email.ts +67 -0
  427. package/src/{ts/routes → routes}/auth-verify-email.yaml +0 -0
  428. package/src/routes/auth.ts +67 -0
  429. package/src/routes/data-exists.ts +31 -0
  430. package/src/routes/data-exists.yaml +44 -0
  431. package/src/routes/data-export.ts +51 -0
  432. package/src/routes/data-export.yaml +64 -0
  433. package/src/routes/data-get.ts +68 -0
  434. package/src/routes/data-get.yaml +54 -0
  435. package/src/routes/data-import.ts +56 -0
  436. package/src/routes/data-import.yaml +75 -0
  437. package/src/routes/data-index-create.ts +85 -0
  438. package/src/routes/data-index-create.yaml +105 -0
  439. package/src/routes/data-index-delete.ts +39 -0
  440. package/src/routes/data-index-delete.yaml +51 -0
  441. package/src/routes/data-index-list.ts +42 -0
  442. package/src/routes/data-index-list.yaml +80 -0
  443. package/src/routes/data-query.ts +97 -0
  444. package/src/routes/data-query.yaml +166 -0
  445. package/src/routes/data-reflect.ts +94 -0
  446. package/src/routes/data-reflect.yaml +124 -0
  447. package/src/routes/data-schema-get.ts +38 -0
  448. package/src/routes/data-schema-get.yaml +53 -0
  449. package/src/routes/data-schema-set.ts +38 -0
  450. package/src/routes/data-schema-set.yaml +60 -0
  451. package/src/routes/data-schema-test.ts +53 -0
  452. package/src/routes/data-schema-test.yaml +66 -0
  453. package/src/routes/data-schemas-list.ts +33 -0
  454. package/src/routes/data-schemas-list.yaml +41 -0
  455. package/src/routes/data-set.ts +76 -0
  456. package/src/routes/data-set.yaml +71 -0
  457. package/src/routes/data-sync-changes.ts +78 -0
  458. package/src/routes/data-sync-changes.yaml +67 -0
  459. package/src/routes/data-sync-mutations.ts +78 -0
  460. package/src/routes/data-sync-mutations.yaml +67 -0
  461. package/src/routes/data-transaction-finish.yaml +76 -0
  462. package/src/routes/data-transaction-start.yaml +58 -0
  463. package/src/routes/data-transaction.ts +144 -0
  464. package/src/routes/data-update.ts +77 -0
  465. package/src/routes/data-update.yaml +71 -0
  466. package/src/routes/data.ts +79 -0
  467. package/src/routes/docs.ts +249 -0
  468. package/src/routes/meta-info.ts +80 -0
  469. package/src/routes/meta-info.yaml +41 -0
  470. package/src/routes/meta-ping.ts +15 -0
  471. package/src/routes/meta-ping.yaml +23 -0
  472. package/src/routes/meta-stats.ts +31 -0
  473. package/src/routes/meta-stats.yaml +41 -0
  474. package/src/routes/meta.ts +18 -0
  475. package/src/routes/oauth2-init.ts +44 -0
  476. package/src/{ts/routes → routes}/oauth2-init.yaml +0 -0
  477. package/src/routes/oauth2-refresh.ts +39 -0
  478. package/src/{ts/routes → routes}/oauth2-refresh.yaml +0 -0
  479. package/src/routes/oauth2-signin.ts +281 -0
  480. package/src/{ts/routes → routes}/oauth2-signin.yaml +0 -0
  481. package/src/routes/webmanager.ts +29 -0
  482. package/src/rules.ts +196 -0
  483. package/src/schema/user.ts +99 -0
  484. package/src/server.ts +416 -0
  485. package/src/settings/email.ts +18 -0
  486. package/src/settings/index.ts +241 -0
  487. package/src/shared/clients.ts +31 -0
  488. package/src/shared/email.ts +33 -0
  489. package/src/shared/env.ts +38 -0
  490. package/src/shared/error.ts +37 -0
  491. package/src/shared/http.ts +24 -0
  492. package/src/shared/password.ts +41 -0
  493. package/src/shared/rootpath.ts +15 -0
  494. package/src/shared/signin.ts +143 -0
  495. package/src/{ts/oauth-providers → shared}/simple-fetch.ts +2 -2
  496. package/src/shared/tokens.ts +77 -0
  497. package/src/shared/validate.ts +53 -0
  498. package/src/{start.js → start.ts} +7 -5
  499. package/src/test.ts +10 -0
  500. package/src/websocket/index.ts +320 -0
  501. package/src/websocket/manager.ts +46 -0
  502. package/src/websocket/socket.io.ts +91 -0
  503. package/tsconfig-cjs.json +10 -0
  504. package/tsconfig.json +13 -5
  505. package/{src/webmanager → webmanager}/index.html +0 -0
  506. package/{src/webmanager → webmanager}/index.js +0 -0
  507. package/src/acebase-server.js +0 -3060
  508. package/src/index.d.ts +0 -212
  509. package/src/index.js +0 -2
  510. package/src/routes/docs.js +0 -97
  511. package/src/ts/routes/docs.ts +0 -100
package/src/server.ts ADDED
@@ -0,0 +1,416 @@
1
+ import { ColorStyle, DebugLogger, SimpleEventEmitter } from 'acebase-core';
2
+ import { AceBaseServerSettings, AceBaseServerConfig } from './settings';
3
+ import { createApp } from './shared/http';
4
+ import { addWebsocketServer } from './websocket';
5
+ import { RouteInitEnvironment } from './shared/env';
6
+ import { ConnectedClient } from './shared/clients';
7
+ import { AceBase, AceBaseLocalSettings, AceBaseStorageSettings } from 'acebase';
8
+ import { createServer } from 'http';
9
+ import { createServer as createSecureServer } from 'https';
10
+ import { IOAuth2Provider } from './oauth-providers/oauth-provider';
11
+ import oAuth2Providers from './oauth-providers';
12
+ import { PathBasedRules } from './rules';
13
+ import { DbUserAccountDetails } from './schema/user';
14
+ import { Api } from 'acebase-core/src/api';
15
+ import addConnectionMiddleware from './middleware/connection';
16
+ import addCorsMiddleware from './middleware/cors';
17
+ import addAuthenticionRoutes from './routes/auth';
18
+ import setupAuthentication from './auth';
19
+ import addDataRoutes from './routes/data';
20
+ import addDocsRoute from './routes/docs';
21
+ import addWebManagerRoutes from './routes/webmanager';
22
+ import addMetadataRoutes from './routes/meta';
23
+ import add404Middleware from './middleware/404';
24
+ import addSwaggerMiddleware from './middleware/swagger';
25
+ import addCacheMiddleware from './middleware/cache';
26
+
27
+ type PrivateStorageSettings = AceBaseStorageSettings & { info?: string; type?: 'data'|'transaction'|'auth'|'log' };
28
+ // type PrivateLocalSettings = AceBaseLocalSettings & { storage: PrivateStorageSettings };
29
+
30
+ export class AceBaseServerNotReadyError extends Error {
31
+ constructor() { super('Server is not ready yet'); }
32
+ }
33
+
34
+ export class AceBaseServer extends SimpleEventEmitter {
35
+
36
+ private _ready: boolean = false;
37
+ get isReady() { return this._ready; }
38
+
39
+ /**
40
+ * Wait for the server to be ready to accept incoming connections
41
+ * @param callback (optional) callback function that is called when ready. You can also use the returned promise
42
+ * @returns returns a promise that resolves when ready
43
+ */
44
+ async ready(callback?: () => any) {
45
+ if (!this._ready) {
46
+ await this.once('ready');
47
+ }
48
+ callback?.();
49
+ }
50
+
51
+ /**
52
+ * Gets the active server configuration
53
+ */
54
+ readonly config: AceBaseServerConfig;
55
+
56
+ /**
57
+ * Gets the url the server is running at
58
+ */
59
+ get url() {
60
+ return `http${this.config.https.enabled ? 's' : ''}://${this.config.host}:${this.config.port}`;
61
+ }
62
+
63
+ readonly debug: DebugLogger;
64
+
65
+ /**
66
+ * Gets direct access to the database, this bypasses any security rules and schema validators.
67
+ * You can use this to add custom event handlers ("cloud functions") to your database directly.
68
+ * NOTE: your code will run in the same thread as the server, make sure you are not performing
69
+ * CPU heavy tasks here. If you have to do heavy weightlifting, create a seperate app that connects
70
+ * to your server with an AceBaseClient, or execute in a worker thread.
71
+ * @example
72
+ * server.db.ref('uploads/images').on('child_added', async snap => {
73
+ * const image = snap.val();
74
+ * const resizedImages = await createImageSizes(image); // Some function that creates multiple image sizes in worker thread
75
+ * const targetRef = await server.db.ref('images').push(resizedImages); // Store them somewhere else
76
+ * await snap.ref.remove(); // Remove original upload
77
+ * });
78
+ */
79
+ readonly db: AceBase;
80
+
81
+ /**
82
+ * Exposes the used http frameworks app (currently Express) for external use.
83
+ */
84
+ readonly app: ReturnType<typeof createApp>;
85
+
86
+ private readonly authProviders: { [provider: string]: IOAuth2Provider } = {};
87
+
88
+ constructor(dbname: string, options?: AceBaseServerSettings) {
89
+ super();
90
+
91
+ this.config = new AceBaseServerConfig(options);
92
+ this.debug = new DebugLogger(this.config.logLevel, `[${dbname}]`.colorize(ColorStyle.green));
93
+
94
+ if (this.config.auth.enabled && !this.config.https.enabled) {
95
+ this.debug.warn(`WARNING: Authentication is enabled, but the server is not using https. Any password and other data transmitted may be intercepted!`.colorize(ColorStyle.red));
96
+ }
97
+ else if (!this.config.https.enabled) {
98
+ this.debug.warn(`WARNING: Server is not using https, any data transmitted may be intercepted!`.colorize(ColorStyle.red));
99
+ }
100
+ if (!this.config.auth.enabled) {
101
+ this.debug.warn(`WARNING: Authentication is disabled, *anyone* can do *anything* with your data!`.colorize(ColorStyle.red));
102
+ }
103
+
104
+ // Open database(s)
105
+ const dbOptions: AceBaseLocalSettings & { info: string } = {
106
+ logLevel: this.config.logLevel,
107
+ info: 'realtime database server',
108
+ // NEW: Allow storage setting like AceBaseLocalSettings - could allow using other db backend (typed, but undocumented)
109
+ storage: this.config.storage || {
110
+ path: this.config.path,
111
+ removeVoidProperties: true,
112
+ },
113
+ transactions: this.config.transactions,
114
+ ipc: this.config.ipc
115
+ };
116
+ this.db = new AceBase(dbname, dbOptions);
117
+
118
+ const otherDbsPath = `${this.config.path}/${this.db.name}.acebase`;
119
+ const authDb = (() => {
120
+ if (!this.config.auth.enabled) {
121
+ return null;
122
+ }
123
+ switch (this.config.auth.separateDb) {
124
+ case true: return new AceBase('auth', { logLevel: dbOptions.logLevel, storage: <PrivateStorageSettings>{ path: otherDbsPath, removeVoidProperties: true, info: `${dbname} auth database` } });
125
+ case 'v2': /*NOT TESTED YET*/return new AceBase(dbname, { logLevel: dbOptions.logLevel, storage: <PrivateStorageSettings>{ type: 'auth', path: this.config.path, removeVoidProperties: true, info: `${dbname} auth database` } });
126
+ default: return this.db;
127
+ }
128
+ })();
129
+
130
+ // Create Express app
131
+ this.app = createApp({ trustProxy: true, maxPayloadSize: this.config.maxPayloadSize });
132
+
133
+ // Initialize and start server
134
+ this.init({ authDb });
135
+ }
136
+
137
+ private async init(env: { authDb?: AceBase }) {
138
+ const config = this.config;
139
+ const db = this.db;
140
+ const authDb = env.authDb;
141
+
142
+ // Wait for databases to be ready to use
143
+ await Promise.all([
144
+ db.ready(),
145
+ authDb?.ready()
146
+ ]);
147
+
148
+ // Create http server
149
+ const app = this.app;
150
+ const server = config.https.enabled ? createSecureServer(config.https, app) : createServer(app);
151
+ const clients = new Map<string, ConnectedClient>();
152
+
153
+ const securityRef = authDb ? authDb === db ? db.ref('__auth__/security') : authDb.ref('security') : null;
154
+ const authRef = authDb ? authDb === db ? db.ref('__auth__/accounts') : authDb.ref('accounts') : null;
155
+ const logRef = authDb ? authDb === db ? db.ref('__log__') : authDb.ref('log') : null;
156
+
157
+ // Setup rules
158
+ const rulesFilePath = `${this.config.path}/${this.db.name}.acebase/rules.json`;
159
+ const rules = new PathBasedRules(rulesFilePath, config.auth.defaultAccessRule, { db, debug: this.debug, authEnabled: this.config.auth.enabled });
160
+
161
+ const routeEnv: RouteInitEnvironment = {
162
+ config: this.config,
163
+ server,
164
+ db: db as AceBase & { api: Api },
165
+ authDb,
166
+ app,
167
+ debug: this.debug,
168
+ securityRef,
169
+ authRef,
170
+ logRef,
171
+ tokenSalt: null,
172
+ clients,
173
+ authCache: null,
174
+ authProviders: this.authProviders,
175
+ rules
176
+ };
177
+
178
+ // Add connection middleware
179
+ const killConnections = addConnectionMiddleware(routeEnv);
180
+
181
+ // Add CORS middleware
182
+ addCorsMiddleware(routeEnv);
183
+
184
+ // Add cache middleware
185
+ addCacheMiddleware(routeEnv);
186
+
187
+ if (config.auth.enabled) {
188
+ // Setup auth database
189
+ await setupAuthentication(routeEnv);
190
+
191
+ // Add auth endpoints
192
+ const { resetPassword, verifyEmailAddress } = addAuthenticionRoutes(routeEnv);
193
+ this.resetPassword = resetPassword;
194
+ this.verifyEmailAddress = verifyEmailAddress;
195
+ }
196
+
197
+ // Add metadata endpoints
198
+ addMetadataRoutes(routeEnv);
199
+
200
+ // If environment is development, add API docs
201
+ if (process.env.NODE_ENV?.trim?.() === 'development') {
202
+ this.debug.warn('DEVELOPMENT MODE: adding API docs endpoint at /docs');
203
+ addDocsRoute(routeEnv);
204
+ addSwaggerMiddleware(routeEnv);
205
+ }
206
+
207
+ // Add data endpoints
208
+ addDataRoutes(routeEnv);
209
+
210
+ // Add webmanager endpoints
211
+ addWebManagerRoutes(routeEnv);
212
+
213
+ // Allow adding custom routes
214
+ this.extend = (method: 'get'|'put'|'post'|'delete', ext_path: string, handler: (req: Express.Request, res: Express.Response) => any) => {
215
+ const route = `/ext/${db.name}/${ext_path}`;
216
+ this.debug.log(`Extending server: `, method, route);
217
+ routeEnv.app[method.toLowerCase()](route, handler);
218
+ };
219
+
220
+ // Create websocket server
221
+ addWebsocketServer(routeEnv);
222
+
223
+ // Last but not least, add 404 handler
224
+ // DISABLED because it causes server extension routes through server.extend (see above) not be be executed
225
+ // add404Middleware(routeEnv);
226
+
227
+ // Start listening
228
+ server.listen(config.port, config.host, () => {
229
+ // Ready!!
230
+ this.debug.log(`"${db.name}" database server running at ${this.url}`);
231
+ this._ready = true;
232
+ this.emitOnce(`ready`);
233
+ });
234
+
235
+ // Setup pause and resume methods
236
+ let paused = false;
237
+ this.pause = async () => {
238
+ if (paused) { throw new Error('Server is already paused'); }
239
+ server.close();
240
+ this.debug.warn(`Paused "${db.name}" database server at ${this.url}`);
241
+ this.emit('pause');
242
+ paused = true;
243
+ };
244
+ this.resume = async () => {
245
+ if (!paused) { throw new Error('Server is not paused'); }
246
+ return new Promise(resolve => {
247
+ server.listen(config.port, config.host, () => {
248
+ this.debug.warn(`Resumed "${db.name}" database server at ${this.url}`);
249
+ this.emit('resume');
250
+ paused = false;
251
+ resolve();
252
+ });
253
+ })
254
+ };
255
+
256
+ // Handle SIGINT and shutdown requests
257
+ const shutdown = async (request: { sigint: boolean }) => {
258
+ this.debug.warn('shutting down server');
259
+ routeEnv.rules.stop();
260
+
261
+ const getConnectionsCount = () => {
262
+ return new Promise<number>((resolve, reject) => {
263
+ server.getConnections((err, connections) => {
264
+ if (err) { reject(err); }
265
+ else { resolve(connections); }
266
+ });
267
+ });
268
+ };
269
+ const connections = await getConnectionsCount();
270
+ this.debug.log(`Server has ${connections} connections`);
271
+
272
+ await new Promise<void>((resolve) => {
273
+ // const interval = setInterval(async () => {
274
+ // const connections = await getConnectionsCount();
275
+ // this.debug.log(`Server still has ${connections} connections`);
276
+ // }, 5000);
277
+ // interval.unref();
278
+
279
+ server.close(err => {
280
+ if (err) { console.error(`server.close() error: ${err.message}`); }
281
+ else { console.log(`server.close() success`); }
282
+ resolve();
283
+ });
284
+
285
+ // If for some reason connection aren't broken in time - do proceed with shutdown sequence
286
+ const timeout = setTimeout(() => {
287
+ console.warn(`server.close() timed out, there are still open connections`);
288
+ killConnections();
289
+ // resolve();
290
+ }, 5000);
291
+ timeout.unref();
292
+
293
+ console.log(`Closing ${clients.size} websocket connections`);
294
+ clients.forEach((client, id) => {
295
+ const socket = client.socket;
296
+ socket.once('disconnect', reason => {
297
+ console.log(`Socket ${socket.id} disconnected: ${reason}`);
298
+ })
299
+ socket.disconnect(true);
300
+ });
301
+
302
+ // clients.list.slice().forEach(client => {
303
+ // client.socket.disconnect(true);
304
+ // });
305
+ });
306
+ this.debug.warn('closing database');
307
+ await db.close();
308
+ this.debug.warn('shutdown complete');
309
+
310
+ // Emit events to let the outside world know we shut down.
311
+ // This is especially important if this instance was running in a Node.js cluster: the process will
312
+ // not exit automatically after this shutdown because Node.js' IPC channel between worker and master is still open.
313
+ // By sending these events, the cluster manager can determine if it should (and when to) execute process.exit()
314
+
315
+ // process.emit('acebase-server-shutdown'); // Emit on process
316
+ process.emit('beforeExit', request.sigint ? 130 : 0); // Emit on process
317
+ try {
318
+ process.send && process.send('acebase-server-shutdown'); // Send to master process when running in a Node.js cluster
319
+ }
320
+ catch(err) {
321
+ // IPC Channel has apparently been closed already
322
+ }
323
+ this.emit('shutdown'); // Emit on AceBaseServer instance
324
+ };
325
+ this.shutdown = async () => await shutdown({ sigint: false });
326
+ process.on('SIGINT', () => shutdown({ sigint: true }));
327
+ }
328
+
329
+ /**
330
+ * Reset a user's password. This can also be done using the auth/reset_password API endpoint
331
+ * @param clientIp ip address of the user
332
+ * @param code reset code that was sent to the user's email address
333
+ * @param newPassword new password chosen by the user
334
+ */
335
+ resetPassword (clientIp: string, code: string, newPassword: string): Promise<DbUserAccountDetails> {
336
+ throw new AceBaseServerNotReadyError();
337
+ }
338
+
339
+ /**
340
+ * Marks a user account's email address as validated. This can also be done using the auth/verify_email API endpoint
341
+ * @param clientIp ip address of the user
342
+ * @param code verification code sent to the user's email address
343
+ */
344
+ verifyEmailAddress (clientIp: string, code: string): Promise<void> {
345
+ throw new AceBaseServerNotReadyError();
346
+ }
347
+
348
+ /**
349
+ * Shuts down the server. Stops listening for incoming connections, breaks current connections and closes the database.
350
+ * Is automatically executed when a "SIGINT" process event is received.
351
+ *
352
+ * Once the shutdown procedure is completed, it emits a "shutdown" event on the server instance, "acebase-server-shutdown" event on the `process`, and sends an 'acebase-server-shutdown' IPC message if Node.js clustering is used.
353
+ * These events can be handled by cluster managing code to `kill` or `exit` the process safely.
354
+ */
355
+ shutdown() {
356
+ throw new AceBaseServerNotReadyError();
357
+ }
358
+
359
+ /**
360
+ * Temporarily stops the server from handling incoming connections, but keeps existing connections open
361
+ */
362
+ pause(): Promise<void> {
363
+ throw new AceBaseServerNotReadyError();
364
+ }
365
+
366
+ /**
367
+ * Resumes handling incoming connections
368
+ */
369
+ resume(): Promise<void> {
370
+ throw new AceBaseServerNotReadyError();
371
+ }
372
+
373
+ /**
374
+ * Extend the server API with your own custom functions. Your handler will be listening
375
+ * on path /ext/[db name]/[ext_path].
376
+ * @example
377
+ * // Server side:
378
+ * const _quotes = [...];
379
+ * server.extend('get', 'quotes/random', (req, res) => {
380
+ * let index = Math.round(Math.random() * _quotes.length);
381
+ * res.send(quotes[index]);
382
+ * })
383
+ * // Client side:
384
+ * client.callExtension('get', 'quotes/random')
385
+ * .then(quote => {
386
+ * console.log(`Got random quote: ${quote}`);
387
+ * })
388
+ * @param {'get'|'put'|'post'|'delete'} method
389
+ * @param {string} ext_path
390
+ * @param {(req: Express.Request, res: Express.Response)} handler
391
+ */
392
+ extend(method: 'get'|'put'|'post'|'delete', ext_path: string, handler: (req: Express.Request, res: Express.Response) => void) {
393
+ throw new AceBaseServerNotReadyError();
394
+ }
395
+
396
+ /**
397
+ * Configure an auth provider to allow users to sign in with Facebook, Google, etc
398
+ * @param providerName name of the third party OAuth provider. Eg: "Facebook", "Google", "spotify" etc
399
+ * @param settings API key & secret for the OAuth provider
400
+ * @returns Returns the created auth provider instance, which can be used to call non-user specific methods the provider might support. (example: the Spotify auth provider supports getClientAuthToken, which allows API calls to be made to the core (non-user) spotify service)
401
+ */
402
+ configAuthProvider(providerName: string, settings: any) {
403
+ if (!this.config.auth.enabled) {
404
+ throw new Error(`Authentication is not enabled`);
405
+ }
406
+ try {
407
+ const AuthProvider = oAuth2Providers[providerName];
408
+ const provider = new AuthProvider(settings);
409
+ this.authProviders[providerName] = provider;
410
+ return provider;
411
+ }
412
+ catch(err) {
413
+ throw new Error(`Failed to configure provider ${providerName}: ${err.message}`)
414
+ }
415
+ }
416
+ }
@@ -0,0 +1,18 @@
1
+ import { AceBaseEmailRequest } from '../shared/email';
2
+
3
+ export interface AceBaseServerEmailServerSettings {
4
+ host: string;
5
+ port: number;
6
+ username?: string;
7
+ password?: string;
8
+ secure: boolean;
9
+ };
10
+
11
+ export interface AceBaseServerEmailSettings {
12
+
13
+ /** NOT IMPLEMENTED YET - Use send property for your own implementation */
14
+ server?: AceBaseServerEmailServerSettings;
15
+
16
+ /** function to call when an e-mail needs to be sent */
17
+ send: (request: AceBaseEmailRequest) => Promise<boolean>;
18
+ };
@@ -0,0 +1,241 @@
1
+ import { AceBaseStorageSettings } from 'acebase';
2
+ import { readFileSync } from 'fs';
3
+ import { AceBaseServerEmailSettings } from './email';
4
+
5
+ export type AceBaseServerHttpsSettings = {
6
+ enabled?: boolean;
7
+ keyPath?: string;
8
+ certPath?: string
9
+ pfxPath?: string;
10
+ passphrase?: string
11
+ } & (
12
+ { keyPath: string; certPath: string } |
13
+ { pfxPath: string; passphrase: string } |
14
+ {}
15
+ )
16
+
17
+ export class AceBaseServerHttpsConfig {
18
+ enabled: boolean = true;
19
+ key?: Buffer;
20
+ cert?: Buffer;
21
+ pfx?: Buffer;
22
+ passphrase?: string;
23
+
24
+ constructor(settings: AceBaseServerHttpsSettings) {
25
+ this.enabled = typeof settings === "object" && settings.enabled !== false;
26
+ if (!this.enabled) { return; }
27
+ if (settings.keyPath) {
28
+ this.key = readFileSync(settings.keyPath);
29
+ this.cert = readFileSync(settings.certPath);
30
+ }
31
+ else if (settings.pfxPath) {
32
+ this.pfx = readFileSync(settings.pfxPath);
33
+ this.passphrase = settings.passphrase;
34
+ }
35
+ }
36
+ }
37
+
38
+ export enum AUTH_ACCESS_DEFAULT {
39
+ DENY_ALL = 'deny',
40
+ ALLOW_ALL = 'allow',
41
+ ALLOW_AUTHENTICATED = 'auth'
42
+ }
43
+
44
+ export class AceBaseServerAuthenticationSettings {
45
+
46
+ /**
47
+ * Whether to enable authorization. Without authorization the entire db can be read and written to by anyone (not recommended 🤷🏼‍♂️)
48
+ */
49
+ readonly enabled: boolean = true;
50
+
51
+ /**
52
+ * Whether new users creation is allowed for anyone, or just the admin
53
+ */
54
+ readonly allowUserSignup: boolean = false;
55
+
56
+ /**
57
+ * How many new users can sign up per hour per IP address. not implemented yet
58
+ */
59
+ readonly newUserRateLimit: number = 0;
60
+
61
+ /**
62
+ * How many minutes before access tokens expire. 0 for no expiration. (not implemented yet)
63
+ */
64
+ readonly tokensExpire: number = 0;
65
+
66
+ /**
67
+ * When the server runs for the first time, what defaults to use to generate the rules.json file with. Options are: 'auth' (only authenticated access to db, default), 'deny' (deny access to anyone except admin user), 'allow' (allow access to anyone)
68
+ */
69
+ readonly defaultAccessRule: AUTH_ACCESS_DEFAULT = AUTH_ACCESS_DEFAULT.ALLOW_AUTHENTICATED;
70
+
71
+ /**
72
+ * When the server runs for the first time, what password to use for the admin user. If not supplied, a generated password will be used and shown ONCE in the console output.
73
+ */
74
+ readonly defaultAdminPassword?: string;
75
+
76
+ /**
77
+ * Whether to use a separate database for auth and logging. 'v2' will store data in auth.db, which is NOT TESTED YET!
78
+ */
79
+ readonly separateDb: boolean|'v2' = false;
80
+
81
+ constructor(settings: Partial<AceBaseServerAuthenticationSettings>) {
82
+ if (typeof settings !== "object") { settings = {}; }
83
+ if (typeof settings.enabled === 'boolean') { this.enabled = settings.enabled; }
84
+ if (typeof settings.allowUserSignup === 'boolean') { this.allowUserSignup = settings.allowUserSignup; }
85
+ if (typeof settings.newUserRateLimit === 'number') { this.newUserRateLimit = settings.newUserRateLimit; }
86
+ if (typeof settings.tokensExpire === 'number') { this.tokensExpire = settings.tokensExpire; }
87
+ if (typeof settings.defaultAccessRule === 'string') { this.defaultAccessRule = settings.defaultAccessRule; }
88
+ if (typeof settings.defaultAdminPassword === 'string') { this.defaultAdminPassword = settings.defaultAdminPassword; }
89
+ if (typeof (settings as any).seperateDb === 'boolean') { this.separateDb = (settings as any).seperateDb; } // Handle previous _wrong_ spelling
90
+ if (typeof settings.separateDb === 'boolean') { this.separateDb = settings.separateDb; }
91
+ }
92
+ }
93
+
94
+ /**
95
+ * TODO: Use AceBaseTransactionLogSettings from 'acebase/src/storage-acebase.js'
96
+ */
97
+ export class AceBaseServerTransactionSettings {
98
+ /**
99
+ * Whether to enable transaction logging
100
+ */
101
+ log: boolean = false;
102
+
103
+ /**
104
+ * Max age in days to keep transactions in the log file
105
+ */
106
+ maxAge: number = 30;
107
+
108
+ /**
109
+ * Whether database write operations should not wait until transaction has been logged
110
+ */
111
+ noWait: boolean = false;
112
+
113
+ constructor(settings: Partial<AceBaseServerTransactionSettings>) {
114
+ if (typeof settings !== 'object') { return; }
115
+ if (typeof settings.log === 'boolean') { this.log = settings.log; }
116
+ if (typeof settings.maxAge === 'number') { this.maxAge = settings.maxAge; }
117
+ if (typeof settings.noWait === 'boolean') { this.noWait = settings.noWait; }
118
+ }
119
+ }
120
+
121
+ export interface IPCClientSettings {
122
+ /**
123
+ * IPC Server host to connect to. Default is `"localhost"`
124
+ */
125
+ host?: string;
126
+
127
+ /**
128
+ * IPC Server port number
129
+ */
130
+ port: number;
131
+
132
+ /**
133
+ * Whether to use a secure connection to the server. Strongly recommended if `host` is not `"localhost"`. Default is `false`
134
+ */
135
+ ssl?: boolean;
136
+
137
+ /**
138
+ * Token used in the IPC Server configuration (optional). The server will refuse connections using the wrong token.
139
+ */
140
+ token?: string;
141
+
142
+ /**
143
+ * Determines the role of this IPC client. Only 1 process can be assigned the 'master' role, all other processes must use the role 'worker'
144
+ */
145
+ role: 'master'|'worker';
146
+ }
147
+
148
+ export type AceBaseServerSettings = Partial<{
149
+ /**
150
+ * Level of messages logged to console
151
+ */
152
+ logLevel: 'verbose'|'log'|'warn'|'error';
153
+
154
+ /**
155
+ * ip or hostname to start the server on
156
+ */
157
+ host: string;
158
+
159
+ /**
160
+ * port number the server will be listening
161
+ */
162
+ port: number;
163
+
164
+ /**
165
+ * target directory path to store/open the database. Default is '.'
166
+ */
167
+ path: string;
168
+
169
+ /**
170
+ * Whether to use secure sockets layer (ssl)
171
+ */
172
+ https: AceBaseServerHttpsSettings;
173
+
174
+ /**
175
+ * settings that define if and how authentication is used
176
+ */
177
+ authentication: Partial<AceBaseServerAuthenticationSettings>;
178
+
179
+ /**
180
+ * maximum size to allow for posted data, eg for updating nodes. Default is '10mb'
181
+ */
182
+ maxPayloadSize: string;
183
+
184
+ /**
185
+ * Value to use for Access-Control-Allow-Origin CORS header. Default is '*'
186
+ */
187
+ allowOrigin: string;
188
+
189
+ /**
190
+ * Email settings that enable AceBaseServer to send e-mails, eg for welcoming new users, to reset passwords, notify of new sign ins etc
191
+ */
192
+ email: AceBaseServerEmailSettings;
193
+
194
+ /**
195
+ * Transaction logging settings. Warning: BETA stage, do NOT use in production yet
196
+ */
197
+ transactions: Partial<AceBaseServerTransactionSettings>;
198
+
199
+ /**
200
+ * IPC settings for pm2 or cloud-based clusters. BETA stage, see https://github.com/appy-one/acebase-ipc-server
201
+ */
202
+ ipc: IPCClientSettings;
203
+
204
+ /**
205
+ * Allows overriding of default storage settings used by the database. ALPHA stage
206
+ */
207
+ storage: AceBaseStorageSettings;
208
+ }>
209
+
210
+ export class AceBaseServerConfig {
211
+
212
+ readonly logLevel: 'verbose'|'log'|'warn'|'error' = 'log';
213
+ readonly host: string = 'localhost';
214
+ readonly port: number = 3000;
215
+ readonly path: string = '.';
216
+ readonly maxPayloadSize: string = '10mb';
217
+ readonly allowOrigin: string = '*';
218
+ readonly https: AceBaseServerHttpsConfig;
219
+ readonly auth: AceBaseServerAuthenticationSettings;
220
+ readonly email: AceBaseServerEmailSettings;
221
+ readonly transactions: AceBaseServerTransactionSettings;
222
+ readonly ipc: IPCClientSettings;
223
+
224
+ readonly storage?: AceBaseStorageSettings;
225
+
226
+ constructor(settings: AceBaseServerSettings) {
227
+ if (typeof settings !== "object") { settings = {}; }
228
+ if (typeof settings.logLevel === 'string') { this.logLevel = settings.logLevel; }
229
+ if (typeof settings.host === 'string') { this.host = settings.host; }
230
+ if (typeof settings.port === 'number') { this.port = settings.port; }
231
+ if (typeof settings.path === 'string') { this.path = settings.path; }
232
+ this.https = new AceBaseServerHttpsConfig(settings.https);
233
+ this.auth = new AceBaseServerAuthenticationSettings(settings.authentication);
234
+ if (typeof settings.maxPayloadSize === 'string') { this.maxPayloadSize = settings.maxPayloadSize; }
235
+ if (typeof settings.allowOrigin === 'string') { this.allowOrigin = settings.allowOrigin; }
236
+ if (typeof settings.email === 'object') { this.email = settings.email; }
237
+ this.transactions = new AceBaseServerTransactionSettings(settings.transactions);
238
+ this.ipc = settings.ipc;
239
+ if (typeof settings.storage === 'object') { this.storage = settings.storage; }
240
+ }
241
+ }