@openstax/ts-utils 1.34.0 → 1.34.1

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 (503) hide show
  1. package/README.md +90 -62
  2. package/dist/cjs/assertions/index.d.ts +89 -0
  3. package/dist/cjs/assertions/index.js +157 -0
  4. package/dist/cjs/aws/ssmService.d.ts +5 -0
  5. package/dist/cjs/aws/ssmService.js +9 -0
  6. package/dist/cjs/config/awsParameterConfig.d.ts +10 -0
  7. package/dist/cjs/config/awsParameterConfig.js +26 -0
  8. package/dist/cjs/config/envConfig.d.ts +24 -0
  9. package/dist/cjs/config/envConfig.js +57 -0
  10. package/{packages/utils/src/config/index.ts → dist/cjs/config/index.d.ts} +13 -29
  11. package/dist/cjs/config/index.js +35 -0
  12. package/dist/cjs/config/lambdaParameterConfig.d.ts +12 -0
  13. package/dist/cjs/config/lambdaParameterConfig.js +45 -0
  14. package/dist/cjs/config/replaceConfig.d.ts +14 -0
  15. package/dist/cjs/config/replaceConfig.js +22 -0
  16. package/dist/cjs/config/resolveConfigValue.d.ts +5 -0
  17. package/dist/cjs/config/resolveConfigValue.js +12 -0
  18. package/dist/cjs/errors/index.d.ts +88 -0
  19. package/dist/cjs/errors/index.js +123 -0
  20. package/dist/cjs/fetch/fetchStatusRetry.d.ts +8 -0
  21. package/dist/cjs/fetch/fetchStatusRetry.js +27 -0
  22. package/dist/cjs/fetch/index.d.ts +64 -0
  23. package/dist/cjs/fetch/index.js +55 -0
  24. package/{packages/utils/src/guards/index.ts → dist/cjs/guards/index.d.ts} +7 -10
  25. package/dist/cjs/guards/index.js +44 -0
  26. package/dist/cjs/index.js +20 -0
  27. package/dist/cjs/middleware/apiErrorHandler.d.ts +24 -0
  28. package/dist/cjs/middleware/apiErrorHandler.js +42 -0
  29. package/dist/cjs/middleware/apiSlowResponseMiddleware.d.ts +23 -0
  30. package/dist/cjs/middleware/apiSlowResponseMiddleware.js +54 -0
  31. package/{packages/utils/src/middleware/index.ts → dist/cjs/middleware/index.d.ts} +5 -53
  32. package/dist/cjs/middleware/index.js +48 -0
  33. package/dist/cjs/middleware/lambdaCorsResponseMiddleware.d.ts +20 -0
  34. package/dist/cjs/middleware/lambdaCorsResponseMiddleware.js +44 -0
  35. package/dist/cjs/middleware/throwNotFoundMiddleware.d.ts +4 -0
  36. package/dist/cjs/middleware/throwNotFoundMiddleware.js +14 -0
  37. package/dist/cjs/misc/hashValue.d.ts +10 -0
  38. package/dist/cjs/misc/hashValue.js +17 -0
  39. package/dist/cjs/misc/helpers.d.ts +124 -0
  40. package/dist/cjs/misc/helpers.js +214 -0
  41. package/dist/cjs/misc/merge.d.ts +21 -0
  42. package/dist/cjs/misc/merge.js +45 -0
  43. package/dist/cjs/misc/partitionSequence.d.ts +35 -0
  44. package/dist/cjs/misc/partitionSequence.js +55 -0
  45. package/dist/cjs/pagination/index.d.ts +91 -0
  46. package/dist/cjs/pagination/index.js +83 -0
  47. package/dist/cjs/routing/helpers.d.ts +57 -0
  48. package/dist/cjs/routing/helpers.js +90 -0
  49. package/dist/cjs/routing/index.d.ts +290 -0
  50. package/dist/cjs/routing/index.js +295 -0
  51. package/dist/cjs/routing/validators/zod.d.ts +4 -0
  52. package/dist/cjs/routing/validators/zod.js +14 -0
  53. package/dist/cjs/services/accountsGateway/index.d.ts +92 -0
  54. package/dist/cjs/services/accountsGateway/index.js +138 -0
  55. package/dist/cjs/services/apiGateway/index.d.ts +68 -0
  56. package/dist/cjs/services/apiGateway/index.js +118 -0
  57. package/dist/cjs/services/authProvider/browser.d.ts +40 -0
  58. package/dist/cjs/services/authProvider/browser.js +155 -0
  59. package/dist/cjs/services/authProvider/decryption.d.ts +19 -0
  60. package/dist/cjs/services/authProvider/decryption.js +73 -0
  61. package/dist/cjs/services/authProvider/index.d.ts +63 -0
  62. package/dist/cjs/services/authProvider/index.js +34 -0
  63. package/dist/cjs/services/authProvider/subrequest.d.ts +13 -0
  64. package/dist/cjs/services/authProvider/subrequest.js +49 -0
  65. package/dist/cjs/services/authProvider/utils/decryptAndVerify.d.ts +28 -0
  66. package/dist/cjs/services/authProvider/utils/decryptAndVerify.js +91 -0
  67. package/dist/cjs/services/authProvider/utils/embeddedAuthProvider.d.ts +26 -0
  68. package/dist/cjs/services/authProvider/utils/embeddedAuthProvider.js +47 -0
  69. package/dist/cjs/services/authProvider/utils/userRoleValidator.d.ts +13 -0
  70. package/dist/cjs/services/authProvider/utils/userRoleValidator.js +37 -0
  71. package/dist/cjs/services/authProvider/utils/userSubrequest.d.ts +3 -0
  72. package/dist/cjs/services/authProvider/utils/userSubrequest.js +13 -0
  73. package/dist/cjs/services/documentStore/dynamoEncoding.d.ts +10 -0
  74. package/dist/cjs/services/documentStore/dynamoEncoding.js +52 -0
  75. package/dist/cjs/services/documentStore/fileSystemAssert.d.ts +1 -0
  76. package/dist/cjs/services/documentStore/fileSystemAssert.js +14 -0
  77. package/{packages/utils/src/services/documentStore/index.ts → dist/cjs/services/documentStore/index.d.ts} +8 -8
  78. package/dist/cjs/services/documentStore/index.js +2 -0
  79. package/dist/cjs/services/documentStore/unversioned/dynamodb.d.ts +31 -0
  80. package/dist/cjs/services/documentStore/unversioned/dynamodb.js +233 -0
  81. package/dist/cjs/services/documentStore/unversioned/file-system.d.ts +32 -0
  82. package/dist/cjs/services/documentStore/unversioned/file-system.js +214 -0
  83. package/{packages/utils/src/services/documentStore/unversioned/index.ts → dist/cjs/services/documentStore/unversioned/index.d.ts} +0 -2
  84. package/dist/cjs/services/documentStore/unversioned/index.js +2 -0
  85. package/dist/cjs/services/documentStore/versioned/dynamodb.d.ts +25 -0
  86. package/dist/cjs/services/documentStore/versioned/dynamodb.js +143 -0
  87. package/dist/cjs/services/documentStore/versioned/file-system.d.ts +25 -0
  88. package/dist/cjs/services/documentStore/versioned/file-system.js +73 -0
  89. package/dist/cjs/services/documentStore/versioned/index.d.ts +17 -0
  90. package/dist/cjs/services/documentStore/versioned/index.js +2 -0
  91. package/dist/cjs/services/exercisesGateway/index.d.ts +67 -0
  92. package/dist/cjs/services/exercisesGateway/index.js +107 -0
  93. package/dist/cjs/services/fileServer/index.d.ts +30 -0
  94. package/dist/cjs/services/fileServer/index.js +19 -0
  95. package/dist/cjs/services/fileServer/localFileServer.d.ts +13 -0
  96. package/dist/cjs/services/fileServer/localFileServer.js +132 -0
  97. package/dist/cjs/services/fileServer/s3FileServer.d.ts +14 -0
  98. package/dist/cjs/services/fileServer/s3FileServer.js +131 -0
  99. package/dist/cjs/services/launchParams/index.js +7 -0
  100. package/dist/cjs/services/launchParams/signer.d.ts +23 -0
  101. package/dist/cjs/services/launchParams/signer.js +58 -0
  102. package/dist/cjs/services/launchParams/verifier.d.ts +21 -0
  103. package/dist/cjs/services/launchParams/verifier.js +129 -0
  104. package/dist/cjs/services/logger/console.d.ts +4 -0
  105. package/dist/cjs/services/logger/console.js +12 -0
  106. package/{packages/utils/src/services/logger/index.ts → dist/cjs/services/logger/index.d.ts} +9 -23
  107. package/dist/cjs/services/logger/index.js +31 -0
  108. package/dist/cjs/services/lrsGateway/addStatementDefaultFields.d.ts +5 -0
  109. package/dist/cjs/services/lrsGateway/addStatementDefaultFields.js +21 -0
  110. package/dist/cjs/services/lrsGateway/attempt-utils.d.ts +72 -0
  111. package/dist/cjs/services/lrsGateway/attempt-utils.js +283 -0
  112. package/dist/cjs/services/lrsGateway/file-system.d.ts +15 -0
  113. package/dist/cjs/services/lrsGateway/file-system.js +150 -0
  114. package/dist/cjs/services/lrsGateway/index.d.ts +122 -0
  115. package/dist/cjs/services/lrsGateway/index.js +148 -0
  116. package/dist/cjs/services/lrsGateway/xapiUtils.d.ts +71 -0
  117. package/dist/cjs/services/lrsGateway/xapiUtils.js +145 -0
  118. package/dist/cjs/services/postgresConnection/index.d.ts +28 -0
  119. package/dist/cjs/services/postgresConnection/index.js +65 -0
  120. package/dist/cjs/services/searchProvider/index.d.ts +67 -0
  121. package/dist/cjs/services/searchProvider/index.js +2 -0
  122. package/dist/cjs/services/searchProvider/memorySearchTheBadWay.d.ts +20 -0
  123. package/dist/cjs/services/searchProvider/memorySearchTheBadWay.js +191 -0
  124. package/dist/cjs/services/searchProvider/openSearch.d.ts +28 -0
  125. package/dist/cjs/services/searchProvider/openSearch.js +154 -0
  126. package/dist/cjs/tsconfig.without-specs.cjs.tsbuildinfo +1 -0
  127. package/{packages/utils/src/types.ts → dist/cjs/types.d.ts} +6 -34
  128. package/dist/cjs/types.js +2 -0
  129. package/dist/esm/assertions/index.d.ts +89 -0
  130. package/{packages/utils/src/assertions/index.ts → dist/esm/assertions/index.js} +49 -64
  131. package/dist/esm/aws/ssmService.d.ts +5 -0
  132. package/dist/esm/aws/ssmService.js +6 -0
  133. package/dist/esm/config/awsParameterConfig.d.ts +10 -0
  134. package/dist/esm/config/awsParameterConfig.js +22 -0
  135. package/dist/esm/config/envConfig.d.ts +24 -0
  136. package/dist/esm/config/envConfig.js +53 -0
  137. package/dist/esm/config/index.d.ts +48 -0
  138. package/dist/esm/config/index.js +17 -0
  139. package/dist/esm/config/lambdaParameterConfig.d.ts +12 -0
  140. package/dist/esm/config/lambdaParameterConfig.js +38 -0
  141. package/dist/esm/config/replaceConfig.d.ts +14 -0
  142. package/{packages/utils/src/config/replaceConfig.ts → dist/esm/config/replaceConfig.js} +6 -16
  143. package/dist/esm/config/resolveConfigValue.d.ts +5 -0
  144. package/dist/esm/config/resolveConfigValue.js +8 -0
  145. package/dist/esm/errors/index.d.ts +88 -0
  146. package/{packages/utils/src/errors/index.ts → dist/esm/errors/index.js} +41 -57
  147. package/dist/esm/fetch/fetchStatusRetry.d.ts +8 -0
  148. package/dist/esm/fetch/fetchStatusRetry.js +23 -0
  149. package/dist/esm/fetch/index.d.ts +64 -0
  150. package/dist/esm/fetch/index.js +46 -0
  151. package/dist/esm/guards/index.d.ts +38 -0
  152. package/dist/esm/guards/index.js +36 -0
  153. package/dist/esm/index.d.ts +4 -0
  154. package/dist/esm/index.js +4 -0
  155. package/dist/esm/middleware/apiErrorHandler.d.ts +24 -0
  156. package/dist/esm/middleware/apiErrorHandler.js +38 -0
  157. package/dist/esm/middleware/apiSlowResponseMiddleware.d.ts +23 -0
  158. package/dist/esm/middleware/apiSlowResponseMiddleware.js +50 -0
  159. package/dist/esm/middleware/index.d.ts +47 -0
  160. package/dist/esm/middleware/index.js +44 -0
  161. package/dist/esm/middleware/lambdaCorsResponseMiddleware.d.ts +20 -0
  162. package/dist/esm/middleware/lambdaCorsResponseMiddleware.js +40 -0
  163. package/dist/esm/middleware/throwNotFoundMiddleware.d.ts +4 -0
  164. package/dist/esm/middleware/throwNotFoundMiddleware.js +10 -0
  165. package/dist/esm/misc/hashValue.d.ts +10 -0
  166. package/dist/esm/misc/hashValue.js +13 -0
  167. package/dist/esm/misc/helpers.d.ts +124 -0
  168. package/dist/esm/misc/helpers.js +199 -0
  169. package/dist/esm/misc/merge.d.ts +21 -0
  170. package/dist/esm/misc/merge.js +40 -0
  171. package/dist/esm/misc/partitionSequence.d.ts +35 -0
  172. package/{packages/utils/src/misc/partitionSequence.ts → dist/esm/misc/partitionSequence.js} +15 -23
  173. package/dist/esm/pagination/index.d.ts +91 -0
  174. package/dist/esm/pagination/index.js +77 -0
  175. package/dist/esm/routing/helpers.d.ts +57 -0
  176. package/{packages/utils/src/routing/helpers.ts → dist/esm/routing/helpers.js} +30 -42
  177. package/dist/esm/routing/index.d.ts +290 -0
  178. package/dist/esm/routing/index.js +246 -0
  179. package/dist/esm/routing/validators/zod.d.ts +4 -0
  180. package/dist/esm/routing/validators/zod.js +10 -0
  181. package/dist/esm/services/accountsGateway/index.d.ts +92 -0
  182. package/dist/esm/services/accountsGateway/index.js +131 -0
  183. package/dist/esm/services/apiGateway/index.d.ts +68 -0
  184. package/dist/esm/services/apiGateway/index.js +77 -0
  185. package/dist/esm/services/authProvider/browser.d.ts +40 -0
  186. package/dist/esm/services/authProvider/browser.js +151 -0
  187. package/dist/esm/services/authProvider/decryption.d.ts +19 -0
  188. package/dist/esm/services/authProvider/decryption.js +69 -0
  189. package/dist/esm/services/authProvider/index.d.ts +63 -0
  190. package/dist/esm/services/authProvider/index.js +26 -0
  191. package/dist/esm/services/authProvider/subrequest.d.ts +13 -0
  192. package/dist/esm/services/authProvider/subrequest.js +45 -0
  193. package/dist/esm/services/authProvider/utils/decryptAndVerify.d.ts +28 -0
  194. package/dist/esm/services/authProvider/utils/decryptAndVerify.js +85 -0
  195. package/dist/esm/services/authProvider/utils/embeddedAuthProvider.d.ts +26 -0
  196. package/dist/esm/services/authProvider/utils/embeddedAuthProvider.js +40 -0
  197. package/dist/esm/services/authProvider/utils/userRoleValidator.d.ts +13 -0
  198. package/dist/esm/services/authProvider/utils/userRoleValidator.js +33 -0
  199. package/dist/esm/services/authProvider/utils/userSubrequest.d.ts +3 -0
  200. package/dist/esm/services/authProvider/utils/userSubrequest.js +6 -0
  201. package/dist/esm/services/documentStore/dynamoEncoding.d.ts +10 -0
  202. package/dist/esm/services/documentStore/dynamoEncoding.js +45 -0
  203. package/dist/esm/services/documentStore/fileSystemAssert.d.ts +1 -0
  204. package/dist/esm/services/documentStore/fileSystemAssert.js +10 -0
  205. package/dist/esm/services/documentStore/index.d.ts +14 -0
  206. package/dist/esm/services/documentStore/index.js +1 -0
  207. package/dist/esm/services/documentStore/unversioned/dynamodb.d.ts +31 -0
  208. package/dist/esm/services/documentStore/unversioned/dynamodb.js +226 -0
  209. package/dist/esm/services/documentStore/unversioned/file-system.d.ts +32 -0
  210. package/dist/esm/services/documentStore/unversioned/file-system.js +174 -0
  211. package/dist/esm/services/documentStore/unversioned/index.d.ts +2 -0
  212. package/dist/esm/services/documentStore/unversioned/index.js +1 -0
  213. package/dist/esm/services/documentStore/versioned/dynamodb.d.ts +25 -0
  214. package/dist/esm/services/documentStore/versioned/dynamodb.js +139 -0
  215. package/dist/esm/services/documentStore/versioned/file-system.d.ts +25 -0
  216. package/dist/esm/services/documentStore/versioned/file-system.js +69 -0
  217. package/dist/esm/services/documentStore/versioned/index.d.ts +17 -0
  218. package/dist/esm/services/documentStore/versioned/index.js +1 -0
  219. package/dist/esm/services/exercisesGateway/index.d.ts +67 -0
  220. package/dist/esm/services/exercisesGateway/index.js +70 -0
  221. package/dist/esm/services/fileServer/index.d.ts +30 -0
  222. package/dist/esm/services/fileServer/index.js +13 -0
  223. package/dist/esm/services/fileServer/localFileServer.d.ts +13 -0
  224. package/dist/esm/services/fileServer/localFileServer.js +125 -0
  225. package/dist/esm/services/fileServer/s3FileServer.d.ts +14 -0
  226. package/dist/esm/services/fileServer/s3FileServer.js +124 -0
  227. package/dist/esm/services/launchParams/index.d.ts +2 -0
  228. package/dist/esm/services/launchParams/index.js +2 -0
  229. package/dist/esm/services/launchParams/signer.d.ts +23 -0
  230. package/dist/esm/services/launchParams/signer.js +51 -0
  231. package/dist/esm/services/launchParams/verifier.d.ts +21 -0
  232. package/dist/esm/services/launchParams/verifier.js +92 -0
  233. package/dist/esm/services/logger/console.d.ts +4 -0
  234. package/{packages/utils/src/services/logger/console.ts → dist/esm/services/logger/console.js} +2 -5
  235. package/dist/esm/services/logger/index.d.ts +39 -0
  236. package/dist/esm/services/logger/index.js +27 -0
  237. package/dist/esm/services/lrsGateway/addStatementDefaultFields.d.ts +5 -0
  238. package/dist/esm/services/lrsGateway/addStatementDefaultFields.js +14 -0
  239. package/dist/esm/services/lrsGateway/attempt-utils.d.ts +72 -0
  240. package/dist/esm/services/lrsGateway/attempt-utils.js +261 -0
  241. package/dist/esm/services/lrsGateway/file-system.d.ts +15 -0
  242. package/dist/esm/services/lrsGateway/file-system.js +110 -0
  243. package/dist/esm/services/lrsGateway/index.d.ts +122 -0
  244. package/dist/esm/services/lrsGateway/index.js +111 -0
  245. package/dist/esm/services/lrsGateway/xapiUtils.d.ts +71 -0
  246. package/dist/esm/services/lrsGateway/xapiUtils.js +134 -0
  247. package/dist/esm/services/postgresConnection/index.d.ts +28 -0
  248. package/dist/esm/services/postgresConnection/index.js +58 -0
  249. package/dist/esm/services/searchProvider/index.d.ts +67 -0
  250. package/dist/esm/services/searchProvider/index.js +1 -0
  251. package/dist/esm/services/searchProvider/memorySearchTheBadWay.d.ts +20 -0
  252. package/dist/esm/services/searchProvider/memorySearchTheBadWay.js +187 -0
  253. package/dist/esm/services/searchProvider/openSearch.d.ts +28 -0
  254. package/dist/esm/services/searchProvider/openSearch.js +150 -0
  255. package/dist/esm/tsconfig.without-specs.esm.tsbuildinfo +1 -0
  256. package/dist/esm/types.d.ts +31 -0
  257. package/dist/esm/types.js +1 -0
  258. package/package.json +228 -12
  259. package/.cfnlintrc +0 -2
  260. package/.github/CODEOWNERS +0 -1
  261. package/.github/workflows/ci.yml +0 -36
  262. package/.github/workflows/lint.yml +0 -55
  263. package/.nvmrc +0 -1
  264. package/.syncignore +0 -4
  265. package/.syncpackrc +0 -18
  266. package/CONTRIBUTING.md +0 -96
  267. package/LICENSE +0 -661
  268. package/Procfile +0 -1
  269. package/app.json +0 -23
  270. package/cspell.json +0 -32
  271. package/deploy/constants.env +0 -21
  272. package/deploy/deploy.bash +0 -157
  273. package/deploy/deployment-alt-region.cfn.yml +0 -70
  274. package/deploy/deployment.cfn.yml +0 -650
  275. package/deploy/destroy-deployment.bash +0 -23
  276. package/deploy/shared.cfn.yml +0 -94
  277. package/docs/lambda-build.md +0 -35
  278. package/packages/frontend/README.md +0 -46
  279. package/packages/frontend/package.json +0 -101
  280. package/packages/frontend/public/favicon.ico +0 -0
  281. package/packages/frontend/public/index.html +0 -107
  282. package/packages/frontend/public/maintenance.html +0 -59
  283. package/packages/frontend/public/manifest.json +0 -15
  284. package/packages/frontend/public/robots.txt +0 -3
  285. package/packages/frontend/script/make-certificate.bash +0 -49
  286. package/packages/frontend/script/server/cli.js +0 -11
  287. package/packages/frontend/script/server/index.js +0 -47
  288. package/packages/frontend/script/start.bash +0 -22
  289. package/packages/frontend/script/trust-localhost.bash +0 -7
  290. package/packages/frontend/src/auth/authProvider.ts +0 -10
  291. package/packages/frontend/src/auth/useAuth.ts +0 -33
  292. package/packages/frontend/src/components/Pagination.tsx +0 -26
  293. package/packages/frontend/src/configProvider/index.ts +0 -53
  294. package/packages/frontend/src/configProvider/use.ts +0 -41
  295. package/packages/frontend/src/core/context/services.spec.tsx +0 -39
  296. package/packages/frontend/src/core/context/services.tsx +0 -16
  297. package/packages/frontend/src/core/index.spec.ts +0 -7
  298. package/packages/frontend/src/core/index.ts +0 -20
  299. package/packages/frontend/src/core/services.tsx +0 -14
  300. package/packages/frontend/src/core/types.ts +0 -3
  301. package/packages/frontend/src/example/api.ts +0 -28
  302. package/packages/frontend/src/example/components/Layout.tsx +0 -23
  303. package/packages/frontend/src/example/screens/Home.spec.tsx +0 -68
  304. package/packages/frontend/src/example/screens/Home.tsx +0 -78
  305. package/packages/frontend/src/example/screens/ThingList.spec.tsx +0 -60
  306. package/packages/frontend/src/example/screens/ThingList.tsx +0 -75
  307. package/packages/frontend/src/example/screens/ThingView.spec.tsx +0 -71
  308. package/packages/frontend/src/example/screens/ThingView.tsx +0 -47
  309. package/packages/frontend/src/example/screens/index.ts +0 -9
  310. package/packages/frontend/src/index.css +0 -159
  311. package/packages/frontend/src/index.tsx +0 -67
  312. package/packages/frontend/src/react-app-env.d.ts +0 -1
  313. package/packages/frontend/src/routing/components/RouteLink.spec.tsx +0 -55
  314. package/packages/frontend/src/routing/components/RouteLink.tsx +0 -35
  315. package/packages/frontend/src/routing/middleware.ts +0 -6
  316. package/packages/frontend/src/routing/useQuery.ts +0 -14
  317. package/packages/frontend/src/setupProxy.js +0 -19
  318. package/packages/frontend/src/setupTests.ts +0 -9
  319. package/packages/frontend/src/tests/testServices.tsx +0 -23
  320. package/packages/frontend/tsconfig.json +0 -27
  321. package/packages/lambda/.eslintrc.js +0 -64
  322. package/packages/lambda/jest-global-setup.js +0 -3
  323. package/packages/lambda/jest-setup-after-env.js +0 -1
  324. package/packages/lambda/jest.config.js +0 -31
  325. package/packages/lambda/jest.resolver.js +0 -17
  326. package/packages/lambda/package.json +0 -68
  327. package/packages/lambda/script/build.bash +0 -19
  328. package/packages/lambda/script/bundle-functions.bash +0 -10
  329. package/packages/lambda/script/lambdaLocalProxy.js +0 -16
  330. package/packages/lambda/script/lambdaLocalProxy.spec.ts +0 -147
  331. package/packages/lambda/script/utils/getRouteData.ts +0 -7
  332. package/packages/lambda/script/utils/routeDataLoader.js +0 -8
  333. package/packages/lambda/script/utils/routeDataLoader.spec.ts +0 -8
  334. package/packages/lambda/src/functions/serviceApi/core/index.ts +0 -7
  335. package/packages/lambda/src/functions/serviceApi/core/request.spec.ts +0 -38
  336. package/packages/lambda/src/functions/serviceApi/core/request.ts +0 -42
  337. package/packages/lambda/src/functions/serviceApi/core/routes.spec.ts +0 -7
  338. package/packages/lambda/src/functions/serviceApi/core/routes.ts +0 -10
  339. package/packages/lambda/src/functions/serviceApi/core/services.ts +0 -9
  340. package/packages/lambda/src/functions/serviceApi/core/types.ts +0 -13
  341. package/packages/lambda/src/functions/serviceApi/entry/lambda/https-xray.ts +0 -4
  342. package/packages/lambda/src/functions/serviceApi/entry/lambda/index.spec.ts +0 -48
  343. package/packages/lambda/src/functions/serviceApi/entry/lambda/index.ts +0 -58
  344. package/packages/lambda/src/functions/serviceApi/entry/lambda/services.ts +0 -36
  345. package/packages/lambda/src/functions/serviceApi/entry/local.ts +0 -71
  346. package/packages/lambda/src/functions/serviceApi/versions/v0/example/documentSearchMiddleware.spec.ts +0 -16
  347. package/packages/lambda/src/functions/serviceApi/versions/v0/example/documentSearchMiddleware.ts +0 -41
  348. package/packages/lambda/src/functions/serviceApi/versions/v0/example/documentStoreMiddleware.spec.ts +0 -78
  349. package/packages/lambda/src/functions/serviceApi/versions/v0/example/documentStoreMiddleware.ts +0 -70
  350. package/packages/lambda/src/functions/serviceApi/versions/v0/example/routes.spec.ts +0 -306
  351. package/packages/lambda/src/functions/serviceApi/versions/v0/example/routes.ts +0 -176
  352. package/packages/lambda/src/functions/serviceApi/versions/v0/index.spec.ts +0 -263
  353. package/packages/lambda/src/functions/serviceApi/versions/v0/index.ts +0 -134
  354. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/authMiddleware.spec.ts +0 -23
  355. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/authMiddleware.ts +0 -32
  356. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/configMiddleware.spec.ts +0 -10
  357. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/configMiddleware.ts +0 -7
  358. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/frontendFileServerMiddleware.spec.ts +0 -13
  359. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/frontendFileServerMiddleware.ts +0 -23
  360. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/paginationMiddleware.spec.ts +0 -9
  361. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/paginationMiddleware.ts +0 -9
  362. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/searchMiddleware.spec.ts +0 -12
  363. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/searchMiddleware.ts +0 -21
  364. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/userRoleValidatorMiddleware.spec.ts +0 -21
  365. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/userRoleValidatorMiddleware.ts +0 -18
  366. package/packages/lambda/tsconfig.json +0 -30
  367. package/packages/lambda/webpack.config.js +0 -97
  368. package/packages/utils/.eslintrc.js +0 -64
  369. package/packages/utils/README.md +0 -118
  370. package/packages/utils/jest-global-setup.js +0 -3
  371. package/packages/utils/jest.config.js +0 -25
  372. package/packages/utils/jest.resolver.js +0 -17
  373. package/packages/utils/package.json +0 -238
  374. package/packages/utils/src/assertions/index.spec.ts +0 -126
  375. package/packages/utils/src/aws/ssmService.ts +0 -7
  376. package/packages/utils/src/config/awsParameterConfig.ts +0 -24
  377. package/packages/utils/src/config/envConfig.ts +0 -58
  378. package/packages/utils/src/config/index.spec.ts +0 -165
  379. package/packages/utils/src/config/lambdaParameterConfig.ts +0 -49
  380. package/packages/utils/src/config/resolveConfigValue.ts +0 -10
  381. package/packages/utils/src/errors/index.spec.ts +0 -35
  382. package/packages/utils/src/fetch/fetchStatusRetry.spec.ts +0 -197
  383. package/packages/utils/src/fetch/fetchStatusRetry.ts +0 -33
  384. package/packages/utils/src/fetch/index.spec.ts +0 -34
  385. package/packages/utils/src/fetch/index.ts +0 -87
  386. package/packages/utils/src/guards/index.spec.ts +0 -58
  387. package/packages/utils/src/index.spec.ts +0 -471
  388. package/packages/utils/src/middleware/apiErrorHandler.spec.ts +0 -65
  389. package/packages/utils/src/middleware/apiErrorHandler.ts +0 -67
  390. package/packages/utils/src/middleware/apiSlowResponseMiddleware.spec.ts +0 -184
  391. package/packages/utils/src/middleware/apiSlowResponseMiddleware.ts +0 -71
  392. package/packages/utils/src/middleware/index.spec.ts +0 -99
  393. package/packages/utils/src/middleware/lambdaCorsResponseMiddleware.spec.ts +0 -103
  394. package/packages/utils/src/middleware/lambdaCorsResponseMiddleware.ts +0 -52
  395. package/packages/utils/src/middleware/throwNotFoundMiddleware.spec.ts +0 -20
  396. package/packages/utils/src/middleware/throwNotFoundMiddleware.ts +0 -11
  397. package/packages/utils/src/misc/hashValue.ts +0 -18
  398. package/packages/utils/src/misc/helpers.ts +0 -259
  399. package/packages/utils/src/misc/merge.ts +0 -48
  400. package/packages/utils/src/pagination/index.spec.ts +0 -150
  401. package/packages/utils/src/pagination/index.ts +0 -117
  402. package/packages/utils/src/routing/index.spec.ts +0 -553
  403. package/packages/utils/src/routing/index.ts +0 -424
  404. package/packages/utils/src/routing/validators/zod.spec.ts +0 -16
  405. package/packages/utils/src/routing/validators/zod.ts +0 -14
  406. package/packages/utils/src/services/accountsGateway/README.md +0 -3
  407. package/packages/utils/src/services/accountsGateway/index.spec.ts +0 -518
  408. package/packages/utils/src/services/accountsGateway/index.ts +0 -251
  409. package/packages/utils/src/services/apiGateway/README.md +0 -93
  410. package/packages/utils/src/services/apiGateway/index.spec.ts +0 -254
  411. package/packages/utils/src/services/apiGateway/index.ts +0 -189
  412. package/packages/utils/src/services/authProvider/README.md +0 -21
  413. package/packages/utils/src/services/authProvider/browser.spec.ts +0 -391
  414. package/packages/utils/src/services/authProvider/browser.ts +0 -209
  415. package/packages/utils/src/services/authProvider/decryption.spec.ts +0 -337
  416. package/packages/utils/src/services/authProvider/decryption.ts +0 -98
  417. package/packages/utils/src/services/authProvider/index.ts +0 -93
  418. package/packages/utils/src/services/authProvider/stub.spec.ts +0 -29
  419. package/packages/utils/src/services/authProvider/subrequest.spec.ts +0 -105
  420. package/packages/utils/src/services/authProvider/subrequest.ts +0 -68
  421. package/packages/utils/src/services/authProvider/utils/decryptAndVerify.spec.ts +0 -128
  422. package/packages/utils/src/services/authProvider/utils/decryptAndVerify.ts +0 -106
  423. package/packages/utils/src/services/authProvider/utils/embeddedAuthProvider.spec.ts +0 -26
  424. package/packages/utils/src/services/authProvider/utils/embeddedAuthProvider.ts +0 -57
  425. package/packages/utils/src/services/authProvider/utils/userRoleValidator.spec.ts +0 -135
  426. package/packages/utils/src/services/authProvider/utils/userRoleValidator.ts +0 -49
  427. package/packages/utils/src/services/authProvider/utils/userSubrequest.spec.ts +0 -26
  428. package/packages/utils/src/services/authProvider/utils/userSubrequest.ts +0 -10
  429. package/packages/utils/src/services/documentStore/dynamoEncoding.ts +0 -57
  430. package/packages/utils/src/services/documentStore/fileSystemAssert.spec.ts +0 -43
  431. package/packages/utils/src/services/documentStore/fileSystemAssert.ts +0 -10
  432. package/packages/utils/src/services/documentStore/unversioned/README.md +0 -13
  433. package/packages/utils/src/services/documentStore/unversioned/dynamodb.spec.ts +0 -859
  434. package/packages/utils/src/services/documentStore/unversioned/dynamodb.ts +0 -243
  435. package/packages/utils/src/services/documentStore/unversioned/file-system.spec.ts +0 -629
  436. package/packages/utils/src/services/documentStore/unversioned/file-system.ts +0 -194
  437. package/packages/utils/src/services/documentStore/versioned/README.md +0 -13
  438. package/packages/utils/src/services/documentStore/versioned/dynamodb.spec.ts +0 -376
  439. package/packages/utils/src/services/documentStore/versioned/dynamodb.ts +0 -167
  440. package/packages/utils/src/services/documentStore/versioned/file-system.spec.ts +0 -262
  441. package/packages/utils/src/services/documentStore/versioned/file-system.ts +0 -90
  442. package/packages/utils/src/services/documentStore/versioned/index.ts +0 -25
  443. package/packages/utils/src/services/exercisesGateway/README.md +0 -5
  444. package/packages/utils/src/services/exercisesGateway/index.spec.ts +0 -326
  445. package/packages/utils/src/services/exercisesGateway/index.ts +0 -163
  446. package/packages/utils/src/services/fileServer/index.spec.ts +0 -88
  447. package/packages/utils/src/services/fileServer/index.ts +0 -43
  448. package/packages/utils/src/services/fileServer/localFileServer.spec.ts +0 -182
  449. package/packages/utils/src/services/fileServer/localFileServer.ts +0 -159
  450. package/packages/utils/src/services/fileServer/s3FileServer.spec.ts +0 -266
  451. package/packages/utils/src/services/fileServer/s3FileServer.ts +0 -155
  452. package/packages/utils/src/services/launchParams/index.spec.ts +0 -366
  453. package/packages/utils/src/services/launchParams/signer.ts +0 -73
  454. package/packages/utils/src/services/launchParams/verifier.ts +0 -120
  455. package/packages/utils/src/services/logger/console.spec.ts +0 -29
  456. package/packages/utils/src/services/logger/index.spec.ts +0 -65
  457. package/packages/utils/src/services/lrsGateway/README.md +0 -5
  458. package/packages/utils/src/services/lrsGateway/addStatementDefaultFields.ts +0 -22
  459. package/packages/utils/src/services/lrsGateway/attempt-utils.spec.ts +0 -847
  460. package/packages/utils/src/services/lrsGateway/attempt-utils.ts +0 -358
  461. package/packages/utils/src/services/lrsGateway/file-system.spec.ts +0 -363
  462. package/packages/utils/src/services/lrsGateway/file-system.ts +0 -165
  463. package/packages/utils/src/services/lrsGateway/index.spec.ts +0 -194
  464. package/packages/utils/src/services/lrsGateway/index.ts +0 -257
  465. package/packages/utils/src/services/lrsGateway/xapiUtils.spec.ts +0 -887
  466. package/packages/utils/src/services/lrsGateway/xapiUtils.ts +0 -262
  467. package/packages/utils/src/services/postgresConnection/index.spec.ts +0 -170
  468. package/packages/utils/src/services/postgresConnection/index.ts +0 -84
  469. package/packages/utils/src/services/searchProvider/README.md +0 -3
  470. package/packages/utils/src/services/searchProvider/index.ts +0 -59
  471. package/packages/utils/src/services/searchProvider/memorySearchTheBadWay.spec.ts +0 -526
  472. package/packages/utils/src/services/searchProvider/memorySearchTheBadWay.ts +0 -223
  473. package/packages/utils/src/services/searchProvider/openSearch.spec.ts +0 -926
  474. package/packages/utils/src/services/searchProvider/openSearch.ts +0 -195
  475. package/packages/utils/tsconfig.json +0 -31
  476. package/packages/utils/tsconfig.without-specs.cjs.json +0 -7
  477. package/packages/utils/tsconfig.without-specs.esm.json +0 -7
  478. package/packages/utils/tsconfig.without-specs.json +0 -6
  479. package/scripts/build.bash +0 -24
  480. package/scripts/ci.bash +0 -10
  481. package/scripts/start.bash +0 -29
  482. /package/{packages/utils/src/index.ts → dist/cjs/index.d.ts} +0 -0
  483. /package/{packages/utils/src/services/launchParams/index.ts → dist/cjs/services/launchParams/index.d.ts} +0 -0
  484. /package/{packages/utils/script → script}/bin/copy-from-template.bash +0 -0
  485. /package/{packages/utils/script → script}/bin/delete-stack.bash +0 -0
  486. /package/{packages/utils/script → script}/bin/deploy.bash +0 -0
  487. /package/{packages/utils/script → script}/bin/destroy-deployment.bash +0 -0
  488. /package/{packages/utils/script → script}/bin/empty-bucket.bash +0 -0
  489. /package/{packages/utils/script → script}/bin/get-arg.bash +0 -0
  490. /package/{packages/utils/script → script}/bin/get-deployed-environments.bash +0 -0
  491. /package/{packages/utils/script → script}/bin/get-env-param.bash +0 -0
  492. /package/{packages/utils/script → script}/bin/get-kwarg.bash +0 -0
  493. /package/{packages/utils/script → script}/bin/get-stack-param.bash +0 -0
  494. /package/{packages/utils/script → script}/bin/has-flag.bash +0 -0
  495. /package/{packages/utils/script → script}/bin/init-constants-script.bash +0 -0
  496. /package/{packages/utils/script → script}/bin/init-params-script.bash +0 -0
  497. /package/{packages/utils/script → script}/bin/stack-exists.bash +0 -0
  498. /package/{packages/utils/script → script}/bin/update-utils.bash +0 -0
  499. /package/{packages/utils/script → script}/bin/upload-pager-duty-endpoints.bash +0 -0
  500. /package/{packages/utils/script → script}/bin/upload-params.bash +0 -0
  501. /package/{packages/utils/script → script}/bin/which.bash +0 -0
  502. /package/{packages/utils/script → script}/bin-entry.bash +0 -0
  503. /package/{packages/utils/script → script}/build.bash +0 -0
@@ -1,33 +0,0 @@
1
- import { RetryOptions, retryWithDelay } from '../misc/helpers';
2
- import { GenericFetch } from '.';
3
-
4
- interface Options extends RetryOptions {
5
- status?: number[];
6
- timeout?: number;
7
- }
8
-
9
- export const fetchStatusRetry = (base: GenericFetch, options: Options): GenericFetch => {
10
-
11
- return (...params) => retryWithDelay(() => {
12
- const fetchPromise = base(...params).then(r => {
13
- if (options.status?.includes(r.status)) {
14
- return r.text().then(text => {
15
- throw new Error(`fetch failed ${params[0]} -- ${r.status}: ${text}`);
16
- });
17
- }
18
- return r;
19
- });
20
-
21
- if (options.timeout) {
22
- const timeoutPromise = new Promise<never>((_, reject) => {
23
- setTimeout(() => {
24
- reject(new Error(`fetch timeout after ${options.timeout}ms: ${params[0]}`));
25
- }, options.timeout);
26
- });
27
-
28
- return Promise.race([fetchPromise, timeoutPromise]);
29
- }
30
-
31
- return fetchPromise;
32
- }, options);
33
- };
@@ -1,34 +0,0 @@
1
- import { fetchError, fetchIdle, fetchLoading, FetchStateType, fetchSuccess, stateHasData, stateHasError } from '.';
2
-
3
- describe('creators', () => {
4
- it('creates FetchStateLoading', () => {
5
- expect(fetchLoading()).toEqual({type: 'loading'});
6
- });
7
- it('creates FetchStateLoading, with data', () => {
8
- expect(fetchLoading({type: FetchStateType.ERROR, error: 'some error', data: 'other data'})).toEqual({type: 'loading', data: 'other data'});
9
- });
10
- it('creates FetchStateError', () => {
11
- expect(fetchError('hello')).toEqual({type: 'error', error: 'hello'});
12
- });
13
- it('creates FetchStateSuccess', () => {
14
- expect(fetchSuccess('wow, such success')).toEqual({type: 'success', data: 'wow, such success'});
15
- });
16
- it('creates FetchStateIdle', () => {
17
- expect(fetchIdle()).toEqual({type: 'idle'});
18
- });
19
- });
20
-
21
- describe('guards', () => {
22
- it('returns true with data', () => {
23
- expect(stateHasData(fetchSuccess('wow'))).toBe(true);
24
- });
25
- it('returns false with data', () => {
26
- expect(stateHasData(fetchLoading())).toBe(false);
27
- });
28
- it('returns true with error', () => {
29
- expect(stateHasError(fetchError('wow'))).toBe(true);
30
- });
31
- it('returns false with error', () => {
32
- expect(stateHasError(fetchLoading())).toBe(false);
33
- });
34
- });
@@ -1,87 +0,0 @@
1
- import { METHOD } from '../routing';
2
-
3
- /*
4
- * these are just helpers for formatting responses, they don't actually do any loading. especially in UI development they
5
- * help with continuity over loading, reloading, saving, and errors. this is pretty nice in typescript because you have to deal
6
- * with the possibility that the result state is in a loading or error state. if you avoid dealing with those states you need
7
- * to write very clear code to ignore them, which easily presents missing functionality like errors that are not being messaged
8
- * to the user.
9
- * */
10
- export enum FetchStateType {
11
- SUCCESS = 'success',
12
- ERROR = 'error',
13
- LOADING = 'loading',
14
- IDLE = 'idle',
15
- }
16
-
17
- export type FetchState<D, E> = FetchStateLoading<D>
18
- | FetchStateError<D, E>
19
- | FetchStateSuccess<D>
20
- | FetchStateIdle;
21
-
22
- type FetchStateLoading<D> = {type: FetchStateType.LOADING; data?: D};
23
- type FetchStateError<D, E> = {type: FetchStateType.ERROR; data?: D; error: E};
24
- type FetchStateSuccess<D> = {type: FetchStateType.SUCCESS; data: D};
25
- type FetchStateIdle = {type: FetchStateType.IDLE};
26
-
27
- /*
28
- * keeps existing data but sets the new status
29
- *
30
- * const state = fetchLoading(previousState)
31
- * */
32
- export const fetchLoading = <D, E>(previous?: FetchState<D, E>): FetchStateLoading<D> => ({type: FetchStateType.LOADING, ...(previous && 'data' in previous ? {data: previous.data} : {})});
33
-
34
- /*
35
- * keeps existing data but sets the new status and error value
36
- *
37
- * const state = fetchError(error, previousState)
38
- * */
39
- export const fetchError = <D, E>(error: E, previous?: FetchState<D, E>): FetchStateError<D, E> => ({...previous, type: FetchStateType.ERROR, error});
40
-
41
- /*
42
- * formats data with success type
43
- *
44
- * const state = fetchSuccess(newData)
45
- * */
46
- export const fetchSuccess = <D>(data: D): FetchStateSuccess<D> => ({type: FetchStateType.SUCCESS, data});
47
-
48
- /*
49
- * formats data with idle type
50
- *
51
- * const state = fetchIdle(newData)
52
- * */
53
- export const fetchIdle = (): FetchStateIdle => ({type: FetchStateType.IDLE});
54
-
55
- /*
56
- * guard for checking if the state has result data, it might be true for any state type.
57
- * */
58
- export const stateHasData = <D, E>(state: {type: FetchStateType; data?: D; error?: E}): state is {type: FetchStateType; data: D} => 'data' in state;
59
- /*
60
- * guard for checking if the state has an error, it might be true for error or loading states.
61
- * */
62
- export const stateHasError = <D, E>(state: {type: FetchStateType; data?: D; error?: E}): state is {type: FetchStateType; error: E} => 'error' in state;
63
-
64
- /*
65
- * a minimal fetch interface that is compatible with both WindowOrWorkerGlobalScope['fetch'] and node-fetch
66
- * only the features needed by this library are defined here. the generic is so that utilities can set
67
- * themselves up to accept input fetchConfig that may extend this.
68
- */
69
- export type FetchConfig = {
70
- credentials?: 'include' | 'omit' | 'same-origin';
71
- method?: METHOD;
72
- body?: string;
73
- headers?: {[key: string]: string};
74
- };
75
- type Headers = {
76
- get: (name: string) => string | null;
77
- };
78
- export type Response = {
79
- status: number;
80
- headers: Headers;
81
- json: () => Promise<any>;
82
- text: () => Promise<string>;
83
- };
84
- export type GenericFetch<C extends FetchConfig = FetchConfig, R extends Response = Response> =
85
- (url: string, fetchConfig?: C) => Promise<R>;
86
-
87
- export type ConfigForFetch<F> = F extends GenericFetch<infer C, any> ? C : never;
@@ -1,58 +0,0 @@
1
- import { ifDefined, isDefined, isNotNull, isNumber, isPlainObject } from '.';
2
-
3
- describe('ifDefined', () => {
4
- it('returns input', () => {
5
- expect(ifDefined('input', 'default')).toBe('input');
6
- });
7
- it('returns default', () => {
8
- expect(ifDefined(undefined, 'default')).toBe('default');
9
- });
10
- });
11
-
12
- describe('isNumber', () => {
13
- it('returns true', () => {
14
- expect(isNumber(5)).toBe(true);
15
- });
16
- it('returns false', () => {
17
- expect(isNumber('5')).toBe(false);
18
- });
19
- });
20
-
21
- describe('isDefined', () => {
22
- it('is defined', () => {
23
- expect(isDefined('asdf')).toBe(true);
24
- });
25
- it('null is defined', () => {
26
- expect(isDefined(null)).toBe(true);
27
- });
28
- it('false is defined', () => {
29
- expect(isDefined(false)).toBe(true);
30
- });
31
- it('isn\'t defined', () => {
32
- expect(isDefined(undefined)).toBe(false);
33
- });
34
- });
35
-
36
- describe('isNotNull', () => {
37
- it('is not null', () => {
38
- expect(isNotNull('asdf')).toBe(true);
39
- });
40
- it('null is null', () => {
41
- expect(isNotNull(null)).toBe(false);
42
- });
43
- it('false is not null', () => {
44
- expect(isNotNull(false)).toBe(true);
45
- });
46
- it('undefined is not null', () => {
47
- expect(isNotNull(undefined)).toBe(true);
48
- });
49
- });
50
-
51
- describe('isPlainObject', () => {
52
- it('is plain', () => {
53
- expect(isPlainObject({})).toBe(true);
54
- });
55
- it('is not plain', () => {
56
- expect(isPlainObject(new Error())).toBe(false);
57
- });
58
- });
@@ -1,471 +0,0 @@
1
- import { retryWithDelay } from './misc/helpers';
2
- import { coerceArray, flow, fnIf, getKeyValue, getKeyValueOr, hashValue, mapFind, memoize, merge, once, partitionSequence, putKeyValue, roundToPrecision, tuple } from '.';
3
-
4
- afterEach(() => {
5
- jest.clearAllMocks();
6
- });
7
-
8
- describe('mapFind', () => {
9
- it('finds first result', () => {
10
- const array = [{a: 0}, {a: 2}, {a: 0}, {a: 1}];
11
- const result = mapFind(array, x => x.a);
12
-
13
- expect(result).toBe(2);
14
- });
15
-
16
- it('finds first result with predicate', () => {
17
- const array = [{a: 0}, {a: 2}, {a: 0}, {a: 1}];
18
- const result = mapFind(array, x => x.a, x => x === 1);
19
-
20
- expect(result).toBe(1);
21
- });
22
-
23
- it('fails to find result', () => {
24
- const array: {a: number; b?: number}[] = [{a: 0}, {a: 2}, {a: 0}, {a: 1}];
25
- const result = mapFind(array, x => x.b);
26
-
27
- expect(result).toBeUndefined();
28
- });
29
-
30
- it('fails to find result with predicate', () => {
31
- const array = [{a: 0}, {a: 2}, {a: 0}, {a: 1}];
32
- const result = mapFind(array, x => x.a, x => x === 3);
33
-
34
- expect(result).toBeUndefined();
35
- });
36
- });
37
-
38
- describe('hashValue', () => {
39
- it('hashes a string', () => {
40
- expect(hashValue('a string')).toEqual(expect.any(String));
41
- expect(hashValue('a string')).toEqual(hashValue('a string'));
42
- expect(hashValue('a string')).not.toEqual(hashValue('a different string'));
43
- });
44
- it('hashes a boolean', () => {
45
- expect(hashValue(true)).toEqual(expect.any(String));
46
- expect(hashValue(true)).toEqual(hashValue(true));
47
- expect(hashValue(true)).not.toEqual(hashValue(false));
48
- });
49
- it('hashes a number', () => {
50
- expect(hashValue(1)).toEqual(expect.any(String));
51
- expect(hashValue(1)).toEqual(hashValue(1));
52
- expect(hashValue(1)).not.toEqual(hashValue(2));
53
- });
54
- it('hashes a list', () => {
55
- expect(hashValue([1,2])).toEqual(expect.any(String));
56
- expect(hashValue([1,2])).toEqual(hashValue([1,2]));
57
- expect(hashValue([1,2])).not.toEqual(hashValue([2,3]));
58
- });
59
- it('hashes an object', () => {
60
- expect(hashValue({one: 'one'})).toEqual(expect.any(String));
61
- expect(hashValue({one: 'one'})).toEqual(hashValue({one: 'one'}));
62
- expect(hashValue({one: 'one'})).not.toEqual(hashValue({two: 'two'}));
63
- expect(hashValue({one: 'one', two: 'two'})).toEqual(hashValue({two: 'two', one: 'one'}));
64
- });
65
- });
66
-
67
- describe('object access', () => {
68
- it('gets key value', () => {
69
- expect(getKeyValue('theKey')({theKey: 'theValue'})).toBe('theValue');
70
- });
71
- it('gets key value with default', () => {
72
- expect(getKeyValueOr('theKey', 'defaultValue')({theKey: 'theValue'})).toBe('theValue');
73
- });
74
- it('gets default value', () => {
75
- expect(getKeyValueOr('theKey', 'defaultValue')({theKey: null})).toBe('defaultValue');
76
- });
77
- it('puts key value', () => {
78
- expect(putKeyValue('theKey')({theKey: 'theValue'}, 'newValue')).toEqual({theKey: 'newValue'});
79
- });
80
- });
81
-
82
- describe('once', () => {
83
- it('calls once', () => {
84
- const spy = jest.fn(x => x);
85
- const onceSpy = once(spy);
86
-
87
- expect(onceSpy(5)).toBe(5);
88
- expect(onceSpy(1)).toBe(5);
89
- expect(onceSpy(7)).toBe(5);
90
- expect(onceSpy(2)).toBe(5);
91
-
92
- expect(spy).toHaveBeenCalledTimes(1);
93
- });
94
-
95
- it('calls once when result is falsy', () => {
96
- const spy = jest.fn(_x => null);
97
- const onceSpy = once(spy);
98
-
99
- expect(onceSpy(5)).toBeNull();
100
- expect(onceSpy(1)).toBeNull();
101
- expect(onceSpy(7)).toBeNull();
102
- expect(onceSpy(2)).toBeNull();
103
-
104
- expect(spy).toHaveBeenCalledTimes(1);
105
- });
106
-
107
- it('calls multiple times when the function throws', () => {
108
- const spy = jest.fn((_x) => { throw new Error('Bad Request'); });
109
- const onceSpy = once(spy);
110
-
111
- expect(() => onceSpy(1)).toThrow('Bad Request');
112
- expect(() => onceSpy(2)).toThrow('Bad Request');
113
-
114
- expect(spy).toHaveBeenCalledTimes(2);
115
- });
116
-
117
- it('calls multiple times when the function returns a Promise that rejects (when it rejects)', async() => {
118
- const spy = jest.fn(async(_x) => { throw new Error('Bad Request'); });
119
- const onceSpy = once(spy);
120
-
121
- const promise1 = onceSpy(1);
122
- const promise2 = onceSpy(2);
123
-
124
- await expect(promise1).rejects.toThrow('Bad Request');
125
- await expect(promise2).rejects.toThrow('Bad Request');
126
-
127
- expect(spy).toHaveBeenCalledTimes(1);
128
-
129
- await expect(onceSpy(3)).rejects.toThrow('Bad Request');
130
-
131
- expect(spy).toHaveBeenCalledTimes(2);
132
- });
133
- });
134
-
135
- describe('merge', () => {
136
- it('merges simple object', () => {
137
- expect(merge({key1: 'value1'}, {key2: 'value2'})).toEqual({key1: 'value1', key2: 'value2'});
138
- });
139
-
140
- it('merges objects recursively', () => {
141
- expect(merge(
142
- {key1: 'value1', subObject: {subKey1: 'subValue1'}},
143
- {key2: 'value2', subObject: {subKey2: 'subValue2'}}
144
- )).toEqual({key1: 'value1', key2: 'value2', subObject: {subKey1: 'subValue1', subKey2: 'subValue2'}});
145
- });
146
-
147
- it('merges arrays recursively', () => {
148
- expect(merge(
149
- {key1: 'value1', subArray: ['subValue1']},
150
- {key2: 'value2', subArray: ['subValue2']}
151
- )).toEqual({key1: 'value1', key2: 'value2', subArray: ['subValue1', 'subValue2']});
152
- });
153
-
154
- it('last value for common key wins', () => {
155
- expect(merge({key: 'value1'}, {key: 'value2'})).toEqual({key: 'value2'});
156
- });
157
-
158
- it('object references work when unmerged', () => {
159
- const subObject1 = {subKey1: 'subValue1'};
160
- const subObject2 = {subKey2: 'subValue2'};
161
- const merged = merge(
162
- {key1: 'value1', subObject1, subObject: subObject1},
163
- {key2: 'value2', subObject2, subObject: subObject2}
164
- );
165
-
166
- expect(merged.subObject1).toBe(subObject1);
167
- expect(merged.subObject2).toBe(subObject2);
168
- expect(merged.subObject).not.toBe(subObject1);
169
- expect(merged.subObject).not.toBe(subObject2);
170
- });
171
- });
172
-
173
- describe('tuple', () => {
174
- it('works', () => {
175
- expect(tuple(1,2)).toEqual([1,2]);
176
- });
177
- });
178
-
179
- describe('fnIf', () => {
180
- it('returns one', () => {
181
- expect(fnIf(true, 'this one', 'not this one')).toBe('this one');
182
- });
183
-
184
- it('returns two', () => {
185
- expect(fnIf(false, 'not this one', 'this one')).toBe('this one');
186
- });
187
- });
188
-
189
- describe('roundToPrecision', () => {
190
- it('rounds positive places', () => {
191
- expect(roundToPrecision(1234.123, 2)).toBe(1200);
192
- });
193
-
194
- it('rounds negative places', () => {
195
- expect(roundToPrecision(1234.123, -2)).toBe(1234.12);
196
- });
197
-
198
- it('rounds up 5s', () => {
199
- expect(roundToPrecision(1234.125, -2)).toBe(1234.13);
200
- });
201
- });
202
-
203
- describe('memoize', () => {
204
- it('memoizes', () => {
205
- const fn = jest.fn((x: number) => x * 2);
206
- const fnM = memoize(fn);
207
-
208
- expect(fnM(3)).toBe(6);
209
- expect(fnM(3)).toBe(6);
210
- expect(fnM(3)).toBe(6);
211
- expect(fnM(1)).toBe(2);
212
- expect(fnM(1)).toBe(2);
213
- expect(fnM(7)).toBe(14);
214
-
215
- expect(fn).toHaveBeenCalledTimes(3);
216
- });
217
-
218
- it('handles multiple arguments', () => {
219
- const fn = jest.fn((x: number, y: number, z: number = 1) => x * y * z);
220
- const fnM = memoize(fn);
221
-
222
- expect(fnM(3, 2)).toBe(6);
223
- expect(fnM(3, 2)).toBe(6);
224
- expect(fnM(3, 3)).toBe(9);
225
- expect(fnM(3, 3, 2)).toBe(18);
226
- expect(fnM(3, 3, 2)).toBe(18);
227
- expect(fnM(1, 2)).toBe(2);
228
- expect(fnM(1, 2)).toBe(2);
229
- expect(fnM(7, 2)).toBe(14);
230
-
231
- expect(fn).toHaveBeenCalledTimes(5);
232
- });
233
-
234
- it('memoizes object arguments', () => {
235
- const fn = jest.fn((x: number, {y, z}: {y: number; z?: number}) => x * y * (z || 1));
236
- const fnM = memoize(fn);
237
-
238
- const two = {y: 2};
239
- const threeTwo = {y:3, z: 2};
240
-
241
- expect(fnM(3, two)).toBe(6);
242
- expect(fnM(3, two)).toBe(6);
243
- expect(fnM(3, {y: 3})).toBe(9);
244
- expect(fnM(3, threeTwo)).toBe(18);
245
- expect(fnM(3, threeTwo)).toBe(18);
246
- expect(fnM(1, two)).toBe(2);
247
- expect(fnM(1, two)).toBe(2);
248
- expect(fnM(7, two)).toBe(14);
249
-
250
- expect(fn).toHaveBeenCalledTimes(5);
251
- });
252
-
253
- describe('without WeakMap support', () => {
254
- const weakMapBak = global.WeakMap;
255
-
256
- beforeEach(() => {
257
- delete (global as any).WeakMap;
258
- });
259
-
260
- afterEach(() => {
261
- (global as any).WeakMap = weakMapBak;
262
- });
263
-
264
- it('still works', () => {
265
- const fn = jest.fn((x: number, y: number, z: number = 1) => x * y * z);
266
- const fnM = memoize(fn);
267
-
268
- expect(fnM(3, 2)).toBe(6);
269
- expect(fnM(3, 2)).toBe(6);
270
- expect(fnM(3, 3)).toBe(9);
271
- expect(fnM(3, 3, 2)).toBe(18);
272
- expect(fnM(3, 3, 2)).toBe(18);
273
- expect(fnM(1, 2)).toBe(2);
274
- expect(fnM(1, 2)).toBe(2);
275
- expect(fnM(7, 2)).toBe(14);
276
-
277
- expect(fn).toHaveBeenCalledTimes(5);
278
- });
279
-
280
- it('doesn\'t memoize object arguments', () => {
281
- const fn = jest.fn((x: number, {y, z}: {y: number; z?: number}) => x * y * (z || 1));
282
- const fnM = memoize(fn);
283
-
284
- const two = {y: 2};
285
- const threeTwo = {y:3, z: 2};
286
-
287
- expect(fnM(3, two)).toBe(6);
288
- expect(fnM(3, two)).toBe(6);
289
- expect(fnM(3, {y: 3})).toBe(9);
290
- expect(fnM(3, threeTwo)).toBe(18);
291
- expect(fnM(3, threeTwo)).toBe(18);
292
- expect(fnM(1, two)).toBe(2);
293
- expect(fnM(1, two)).toBe(2);
294
- expect(fnM(7, two)).toBe(14);
295
-
296
- expect(fn).toHaveBeenCalledTimes(8);
297
- });
298
- });
299
-
300
- it('calls multiple times when the function returns a Promise that rejects (when it rejects)', async() => {
301
- const spy = jest.fn(async(_x) => { throw new Error('Bad Request'); });
302
- const memoized = memoize(spy);
303
-
304
- const promise1 = memoized(1);
305
- const promise2 = memoized(1);
306
- const promise3 = memoized(2);
307
-
308
- await expect(promise1).rejects.toThrow('Bad Request');
309
- await expect(promise2).rejects.toThrow('Bad Request');
310
- await expect(promise3).rejects.toThrow('Bad Request');
311
-
312
- expect(spy).toHaveBeenCalledTimes(2);
313
-
314
- await expect(memoized(2)).rejects.toThrow('Bad Request');
315
-
316
- expect(spy).toHaveBeenCalledTimes(3);
317
- });
318
- });
319
-
320
- describe('partitionSequence', () => {
321
- it('partitions a sequence by predicate', () => {
322
- expect(partitionSequence(
323
- (n: number) => ({value: n % 2}),
324
- [1,2,3,4,5,6,7,8]
325
- )).toEqual([
326
- [1, [1]],
327
- [0, [2]],
328
- [1, [3]],
329
- [0, [4]],
330
- [1, [5]],
331
- [0, [6]],
332
- [1, [7]],
333
- [0, [8]],
334
- ]);
335
- expect(partitionSequence(
336
- (n: number) => ({value: Math.floor(n / 3)}),
337
- [1,2,3,4,5,6,7,8]
338
- )).toEqual([
339
- [0, [1,2]],
340
- [1, [3,4, 5]],
341
- [2, [6,7,8]],
342
- ]);
343
- });
344
-
345
- it('partitions a sequence with running predicate', () => {
346
- expect(partitionSequence(
347
- (n: number, p?: {min: number; max: number}) =>
348
- p && p.max + 1 === n
349
- ? {value: {...p, max: n}, matches: true}
350
- : {value: {min: n, max: n}, matches: false}
351
- , [1,2,3,5,6,8]
352
- )).toEqual([
353
- [{min: 1, max: 3}, [1,2,3]],
354
- [{min: 5,max: 6}, [5,6]],
355
- [{min: 8,max: 8}, [8]],
356
- ]);
357
- });
358
- });
359
-
360
- describe('flow', () => {
361
- it('flows', () => {
362
- const fn = flow(
363
- (n: number) => n * 4,
364
- (n: number) => n.toString(),
365
- (s: string) => [s, s],
366
- (a: string[]) => a.join(', ')
367
- );
368
-
369
- expect(fn(2)).toBe('8, 8');
370
- });
371
- });
372
-
373
- describe('coerceArray', () => {
374
- it('coerces', () => {
375
- expect(coerceArray('value')).toEqual(['value']);
376
- });
377
-
378
- it('no-ops', () => {
379
- const array = ['foo'];
380
- expect(coerceArray(array)).toBe(array);
381
- });
382
-
383
- it('handles undefined', () => {
384
- expect(coerceArray(undefined)).toEqual([]);
385
- });
386
- });
387
-
388
- describe('retryWithDelay', () => {
389
- let setTimeoutSpy: jest.SpyInstance;
390
- let timeouts: Array<number | undefined>;
391
-
392
- const doBeforeEach = () => {
393
- timeouts = [];
394
- setTimeoutSpy = jest.spyOn(global, 'setTimeout')
395
- .mockImplementation((fn, timeout) => {
396
- timeouts.push(timeout);
397
- fn();
398
- return 1 as any;
399
- });
400
- };
401
-
402
- const doAfterEach = () => {
403
- setTimeoutSpy.mockReset();
404
- };
405
-
406
- beforeEach(doBeforeEach);
407
- afterEach(doAfterEach);
408
-
409
- it('runs once without delay', async() => {
410
- const fn = jest.fn().mockReturnValue(Promise.resolve('hello'));
411
- const result = await retryWithDelay(fn);
412
- expect(setTimeoutSpy).not.toHaveBeenCalled();
413
- expect(result).toBe('hello');
414
- });
415
-
416
- it('aborts without retrying', async() => {
417
- const fn = jest.fn().mockImplementation(async abort => {
418
- abort(new Error('cool error'));
419
- throw new Error('unreachable code');
420
- });
421
- await expect(() => retryWithDelay(fn)).rejects.toThrow('cool error');
422
- expect(setTimeoutSpy).not.toHaveBeenCalled();
423
- });
424
-
425
- it('retries within expected delay bounds', async() => {
426
- for (let i = 0; i < 100; i++) {
427
- doBeforeEach();
428
- const fn = jest.fn()
429
- .mockReturnValueOnce(Promise.reject(new Error('nope')))
430
- .mockReturnValue(Promise.resolve('hello'));
431
-
432
- const result = await retryWithDelay<string>(fn);
433
-
434
- expect(result).toBe('hello');
435
-
436
- expect(setTimeoutSpy).toHaveBeenCalledTimes(1);
437
- expect(timeouts).toHaveLength(1);
438
-
439
- expect(timeouts[0]).toBeGreaterThan(50);
440
- expect(timeouts[0]).toBeLessThan(150);
441
- doAfterEach();
442
- }
443
- });
444
-
445
- it('throws when it runs out of attempts', async() => {
446
- for (let i = 0; i < 100; i++) {
447
- doBeforeEach();
448
- const fn = jest.fn()
449
- .mockReturnValueOnce(Promise.reject(new Error('nope')))
450
- .mockReturnValueOnce(Promise.reject(new Error('nope')))
451
- .mockReturnValueOnce(Promise.reject(new Error('nope')))
452
- .mockReturnValueOnce(Promise.reject(new Error('nope')))
453
- .mockReturnValue(Promise.resolve('hello'));
454
-
455
- await expect(() => retryWithDelay<string>(fn, {retries: 3})).rejects.toThrow('nope');
456
-
457
- expect(setTimeoutSpy).toHaveBeenCalledTimes(3);
458
- expect(timeouts).toHaveLength(3);
459
-
460
- expect(timeouts[0]).toBeGreaterThan(50);
461
- expect(timeouts[0]).toBeLessThan(150);
462
-
463
- expect(timeouts[1]).toBeGreaterThan(150);
464
- expect(timeouts[1]).toBeLessThan(250);
465
-
466
- expect(timeouts[2]).toBeGreaterThan(250);
467
- expect(timeouts[2]).toBeLessThan(350);
468
- doAfterEach();
469
- }
470
- });
471
- });