@xemahq/platform-common 0.1.3

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 (460) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +64 -0
  3. package/dist/index.d.ts +35 -0
  4. package/dist/index.d.ts.map +1 -0
  5. package/dist/index.js +74 -0
  6. package/dist/index.js.map +1 -0
  7. package/dist/lib/advisory-lock.d.ts +9 -0
  8. package/dist/lib/advisory-lock.d.ts.map +1 -0
  9. package/dist/lib/advisory-lock.js +25 -0
  10. package/dist/lib/advisory-lock.js.map +1 -0
  11. package/dist/lib/agent-session.types.d.ts +171 -0
  12. package/dist/lib/agent-session.types.d.ts.map +1 -0
  13. package/dist/lib/agent-session.types.js +156 -0
  14. package/dist/lib/agent-session.types.js.map +1 -0
  15. package/dist/lib/approval-mode.d.ts +9 -0
  16. package/dist/lib/approval-mode.d.ts.map +1 -0
  17. package/dist/lib/approval-mode.js +27 -0
  18. package/dist/lib/approval-mode.js.map +1 -0
  19. package/dist/lib/briefcase/index.d.ts +18 -0
  20. package/dist/lib/briefcase/index.d.ts.map +1 -0
  21. package/dist/lib/briefcase/index.js +72 -0
  22. package/dist/lib/briefcase/index.js.map +1 -0
  23. package/dist/lib/deliverable-output-contract.d.ts +87 -0
  24. package/dist/lib/deliverable-output-contract.d.ts.map +1 -0
  25. package/dist/lib/deliverable-output-contract.js +119 -0
  26. package/dist/lib/deliverable-output-contract.js.map +1 -0
  27. package/dist/lib/derive-required-workspace-slots.d.ts +12 -0
  28. package/dist/lib/derive-required-workspace-slots.d.ts.map +1 -0
  29. package/dist/lib/derive-required-workspace-slots.js +51 -0
  30. package/dist/lib/derive-required-workspace-slots.js.map +1 -0
  31. package/dist/lib/encryption.d.ts +5 -0
  32. package/dist/lib/encryption.d.ts.map +1 -0
  33. package/dist/lib/encryption.js +40 -0
  34. package/dist/lib/encryption.js.map +1 -0
  35. package/dist/lib/enums/artifact-versioning-mode.d.ts +6 -0
  36. package/dist/lib/enums/artifact-versioning-mode.d.ts.map +1 -0
  37. package/dist/lib/enums/artifact-versioning-mode.js +10 -0
  38. package/dist/lib/enums/artifact-versioning-mode.js.map +1 -0
  39. package/dist/lib/enums/index.d.ts +5 -0
  40. package/dist/lib/enums/index.d.ts.map +1 -0
  41. package/dist/lib/enums/index.js +21 -0
  42. package/dist/lib/enums/index.js.map +1 -0
  43. package/dist/lib/enums/llm-gateway.d.ts +19 -0
  44. package/dist/lib/enums/llm-gateway.d.ts.map +1 -0
  45. package/dist/lib/enums/llm-gateway.js +51 -0
  46. package/dist/lib/enums/llm-gateway.js.map +1 -0
  47. package/dist/lib/enums/scope-source.d.ts +24 -0
  48. package/dist/lib/enums/scope-source.d.ts.map +1 -0
  49. package/dist/lib/enums/scope-source.js +73 -0
  50. package/dist/lib/enums/scope-source.js.map +1 -0
  51. package/dist/lib/enums/webapp-studio.d.ts +20 -0
  52. package/dist/lib/enums/webapp-studio.d.ts.map +1 -0
  53. package/dist/lib/enums/webapp-studio.js +27 -0
  54. package/dist/lib/enums/webapp-studio.js.map +1 -0
  55. package/dist/lib/errors/pipeline-errors.d.ts +182 -0
  56. package/dist/lib/errors/pipeline-errors.d.ts.map +1 -0
  57. package/dist/lib/errors/pipeline-errors.js +323 -0
  58. package/dist/lib/errors/pipeline-errors.js.map +1 -0
  59. package/dist/lib/escape-for-prompt.d.ts +3 -0
  60. package/dist/lib/escape-for-prompt.d.ts.map +1 -0
  61. package/dist/lib/escape-for-prompt.js +28 -0
  62. package/dist/lib/escape-for-prompt.js.map +1 -0
  63. package/dist/lib/file-share-token.d.ts +25 -0
  64. package/dist/lib/file-share-token.d.ts.map +1 -0
  65. package/dist/lib/file-share-token.js +90 -0
  66. package/dist/lib/file-share-token.js.map +1 -0
  67. package/dist/lib/integration-webhooks/adapter-key.enum.d.ts +8 -0
  68. package/dist/lib/integration-webhooks/adapter-key.enum.d.ts.map +1 -0
  69. package/dist/lib/integration-webhooks/adapter-key.enum.js +12 -0
  70. package/dist/lib/integration-webhooks/adapter-key.enum.js.map +1 -0
  71. package/dist/lib/integration-webhooks/index.d.ts +5 -0
  72. package/dist/lib/integration-webhooks/index.d.ts.map +1 -0
  73. package/dist/lib/integration-webhooks/index.js +21 -0
  74. package/dist/lib/integration-webhooks/index.js.map +1 -0
  75. package/dist/lib/integration-webhooks/integration-provider.enum.d.ts +26 -0
  76. package/dist/lib/integration-webhooks/integration-provider.enum.d.ts.map +1 -0
  77. package/dist/lib/integration-webhooks/integration-provider.enum.js +30 -0
  78. package/dist/lib/integration-webhooks/integration-provider.enum.js.map +1 -0
  79. package/dist/lib/integration-webhooks/routes.d.ts +3 -0
  80. package/dist/lib/integration-webhooks/routes.d.ts.map +1 -0
  81. package/dist/lib/integration-webhooks/routes.js +6 -0
  82. package/dist/lib/integration-webhooks/routes.js.map +1 -0
  83. package/dist/lib/integration-webhooks/webhook-entity-kind.enum.d.ts +12 -0
  84. package/dist/lib/integration-webhooks/webhook-entity-kind.enum.d.ts.map +1 -0
  85. package/dist/lib/integration-webhooks/webhook-entity-kind.enum.js +16 -0
  86. package/dist/lib/integration-webhooks/webhook-entity-kind.enum.js.map +1 -0
  87. package/dist/lib/interaction-widgets/factories.d.ts +83 -0
  88. package/dist/lib/interaction-widgets/factories.d.ts.map +1 -0
  89. package/dist/lib/interaction-widgets/factories.js +173 -0
  90. package/dist/lib/interaction-widgets/factories.js.map +1 -0
  91. package/dist/lib/interaction-widgets/index.d.ts +4 -0
  92. package/dist/lib/interaction-widgets/index.d.ts.map +1 -0
  93. package/dist/lib/interaction-widgets/index.js +20 -0
  94. package/dist/lib/interaction-widgets/index.js.map +1 -0
  95. package/dist/lib/interaction-widgets/validation.d.ts +10 -0
  96. package/dist/lib/interaction-widgets/validation.d.ts.map +1 -0
  97. package/dist/lib/interaction-widgets/validation.js +214 -0
  98. package/dist/lib/interaction-widgets/validation.js.map +1 -0
  99. package/dist/lib/interaction-widgets/widget-types.d.ts +163 -0
  100. package/dist/lib/interaction-widgets/widget-types.d.ts.map +1 -0
  101. package/dist/lib/interaction-widgets/widget-types.js +22 -0
  102. package/dist/lib/interaction-widgets/widget-types.js.map +1 -0
  103. package/dist/lib/interactive-workspace-layout.d.ts +25 -0
  104. package/dist/lib/interactive-workspace-layout.d.ts.map +1 -0
  105. package/dist/lib/interactive-workspace-layout.js +56 -0
  106. package/dist/lib/interactive-workspace-layout.js.map +1 -0
  107. package/dist/lib/json-extraction.d.ts +2 -0
  108. package/dist/lib/json-extraction.d.ts.map +1 -0
  109. package/dist/lib/json-extraction.js +81 -0
  110. package/dist/lib/json-extraction.js.map +1 -0
  111. package/dist/lib/llm-stream/anthropic-adapter.d.ts +25 -0
  112. package/dist/lib/llm-stream/anthropic-adapter.d.ts.map +1 -0
  113. package/dist/lib/llm-stream/anthropic-adapter.js +278 -0
  114. package/dist/lib/llm-stream/anthropic-adapter.js.map +1 -0
  115. package/dist/lib/llm-stream/compaction.d.ts +16 -0
  116. package/dist/lib/llm-stream/compaction.d.ts.map +1 -0
  117. package/dist/lib/llm-stream/compaction.js +82 -0
  118. package/dist/lib/llm-stream/compaction.js.map +1 -0
  119. package/dist/lib/llm-stream/consume-stream.d.ts +17 -0
  120. package/dist/lib/llm-stream/consume-stream.d.ts.map +1 -0
  121. package/dist/lib/llm-stream/consume-stream.js +138 -0
  122. package/dist/lib/llm-stream/consume-stream.js.map +1 -0
  123. package/dist/lib/llm-stream/index.d.ts +6 -0
  124. package/dist/lib/llm-stream/index.d.ts.map +1 -0
  125. package/dist/lib/llm-stream/index.js +22 -0
  126. package/dist/lib/llm-stream/index.js.map +1 -0
  127. package/dist/lib/llm-stream/progress.d.ts +17 -0
  128. package/dist/lib/llm-stream/progress.d.ts.map +1 -0
  129. package/dist/lib/llm-stream/progress.js +12 -0
  130. package/dist/lib/llm-stream/progress.js.map +1 -0
  131. package/dist/lib/llm-stream/types.d.ts +56 -0
  132. package/dist/lib/llm-stream/types.d.ts.map +1 -0
  133. package/dist/lib/llm-stream/types.js +3 -0
  134. package/dist/lib/llm-stream/types.js.map +1 -0
  135. package/dist/lib/llm-stream-observer.d.ts +27 -0
  136. package/dist/lib/llm-stream-observer.d.ts.map +1 -0
  137. package/dist/lib/llm-stream-observer.js +55 -0
  138. package/dist/lib/llm-stream-observer.js.map +1 -0
  139. package/dist/lib/manifest/index.d.ts +5 -0
  140. package/dist/lib/manifest/index.d.ts.map +1 -0
  141. package/dist/lib/manifest/index.js +21 -0
  142. package/dist/lib/manifest/index.js.map +1 -0
  143. package/dist/lib/manifest/manifest.enums.d.ts +55 -0
  144. package/dist/lib/manifest/manifest.enums.d.ts.map +1 -0
  145. package/dist/lib/manifest/manifest.enums.js +278 -0
  146. package/dist/lib/manifest/manifest.enums.js.map +1 -0
  147. package/dist/lib/manifest/manifest.schema.d.ts +433 -0
  148. package/dist/lib/manifest/manifest.schema.d.ts.map +1 -0
  149. package/dist/lib/manifest/manifest.schema.js +327 -0
  150. package/dist/lib/manifest/manifest.schema.js.map +1 -0
  151. package/dist/lib/manifest/manifest.types.d.ts +146 -0
  152. package/dist/lib/manifest/manifest.types.d.ts.map +1 -0
  153. package/dist/lib/manifest/manifest.types.js +54 -0
  154. package/dist/lib/manifest/manifest.types.js.map +1 -0
  155. package/dist/lib/manifest/manifest.validation.d.ts +17 -0
  156. package/dist/lib/manifest/manifest.validation.d.ts.map +1 -0
  157. package/dist/lib/manifest/manifest.validation.js +353 -0
  158. package/dist/lib/manifest/manifest.validation.js.map +1 -0
  159. package/dist/lib/mcp-bridge-token.d.ts +63 -0
  160. package/dist/lib/mcp-bridge-token.d.ts.map +1 -0
  161. package/dist/lib/mcp-bridge-token.js +255 -0
  162. package/dist/lib/mcp-bridge-token.js.map +1 -0
  163. package/dist/lib/mcp-response-projection.d.ts +9 -0
  164. package/dist/lib/mcp-response-projection.d.ts.map +1 -0
  165. package/dist/lib/mcp-response-projection.js +57 -0
  166. package/dist/lib/mcp-response-projection.js.map +1 -0
  167. package/dist/lib/omit-undefined.d.ts +2 -0
  168. package/dist/lib/omit-undefined.d.ts.map +1 -0
  169. package/dist/lib/omit-undefined.js +9 -0
  170. package/dist/lib/omit-undefined.js.map +1 -0
  171. package/dist/lib/orval-client-config.d.ts +29 -0
  172. package/dist/lib/orval-client-config.d.ts.map +1 -0
  173. package/dist/lib/orval-client-config.js +30 -0
  174. package/dist/lib/orval-client-config.js.map +1 -0
  175. package/dist/lib/preview-token.d.ts +16 -0
  176. package/dist/lib/preview-token.d.ts.map +1 -0
  177. package/dist/lib/preview-token.js +71 -0
  178. package/dist/lib/preview-token.js.map +1 -0
  179. package/dist/lib/redaction/default-rules.d.ts +3 -0
  180. package/dist/lib/redaction/default-rules.d.ts.map +1 -0
  181. package/dist/lib/redaction/default-rules.js +66 -0
  182. package/dist/lib/redaction/default-rules.js.map +1 -0
  183. package/dist/lib/redaction/index.d.ts +5 -0
  184. package/dist/lib/redaction/index.d.ts.map +1 -0
  185. package/dist/lib/redaction/index.js +12 -0
  186. package/dist/lib/redaction/index.js.map +1 -0
  187. package/dist/lib/redaction/redaction-rule.d.ts +8 -0
  188. package/dist/lib/redaction/redaction-rule.d.ts.map +1 -0
  189. package/dist/lib/redaction/redaction-rule.js +3 -0
  190. package/dist/lib/redaction/redaction-rule.js.map +1 -0
  191. package/dist/lib/redaction/redaction.interceptor.d.ts +11 -0
  192. package/dist/lib/redaction/redaction.interceptor.d.ts.map +1 -0
  193. package/dist/lib/redaction/redaction.interceptor.js +41 -0
  194. package/dist/lib/redaction/redaction.interceptor.js.map +1 -0
  195. package/dist/lib/redaction/redaction.service.d.ts +9 -0
  196. package/dist/lib/redaction/redaction.service.d.ts.map +1 -0
  197. package/dist/lib/redaction/redaction.service.js +110 -0
  198. package/dist/lib/redaction/redaction.service.js.map +1 -0
  199. package/dist/lib/request-context.d.ts +34 -0
  200. package/dist/lib/request-context.d.ts.map +1 -0
  201. package/dist/lib/request-context.js +10 -0
  202. package/dist/lib/request-context.js.map +1 -0
  203. package/dist/lib/run-events/action-types.d.ts +40 -0
  204. package/dist/lib/run-events/action-types.d.ts.map +1 -0
  205. package/dist/lib/run-events/action-types.js +40 -0
  206. package/dist/lib/run-events/action-types.js.map +1 -0
  207. package/dist/lib/run-events/event-families.d.ts +96 -0
  208. package/dist/lib/run-events/event-families.d.ts.map +1 -0
  209. package/dist/lib/run-events/event-families.js +282 -0
  210. package/dist/lib/run-events/event-families.js.map +1 -0
  211. package/dist/lib/run-events/index.d.ts +7 -0
  212. package/dist/lib/run-events/index.d.ts.map +1 -0
  213. package/dist/lib/run-events/index.js +23 -0
  214. package/dist/lib/run-events/index.js.map +1 -0
  215. package/dist/lib/run-events/run-event.types.d.ts +60 -0
  216. package/dist/lib/run-events/run-event.types.d.ts.map +1 -0
  217. package/dist/lib/run-events/run-event.types.js +57 -0
  218. package/dist/lib/run-events/run-event.types.js.map +1 -0
  219. package/dist/lib/run-events/run-live-snapshot.types.d.ts +69 -0
  220. package/dist/lib/run-events/run-live-snapshot.types.d.ts.map +1 -0
  221. package/dist/lib/run-events/run-live-snapshot.types.js +17 -0
  222. package/dist/lib/run-events/run-live-snapshot.types.js.map +1 -0
  223. package/dist/lib/run-events/snapshot-reducer.d.ts +4 -0
  224. package/dist/lib/run-events/snapshot-reducer.d.ts.map +1 -0
  225. package/dist/lib/run-events/snapshot-reducer.js +313 -0
  226. package/dist/lib/run-events/snapshot-reducer.js.map +1 -0
  227. package/dist/lib/run-events/stream-contracts.d.ts +79 -0
  228. package/dist/lib/run-events/stream-contracts.d.ts.map +1 -0
  229. package/dist/lib/run-events/stream-contracts.js +27 -0
  230. package/dist/lib/run-events/stream-contracts.js.map +1 -0
  231. package/dist/lib/tag-taxonomy/concern-tags.d.ts +3 -0
  232. package/dist/lib/tag-taxonomy/concern-tags.d.ts.map +1 -0
  233. package/dist/lib/tag-taxonomy/concern-tags.js +26 -0
  234. package/dist/lib/tag-taxonomy/concern-tags.js.map +1 -0
  235. package/dist/lib/tag-taxonomy/index.d.ts +14 -0
  236. package/dist/lib/tag-taxonomy/index.d.ts.map +1 -0
  237. package/dist/lib/tag-taxonomy/index.js +59 -0
  238. package/dist/lib/tag-taxonomy/index.js.map +1 -0
  239. package/dist/lib/tag-taxonomy/lifecycle-tags.d.ts +3 -0
  240. package/dist/lib/tag-taxonomy/lifecycle-tags.d.ts.map +1 -0
  241. package/dist/lib/tag-taxonomy/lifecycle-tags.js +57 -0
  242. package/dist/lib/tag-taxonomy/lifecycle-tags.js.map +1 -0
  243. package/dist/lib/tag-taxonomy/stack-tags.d.ts +3 -0
  244. package/dist/lib/tag-taxonomy/stack-tags.d.ts.map +1 -0
  245. package/dist/lib/tag-taxonomy/stack-tags.js +26 -0
  246. package/dist/lib/tag-taxonomy/stack-tags.js.map +1 -0
  247. package/dist/lib/tag-taxonomy/team-tags.d.ts +3 -0
  248. package/dist/lib/tag-taxonomy/team-tags.d.ts.map +1 -0
  249. package/dist/lib/tag-taxonomy/team-tags.js +84 -0
  250. package/dist/lib/tag-taxonomy/team-tags.js.map +1 -0
  251. package/dist/lib/tag-taxonomy/types.d.ts +14 -0
  252. package/dist/lib/tag-taxonomy/types.d.ts.map +1 -0
  253. package/dist/lib/tag-taxonomy/types.js +3 -0
  254. package/dist/lib/tag-taxonomy/types.js.map +1 -0
  255. package/dist/lib/to-prisma-json.d.ts +6 -0
  256. package/dist/lib/to-prisma-json.d.ts.map +1 -0
  257. package/dist/lib/to-prisma-json.js +12 -0
  258. package/dist/lib/to-prisma-json.js.map +1 -0
  259. package/dist/lib/tool-usage-counter.d.ts +20 -0
  260. package/dist/lib/tool-usage-counter.d.ts.map +1 -0
  261. package/dist/lib/tool-usage-counter.js +50 -0
  262. package/dist/lib/tool-usage-counter.js.map +1 -0
  263. package/dist/lib/vote-feedback.d.ts +60 -0
  264. package/dist/lib/vote-feedback.d.ts.map +1 -0
  265. package/dist/lib/vote-feedback.js +57 -0
  266. package/dist/lib/vote-feedback.js.map +1 -0
  267. package/dist/lib/write-policy.d.ts +30 -0
  268. package/dist/lib/write-policy.d.ts.map +1 -0
  269. package/dist/lib/write-policy.js +54 -0
  270. package/dist/lib/write-policy.js.map +1 -0
  271. package/dist/lib/xema-path-builder.d.ts +7 -0
  272. package/dist/lib/xema-path-builder.d.ts.map +1 -0
  273. package/dist/lib/xema-path-builder.js +67 -0
  274. package/dist/lib/xema-path-builder.js.map +1 -0
  275. package/dist/nestjs/auth/auth-module-options.d.ts +16 -0
  276. package/dist/nestjs/auth/auth-module-options.d.ts.map +1 -0
  277. package/dist/nestjs/auth/auth-module-options.js +5 -0
  278. package/dist/nestjs/auth/auth-module-options.js.map +1 -0
  279. package/dist/nestjs/auth/auth.module.d.ts +7 -0
  280. package/dist/nestjs/auth/auth.module.d.ts.map +1 -0
  281. package/dist/nestjs/auth/auth.module.js +69 -0
  282. package/dist/nestjs/auth/auth.module.js.map +1 -0
  283. package/dist/nestjs/auth/configure-auth-middleware.d.ts +7 -0
  284. package/dist/nestjs/auth/configure-auth-middleware.d.ts.map +1 -0
  285. package/dist/nestjs/auth/configure-auth-middleware.js +30 -0
  286. package/dist/nestjs/auth/configure-auth-middleware.js.map +1 -0
  287. package/dist/nestjs/auth/index.d.ts +11 -0
  288. package/dist/nestjs/auth/index.d.ts.map +1 -0
  289. package/dist/nestjs/auth/index.js +36 -0
  290. package/dist/nestjs/auth/index.js.map +1 -0
  291. package/dist/nestjs/auth/internal-caller.guard.d.ts +6 -0
  292. package/dist/nestjs/auth/internal-caller.guard.d.ts.map +1 -0
  293. package/dist/nestjs/auth/internal-caller.guard.js +38 -0
  294. package/dist/nestjs/auth/internal-caller.guard.js.map +1 -0
  295. package/dist/nestjs/auth/org-claim.d.ts +13 -0
  296. package/dist/nestjs/auth/org-claim.d.ts.map +1 -0
  297. package/dist/nestjs/auth/org-claim.js +26 -0
  298. package/dist/nestjs/auth/org-claim.js.map +1 -0
  299. package/dist/nestjs/auth/org-role.d.ts +13 -0
  300. package/dist/nestjs/auth/org-role.d.ts.map +1 -0
  301. package/dist/nestjs/auth/org-role.guard.d.ts +9 -0
  302. package/dist/nestjs/auth/org-role.guard.d.ts.map +1 -0
  303. package/dist/nestjs/auth/org-role.guard.js +59 -0
  304. package/dist/nestjs/auth/org-role.guard.js.map +1 -0
  305. package/dist/nestjs/auth/org-role.js +75 -0
  306. package/dist/nestjs/auth/org-role.js.map +1 -0
  307. package/dist/nestjs/auth/service-actor.guard.d.ts +6 -0
  308. package/dist/nestjs/auth/service-actor.guard.d.ts.map +1 -0
  309. package/dist/nestjs/auth/service-actor.guard.js +49 -0
  310. package/dist/nestjs/auth/service-actor.guard.js.map +1 -0
  311. package/dist/nestjs/auth/service-token.guard.d.ts +16 -0
  312. package/dist/nestjs/auth/service-token.guard.d.ts.map +1 -0
  313. package/dist/nestjs/auth/service-token.guard.js +209 -0
  314. package/dist/nestjs/auth/service-token.guard.js.map +1 -0
  315. package/dist/nestjs/auth/token-class.guard.d.ts +9 -0
  316. package/dist/nestjs/auth/token-class.guard.d.ts.map +1 -0
  317. package/dist/nestjs/auth/token-class.guard.js +57 -0
  318. package/dist/nestjs/auth/token-class.guard.js.map +1 -0
  319. package/dist/nestjs/body-parsers.d.ts +7 -0
  320. package/dist/nestjs/body-parsers.d.ts.map +1 -0
  321. package/dist/nestjs/body-parsers.js +14 -0
  322. package/dist/nestjs/body-parsers.js.map +1 -0
  323. package/dist/nestjs/cors.config.d.ts +4 -0
  324. package/dist/nestjs/cors.config.d.ts.map +1 -0
  325. package/dist/nestjs/cors.config.js +74 -0
  326. package/dist/nestjs/cors.config.js.map +1 -0
  327. package/dist/nestjs/ctx.decorator.d.ts +3 -0
  328. package/dist/nestjs/ctx.decorator.d.ts.map +1 -0
  329. package/dist/nestjs/ctx.decorator.js +14 -0
  330. package/dist/nestjs/ctx.decorator.js.map +1 -0
  331. package/dist/nestjs/decorator-metadata.d.ts +6 -0
  332. package/dist/nestjs/decorator-metadata.d.ts.map +1 -0
  333. package/dist/nestjs/decorator-metadata.js +18 -0
  334. package/dist/nestjs/decorator-metadata.js.map +1 -0
  335. package/dist/nestjs/error-response.dto.d.ts +10 -0
  336. package/dist/nestjs/error-response.dto.d.ts.map +1 -0
  337. package/dist/nestjs/error-response.dto.js +46 -0
  338. package/dist/nestjs/error-response.dto.js.map +1 -0
  339. package/dist/nestjs/fetch-envelope.d.ts +5 -0
  340. package/dist/nestjs/fetch-envelope.d.ts.map +1 -0
  341. package/dist/nestjs/fetch-envelope.js +38 -0
  342. package/dist/nestjs/fetch-envelope.js.map +1 -0
  343. package/dist/nestjs/fetch-with-retry.d.ts +11 -0
  344. package/dist/nestjs/fetch-with-retry.d.ts.map +1 -0
  345. package/dist/nestjs/fetch-with-retry.js +100 -0
  346. package/dist/nestjs/fetch-with-retry.js.map +1 -0
  347. package/dist/nestjs/get-env-or-throw.d.ts +2 -0
  348. package/dist/nestjs/get-env-or-throw.d.ts.map +1 -0
  349. package/dist/nestjs/get-env-or-throw.js +11 -0
  350. package/dist/nestjs/get-env-or-throw.js.map +1 -0
  351. package/dist/nestjs/global-exception.filter.d.ts +10 -0
  352. package/dist/nestjs/global-exception.filter.d.ts.map +1 -0
  353. package/dist/nestjs/global-exception.filter.js +139 -0
  354. package/dist/nestjs/global-exception.filter.js.map +1 -0
  355. package/dist/nestjs/idempotency/idempotency.service.d.ts +6 -0
  356. package/dist/nestjs/idempotency/idempotency.service.d.ts.map +1 -0
  357. package/dist/nestjs/idempotency/idempotency.service.js +5 -0
  358. package/dist/nestjs/idempotency/idempotency.service.js.map +1 -0
  359. package/dist/nestjs/idempotency/idempotency.tokens.d.ts +2 -0
  360. package/dist/nestjs/idempotency/idempotency.tokens.d.ts.map +1 -0
  361. package/dist/nestjs/idempotency/idempotency.tokens.js +5 -0
  362. package/dist/nestjs/idempotency/idempotency.tokens.js.map +1 -0
  363. package/dist/nestjs/idempotency/index.d.ts +4 -0
  364. package/dist/nestjs/idempotency/index.d.ts.map +1 -0
  365. package/dist/nestjs/idempotency/index.js +11 -0
  366. package/dist/nestjs/idempotency/index.js.map +1 -0
  367. package/dist/nestjs/idempotency/prisma-idempotency.service.d.ts +20 -0
  368. package/dist/nestjs/idempotency/prisma-idempotency.service.d.ts.map +1 -0
  369. package/dist/nestjs/idempotency/prisma-idempotency.service.js +58 -0
  370. package/dist/nestjs/idempotency/prisma-idempotency.service.js.map +1 -0
  371. package/dist/nestjs/index.d.ts +26 -0
  372. package/dist/nestjs/index.d.ts.map +1 -0
  373. package/dist/nestjs/index.js +96 -0
  374. package/dist/nestjs/index.js.map +1 -0
  375. package/dist/nestjs/integration-webhooks/api-integration-envelope.decorator.d.ts +7 -0
  376. package/dist/nestjs/integration-webhooks/api-integration-envelope.decorator.d.ts.map +1 -0
  377. package/dist/nestjs/integration-webhooks/api-integration-envelope.decorator.js +27 -0
  378. package/dist/nestjs/integration-webhooks/api-integration-envelope.decorator.js.map +1 -0
  379. package/dist/nestjs/integration-webhooks/index.d.ts +5 -0
  380. package/dist/nestjs/integration-webhooks/index.d.ts.map +1 -0
  381. package/dist/nestjs/integration-webhooks/index.js +10 -0
  382. package/dist/nestjs/integration-webhooks/index.js.map +1 -0
  383. package/dist/nestjs/integration-webhooks/integration-envelope.pipe.d.ts +9 -0
  384. package/dist/nestjs/integration-webhooks/integration-envelope.pipe.d.ts.map +1 -0
  385. package/dist/nestjs/integration-webhooks/integration-envelope.pipe.js +100 -0
  386. package/dist/nestjs/integration-webhooks/integration-envelope.pipe.js.map +1 -0
  387. package/dist/nestjs/integration-webhooks/integration-envelope.types.d.ts +7 -0
  388. package/dist/nestjs/integration-webhooks/integration-envelope.types.d.ts.map +1 -0
  389. package/dist/nestjs/integration-webhooks/integration-envelope.types.js +3 -0
  390. package/dist/nestjs/integration-webhooks/integration-envelope.types.js.map +1 -0
  391. package/dist/nestjs/integration-webhooks/integration-webhook-envelope.dto.d.ts +14 -0
  392. package/dist/nestjs/integration-webhooks/integration-webhook-envelope.dto.d.ts.map +1 -0
  393. package/dist/nestjs/integration-webhooks/integration-webhook-envelope.dto.js +97 -0
  394. package/dist/nestjs/integration-webhooks/integration-webhook-envelope.dto.js.map +1 -0
  395. package/dist/nestjs/jwks/jwks-verifier.d.ts +48 -0
  396. package/dist/nestjs/jwks/jwks-verifier.d.ts.map +1 -0
  397. package/dist/nestjs/jwks/jwks-verifier.js +177 -0
  398. package/dist/nestjs/jwks/jwks-verifier.js.map +1 -0
  399. package/dist/nestjs/jwt-verification.guard.d.ts +25 -0
  400. package/dist/nestjs/jwt-verification.guard.d.ts.map +1 -0
  401. package/dist/nestjs/jwt-verification.guard.js +232 -0
  402. package/dist/nestjs/jwt-verification.guard.js.map +1 -0
  403. package/dist/nestjs/openapi-docs.enricher.d.ts +6 -0
  404. package/dist/nestjs/openapi-docs.enricher.d.ts.map +1 -0
  405. package/dist/nestjs/openapi-docs.enricher.js +296 -0
  406. package/dist/nestjs/openapi-docs.enricher.js.map +1 -0
  407. package/dist/nestjs/pagination.d.ts +25 -0
  408. package/dist/nestjs/pagination.d.ts.map +1 -0
  409. package/dist/nestjs/pagination.js +73 -0
  410. package/dist/nestjs/pagination.js.map +1 -0
  411. package/dist/nestjs/public.decorator.d.ts +3 -0
  412. package/dist/nestjs/public.decorator.d.ts.map +1 -0
  413. package/dist/nestjs/public.decorator.js +8 -0
  414. package/dist/nestjs/public.decorator.js.map +1 -0
  415. package/dist/nestjs/raw-response.decorator.d.ts +3 -0
  416. package/dist/nestjs/raw-response.decorator.d.ts.map +1 -0
  417. package/dist/nestjs/raw-response.decorator.js +8 -0
  418. package/dist/nestjs/raw-response.decorator.js.map +1 -0
  419. package/dist/nestjs/request-context.middleware.d.ts +27 -0
  420. package/dist/nestjs/request-context.middleware.d.ts.map +1 -0
  421. package/dist/nestjs/request-context.middleware.js +252 -0
  422. package/dist/nestjs/request-context.middleware.js.map +1 -0
  423. package/dist/nestjs/require-pipeline-run-id.d.ts +3 -0
  424. package/dist/nestjs/require-pipeline-run-id.d.ts.map +1 -0
  425. package/dist/nestjs/require-pipeline-run-id.js +11 -0
  426. package/dist/nestjs/require-pipeline-run-id.js.map +1 -0
  427. package/dist/nestjs/require-project-id.d.ts +3 -0
  428. package/dist/nestjs/require-project-id.d.ts.map +1 -0
  429. package/dist/nestjs/require-project-id.js +11 -0
  430. package/dist/nestjs/require-project-id.js.map +1 -0
  431. package/dist/nestjs/response-envelope.interceptor.d.ts +6 -0
  432. package/dist/nestjs/response-envelope.interceptor.d.ts.map +1 -0
  433. package/dist/nestjs/response-envelope.interceptor.js +48 -0
  434. package/dist/nestjs/response-envelope.interceptor.js.map +1 -0
  435. package/dist/nestjs/roles.decorator.d.ts +3 -0
  436. package/dist/nestjs/roles.decorator.d.ts.map +1 -0
  437. package/dist/nestjs/roles.decorator.js +8 -0
  438. package/dist/nestjs/roles.decorator.js.map +1 -0
  439. package/dist/nestjs/roles.guard.d.ts +6 -0
  440. package/dist/nestjs/roles.guard.d.ts.map +1 -0
  441. package/dist/nestjs/roles.guard.js +41 -0
  442. package/dist/nestjs/roles.guard.js.map +1 -0
  443. package/dist/nestjs/swagger-keycloak.d.ts +30 -0
  444. package/dist/nestjs/swagger-keycloak.d.ts.map +1 -0
  445. package/dist/nestjs/swagger-keycloak.js +75 -0
  446. package/dist/nestjs/swagger-keycloak.js.map +1 -0
  447. package/dist/nestjs/swagger.decorators.d.ts +8 -0
  448. package/dist/nestjs/swagger.decorators.d.ts.map +1 -0
  449. package/dist/nestjs/swagger.decorators.js +117 -0
  450. package/dist/nestjs/swagger.decorators.js.map +1 -0
  451. package/dist/schemas/xema/analysis.json +51 -0
  452. package/dist/schemas/xema/clarification-contract.json +49 -0
  453. package/dist/schemas/xema/context.json +79 -0
  454. package/dist/schemas/xema/index.d.ts +8 -0
  455. package/dist/schemas/xema/index.d.ts.map +1 -0
  456. package/dist/schemas/xema/index.js +30 -0
  457. package/dist/schemas/xema/index.js.map +1 -0
  458. package/dist/schemas/xema/manifest.json +32 -0
  459. package/dist/schemas/xema/review-history.json +42 -0
  460. package/package.json +76 -0
@@ -0,0 +1,27 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ApiIntegrationEnvelope = ApiIntegrationEnvelope;
4
+ const common_1 = require("@nestjs/common");
5
+ const swagger_1 = require("@nestjs/swagger");
6
+ function ApiIntegrationEnvelope(options) {
7
+ const { variants, description } = options;
8
+ if (variants.length === 0) {
9
+ throw new Error('ApiIntegrationEnvelope requires at least one variant constructor.');
10
+ }
11
+ const variantList = [...variants];
12
+ return (0, common_1.applyDecorators)((0, swagger_1.ApiExtraModels)(...variantList), (0, swagger_1.ApiBody)({
13
+ description: description ??
14
+ 'Normalized integration webhook envelope. One variant per entityKind discriminator.',
15
+ schema: {
16
+ oneOf: variantList.map((v) => ({ $ref: (0, swagger_1.getSchemaPath)(v) })),
17
+ discriminator: {
18
+ propertyName: 'entityKind',
19
+ mapping: variantList.reduce((acc, v) => {
20
+ acc[v.ENTITY_KIND] = (0, swagger_1.getSchemaPath)(v);
21
+ return acc;
22
+ }, {}),
23
+ },
24
+ },
25
+ }));
26
+ }
27
+ //# sourceMappingURL=api-integration-envelope.decorator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"api-integration-envelope.decorator.js","sourceRoot":"","sources":["../../../src/nestjs/integration-webhooks/api-integration-envelope.decorator.ts"],"names":[],"mappings":";;AAoCA,wDAmCC;AAvED,2CAAiD;AACjD,6CAAyE;AAmCzE,SAAgB,sBAAsB,CACpC,OAAsC;IAEtC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAE1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;IACJ,CAAC;IAGD,MAAM,WAAW,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IAElC,OAAO,IAAA,wBAAe,EACpB,IAAA,wBAAc,EAAC,GAAG,WAAW,CAAC,EAC9B,IAAA,iBAAO,EAAC;QACN,WAAW,EACT,WAAW;YACX,oFAAoF;QACtF,MAAM,EAAE;YACN,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAA,uBAAa,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3D,aAAa,EAAE;gBACb,YAAY,EAAE,YAAY;gBAI1B,OAAO,EAAE,WAAW,CAAC,MAAM,CAAyB,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;oBAC7D,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,IAAA,uBAAa,EAAC,CAAC,CAAC,CAAC;oBACtC,OAAO,GAAG,CAAC;gBACb,CAAC,EAAE,EAAE,CAAC;aACP;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}
@@ -0,0 +1,5 @@
1
+ export { IntegrationWebhookEnvelopeDto } from './integration-webhook-envelope.dto';
2
+ export { IntegrationEnvelopePipe } from './integration-envelope.pipe';
3
+ export { ApiIntegrationEnvelope, type ApiIntegrationEnvelopeOptions, } from './api-integration-envelope.decorator';
4
+ export type { IntegrationEnvelopeVariant } from './integration-envelope.types';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/nestjs/integration-webhooks/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,GACnC,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC"}
@@ -0,0 +1,10 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ApiIntegrationEnvelope = exports.IntegrationEnvelopePipe = exports.IntegrationWebhookEnvelopeDto = void 0;
4
+ var integration_webhook_envelope_dto_1 = require("./integration-webhook-envelope.dto");
5
+ Object.defineProperty(exports, "IntegrationWebhookEnvelopeDto", { enumerable: true, get: function () { return integration_webhook_envelope_dto_1.IntegrationWebhookEnvelopeDto; } });
6
+ var integration_envelope_pipe_1 = require("./integration-envelope.pipe");
7
+ Object.defineProperty(exports, "IntegrationEnvelopePipe", { enumerable: true, get: function () { return integration_envelope_pipe_1.IntegrationEnvelopePipe; } });
8
+ var api_integration_envelope_decorator_1 = require("./api-integration-envelope.decorator");
9
+ Object.defineProperty(exports, "ApiIntegrationEnvelope", { enumerable: true, get: function () { return api_integration_envelope_decorator_1.ApiIntegrationEnvelope; } });
10
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/nestjs/integration-webhooks/index.ts"],"names":[],"mappings":";;;AAQA,uFAAmF;AAA1E,iJAAA,6BAA6B,OAAA;AACtC,yEAAsE;AAA7D,oIAAA,uBAAuB,OAAA;AAChC,2FAG8C;AAF5C,4IAAA,sBAAsB,OAAA"}
@@ -0,0 +1,9 @@
1
+ import { PipeTransform } from '@nestjs/common';
2
+ import type { IntegrationWebhookEnvelopeDto } from './integration-webhook-envelope.dto';
3
+ import type { IntegrationEnvelopeVariant } from './integration-envelope.types';
4
+ export declare class IntegrationEnvelopePipe<TVariant extends IntegrationWebhookEnvelopeDto<unknown>> implements PipeTransform<unknown, Promise<TVariant>> {
5
+ private readonly byEntityKind;
6
+ constructor(variants: readonly IntegrationEnvelopeVariant[]);
7
+ transform(value: unknown): Promise<TVariant>;
8
+ }
9
+ //# sourceMappingURL=integration-envelope.pipe.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"integration-envelope.pipe.d.ts","sourceRoot":"","sources":["../../../src/nestjs/integration-webhooks/integration-envelope.pipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,aAAa,EACd,MAAM,gBAAgB,CAAC;AAMxB,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AA6B/E,qBACa,uBAAuB,CAClC,QAAQ,SAAS,6BAA6B,CAAC,OAAO,CAAC,CACvD,YAAW,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAG3B;gBAEU,QAAQ,EAAE,SAAS,0BAA0B,EAAE;IAyBrD,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;CA8CnD"}
@@ -0,0 +1,100 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.IntegrationEnvelopePipe = void 0;
13
+ const common_1 = require("@nestjs/common");
14
+ const class_transformer_1 = require("class-transformer");
15
+ const class_validator_1 = require("class-validator");
16
+ let IntegrationEnvelopePipe = class IntegrationEnvelopePipe {
17
+ byEntityKind;
18
+ constructor(variants) {
19
+ if (variants.length === 0) {
20
+ throw new Error('IntegrationEnvelopePipe requires at least one variant constructor.');
21
+ }
22
+ const map = new Map();
23
+ for (const ctor of variants) {
24
+ const entityKind = ctor.ENTITY_KIND;
25
+ if (entityKind === undefined) {
26
+ throw new Error(`IntegrationEnvelopePipe: variant ${ctor.name} is missing static ENTITY_KIND.`);
27
+ }
28
+ const existing = map.get(entityKind);
29
+ if (existing) {
30
+ throw new Error(`IntegrationEnvelopePipe: duplicate ENTITY_KIND "${entityKind}" shared by ${existing.name} and ${ctor.name}.`);
31
+ }
32
+ map.set(entityKind, ctor);
33
+ }
34
+ this.byEntityKind = map;
35
+ }
36
+ async transform(value) {
37
+ if (!isPlainObject(value)) {
38
+ throw new common_1.BadRequestException({
39
+ code: 'INVALID_ENVELOPE',
40
+ message: 'Webhook envelope body must be a JSON object.',
41
+ });
42
+ }
43
+ const rawEntityKind = value.entityKind;
44
+ if (typeof rawEntityKind !== 'string') {
45
+ throw new common_1.BadRequestException({
46
+ code: 'MISSING_ENTITY_KIND',
47
+ message: 'Webhook envelope is missing the required string field "entityKind".',
48
+ });
49
+ }
50
+ const ctor = this.byEntityKind.get(rawEntityKind);
51
+ if (!ctor) {
52
+ const accepted = [...this.byEntityKind.keys()].join(', ');
53
+ throw new common_1.BadRequestException({
54
+ code: 'UNKNOWN_ENTITY_KIND',
55
+ message: `Unknown entityKind "${rawEntityKind}". Expected one of: ${accepted}.`,
56
+ });
57
+ }
58
+ const instance = (0, class_transformer_1.plainToInstance)(ctor, value, {
59
+ enableImplicitConversion: false,
60
+ });
61
+ const errors = await (0, class_validator_1.validate)(instance, {
62
+ whitelist: true,
63
+ forbidNonWhitelisted: true,
64
+ forbidUnknownValues: true,
65
+ });
66
+ if (errors.length > 0) {
67
+ throw new common_1.BadRequestException({
68
+ code: 'INVALID_ENVELOPE',
69
+ message: `Webhook envelope failed validation (entityKind=${rawEntityKind}).`,
70
+ details: flattenValidationErrors(errors),
71
+ });
72
+ }
73
+ return instance;
74
+ }
75
+ };
76
+ exports.IntegrationEnvelopePipe = IntegrationEnvelopePipe;
77
+ exports.IntegrationEnvelopePipe = IntegrationEnvelopePipe = __decorate([
78
+ (0, common_1.Injectable)(),
79
+ __metadata("design:paramtypes", [Array])
80
+ ], IntegrationEnvelopePipe);
81
+ function isPlainObject(value) {
82
+ return (typeof value === 'object' &&
83
+ value !== null &&
84
+ !Array.isArray(value) &&
85
+ Object.getPrototypeOf(value) === Object.prototype);
86
+ }
87
+ function flattenValidationErrors(errors, parentPath = '') {
88
+ const flat = [];
89
+ for (const err of errors) {
90
+ const path = parentPath ? `${parentPath}.${err.property}` : err.property;
91
+ if (err.constraints && Object.keys(err.constraints).length > 0) {
92
+ flat.push({ path, constraints: err.constraints });
93
+ }
94
+ if (err.children && err.children.length > 0) {
95
+ flat.push(...flattenValidationErrors(err.children, path));
96
+ }
97
+ }
98
+ return flat;
99
+ }
100
+ //# sourceMappingURL=integration-envelope.pipe.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"integration-envelope.pipe.js","sourceRoot":"","sources":["../../../src/nestjs/integration-webhooks/integration-envelope.pipe.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import type { Type } from '@nestjs/common';
2
+ import type { WebhookEntityKind } from '../../lib/integration-webhooks';
3
+ import type { IntegrationWebhookEnvelopeDto } from './integration-webhook-envelope.dto';
4
+ export type IntegrationEnvelopeVariant<TPayload = any> = Type<IntegrationWebhookEnvelopeDto<TPayload>> & {
5
+ readonly ENTITY_KIND: WebhookEntityKind;
6
+ };
7
+ //# sourceMappingURL=integration-envelope.types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"integration-envelope.types.d.ts","sourceRoot":"","sources":["../../../src/nestjs/integration-webhooks/integration-envelope.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAWxF,MAAM,MAAM,0BAA0B,CAAC,QAAQ,GAAG,GAAG,IAAI,IAAI,CAC3D,6BAA6B,CAAC,QAAQ,CAAC,CACxC,GAAG;IACF,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;CACzC,CAAC"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=integration-envelope.types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"integration-envelope.types.js","sourceRoot":"","sources":["../../../src/nestjs/integration-webhooks/integration-envelope.types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,14 @@
1
+ import { AdapterKey, ConnectorKind, WebhookEntityKind } from '../../lib/integration-webhooks';
2
+ export declare class IntegrationWebhookEnvelopeDto<TPayload = unknown> {
3
+ provider: ConnectorKind;
4
+ adapterKey: AdapterKey;
5
+ event: string;
6
+ entityKind: WebhookEntityKind;
7
+ deliveryId: string;
8
+ occurredAt: string;
9
+ correlationId: string;
10
+ externalId?: string;
11
+ externalSpaceKey?: string;
12
+ payload: TPayload;
13
+ }
14
+ //# sourceMappingURL=integration-webhook-envelope.dto.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"integration-webhook-envelope.dto.d.ts","sourceRoot":"","sources":["../../../src/nestjs/integration-webhooks/integration-webhook-envelope.dto.ts"],"names":[],"mappings":"AASA,OAAO,EACL,UAAU,EACV,aAAa,EACb,iBAAiB,EAClB,MAAM,gCAAgC,CAAC;AAwBxC,qBAAa,6BAA6B,CAAC,QAAQ,GAAG,OAAO;IAQ3D,QAAQ,EAAG,aAAa,CAAC;IASzB,UAAU,EAAG,UAAU,CAAC;IAQxB,KAAK,EAAG,MAAM,CAAC;IAIf,UAAU,EAAG,iBAAiB,CAAC;IAQ/B,UAAU,EAAG,MAAM,CAAC;IAOpB,UAAU,EAAG,MAAM,CAAC;IAQpB,aAAa,EAAG,MAAM,CAAC;IASvB,UAAU,CAAC,EAAE,MAAM,CAAC;IASpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAK1B,OAAO,EAAG,QAAQ,CAAC;CACpB"}
@@ -0,0 +1,97 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.IntegrationWebhookEnvelopeDto = void 0;
13
+ const swagger_1 = require("@nestjs/swagger");
14
+ const class_validator_1 = require("class-validator");
15
+ const integration_webhooks_1 = require("../../lib/integration-webhooks");
16
+ class IntegrationWebhookEnvelopeDto {
17
+ provider;
18
+ adapterKey;
19
+ event;
20
+ entityKind;
21
+ deliveryId;
22
+ occurredAt;
23
+ correlationId;
24
+ externalId;
25
+ externalSpaceKey;
26
+ payload;
27
+ }
28
+ exports.IntegrationWebhookEnvelopeDto = IntegrationWebhookEnvelopeDto;
29
+ __decorate([
30
+ (0, swagger_1.ApiProperty)({
31
+ enum: integration_webhooks_1.ConnectorKind,
32
+ enumName: 'ConnectorKind',
33
+ description: 'External provider that emitted the webhook.',
34
+ example: integration_webhooks_1.ConnectorKind.GITHUB,
35
+ }),
36
+ (0, class_validator_1.IsEnum)(integration_webhooks_1.ConnectorKind),
37
+ __metadata("design:type", String)
38
+ ], IntegrationWebhookEnvelopeDto.prototype, "provider", void 0);
39
+ __decorate([
40
+ (0, class_validator_1.IsEnum)(integration_webhooks_1.AdapterKey),
41
+ __metadata("design:type", String)
42
+ ], IntegrationWebhookEnvelopeDto.prototype, "adapterKey", void 0);
43
+ __decorate([
44
+ (0, swagger_1.ApiProperty)({
45
+ description: 'Canonical event name. Per-domain enums define the allowed values (ScmWebhookEvent, TrackerWebhookEvent, DocWebhookEvent).',
46
+ example: 'scm.issue.opened',
47
+ }),
48
+ (0, class_validator_1.IsString)(),
49
+ __metadata("design:type", String)
50
+ ], IntegrationWebhookEnvelopeDto.prototype, "event", void 0);
51
+ __decorate([
52
+ (0, class_validator_1.IsEnum)(integration_webhooks_1.WebhookEntityKind),
53
+ __metadata("design:type", String)
54
+ ], IntegrationWebhookEnvelopeDto.prototype, "entityKind", void 0);
55
+ __decorate([
56
+ (0, swagger_1.ApiProperty)({
57
+ description: "Provider-native delivery identifier. Stable across retries — the adapter's dedup table keys off (provider, deliveryId).",
58
+ example: '72d3162e-cc78-11e3-81ab-4c9367dc0958',
59
+ }),
60
+ (0, class_validator_1.IsString)(),
61
+ __metadata("design:type", String)
62
+ ], IntegrationWebhookEnvelopeDto.prototype, "deliveryId", void 0);
63
+ __decorate([
64
+ (0, swagger_1.ApiProperty)({
65
+ description: 'ISO-8601 timestamp when the provider emitted this event.',
66
+ example: '2026-04-17T13:45:00.000Z',
67
+ }),
68
+ (0, class_validator_1.IsISO8601)(),
69
+ __metadata("design:type", String)
70
+ ], IntegrationWebhookEnvelopeDto.prototype, "occurredAt", void 0);
71
+ __decorate([
72
+ (0, swagger_1.ApiProperty)({
73
+ description: 'Correlation id for tracing; propagated into domain service logs via X-Correlation-Id.',
74
+ example: '550e8400-e29b-41d4-a716-446655440000',
75
+ }),
76
+ (0, class_validator_1.IsUUID)(),
77
+ __metadata("design:type", String)
78
+ ], IntegrationWebhookEnvelopeDto.prototype, "correlationId", void 0);
79
+ __decorate([
80
+ (0, swagger_1.ApiPropertyOptional)({
81
+ description: 'External entity id in the provider (e.g. GitHub issue id, Jira issue key).',
82
+ example: '123456789',
83
+ }),
84
+ (0, class_validator_1.IsOptional)(),
85
+ (0, class_validator_1.IsString)(),
86
+ __metadata("design:type", String)
87
+ ], IntegrationWebhookEnvelopeDto.prototype, "externalId", void 0);
88
+ __decorate([
89
+ (0, swagger_1.ApiPropertyOptional)({
90
+ description: 'Provider-native grouping key — repoSlug for SCM, spaceKey for Confluence, projectKey for Jira.',
91
+ example: 'acme/billing',
92
+ }),
93
+ (0, class_validator_1.IsOptional)(),
94
+ (0, class_validator_1.IsString)(),
95
+ __metadata("design:type", String)
96
+ ], IntegrationWebhookEnvelopeDto.prototype, "externalSpaceKey", void 0);
97
+ //# sourceMappingURL=integration-webhook-envelope.dto.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"integration-webhook-envelope.dto.js","sourceRoot":"","sources":["../../../src/nestjs/integration-webhooks/integration-webhook-envelope.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6CAAmE;AACnE,qDAMyB;AAEzB,yEAIwC;AAwBxC,MAAa,6BAA6B;IAQxC,QAAQ,CAAiB;IASzB,UAAU,CAAc;IAQxB,KAAK,CAAU;IAIf,UAAU,CAAqB;IAQ/B,UAAU,CAAU;IAOpB,UAAU,CAAU;IAQpB,aAAa,CAAU;IASvB,UAAU,CAAU;IASpB,gBAAgB,CAAU;IAK1B,OAAO,CAAY;CACpB;AA5ED,sEA4EC;AApEC;IAPC,IAAA,qBAAW,EAAC;QACX,IAAI,EAAE,oCAAa;QACnB,QAAQ,EAAE,eAAe;QACzB,WAAW,EAAE,6CAA6C;QAC1D,OAAO,EAAE,oCAAa,CAAC,MAAM;KAC9B,CAAC;IACD,IAAA,wBAAM,EAAC,oCAAa,CAAC;;+DACG;AASzB;IADC,IAAA,wBAAM,EAAC,iCAAU,CAAC;;iEACK;AAQxB;IANC,IAAA,qBAAW,EAAC;QACX,WAAW,EACT,2HAA2H;QAC7H,OAAO,EAAE,kBAAkB;KAC5B,CAAC;IACD,IAAA,0BAAQ,GAAE;;4DACI;AAIf;IADC,IAAA,wBAAM,EAAC,wCAAiB,CAAC;;iEACK;AAQ/B;IANC,IAAA,qBAAW,EAAC;QACX,WAAW,EACT,yHAAyH;QAC3H,OAAO,EAAE,sCAAsC;KAChD,CAAC;IACD,IAAA,0BAAQ,GAAE;;iEACS;AAOpB;IALC,IAAA,qBAAW,EAAC;QACX,WAAW,EAAE,0DAA0D;QACvE,OAAO,EAAE,0BAA0B;KACpC,CAAC;IACD,IAAA,2BAAS,GAAE;;iEACQ;AAQpB;IANC,IAAA,qBAAW,EAAC;QACX,WAAW,EACT,uFAAuF;QACzF,OAAO,EAAE,sCAAsC;KAChD,CAAC;IACD,IAAA,wBAAM,GAAE;;oEACc;AASvB;IAPC,IAAA,6BAAmB,EAAC;QACnB,WAAW,EACT,4EAA4E;QAC9E,OAAO,EAAE,WAAW;KACrB,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;iEACS;AASpB;IAPC,IAAA,6BAAmB,EAAC;QACnB,WAAW,EACT,gGAAgG;QAClG,OAAO,EAAE,cAAc;KACxB,CAAC;IACD,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;uEACe"}
@@ -0,0 +1,48 @@
1
+ export interface DecodedJwtHeader {
2
+ alg: string;
3
+ typ?: string;
4
+ kid?: string;
5
+ }
6
+ export interface DecodedJwtPayload {
7
+ iss?: string;
8
+ sub?: string;
9
+ exp?: number;
10
+ iat?: number;
11
+ nbf?: number;
12
+ aud?: string | string[];
13
+ [key: string]: unknown;
14
+ }
15
+ export interface Jwk {
16
+ kty: string;
17
+ kid: string;
18
+ use?: string;
19
+ n?: string;
20
+ e?: string;
21
+ x5c?: string[];
22
+ alg?: string;
23
+ }
24
+ export declare class JwksVerificationError extends Error {
25
+ constructor(message: string);
26
+ }
27
+ export interface JwksVerifyOptions {
28
+ jwksUrl: string;
29
+ cacheKey: string;
30
+ expectedIssuers?: readonly string[];
31
+ }
32
+ export declare class JwksVerifier {
33
+ private readonly cacheTtlMs;
34
+ private readonly caches;
35
+ constructor(cacheTtlMs?: number);
36
+ decode(jwt: string): {
37
+ header: DecodedJwtHeader;
38
+ payload: DecodedJwtPayload;
39
+ };
40
+ verify(jwt: string, options: JwksVerifyOptions): Promise<DecodedJwtPayload>;
41
+ private assertIssuer;
42
+ private verifySignature;
43
+ private getSigningKey;
44
+ private fetchJwks;
45
+ private resolveKey;
46
+ private mapAlgorithm;
47
+ }
48
+ //# sourceMappingURL=jwks-verifier.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jwks-verifier.d.ts","sourceRoot":"","sources":["../../../src/nestjs/jwks/jwks-verifier.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAOD,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,MAAM,WAAW,GAAG;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAuBD,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAKD,MAAM,WAAW,iBAAiB;IAKhC,OAAO,EAAE,MAAM,CAAC;IAMhB,QAAQ,EAAE,MAAM,CAAC;IASjB,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAkBD,qBAAa,YAAY;IASX,OAAO,CAAC,QAAQ,CAAC,UAAU;IAPvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;gBAO9B,UAAU,GAAE,MAAgB;IAQzD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,gBAAgB,CAAC;QAAC,OAAO,EAAE,iBAAiB,CAAA;KAAE;IAyBvE,MAAM,CACV,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC;IAoC7B,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,eAAe;YAqBT,aAAa;YAsBb,SAAS;IAiCvB,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,YAAY;CAYrB"}
@@ -0,0 +1,177 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.JwksVerifier = exports.JwksVerificationError = void 0;
37
+ const crypto = __importStar(require("node:crypto"));
38
+ class JwksVerificationError extends Error {
39
+ constructor(message) {
40
+ super(message);
41
+ this.name = 'JwksVerificationError';
42
+ }
43
+ }
44
+ exports.JwksVerificationError = JwksVerificationError;
45
+ class JwksVerifier {
46
+ cacheTtlMs;
47
+ caches = new Map();
48
+ constructor(cacheTtlMs = 600_000) {
49
+ this.cacheTtlMs = cacheTtlMs;
50
+ }
51
+ decode(jwt) {
52
+ const [headerB64, payloadB64, signatureB64] = jwt.split('.');
53
+ if (!headerB64 || !payloadB64 || !signatureB64) {
54
+ throw new JwksVerificationError('Invalid token format');
55
+ }
56
+ let header;
57
+ let payload;
58
+ try {
59
+ header = JSON.parse(Buffer.from(headerB64, 'base64url').toString('utf8'));
60
+ payload = JSON.parse(Buffer.from(payloadB64, 'base64url').toString('utf8'));
61
+ }
62
+ catch {
63
+ throw new JwksVerificationError('Invalid token format');
64
+ }
65
+ return { header, payload };
66
+ }
67
+ async verify(jwt, options) {
68
+ const [headerB64, payloadB64, signatureB64] = jwt.split('.');
69
+ if (!headerB64 || !payloadB64 || !signatureB64) {
70
+ throw new JwksVerificationError('Invalid token format');
71
+ }
72
+ const { header, payload } = this.decode(jwt);
73
+ const nowMs = Date.now();
74
+ if (typeof payload.exp === 'number' && nowMs >= payload.exp * 1000) {
75
+ throw new JwksVerificationError('Token expired');
76
+ }
77
+ if (typeof payload.nbf === 'number' && nowMs < payload.nbf * 1000) {
78
+ throw new JwksVerificationError('Token not yet valid');
79
+ }
80
+ if (options.expectedIssuers && options.expectedIssuers.length > 0) {
81
+ this.assertIssuer(payload.iss, options.expectedIssuers);
82
+ }
83
+ const publicKey = await this.getSigningKey(options.cacheKey, options.jwksUrl, header.kid);
84
+ this.verifySignature(headerB64, payloadB64, signatureB64, header.alg, publicKey);
85
+ return payload;
86
+ }
87
+ assertIssuer(iss, expectedIssuers) {
88
+ if (!iss) {
89
+ throw new JwksVerificationError('Token missing required issuer claim');
90
+ }
91
+ const realmSuffixes = [
92
+ ...new Set(expectedIssuers
93
+ .map((candidate) => candidate.match(/(\/realms\/[^/]+)$/)?.[1])
94
+ .filter((suffix) => Boolean(suffix))),
95
+ ];
96
+ const matched = expectedIssuers.includes(iss) ||
97
+ realmSuffixes.some((suffix) => iss.endsWith(suffix));
98
+ if (!matched) {
99
+ throw new JwksVerificationError('Invalid token issuer');
100
+ }
101
+ }
102
+ verifySignature(headerB64, payloadB64, signatureB64, alg, publicKey) {
103
+ const data = `${headerB64}.${payloadB64}`;
104
+ const signature = Buffer.from(signatureB64, 'base64url');
105
+ const algorithm = this.mapAlgorithm(alg);
106
+ const isValid = crypto.verify(algorithm, Buffer.from(data), publicKey, signature);
107
+ if (!isValid) {
108
+ throw new JwksVerificationError('Invalid token signature');
109
+ }
110
+ }
111
+ async getSigningKey(cacheKey, jwksUrl, kid) {
112
+ let cache = this.caches.get(cacheKey);
113
+ if (cache &&
114
+ kid &&
115
+ cache.keys.has(kid) &&
116
+ Date.now() - cache.lastFetch < this.cacheTtlMs) {
117
+ return cache.keys.get(kid);
118
+ }
119
+ const keys = await this.fetchJwks(jwksUrl);
120
+ cache = { keys, lastFetch: Date.now() };
121
+ this.caches.set(cacheKey, cache);
122
+ return this.resolveKey(cache, kid);
123
+ }
124
+ async fetchJwks(jwksUrl) {
125
+ let response;
126
+ try {
127
+ response = await fetch(jwksUrl);
128
+ }
129
+ catch (error) {
130
+ const msg = error instanceof Error ? error.message : String(error);
131
+ throw new JwksVerificationError(`Failed to reach JWKS endpoint ${jwksUrl}: ${msg}`);
132
+ }
133
+ if (!response.ok) {
134
+ throw new JwksVerificationError(`Failed to fetch JWKS from ${jwksUrl}: ${response.status}`);
135
+ }
136
+ const jwks = (await response.json());
137
+ const keys = new Map();
138
+ for (const key of jwks.keys) {
139
+ if (key.kty === 'RSA' && key.n && key.e) {
140
+ const publicKey = crypto.createPublicKey({
141
+ key: { kty: 'RSA', n: key.n, e: key.e },
142
+ format: 'jwk',
143
+ });
144
+ keys.set(key.kid, publicKey);
145
+ }
146
+ }
147
+ return keys;
148
+ }
149
+ resolveKey(cache, kid) {
150
+ if (kid) {
151
+ const key = cache.keys.get(kid);
152
+ if (!key) {
153
+ throw new JwksVerificationError(`Signing key not found for kid: ${kid}`);
154
+ }
155
+ return key;
156
+ }
157
+ const firstKey = cache.keys.values().next().value;
158
+ if (!firstKey) {
159
+ throw new JwksVerificationError('No valid signing keys found in JWKS');
160
+ }
161
+ return firstKey;
162
+ }
163
+ mapAlgorithm(alg) {
164
+ switch (alg) {
165
+ case 'RS256':
166
+ return 'sha256';
167
+ case 'RS384':
168
+ return 'sha384';
169
+ case 'RS512':
170
+ return 'sha512';
171
+ default:
172
+ throw new JwksVerificationError(`Unsupported JWT algorithm: ${alg}`);
173
+ }
174
+ }
175
+ }
176
+ exports.JwksVerifier = JwksVerifier;
177
+ //# sourceMappingURL=jwks-verifier.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jwks-verifier.js","sourceRoot":"","sources":["../../../src/nestjs/jwks/jwks-verifier.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ import { CanActivate, ExecutionContext } from '@nestjs/common';
2
+ import type { AuthModuleOptions } from './auth/auth-module-options';
3
+ export declare class JwtVerificationGuard implements CanActivate {
4
+ private readonly authOptions?;
5
+ private readonly logger;
6
+ private readonly jwks;
7
+ private static readonly SINGLE_REALM_CACHE_KEY;
8
+ private multiRealmConfig;
9
+ private resolvingConfig;
10
+ constructor(authOptions?: AuthModuleOptions | undefined);
11
+ canActivate(context: ExecutionContext): Promise<boolean>;
12
+ private verifyToken;
13
+ private decodeOrThrow;
14
+ private verifyWithJwks;
15
+ private verifyMultiRealm;
16
+ private verifySingleRealm;
17
+ private resolveMultiRealmConfig;
18
+ private resolveKeycloakBaseUrl;
19
+ private resolveAllowedRealms;
20
+ private appendIssuerBaseUrls;
21
+ private extractRealmFromIssuer;
22
+ private attachRealmToContext;
23
+ private isPublicPath;
24
+ }
25
+ //# sourceMappingURL=jwt-verification.guard.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"jwt-verification.guard.d.ts","sourceRoot":"","sources":["../../src/nestjs/jwt-verification.guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EACX,gBAAgB,EAKjB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAyCpE,qBACa,oBAAqB,YAAW,WAAW;IA6BpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IA5B/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAShE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAGlD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAgB;IAG9D,OAAO,CAAC,gBAAgB,CAGR;IAEhB,OAAO,CAAC,eAAe,CAGC;gBAKL,WAAW,CAAC,EAAE,iBAAiB,YAAA;IAG5C,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;YAwChD,WAAW;IAsBzB,OAAO,CAAC,aAAa;YAmBP,cAAc;YAed,gBAAgB;YAoChB,iBAAiB;YA0CjB,uBAAuB;YA4CvB,sBAAsB;YAQtB,oBAAoB;IAclC,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,YAAY;CAYrB"}