@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
@@ -1,238 +1,125 @@
1
1
  "use strict";
2
- var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
- function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
- return new (P || (P = Promise))(function (resolve, reject) {
5
- function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
- function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
- function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
- step((generator = generator.apply(thisArg, _arguments || [])).next());
9
- });
10
- };
11
- var __generator = (this && this.__generator) || function (thisArg, body) {
12
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
- return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
- function verb(n) { return function (v) { return step([n, v]); }; }
15
- function step(op) {
16
- if (f) throw new TypeError("Generator is already executing.");
17
- while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
- if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
- if (y = 0, t) op = [op[0] & 2, t.value];
20
- switch (op[0]) {
21
- case 0: case 1: t = op; break;
22
- case 4: _.label++; return { value: op[1], done: false };
23
- case 5: _.label++; y = op[1]; op = [0]; continue;
24
- case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
- default:
26
- if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
- if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
- if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
- if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
- if (t[2]) _.ops.pop();
31
- _.trys.pop(); continue;
32
- }
33
- op = body.call(thisArg, _);
34
- } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
- if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
- }
37
- };
38
- var __values = (this && this.__values) || function(o) {
39
- var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
40
- if (m) return m.call(o);
41
- if (o && typeof o.length === "number") return {
42
- next: function () {
43
- if (o && i >= o.length) o = void 0;
44
- return { value: o && o[i++], done: !o };
45
- }
46
- };
47
- throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
48
- };
49
- var __read = (this && this.__read) || function (o, n) {
50
- var m = typeof Symbol === "function" && o[Symbol.iterator];
51
- if (!m) return o;
52
- var i = m.call(o), r, ar = [], e;
53
- try {
54
- while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
55
- }
56
- catch (error) { e = { error: error }; }
57
- finally {
58
- try {
59
- if (r && !r.done && (m = i["return"])) m.call(i);
60
- }
61
- finally { if (e) throw e.error; }
62
- }
63
- return ar;
64
- };
65
- var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
66
- if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
67
- if (ar || !(i in from)) {
68
- if (!ar) ar = Array.prototype.slice.call(from, 0, i);
69
- ar[i] = from[i];
70
- }
71
- }
72
- return to.concat(ar || Array.prototype.slice.call(from));
73
- };
74
2
  Object.defineProperty(exports, "__esModule", { value: true });
75
3
  exports.getAllMCPTools = exports.generateAllTools = exports.generateToolsForEntry = void 0;
76
- var zod_1 = require("zod");
77
- var logger_1 = require("../logger");
78
- var requestContext_1 = require("../requestContext");
79
- var handlers_1 = require("./handlers");
80
- var registry_1 = require("./registry");
81
- var schemaGenerator_1 = require("./schemaGenerator");
82
- var getToolPrefix = function (entry) {
4
+ const zod_1 = require("zod");
5
+ const logger_1 = require("../logger");
6
+ const requestContext_1 = require("../requestContext");
7
+ const handlers_1 = require("./handlers");
8
+ const registry_1 = require("./registry");
9
+ const schemaGenerator_1 = require("./schemaGenerator");
10
+ const getToolPrefix = (entry) => {
83
11
  if (entry.config.toolPrefix) {
84
12
  return entry.config.toolPrefix;
85
13
  }
86
14
  // Default: lowercase model name with simple pluralization. Irregular nouns are expected
87
15
  // to set config.toolPrefix rather than growing an exception list here.
88
- var name = entry.modelName.toLowerCase();
16
+ const name = entry.modelName.toLowerCase();
89
17
  if (/(?:s|x|z|ch|sh)$/.test(name)) {
90
- return "".concat(name, "es");
18
+ return `${name}es`;
91
19
  }
92
20
  if (name.endsWith("y") && !/[aeiou]y$/i.test(name)) {
93
- return "".concat(name.slice(0, -1), "ies");
21
+ return `${name.slice(0, -1)}ies`;
94
22
  }
95
- return "".concat(name, "s");
23
+ return `${name}s`;
96
24
  };
97
- var METHOD_HANDLERS = {
25
+ const METHOD_HANDLERS = {
98
26
  create: handlers_1.handleCreate,
99
27
  delete: handlers_1.handleDelete,
100
28
  list: handlers_1.handleList,
101
29
  read: handlers_1.handleRead,
102
30
  update: handlers_1.handleUpdate,
103
31
  };
104
- var getToolErrorMessage = function (result) {
105
- var _a;
106
- var text = (_a = result.content[0]) === null || _a === void 0 ? void 0 : _a.text;
32
+ const getToolErrorMessage = (result) => {
33
+ const text = result.content[0]?.text;
107
34
  if (!text) {
108
35
  return "Unknown MCP tool error";
109
36
  }
110
37
  try {
111
- var parsed = JSON.parse(text);
38
+ const parsed = JSON.parse(text);
112
39
  return typeof parsed.error === "string" ? parsed.error : text;
113
40
  }
114
- catch (_b) {
41
+ catch {
115
42
  return text;
116
43
  }
117
44
  };
118
- var executeTool = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
119
- var userId, log, startedAt, result, durationMs, cause, message, error_1, durationMs;
120
- var _c;
121
- var args = _b.args, entry = _b.entry, handler = _b.handler, method = _b.method, toolName = _b.toolName, user = _b.user;
122
- return __generator(this, function (_d) {
123
- switch (_d.label) {
124
- case 0:
125
- userId = (_c = user === null || user === void 0 ? void 0 : user.id) !== null && _c !== void 0 ? _c : ((user === null || user === void 0 ? void 0 : user._id) ? String(user._id) : undefined);
126
- if (userId) {
127
- (0, requestContext_1.setRequestContext)({ userId: userId });
128
- }
129
- log = (0, logger_1.createScopedLogger)({
130
- labels: {
131
- mcpMethod: method,
132
- mcpModel: entry.modelName,
133
- mcpTool: toolName,
134
- },
135
- prefix: "[MCPTool]",
136
- });
137
- startedAt = performance.now();
138
- _d.label = 1;
139
- case 1:
140
- _d.trys.push([1, 3, , 4]);
141
- return [4 /*yield*/, handler(entry, args, user)];
142
- case 2:
143
- result = _d.sent();
144
- durationMs = Math.round(performance.now() - startedAt);
145
- if (!result.isError) {
146
- log.info("MCP tool call succeeded", { durationMs: durationMs });
147
- return [2 /*return*/, result];
148
- }
149
- cause = (0, handlers_1.getMCPErrorCause)(result);
150
- message = getToolErrorMessage(result);
151
- if (cause !== undefined) {
152
- // ScopedLogger.catch records the original exception and captures it in Sentry when enabled.
153
- log.catch(cause);
154
- log.error("MCP tool call failed", { durationMs: durationMs, message: message });
155
- }
156
- else {
157
- // Permission, not-found, and input errors are expected failures: retain an audit trail
158
- // and Sentry log without reporting them as exceptions.
159
- log.warn("MCP tool call refused", { durationMs: durationMs, message: message });
160
- }
161
- return [2 /*return*/, result];
162
- case 3:
163
- error_1 = _d.sent();
164
- durationMs = Math.round(performance.now() - startedAt);
165
- log.catch(error_1);
166
- log.error("MCP tool call crashed", { durationMs: durationMs });
167
- throw error_1;
168
- case 4: return [2 /*return*/];
169
- }
45
+ const executeTool = async ({ args, entry, handler, method, toolName, user, }) => {
46
+ const userId = user?.id ?? (user?._id ? String(user._id) : undefined);
47
+ if (userId) {
48
+ (0, requestContext_1.setRequestContext)({ userId });
49
+ }
50
+ const log = (0, logger_1.createScopedLogger)({
51
+ labels: {
52
+ mcpMethod: method,
53
+ mcpModel: entry.modelName,
54
+ mcpTool: toolName,
55
+ },
56
+ prefix: "[MCPTool]",
170
57
  });
171
- }); };
172
- var generateToolsForEntry = function (entry) {
173
- var e_1, _a;
174
- var _b, _c;
175
- var methods = (_b = entry.config.methods) !== null && _b !== void 0 ? _b : ["list", "read"];
176
- var prefix = getToolPrefix(entry);
177
- var tools = [];
178
- var _loop_1 = function (method) {
58
+ const startedAt = performance.now();
59
+ try {
60
+ const result = await handler(entry, args, user);
61
+ const durationMs = Math.round(performance.now() - startedAt);
62
+ if (!result.isError) {
63
+ log.info("MCP tool call succeeded", { durationMs });
64
+ return result;
65
+ }
66
+ const cause = (0, handlers_1.getMCPErrorCause)(result);
67
+ const message = getToolErrorMessage(result);
68
+ if (cause !== undefined) {
69
+ // ScopedLogger.catch records the original exception and captures it in Sentry when enabled.
70
+ log.catch(cause);
71
+ log.error("MCP tool call failed", { durationMs, message });
72
+ }
73
+ else {
74
+ // Permission, not-found, and input errors are expected failures: retain an audit trail
75
+ // and Sentry log without reporting them as exceptions.
76
+ log.warn("MCP tool call refused", { durationMs, message });
77
+ }
78
+ return result;
79
+ }
80
+ catch (error) {
81
+ const durationMs = Math.round(performance.now() - startedAt);
82
+ log.catch(error);
83
+ log.error("MCP tool call crashed", { durationMs });
84
+ throw error;
85
+ }
86
+ };
87
+ const generateToolsForEntry = (entry) => {
88
+ const methods = entry.config.methods ?? ["list", "read"];
89
+ const prefix = getToolPrefix(entry);
90
+ const tools = [];
91
+ for (const method of methods) {
179
92
  // Skip methods with empty permission arrays (disabled)
180
- if (((_c = entry.options.permissions[method]) === null || _c === void 0 ? void 0 : _c.length) === 0) {
181
- return "continue";
93
+ if (entry.options.permissions[method]?.length === 0) {
94
+ continue;
182
95
  }
183
- var restExcludeFields = (0, schemaGenerator_1.restWriteExcludeFields)(method, entry.options.validation);
184
- var zodSchema = (0, schemaGenerator_1.generateInputSchema)(entry.model, method, entry.config, entry.options.queryFields, entry.options.populatePaths, restExcludeFields);
185
- var inputSchema = (0, zod_1.toJSONSchema)(zodSchema);
186
- var handler = METHOD_HANDLERS[method];
187
- var toolName = "".concat(prefix, "_").concat(method);
96
+ const restExcludeFields = (0, schemaGenerator_1.restWriteExcludeFields)(method, entry.options.validation);
97
+ const zodSchema = (0, schemaGenerator_1.generateInputSchema)(entry.model, method, entry.config, entry.options.queryFields, entry.options.populatePaths, restExcludeFields);
98
+ const inputSchema = (0, zod_1.toJSONSchema)(zodSchema);
99
+ const handler = METHOD_HANDLERS[method];
100
+ const toolName = `${prefix}_${method}`;
188
101
  tools.push({
189
102
  description: (0, schemaGenerator_1.generateToolDescription)(entry.model, method, entry.config, entry.options.queryFields, entry.options.populatePaths, restExcludeFields),
190
- handler: function (args, user) {
191
- return executeTool({ args: args, entry: entry, handler: handler, method: method, toolName: toolName, user: user });
192
- },
103
+ handler: (args, user) => executeTool({ args, entry, handler, method, toolName, user }),
193
104
  inputSchema: inputSchema,
194
105
  name: toolName,
195
- zodSchema: zodSchema,
106
+ zodSchema,
196
107
  });
197
- };
198
- try {
199
- for (var methods_1 = __values(methods), methods_1_1 = methods_1.next(); !methods_1_1.done; methods_1_1 = methods_1.next()) {
200
- var method = methods_1_1.value;
201
- _loop_1(method);
202
- }
203
- }
204
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
205
- finally {
206
- try {
207
- if (methods_1_1 && !methods_1_1.done && (_a = methods_1.return)) _a.call(methods_1);
208
- }
209
- finally { if (e_1) throw e_1.error; }
210
108
  }
211
109
  return tools;
212
110
  };
213
111
  exports.generateToolsForEntry = generateToolsForEntry;
214
- var generateAllTools = function (entries) {
215
- var e_2, _a;
216
- var tools = [];
217
- try {
218
- for (var entries_1 = __values(entries), entries_1_1 = entries_1.next(); !entries_1_1.done; entries_1_1 = entries_1.next()) {
219
- var entry = entries_1_1.value;
220
- tools.push.apply(tools, __spreadArray([], __read((0, exports.generateToolsForEntry)(entry)), false));
221
- }
222
- }
223
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
224
- finally {
225
- try {
226
- if (entries_1_1 && !entries_1_1.done && (_a = entries_1.return)) _a.call(entries_1);
227
- }
228
- finally { if (e_2) throw e_2.error; }
112
+ const generateAllTools = (entries) => {
113
+ const tools = [];
114
+ for (const entry of entries) {
115
+ tools.push(...(0, exports.generateToolsForEntry)(entry));
229
116
  }
230
117
  return tools;
231
118
  };
232
119
  exports.generateAllTools = generateAllTools;
233
120
  /** Model-router tools plus any custom tools registered with `registerMCPTool`. */
234
- var getAllMCPTools = function () {
235
- var customTools = (0, registry_1.getMCPCustomTools)().map(function (tool) {
121
+ const getAllMCPTools = () => {
122
+ const customTools = (0, registry_1.getMCPCustomTools)().map((tool) => {
236
123
  return {
237
124
  description: tool.description,
238
125
  handler: tool.handler,
@@ -241,6 +128,6 @@ var getAllMCPTools = function () {
241
128
  zodSchema: tool.zodSchema,
242
129
  };
243
130
  });
244
- return __spreadArray(__spreadArray([], __read((0, exports.generateAllTools)((0, registry_1.getMCPRegistry)())), false), __read(customTools), false);
131
+ return [...(0, exports.generateAllTools)((0, registry_1.getMCPRegistry)()), ...customTools];
245
132
  };
246
133
  exports.getAllMCPTools = getAllMCPTools;
@@ -1,15 +1,4 @@
1
1
  "use strict";
2
- var __assign = (this && this.__assign) || function () {
3
- __assign = Object.assign || function(t) {
4
- for (var s, i = 1, n = arguments.length; i < n; i++) {
5
- s = arguments[i];
6
- for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
7
- t[p] = s[p];
8
- }
9
- return t;
10
- };
11
- return __assign.apply(this, arguments);
12
- };
13
2
  var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
14
3
  if (k2 === undefined) k2 = k;
15
4
  var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -45,18 +34,18 @@ var __importStar = (this && this.__importStar) || (function () {
45
34
  })();
46
35
  Object.defineProperty(exports, "__esModule", { value: true });
47
36
  exports.jsonResponseRequestIdMiddleware = exports.sentryAppVersionMiddleware = exports.requireAdminMiddleware = void 0;
48
- var Sentry = __importStar(require("@sentry/bun"));
49
- var errors_1 = require("./errors");
50
- var requestContext_1 = require("./requestContext");
37
+ const Sentry = __importStar(require("@sentry/bun"));
38
+ const errors_1 = require("./errors");
39
+ const requestContext_1 = require("./requestContext");
51
40
  /**
52
41
  * Express middleware that rejects the request with a 403 unless the authenticated user is an admin
53
42
  * (`req.user.admin === true`). Run it after {@link authenticateMiddleware} so `req.user` is
54
43
  * populated, e.g. `[authenticateMiddleware(), requireAdminMiddleware]`. Use this for admin-only
55
44
  * custom routes instead of hand-rolling an inline admin guard.
56
45
  */
57
- var requireAdminMiddleware = function (req, _res, next) {
58
- var user = req.user;
59
- if (!(user === null || user === void 0 ? void 0 : user.admin)) {
46
+ const requireAdminMiddleware = (req, _res, next) => {
47
+ const user = req.user;
48
+ if (!user?.admin) {
60
49
  throw new errors_1.APIError({ status: 403, title: "Admin access required" });
61
50
  }
62
51
  next();
@@ -70,8 +59,8 @@ exports.requireAdminMiddleware = requireAdminMiddleware;
70
59
  *
71
60
  * Expected header: `App-Version`
72
61
  */
73
- var sentryAppVersionMiddleware = function (req, _res, next) {
74
- var appVersion = req.get("App-Version");
62
+ const sentryAppVersionMiddleware = (req, _res, next) => {
63
+ const appVersion = req.get("App-Version");
75
64
  if (appVersion) {
76
65
  Sentry.getCurrentScope().setTag("app_version", appVersion);
77
66
  }
@@ -82,11 +71,11 @@ exports.sentryAppVersionMiddleware = sentryAppVersionMiddleware;
82
71
  * OpenAPI vendor routes that must return pristine JSON (no injected requestId).
83
72
  * Matches @wesleytodd/openapi: main spec, per-component JSON, and validate payload.
84
73
  */
85
- var isOpenApiToolingJsonRequest = function (req) {
74
+ const isOpenApiToolingJsonRequest = (req) => {
86
75
  if (req.method !== "GET") {
87
76
  return false;
88
77
  }
89
- var path = req.path;
78
+ const { path } = req;
90
79
  if (path === "/openapi.json") {
91
80
  return true;
92
81
  }
@@ -104,19 +93,18 @@ var isOpenApiToolingJsonRequest = function (req) {
104
93
  * (`/openapi.json`, `/openapi/components/...json`, `/openapi/validate`) so
105
94
  * machine-consumed payloads stay valid. Does not wrap arrays or primitives.
106
95
  */
107
- var jsonResponseRequestIdMiddleware = function (req, res, next) {
108
- var originalJson = res.json.bind(res);
109
- res.json = function (body) {
110
- var _a, _b;
96
+ const jsonResponseRequestIdMiddleware = (req, res, next) => {
97
+ const originalJson = res.json.bind(res);
98
+ res.json = (body) => {
111
99
  if (isOpenApiToolingJsonRequest(req)) {
112
100
  return originalJson(body);
113
101
  }
114
- var requestId = (_a = req.requestId) !== null && _a !== void 0 ? _a : (_b = (0, requestContext_1.getCurrentRequestContext)()) === null || _b === void 0 ? void 0 : _b.requestId;
102
+ const requestId = req.requestId ?? (0, requestContext_1.getCurrentRequestContext)()?.requestId;
115
103
  if (!requestId) {
116
104
  return originalJson(body);
117
105
  }
118
106
  if (body !== null && body !== undefined && typeof body === "object" && !Array.isArray(body)) {
119
- return originalJson(__assign(__assign({}, body), { requestId: requestId }));
107
+ return originalJson({ ...body, requestId });
120
108
  }
121
109
  return originalJson(body);
122
110
  };
@@ -0,0 +1,4 @@
1
+ /** Loader fixture: reversible file used to prove full up-then-down exercise. */
2
+ export declare const id = "20260910120000-one";
3
+ export declare const up: () => Promise<void>;
4
+ export declare const down: () => Promise<void>;
@@ -0,0 +1,9 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.down = exports.up = exports.id = void 0;
4
+ /** Loader fixture: reversible file used to prove full up-then-down exercise. */
5
+ exports.id = "20260910120000-one";
6
+ const up = async () => undefined;
7
+ exports.up = up;
8
+ const down = async () => undefined;
9
+ exports.down = down;
@@ -0,0 +1,4 @@
1
+ /** Loader fixture: second reversible file in the all-down pair. */
2
+ export declare const id = "20260910120001-two";
3
+ export declare const up: () => Promise<void>;
4
+ export declare const down: () => Promise<void>;
@@ -0,0 +1,9 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.down = exports.up = exports.id = void 0;
4
+ /** Loader fixture: second reversible file in the all-down pair. */
5
+ exports.id = "20260910120001-two";
6
+ const up = async () => undefined;
7
+ exports.up = up;
8
+ const down = async () => undefined;
9
+ exports.down = down;
@@ -0,0 +1,3 @@
1
+ /** Loader fixture: filename is valid but exported `id` does not match the stem. */
2
+ export declare const id = "wrong-id";
3
+ export declare const up: () => Promise<void>;
@@ -0,0 +1,7 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.up = exports.id = void 0;
4
+ /** Loader fixture: filename is valid but exported `id` does not match the stem. */
5
+ exports.id = "wrong-id";
6
+ const up = async () => undefined;
7
+ exports.up = up;
@@ -0,0 +1,3 @@
1
+ /** Loader fixture: filename is not `YYYYMMDDHHmmss-slug.ts`. */
2
+ export declare const id = "not-a-migration";
3
+ export declare const up: () => Promise<void>;
@@ -0,0 +1,7 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.up = exports.id = void 0;
4
+ /** Loader fixture: filename is not `YYYYMMDDHHmmss-slug.ts`. */
5
+ exports.id = "not-a-migration";
6
+ const up = async () => undefined;
7
+ exports.up = up;
@@ -0,0 +1,2 @@
1
+ /** Loader fixture: valid filename/id but missing required `up` export. */
2
+ export declare const id = "20260910120000-noup";
@@ -0,0 +1,5 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.id = void 0;
4
+ /** Loader fixture: valid filename/id but missing required `up` export. */
5
+ exports.id = "20260910120000-noup";
@@ -0,0 +1,3 @@
1
+ /** Loader fixture: irreversible (no `down`), first in the valid pair. */
2
+ export declare const id = "20260910120000-alpha";
3
+ export declare const up: () => Promise<void>;
@@ -0,0 +1,7 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.up = exports.id = void 0;
4
+ /** Loader fixture: irreversible (no `down`), first in the valid pair. */
5
+ exports.id = "20260910120000-alpha";
6
+ const up = async () => undefined;
7
+ exports.up = up;
@@ -0,0 +1,4 @@
1
+ /** Loader fixture: reversible (`down` present), second in the valid pair. */
2
+ export declare const id = "20260910120001-beta";
3
+ export declare const up: () => Promise<void>;
4
+ export declare const down: () => Promise<void>;
@@ -0,0 +1,9 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.down = exports.up = exports.id = void 0;
4
+ /** Loader fixture: reversible (`down` present), second in the valid pair. */
5
+ exports.id = "20260910120001-beta";
6
+ const up = async () => undefined;
7
+ exports.up = up;
8
+ const down = async () => undefined;
9
+ exports.down = down;
@@ -0,0 +1,17 @@
1
+ import { DateTime } from "luxon";
2
+ import type { Model, Document as MongooseDocument } from "mongoose";
3
+ import { type SchemaCatalog } from "./schemaCatalog";
4
+ export interface GenerateMigrationOptions {
5
+ dir: string;
6
+ models: Model<MongooseDocument>[];
7
+ name?: string;
8
+ now?: () => DateTime;
9
+ }
10
+ export interface GenerateMigrationResult {
11
+ noop: boolean;
12
+ path: string | null;
13
+ }
14
+ export declare const lastSchemaAfter: (catalogs: Array<{
15
+ schemaAfter?: unknown;
16
+ }>) => SchemaCatalog | undefined;
17
+ export declare const generateMigration: ({ dir, models, name, now, }: GenerateMigrationOptions) => Promise<GenerateMigrationResult>;