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