@terreno/api 57.3.0 → 57.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (412) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +11 -5
  3. package/bunfig.toml +1 -1
  4. package/dist/actions.js +197 -368
  5. package/dist/adminModelRouter.js +88 -173
  6. package/dist/adminTypes.d.ts +7 -0
  7. package/dist/adminTypes.js +6 -1
  8. package/dist/api.d.ts +10 -0
  9. package/dist/api.js +601 -792
  10. package/dist/audit/auditApp.d.ts +30 -0
  11. package/dist/audit/auditApp.js +114 -0
  12. package/dist/audit/auditEventModel.d.ts +29 -0
  13. package/dist/audit/auditEventModel.js +101 -0
  14. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  15. package/dist/audit/cloudTasksEnqueue.js +69 -0
  16. package/dist/audit/diff.d.ts +10 -0
  17. package/dist/audit/diff.js +140 -0
  18. package/dist/audit/processQueue.d.ts +6 -0
  19. package/dist/audit/processQueue.js +56 -0
  20. package/dist/audit/rbacSink.d.ts +2 -0
  21. package/dist/audit/rbacSink.js +41 -0
  22. package/dist/audit/record.d.ts +56 -0
  23. package/dist/audit/record.js +251 -0
  24. package/dist/auth.js +432 -681
  25. package/dist/authRecovery.js +155 -269
  26. package/dist/authTokens.js +43 -118
  27. package/dist/betterAuth.d.ts +6 -0
  28. package/dist/betterAuthApp.js +25 -26
  29. package/dist/betterAuthSetup.js +258 -413
  30. package/dist/browserLogsRoute.d.ts +6 -0
  31. package/dist/browserLogsRoute.js +97 -0
  32. package/dist/collectionRegistry.d.ts +3 -1
  33. package/dist/collectionRegistry.js +43 -33
  34. package/dist/config.js +53 -122
  35. package/dist/configurationApp.js +180 -361
  36. package/dist/configurationPlugin.js +130 -302
  37. package/dist/consentApp.js +276 -421
  38. package/dist/docLoader.js +78 -126
  39. package/dist/envConfigurationPlugin.js +25 -147
  40. package/dist/errors.js +151 -247
  41. package/dist/example.js +28 -34
  42. package/dist/expressServer.d.ts +10 -0
  43. package/dist/expressServer.js +109 -255
  44. package/dist/frameworkModelNames.d.ts +24 -0
  45. package/dist/frameworkModelNames.js +31 -0
  46. package/dist/githubAuth.js +152 -216
  47. package/dist/httpClient.js +176 -264
  48. package/dist/index.d.ts +28 -1
  49. package/dist/index.js +53 -2
  50. package/dist/logger.js +145 -278
  51. package/dist/mcp/auth.js +76 -128
  52. package/dist/mcp/createMCPRequest.js +4 -5
  53. package/dist/mcp/handlers.js +268 -480
  54. package/dist/mcp/query.d.ts +0 -13
  55. package/dist/mcp/query.js +57 -151
  56. package/dist/mcp/registry.js +17 -30
  57. package/dist/mcp/schemaGenerator.js +95 -181
  58. package/dist/mcp/server.js +28 -100
  59. package/dist/mcp/serviceTokens.js +102 -191
  60. package/dist/mcp/toolGenerator.js +78 -191
  61. package/dist/middleware.js +15 -27
  62. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  63. package/dist/migrations/fixtures/all-down/20260910120000-one.js +9 -0
  64. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  65. package/dist/migrations/fixtures/all-down/20260910120001-two.js +9 -0
  66. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  67. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +7 -0
  68. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  69. package/dist/migrations/fixtures/bad-name/not-a-migration.js +7 -0
  70. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  71. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  72. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  73. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +7 -0
  74. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  75. package/dist/migrations/fixtures/valid/20260910120001-beta.js +9 -0
  76. package/dist/migrations/generate.d.ts +17 -0
  77. package/dist/migrations/generate.js +155 -0
  78. package/dist/migrations/load.d.ts +20 -0
  79. package/dist/migrations/load.js +110 -0
  80. package/dist/migrations/lock.d.ts +13 -0
  81. package/dist/migrations/lock.js +73 -0
  82. package/dist/migrations/runner.d.ts +42 -0
  83. package/dist/migrations/runner.js +249 -0
  84. package/dist/migrations/schemaCatalog.d.ts +44 -0
  85. package/dist/migrations/schemaCatalog.js +185 -0
  86. package/dist/migrations/types.d.ts +87 -0
  87. package/dist/migrations/types.js +7 -0
  88. package/dist/models/consentForm.js +6 -6
  89. package/dist/models/consentResponse.js +5 -5
  90. package/dist/models/mcpServiceToken.js +66 -156
  91. package/dist/models/notification.d.ts +2 -0
  92. package/dist/models/notification.js +62 -0
  93. package/dist/models/notificationPreference.d.ts +2 -0
  94. package/dist/models/notificationPreference.js +49 -0
  95. package/dist/models/versionConfig.js +5 -5
  96. package/dist/notifications/notificationService.d.ts +40 -0
  97. package/dist/notifications/notificationService.js +183 -0
  98. package/dist/notifications/notificationsApp.d.ts +18 -0
  99. package/dist/notifications/notificationsApp.js +156 -0
  100. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  101. package/dist/notifications/notificationsBeforeSend.js +32 -0
  102. package/dist/notifiers/googleChatNotifier.js +36 -117
  103. package/dist/notifiers/slackNotifier.d.ts +31 -2
  104. package/dist/notifiers/slackNotifier.js +170 -119
  105. package/dist/notifiers/zoomNotifier.js +60 -111
  106. package/dist/openApi.d.ts +1 -7
  107. package/dist/openApi.js +113 -127
  108. package/dist/openApiBuilder.d.ts +14 -3
  109. package/dist/openApiBuilder.js +117 -159
  110. package/dist/openApiCompat.js +81 -148
  111. package/dist/openApiEtag.js +7 -7
  112. package/dist/openApiValidator.d.ts +13 -1
  113. package/dist/openApiValidator.js +301 -246
  114. package/dist/orgs/orgContext.d.ts +23 -0
  115. package/dist/orgs/orgContext.js +128 -0
  116. package/dist/orgs/orgPermissions.d.ts +4 -0
  117. package/dist/orgs/orgPermissions.js +38 -0
  118. package/dist/orgs/orgPlugin.d.ts +13 -0
  119. package/dist/orgs/orgPlugin.js +66 -0
  120. package/dist/orgs/organizationModel.d.ts +13 -0
  121. package/dist/orgs/organizationModel.js +200 -0
  122. package/dist/orgs/organizationSettings.d.ts +19 -0
  123. package/dist/orgs/organizationSettings.js +113 -0
  124. package/dist/orgs/orgsApp.d.ts +28 -0
  125. package/dist/orgs/orgsApp.js +416 -0
  126. package/dist/permissions.d.ts +7 -13
  127. package/dist/permissions.js +95 -211
  128. package/dist/plugins.js +125 -218
  129. package/dist/populate.js +130 -240
  130. package/dist/rateLimit/applyTrustProxy.js +1 -1
  131. package/dist/rateLimit/createStore.js +7 -8
  132. package/dist/rateLimit/memoryStore.js +22 -100
  133. package/dist/rateLimit/middleware.d.ts +0 -8
  134. package/dist/rateLimit/middleware.js +49 -101
  135. package/dist/rateLimit/mongoStore.d.ts +1 -0
  136. package/dist/rateLimit/mongoStore.js +55 -112
  137. package/dist/rateLimit/policies.d.ts +0 -4
  138. package/dist/rateLimit/policies.js +44 -80
  139. package/dist/rateLimit/redisStore.d.ts +1 -0
  140. package/dist/rateLimit/redisStore.js +40 -133
  141. package/dist/rbac/access.js +122 -253
  142. package/dist/rbac/assertAllowed.js +95 -171
  143. package/dist/rbac/auditModel.js +14 -58
  144. package/dist/rbac/backfillAdmins.js +24 -130
  145. package/dist/rbac/fieldViews.js +46 -141
  146. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  147. package/dist/rbac/membershipOrgAdminSource.js +51 -0
  148. package/dist/rbac/middleware.js +30 -96
  149. package/dist/rbac/modelRouterAccess.d.ts +3 -0
  150. package/dist/rbac/modelRouterAccess.js +133 -307
  151. package/dist/rbac/permissionUtils.js +40 -179
  152. package/dist/rbac/realtimeAccess.js +81 -147
  153. package/dist/rbac/resolve.d.ts +1 -1
  154. package/dist/rbac/resolve.js +154 -319
  155. package/dist/rbac/roleManager.js +318 -700
  156. package/dist/rbac/roleModel.d.ts +2 -5
  157. package/dist/rbac/roleModel.js +60 -173
  158. package/dist/rbac/routes.js +93 -196
  159. package/dist/rbac/scopes.js +39 -133
  160. package/dist/rbac/statements.d.ts +10 -1
  161. package/dist/rbac/statements.js +42 -93
  162. package/dist/rbac/types.d.ts +5 -0
  163. package/dist/rbac/userPlugin.js +3 -29
  164. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  165. package/dist/realtime/changeStreamWatcher.js +499 -764
  166. package/dist/realtime/deprecation.d.ts +1 -0
  167. package/dist/realtime/deprecation.js +9 -10
  168. package/dist/realtime/queryMatcher.js +110 -191
  169. package/dist/realtime/queryStore.js +35 -118
  170. package/dist/realtime/realtimeApp.d.ts +1 -0
  171. package/dist/realtime/realtimeApp.js +248 -401
  172. package/dist/realtime/registry.js +19 -30
  173. package/dist/realtime/sessionRevalidation.js +132 -358
  174. package/dist/realtime/socketAuth.js +89 -208
  175. package/dist/realtime/socketUser.js +10 -56
  176. package/dist/requestContext.js +93 -139
  177. package/dist/schemaMetadata.js +181 -265
  178. package/dist/scriptRunner.js +96 -266
  179. package/dist/scrubAdminFields.js +36 -108
  180. package/dist/secretProviders.js +130 -299
  181. package/dist/seedRunner.js +221 -514
  182. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  183. package/dist/sync/adminBroadcastScope.js +82 -0
  184. package/dist/sync/adminWindowAccess.d.ts +13 -0
  185. package/dist/sync/adminWindowAccess.js +25 -0
  186. package/dist/sync/adminWindowMutation.d.ts +88 -0
  187. package/dist/sync/adminWindowMutation.js +176 -0
  188. package/dist/sync/executors.d.ts +9 -3
  189. package/dist/sync/executors.js +425 -598
  190. package/dist/sync/loadHarness.js +392 -689
  191. package/dist/sync/models.js +181 -341
  192. package/dist/sync/mutationHandler.d.ts +5 -2
  193. package/dist/sync/mutationHandler.js +549 -697
  194. package/dist/sync/registrationSideEffects.js +41 -95
  195. package/dist/sync/registry.js +31 -47
  196. package/dist/sync/routes.d.ts +13 -0
  197. package/dist/sync/routes.js +484 -760
  198. package/dist/sync/scripts/compactTombstones.js +83 -228
  199. package/dist/sync/serialize.js +18 -58
  200. package/dist/sync/socketHandlers.d.ts +8 -2
  201. package/dist/sync/socketHandlers.js +271 -402
  202. package/dist/sync/streams.d.ts +2 -0
  203. package/dist/sync/streams.js +54 -116
  204. package/dist/sync/syncApp.d.ts +2 -1
  205. package/dist/sync/syncApp.js +14 -16
  206. package/dist/sync/syncBatch.d.ts +5 -2
  207. package/dist/sync/syncBatch.js +63 -168
  208. package/dist/sync/syncSeqPlugin.js +430 -702
  209. package/dist/sync/types.d.ts +18 -0
  210. package/dist/syncConsents.js +113 -253
  211. package/dist/terrenoApp.d.ts +29 -0
  212. package/dist/terrenoApp.js +184 -257
  213. package/dist/tests/createTestData.d.ts +1 -3
  214. package/dist/tests/createTestData.js +147 -259
  215. package/dist/tests/models.d.ts +1 -0
  216. package/dist/tests/models.js +23 -56
  217. package/dist/tests/mongoTestSetup.js +42 -103
  218. package/dist/tests/testHelper.d.ts +0 -5
  219. package/dist/tests/testHelper.js +32 -101
  220. package/dist/tests.js +12 -51
  221. package/dist/transformers.js +61 -164
  222. package/dist/types/authToken.d.ts +3 -3
  223. package/dist/types/mcpServiceToken.d.ts +2 -2
  224. package/dist/types/membership.d.ts +23 -0
  225. package/dist/types/membership.js +2 -0
  226. package/dist/types/notification.d.ts +28 -0
  227. package/dist/types/notification.js +2 -0
  228. package/dist/types/notificationPreference.d.ts +20 -0
  229. package/dist/types/notificationPreference.js +2 -0
  230. package/dist/types/organization.d.ts +36 -0
  231. package/dist/types/organization.js +2 -0
  232. package/dist/utils.js +31 -93
  233. package/dist/vendor/wesleytodd-openapi/index.js +37 -51
  234. package/dist/vendor/wesleytodd-openapi/lib/generate-doc.js +32 -40
  235. package/dist/vendor/wesleytodd-openapi/lib/layer-schema.js +3 -3
  236. package/dist/vendor/wesleytodd-openapi/lib/ui.js +50 -19
  237. package/dist/vendor/wesleytodd-openapi/lib/validate.js +19 -47
  238. package/dist/versionCheckPlugin.js +52 -100
  239. package/dist/webhooks/headerValue.js +2 -2
  240. package/dist/webhooks/idempotency/memoryStore.js +16 -59
  241. package/dist/webhooks/idempotency/mongoStore.js +55 -130
  242. package/dist/webhooks/idempotency/webhookReceipt.d.ts +4 -49
  243. package/dist/webhooks/idempotency/webhookReceipt.js +14 -14
  244. package/dist/webhooks/rawBody.d.ts +1 -0
  245. package/dist/webhooks/rawBody.js +2 -1
  246. package/dist/webhooks/timingSafeEqual.js +4 -5
  247. package/dist/webhooks/verifiers/hmac.js +17 -18
  248. package/dist/webhooks/verifiers/sendgrid.js +20 -22
  249. package/dist/webhooks/verifiers/stripe.js +31 -65
  250. package/dist/webhooks/verifiers/twilio.js +23 -73
  251. package/dist/webhooks/webhooksApp.js +78 -177
  252. package/dist/zodOpenApi.js +2 -2
  253. package/package.json +34 -28
  254. package/src/__snapshots__/openApi.test.ts.snap +192 -54
  255. package/src/__snapshots__/openApiBuilder.test.ts.snap +0 -18
  256. package/src/__snapshots__/schemaMetadata.test.ts.snap +0 -1
  257. package/src/__tests__/browserLogsRoute.test.ts +165 -0
  258. package/src/adminTypes.ts +8 -0
  259. package/src/api.test.ts +39 -2
  260. package/src/api.ts +68 -0
  261. package/src/audit/auditApp.test.ts +243 -0
  262. package/src/audit/auditApp.ts +139 -0
  263. package/src/audit/auditEventModel.ts +160 -0
  264. package/src/audit/auditRouter.test.ts +456 -0
  265. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  266. package/src/audit/cloudTasksEnqueue.ts +104 -0
  267. package/src/audit/diff.ts +163 -0
  268. package/src/audit/processQueue.ts +69 -0
  269. package/src/audit/rbacSink.test.ts +86 -0
  270. package/src/audit/rbacSink.ts +42 -0
  271. package/src/audit/record.test.ts +402 -0
  272. package/src/audit/record.ts +329 -0
  273. package/src/auth.test.ts +1 -1
  274. package/src/auth.ts +1 -1
  275. package/src/authRecovery.test.ts +43 -0
  276. package/src/authRecovery.ts +16 -10
  277. package/src/authTokens.ts +6 -2
  278. package/src/authVerification.test.ts +22 -0
  279. package/src/betterAuth.ts +7 -0
  280. package/src/betterAuthSetup.test.ts +27 -0
  281. package/src/betterAuthSetup.ts +1 -0
  282. package/src/browserLogsRoute.ts +110 -0
  283. package/src/collectionRegistry.test.ts +8 -9
  284. package/src/collectionRegistry.ts +21 -1
  285. package/src/configurationPlugin.test.ts +1 -11
  286. package/src/express.d.ts +2 -0
  287. package/src/expressServer.test.ts +50 -2
  288. package/src/expressServer.ts +10 -0
  289. package/src/frameworkModelNames.test.ts +62 -0
  290. package/src/frameworkModelNames.ts +33 -0
  291. package/src/index.ts +76 -0
  292. package/src/isolated/migrateCliConnect.isolated.ts +51 -0
  293. package/src/mcp/auth.test.ts +34 -1
  294. package/src/mcp/handlers.test.ts +275 -0
  295. package/src/mcp/query.ts +3 -3
  296. package/src/mcp/toolGenerator.test.ts +81 -0
  297. package/src/migrations/cli.test.ts +353 -0
  298. package/src/migrations/cli.ts +283 -0
  299. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  300. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  301. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  302. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  303. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  304. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  305. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  306. package/src/migrations/generate.test.ts +333 -0
  307. package/src/migrations/generate.ts +216 -0
  308. package/src/migrations/load.test.ts +103 -0
  309. package/src/migrations/load.ts +124 -0
  310. package/src/migrations/lock.test.ts +133 -0
  311. package/src/migrations/lock.ts +118 -0
  312. package/src/migrations/runner.test.ts +504 -0
  313. package/src/migrations/runner.ts +358 -0
  314. package/src/migrations/schemaCatalog.test.ts +159 -0
  315. package/src/migrations/schemaCatalog.ts +262 -0
  316. package/src/migrations/types.ts +94 -0
  317. package/src/models/mcpServiceToken.ts +4 -3
  318. package/src/models/notification.ts +69 -0
  319. package/src/models/notificationPreference.ts +62 -0
  320. package/src/notifications/notificationService.ts +254 -0
  321. package/src/notifications/notificationsApp.test.ts +528 -0
  322. package/src/notifications/notificationsApp.ts +200 -0
  323. package/src/notifications/notificationsBeforeSend.ts +51 -0
  324. package/src/notifiers/slackNotifier.test.ts +186 -1
  325. package/src/notifiers/slackNotifier.ts +167 -8
  326. package/src/openApi.test.ts +0 -1
  327. package/src/openApi.ts +2 -1
  328. package/src/openApiBuilder.ts +14 -3
  329. package/src/openApiValidator.test.ts +221 -2
  330. package/src/openApiValidator.ts +218 -33
  331. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  332. package/src/orgs/orgContext.test.ts +259 -0
  333. package/src/orgs/orgContext.ts +151 -0
  334. package/src/orgs/orgPermissions.test.ts +105 -0
  335. package/src/orgs/orgPermissions.ts +40 -0
  336. package/src/orgs/orgPlugin.test.ts +130 -0
  337. package/src/orgs/orgPlugin.ts +70 -0
  338. package/src/orgs/orgRbac.test.ts +267 -0
  339. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  340. package/src/orgs/organizationModel.test.ts +205 -0
  341. package/src/orgs/organizationModel.ts +262 -0
  342. package/src/orgs/organizationSettings.test.ts +113 -0
  343. package/src/orgs/organizationSettings.ts +126 -0
  344. package/src/orgs/orgsApp.test.ts +382 -0
  345. package/src/orgs/orgsApp.ts +563 -0
  346. package/src/permissions.test.ts +62 -36
  347. package/src/permissions.ts +8 -30
  348. package/src/plugins.test.ts +5 -0
  349. package/src/plugins.ts +3 -0
  350. package/src/rateLimit/middleware.ts +1 -1
  351. package/src/rateLimit/mongoStore.ts +1 -0
  352. package/src/rateLimit/policies.ts +2 -2
  353. package/src/rateLimit/redisStore.ts +1 -0
  354. package/src/rbac/access.ts +11 -3
  355. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  356. package/src/rbac/modelRouterAccess.ts +3 -0
  357. package/src/rbac/permissionUtils.test.ts +26 -5
  358. package/src/rbac/resolve.test.ts +34 -2
  359. package/src/rbac/resolve.ts +26 -7
  360. package/src/rbac/roleModel.test.ts +34 -1
  361. package/src/rbac/roleModel.ts +17 -1
  362. package/src/rbac/statements.test.ts +19 -0
  363. package/src/rbac/statements.ts +19 -1
  364. package/src/rbac/types.ts +5 -0
  365. package/src/realtime/changeStreamWatcher.ts +73 -33
  366. package/src/realtime/deprecation.ts +1 -0
  367. package/src/realtime/realtime.test.ts +357 -185
  368. package/src/realtime/realtimeApp.ts +2 -1
  369. package/src/schemaMetadata.test.ts +14 -0
  370. package/src/schemaMetadata.ts +5 -5
  371. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  372. package/src/sync/adminBroadcastScope.test.ts +155 -0
  373. package/src/sync/adminBroadcastScope.ts +123 -0
  374. package/src/sync/adminWindowAccess.test.ts +57 -0
  375. package/src/sync/adminWindowAccess.ts +32 -0
  376. package/src/sync/adminWindowMutation.test.ts +450 -0
  377. package/src/sync/adminWindowMutation.ts +283 -0
  378. package/src/sync/executors.ts +33 -6
  379. package/src/sync/integration.test.ts +2 -2
  380. package/src/sync/mutationHandler.test.ts +277 -1
  381. package/src/sync/mutationHandler.ts +171 -29
  382. package/src/sync/registry.ts +4 -0
  383. package/src/sync/routes.ts +52 -8
  384. package/src/sync/socketHandlers.ts +154 -58
  385. package/src/sync/streams.ts +6 -0
  386. package/src/sync/sync.test.ts +3 -2
  387. package/src/sync/syncApp.ts +2 -1
  388. package/src/sync/syncBatch.ts +7 -2
  389. package/src/sync/syncRoutes.test.ts +297 -3
  390. package/src/sync/syncSocket.test.ts +229 -0
  391. package/src/sync/types.ts +20 -0
  392. package/src/terrenoApp.migrations.test.ts +114 -0
  393. package/src/terrenoApp.test.ts +41 -0
  394. package/src/terrenoApp.ts +97 -31
  395. package/src/tests/createTestData.ts +2 -2
  396. package/src/tests/models.ts +10 -2
  397. package/src/tests/testHelper.ts +1 -7
  398. package/src/types/authToken.ts +2 -4
  399. package/src/types/mcpServiceToken.ts +1 -7
  400. package/src/types/membership.ts +48 -0
  401. package/src/types/notification.ts +34 -0
  402. package/src/types/notificationPreference.ts +28 -0
  403. package/src/types/organization.ts +49 -0
  404. package/src/types.d.ts +1 -0
  405. package/src/webhooks/idempotency/webhookReceipt.ts +8 -10
  406. package/src/webhooks/rawBody.test.ts +33 -0
  407. package/src/webhooks/rawBody.ts +1 -0
  408. package/tsconfig.json +13 -54
  409. package/tsconfig.typedoc.json +4 -1
  410. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  411. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  412. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -0,0 +1,329 @@
1
+ import type {Request} from "express";
2
+ import mongoose from "mongoose";
3
+
4
+ import {logger} from "../logger";
5
+ import {getOrgContext, ORGANIZATION_ID_HEADER} from "../orgs/orgContext";
6
+ import type {AuditEventModel, AuditEventOperation, AuditEventVerb} from "./auditEventModel";
7
+ import {changedFieldDiff, recordLabelFromDoc, toAuditPlain} from "./diff";
8
+
9
+ export interface ModelRouterAuditOptions {
10
+ redact?: string[];
11
+ }
12
+
13
+ export type ModelRouterAuditConfig = boolean | ModelRouterAuditOptions;
14
+
15
+ /** Off-process persist (Cloud Tasks). When set, Mongo is not written in this process. */
16
+ export type AuditEnqueue = (write: AuditEventWrite) => Promise<void>;
17
+
18
+ export interface AuditRecorderOptions {
19
+ enqueue?: AuditEnqueue;
20
+ }
21
+
22
+ export interface AuditEventWrite {
23
+ actorId?: string;
24
+ after?: Record<string, unknown>;
25
+ before?: Record<string, unknown>;
26
+ modelName: string;
27
+ operation: AuditEventOperation;
28
+ organizationId?: string;
29
+ recordId?: string;
30
+ recordLabel?: string;
31
+ source: "admin" | "modelRouter" | "rbac";
32
+ verb: AuditEventVerb;
33
+ }
34
+
35
+ const MISSING_PLUGIN_MESSAGE =
36
+ "modelRouter audit: true requires AuditApp to be registered; skipping AuditEvent write";
37
+ const AUDIT_EVENT_MODEL_NAMES = new Set(["AuditEvent", "TerrenoAuditEvent"]);
38
+
39
+ let auditEventModel: AuditEventModel | undefined;
40
+ let auditEnqueue: AuditEnqueue | undefined;
41
+ let missingPluginLogged = false;
42
+ const inflightWrites = new Set<Promise<void>>();
43
+
44
+ export const installAuditRecorder = (
45
+ model: AuditEventModel,
46
+ options: AuditRecorderOptions = {}
47
+ ): void => {
48
+ auditEventModel = model;
49
+ auditEnqueue = options.enqueue;
50
+ };
51
+
52
+ export const isAuditRecorderInstalled = (): boolean => Boolean(auditEventModel);
53
+
54
+ export const resetAuditRecorderForTests = (): void => {
55
+ auditEventModel = undefined;
56
+ auditEnqueue = undefined;
57
+ missingPluginLogged = false;
58
+ inflightWrites.clear();
59
+ };
60
+
61
+ export const flushAuditRecorderForTests = async (): Promise<void> => {
62
+ await Promise.all([...inflightWrites]);
63
+ };
64
+
65
+ const operationFromVerb = (verb: AuditEventVerb): AuditEventOperation => {
66
+ if (verb === "created") {
67
+ return "create";
68
+ }
69
+ if (verb === "deleted") {
70
+ return "delete";
71
+ }
72
+ return "update";
73
+ };
74
+
75
+ export const maybeRecordAdminAudit = async ({
76
+ after,
77
+ before,
78
+ extraRedact = [],
79
+ modelName,
80
+ recordLabel,
81
+ req,
82
+ verb,
83
+ }: {
84
+ after?: unknown;
85
+ before?: unknown;
86
+ extraRedact?: string[];
87
+ modelName: string;
88
+ recordLabel?: string;
89
+ req: Request;
90
+ verb: AuditEventVerb;
91
+ }): Promise<void> => {
92
+ try {
93
+ if (!auditEventModel) {
94
+ return;
95
+ }
96
+ if (AUDIT_EVENT_MODEL_NAMES.has(modelName)) {
97
+ return;
98
+ }
99
+ const beforePlain = toAuditPlain(before);
100
+ const afterPlain = toAuditPlain(after);
101
+ const diff = changedFieldDiff({after: afterPlain, before: beforePlain, extraRedact});
102
+ const recordIdValue = afterPlain?._id ?? beforePlain?._id;
103
+ await recordAuditEvent({
104
+ actorId: actorIdFromRequest(req),
105
+ after: diff.after,
106
+ before: diff.before,
107
+ modelName,
108
+ operation: operationFromVerb(verb),
109
+ organizationId: organizationIdFromAuditContext(req, afterPlain, beforePlain),
110
+ recordId: recordIdValue != null ? String(recordIdValue) : undefined,
111
+ recordLabel: recordLabel ?? recordLabelFromDoc(afterPlain) ?? recordLabelFromDoc(beforePlain),
112
+ source: "admin",
113
+ verb,
114
+ });
115
+ } catch (error: unknown) {
116
+ logger.error("Failed to persist AuditEvent", error);
117
+ }
118
+ };
119
+
120
+ const resolveAuditRedact = (audit?: ModelRouterAuditConfig): string[] | undefined => {
121
+ if (!audit) {
122
+ return undefined;
123
+ }
124
+ if (audit === true) {
125
+ return [];
126
+ }
127
+ return audit.redact ?? [];
128
+ };
129
+
130
+ const actorIdFromRequest = (req: Request): string | undefined => {
131
+ const user = req.user;
132
+ if (!user) {
133
+ return undefined;
134
+ }
135
+ if (user.id) {
136
+ return String(user.id);
137
+ }
138
+ if (user._id) {
139
+ return String(user._id);
140
+ }
141
+ return undefined;
142
+ };
143
+
144
+ const idString = (value: unknown): string | undefined => {
145
+ if (value === null || value === undefined) {
146
+ return undefined;
147
+ }
148
+ if (typeof value === "string") {
149
+ return value.length > 0 ? value : undefined;
150
+ }
151
+ if (typeof value === "object" && ("id" in value || "_id" in value)) {
152
+ const record = value as {_id?: unknown; id?: unknown};
153
+ if (record.id !== undefined && record.id !== null) {
154
+ return String(record.id);
155
+ }
156
+ if (record._id !== undefined && record._id !== null) {
157
+ return String(record._id);
158
+ }
159
+ }
160
+ return String(value);
161
+ };
162
+
163
+ const organizationIdFromAuditContext = (
164
+ req: Request,
165
+ after?: Record<string, unknown>,
166
+ before?: Record<string, unknown>
167
+ ): string | undefined => {
168
+ const organization = (req as Request & {organization?: unknown}).organization;
169
+ const fromRequest = idString(organization);
170
+ if (fromRequest) {
171
+ return fromRequest;
172
+ }
173
+ const fromAls = idString(getOrgContext()?.organization);
174
+ if (fromAls) {
175
+ return fromAls;
176
+ }
177
+ const fromHeader =
178
+ typeof req.header === "function" ? req.header(ORGANIZATION_ID_HEADER)?.trim() : undefined;
179
+ if (fromHeader) {
180
+ return fromHeader;
181
+ }
182
+ const fromDoc = after?.organizationId ?? before?.organizationId;
183
+ return idString(fromDoc);
184
+ };
185
+
186
+ /** 24-hex ObjectIds only. mongoose.isValidObjectId also accepts 12-char strings. */
187
+ const isCanonicalObjectId = (id: string): boolean => {
188
+ try {
189
+ return new mongoose.Types.ObjectId(id).toString() === id;
190
+ } catch {
191
+ return false;
192
+ }
193
+ };
194
+
195
+ export const actorIdForAuditWrite = (actorId?: string): string | undefined => {
196
+ if (!actorId) {
197
+ return undefined;
198
+ }
199
+ if (!isCanonicalObjectId(actorId)) {
200
+ logger.warn(`AuditEvent actorId is not an ObjectId, recording without an actor: ${actorId}`);
201
+ return undefined;
202
+ }
203
+ return actorId;
204
+ };
205
+
206
+ const actorObjectId = (actorId?: string): mongoose.Types.ObjectId | undefined => {
207
+ const validId = actorIdForAuditWrite(actorId);
208
+ if (!validId) {
209
+ return undefined;
210
+ }
211
+ return new mongoose.Types.ObjectId(validId);
212
+ };
213
+
214
+ /** Capture pre-mutation state only when audit is on. A throwing toJSON must not fail the write. */
215
+ export const snapshotAuditBefore = ({
216
+ audit,
217
+ doc,
218
+ }: {
219
+ audit?: ModelRouterAuditConfig;
220
+ doc: {toJSON?: () => unknown};
221
+ }): unknown => {
222
+ if (!audit) {
223
+ return undefined;
224
+ }
225
+ try {
226
+ if (typeof doc.toJSON === "function") {
227
+ return doc.toJSON();
228
+ }
229
+ return doc;
230
+ } catch (error: unknown) {
231
+ logger.error("Failed to snapshot document for AuditEvent", error);
232
+ return undefined;
233
+ }
234
+ };
235
+
236
+ const persistAuditEvent = async (write: AuditEventWrite): Promise<void> => {
237
+ if (AUDIT_EVENT_MODEL_NAMES.has(write.modelName)) {
238
+ return;
239
+ }
240
+ if (!auditEventModel) {
241
+ if (!missingPluginLogged) {
242
+ missingPluginLogged = true;
243
+ logger.error(MISSING_PLUGIN_MESSAGE);
244
+ }
245
+ return;
246
+ }
247
+ const actorId = actorObjectId(write.actorId);
248
+ await auditEventModel.create({
249
+ ...(actorId ? {actorId} : {}),
250
+ ...(write.after ? {after: write.after} : {}),
251
+ ...(write.before ? {before: write.before} : {}),
252
+ modelName: write.modelName,
253
+ operation: write.operation,
254
+ ...(write.organizationId ? {organizationId: write.organizationId} : {}),
255
+ ...(write.recordId ? {recordId: write.recordId} : {}),
256
+ ...(write.recordLabel ? {recordLabel: write.recordLabel} : {}),
257
+ source: write.source,
258
+ verb: write.verb,
259
+ });
260
+ };
261
+
262
+ const runAuditWrite = async (write: AuditEventWrite): Promise<void> => {
263
+ try {
264
+ if (auditEnqueue) {
265
+ await auditEnqueue(write);
266
+ return;
267
+ }
268
+ await persistAuditEvent(write);
269
+ } catch (error: unknown) {
270
+ logger.error("Failed to persist AuditEvent", error);
271
+ }
272
+ };
273
+
274
+ export const persistEnqueuedAuditEvent = async (write: AuditEventWrite): Promise<void> => {
275
+ await persistAuditEvent(write);
276
+ };
277
+
278
+ export const recordAuditEvent = (write: AuditEventWrite): Promise<void> => {
279
+ const run = runAuditWrite(write);
280
+ inflightWrites.add(run);
281
+ void run.finally(() => {
282
+ inflightWrites.delete(run);
283
+ });
284
+ return run;
285
+ };
286
+
287
+ export const maybeRecordModelRouterAudit = async ({
288
+ after,
289
+ audit,
290
+ before,
291
+ modelName,
292
+ operation,
293
+ recordId,
294
+ req,
295
+ verb,
296
+ }: {
297
+ after?: unknown;
298
+ audit?: ModelRouterAuditConfig;
299
+ before?: unknown;
300
+ modelName: string;
301
+ operation: AuditEventOperation;
302
+ recordId?: string;
303
+ req: Request;
304
+ verb: AuditEventVerb;
305
+ }): Promise<void> => {
306
+ try {
307
+ const extraRedact = resolveAuditRedact(audit);
308
+ if (extraRedact === undefined) {
309
+ return;
310
+ }
311
+ const beforePlain = toAuditPlain(before);
312
+ const afterPlain = toAuditPlain(after);
313
+ const diff = changedFieldDiff({after: afterPlain, before: beforePlain, extraRedact});
314
+ await recordAuditEvent({
315
+ actorId: actorIdFromRequest(req),
316
+ after: diff.after,
317
+ before: diff.before,
318
+ modelName,
319
+ operation,
320
+ organizationId: organizationIdFromAuditContext(req, afterPlain, beforePlain),
321
+ recordId,
322
+ recordLabel: recordLabelFromDoc(afterPlain) ?? recordLabelFromDoc(beforePlain),
323
+ source: "modelRouter",
324
+ verb,
325
+ });
326
+ } catch (error: unknown) {
327
+ logger.error("Failed to persist AuditEvent", error);
328
+ }
329
+ };
package/src/auth.test.ts CHANGED
@@ -1103,7 +1103,7 @@ describe("privileged user fields", () => {
1103
1103
  );
1104
1104
 
1105
1105
  expect((user as unknown as {admin?: boolean}).admin).toBe(false);
1106
- expect((user as unknown as {roles?: string[]}).roles).toBeUndefined();
1106
+ expect((user as unknown as {roles?: string[]}).roles ?? []).toEqual([]);
1107
1107
  });
1108
1108
 
1109
1109
  it("does not let PATCH /auth/me escalate to admin or join organizations", async () => {
package/src/auth.ts CHANGED
@@ -695,7 +695,7 @@ export const addAuthRoutes = (
695
695
  )(req, res, next);
696
696
  },
697
697
  async (req: express.Request, res: express.Response) => {
698
- if (req.user) {
698
+ if (req.user && authOptions?.emailVerification !== false) {
699
699
  try {
700
700
  await sendVerificationEmail(req.user, authOptions);
701
701
  } catch (error: unknown) {
@@ -143,6 +143,49 @@ describe("password reset routes", () => {
143
143
  .expect(200);
144
144
  });
145
145
 
146
+ it("can disable only the legacy POST /resetPassword alias", async () => {
147
+ const noLegacyAliasApp = new TerrenoApp({
148
+ authOptions: {
149
+ legacyResetPasswordRoute: false,
150
+ publicAppUrl: "https://app.example.com",
151
+ },
152
+ skipListen: true,
153
+ userModel: UserModel,
154
+ }).build();
155
+
156
+ await supertest(noLegacyAliasApp).post("/resetPassword").send({}).expect(404);
157
+ await supertest(noLegacyAliasApp).post("/auth/resetPassword").send({}).expect(400);
158
+ });
159
+
160
+ it("can disable all password reset routes", async () => {
161
+ const noPasswordResetApp = new TerrenoApp({
162
+ authOptions: {
163
+ passwordReset: false,
164
+ publicAppUrl: "https://app.example.com",
165
+ },
166
+ skipListen: true,
167
+ userModel: UserModel,
168
+ }).build();
169
+
170
+ await supertest(noPasswordResetApp).post("/auth/forgotPassword").send({}).expect(404);
171
+ await supertest(noPasswordResetApp).post("/auth/resetPassword").send({}).expect(404);
172
+ await supertest(noPasswordResetApp).post("/resetPassword").send({}).expect(404);
173
+ });
174
+
175
+ it("can disable all email verification routes", async () => {
176
+ const noEmailVerificationApp = new TerrenoApp({
177
+ authOptions: {
178
+ emailVerification: false,
179
+ publicAppUrl: "https://app.example.com",
180
+ },
181
+ skipListen: true,
182
+ userModel: UserModel,
183
+ }).build();
184
+
185
+ await supertest(noEmailVerificationApp).post("/auth/sendVerification").send({}).expect(404);
186
+ await supertest(noEmailVerificationApp).post("/auth/verifyEmail").send({}).expect(404);
187
+ });
188
+
146
189
  it("syncs a successful JWT reset to Better Auth when a bridge is configured", async () => {
147
190
  const synced: Array<{email?: string; password: string}> = [];
148
191
  const bridgedApp = new TerrenoApp({
@@ -265,15 +265,21 @@ export const addAuthRecoveryRoutes = (
265
265
  .build();
266
266
 
267
267
  const router = express.Router();
268
- router.post("/forgotPassword", forgotOpenApi, forgotPassword);
269
- router.post("/resetPassword", resetOpenApi, resetPassword);
270
- router.post(
271
- "/sendVerification",
272
- authenticateMiddleware(),
273
- sendVerificationOpenApi,
274
- sendVerification
275
- );
276
- router.post("/verifyEmail", verifyEmailOpenApi, verifyEmail);
268
+ if (authOptions?.passwordReset !== false) {
269
+ router.post("/forgotPassword", forgotOpenApi, forgotPassword);
270
+ router.post("/resetPassword", resetOpenApi, resetPassword);
271
+ }
272
+ if (authOptions?.emailVerification !== false) {
273
+ router.post(
274
+ "/sendVerification",
275
+ authenticateMiddleware(),
276
+ sendVerificationOpenApi,
277
+ sendVerification
278
+ );
279
+ router.post("/verifyEmail", verifyEmailOpenApi, verifyEmail);
280
+ }
277
281
  app.use("/auth", router);
278
- app.post("/resetPassword", resetOpenApi, resetPassword);
282
+ if (authOptions?.passwordReset !== false && authOptions?.legacyResetPasswordRoute !== false) {
283
+ app.post("/resetPassword", resetOpenApi, resetPassword);
284
+ }
279
285
  };
package/src/authTokens.ts CHANGED
@@ -114,5 +114,9 @@ authTokenSchema.statics = {
114
114
  };
115
115
 
116
116
  export const AuthToken =
117
- (mongoose.models.AuthToken as AuthTokenModel | undefined) ??
118
- mongoose.model<AuthTokenDocument, AuthTokenModel>("AuthToken", authTokenSchema);
117
+ (mongoose.models.TerrenoAuthToken as AuthTokenModel | undefined) ??
118
+ mongoose.model<AuthTokenDocument, AuthTokenModel>(
119
+ "TerrenoAuthToken",
120
+ authTokenSchema,
121
+ "authtokens"
122
+ );
@@ -99,6 +99,28 @@ describe("email verification gating", () => {
99
99
  .expect(200);
100
100
  });
101
101
 
102
+ it("does not issue an unusable verification token on signup when routes are disabled", async () => {
103
+ const noVerificationRoutesApp = new TerrenoApp({
104
+ authOptions: {
105
+ emailVerification: false,
106
+ publicAppUrl: "https://app.example.com",
107
+ sendMail: async (message) => {
108
+ openMail.push(message);
109
+ },
110
+ },
111
+ skipListen: true,
112
+ userModel: UserModel,
113
+ }).build();
114
+
115
+ await supertest(noVerificationRoutesApp)
116
+ .post("/auth/signup")
117
+ .send({email: "custom-verification@example.com", password: "password"})
118
+ .expect(200);
119
+
120
+ assert.equal(openMail.length, 0);
121
+ assert.equal(await AuthToken.countDocuments({type: "emailVerification"}), 0);
122
+ });
123
+
102
124
  it("resends verification mail for an authenticated unverified user", async () => {
103
125
  const login = await supertest(openApp)
104
126
  .post("/auth/login")
package/src/betterAuth.ts CHANGED
@@ -90,6 +90,13 @@ export interface BetterAuthConfig {
90
90
  authMailTemplates?: Partial<
91
91
  Record<"resetPassword" | "verifyEmail", {html?: string; subject: string; text?: string}>
92
92
  >;
93
+
94
+ /**
95
+ * Disable Better Auth's built-in IP limiter. Use only on throwaway in-process
96
+ * seed apps — production `BetterAuthApp` instances keep the default (on in
97
+ * `NODE_ENV=production`).
98
+ */
99
+ disableRateLimit?: boolean;
93
100
  }
94
101
 
95
102
  /**
@@ -146,6 +146,33 @@ describe("createBetterAuth", () => {
146
146
  expect(auth.api).toBeDefined();
147
147
  });
148
148
 
149
+ it("does not 429 a burst of email sign-ups when disableRateLimit is set", async () => {
150
+ await setup;
151
+ const config: BetterAuthConfig = {
152
+ baseURL: "http://localhost:3000",
153
+ disableRateLimit: true,
154
+ enabled: true,
155
+ secret: "test-secret-at-least-32-characters-long",
156
+ };
157
+ const auth = createBetterAuth({config, mongoClient: getClient()});
158
+
159
+ for (let index = 0; index < 6; index += 1) {
160
+ const response = await auth.handler(
161
+ new globalThis.Request("https://localhost:3000/api/auth/sign-up/email", {
162
+ body: JSON.stringify({
163
+ email: `seed-burst-${index}@example.com`,
164
+ name: `Seed Burst ${index}`,
165
+ password: "testpassword123",
166
+ }),
167
+ headers: {"Content-Type": "application/json"},
168
+ method: "POST",
169
+ })
170
+ );
171
+ assert.notEqual(response.status, 429, `sign-up ${index} was rate-limited`);
172
+ assert.isTrue(response.ok, `sign-up ${index} failed: ${response.status}`);
173
+ }
174
+ });
175
+
149
176
  it("sets cross-site session cookies when crossDomainCookies is enabled", async () => {
150
177
  await setup;
151
178
  const origin = "https://frontend.example.com";
@@ -228,6 +228,7 @@ export const createBetterAuth = (options: CreateBetterAuthOptions): BetterAuthIn
228
228
  // token as a bearer header) — without it, a raw session token cannot be validated and
229
229
  // socket auth silently fails (the sync client shows perpetually "offline").
230
230
  plugins: [bearer()],
231
+ rateLimit: config.disableRateLimit ? {enabled: false} : undefined,
231
232
  secret,
232
233
  session: {
233
234
  cookieCache: {
@@ -0,0 +1,110 @@
1
+ import {appendFileSync, existsSync, mkdirSync, statSync, writeFileSync} from "node:fs";
2
+ import {join} from "node:path";
3
+ import express from "express";
4
+ import {DateTime} from "luxon";
5
+
6
+ const MAX_BATCH_ENTRIES = 100;
7
+ const MAX_LEVEL_LENGTH = 32;
8
+ const MAX_MESSAGE_LENGTH = 8000;
9
+ const MAX_STACK_LENGTH = 16_000;
10
+ const BROWSER_LOG_BODY_LIMIT_BYTES = 256 * 1024;
11
+ const BROWSER_LOG_BODY_LIMIT = "256kb";
12
+ const MAX_BROWSER_LOG_FILE_BYTES = 5 * 1024 * 1024;
13
+
14
+ const shouldEnableBrowserLogs = (): boolean => {
15
+ if (process.env.NODE_ENV === "production") {
16
+ return false;
17
+ }
18
+ if (process.env.TERRENO_BROWSER_LOGS === "false" || process.env.TERRENO_BROWSER_LOGS === "0") {
19
+ return false;
20
+ }
21
+ if (process.env.TERRENO_BROWSER_LOGS === "true" || process.env.TERRENO_BROWSER_LOGS === "1") {
22
+ return true;
23
+ }
24
+ return process.env.NODE_ENV === "development";
25
+ };
26
+
27
+ interface BrowserLogPayload {
28
+ level?: string;
29
+ message?: unknown;
30
+ stack?: string;
31
+ timestamp?: string;
32
+ }
33
+
34
+ const isLoopbackAddress = (address: string | undefined): boolean => {
35
+ return address === "127.0.0.1" || address === "::1" || address === "::ffff:127.0.0.1";
36
+ };
37
+
38
+ const isBrowserLogRequestAllowed = (req: express.Request): boolean => {
39
+ return Boolean(req.user) || isLoopbackAddress(req.socket.remoteAddress);
40
+ };
41
+
42
+ /**
43
+ * Dev-only ingestion for the Terreno MCP `read_logs` tool: POST batches of client
44
+ * console / global error lines as JSONL under `.terreno/logs/browser.log`.
45
+ */
46
+ export const addTerrenoDevBrowserLogsRoute = (app: express.Application): void => {
47
+ if (!shouldEnableBrowserLogs()) {
48
+ return;
49
+ }
50
+
51
+ app.post("/__terreno/browser-logs", express.json({limit: BROWSER_LOG_BODY_LIMIT}), (req, res) => {
52
+ if (!isBrowserLogRequestAllowed(req)) {
53
+ res
54
+ .status(403)
55
+ .json({error: "Browser log ingestion requires a local or authenticated client"});
56
+ return;
57
+ }
58
+ const parsedBodySize = Buffer.byteLength(JSON.stringify(req.body ?? null));
59
+ if (parsedBodySize > BROWSER_LOG_BODY_LIMIT_BYTES) {
60
+ res.status(413).json({error: "Browser log payload may not exceed 256 kB"});
61
+ return;
62
+ }
63
+ const body = req.body as {entries?: unknown} | undefined;
64
+ if (!Array.isArray(body?.entries) || body.entries.length === 0) {
65
+ res.status(400).json({error: "Expected { entries: [...] }"});
66
+ return;
67
+ }
68
+ if (body.entries.length > MAX_BATCH_ENTRIES) {
69
+ res.status(413).json({error: `A batch may contain at most ${MAX_BATCH_ENTRIES} entries`});
70
+ return;
71
+ }
72
+
73
+ const logDir = join(process.cwd(), ".terreno", "logs");
74
+ mkdirSync(logDir, {recursive: true});
75
+ const path = join(logDir, "browser.log");
76
+ const lines: string[] = [];
77
+
78
+ for (const row of body.entries) {
79
+ if (typeof row !== "object" || row === null) {
80
+ continue;
81
+ }
82
+ const r = row as BrowserLogPayload;
83
+ const level = (typeof r.level === "string" ? r.level : "info").slice(0, MAX_LEVEL_LENGTH);
84
+ const rawMessage =
85
+ typeof r.message === "string" ? r.message : JSON.stringify(r.message ?? "");
86
+ lines.push(
87
+ JSON.stringify({
88
+ level,
89
+ message: rawMessage.slice(0, MAX_MESSAGE_LENGTH),
90
+ source: "browser",
91
+ stack: typeof r.stack === "string" ? r.stack.slice(0, MAX_STACK_LENGTH) : undefined,
92
+ timestamp:
93
+ typeof r.timestamp === "string" && r.timestamp ? r.timestamp : DateTime.now().toISO(),
94
+ })
95
+ );
96
+ }
97
+
98
+ if (lines.length > 0) {
99
+ const payload = `${lines.join("\n")}\n`;
100
+ const currentSize = existsSync(path) ? statSync(path).size : 0;
101
+ if (currentSize + Buffer.byteLength(payload) > MAX_BROWSER_LOG_FILE_BYTES) {
102
+ writeFileSync(path, payload, {encoding: "utf-8", mode: 0o600});
103
+ } else {
104
+ appendFileSync(path, payload, {encoding: "utf-8", mode: 0o600});
105
+ }
106
+ }
107
+
108
+ res.status(204).end();
109
+ });
110
+ };
@@ -135,7 +135,7 @@ describe("CollectionRegistry", () => {
135
135
  expect(getSyncRegistry()[0]?.options).toBe(updatedOptions);
136
136
  });
137
137
 
138
- it("rejects re-registering sync at the same route path", () => {
138
+ it("treats re-registering the same model at the same route path as a no-op", () => {
139
139
  clearSyncRegistry();
140
140
  registerSync({
141
141
  config: {scope: {type: "owner"}},
@@ -143,14 +143,13 @@ describe("CollectionRegistry", () => {
143
143
  options: syncOptions,
144
144
  routePath: "/catalogTodos",
145
145
  });
146
- expect(() =>
147
- registerSync({
148
- config: {scope: {type: "owner"}},
149
- model: CatalogTodoModel,
150
- options: syncOptions,
151
- routePath: "/catalogTodos",
152
- })
153
- ).toThrow(/already registered/);
146
+ registerSync({
147
+ config: {scope: {type: "owner"}},
148
+ model: CatalogTodoModel,
149
+ options: syncOptions,
150
+ routePath: "/catalogTodos",
151
+ });
152
+ expect(getSyncRegistry()).toHaveLength(1);
154
153
  });
155
154
 
156
155
  it("clearCollectionRegistry resets deferred sync index tasks", async () => {