@terreno/api 57.2.0 → 57.4.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 (472) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +23 -7
  3. package/dist/actions.js +19 -7
  4. package/dist/adminTypes.d.ts +7 -0
  5. package/dist/adminTypes.js +6 -1
  6. package/dist/api.d.ts +14 -0
  7. package/dist/api.js +111 -60
  8. package/dist/audit/auditApp.d.ts +30 -0
  9. package/dist/audit/auditApp.js +155 -0
  10. package/dist/audit/auditEventModel.d.ts +29 -0
  11. package/dist/audit/auditEventModel.js +102 -0
  12. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  13. package/dist/audit/cloudTasksEnqueue.js +162 -0
  14. package/dist/audit/diff.d.ts +10 -0
  15. package/dist/audit/diff.js +230 -0
  16. package/dist/audit/processQueue.d.ts +6 -0
  17. package/dist/audit/processQueue.js +101 -0
  18. package/dist/audit/rbacSink.d.ts +2 -0
  19. package/dist/audit/rbacSink.js +82 -0
  20. package/dist/audit/record.d.ts +56 -0
  21. package/dist/audit/record.js +373 -0
  22. package/dist/auth.d.ts +23 -10
  23. package/dist/auth.js +97 -32
  24. package/dist/authRecovery.d.ts +5 -0
  25. package/dist/authRecovery.js +350 -0
  26. package/dist/authTokens.d.ts +8 -0
  27. package/dist/authTokens.js +162 -0
  28. package/dist/betterAuth.d.ts +39 -0
  29. package/dist/betterAuthApp.d.ts +4 -0
  30. package/dist/betterAuthApp.js +26 -8
  31. package/dist/betterAuthSetup.d.ts +44 -2
  32. package/dist/betterAuthSetup.js +288 -18
  33. package/dist/collectionRegistry.d.ts +40 -0
  34. package/dist/collectionRegistry.js +97 -0
  35. package/dist/configurationApp.d.ts +11 -2
  36. package/dist/configurationApp.js +2 -4
  37. package/dist/docLoader.js +35 -6
  38. package/dist/expressServer.d.ts +26 -3
  39. package/dist/expressServer.js +79 -11
  40. package/dist/index.d.ts +42 -1
  41. package/dist/index.js +84 -2
  42. package/dist/mcp/auth.d.ts +1 -0
  43. package/dist/mcp/auth.js +47 -25
  44. package/dist/mcp/handlers.d.ts +1 -1
  45. package/dist/mcp/handlers.js +67 -233
  46. package/dist/mcp/query.d.ts +2 -15
  47. package/dist/mcp/query.js +8 -8
  48. package/dist/mcp/registry.d.ts +1 -5
  49. package/dist/mcp/registry.js +31 -20
  50. package/dist/mcp/schemaGenerator.d.ts +2 -7
  51. package/dist/mcp/schemaGenerator.js +41 -116
  52. package/dist/mcp/server.d.ts +1 -0
  53. package/dist/mcp/server.js +1 -0
  54. package/dist/mcp/serviceTokens.d.ts +16 -0
  55. package/dist/mcp/serviceTokens.js +345 -0
  56. package/dist/mcp/types.d.ts +2 -2
  57. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  58. package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
  59. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  60. package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
  61. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  62. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
  63. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  64. package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
  65. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  66. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  67. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  68. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
  69. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  70. package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
  71. package/dist/migrations/generate.d.ts +17 -0
  72. package/dist/migrations/generate.js +277 -0
  73. package/dist/migrations/load.d.ts +20 -0
  74. package/dist/migrations/load.js +236 -0
  75. package/dist/migrations/lock.d.ts +13 -0
  76. package/dist/migrations/lock.js +145 -0
  77. package/dist/migrations/runner.d.ts +42 -0
  78. package/dist/migrations/runner.js +503 -0
  79. package/dist/migrations/schemaCatalog.d.ts +44 -0
  80. package/dist/migrations/schemaCatalog.js +326 -0
  81. package/dist/migrations/types.d.ts +87 -0
  82. package/dist/migrations/types.js +7 -0
  83. package/dist/models/mcpServiceToken.d.ts +3 -0
  84. package/dist/models/mcpServiceToken.js +208 -0
  85. package/dist/models/notification.d.ts +2 -0
  86. package/dist/models/notification.js +62 -0
  87. package/dist/models/notificationPreference.d.ts +2 -0
  88. package/dist/models/notificationPreference.js +49 -0
  89. package/dist/notifications/notificationService.d.ts +40 -0
  90. package/dist/notifications/notificationService.js +323 -0
  91. package/dist/notifications/notificationsApp.d.ts +18 -0
  92. package/dist/notifications/notificationsApp.js +250 -0
  93. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  94. package/dist/notifications/notificationsBeforeSend.js +77 -0
  95. package/dist/openApi.d.ts +1 -7
  96. package/dist/openApi.js +7 -6
  97. package/dist/openApiBuilder.d.ts +19 -7
  98. package/dist/openApiBuilder.js +61 -8
  99. package/dist/openApiCompat.js +1 -1
  100. package/dist/openApiValidator.d.ts +13 -1
  101. package/dist/openApiValidator.js +200 -38
  102. package/dist/orgs/orgContext.d.ts +23 -0
  103. package/dist/orgs/orgContext.js +198 -0
  104. package/dist/orgs/orgPermissions.d.ts +4 -0
  105. package/dist/orgs/orgPermissions.js +77 -0
  106. package/dist/orgs/orgPlugin.d.ts +13 -0
  107. package/dist/orgs/orgPlugin.js +84 -0
  108. package/dist/orgs/organizationModel.d.ts +13 -0
  109. package/dist/orgs/organizationModel.js +301 -0
  110. package/dist/orgs/organizationSettings.d.ts +19 -0
  111. package/dist/orgs/organizationSettings.js +120 -0
  112. package/dist/orgs/orgsApp.d.ts +28 -0
  113. package/dist/orgs/orgsApp.js +678 -0
  114. package/dist/permissions.d.ts +7 -13
  115. package/dist/permissions.js +8 -31
  116. package/dist/plugins.d.ts +14 -1
  117. package/dist/plugins.js +17 -6
  118. package/dist/populate.d.ts +2 -2
  119. package/dist/populate.js +47 -42
  120. package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
  121. package/dist/rateLimit/applyTrustProxy.js +17 -0
  122. package/dist/rateLimit/createStore.d.ts +2 -0
  123. package/dist/rateLimit/createStore.js +28 -0
  124. package/dist/rateLimit/memoryStore.d.ts +2 -0
  125. package/dist/rateLimit/memoryStore.js +108 -0
  126. package/dist/rateLimit/middleware.d.ts +3 -0
  127. package/dist/rateLimit/middleware.js +109 -0
  128. package/dist/rateLimit/mongoStore.d.ts +4 -0
  129. package/dist/rateLimit/mongoStore.js +123 -0
  130. package/dist/rateLimit/policies.d.ts +10 -0
  131. package/dist/rateLimit/policies.js +149 -0
  132. package/dist/rateLimit/redisStore.d.ts +4 -0
  133. package/dist/rateLimit/redisStore.js +156 -0
  134. package/dist/rateLimit/types.d.ts +54 -0
  135. package/dist/rateLimit/types.js +9 -0
  136. package/dist/rbac/access.js +35 -14
  137. package/dist/rbac/assertAllowed.d.ts +9 -0
  138. package/dist/rbac/assertAllowed.js +182 -0
  139. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  140. package/dist/rbac/membershipOrgAdminSource.js +122 -0
  141. package/dist/rbac/modelRouterAccess.d.ts +4 -0
  142. package/dist/rbac/modelRouterAccess.js +11 -4
  143. package/dist/rbac/permissionUtils.js +3 -2
  144. package/dist/rbac/resolve.js +65 -35
  145. package/dist/rbac/roleModel.d.ts +2 -5
  146. package/dist/rbac/roleModel.js +18 -4
  147. package/dist/rbac/routes.js +15 -6
  148. package/dist/rbac/statements.d.ts +10 -1
  149. package/dist/rbac/statements.js +19 -2
  150. package/dist/rbac/types.d.ts +5 -0
  151. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  152. package/dist/realtime/changeStreamWatcher.js +110 -64
  153. package/dist/realtime/deprecation.d.ts +13 -0
  154. package/dist/realtime/deprecation.js +33 -0
  155. package/dist/realtime/realtimeApp.d.ts +2 -1
  156. package/dist/realtime/realtimeApp.js +11 -11
  157. package/dist/realtime/registry.d.ts +0 -31
  158. package/dist/realtime/registry.js +44 -31
  159. package/dist/realtime/socketAuth.d.ts +5 -5
  160. package/dist/realtime/socketAuth.js +11 -1
  161. package/dist/realtime/socketUser.d.ts +5 -1
  162. package/dist/realtime/types.d.ts +14 -4
  163. package/dist/schemaMetadata.d.ts +56 -0
  164. package/dist/schemaMetadata.js +524 -0
  165. package/dist/seedRunner.d.ts +88 -0
  166. package/dist/seedRunner.js +627 -0
  167. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  168. package/dist/sync/adminBroadcastScope.js +194 -0
  169. package/dist/sync/adminWindowAccess.d.ts +13 -0
  170. package/dist/sync/adminWindowAccess.js +96 -0
  171. package/dist/sync/adminWindowMutation.d.ts +88 -0
  172. package/dist/sync/adminWindowMutation.js +247 -0
  173. package/dist/sync/executors.d.ts +19 -3
  174. package/dist/sync/executors.js +194 -165
  175. package/dist/sync/loadHarness.js +28 -19
  176. package/dist/sync/models.js +26 -24
  177. package/dist/sync/mutationHandler.d.ts +14 -2
  178. package/dist/sync/mutationHandler.js +201 -76
  179. package/dist/sync/registrationSideEffects.d.ts +35 -0
  180. package/dist/sync/registrationSideEffects.js +151 -0
  181. package/dist/sync/registry.d.ts +2 -52
  182. package/dist/sync/registry.js +42 -187
  183. package/dist/sync/routes.d.ts +13 -0
  184. package/dist/sync/routes.js +116 -58
  185. package/dist/sync/scripts/compactTombstones.js +0 -2
  186. package/dist/sync/socketHandlers.d.ts +8 -2
  187. package/dist/sync/socketHandlers.js +144 -50
  188. package/dist/sync/streams.d.ts +2 -0
  189. package/dist/sync/streams.js +7 -1
  190. package/dist/sync/syncApp.d.ts +4 -3
  191. package/dist/sync/syncApp.js +5 -4
  192. package/dist/sync/syncBatch.d.ts +5 -2
  193. package/dist/sync/syncBatch.js +7 -6
  194. package/dist/sync/syncSeqPlugin.d.ts +1 -1
  195. package/dist/sync/syncSeqPlugin.js +20 -16
  196. package/dist/sync/types.d.ts +18 -0
  197. package/dist/terrenoApp.d.ts +48 -5
  198. package/dist/terrenoApp.js +157 -72
  199. package/dist/tests/createTestData.d.ts +1 -3
  200. package/dist/tests/createTestData.js +3 -5
  201. package/dist/tests/models.d.ts +3 -0
  202. package/dist/tests/models.js +15 -2
  203. package/dist/tests/testHelper.d.ts +0 -5
  204. package/dist/tests/testHelper.js +2 -9
  205. package/dist/types/authToken.d.ts +33 -0
  206. package/dist/types/authToken.js +2 -0
  207. package/dist/types/mcpServiceToken.d.ts +41 -0
  208. package/dist/types/mcpServiceToken.js +2 -0
  209. package/dist/types/membership.d.ts +23 -0
  210. package/dist/types/membership.js +2 -0
  211. package/dist/types/notification.d.ts +28 -0
  212. package/dist/types/notification.js +2 -0
  213. package/dist/types/notificationPreference.d.ts +20 -0
  214. package/dist/types/notificationPreference.js +2 -0
  215. package/dist/types/organization.d.ts +36 -0
  216. package/dist/types/organization.js +2 -0
  217. package/dist/webhooks/headerValue.d.ts +2 -0
  218. package/dist/webhooks/headerValue.js +14 -0
  219. package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
  220. package/dist/webhooks/idempotency/memoryStore.js +65 -0
  221. package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
  222. package/dist/webhooks/idempotency/mongoStore.js +150 -0
  223. package/dist/webhooks/idempotency/webhookReceipt.d.ts +17 -0
  224. package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
  225. package/dist/webhooks/rawBody.d.ts +15 -0
  226. package/dist/webhooks/rawBody.js +23 -0
  227. package/dist/webhooks/timingSafeEqual.d.ts +4 -0
  228. package/dist/webhooks/timingSafeEqual.js +17 -0
  229. package/dist/webhooks/verifiers/hmac.d.ts +15 -0
  230. package/dist/webhooks/verifiers/hmac.js +49 -0
  231. package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
  232. package/dist/webhooks/verifiers/sendgrid.js +56 -0
  233. package/dist/webhooks/verifiers/stripe.d.ts +9 -0
  234. package/dist/webhooks/verifiers/stripe.js +99 -0
  235. package/dist/webhooks/verifiers/twilio.d.ts +9 -0
  236. package/dist/webhooks/verifiers/twilio.js +112 -0
  237. package/dist/webhooks/webhooksApp.d.ts +33 -0
  238. package/dist/webhooks/webhooksApp.js +195 -0
  239. package/package.json +32 -27
  240. package/src/__snapshots__/openApi.test.ts.snap +444 -36
  241. package/src/__snapshots__/openApiBuilder.test.ts.snap +24 -24
  242. package/src/__snapshots__/schemaMetadata.test.ts.snap +196 -0
  243. package/src/actions.ts +20 -13
  244. package/src/adminModelRouter.test.ts +133 -0
  245. package/src/adminTypes.ts +8 -0
  246. package/src/api.arrayOperations.test.ts +43 -31
  247. package/src/api.hooks.test.ts +38 -29
  248. package/src/api.query.test.ts +31 -31
  249. package/src/api.test.ts +133 -97
  250. package/src/api.ts +84 -27
  251. package/src/audit/auditApp.test.ts +243 -0
  252. package/src/audit/auditApp.ts +139 -0
  253. package/src/audit/auditEventModel.ts +156 -0
  254. package/src/audit/auditRouter.test.ts +456 -0
  255. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  256. package/src/audit/cloudTasksEnqueue.ts +104 -0
  257. package/src/audit/diff.ts +163 -0
  258. package/src/audit/processQueue.ts +69 -0
  259. package/src/audit/rbacSink.test.ts +86 -0
  260. package/src/audit/rbacSink.ts +42 -0
  261. package/src/audit/record.test.ts +402 -0
  262. package/src/audit/record.ts +328 -0
  263. package/src/auth.test.ts +108 -52
  264. package/src/auth.ts +98 -29
  265. package/src/authRecovery.test.ts +281 -0
  266. package/src/authRecovery.ts +279 -0
  267. package/src/authTokens.test.ts +94 -0
  268. package/src/authTokens.ts +118 -0
  269. package/src/authVerification.test.ts +293 -0
  270. package/src/betterAuth.ts +31 -0
  271. package/src/betterAuthApp.test.ts +1 -0
  272. package/src/betterAuthApp.ts +27 -9
  273. package/src/betterAuthSetup.test.ts +595 -38
  274. package/src/betterAuthSetup.ts +261 -5
  275. package/src/collectionRegistry.test.ts +164 -0
  276. package/src/collectionRegistry.ts +135 -0
  277. package/src/configurationApp.ts +13 -7
  278. package/src/docLoader.test.ts +45 -1
  279. package/src/docLoader.ts +37 -6
  280. package/src/express.d.ts +3 -0
  281. package/src/expressServer.test.ts +180 -68
  282. package/src/expressServer.ts +75 -19
  283. package/src/githubAuth.test.ts +60 -55
  284. package/src/index.ts +127 -0
  285. package/src/mcp/auth.test.ts +47 -0
  286. package/src/mcp/auth.ts +32 -11
  287. package/src/mcp/handlers.test.ts +275 -0
  288. package/src/mcp/handlers.ts +45 -172
  289. package/src/mcp/integration.test.ts +59 -9
  290. package/src/mcp/query.ts +5 -7
  291. package/src/mcp/registry.ts +29 -20
  292. package/src/mcp/schemaGenerator.test.ts +8 -0
  293. package/src/mcp/schemaGenerator.ts +49 -131
  294. package/src/mcp/server.ts +2 -0
  295. package/src/mcp/serviceTokens.test.ts +330 -0
  296. package/src/mcp/serviceTokens.ts +307 -0
  297. package/src/mcp/toolGenerator.test.ts +82 -1
  298. package/src/mcp/types.ts +2 -6
  299. package/src/migrations/cli.test.ts +376 -0
  300. package/src/migrations/cli.ts +283 -0
  301. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  302. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  303. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  304. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  305. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  306. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  307. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  308. package/src/migrations/generate.test.ts +333 -0
  309. package/src/migrations/generate.ts +216 -0
  310. package/src/migrations/load.test.ts +103 -0
  311. package/src/migrations/load.ts +124 -0
  312. package/src/migrations/lock.test.ts +133 -0
  313. package/src/migrations/lock.ts +118 -0
  314. package/src/migrations/runner.test.ts +504 -0
  315. package/src/migrations/runner.ts +358 -0
  316. package/src/migrations/schemaCatalog.test.ts +159 -0
  317. package/src/migrations/schemaCatalog.ts +262 -0
  318. package/src/migrations/types.ts +94 -0
  319. package/src/models/mcpServiceToken.test.ts +129 -0
  320. package/src/models/mcpServiceToken.ts +158 -0
  321. package/src/models/notification.ts +68 -0
  322. package/src/models/notificationPreference.ts +62 -0
  323. package/src/notifications/notificationService.ts +254 -0
  324. package/src/notifications/notificationsApp.test.ts +505 -0
  325. package/src/notifications/notificationsApp.ts +200 -0
  326. package/src/notifications/notificationsBeforeSend.ts +51 -0
  327. package/src/openApi.test.ts +80 -65
  328. package/src/openApi.ts +2 -1
  329. package/src/openApiBuilder.test.ts +95 -7
  330. package/src/openApiBuilder.ts +60 -12
  331. package/src/openApiCompat.ts +1 -1
  332. package/src/openApiValidator.test.ts +270 -56
  333. package/src/openApiValidator.ts +219 -36
  334. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  335. package/src/orgs/orgContext.test.ts +259 -0
  336. package/src/orgs/orgContext.ts +151 -0
  337. package/src/orgs/orgPermissions.test.ts +105 -0
  338. package/src/orgs/orgPermissions.ts +40 -0
  339. package/src/orgs/orgPlugin.test.ts +130 -0
  340. package/src/orgs/orgPlugin.ts +70 -0
  341. package/src/orgs/orgRbac.test.ts +267 -0
  342. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  343. package/src/orgs/organizationModel.test.ts +205 -0
  344. package/src/orgs/organizationModel.ts +257 -0
  345. package/src/orgs/organizationSettings.test.ts +113 -0
  346. package/src/orgs/organizationSettings.ts +126 -0
  347. package/src/orgs/orgsApp.test.ts +382 -0
  348. package/src/orgs/orgsApp.ts +563 -0
  349. package/src/permissions.test.ts +62 -36
  350. package/src/permissions.ts +8 -30
  351. package/src/plugins.test.ts +14 -0
  352. package/src/plugins.ts +34 -9
  353. package/src/populate.test.ts +34 -0
  354. package/src/populate.ts +40 -29
  355. package/src/rateLimit/applyTrustProxy.ts +17 -0
  356. package/src/rateLimit/createStore.ts +25 -0
  357. package/src/rateLimit/memoryStore.ts +40 -0
  358. package/src/rateLimit/middleware.ts +79 -0
  359. package/src/rateLimit/mongoStore.test.ts +80 -0
  360. package/src/rateLimit/mongoStore.ts +77 -0
  361. package/src/rateLimit/policies.ts +130 -0
  362. package/src/rateLimit/rateLimit.test.ts +328 -0
  363. package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
  364. package/src/rateLimit/redisStore.test.ts +114 -0
  365. package/src/rateLimit/redisStore.ts +86 -0
  366. package/src/rateLimit/types.ts +64 -0
  367. package/src/rbac/access.ts +16 -4
  368. package/src/rbac/assertAllowed.test.ts +325 -0
  369. package/src/rbac/assertAllowed.ts +157 -0
  370. package/src/rbac/backfillAdmins.test.ts +124 -0
  371. package/src/rbac/fieldViews.test.ts +89 -0
  372. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  373. package/src/rbac/modelRouterAccess.test.ts +126 -0
  374. package/src/rbac/modelRouterAccess.ts +8 -2
  375. package/src/rbac/permissionUtils.test.ts +26 -5
  376. package/src/rbac/permissionUtils.ts +3 -2
  377. package/src/rbac/realtimeAccess.test.ts +109 -1
  378. package/src/rbac/resolve.test.ts +34 -2
  379. package/src/rbac/resolve.ts +31 -11
  380. package/src/rbac/roleManager.test.ts +169 -0
  381. package/src/rbac/roleModel.test.ts +34 -1
  382. package/src/rbac/roleModel.ts +17 -1
  383. package/src/rbac/routes.test.ts +233 -0
  384. package/src/rbac/routes.ts +16 -6
  385. package/src/rbac/statements.test.ts +19 -0
  386. package/src/rbac/statements.ts +19 -1
  387. package/src/rbac/types.ts +5 -0
  388. package/src/realtime/changeStreamWatcher.ts +73 -33
  389. package/src/realtime/deprecation.test.ts +60 -0
  390. package/src/realtime/deprecation.ts +33 -0
  391. package/src/realtime/realtime.test.ts +365 -189
  392. package/src/realtime/realtimeApp.ts +11 -11
  393. package/src/realtime/realtimeAppSetup.test.ts +32 -5
  394. package/src/realtime/registry.ts +48 -42
  395. package/src/realtime/sessionRevalidation.test.ts +57 -44
  396. package/src/realtime/socketAuth.test.ts +75 -23
  397. package/src/realtime/socketAuth.ts +17 -6
  398. package/src/realtime/socketUser.ts +5 -3
  399. package/src/realtime/types.ts +14 -4
  400. package/src/schemaMetadata.test.ts +419 -0
  401. package/src/schemaMetadata.ts +593 -0
  402. package/src/scrubAdminFields.test.ts +105 -0
  403. package/src/seedRunner.test.ts +591 -0
  404. package/src/seedRunner.ts +464 -0
  405. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  406. package/src/sync/adminBroadcastScope.test.ts +155 -0
  407. package/src/sync/adminBroadcastScope.ts +123 -0
  408. package/src/sync/adminWindowAccess.test.ts +57 -0
  409. package/src/sync/adminWindowAccess.ts +32 -0
  410. package/src/sync/adminWindowMutation.test.ts +450 -0
  411. package/src/sync/adminWindowMutation.ts +283 -0
  412. package/src/sync/docMatchesMutationData.test.ts +16 -0
  413. package/src/sync/ensureSyncIndexes.test.ts +54 -15
  414. package/src/sync/executors.test.ts +40 -0
  415. package/src/sync/executors.ts +57 -18
  416. package/src/sync/integration.test.ts +15 -7
  417. package/src/sync/loadHarness.ts +28 -19
  418. package/src/sync/models.ts +32 -18
  419. package/src/sync/mutationHandler.test.ts +293 -17
  420. package/src/sync/mutationHandler.ts +180 -36
  421. package/src/sync/registrationSideEffects.test.ts +126 -0
  422. package/src/sync/registrationSideEffects.ts +131 -0
  423. package/src/sync/registry.ts +49 -171
  424. package/src/sync/routes.ts +55 -10
  425. package/src/sync/scripts/compactTombstones.ts +0 -2
  426. package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
  427. package/src/sync/socketHandlers.ts +154 -58
  428. package/src/sync/streams.ts +6 -0
  429. package/src/sync/sync.test.ts +28 -25
  430. package/src/sync/syncApp.ts +5 -4
  431. package/src/sync/syncBatch.ts +10 -4
  432. package/src/sync/syncFrontier.test.ts +17 -15
  433. package/src/sync/syncPhaseC.test.ts +54 -43
  434. package/src/sync/syncRoutes.test.ts +347 -38
  435. package/src/sync/syncSeqPlugin.ts +66 -44
  436. package/src/sync/syncSocket.test.ts +341 -81
  437. package/src/sync/types.ts +20 -0
  438. package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
  439. package/src/terrenoApp.migrations.test.ts +114 -0
  440. package/src/terrenoApp.test.ts +41 -0
  441. package/src/terrenoApp.ts +181 -46
  442. package/src/tests/createTestData.ts +2 -2
  443. package/src/tests/models.ts +24 -3
  444. package/src/tests/testHelper.ts +1 -7
  445. package/src/types/authToken.ts +41 -0
  446. package/src/types/mcpServiceToken.ts +48 -0
  447. package/src/types/membership.ts +48 -0
  448. package/src/types/notification.ts +34 -0
  449. package/src/types/notificationPreference.ts +28 -0
  450. package/src/types/organization.ts +49 -0
  451. package/src/webhooks/headerValue.test.ts +22 -0
  452. package/src/webhooks/headerValue.ts +12 -0
  453. package/src/webhooks/idempotency/memoryStore.ts +34 -0
  454. package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
  455. package/src/webhooks/idempotency/mongoStore.ts +83 -0
  456. package/src/webhooks/idempotency/webhookReceipt.ts +67 -0
  457. package/src/webhooks/rawBody.test.ts +107 -0
  458. package/src/webhooks/rawBody.ts +24 -0
  459. package/src/webhooks/timingSafeEqual.ts +16 -0
  460. package/src/webhooks/verifiers/hmac.test.ts +110 -0
  461. package/src/webhooks/verifiers/hmac.ts +54 -0
  462. package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
  463. package/src/webhooks/verifiers/sendgrid.ts +59 -0
  464. package/src/webhooks/verifiers/stripe.ts +67 -0
  465. package/src/webhooks/verifiers/twilio.ts +69 -0
  466. package/src/webhooks/webhooksApp.test.ts +221 -0
  467. package/src/webhooks/webhooksApp.ts +144 -0
  468. package/tsconfig.json +1 -1
  469. package/tsconfig.typedoc.json +2 -1
  470. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  471. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  472. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -107,13 +107,18 @@ export declare const isVersionError: (error: unknown) => boolean;
107
107
  * `transformer.transform`, `preCreate`, `Model.create` (Mongoose validation), population,
108
108
  * and `postCreate`. Throws APIErrors with the same statuses/titles as the REST handler.
109
109
  */
110
- export declare const executeCreate: <T>({ model, options, user, body, req, skipPostHooks, }: {
110
+ export declare const executeCreate: <T>({ model, options, user, body, req, skipPermissionChecks, skipPostHooks, writeModelName, }: {
111
111
  model: Model<T>;
112
112
  options: ModelRouterOptions<T>;
113
113
  user?: User;
114
114
  body: unknown;
115
115
  /** The real Express request when called over HTTP; hooks receive a `{user}` stub otherwise. */
116
116
  req?: express.Request;
117
+ /**
118
+ * Name used for User-role stripping after hooks. Defaults to `model.modelName`.
119
+ * MCP passes the registry `modelName` because compiled mongoose names can differ.
120
+ */
121
+ writeModelName?: string;
117
122
  /**
118
123
  * C5 (FIX 6): when true, skip the built-in `postCreate` call — the caller
119
124
  * (the sync mutation handler) runs it manually AFTER finalizing the
@@ -121,6 +126,8 @@ export declare const executeCreate: <T>({ model, options, user, body, req, skipP
121
126
  * committed write look like a failure. REST handlers never set this.
122
127
  */
123
128
  skipPostHooks?: boolean;
129
+ /** When true, skip modelRouter permission checks (admin-window sync mutations). */
130
+ skipPermissionChecks?: boolean;
124
131
  }) => Promise<ExecutorResult<T>>;
125
132
  /**
126
133
  * C5 (FIX 6): run `postCreate` outside the write transaction/ledger-finalize
@@ -141,7 +148,7 @@ export declare const runPostCreate: <T>({ doc, options, request, }: {
141
148
  * population, and `postUpdate`. Throws APIErrors with the same statuses/titles as the REST
142
149
  * handler; concurrency conflicts throw `ExecutorConflictError` (409) carrying the server doc.
143
150
  */
144
- export declare const executeUpdate: <T>({ model, options, user, id, body, concurrencyCheck, existingDoc, req, skipPostHooks, }: {
151
+ export declare const executeUpdate: <T>({ model, options, user, id, body, concurrencyCheck, existingDoc, req, skipPermissionChecks, skipPostHooks, writeModelName, }: {
145
152
  model: Model<T>;
146
153
  options: ModelRouterOptions<T>;
147
154
  user?: User;
@@ -157,6 +164,13 @@ export declare const executeUpdate: <T>({ model, options, user, id, body, concur
157
164
  req?: express.Request;
158
165
  /** C5 (FIX 6): see `executeCreate`'s `skipPostHooks` doc comment. */
159
166
  skipPostHooks?: boolean;
167
+ /**
168
+ * Name used for User-role stripping after hooks. Defaults to `model.modelName`.
169
+ * MCP passes the registry `modelName` because compiled mongoose names can differ.
170
+ */
171
+ writeModelName?: string;
172
+ /** When true, skip modelRouter permission checks (admin-window sync mutations). */
173
+ skipPermissionChecks?: boolean;
160
174
  }) => Promise<ExecutorResult<T>>;
161
175
  /** C5 (FIX 6): run `postUpdate` outside the write/ledger-finalize window — see `runPostCreate`. */
162
176
  export declare const runPostUpdate: <T>({ doc, cleanedBody, prevDoc, options, request, }: {
@@ -172,7 +186,7 @@ export declare const runPostUpdate: <T>({ doc, cleanedBody, prevDoc, options, re
172
186
  * schema has a Boolean `deleted` path, else `doc.deleteOne()`), and `postDelete`. Throws
173
187
  * APIErrors with the same statuses/titles as the REST handler.
174
188
  */
175
- export declare const executeDelete: <T>({ model, options, user, id, existingDoc, req, skipPostHooks, }: {
189
+ export declare const executeDelete: <T>({ model, options, user, id, existingDoc, req, skipPermissionChecks, skipPostHooks, }: {
176
190
  model: Model<T>;
177
191
  options: ModelRouterOptions<T>;
178
192
  user?: User;
@@ -188,6 +202,8 @@ export declare const executeDelete: <T>({ model, options, user, id, existingDoc,
188
202
  req?: express.Request;
189
203
  /** C5 (FIX 6): see `executeCreate`'s `skipPostHooks` doc comment. */
190
204
  skipPostHooks?: boolean;
205
+ /** When true, skip modelRouter permission checks (admin-window sync mutations). */
206
+ skipPermissionChecks?: boolean;
191
207
  }) => Promise<ExecutorResult<T>>;
192
208
  /** C5 (FIX 6): run `postDelete` outside the write/ledger-finalize window — see `runPostCreate`. */
193
209
  export declare const runPostDelete: <T>({ doc, options, request, }: {
@@ -158,15 +158,20 @@ var reloadDocForConflict = function (model, id) { return __awaiter(void 0, void
158
158
  * and `postCreate`. Throws APIErrors with the same statuses/titles as the REST handler.
159
159
  */
160
160
  var executeCreate = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
161
- var request, cleanedBody, error_1, data, error_2, populateQuery, error_3, error_4;
162
- var model = _b.model, options = _b.options, user = _b.user, body = _b.body, req = _b.req, skipPostHooks = _b.skipPostHooks;
163
- return __generator(this, function (_c) {
164
- switch (_c.label) {
161
+ var request, _c, cleanedBody, error_1, data, error_2, populateQuery, error_3, error_4;
162
+ var model = _b.model, options = _b.options, user = _b.user, body = _b.body, req = _b.req, skipPermissionChecks = _b.skipPermissionChecks, skipPostHooks = _b.skipPostHooks, writeModelName = _b.writeModelName;
163
+ return __generator(this, function (_d) {
164
+ switch (_d.label) {
165
165
  case 0:
166
166
  request = req !== null && req !== void 0 ? req : stubRequest(user);
167
+ _c = !skipPermissionChecks;
168
+ if (!_c) return [3 /*break*/, 2];
167
169
  return [4 /*yield*/, (0, permissions_1.checkPermissions)("create", options.permissions.create, user)];
168
170
  case 1:
169
- if (!(_c.sent())) {
171
+ _c = !(_d.sent());
172
+ _d.label = 2;
173
+ case 2:
174
+ if (_c) {
170
175
  throw new errors_1.APIError({
171
176
  status: 405,
172
177
  title: "Access to CREATE on ".concat(model.modelName, " denied for ").concat(user === null || user === void 0 ? void 0 : user.id),
@@ -182,22 +187,22 @@ var executeCreate = function (_a) { return __awaiter(void 0, [_a], void 0, funct
182
187
  title: "Transform error",
183
188
  });
184
189
  }
185
- if (!options.preCreate) return [3 /*break*/, 6];
186
- _c.label = 2;
187
- case 2:
188
- _c.trys.push([2, 4, , 5]);
189
- return [4 /*yield*/, options.preCreate(cleanedBody, request)];
190
+ if (!options.preCreate) return [3 /*break*/, 7];
191
+ _d.label = 3;
190
192
  case 3:
191
- cleanedBody = _c.sent();
192
- return [3 /*break*/, 5];
193
+ _d.trys.push([3, 5, , 6]);
194
+ return [4 /*yield*/, options.preCreate(cleanedBody, request)];
193
195
  case 4:
194
- error_1 = _c.sent();
196
+ cleanedBody = _d.sent();
197
+ return [3 /*break*/, 6];
198
+ case 5:
199
+ error_1 = _d.sent();
195
200
  throw (0, errors_1.passthroughOrWrap)(error_1, {
196
201
  code: "pre-create-hook-error",
197
202
  status: 400,
198
203
  title: "preCreate hook error",
199
204
  });
200
- case 5:
205
+ case 6:
201
206
  if (cleanedBody === undefined) {
202
207
  throw new errors_1.ForbiddenError({
203
208
  code: "create-not-allowed",
@@ -212,9 +217,9 @@ var executeCreate = function (_a) { return __awaiter(void 0, [_a], void 0, funct
212
217
  title: "Create not allowed",
213
218
  });
214
219
  }
215
- _c.label = 6;
216
- case 6:
217
- cleanedBody = (0, auth_1.omitUserRolesFromWriteBody)(model.modelName, options.accessControl, cleanedBody, request
220
+ _d.label = 7;
221
+ case 7:
222
+ cleanedBody = (0, auth_1.omitUserRolesFromWriteBody)(writeModelName !== null && writeModelName !== void 0 ? writeModelName : model.modelName, options.accessControl, cleanedBody, request
218
223
  .terrenoAllowUserAdminWrite === true);
219
224
  if (cleanedBody === undefined) {
220
225
  throw new errors_1.BadRequestError({
@@ -229,57 +234,56 @@ var executeCreate = function (_a) { return __awaiter(void 0, [_a], void 0, funct
229
234
  phase: "create",
230
235
  user: user,
231
236
  })];
232
- case 7:
233
- _c.sent();
234
- _c.label = 8;
235
237
  case 8:
236
- _c.trys.push([8, 10, , 11]);
237
- return [4 /*yield*/, model.create(cleanedBody)];
238
+ _d.sent();
239
+ _d.label = 9;
238
240
  case 9:
239
- data = (_c.sent());
240
- return [3 /*break*/, 11];
241
+ _d.trys.push([9, 11, , 12]);
242
+ return [4 /*yield*/, model.create(cleanedBody)];
241
243
  case 10:
242
- error_2 = _c.sent();
244
+ data = (_d.sent());
245
+ return [3 /*break*/, 12];
246
+ case 11:
247
+ error_2 = _d.sent();
243
248
  throw (0, errors_1.passthroughOrWrapWrite)(error_2, {
244
249
  code: "create-error",
245
250
  status: 400,
246
251
  title: "Create error",
247
252
  });
248
- case 11:
249
- if (!options.populatePaths) return [3 /*break*/, 15];
250
- _c.label = 12;
251
253
  case 12:
252
- _c.trys.push([12, 14, , 15]);
253
- populateQuery = model.findById(data._id);
254
- populateQuery = (0, api_1.addPopulateToQuery)(populateQuery, options.populatePaths);
255
- return [4 /*yield*/, populateQuery.exec()];
254
+ if (!options.populatePaths) return [3 /*break*/, 16];
255
+ _d.label = 13;
256
256
  case 13:
257
- data = _c.sent();
258
- return [3 /*break*/, 15];
257
+ _d.trys.push([13, 15, , 16]);
258
+ populateQuery = (0, api_1.addPopulateToQuery)(model.findById(data._id), options.populatePaths);
259
+ return [4 /*yield*/, populateQuery.exec()];
259
260
  case 14:
260
- error_3 = _c.sent();
261
+ data = (_d.sent());
262
+ return [3 /*break*/, 16];
263
+ case 15:
264
+ error_3 = _d.sent();
261
265
  throw (0, errors_1.passthroughOrWrap)(error_3, {
262
266
  code: "populate-error",
263
267
  status: 400,
264
268
  title: "Populate error",
265
269
  });
266
- case 15:
267
- if (!(options.postCreate && !skipPostHooks)) return [3 /*break*/, 19];
268
- _c.label = 16;
269
270
  case 16:
270
- _c.trys.push([16, 18, , 19]);
271
- return [4 /*yield*/, options.postCreate(data, request)];
271
+ if (!(options.postCreate && !skipPostHooks)) return [3 /*break*/, 20];
272
+ _d.label = 17;
272
273
  case 17:
273
- _c.sent();
274
- return [3 /*break*/, 19];
274
+ _d.trys.push([17, 19, , 20]);
275
+ return [4 /*yield*/, options.postCreate(data, request)];
275
276
  case 18:
276
- error_4 = _c.sent();
277
+ _d.sent();
278
+ return [3 /*break*/, 20];
279
+ case 19:
280
+ error_4 = _d.sent();
277
281
  throw (0, errors_1.passthroughOrWrap)(error_4, {
278
282
  code: "post-create-hook-error",
279
283
  status: 400,
280
284
  title: "postCreate hook error",
281
285
  });
282
- case 19: return [2 /*return*/, { doc: data }];
286
+ case 20: return [2 /*return*/, { doc: data }];
283
287
  }
284
288
  });
285
289
  }); };
@@ -314,33 +318,43 @@ exports.runPostCreate = runPostCreate;
314
318
  * handler; concurrency conflicts throw `ExecutorConflictError` (409) carrying the server doc.
315
319
  */
316
320
  var executeUpdate = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
317
- var request, doc, _c, cleanedBody, error_5, clientTimestamp, docRecord, serverTimestamp, serverTimestampValue, serverSeq, prevDoc, error_6, current, serverSeq, populateQuery, error_7;
318
- var _d, _e, _f, _g;
319
- var model = _b.model, options = _b.options, user = _b.user, id = _b.id, body = _b.body, concurrencyCheck = _b.concurrencyCheck, existingDoc = _b.existingDoc, req = _b.req, skipPostHooks = _b.skipPostHooks;
320
- return __generator(this, function (_h) {
321
- switch (_h.label) {
321
+ var request, _c, doc, _d, _e, cleanedBody, error_5, clientTimestamp, docRecord, serverTimestamp, serverTimestampValue, serverSeq, prevDoc, error_6, current, serverSeq, populateQuery, error_7;
322
+ var _f, _g, _h, _j;
323
+ var model = _b.model, options = _b.options, user = _b.user, id = _b.id, body = _b.body, concurrencyCheck = _b.concurrencyCheck, existingDoc = _b.existingDoc, req = _b.req, skipPermissionChecks = _b.skipPermissionChecks, skipPostHooks = _b.skipPostHooks, writeModelName = _b.writeModelName;
324
+ return __generator(this, function (_k) {
325
+ switch (_k.label) {
322
326
  case 0:
323
327
  request = req !== null && req !== void 0 ? req : stubRequest(user);
328
+ _c = !skipPermissionChecks;
329
+ if (!_c) return [3 /*break*/, 2];
324
330
  return [4 /*yield*/, (0, permissions_1.checkPermissions)("update", options.permissions.update, user)];
325
331
  case 1:
326
- if (!(_h.sent())) {
332
+ _c = !(_k.sent());
333
+ _k.label = 2;
334
+ case 2:
335
+ if (_c) {
327
336
  throw new errors_1.APIError({
328
337
  status: 405,
329
338
  title: "Access to UPDATE on ".concat(model.modelName, " denied for ").concat(user === null || user === void 0 ? void 0 : user.id),
330
339
  });
331
340
  }
332
- if (!(existingDoc !== null && existingDoc !== void 0)) return [3 /*break*/, 2];
333
- _c = existingDoc;
334
- return [3 /*break*/, 4];
335
- case 2: return [4 /*yield*/, (0, docLoader_1.loadDocOr404)(model, id, options.populatePaths)];
336
- case 3:
337
- _c = (_h.sent());
338
- _h.label = 4;
341
+ if (!(existingDoc !== null && existingDoc !== void 0)) return [3 /*break*/, 3];
342
+ _d = existingDoc;
343
+ return [3 /*break*/, 5];
344
+ case 3: return [4 /*yield*/, (0, docLoader_1.loadDocOr404)(model, id, options.populatePaths)];
339
345
  case 4:
340
- doc = _c;
341
- return [4 /*yield*/, (0, permissions_1.checkPermissions)("update", options.permissions.update, user, doc)];
346
+ _d = (_k.sent());
347
+ _k.label = 5;
342
348
  case 5:
343
- if (!(_h.sent())) {
349
+ doc = _d;
350
+ _e = !skipPermissionChecks;
351
+ if (!_e) return [3 /*break*/, 7];
352
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)("update", options.permissions.update, user, doc)];
353
+ case 6:
354
+ _e = !(_k.sent());
355
+ _k.label = 7;
356
+ case 7:
357
+ if (_e) {
344
358
  throw new errors_1.APIError({
345
359
  status: 403,
346
360
  title: "Access to GET on ".concat(model.modelName, ":").concat(id, " denied for ").concat(user === null || user === void 0 ? void 0 : user.id),
@@ -365,23 +379,23 @@ var executeUpdate = function (_a) { return __awaiter(void 0, [_a], void 0, funct
365
379
  if (cleanedBody && typeof cleanedBody === "object") {
366
380
  delete cleanedBody._updatedAt;
367
381
  }
368
- if (!options.preUpdate) return [3 /*break*/, 10];
369
- _h.label = 6;
370
- case 6:
371
- _h.trys.push([6, 8, , 9]);
372
- return [4 /*yield*/, options.preUpdate(cleanedBody, request)];
373
- case 7:
374
- cleanedBody = _h.sent();
375
- return [3 /*break*/, 9];
382
+ if (!options.preUpdate) return [3 /*break*/, 12];
383
+ _k.label = 8;
376
384
  case 8:
377
- error_5 = _h.sent();
385
+ _k.trys.push([8, 10, , 11]);
386
+ return [4 /*yield*/, options.preUpdate(cleanedBody, request)];
387
+ case 9:
388
+ cleanedBody = _k.sent();
389
+ return [3 /*break*/, 11];
390
+ case 10:
391
+ error_5 = _k.sent();
378
392
  throw (0, errors_1.passthroughOrWrap)(error_5, {
379
393
  code: "pre-update-hook-error",
380
394
  detail: "preUpdate hook error on ".concat(id, ": ").concat((0, errors_1.errorMessage)(error_5)),
381
395
  status: 400,
382
396
  title: "preUpdate hook error",
383
397
  });
384
- case 9:
398
+ case 11:
385
399
  if (cleanedBody === undefined) {
386
400
  throw new errors_1.ForbiddenError({
387
401
  code: "update-not-allowed",
@@ -396,9 +410,9 @@ var executeUpdate = function (_a) { return __awaiter(void 0, [_a], void 0, funct
396
410
  title: "Update not allowed",
397
411
  });
398
412
  }
399
- _h.label = 10;
400
- case 10:
401
- cleanedBody = (0, auth_1.omitUserRolesFromWriteBody)(model.modelName, options.accessControl, cleanedBody, request
413
+ _k.label = 12;
414
+ case 12:
415
+ cleanedBody = (0, auth_1.omitUserRolesFromWriteBody)(writeModelName !== null && writeModelName !== void 0 ? writeModelName : model.modelName, options.accessControl, cleanedBody, request
402
416
  .terrenoAllowUserAdminWrite === true);
403
417
  return [4 /*yield*/, (0, modelRouterAccess_1.validateAccessWritePayload)({
404
418
  body: cleanedBody,
@@ -407,22 +421,22 @@ var executeUpdate = function (_a) { return __awaiter(void 0, [_a], void 0, funct
407
421
  phase: "write",
408
422
  user: user,
409
423
  })];
410
- case 11:
411
- _h.sent();
424
+ case 13:
425
+ _k.sent();
412
426
  // Conflict detection runs after preUpdate so that unauthorized mutations
413
427
  // are rejected before we leak document data in a conflict response.
414
428
  if ((concurrencyCheck === null || concurrencyCheck === void 0 ? void 0 : concurrencyCheck.type) === "timestamp") {
415
429
  clientTimestamp = luxon_1.DateTime.fromJSDate(concurrencyCheck.ifUnmodifiedSince);
416
430
  if (!clientTimestamp.isValid) {
417
431
  throw new errors_1.APIError({
418
- detail: (_d = concurrencyCheck.invalidTimestampDetail) !== null && _d !== void 0 ? _d : "Conflict-detection timestamp could not be parsed as a date",
432
+ detail: (_f = concurrencyCheck.invalidTimestampDetail) !== null && _f !== void 0 ? _f : "Conflict-detection timestamp could not be parsed as a date",
419
433
  status: 400,
420
434
  title: "Invalid conflict-detection timestamp",
421
435
  });
422
436
  }
423
437
  docRecord = doc;
424
438
  serverTimestamp = null;
425
- serverTimestampValue = (_e = docRecord.updated) !== null && _e !== void 0 ? _e : docRecord.created;
439
+ serverTimestampValue = (_g = docRecord.updated) !== null && _g !== void 0 ? _g : docRecord.created;
426
440
  if (serverTimestampValue instanceof Date) {
427
441
  serverTimestamp = luxon_1.DateTime.fromJSDate(serverTimestampValue);
428
442
  }
@@ -448,7 +462,7 @@ var executeUpdate = function (_a) { return __awaiter(void 0, [_a], void 0, funct
448
462
  }
449
463
  }
450
464
  else if ((concurrencyCheck === null || concurrencyCheck === void 0 ? void 0 : concurrencyCheck.type) === "seq") {
451
- serverSeq = (_f = doc._syncSeq) !== null && _f !== void 0 ? _f : 0;
465
+ serverSeq = (_h = doc._syncSeq) !== null && _h !== void 0 ? _h : 0;
452
466
  if (concurrencyCheck.baseSeq !== serverSeq) {
453
467
  throw new ExecutorConflictError({
454
468
  conflictType: "seq",
@@ -462,21 +476,21 @@ var executeUpdate = function (_a) { return __awaiter(void 0, [_a], void 0, funct
462
476
  }
463
477
  }
464
478
  prevDoc = (0, cloneDeep_1.default)(doc);
465
- _h.label = 12;
466
- case 12:
467
- _h.trys.push([12, 14, , 17]);
479
+ _k.label = 14;
480
+ case 14:
481
+ _k.trys.push([14, 16, , 19]);
468
482
  doc.set(cleanedBody);
469
483
  return [4 /*yield*/, doc.save()];
470
- case 13:
471
- _h.sent();
472
- return [3 /*break*/, 17];
473
- case 14:
474
- error_6 = _h.sent();
475
- if (!((concurrencyCheck === null || concurrencyCheck === void 0 ? void 0 : concurrencyCheck.type) === "seq" && (0, exports.isVersionError)(error_6))) return [3 /*break*/, 16];
476
- return [4 /*yield*/, reloadDocForConflict(model, id)];
477
484
  case 15:
478
- current = _h.sent();
479
- serverSeq = (_g = current === null || current === void 0 ? void 0 : current._syncSeq) !== null && _g !== void 0 ? _g : 0;
485
+ _k.sent();
486
+ return [3 /*break*/, 19];
487
+ case 16:
488
+ error_6 = _k.sent();
489
+ if (!((concurrencyCheck === null || concurrencyCheck === void 0 ? void 0 : concurrencyCheck.type) === "seq" && (0, exports.isVersionError)(error_6))) return [3 /*break*/, 18];
490
+ return [4 /*yield*/, reloadDocForConflict(model, id)];
491
+ case 17:
492
+ current = _k.sent();
493
+ serverSeq = (_j = current === null || current === void 0 ? void 0 : current._syncSeq) !== null && _j !== void 0 ? _j : 0;
480
494
  throw new ExecutorConflictError({
481
495
  conflictType: "seq",
482
496
  detail: "Document was modified since your last read",
@@ -486,38 +500,37 @@ var executeUpdate = function (_a) { return __awaiter(void 0, [_a], void 0, funct
486
500
  status: 409,
487
501
  title: "Sync conflict on ".concat(model.modelName, ":").concat(id, ": a concurrent write landed while this update was in flight (baseSeq ").concat(concurrencyCheck.baseSeq, ")"),
488
502
  });
489
- case 16: throw (0, errors_1.passthroughOrWrapWrite)(error_6, {
503
+ case 18: throw (0, errors_1.passthroughOrWrapWrite)(error_6, {
490
504
  code: "update-save-error",
491
505
  detail: "preUpdate hook save error on ".concat(id, ": ").concat((0, errors_1.errorMessage)(error_6)),
492
506
  status: 400,
493
507
  title: "preUpdate hook save error",
494
508
  });
495
- case 17:
496
- if (!options.populatePaths) return [3 /*break*/, 19];
497
- populateQuery = model.findById(doc._id);
498
- populateQuery = (0, api_1.addPopulateToQuery)(populateQuery, options.populatePaths);
499
- return [4 /*yield*/, populateQuery.exec()];
500
- case 18:
501
- doc = _h.sent();
502
- _h.label = 19;
503
509
  case 19:
504
- if (!(options.postUpdate && !skipPostHooks)) return [3 /*break*/, 23];
505
- _h.label = 20;
510
+ if (!options.populatePaths) return [3 /*break*/, 21];
511
+ populateQuery = (0, api_1.addPopulateToQuery)(model.findById(doc._id), options.populatePaths);
512
+ return [4 /*yield*/, populateQuery.exec()];
506
513
  case 20:
507
- _h.trys.push([20, 22, , 23]);
508
- return [4 /*yield*/, options.postUpdate(doc, cleanedBody, request, prevDoc)];
514
+ doc = (_k.sent());
515
+ _k.label = 21;
509
516
  case 21:
510
- _h.sent();
511
- return [3 /*break*/, 23];
517
+ if (!(options.postUpdate && !skipPostHooks)) return [3 /*break*/, 25];
518
+ _k.label = 22;
512
519
  case 22:
513
- error_7 = _h.sent();
520
+ _k.trys.push([22, 24, , 25]);
521
+ return [4 /*yield*/, options.postUpdate(doc, cleanedBody, request, prevDoc)];
522
+ case 23:
523
+ _k.sent();
524
+ return [3 /*break*/, 25];
525
+ case 24:
526
+ error_7 = _k.sent();
514
527
  throw (0, errors_1.passthroughOrWrap)(error_7, {
515
528
  code: "post-update-hook-error",
516
529
  detail: "postUpdate hook error on ".concat(id, ": ").concat((0, errors_1.errorMessage)(error_7)),
517
530
  status: 400,
518
531
  title: "postUpdate hook error",
519
532
  });
520
- case 23: return [2 /*return*/, { cleanedBody: cleanedBody, doc: doc, prevDoc: prevDoc }];
533
+ case 25: return [2 /*return*/, { cleanedBody: cleanedBody, doc: doc, prevDoc: prevDoc }];
521
534
  }
522
535
  });
523
536
  }); };
@@ -545,79 +558,95 @@ exports.runPostUpdate = runPostUpdate;
545
558
  * APIErrors with the same statuses/titles as the REST handler.
546
559
  */
547
560
  var executeDelete = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
548
- var request, doc, error_8, alreadyDeleted, tombstone, resolved, body, error_9, error_10, error_11;
549
- var _c;
550
- var model = _b.model, options = _b.options, user = _b.user, id = _b.id, existingDoc = _b.existingDoc, req = _b.req, skipPostHooks = _b.skipPostHooks;
551
- return __generator(this, function (_d) {
552
- switch (_d.label) {
561
+ var request, _c, doc, error_8, alreadyDeleted, tombstone, resolved, _d, _e, body, error_9, error_10, error_11;
562
+ var _f;
563
+ var model = _b.model, options = _b.options, user = _b.user, id = _b.id, existingDoc = _b.existingDoc, req = _b.req, skipPermissionChecks = _b.skipPermissionChecks, skipPostHooks = _b.skipPostHooks;
564
+ return __generator(this, function (_g) {
565
+ switch (_g.label) {
553
566
  case 0:
554
567
  request = req !== null && req !== void 0 ? req : stubRequest(user);
568
+ _c = !skipPermissionChecks;
569
+ if (!_c) return [3 /*break*/, 2];
555
570
  return [4 /*yield*/, (0, permissions_1.checkPermissions)("delete", options.permissions.delete, user)];
556
571
  case 1:
557
- if (!(_d.sent())) {
572
+ _c = !(_g.sent());
573
+ _g.label = 2;
574
+ case 2:
575
+ if (_c) {
558
576
  throw new errors_1.APIError({
559
577
  status: 405,
560
578
  title: "Access to DELETE on ".concat(model.modelName, " denied for ").concat(user === null || user === void 0 ? void 0 : user.id),
561
579
  });
562
580
  }
563
581
  doc = existingDoc;
564
- if (!!doc) return [3 /*break*/, 8];
565
- _d.label = 2;
566
- case 2:
567
- _d.trys.push([2, 4, , 8]);
568
- return [4 /*yield*/, (0, docLoader_1.loadDocOr404)(model, id, options.populatePaths)];
582
+ if (!!doc) return [3 /*break*/, 10];
583
+ _g.label = 3;
569
584
  case 3:
570
- doc = (_d.sent());
571
- return [3 /*break*/, 8];
585
+ _g.trys.push([3, 5, , 10]);
586
+ return [4 /*yield*/, (0, docLoader_1.loadDocOr404)(model, id, options.populatePaths)];
572
587
  case 4:
573
- error_8 = _d.sent();
588
+ doc = (_g.sent());
589
+ return [3 /*break*/, 10];
590
+ case 5:
591
+ error_8 = _g.sent();
574
592
  alreadyDeleted = (0, errors_1.isAPIError)(error_8) &&
575
593
  error_8.status === 404 &&
576
- ((_c = error_8.meta) === null || _c === void 0 ? void 0 : _c.deleted) === "true";
577
- if (!alreadyDeleted) return [3 /*break*/, 7];
594
+ ((_f = error_8.meta) === null || _f === void 0 ? void 0 : _f.deleted) === "true";
595
+ if (!alreadyDeleted) return [3 /*break*/, 9];
578
596
  return [4 /*yield*/, model.find({ _id: id, deleted: { $in: [true, false] } }).limit(1)];
579
- case 5:
580
- tombstone = _d.sent();
597
+ case 6:
598
+ tombstone = _g.sent();
581
599
  resolved = tombstone[0];
582
600
  if (!resolved) {
583
601
  throw error_8;
584
602
  }
603
+ _d = !skipPermissionChecks;
604
+ if (!_d) return [3 /*break*/, 8];
585
605
  return [4 /*yield*/, (0, permissions_1.checkPermissions)("delete", options.permissions.delete, user, resolved)];
586
- case 6:
587
- if (!(_d.sent())) {
606
+ case 7:
607
+ _d = !(_g.sent());
608
+ _g.label = 8;
609
+ case 8:
610
+ if (_d) {
588
611
  throw new errors_1.APIError({
589
612
  status: 403,
590
613
  title: "Access to GET on ".concat(model.modelName, ":").concat(id, " denied for ").concat(user === null || user === void 0 ? void 0 : user.id),
591
614
  });
592
615
  }
593
616
  return [2 /*return*/, { doc: resolved }];
594
- case 7: throw error_8;
595
- case 8: return [4 /*yield*/, (0, permissions_1.checkPermissions)("delete", options.permissions.delete, user, doc)];
596
- case 9:
597
- if (!(_d.sent())) {
617
+ case 9: throw error_8;
618
+ case 10:
619
+ _e = !skipPermissionChecks;
620
+ if (!_e) return [3 /*break*/, 12];
621
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)("delete", options.permissions.delete, user, doc)];
622
+ case 11:
623
+ _e = !(_g.sent());
624
+ _g.label = 12;
625
+ case 12:
626
+ if (_e) {
598
627
  throw new errors_1.APIError({
599
628
  status: 403,
600
629
  title: "Access to GET on ".concat(model.modelName, ":").concat(id, " denied for ").concat(user === null || user === void 0 ? void 0 : user.id),
601
630
  });
602
631
  }
603
- if (!options.preDelete) return [3 /*break*/, 14];
632
+ if (!options.preDelete) return [3 /*break*/, 17];
604
633
  body = void 0;
605
- _d.label = 10;
606
- case 10:
607
- _d.trys.push([10, 12, , 13]);
634
+ _g.label = 13;
635
+ case 13:
636
+ _g.trys.push([13, 15, , 16]);
608
637
  return [4 /*yield*/, options.preDelete(doc, request)];
609
- case 11:
610
- body = _d.sent();
611
- return [3 /*break*/, 13];
612
- case 12:
613
- error_9 = _d.sent();
638
+ case 14:
639
+ body = _g.sent();
640
+ return [3 /*break*/, 16];
641
+ case 15:
642
+ error_9 = _g.sent();
614
643
  throw (0, errors_1.passthroughOrWrap)(error_9, {
615
644
  code: "pre-delete-hook-error",
616
645
  detail: "preDelete hook error on ".concat(id, ": ").concat((0, errors_1.errorMessage)(error_9)),
617
646
  status: 403,
618
647
  title: "preDelete hook error",
619
648
  });
620
- case 13:
649
+ case 16:
621
650
  if (body === undefined) {
622
651
  throw new errors_1.ForbiddenError({
623
652
  code: "delete-not-allowed",
@@ -632,45 +661,45 @@ var executeDelete = function (_a) { return __awaiter(void 0, [_a], void 0, funct
632
661
  title: "Delete not allowed",
633
662
  });
634
663
  }
635
- _d.label = 14;
636
- case 14:
664
+ _g.label = 17;
665
+ case 17:
637
666
  if (!(Object.keys(model.schema.paths).includes("deleted") &&
638
- model.schema.paths.deleted.instance === "Boolean")) return [3 /*break*/, 16];
667
+ model.schema.paths.deleted.instance === "Boolean")) return [3 /*break*/, 19];
639
668
  doc.deleted = true;
640
669
  return [4 /*yield*/, doc.save()];
641
- case 15:
642
- _d.sent();
643
- return [3 /*break*/, 19];
644
- case 16:
645
- _d.trys.push([16, 18, , 19]);
646
- return [4 /*yield*/, doc.deleteOne()];
647
- case 17:
648
- _d.sent();
649
- return [3 /*break*/, 19];
650
670
  case 18:
651
- error_10 = _d.sent();
671
+ _g.sent();
672
+ return [3 /*break*/, 22];
673
+ case 19:
674
+ _g.trys.push([19, 21, , 22]);
675
+ return [4 /*yield*/, doc.deleteOne()];
676
+ case 20:
677
+ _g.sent();
678
+ return [3 /*break*/, 22];
679
+ case 21:
680
+ error_10 = _g.sent();
652
681
  throw (0, errors_1.passthroughOrWrap)(error_10, {
653
682
  code: "delete-error",
654
683
  status: 400,
655
684
  title: "Delete error",
656
685
  });
657
- case 19:
658
- if (!(options.postDelete && !skipPostHooks)) return [3 /*break*/, 23];
659
- _d.label = 20;
660
- case 20:
661
- _d.trys.push([20, 22, , 23]);
662
- return [4 /*yield*/, options.postDelete(request, doc)];
663
- case 21:
664
- _d.sent();
665
- return [3 /*break*/, 23];
666
686
  case 22:
667
- error_11 = _d.sent();
687
+ if (!(options.postDelete && !skipPostHooks)) return [3 /*break*/, 26];
688
+ _g.label = 23;
689
+ case 23:
690
+ _g.trys.push([23, 25, , 26]);
691
+ return [4 /*yield*/, options.postDelete(request, doc)];
692
+ case 24:
693
+ _g.sent();
694
+ return [3 /*break*/, 26];
695
+ case 25:
696
+ error_11 = _g.sent();
668
697
  throw (0, errors_1.passthroughOrWrap)(error_11, {
669
698
  code: "post-delete-hook-error",
670
699
  status: 400,
671
700
  title: "postDelete hook error",
672
701
  });
673
- case 23: return [2 /*return*/, { doc: doc }];
702
+ case 26: return [2 /*return*/, { doc: doc }];
674
703
  }
675
704
  });
676
705
  }); };