@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
@@ -25,27 +25,21 @@ export interface OrganizationScopedUser extends User {
25
25
  /** Reads the caller's organization ids, tolerating users without the `organizationIds` field. */
26
26
  export declare const getUserOrganizationIds: (user?: User) => string[];
27
27
  /**
28
- * Restricts list queries to documents belonging to one of the caller's organizations. This is the
29
- * tenant-scoped analog of {@link OwnerQueryFilter}: it filters on the document's `organizationId`
30
- * field using the user's `organizationIds`. Returns `null` for anonymous callers (no user).
28
+ * Restricts list queries to the current request organization (`X-Organization-Id` or inferred
29
+ * single org-admin membership). Does not read `User.organizationIds`.
31
30
  */
32
- export declare const OrganizationQueryFilter: (user?: User) => {
33
- organizationId: {
34
- $in: string[];
35
- };
36
- } | null;
31
+ export declare const OrganizationQueryFilter: (_user?: User, _query?: Record<string, unknown>) => Record<string, unknown>;
37
32
  export declare const Permissions: {
38
33
  IsAdmin: (_method: RESTMethod, user?: User) => boolean;
39
34
  IsAny: () => boolean;
40
35
  IsAuthenticated: (_method: RESTMethod, user?: User) => boolean;
41
36
  IsAuthenticatedOrReadOnly: (method: RESTMethod, user?: User) => boolean;
42
37
  /**
43
- * Object-level permission for tenant-scoped documents: the caller must belong to the document's
44
- * organization (admins always pass). With no object (list/create checks) it returns true and
45
- * defers to the {@link OrganizationQueryFilter} / a `preCreate` hook to scope access. Expects the
46
- * document to expose an `organizationId` and the user an `organizationIds` array.
38
+ * Object-level permission for tenant-scoped documents: platform org actors must match the
39
+ * current org context; everyone else needs an active Membership. With no object (list/create)
40
+ * it returns true and defers to {@link OrganizationQueryFilter}.
47
41
  */
48
- IsOrganizationMember: (_method: RESTMethod, user?: User, obj?: unknown) => boolean;
42
+ IsOrganizationMember: PermissionMethod<unknown>;
49
43
  IsOwner: (_method: RESTMethod, user?: User, obj?: unknown) => boolean;
50
44
  IsOwnerOrReadOnly: (method: RESTMethod, user?: User, obj?: unknown) => boolean;
51
45
  };
@@ -50,6 +50,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
50
50
  exports.permissionMiddleware = exports.checkPermissions = exports.Permissions = exports.OrganizationQueryFilter = exports.getUserOrganizationIds = exports.OwnerQueryFilter = void 0;
51
51
  var docLoader_1 = require("./docLoader");
52
52
  var errors_1 = require("./errors");
53
+ var orgPermissions_1 = require("./orgs/orgPermissions");
53
54
  var OwnerQueryFilter = function (user) {
54
55
  if (user) {
55
56
  return { ownerId: user === null || user === void 0 ? void 0 : user.id };
@@ -64,17 +65,10 @@ var getUserOrganizationIds = function (user) {
64
65
  };
65
66
  exports.getUserOrganizationIds = getUserOrganizationIds;
66
67
  /**
67
- * Restricts list queries to documents belonging to one of the caller's organizations. This is the
68
- * tenant-scoped analog of {@link OwnerQueryFilter}: it filters on the document's `organizationId`
69
- * field using the user's `organizationIds`. Returns `null` for anonymous callers (no user).
68
+ * Restricts list queries to the current request organization (`X-Organization-Id` or inferred
69
+ * single org-admin membership). Does not read `User.organizationIds`.
70
70
  */
71
- var OrganizationQueryFilter = function (user) {
72
- if (!user) {
73
- return null;
74
- }
75
- return { organizationId: { $in: (0, exports.getUserOrganizationIds)(user) } };
76
- };
77
- exports.OrganizationQueryFilter = OrganizationQueryFilter;
71
+ exports.OrganizationQueryFilter = orgPermissions_1.OrgQueryFilter;
78
72
  exports.Permissions = {
79
73
  IsAdmin: function (_method, user) {
80
74
  return Boolean(user === null || user === void 0 ? void 0 : user.admin);
@@ -95,28 +89,11 @@ exports.Permissions = {
95
89
  return method === "list" || method === "read";
96
90
  },
97
91
  /**
98
- * Object-level permission for tenant-scoped documents: the caller must belong to the document's
99
- * organization (admins always pass). With no object (list/create checks) it returns true and
100
- * defers to the {@link OrganizationQueryFilter} / a `preCreate` hook to scope access. Expects the
101
- * document to expose an `organizationId` and the user an `organizationIds` array.
92
+ * Object-level permission for tenant-scoped documents: platform org actors must match the
93
+ * current org context; everyone else needs an active Membership. With no object (list/create)
94
+ * it returns true and defers to {@link OrganizationQueryFilter}.
102
95
  */
103
- IsOrganizationMember: function (_method, user, obj) {
104
- // When checking if we can possibly perform the action, return true.
105
- if (!obj) {
106
- return true;
107
- }
108
- if (!user) {
109
- return false;
110
- }
111
- if (user === null || user === void 0 ? void 0 : user.admin) {
112
- return true;
113
- }
114
- var organizationId = obj.organizationId;
115
- if (!organizationId) {
116
- return false;
117
- }
118
- return (0, exports.getUserOrganizationIds)(user).includes(organizationId);
119
- },
96
+ IsOrganizationMember: orgPermissions_1.isOrgMemberPermission,
120
97
  IsOwner: function (_method, user, obj) {
121
98
  var _a;
122
99
  // When checking if we can possibly perform the action, return true.
package/dist/plugins.d.ts CHANGED
@@ -6,6 +6,14 @@ export interface BaseUser {
6
6
  email: string;
7
7
  }
8
8
  export declare const baseUserPlugin: (schema: Schema<any, any, any, any>) => void;
9
+ export interface EmailVerified {
10
+ emailVerified: boolean;
11
+ }
12
+ /**
13
+ * Opt-in `emailVerified` field for user schemas. Defaults to false so existing
14
+ * documents stay unverified until they complete the email-verification flow.
15
+ */
16
+ export declare const emailVerificationPlugin: (schema: Parameters<typeof baseUserPlugin>[0]) => void;
9
17
  /** For models with the isDeletedPlugin, extend this interface to add the appropriate fields. */
10
18
  export interface IsDeleted {
11
19
  deleted: boolean;
@@ -85,7 +93,12 @@ export interface FindExactlyOnePlugin<T> {
85
93
  export declare class DateOnly extends SchemaType {
86
94
  constructor(key: string, options: SchemaTypeOptions<Date>);
87
95
  handleSingle(val: unknown): Date | undefined;
88
- $conditionalHandlers: any;
96
+ $conditionalHandlers: {
97
+ $gt: (val: unknown) => Date | undefined;
98
+ $gte: (val: unknown) => Date | undefined;
99
+ $lt: (val: unknown) => Date | undefined;
100
+ $lte: (val: unknown) => Date | undefined;
101
+ };
89
102
  castForQuery($conditional: string | undefined, val: unknown, context: unknown): Date | undefined;
90
103
  cast(val: unknown): Date | undefined;
91
104
  get(val: unknown): this;
package/dist/plugins.js CHANGED
@@ -95,7 +95,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
95
95
  }
96
96
  };
97
97
  Object.defineProperty(exports, "__esModule", { value: true });
98
- exports.DateOnly = exports.excludeArchivedPlugin = exports.upsertPlugin = exports.findExactlyOne = exports.findOneOrNoneFor = exports.findOneOrNone = exports.firebaseJWTPlugin = exports.createdUpdatedPlugin = exports.isDisabledPlugin = exports.isDeletedPlugin = exports.baseUserPlugin = void 0;
98
+ exports.DateOnly = exports.excludeArchivedPlugin = exports.upsertPlugin = exports.findExactlyOne = exports.findOneOrNoneFor = exports.findOneOrNone = exports.firebaseJWTPlugin = exports.createdUpdatedPlugin = exports.isDisabledPlugin = exports.isDeletedPlugin = exports.emailVerificationPlugin = exports.baseUserPlugin = void 0;
99
99
  var luxon_1 = require("luxon");
100
100
  var mongoose_1 = __importStar(require("mongoose"));
101
101
  var errors_1 = require("./errors");
@@ -123,6 +123,20 @@ var baseUserPlugin = function (schema) {
123
123
  schema.add({ email: { description: "The user's email address", index: true, type: String } });
124
124
  };
125
125
  exports.baseUserPlugin = baseUserPlugin;
126
+ /**
127
+ * Opt-in `emailVerified` field for user schemas. Defaults to false so existing
128
+ * documents stay unverified until they complete the email-verification flow.
129
+ */
130
+ var emailVerificationPlugin = function (schema) {
131
+ schema.add({
132
+ emailVerified: {
133
+ default: false,
134
+ description: "Whether the user has verified their email address",
135
+ type: Boolean,
136
+ },
137
+ });
138
+ };
139
+ exports.emailVerificationPlugin = emailVerificationPlugin;
126
140
  // noExplicitAny: Schema generics must be loose to accept arbitrary consumer schemas
127
141
  // biome-ignore lint/suspicious/noExplicitAny: Schema generics must be loose to accept arbitrary consumer schemas
128
142
  var isDeletedPlugin = function (schema, defaultValue) {
@@ -404,7 +418,8 @@ var DateOnly = /** @class */ (function (_super) {
404
418
  __extends(DateOnly, _super);
405
419
  function DateOnly(key, options) {
406
420
  var _this = _super.call(this, key, options, "DateOnly") || this;
407
- _this.$conditionalHandlers = __assign(__assign({}, mongoose_1.SchemaType.prototype.$conditionalHandlers), { $gt: _this.handleSingle, $gte: _this.handleSingle, $lt: _this.handleSingle, $lte: _this.handleSingle });
421
+ _this.$conditionalHandlers = __assign(__assign({}, mongoose_1.SchemaType.prototype
422
+ .$conditionalHandlers), { $gt: _this.handleSingle, $gte: _this.handleSingle, $lt: _this.handleSingle, $lte: _this.handleSingle });
408
423
  return _this;
409
424
  }
410
425
  DateOnly.prototype.handleSingle = function (val) {
@@ -414,8 +429,6 @@ var DateOnly = /** @class */ (function (_super) {
414
429
  // When using $gt, $gte, $lt, $lte, etc, we need to cast the value to a Date
415
430
  DateOnly.prototype.castForQuery = function ($conditional, val, context) {
416
431
  if ($conditional == null) {
417
- // noExplicitAny: applySetters is an internal Mongoose SchemaType method not in public type definitions
418
- // biome-ignore lint/suspicious/noExplicitAny: applySetters is an internal Mongoose SchemaType method not in public type definitions
419
432
  return this.applySetters(val, context);
420
433
  }
421
434
  var handler = this.$conditionalHandlers[$conditional];
@@ -462,6 +475,4 @@ var DateOnly = /** @class */ (function (_super) {
462
475
  }(mongoose_1.SchemaType));
463
476
  exports.DateOnly = DateOnly;
464
477
  // Register DateOnly with Mongoose's Schema.Types
465
- // noExplicitAny: DateOnly is a custom SchemaType not declared in Mongoose's Schema.Types interface
466
- // biome-ignore lint/suspicious/noExplicitAny: DateOnly is a custom SchemaType not declared in Mongoose's Schema.Types interface
467
478
  mongoose_1.default.Schema.Types.DateOnly = DateOnly;
@@ -1,4 +1,4 @@
1
- import type { Document, Schema } from "mongoose";
1
+ import type { Document, Model, Schema } from "mongoose";
2
2
  interface OpenApiSchemaNode {
3
3
  description?: string;
4
4
  items?: OpenApiSchemaNode;
@@ -11,7 +11,7 @@ export interface PopulatePath {
11
11
  fields?: string[];
12
12
  }
13
13
  export declare const fixMixedFields: (schema: Schema | null, properties: Record<string, OpenApiSchemaNode> | Record<string, unknown> | null) => void;
14
- export declare const getOpenApiSpecForModel: (model: any, { populatePaths, extraModelProperties, }?: {
14
+ export declare const getOpenApiSpecForModel: <T>(model: Model<T>, { populatePaths, extraModelProperties, }?: {
15
15
  populatePaths?: PopulatePath[];
16
16
  extraModelProperties?: Record<string, unknown>;
17
17
  }) => {
package/dist/populate.js CHANGED
@@ -54,6 +54,7 @@ exports.unpopulate = exports.getOpenApiSpecForModel = exports.fixMixedFields = v
54
54
  var isArray_1 = __importDefault(require("lodash/isArray"));
55
55
  var mongoose_to_swagger_1 = __importDefault(require("mongoose-to-swagger"));
56
56
  var errors_1 = require("./errors");
57
+ var schemaMetadata_1 = require("./schemaMetadata");
57
58
  var m2sOptions = {
58
59
  props: ["readOnly", "required", "enum", "default"],
59
60
  };
@@ -157,17 +158,18 @@ var fixMixedFields = function (schema, properties) {
157
158
  }
158
159
  };
159
160
  exports.fixMixedFields = fixMixedFields;
160
- var getOpenApiSpecForModel = function (
161
- // noExplicitAny: Mongoose Model param uses deep internal APIs (schema.path().options.ref, schema.virtuals, schema.childSchemas, db.model) that are not exposed in public type definitions
162
- // biome-ignore lint/suspicious/noExplicitAny: Mongoose Model param uses deep internal APIs (schema.path().options.ref, schema.virtuals, schema.childSchemas, db.model) that are not exposed in public type definitions
163
- model, _a) {
161
+ var getOpenApiSpecForModel = function (model, _a) {
164
162
  var e_2, _b, _c, e_3, _d, e_4, _e, e_5, _f;
165
- var _g, _h, _j, _k;
166
- var _l = _a === void 0 ? {} : _a, populatePaths = _l.populatePaths, extraModelProperties = _l.extraModelProperties;
167
- var modelSwagger = (0, mongoose_to_swagger_1.default)(model, {
168
- props: ["required", "enum"],
169
- });
170
- (0, exports.fixMixedFields)(model.schema, modelSwagger.properties);
163
+ var _g, _h, _j, _k, _l, _m;
164
+ var _o = _a === void 0 ? {} : _a, populatePaths = _o.populatePaths, extraModelProperties = _o.extraModelProperties;
165
+ var description = (0, schemaMetadata_1.describeModel)(model);
166
+ var _p = (0, schemaMetadata_1.modelDescriptionToOpenApiSpec)(description), properties = _p.properties, required = _p.required;
167
+ var modelProperties = properties;
168
+ var modelSwagger = {
169
+ properties: modelProperties,
170
+ required: required,
171
+ };
172
+ (0, exports.fixMixedFields)(model.schema, modelProperties);
171
173
  if (populatePaths && (0, isArray_1.default)(populatePaths)) {
172
174
  try {
173
175
  for (var populatePaths_1 = __values(populatePaths), populatePaths_1_1 = populatePaths_1.next(); !populatePaths_1_1.done; populatePaths_1_1 = populatePaths_1.next()) {
@@ -182,7 +184,7 @@ model, _a) {
182
184
  continue;
183
185
  }
184
186
  // Get the properties of the referenced model
185
- var properties = filterKeys((0, mongoose_to_swagger_1.default)(model.db.model(populateModel), m2sOptions).properties, populatePath.fields);
187
+ var properties_1 = filterKeys((0, mongoose_to_swagger_1.default)(model.db.model(populateModel), m2sOptions).properties, populatePath.fields);
186
188
  // Get the OpenAPI path for the current populate path
187
189
  var openApiPath = getPathInSchema(modelSwagger, populatePath.path);
188
190
  // Determine the schema to set
@@ -194,7 +196,7 @@ model, _a) {
194
196
  }
195
197
  else {
196
198
  schemaToSet = {
197
- properties: properties,
199
+ properties: properties_1,
198
200
  type: "object",
199
201
  };
200
202
  }
@@ -223,7 +225,8 @@ model, _a) {
223
225
  currentSchema[part] = { properties: {}, type: "object" };
224
226
  }
225
227
  }
226
- currentSchema = currentSchema[part].properties || currentSchema[part];
228
+ var nextSchema = (_k = currentSchema[part].properties) !== null && _k !== void 0 ? _k : currentSchema[part];
229
+ currentSchema = nextSchema;
227
230
  }
228
231
  }
229
232
  }
@@ -238,8 +241,8 @@ model, _a) {
238
241
  }
239
242
  try {
240
243
  // Add virtuals to the modelSwagger property
241
- for (var _m = __values(Object.keys(model.schema.virtuals)), _o = _m.next(); !_o.done; _o = _m.next()) {
242
- var virtual = _o.value;
244
+ for (var _q = __values(Object.keys(model.schema.virtuals)), _r = _q.next(); !_r.done; _r = _q.next()) {
245
+ var virtual = _r.value;
243
246
  // Skip Mongoose internals
244
247
  if (virtual === "id" || virtual === "__v") {
245
248
  continue;
@@ -252,22 +255,26 @@ model, _a) {
252
255
  catch (e_3_1) { e_3 = { error: e_3_1 }; }
253
256
  finally {
254
257
  try {
255
- if (_o && !_o.done && (_d = _m.return)) _d.call(_m);
258
+ if (_r && !_r.done && (_d = _q.return)) _d.call(_q);
256
259
  }
257
260
  finally { if (e_3) throw e_3.error; }
258
261
  }
259
262
  // Check subschemas for virtuals (one level deep)
260
263
  if (model.schema.childSchemas.length > 0) {
261
264
  try {
262
- for (var _p = __values(model.schema.childSchemas), _q = _p.next(); !_q.done; _q = _p.next()) {
263
- var childSchema = _q.value;
265
+ for (var _s = __values(model.schema.childSchemas), _t = _s.next(); !_t.done; _t = _s.next()) {
266
+ var childSchema = _t.value;
264
267
  try {
265
- for (var _r = (e_5 = void 0, __values(Object.keys(childSchema.schema.virtuals))), _s = _r.next(); !_s.done; _s = _r.next()) {
266
- var virtual = _s.value;
268
+ for (var _u = (e_5 = void 0, __values(Object.keys(childSchema.schema.virtuals))), _v = _u.next(); !_v.done; _v = _u.next()) {
269
+ var virtual = _v.value;
267
270
  if (virtual === "id" || virtual === "__v") {
268
271
  continue;
269
272
  }
270
- modelSwagger.properties[childSchema.model.path].properties[virtual] = {
273
+ var childPath = childSchema.model.path;
274
+ if (!childPath || !((_l = modelSwagger.properties[childPath]) === null || _l === void 0 ? void 0 : _l.properties)) {
275
+ continue;
276
+ }
277
+ modelSwagger.properties[childPath].properties[virtual] = {
271
278
  type: "any",
272
279
  };
273
280
  }
@@ -275,7 +282,7 @@ model, _a) {
275
282
  catch (e_5_1) { e_5 = { error: e_5_1 }; }
276
283
  finally {
277
284
  try {
278
- if (_s && !_s.done && (_f = _r.return)) _f.call(_r);
285
+ if (_v && !_v.done && (_f = _u.return)) _f.call(_u);
279
286
  }
280
287
  finally { if (e_5) throw e_5.error; }
281
288
  }
@@ -284,14 +291,14 @@ model, _a) {
284
291
  catch (e_4_1) { e_4 = { error: e_4_1 }; }
285
292
  finally {
286
293
  try {
287
- if (_q && !_q.done && (_e = _p.return)) _e.call(_p);
294
+ if (_t && !_t.done && (_e = _s.return)) _e.call(_s);
288
295
  }
289
296
  finally { if (e_4) throw e_4.error; }
290
297
  }
291
298
  }
292
299
  return {
293
300
  properties: __assign(__assign({}, modelSwagger.properties), extraModelProperties),
294
- required: (_k = modelSwagger.required) !== null && _k !== void 0 ? _k : [],
301
+ required: (_m = modelSwagger.required) !== null && _m !== void 0 ? _m : [],
295
302
  };
296
303
  };
297
304
  exports.getOpenApiSpecForModel = getOpenApiSpecForModel;
@@ -304,53 +311,51 @@ var unpopulate = function (doc, path) {
304
311
  throw new errors_1.APIError({ status: 500, title: "path is required for unpopulate" });
305
312
  }
306
313
  var pathParts = path.split(".");
314
+ var asRecord = function (value) { return value; };
315
+ var idOf = function (value) { return value === null || value === void 0 ? void 0 : value._id; };
307
316
  // Recursive because we need to support nested paths.
308
- // noExplicitAny: recursive document traversal uses bracket-notation indexing on arbitrary nested document shapes that Mongoose Document types do not expose
309
- // biome-ignore lint/suspicious/noExplicitAny: recursive document traversal uses bracket-notation indexing on arbitrary nested document shapes that Mongoose Document types do not expose
310
317
  var recursiveUnpopulate = function (current, parts) {
311
318
  var e_6, _a;
312
- var _b;
313
319
  var part = parts[0];
320
+ var value = current[part];
314
321
  // If the path doesn't exist, return the original doc
315
- if (!current[part]) {
316
- return doc;
322
+ if (!value) {
323
+ return asRecord(doc);
317
324
  }
318
325
  if (parts.length === 1) {
319
326
  // Base case: we've reached the last part of the path
320
- if (Array.isArray(current[part])) {
327
+ if (Array.isArray(value)) {
321
328
  // If the field is an array, recursively unpopulate each element
322
- current[part] = current[part].map(function (item) {
323
- return (item === null || item === void 0 ? void 0 : item._id) ? item._id : item;
324
- });
329
+ current[part] = value.map(function (item) { var _a; return (_a = idOf(item)) !== null && _a !== void 0 ? _a : item; });
325
330
  }
326
- else if ((_b = current[part]) === null || _b === void 0 ? void 0 : _b._id) {
331
+ else if (idOf(value)) {
327
332
  // If the field is a populated document, revert to _id
328
- current[part] = current[part]._id;
333
+ current[part] = idOf(value);
329
334
  }
330
335
  }
331
336
  else {
332
337
  // Recursive case: continue down the path
333
- if (Array.isArray(current[part])) {
338
+ if (Array.isArray(value)) {
334
339
  try {
335
- for (var _c = __values(current[part]), _d = _c.next(); !_d.done; _d = _c.next()) {
336
- var item = _d.value;
337
- recursiveUnpopulate(item, parts.slice(1)); // Recursively handle each item in the array
340
+ for (var value_1 = __values(value), value_1_1 = value_1.next(); !value_1_1.done; value_1_1 = value_1.next()) {
341
+ var item = value_1_1.value;
342
+ recursiveUnpopulate(asRecord(item), parts.slice(1)); // Recursively handle each item in the array
338
343
  }
339
344
  }
340
345
  catch (e_6_1) { e_6 = { error: e_6_1 }; }
341
346
  finally {
342
347
  try {
343
- if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
348
+ if (value_1_1 && !value_1_1.done && (_a = value_1.return)) _a.call(value_1);
344
349
  }
345
350
  finally { if (e_6) throw e_6.error; }
346
351
  }
347
352
  }
348
353
  else {
349
- recursiveUnpopulate(current[part], parts.slice(1)); // Recursively handle the next part
354
+ recursiveUnpopulate(asRecord(value), parts.slice(1)); // Recursively handle the next part
350
355
  }
351
356
  }
352
357
  return current;
353
358
  };
354
- return recursiveUnpopulate(doc, pathParts);
359
+ return recursiveUnpopulate(asRecord(doc), pathParts);
355
360
  };
356
361
  exports.unpopulate = unpopulate;
@@ -0,0 +1,3 @@
1
+ import type { Application } from "express";
2
+ import type { RateLimitOptions } from "./types";
3
+ export declare const applyRateLimitTrustProxy: (app: Application, options: RateLimitOptions) => void;
@@ -0,0 +1,17 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.applyRateLimitTrustProxy = void 0;
4
+ var applyRateLimitTrustProxy = function (app, options) {
5
+ if (options.trustProxy === false) {
6
+ app.set("trust proxy", false);
7
+ return;
8
+ }
9
+ if (options.trustProxy !== undefined) {
10
+ app.set("trust proxy", options.trustProxy);
11
+ return;
12
+ }
13
+ // Default off so client X-Forwarded-For cannot rotate unauthenticated buckets.
14
+ // Cloud Run / GFE: pass trustProxy: 1.
15
+ app.set("trust proxy", false);
16
+ };
17
+ exports.applyRateLimitTrustProxy = applyRateLimitTrustProxy;
@@ -0,0 +1,2 @@
1
+ import type { RateLimitOptions, RateLimitStore } from "./types";
2
+ export declare const createRateLimitStore: (options: RateLimitOptions) => RateLimitStore;
@@ -0,0 +1,28 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.createRateLimitStore = void 0;
4
+ var errors_1 = require("../errors");
5
+ var memoryStore_1 = require("./memoryStore");
6
+ var mongoStore_1 = require("./mongoStore");
7
+ var redisStore_1 = require("./redisStore");
8
+ var createRateLimitStore = function (options) {
9
+ var _a;
10
+ if (options.storeImpl) {
11
+ return options.storeImpl;
12
+ }
13
+ var kind = (_a = options.store) !== null && _a !== void 0 ? _a : "memory";
14
+ if (kind === "memory") {
15
+ return (0, memoryStore_1.createMemoryRateLimitStore)();
16
+ }
17
+ if (kind === "redis") {
18
+ return (0, redisStore_1.createRedisRateLimitStore)(options);
19
+ }
20
+ if (kind === "mongo") {
21
+ return (0, mongoStore_1.createMongoRateLimitStore)();
22
+ }
23
+ throw new errors_1.APIError({
24
+ status: 500,
25
+ title: "Unknown rate limit store: ".concat(String(kind)),
26
+ });
27
+ };
28
+ exports.createRateLimitStore = createRateLimitStore;
@@ -0,0 +1,2 @@
1
+ import type { RateLimitStore } from "./types";
2
+ export declare const createMemoryRateLimitStore: () => RateLimitStore;
@@ -0,0 +1,108 @@
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
+ var __values = (this && this.__values) || function(o) {
39
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
40
+ if (m) return m.call(o);
41
+ if (o && typeof o.length === "number") return {
42
+ next: function () {
43
+ if (o && i >= o.length) o = void 0;
44
+ return { value: o && o[i++], done: !o };
45
+ }
46
+ };
47
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
48
+ };
49
+ var __read = (this && this.__read) || function (o, n) {
50
+ var m = typeof Symbol === "function" && o[Symbol.iterator];
51
+ if (!m) return o;
52
+ var i = m.call(o), r, ar = [], e;
53
+ try {
54
+ while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
55
+ }
56
+ catch (error) { e = { error: error }; }
57
+ finally {
58
+ try {
59
+ if (r && !r.done && (m = i["return"])) m.call(i);
60
+ }
61
+ finally { if (e) throw e.error; }
62
+ }
63
+ return ar;
64
+ };
65
+ Object.defineProperty(exports, "__esModule", { value: true });
66
+ exports.createMemoryRateLimitStore = void 0;
67
+ var createMemoryRateLimitStore = function () {
68
+ var windows = new Map();
69
+ var consume = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
70
+ var existing, windows_1, windows_1_1, _c, windowKey, window_1, resetAt, allowed;
71
+ var e_1, _d;
72
+ var key = _b.key, max = _b.max, windowMs = _b.windowMs, now = _b.now;
73
+ return __generator(this, function (_e) {
74
+ existing = windows.get(key);
75
+ if (!existing || existing.resetAt <= now) {
76
+ if (windows.size > 10000) {
77
+ try {
78
+ for (windows_1 = __values(windows), windows_1_1 = windows_1.next(); !windows_1_1.done; windows_1_1 = windows_1.next()) {
79
+ _c = __read(windows_1_1.value, 2), windowKey = _c[0], window_1 = _c[1];
80
+ if (window_1.resetAt <= now) {
81
+ windows.delete(windowKey);
82
+ }
83
+ }
84
+ }
85
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
86
+ finally {
87
+ try {
88
+ if (windows_1_1 && !windows_1_1.done && (_d = windows_1.return)) _d.call(windows_1);
89
+ }
90
+ finally { if (e_1) throw e_1.error; }
91
+ }
92
+ }
93
+ resetAt = now + windowMs;
94
+ windows.set(key, { count: 1, resetAt: resetAt });
95
+ return [2 /*return*/, { allowed: true, remaining: Math.max(0, max - 1), resetAt: resetAt }];
96
+ }
97
+ existing.count += 1;
98
+ allowed = existing.count <= max;
99
+ return [2 /*return*/, {
100
+ allowed: allowed,
101
+ remaining: Math.max(0, max - existing.count),
102
+ resetAt: existing.resetAt,
103
+ }];
104
+ });
105
+ }); };
106
+ return { consume: consume };
107
+ };
108
+ exports.createMemoryRateLimitStore = createMemoryRateLimitStore;
@@ -0,0 +1,3 @@
1
+ import type { NextFunction, Request, Response } from "express";
2
+ import type { RateLimitOptions, RateLimitStore } from "./types";
3
+ export declare const createRateLimitMiddleware: (store: RateLimitStore, options?: RateLimitOptions) => ((req: Request, res: Response, next: NextFunction) => Promise<void>);