@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.
- package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
- package/README.md +23 -7
- package/dist/actions.js +19 -7
- package/dist/adminTypes.d.ts +7 -0
- package/dist/adminTypes.js +6 -1
- package/dist/api.d.ts +14 -0
- package/dist/api.js +111 -60
- package/dist/audit/auditApp.d.ts +30 -0
- package/dist/audit/auditApp.js +155 -0
- package/dist/audit/auditEventModel.d.ts +29 -0
- package/dist/audit/auditEventModel.js +102 -0
- package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
- package/dist/audit/cloudTasksEnqueue.js +162 -0
- package/dist/audit/diff.d.ts +10 -0
- package/dist/audit/diff.js +230 -0
- package/dist/audit/processQueue.d.ts +6 -0
- package/dist/audit/processQueue.js +101 -0
- package/dist/audit/rbacSink.d.ts +2 -0
- package/dist/audit/rbacSink.js +82 -0
- package/dist/audit/record.d.ts +56 -0
- package/dist/audit/record.js +373 -0
- package/dist/auth.d.ts +23 -10
- package/dist/auth.js +97 -32
- package/dist/authRecovery.d.ts +5 -0
- package/dist/authRecovery.js +350 -0
- package/dist/authTokens.d.ts +8 -0
- package/dist/authTokens.js +162 -0
- package/dist/betterAuth.d.ts +39 -0
- package/dist/betterAuthApp.d.ts +4 -0
- package/dist/betterAuthApp.js +26 -8
- package/dist/betterAuthSetup.d.ts +44 -2
- package/dist/betterAuthSetup.js +288 -18
- package/dist/collectionRegistry.d.ts +40 -0
- package/dist/collectionRegistry.js +97 -0
- package/dist/configurationApp.d.ts +11 -2
- package/dist/configurationApp.js +2 -4
- package/dist/docLoader.js +35 -6
- package/dist/expressServer.d.ts +26 -3
- package/dist/expressServer.js +79 -11
- package/dist/index.d.ts +42 -1
- package/dist/index.js +84 -2
- package/dist/mcp/auth.d.ts +1 -0
- package/dist/mcp/auth.js +47 -25
- package/dist/mcp/handlers.d.ts +1 -1
- package/dist/mcp/handlers.js +67 -233
- package/dist/mcp/query.d.ts +2 -15
- package/dist/mcp/query.js +8 -8
- package/dist/mcp/registry.d.ts +1 -5
- package/dist/mcp/registry.js +31 -20
- package/dist/mcp/schemaGenerator.d.ts +2 -7
- package/dist/mcp/schemaGenerator.js +41 -116
- package/dist/mcp/server.d.ts +1 -0
- package/dist/mcp/server.js +1 -0
- package/dist/mcp/serviceTokens.d.ts +16 -0
- package/dist/mcp/serviceTokens.js +345 -0
- package/dist/mcp/types.d.ts +2 -2
- package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
- package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
- package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
- package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
- package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
- package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
- package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
- package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
- package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
- package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
- package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
- package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
- package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
- package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
- package/dist/migrations/generate.d.ts +17 -0
- package/dist/migrations/generate.js +277 -0
- package/dist/migrations/load.d.ts +20 -0
- package/dist/migrations/load.js +236 -0
- package/dist/migrations/lock.d.ts +13 -0
- package/dist/migrations/lock.js +145 -0
- package/dist/migrations/runner.d.ts +42 -0
- package/dist/migrations/runner.js +503 -0
- package/dist/migrations/schemaCatalog.d.ts +44 -0
- package/dist/migrations/schemaCatalog.js +326 -0
- package/dist/migrations/types.d.ts +87 -0
- package/dist/migrations/types.js +7 -0
- package/dist/models/mcpServiceToken.d.ts +3 -0
- package/dist/models/mcpServiceToken.js +208 -0
- package/dist/models/notification.d.ts +2 -0
- package/dist/models/notification.js +62 -0
- package/dist/models/notificationPreference.d.ts +2 -0
- package/dist/models/notificationPreference.js +49 -0
- package/dist/notifications/notificationService.d.ts +40 -0
- package/dist/notifications/notificationService.js +323 -0
- package/dist/notifications/notificationsApp.d.ts +18 -0
- package/dist/notifications/notificationsApp.js +250 -0
- package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
- package/dist/notifications/notificationsBeforeSend.js +77 -0
- package/dist/openApi.d.ts +1 -7
- package/dist/openApi.js +7 -6
- package/dist/openApiBuilder.d.ts +19 -7
- package/dist/openApiBuilder.js +61 -8
- package/dist/openApiCompat.js +1 -1
- package/dist/openApiValidator.d.ts +13 -1
- package/dist/openApiValidator.js +200 -38
- package/dist/orgs/orgContext.d.ts +23 -0
- package/dist/orgs/orgContext.js +198 -0
- package/dist/orgs/orgPermissions.d.ts +4 -0
- package/dist/orgs/orgPermissions.js +77 -0
- package/dist/orgs/orgPlugin.d.ts +13 -0
- package/dist/orgs/orgPlugin.js +84 -0
- package/dist/orgs/organizationModel.d.ts +13 -0
- package/dist/orgs/organizationModel.js +301 -0
- package/dist/orgs/organizationSettings.d.ts +19 -0
- package/dist/orgs/organizationSettings.js +120 -0
- package/dist/orgs/orgsApp.d.ts +28 -0
- package/dist/orgs/orgsApp.js +678 -0
- package/dist/permissions.d.ts +7 -13
- package/dist/permissions.js +8 -31
- package/dist/plugins.d.ts +14 -1
- package/dist/plugins.js +17 -6
- package/dist/populate.d.ts +2 -2
- package/dist/populate.js +47 -42
- package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
- package/dist/rateLimit/applyTrustProxy.js +17 -0
- package/dist/rateLimit/createStore.d.ts +2 -0
- package/dist/rateLimit/createStore.js +28 -0
- package/dist/rateLimit/memoryStore.d.ts +2 -0
- package/dist/rateLimit/memoryStore.js +108 -0
- package/dist/rateLimit/middleware.d.ts +3 -0
- package/dist/rateLimit/middleware.js +109 -0
- package/dist/rateLimit/mongoStore.d.ts +4 -0
- package/dist/rateLimit/mongoStore.js +123 -0
- package/dist/rateLimit/policies.d.ts +10 -0
- package/dist/rateLimit/policies.js +149 -0
- package/dist/rateLimit/redisStore.d.ts +4 -0
- package/dist/rateLimit/redisStore.js +156 -0
- package/dist/rateLimit/types.d.ts +54 -0
- package/dist/rateLimit/types.js +9 -0
- package/dist/rbac/access.js +35 -14
- package/dist/rbac/assertAllowed.d.ts +9 -0
- package/dist/rbac/assertAllowed.js +182 -0
- package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
- package/dist/rbac/membershipOrgAdminSource.js +122 -0
- package/dist/rbac/modelRouterAccess.d.ts +4 -0
- package/dist/rbac/modelRouterAccess.js +11 -4
- package/dist/rbac/permissionUtils.js +3 -2
- package/dist/rbac/resolve.js +65 -35
- package/dist/rbac/roleModel.d.ts +2 -5
- package/dist/rbac/roleModel.js +18 -4
- package/dist/rbac/routes.js +15 -6
- package/dist/rbac/statements.d.ts +10 -1
- package/dist/rbac/statements.js +19 -2
- package/dist/rbac/types.d.ts +5 -0
- package/dist/realtime/changeStreamWatcher.d.ts +10 -4
- package/dist/realtime/changeStreamWatcher.js +110 -64
- package/dist/realtime/deprecation.d.ts +13 -0
- package/dist/realtime/deprecation.js +33 -0
- package/dist/realtime/realtimeApp.d.ts +2 -1
- package/dist/realtime/realtimeApp.js +11 -11
- package/dist/realtime/registry.d.ts +0 -31
- package/dist/realtime/registry.js +44 -31
- package/dist/realtime/socketAuth.d.ts +5 -5
- package/dist/realtime/socketAuth.js +11 -1
- package/dist/realtime/socketUser.d.ts +5 -1
- package/dist/realtime/types.d.ts +14 -4
- package/dist/schemaMetadata.d.ts +56 -0
- package/dist/schemaMetadata.js +524 -0
- package/dist/seedRunner.d.ts +88 -0
- package/dist/seedRunner.js +627 -0
- package/dist/sync/adminBroadcastScope.d.ts +40 -0
- package/dist/sync/adminBroadcastScope.js +194 -0
- package/dist/sync/adminWindowAccess.d.ts +13 -0
- package/dist/sync/adminWindowAccess.js +96 -0
- package/dist/sync/adminWindowMutation.d.ts +88 -0
- package/dist/sync/adminWindowMutation.js +247 -0
- package/dist/sync/executors.d.ts +19 -3
- package/dist/sync/executors.js +194 -165
- package/dist/sync/loadHarness.js +28 -19
- package/dist/sync/models.js +26 -24
- package/dist/sync/mutationHandler.d.ts +14 -2
- package/dist/sync/mutationHandler.js +201 -76
- package/dist/sync/registrationSideEffects.d.ts +35 -0
- package/dist/sync/registrationSideEffects.js +151 -0
- package/dist/sync/registry.d.ts +2 -52
- package/dist/sync/registry.js +42 -187
- package/dist/sync/routes.d.ts +13 -0
- package/dist/sync/routes.js +116 -58
- package/dist/sync/scripts/compactTombstones.js +0 -2
- package/dist/sync/socketHandlers.d.ts +8 -2
- package/dist/sync/socketHandlers.js +144 -50
- package/dist/sync/streams.d.ts +2 -0
- package/dist/sync/streams.js +7 -1
- package/dist/sync/syncApp.d.ts +4 -3
- package/dist/sync/syncApp.js +5 -4
- package/dist/sync/syncBatch.d.ts +5 -2
- package/dist/sync/syncBatch.js +7 -6
- package/dist/sync/syncSeqPlugin.d.ts +1 -1
- package/dist/sync/syncSeqPlugin.js +20 -16
- package/dist/sync/types.d.ts +18 -0
- package/dist/terrenoApp.d.ts +48 -5
- package/dist/terrenoApp.js +157 -72
- package/dist/tests/createTestData.d.ts +1 -3
- package/dist/tests/createTestData.js +3 -5
- package/dist/tests/models.d.ts +3 -0
- package/dist/tests/models.js +15 -2
- package/dist/tests/testHelper.d.ts +0 -5
- package/dist/tests/testHelper.js +2 -9
- package/dist/types/authToken.d.ts +33 -0
- package/dist/types/authToken.js +2 -0
- package/dist/types/mcpServiceToken.d.ts +41 -0
- package/dist/types/mcpServiceToken.js +2 -0
- package/dist/types/membership.d.ts +23 -0
- package/dist/types/membership.js +2 -0
- package/dist/types/notification.d.ts +28 -0
- package/dist/types/notification.js +2 -0
- package/dist/types/notificationPreference.d.ts +20 -0
- package/dist/types/notificationPreference.js +2 -0
- package/dist/types/organization.d.ts +36 -0
- package/dist/types/organization.js +2 -0
- package/dist/webhooks/headerValue.d.ts +2 -0
- package/dist/webhooks/headerValue.js +14 -0
- package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
- package/dist/webhooks/idempotency/memoryStore.js +65 -0
- package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
- package/dist/webhooks/idempotency/mongoStore.js +150 -0
- package/dist/webhooks/idempotency/webhookReceipt.d.ts +17 -0
- package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
- package/dist/webhooks/rawBody.d.ts +15 -0
- package/dist/webhooks/rawBody.js +23 -0
- package/dist/webhooks/timingSafeEqual.d.ts +4 -0
- package/dist/webhooks/timingSafeEqual.js +17 -0
- package/dist/webhooks/verifiers/hmac.d.ts +15 -0
- package/dist/webhooks/verifiers/hmac.js +49 -0
- package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
- package/dist/webhooks/verifiers/sendgrid.js +56 -0
- package/dist/webhooks/verifiers/stripe.d.ts +9 -0
- package/dist/webhooks/verifiers/stripe.js +99 -0
- package/dist/webhooks/verifiers/twilio.d.ts +9 -0
- package/dist/webhooks/verifiers/twilio.js +112 -0
- package/dist/webhooks/webhooksApp.d.ts +33 -0
- package/dist/webhooks/webhooksApp.js +195 -0
- package/package.json +32 -27
- package/src/__snapshots__/openApi.test.ts.snap +444 -36
- package/src/__snapshots__/openApiBuilder.test.ts.snap +24 -24
- package/src/__snapshots__/schemaMetadata.test.ts.snap +196 -0
- package/src/actions.ts +20 -13
- package/src/adminModelRouter.test.ts +133 -0
- package/src/adminTypes.ts +8 -0
- package/src/api.arrayOperations.test.ts +43 -31
- package/src/api.hooks.test.ts +38 -29
- package/src/api.query.test.ts +31 -31
- package/src/api.test.ts +133 -97
- package/src/api.ts +84 -27
- package/src/audit/auditApp.test.ts +243 -0
- package/src/audit/auditApp.ts +139 -0
- package/src/audit/auditEventModel.ts +156 -0
- package/src/audit/auditRouter.test.ts +456 -0
- package/src/audit/cloudTasksEnqueue.test.ts +124 -0
- package/src/audit/cloudTasksEnqueue.ts +104 -0
- package/src/audit/diff.ts +163 -0
- package/src/audit/processQueue.ts +69 -0
- package/src/audit/rbacSink.test.ts +86 -0
- package/src/audit/rbacSink.ts +42 -0
- package/src/audit/record.test.ts +402 -0
- package/src/audit/record.ts +328 -0
- package/src/auth.test.ts +108 -52
- package/src/auth.ts +98 -29
- package/src/authRecovery.test.ts +281 -0
- package/src/authRecovery.ts +279 -0
- package/src/authTokens.test.ts +94 -0
- package/src/authTokens.ts +118 -0
- package/src/authVerification.test.ts +293 -0
- package/src/betterAuth.ts +31 -0
- package/src/betterAuthApp.test.ts +1 -0
- package/src/betterAuthApp.ts +27 -9
- package/src/betterAuthSetup.test.ts +595 -38
- package/src/betterAuthSetup.ts +261 -5
- package/src/collectionRegistry.test.ts +164 -0
- package/src/collectionRegistry.ts +135 -0
- package/src/configurationApp.ts +13 -7
- package/src/docLoader.test.ts +45 -1
- package/src/docLoader.ts +37 -6
- package/src/express.d.ts +3 -0
- package/src/expressServer.test.ts +180 -68
- package/src/expressServer.ts +75 -19
- package/src/githubAuth.test.ts +60 -55
- package/src/index.ts +127 -0
- package/src/mcp/auth.test.ts +47 -0
- package/src/mcp/auth.ts +32 -11
- package/src/mcp/handlers.test.ts +275 -0
- package/src/mcp/handlers.ts +45 -172
- package/src/mcp/integration.test.ts +59 -9
- package/src/mcp/query.ts +5 -7
- package/src/mcp/registry.ts +29 -20
- package/src/mcp/schemaGenerator.test.ts +8 -0
- package/src/mcp/schemaGenerator.ts +49 -131
- package/src/mcp/server.ts +2 -0
- package/src/mcp/serviceTokens.test.ts +330 -0
- package/src/mcp/serviceTokens.ts +307 -0
- package/src/mcp/toolGenerator.test.ts +82 -1
- package/src/mcp/types.ts +2 -6
- package/src/migrations/cli.test.ts +376 -0
- package/src/migrations/cli.ts +283 -0
- package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
- package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
- package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
- package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
- package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
- package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
- package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
- package/src/migrations/generate.test.ts +333 -0
- package/src/migrations/generate.ts +216 -0
- package/src/migrations/load.test.ts +103 -0
- package/src/migrations/load.ts +124 -0
- package/src/migrations/lock.test.ts +133 -0
- package/src/migrations/lock.ts +118 -0
- package/src/migrations/runner.test.ts +504 -0
- package/src/migrations/runner.ts +358 -0
- package/src/migrations/schemaCatalog.test.ts +159 -0
- package/src/migrations/schemaCatalog.ts +262 -0
- package/src/migrations/types.ts +94 -0
- package/src/models/mcpServiceToken.test.ts +129 -0
- package/src/models/mcpServiceToken.ts +158 -0
- package/src/models/notification.ts +68 -0
- package/src/models/notificationPreference.ts +62 -0
- package/src/notifications/notificationService.ts +254 -0
- package/src/notifications/notificationsApp.test.ts +505 -0
- package/src/notifications/notificationsApp.ts +200 -0
- package/src/notifications/notificationsBeforeSend.ts +51 -0
- package/src/openApi.test.ts +80 -65
- package/src/openApi.ts +2 -1
- package/src/openApiBuilder.test.ts +95 -7
- package/src/openApiBuilder.ts +60 -12
- package/src/openApiCompat.ts +1 -1
- package/src/openApiValidator.test.ts +270 -56
- package/src/openApiValidator.ts +219 -36
- package/src/orgs/orgAccessOptIn.test.ts +87 -0
- package/src/orgs/orgContext.test.ts +259 -0
- package/src/orgs/orgContext.ts +151 -0
- package/src/orgs/orgPermissions.test.ts +105 -0
- package/src/orgs/orgPermissions.ts +40 -0
- package/src/orgs/orgPlugin.test.ts +130 -0
- package/src/orgs/orgPlugin.ts +70 -0
- package/src/orgs/orgRbac.test.ts +267 -0
- package/src/orgs/orgSecurityDefects.test.ts +415 -0
- package/src/orgs/organizationModel.test.ts +205 -0
- package/src/orgs/organizationModel.ts +257 -0
- package/src/orgs/organizationSettings.test.ts +113 -0
- package/src/orgs/organizationSettings.ts +126 -0
- package/src/orgs/orgsApp.test.ts +382 -0
- package/src/orgs/orgsApp.ts +563 -0
- package/src/permissions.test.ts +62 -36
- package/src/permissions.ts +8 -30
- package/src/plugins.test.ts +14 -0
- package/src/plugins.ts +34 -9
- package/src/populate.test.ts +34 -0
- package/src/populate.ts +40 -29
- package/src/rateLimit/applyTrustProxy.ts +17 -0
- package/src/rateLimit/createStore.ts +25 -0
- package/src/rateLimit/memoryStore.ts +40 -0
- package/src/rateLimit/middleware.ts +79 -0
- package/src/rateLimit/mongoStore.test.ts +80 -0
- package/src/rateLimit/mongoStore.ts +77 -0
- package/src/rateLimit/policies.ts +130 -0
- package/src/rateLimit/rateLimit.test.ts +328 -0
- package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
- package/src/rateLimit/redisStore.test.ts +114 -0
- package/src/rateLimit/redisStore.ts +86 -0
- package/src/rateLimit/types.ts +64 -0
- package/src/rbac/access.ts +16 -4
- package/src/rbac/assertAllowed.test.ts +325 -0
- package/src/rbac/assertAllowed.ts +157 -0
- package/src/rbac/backfillAdmins.test.ts +124 -0
- package/src/rbac/fieldViews.test.ts +89 -0
- package/src/rbac/membershipOrgAdminSource.ts +59 -0
- package/src/rbac/modelRouterAccess.test.ts +126 -0
- package/src/rbac/modelRouterAccess.ts +8 -2
- package/src/rbac/permissionUtils.test.ts +26 -5
- package/src/rbac/permissionUtils.ts +3 -2
- package/src/rbac/realtimeAccess.test.ts +109 -1
- package/src/rbac/resolve.test.ts +34 -2
- package/src/rbac/resolve.ts +31 -11
- package/src/rbac/roleManager.test.ts +169 -0
- package/src/rbac/roleModel.test.ts +34 -1
- package/src/rbac/roleModel.ts +17 -1
- package/src/rbac/routes.test.ts +233 -0
- package/src/rbac/routes.ts +16 -6
- package/src/rbac/statements.test.ts +19 -0
- package/src/rbac/statements.ts +19 -1
- package/src/rbac/types.ts +5 -0
- package/src/realtime/changeStreamWatcher.ts +73 -33
- package/src/realtime/deprecation.test.ts +60 -0
- package/src/realtime/deprecation.ts +33 -0
- package/src/realtime/realtime.test.ts +365 -189
- package/src/realtime/realtimeApp.ts +11 -11
- package/src/realtime/realtimeAppSetup.test.ts +32 -5
- package/src/realtime/registry.ts +48 -42
- package/src/realtime/sessionRevalidation.test.ts +57 -44
- package/src/realtime/socketAuth.test.ts +75 -23
- package/src/realtime/socketAuth.ts +17 -6
- package/src/realtime/socketUser.ts +5 -3
- package/src/realtime/types.ts +14 -4
- package/src/schemaMetadata.test.ts +419 -0
- package/src/schemaMetadata.ts +593 -0
- package/src/scrubAdminFields.test.ts +105 -0
- package/src/seedRunner.test.ts +591 -0
- package/src/seedRunner.ts +464 -0
- package/src/sync/adminBroadcastConfig.test.ts +96 -0
- package/src/sync/adminBroadcastScope.test.ts +155 -0
- package/src/sync/adminBroadcastScope.ts +123 -0
- package/src/sync/adminWindowAccess.test.ts +57 -0
- package/src/sync/adminWindowAccess.ts +32 -0
- package/src/sync/adminWindowMutation.test.ts +450 -0
- package/src/sync/adminWindowMutation.ts +283 -0
- package/src/sync/docMatchesMutationData.test.ts +16 -0
- package/src/sync/ensureSyncIndexes.test.ts +54 -15
- package/src/sync/executors.test.ts +40 -0
- package/src/sync/executors.ts +57 -18
- package/src/sync/integration.test.ts +15 -7
- package/src/sync/loadHarness.ts +28 -19
- package/src/sync/models.ts +32 -18
- package/src/sync/mutationHandler.test.ts +293 -17
- package/src/sync/mutationHandler.ts +180 -36
- package/src/sync/registrationSideEffects.test.ts +126 -0
- package/src/sync/registrationSideEffects.ts +131 -0
- package/src/sync/registry.ts +49 -171
- package/src/sync/routes.ts +55 -10
- package/src/sync/scripts/compactTombstones.ts +0 -2
- package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
- package/src/sync/socketHandlers.ts +154 -58
- package/src/sync/streams.ts +6 -0
- package/src/sync/sync.test.ts +28 -25
- package/src/sync/syncApp.ts +5 -4
- package/src/sync/syncBatch.ts +10 -4
- package/src/sync/syncFrontier.test.ts +17 -15
- package/src/sync/syncPhaseC.test.ts +54 -43
- package/src/sync/syncRoutes.test.ts +347 -38
- package/src/sync/syncSeqPlugin.ts +66 -44
- package/src/sync/syncSocket.test.ts +341 -81
- package/src/sync/types.ts +20 -0
- package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
- package/src/terrenoApp.migrations.test.ts +114 -0
- package/src/terrenoApp.test.ts +41 -0
- package/src/terrenoApp.ts +181 -46
- package/src/tests/createTestData.ts +2 -2
- package/src/tests/models.ts +24 -3
- package/src/tests/testHelper.ts +1 -7
- package/src/types/authToken.ts +41 -0
- package/src/types/mcpServiceToken.ts +48 -0
- package/src/types/membership.ts +48 -0
- package/src/types/notification.ts +34 -0
- package/src/types/notificationPreference.ts +28 -0
- package/src/types/organization.ts +49 -0
- package/src/webhooks/headerValue.test.ts +22 -0
- package/src/webhooks/headerValue.ts +12 -0
- package/src/webhooks/idempotency/memoryStore.ts +34 -0
- package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
- package/src/webhooks/idempotency/mongoStore.ts +83 -0
- package/src/webhooks/idempotency/webhookReceipt.ts +67 -0
- package/src/webhooks/rawBody.test.ts +107 -0
- package/src/webhooks/rawBody.ts +24 -0
- package/src/webhooks/timingSafeEqual.ts +16 -0
- package/src/webhooks/verifiers/hmac.test.ts +110 -0
- package/src/webhooks/verifiers/hmac.ts +54 -0
- package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
- package/src/webhooks/verifiers/sendgrid.ts +59 -0
- package/src/webhooks/verifiers/stripe.ts +67 -0
- package/src/webhooks/verifiers/twilio.ts +69 -0
- package/src/webhooks/webhooksApp.test.ts +221 -0
- package/src/webhooks/webhooksApp.ts +144 -0
- package/tsconfig.json +1 -1
- package/tsconfig.typedoc.json +2 -1
- package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
- package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
- package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
|
@@ -1,6 +1,5 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
import type {ClientSession, Model, Query, Schema} from "mongoose";
|
|
1
|
+
import type {ClientSession, Query, Schema} from "mongoose";
|
|
2
|
+
import {APIError} from "../errors";
|
|
4
3
|
import {logger} from "../logger";
|
|
5
4
|
import {claimSyncSeqs, confirmSyncSeqs, releaseSyncSeqs, SyncScopeMove} from "./models";
|
|
6
5
|
import {findSyncEntryByModelName, type SyncRegistryEntry} from "./registry";
|
|
@@ -222,6 +221,17 @@ const writeScopeMoveMarker = async ({
|
|
|
222
221
|
}
|
|
223
222
|
};
|
|
224
223
|
|
|
224
|
+
/** The subset of a Mongoose model the raw-collection re-stamp write needs. */
|
|
225
|
+
interface RestampableModel {
|
|
226
|
+
modelName: string;
|
|
227
|
+
collection: {
|
|
228
|
+
updateOne(
|
|
229
|
+
filter: Record<string, unknown>,
|
|
230
|
+
update: Record<string, unknown>
|
|
231
|
+
): Promise<{matchedCount?: number}>;
|
|
232
|
+
};
|
|
233
|
+
}
|
|
234
|
+
|
|
225
235
|
/**
|
|
226
236
|
* Task 9.17: the confirm found no pending entry, meaning this writer's claim was reaped as
|
|
227
237
|
* abandoned (it stalled past {@link PENDING_CLAIM_LEASE_MS} without crashing) and the
|
|
@@ -239,7 +249,7 @@ const restampReapedSeq = async ({
|
|
|
239
249
|
stream,
|
|
240
250
|
reapedSeq,
|
|
241
251
|
}: {
|
|
242
|
-
model:
|
|
252
|
+
model: RestampableModel;
|
|
243
253
|
/** The document's RAW `_id` — the native driver does no casting, so a stringified
|
|
244
254
|
* ObjectId would match nothing and silently leave the doc below the frontier. */
|
|
245
255
|
id: unknown;
|
|
@@ -253,10 +263,7 @@ const restampReapedSeq = async ({
|
|
|
253
263
|
);
|
|
254
264
|
try {
|
|
255
265
|
const claim = await claimSyncSeqs({stream});
|
|
256
|
-
const result = await model.collection.updateOne(
|
|
257
|
-
{_id: id as any},
|
|
258
|
-
{$set: {_syncSeq: claim.lastSeq}}
|
|
259
|
-
);
|
|
266
|
+
const result = await model.collection.updateOne({_id: id}, {$set: {_syncSeq: claim.lastSeq}});
|
|
260
267
|
if ((result.matchedCount ?? 0) === 0) {
|
|
261
268
|
logger.error("[sync] Re-stamp matched no document; releasing the re-stamp claim", {
|
|
262
269
|
entityId: String(id),
|
|
@@ -287,16 +294,18 @@ const restampReapedSeq = async ({
|
|
|
287
294
|
}
|
|
288
295
|
};
|
|
289
296
|
|
|
290
|
-
export const syncPlugin = (schema: Schema
|
|
297
|
+
export const syncPlugin = (schema: Schema): void => {
|
|
291
298
|
// Task 9.13: `doc.save()` must be conditional on the version the document was loaded at,
|
|
292
299
|
// so the `baseVersion` comparison in executeUpdate cannot be defeated by a concurrent
|
|
293
300
|
// save landing between the read and the write.
|
|
294
301
|
if (!schema.options.versionKey) {
|
|
295
|
-
throw new
|
|
296
|
-
|
|
302
|
+
throw new APIError({
|
|
303
|
+
status: 500,
|
|
304
|
+
title:
|
|
305
|
+
"syncPlugin requires a versionKey on the schema: sync relies on Mongoose " +
|
|
297
306
|
"optimisticConcurrency to make the baseVersion conflict check atomic. " +
|
|
298
|
-
"Remove `versionKey: false` from the schema options."
|
|
299
|
-
);
|
|
307
|
+
"Remove `versionKey: false` from the schema options.",
|
|
308
|
+
});
|
|
300
309
|
}
|
|
301
310
|
schema.set("optimisticConcurrency", true);
|
|
302
311
|
|
|
@@ -318,7 +327,9 @@ export const syncPlugin = (schema: Schema<any, any, any, any>): void => {
|
|
|
318
327
|
// Capture the stream the document belonged to when it was loaded, so scope moves can
|
|
319
328
|
// be detected at save time without re-querying.
|
|
320
329
|
schema.post("init", function () {
|
|
321
|
-
const entry = findSyncEntryByModelName(
|
|
330
|
+
const entry = findSyncEntryByModelName(
|
|
331
|
+
(this.constructor as unknown as {modelName: string}).modelName
|
|
332
|
+
);
|
|
322
333
|
if (!entry) {
|
|
323
334
|
return;
|
|
324
335
|
}
|
|
@@ -338,7 +349,9 @@ export const syncPlugin = (schema: Schema<any, any, any, any>): void => {
|
|
|
338
349
|
}
|
|
339
350
|
|
|
340
351
|
schema.pre("save", async function () {
|
|
341
|
-
const entry = findSyncEntryByModelName(
|
|
352
|
+
const entry = findSyncEntryByModelName(
|
|
353
|
+
(this.constructor as unknown as {modelName: string}).modelName
|
|
354
|
+
);
|
|
342
355
|
if (!entry) {
|
|
343
356
|
return;
|
|
344
357
|
}
|
|
@@ -409,7 +422,7 @@ export const syncPlugin = (schema: Schema<any, any, any, any>): void => {
|
|
|
409
422
|
// running, so the frontier already passed the seq we just committed.
|
|
410
423
|
const restamped = await restampReapedSeq({
|
|
411
424
|
id: this._id,
|
|
412
|
-
model: this.constructor as
|
|
425
|
+
model: this.constructor as unknown as RestampableModel,
|
|
413
426
|
reapedSeq: pending.claim.seqs[pending.claim.seqs.length - 1],
|
|
414
427
|
stream: pending.currentStream,
|
|
415
428
|
});
|
|
@@ -446,8 +459,11 @@ export const syncPlugin = (schema: Schema<any, any, any, any>): void => {
|
|
|
446
459
|
// Keep arity ≥ 3 so Kareem still classifies this as error middleware.
|
|
447
460
|
schema.post(
|
|
448
461
|
"save",
|
|
449
|
-
async function (error:
|
|
450
|
-
const locals = (this?.$locals ??
|
|
462
|
+
async function (error: unknown, doc: unknown, _next: (err?: Error) => void): Promise<void> {
|
|
463
|
+
const locals = (this?.$locals ??
|
|
464
|
+
(doc as {$locals?: Record<string, unknown>} | undefined)?.$locals) as
|
|
465
|
+
| Record<string, unknown>
|
|
466
|
+
| undefined;
|
|
451
467
|
const pending = locals?.[PENDING_COMMIT_KEY] as PendingSaveCommit | undefined;
|
|
452
468
|
if (locals) {
|
|
453
469
|
locals[PENDING_COMMIT_KEY] = undefined;
|
|
@@ -469,11 +485,11 @@ export const syncPlugin = (schema: Schema<any, any, any, any>): void => {
|
|
|
469
485
|
// Mongoose 9 insertMany pre hooks are async (no `next` callback) and receive docs + options.
|
|
470
486
|
schema.pre(
|
|
471
487
|
"insertMany",
|
|
472
|
-
async function (docs:
|
|
488
|
+
async function (docs: unknown, options?: {session?: ClientSession | null}) {
|
|
473
489
|
const docsArray = Array.isArray(docs)
|
|
474
490
|
? (docs as Record<string, unknown>[])
|
|
475
491
|
: [docs as Record<string, unknown>];
|
|
476
|
-
const model = this as unknown as
|
|
492
|
+
const model = this as unknown as {modelName: string};
|
|
477
493
|
const entry = findSyncEntryByModelName(model.modelName);
|
|
478
494
|
if (!entry || docsArray.length === 0) {
|
|
479
495
|
return;
|
|
@@ -509,22 +525,21 @@ export const syncPlugin = (schema: Schema<any, any, any, any>): void => {
|
|
|
509
525
|
return;
|
|
510
526
|
}
|
|
511
527
|
const modelName = ((docs[0] as {constructor?: {modelName?: string}})?.constructor?.modelName ??
|
|
512
|
-
(this as unknown as
|
|
528
|
+
(this as unknown as {modelName?: string}).modelName) as string | undefined;
|
|
513
529
|
const entry = modelName ? findSyncEntryByModelName(modelName) : undefined;
|
|
514
530
|
if (!entry) {
|
|
515
531
|
return;
|
|
516
532
|
}
|
|
517
533
|
const seqsByStream = new Map<string, number[]>();
|
|
518
|
-
for (const doc of docs as
|
|
534
|
+
for (const doc of docs as Array<
|
|
535
|
+
Record<string, unknown> & {$session?: () => unknown; toObject?: () => Record<string, unknown>}
|
|
536
|
+
>) {
|
|
519
537
|
// A session-backed claim registered nothing to confirm, and a `$pull` issued outside
|
|
520
538
|
// the caller's still-open transaction would conflict with its counter write.
|
|
521
539
|
if (typeof doc?.$session === "function" && doc.$session()) {
|
|
522
540
|
continue;
|
|
523
541
|
}
|
|
524
|
-
const obj =
|
|
525
|
-
string,
|
|
526
|
-
unknown
|
|
527
|
-
>;
|
|
542
|
+
const obj = typeof doc?.toObject === "function" ? doc.toObject() : doc;
|
|
528
543
|
const seq = obj._syncSeq;
|
|
529
544
|
if (typeof seq !== "number") {
|
|
530
545
|
continue;
|
|
@@ -547,8 +562,18 @@ export const syncPlugin = (schema: Schema<any, any, any, any>): void => {
|
|
|
547
562
|
|
|
548
563
|
// Single-document query writes: fetch the target to resolve its stream (and detect
|
|
549
564
|
// scope moves), claim a seq, and merge the stamp into the update.
|
|
550
|
-
|
|
551
|
-
|
|
565
|
+
/** What a query-write's post hook must finish once the write commits. */
|
|
566
|
+
interface PendingQueryConfirm {
|
|
567
|
+
claim: {registered: boolean; seqs: number[]};
|
|
568
|
+
currentStream: string;
|
|
569
|
+
entityId: string;
|
|
570
|
+
entry: SyncRegistryEntry;
|
|
571
|
+
prevStream: string | null;
|
|
572
|
+
session: ClientSession | null;
|
|
573
|
+
}
|
|
574
|
+
|
|
575
|
+
const preQueryWrite = async function (this: Query<unknown, never>): Promise<void> {
|
|
576
|
+
const model = this.model;
|
|
552
577
|
const entry = findSyncEntryByModelName(model.modelName);
|
|
553
578
|
if (!entry) {
|
|
554
579
|
return;
|
|
@@ -582,7 +607,7 @@ export const syncPlugin = (schema: Schema<any, any, any, any>): void => {
|
|
|
582
607
|
const targetObj = target.toObject() as Record<string, unknown>;
|
|
583
608
|
const previousStream = streamForObject(entry, targetObj);
|
|
584
609
|
|
|
585
|
-
const rawUpdate = (this.getUpdate() ?? {}) as Record<string,
|
|
610
|
+
const rawUpdate = (this.getUpdate() ?? {}) as Record<string, unknown>;
|
|
586
611
|
// Only replaceOne/findOneAndReplace replace the document. A plain object passed to
|
|
587
612
|
// updateOne/findOneAndUpdate is an IMPLICIT $set in Mongoose — treating it as a
|
|
588
613
|
// replacement would resolve the scope value as undefined and claim the wrong stream.
|
|
@@ -653,7 +678,7 @@ export const syncPlugin = (schema: Schema<any, any, any, any>): void => {
|
|
|
653
678
|
}
|
|
654
679
|
this.setUpdate(rawUpdate);
|
|
655
680
|
// Stash the claim + move info so the query post hook confirms/records after commit.
|
|
656
|
-
(this as unknown as {_syncPendingConfirm?:
|
|
681
|
+
(this as unknown as {_syncPendingConfirm?: PendingQueryConfirm})._syncPendingConfirm = {
|
|
657
682
|
claim,
|
|
658
683
|
currentStream,
|
|
659
684
|
entityId: String(target._id),
|
|
@@ -665,20 +690,15 @@ export const syncPlugin = (schema: Schema<any, any, any, any>): void => {
|
|
|
665
690
|
|
|
666
691
|
// C1/C4: after the query write commits, confirm the claimed seq and record the
|
|
667
692
|
// scope-move marker. Query post middleware `this` is the Query (not a document).
|
|
668
|
-
const postQueryWrite = async function (this: Query<
|
|
669
|
-
const pending = (this as unknown as {_syncPendingConfirm?:
|
|
693
|
+
const postQueryWrite = async function (this: Query<unknown, never>): Promise<void> {
|
|
694
|
+
const pending = (this as unknown as {_syncPendingConfirm?: PendingQueryConfirm})
|
|
695
|
+
._syncPendingConfirm;
|
|
670
696
|
if (!pending) {
|
|
671
697
|
return;
|
|
672
698
|
}
|
|
673
|
-
(this as unknown as {_syncPendingConfirm?:
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
currentStream: string;
|
|
677
|
-
entityId: string;
|
|
678
|
-
entry: SyncRegistryEntry;
|
|
679
|
-
prevStream: string | null;
|
|
680
|
-
session: ClientSession | null;
|
|
681
|
-
};
|
|
699
|
+
(this as unknown as {_syncPendingConfirm?: PendingQueryConfirm})._syncPendingConfirm =
|
|
700
|
+
undefined;
|
|
701
|
+
const {claim, currentStream, entityId, entry, prevStream, session} = pending;
|
|
682
702
|
if (claim.registered) {
|
|
683
703
|
await confirmSyncSeqs({seqs: claim.seqs, stream: currentStream}).catch((error: unknown) => {
|
|
684
704
|
logger.error("[sync] Failed to confirm seq after query write", {
|
|
@@ -711,8 +731,8 @@ export const syncPlugin = (schema: Schema<any, any, any, any>): void => {
|
|
|
711
731
|
|
|
712
732
|
// Unsupported multi-document / hard-delete paths throw for registered models.
|
|
713
733
|
const guardQuery = (operation: string) =>
|
|
714
|
-
function (this: Query<
|
|
715
|
-
const model = this.model
|
|
734
|
+
function (this: Query<unknown, never>): void {
|
|
735
|
+
const model = this.model;
|
|
716
736
|
if (findSyncEntryByModelName(model.modelName)) {
|
|
717
737
|
throw unsupportedWrite(model.modelName, operation);
|
|
718
738
|
}
|
|
@@ -722,7 +742,9 @@ export const syncPlugin = (schema: Schema<any, any, any, any>): void => {
|
|
|
722
742
|
schema.pre("deleteOne", {document: false, query: true}, guardQuery("deleteOne"));
|
|
723
743
|
schema.pre("findOneAndDelete", guardQuery("findOneAndDelete"));
|
|
724
744
|
schema.pre("deleteOne", {document: true, query: false}, function () {
|
|
725
|
-
const entry = findSyncEntryByModelName(
|
|
745
|
+
const entry = findSyncEntryByModelName(
|
|
746
|
+
(this.constructor as unknown as {modelName: string}).modelName
|
|
747
|
+
);
|
|
726
748
|
if (entry) {
|
|
727
749
|
throw unsupportedWrite(entry.modelName, "document deleteOne (hard delete)");
|
|
728
750
|
}
|