@bitblit/ratchet-epsilon-common 4.0.85-alpha

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 (409) hide show
  1. package/CHANGELOG.md +177 -0
  2. package/License.txt +13 -0
  3. package/README.md +242 -0
  4. package/dist/cjs/background/background-dynamo-log-table-handler.js +38 -0
  5. package/dist/cjs/background/background-entry.js +2 -0
  6. package/dist/cjs/background/background-execution-event-type.js +11 -0
  7. package/dist/cjs/background/background-execution-event.js +2 -0
  8. package/dist/cjs/background/background-execution-listener.js +2 -0
  9. package/dist/cjs/background/background-handler.js +269 -0
  10. package/dist/cjs/background/background-http-adapter-handler.js +127 -0
  11. package/dist/cjs/background/background-meta-response-internal.js +2 -0
  12. package/dist/cjs/background/background-process-handling.js +8 -0
  13. package/dist/cjs/background/background-process-log-table-entry.js +2 -0
  14. package/dist/cjs/background/background-queue-response-internal.js +2 -0
  15. package/dist/cjs/background/background-validator.js +88 -0
  16. package/dist/cjs/background/epsilon-background-process-error.js +93 -0
  17. package/dist/cjs/background/internal-background-entry.js +2 -0
  18. package/dist/cjs/background/manager/abstract-background-manager.js +92 -0
  19. package/dist/cjs/background/manager/aws-sqs-sns-background-manager.js +153 -0
  20. package/dist/cjs/background/manager/background-manager-like.js +2 -0
  21. package/dist/cjs/background/manager/single-thread-local-background-manager.js +49 -0
  22. package/dist/cjs/background/s3-background-transaction-logger.js +54 -0
  23. package/dist/cjs/build/ratchet-epsilon-common-info.js +18 -0
  24. package/dist/cjs/built-in/background/echo-processor.js +18 -0
  25. package/dist/cjs/built-in/background/log-and-enqueue-echo-processor.js +16 -0
  26. package/dist/cjs/built-in/background/log-message-background-error-processor.js +10 -0
  27. package/dist/cjs/built-in/background/no-op-processor.js +13 -0
  28. package/dist/cjs/built-in/background/retry-processor.js +41 -0
  29. package/dist/cjs/built-in/background/sample-delay-processor.js +16 -0
  30. package/dist/cjs/built-in/background/sample-input-validated-processor-data.js +2 -0
  31. package/dist/cjs/built-in/background/sample-input-validated-processor.js +16 -0
  32. package/dist/cjs/built-in/built-in-trace-id-generators.js +25 -0
  33. package/dist/cjs/built-in/daemon/daemon-authorizer-function.js +2 -0
  34. package/dist/cjs/built-in/daemon/daemon-config.js +2 -0
  35. package/dist/cjs/built-in/daemon/daemon-group-selection-function.js +2 -0
  36. package/dist/cjs/built-in/daemon/daemon-handler.js +62 -0
  37. package/dist/cjs/built-in/daemon/daemon-process-state-list.js +2 -0
  38. package/dist/cjs/built-in/http/apollo-filter.js +63 -0
  39. package/dist/cjs/built-in/http/built-in-auth-filters.js +115 -0
  40. package/dist/cjs/built-in/http/built-in-authorizers.js +43 -0
  41. package/dist/cjs/built-in/http/built-in-filters.js +222 -0
  42. package/dist/cjs/built-in/http/built-in-handlers.js +73 -0
  43. package/dist/cjs/built-in/http/log-level-manipulation-filter.js +20 -0
  44. package/dist/cjs/built-in/http/run-handler-as-filter.js +64 -0
  45. package/dist/cjs/cli-bootstrap/epsilon-run-background-process-from-command-line-dry-run.js +20 -0
  46. package/dist/cjs/config/background/background-aws-config.js +2 -0
  47. package/dist/cjs/config/background/background-config.js +2 -0
  48. package/dist/cjs/config/background/background-error-processor.js +2 -0
  49. package/dist/cjs/config/background/background-processor.js +2 -0
  50. package/dist/cjs/config/background/background-transaction-log.js +2 -0
  51. package/dist/cjs/config/background/background-transaction-logger.js +2 -0
  52. package/dist/cjs/config/cron/abstract-cron-entry.js +2 -0
  53. package/dist/cjs/config/cron/cron-background-entry.js +2 -0
  54. package/dist/cjs/config/cron/cron-config.js +2 -0
  55. package/dist/cjs/config/dynamo-db-config.js +2 -0
  56. package/dist/cjs/config/epsilon-config.js +2 -0
  57. package/dist/cjs/config/epsilon-lambda-event-handler.js +2 -0
  58. package/dist/cjs/config/epsilon-logger-config.js +2 -0
  59. package/dist/cjs/config/generic-aws-event-handler-function.js +2 -0
  60. package/dist/cjs/config/http/authorizer-function.js +2 -0
  61. package/dist/cjs/config/http/epsilon-authorization-context.js +2 -0
  62. package/dist/cjs/config/http/extended-api-gateway-event.js +2 -0
  63. package/dist/cjs/config/http/filter-chain-context.js +2 -0
  64. package/dist/cjs/config/http/filter-function.js +2 -0
  65. package/dist/cjs/config/http/handler-function.js +2 -0
  66. package/dist/cjs/config/http/http-config.js +2 -0
  67. package/dist/cjs/config/http/http-processing-config.js +2 -0
  68. package/dist/cjs/config/http/mapped-http-processing-config.js +2 -0
  69. package/dist/cjs/config/http/null-returned-object-handling.js +9 -0
  70. package/dist/cjs/config/inter-api/inter-api-aws-config.js +2 -0
  71. package/dist/cjs/config/inter-api/inter-api-config.js +2 -0
  72. package/dist/cjs/config/inter-api/inter-api-process-mapping.js +2 -0
  73. package/dist/cjs/config/logging-trace-id-generator.js +2 -0
  74. package/dist/cjs/config/open-api/open-api-document-components.js +2 -0
  75. package/dist/cjs/config/open-api/open-api-document-path.js +2 -0
  76. package/dist/cjs/config/open-api/open-api-document.js +2 -0
  77. package/dist/cjs/config/s3-config.js +2 -0
  78. package/dist/cjs/config/sns-config.js +2 -0
  79. package/dist/cjs/epsilon-build-properties.js +28 -0
  80. package/dist/cjs/epsilon-constants.js +49 -0
  81. package/dist/cjs/epsilon-global-handler.js +155 -0
  82. package/dist/cjs/epsilon-instance.js +2 -0
  83. package/dist/cjs/epsilon-logging-extension-processor.js +19 -0
  84. package/dist/cjs/http/auth/api-gateway-adapter-authentication-handler.js +75 -0
  85. package/dist/cjs/http/auth/auth0-web-token-manipulator.js +62 -0
  86. package/dist/cjs/http/auth/basic-auth-token.js +2 -0
  87. package/dist/cjs/http/auth/google-web-token-manipulator.js +72 -0
  88. package/dist/cjs/http/auth/jwt-ratchet-local-web-token-manipulator.js +29 -0
  89. package/dist/cjs/http/auth/local-web-token-manipulator.js +74 -0
  90. package/dist/cjs/http/auth/web-token-manipulator.js +2 -0
  91. package/dist/cjs/http/error/bad-gateway.js +12 -0
  92. package/dist/cjs/http/error/bad-request-error.js +12 -0
  93. package/dist/cjs/http/error/conflict-error.js +12 -0
  94. package/dist/cjs/http/error/epsilon-http-error.js +132 -0
  95. package/dist/cjs/http/error/forbidden-error.js +12 -0
  96. package/dist/cjs/http/error/gateway-timeout.js +12 -0
  97. package/dist/cjs/http/error/method-not-allowed-error.js +12 -0
  98. package/dist/cjs/http/error/misconfigured-error.js +12 -0
  99. package/dist/cjs/http/error/not-found-error.js +12 -0
  100. package/dist/cjs/http/error/not-implemented.js +12 -0
  101. package/dist/cjs/http/error/request-timeout-error.js +12 -0
  102. package/dist/cjs/http/error/service-unavailable.js +12 -0
  103. package/dist/cjs/http/error/too-many-requests-error.js +12 -0
  104. package/dist/cjs/http/error/unauthorized-error.js +12 -0
  105. package/dist/cjs/http/event-util.js +180 -0
  106. package/dist/cjs/http/response-util.js +146 -0
  107. package/dist/cjs/http/route/epsilon-router.js +2 -0
  108. package/dist/cjs/http/route/extended-auth-response-context.js +2 -0
  109. package/dist/cjs/http/route/route-mapping.js +2 -0
  110. package/dist/cjs/http/route/route-validator-config.js +2 -0
  111. package/dist/cjs/http/route/router-util.js +238 -0
  112. package/dist/cjs/http/web-handler.js +122 -0
  113. package/dist/cjs/http/web-v2-handler.js +25 -0
  114. package/dist/cjs/index.js +136 -0
  115. package/dist/cjs/inter-api/inter-api-entry.js +2 -0
  116. package/dist/cjs/inter-api/inter-api-util.js +62 -0
  117. package/dist/cjs/inter-api-manager.js +67 -0
  118. package/dist/cjs/lambda-event-handler/cron-epsilon-lambda-event-handler.js +76 -0
  119. package/dist/cjs/lambda-event-handler/dynamo-epsilon-lambda-event-handler.js +36 -0
  120. package/dist/cjs/lambda-event-handler/generic-sns-epsilon-lambda-event-handler.js +32 -0
  121. package/dist/cjs/lambda-event-handler/inter-api-epsilon-lambda-event-handler.js +26 -0
  122. package/dist/cjs/lambda-event-handler/s3-epsilon-lambda-event-handler.js +44 -0
  123. package/dist/cjs/local-container-server.js +79 -0
  124. package/dist/cjs/local-server-cert.js +71 -0
  125. package/dist/cjs/local-server.js +145 -0
  126. package/dist/cjs/open-api-util/open-api-doc-modifications.js +2 -0
  127. package/dist/cjs/open-api-util/open-api-doc-modifier.js +83 -0
  128. package/dist/cjs/open-api-util/yaml-combiner.js +32 -0
  129. package/dist/cjs/run-background-process-from-command-line.js +37 -0
  130. package/dist/cjs/sample/sample-batch-only-local-server.js +19 -0
  131. package/dist/cjs/sample/sample-local-server.js +30 -0
  132. package/dist/cjs/sample/sample-server-components.js +197 -0
  133. package/dist/cjs/test-error-server.js +48 -0
  134. package/dist/cjs/util/aws-util.js +69 -0
  135. package/dist/cjs/util/context-util.js +104 -0
  136. package/dist/cjs/util/cron-util.js +72 -0
  137. package/dist/cjs/util/epsilon-config-parser.js +70 -0
  138. package/dist/es/background/background-dynamo-log-table-handler.js +33 -0
  139. package/dist/es/background/background-entry.js +1 -0
  140. package/dist/es/background/background-execution-event-type.js +8 -0
  141. package/dist/es/background/background-execution-event.js +1 -0
  142. package/dist/es/background/background-execution-listener.js +1 -0
  143. package/dist/es/background/background-handler.js +265 -0
  144. package/dist/es/background/background-http-adapter-handler.js +123 -0
  145. package/dist/es/background/background-meta-response-internal.js +1 -0
  146. package/dist/es/background/background-process-handling.js +5 -0
  147. package/dist/es/background/background-process-log-table-entry.js +1 -0
  148. package/dist/es/background/background-queue-response-internal.js +1 -0
  149. package/dist/es/background/background-validator.js +84 -0
  150. package/dist/es/background/epsilon-background-process-error.js +88 -0
  151. package/dist/es/background/internal-background-entry.js +1 -0
  152. package/dist/es/background/manager/abstract-background-manager.js +88 -0
  153. package/dist/es/background/manager/aws-sqs-sns-background-manager.js +149 -0
  154. package/dist/es/background/manager/background-manager-like.js +1 -0
  155. package/dist/es/background/manager/single-thread-local-background-manager.js +45 -0
  156. package/dist/es/background/s3-background-transaction-logger.js +49 -0
  157. package/dist/es/build/ratchet-epsilon-common-info.js +14 -0
  158. package/dist/es/built-in/background/echo-processor.js +14 -0
  159. package/dist/es/built-in/background/log-and-enqueue-echo-processor.js +12 -0
  160. package/dist/es/built-in/background/log-message-background-error-processor.js +6 -0
  161. package/dist/es/built-in/background/no-op-processor.js +9 -0
  162. package/dist/es/built-in/background/retry-processor.js +36 -0
  163. package/dist/es/built-in/background/sample-delay-processor.js +12 -0
  164. package/dist/es/built-in/background/sample-input-validated-processor-data.js +1 -0
  165. package/dist/es/built-in/background/sample-input-validated-processor.js +12 -0
  166. package/dist/es/built-in/built-in-trace-id-generators.js +21 -0
  167. package/dist/es/built-in/daemon/daemon-authorizer-function.js +1 -0
  168. package/dist/es/built-in/daemon/daemon-config.js +1 -0
  169. package/dist/es/built-in/daemon/daemon-group-selection-function.js +1 -0
  170. package/dist/es/built-in/daemon/daemon-handler.js +58 -0
  171. package/dist/es/built-in/daemon/daemon-process-state-list.js +1 -0
  172. package/dist/es/built-in/http/apollo-filter.js +58 -0
  173. package/dist/es/built-in/http/built-in-auth-filters.js +107 -0
  174. package/dist/es/built-in/http/built-in-authorizers.js +39 -0
  175. package/dist/es/built-in/http/built-in-filters.js +208 -0
  176. package/dist/es/built-in/http/built-in-handlers.js +69 -0
  177. package/dist/es/built-in/http/log-level-manipulation-filter.js +16 -0
  178. package/dist/es/built-in/http/run-handler-as-filter.js +60 -0
  179. package/dist/es/cli-bootstrap/epsilon-run-background-process-from-command-line-dry-run.js +17 -0
  180. package/dist/es/config/background/background-aws-config.js +1 -0
  181. package/dist/es/config/background/background-config.js +1 -0
  182. package/dist/es/config/background/background-error-processor.js +1 -0
  183. package/dist/es/config/background/background-processor.js +1 -0
  184. package/dist/es/config/background/background-transaction-log.js +1 -0
  185. package/dist/es/config/background/background-transaction-logger.js +1 -0
  186. package/dist/es/config/cron/abstract-cron-entry.js +1 -0
  187. package/dist/es/config/cron/cron-background-entry.js +1 -0
  188. package/dist/es/config/cron/cron-config.js +1 -0
  189. package/dist/es/config/dynamo-db-config.js +1 -0
  190. package/dist/es/config/epsilon-config.js +1 -0
  191. package/dist/es/config/epsilon-lambda-event-handler.js +1 -0
  192. package/dist/es/config/epsilon-logger-config.js +1 -0
  193. package/dist/es/config/generic-aws-event-handler-function.js +1 -0
  194. package/dist/es/config/http/authorizer-function.js +1 -0
  195. package/dist/es/config/http/epsilon-authorization-context.js +1 -0
  196. package/dist/es/config/http/extended-api-gateway-event.js +1 -0
  197. package/dist/es/config/http/filter-chain-context.js +1 -0
  198. package/dist/es/config/http/filter-function.js +1 -0
  199. package/dist/es/config/http/handler-function.js +1 -0
  200. package/dist/es/config/http/http-config.js +1 -0
  201. package/dist/es/config/http/http-processing-config.js +1 -0
  202. package/dist/es/config/http/mapped-http-processing-config.js +1 -0
  203. package/dist/es/config/http/null-returned-object-handling.js +6 -0
  204. package/dist/es/config/inter-api/inter-api-aws-config.js +1 -0
  205. package/dist/es/config/inter-api/inter-api-config.js +1 -0
  206. package/dist/es/config/inter-api/inter-api-process-mapping.js +1 -0
  207. package/dist/es/config/logging-trace-id-generator.js +1 -0
  208. package/dist/es/config/open-api/open-api-document-components.js +1 -0
  209. package/dist/es/config/open-api/open-api-document-path.js +1 -0
  210. package/dist/es/config/open-api/open-api-document.js +1 -0
  211. package/dist/es/config/s3-config.js +1 -0
  212. package/dist/es/config/sns-config.js +1 -0
  213. package/dist/es/epsilon-build-properties.js +24 -0
  214. package/dist/es/epsilon-constants.js +45 -0
  215. package/dist/es/epsilon-global-handler.js +149 -0
  216. package/dist/es/epsilon-instance.js +1 -0
  217. package/dist/es/epsilon-logging-extension-processor.js +15 -0
  218. package/dist/es/http/auth/api-gateway-adapter-authentication-handler.js +71 -0
  219. package/dist/es/http/auth/auth0-web-token-manipulator.js +56 -0
  220. package/dist/es/http/auth/basic-auth-token.js +1 -0
  221. package/dist/es/http/auth/google-web-token-manipulator.js +67 -0
  222. package/dist/es/http/auth/jwt-ratchet-local-web-token-manipulator.js +25 -0
  223. package/dist/es/http/auth/local-web-token-manipulator.js +70 -0
  224. package/dist/es/http/auth/web-token-manipulator.js +1 -0
  225. package/dist/es/http/error/bad-gateway.js +8 -0
  226. package/dist/es/http/error/bad-request-error.js +8 -0
  227. package/dist/es/http/error/conflict-error.js +8 -0
  228. package/dist/es/http/error/epsilon-http-error.js +127 -0
  229. package/dist/es/http/error/forbidden-error.js +8 -0
  230. package/dist/es/http/error/gateway-timeout.js +8 -0
  231. package/dist/es/http/error/method-not-allowed-error.js +8 -0
  232. package/dist/es/http/error/misconfigured-error.js +8 -0
  233. package/dist/es/http/error/not-found-error.js +8 -0
  234. package/dist/es/http/error/not-implemented.js +8 -0
  235. package/dist/es/http/error/request-timeout-error.js +8 -0
  236. package/dist/es/http/error/service-unavailable.js +8 -0
  237. package/dist/es/http/error/too-many-requests-error.js +8 -0
  238. package/dist/es/http/error/unauthorized-error.js +8 -0
  239. package/dist/es/http/event-util.js +175 -0
  240. package/dist/es/http/response-util.js +141 -0
  241. package/dist/es/http/route/epsilon-router.js +1 -0
  242. package/dist/es/http/route/extended-auth-response-context.js +1 -0
  243. package/dist/es/http/route/route-mapping.js +1 -0
  244. package/dist/es/http/route/route-validator-config.js +1 -0
  245. package/dist/es/http/route/router-util.js +233 -0
  246. package/dist/es/http/web-handler.js +116 -0
  247. package/dist/es/http/web-v2-handler.js +21 -0
  248. package/dist/es/index.js +133 -0
  249. package/dist/es/inter-api/inter-api-entry.js +1 -0
  250. package/dist/es/inter-api/inter-api-util.js +58 -0
  251. package/dist/es/inter-api-manager.js +63 -0
  252. package/dist/es/lambda-event-handler/cron-epsilon-lambda-event-handler.js +72 -0
  253. package/dist/es/lambda-event-handler/dynamo-epsilon-lambda-event-handler.js +32 -0
  254. package/dist/es/lambda-event-handler/generic-sns-epsilon-lambda-event-handler.js +28 -0
  255. package/dist/es/lambda-event-handler/inter-api-epsilon-lambda-event-handler.js +22 -0
  256. package/dist/es/lambda-event-handler/s3-epsilon-lambda-event-handler.js +40 -0
  257. package/dist/es/local-container-server.js +74 -0
  258. package/dist/es/local-server-cert.js +67 -0
  259. package/dist/es/local-server.js +140 -0
  260. package/dist/es/open-api-util/open-api-doc-modifications.js +1 -0
  261. package/dist/es/open-api-util/open-api-doc-modifier.js +78 -0
  262. package/dist/es/open-api-util/yaml-combiner.js +27 -0
  263. package/dist/es/run-background-process-from-command-line.js +32 -0
  264. package/dist/es/sample/sample-batch-only-local-server.js +17 -0
  265. package/dist/es/sample/sample-local-server.js +28 -0
  266. package/dist/es/sample/sample-server-components.js +192 -0
  267. package/dist/es/test-error-server.js +43 -0
  268. package/dist/es/util/aws-util.js +65 -0
  269. package/dist/es/util/context-util.js +95 -0
  270. package/dist/es/util/cron-util.js +68 -0
  271. package/dist/es/util/epsilon-config-parser.js +64 -0
  272. package/dist/tsconfig.cjs.tsbuildinfo +1 -0
  273. package/dist/tsconfig.es.tsbuildinfo +1 -0
  274. package/dist/tsconfig.types.tsbuildinfo +1 -0
  275. package/dist/types/background/background-dynamo-log-table-handler.d.ts +11 -0
  276. package/dist/types/background/background-entry.d.ts +4 -0
  277. package/dist/types/background/background-execution-event-type.d.ts +7 -0
  278. package/dist/types/background/background-execution-event.d.ts +8 -0
  279. package/dist/types/background/background-execution-listener.d.ts +5 -0
  280. package/dist/types/background/background-handler.d.ts +33 -0
  281. package/dist/types/background/background-http-adapter-handler.d.ts +26 -0
  282. package/dist/types/background/background-meta-response-internal.d.ts +5 -0
  283. package/dist/types/background/background-process-handling.d.ts +4 -0
  284. package/dist/types/background/background-process-log-table-entry.d.ts +11 -0
  285. package/dist/types/background/background-queue-response-internal.d.ts +8 -0
  286. package/dist/types/background/background-validator.d.ts +20 -0
  287. package/dist/types/background/epsilon-background-process-error.d.ts +30 -0
  288. package/dist/types/background/internal-background-entry.d.ts +7 -0
  289. package/dist/types/background/manager/abstract-background-manager.d.ts +26 -0
  290. package/dist/types/background/manager/aws-sqs-sns-background-manager.d.ts +30 -0
  291. package/dist/types/background/manager/background-manager-like.d.ts +24 -0
  292. package/dist/types/background/manager/single-thread-local-background-manager.d.ts +22 -0
  293. package/dist/types/background/s3-background-transaction-logger.d.ts +17 -0
  294. package/dist/types/build/ratchet-epsilon-common-info.d.ts +5 -0
  295. package/dist/types/built-in/background/echo-processor.d.ts +7 -0
  296. package/dist/types/built-in/background/log-and-enqueue-echo-processor.d.ts +6 -0
  297. package/dist/types/built-in/background/log-message-background-error-processor.d.ts +5 -0
  298. package/dist/types/built-in/background/no-op-processor.d.ts +6 -0
  299. package/dist/types/built-in/background/retry-processor.d.ts +16 -0
  300. package/dist/types/built-in/background/sample-delay-processor.d.ts +6 -0
  301. package/dist/types/built-in/background/sample-input-validated-processor-data.d.ts +4 -0
  302. package/dist/types/built-in/background/sample-input-validated-processor.d.ts +8 -0
  303. package/dist/types/built-in/built-in-trace-id-generators.d.ts +5 -0
  304. package/dist/types/built-in/daemon/daemon-authorizer-function.d.ts +5 -0
  305. package/dist/types/built-in/daemon/daemon-config.d.ts +8 -0
  306. package/dist/types/built-in/daemon/daemon-group-selection-function.d.ts +4 -0
  307. package/dist/types/built-in/daemon/daemon-handler.d.ts +22 -0
  308. package/dist/types/built-in/daemon/daemon-process-state-list.d.ts +8 -0
  309. package/dist/types/built-in/http/apollo-filter.d.ts +10 -0
  310. package/dist/types/built-in/http/built-in-auth-filters.d.ts +9 -0
  311. package/dist/types/built-in/http/built-in-authorizers.d.ts +8 -0
  312. package/dist/types/built-in/http/built-in-filters.d.ts +25 -0
  313. package/dist/types/built-in/http/built-in-handlers.d.ts +9 -0
  314. package/dist/types/built-in/http/log-level-manipulation-filter.d.ts +9 -0
  315. package/dist/types/built-in/http/run-handler-as-filter.d.ts +12 -0
  316. package/dist/types/cli-bootstrap/epsilon-run-background-process-from-command-line-dry-run.d.ts +2 -0
  317. package/dist/types/config/background/background-aws-config.d.ts +7 -0
  318. package/dist/types/config/background/background-config.d.ts +14 -0
  319. package/dist/types/config/background/background-error-processor.d.ts +4 -0
  320. package/dist/types/config/background/background-processor.d.ts +6 -0
  321. package/dist/types/config/background/background-transaction-log.d.ts +8 -0
  322. package/dist/types/config/background/background-transaction-logger.d.ts +5 -0
  323. package/dist/types/config/cron/abstract-cron-entry.d.ts +12 -0
  324. package/dist/types/config/cron/cron-background-entry.d.ts +15 -0
  325. package/dist/types/config/cron/cron-config.d.ts +6 -0
  326. package/dist/types/config/dynamo-db-config.d.ts +5 -0
  327. package/dist/types/config/epsilon-config.d.ts +20 -0
  328. package/dist/types/config/epsilon-lambda-event-handler.d.ts +7 -0
  329. package/dist/types/config/epsilon-logger-config.d.ts +12 -0
  330. package/dist/types/config/generic-aws-event-handler-function.d.ts +3 -0
  331. package/dist/types/config/http/authorizer-function.d.ts +6 -0
  332. package/dist/types/config/http/epsilon-authorization-context.d.ts +5 -0
  333. package/dist/types/config/http/extended-api-gateway-event.d.ts +7 -0
  334. package/dist/types/config/http/filter-chain-context.d.ts +14 -0
  335. package/dist/types/config/http/filter-function.d.ts +4 -0
  336. package/dist/types/config/http/handler-function.d.ts +5 -0
  337. package/dist/types/config/http/http-config.d.ts +15 -0
  338. package/dist/types/config/http/http-processing-config.d.ts +11 -0
  339. package/dist/types/config/http/mapped-http-processing-config.d.ts +7 -0
  340. package/dist/types/config/http/null-returned-object-handling.d.ts +5 -0
  341. package/dist/types/config/inter-api/inter-api-aws-config.d.ts +5 -0
  342. package/dist/types/config/inter-api/inter-api-config.d.ts +6 -0
  343. package/dist/types/config/inter-api/inter-api-process-mapping.d.ts +11 -0
  344. package/dist/types/config/logging-trace-id-generator.d.ts +4 -0
  345. package/dist/types/config/open-api/open-api-document-components.d.ts +4 -0
  346. package/dist/types/config/open-api/open-api-document-path.d.ts +2 -0
  347. package/dist/types/config/open-api/open-api-document.d.ts +6 -0
  348. package/dist/types/config/s3-config.d.ts +6 -0
  349. package/dist/types/config/sns-config.d.ts +5 -0
  350. package/dist/types/epsilon-build-properties.d.ts +9 -0
  351. package/dist/types/epsilon-constants.d.ts +16 -0
  352. package/dist/types/epsilon-global-handler.d.ts +23 -0
  353. package/dist/types/epsilon-instance.d.ts +19 -0
  354. package/dist/types/epsilon-logging-extension-processor.d.ts +5 -0
  355. package/dist/types/http/auth/api-gateway-adapter-authentication-handler.d.ts +18 -0
  356. package/dist/types/http/auth/auth0-web-token-manipulator.d.ts +13 -0
  357. package/dist/types/http/auth/basic-auth-token.d.ts +7 -0
  358. package/dist/types/http/auth/google-web-token-manipulator.d.ts +14 -0
  359. package/dist/types/http/auth/jwt-ratchet-local-web-token-manipulator.d.ts +13 -0
  360. package/dist/types/http/auth/local-web-token-manipulator.d.ts +20 -0
  361. package/dist/types/http/auth/web-token-manipulator.d.ts +7 -0
  362. package/dist/types/http/error/bad-gateway.d.ts +5 -0
  363. package/dist/types/http/error/bad-request-error.d.ts +5 -0
  364. package/dist/types/http/error/conflict-error.d.ts +5 -0
  365. package/dist/types/http/error/epsilon-http-error.d.ts +41 -0
  366. package/dist/types/http/error/forbidden-error.d.ts +5 -0
  367. package/dist/types/http/error/gateway-timeout.d.ts +5 -0
  368. package/dist/types/http/error/method-not-allowed-error.d.ts +5 -0
  369. package/dist/types/http/error/misconfigured-error.d.ts +5 -0
  370. package/dist/types/http/error/not-found-error.d.ts +5 -0
  371. package/dist/types/http/error/not-implemented.d.ts +5 -0
  372. package/dist/types/http/error/request-timeout-error.d.ts +5 -0
  373. package/dist/types/http/error/service-unavailable.d.ts +5 -0
  374. package/dist/types/http/error/too-many-requests-error.d.ts +5 -0
  375. package/dist/types/http/error/unauthorized-error.d.ts +5 -0
  376. package/dist/types/http/event-util.d.ts +47 -0
  377. package/dist/types/http/response-util.d.ts +11 -0
  378. package/dist/types/http/route/epsilon-router.d.ts +8 -0
  379. package/dist/types/http/route/extended-auth-response-context.d.ts +6 -0
  380. package/dist/types/http/route/route-mapping.d.ts +12 -0
  381. package/dist/types/http/route/route-validator-config.d.ts +5 -0
  382. package/dist/types/http/route/router-util.d.ts +26 -0
  383. package/dist/types/http/web-handler.d.ts +26 -0
  384. package/dist/types/http/web-v2-handler.d.ts +13 -0
  385. package/dist/types/index.d.ts +136 -0
  386. package/dist/types/inter-api/inter-api-entry.d.ts +7 -0
  387. package/dist/types/inter-api/inter-api-util.d.ts +10 -0
  388. package/dist/types/inter-api-manager.d.ts +17 -0
  389. package/dist/types/lambda-event-handler/cron-epsilon-lambda-event-handler.d.ts +14 -0
  390. package/dist/types/lambda-event-handler/dynamo-epsilon-lambda-event-handler.d.ts +11 -0
  391. package/dist/types/lambda-event-handler/generic-sns-epsilon-lambda-event-handler.d.ts +10 -0
  392. package/dist/types/lambda-event-handler/inter-api-epsilon-lambda-event-handler.d.ts +10 -0
  393. package/dist/types/lambda-event-handler/s3-epsilon-lambda-event-handler.d.ts +10 -0
  394. package/dist/types/local-container-server.d.ts +13 -0
  395. package/dist/types/local-server-cert.d.ts +5 -0
  396. package/dist/types/local-server.d.ts +19 -0
  397. package/dist/types/open-api-util/open-api-doc-modifications.d.ts +8 -0
  398. package/dist/types/open-api-util/open-api-doc-modifier.d.ts +10 -0
  399. package/dist/types/open-api-util/yaml-combiner.d.ts +3 -0
  400. package/dist/types/run-background-process-from-command-line.d.ts +13 -0
  401. package/dist/types/sample/sample-batch-only-local-server.d.ts +1 -0
  402. package/dist/types/sample/sample-local-server.d.ts +1 -0
  403. package/dist/types/sample/sample-server-components.d.ts +12 -0
  404. package/dist/types/test-error-server.d.ts +13 -0
  405. package/dist/types/util/aws-util.d.ts +8 -0
  406. package/dist/types/util/context-util.d.ts +33 -0
  407. package/dist/types/util/cron-util.d.ts +11 -0
  408. package/dist/types/util/epsilon-config-parser.d.ts +14 -0
  409. package/package.json +132 -0
@@ -0,0 +1,69 @@
1
+ import { StringRatchet } from '@bitblit/ratchet-common';
2
+ import { Logger } from '@bitblit/ratchet-common';
3
+ import { NumberRatchet } from '@bitblit/ratchet-common';
4
+ import { BadRequestError } from '../../http/error/bad-request-error';
5
+ import { EpsilonHttpError } from '../../http/error/epsilon-http-error';
6
+ import { UnauthorizedError } from '../../http/error/unauthorized-error';
7
+ import { NotFoundError } from '../../http/error/not-found-error';
8
+ import { ForbiddenError } from '../../http/error/forbidden-error';
9
+ import { NotImplemented } from '../../http/error/not-implemented';
10
+ import { MisconfiguredError } from '../../http/error/misconfigured-error';
11
+ export class BuiltInHandlers {
12
+ static async expectedHandledByFilter(evt, flag) {
13
+ throw new MisconfiguredError().withFormattedErrorMessage('Should not happen - it was expected that route %s would be handled by a filter', evt.path);
14
+ }
15
+ static async handleNotImplemented(evt, flag) {
16
+ Logger.info('A request was made to %s with body %j - not yet implemented', evt.path, evt.body);
17
+ const rval = {
18
+ time: new Date().toLocaleString(),
19
+ path: evt.path,
20
+ message: 'NOT IMPLEMENTED YET',
21
+ };
22
+ return rval;
23
+ }
24
+ static async sample(evt, flag, context) {
25
+ const rval = {
26
+ time: new Date().toLocaleString(),
27
+ evt: evt,
28
+ pad: StringRatchet.createRandomHexString(2000),
29
+ flag: flag,
30
+ };
31
+ if (context) {
32
+ rval['context'] = context;
33
+ }
34
+ const errNumber = NumberRatchet.safeNumber(evt.queryStringParameters['error']);
35
+ if (errNumber) {
36
+ switch (errNumber) {
37
+ case -1:
38
+ throw new Error('Test random failure');
39
+ case 400:
40
+ throw new BadRequestError('Bad request error');
41
+ case 401:
42
+ throw new UnauthorizedError('Unauthorized error');
43
+ case 403:
44
+ throw new ForbiddenError('Forbidden error');
45
+ case 404:
46
+ throw new NotFoundError('Not Found error');
47
+ case 501:
48
+ throw new NotImplemented('Not Implemented');
49
+ default:
50
+ throw new EpsilonHttpError()
51
+ .withFormattedErrorMessage('Default error - %s', errNumber)
52
+ .withHttpStatusCode(500)
53
+ .withDetails({ src: errNumber })
54
+ .withEndUserErrors(['msg1', 'msg2']);
55
+ }
56
+ }
57
+ let test = StringRatchet.trimToNull(evt.queryStringParameters['test']);
58
+ if (test) {
59
+ test = test.toLowerCase();
60
+ if (test === 'null') {
61
+ return null;
62
+ }
63
+ }
64
+ return rval;
65
+ }
66
+ static async defaultErrorProcessor(event, err, cfg) {
67
+ Logger.warn('Unhandled error (in promise catch) : %s \nStack was: %s\nEvt was: %j\nConfig was: %j', err.message, err.stack, event, cfg);
68
+ }
69
+ }
@@ -0,0 +1,16 @@
1
+ import { Logger } from '@bitblit/ratchet-common';
2
+ export class LogLevelManipulationFilter {
3
+ static async setLogLevelForTransaction(fCtx) {
4
+ LogLevelManipulationFilter.LOG_LEVEL_BEFORE_CHANGE = Logger.getLevel();
5
+ return true;
6
+ }
7
+ static async clearLogLevelForTransaction(fCtx) {
8
+ if (LogLevelManipulationFilter.LOG_LEVEL_BEFORE_CHANGE) {
9
+ Logger.setLevel(LogLevelManipulationFilter.LOG_LEVEL_BEFORE_CHANGE);
10
+ LogLevelManipulationFilter.LOG_LEVEL_BEFORE_CHANGE = null;
11
+ Logger.updateTracePrefix(null);
12
+ }
13
+ return true;
14
+ }
15
+ }
16
+ LogLevelManipulationFilter.LOG_LEVEL_BEFORE_CHANGE = null;
@@ -0,0 +1,60 @@
1
+ import { Logger } from '@bitblit/ratchet-common';
2
+ import { PromiseRatchet } from '@bitblit/ratchet-common';
3
+ import { TimeoutToken } from '@bitblit/ratchet-common';
4
+ import { RequestTimeoutError } from '../../http/error/request-timeout-error';
5
+ import { ResponseUtil } from '../../http/response-util';
6
+ import { NotFoundError } from '../../http/error/not-found-error';
7
+ import { NullReturnedObjectHandling } from '../../config/http/null-returned-object-handling';
8
+ import { EpsilonHttpError } from '../../http/error/epsilon-http-error';
9
+ export class RunHandlerAsFilter {
10
+ static async runHandler(fCtx, rm) {
11
+ const handler = RunHandlerAsFilter.findHandler(rm, fCtx.event, fCtx.context);
12
+ Logger.debug('Processing event with epsilon: %j', fCtx.event);
13
+ let tmp = await handler;
14
+ if (TimeoutToken.isTimeoutToken(tmp)) {
15
+ tmp.writeToLog();
16
+ throw new RequestTimeoutError('Timed out');
17
+ }
18
+ Logger.debug('Initial return value : %j', tmp);
19
+ tmp = RunHandlerAsFilter.applyNullReturnedObjectHandling(tmp, rm.mapping.metaProcessingConfig.nullReturnedObjectHandling);
20
+ fCtx.rawResult = tmp;
21
+ fCtx.result = ResponseUtil.coerceToProxyResult(tmp);
22
+ return true;
23
+ }
24
+ static applyNullReturnedObjectHandling(result, handling) {
25
+ let rval = result;
26
+ if (result === null || result === undefined) {
27
+ if (handling === NullReturnedObjectHandling.Error) {
28
+ Logger.error('Null object returned and Error specified, throwing 500');
29
+ throw new EpsilonHttpError('Null object').withHttpStatusCode(500);
30
+ }
31
+ else if (handling === NullReturnedObjectHandling.Return404NotFoundResponse) {
32
+ throw new NotFoundError('Resource not found');
33
+ }
34
+ else if (handling === NullReturnedObjectHandling.ConvertToEmptyString) {
35
+ Logger.warn('Null object returned from handler and convert not specified, converting to empty string');
36
+ rval = '';
37
+ }
38
+ else {
39
+ throw new EpsilonHttpError('Cant happen - failed enum check').withHttpStatusCode(500);
40
+ }
41
+ }
42
+ return rval;
43
+ }
44
+ static async findHandler(rm, event, context, add404OnMissing = true) {
45
+ let rval = null;
46
+ if (rm) {
47
+ event.pathParameters = Object.assign({}, event.pathParameters, rm.parsed);
48
+ rval = PromiseRatchet.timeout(rm.mapping.function(event, context), 'Timed out after ' + rm.mapping.metaProcessingConfig.timeoutMS + ' ms. Request was ' + JSON.stringify(event), rm.mapping.metaProcessingConfig.timeoutMS);
49
+ }
50
+ else if (add404OnMissing) {
51
+ throw new NotFoundError('No such endpoint');
52
+ }
53
+ return rval;
54
+ }
55
+ static addRunHandlerAsFilterToList(filters, rm) {
56
+ if (filters) {
57
+ filters.push((fCtx) => RunHandlerAsFilter.runHandler(fCtx, rm));
58
+ }
59
+ }
60
+ }
@@ -0,0 +1,17 @@
1
+ #!/usr/bin/env node
2
+ import { RunBackgroundProcessFromCommandLine } from '../run-background-process-from-command-line';
3
+ import { CliRatchet } from '@bitblit/ratchet-node-only';
4
+ import { Logger } from '@bitblit/ratchet-common';
5
+ if (process?.argv?.length &&
6
+ CliRatchet.isCalledFromCLI([
7
+ 'epsilon-run-background-process-from-command-line-dry-run.js',
8
+ 'epsilon-run-background-process-from-command-line-dry-run',
9
+ ])) {
10
+ RunBackgroundProcessFromCommandLine.processBackgroundCliRequest(null, true)
11
+ .then((out) => {
12
+ Logger.info('Result : %s', out);
13
+ })
14
+ .catch((err) => Logger.error('Failed : %s', err));
15
+ }
16
+ else {
17
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,6 @@
1
+ export var NullReturnedObjectHandling;
2
+ (function (NullReturnedObjectHandling) {
3
+ NullReturnedObjectHandling["Error"] = "Error";
4
+ NullReturnedObjectHandling["ConvertToEmptyString"] = "ConvertToEmptyString";
5
+ NullReturnedObjectHandling["Return404NotFoundResponse"] = "Return404NotFoundResponse";
6
+ })(NullReturnedObjectHandling || (NullReturnedObjectHandling = {}));
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,24 @@
1
+ import { StringRatchet } from '@bitblit/ratchet-common';
2
+ export class EpsilonBuildProperties {
3
+ constructor() { }
4
+ static get buildVersion() {
5
+ return 'LOCAL-SNAPSHOT';
6
+ }
7
+ static get buildHash() {
8
+ return 'LOCAL-HASH';
9
+ }
10
+ static get buildBranch() {
11
+ return 'LOCAL-BRANCH';
12
+ }
13
+ static get buildTag() {
14
+ return 'LOCAL-TAG';
15
+ }
16
+ static get buildBranchOrTag() {
17
+ return StringRatchet.trimToNull(EpsilonBuildProperties.buildBranch)
18
+ ? 'BRANCH:' + EpsilonBuildProperties.buildBranch
19
+ : 'TAG:' + EpsilonBuildProperties.buildTag;
20
+ }
21
+ static get buildTime() {
22
+ return 'LOCAL-TIME';
23
+ }
24
+ }
@@ -0,0 +1,45 @@
1
+ import { Logger } from '@bitblit/ratchet-common';
2
+ export class EpsilonConstants {
3
+ static load(filePath, className) {
4
+ Logger.info('Searching for %s : %s : %s', filePath, className, __dirname);
5
+ let rval = null;
6
+ const val = require(filePath);
7
+ if (val) {
8
+ Logger.debug('Found %s - pulling object : %j : %s', filePath, Object.keys(val), className);
9
+ rval = val[className];
10
+ }
11
+ return rval;
12
+ }
13
+ static async findDynamicImportEpsilonGlobalHandlerProvider() {
14
+ const importPath = process.env[EpsilonConstants.EPSILON_FINDER_DYNAMIC_IMPORT_PATH_ENV_NAME] ||
15
+ EpsilonConstants.DEFAULT_EPSILON_FINDER_DYNAMIC_IMPORT_PATH;
16
+ const fnName = process.env[EpsilonConstants.EPSILON_FINDER_FUNCTION_NAME_ENV_NAME] || EpsilonConstants.DEFAULT_EPSILON_FINDER_FUNCTION_NAME;
17
+ Logger.debug('Using epsilon finder dynamic import path : %s / %s', importPath, fnName);
18
+ let provider = null;
19
+ try {
20
+ provider = this.load(importPath, fnName);
21
+ }
22
+ catch (err) {
23
+ Logger.error('Error loading provider : %s / %s : %s', importPath, fnName, err, err);
24
+ }
25
+ let rval = null;
26
+ if (provider) {
27
+ Logger.debug('Type2 is : %s', typeof provider);
28
+ Logger.info('Got3 : %s : %s', provider, typeof provider);
29
+ rval = provider();
30
+ Logger.info('Rval3 is %s', rval);
31
+ }
32
+ return rval;
33
+ }
34
+ constructor() { }
35
+ }
36
+ EpsilonConstants.EPSILON_FINDER_DYNAMIC_IMPORT_PATH_ENV_NAME = 'EPSILON_FINDER_DYNAMIC_IMPORT_PATH';
37
+ EpsilonConstants.EPSILON_FINDER_FUNCTION_NAME_ENV_NAME = 'EPSILON_FINDER_FUNCTION_NAME';
38
+ EpsilonConstants.DEFAULT_EPSILON_FINDER_DYNAMIC_IMPORT_PATH = 'epsilon-global-handler-provider.js';
39
+ EpsilonConstants.DEFAULT_EPSILON_FINDER_FUNCTION_NAME = 'findEpsilonGlobalHandler';
40
+ EpsilonConstants.AUTH_HEADER_PREFIX = 'Bearer ';
41
+ EpsilonConstants.AUTH_HEADER_NAME = 'Authorization';
42
+ EpsilonConstants.BACKGROUND_SQS_TYPE_FIELD = 'BACKGROUND_TYPE';
43
+ EpsilonConstants.BACKGROUND_SNS_START_MARKER = 'BACKGROUND_START_MARKER';
44
+ EpsilonConstants.BACKGROUND_SNS_IMMEDIATE_RUN_FLAG = 'BACKGROUND_IMMEDIATE_RUN_FLAG';
45
+ EpsilonConstants.INTER_API_SNS_EVENT = 'EPSILON_INTER_API_EVENT';
@@ -0,0 +1,149 @@
1
+ import { Logger } from '@bitblit/ratchet-common';
2
+ import { EventUtil } from './http/event-util';
3
+ import { TimeoutToken } from '@bitblit/ratchet-common';
4
+ import { PromiseRatchet } from '@bitblit/ratchet-common';
5
+ import { ResponseUtil } from './http/response-util';
6
+ import { EpsilonHttpError } from './http/error/epsilon-http-error';
7
+ import { RequestTimeoutError } from './http/error/request-timeout-error';
8
+ import { ErrorRatchet, LoggerLevelName, LoggerOutputFunction, LogMessageFormatType, } from '@bitblit/ratchet-common';
9
+ import { ContextUtil } from './util/context-util';
10
+ import { WebV2Handler } from './http/web-v2-handler';
11
+ import { InterApiEpsilonLambdaEventHandler } from './lambda-event-handler/inter-api-epsilon-lambda-event-handler';
12
+ import { GenericSnsEpsilonLambdaEventHandler } from './lambda-event-handler/generic-sns-epsilon-lambda-event-handler';
13
+ import { CronEpsilonLambdaEventHandler } from './lambda-event-handler/cron-epsilon-lambda-event-handler';
14
+ import { S3EpsilonLambdaEventHandler } from './lambda-event-handler/s3-epsilon-lambda-event-handler';
15
+ import { DynamoEpsilonLambdaEventHandler } from './lambda-event-handler/dynamo-epsilon-lambda-event-handler';
16
+ import { EpsilonLoggingExtensionProcessor } from './epsilon-logging-extension-processor';
17
+ export class EpsilonGlobalHandler {
18
+ static set globalInstanceProvider(input) {
19
+ EpsilonGlobalHandler.GLOBAL_INSTANCE_PROVIDER = input;
20
+ }
21
+ static get globalInstanceProvider() {
22
+ return EpsilonGlobalHandler.GLOBAL_INSTANCE_PROVIDER;
23
+ }
24
+ constructor(_epsilon) {
25
+ this._epsilon = _epsilon;
26
+ this.handlers = null;
27
+ if (!EpsilonGlobalHandler.LOGGER_CONFIGURED) {
28
+ EpsilonGlobalHandler.configureDefaultLogger();
29
+ Logger.info('EpsilonLoggingConfiguration:Default logger configured');
30
+ }
31
+ else {
32
+ Logger.info('EpsilonLoggingConfiguration:Skipping default logger config - already configured');
33
+ }
34
+ this.handlers = [
35
+ this._epsilon.webHandler,
36
+ new WebV2Handler(this._epsilon.webHandler),
37
+ this._epsilon.backgroundHandler,
38
+ new InterApiEpsilonLambdaEventHandler(this._epsilon),
39
+ new GenericSnsEpsilonLambdaEventHandler(this._epsilon),
40
+ new CronEpsilonLambdaEventHandler(this._epsilon),
41
+ new S3EpsilonLambdaEventHandler(this._epsilon),
42
+ new DynamoEpsilonLambdaEventHandler(this._epsilon),
43
+ ];
44
+ }
45
+ static configureDefaultLogger(overrides) {
46
+ const output = overrides ? Object.assign({}, overrides) : {};
47
+ output.initialLevel = output.initialLevel ?? LoggerLevelName.info;
48
+ output.formatType = output.formatType ?? LogMessageFormatType.StructuredJson;
49
+ output.globalVars = output.globalVars ?? {};
50
+ output.outputFunction = output.outputFunction ?? LoggerOutputFunction.StdOut;
51
+ output.ringBufferSize = output.ringBufferSize ?? 0;
52
+ const src = output.preProcessors || [];
53
+ output.preProcessors = src.concat([new EpsilonLoggingExtensionProcessor()]);
54
+ const pre = Logger.getOptions();
55
+ Logger.changeDefaultOptions(output, true);
56
+ const post = Logger.getOptions();
57
+ EpsilonGlobalHandler.LOGGER_CONFIGURED = true;
58
+ Logger.info('EpsilonLoggingConfiguration: Updated');
59
+ Logger.dumpOptionsIntoLog();
60
+ }
61
+ get epsilon() {
62
+ return this._epsilon;
63
+ }
64
+ async processSingleBackgroundByParts(type, data, overrideTraceId, overrideTraceDepth) {
65
+ return this.processSingleBackgroundEntry(this._epsilon.backgroundManager.createEntry(type, data), overrideTraceId, overrideTraceDepth);
66
+ }
67
+ async processSingleBackgroundEntry(e, overrideTraceId, overrideTraceDepth) {
68
+ let rval = false;
69
+ if (e?.type) {
70
+ const internal = this._epsilon.backgroundManager.wrapEntryForInternal(e, overrideTraceId, overrideTraceDepth);
71
+ rval = await this._epsilon.backgroundHandler.processSingleBackgroundEntry(internal);
72
+ Logger.info('Direct processed request %j to %s', e, rval);
73
+ }
74
+ else {
75
+ Logger.error('Cannot process null/unnamed background entry');
76
+ }
77
+ return rval;
78
+ }
79
+ async lambdaHandler(event, context) {
80
+ let rval = null;
81
+ try {
82
+ if (this.epsilon.config.disableLastResortTimeout || !context || !context.getRemainingTimeInMillis()) {
83
+ rval = await this.innerLambdaHandler(event, context);
84
+ }
85
+ else {
86
+ const tmp = await PromiseRatchet.timeout(this.innerLambdaHandler(event, context), 'EpsilonLastResortTimeout', context.getRemainingTimeInMillis() - 1000);
87
+ if (TimeoutToken.isTimeoutToken(tmp)) {
88
+ tmp.writeToLog();
89
+ rval = ResponseUtil.errorResponse(EpsilonHttpError.wrapError(new RequestTimeoutError('Timed out')));
90
+ }
91
+ else {
92
+ rval = tmp;
93
+ }
94
+ }
95
+ }
96
+ finally {
97
+ ContextUtil.clearContext();
98
+ }
99
+ return rval;
100
+ }
101
+ async innerLambdaHandler(event, context) {
102
+ ContextUtil.initContext(this._epsilon, event, context, 'TBD');
103
+ let rval = null;
104
+ let errorHandler = EpsilonGlobalHandler.defaultProcessUncaughtError;
105
+ try {
106
+ if (!this._epsilon) {
107
+ Logger.error('Config not found, abandoning');
108
+ return false;
109
+ }
110
+ const logLevel = EventUtil.calcLogLevelViaEventOrEnvParam(Logger.getLevel(), event, this._epsilon.config.loggerConfig);
111
+ Logger.setLevel(logLevel);
112
+ if (this._epsilon.config.loggerConfig &&
113
+ this._epsilon.config.loggerConfig.queryParamTracePrefixName &&
114
+ event.queryStringParameters &&
115
+ event.queryStringParameters[this._epsilon.config.loggerConfig.queryParamTracePrefixName]) {
116
+ Logger.info('Setting trace prefix to %s', event.queryStringParameters[this._epsilon.config.loggerConfig.queryParamTracePrefixName]);
117
+ Logger.updateTracePrefix(event.queryStringParameters[this._epsilon.config.loggerConfig.queryParamTracePrefixName]);
118
+ }
119
+ let found = false;
120
+ for (let i = 0; i < this.handlers.length && !found; i++) {
121
+ const handler = this.handlers[i];
122
+ if (handler.handlesEvent(event)) {
123
+ found = true;
124
+ errorHandler = handler.processUncaughtError || errorHandler;
125
+ const label = handler.extractLabel(event, context);
126
+ ContextUtil.setProcessLabel(label);
127
+ Logger.logByLevel(this._epsilon?.config?.loggerConfig?.epsilonStartEndMessageLogLevel || LoggerLevelName.info, 'EvtStart: %s', label);
128
+ rval = await handler.processEvent(event, context);
129
+ Logger.logByLevel(this._epsilon?.config?.loggerConfig?.epsilonStartEndMessageLogLevel || LoggerLevelName.info, 'EvtEnd: %s', label);
130
+ Logger.silly('EvtEnd:Value: %s Value: %j', label, rval);
131
+ }
132
+ }
133
+ }
134
+ catch (err) {
135
+ rval = await errorHandler(event, context, err);
136
+ }
137
+ return rval;
138
+ }
139
+ static async defaultProcessUncaughtError(event, context, err) {
140
+ Logger.error('Error slipped out to outer edge (Default). Logging and returning log : %s', err, err);
141
+ const rval = {
142
+ statusCode: 500,
143
+ body: JSON.stringify({ error: ErrorRatchet.safeStringifyErr(err) }),
144
+ isBase64Encoded: false,
145
+ };
146
+ return rval;
147
+ }
148
+ }
149
+ EpsilonGlobalHandler.LOGGER_CONFIGURED = false;
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,15 @@
1
+ import { ContextUtil } from './util/context-util';
2
+ export class EpsilonLoggingExtensionProcessor {
3
+ process(msg) {
4
+ msg.params = Object.assign({}, msg.params || {}, ContextUtil.fetchLogVariables());
5
+ msg.params['tester'] = Date.now();
6
+ msg.params['awsRequestId'] = ContextUtil.currentRequestId();
7
+ msg.params['traceId'] = ContextUtil.currentTraceId();
8
+ msg.params['traceDepth'] = ContextUtil.currentTraceDepth();
9
+ msg.params['procLabel'] = ContextUtil.currentProcessLabel();
10
+ return msg;
11
+ }
12
+ label() {
13
+ return 'EpsilonLoggingExtensionProcessor';
14
+ }
15
+ }
@@ -0,0 +1,71 @@
1
+ import { Logger } from '@bitblit/ratchet-common';
2
+ import { LocalWebTokenManipulator } from './local-web-token-manipulator';
3
+ import { EpsilonConstants } from '../../epsilon-constants';
4
+ export class ApiGatewayAdapterAuthenticationHandler {
5
+ constructor(issuer, encryptionKeys) {
6
+ this.webTokenManipulator = new LocalWebTokenManipulator([encryptionKeys], issuer);
7
+ }
8
+ lambdaHandler(event, context, callback) {
9
+ Logger.info('Got event : %j', event);
10
+ const srcString = ApiGatewayAdapterAuthenticationHandler.extractTokenStringFromAuthorizerEvent(event);
11
+ if (srcString) {
12
+ const methodArn = event.methodArn;
13
+ this.webTokenManipulator
14
+ .parseAndValidateJWTStringAsync(srcString)
15
+ .then((parsed) => {
16
+ if (parsed) {
17
+ callback(null, this.createPolicy(methodArn, srcString, parsed));
18
+ }
19
+ else {
20
+ Logger.info('Invalid bearer token');
21
+ callback(new Error('Unauthorized'));
22
+ }
23
+ })
24
+ .catch((err) => {
25
+ Logger.error('Exception parsing token : %s', err);
26
+ callback(new Error('Unauthorized'));
27
+ });
28
+ }
29
+ else {
30
+ Logger.info('Token not supplied');
31
+ callback(new Error('Unauthorized'));
32
+ }
33
+ }
34
+ createPolicy(methodArn, srcString, userOb) {
35
+ const tmp = methodArn.split(':');
36
+ const apiGatewayArnTmp = tmp[5].split('/');
37
+ const awsAccountId = tmp[4];
38
+ const region = tmp[3];
39
+ const stage = apiGatewayArnTmp[1];
40
+ const restApiId = apiGatewayArnTmp[0];
41
+ const response = {
42
+ principalId: 'user',
43
+ policyDocument: {
44
+ Version: '2012-10-17',
45
+ Statement: [
46
+ {
47
+ Action: 'execute-api:Invoke',
48
+ Effect: 'Allow',
49
+ Resource: ['arn:aws:execute-api:' + region + ':' + awsAccountId + ':' + restApiId + '/' + stage + '/*/*'],
50
+ },
51
+ ],
52
+ },
53
+ context: {
54
+ userJSON: JSON.stringify(userOb),
55
+ srcData: srcString,
56
+ },
57
+ };
58
+ return response;
59
+ }
60
+ static extractTokenStringFromAuthorizerEvent(event) {
61
+ Logger.silly('Extracting token from event : %j', event);
62
+ let rval = null;
63
+ if (event && event.authorizationToken) {
64
+ const token = event.authorizationToken;
65
+ if (token && token.startsWith(EpsilonConstants.AUTH_HEADER_PREFIX)) {
66
+ rval = token.substring(EpsilonConstants.AUTH_HEADER_PREFIX.length);
67
+ }
68
+ }
69
+ return rval;
70
+ }
71
+ }
@@ -0,0 +1,56 @@
1
+ import { Logger, StringRatchet } from '@bitblit/ratchet-common';
2
+ import jwt from 'jsonwebtoken';
3
+ import jwks from 'jwks-rsa';
4
+ export class Auth0WebTokenManipulator {
5
+ constructor(clientId, jwksUri, issuer) {
6
+ this.clientId = clientId;
7
+ this.jwksUri = jwksUri;
8
+ this.issuer = issuer;
9
+ }
10
+ async extractTokenFromAuthorizationHeader(authHeader) {
11
+ let tokenString = StringRatchet.trimToEmpty(authHeader);
12
+ if (tokenString.toLowerCase().startsWith('bearer ')) {
13
+ tokenString = tokenString.substring(7);
14
+ }
15
+ const validated = tokenString ? await this.parseAndValidateAuth0Token(tokenString, false) : null;
16
+ return validated;
17
+ }
18
+ async parseAndValidateAuth0Token(auth0Token, allowExpired = false) {
19
+ Logger.debug('Validating Auth0 token : %s', StringRatchet.obscure(auth0Token, 4));
20
+ const fullToken = jwt.decode(auth0Token, { complete: true });
21
+ const kid = fullToken?.header?.kid;
22
+ const nowEpochSeconds = Math.floor(new Date().getTime() / 1000);
23
+ const pubKey = await this.fetchSigningKey(kid);
24
+ const validated = jwt.verify(auth0Token, pubKey, {
25
+ audience: this.clientId,
26
+ issuer: this.issuer,
27
+ ignoreExpiration: allowExpired,
28
+ clockTimestamp: nowEpochSeconds,
29
+ });
30
+ return validated;
31
+ }
32
+ async fetchSigningKey(kid) {
33
+ const jClient = await this.fetchJwksClient();
34
+ return new Promise((res, rej) => {
35
+ jClient.getSigningKey(kid, (err, key) => {
36
+ if (err) {
37
+ rej(err);
38
+ }
39
+ else {
40
+ res(key.publicKey || key.rsaPublicKey);
41
+ }
42
+ });
43
+ });
44
+ }
45
+ async fetchJwksClient() {
46
+ if (!this.jwksClient) {
47
+ this.jwksClient = jwks({
48
+ cache: true,
49
+ cacheMaxEntries: 5,
50
+ cacheMaxAge: 1000 * 60 * 60 * 10,
51
+ jwksUri: this.jwksUri,
52
+ });
53
+ }
54
+ return this.jwksClient;
55
+ }
56
+ }
@@ -0,0 +1 @@
1
+ export {};