@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
@@ -143,10 +143,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
143
143
  var node_http_1 = require("node:http");
144
144
  var syncdb_1 = require("@terreno/syncdb");
145
145
  var express_1 = __importDefault(require("express"));
146
+ var luxon_1 = require("luxon");
146
147
  var mongoose_1 = __importStar(require("mongoose"));
147
148
  var passport_local_mongoose_1 = __importDefault(require("passport-local-mongoose"));
148
149
  var api_1 = require("../api");
149
150
  var auth_1 = require("../auth");
151
+ var errors_1 = require("../errors");
150
152
  var logger_1 = require("../logger");
151
153
  var permissions_1 = require("../permissions");
152
154
  var plugins_1 = require("../plugins");
@@ -237,10 +239,10 @@ var waitFor = function (predicate_1) {
237
239
  return __generator(this, function (_f) {
238
240
  switch (_f.label) {
239
241
  case 0:
240
- start = Date.now();
242
+ start = luxon_1.DateTime.now().toMillis();
241
243
  _f.label = 1;
242
244
  case 1:
243
- if (!(Date.now() - start < timeoutMs)) return [3 /*break*/, 4];
245
+ if (!(luxon_1.DateTime.now().toMillis() - start < timeoutMs)) return [3 /*break*/, 4];
244
246
  return [4 /*yield*/, predicate()];
245
247
  case 2:
246
248
  if (_f.sent()) {
@@ -250,7 +252,10 @@ var waitFor = function (predicate_1) {
250
252
  case 3:
251
253
  _f.sent();
252
254
  return [3 /*break*/, 1];
253
- case 4: throw new Error("Timed out after ".concat(timeoutMs, "ms waiting for ").concat(label));
255
+ case 4: throw new errors_1.APIError({
256
+ status: 500,
257
+ title: "Timed out after ".concat(timeoutMs, "ms waiting for ").concat(label),
258
+ });
254
259
  }
255
260
  });
256
261
  });
@@ -413,7 +418,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
413
418
  perOwnerCount_1.set(owner.ownerId, ((_a = perOwnerCount_1.get(owner.ownerId)) !== null && _a !== void 0 ? _a : 0) + 1);
414
419
  return { ownerId: owner.ownerId, title: "seed-".concat(i) };
415
420
  });
416
- bootstrapStart = Date.now();
421
+ bootstrapStart = luxon_1.DateTime.now().toMillis();
417
422
  if (!(seeds.length > 0)) return [3 /*break*/, 12];
418
423
  return [4 /*yield*/, LoadTodoModel.insertMany(seeds)];
419
424
  case 11:
@@ -428,7 +433,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
428
433
  }, { label: "bootstrap convergence at ".concat(config.seedDocs, " docs"), timeoutMs: 120000 })];
429
434
  case 13:
430
435
  _w.sent();
431
- bootstrapWallMs = Date.now() - bootstrapStart;
436
+ bootstrapWallMs = luxon_1.DateTime.now().toMillis() - bootstrapStart;
432
437
  logger_1.logger.info("[loadHarness] bootstrap converged in ".concat(bootstrapWallMs, "ms"));
433
438
  mutateLatenciesMs_1 = [];
434
439
  fanoutLagsMs_1 = [];
@@ -451,7 +456,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
451
456
  }, { intervalMs: 8, label: "mutation ".concat(mutationId, " terminal"), timeoutMs: 15000 })];
452
457
  case 1:
453
458
  _b.sent();
454
- mutateLatenciesMs_1.push(Date.now() - startedAt);
459
+ mutateLatenciesMs_1.push(luxon_1.DateTime.now().toMillis() - startedAt);
455
460
  mutation = hc.client.outbox.getMutation({ mutationId: mutationId });
456
461
  if ((mutation === null || mutation === void 0 ? void 0 : mutation.status) === "conflicted") {
457
462
  conflictCount_1 += 1;
@@ -466,7 +471,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
466
471
  case 2:
467
472
  _a = _b.sent();
468
473
  // Timed out waiting; still record whatever elapsed so the report reflects it.
469
- mutateLatenciesMs_1.push(Date.now() - startedAt);
474
+ mutateLatenciesMs_1.push(luxon_1.DateTime.now().toMillis() - startedAt);
470
475
  return [3 /*break*/, 3];
471
476
  case 3: return [2 /*return*/];
472
477
  }
@@ -503,7 +508,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
503
508
  }
504
509
  loadPromises = [];
505
510
  intervalMs_1 = 1000 / config.targetRate;
506
- loadEnd = Date.now() + config.durationSec * 1000;
511
+ loadEnd = luxon_1.DateTime.now().plus({ seconds: config.durationSec }).toMillis();
507
512
  _loop_1 = function () {
508
513
  var hc, opRoll, startedAt, mutationId, target, owner_1, startedAt, mutationId, dupRequest_1, idx, target, owner, startedAt, mutationId, anyOwner, writeStart_1, doc, id_1;
509
514
  return __generator(this, function (_x) {
@@ -512,10 +517,12 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
512
517
  hc = randomClient();
513
518
  opRoll = Math.random();
514
519
  if (opRoll < 0.5 || knownEntityIds.length === 0) {
515
- startedAt = Date.now();
520
+ startedAt = luxon_1.DateTime.now().toMillis();
516
521
  mutationId = hc.client.mutate({
517
522
  collection: COLLECTION,
518
- data: { title: "load-".concat(Date.now(), "-").concat(Math.random().toString(36).slice(2, 8)) },
523
+ data: {
524
+ title: "load-".concat(luxon_1.DateTime.now().toMillis(), "-").concat(Math.random().toString(36).slice(2, 8)),
525
+ },
519
526
  operation: "create",
520
527
  }).mutationId;
521
528
  loadPromises.push(trackMutation(hc, mutationId, startedAt));
@@ -523,10 +530,10 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
523
530
  else if (opRoll < 0.85) {
524
531
  target = knownEntityIds[Math.floor(Math.random() * knownEntityIds.length)];
525
532
  owner_1 = harnessClients[target.clientIndex];
526
- startedAt = Date.now();
533
+ startedAt = luxon_1.DateTime.now().toMillis();
527
534
  mutationId = owner_1.client.mutate({
528
535
  collection: COLLECTION,
529
- data: { title: "updated-".concat(Date.now()) },
536
+ data: { title: "updated-".concat(luxon_1.DateTime.now().toMillis()) },
530
537
  id: target.id,
531
538
  operation: "update",
532
539
  }).mutationId;
@@ -541,7 +548,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
541
548
  if (!doc) {
542
549
  return;
543
550
  }
544
- doc.title = "server-race-".concat(Date.now());
551
+ doc.title = "server-race-".concat(luxon_1.DateTime.now().toMillis());
545
552
  return doc.save();
546
553
  })
547
554
  .catch(function () { });
@@ -553,8 +560,10 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
553
560
  if (Math.random() < 0.05) {
554
561
  dupRequest_1 = {
555
562
  collection: COLLECTION,
556
- data: { title: "dup-".concat(Date.now()) },
557
- mutationId: "load-dup-".concat(Date.now(), "-").concat(Math.random().toString(36).slice(2, 8)),
563
+ data: { title: "dup-".concat(luxon_1.DateTime.now().toMillis()) },
564
+ mutationId: "load-dup-".concat(luxon_1.DateTime.now().toMillis(), "-").concat(Math.random()
565
+ .toString(36)
566
+ .slice(2, 8)),
558
567
  operation: "create",
559
568
  };
560
569
  loadPromises.push(owner_1.httpChannel
@@ -570,7 +579,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
570
579
  idx = Math.floor(Math.random() * knownEntityIds.length);
571
580
  target = knownEntityIds[idx];
572
581
  owner = harnessClients[target.clientIndex];
573
- startedAt = Date.now();
582
+ startedAt = luxon_1.DateTime.now().toMillis();
574
583
  mutationId = owner.client.mutate({
575
584
  collection: COLLECTION,
576
585
  id: target.id,
@@ -581,7 +590,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
581
590
  }
582
591
  if (!(Math.random() < 0.02)) return [3 /*break*/, 2];
583
592
  anyOwner = randomClient();
584
- writeStart_1 = Date.now();
593
+ writeStart_1 = luxon_1.DateTime.now().toMillis();
585
594
  return [4 /*yield*/, LoadTodoModel.create({
586
595
  ownerId: anyOwner.ownerId,
587
596
  title: "fanout-".concat(writeStart_1),
@@ -598,7 +607,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
598
607
  timeoutMs: 15000,
599
608
  })
600
609
  .then(function () {
601
- fanoutLagsMs_1.push(Date.now() - writeStart_1);
610
+ fanoutLagsMs_1.push(luxon_1.DateTime.now().toMillis() - writeStart_1);
602
611
  })
603
612
  .catch(function () { }));
604
613
  _x.label = 2;
@@ -611,7 +620,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
611
620
  };
612
621
  _w.label = 14;
613
622
  case 14:
614
- if (!(Date.now() < loadEnd)) return [3 /*break*/, 16];
623
+ if (!(luxon_1.DateTime.now().toMillis() < loadEnd)) return [3 /*break*/, 16];
615
624
  return [5 /*yield**/, _loop_1()];
616
625
  case 15:
617
626
  _w.sent();
@@ -86,7 +86,9 @@ var _a, _b, _c, _d;
86
86
  Object.defineProperty(exports, "__esModule", { value: true });
87
87
  exports.getOrCreateSyncKeyMaterial = exports.ensureSyncModelIndexes = exports.SyncKey = exports.SyncMutation = exports.SYNC_MUTATION_LEASE_MS = exports.SyncScopeMove = exports.getCompactedThroughSeq = exports.recordCompactedThroughSeq = exports.computeStableFrontier = exports.releaseSyncSeqs = exports.confirmSyncSeqs = exports.claimSyncSeqs = exports.SyncCounter = exports.PENDING_CLAIM_LEASE_MS = void 0;
88
88
  var node_crypto_1 = __importDefault(require("node:crypto"));
89
+ var luxon_1 = require("luxon");
89
90
  var mongoose_1 = __importStar(require("mongoose"));
91
+ var errors_1 = require("../errors");
90
92
  var logger_1 = require("../logger");
91
93
  var plugins_1 = require("../plugins");
92
94
  /**
@@ -97,7 +99,7 @@ var plugins_1 = require("../plugins");
97
99
  exports.PENDING_CLAIM_LEASE_MS = 60 * 1000;
98
100
  var syncPendingClaimSchema = new mongoose_1.Schema({
99
101
  claimedAt: {
100
- default: function () { return new Date(); },
102
+ default: function () { return luxon_1.DateTime.now().toJSDate(); },
101
103
  description: "When this seq was claimed; a claim older than PENDING_CLAIM_LEASE_MS is stale",
102
104
  type: Date,
103
105
  },
@@ -175,7 +177,7 @@ var claimSyncSeqs = function (_a) { return __awaiter(void 0, [_a], void 0, funct
175
177
  return __generator(this, function (_a) {
176
178
  switch (_a.label) {
177
179
  case 0:
178
- now = new Date();
180
+ now = luxon_1.DateTime.now().toJSDate();
179
181
  return [4 /*yield*/, exports.SyncCounter.findOneAndUpdate({ stream: stream }, [
180
182
  { $set: { _syncOldSeq: { $ifNull: ["$seq", 0] } } },
181
183
  { $set: { seq: { $add: ["$_syncOldSeq", count] } } },
@@ -295,7 +297,7 @@ var computeStableFrontier = function (_a) { return __awaiter(void 0, [_a], void
295
297
  var stream = _b.stream;
296
298
  return __generator(this, function (_e) {
297
299
  switch (_e.label) {
298
- case 0: return [4 /*yield*/, exports.SyncCounter.findOne({ stream: stream })];
300
+ case 0: return [4 /*yield*/, (0, plugins_1.findOneOrNoneFor)(exports.SyncCounter, { stream: stream })];
299
301
  case 1:
300
302
  counter = _e.sent();
301
303
  if (!counter) {
@@ -305,13 +307,13 @@ var computeStableFrontier = function (_a) { return __awaiter(void 0, [_a], void
305
307
  if (pending.length === 0) {
306
308
  return [2 /*return*/, counter.seq];
307
309
  }
308
- cutoff = Date.now() - exports.PENDING_CLAIM_LEASE_MS;
310
+ cutoff = luxon_1.DateTime.now().minus({ milliseconds: exports.PENDING_CLAIM_LEASE_MS }).toMillis();
309
311
  staleSeqs = [];
310
312
  minLiveSeq = Number.POSITIVE_INFINITY;
311
313
  try {
312
314
  for (pending_1 = __values(pending), pending_1_1 = pending_1.next(); !pending_1_1.done; pending_1_1 = pending_1.next()) {
313
315
  claim = pending_1_1.value;
314
- claimedAtMs = new Date(claim.claimedAt).getTime();
316
+ claimedAtMs = luxon_1.DateTime.fromJSDate(claim.claimedAt).toMillis();
315
317
  if (claimedAtMs < cutoff) {
316
318
  staleSeqs.push(claim.seq);
317
319
  continue;
@@ -390,7 +392,7 @@ var syncScopeMoveSchema = new mongoose_1.Schema({
390
392
  type: String,
391
393
  },
392
394
  created: {
393
- default: function () { return new Date(); },
395
+ default: function () { return luxon_1.DateTime.now().toJSDate(); },
394
396
  description: "When the move was recorded; reaped by compactTombstones once older than the " +
395
397
  "owning model's retentionDays (deliberately NOT TTL-indexed — see the model doc)",
396
398
  type: Date,
@@ -452,13 +454,13 @@ var SYNC_MUTATION_TTL_SECONDS = 30 * 24 * 60 * 60;
452
454
  exports.SYNC_MUTATION_LEASE_MS = 60 * 1000;
453
455
  var syncMutationSchema = new mongoose_1.Schema({
454
456
  claimedAt: {
455
- default: function () { return new Date(); },
457
+ default: function () { return luxon_1.DateTime.now().toJSDate(); },
456
458
  description: "When this delivery claimed the mutation (lease); a pending row older than " +
457
459
  "SYNC_MUTATION_LEASE_MS may be taken over by a fresh delivery via findOneAndUpdate",
458
460
  type: Date,
459
461
  },
460
462
  created: {
461
- default: function () { return new Date(); },
463
+ default: function () { return luxon_1.DateTime.now().toJSDate(); },
462
464
  description: "When the mutation was first claimed; TTL-indexed so rows expire after 30 days",
463
465
  type: Date,
464
466
  },
@@ -515,7 +517,7 @@ syncMutationSchema.index({ created: 1 }, { expireAfterSeconds: SYNC_MUTATION_TTL
515
517
  exports.SyncMutation = (_c = mongoose_1.default.models.SyncMutation) !== null && _c !== void 0 ? _c : mongoose_1.default.model("SyncMutation", syncMutationSchema);
516
518
  var syncKeySchema = new mongoose_1.Schema({
517
519
  created: {
518
- default: function () { return new Date(); },
520
+ default: function () { return luxon_1.DateTime.now().toJSDate(); },
519
521
  description: "When this key material was generated",
520
522
  type: Date,
521
523
  },
@@ -534,17 +536,12 @@ var syncKeySchema = new mongoose_1.Schema({
534
536
  // Consumer apps run checkModelsStrict() at startup; framework models must comply.
535
537
  { strict: "throw", toJSON: { virtuals: true }, toObject: { virtuals: true } });
536
538
  exports.SyncKey = (_d = mongoose_1.default.models.SyncKey) !== null && _d !== void 0 ? _d : mongoose_1.default.model("SyncKey", syncKeySchema);
537
- /**
538
- * Every model backing the SyncDB protocol. Their indexes are correctness-critical, not
539
- * just performance: without the unique `SyncMutation.mutationId` index a duplicate
540
- * delivery double-applies a mutation (INV-3), and without the unique `SyncCounter.stream`
541
- * index the counter upsert race mints duplicate seqs. Schema-level `unique: true` only
542
- * builds them when Mongoose `autoIndex` is on — commonly disabled in production — so
543
- * startup builds them explicitly.
544
- */
545
- // noExplicitAny: a heterogeneous list of models is only used for ensureIndexes
546
- // biome-ignore lint/suspicious/noExplicitAny: a heterogeneous list of models is only used for ensureIndexes
547
- var SYNC_BOOKKEEPING_MODELS = [exports.SyncCounter, exports.SyncMutation, exports.SyncScopeMove, exports.SyncKey];
539
+ var SYNC_BOOKKEEPING_MODELS = [
540
+ exports.SyncCounter,
541
+ exports.SyncMutation,
542
+ exports.SyncScopeMove,
543
+ exports.SyncKey,
544
+ ];
548
545
  /**
549
546
  * Best-effort removal of the pre-Task-9.15 `SyncScopeMove` TTL index. Failure is only
550
547
  * logged: a leftover TTL index degrades retention accounting but must never block
@@ -607,9 +604,14 @@ var ensureSyncModelIndexes = function () { return __awaiter(void 0, void 0, void
607
604
  logger_1.logger.error("[sync] Failed to ensure sync indexes for ".concat(model.modelName), {
608
605
  error: String(error_3),
609
606
  });
610
- throw new Error("Failed to ensure sync indexes for ".concat(model.modelName, ": ").concat(String(error_3), ". ") +
611
- "The sync protocol depends on these indexes (unique mutationId for mutation " +
612
- "idempotency, unique stream for seq allocation); fix the DB and restart.");
607
+ throw new errors_1.APIError({
608
+ cause: error_3,
609
+ code: "sync-indexes-failed",
610
+ detail: "".concat((0, errors_1.errorDetail)(error_3), ". The sync protocol depends on these indexes (unique mutationId for ") +
611
+ "mutation idempotency, unique stream for seq allocation); fix the DB and restart.",
612
+ status: 500,
613
+ title: "Failed to ensure sync indexes for ".concat(model.modelName),
614
+ });
613
615
  case 3: return [2 /*return*/];
614
616
  }
615
617
  });
@@ -634,7 +636,7 @@ var getOrCreateSyncKeyMaterial = function (_a) { return __awaiter(void 0, [_a],
634
636
  switch (_c.label) {
635
637
  case 0:
636
638
  candidate = node_crypto_1.default.randomBytes(32).toString("base64");
637
- return [4 /*yield*/, exports.SyncKey.findOneAndUpdate({ userId: userId }, { $setOnInsert: { created: new Date(), keyMaterial: candidate, userId: userId } }, { new: true, upsert: true })];
639
+ return [4 /*yield*/, exports.SyncKey.findOneAndUpdate({ userId: userId }, { $setOnInsert: { created: luxon_1.DateTime.now().toJSDate(), keyMaterial: candidate, userId: userId } }, { new: true, upsert: true })];
638
640
  case 1:
639
641
  doc = _c.sent();
640
642
  return [2 /*return*/, doc.keyMaterial];
@@ -1,6 +1,7 @@
1
1
  import type express from "express";
2
2
  import type { User } from "../auth";
3
3
  import { type SyncRegistryEntry } from "./registry";
4
+ import type { SyncAppOptions } from "./routes";
4
5
  import type { SyncAck, SyncMutateBatchResponse, SyncMutateRequest, SyncNack } from "./types";
5
6
  export type SyncMutationScopeResolver = (user: User, entry: SyncRegistryEntry) => Promise<string[]> | string[];
6
7
  /**
@@ -49,17 +50,27 @@ export type SyncMutationOutcome = {
49
50
  };
50
51
  /** Maximum mutations accepted in a single `sync:mutateBatch` / `POST /sync/mutate/batch` request. */
51
52
  export declare const MAX_SYNC_MUTATIONS_PER_BATCH = 100;
53
+ /**
54
+ * C5 (FIX 6): true when every key/value in `data` (the mutation's own
55
+ * intended write) is already present on `doc` — used alongside the
56
+ * expected-post-write-seq check to distinguish "this mutation's own write
57
+ * already landed" (safe to report as already-applied) from "a genuinely
58
+ * different write landed and happens to have advanced the seq by exactly
59
+ * one" (a real conflict; a seq match alone cannot tell these apart).
60
+ */
61
+ export declare const docMatchesMutationData: (doc: unknown, data: Record<string, unknown> | undefined) => boolean;
52
62
  /**
53
63
  * Apply a client mutation through the transport-agnostic executors (permissions,
54
64
  * pre/post hooks, validation) with an atomic idempotency claim. Always finalizes the
55
65
  * claimed ledger row before returning so duplicate deliveries can read the outcome back.
56
66
  */
57
- export declare const applySyncMutation: ({ user, mutation, req, scopeResolver, }: {
67
+ export declare const applySyncMutation: ({ user, mutation, req, scopeResolver, syncOptions, }: {
58
68
  user: User;
59
69
  mutation: SyncMutateRequest;
60
70
  /** The real Express request when called over HTTP; hooks receive a `{user}` stub otherwise. */
61
71
  req?: express.Request;
62
72
  scopeResolver?: SyncMutationScopeResolver;
73
+ syncOptions?: SyncAppOptions;
63
74
  }) => Promise<SyncMutationOutcome>;
64
75
  /** Outcome of a batch validation pre-check (before any mutation is attempted). */
65
76
  export type SyncBatchValidationOutcome = {
@@ -88,10 +99,11 @@ export declare const validateSyncMutationBatch: (mutations: SyncMutateRequest[])
88
99
  * rejection happens before any mutation is attempted); this function assumes the
89
100
  * batch already passed that check.
90
101
  */
91
- export declare const applySyncMutationBatch: ({ user, mutations, req, scopeResolver, }: {
102
+ export declare const applySyncMutationBatch: ({ user, mutations, req, scopeResolver, syncOptions, }: {
92
103
  user: User;
93
104
  mutations: SyncMutateRequest[];
94
105
  /** The real Express request when called over HTTP; hooks receive a `{user}` stub otherwise. */
95
106
  req?: express.Request;
96
107
  scopeResolver?: SyncMutationScopeResolver;
108
+ syncOptions?: SyncAppOptions;
97
109
  }) => Promise<SyncMutateBatchResponse>;