@terreno/api 57.3.0 → 57.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (412) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +11 -5
  3. package/bunfig.toml +1 -1
  4. package/dist/actions.js +197 -368
  5. package/dist/adminModelRouter.js +88 -173
  6. package/dist/adminTypes.d.ts +7 -0
  7. package/dist/adminTypes.js +6 -1
  8. package/dist/api.d.ts +10 -0
  9. package/dist/api.js +601 -792
  10. package/dist/audit/auditApp.d.ts +30 -0
  11. package/dist/audit/auditApp.js +114 -0
  12. package/dist/audit/auditEventModel.d.ts +29 -0
  13. package/dist/audit/auditEventModel.js +101 -0
  14. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  15. package/dist/audit/cloudTasksEnqueue.js +69 -0
  16. package/dist/audit/diff.d.ts +10 -0
  17. package/dist/audit/diff.js +140 -0
  18. package/dist/audit/processQueue.d.ts +6 -0
  19. package/dist/audit/processQueue.js +56 -0
  20. package/dist/audit/rbacSink.d.ts +2 -0
  21. package/dist/audit/rbacSink.js +41 -0
  22. package/dist/audit/record.d.ts +56 -0
  23. package/dist/audit/record.js +251 -0
  24. package/dist/auth.js +432 -681
  25. package/dist/authRecovery.js +155 -269
  26. package/dist/authTokens.js +43 -118
  27. package/dist/betterAuth.d.ts +6 -0
  28. package/dist/betterAuthApp.js +25 -26
  29. package/dist/betterAuthSetup.js +258 -413
  30. package/dist/browserLogsRoute.d.ts +6 -0
  31. package/dist/browserLogsRoute.js +97 -0
  32. package/dist/collectionRegistry.d.ts +3 -1
  33. package/dist/collectionRegistry.js +43 -33
  34. package/dist/config.js +53 -122
  35. package/dist/configurationApp.js +180 -361
  36. package/dist/configurationPlugin.js +130 -302
  37. package/dist/consentApp.js +276 -421
  38. package/dist/docLoader.js +78 -126
  39. package/dist/envConfigurationPlugin.js +25 -147
  40. package/dist/errors.js +151 -247
  41. package/dist/example.js +28 -34
  42. package/dist/expressServer.d.ts +10 -0
  43. package/dist/expressServer.js +109 -255
  44. package/dist/frameworkModelNames.d.ts +24 -0
  45. package/dist/frameworkModelNames.js +31 -0
  46. package/dist/githubAuth.js +152 -216
  47. package/dist/httpClient.js +176 -264
  48. package/dist/index.d.ts +28 -1
  49. package/dist/index.js +53 -2
  50. package/dist/logger.js +145 -278
  51. package/dist/mcp/auth.js +76 -128
  52. package/dist/mcp/createMCPRequest.js +4 -5
  53. package/dist/mcp/handlers.js +268 -480
  54. package/dist/mcp/query.d.ts +0 -13
  55. package/dist/mcp/query.js +57 -151
  56. package/dist/mcp/registry.js +17 -30
  57. package/dist/mcp/schemaGenerator.js +95 -181
  58. package/dist/mcp/server.js +28 -100
  59. package/dist/mcp/serviceTokens.js +102 -191
  60. package/dist/mcp/toolGenerator.js +78 -191
  61. package/dist/middleware.js +15 -27
  62. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  63. package/dist/migrations/fixtures/all-down/20260910120000-one.js +9 -0
  64. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  65. package/dist/migrations/fixtures/all-down/20260910120001-two.js +9 -0
  66. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  67. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +7 -0
  68. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  69. package/dist/migrations/fixtures/bad-name/not-a-migration.js +7 -0
  70. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  71. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  72. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  73. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +7 -0
  74. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  75. package/dist/migrations/fixtures/valid/20260910120001-beta.js +9 -0
  76. package/dist/migrations/generate.d.ts +17 -0
  77. package/dist/migrations/generate.js +155 -0
  78. package/dist/migrations/load.d.ts +20 -0
  79. package/dist/migrations/load.js +110 -0
  80. package/dist/migrations/lock.d.ts +13 -0
  81. package/dist/migrations/lock.js +73 -0
  82. package/dist/migrations/runner.d.ts +42 -0
  83. package/dist/migrations/runner.js +249 -0
  84. package/dist/migrations/schemaCatalog.d.ts +44 -0
  85. package/dist/migrations/schemaCatalog.js +185 -0
  86. package/dist/migrations/types.d.ts +87 -0
  87. package/dist/migrations/types.js +7 -0
  88. package/dist/models/consentForm.js +6 -6
  89. package/dist/models/consentResponse.js +5 -5
  90. package/dist/models/mcpServiceToken.js +66 -156
  91. package/dist/models/notification.d.ts +2 -0
  92. package/dist/models/notification.js +62 -0
  93. package/dist/models/notificationPreference.d.ts +2 -0
  94. package/dist/models/notificationPreference.js +49 -0
  95. package/dist/models/versionConfig.js +5 -5
  96. package/dist/notifications/notificationService.d.ts +40 -0
  97. package/dist/notifications/notificationService.js +183 -0
  98. package/dist/notifications/notificationsApp.d.ts +18 -0
  99. package/dist/notifications/notificationsApp.js +156 -0
  100. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  101. package/dist/notifications/notificationsBeforeSend.js +32 -0
  102. package/dist/notifiers/googleChatNotifier.js +36 -117
  103. package/dist/notifiers/slackNotifier.d.ts +31 -2
  104. package/dist/notifiers/slackNotifier.js +170 -119
  105. package/dist/notifiers/zoomNotifier.js +60 -111
  106. package/dist/openApi.d.ts +1 -7
  107. package/dist/openApi.js +113 -127
  108. package/dist/openApiBuilder.d.ts +14 -3
  109. package/dist/openApiBuilder.js +117 -159
  110. package/dist/openApiCompat.js +81 -148
  111. package/dist/openApiEtag.js +7 -7
  112. package/dist/openApiValidator.d.ts +13 -1
  113. package/dist/openApiValidator.js +301 -246
  114. package/dist/orgs/orgContext.d.ts +23 -0
  115. package/dist/orgs/orgContext.js +128 -0
  116. package/dist/orgs/orgPermissions.d.ts +4 -0
  117. package/dist/orgs/orgPermissions.js +38 -0
  118. package/dist/orgs/orgPlugin.d.ts +13 -0
  119. package/dist/orgs/orgPlugin.js +66 -0
  120. package/dist/orgs/organizationModel.d.ts +13 -0
  121. package/dist/orgs/organizationModel.js +200 -0
  122. package/dist/orgs/organizationSettings.d.ts +19 -0
  123. package/dist/orgs/organizationSettings.js +113 -0
  124. package/dist/orgs/orgsApp.d.ts +28 -0
  125. package/dist/orgs/orgsApp.js +416 -0
  126. package/dist/permissions.d.ts +7 -13
  127. package/dist/permissions.js +95 -211
  128. package/dist/plugins.js +125 -218
  129. package/dist/populate.js +130 -240
  130. package/dist/rateLimit/applyTrustProxy.js +1 -1
  131. package/dist/rateLimit/createStore.js +7 -8
  132. package/dist/rateLimit/memoryStore.js +22 -100
  133. package/dist/rateLimit/middleware.d.ts +0 -8
  134. package/dist/rateLimit/middleware.js +49 -101
  135. package/dist/rateLimit/mongoStore.d.ts +1 -0
  136. package/dist/rateLimit/mongoStore.js +55 -112
  137. package/dist/rateLimit/policies.d.ts +0 -4
  138. package/dist/rateLimit/policies.js +44 -80
  139. package/dist/rateLimit/redisStore.d.ts +1 -0
  140. package/dist/rateLimit/redisStore.js +40 -133
  141. package/dist/rbac/access.js +122 -253
  142. package/dist/rbac/assertAllowed.js +95 -171
  143. package/dist/rbac/auditModel.js +14 -58
  144. package/dist/rbac/backfillAdmins.js +24 -130
  145. package/dist/rbac/fieldViews.js +46 -141
  146. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  147. package/dist/rbac/membershipOrgAdminSource.js +51 -0
  148. package/dist/rbac/middleware.js +30 -96
  149. package/dist/rbac/modelRouterAccess.d.ts +3 -0
  150. package/dist/rbac/modelRouterAccess.js +133 -307
  151. package/dist/rbac/permissionUtils.js +40 -179
  152. package/dist/rbac/realtimeAccess.js +81 -147
  153. package/dist/rbac/resolve.d.ts +1 -1
  154. package/dist/rbac/resolve.js +154 -319
  155. package/dist/rbac/roleManager.js +318 -700
  156. package/dist/rbac/roleModel.d.ts +2 -5
  157. package/dist/rbac/roleModel.js +60 -173
  158. package/dist/rbac/routes.js +93 -196
  159. package/dist/rbac/scopes.js +39 -133
  160. package/dist/rbac/statements.d.ts +10 -1
  161. package/dist/rbac/statements.js +42 -93
  162. package/dist/rbac/types.d.ts +5 -0
  163. package/dist/rbac/userPlugin.js +3 -29
  164. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  165. package/dist/realtime/changeStreamWatcher.js +499 -764
  166. package/dist/realtime/deprecation.d.ts +1 -0
  167. package/dist/realtime/deprecation.js +9 -10
  168. package/dist/realtime/queryMatcher.js +110 -191
  169. package/dist/realtime/queryStore.js +35 -118
  170. package/dist/realtime/realtimeApp.d.ts +1 -0
  171. package/dist/realtime/realtimeApp.js +248 -401
  172. package/dist/realtime/registry.js +19 -30
  173. package/dist/realtime/sessionRevalidation.js +132 -358
  174. package/dist/realtime/socketAuth.js +89 -208
  175. package/dist/realtime/socketUser.js +10 -56
  176. package/dist/requestContext.js +93 -139
  177. package/dist/schemaMetadata.js +181 -265
  178. package/dist/scriptRunner.js +96 -266
  179. package/dist/scrubAdminFields.js +36 -108
  180. package/dist/secretProviders.js +130 -299
  181. package/dist/seedRunner.js +221 -514
  182. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  183. package/dist/sync/adminBroadcastScope.js +82 -0
  184. package/dist/sync/adminWindowAccess.d.ts +13 -0
  185. package/dist/sync/adminWindowAccess.js +25 -0
  186. package/dist/sync/adminWindowMutation.d.ts +88 -0
  187. package/dist/sync/adminWindowMutation.js +176 -0
  188. package/dist/sync/executors.d.ts +9 -3
  189. package/dist/sync/executors.js +425 -598
  190. package/dist/sync/loadHarness.js +392 -689
  191. package/dist/sync/models.js +181 -341
  192. package/dist/sync/mutationHandler.d.ts +5 -2
  193. package/dist/sync/mutationHandler.js +549 -697
  194. package/dist/sync/registrationSideEffects.js +41 -95
  195. package/dist/sync/registry.js +31 -47
  196. package/dist/sync/routes.d.ts +13 -0
  197. package/dist/sync/routes.js +484 -760
  198. package/dist/sync/scripts/compactTombstones.js +83 -228
  199. package/dist/sync/serialize.js +18 -58
  200. package/dist/sync/socketHandlers.d.ts +8 -2
  201. package/dist/sync/socketHandlers.js +271 -402
  202. package/dist/sync/streams.d.ts +2 -0
  203. package/dist/sync/streams.js +54 -116
  204. package/dist/sync/syncApp.d.ts +2 -1
  205. package/dist/sync/syncApp.js +14 -16
  206. package/dist/sync/syncBatch.d.ts +5 -2
  207. package/dist/sync/syncBatch.js +63 -168
  208. package/dist/sync/syncSeqPlugin.js +430 -702
  209. package/dist/sync/types.d.ts +18 -0
  210. package/dist/syncConsents.js +113 -253
  211. package/dist/terrenoApp.d.ts +29 -0
  212. package/dist/terrenoApp.js +184 -257
  213. package/dist/tests/createTestData.d.ts +1 -3
  214. package/dist/tests/createTestData.js +147 -259
  215. package/dist/tests/models.d.ts +1 -0
  216. package/dist/tests/models.js +23 -56
  217. package/dist/tests/mongoTestSetup.js +42 -103
  218. package/dist/tests/testHelper.d.ts +0 -5
  219. package/dist/tests/testHelper.js +32 -101
  220. package/dist/tests.js +12 -51
  221. package/dist/transformers.js +61 -164
  222. package/dist/types/authToken.d.ts +3 -3
  223. package/dist/types/mcpServiceToken.d.ts +2 -2
  224. package/dist/types/membership.d.ts +23 -0
  225. package/dist/types/membership.js +2 -0
  226. package/dist/types/notification.d.ts +28 -0
  227. package/dist/types/notification.js +2 -0
  228. package/dist/types/notificationPreference.d.ts +20 -0
  229. package/dist/types/notificationPreference.js +2 -0
  230. package/dist/types/organization.d.ts +36 -0
  231. package/dist/types/organization.js +2 -0
  232. package/dist/utils.js +31 -93
  233. package/dist/vendor/wesleytodd-openapi/index.js +37 -51
  234. package/dist/vendor/wesleytodd-openapi/lib/generate-doc.js +32 -40
  235. package/dist/vendor/wesleytodd-openapi/lib/layer-schema.js +3 -3
  236. package/dist/vendor/wesleytodd-openapi/lib/ui.js +50 -19
  237. package/dist/vendor/wesleytodd-openapi/lib/validate.js +19 -47
  238. package/dist/versionCheckPlugin.js +52 -100
  239. package/dist/webhooks/headerValue.js +2 -2
  240. package/dist/webhooks/idempotency/memoryStore.js +16 -59
  241. package/dist/webhooks/idempotency/mongoStore.js +55 -130
  242. package/dist/webhooks/idempotency/webhookReceipt.d.ts +4 -49
  243. package/dist/webhooks/idempotency/webhookReceipt.js +14 -14
  244. package/dist/webhooks/rawBody.d.ts +1 -0
  245. package/dist/webhooks/rawBody.js +2 -1
  246. package/dist/webhooks/timingSafeEqual.js +4 -5
  247. package/dist/webhooks/verifiers/hmac.js +17 -18
  248. package/dist/webhooks/verifiers/sendgrid.js +20 -22
  249. package/dist/webhooks/verifiers/stripe.js +31 -65
  250. package/dist/webhooks/verifiers/twilio.js +23 -73
  251. package/dist/webhooks/webhooksApp.js +78 -177
  252. package/dist/zodOpenApi.js +2 -2
  253. package/package.json +34 -28
  254. package/src/__snapshots__/openApi.test.ts.snap +192 -54
  255. package/src/__snapshots__/openApiBuilder.test.ts.snap +0 -18
  256. package/src/__snapshots__/schemaMetadata.test.ts.snap +0 -1
  257. package/src/__tests__/browserLogsRoute.test.ts +165 -0
  258. package/src/adminTypes.ts +8 -0
  259. package/src/api.test.ts +39 -2
  260. package/src/api.ts +68 -0
  261. package/src/audit/auditApp.test.ts +243 -0
  262. package/src/audit/auditApp.ts +139 -0
  263. package/src/audit/auditEventModel.ts +160 -0
  264. package/src/audit/auditRouter.test.ts +456 -0
  265. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  266. package/src/audit/cloudTasksEnqueue.ts +104 -0
  267. package/src/audit/diff.ts +163 -0
  268. package/src/audit/processQueue.ts +69 -0
  269. package/src/audit/rbacSink.test.ts +86 -0
  270. package/src/audit/rbacSink.ts +42 -0
  271. package/src/audit/record.test.ts +402 -0
  272. package/src/audit/record.ts +329 -0
  273. package/src/auth.test.ts +1 -1
  274. package/src/auth.ts +1 -1
  275. package/src/authRecovery.test.ts +43 -0
  276. package/src/authRecovery.ts +16 -10
  277. package/src/authTokens.ts +6 -2
  278. package/src/authVerification.test.ts +22 -0
  279. package/src/betterAuth.ts +7 -0
  280. package/src/betterAuthSetup.test.ts +27 -0
  281. package/src/betterAuthSetup.ts +1 -0
  282. package/src/browserLogsRoute.ts +110 -0
  283. package/src/collectionRegistry.test.ts +8 -9
  284. package/src/collectionRegistry.ts +21 -1
  285. package/src/configurationPlugin.test.ts +1 -11
  286. package/src/express.d.ts +2 -0
  287. package/src/expressServer.test.ts +50 -2
  288. package/src/expressServer.ts +10 -0
  289. package/src/frameworkModelNames.test.ts +62 -0
  290. package/src/frameworkModelNames.ts +33 -0
  291. package/src/index.ts +76 -0
  292. package/src/isolated/migrateCliConnect.isolated.ts +51 -0
  293. package/src/mcp/auth.test.ts +34 -1
  294. package/src/mcp/handlers.test.ts +275 -0
  295. package/src/mcp/query.ts +3 -3
  296. package/src/mcp/toolGenerator.test.ts +81 -0
  297. package/src/migrations/cli.test.ts +353 -0
  298. package/src/migrations/cli.ts +283 -0
  299. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  300. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  301. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  302. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  303. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  304. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  305. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  306. package/src/migrations/generate.test.ts +333 -0
  307. package/src/migrations/generate.ts +216 -0
  308. package/src/migrations/load.test.ts +103 -0
  309. package/src/migrations/load.ts +124 -0
  310. package/src/migrations/lock.test.ts +133 -0
  311. package/src/migrations/lock.ts +118 -0
  312. package/src/migrations/runner.test.ts +504 -0
  313. package/src/migrations/runner.ts +358 -0
  314. package/src/migrations/schemaCatalog.test.ts +159 -0
  315. package/src/migrations/schemaCatalog.ts +262 -0
  316. package/src/migrations/types.ts +94 -0
  317. package/src/models/mcpServiceToken.ts +4 -3
  318. package/src/models/notification.ts +69 -0
  319. package/src/models/notificationPreference.ts +62 -0
  320. package/src/notifications/notificationService.ts +254 -0
  321. package/src/notifications/notificationsApp.test.ts +528 -0
  322. package/src/notifications/notificationsApp.ts +200 -0
  323. package/src/notifications/notificationsBeforeSend.ts +51 -0
  324. package/src/notifiers/slackNotifier.test.ts +186 -1
  325. package/src/notifiers/slackNotifier.ts +167 -8
  326. package/src/openApi.test.ts +0 -1
  327. package/src/openApi.ts +2 -1
  328. package/src/openApiBuilder.ts +14 -3
  329. package/src/openApiValidator.test.ts +221 -2
  330. package/src/openApiValidator.ts +218 -33
  331. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  332. package/src/orgs/orgContext.test.ts +259 -0
  333. package/src/orgs/orgContext.ts +151 -0
  334. package/src/orgs/orgPermissions.test.ts +105 -0
  335. package/src/orgs/orgPermissions.ts +40 -0
  336. package/src/orgs/orgPlugin.test.ts +130 -0
  337. package/src/orgs/orgPlugin.ts +70 -0
  338. package/src/orgs/orgRbac.test.ts +267 -0
  339. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  340. package/src/orgs/organizationModel.test.ts +205 -0
  341. package/src/orgs/organizationModel.ts +262 -0
  342. package/src/orgs/organizationSettings.test.ts +113 -0
  343. package/src/orgs/organizationSettings.ts +126 -0
  344. package/src/orgs/orgsApp.test.ts +382 -0
  345. package/src/orgs/orgsApp.ts +563 -0
  346. package/src/permissions.test.ts +62 -36
  347. package/src/permissions.ts +8 -30
  348. package/src/plugins.test.ts +5 -0
  349. package/src/plugins.ts +3 -0
  350. package/src/rateLimit/middleware.ts +1 -1
  351. package/src/rateLimit/mongoStore.ts +1 -0
  352. package/src/rateLimit/policies.ts +2 -2
  353. package/src/rateLimit/redisStore.ts +1 -0
  354. package/src/rbac/access.ts +11 -3
  355. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  356. package/src/rbac/modelRouterAccess.ts +3 -0
  357. package/src/rbac/permissionUtils.test.ts +26 -5
  358. package/src/rbac/resolve.test.ts +34 -2
  359. package/src/rbac/resolve.ts +26 -7
  360. package/src/rbac/roleModel.test.ts +34 -1
  361. package/src/rbac/roleModel.ts +17 -1
  362. package/src/rbac/statements.test.ts +19 -0
  363. package/src/rbac/statements.ts +19 -1
  364. package/src/rbac/types.ts +5 -0
  365. package/src/realtime/changeStreamWatcher.ts +73 -33
  366. package/src/realtime/deprecation.ts +1 -0
  367. package/src/realtime/realtime.test.ts +357 -185
  368. package/src/realtime/realtimeApp.ts +2 -1
  369. package/src/schemaMetadata.test.ts +14 -0
  370. package/src/schemaMetadata.ts +5 -5
  371. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  372. package/src/sync/adminBroadcastScope.test.ts +155 -0
  373. package/src/sync/adminBroadcastScope.ts +123 -0
  374. package/src/sync/adminWindowAccess.test.ts +57 -0
  375. package/src/sync/adminWindowAccess.ts +32 -0
  376. package/src/sync/adminWindowMutation.test.ts +450 -0
  377. package/src/sync/adminWindowMutation.ts +283 -0
  378. package/src/sync/executors.ts +33 -6
  379. package/src/sync/integration.test.ts +2 -2
  380. package/src/sync/mutationHandler.test.ts +277 -1
  381. package/src/sync/mutationHandler.ts +171 -29
  382. package/src/sync/registry.ts +4 -0
  383. package/src/sync/routes.ts +52 -8
  384. package/src/sync/socketHandlers.ts +154 -58
  385. package/src/sync/streams.ts +6 -0
  386. package/src/sync/sync.test.ts +3 -2
  387. package/src/sync/syncApp.ts +2 -1
  388. package/src/sync/syncBatch.ts +7 -2
  389. package/src/sync/syncRoutes.test.ts +297 -3
  390. package/src/sync/syncSocket.test.ts +229 -0
  391. package/src/sync/types.ts +20 -0
  392. package/src/terrenoApp.migrations.test.ts +114 -0
  393. package/src/terrenoApp.test.ts +41 -0
  394. package/src/terrenoApp.ts +97 -31
  395. package/src/tests/createTestData.ts +2 -2
  396. package/src/tests/models.ts +10 -2
  397. package/src/tests/testHelper.ts +1 -7
  398. package/src/types/authToken.ts +2 -4
  399. package/src/types/mcpServiceToken.ts +1 -7
  400. package/src/types/membership.ts +48 -0
  401. package/src/types/notification.ts +34 -0
  402. package/src/types/notificationPreference.ts +28 -0
  403. package/src/types/organization.ts +49 -0
  404. package/src/types.d.ts +1 -0
  405. package/src/webhooks/idempotency/webhookReceipt.ts +8 -10
  406. package/src/webhooks/rawBody.test.ts +33 -0
  407. package/src/webhooks/rawBody.ts +1 -0
  408. package/tsconfig.json +13 -54
  409. package/tsconfig.typedoc.json +4 -1
  410. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  411. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  412. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -1,210 +1,71 @@
1
1
  "use strict";
2
- var __values = (this && this.__values) || function(o) {
3
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
4
- if (m) return m.call(o);
5
- if (o && typeof o.length === "number") return {
6
- next: function () {
7
- if (o && i >= o.length) o = void 0;
8
- return { value: o && o[i++], done: !o };
9
- }
10
- };
11
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
12
- };
13
- var __read = (this && this.__read) || function (o, n) {
14
- var m = typeof Symbol === "function" && o[Symbol.iterator];
15
- if (!m) return o;
16
- var i = m.call(o), r, ar = [], e;
17
- try {
18
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
19
- }
20
- catch (error) { e = { error: error }; }
21
- finally {
22
- try {
23
- if (r && !r.done && (m = i["return"])) m.call(i);
24
- }
25
- finally { if (e) throw e.error; }
26
- }
27
- return ar;
28
- };
29
- var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
30
- if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
31
- if (ar || !(i in from)) {
32
- if (!ar) ar = Array.prototype.slice.call(from, 0, i);
33
- ar[i] = from[i];
34
- }
35
- }
36
- return to.concat(ar || Array.prototype.slice.call(from));
37
- };
38
2
  Object.defineProperty(exports, "__esModule", { value: true });
39
3
  exports.validatePermissionSet = exports.diffPermissionSets = exports.isPermissionSubset = exports.unionPermissionSets = void 0;
40
- var errors_1 = require("../errors");
41
- var unionPermissionSets = function () {
42
- var e_1, _a, e_2, _b, e_3, _c, e_4, _d;
43
- var sets = [];
44
- for (var _i = 0; _i < arguments.length; _i++) {
45
- sets[_i] = arguments[_i];
46
- }
47
- var merged = {};
48
- try {
49
- for (var sets_1 = __values(sets), sets_1_1 = sets_1.next(); !sets_1_1.done; sets_1_1 = sets_1.next()) {
50
- var set = sets_1_1.value;
51
- if (!set) {
52
- continue;
53
- }
54
- try {
55
- for (var _e = (e_2 = void 0, __values(Object.entries(set))), _f = _e.next(); !_f.done; _f = _e.next()) {
56
- var _g = __read(_f.value, 2), resource = _g[0], actions = _g[1];
57
- if (!merged[resource]) {
58
- merged[resource] = new Set();
59
- }
60
- try {
61
- for (var actions_1 = (e_3 = void 0, __values(actions)), actions_1_1 = actions_1.next(); !actions_1_1.done; actions_1_1 = actions_1.next()) {
62
- var action = actions_1_1.value;
63
- merged[resource].add(action);
64
- }
65
- }
66
- catch (e_3_1) { e_3 = { error: e_3_1 }; }
67
- finally {
68
- try {
69
- if (actions_1_1 && !actions_1_1.done && (_c = actions_1.return)) _c.call(actions_1);
70
- }
71
- finally { if (e_3) throw e_3.error; }
72
- }
73
- }
4
+ const errors_1 = require("../errors");
5
+ const unionPermissionSets = (...sets) => {
6
+ const merged = {};
7
+ for (const set of sets) {
8
+ if (!set) {
9
+ continue;
10
+ }
11
+ for (const [resource, actions] of Object.entries(set)) {
12
+ if (!merged[resource]) {
13
+ merged[resource] = new Set();
74
14
  }
75
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
76
- finally {
77
- try {
78
- if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
79
- }
80
- finally { if (e_2) throw e_2.error; }
15
+ for (const action of actions) {
16
+ merged[resource].add(action);
81
17
  }
82
18
  }
83
19
  }
84
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
85
- finally {
86
- try {
87
- if (sets_1_1 && !sets_1_1.done && (_a = sets_1.return)) _a.call(sets_1);
88
- }
89
- finally { if (e_1) throw e_1.error; }
90
- }
91
- var result = {};
92
- try {
93
- for (var _h = __values(Object.entries(merged)), _j = _h.next(); !_j.done; _j = _h.next()) {
94
- var _k = __read(_j.value, 2), resource = _k[0], actions = _k[1];
95
- result[resource] = __spreadArray([], __read(actions), false);
96
- }
97
- }
98
- catch (e_4_1) { e_4 = { error: e_4_1 }; }
99
- finally {
100
- try {
101
- if (_j && !_j.done && (_d = _h.return)) _d.call(_h);
102
- }
103
- finally { if (e_4) throw e_4.error; }
20
+ const result = {};
21
+ for (const [resource, actions] of Object.entries(merged)) {
22
+ result[resource] = [...actions];
104
23
  }
105
24
  return result;
106
25
  };
107
26
  exports.unionPermissionSets = unionPermissionSets;
108
- var isPermissionSubset = function (actorPermissions, requestedPermissions) {
109
- var e_5, _a, e_6, _b;
110
- var _c;
111
- try {
112
- for (var _d = __values(Object.entries(requestedPermissions !== null && requestedPermissions !== void 0 ? requestedPermissions : {})), _e = _d.next(); !_e.done; _e = _d.next()) {
113
- var _f = __read(_e.value, 2), resource = _f[0], actions = _f[1];
114
- var actorActions = (_c = actorPermissions[resource]) !== null && _c !== void 0 ? _c : [];
115
- try {
116
- for (var actions_2 = (e_6 = void 0, __values(actions)), actions_2_1 = actions_2.next(); !actions_2_1.done; actions_2_1 = actions_2.next()) {
117
- var action = actions_2_1.value;
118
- if (!actorActions.includes(action)) {
119
- return false;
120
- }
121
- }
122
- }
123
- catch (e_6_1) { e_6 = { error: e_6_1 }; }
124
- finally {
125
- try {
126
- if (actions_2_1 && !actions_2_1.done && (_b = actions_2.return)) _b.call(actions_2);
127
- }
128
- finally { if (e_6) throw e_6.error; }
27
+ const isPermissionSubset = (actorPermissions, requestedPermissions) => {
28
+ for (const [resource, actions] of Object.entries(requestedPermissions ?? {})) {
29
+ const actorActions = actorPermissions[resource] ?? [];
30
+ for (const action of actions) {
31
+ if (!actorActions.includes(action)) {
32
+ return false;
129
33
  }
130
34
  }
131
35
  }
132
- catch (e_5_1) { e_5 = { error: e_5_1 }; }
133
- finally {
134
- try {
135
- if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
136
- }
137
- finally { if (e_5) throw e_5.error; }
138
- }
139
36
  return true;
140
37
  };
141
38
  exports.isPermissionSubset = isPermissionSubset;
142
- var diffPermissionSets = function (before, after) {
143
- var e_7, _a;
144
- var _b, _c;
145
- var gained = {};
146
- var lost = {};
147
- var resources = new Set(__spreadArray(__spreadArray([], __read(Object.keys(before)), false), __read(Object.keys(after)), false));
148
- var _loop_1 = function (resource) {
149
- var beforeActions = new Set((_b = before[resource]) !== null && _b !== void 0 ? _b : []);
150
- var afterActions = new Set((_c = after[resource]) !== null && _c !== void 0 ? _c : []);
151
- var gainedActions = __spreadArray([], __read(afterActions), false).filter(function (action) { return !beforeActions.has(action); });
152
- var lostActions = __spreadArray([], __read(beforeActions), false).filter(function (action) { return !afterActions.has(action); });
39
+ const diffPermissionSets = (before, after) => {
40
+ const gained = {};
41
+ const lost = {};
42
+ const resources = new Set([...Object.keys(before), ...Object.keys(after)]);
43
+ for (const resource of resources) {
44
+ const beforeActions = new Set(before[resource] ?? []);
45
+ const afterActions = new Set(after[resource] ?? []);
46
+ const gainedActions = [...afterActions].filter((action) => !beforeActions.has(action));
47
+ const lostActions = [...beforeActions].filter((action) => !afterActions.has(action));
153
48
  if (gainedActions.length > 0) {
154
49
  gained[resource] = gainedActions;
155
50
  }
156
51
  if (lostActions.length > 0) {
157
52
  lost[resource] = lostActions;
158
53
  }
159
- };
160
- try {
161
- for (var resources_1 = __values(resources), resources_1_1 = resources_1.next(); !resources_1_1.done; resources_1_1 = resources_1.next()) {
162
- var resource = resources_1_1.value;
163
- _loop_1(resource);
164
- }
165
54
  }
166
- catch (e_7_1) { e_7 = { error: e_7_1 }; }
167
- finally {
168
- try {
169
- if (resources_1_1 && !resources_1_1.done && (_a = resources_1.return)) _a.call(resources_1);
170
- }
171
- finally { if (e_7) throw e_7.error; }
172
- }
173
- return { gained: gained, lost: lost };
55
+ return { gained, lost };
174
56
  };
175
57
  exports.diffPermissionSets = diffPermissionSets;
176
- var validatePermissionSet = function (permissions, statements) {
177
- var e_8, _a, e_9, _b;
178
- try {
179
- for (var _c = __values(Object.entries(permissions)), _d = _c.next(); !_d.done; _d = _c.next()) {
180
- var _e = __read(_d.value, 2), resource = _e[0], actions = _e[1];
181
- var allowedActions = statements[resource];
182
- if (!allowedActions) {
183
- throw new errors_1.APIError({ status: 500, title: "Unknown resource: ".concat(resource) });
184
- }
185
- try {
186
- for (var actions_3 = (e_9 = void 0, __values(actions)), actions_3_1 = actions_3.next(); !actions_3_1.done; actions_3_1 = actions_3.next()) {
187
- var action = actions_3_1.value;
188
- if (!allowedActions.includes(action)) {
189
- throw new errors_1.APIError({ status: 500, title: "Unknown permission: ".concat(resource, ":").concat(action) });
190
- }
191
- }
192
- }
193
- catch (e_9_1) { e_9 = { error: e_9_1 }; }
194
- finally {
195
- try {
196
- if (actions_3_1 && !actions_3_1.done && (_b = actions_3.return)) _b.call(actions_3);
197
- }
198
- finally { if (e_9) throw e_9.error; }
199
- }
58
+ const validatePermissionSet = (permissions, statements) => {
59
+ for (const [resource, actions] of Object.entries(permissions)) {
60
+ const allowedActions = statements[resource];
61
+ if (!allowedActions) {
62
+ throw new errors_1.APIError({ status: 500, title: `Unknown resource: ${resource}` });
200
63
  }
201
- }
202
- catch (e_8_1) { e_8 = { error: e_8_1 }; }
203
- finally {
204
- try {
205
- if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
64
+ for (const action of actions) {
65
+ if (!allowedActions.includes(action)) {
66
+ throw new errors_1.APIError({ status: 500, title: `Unknown permission: ${resource}:${action}` });
67
+ }
206
68
  }
207
- finally { if (e_8) throw e_8.error; }
208
69
  }
209
70
  };
210
71
  exports.validatePermissionSet = validatePermissionSet;
@@ -1,58 +1,21 @@
1
1
  "use strict";
2
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
- return new (P || (P = Promise))(function (resolve, reject) {
5
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
- step((generator = generator.apply(thisArg, _arguments || [])).next());
9
- });
10
- };
11
- var __generator = (this && this.__generator) || function (thisArg, body) {
12
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
- function verb(n) { return function (v) { return step([n, v]); }; }
15
- function step(op) {
16
- if (f) throw new TypeError("Generator is already executing.");
17
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
- if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
- if (y = 0, t) op = [op[0] & 2, t.value];
20
- switch (op[0]) {
21
- case 0: case 1: t = op; break;
22
- case 4: _.label++; return { value: op[1], done: false };
23
- case 5: _.label++; y = op[1]; op = [0]; continue;
24
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
- default:
26
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
- if (t[2]) _.ops.pop();
31
- _.trys.pop(); continue;
32
- }
33
- op = body.call(thisArg, _);
34
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
- }
37
- };
38
2
  Object.defineProperty(exports, "__esModule", { value: true });
39
3
  exports.maskRealtimeDocument = exports.canReadDocumentRealtime = exports.canSubscribeRealtime = void 0;
40
- var permissions_1 = require("../permissions");
41
- var fieldViews_1 = require("./fieldViews");
42
- var DEFAULT_METHOD_ACTIONS = {
4
+ const permissions_1 = require("../permissions");
5
+ const fieldViews_1 = require("./fieldViews");
6
+ const DEFAULT_METHOD_ACTIONS = {
43
7
  list: "list",
44
8
  read: "read",
45
9
  };
46
- var resolveActionForMethod = function (method, access, statements) {
47
- var _a, _b;
48
- var override = (_a = access.actions) === null || _a === void 0 ? void 0 : _a[method];
10
+ const resolveActionForMethod = (method, access, statements) => {
11
+ const override = access.actions?.[method];
49
12
  if (override === null) {
50
13
  return null;
51
14
  }
52
15
  if (override) {
53
16
  return override;
54
17
  }
55
- var resourceActions = (_b = statements[access.resource]) !== null && _b !== void 0 ? _b : [];
18
+ const resourceActions = statements[access.resource] ?? [];
56
19
  if (method === "list" && resourceActions.includes("list")) {
57
20
  return "list";
58
21
  }
@@ -61,113 +24,84 @@ var resolveActionForMethod = function (method, access, statements) {
61
24
  }
62
25
  return DEFAULT_METHOD_ACTIONS[method];
63
26
  };
64
- var canSubscribeRealtime = function (entry, method, user) { return __awaiter(void 0, void 0, void 0, function () {
65
- var access, accessControl, statements, action, result, permissions;
66
- var _a;
67
- var _b, _c;
68
- return __generator(this, function (_d) {
69
- switch (_d.label) {
70
- case 0:
71
- access = entry.options.access;
72
- accessControl = entry.options.accessControl;
73
- if (!(access && accessControl)) return [3 /*break*/, 2];
74
- statements = accessControl.statements;
75
- action = resolveActionForMethod(method, access, statements);
76
- if (!action) {
77
- return [2 /*return*/, false];
78
- }
79
- return [4 /*yield*/, accessControl.can({
80
- context: { transport: "socket" },
81
- permissions: (_a = {}, _a[access.resource] = [action], _a),
82
- user: user,
83
- })];
84
- case 1:
85
- result = _d.sent();
86
- return [2 /*return*/, result.allowed];
87
- case 2:
88
- permissions = (_c = (_b = entry.options.permissions) === null || _b === void 0 ? void 0 : _b[method]) !== null && _c !== void 0 ? _c : [];
89
- return [2 /*return*/, (0, permissions_1.checkPermissions)(method, permissions, user)];
27
+ const canSubscribeRealtime = async (entry, method, user) => {
28
+ const access = entry.options.access;
29
+ const accessControl = entry.options.accessControl;
30
+ if (access && accessControl) {
31
+ const statements = accessControl.statements;
32
+ const action = resolveActionForMethod(method, access, statements);
33
+ if (!action) {
34
+ return false;
90
35
  }
91
- });
92
- }); };
36
+ const result = await accessControl.can({
37
+ context: { transport: "socket" },
38
+ permissions: { [access.resource]: [action] },
39
+ user,
40
+ });
41
+ return result.allowed;
42
+ }
43
+ const permissions = entry.options.permissions?.[method] ?? [];
44
+ return (0, permissions_1.checkPermissions)(method, permissions, user);
45
+ };
93
46
  exports.canSubscribeRealtime = canSubscribeRealtime;
94
- var canReadDocumentRealtime = function (entry, user, doc) { return __awaiter(void 0, void 0, void 0, function () {
95
- var access, accessControl, statements, action, result, scopeResult, extra;
96
- var _a;
97
- var _b, _c, _d;
98
- return __generator(this, function (_e) {
99
- switch (_e.label) {
100
- case 0:
101
- access = entry.options.access;
102
- accessControl = entry.options.accessControl;
103
- if (!(access && accessControl)) return [3 /*break*/, 5];
104
- statements = accessControl.statements;
105
- action = resolveActionForMethod("read", access, statements);
106
- if (!action) {
107
- return [2 /*return*/, false];
108
- }
109
- return [4 /*yield*/, accessControl.can({
110
- context: { transport: "socket" },
111
- doc: doc,
112
- permissions: (_a = {}, _a[access.resource] = [action], _a),
113
- user: user,
114
- })];
115
- case 1:
116
- result = _e.sent();
117
- if (!result.allowed) {
118
- return [2 /*return*/, false];
119
- }
120
- if (!((_b = access.scope) === null || _b === void 0 ? void 0 : _b.check)) return [3 /*break*/, 4];
121
- if (!user) {
122
- return [2 /*return*/, false];
123
- }
124
- return [4 /*yield*/, access.scope.check({
125
- action: action,
126
- doc: doc,
127
- user: user,
128
- })];
129
- case 2:
130
- scopeResult = _e.sent();
131
- if (scopeResult === false) {
132
- return [2 /*return*/, false];
133
- }
134
- if (!(scopeResult && typeof scopeResult === "object")) return [3 /*break*/, 4];
135
- return [4 /*yield*/, accessControl.can({
136
- context: { transport: "socket" },
137
- doc: doc,
138
- permissions: scopeResult,
139
- user: user,
140
- })];
141
- case 3:
142
- extra = _e.sent();
143
- return [2 /*return*/, extra.allowed];
144
- case 4: return [2 /*return*/, true];
145
- case 5: return [2 /*return*/, (0, permissions_1.checkPermissions)("read", (_d = (_c = entry.options.permissions) === null || _c === void 0 ? void 0 : _c.read) !== null && _d !== void 0 ? _d : [], user, doc)];
47
+ const canReadDocumentRealtime = async (entry, user, doc) => {
48
+ const access = entry.options.access;
49
+ const accessControl = entry.options.accessControl;
50
+ if (access && accessControl) {
51
+ const statements = accessControl.statements;
52
+ const action = resolveActionForMethod("read", access, statements);
53
+ if (!action) {
54
+ return false;
146
55
  }
147
- });
148
- }); };
149
- exports.canReadDocumentRealtime = canReadDocumentRealtime;
150
- var maskRealtimeDocument = function (entry, user, doc, _method) { return __awaiter(void 0, void 0, void 0, function () {
151
- var access, accessControl, phase, mask;
152
- return __generator(this, function (_a) {
153
- switch (_a.label) {
154
- case 0:
155
- access = entry.options.access;
156
- accessControl = entry.options.accessControl;
157
- if (!access || !accessControl) {
158
- return [2 /*return*/, doc];
159
- }
160
- phase = "read";
161
- return [4 /*yield*/, accessControl.fieldMask({
162
- doc: doc,
163
- phase: phase,
164
- resource: access.resource,
165
- user: user,
166
- })];
167
- case 1:
168
- mask = _a.sent();
169
- return [2 /*return*/, (0, fieldViews_1.applyReadMask)(doc, mask)];
56
+ const result = await accessControl.can({
57
+ context: { transport: "socket" },
58
+ doc,
59
+ permissions: { [access.resource]: [action] },
60
+ user,
61
+ });
62
+ if (!result.allowed) {
63
+ return false;
170
64
  }
65
+ if (access.scope?.check) {
66
+ if (!user) {
67
+ return false;
68
+ }
69
+ const scopeResult = await access.scope.check({
70
+ action,
71
+ doc,
72
+ user,
73
+ });
74
+ if (scopeResult === false) {
75
+ return false;
76
+ }
77
+ if (scopeResult && typeof scopeResult === "object") {
78
+ const extra = await accessControl.can({
79
+ context: { transport: "socket" },
80
+ doc,
81
+ permissions: scopeResult,
82
+ user,
83
+ });
84
+ return extra.allowed;
85
+ }
86
+ }
87
+ return true;
88
+ }
89
+ return (0, permissions_1.checkPermissions)("read", entry.options.permissions?.read ?? [], user, doc);
90
+ };
91
+ exports.canReadDocumentRealtime = canReadDocumentRealtime;
92
+ const maskRealtimeDocument = async (entry, user, doc, _method) => {
93
+ const access = entry.options.access;
94
+ const accessControl = entry.options.accessControl;
95
+ if (!access || !accessControl) {
96
+ return doc;
97
+ }
98
+ const phase = "read";
99
+ const mask = await accessControl.fieldMask({
100
+ doc,
101
+ phase,
102
+ resource: access.resource,
103
+ user,
171
104
  });
172
- }); };
105
+ return (0, fieldViews_1.applyReadMask)(doc, mask);
106
+ };
173
107
  exports.maskRealtimeDocument = maskRealtimeDocument;
@@ -13,7 +13,7 @@ export declare const createPermissionResolver: <S extends Statements>(args: {
13
13
  }) => Promise<PermissionSet | null>;
14
14
  }) => {
15
15
  ac: {
16
- newRole<const TRoleStatements extends import("better-auth/plugins/access").Statements>(statements: import("better-auth/plugins/access").RoleInput<S, TRoleStatements>): import("better-auth/plugins/access").Role<import("better-auth/plugins/access").ExactRoleStatements<TRoleStatements>, S>;
16
+ newRole<const TRoleStatements extends import("better-auth/plugins/access", { with: { "resolution-mode": "import" } }).Statements>(statements: import("better-auth/plugins/access", { with: { "resolution-mode": "import" } }).RoleInput<S, TRoleStatements>): import("better-auth/plugins/access", { with: { "resolution-mode": "import" } }).Role<import("better-auth/plugins/access", { with: { "resolution-mode": "import" } }).ExactRoleStatements<TRoleStatements>, S>;
17
17
  statements: S;
18
18
  };
19
19
  authorizePermissions: (permissions: PermissionSet, request: PermissionSet) => {