@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,13 +1,11 @@
|
|
|
1
|
-
// noExplicitAny: test model typing
|
|
2
|
-
// biome-ignore-all lint/suspicious/noExplicitAny: test model typing
|
|
3
1
|
import {beforeEach, describe, expect, it} from "bun:test";
|
|
4
2
|
import type express from "express";
|
|
5
|
-
import {model, Schema} from "mongoose";
|
|
3
|
+
import {type Model, model, Schema} from "mongoose";
|
|
6
4
|
import supertest from "supertest";
|
|
7
5
|
import type TestAgent from "supertest/lib/agent";
|
|
8
6
|
import type {ModelRouterOptions} from "../api";
|
|
9
|
-
import {addAuthRoutes, setupAuth, type User} from "../auth";
|
|
10
|
-
import {Permissions} from "../permissions";
|
|
7
|
+
import {type UserModel as AuthUserModel, addAuthRoutes, setupAuth, type User} from "../auth";
|
|
8
|
+
import {Permissions, type RESTMethod} from "../permissions";
|
|
11
9
|
import {createdUpdatedPlugin, type IsDeleted, isDeletedPlugin} from "../plugins";
|
|
12
10
|
import {DEFAULT_IGNORED_COLLECTIONS} from "../realtime/changeStreamWatcher";
|
|
13
11
|
import {authAsUser, getBaseServer, setupDb, UserModel} from "../tests";
|
|
@@ -36,6 +34,13 @@ interface PhaseCTodo extends IsDeleted {
|
|
|
36
34
|
_syncSeq?: number;
|
|
37
35
|
}
|
|
38
36
|
|
|
37
|
+
interface SnapshotEntity {
|
|
38
|
+
id: string;
|
|
39
|
+
seq: number;
|
|
40
|
+
deleted: boolean;
|
|
41
|
+
data: {title?: string} | null;
|
|
42
|
+
}
|
|
43
|
+
|
|
39
44
|
const phaseCTodoSchema = new Schema<PhaseCTodo>({
|
|
40
45
|
ownerId: {description: "The owner", type: String},
|
|
41
46
|
title: {description: "The title", required: true, type: String},
|
|
@@ -83,7 +88,7 @@ phaseCProjectSchema.plugin(createdUpdatedPlugin);
|
|
|
83
88
|
phaseCProjectSchema.plugin(syncPlugin);
|
|
84
89
|
const PhaseCProjectModel = model<PhaseCProject>("SyncPhaseCProject", phaseCProjectSchema);
|
|
85
90
|
|
|
86
|
-
const authedOptions = {
|
|
91
|
+
const authedOptions: ModelRouterOptions<unknown> = {
|
|
87
92
|
permissions: {
|
|
88
93
|
create: [Permissions.IsAuthenticated],
|
|
89
94
|
delete: [Permissions.IsAuthenticated],
|
|
@@ -91,7 +96,7 @@ const authedOptions = {
|
|
|
91
96
|
read: [Permissions.IsAuthenticated],
|
|
92
97
|
update: [Permissions.IsAuthenticated],
|
|
93
98
|
},
|
|
94
|
-
}
|
|
99
|
+
};
|
|
95
100
|
|
|
96
101
|
// Per-user tenant membership, mutable so join tests can extend it.
|
|
97
102
|
const userOrgs = new Map<string, string[]>();
|
|
@@ -114,19 +119,19 @@ describe("Phase C sync routes", () => {
|
|
|
114
119
|
clearSyncRegistry();
|
|
115
120
|
registerSync({
|
|
116
121
|
config: {scope: {type: "owner"}},
|
|
117
|
-
model: PhaseCTodoModel as
|
|
122
|
+
model: PhaseCTodoModel as unknown as Model<unknown>,
|
|
118
123
|
options: authedOptions,
|
|
119
124
|
routePath: "/phaseCTodos",
|
|
120
125
|
});
|
|
121
126
|
registerSync({
|
|
122
127
|
config: {scope: {field: "orgId", type: "tenant"}},
|
|
123
|
-
model: PhaseCProjectModel as
|
|
128
|
+
model: PhaseCProjectModel as unknown as Model<unknown>,
|
|
124
129
|
options: authedOptions,
|
|
125
130
|
routePath: "/phaseCProjects",
|
|
126
131
|
});
|
|
127
132
|
registerSync({
|
|
128
133
|
config: {scope: {type: "owner"}},
|
|
129
|
-
model: PhaseCNoteModel as
|
|
134
|
+
model: PhaseCNoteModel as unknown as Model<unknown>,
|
|
130
135
|
options: authedOptions,
|
|
131
136
|
routePath: "/phaseCNotes",
|
|
132
137
|
});
|
|
@@ -141,8 +146,8 @@ describe("Phase C sync routes", () => {
|
|
|
141
146
|
]);
|
|
142
147
|
|
|
143
148
|
app = getBaseServer();
|
|
144
|
-
setupAuth(app
|
|
145
|
-
addAuthRoutes(app
|
|
149
|
+
setupAuth(app, UserModel as unknown as AuthUserModel);
|
|
150
|
+
addAuthRoutes(app, UserModel as unknown as AuthUserModel);
|
|
146
151
|
new SyncApp({
|
|
147
152
|
getUserScopes: (user: User, entry: SyncRegistryEntry) => {
|
|
148
153
|
// Custom-scoped entries (used by the $or snapshotFilter test) resolve their
|
|
@@ -166,7 +171,7 @@ describe("Phase C sync routes", () => {
|
|
|
166
171
|
describe("C2 — per-stream cursors and /sync/streams", () => {
|
|
167
172
|
it("GET /sync/streams returns owner + tenant streams reflecting memberships", async () => {
|
|
168
173
|
const res = await agent.get("/sync/streams").expect(200);
|
|
169
|
-
const streams: string[] = res.body.streams.map((s:
|
|
174
|
+
const streams: string[] = res.body.streams.map((s: {stream: string}) => s.stream);
|
|
170
175
|
expect(streams).toContain(ownerStream());
|
|
171
176
|
expect(streams).toContain("phaseCProjects|tenant:org1");
|
|
172
177
|
expect(streams).toContain("phaseCProjects|tenant:org2");
|
|
@@ -209,13 +214,15 @@ describe("Phase C sync routes", () => {
|
|
|
209
214
|
|
|
210
215
|
it("reflects a tenant join in /sync/streams (new stream becomes available)", async () => {
|
|
211
216
|
let res = await agent.get("/sync/streams").expect(200);
|
|
212
|
-
expect(res.body.streams.map((s:
|
|
217
|
+
expect(res.body.streams.map((s: {stream: string}) => s.stream)).not.toContain(
|
|
213
218
|
"phaseCProjects|tenant:org3"
|
|
214
219
|
);
|
|
215
220
|
// Join org3.
|
|
216
221
|
userOrgs.set(notAdminId, ["org1", "org2", "org3"]);
|
|
217
222
|
res = await agent.get("/sync/streams").expect(200);
|
|
218
|
-
expect(res.body.streams.map((s:
|
|
223
|
+
expect(res.body.streams.map((s: {stream: string}) => s.stream)).toContain(
|
|
224
|
+
"phaseCProjects|tenant:org3"
|
|
225
|
+
);
|
|
219
226
|
// And the newly-joined stream is now snapshottable.
|
|
220
227
|
await PhaseCProjectModel.create({orgId: "org3", title: "joined"});
|
|
221
228
|
const snap = await agent
|
|
@@ -240,7 +247,7 @@ describe("Phase C sync routes", () => {
|
|
|
240
247
|
ownerId: notAdminId,
|
|
241
248
|
title: `legacy-${String(i).padStart(4, "0")}`,
|
|
242
249
|
}));
|
|
243
|
-
await PhaseCTodoModel.collection.insertMany(legacy as
|
|
250
|
+
await PhaseCTodoModel.collection.insertMany(legacy as unknown as PhaseCTodo[]);
|
|
244
251
|
// A couple of modern (stamped) docs after the legacy stratum.
|
|
245
252
|
await PhaseCTodoModel.create({ownerId: notAdminId, title: "modern-1"});
|
|
246
253
|
await PhaseCTodoModel.create({ownerId: notAdminId, title: "modern-2"});
|
|
@@ -284,14 +291,14 @@ describe("Phase C sync routes", () => {
|
|
|
284
291
|
await PhaseCTodoModel.collection.insertMany([
|
|
285
292
|
{deleted: false, ownerId: notAdminId, title: "legacy-a"},
|
|
286
293
|
{deleted: false, ownerId: notAdminId, title: "legacy-b"},
|
|
287
|
-
] as
|
|
294
|
+
] as unknown as PhaseCTodo[]);
|
|
288
295
|
await PhaseCTodoModel.create({ownerId: notAdminId, title: "stamped"});
|
|
289
296
|
|
|
290
297
|
const page1 = await agent
|
|
291
298
|
.get(`/sync/snapshot?stream=${enc(ownerStream())}&limit=10`)
|
|
292
299
|
.expect(200);
|
|
293
300
|
// First page is the legacy stratum (seq 0), with a legacyCursor.
|
|
294
|
-
expect(page1.body.entities.every((e:
|
|
301
|
+
expect(page1.body.entities.every((e: SnapshotEntity) => e.seq === 0)).toBe(true);
|
|
295
302
|
expect(page1.body.legacyCursor).toBeDefined();
|
|
296
303
|
expect(page1.body.hasMore).toBe(true);
|
|
297
304
|
|
|
@@ -304,7 +311,7 @@ describe("Phase C sync routes", () => {
|
|
|
304
311
|
.expect(200);
|
|
305
312
|
// Legacy stratum exhausted; falls through to seq paging (no legacyCursor).
|
|
306
313
|
expect(page2.body.legacyCursor).toBeUndefined();
|
|
307
|
-
const stamped = page2.body.entities.find((e:
|
|
314
|
+
const stamped = page2.body.entities.find((e: SnapshotEntity) => e.data?.title === "stamped");
|
|
308
315
|
expect(stamped?.seq).toBe(1);
|
|
309
316
|
});
|
|
310
317
|
|
|
@@ -322,7 +329,7 @@ describe("Phase C sync routes", () => {
|
|
|
322
329
|
deleted: false,
|
|
323
330
|
ownerId: notAdminId,
|
|
324
331
|
title: `legacy note ${i}`,
|
|
325
|
-
})) as
|
|
332
|
+
})) as unknown as PhaseCNote[]
|
|
326
333
|
);
|
|
327
334
|
await PhaseCNoteModel.create({
|
|
328
335
|
_id: "note-modern",
|
|
@@ -364,7 +371,7 @@ describe("Phase C sync routes", () => {
|
|
|
364
371
|
it("Task 9.14: 400s (not 500s) on a malformed legacyCursor for an ObjectId-keyed model", async () => {
|
|
365
372
|
await PhaseCTodoModel.collection.insertMany([
|
|
366
373
|
{deleted: false, ownerId: notAdminId, title: "legacy-a"},
|
|
367
|
-
] as
|
|
374
|
+
] as unknown as PhaseCTodo[]);
|
|
368
375
|
await agent
|
|
369
376
|
.get(`/sync/snapshot?stream=${enc(ownerStream())}&legacyCursor=not-an-object-id`)
|
|
370
377
|
.expect(400);
|
|
@@ -427,21 +434,21 @@ describe("Phase C sync routes", () => {
|
|
|
427
434
|
clearSyncRegistry();
|
|
428
435
|
registerSync({
|
|
429
436
|
config: {scope: {type: "owner"}},
|
|
430
|
-
model: PhaseCTodoModel as
|
|
437
|
+
model: PhaseCTodoModel as unknown as Model<unknown>,
|
|
431
438
|
options: {
|
|
432
439
|
...authedOptions,
|
|
433
440
|
permissions: {
|
|
434
|
-
...
|
|
441
|
+
...authedOptions.permissions,
|
|
435
442
|
read: [
|
|
436
|
-
(_method:
|
|
443
|
+
(_method: RESTMethod, _user?: User, doc?: unknown) => {
|
|
437
444
|
if (!doc) {
|
|
438
445
|
return true;
|
|
439
446
|
}
|
|
440
|
-
return !String(doc.title).endsWith("-secret");
|
|
447
|
+
return !String((doc as PhaseCTodo).title).endsWith("-secret");
|
|
441
448
|
},
|
|
442
449
|
],
|
|
443
450
|
},
|
|
444
|
-
} as unknown as ModelRouterOptions<
|
|
451
|
+
} as unknown as ModelRouterOptions<unknown>,
|
|
445
452
|
routePath: "/phaseCTodos",
|
|
446
453
|
});
|
|
447
454
|
|
|
@@ -450,7 +457,7 @@ describe("Phase C sync routes", () => {
|
|
|
450
457
|
await PhaseCTodoModel.create({ownerId: notAdminId, title: "visible-2"});
|
|
451
458
|
|
|
452
459
|
const res = await agent.get(`/sync/snapshot?stream=${enc(ownerStream())}`).expect(200);
|
|
453
|
-
const titles = res.body.entities.map((e:
|
|
460
|
+
const titles = res.body.entities.map((e: SnapshotEntity) => e.data.title);
|
|
454
461
|
expect(titles).toEqual(["visible-1", "visible-2"]);
|
|
455
462
|
// The cursor advanced past the denied doc (seq 3), so it is never re-fetched.
|
|
456
463
|
expect(res.body.cursor).toBe(3);
|
|
@@ -461,13 +468,13 @@ describe("Phase C sync routes", () => {
|
|
|
461
468
|
clearSyncRegistry();
|
|
462
469
|
registerSync({
|
|
463
470
|
config: {scope: {type: "owner"}},
|
|
464
|
-
model: PhaseCTodoModel as
|
|
471
|
+
model: PhaseCTodoModel as unknown as Model<unknown>,
|
|
465
472
|
options: {
|
|
466
473
|
...authedOptions,
|
|
467
474
|
permissions: {
|
|
468
|
-
...
|
|
475
|
+
...authedOptions.permissions,
|
|
469
476
|
read: [
|
|
470
|
-
(_method:
|
|
477
|
+
(_method: RESTMethod, _user?: User, doc?: unknown) => {
|
|
471
478
|
if (!doc) {
|
|
472
479
|
return true;
|
|
473
480
|
}
|
|
@@ -475,7 +482,7 @@ describe("Phase C sync routes", () => {
|
|
|
475
482
|
},
|
|
476
483
|
],
|
|
477
484
|
},
|
|
478
|
-
} as unknown as ModelRouterOptions<
|
|
485
|
+
} as unknown as ModelRouterOptions<unknown>,
|
|
479
486
|
routePath: "/phaseCTodos",
|
|
480
487
|
});
|
|
481
488
|
|
|
@@ -520,7 +527,7 @@ describe("Phase C sync routes", () => {
|
|
|
520
527
|
scope: (doc: Record<string, unknown>) => String(doc.ownerId),
|
|
521
528
|
snapshotFilter: () => ({$or: [{ownerId: notAdminId}, {ownerId: "shared"}]}),
|
|
522
529
|
},
|
|
523
|
-
model: PhaseCTodoModel as
|
|
530
|
+
model: PhaseCTodoModel as unknown as Model<unknown>,
|
|
524
531
|
options: authedOptions,
|
|
525
532
|
routePath: "/phaseCTodos",
|
|
526
533
|
});
|
|
@@ -533,14 +540,16 @@ describe("Phase C sync routes", () => {
|
|
|
533
540
|
|
|
534
541
|
const customStream = `phaseCTodos|custom:${notAdminId}`;
|
|
535
542
|
const res = await agent.get(`/sync/snapshot?stream=${enc(customStream)}`).expect(200);
|
|
536
|
-
const byTitle = new Map
|
|
543
|
+
const byTitle = new Map<string, SnapshotEntity>(
|
|
544
|
+
res.body.entities.map((e: SnapshotEntity) => [e.id, e])
|
|
545
|
+
);
|
|
537
546
|
// "other" is excluded by the $or filter; "mine" appears as a tombstone (data null).
|
|
538
547
|
const titles = res.body.entities
|
|
539
|
-
.filter((e:
|
|
540
|
-
.map((e:
|
|
548
|
+
.filter((e: SnapshotEntity) => !e.deleted)
|
|
549
|
+
.map((e: SnapshotEntity) => e.data.title)
|
|
541
550
|
.sort();
|
|
542
551
|
expect(titles).toEqual(["shared"]);
|
|
543
|
-
const tombstone = byTitle.get(String(mine._id))
|
|
552
|
+
const tombstone = byTitle.get(String(mine._id));
|
|
544
553
|
expect(tombstone?.deleted).toBe(true);
|
|
545
554
|
expect(tombstone?.data).toBeNull();
|
|
546
555
|
});
|
|
@@ -610,14 +619,14 @@ describe("Phase C sync routes", () => {
|
|
|
610
619
|
clearSyncRegistry();
|
|
611
620
|
registerSync({
|
|
612
621
|
config: {scope: {type: "owner"}},
|
|
613
|
-
model: PhaseCTodoModel as
|
|
622
|
+
model: PhaseCTodoModel as unknown as Model<unknown>,
|
|
614
623
|
options: {
|
|
615
624
|
...authedOptions,
|
|
616
|
-
responseHandler: (value:
|
|
625
|
+
responseHandler: async (value: {title?: string}, method: string) => {
|
|
617
626
|
seenMethods.push(method);
|
|
618
627
|
return method === "read" ? {shape: "read", title: value.title} : value;
|
|
619
628
|
},
|
|
620
|
-
} as unknown as ModelRouterOptions<
|
|
629
|
+
} as unknown as ModelRouterOptions<unknown>,
|
|
621
630
|
routePath: "/phaseCTodos",
|
|
622
631
|
});
|
|
623
632
|
await PhaseCTodoModel.create({ownerId: notAdminId, title: "rh"});
|
|
@@ -631,7 +640,7 @@ describe("Phase C sync routes", () => {
|
|
|
631
640
|
clearSyncRegistry();
|
|
632
641
|
registerSync({
|
|
633
642
|
config: {scope: {type: "owner"}},
|
|
634
|
-
model: PhaseCTodoModel as
|
|
643
|
+
model: PhaseCTodoModel as unknown as Model<unknown>,
|
|
635
644
|
options: authedOptions,
|
|
636
645
|
routePath: "/dupTag",
|
|
637
646
|
});
|
|
@@ -641,7 +650,7 @@ describe("Phase C sync routes", () => {
|
|
|
641
650
|
expect(() =>
|
|
642
651
|
registerSync({
|
|
643
652
|
config: {scope: {field: "orgId", type: "tenant"}},
|
|
644
|
-
model: PhaseCProjectModel as
|
|
653
|
+
model: PhaseCProjectModel as unknown as Model<unknown>,
|
|
645
654
|
options: authedOptions,
|
|
646
655
|
routePath: "/dupTag",
|
|
647
656
|
})
|
|
@@ -700,11 +709,13 @@ describe("Phase C sync routes", () => {
|
|
|
700
709
|
const rebootstrap = await agent
|
|
701
710
|
.get(`/sync/snapshot?stream=${enc(stream)}&cursor=0`)
|
|
702
711
|
.expect(200);
|
|
703
|
-
const ids = rebootstrap.body.entities.map((e:
|
|
712
|
+
const ids = rebootstrap.body.entities.map((e: SnapshotEntity) => e.id).sort();
|
|
704
713
|
expect(ids).toEqual(
|
|
705
714
|
[String(keep._id), String((await PhaseCTodoModel.findOne({title: "later"}))?._id)].sort()
|
|
706
715
|
);
|
|
707
|
-
expect(
|
|
716
|
+
expect(
|
|
717
|
+
rebootstrap.body.entities.some((e: SnapshotEntity) => e.id === String(doomed._id))
|
|
718
|
+
).toBe(false);
|
|
708
719
|
});
|
|
709
720
|
|
|
710
721
|
it("a live never-deleted early doc no longer pins the retention floor", async () => {
|