@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
@@ -0,0 +1,14 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.zodPayloadValidator = void 0;
4
+ /* spell-checker: ignore treeify */
5
+ const zod_1 = require("zod");
6
+ const errors_1 = require("../../errors");
7
+ const zodPayloadValidator = (validator) => (input) => {
8
+ const result = validator.safeParse(input);
9
+ if (result.success) {
10
+ return true;
11
+ }
12
+ throw new errors_1.ValidationError((0, zod_1.treeifyError)(result.error));
13
+ };
14
+ exports.zodPayloadValidator = zodPayloadValidator;
@@ -0,0 +1,92 @@
1
+ import { ConfigProviderForConfig } from '../../config';
2
+ import { GenericFetch } from '../../fetch';
3
+ import { JsonCompatibleStruct } from '../../routing';
4
+ import { ApiUser, ConsentPreferences } from '../authProvider';
5
+ import { Logger } from '../logger';
6
+ export type Config = {
7
+ accountsBase: string;
8
+ accountsAuthToken: string;
9
+ };
10
+ interface Initializer<C> {
11
+ configSpace?: C;
12
+ fetch: GenericFetch;
13
+ }
14
+ export type FindUserPayload = ({
15
+ external_id: string;
16
+ } | {
17
+ uuid: string;
18
+ }) & {
19
+ sso?: string;
20
+ };
21
+ export type FindOrCreateUserPayload = {
22
+ external_id: string;
23
+ email?: string;
24
+ already_verified?: boolean;
25
+ first_name?: string;
26
+ last_name?: string;
27
+ full_name?: string;
28
+ salesforce_contact_id?: string;
29
+ faculty_status?: string;
30
+ role?: string;
31
+ school_type?: string;
32
+ is_test?: boolean;
33
+ sso?: string;
34
+ };
35
+ export type FindOrCreateUserResponse = {
36
+ id: number;
37
+ uuid: string;
38
+ external_ids: string[];
39
+ is_test: boolean;
40
+ sso: string;
41
+ };
42
+ export type FindUserResponse = (FindOrCreateUserResponse & {
43
+ external_ids: string[];
44
+ }) | undefined;
45
+ export type LinkUserPayload = {
46
+ userId: number;
47
+ externalId: string;
48
+ };
49
+ export type LinkUserResponse = {
50
+ user_id: number;
51
+ external_id: string;
52
+ };
53
+ export type SearchUsersPayload = {
54
+ q: string;
55
+ order_by?: string;
56
+ };
57
+ export type SearchUsersResponse = {
58
+ items: Array<ApiUser & {
59
+ external_ids: string[];
60
+ } & JsonCompatibleStruct>;
61
+ total_count: number;
62
+ };
63
+ export type UpdateUserPayload = ConsentPreferences;
64
+ export type MappedUserInfo<T> = {
65
+ data: T;
66
+ fullName: string;
67
+ platformUserId?: string;
68
+ uuid: string;
69
+ };
70
+ export declare const accountsGateway: <C extends string = "accounts">(initializer: Initializer<C>) => (configProvider: { [_key in C]: ConfigProviderForConfig<Config>; }) => ({ logger }: {
71
+ logger: Logger;
72
+ }) => {
73
+ findOrCreateUser: (body: FindOrCreateUserPayload) => Promise<FindOrCreateUserResponse>;
74
+ findUser: (body: FindUserPayload) => Promise<FindUserResponse>;
75
+ getUser: (token: string) => Promise<ApiUser & JsonCompatibleStruct>;
76
+ linkUser: (body: LinkUserPayload) => Promise<LinkUserResponse>;
77
+ mapUserUuids: <T>(userUuidsMap: {
78
+ [uuid: string]: T;
79
+ }, platformId?: string) => Promise<{
80
+ data: T;
81
+ fullName: string;
82
+ platformUserId: string | undefined;
83
+ uuid: string;
84
+ }[]>;
85
+ searchUsers: (payload: SearchUsersPayload) => Promise<SearchUsersResponse>;
86
+ updateUser: (token: string, body: UpdateUserPayload) => Promise<ApiUser & JsonCompatibleStruct>;
87
+ getUserMap: <R>(userUuids: Set<string>, mapper: ((user: ApiUser) => R)) => Promise<Map<string, R>>;
88
+ mapUserData: <T, R>(input: T[], getUserUuid: (item: T) => string, mapper: ((user: ApiUser | undefined, item: T) => R)) => Promise<R[]>;
89
+ mapUsersData: <T, R_1>(input: T[], getUserUuids: (item: T) => string[], mapper: ((users: Map<string, ApiUser | undefined>, item: T) => R_1)) => Promise<R_1[]>;
90
+ };
91
+ export type AccountsGateway = ReturnType<ReturnType<ReturnType<typeof accountsGateway>>>;
92
+ export {};
@@ -0,0 +1,138 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.accountsGateway = void 0;
7
+ const lodash_1 = require("lodash");
8
+ const query_string_1 = __importDefault(require("query-string"));
9
+ const config_1 = require("../../config");
10
+ const guards_1 = require("../../guards");
11
+ const helpers_1 = require("../../misc/helpers");
12
+ const routing_1 = require("../../routing");
13
+ const logger_1 = require("../logger");
14
+ class ApiError extends Error {
15
+ constructor(message, status) {
16
+ super(message);
17
+ this.status = status;
18
+ }
19
+ }
20
+ const accountsGateway = (initializer) => (configProvider) => {
21
+ const config = configProvider[(0, guards_1.ifDefined)(initializer.configSpace, 'accounts')];
22
+ const accountsBase = (0, helpers_1.once)(() => (0, config_1.resolveConfigValue)(config.accountsBase));
23
+ const accountsAuthToken = (0, helpers_1.once)(() => (0, config_1.resolveConfigValue)(config.accountsAuthToken));
24
+ return ({ logger }) => {
25
+ const request = async (method, path, options, statuses = [200, 201]) => {
26
+ const host = (await accountsBase()).replace(/\/+$/, '');
27
+ const url = `${host}/api/${path}`;
28
+ const config = {
29
+ headers: {
30
+ Authorization: `Bearer ${options.token || await accountsAuthToken()}`,
31
+ },
32
+ method,
33
+ };
34
+ if (options.body) {
35
+ config.body = JSON.stringify(options.body);
36
+ }
37
+ const response = await initializer.fetch(url, config);
38
+ if (!statuses.includes(response.status)) {
39
+ throw new ApiError(`Received unexpected status code ${response.status} for Accounts API call: ${method} ${url}`, response.status);
40
+ }
41
+ return response.json();
42
+ };
43
+ const findOrCreateUser = async (body) => request(routing_1.METHOD.POST, 'user/find-or-create', { body });
44
+ const findUser = async (body) => {
45
+ try {
46
+ return await request(routing_1.METHOD.POST, 'user/find', { body });
47
+ }
48
+ catch (error) {
49
+ if (error instanceof ApiError && error.status === 404) {
50
+ return undefined;
51
+ }
52
+ else {
53
+ throw error;
54
+ }
55
+ }
56
+ };
57
+ const getUser = async (token) => request(routing_1.METHOD.GET, 'user', { token });
58
+ const linkUser = async (body) => request(routing_1.METHOD.POST, 'user/external-ids', {
59
+ body: {
60
+ external_id: body.externalId,
61
+ user_id: body.userId,
62
+ }
63
+ });
64
+ const searchUsers = async (payload) => request(routing_1.METHOD.GET, `users?${query_string_1.default.stringify(payload)}`, {});
65
+ const updateUser = async (token, body) => request(routing_1.METHOD.PUT, 'user', { body, token });
66
+ const getPlatformUserId = (externalIds, platformId) => {
67
+ for (const externalId of externalIds) {
68
+ const [userPlatformId, userId] = externalId.split('/', 2);
69
+ if (userPlatformId === platformId) {
70
+ return userId;
71
+ }
72
+ }
73
+ };
74
+ /*
75
+ * If a platformId is given, returns an array where
76
+ * the first element is the user id from the platform
77
+ * and the second is the value from the map
78
+ * Otherwise, returns an array where
79
+ * the first element is the user's full_name
80
+ * and the second is the value from the map
81
+ */
82
+ const mapUserUuids = async (userUuidsMap, platformId) => {
83
+ const results = await mapUserData(Object.entries(userUuidsMap), ([id]) => id, (user, [, data]) => {
84
+ if (!user)
85
+ return undefined;
86
+ const platformUserId = platformId ? getPlatformUserId(user.external_ids, platformId) : undefined;
87
+ if (platformId && !platformUserId) {
88
+ logger.logEvent(logger_1.Level.Warn, {
89
+ message: 'Accounts user has no external_id matching the given platformId',
90
+ accountsUuid: user.uuid,
91
+ platformId,
92
+ });
93
+ }
94
+ if (!user.full_name) {
95
+ logger.logEvent(logger_1.Level.Warn, {
96
+ message: 'Accounts user has no full_name',
97
+ accountsUuid: user.uuid,
98
+ });
99
+ }
100
+ return { data, fullName: user.full_name, platformUserId, uuid: user.uuid };
101
+ });
102
+ return results.filter(guards_1.isDefined);
103
+ };
104
+ const getUserMap = async (userUuids, mapper) => {
105
+ if (userUuids.size === 0)
106
+ return new Map();
107
+ const chunked = (0, lodash_1.chunk)([...userUuids], 10);
108
+ const results = await Promise.all(chunked.map(async (inputChunk) => {
109
+ const { items } = await searchUsers({ q: inputChunk.map(userUuid => `uuid:${userUuid}`).join(' ')
110
+ });
111
+ const accountsUuids = items.map((user) => user.uuid);
112
+ if (!(0, lodash_1.isEqual)(accountsUuids.sort(), inputChunk.sort())) {
113
+ logger.logEvent(logger_1.Level.Warn, {
114
+ message: 'Unexpected Accounts user search results',
115
+ uuids: inputChunk,
116
+ accountsUuids,
117
+ });
118
+ }
119
+ return items;
120
+ }));
121
+ return new Map(results.flat(1).map(user => [user.uuid, mapper(user)]));
122
+ };
123
+ const mapUserData = async (input, getUserUuid, mapper) => {
124
+ const userMap = await getUserMap(new Set(input.flatMap(getUserUuid)), user => user);
125
+ return input.map(item => mapper(userMap.get(getUserUuid(item)), item));
126
+ };
127
+ const mapUsersData = async (input, getUserUuids, mapper) => {
128
+ const userMap = await getUserMap(new Set(input.flatMap(getUserUuids)), user => user);
129
+ return input.map(item => {
130
+ const userUuids = getUserUuids(item);
131
+ const itemUserMap = new Map(userUuids.map(uuid => [uuid, userMap.get(uuid)]));
132
+ return mapper(itemUserMap, item);
133
+ });
134
+ };
135
+ return { findOrCreateUser, findUser, getUser, linkUser, mapUserUuids, searchUsers, updateUser, getUserMap, mapUserData, mapUsersData };
136
+ };
137
+ };
138
+ exports.accountsGateway = accountsGateway;
@@ -0,0 +1,68 @@
1
+ import { Headers } from 'node-fetch';
2
+ import { ConfigProviderForConfig } from '../../config';
3
+ import { ConfigForFetch, GenericFetch, Response } from '../../fetch';
4
+ import { AnyRoute, ApiResponse, OutputForRoute, ParamsForRoute, PayloadForRoute, QueryParams } from '../../routing';
5
+ import { UnwrapPromise } from '../../types';
6
+ import { Logger } from '../logger';
7
+ export type TResponsePayload<R> = R extends ApiResponse<any, infer P> ? P : never;
8
+ export type TResponseStatus<R> = R extends ApiResponse<infer S, any> ? S : never;
9
+ export type RouteClient<R> = {
10
+ (config: {
11
+ fetchConfig?: any;
12
+ query?: QueryParams;
13
+ } & (ParamsForRoute<R> extends undefined ? {} : {
14
+ params: ParamsForRoute<R>;
15
+ }) & (PayloadForRoute<R> extends undefined ? {} : {
16
+ payload: PayloadForRoute<R>;
17
+ })): Promise<UnsafeApiClientResponse<UnwrapPromise<OutputForRoute<R>>>>;
18
+ renderUrl: (config: {
19
+ query?: QueryParams;
20
+ } & (ParamsForRoute<R> extends undefined ? {} : {
21
+ params: ParamsForRoute<R>;
22
+ })) => Promise<string>;
23
+ };
24
+ export interface AcceptStatus<Ro> {
25
+ <S extends TResponseStatus<Ro>[]>(...args: S): Promise<ApiClientResponse<Extract<Ro, Record<'statusCode', S[number]>>>>;
26
+ <S extends number[]>(...args: S): Promise<ApiClientResponse<any>>;
27
+ }
28
+ export type UnsafeApiClientResponse<Ro> = {
29
+ headers: Headers;
30
+ load: () => Promise<any>;
31
+ status: number;
32
+ acceptStatus: AcceptStatus<Ro>;
33
+ };
34
+ export type ApiClientResponse<Ro> = Ro extends any ? {
35
+ headers: Headers;
36
+ status: TResponseStatus<Ro>;
37
+ load: () => Promise<TResponsePayload<Ro>>;
38
+ } : never;
39
+ export type ExpandRoute<T> = T extends ((...args: infer A) => infer R) & {
40
+ renderUrl: (...args: infer Ar) => Promise<string>;
41
+ } ? ((...args: A) => R) & {
42
+ renderUrl: (...args: Ar) => Promise<string>;
43
+ } : never;
44
+ export type MapRoutesToClient<Ru> = [Ru] extends [AnyRoute<Ru>] ? {
45
+ [N in Ru['name']]: ExpandRoute<RouteClient<Extract<Ru, Record<'name', N>>>>;
46
+ } : never;
47
+ export type MapRoutesToConfig<Ru> = [Ru] extends [AnyRoute<Ru>] ? {
48
+ [_N in Ru['name']]: {
49
+ path: string;
50
+ method: string;
51
+ };
52
+ } : never;
53
+ /** Pulls the content out of a response based on the content type */
54
+ export declare const loadResponse: (response: Response) => () => Promise<any>;
55
+ export interface MakeApiGateway<F> {
56
+ <Ru>(config: ConfigProviderForConfig<{
57
+ apiBase: string;
58
+ }>, routes: MapRoutesToConfig<Ru>, app?: {
59
+ authProvider?: {
60
+ getAuthorizedFetchConfig: () => Promise<ConfigForFetch<F>>;
61
+ };
62
+ logger?: Logger;
63
+ launchToken?: string;
64
+ }): MapRoutesToClient<Ru>;
65
+ }
66
+ export declare const createApiGateway: <F extends GenericFetch>(initializer: {
67
+ fetch: F;
68
+ }) => MakeApiGateway<F>;
@@ -0,0 +1,118 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ var __importDefault = (this && this.__importDefault) || function (mod) {
36
+ return (mod && mod.__esModule) ? mod : { "default": mod };
37
+ };
38
+ Object.defineProperty(exports, "__esModule", { value: true });
39
+ exports.createApiGateway = exports.loadResponse = void 0;
40
+ const pathToRegexp = __importStar(require("path-to-regexp"));
41
+ const query_string_1 = __importDefault(require("query-string"));
42
+ const uuid_1 = require("uuid");
43
+ const __1 = require("../..");
44
+ const config_1 = require("../../config");
45
+ const errors_1 = require("../../errors");
46
+ const fetchStatusRetry_1 = require("../../fetch/fetchStatusRetry");
47
+ const logger_1 = require("../logger");
48
+ /** Pulls the content out of a response based on the content type */
49
+ const loadResponse = (response) => () => {
50
+ const [contentType] = (response.headers.get('content-type') || '').split(';');
51
+ switch (contentType) {
52
+ case 'text/plain':
53
+ return response.text();
54
+ case 'application/json':
55
+ return response.json();
56
+ default:
57
+ throw new Error(`unknown content type ${contentType}`);
58
+ }
59
+ };
60
+ exports.loadResponse = loadResponse;
61
+ const makeRouteClient = (initializer, config, route, app) => {
62
+ /* TODO this duplicates code with makeRenderRouteUrl, reuse that */
63
+ const renderUrl = async ({ params, query }) => {
64
+ const apiBase = await (0, config_1.resolveConfigValue)(config.apiBase);
65
+ const getPathForParams = pathToRegexp.compile(route.path, { encode: encodeURIComponent });
66
+ const search = query && query_string_1.default.stringify(query);
67
+ return apiBase.replace(/\/+$/, '') + getPathForParams(params || {}) + (search ? `?${search}` : '');
68
+ };
69
+ const routeClient = async ({ params, payload, query, fetchConfig }) => {
70
+ var _a, _b;
71
+ const { fetch } = initializer;
72
+ const url = await renderUrl({ params, query });
73
+ const body = payload ? JSON.stringify(payload) : undefined;
74
+ const baseOptions = (0, __1.merge)((await ((_a = app === null || app === void 0 ? void 0 : app.authProvider) === null || _a === void 0 ? void 0 : _a.getAuthorizedFetchConfig())) || {}, fetchConfig || {});
75
+ const requestId = (0, uuid_1.v4)();
76
+ const requestLogger = (_b = app === null || app === void 0 ? void 0 : app.logger) === null || _b === void 0 ? void 0 : _b.createSubContext();
77
+ requestLogger === null || requestLogger === void 0 ? void 0 : requestLogger.setContext({ requestId, url, timeStamp: new Date().getTime() });
78
+ const fetcher = (0, fetchStatusRetry_1.fetchStatusRetry)(fetch, { retries: 1, status: [502], logger: requestLogger });
79
+ requestLogger === null || requestLogger === void 0 ? void 0 : requestLogger.log('Request Initiated', logger_1.Level.Info);
80
+ return fetcher(url, (0, __1.merge)(baseOptions, {
81
+ method: route.method,
82
+ body,
83
+ headers: {
84
+ ...fetchConfig === null || fetchConfig === void 0 ? void 0 : fetchConfig.headers,
85
+ ...(body ? { 'content-type': 'application/json' } : {}),
86
+ 'x-request-id': requestId,
87
+ ...((app === null || app === void 0 ? void 0 : app.launchToken) ? {
88
+ 'x-launch-token': app.launchToken,
89
+ } : {}),
90
+ }
91
+ })).then(response => {
92
+ if (response.status === 401) {
93
+ throw new errors_1.UnauthorizedError();
94
+ }
95
+ if (response.status === 440) {
96
+ throw new errors_1.SessionExpiredError();
97
+ }
98
+ return {
99
+ status: response.status,
100
+ acceptStatus: async (...status) => {
101
+ if (!status.includes(response.status)) {
102
+ throw new Error(`unexpected HTTP ${response.status} response from api: ${await response.text()}`);
103
+ }
104
+ return { status: response.status, headers: response.headers, load: (0, exports.loadResponse)(response) };
105
+ },
106
+ headers: response.headers,
107
+ load: (0, exports.loadResponse)(response),
108
+ };
109
+ });
110
+ };
111
+ routeClient.renderUrl = renderUrl;
112
+ return routeClient;
113
+ };
114
+ const createApiGateway = (initializer) => (config, routes, app) => {
115
+ return Object.fromEntries(Object.entries(routes)
116
+ .map(([key, routeConfig]) => ([key, makeRouteClient(initializer, config, routeConfig, app)])));
117
+ };
118
+ exports.createApiGateway = createApiGateway;
@@ -0,0 +1,40 @@
1
+ import { ConfigProviderForConfig } from '../../config';
2
+ import { GenericFetch } from '../../fetch';
3
+ import { UserData } from './utils/embeddedAuthProvider';
4
+ import { ApiUser, AuthProvider } from '.';
5
+ type Config = {
6
+ accountsBase: string;
7
+ };
8
+ interface Initializer<C> {
9
+ configSpace?: C;
10
+ window: Window;
11
+ }
12
+ export type EventHandler = (e: {
13
+ data: any;
14
+ origin: string;
15
+ source: Pick<Window, 'postMessage'>;
16
+ }) => void;
17
+ export interface Window {
18
+ fetch: GenericFetch;
19
+ parent: Pick<Window, 'postMessage'>;
20
+ location: {
21
+ search: string;
22
+ };
23
+ document: {
24
+ referrer: string;
25
+ };
26
+ postMessage: (data: any, origin: string) => void;
27
+ addEventListener: (event: 'message', callback: EventHandler) => void;
28
+ removeEventListener: (event: 'message', callback: EventHandler) => void;
29
+ }
30
+ export type UpdatableUserFields = Partial<Pick<ApiUser, 'consent_preferences' | 'first_name' | 'last_name'>>;
31
+ export type BrowserAuthProvider = AuthProvider & {
32
+ getAuthorizedUrl: (urlString: string) => string;
33
+ getAuthorizedLinkUrl: (urlString: string) => string;
34
+ getAuthorizedEmbedUrl: (urlString: string, extraParams?: {
35
+ [key: string]: string;
36
+ }) => string;
37
+ updateUser: (updates: UpdatableUserFields) => Promise<UserData<ApiUser>>;
38
+ };
39
+ export declare const browserAuthProvider: <C extends string = "auth">({ window, configSpace }: Initializer<C>) => (configProvider: { [_key in C]: ConfigProviderForConfig<Config>; }) => BrowserAuthProvider;
40
+ export {};
@@ -0,0 +1,155 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.browserAuthProvider = void 0;
4
+ const __1 = require("../..");
5
+ const config_1 = require("../../config");
6
+ const guards_1 = require("../../guards");
7
+ const routing_1 = require("../../routing");
8
+ const embeddedAuthProvider_1 = require("./utils/embeddedAuthProvider");
9
+ const isUserData = (0, routing_1.unsafePayloadValidator)();
10
+ const browserAuthProvider = ({ window, configSpace }) => (configProvider) => {
11
+ const config = configProvider[(0, guards_1.ifDefined)(configSpace, 'auth')];
12
+ const accountsBase = (0, __1.once)(() => (0, config_1.resolveConfigValue)(config.accountsBase));
13
+ const queryString = window.location.search;
14
+ const queryKey = 'auth';
15
+ const urlSearchParams = new URLSearchParams(queryString);
16
+ const authQuery = urlSearchParams.get(queryKey);
17
+ const referrer = window.document.referrer ? new URL(window.document.referrer) : undefined;
18
+ const isEmbedded = window.parent !== window;
19
+ const trustedParent = isEmbedded && referrer && referrer.hostname.match(/^(openstax\.org|((.*)(\.openstax\.org|local|localhost)))$/) ? referrer : undefined;
20
+ const { embeddedQueryKey, embeddedQueryValue, getAuthorizedEmbedUrl } = (0, embeddedAuthProvider_1.embeddedAuthProvider)(() => getUserData(), { authQuery: { key: queryKey, value: authQuery }, window });
21
+ const embeddedQuery = urlSearchParams.get(embeddedQueryKey);
22
+ let userData = { token: authQuery };
23
+ const getAuthToken = async () => {
24
+ return (await getUserData()).token;
25
+ };
26
+ const getAuthorizedLinkUrl = (urlString) => {
27
+ const url = new URL(urlString);
28
+ if (userData.token) {
29
+ url.searchParams.set(queryKey, userData.token);
30
+ }
31
+ return url.href;
32
+ };
33
+ const getAuthorizedUrl = (urlString) => {
34
+ const url = new URL(urlString);
35
+ if (authQuery) {
36
+ url.searchParams.set(queryKey, authQuery);
37
+ }
38
+ else if (embeddedQuery) {
39
+ url.searchParams.set(queryKey, 'embedded');
40
+ }
41
+ if (embeddedQuery) {
42
+ url.searchParams.set(embeddedQueryKey, embeddedQuery);
43
+ }
44
+ return url.href;
45
+ };
46
+ // *note* that this does not actually prevent cookies from being sent on same-origin
47
+ // requests, i'm not sure if its possible to stop browsers from sending cookies in
48
+ // that case
49
+ const getAuthorizedFetchConfigFromData = (data) => {
50
+ const { token } = data;
51
+ return token ? {
52
+ headers: { Authorization: `Bearer ${token}` },
53
+ } : {
54
+ credentials: 'include',
55
+ };
56
+ };
57
+ const getAuthorizedFetchConfig = async () => {
58
+ return getAuthorizedFetchConfigFromData(userData.token ? userData : await getUserData());
59
+ };
60
+ /*
61
+ * requests user identity from parent window via postMessage
62
+ */
63
+ const getParentWindowUser = () => new Promise((resolve, reject) => {
64
+ if (!window.parent || !trustedParent) {
65
+ return reject(new Error('parent window is undefined or not trusted'));
66
+ }
67
+ const handler = (event) => {
68
+ if (event.data.type === embeddedAuthProvider_1.PostMessageTypes.ReceiveUser && event.origin === trustedParent.origin) {
69
+ clearTimeout(timeout);
70
+ window.removeEventListener('message', handler);
71
+ resolve(event.data.userData);
72
+ }
73
+ };
74
+ window.addEventListener('message', handler);
75
+ window.parent.postMessage({ type: embeddedAuthProvider_1.PostMessageTypes.RequestUser }, trustedParent.origin);
76
+ const timeout = setTimeout(() => {
77
+ window.removeEventListener('message', handler);
78
+ reject(new Error('loading user identity timed out'));
79
+ }, 5000);
80
+ });
81
+ /*
82
+ * requests user identity from accounts api using given token or cookie
83
+ */
84
+ const getFetchUser = async () => {
85
+ const response = await window.fetch((await accountsBase()).replace(/\/+$/, '') + '/api/user?always_200=true', getAuthorizedFetchConfigFromData(userData));
86
+ if (response.status === 200) {
87
+ const body = await response.json();
88
+ const user = isUserData(body) ? body : undefined;
89
+ return { ...userData, user };
90
+ }
91
+ const message = await response.text();
92
+ throw new Error(`Error response from Accounts ${response.status}: ${message}`);
93
+ };
94
+ const getUserData = (0, __1.once)(async () => {
95
+ // For backwards compatibility
96
+ if (authQuery === 'embedded') {
97
+ return getParentWindowUser();
98
+ }
99
+ // getFetchUser() will throw here if authQuery is not set
100
+ return await (embeddedQuery === embeddedQueryValue ? getParentWindowUser() : getFetchUser());
101
+ });
102
+ const getUser = async () => {
103
+ return (await getUserData()).user;
104
+ };
105
+ const updateUser = async (updates) => {
106
+ const response = await window.fetch((await accountsBase()).replace(/\/+$/, '') + '/api/user', { ...getAuthorizedFetchConfigFromData(userData), method: routing_1.METHOD.PUT, body: JSON.stringify(updates) });
107
+ if (response.status === 200) {
108
+ const user = await response.json();
109
+ if (isUserData(user)) {
110
+ return { ...userData, user };
111
+ }
112
+ }
113
+ const message = await response.text();
114
+ throw new Error(`Error response from Accounts ${response.status}: ${message}`);
115
+ };
116
+ return {
117
+ /**
118
+ * gets the authentication token
119
+ */
120
+ getAuthToken,
121
+ /**
122
+ * adds auth parameters to the url. this is only safe to use when using javascript to navigate
123
+ * within the current window, eg `window.location = 'https://my.otherservice.com';` anchors
124
+ * should use getAuthorizedLinkUrl for their href.
125
+ *
126
+ * result unreliable unless `getUser` is resolved first.
127
+ */
128
+ getAuthorizedUrl,
129
+ /**
130
+ * all link href-s must be rendered with auth tokens so that they work when opened in a new tab
131
+ *
132
+ * result unreliable unless `getUser` is resolved first.
133
+ */
134
+ getAuthorizedLinkUrl,
135
+ /**
136
+ * gets an authorized url for an iframe src. sets params on the url and saves its
137
+ * origin to trust releasing user identity to it
138
+ */
139
+ getAuthorizedEmbedUrl,
140
+ /**
141
+ * gets second argument for `fetch` that has authentication token or cookie
142
+ */
143
+ getAuthorizedFetchConfig,
144
+ /**
145
+ * loads current user identity. does not reflect changes in identity after being called the first time.
146
+ */
147
+ getUser,
148
+ loadUserData: getUser,
149
+ /**
150
+ * updates user settings, for example the cookie consent preferences
151
+ */
152
+ updateUser,
153
+ };
154
+ };
155
+ exports.browserAuthProvider = browserAuthProvider;
@@ -0,0 +1,19 @@
1
+ import type { ConfigProviderForConfig } from '../../config';
2
+ import { GenericFetch } from '../../fetch';
3
+ import { ApiUser, AuthProvider, CookieAuthProvider } from '.';
4
+ type Config = {
5
+ accountsBase: string;
6
+ cookieName: string;
7
+ encryptionPrivateKey: string;
8
+ signaturePublicKey: string;
9
+ };
10
+ interface Initializer<C> {
11
+ configSpace?: C;
12
+ fetch: GenericFetch;
13
+ }
14
+ export type DecryptionAuthProvider = AuthProvider & {
15
+ getTokenExpiration: (tokenString?: string) => Promise<number | null | undefined>;
16
+ loadUserData: () => Promise<ApiUser | undefined>;
17
+ };
18
+ export declare const decryptionAuthProvider: <C extends string = "decryption">(initializer: Initializer<C>) => (configProvider: { [_key in C]: ConfigProviderForConfig<Config>; }) => CookieAuthProvider<DecryptionAuthProvider>;
19
+ export {};