@openstax/ts-utils 1.33.1 → 1.34.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (504) hide show
  1. package/.cfnlintrc +2 -0
  2. package/.github/CODEOWNERS +1 -0
  3. package/.github/workflows/ci.yml +36 -0
  4. package/.github/workflows/lint.yml +55 -0
  5. package/.nvmrc +1 -0
  6. package/.syncignore +4 -0
  7. package/.syncpackrc +18 -0
  8. package/CONTRIBUTING.md +96 -0
  9. package/LICENSE +661 -0
  10. package/Procfile +1 -0
  11. package/README.md +62 -90
  12. package/app.json +23 -0
  13. package/cspell.json +32 -0
  14. package/deploy/constants.env +21 -0
  15. package/deploy/deploy.bash +157 -0
  16. package/deploy/deployment-alt-region.cfn.yml +70 -0
  17. package/deploy/deployment.cfn.yml +650 -0
  18. package/deploy/destroy-deployment.bash +23 -0
  19. package/deploy/shared.cfn.yml +94 -0
  20. package/docs/lambda-build.md +35 -0
  21. package/package.json +12 -228
  22. package/packages/frontend/README.md +46 -0
  23. package/packages/frontend/package.json +101 -0
  24. package/packages/frontend/public/favicon.ico +0 -0
  25. package/packages/frontend/public/index.html +107 -0
  26. package/packages/frontend/public/maintenance.html +59 -0
  27. package/packages/frontend/public/manifest.json +15 -0
  28. package/packages/frontend/public/robots.txt +3 -0
  29. package/packages/frontend/script/make-certificate.bash +49 -0
  30. package/packages/frontend/script/server/cli.js +11 -0
  31. package/packages/frontend/script/server/index.js +47 -0
  32. package/packages/frontend/script/start.bash +22 -0
  33. package/packages/frontend/script/trust-localhost.bash +7 -0
  34. package/packages/frontend/src/auth/authProvider.ts +10 -0
  35. package/packages/frontend/src/auth/useAuth.ts +33 -0
  36. package/packages/frontend/src/components/Pagination.tsx +26 -0
  37. package/packages/frontend/src/configProvider/index.ts +53 -0
  38. package/packages/frontend/src/configProvider/use.ts +41 -0
  39. package/packages/frontend/src/core/context/services.spec.tsx +39 -0
  40. package/packages/frontend/src/core/context/services.tsx +16 -0
  41. package/packages/frontend/src/core/index.spec.ts +7 -0
  42. package/packages/frontend/src/core/index.ts +20 -0
  43. package/packages/frontend/src/core/services.tsx +14 -0
  44. package/packages/frontend/src/core/types.ts +3 -0
  45. package/packages/frontend/src/example/api.ts +28 -0
  46. package/packages/frontend/src/example/components/Layout.tsx +23 -0
  47. package/packages/frontend/src/example/screens/Home.spec.tsx +68 -0
  48. package/packages/frontend/src/example/screens/Home.tsx +78 -0
  49. package/packages/frontend/src/example/screens/ThingList.spec.tsx +60 -0
  50. package/packages/frontend/src/example/screens/ThingList.tsx +75 -0
  51. package/packages/frontend/src/example/screens/ThingView.spec.tsx +71 -0
  52. package/packages/frontend/src/example/screens/ThingView.tsx +47 -0
  53. package/packages/frontend/src/example/screens/index.ts +9 -0
  54. package/packages/frontend/src/index.css +159 -0
  55. package/packages/frontend/src/index.tsx +67 -0
  56. package/packages/frontend/src/react-app-env.d.ts +1 -0
  57. package/packages/frontend/src/routing/components/RouteLink.spec.tsx +55 -0
  58. package/packages/frontend/src/routing/components/RouteLink.tsx +35 -0
  59. package/packages/frontend/src/routing/middleware.ts +6 -0
  60. package/packages/frontend/src/routing/useQuery.ts +14 -0
  61. package/packages/frontend/src/setupProxy.js +19 -0
  62. package/packages/frontend/src/setupTests.ts +9 -0
  63. package/packages/frontend/src/tests/testServices.tsx +23 -0
  64. package/packages/frontend/tsconfig.json +27 -0
  65. package/packages/lambda/.eslintrc.js +64 -0
  66. package/packages/lambda/jest-global-setup.js +3 -0
  67. package/packages/lambda/jest-setup-after-env.js +1 -0
  68. package/packages/lambda/jest.config.js +31 -0
  69. package/packages/lambda/jest.resolver.js +17 -0
  70. package/packages/lambda/package.json +68 -0
  71. package/packages/lambda/script/build.bash +19 -0
  72. package/packages/lambda/script/bundle-functions.bash +10 -0
  73. package/packages/lambda/script/lambdaLocalProxy.js +16 -0
  74. package/packages/lambda/script/lambdaLocalProxy.spec.ts +147 -0
  75. package/packages/lambda/script/utils/getRouteData.ts +7 -0
  76. package/packages/lambda/script/utils/routeDataLoader.js +8 -0
  77. package/packages/lambda/script/utils/routeDataLoader.spec.ts +8 -0
  78. package/packages/lambda/src/functions/serviceApi/core/index.ts +7 -0
  79. package/packages/lambda/src/functions/serviceApi/core/request.spec.ts +38 -0
  80. package/packages/lambda/src/functions/serviceApi/core/request.ts +42 -0
  81. package/packages/lambda/src/functions/serviceApi/core/routes.spec.ts +7 -0
  82. package/packages/lambda/src/functions/serviceApi/core/routes.ts +10 -0
  83. package/packages/lambda/src/functions/serviceApi/core/services.ts +9 -0
  84. package/packages/lambda/src/functions/serviceApi/core/types.ts +13 -0
  85. package/packages/lambda/src/functions/serviceApi/entry/lambda/https-xray.ts +4 -0
  86. package/packages/lambda/src/functions/serviceApi/entry/lambda/index.spec.ts +48 -0
  87. package/packages/lambda/src/functions/serviceApi/entry/lambda/index.ts +58 -0
  88. package/packages/lambda/src/functions/serviceApi/entry/lambda/services.ts +36 -0
  89. package/packages/lambda/src/functions/serviceApi/entry/local.ts +71 -0
  90. package/packages/lambda/src/functions/serviceApi/versions/v0/example/documentSearchMiddleware.spec.ts +16 -0
  91. package/packages/lambda/src/functions/serviceApi/versions/v0/example/documentSearchMiddleware.ts +41 -0
  92. package/packages/lambda/src/functions/serviceApi/versions/v0/example/documentStoreMiddleware.spec.ts +78 -0
  93. package/packages/lambda/src/functions/serviceApi/versions/v0/example/documentStoreMiddleware.ts +70 -0
  94. package/packages/lambda/src/functions/serviceApi/versions/v0/example/routes.spec.ts +306 -0
  95. package/packages/lambda/src/functions/serviceApi/versions/v0/example/routes.ts +176 -0
  96. package/packages/lambda/src/functions/serviceApi/versions/v0/index.spec.ts +263 -0
  97. package/packages/lambda/src/functions/serviceApi/versions/v0/index.ts +134 -0
  98. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/authMiddleware.spec.ts +23 -0
  99. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/authMiddleware.ts +32 -0
  100. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/configMiddleware.spec.ts +10 -0
  101. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/configMiddleware.ts +7 -0
  102. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/frontendFileServerMiddleware.spec.ts +13 -0
  103. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/frontendFileServerMiddleware.ts +23 -0
  104. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/paginationMiddleware.spec.ts +9 -0
  105. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/paginationMiddleware.ts +9 -0
  106. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/searchMiddleware.spec.ts +12 -0
  107. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/searchMiddleware.ts +21 -0
  108. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/userRoleValidatorMiddleware.spec.ts +21 -0
  109. package/packages/lambda/src/functions/serviceApi/versions/v0/middleware/userRoleValidatorMiddleware.ts +18 -0
  110. package/packages/lambda/tsconfig.json +30 -0
  111. package/packages/lambda/webpack.config.js +97 -0
  112. package/packages/utils/.eslintrc.js +64 -0
  113. package/packages/utils/README.md +118 -0
  114. package/packages/utils/jest-global-setup.js +3 -0
  115. package/packages/utils/jest.config.js +25 -0
  116. package/packages/utils/jest.resolver.js +17 -0
  117. package/packages/utils/package.json +238 -0
  118. package/packages/utils/src/assertions/index.spec.ts +126 -0
  119. package/{dist/esm/assertions/index.js → packages/utils/src/assertions/index.ts} +64 -49
  120. package/packages/utils/src/aws/ssmService.ts +7 -0
  121. package/packages/utils/src/config/awsParameterConfig.ts +24 -0
  122. package/packages/utils/src/config/envConfig.ts +58 -0
  123. package/packages/utils/src/config/index.spec.ts +165 -0
  124. package/{dist/esm/config/index.d.ts → packages/utils/src/config/index.ts} +29 -13
  125. package/packages/utils/src/config/lambdaParameterConfig.ts +49 -0
  126. package/{dist/esm/config/replaceConfig.js → packages/utils/src/config/replaceConfig.ts} +16 -6
  127. package/packages/utils/src/config/resolveConfigValue.ts +10 -0
  128. package/packages/utils/src/errors/index.spec.ts +35 -0
  129. package/{dist/esm/errors/index.js → packages/utils/src/errors/index.ts} +57 -41
  130. package/packages/utils/src/fetch/fetchStatusRetry.spec.ts +197 -0
  131. package/packages/utils/src/fetch/fetchStatusRetry.ts +33 -0
  132. package/packages/utils/src/fetch/index.spec.ts +34 -0
  133. package/packages/utils/src/fetch/index.ts +87 -0
  134. package/packages/utils/src/guards/index.spec.ts +58 -0
  135. package/{dist/esm/guards/index.d.ts → packages/utils/src/guards/index.ts} +10 -7
  136. package/packages/utils/src/index.spec.ts +471 -0
  137. package/packages/utils/src/middleware/apiErrorHandler.spec.ts +65 -0
  138. package/packages/utils/src/middleware/apiErrorHandler.ts +67 -0
  139. package/packages/utils/src/middleware/apiSlowResponseMiddleware.spec.ts +184 -0
  140. package/packages/utils/src/middleware/apiSlowResponseMiddleware.ts +71 -0
  141. package/packages/utils/src/middleware/index.spec.ts +99 -0
  142. package/{dist/cjs/middleware/index.d.ts → packages/utils/src/middleware/index.ts} +53 -5
  143. package/packages/utils/src/middleware/lambdaCorsResponseMiddleware.spec.ts +103 -0
  144. package/packages/utils/src/middleware/lambdaCorsResponseMiddleware.ts +52 -0
  145. package/packages/utils/src/middleware/throwNotFoundMiddleware.spec.ts +20 -0
  146. package/packages/utils/src/middleware/throwNotFoundMiddleware.ts +11 -0
  147. package/packages/utils/src/misc/hashValue.ts +18 -0
  148. package/packages/utils/src/misc/helpers.ts +259 -0
  149. package/packages/utils/src/misc/merge.ts +48 -0
  150. package/{dist/esm/misc/partitionSequence.js → packages/utils/src/misc/partitionSequence.ts} +23 -15
  151. package/packages/utils/src/pagination/index.spec.ts +150 -0
  152. package/packages/utils/src/pagination/index.ts +117 -0
  153. package/{dist/esm/routing/helpers.js → packages/utils/src/routing/helpers.ts} +42 -30
  154. package/packages/utils/src/routing/index.spec.ts +553 -0
  155. package/packages/utils/src/routing/index.ts +424 -0
  156. package/packages/utils/src/routing/validators/zod.spec.ts +16 -0
  157. package/packages/utils/src/routing/validators/zod.ts +14 -0
  158. package/packages/utils/src/services/accountsGateway/README.md +3 -0
  159. package/packages/utils/src/services/accountsGateway/index.spec.ts +518 -0
  160. package/packages/utils/src/services/accountsGateway/index.ts +251 -0
  161. package/packages/utils/src/services/apiGateway/README.md +93 -0
  162. package/packages/utils/src/services/apiGateway/index.spec.ts +254 -0
  163. package/packages/utils/src/services/apiGateway/index.ts +189 -0
  164. package/packages/utils/src/services/authProvider/README.md +21 -0
  165. package/packages/utils/src/services/authProvider/browser.spec.ts +391 -0
  166. package/packages/utils/src/services/authProvider/browser.ts +209 -0
  167. package/packages/utils/src/services/authProvider/decryption.spec.ts +337 -0
  168. package/packages/utils/src/services/authProvider/decryption.ts +98 -0
  169. package/packages/utils/src/services/authProvider/index.ts +93 -0
  170. package/packages/utils/src/services/authProvider/stub.spec.ts +29 -0
  171. package/packages/utils/src/services/authProvider/subrequest.spec.ts +105 -0
  172. package/packages/utils/src/services/authProvider/subrequest.ts +68 -0
  173. package/packages/utils/src/services/authProvider/utils/decryptAndVerify.spec.ts +128 -0
  174. package/packages/utils/src/services/authProvider/utils/decryptAndVerify.ts +106 -0
  175. package/packages/utils/src/services/authProvider/utils/embeddedAuthProvider.spec.ts +26 -0
  176. package/packages/utils/src/services/authProvider/utils/embeddedAuthProvider.ts +57 -0
  177. package/packages/utils/src/services/authProvider/utils/userRoleValidator.spec.ts +135 -0
  178. package/packages/utils/src/services/authProvider/utils/userRoleValidator.ts +49 -0
  179. package/packages/utils/src/services/authProvider/utils/userSubrequest.spec.ts +26 -0
  180. package/packages/utils/src/services/authProvider/utils/userSubrequest.ts +10 -0
  181. package/packages/utils/src/services/documentStore/dynamoEncoding.ts +57 -0
  182. package/packages/utils/src/services/documentStore/fileSystemAssert.spec.ts +43 -0
  183. package/packages/utils/src/services/documentStore/fileSystemAssert.ts +10 -0
  184. package/{dist/cjs/services/documentStore/index.d.ts → packages/utils/src/services/documentStore/index.ts} +8 -8
  185. package/packages/utils/src/services/documentStore/unversioned/README.md +13 -0
  186. package/packages/utils/src/services/documentStore/unversioned/dynamodb.spec.ts +859 -0
  187. package/packages/utils/src/services/documentStore/unversioned/dynamodb.ts +243 -0
  188. package/packages/utils/src/services/documentStore/unversioned/file-system.spec.ts +629 -0
  189. package/packages/utils/src/services/documentStore/unversioned/file-system.ts +194 -0
  190. package/{dist/cjs/services/documentStore/unversioned/index.d.ts → packages/utils/src/services/documentStore/unversioned/index.ts} +2 -0
  191. package/packages/utils/src/services/documentStore/versioned/README.md +13 -0
  192. package/packages/utils/src/services/documentStore/versioned/dynamodb.spec.ts +376 -0
  193. package/packages/utils/src/services/documentStore/versioned/dynamodb.ts +167 -0
  194. package/packages/utils/src/services/documentStore/versioned/file-system.spec.ts +262 -0
  195. package/packages/utils/src/services/documentStore/versioned/file-system.ts +90 -0
  196. package/packages/utils/src/services/documentStore/versioned/index.ts +25 -0
  197. package/packages/utils/src/services/exercisesGateway/README.md +5 -0
  198. package/packages/utils/src/services/exercisesGateway/index.spec.ts +326 -0
  199. package/packages/utils/src/services/exercisesGateway/index.ts +163 -0
  200. package/packages/utils/src/services/fileServer/index.spec.ts +88 -0
  201. package/packages/utils/src/services/fileServer/index.ts +43 -0
  202. package/packages/utils/src/services/fileServer/localFileServer.spec.ts +182 -0
  203. package/packages/utils/src/services/fileServer/localFileServer.ts +159 -0
  204. package/packages/utils/src/services/fileServer/s3FileServer.spec.ts +266 -0
  205. package/packages/utils/src/services/fileServer/s3FileServer.ts +155 -0
  206. package/packages/utils/src/services/launchParams/index.spec.ts +366 -0
  207. package/packages/utils/src/services/launchParams/signer.ts +73 -0
  208. package/packages/utils/src/services/launchParams/verifier.ts +120 -0
  209. package/packages/utils/src/services/logger/console.spec.ts +29 -0
  210. package/{dist/esm/services/logger/console.js → packages/utils/src/services/logger/console.ts} +5 -2
  211. package/packages/utils/src/services/logger/index.spec.ts +65 -0
  212. package/{dist/esm/services/logger/index.d.ts → packages/utils/src/services/logger/index.ts} +23 -9
  213. package/packages/utils/src/services/lrsGateway/README.md +5 -0
  214. package/packages/utils/src/services/lrsGateway/addStatementDefaultFields.ts +22 -0
  215. package/packages/utils/src/services/lrsGateway/attempt-utils.spec.ts +847 -0
  216. package/packages/utils/src/services/lrsGateway/attempt-utils.ts +358 -0
  217. package/packages/utils/src/services/lrsGateway/file-system.spec.ts +363 -0
  218. package/packages/utils/src/services/lrsGateway/file-system.ts +165 -0
  219. package/packages/utils/src/services/lrsGateway/index.spec.ts +194 -0
  220. package/packages/utils/src/services/lrsGateway/index.ts +257 -0
  221. package/packages/utils/src/services/lrsGateway/xapiUtils.spec.ts +887 -0
  222. package/packages/utils/src/services/lrsGateway/xapiUtils.ts +262 -0
  223. package/packages/utils/src/services/postgresConnection/index.spec.ts +170 -0
  224. package/packages/utils/src/services/postgresConnection/index.ts +84 -0
  225. package/packages/utils/src/services/searchProvider/README.md +3 -0
  226. package/packages/utils/src/services/searchProvider/index.ts +59 -0
  227. package/packages/utils/src/services/searchProvider/memorySearchTheBadWay.spec.ts +526 -0
  228. package/packages/utils/src/services/searchProvider/memorySearchTheBadWay.ts +223 -0
  229. package/packages/utils/src/services/searchProvider/openSearch.spec.ts +926 -0
  230. package/packages/utils/src/services/searchProvider/openSearch.ts +195 -0
  231. package/{dist/esm/types.d.ts → packages/utils/src/types.ts} +34 -6
  232. package/packages/utils/tsconfig.json +31 -0
  233. package/packages/utils/tsconfig.without-specs.cjs.json +7 -0
  234. package/packages/utils/tsconfig.without-specs.esm.json +7 -0
  235. package/packages/utils/tsconfig.without-specs.json +6 -0
  236. package/scripts/build.bash +24 -0
  237. package/scripts/ci.bash +10 -0
  238. package/scripts/start.bash +29 -0
  239. package/dist/cjs/assertions/index.d.ts +0 -89
  240. package/dist/cjs/assertions/index.js +0 -157
  241. package/dist/cjs/aws/ssmService.d.ts +0 -5
  242. package/dist/cjs/aws/ssmService.js +0 -9
  243. package/dist/cjs/config/awsParameterConfig.d.ts +0 -10
  244. package/dist/cjs/config/awsParameterConfig.js +0 -26
  245. package/dist/cjs/config/envConfig.d.ts +0 -24
  246. package/dist/cjs/config/envConfig.js +0 -57
  247. package/dist/cjs/config/index.d.ts +0 -48
  248. package/dist/cjs/config/index.js +0 -35
  249. package/dist/cjs/config/lambdaParameterConfig.d.ts +0 -12
  250. package/dist/cjs/config/lambdaParameterConfig.js +0 -45
  251. package/dist/cjs/config/replaceConfig.d.ts +0 -14
  252. package/dist/cjs/config/replaceConfig.js +0 -22
  253. package/dist/cjs/config/resolveConfigValue.d.ts +0 -5
  254. package/dist/cjs/config/resolveConfigValue.js +0 -12
  255. package/dist/cjs/errors/index.d.ts +0 -88
  256. package/dist/cjs/errors/index.js +0 -123
  257. package/dist/cjs/fetch/fetchStatusRetry.d.ts +0 -8
  258. package/dist/cjs/fetch/fetchStatusRetry.js +0 -27
  259. package/dist/cjs/fetch/index.d.ts +0 -64
  260. package/dist/cjs/fetch/index.js +0 -55
  261. package/dist/cjs/guards/index.d.ts +0 -38
  262. package/dist/cjs/guards/index.js +0 -44
  263. package/dist/cjs/index.js +0 -20
  264. package/dist/cjs/middleware/apiErrorHandler.d.ts +0 -24
  265. package/dist/cjs/middleware/apiErrorHandler.js +0 -42
  266. package/dist/cjs/middleware/apiSlowResponseMiddleware.d.ts +0 -23
  267. package/dist/cjs/middleware/apiSlowResponseMiddleware.js +0 -54
  268. package/dist/cjs/middleware/index.js +0 -48
  269. package/dist/cjs/middleware/lambdaCorsResponseMiddleware.d.ts +0 -20
  270. package/dist/cjs/middleware/lambdaCorsResponseMiddleware.js +0 -44
  271. package/dist/cjs/middleware/throwNotFoundMiddleware.d.ts +0 -4
  272. package/dist/cjs/middleware/throwNotFoundMiddleware.js +0 -14
  273. package/dist/cjs/misc/hashValue.d.ts +0 -10
  274. package/dist/cjs/misc/hashValue.js +0 -17
  275. package/dist/cjs/misc/helpers.d.ts +0 -124
  276. package/dist/cjs/misc/helpers.js +0 -214
  277. package/dist/cjs/misc/merge.d.ts +0 -21
  278. package/dist/cjs/misc/merge.js +0 -45
  279. package/dist/cjs/misc/partitionSequence.d.ts +0 -35
  280. package/dist/cjs/misc/partitionSequence.js +0 -55
  281. package/dist/cjs/pagination/index.d.ts +0 -91
  282. package/dist/cjs/pagination/index.js +0 -83
  283. package/dist/cjs/routing/helpers.d.ts +0 -57
  284. package/dist/cjs/routing/helpers.js +0 -90
  285. package/dist/cjs/routing/index.d.ts +0 -290
  286. package/dist/cjs/routing/index.js +0 -295
  287. package/dist/cjs/routing/validators/zod.d.ts +0 -4
  288. package/dist/cjs/routing/validators/zod.js +0 -14
  289. package/dist/cjs/services/accountsGateway/index.d.ts +0 -92
  290. package/dist/cjs/services/accountsGateway/index.js +0 -138
  291. package/dist/cjs/services/apiGateway/index.d.ts +0 -68
  292. package/dist/cjs/services/apiGateway/index.js +0 -118
  293. package/dist/cjs/services/authProvider/browser.d.ts +0 -40
  294. package/dist/cjs/services/authProvider/browser.js +0 -155
  295. package/dist/cjs/services/authProvider/decryption.d.ts +0 -19
  296. package/dist/cjs/services/authProvider/decryption.js +0 -73
  297. package/dist/cjs/services/authProvider/index.d.ts +0 -63
  298. package/dist/cjs/services/authProvider/index.js +0 -34
  299. package/dist/cjs/services/authProvider/subrequest.d.ts +0 -13
  300. package/dist/cjs/services/authProvider/subrequest.js +0 -49
  301. package/dist/cjs/services/authProvider/utils/decryptAndVerify.d.ts +0 -28
  302. package/dist/cjs/services/authProvider/utils/decryptAndVerify.js +0 -91
  303. package/dist/cjs/services/authProvider/utils/embeddedAuthProvider.d.ts +0 -26
  304. package/dist/cjs/services/authProvider/utils/embeddedAuthProvider.js +0 -47
  305. package/dist/cjs/services/authProvider/utils/userRoleValidator.d.ts +0 -13
  306. package/dist/cjs/services/authProvider/utils/userRoleValidator.js +0 -37
  307. package/dist/cjs/services/authProvider/utils/userSubrequest.d.ts +0 -3
  308. package/dist/cjs/services/authProvider/utils/userSubrequest.js +0 -13
  309. package/dist/cjs/services/documentStore/dynamoEncoding.d.ts +0 -10
  310. package/dist/cjs/services/documentStore/dynamoEncoding.js +0 -52
  311. package/dist/cjs/services/documentStore/fileSystemAssert.d.ts +0 -1
  312. package/dist/cjs/services/documentStore/fileSystemAssert.js +0 -14
  313. package/dist/cjs/services/documentStore/index.js +0 -2
  314. package/dist/cjs/services/documentStore/unversioned/dynamodb.d.ts +0 -31
  315. package/dist/cjs/services/documentStore/unversioned/dynamodb.js +0 -233
  316. package/dist/cjs/services/documentStore/unversioned/file-system.d.ts +0 -32
  317. package/dist/cjs/services/documentStore/unversioned/file-system.js +0 -214
  318. package/dist/cjs/services/documentStore/unversioned/index.js +0 -2
  319. package/dist/cjs/services/documentStore/versioned/dynamodb.d.ts +0 -25
  320. package/dist/cjs/services/documentStore/versioned/dynamodb.js +0 -143
  321. package/dist/cjs/services/documentStore/versioned/file-system.d.ts +0 -25
  322. package/dist/cjs/services/documentStore/versioned/file-system.js +0 -73
  323. package/dist/cjs/services/documentStore/versioned/index.d.ts +0 -17
  324. package/dist/cjs/services/documentStore/versioned/index.js +0 -2
  325. package/dist/cjs/services/exercisesGateway/index.d.ts +0 -67
  326. package/dist/cjs/services/exercisesGateway/index.js +0 -107
  327. package/dist/cjs/services/fileServer/index.d.ts +0 -30
  328. package/dist/cjs/services/fileServer/index.js +0 -19
  329. package/dist/cjs/services/fileServer/localFileServer.d.ts +0 -13
  330. package/dist/cjs/services/fileServer/localFileServer.js +0 -132
  331. package/dist/cjs/services/fileServer/s3FileServer.d.ts +0 -14
  332. package/dist/cjs/services/fileServer/s3FileServer.js +0 -132
  333. package/dist/cjs/services/launchParams/index.js +0 -7
  334. package/dist/cjs/services/launchParams/signer.d.ts +0 -23
  335. package/dist/cjs/services/launchParams/signer.js +0 -58
  336. package/dist/cjs/services/launchParams/verifier.d.ts +0 -21
  337. package/dist/cjs/services/launchParams/verifier.js +0 -129
  338. package/dist/cjs/services/logger/console.d.ts +0 -4
  339. package/dist/cjs/services/logger/console.js +0 -12
  340. package/dist/cjs/services/logger/index.d.ts +0 -39
  341. package/dist/cjs/services/logger/index.js +0 -31
  342. package/dist/cjs/services/lrsGateway/addStatementDefaultFields.d.ts +0 -5
  343. package/dist/cjs/services/lrsGateway/addStatementDefaultFields.js +0 -21
  344. package/dist/cjs/services/lrsGateway/attempt-utils.d.ts +0 -70
  345. package/dist/cjs/services/lrsGateway/attempt-utils.js +0 -258
  346. package/dist/cjs/services/lrsGateway/file-system.d.ts +0 -15
  347. package/dist/cjs/services/lrsGateway/file-system.js +0 -150
  348. package/dist/cjs/services/lrsGateway/index.d.ts +0 -122
  349. package/dist/cjs/services/lrsGateway/index.js +0 -148
  350. package/dist/cjs/services/lrsGateway/xapiUtils.d.ts +0 -68
  351. package/dist/cjs/services/lrsGateway/xapiUtils.js +0 -109
  352. package/dist/cjs/services/postgresConnection/index.d.ts +0 -28
  353. package/dist/cjs/services/postgresConnection/index.js +0 -65
  354. package/dist/cjs/services/searchProvider/index.d.ts +0 -67
  355. package/dist/cjs/services/searchProvider/index.js +0 -2
  356. package/dist/cjs/services/searchProvider/memorySearchTheBadWay.d.ts +0 -20
  357. package/dist/cjs/services/searchProvider/memorySearchTheBadWay.js +0 -191
  358. package/dist/cjs/services/searchProvider/openSearch.d.ts +0 -28
  359. package/dist/cjs/services/searchProvider/openSearch.js +0 -154
  360. package/dist/cjs/tsconfig.without-specs.cjs.tsbuildinfo +0 -1
  361. package/dist/cjs/types.d.ts +0 -31
  362. package/dist/cjs/types.js +0 -2
  363. package/dist/esm/assertions/index.d.ts +0 -89
  364. package/dist/esm/aws/ssmService.d.ts +0 -5
  365. package/dist/esm/aws/ssmService.js +0 -6
  366. package/dist/esm/config/awsParameterConfig.d.ts +0 -10
  367. package/dist/esm/config/awsParameterConfig.js +0 -22
  368. package/dist/esm/config/envConfig.d.ts +0 -24
  369. package/dist/esm/config/envConfig.js +0 -53
  370. package/dist/esm/config/index.js +0 -17
  371. package/dist/esm/config/lambdaParameterConfig.d.ts +0 -12
  372. package/dist/esm/config/lambdaParameterConfig.js +0 -38
  373. package/dist/esm/config/replaceConfig.d.ts +0 -14
  374. package/dist/esm/config/resolveConfigValue.d.ts +0 -5
  375. package/dist/esm/config/resolveConfigValue.js +0 -8
  376. package/dist/esm/errors/index.d.ts +0 -88
  377. package/dist/esm/fetch/fetchStatusRetry.d.ts +0 -8
  378. package/dist/esm/fetch/fetchStatusRetry.js +0 -23
  379. package/dist/esm/fetch/index.d.ts +0 -64
  380. package/dist/esm/fetch/index.js +0 -46
  381. package/dist/esm/guards/index.js +0 -36
  382. package/dist/esm/index.d.ts +0 -4
  383. package/dist/esm/index.js +0 -4
  384. package/dist/esm/middleware/apiErrorHandler.d.ts +0 -24
  385. package/dist/esm/middleware/apiErrorHandler.js +0 -38
  386. package/dist/esm/middleware/apiSlowResponseMiddleware.d.ts +0 -23
  387. package/dist/esm/middleware/apiSlowResponseMiddleware.js +0 -50
  388. package/dist/esm/middleware/index.d.ts +0 -47
  389. package/dist/esm/middleware/index.js +0 -44
  390. package/dist/esm/middleware/lambdaCorsResponseMiddleware.d.ts +0 -20
  391. package/dist/esm/middleware/lambdaCorsResponseMiddleware.js +0 -40
  392. package/dist/esm/middleware/throwNotFoundMiddleware.d.ts +0 -4
  393. package/dist/esm/middleware/throwNotFoundMiddleware.js +0 -10
  394. package/dist/esm/misc/hashValue.d.ts +0 -10
  395. package/dist/esm/misc/hashValue.js +0 -13
  396. package/dist/esm/misc/helpers.d.ts +0 -124
  397. package/dist/esm/misc/helpers.js +0 -199
  398. package/dist/esm/misc/merge.d.ts +0 -21
  399. package/dist/esm/misc/merge.js +0 -40
  400. package/dist/esm/misc/partitionSequence.d.ts +0 -35
  401. package/dist/esm/pagination/index.d.ts +0 -91
  402. package/dist/esm/pagination/index.js +0 -77
  403. package/dist/esm/routing/helpers.d.ts +0 -57
  404. package/dist/esm/routing/index.d.ts +0 -290
  405. package/dist/esm/routing/index.js +0 -246
  406. package/dist/esm/routing/validators/zod.d.ts +0 -4
  407. package/dist/esm/routing/validators/zod.js +0 -10
  408. package/dist/esm/services/accountsGateway/index.d.ts +0 -92
  409. package/dist/esm/services/accountsGateway/index.js +0 -131
  410. package/dist/esm/services/apiGateway/index.d.ts +0 -68
  411. package/dist/esm/services/apiGateway/index.js +0 -77
  412. package/dist/esm/services/authProvider/browser.d.ts +0 -40
  413. package/dist/esm/services/authProvider/browser.js +0 -151
  414. package/dist/esm/services/authProvider/decryption.d.ts +0 -19
  415. package/dist/esm/services/authProvider/decryption.js +0 -69
  416. package/dist/esm/services/authProvider/index.d.ts +0 -63
  417. package/dist/esm/services/authProvider/index.js +0 -26
  418. package/dist/esm/services/authProvider/subrequest.d.ts +0 -13
  419. package/dist/esm/services/authProvider/subrequest.js +0 -45
  420. package/dist/esm/services/authProvider/utils/decryptAndVerify.d.ts +0 -28
  421. package/dist/esm/services/authProvider/utils/decryptAndVerify.js +0 -85
  422. package/dist/esm/services/authProvider/utils/embeddedAuthProvider.d.ts +0 -26
  423. package/dist/esm/services/authProvider/utils/embeddedAuthProvider.js +0 -40
  424. package/dist/esm/services/authProvider/utils/userRoleValidator.d.ts +0 -13
  425. package/dist/esm/services/authProvider/utils/userRoleValidator.js +0 -33
  426. package/dist/esm/services/authProvider/utils/userSubrequest.d.ts +0 -3
  427. package/dist/esm/services/authProvider/utils/userSubrequest.js +0 -6
  428. package/dist/esm/services/documentStore/dynamoEncoding.d.ts +0 -10
  429. package/dist/esm/services/documentStore/dynamoEncoding.js +0 -45
  430. package/dist/esm/services/documentStore/fileSystemAssert.d.ts +0 -1
  431. package/dist/esm/services/documentStore/fileSystemAssert.js +0 -10
  432. package/dist/esm/services/documentStore/index.d.ts +0 -14
  433. package/dist/esm/services/documentStore/index.js +0 -1
  434. package/dist/esm/services/documentStore/unversioned/dynamodb.d.ts +0 -31
  435. package/dist/esm/services/documentStore/unversioned/dynamodb.js +0 -226
  436. package/dist/esm/services/documentStore/unversioned/file-system.d.ts +0 -32
  437. package/dist/esm/services/documentStore/unversioned/file-system.js +0 -174
  438. package/dist/esm/services/documentStore/unversioned/index.d.ts +0 -2
  439. package/dist/esm/services/documentStore/unversioned/index.js +0 -1
  440. package/dist/esm/services/documentStore/versioned/dynamodb.d.ts +0 -25
  441. package/dist/esm/services/documentStore/versioned/dynamodb.js +0 -139
  442. package/dist/esm/services/documentStore/versioned/file-system.d.ts +0 -25
  443. package/dist/esm/services/documentStore/versioned/file-system.js +0 -69
  444. package/dist/esm/services/documentStore/versioned/index.d.ts +0 -17
  445. package/dist/esm/services/documentStore/versioned/index.js +0 -1
  446. package/dist/esm/services/exercisesGateway/index.d.ts +0 -67
  447. package/dist/esm/services/exercisesGateway/index.js +0 -70
  448. package/dist/esm/services/fileServer/index.d.ts +0 -30
  449. package/dist/esm/services/fileServer/index.js +0 -13
  450. package/dist/esm/services/fileServer/localFileServer.d.ts +0 -13
  451. package/dist/esm/services/fileServer/localFileServer.js +0 -125
  452. package/dist/esm/services/fileServer/s3FileServer.d.ts +0 -14
  453. package/dist/esm/services/fileServer/s3FileServer.js +0 -125
  454. package/dist/esm/services/launchParams/index.d.ts +0 -2
  455. package/dist/esm/services/launchParams/index.js +0 -2
  456. package/dist/esm/services/launchParams/signer.d.ts +0 -23
  457. package/dist/esm/services/launchParams/signer.js +0 -51
  458. package/dist/esm/services/launchParams/verifier.d.ts +0 -21
  459. package/dist/esm/services/launchParams/verifier.js +0 -92
  460. package/dist/esm/services/logger/console.d.ts +0 -4
  461. package/dist/esm/services/logger/index.js +0 -27
  462. package/dist/esm/services/lrsGateway/addStatementDefaultFields.d.ts +0 -5
  463. package/dist/esm/services/lrsGateway/addStatementDefaultFields.js +0 -14
  464. package/dist/esm/services/lrsGateway/attempt-utils.d.ts +0 -70
  465. package/dist/esm/services/lrsGateway/attempt-utils.js +0 -236
  466. package/dist/esm/services/lrsGateway/file-system.d.ts +0 -15
  467. package/dist/esm/services/lrsGateway/file-system.js +0 -110
  468. package/dist/esm/services/lrsGateway/index.d.ts +0 -122
  469. package/dist/esm/services/lrsGateway/index.js +0 -111
  470. package/dist/esm/services/lrsGateway/xapiUtils.d.ts +0 -68
  471. package/dist/esm/services/lrsGateway/xapiUtils.js +0 -99
  472. package/dist/esm/services/postgresConnection/index.d.ts +0 -28
  473. package/dist/esm/services/postgresConnection/index.js +0 -58
  474. package/dist/esm/services/searchProvider/index.d.ts +0 -67
  475. package/dist/esm/services/searchProvider/index.js +0 -1
  476. package/dist/esm/services/searchProvider/memorySearchTheBadWay.d.ts +0 -20
  477. package/dist/esm/services/searchProvider/memorySearchTheBadWay.js +0 -187
  478. package/dist/esm/services/searchProvider/openSearch.d.ts +0 -28
  479. package/dist/esm/services/searchProvider/openSearch.js +0 -150
  480. package/dist/esm/tsconfig.without-specs.esm.tsbuildinfo +0 -1
  481. package/dist/esm/types.js +0 -1
  482. package/script/bin/.init-params-script.bash.swp +0 -0
  483. /package/{script → packages/utils/script}/bin/copy-from-template.bash +0 -0
  484. /package/{script → packages/utils/script}/bin/delete-stack.bash +0 -0
  485. /package/{script → packages/utils/script}/bin/deploy.bash +0 -0
  486. /package/{script → packages/utils/script}/bin/destroy-deployment.bash +0 -0
  487. /package/{script → packages/utils/script}/bin/empty-bucket.bash +0 -0
  488. /package/{script → packages/utils/script}/bin/get-arg.bash +0 -0
  489. /package/{script → packages/utils/script}/bin/get-deployed-environments.bash +0 -0
  490. /package/{script → packages/utils/script}/bin/get-env-param.bash +0 -0
  491. /package/{script → packages/utils/script}/bin/get-kwarg.bash +0 -0
  492. /package/{script → packages/utils/script}/bin/get-stack-param.bash +0 -0
  493. /package/{script → packages/utils/script}/bin/has-flag.bash +0 -0
  494. /package/{script → packages/utils/script}/bin/init-constants-script.bash +0 -0
  495. /package/{script → packages/utils/script}/bin/init-params-script.bash +0 -0
  496. /package/{script → packages/utils/script}/bin/stack-exists.bash +0 -0
  497. /package/{script → packages/utils/script}/bin/update-utils.bash +0 -0
  498. /package/{script → packages/utils/script}/bin/upload-pager-duty-endpoints.bash +0 -0
  499. /package/{script → packages/utils/script}/bin/upload-params.bash +0 -0
  500. /package/{script → packages/utils/script}/bin/which.bash +0 -0
  501. /package/{script → packages/utils/script}/bin-entry.bash +0 -0
  502. /package/{script → packages/utils/script}/build.bash +0 -0
  503. /package/{dist/cjs/index.d.ts → packages/utils/src/index.ts} +0 -0
  504. /package/{dist/cjs/services/launchParams/index.d.ts → packages/utils/src/services/launchParams/index.ts} +0 -0
@@ -0,0 +1,263 @@
1
+ import { getKeyValue } from '@openstax/ts-utils';
2
+ import { stubAuthProvider, User } from '@openstax/ts-utils/services/authProvider';
3
+ import { FileServerAdapter } from '@openstax/ts-utils/services/fileServer';
4
+ import { createConsoleLogger } from '@openstax/ts-utils/services/logger/console';
5
+ import { ApiRouteRequest, AppServices } from '../../core';
6
+ import { apiV0Index, apiV0Routes, buildIndex, makeIndexHtmlBody } from '.';
7
+
8
+ let appServices: AppServices;
9
+ let request: ApiRouteRequest;
10
+
11
+ beforeEach(async () => {
12
+ appServices = {} as AppServices;
13
+ request = {} as ApiRouteRequest;
14
+ });
15
+
16
+ afterEach(() => {
17
+ jest.clearAllMocks();
18
+ });
19
+
20
+ describe('apiV0Index', () => {
21
+ it('matches snapshot', async() => {
22
+ const requestServices = {
23
+ logger: createConsoleLogger(),
24
+ request,
25
+ environmentConfig: {
26
+ codeVersion: 'code-version-goes-here',
27
+ apiHost: '',
28
+ uiHost: '',
29
+ maintenanceMessage: '',
30
+ frontendConfig: {
31
+ roleApplication: 'test',
32
+ accountsBase: 'https://dev.openstax.org/accounts',
33
+ exampleMessage: 'hello from /api/v0/info',
34
+ },
35
+ },
36
+ authProvider: stubAuthProvider()
37
+ };
38
+ const response = await apiV0Index.handler(undefined, requestServices);
39
+ expect(response).toMatchInlineSnapshot(`
40
+ {
41
+ "body": "{"message":"greetings from the api controller","code":"code-version-goes-here","config":{"roleApplication":"test","accountsBase":"https://dev.openstax.org/accounts","exampleMessage":"hello from /api/v0/info","releaseId":"code-version-goes-here"}}",
42
+ "data": {
43
+ "code": "code-version-goes-here",
44
+ "config": {
45
+ "accountsBase": "https://dev.openstax.org/accounts",
46
+ "exampleMessage": "hello from /api/v0/info",
47
+ "releaseId": "code-version-goes-here",
48
+ "roleApplication": "test",
49
+ },
50
+ "message": "greetings from the api controller",
51
+ },
52
+ "headers": {
53
+ "content-type": "application/json",
54
+ },
55
+ "statusCode": 200,
56
+ }
57
+ `);
58
+ });
59
+
60
+ it('matches snapshot with user', async() => {
61
+ const requestServices = {
62
+ logger: createConsoleLogger(),
63
+ request,
64
+ environmentConfig: {
65
+ codeVersion: 'code-version-goes-here',
66
+ apiHost: '',
67
+ uiHost: '',
68
+ maintenanceMessage: '',
69
+ frontendConfig: {
70
+ roleApplication: 'test',
71
+ accountsBase: 'https://dev.openstax.org/accounts',
72
+ exampleMessage: 'hello from /api/v0/info',
73
+ },
74
+ },
75
+ authProvider: stubAuthProvider({name: 'test user', uuid: '5c9f7915-4abb-499b-805d-de29cdf67e2d'} as User)
76
+ };
77
+ appServices.getEnvironmentConfig = getKeyValue('deployed');
78
+ const response = await apiV0Index.handler(undefined, requestServices);
79
+ expect(response).toMatchInlineSnapshot(`
80
+ {
81
+ "body": "{"message":"greetings from the api controller test user","code":"code-version-goes-here","config":{"roleApplication":"test","accountsBase":"https://dev.openstax.org/accounts","exampleMessage":"hello from /api/v0/info","releaseId":"code-version-goes-here"}}",
82
+ "data": {
83
+ "code": "code-version-goes-here",
84
+ "config": {
85
+ "accountsBase": "https://dev.openstax.org/accounts",
86
+ "exampleMessage": "hello from /api/v0/info",
87
+ "releaseId": "code-version-goes-here",
88
+ "roleApplication": "test",
89
+ },
90
+ "message": "greetings from the api controller test user",
91
+ },
92
+ "headers": {
93
+ "content-type": "application/json",
94
+ },
95
+ "statusCode": 200,
96
+ }
97
+ `);
98
+ });
99
+ });
100
+
101
+ describe('buildIndex', () => {
102
+ it('matches snapshot without user', async() => {
103
+ const requestServices = {
104
+ authProvider: stubAuthProvider(),
105
+ environmentConfig: {
106
+ codeVersion: 'code-version-goes-here',
107
+ apiHost: '',
108
+ uiHost: '',
109
+ maintenanceMessage: '',
110
+ frontendConfig: {
111
+ roleApplication: 'test',
112
+ accountsBase: 'https://dev.openstax.org/accounts',
113
+ exampleMessage: 'hello from /api/v0/info',
114
+ },
115
+ },
116
+ frontendFileServer: {
117
+ putFileContent: jest.fn(),
118
+ getSignedViewerUrl: jest.fn(),
119
+ getFileContent: async() => Buffer.from(
120
+ '<html><head><!-- Static head stuff --></head><body><!-- Static body stuff --></body></html>'
121
+ )
122
+ } as unknown as FileServerAdapter,
123
+ logger: createConsoleLogger(),
124
+ request,
125
+ };
126
+ const response = await buildIndex.handler(undefined, requestServices);
127
+ expect(response).toMatchInlineSnapshot(`
128
+ {
129
+ "body": "<html><head>
130
+ <script>window._OX_FRONTEND_CONFIG = {"roleApplication":"test","accountsBase":"https://dev.openstax.org/accounts","exampleMessage":"hello from /api/v0/info","releaseId":"code-version-goes-here"};</script><!-- Static head stuff --></head><body><!-- Static body stuff --></body></html>",
131
+ "data": "<html><head>
132
+ <script>window._OX_FRONTEND_CONFIG = {"roleApplication":"test","accountsBase":"https://dev.openstax.org/accounts","exampleMessage":"hello from /api/v0/info","releaseId":"code-version-goes-here"};</script><!-- Static head stuff --></head><body><!-- Static body stuff --></body></html>",
133
+ "headers": {
134
+ "cache-control": "no-cache",
135
+ "content-type": "text/html",
136
+ },
137
+ "statusCode": 200,
138
+ }
139
+ `);
140
+ });
141
+
142
+ it('matches snapshot with user', async() => {
143
+ const requestServices = {
144
+ authProvider: stubAuthProvider({
145
+ uuid: '5c9f7915-4abb-499b-805d-de29cdf67e2d',
146
+ consent_preferences: { accepted: ['test'], rejected: ['nothing'] },
147
+ } as User),
148
+ environmentConfig: {
149
+ codeVersion: 'code-version-goes-here',
150
+ apiHost: '',
151
+ uiHost: '',
152
+ maintenanceMessage: '',
153
+ frontendConfig: {
154
+ roleApplication: 'test',
155
+ accountsBase: 'https://dev.openstax.org/accounts',
156
+ exampleMessage: 'hello from /api/v0/info',
157
+ },
158
+ },
159
+ frontendFileServer: {
160
+ putFileContent: jest.fn(),
161
+ getSignedViewerUrl: jest.fn(),
162
+ getFileContent: async() => Buffer.from(
163
+ '<html><head><!-- Static head stuff --></head><body><!-- Static body stuff --></body></html>'
164
+ )
165
+ } as unknown as FileServerAdapter,
166
+ logger: createConsoleLogger(),
167
+ request,
168
+ };
169
+ const response = await buildIndex.handler(undefined, requestServices);
170
+ expect(response).toMatchInlineSnapshot(`
171
+ {
172
+ "body": "<html><head>
173
+ <script>
174
+ window._OX_AUTH_TOKEN = 'authToken';
175
+ window._OX_USER_DATA = {"consentPreferences":{"accepted":["test"],"rejected":["nothing"]},"uuid":"5c9f7915-4abb-499b-805d-de29cdf67e2d"};
176
+ </script>
177
+ <script>window._OX_FRONTEND_CONFIG = {"roleApplication":"test","accountsBase":"https://dev.openstax.org/accounts","exampleMessage":"hello from /api/v0/info","releaseId":"code-version-goes-here"};</script><!-- Static head stuff --></head><body><!-- Static body stuff --></body></html>",
178
+ "data": "<html><head>
179
+ <script>
180
+ window._OX_AUTH_TOKEN = 'authToken';
181
+ window._OX_USER_DATA = {"consentPreferences":{"accepted":["test"],"rejected":["nothing"]},"uuid":"5c9f7915-4abb-499b-805d-de29cdf67e2d"};
182
+ </script>
183
+ <script>window._OX_FRONTEND_CONFIG = {"roleApplication":"test","accountsBase":"https://dev.openstax.org/accounts","exampleMessage":"hello from /api/v0/info","releaseId":"code-version-goes-here"};</script><!-- Static head stuff --></head><body><!-- Static body stuff --></body></html>",
184
+ "headers": {
185
+ "cache-control": "no-cache",
186
+ "content-type": "text/html",
187
+ },
188
+ "statusCode": 200,
189
+ }
190
+ `);
191
+ });
192
+
193
+ it('matches snapshot with subcontent queryStringParameter', async() => {
194
+ const requestServices = {
195
+ authProvider: stubAuthProvider(),
196
+ environmentConfig: {
197
+ codeVersion: 'code-version-goes-here',
198
+ apiHost: '',
199
+ uiHost: '',
200
+ maintenanceMessage: '',
201
+ frontendConfig: {
202
+ roleApplication: 'test',
203
+ accountsBase: 'https://dev.openstax.org/accounts',
204
+ exampleMessage: 'hello from /api/v0/info',
205
+ },
206
+ },
207
+ frontendFileServer: {
208
+ putFileContent: jest.fn(),
209
+ getSignedViewerUrl: jest.fn(),
210
+ getFileContent: async() => Buffer.from(
211
+ '<html><head><!-- Static head stuff --></head><body><!-- Static body stuff --></body></html>'
212
+ )
213
+ } as unknown as FileServerAdapter,
214
+ logger: createConsoleLogger(),
215
+ request: { queryStringParameters: { subcontent: 'true' } } as unknown as ApiRouteRequest,
216
+ };
217
+ const response = await buildIndex.handler(undefined, requestServices);
218
+ expect(response).toMatchInlineSnapshot(`
219
+ {
220
+ "body": "<html><head>
221
+ <script>window._OX_FRONTEND_CONFIG = {"roleApplication":"test","accountsBase":"https://dev.openstax.org/accounts","exampleMessage":"hello from /api/v0/info","releaseId":"code-version-goes-here"};</script><!-- Static head stuff --></head><body class="os-subcontent"><!-- Static body stuff --></body></html>",
222
+ "data": "<html><head>
223
+ <script>window._OX_FRONTEND_CONFIG = {"roleApplication":"test","accountsBase":"https://dev.openstax.org/accounts","exampleMessage":"hello from /api/v0/info","releaseId":"code-version-goes-here"};</script><!-- Static head stuff --></head><body class="os-subcontent"><!-- Static body stuff --></body></html>",
224
+ "headers": {
225
+ "cache-control": "no-cache",
226
+ "content-type": "text/html",
227
+ },
228
+ "statusCode": 200,
229
+ }
230
+ `);
231
+ });
232
+ });
233
+
234
+ describe('makeIndexHtmlBody', () => {
235
+ it('matches snapshot with maintenance message', async () => {
236
+ const response = await makeIndexHtmlBody({
237
+ putFileContent: jest.fn(),
238
+ getSignedViewerUrl: jest.fn(),
239
+ getFileContent: async () => Buffer.from(
240
+ '<html><head><!-- Static head stuff --></head><body><!-- Static body stuff --></body></html>'
241
+ )
242
+ } as unknown as FileServerAdapter, {
243
+ codeVersion: 'code-version-goes-here',
244
+ maintenanceMessage: 'Down for maintenance',
245
+ frontendConfig: {
246
+ roleApplication: 'test',
247
+ accountsBase: 'https://dev.openstax.org/accounts',
248
+ exampleMessage: 'hello from /api/v0/info',
249
+ }
250
+ }
251
+ );
252
+ expect(response).toMatchInlineSnapshot(`
253
+ "<html><head>
254
+ <script>window._OX_FRONTEND_CONFIG = {"roleApplication":"test","accountsBase":"https://dev.openstax.org/accounts","exampleMessage":"hello from /api/v0/info","releaseId":"code-version-goes-here"};</script><!-- Static head stuff --></head><body>Down for maintenance<!-- Static body stuff --></body></html>"
255
+ `);
256
+ });
257
+ });
258
+
259
+ describe('apiV0Routes', () => {
260
+ it('collects routes', () => {
261
+ expect(() => apiV0Routes()).not.toThrow();
262
+ });
263
+ });
@@ -0,0 +1,134 @@
1
+ import { ConfigForConfigProvider, ConfigValueProvider, envConfig, resolveConfigValue } from '@openstax/ts-utils/config';
2
+ import { once } from '@openstax/ts-utils/misc/helpers';
3
+ import { apiHtmlResponse, apiJsonResponse, METHOD, routesList } from '@openstax/ts-utils/routing';
4
+ import { TokenUser } from '@openstax/ts-utils/services/authProvider';
5
+ import { FileServerAdapter } from '@openstax/ts-utils/services/fileServer';
6
+ import { composeServiceMiddleware, createRoute } from '../../core/services';
7
+ import { apiV0ExampleRoutes } from './example/routes';
8
+ import { authMiddleware } from './middleware/authMiddleware';
9
+ import { getEnvironmentConfig } from './middleware/configMiddleware';
10
+ import { frontendFileServerMiddleware } from './middleware/frontendFileServerMiddleware';
11
+ import { roleValidatorConfig } from './middleware/userRoleValidatorMiddleware';
12
+
13
+ // frontendConfig values are visible to all users
14
+ const configProvider = getEnvironmentConfig({
15
+ local: {
16
+ codeVersion: 'dev',
17
+ maintenanceMessage: envConfig('MAINTENANCE_MESSAGE', 'runtime', ''),
18
+ frontendConfig: {
19
+ roleApplication: roleValidatorConfig.application,
20
+ accountsBase: envConfig('ACCOUNTS_BASE', 'runtime', '/accounts'),
21
+ exampleMessage: envConfig('EXAMPLE_MESSAGE', 'runtime', 'hello from /api/v0/info'),
22
+ },
23
+ },
24
+ deployed: {
25
+ codeVersion: envConfig('CODE_VERSION'),
26
+ maintenanceMessage: envConfig('MAINTENANCE_MESSAGE', 'runtime', ''),
27
+ frontendConfig: {
28
+ roleApplication: roleValidatorConfig.application,
29
+ accountsBase: envConfig('ACCOUNTS_BASE', 'runtime'),
30
+ exampleMessage: envConfig('EXAMPLE_MESSAGE', 'runtime', 'hello from /api/v0/info'),
31
+ },
32
+ },
33
+ });
34
+
35
+ const requestServiceProvider = composeServiceMiddleware(
36
+ authMiddleware,
37
+ configProvider,
38
+ );
39
+
40
+ type EnvironmentConfigProvider = ReturnType<ReturnType<typeof configProvider>>['environmentConfig'];
41
+ export type FrontendConfigProvider = EnvironmentConfigProvider['frontendConfig'];
42
+
43
+ const resolveFrontendConfig = once(async(frontendConfig: FrontendConfigProvider, codeVersion: ConfigValueProvider<string>) => {
44
+ const config: Record<string, ConfigValueProvider<string>> = {};
45
+
46
+ await Promise.all(Object.entries({...frontendConfig, releaseId: codeVersion}).map(
47
+ async([name, value]) => config[name] = await resolveConfigValue(value)
48
+ ));
49
+
50
+ return config as ConfigForConfigProvider<FrontendConfigProvider>;
51
+ });
52
+
53
+ export const makeIndexHtmlBody = async(fileServer: FileServerAdapter, config: EnvironmentConfigProvider) => {
54
+ const frontendConfig = await resolveFrontendConfig(config.frontendConfig, config.codeVersion);
55
+ const maintenanceMessage = await resolveConfigValue(config.maintenanceMessage);
56
+ const bodyFile = maintenanceMessage ? 'maintenance' : 'index';
57
+
58
+ let body = (await fileServer.getFileContent({
59
+ dataType: 'file',
60
+ mimeType: 'text/html',
61
+ path: `build/${bodyFile}.html`,
62
+ label: `${bodyFile}.html`,
63
+ })).toString();
64
+
65
+ if (maintenanceMessage) {
66
+ body = body.replace('<body>', `<body>${maintenanceMessage}`);
67
+ }
68
+
69
+ return body.replace(
70
+ '<head>',
71
+ `<head>
72
+ <script>window._OX_FRONTEND_CONFIG = ${JSON.stringify(frontendConfig)};</script>`
73
+ );
74
+ };
75
+
76
+ const indexHtmlBody = once(makeIndexHtmlBody);
77
+
78
+ export const apiV0Index = createRoute({name: 'apiV0Info', method: METHOD.GET, path: '/api/v0/info',
79
+ requestServiceProvider},
80
+ async(_params: undefined, services) => {
81
+ const user = await services.authProvider.getUser();
82
+ const environmentConfig = services.environmentConfig;
83
+ // This config is here for backwards compatibility and can eventually be removed
84
+ const config = await resolveFrontendConfig(environmentConfig.frontendConfig, environmentConfig.codeVersion);
85
+
86
+ return apiJsonResponse(200, {
87
+ message: `greetings from the api controller${user ? ` ${user.name}`: ''}`,
88
+ code: await resolveConfigValue(services.environmentConfig.codeVersion),
89
+ config: config,
90
+ });
91
+ }
92
+ );
93
+
94
+ const oxUserData = (user: TokenUser, consentPreferences: { accepted?: string[]; rejected?: string[] } | undefined) => {
95
+ const { uuid } = user;
96
+ return JSON.stringify({ consentPreferences, uuid });
97
+ };
98
+
99
+ export const buildIndex = createRoute({name: 'buildIndex', method: METHOD.GET, path: '/build/index.html',
100
+ requestServiceProvider: composeServiceMiddleware(
101
+ requestServiceProvider,
102
+ frontendFileServerMiddleware,
103
+ )},
104
+ async(_params: undefined, services) => {
105
+ const token = await services.authProvider.getAuthToken();
106
+ const user = await services.authProvider.loadUserData();
107
+
108
+ // Frontend config is already included
109
+ const originalBody = await indexHtmlBody(services.frontendFileServer, services.environmentConfig);
110
+
111
+ // Add os-subcontent body class if subcontent queryStringParameter is set to true
112
+ const bodyWithSubcontent = services.request.queryStringParameters?.subcontent === 'true' ? originalBody.replace(
113
+ '<body>', '<body class="os-subcontent">'
114
+ ) : originalBody;
115
+
116
+ // Add _OX_USER_DATA if logged in
117
+ const body = user ? bodyWithSubcontent.replace(
118
+ '<head>',
119
+ `<head>
120
+ <script>
121
+ window._OX_AUTH_TOKEN = '${token}';
122
+ window._OX_USER_DATA = ${oxUserData(user, user.consent_preferences)};
123
+ </script>`
124
+ ): bodyWithSubcontent;
125
+
126
+ return apiHtmlResponse(200, body, { 'cache-control': 'no-cache' });
127
+ }
128
+ );
129
+
130
+ export const apiV0Routes = () => routesList([
131
+ apiV0Index,
132
+ buildIndex,
133
+ ...apiV0ExampleRoutes(),
134
+ ]);
@@ -0,0 +1,23 @@
1
+ import { createCoreLogger } from '@openstax/ts-utils/services/logger';
2
+ import { ApiRouteRequest, AppServices } from '../../../core';
3
+ import { authMiddleware } from './authMiddleware';
4
+
5
+ describe('authMiddleware', () => {
6
+ it('adds request cookies to auth provider', () => {
7
+ const createAuthProvider = jest.fn();
8
+ const request = {headers: {}, cookies: ['one=cookieOne', 'two=cookieTwo']} as unknown as ApiRouteRequest;
9
+ const logger = createCoreLogger(jest.fn());
10
+ const middleware = {request, logger};
11
+ authMiddleware({createAuthProvider: () => createAuthProvider} as unknown as AppServices)(middleware);
12
+ expect(createAuthProvider).toHaveBeenCalledWith(expect.objectContaining({request}));
13
+ });
14
+
15
+ it('works if there are no cookies', () => {
16
+ const createAuthProvider = jest.fn();
17
+ const request = {headers: {}} as unknown as ApiRouteRequest;
18
+ const logger = createCoreLogger(jest.fn());
19
+ const middleware = {request, logger};
20
+ authMiddleware({createAuthProvider: () => createAuthProvider} as unknown as AppServices)(middleware);
21
+ expect(createAuthProvider).toHaveBeenCalledWith(expect.objectContaining({request}));
22
+ });
23
+ });
@@ -0,0 +1,32 @@
1
+ import { envConfig, lambdaParameterConfig, replaceConfig } from '@openstax/ts-utils/config';
2
+ import type { Logger } from '@openstax/ts-utils/services/logger';
3
+ import { ApiRouteRequest, AppServices } from '../../../core';
4
+
5
+ const config = {
6
+ local: {
7
+ accountsBase: 'https://dev.openstax.org/accounts',
8
+ cookieName: 'oxa_dev',
9
+ },
10
+ deployed: {
11
+ accountsBase: envConfig('ACCOUNTS_BASE', 'runtime'),
12
+ cookieName: envConfig('COOKIE_NAME', 'runtime'),
13
+ encryptionPrivateKey: lambdaParameterConfig(
14
+ replaceConfig('/[app]/[env]/api/EncryptionPrivateKey', {
15
+ '[app]': envConfig('APPLICATION'),
16
+ '[env]': envConfig('ENV_NAME', 'runtime')
17
+ })
18
+ ),
19
+ signaturePublicKey: envConfig('SIGNATURE_PUBLIC_KEY', 'runtime'),
20
+ },
21
+ };
22
+
23
+ export const authMiddleware = ({createAuthProvider}: AppServices) => {
24
+ const authProvider = createAuthProvider(config);
25
+
26
+ return <M extends {request: ApiRouteRequest; logger: Logger}>(middleware: M) => {
27
+ return {
28
+ ...middleware,
29
+ authProvider: authProvider(middleware)
30
+ };
31
+ };
32
+ };
@@ -0,0 +1,10 @@
1
+ import { getKeyValue } from '@openstax/ts-utils';
2
+ import { AppServices } from '../../../core/types';
3
+ import { getEnvironmentConfig } from './configMiddleware';
4
+
5
+ describe('getEnvironmentConfig', () => {
6
+ it('gets the environment config', () => {
7
+ const result = getEnvironmentConfig({local: {test: 'local'}, deployed: {test: 'deployed'}})({getEnvironmentConfig: getKeyValue('local')} as AppServices)({});
8
+ expect(result.environmentConfig.test).toBe('local');
9
+ });
10
+ });
@@ -0,0 +1,7 @@
1
+ // TODO - if we make this even more generic so that it doesn't rely on the app specific base config type, we can move it to ts-utils/config
2
+ import { AppServices, BaseEnvironmentConfig } from '../../../core/types';
3
+
4
+ export const getEnvironmentConfig = <P extends BaseEnvironmentConfig>(config: P) => ({getEnvironmentConfig}: AppServices) => <M extends {}>(middleware: M) => {
5
+ const environmentConfig = getEnvironmentConfig(config);
6
+ return {...middleware, environmentConfig};
7
+ };
@@ -0,0 +1,13 @@
1
+ import { ApiRouteRequest, AppServices } from '../../../core';
2
+ import { frontendFileServerMiddleware } from './frontendFileServerMiddleware';
3
+
4
+ describe('frontendFileServerMiddleware', () => {
5
+ it('adds frontendFileServer to middleware stack', () => {
6
+ const frontendFileServer = {};
7
+ const createFileServer = jest.fn().mockReturnValue(frontendFileServer);
8
+ const request = {} as unknown as ApiRouteRequest;
9
+ const middleware = frontendFileServerMiddleware({ createFileServer } as unknown as AppServices)({request});
10
+ expect(createFileServer).toHaveBeenCalledWith(expect.objectContaining({ local: { storagePrefix: '../../frontend' } }));
11
+ expect(middleware.frontendFileServer).toBe(frontendFileServer);
12
+ });
13
+ });
@@ -0,0 +1,23 @@
1
+ import { envConfig } from '@openstax/ts-utils/config';
2
+ import { ApiRouteRequest, AppServices } from '../../../core';
3
+
4
+ const config = {
5
+ local: {
6
+ storagePrefix: '../../frontend',
7
+ },
8
+ deployed: {
9
+ bucketName: envConfig('FRONTEND_BUILD_BUCKET', 'runtime'),
10
+ bucketRegion: envConfig('AWS_REGION', 'runtime'),
11
+ },
12
+ };
13
+
14
+ export const frontendFileServerMiddleware = ({ createFileServer }: AppServices) => {
15
+ const frontendFileServer = createFileServer(config);
16
+
17
+ return <M extends {request: ApiRouteRequest}>(middleware: M) => {
18
+ return {
19
+ ...middleware,
20
+ frontendFileServer
21
+ };
22
+ };
23
+ };
@@ -0,0 +1,9 @@
1
+ import { loadMorePaginationMiddleware, pageNumberPaginationMiddleware } from './paginationMiddleware';
2
+
3
+ it('is defined', () => {
4
+ expect(loadMorePaginationMiddleware).toBeDefined();
5
+ });
6
+
7
+ it('is also defined', () => {
8
+ expect(pageNumberPaginationMiddleware).toBeDefined();
9
+ });
@@ -0,0 +1,9 @@
1
+ import { getKeyValueOr, putKeyValue } from '@openstax/ts-utils';
2
+ import { createPaginationMiddleware, loadMorePagination, pageNumberPagination } from '@openstax/ts-utils/pagination';
3
+ import { ApiRouteRequest } from '../../../core';
4
+
5
+ const getQueryParams = getKeyValueOr('queryStringParameters', {} as NonNullable<ApiRouteRequest['queryStringParameters']>);
6
+ const setUnusedQueryParams = putKeyValue('queryStringParameters');
7
+
8
+ export const loadMorePaginationMiddleware = createPaginationMiddleware<ApiRouteRequest>()({getQueryParams, setUnusedQueryParams, paginator: loadMorePagination});
9
+ export const pageNumberPaginationMiddleware = createPaginationMiddleware<ApiRouteRequest>()({getQueryParams, setUnusedQueryParams, paginator: pageNumberPagination});
@@ -0,0 +1,12 @@
1
+ import { AppServices } from '../../../core/types';
2
+ import { searchMiddleware } from './searchMiddleware';
3
+
4
+ describe('searchMiddleware', () => {
5
+ it('works', async () => {
6
+ const provider = {};
7
+ const createSearchProvider = jest.fn().mockReturnValue(provider);
8
+ const middleware = searchMiddleware({createSearchProvider} as unknown as AppServices)({});
9
+ expect(middleware).toHaveProperty('createSearchProvider');
10
+ expect(middleware.createSearchProvider).toBe(provider);
11
+ });
12
+ });
@@ -0,0 +1,21 @@
1
+ import { envConfig, replaceConfig } from '@openstax/ts-utils/config';
2
+ import { AppServices } from '../../../core/types';
3
+
4
+ const config = {
5
+ deployed: {
6
+ region: envConfig('OPEN_SEARCH_REGION', 'runtime', 'us-east-1'),
7
+ node: replaceConfig('https://[host]', {
8
+ '[host]': envConfig('OPEN_SEARCH_HOST', 'runtime'),
9
+ }),
10
+ },
11
+ local: { },
12
+ };
13
+
14
+ export const searchMiddleware = <M extends {}>(app: AppServices) => (middleware: M) => {
15
+ return {
16
+ ...middleware,
17
+ createSearchProvider: app.createSearchProvider(config),
18
+ };
19
+ };
20
+
21
+ export type CreateSearchProvider = ReturnType<ReturnType<typeof searchMiddleware>>['createSearchProvider'];
@@ -0,0 +1,21 @@
1
+ import { stubAuthProvider } from '@openstax/ts-utils/services/authProvider';
2
+ import { userRoleValidatorMiddleware } from './userRoleValidatorMiddleware';
3
+
4
+ describe('userRoleValidatorMiddleware', () => {
5
+ const envBack = process.env;
6
+
7
+ beforeEach(() => {
8
+ process.env = {...process.env};
9
+ });
10
+
11
+ afterEach(() => {
12
+ process.env = envBack;
13
+ });
14
+
15
+ it('works', async () => {
16
+ process.env.APPLICATION = 'test';
17
+ const authProvider = stubAuthProvider(undefined);
18
+ const middleware = userRoleValidatorMiddleware()({authProvider});
19
+ await expect(() => middleware.roleValidator.assertUserRole(['admin'])).rejects.toThrowErrorMatchingInlineSnapshot('"UnauthorizedError"');
20
+ });
21
+ });
@@ -0,0 +1,18 @@
1
+ import { envConfig } from '@openstax/ts-utils/config';
2
+ import { AuthProvider } from '@openstax/ts-utils/services/authProvider';
3
+ import { createUserRoleValidator } from '@openstax/ts-utils/services/authProvider/utils/userRoleValidator';
4
+
5
+ const config = {
6
+ application: envConfig('APPLICATION')
7
+ };
8
+
9
+ export const roleValidatorConfig = config;
10
+
11
+ export const userRoleValidatorMiddleware = () => {
12
+ return <M extends {authProvider: AuthProvider}>(middleware: M) => {
13
+ return {
14
+ ...middleware,
15
+ roleValidator: createUserRoleValidator(middleware.authProvider, config),
16
+ };
17
+ };
18
+ };
@@ -0,0 +1,30 @@
1
+ {
2
+ "compilerOptions": {
3
+ "incremental": true,
4
+ "allowJs": false,
5
+ "allowSyntheticDefaultImports": true,
6
+ "alwaysStrict": true,
7
+ "esModuleInterop": true,
8
+ "forceConsistentCasingInFileNames": true,
9
+ "isolatedModules": true,
10
+ "module": "commonjs",
11
+ "moduleResolution": "node",
12
+ "noEmit": true,
13
+ "noImplicitAny": true,
14
+ "listEmittedFiles": true,
15
+ "noUnusedLocals": true,
16
+ "noUnusedParameters": true,
17
+ "resolveJsonModule": true,
18
+ "skipLibCheck": true,
19
+ "strict": true,
20
+ "target": "es2019",
21
+ "lib": [
22
+ "es2020"
23
+ ],
24
+ "noFallthroughCasesInSwitch": true
25
+ },
26
+ "include": [
27
+ "src",
28
+ "script"
29
+ ]
30
+ }