@openstax/ts-utils 1.33.1 → 1.34.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 (504) hide show
  1. package/.cfnlintrc +2 -0
  2. package/.github/CODEOWNERS +1 -0
  3. package/.github/workflows/ci.yml +36 -0
  4. package/.github/workflows/lint.yml +55 -0
  5. package/.nvmrc +1 -0
  6. package/.syncignore +4 -0
  7. package/.syncpackrc +18 -0
  8. package/CONTRIBUTING.md +96 -0
  9. package/LICENSE +661 -0
  10. package/Procfile +1 -0
  11. package/README.md +62 -90
  12. package/app.json +23 -0
  13. package/cspell.json +32 -0
  14. package/deploy/constants.env +21 -0
  15. package/deploy/deploy.bash +157 -0
  16. package/deploy/deployment-alt-region.cfn.yml +70 -0
  17. package/deploy/deployment.cfn.yml +650 -0
  18. package/deploy/destroy-deployment.bash +23 -0
  19. package/deploy/shared.cfn.yml +94 -0
  20. package/docs/lambda-build.md +35 -0
  21. package/package.json +12 -228
  22. package/packages/frontend/README.md +46 -0
  23. package/packages/frontend/package.json +101 -0
  24. package/packages/frontend/public/favicon.ico +0 -0
  25. package/packages/frontend/public/index.html +107 -0
  26. package/packages/frontend/public/maintenance.html +59 -0
  27. package/packages/frontend/public/manifest.json +15 -0
  28. package/packages/frontend/public/robots.txt +3 -0
  29. package/packages/frontend/script/make-certificate.bash +49 -0
  30. package/packages/frontend/script/server/cli.js +11 -0
  31. package/packages/frontend/script/server/index.js +47 -0
  32. package/packages/frontend/script/start.bash +22 -0
  33. package/packages/frontend/script/trust-localhost.bash +7 -0
  34. package/packages/frontend/src/auth/authProvider.ts +10 -0
  35. package/packages/frontend/src/auth/useAuth.ts +33 -0
  36. package/packages/frontend/src/components/Pagination.tsx +26 -0
  37. package/packages/frontend/src/configProvider/index.ts +53 -0
  38. package/packages/frontend/src/configProvider/use.ts +41 -0
  39. package/packages/frontend/src/core/context/services.spec.tsx +39 -0
  40. package/packages/frontend/src/core/context/services.tsx +16 -0
  41. package/packages/frontend/src/core/index.spec.ts +7 -0
  42. package/packages/frontend/src/core/index.ts +20 -0
  43. package/packages/frontend/src/core/services.tsx +14 -0
  44. package/packages/frontend/src/core/types.ts +3 -0
  45. package/packages/frontend/src/example/api.ts +28 -0
  46. package/packages/frontend/src/example/components/Layout.tsx +23 -0
  47. package/packages/frontend/src/example/screens/Home.spec.tsx +68 -0
  48. package/packages/frontend/src/example/screens/Home.tsx +78 -0
  49. package/packages/frontend/src/example/screens/ThingList.spec.tsx +60 -0
  50. package/packages/frontend/src/example/screens/ThingList.tsx +75 -0
  51. package/packages/frontend/src/example/screens/ThingView.spec.tsx +71 -0
  52. package/packages/frontend/src/example/screens/ThingView.tsx +47 -0
  53. package/packages/frontend/src/example/screens/index.ts +9 -0
  54. package/packages/frontend/src/index.css +159 -0
  55. package/packages/frontend/src/index.tsx +67 -0
  56. package/packages/frontend/src/react-app-env.d.ts +1 -0
  57. package/packages/frontend/src/routing/components/RouteLink.spec.tsx +55 -0
  58. package/packages/frontend/src/routing/components/RouteLink.tsx +35 -0
  59. package/packages/frontend/src/routing/middleware.ts +6 -0
  60. package/packages/frontend/src/routing/useQuery.ts +14 -0
  61. package/packages/frontend/src/setupProxy.js +19 -0
  62. package/packages/frontend/src/setupTests.ts +9 -0
  63. package/packages/frontend/src/tests/testServices.tsx +23 -0
  64. package/packages/frontend/tsconfig.json +27 -0
  65. package/packages/lambda/.eslintrc.js +64 -0
  66. package/packages/lambda/jest-global-setup.js +3 -0
  67. package/packages/lambda/jest-setup-after-env.js +1 -0
  68. package/packages/lambda/jest.config.js +31 -0
  69. package/packages/lambda/jest.resolver.js +17 -0
  70. package/packages/lambda/package.json +68 -0
  71. package/packages/lambda/script/build.bash +19 -0
  72. package/packages/lambda/script/bundle-functions.bash +10 -0
  73. package/packages/lambda/script/lambdaLocalProxy.js +16 -0
  74. package/packages/lambda/script/lambdaLocalProxy.spec.ts +147 -0
  75. package/packages/lambda/script/utils/getRouteData.ts +7 -0
  76. package/packages/lambda/script/utils/routeDataLoader.js +8 -0
  77. package/packages/lambda/script/utils/routeDataLoader.spec.ts +8 -0
  78. package/packages/lambda/src/functions/serviceApi/core/index.ts +7 -0
  79. package/packages/lambda/src/functions/serviceApi/core/request.spec.ts +38 -0
  80. package/packages/lambda/src/functions/serviceApi/core/request.ts +42 -0
  81. package/packages/lambda/src/functions/serviceApi/core/routes.spec.ts +7 -0
  82. package/packages/lambda/src/functions/serviceApi/core/routes.ts +10 -0
  83. package/packages/lambda/src/functions/serviceApi/core/services.ts +9 -0
  84. package/packages/lambda/src/functions/serviceApi/core/types.ts +13 -0
  85. package/packages/lambda/src/functions/serviceApi/entry/lambda/https-xray.ts +4 -0
  86. package/packages/lambda/src/functions/serviceApi/entry/lambda/index.spec.ts +48 -0
  87. package/packages/lambda/src/functions/serviceApi/entry/lambda/index.ts +58 -0
  88. package/packages/lambda/src/functions/serviceApi/entry/lambda/services.ts +36 -0
  89. package/packages/lambda/src/functions/serviceApi/entry/local.ts +71 -0
  90. package/packages/lambda/src/functions/serviceApi/versions/v0/example/documentSearchMiddleware.spec.ts +16 -0
  91. package/packages/lambda/src/functions/serviceApi/versions/v0/example/documentSearchMiddleware.ts +41 -0
  92. package/packages/lambda/src/functions/serviceApi/versions/v0/example/documentStoreMiddleware.spec.ts +78 -0
  93. package/packages/lambda/src/functions/serviceApi/versions/v0/example/documentStoreMiddleware.ts +70 -0
  94. package/packages/lambda/src/functions/serviceApi/versions/v0/example/routes.spec.ts +306 -0
  95. package/packages/lambda/src/functions/serviceApi/versions/v0/example/routes.ts +176 -0
  96. package/packages/lambda/src/functions/serviceApi/versions/v0/index.spec.ts +263 -0
  97. package/packages/lambda/src/functions/serviceApi/versions/v0/index.ts +134 -0
  98. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/authMiddleware.spec.ts +23 -0
  99. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/authMiddleware.ts +32 -0
  100. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/configMiddleware.spec.ts +10 -0
  101. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/configMiddleware.ts +7 -0
  102. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/frontendFileServerMiddleware.spec.ts +13 -0
  103. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/frontendFileServerMiddleware.ts +23 -0
  104. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/paginationMiddleware.spec.ts +9 -0
  105. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/paginationMiddleware.ts +9 -0
  106. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/searchMiddleware.spec.ts +12 -0
  107. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/searchMiddleware.ts +21 -0
  108. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/userRoleValidatorMiddleware.spec.ts +21 -0
  109. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/userRoleValidatorMiddleware.ts +18 -0
  110. package/packages/lambda/tsconfig.json +30 -0
  111. package/packages/lambda/webpack.config.js +97 -0
  112. package/packages/utils/.eslintrc.js +64 -0
  113. package/packages/utils/README.md +118 -0
  114. package/packages/utils/jest-global-setup.js +3 -0
  115. package/packages/utils/jest.config.js +25 -0
  116. package/packages/utils/jest.resolver.js +17 -0
  117. package/packages/utils/package.json +238 -0
  118. package/packages/utils/src/assertions/index.spec.ts +126 -0
  119. package/{dist/esm/assertions/index.js → packages/utils/src/assertions/index.ts} +64 -49
  120. package/packages/utils/src/aws/ssmService.ts +7 -0
  121. package/packages/utils/src/config/awsParameterConfig.ts +24 -0
  122. package/packages/utils/src/config/envConfig.ts +58 -0
  123. package/packages/utils/src/config/index.spec.ts +165 -0
  124. package/{dist/esm/config/index.d.ts → packages/utils/src/config/index.ts} +29 -13
  125. package/packages/utils/src/config/lambdaParameterConfig.ts +49 -0
  126. package/{dist/esm/config/replaceConfig.js → packages/utils/src/config/replaceConfig.ts} +16 -6
  127. package/packages/utils/src/config/resolveConfigValue.ts +10 -0
  128. package/packages/utils/src/errors/index.spec.ts +35 -0
  129. package/{dist/esm/errors/index.js → packages/utils/src/errors/index.ts} +57 -41
  130. package/packages/utils/src/fetch/fetchStatusRetry.spec.ts +197 -0
  131. package/packages/utils/src/fetch/fetchStatusRetry.ts +33 -0
  132. package/packages/utils/src/fetch/index.spec.ts +34 -0
  133. package/packages/utils/src/fetch/index.ts +87 -0
  134. package/packages/utils/src/guards/index.spec.ts +58 -0
  135. package/{dist/esm/guards/index.d.ts → packages/utils/src/guards/index.ts} +10 -7
  136. package/packages/utils/src/index.spec.ts +471 -0
  137. package/packages/utils/src/middleware/apiErrorHandler.spec.ts +65 -0
  138. package/packages/utils/src/middleware/apiErrorHandler.ts +67 -0
  139. package/packages/utils/src/middleware/apiSlowResponseMiddleware.spec.ts +184 -0
  140. package/packages/utils/src/middleware/apiSlowResponseMiddleware.ts +71 -0
  141. package/packages/utils/src/middleware/index.spec.ts +99 -0
  142. package/{dist/cjs/middleware/index.d.ts → packages/utils/src/middleware/index.ts} +53 -5
  143. package/packages/utils/src/middleware/lambdaCorsResponseMiddleware.spec.ts +103 -0
  144. package/packages/utils/src/middleware/lambdaCorsResponseMiddleware.ts +52 -0
  145. package/packages/utils/src/middleware/throwNotFoundMiddleware.spec.ts +20 -0
  146. package/packages/utils/src/middleware/throwNotFoundMiddleware.ts +11 -0
  147. package/packages/utils/src/misc/hashValue.ts +18 -0
  148. package/packages/utils/src/misc/helpers.ts +259 -0
  149. package/packages/utils/src/misc/merge.ts +48 -0
  150. package/{dist/esm/misc/partitionSequence.js → packages/utils/src/misc/partitionSequence.ts} +23 -15
  151. package/packages/utils/src/pagination/index.spec.ts +150 -0
  152. package/packages/utils/src/pagination/index.ts +117 -0
  153. package/{dist/esm/routing/helpers.js → packages/utils/src/routing/helpers.ts} +42 -30
  154. package/packages/utils/src/routing/index.spec.ts +553 -0
  155. package/packages/utils/src/routing/index.ts +424 -0
  156. package/packages/utils/src/routing/validators/zod.spec.ts +16 -0
  157. package/packages/utils/src/routing/validators/zod.ts +14 -0
  158. package/packages/utils/src/services/accountsGateway/README.md +3 -0
  159. package/packages/utils/src/services/accountsGateway/index.spec.ts +518 -0
  160. package/packages/utils/src/services/accountsGateway/index.ts +251 -0
  161. package/packages/utils/src/services/apiGateway/README.md +93 -0
  162. package/packages/utils/src/services/apiGateway/index.spec.ts +254 -0
  163. package/packages/utils/src/services/apiGateway/index.ts +189 -0
  164. package/packages/utils/src/services/authProvider/README.md +21 -0
  165. package/packages/utils/src/services/authProvider/browser.spec.ts +391 -0
  166. package/packages/utils/src/services/authProvider/browser.ts +209 -0
  167. package/packages/utils/src/services/authProvider/decryption.spec.ts +337 -0
  168. package/packages/utils/src/services/authProvider/decryption.ts +98 -0
  169. package/packages/utils/src/services/authProvider/index.ts +93 -0
  170. package/packages/utils/src/services/authProvider/stub.spec.ts +29 -0
  171. package/packages/utils/src/services/authProvider/subrequest.spec.ts +105 -0
  172. package/packages/utils/src/services/authProvider/subrequest.ts +68 -0
  173. package/packages/utils/src/services/authProvider/utils/decryptAndVerify.spec.ts +128 -0
  174. package/packages/utils/src/services/authProvider/utils/decryptAndVerify.ts +106 -0
  175. package/packages/utils/src/services/authProvider/utils/embeddedAuthProvider.spec.ts +26 -0
  176. package/packages/utils/src/services/authProvider/utils/embeddedAuthProvider.ts +57 -0
  177. package/packages/utils/src/services/authProvider/utils/userRoleValidator.spec.ts +135 -0
  178. package/packages/utils/src/services/authProvider/utils/userRoleValidator.ts +49 -0
  179. package/packages/utils/src/services/authProvider/utils/userSubrequest.spec.ts +26 -0
  180. package/packages/utils/src/services/authProvider/utils/userSubrequest.ts +10 -0
  181. package/packages/utils/src/services/documentStore/dynamoEncoding.ts +57 -0
  182. package/packages/utils/src/services/documentStore/fileSystemAssert.spec.ts +43 -0
  183. package/packages/utils/src/services/documentStore/fileSystemAssert.ts +10 -0
  184. package/{dist/cjs/services/documentStore/index.d.ts → packages/utils/src/services/documentStore/index.ts} +8 -8
  185. package/packages/utils/src/services/documentStore/unversioned/README.md +13 -0
  186. package/packages/utils/src/services/documentStore/unversioned/dynamodb.spec.ts +859 -0
  187. package/packages/utils/src/services/documentStore/unversioned/dynamodb.ts +243 -0
  188. package/packages/utils/src/services/documentStore/unversioned/file-system.spec.ts +629 -0
  189. package/packages/utils/src/services/documentStore/unversioned/file-system.ts +194 -0
  190. package/{dist/cjs/services/documentStore/unversioned/index.d.ts → packages/utils/src/services/documentStore/unversioned/index.ts} +2 -0
  191. package/packages/utils/src/services/documentStore/versioned/README.md +13 -0
  192. package/packages/utils/src/services/documentStore/versioned/dynamodb.spec.ts +376 -0
  193. package/packages/utils/src/services/documentStore/versioned/dynamodb.ts +167 -0
  194. package/packages/utils/src/services/documentStore/versioned/file-system.spec.ts +262 -0
  195. package/packages/utils/src/services/documentStore/versioned/file-system.ts +90 -0
  196. package/packages/utils/src/services/documentStore/versioned/index.ts +25 -0
  197. package/packages/utils/src/services/exercisesGateway/README.md +5 -0
  198. package/packages/utils/src/services/exercisesGateway/index.spec.ts +326 -0
  199. package/packages/utils/src/services/exercisesGateway/index.ts +163 -0
  200. package/packages/utils/src/services/fileServer/index.spec.ts +88 -0
  201. package/packages/utils/src/services/fileServer/index.ts +43 -0
  202. package/packages/utils/src/services/fileServer/localFileServer.spec.ts +182 -0
  203. package/packages/utils/src/services/fileServer/localFileServer.ts +159 -0
  204. package/packages/utils/src/services/fileServer/s3FileServer.spec.ts +266 -0
  205. package/packages/utils/src/services/fileServer/s3FileServer.ts +155 -0
  206. package/packages/utils/src/services/launchParams/index.spec.ts +366 -0
  207. package/packages/utils/src/services/launchParams/signer.ts +73 -0
  208. package/packages/utils/src/services/launchParams/verifier.ts +120 -0
  209. package/packages/utils/src/services/logger/console.spec.ts +29 -0
  210. package/{dist/esm/services/logger/console.js → packages/utils/src/services/logger/console.ts} +5 -2
  211. package/packages/utils/src/services/logger/index.spec.ts +65 -0
  212. package/{dist/esm/services/logger/index.d.ts → packages/utils/src/services/logger/index.ts} +23 -9
  213. package/packages/utils/src/services/lrsGateway/README.md +5 -0
  214. package/packages/utils/src/services/lrsGateway/addStatementDefaultFields.ts +22 -0
  215. package/packages/utils/src/services/lrsGateway/attempt-utils.spec.ts +847 -0
  216. package/packages/utils/src/services/lrsGateway/attempt-utils.ts +358 -0
  217. package/packages/utils/src/services/lrsGateway/file-system.spec.ts +363 -0
  218. package/packages/utils/src/services/lrsGateway/file-system.ts +165 -0
  219. package/packages/utils/src/services/lrsGateway/index.spec.ts +194 -0
  220. package/packages/utils/src/services/lrsGateway/index.ts +257 -0
  221. package/packages/utils/src/services/lrsGateway/xapiUtils.spec.ts +887 -0
  222. package/packages/utils/src/services/lrsGateway/xapiUtils.ts +262 -0
  223. package/packages/utils/src/services/postgresConnection/index.spec.ts +170 -0
  224. package/packages/utils/src/services/postgresConnection/index.ts +84 -0
  225. package/packages/utils/src/services/searchProvider/README.md +3 -0
  226. package/packages/utils/src/services/searchProvider/index.ts +59 -0
  227. package/packages/utils/src/services/searchProvider/memorySearchTheBadWay.spec.ts +526 -0
  228. package/packages/utils/src/services/searchProvider/memorySearchTheBadWay.ts +223 -0
  229. package/packages/utils/src/services/searchProvider/openSearch.spec.ts +926 -0
  230. package/packages/utils/src/services/searchProvider/openSearch.ts +195 -0
  231. package/{dist/esm/types.d.ts → packages/utils/src/types.ts} +34 -6
  232. package/packages/utils/tsconfig.json +31 -0
  233. package/packages/utils/tsconfig.without-specs.cjs.json +7 -0
  234. package/packages/utils/tsconfig.without-specs.esm.json +7 -0
  235. package/packages/utils/tsconfig.without-specs.json +6 -0
  236. package/scripts/build.bash +24 -0
  237. package/scripts/ci.bash +10 -0
  238. package/scripts/start.bash +29 -0
  239. package/dist/cjs/assertions/index.d.ts +0 -89
  240. package/dist/cjs/assertions/index.js +0 -157
  241. package/dist/cjs/aws/ssmService.d.ts +0 -5
  242. package/dist/cjs/aws/ssmService.js +0 -9
  243. package/dist/cjs/config/awsParameterConfig.d.ts +0 -10
  244. package/dist/cjs/config/awsParameterConfig.js +0 -26
  245. package/dist/cjs/config/envConfig.d.ts +0 -24
  246. package/dist/cjs/config/envConfig.js +0 -57
  247. package/dist/cjs/config/index.d.ts +0 -48
  248. package/dist/cjs/config/index.js +0 -35
  249. package/dist/cjs/config/lambdaParameterConfig.d.ts +0 -12
  250. package/dist/cjs/config/lambdaParameterConfig.js +0 -45
  251. package/dist/cjs/config/replaceConfig.d.ts +0 -14
  252. package/dist/cjs/config/replaceConfig.js +0 -22
  253. package/dist/cjs/config/resolveConfigValue.d.ts +0 -5
  254. package/dist/cjs/config/resolveConfigValue.js +0 -12
  255. package/dist/cjs/errors/index.d.ts +0 -88
  256. package/dist/cjs/errors/index.js +0 -123
  257. package/dist/cjs/fetch/fetchStatusRetry.d.ts +0 -8
  258. package/dist/cjs/fetch/fetchStatusRetry.js +0 -27
  259. package/dist/cjs/fetch/index.d.ts +0 -64
  260. package/dist/cjs/fetch/index.js +0 -55
  261. package/dist/cjs/guards/index.d.ts +0 -38
  262. package/dist/cjs/guards/index.js +0 -44
  263. package/dist/cjs/index.js +0 -20
  264. package/dist/cjs/middleware/apiErrorHandler.d.ts +0 -24
  265. package/dist/cjs/middleware/apiErrorHandler.js +0 -42
  266. package/dist/cjs/middleware/apiSlowResponseMiddleware.d.ts +0 -23
  267. package/dist/cjs/middleware/apiSlowResponseMiddleware.js +0 -54
  268. package/dist/cjs/middleware/index.js +0 -48
  269. package/dist/cjs/middleware/lambdaCorsResponseMiddleware.d.ts +0 -20
  270. package/dist/cjs/middleware/lambdaCorsResponseMiddleware.js +0 -44
  271. package/dist/cjs/middleware/throwNotFoundMiddleware.d.ts +0 -4
  272. package/dist/cjs/middleware/throwNotFoundMiddleware.js +0 -14
  273. package/dist/cjs/misc/hashValue.d.ts +0 -10
  274. package/dist/cjs/misc/hashValue.js +0 -17
  275. package/dist/cjs/misc/helpers.d.ts +0 -124
  276. package/dist/cjs/misc/helpers.js +0 -214
  277. package/dist/cjs/misc/merge.d.ts +0 -21
  278. package/dist/cjs/misc/merge.js +0 -45
  279. package/dist/cjs/misc/partitionSequence.d.ts +0 -35
  280. package/dist/cjs/misc/partitionSequence.js +0 -55
  281. package/dist/cjs/pagination/index.d.ts +0 -91
  282. package/dist/cjs/pagination/index.js +0 -83
  283. package/dist/cjs/routing/helpers.d.ts +0 -57
  284. package/dist/cjs/routing/helpers.js +0 -90
  285. package/dist/cjs/routing/index.d.ts +0 -290
  286. package/dist/cjs/routing/index.js +0 -295
  287. package/dist/cjs/routing/validators/zod.d.ts +0 -4
  288. package/dist/cjs/routing/validators/zod.js +0 -14
  289. package/dist/cjs/services/accountsGateway/index.d.ts +0 -92
  290. package/dist/cjs/services/accountsGateway/index.js +0 -138
  291. package/dist/cjs/services/apiGateway/index.d.ts +0 -68
  292. package/dist/cjs/services/apiGateway/index.js +0 -118
  293. package/dist/cjs/services/authProvider/browser.d.ts +0 -40
  294. package/dist/cjs/services/authProvider/browser.js +0 -155
  295. package/dist/cjs/services/authProvider/decryption.d.ts +0 -19
  296. package/dist/cjs/services/authProvider/decryption.js +0 -73
  297. package/dist/cjs/services/authProvider/index.d.ts +0 -63
  298. package/dist/cjs/services/authProvider/index.js +0 -34
  299. package/dist/cjs/services/authProvider/subrequest.d.ts +0 -13
  300. package/dist/cjs/services/authProvider/subrequest.js +0 -49
  301. package/dist/cjs/services/authProvider/utils/decryptAndVerify.d.ts +0 -28
  302. package/dist/cjs/services/authProvider/utils/decryptAndVerify.js +0 -91
  303. package/dist/cjs/services/authProvider/utils/embeddedAuthProvider.d.ts +0 -26
  304. package/dist/cjs/services/authProvider/utils/embeddedAuthProvider.js +0 -47
  305. package/dist/cjs/services/authProvider/utils/userRoleValidator.d.ts +0 -13
  306. package/dist/cjs/services/authProvider/utils/userRoleValidator.js +0 -37
  307. package/dist/cjs/services/authProvider/utils/userSubrequest.d.ts +0 -3
  308. package/dist/cjs/services/authProvider/utils/userSubrequest.js +0 -13
  309. package/dist/cjs/services/documentStore/dynamoEncoding.d.ts +0 -10
  310. package/dist/cjs/services/documentStore/dynamoEncoding.js +0 -52
  311. package/dist/cjs/services/documentStore/fileSystemAssert.d.ts +0 -1
  312. package/dist/cjs/services/documentStore/fileSystemAssert.js +0 -14
  313. package/dist/cjs/services/documentStore/index.js +0 -2
  314. package/dist/cjs/services/documentStore/unversioned/dynamodb.d.ts +0 -31
  315. package/dist/cjs/services/documentStore/unversioned/dynamodb.js +0 -233
  316. package/dist/cjs/services/documentStore/unversioned/file-system.d.ts +0 -32
  317. package/dist/cjs/services/documentStore/unversioned/file-system.js +0 -214
  318. package/dist/cjs/services/documentStore/unversioned/index.js +0 -2
  319. package/dist/cjs/services/documentStore/versioned/dynamodb.d.ts +0 -25
  320. package/dist/cjs/services/documentStore/versioned/dynamodb.js +0 -143
  321. package/dist/cjs/services/documentStore/versioned/file-system.d.ts +0 -25
  322. package/dist/cjs/services/documentStore/versioned/file-system.js +0 -73
  323. package/dist/cjs/services/documentStore/versioned/index.d.ts +0 -17
  324. package/dist/cjs/services/documentStore/versioned/index.js +0 -2
  325. package/dist/cjs/services/exercisesGateway/index.d.ts +0 -67
  326. package/dist/cjs/services/exercisesGateway/index.js +0 -107
  327. package/dist/cjs/services/fileServer/index.d.ts +0 -30
  328. package/dist/cjs/services/fileServer/index.js +0 -19
  329. package/dist/cjs/services/fileServer/localFileServer.d.ts +0 -13
  330. package/dist/cjs/services/fileServer/localFileServer.js +0 -132
  331. package/dist/cjs/services/fileServer/s3FileServer.d.ts +0 -14
  332. package/dist/cjs/services/fileServer/s3FileServer.js +0 -132
  333. package/dist/cjs/services/launchParams/index.js +0 -7
  334. package/dist/cjs/services/launchParams/signer.d.ts +0 -23
  335. package/dist/cjs/services/launchParams/signer.js +0 -58
  336. package/dist/cjs/services/launchParams/verifier.d.ts +0 -21
  337. package/dist/cjs/services/launchParams/verifier.js +0 -129
  338. package/dist/cjs/services/logger/console.d.ts +0 -4
  339. package/dist/cjs/services/logger/console.js +0 -12
  340. package/dist/cjs/services/logger/index.d.ts +0 -39
  341. package/dist/cjs/services/logger/index.js +0 -31
  342. package/dist/cjs/services/lrsGateway/addStatementDefaultFields.d.ts +0 -5
  343. package/dist/cjs/services/lrsGateway/addStatementDefaultFields.js +0 -21
  344. package/dist/cjs/services/lrsGateway/attempt-utils.d.ts +0 -70
  345. package/dist/cjs/services/lrsGateway/attempt-utils.js +0 -258
  346. package/dist/cjs/services/lrsGateway/file-system.d.ts +0 -15
  347. package/dist/cjs/services/lrsGateway/file-system.js +0 -150
  348. package/dist/cjs/services/lrsGateway/index.d.ts +0 -122
  349. package/dist/cjs/services/lrsGateway/index.js +0 -148
  350. package/dist/cjs/services/lrsGateway/xapiUtils.d.ts +0 -68
  351. package/dist/cjs/services/lrsGateway/xapiUtils.js +0 -109
  352. package/dist/cjs/services/postgresConnection/index.d.ts +0 -28
  353. package/dist/cjs/services/postgresConnection/index.js +0 -65
  354. package/dist/cjs/services/searchProvider/index.d.ts +0 -67
  355. package/dist/cjs/services/searchProvider/index.js +0 -2
  356. package/dist/cjs/services/searchProvider/memorySearchTheBadWay.d.ts +0 -20
  357. package/dist/cjs/services/searchProvider/memorySearchTheBadWay.js +0 -191
  358. package/dist/cjs/services/searchProvider/openSearch.d.ts +0 -28
  359. package/dist/cjs/services/searchProvider/openSearch.js +0 -154
  360. package/dist/cjs/tsconfig.without-specs.cjs.tsbuildinfo +0 -1
  361. package/dist/cjs/types.d.ts +0 -31
  362. package/dist/cjs/types.js +0 -2
  363. package/dist/esm/assertions/index.d.ts +0 -89
  364. package/dist/esm/aws/ssmService.d.ts +0 -5
  365. package/dist/esm/aws/ssmService.js +0 -6
  366. package/dist/esm/config/awsParameterConfig.d.ts +0 -10
  367. package/dist/esm/config/awsParameterConfig.js +0 -22
  368. package/dist/esm/config/envConfig.d.ts +0 -24
  369. package/dist/esm/config/envConfig.js +0 -53
  370. package/dist/esm/config/index.js +0 -17
  371. package/dist/esm/config/lambdaParameterConfig.d.ts +0 -12
  372. package/dist/esm/config/lambdaParameterConfig.js +0 -38
  373. package/dist/esm/config/replaceConfig.d.ts +0 -14
  374. package/dist/esm/config/resolveConfigValue.d.ts +0 -5
  375. package/dist/esm/config/resolveConfigValue.js +0 -8
  376. package/dist/esm/errors/index.d.ts +0 -88
  377. package/dist/esm/fetch/fetchStatusRetry.d.ts +0 -8
  378. package/dist/esm/fetch/fetchStatusRetry.js +0 -23
  379. package/dist/esm/fetch/index.d.ts +0 -64
  380. package/dist/esm/fetch/index.js +0 -46
  381. package/dist/esm/guards/index.js +0 -36
  382. package/dist/esm/index.d.ts +0 -4
  383. package/dist/esm/index.js +0 -4
  384. package/dist/esm/middleware/apiErrorHandler.d.ts +0 -24
  385. package/dist/esm/middleware/apiErrorHandler.js +0 -38
  386. package/dist/esm/middleware/apiSlowResponseMiddleware.d.ts +0 -23
  387. package/dist/esm/middleware/apiSlowResponseMiddleware.js +0 -50
  388. package/dist/esm/middleware/index.d.ts +0 -47
  389. package/dist/esm/middleware/index.js +0 -44
  390. package/dist/esm/middleware/lambdaCorsResponseMiddleware.d.ts +0 -20
  391. package/dist/esm/middleware/lambdaCorsResponseMiddleware.js +0 -40
  392. package/dist/esm/middleware/throwNotFoundMiddleware.d.ts +0 -4
  393. package/dist/esm/middleware/throwNotFoundMiddleware.js +0 -10
  394. package/dist/esm/misc/hashValue.d.ts +0 -10
  395. package/dist/esm/misc/hashValue.js +0 -13
  396. package/dist/esm/misc/helpers.d.ts +0 -124
  397. package/dist/esm/misc/helpers.js +0 -199
  398. package/dist/esm/misc/merge.d.ts +0 -21
  399. package/dist/esm/misc/merge.js +0 -40
  400. package/dist/esm/misc/partitionSequence.d.ts +0 -35
  401. package/dist/esm/pagination/index.d.ts +0 -91
  402. package/dist/esm/pagination/index.js +0 -77
  403. package/dist/esm/routing/helpers.d.ts +0 -57
  404. package/dist/esm/routing/index.d.ts +0 -290
  405. package/dist/esm/routing/index.js +0 -246
  406. package/dist/esm/routing/validators/zod.d.ts +0 -4
  407. package/dist/esm/routing/validators/zod.js +0 -10
  408. package/dist/esm/services/accountsGateway/index.d.ts +0 -92
  409. package/dist/esm/services/accountsGateway/index.js +0 -131
  410. package/dist/esm/services/apiGateway/index.d.ts +0 -68
  411. package/dist/esm/services/apiGateway/index.js +0 -77
  412. package/dist/esm/services/authProvider/browser.d.ts +0 -40
  413. package/dist/esm/services/authProvider/browser.js +0 -151
  414. package/dist/esm/services/authProvider/decryption.d.ts +0 -19
  415. package/dist/esm/services/authProvider/decryption.js +0 -69
  416. package/dist/esm/services/authProvider/index.d.ts +0 -63
  417. package/dist/esm/services/authProvider/index.js +0 -26
  418. package/dist/esm/services/authProvider/subrequest.d.ts +0 -13
  419. package/dist/esm/services/authProvider/subrequest.js +0 -45
  420. package/dist/esm/services/authProvider/utils/decryptAndVerify.d.ts +0 -28
  421. package/dist/esm/services/authProvider/utils/decryptAndVerify.js +0 -85
  422. package/dist/esm/services/authProvider/utils/embeddedAuthProvider.d.ts +0 -26
  423. package/dist/esm/services/authProvider/utils/embeddedAuthProvider.js +0 -40
  424. package/dist/esm/services/authProvider/utils/userRoleValidator.d.ts +0 -13
  425. package/dist/esm/services/authProvider/utils/userRoleValidator.js +0 -33
  426. package/dist/esm/services/authProvider/utils/userSubrequest.d.ts +0 -3
  427. package/dist/esm/services/authProvider/utils/userSubrequest.js +0 -6
  428. package/dist/esm/services/documentStore/dynamoEncoding.d.ts +0 -10
  429. package/dist/esm/services/documentStore/dynamoEncoding.js +0 -45
  430. package/dist/esm/services/documentStore/fileSystemAssert.d.ts +0 -1
  431. package/dist/esm/services/documentStore/fileSystemAssert.js +0 -10
  432. package/dist/esm/services/documentStore/index.d.ts +0 -14
  433. package/dist/esm/services/documentStore/index.js +0 -1
  434. package/dist/esm/services/documentStore/unversioned/dynamodb.d.ts +0 -31
  435. package/dist/esm/services/documentStore/unversioned/dynamodb.js +0 -226
  436. package/dist/esm/services/documentStore/unversioned/file-system.d.ts +0 -32
  437. package/dist/esm/services/documentStore/unversioned/file-system.js +0 -174
  438. package/dist/esm/services/documentStore/unversioned/index.d.ts +0 -2
  439. package/dist/esm/services/documentStore/unversioned/index.js +0 -1
  440. package/dist/esm/services/documentStore/versioned/dynamodb.d.ts +0 -25
  441. package/dist/esm/services/documentStore/versioned/dynamodb.js +0 -139
  442. package/dist/esm/services/documentStore/versioned/file-system.d.ts +0 -25
  443. package/dist/esm/services/documentStore/versioned/file-system.js +0 -69
  444. package/dist/esm/services/documentStore/versioned/index.d.ts +0 -17
  445. package/dist/esm/services/documentStore/versioned/index.js +0 -1
  446. package/dist/esm/services/exercisesGateway/index.d.ts +0 -67
  447. package/dist/esm/services/exercisesGateway/index.js +0 -70
  448. package/dist/esm/services/fileServer/index.d.ts +0 -30
  449. package/dist/esm/services/fileServer/index.js +0 -13
  450. package/dist/esm/services/fileServer/localFileServer.d.ts +0 -13
  451. package/dist/esm/services/fileServer/localFileServer.js +0 -125
  452. package/dist/esm/services/fileServer/s3FileServer.d.ts +0 -14
  453. package/dist/esm/services/fileServer/s3FileServer.js +0 -125
  454. package/dist/esm/services/launchParams/index.d.ts +0 -2
  455. package/dist/esm/services/launchParams/index.js +0 -2
  456. package/dist/esm/services/launchParams/signer.d.ts +0 -23
  457. package/dist/esm/services/launchParams/signer.js +0 -51
  458. package/dist/esm/services/launchParams/verifier.d.ts +0 -21
  459. package/dist/esm/services/launchParams/verifier.js +0 -92
  460. package/dist/esm/services/logger/console.d.ts +0 -4
  461. package/dist/esm/services/logger/index.js +0 -27
  462. package/dist/esm/services/lrsGateway/addStatementDefaultFields.d.ts +0 -5
  463. package/dist/esm/services/lrsGateway/addStatementDefaultFields.js +0 -14
  464. package/dist/esm/services/lrsGateway/attempt-utils.d.ts +0 -70
  465. package/dist/esm/services/lrsGateway/attempt-utils.js +0 -236
  466. package/dist/esm/services/lrsGateway/file-system.d.ts +0 -15
  467. package/dist/esm/services/lrsGateway/file-system.js +0 -110
  468. package/dist/esm/services/lrsGateway/index.d.ts +0 -122
  469. package/dist/esm/services/lrsGateway/index.js +0 -111
  470. package/dist/esm/services/lrsGateway/xapiUtils.d.ts +0 -68
  471. package/dist/esm/services/lrsGateway/xapiUtils.js +0 -99
  472. package/dist/esm/services/postgresConnection/index.d.ts +0 -28
  473. package/dist/esm/services/postgresConnection/index.js +0 -58
  474. package/dist/esm/services/searchProvider/index.d.ts +0 -67
  475. package/dist/esm/services/searchProvider/index.js +0 -1
  476. package/dist/esm/services/searchProvider/memorySearchTheBadWay.d.ts +0 -20
  477. package/dist/esm/services/searchProvider/memorySearchTheBadWay.js +0 -187
  478. package/dist/esm/services/searchProvider/openSearch.d.ts +0 -28
  479. package/dist/esm/services/searchProvider/openSearch.js +0 -150
  480. package/dist/esm/tsconfig.without-specs.esm.tsbuildinfo +0 -1
  481. package/dist/esm/types.js +0 -1
  482. package/script/bin/.init-params-script.bash.swp +0 -0
  483. /package/{script → packages/utils/script}/bin/copy-from-template.bash +0 -0
  484. /package/{script → packages/utils/script}/bin/delete-stack.bash +0 -0
  485. /package/{script → packages/utils/script}/bin/deploy.bash +0 -0
  486. /package/{script → packages/utils/script}/bin/destroy-deployment.bash +0 -0
  487. /package/{script → packages/utils/script}/bin/empty-bucket.bash +0 -0
  488. /package/{script → packages/utils/script}/bin/get-arg.bash +0 -0
  489. /package/{script → packages/utils/script}/bin/get-deployed-environments.bash +0 -0
  490. /package/{script → packages/utils/script}/bin/get-env-param.bash +0 -0
  491. /package/{script → packages/utils/script}/bin/get-kwarg.bash +0 -0
  492. /package/{script → packages/utils/script}/bin/get-stack-param.bash +0 -0
  493. /package/{script → packages/utils/script}/bin/has-flag.bash +0 -0
  494. /package/{script → packages/utils/script}/bin/init-constants-script.bash +0 -0
  495. /package/{script → packages/utils/script}/bin/init-params-script.bash +0 -0
  496. /package/{script → packages/utils/script}/bin/stack-exists.bash +0 -0
  497. /package/{script → packages/utils/script}/bin/update-utils.bash +0 -0
  498. /package/{script → packages/utils/script}/bin/upload-pager-duty-endpoints.bash +0 -0
  499. /package/{script → packages/utils/script}/bin/upload-params.bash +0 -0
  500. /package/{script → packages/utils/script}/bin/which.bash +0 -0
  501. /package/{script → packages/utils/script}/bin-entry.bash +0 -0
  502. /package/{script → packages/utils/script}/build.bash +0 -0
  503. /package/{dist/cjs/index.d.ts → packages/utils/src/index.ts} +0 -0
  504. /package/{dist/cjs/services/launchParams/index.d.ts → packages/utils/src/services/launchParams/index.ts} +0 -0
@@ -1,45 +0,0 @@
1
- import { isPlainObject } from '../../guards';
2
- export const encodeDynamoAttribute = (value) => {
3
- if (typeof value === 'string') {
4
- return { S: value };
5
- }
6
- if (typeof value === 'number') {
7
- return { N: value.toString() };
8
- }
9
- if (typeof value === 'boolean') {
10
- return { BOOL: value };
11
- }
12
- if (value === null) {
13
- return { NULL: true };
14
- }
15
- if (value instanceof Array) {
16
- return { L: value.map(encodeDynamoAttribute) };
17
- }
18
- if (isPlainObject(value)) {
19
- return { M: encodeDynamoDocument(value) };
20
- }
21
- throw new Error(`unknown attribute type ${typeof value} with value ${value}.`);
22
- };
23
- export const encodeDynamoDocument = (base) => Object.fromEntries(Object.entries(base).map(([key, value]) => ([key, encodeDynamoAttribute(value)])));
24
- export const decodeDynamoAttribute = (value) => {
25
- if (value.S !== undefined) {
26
- return value.S;
27
- }
28
- if (value.N !== undefined) {
29
- return parseFloat(value.N);
30
- }
31
- if (value.BOOL !== undefined) {
32
- return value.BOOL;
33
- }
34
- if (value.NULL !== undefined) {
35
- return null;
36
- }
37
- if (value.L !== undefined) {
38
- return value.L.map(decodeDynamoAttribute);
39
- }
40
- if (value.M !== undefined) {
41
- return decodeDynamoDocument(value.M);
42
- }
43
- throw new Error(`unknown attribute type: ${JSON.stringify(value)}.`);
44
- };
45
- export const decodeDynamoDocument = (document) => Object.fromEntries(Object.entries(document).map(([key, value]) => ([key, decodeDynamoAttribute(value)])));
@@ -1 +0,0 @@
1
- export declare const assertNoUndefined: (obj: any, path?: string[]) => void;
@@ -1,10 +0,0 @@
1
- export const assertNoUndefined = (obj, path = []) => {
2
- if (obj === undefined) {
3
- throw new Error(`unknown attribute type ${typeof obj} with value ${obj} at ${path.join('.') || 'root'}.`);
4
- }
5
- if (obj && typeof obj === 'object') {
6
- for (const [key, value] of Object.entries(obj)) {
7
- assertNoUndefined(value, [...path, key]);
8
- }
9
- }
10
- };
@@ -1,14 +0,0 @@
1
- export type Config = {
2
- tableName: string;
3
- };
4
- export type DocumentBaseMapType = {
5
- [key: string]: DocumentBaseValueTypes;
6
- };
7
- export type DocumentBaseListType = DocumentBaseValueTypes[];
8
- export type DocumentBaseValueTypes = number | boolean | string | null | DocumentBaseMapType | DocumentBaseListType;
9
- export type DocumentBaseType = {
10
- [key: string]: DocumentBaseValueTypes;
11
- };
12
- export type TDocument<T> = {
13
- [_key in keyof T]: DocumentBaseValueTypes;
14
- };
@@ -1 +0,0 @@
1
- export {};
@@ -1,31 +0,0 @@
1
- import { DynamoDB } from '@aws-sdk/client-dynamodb';
2
- import { Config, TDocument } from '..';
3
- import { ConfigProviderForConfig } from '../../../config';
4
- interface Initializer<C> {
5
- configSpace?: C;
6
- dynamoClient?: DynamoDB;
7
- }
8
- export declare const dynamoUnversionedDocumentStore: <C extends string = "dynamodb">(initializer?: Initializer<C>) => <T extends TDocument<T>>() => (configProvider: { [_key in C]: ConfigProviderForConfig<Config>; }) => <K extends keyof T>(_: {}, hashKey: K, options?: {
9
- afterWrite?: (item: T) => void | Promise<void>;
10
- batchAfterWrite?: (items: T[]) => void | Promise<void>;
11
- }) => {
12
- loadAllDocumentsTheBadWay: () => Promise<T[]>;
13
- getItemsByField: (key: keyof T, value: T[K], pageKey?: string) => Promise<{
14
- items: T[];
15
- nextPageToken: string | undefined;
16
- }>;
17
- batchGetItem: (ids: T[K][]) => Promise<T[]>;
18
- getItem: (id: T[K]) => Promise<T | undefined>;
19
- incrementItemAttribute: (id: T[K], attribute: keyof T) => Promise<number>;
20
- patchItem: (item: Partial<T>) => Promise<T>;
21
- putItem: (item: T) => Promise<T>;
22
- createItem: (item: T) => Promise<T>;
23
- batchCreateItem: (items: T[], concurrency?: number) => Promise<{
24
- successful: T[];
25
- failed: Array<{
26
- item: T;
27
- error: Error;
28
- }>;
29
- }>;
30
- };
31
- export {};
@@ -1,226 +0,0 @@
1
- import { BatchGetItemCommand, DynamoDB, GetItemCommand, PutItemCommand, QueryCommand, ScanCommand, UpdateItemCommand } from '@aws-sdk/client-dynamodb';
2
- import asyncPool from 'tiny-async-pool';
3
- import { once } from '../../..';
4
- import { resolveConfigValue } from '../../../config';
5
- import { ConflictError, NotFoundError } from '../../../errors';
6
- import { ifDefined } from '../../../guards';
7
- import { decodeDynamoDocument, encodeDynamoAttribute, encodeDynamoDocument } from '../dynamoEncoding';
8
- export const dynamoUnversionedDocumentStore = (initializer) => {
9
- const init = ifDefined(initializer, {});
10
- const dynamodb = once(() => { var _a; return (_a = init.dynamoClient) !== null && _a !== void 0 ? _a : new DynamoDB({ apiVersion: '2012-08-10' }); });
11
- return () => (configProvider) => (_, hashKey, options) => {
12
- const tableName = once(() => resolveConfigValue(configProvider[ifDefined(init.configSpace, 'dynamodb')].tableName));
13
- return {
14
- loadAllDocumentsTheBadWay: async () => {
15
- const loadAllResults = async (ExclusiveStartKey) => {
16
- var _a, _b;
17
- const cmd = new ScanCommand({ TableName: await tableName(), ExclusiveStartKey });
18
- const result = await dynamodb().send(cmd);
19
- const resultItems = (_b = (_a = result.Items) === null || _a === void 0 ? void 0 : _a.map((item) => decodeDynamoDocument(item))) !== null && _b !== void 0 ? _b : [];
20
- if (result.LastEvaluatedKey) {
21
- return [...resultItems, ...await loadAllResults(result.LastEvaluatedKey)];
22
- }
23
- return resultItems;
24
- };
25
- return loadAllResults();
26
- },
27
- /*
28
- * requires that a global secondary index exist on the table
29
- */
30
- getItemsByField: async (key, value, pageKey) => {
31
- var _a, _b;
32
- const ExclusiveStartKey = pageKey
33
- ? JSON.parse(Buffer.from(pageKey, 'base64').toString('utf-8'))
34
- : undefined;
35
- const table = await tableName();
36
- const cmd = new QueryCommand({
37
- TableName: table,
38
- IndexName: key.toString(),
39
- ExclusiveStartKey,
40
- KeyConditionExpression: '#hk = :hkv',
41
- ExpressionAttributeValues: {
42
- ':hkv': encodeDynamoAttribute(value),
43
- },
44
- ExpressionAttributeNames: {
45
- '#hk': key.toString(),
46
- },
47
- });
48
- const response = await dynamodb().send(cmd);
49
- const items = (_b = (_a = response.Items) === null || _a === void 0 ? void 0 : _a.map((item) => decodeDynamoDocument(item))) !== null && _b !== void 0 ? _b : [];
50
- const nextPageToken = response.LastEvaluatedKey;
51
- return {
52
- items,
53
- nextPageToken: nextPageToken
54
- ? Buffer.from(JSON.stringify(nextPageToken)).toString('base64')
55
- : undefined,
56
- };
57
- },
58
- batchGetItem: async (ids) => {
59
- const table = await tableName();
60
- const key = hashKey.toString();
61
- const getBatches = async (requestItems) => {
62
- const cmd = new BatchGetItemCommand({
63
- RequestItems: requestItems !== null && requestItems !== void 0 ? requestItems : { [table]: { Keys: ids.map((id) => ({ [key]: encodeDynamoAttribute(id) })) } },
64
- });
65
- const response = await dynamodb().send(cmd);
66
- const currentResponses = response.Responses ?
67
- response.Responses[table].map(response => decodeDynamoDocument(response)) : [];
68
- return currentResponses.concat(response.UnprocessedKeys ? await getBatches(response.UnprocessedKeys) : []);
69
- };
70
- return getBatches();
71
- },
72
- getItem: async (id) => {
73
- const cmd = new GetItemCommand({
74
- Key: { [hashKey.toString()]: encodeDynamoAttribute(id) },
75
- TableName: await tableName(),
76
- });
77
- return dynamodb().send(cmd).then(result => result.Item ? decodeDynamoDocument(result.Item) : undefined);
78
- },
79
- /* atomically increments the given item attribute by 1 */
80
- incrementItemAttribute: async (id, attribute) => {
81
- const key = hashKey.toString();
82
- const field = attribute.toString();
83
- const cmd = new UpdateItemCommand({
84
- Key: { [key]: encodeDynamoAttribute(id) },
85
- TableName: await tableName(),
86
- UpdateExpression: 'ADD #f :one',
87
- ConditionExpression: 'attribute_exists(#k)',
88
- ExpressionAttributeNames: { '#k': hashKey.toString(), '#f': field },
89
- ExpressionAttributeValues: { ':one': { N: '1' } },
90
- ReturnValues: 'ALL_NEW',
91
- });
92
- return dynamodb().send(cmd).then(async (item) => {
93
- var _a, _b, _c;
94
- const result = (_b = (_a = item.Attributes) === null || _a === void 0 ? void 0 : _a[field]) === null || _b === void 0 ? void 0 : _b['N'];
95
- if (!item.Attributes) {
96
- throw new NotFoundError(`Item with ${key} "${id}" does not exist`);
97
- }
98
- if (!result) {
99
- throw new NotFoundError(`Item with ${key} "${id}" did not produce field "${field}"`);
100
- }
101
- const updatedDoc = decodeDynamoDocument(item.Attributes);
102
- await ((_c = options === null || options === void 0 ? void 0 : options.afterWrite) === null || _c === void 0 ? void 0 : _c.call(options, updatedDoc));
103
- return parseFloat(result);
104
- }).catch((error) => {
105
- throw error.name === 'ConditionalCheckFailedException' ?
106
- new NotFoundError(`Item with ${key} "${id}" does not exist`) : error;
107
- });
108
- },
109
- /* replaces only specified attributes with the given data */
110
- patchItem: async (item) => {
111
- const id = item[hashKey];
112
- const key = hashKey.toString();
113
- if (!id) {
114
- throw new Error(`Key attribute "${key}" is required for patchItem`);
115
- }
116
- const entries = Object.entries(item).filter(([field]) => field !== key);
117
- if (entries.length === 0) {
118
- throw new Error('No attributes to update');
119
- }
120
- const updates = [];
121
- const expressionAttributeNames = { '#k': key };
122
- const expressionAttributeValues = {};
123
- entries.forEach(([field, value], index) => {
124
- updates.push(`#f${index} = :f${index}`);
125
- expressionAttributeNames[`#f${index}`] = field;
126
- expressionAttributeValues[`:f${index}`] = encodeDynamoAttribute(value);
127
- });
128
- const cmd = new UpdateItemCommand({
129
- Key: { [key]: encodeDynamoAttribute(id) },
130
- TableName: await tableName(),
131
- UpdateExpression: `SET ${updates.join(', ')}`,
132
- ConditionExpression: 'attribute_exists(#k)',
133
- ExpressionAttributeNames: expressionAttributeNames,
134
- ExpressionAttributeValues: expressionAttributeValues,
135
- ReturnValues: 'ALL_NEW',
136
- });
137
- return dynamodb().send(cmd).then(async (item) => {
138
- var _a;
139
- if (!item.Attributes) {
140
- throw new NotFoundError(`Item with ${key} "${id}" does not exist`);
141
- }
142
- const updatedDoc = decodeDynamoDocument(item.Attributes);
143
- await ((_a = options === null || options === void 0 ? void 0 : options.afterWrite) === null || _a === void 0 ? void 0 : _a.call(options, updatedDoc));
144
- return updatedDoc;
145
- }).catch((error) => {
146
- throw error.name === 'ConditionalCheckFailedException' ?
147
- new NotFoundError(`Item with ${key} "${id}" does not exist`) : error;
148
- });
149
- },
150
- /* replaces the entire document with the given data */
151
- putItem: async (item) => {
152
- var _a;
153
- const cmd = new PutItemCommand({
154
- TableName: await tableName(),
155
- Item: encodeDynamoDocument(item),
156
- });
157
- const updatedDoc = await dynamodb().send(cmd).then(() => item);
158
- await ((_a = options === null || options === void 0 ? void 0 : options.afterWrite) === null || _a === void 0 ? void 0 : _a.call(options, updatedDoc));
159
- return updatedDoc;
160
- },
161
- /* creates a new document, fails if the primary key already exists */
162
- createItem: async (item) => {
163
- const cmd = new PutItemCommand({
164
- TableName: await tableName(),
165
- Item: encodeDynamoDocument(item),
166
- ConditionExpression: 'attribute_not_exists(#k)',
167
- ExpressionAttributeNames: {
168
- '#k': hashKey.toString(),
169
- },
170
- });
171
- return await dynamodb().send(cmd).then(() => item).catch((error) => {
172
- throw error.name === 'ConditionalCheckFailedException' ?
173
- new ConflictError(`Item with ${String(hashKey)} "${item[hashKey]}" already exists`) : error;
174
- }).then(async (createdDoc) => {
175
- var _a;
176
- await ((_a = options === null || options === void 0 ? void 0 : options.afterWrite) === null || _a === void 0 ? void 0 : _a.call(options, createdDoc));
177
- return createdDoc;
178
- });
179
- },
180
- /* creates multiple new documents, returns successful and failed items separately */
181
- batchCreateItem: async (items, concurrency = 10) => {
182
- if (items.length === 0)
183
- return { successful: [], failed: [] };
184
- const successful = [];
185
- const failed = [];
186
- // Process using async iterator (tiny-async-pool v2)
187
- for await (const result of asyncPool(concurrency, items, async (item) => {
188
- var _a;
189
- try {
190
- const cmd = new PutItemCommand({
191
- TableName: await tableName(),
192
- Item: encodeDynamoDocument(item),
193
- ConditionExpression: 'attribute_not_exists(#k)',
194
- ExpressionAttributeNames: {
195
- '#k': hashKey.toString(),
196
- },
197
- });
198
- await dynamodb().send(cmd);
199
- // Only call individual afterWrite if batchAfterWrite is not defined
200
- if (!(options === null || options === void 0 ? void 0 : options.batchAfterWrite)) {
201
- await ((_a = options === null || options === void 0 ? void 0 : options.afterWrite) === null || _a === void 0 ? void 0 : _a.call(options, item));
202
- }
203
- return { success: true, item };
204
- }
205
- catch (error) {
206
- const processedError = error.name === 'ConditionalCheckFailedException' ?
207
- new ConflictError(`Item with ${String(hashKey)} "${item[hashKey]}" already exists`) : error;
208
- return { success: false, item, error: processedError };
209
- }
210
- })) {
211
- if (result.success) {
212
- successful.push(result.item);
213
- }
214
- else {
215
- failed.push({ item: result.item, error: result.error });
216
- }
217
- }
218
- // Call batchAfterWrite with all successful items if defined
219
- if ((options === null || options === void 0 ? void 0 : options.batchAfterWrite) && successful.length > 0) {
220
- await options.batchAfterWrite(successful);
221
- }
222
- return { successful, failed };
223
- },
224
- };
225
- };
226
- };
@@ -1,32 +0,0 @@
1
- import { Config, TDocument } from '..';
2
- import { ConfigProviderForConfig } from '../../../config';
3
- interface Initializer<C> {
4
- dataDir: string;
5
- fs?: Pick<typeof import('fs'), 'mkdir' | 'readdir' | 'readFile' | 'writeFile'>;
6
- configSpace?: C;
7
- }
8
- export declare const fileSystemUnversionedDocumentStore: <C extends string = "fileSystem">(initializer: Initializer<C>) => <T extends TDocument<T>>() => (configProvider: { [_key in C]: ConfigProviderForConfig<Config>; }) => <K extends keyof T>(_: {}, hashKey: K, options?: {
9
- afterWrite?: (item: T) => void | Promise<void>;
10
- batchAfterWrite?: (items: T[]) => void | Promise<void>;
11
- skipAssert?: boolean;
12
- }) => {
13
- loadAllDocumentsTheBadWay: () => Promise<T[]>;
14
- getItemsByField: (key: keyof T, value: T[K], pageKey?: string) => Promise<{
15
- items: T[];
16
- nextPageToken: string | undefined;
17
- }>;
18
- batchGetItem: (ids: T[K][]) => Promise<Exclude<Awaited<T>, undefined>[]>;
19
- getItem: (id: T[K]) => Promise<T | undefined>;
20
- incrementItemAttribute: (id: T[K], attribute: keyof T) => Promise<number>;
21
- patchItem: (item: Partial<T>) => Promise<T>;
22
- putItem: (item: T) => Promise<T>;
23
- createItem: (item: T) => Promise<T>;
24
- batchCreateItem: (items: T[], _concurrency?: number) => Promise<{
25
- successful: T[];
26
- failed: Array<{
27
- item: T;
28
- error: Error;
29
- }>;
30
- }>;
31
- };
32
- export {};
@@ -1,174 +0,0 @@
1
- import * as fsModule from 'fs';
2
- import path from 'path';
3
- import { hashValue } from '../../..';
4
- import { resolveConfigValue } from '../../../config';
5
- import { ConflictError, NotFoundError } from '../../../errors';
6
- import { ifDefined, isDefined } from '../../../guards';
7
- import { assertNoUndefined } from '../fileSystemAssert';
8
- export const fileSystemUnversionedDocumentStore = (initializer) => () => (configProvider) => (_, hashKey, options) => {
9
- var _a;
10
- const tableName = resolveConfigValue(configProvider[initializer.configSpace || 'fileSystem'].tableName);
11
- const tablePath = tableName.then((table) => path.join(initializer.dataDir, table));
12
- const { mkdir, readdir, readFile, writeFile } = ifDefined(initializer.fs, fsModule);
13
- const skipAssert = (_a = options === null || options === void 0 ? void 0 : options.skipAssert) !== null && _a !== void 0 ? _a : false;
14
- const mkTableDir = new Promise((resolve, reject) => tablePath.then((path) => mkdir(path, { recursive: true }, (err) => err && err.code !== 'EEXIST' ? reject(err) : resolve())));
15
- const hashFilename = (value) => `${hashValue(value)}.json`;
16
- const filePath = async (filename) => path.join(await tablePath, filename);
17
- const load = async (filename) => {
18
- const path = await filePath(filename);
19
- await mkTableDir;
20
- return new Promise((resolve, reject) => {
21
- readFile(path, (err, readData) => {
22
- if (err) {
23
- err.code === 'ENOENT' ? resolve(undefined) : reject(err);
24
- }
25
- else {
26
- try {
27
- const data = JSON.parse(readData.toString());
28
- typeof data === 'object' ? resolve(data) : reject(new Error('unexpected non-object JSON'));
29
- }
30
- catch (err) {
31
- reject(err);
32
- }
33
- }
34
- });
35
- });
36
- };
37
- const loadAllDocumentsTheBadWay = async () => {
38
- const path = await tablePath;
39
- await mkTableDir;
40
- return new Promise((resolve, reject) => readdir(path, (err, files) => err ?
41
- reject(err) :
42
- Promise.all(files.map((file) => load(file)))
43
- .then((allData) => resolve(allData.filter(isDefined)), (err) => reject(err))));
44
- };
45
- return {
46
- loadAllDocumentsTheBadWay,
47
- getItemsByField: async (key, value, pageKey) => {
48
- if (!skipAssert)
49
- assertNoUndefined(value, [key]);
50
- const pageSize = 10;
51
- const items = await loadAllDocumentsTheBadWay();
52
- const filteredItems = items.filter((item) => item[key] === value);
53
- const startIndex = pageKey ? parseInt(pageKey, 10) : 0;
54
- const paginatedItems = filteredItems.slice(startIndex, startIndex + pageSize);
55
- const nextPageToken = startIndex + pageSize < filteredItems.length
56
- ? (startIndex + pageSize).toString()
57
- : undefined;
58
- return { items: paginatedItems, nextPageToken };
59
- },
60
- batchGetItem: async (ids) => {
61
- const items = await Promise.all(ids.map((id) => {
62
- if (!skipAssert)
63
- assertNoUndefined(id, ['id']);
64
- return load(hashFilename(id));
65
- }));
66
- return items.filter(isDefined);
67
- },
68
- getItem: (id) => {
69
- if (!skipAssert)
70
- assertNoUndefined(id, ['id']);
71
- return load(hashFilename(id));
72
- },
73
- incrementItemAttribute: async (id, attribute) => {
74
- if (!skipAssert)
75
- assertNoUndefined(id, ['id']);
76
- const filename = hashFilename(id);
77
- const path = await filePath(filename);
78
- await mkTableDir;
79
- const data = await load(filename);
80
- if (!data) {
81
- throw new NotFoundError(`Item with ${hashKey.toString()} "${id}" does not exist`);
82
- }
83
- const newValue = typeof data[attribute] === 'number' ? data[attribute] + 1 : 1;
84
- const newItem = { ...data, [hashKey]: id, [attribute]: newValue };
85
- return new Promise((resolve, reject) => {
86
- writeFile(path, JSON.stringify(newItem, null, 2), (err) => err ? reject(err) : resolve(newValue));
87
- });
88
- },
89
- patchItem: async (item) => {
90
- const id = item[hashKey];
91
- if (!id) {
92
- throw new Error(`Key attribute "${hashKey.toString()}" is required for patchItem`);
93
- }
94
- // This check is just to make this adapter consistent with the dynamo adapter
95
- if (Object.keys(item).filter((key) => key !== hashKey.toString()).length === 0) {
96
- throw new Error('No attributes to update');
97
- }
98
- const filename = hashFilename(id);
99
- const path = await filePath(filename);
100
- await mkTableDir;
101
- const data = await load(filename);
102
- if (!data) {
103
- throw new NotFoundError(`Item with ${hashKey.toString()} "${id}" does not exist`);
104
- }
105
- const newItem = { ...data, ...item };
106
- if (!skipAssert)
107
- assertNoUndefined(newItem);
108
- return new Promise((resolve, reject) => {
109
- writeFile(path, JSON.stringify(newItem, null, 2), (err) => err ? reject(err) : resolve(newItem));
110
- });
111
- },
112
- putItem: async (item) => {
113
- if (!skipAssert)
114
- assertNoUndefined(item);
115
- const path = await filePath(hashFilename(item[hashKey]));
116
- await mkTableDir;
117
- return new Promise((resolve, reject) => {
118
- writeFile(path, JSON.stringify(item, null, 2), (err) => err ? reject(err) : resolve(item));
119
- });
120
- },
121
- createItem: async (item) => {
122
- if (!skipAssert)
123
- assertNoUndefined(item);
124
- const hashed = hashFilename(item[hashKey]);
125
- const existingItem = await load(hashed);
126
- if (existingItem) {
127
- throw new ConflictError(`Item with ${String(hashKey)} "${item[hashKey]}" already exists`);
128
- }
129
- const path = await filePath(hashed);
130
- await mkTableDir;
131
- return new Promise((resolve, reject) => {
132
- writeFile(path, JSON.stringify(item, null, 2), (err) => err ? reject(err) : resolve(item));
133
- });
134
- },
135
- batchCreateItem: async (items, _concurrency = 1) => {
136
- var _a;
137
- if (items.length === 0)
138
- return { successful: [], failed: [] };
139
- const successful = [];
140
- const failed = [];
141
- // Process items sequentially to ensure consistent conflict detection
142
- // Note: concurrency parameter is ignored for filesystem to avoid race conditions
143
- for (const item of items) {
144
- if (!skipAssert)
145
- assertNoUndefined(item);
146
- try {
147
- const hashed = hashFilename(item[hashKey]);
148
- const existingItem = await load(hashed);
149
- if (existingItem) {
150
- throw new ConflictError(`Item with ${String(hashKey)} "${item[hashKey]}" already exists`);
151
- }
152
- const path = await filePath(hashed);
153
- await mkTableDir;
154
- const createdItem = await new Promise((resolve, reject) => {
155
- writeFile(path, JSON.stringify(item, null, 2), (err) => err ? reject(err) : resolve(item));
156
- });
157
- successful.push(createdItem);
158
- // Only call individual afterWrite if batchAfterWrite is not defined
159
- if (!(options === null || options === void 0 ? void 0 : options.batchAfterWrite)) {
160
- await ((_a = options === null || options === void 0 ? void 0 : options.afterWrite) === null || _a === void 0 ? void 0 : _a.call(options, createdItem));
161
- }
162
- }
163
- catch (error) {
164
- failed.push({ item, error: error });
165
- }
166
- }
167
- // Call batchAfterWrite with all successful items if defined
168
- if ((options === null || options === void 0 ? void 0 : options.batchAfterWrite) && successful.length > 0) {
169
- await options.batchAfterWrite(successful);
170
- }
171
- return { successful, failed };
172
- },
173
- };
174
- };
@@ -1,2 +0,0 @@
1
- import { dynamoUnversionedDocumentStore } from './dynamodb';
2
- export type UnversionedDocumentStoreCreator = typeof dynamoUnversionedDocumentStore;
@@ -1 +0,0 @@
1
- export {};
@@ -1,25 +0,0 @@
1
- import { DynamoDB } from '@aws-sdk/client-dynamodb';
2
- import { Config } from '..';
3
- import { ConfigProviderForConfig } from '../../../config';
4
- import { VersionedDocumentAuthor, VersionedTDocument } from '.';
5
- interface Initializer<C> {
6
- configSpace?: C;
7
- dynamoClient?: DynamoDB;
8
- }
9
- export declare const dynamoVersionedDocumentStore: <C extends string = "dynamodb">(initializer?: Initializer<C>) => <T extends VersionedTDocument<T>>() => (configProvider: { [_key in C]: ConfigProviderForConfig<Config>; }) => <K extends keyof T, A extends undefined | ((...a: any[]) => Promise<VersionedDocumentAuthor>)>(_: {}, hashKey: K, options?: {
10
- afterWrite?: (item: T) => void | Promise<void>;
11
- getAuthor?: A;
12
- }) => {
13
- loadAllDocumentsTheBadWay: () => Promise<T[]>;
14
- getVersions: (id: T[K], startVersion?: number) => Promise<{
15
- items: T[];
16
- nextPageToken: number | undefined;
17
- } | undefined>;
18
- getItem: (id: T[K], timestamp?: number) => Promise<T | undefined>;
19
- prepareItem: (item: Omit<T, "timestamp" | "author">, ...authorArgs: A extends Function ? Parameters<A> : [VersionedDocumentAuthor]) => Promise<{
20
- document: T;
21
- save: (changes?: Partial<Omit<T, "timestamp" | "author">>) => Promise<T>;
22
- }>;
23
- putItem: (item: Omit<T, "timestamp" | "author">, ...authorArgs: A extends Function ? Parameters<A> : [VersionedDocumentAuthor]) => Promise<T>;
24
- };
25
- export {};