@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,5 +1,3 @@
|
|
|
1
|
-
// noExplicitAny: test mocks use dynamic shapes for sockets, io, and documents
|
|
2
|
-
// biome-ignore-all lint/suspicious/noExplicitAny: test mocks use dynamic shapes for sockets, io, and documents
|
|
3
1
|
/**
|
|
4
2
|
* Tests for the sync socket layer (Tasks 2.3–2.5):
|
|
5
3
|
* - socketHandlers.ts (sync:subscribe / sync:unsubscribe / sync:mutate, caps, rate limit)
|
|
@@ -11,7 +9,9 @@
|
|
|
11
9
|
*/
|
|
12
10
|
|
|
13
11
|
import {afterEach, beforeAll, beforeEach, describe, expect, it} from "bun:test";
|
|
14
|
-
import
|
|
12
|
+
import {assert} from "chai";
|
|
13
|
+
import mongoose, {type Model, model, Schema} from "mongoose";
|
|
14
|
+
import type {Server} from "socket.io";
|
|
15
15
|
|
|
16
16
|
import type {ModelRouterOptions} from "../api";
|
|
17
17
|
import {createdUpdatedPlugin, type IsDeleted, isDeletedPlugin} from "../plugins";
|
|
@@ -23,6 +23,7 @@ import {
|
|
|
23
23
|
import {clearRealtimeRegistry, registerRealtime} from "../realtime/registry";
|
|
24
24
|
import {setupDb} from "../tests";
|
|
25
25
|
import {defaultResponseHandler} from "../transformers";
|
|
26
|
+
import {registerAdminBroadcastScope} from "./adminBroadcastScope";
|
|
26
27
|
import {SyncCounter, SyncMutation, SyncScopeMove} from "./models";
|
|
27
28
|
import {MAX_SYNC_MUTATIONS_PER_BATCH} from "./mutationHandler";
|
|
28
29
|
import {
|
|
@@ -108,7 +109,7 @@ const permissiveOptions = {
|
|
|
108
109
|
read: [() => true],
|
|
109
110
|
update: [() => true],
|
|
110
111
|
},
|
|
111
|
-
} as unknown as ModelRouterOptions<
|
|
112
|
+
} as unknown as ModelRouterOptions<unknown>;
|
|
112
113
|
|
|
113
114
|
const adminOnlyOptions = {
|
|
114
115
|
permissions: {
|
|
@@ -118,7 +119,7 @@ const adminOnlyOptions = {
|
|
|
118
119
|
read: [(_m: string, user?: {admin?: boolean}) => user?.admin === true],
|
|
119
120
|
update: [(_m: string, user?: {admin?: boolean}) => user?.admin === true],
|
|
120
121
|
},
|
|
121
|
-
} as unknown as ModelRouterOptions<
|
|
122
|
+
} as unknown as ModelRouterOptions<unknown>;
|
|
122
123
|
|
|
123
124
|
const ownerReadOptions = {
|
|
124
125
|
permissions: {
|
|
@@ -131,31 +132,32 @@ const ownerReadOptions = {
|
|
|
131
132
|
],
|
|
132
133
|
update: [() => true],
|
|
133
134
|
},
|
|
134
|
-
} as unknown as ModelRouterOptions<
|
|
135
|
+
} as unknown as ModelRouterOptions<unknown>;
|
|
135
136
|
|
|
136
137
|
/**
|
|
137
138
|
* A minimal fake Mongoose model satisfying registerSync's schema/collection checks, for
|
|
138
139
|
* tests that need many registrations (each real registration requires a distinct
|
|
139
140
|
* compiled model).
|
|
140
141
|
*/
|
|
141
|
-
const makeFakeSyncModel = (name: string):
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
modelName: name,
|
|
147
|
-
schema: {
|
|
148
|
-
path: (p: string) => {
|
|
149
|
-
if (p === "deleted") {
|
|
150
|
-
return {instance: "Boolean"};
|
|
151
|
-
}
|
|
152
|
-
if (p === "_syncSeq") {
|
|
153
|
-
return {instance: "Number"};
|
|
154
|
-
}
|
|
155
|
-
return undefined;
|
|
142
|
+
const makeFakeSyncModel = (name: string): Model<unknown> =>
|
|
143
|
+
({
|
|
144
|
+
collection: {
|
|
145
|
+
collectionName: name.toLowerCase(),
|
|
146
|
+
createIndex: async () => {},
|
|
156
147
|
},
|
|
157
|
-
|
|
158
|
-
|
|
148
|
+
modelName: name,
|
|
149
|
+
schema: {
|
|
150
|
+
path: (p: string) => {
|
|
151
|
+
if (p === "deleted") {
|
|
152
|
+
return {instance: "Boolean"};
|
|
153
|
+
}
|
|
154
|
+
if (p === "_syncSeq") {
|
|
155
|
+
return {instance: "Number"};
|
|
156
|
+
}
|
|
157
|
+
return undefined;
|
|
158
|
+
},
|
|
159
|
+
},
|
|
160
|
+
}) as unknown as Model<unknown>;
|
|
159
161
|
|
|
160
162
|
// The shared test database can be dropped by another test file mid-suite
|
|
161
163
|
// (configurationPlugin.test.ts drops it in an afterAll); rebuild the unique indexes the
|
|
@@ -168,19 +170,19 @@ const registerAll = (): void => {
|
|
|
168
170
|
clearSyncRegistry();
|
|
169
171
|
registerSync({
|
|
170
172
|
config: {scope: {type: "owner"}},
|
|
171
|
-
model: SockStuffModel as
|
|
173
|
+
model: SockStuffModel as unknown as Model<unknown>,
|
|
172
174
|
options: permissiveOptions,
|
|
173
175
|
routePath: "/sockStuff",
|
|
174
176
|
});
|
|
175
177
|
registerSync({
|
|
176
178
|
config: {scope: {field: "orgId", type: "tenant"}},
|
|
177
|
-
model: SockProjectModel as
|
|
179
|
+
model: SockProjectModel as unknown as Model<unknown>,
|
|
178
180
|
options: permissiveOptions,
|
|
179
181
|
routePath: "/sockProjects",
|
|
180
182
|
});
|
|
181
183
|
registerSync({
|
|
182
184
|
config: {scope: {type: "broadcast"}},
|
|
183
|
-
model: SockNewsModel as
|
|
185
|
+
model: SockNewsModel as unknown as Model<unknown>,
|
|
184
186
|
options: permissiveOptions,
|
|
185
187
|
routePath: "/sockNews",
|
|
186
188
|
});
|
|
@@ -190,17 +192,19 @@ const registerAll = (): void => {
|
|
|
190
192
|
// Mock socket (realtime.test.ts conventions)
|
|
191
193
|
// ─────────────────────────────────────────────────────────────────────────────
|
|
192
194
|
|
|
195
|
+
type SyncSocketListener = (...args: never[]) => void | Promise<void>;
|
|
196
|
+
|
|
193
197
|
interface MockSocket extends SyncSocketLike {
|
|
194
198
|
rooms: Set<string>;
|
|
195
199
|
emitted: {event: string; payload: unknown}[];
|
|
196
|
-
listeners: Map<string,
|
|
197
|
-
trigger: (event: string, ...args:
|
|
200
|
+
listeners: Map<string, SyncSocketListener>;
|
|
201
|
+
trigger: (event: string, ...args: unknown[]) => Promise<void>;
|
|
198
202
|
}
|
|
199
203
|
|
|
200
204
|
const createMockSocket = (decodedToken?: {id?: string; admin?: boolean}): MockSocket => {
|
|
201
205
|
const rooms = new Set<string>();
|
|
202
206
|
const emitted: {event: string; payload: unknown}[] = [];
|
|
203
|
-
const listeners = new Map<string,
|
|
207
|
+
const listeners = new Map<string, SyncSocketListener>();
|
|
204
208
|
|
|
205
209
|
const socket: MockSocket = {
|
|
206
210
|
decodedToken,
|
|
@@ -223,7 +227,7 @@ const createMockSocket = (decodedToken?: {id?: string; admin?: boolean}): MockSo
|
|
|
223
227
|
trigger: async (event, ...args) => {
|
|
224
228
|
const handler = listeners.get(event);
|
|
225
229
|
if (handler) {
|
|
226
|
-
await handler(...args);
|
|
230
|
+
await (handler as (...handlerArgs: unknown[]) => void | Promise<void>)(...args);
|
|
227
231
|
}
|
|
228
232
|
},
|
|
229
233
|
};
|
|
@@ -232,7 +236,9 @@ const createMockSocket = (decodedToken?: {id?: string; admin?: boolean}): MockSo
|
|
|
232
236
|
};
|
|
233
237
|
|
|
234
238
|
const syncErrors = (socket: MockSocket): Array<{collection: string; message: string}> =>
|
|
235
|
-
socket.emitted
|
|
239
|
+
socket.emitted
|
|
240
|
+
.filter((e) => e.event === "sync:error")
|
|
241
|
+
.map((e) => e.payload as {collection: string; message: string});
|
|
236
242
|
|
|
237
243
|
const install = (socket: MockSocket, options: SyncAppOptions = {}): void => {
|
|
238
244
|
installSyncSocketHandlers(null, socket, options);
|
|
@@ -267,11 +273,107 @@ describe("installSyncSocketHandlers — subscribe/unsubscribe", () => {
|
|
|
267
273
|
});
|
|
268
274
|
});
|
|
269
275
|
|
|
276
|
+
it("window mode joins {collection}|admin and does not emit snapshot pages", async () => {
|
|
277
|
+
clearSyncRegistry();
|
|
278
|
+
registerSync({
|
|
279
|
+
config: {adminBroadcast: true, scope: {type: "owner"}},
|
|
280
|
+
model: SockStuffModel as unknown as Model<unknown>,
|
|
281
|
+
options: ownerReadOptions,
|
|
282
|
+
routePath: "/sockStuff",
|
|
283
|
+
});
|
|
284
|
+
const socket = createMockSocket({admin: true, id: "user1"});
|
|
285
|
+
install(socket);
|
|
286
|
+
await socket.trigger("sync:subscribe", {collections: ["sockStuff"], mode: "window"});
|
|
287
|
+
|
|
288
|
+
assert.isTrue(socket.rooms.has("sync:sockStuff|admin"));
|
|
289
|
+
assert.isFalse(socket.rooms.has("sync:sockStuff|owner:user1"));
|
|
290
|
+
const subscribed = socket.emitted.filter((e) => e.event === "sync:subscribed");
|
|
291
|
+
assert.deepEqual(
|
|
292
|
+
subscribed.map((e) => e.payload),
|
|
293
|
+
[{collection: "sockStuff", mode: "window", streams: ["sockStuff|admin"]}]
|
|
294
|
+
);
|
|
295
|
+
const snapshotLike = socket.emitted.filter(
|
|
296
|
+
(e) => e.event.includes("snapshot") || (e.payload as {entities?: unknown})?.entities
|
|
297
|
+
);
|
|
298
|
+
assert.deepEqual(snapshotLike, []);
|
|
299
|
+
});
|
|
300
|
+
|
|
301
|
+
it("nacks window subscribe when the caller is not admin", async () => {
|
|
302
|
+
clearSyncRegistry();
|
|
303
|
+
registerSync({
|
|
304
|
+
config: {adminBroadcast: true, scope: {type: "owner"}},
|
|
305
|
+
model: SockStuffModel as unknown as Model<unknown>,
|
|
306
|
+
options: ownerReadOptions,
|
|
307
|
+
routePath: "/sockStuff",
|
|
308
|
+
});
|
|
309
|
+
const socket = createMockSocket({admin: false, id: "user1"});
|
|
310
|
+
install(socket);
|
|
311
|
+
await socket.trigger("sync:subscribe", {collections: ["sockStuff"], mode: "window"});
|
|
312
|
+
|
|
313
|
+
assert.isFalse(socket.rooms.has("sync:sockStuff|admin"));
|
|
314
|
+
assert.deepEqual(
|
|
315
|
+
socket.emitted.filter((e) => e.event === "sync:subscribed"),
|
|
316
|
+
[]
|
|
317
|
+
);
|
|
318
|
+
const errors = syncErrors(socket);
|
|
319
|
+
assert.equal(errors.length, 1);
|
|
320
|
+
assert.equal(errors[0].collection, "sockStuff");
|
|
321
|
+
assert.match(errors[0].message, /admin/i);
|
|
322
|
+
});
|
|
323
|
+
|
|
324
|
+
it("nacks window subscribe when accessControl denies admin:access", async () => {
|
|
325
|
+
clearSyncRegistry();
|
|
326
|
+
registerSync({
|
|
327
|
+
config: {adminBroadcast: true, scope: {type: "owner"}},
|
|
328
|
+
model: SockStuffModel as unknown as Model<unknown>,
|
|
329
|
+
options: ownerReadOptions,
|
|
330
|
+
routePath: "/sockStuff",
|
|
331
|
+
});
|
|
332
|
+
const socket = createMockSocket({admin: true, id: "user1"});
|
|
333
|
+
install(socket, {
|
|
334
|
+
accessControl: {
|
|
335
|
+
can: async () => ({allowed: false}),
|
|
336
|
+
} as never,
|
|
337
|
+
});
|
|
338
|
+
await socket.trigger("sync:subscribe", {collections: ["sockStuff"], mode: "window"});
|
|
339
|
+
|
|
340
|
+
assert.isFalse(socket.rooms.has("sync:sockStuff|admin"));
|
|
341
|
+
assert.deepEqual(
|
|
342
|
+
socket.emitted.filter((e) => e.event === "sync:subscribed"),
|
|
343
|
+
[]
|
|
344
|
+
);
|
|
345
|
+
const errors = syncErrors(socket);
|
|
346
|
+
assert.equal(errors.length, 1);
|
|
347
|
+
assert.match(errors[0].message, /admin panel access/i);
|
|
348
|
+
});
|
|
349
|
+
|
|
350
|
+
it("nacks window subscribe when AdminApp list permission is denied", async () => {
|
|
351
|
+
clearSyncRegistry();
|
|
352
|
+
registerSync({
|
|
353
|
+
config: {adminBroadcast: true, scope: {type: "owner"}},
|
|
354
|
+
model: SockStuffModel as unknown as Model<unknown>,
|
|
355
|
+
options: ownerReadOptions,
|
|
356
|
+
routePath: "/sockStuff",
|
|
357
|
+
});
|
|
358
|
+
registerAdminBroadcastScope("SockStuff", {
|
|
359
|
+
listPermissions: [() => false],
|
|
360
|
+
readPermissions: [() => true],
|
|
361
|
+
});
|
|
362
|
+
const socket = createMockSocket({admin: true, id: "user1"});
|
|
363
|
+
install(socket);
|
|
364
|
+
await socket.trigger("sync:subscribe", {collections: ["sockStuff"], mode: "window"});
|
|
365
|
+
|
|
366
|
+
assert.isFalse(socket.rooms.has("sync:sockStuff|admin"));
|
|
367
|
+
const errors = syncErrors(socket);
|
|
368
|
+
assert.equal(errors.length, 1);
|
|
369
|
+
assert.match(errors[0].message, /admin collection access/i);
|
|
370
|
+
});
|
|
371
|
+
|
|
270
372
|
it("owner scope never uses a client-supplied user id", async () => {
|
|
271
373
|
const socket = createMockSocket({id: "user1"});
|
|
272
374
|
install(socket);
|
|
273
375
|
// The payload has no place for a user id — assert the room is keyed by the token id.
|
|
274
|
-
await socket.trigger("sync:subscribe", {collections: ["sockStuff"], userId: "victim"}
|
|
376
|
+
await socket.trigger("sync:subscribe", {collections: ["sockStuff"], userId: "victim"});
|
|
275
377
|
expect(socket.rooms.has("sync:sockStuff|owner:user1")).toBe(true);
|
|
276
378
|
expect(Array.from(socket.rooms).some((r) => r.includes("victim"))).toBe(false);
|
|
277
379
|
});
|
|
@@ -375,7 +477,7 @@ describe("installSyncSocketHandlers — subscribe/unsubscribe", () => {
|
|
|
375
477
|
clearSyncRegistry();
|
|
376
478
|
registerSync({
|
|
377
479
|
config: {scope: {type: "owner"}},
|
|
378
|
-
model: SockStuffModel as
|
|
480
|
+
model: SockStuffModel as unknown as Model<unknown>,
|
|
379
481
|
options: adminOnlyOptions,
|
|
380
482
|
routePath: "/sockStuff",
|
|
381
483
|
});
|
|
@@ -390,7 +492,7 @@ describe("installSyncSocketHandlers — subscribe/unsubscribe", () => {
|
|
|
390
492
|
clearSyncRegistry();
|
|
391
493
|
registerSync({
|
|
392
494
|
config: {scope: {type: "owner"}},
|
|
393
|
-
model: SockStuffModel as
|
|
495
|
+
model: SockStuffModel as unknown as Model<unknown>,
|
|
394
496
|
options: adminOnlyOptions,
|
|
395
497
|
routePath: "/sockStuff",
|
|
396
498
|
});
|
|
@@ -481,7 +583,9 @@ describe("installSyncSocketHandlers — subscribe/unsubscribe", () => {
|
|
|
481
583
|
// Re-subscribing after unsubscribe emits a fresh sync:subscribed.
|
|
482
584
|
await socket.trigger("sync:subscribe", {collections: ["sockProjects"]});
|
|
483
585
|
const subscribedEvents = socket.emitted.filter(
|
|
484
|
-
(e) =>
|
|
586
|
+
(e) =>
|
|
587
|
+
e.event === "sync:subscribed" &&
|
|
588
|
+
(e.payload as {collection?: string}).collection === "sockProjects"
|
|
485
589
|
);
|
|
486
590
|
expect(subscribedEvents).toHaveLength(2);
|
|
487
591
|
});
|
|
@@ -593,7 +697,7 @@ describe("installSyncSocketHandlers — sync:mutate", () => {
|
|
|
593
697
|
const nack = lastNack(socket);
|
|
594
698
|
expect(nack?.code).toBe("conflict");
|
|
595
699
|
expect(nack?.serverSeq).toBe(2);
|
|
596
|
-
expect((nack?.serverDoc as
|
|
700
|
+
expect((nack?.serverDoc as {name?: string} | undefined)?.name).toBe("v2");
|
|
597
701
|
});
|
|
598
702
|
|
|
599
703
|
it("duplicate mutationId over the socket returns the recorded outcome without re-applying", async () => {
|
|
@@ -701,10 +805,13 @@ describe("installSyncSocketHandlers — sync:mutateBatch", () => {
|
|
|
701
805
|
socket: MockSocket,
|
|
702
806
|
mutations: unknown[]
|
|
703
807
|
): Promise<{results: Array<{type: string; ack?: SyncAck; nack?: SyncNack}>}> => {
|
|
704
|
-
let response:
|
|
808
|
+
let response: {results: Array<{type: string; ack?: SyncAck; nack?: SyncNack}>} | undefined;
|
|
705
809
|
await socket.trigger("sync:mutateBatch", {mutations}, (res: unknown) => {
|
|
706
|
-
response = res;
|
|
810
|
+
response = res as {results: Array<{type: string; ack?: SyncAck; nack?: SyncNack}>};
|
|
707
811
|
});
|
|
812
|
+
if (!response) {
|
|
813
|
+
throw new Error("sync:mutateBatch did not invoke the ack callback");
|
|
814
|
+
}
|
|
708
815
|
return response;
|
|
709
816
|
};
|
|
710
817
|
|
|
@@ -896,10 +1003,29 @@ describe("SyncAppOptions context", () => {
|
|
|
896
1003
|
// sync:delta emission — mock io helpers
|
|
897
1004
|
// ─────────────────────────────────────────────────────────────────────────────
|
|
898
1005
|
|
|
899
|
-
|
|
900
|
-
|
|
1006
|
+
interface TrackedEmission {
|
|
1007
|
+
event: string;
|
|
1008
|
+
payload: unknown;
|
|
1009
|
+
room: string;
|
|
1010
|
+
socketId: string;
|
|
1011
|
+
}
|
|
1012
|
+
|
|
1013
|
+
interface TrackedSocket {
|
|
1014
|
+
decodedToken?: {id?: string; admin?: boolean};
|
|
1015
|
+
emit: (event: string, payload: unknown) => void;
|
|
1016
|
+
id: string;
|
|
1017
|
+
}
|
|
1018
|
+
|
|
1019
|
+
/** A Socket.io server stand-in that records every emission it receives. */
|
|
1020
|
+
type TrackedIo = Server & {
|
|
1021
|
+
addSocketToRoom: (room: string, decodedToken?: {id?: string; admin?: boolean}) => void;
|
|
1022
|
+
emissions: TrackedEmission[];
|
|
1023
|
+
};
|
|
1024
|
+
|
|
1025
|
+
const makeTrackedIo = (): TrackedIo => {
|
|
1026
|
+
const emissions: TrackedEmission[] = [];
|
|
901
1027
|
const rooms = new Map<string, Set<string>>();
|
|
902
|
-
const sockets = new Map<string,
|
|
1028
|
+
const sockets = new Map<string, TrackedSocket>();
|
|
903
1029
|
|
|
904
1030
|
const addSocketToRoom = (
|
|
905
1031
|
room: string,
|
|
@@ -931,15 +1057,18 @@ const makeTrackedIo = (): any => {
|
|
|
931
1057
|
emissions.push({event, payload, room, socketId: "broadcast"});
|
|
932
1058
|
},
|
|
933
1059
|
}),
|
|
934
|
-
};
|
|
1060
|
+
} as unknown as TrackedIo;
|
|
935
1061
|
};
|
|
936
1062
|
|
|
937
|
-
|
|
938
|
-
|
|
939
|
-
|
|
940
|
-
|
|
941
|
-
|
|
942
|
-
}
|
|
1063
|
+
type WatchedChange = Parameters<typeof emitSyncDeltaForChange>[0]["change"];
|
|
1064
|
+
|
|
1065
|
+
const makeChange = (overrides: Record<string, unknown>): WatchedChange =>
|
|
1066
|
+
({
|
|
1067
|
+
documentKey: {_id: "doc-1"},
|
|
1068
|
+
ns: {coll: "sockstuffs"},
|
|
1069
|
+
operationType: "insert",
|
|
1070
|
+
...overrides,
|
|
1071
|
+
}) as unknown as WatchedChange;
|
|
943
1072
|
|
|
944
1073
|
// ─────────────────────────────────────────────────────────────────────────────
|
|
945
1074
|
// emitSyncDeltaForChange — unit tests with synthetic changes
|
|
@@ -962,7 +1091,7 @@ describe("emitSyncDeltaForChange", () => {
|
|
|
962
1091
|
clearSyncRegistry();
|
|
963
1092
|
registerSync({
|
|
964
1093
|
config: {scope: {type: "owner"}},
|
|
965
|
-
model: SockStuffModel as
|
|
1094
|
+
model: SockStuffModel as unknown as Model<unknown>,
|
|
966
1095
|
options: ownerReadOptions,
|
|
967
1096
|
routePath: "/sockStuff",
|
|
968
1097
|
});
|
|
@@ -985,15 +1114,109 @@ describe("emitSyncDeltaForChange", () => {
|
|
|
985
1114
|
logDebug: () => {},
|
|
986
1115
|
});
|
|
987
1116
|
|
|
988
|
-
const deltas = io.emissions.filter((e
|
|
1117
|
+
const deltas = io.emissions.filter((e) => e.event === "sync:delta");
|
|
989
1118
|
expect(deltas).toHaveLength(1);
|
|
990
1119
|
const delta = deltas[0].payload as SyncDelta;
|
|
991
1120
|
expect(delta.method).toBe("create");
|
|
992
1121
|
expect(delta.seq).toBe(7);
|
|
993
1122
|
expect(delta.stream).toBe("sockStuff|owner:user1");
|
|
994
1123
|
expect(delta.collection).toBe("sockStuff");
|
|
995
|
-
expect((delta.data as
|
|
996
|
-
expect((delta.data as
|
|
1124
|
+
expect((delta.data as Record<string, unknown>).name).toBe("hello");
|
|
1125
|
+
expect((delta.data as Record<string, unknown>).id).toBe("doc-1");
|
|
1126
|
+
});
|
|
1127
|
+
|
|
1128
|
+
it("adminBroadcast true: create also emits to {collection}|admin", async () => {
|
|
1129
|
+
clearSyncRegistry();
|
|
1130
|
+
registerSync({
|
|
1131
|
+
config: {adminBroadcast: true, scope: {type: "owner"}},
|
|
1132
|
+
model: SockStuffModel as unknown as Model<unknown>,
|
|
1133
|
+
options: ownerReadOptions,
|
|
1134
|
+
routePath: "/sockStuff",
|
|
1135
|
+
});
|
|
1136
|
+
const entry = findSyncEntryByCollectionTag("sockStuff") as SyncRegistryEntry;
|
|
1137
|
+
const io = makeTrackedIo();
|
|
1138
|
+
io.addSocketToRoom(syncRoomForStream("sockStuff|owner:user1"), {admin: false, id: "user1"});
|
|
1139
|
+
io.addSocketToRoom(syncRoomForStream("sockStuff|admin"), {admin: true, id: "admin1"});
|
|
1140
|
+
|
|
1141
|
+
await emitSyncDeltaForChange({
|
|
1142
|
+
change: makeChange({
|
|
1143
|
+
fullDocument: {_id: "doc-admin-fan", _syncSeq: 11, name: "hello", ownerId: "user1"},
|
|
1144
|
+
operationType: "insert",
|
|
1145
|
+
}),
|
|
1146
|
+
docId: "doc-admin-fan",
|
|
1147
|
+
entry,
|
|
1148
|
+
io,
|
|
1149
|
+
logDebug: () => {},
|
|
1150
|
+
});
|
|
1151
|
+
|
|
1152
|
+
const deltas = io.emissions
|
|
1153
|
+
.filter((e) => e.event === "sync:delta")
|
|
1154
|
+
.map((e) => e.payload as SyncDelta);
|
|
1155
|
+
const streams = deltas.map((d) => d.stream).sort();
|
|
1156
|
+
assert.deepEqual(streams, ["sockStuff|admin", "sockStuff|owner:user1"]);
|
|
1157
|
+
const adminDelta = deltas.find((d) => d.stream === "sockStuff|admin");
|
|
1158
|
+
const ownerDelta = deltas.find((d) => d.stream === "sockStuff|owner:user1");
|
|
1159
|
+
assert.strictEqual(adminDelta?.method, "create");
|
|
1160
|
+
assert.strictEqual(adminDelta?.seq, 11);
|
|
1161
|
+
assert.strictEqual(ownerDelta?.method, "create");
|
|
1162
|
+
assert.strictEqual(ownerDelta?.seq, 11);
|
|
1163
|
+
});
|
|
1164
|
+
|
|
1165
|
+
it("adminBroadcast room skips sockets excluded by AdminApp queryFilter", async () => {
|
|
1166
|
+
clearSyncRegistry();
|
|
1167
|
+
registerSync({
|
|
1168
|
+
config: {adminBroadcast: true, scope: {type: "owner"}},
|
|
1169
|
+
model: SockStuffModel as unknown as Model<unknown>,
|
|
1170
|
+
options: ownerReadOptions,
|
|
1171
|
+
routePath: "/sockStuff",
|
|
1172
|
+
});
|
|
1173
|
+
registerAdminBroadcastScope("SockStuff", {
|
|
1174
|
+
listPermissions: [() => true],
|
|
1175
|
+
queryFilter: () => ({ownerId: "acme"}),
|
|
1176
|
+
readPermissions: [() => true],
|
|
1177
|
+
});
|
|
1178
|
+
const entry = findSyncEntryByCollectionTag("sockStuff") as SyncRegistryEntry;
|
|
1179
|
+
const io = makeTrackedIo();
|
|
1180
|
+
io.addSocketToRoom(syncRoomForStream("sockStuff|admin"), {admin: true, id: "admin1"});
|
|
1181
|
+
|
|
1182
|
+
await emitSyncDeltaForChange({
|
|
1183
|
+
change: makeChange({
|
|
1184
|
+
fullDocument: {_id: "doc-other-tenant", _syncSeq: 12, name: "hello", ownerId: "user1"},
|
|
1185
|
+
operationType: "insert",
|
|
1186
|
+
}),
|
|
1187
|
+
docId: "doc-other-tenant",
|
|
1188
|
+
entry,
|
|
1189
|
+
io,
|
|
1190
|
+
logDebug: () => {},
|
|
1191
|
+
});
|
|
1192
|
+
|
|
1193
|
+
const adminDeltas = io.emissions.filter(
|
|
1194
|
+
(e) => e.event === "sync:delta" && (e.payload as SyncDelta).stream === "sockStuff|admin"
|
|
1195
|
+
);
|
|
1196
|
+
assert.deepEqual(adminDeltas, []);
|
|
1197
|
+
});
|
|
1198
|
+
|
|
1199
|
+
it("adminBroadcast false: create emits only the owner stream", async () => {
|
|
1200
|
+
const entry = ownerEntry();
|
|
1201
|
+
const io = makeTrackedIo();
|
|
1202
|
+
io.addSocketToRoom(syncRoomForStream("sockStuff|owner:user1"), {admin: false, id: "user1"});
|
|
1203
|
+
io.addSocketToRoom(syncRoomForStream("sockStuff|admin"), {admin: true, id: "admin1"});
|
|
1204
|
+
|
|
1205
|
+
await emitSyncDeltaForChange({
|
|
1206
|
+
change: makeChange({
|
|
1207
|
+
fullDocument: {_id: "doc-no-fan", _syncSeq: 2, name: "hello", ownerId: "user1"},
|
|
1208
|
+
operationType: "insert",
|
|
1209
|
+
}),
|
|
1210
|
+
docId: "doc-no-fan",
|
|
1211
|
+
entry,
|
|
1212
|
+
io,
|
|
1213
|
+
logDebug: () => {},
|
|
1214
|
+
});
|
|
1215
|
+
|
|
1216
|
+
const streams = io.emissions
|
|
1217
|
+
.filter((e) => e.event === "sync:delta")
|
|
1218
|
+
.map((e) => (e.payload as SyncDelta).stream);
|
|
1219
|
+
assert.deepEqual(streams, ["sockStuff|owner:user1"]);
|
|
997
1220
|
});
|
|
998
1221
|
|
|
999
1222
|
it("emits a delta when the REST responseHandler serializes a BSON post-image", async () => {
|
|
@@ -1040,7 +1263,7 @@ describe("emitSyncDeltaForChange", () => {
|
|
|
1040
1263
|
logDebug: () => {},
|
|
1041
1264
|
});
|
|
1042
1265
|
|
|
1043
|
-
const deltas = io.emissions.filter((e
|
|
1266
|
+
const deltas = io.emissions.filter((e) => e.event === "sync:delta");
|
|
1044
1267
|
expect(deltas).toHaveLength(1);
|
|
1045
1268
|
const receiver = io.sockets.sockets.get(deltas[0].socketId);
|
|
1046
1269
|
expect(receiver.decodedToken.id).toBe("user1");
|
|
@@ -1063,7 +1286,7 @@ describe("emitSyncDeltaForChange", () => {
|
|
|
1063
1286
|
logDebug: () => {},
|
|
1064
1287
|
});
|
|
1065
1288
|
|
|
1066
|
-
const deltas = io.emissions.filter((e
|
|
1289
|
+
const deltas = io.emissions.filter((e) => e.event === "sync:delta");
|
|
1067
1290
|
expect(deltas).toHaveLength(1);
|
|
1068
1291
|
const delta = deltas[0].payload as SyncDelta;
|
|
1069
1292
|
expect(delta.method).toBe("delete");
|
|
@@ -1107,20 +1330,20 @@ describe("emitSyncDeltaForChange", () => {
|
|
|
1107
1330
|
logDebug: () => {},
|
|
1108
1331
|
});
|
|
1109
1332
|
|
|
1110
|
-
const deltas = io.emissions.filter((e
|
|
1333
|
+
const deltas = io.emissions.filter((e) => e.event === "sync:delta");
|
|
1111
1334
|
expect(deltas).toHaveLength(2);
|
|
1112
1335
|
|
|
1113
|
-
const tombstone = deltas.find((e
|
|
1336
|
+
const tombstone = deltas.find((e) => e.room === oldRoom)?.payload as SyncDelta;
|
|
1114
1337
|
expect(tombstone.method).toBe("delete");
|
|
1115
1338
|
expect(tombstone.deleted).toBe(true);
|
|
1116
1339
|
expect(tombstone.stream).toBe("sockStuff|owner:user1");
|
|
1117
1340
|
expect(tombstone.seq).toBe(9);
|
|
1118
1341
|
expect(tombstone.data).toBeUndefined();
|
|
1119
1342
|
|
|
1120
|
-
const create = deltas.find((e
|
|
1343
|
+
const create = deltas.find((e) => e.room === newRoom)?.payload as SyncDelta;
|
|
1121
1344
|
expect(create.method).toBe("create");
|
|
1122
1345
|
expect(create.stream).toBe("sockStuff|owner:user2");
|
|
1123
|
-
expect((create.data as
|
|
1346
|
+
expect((create.data as Record<string, unknown>).name).toBe("moved");
|
|
1124
1347
|
await SyncScopeMove.deleteMany({});
|
|
1125
1348
|
});
|
|
1126
1349
|
|
|
@@ -1161,8 +1384,8 @@ describe("emitSyncDeltaForChange", () => {
|
|
|
1161
1384
|
logDebug: () => {},
|
|
1162
1385
|
});
|
|
1163
1386
|
|
|
1164
|
-
const deltas = io.emissions.filter((e
|
|
1165
|
-
const tombstone = deltas.find((e
|
|
1387
|
+
const deltas = io.emissions.filter((e) => e.event === "sync:delta");
|
|
1388
|
+
const tombstone = deltas.find((e) => e.room === oldRoom)?.payload as SyncDelta;
|
|
1166
1389
|
expect(tombstone).toBeDefined();
|
|
1167
1390
|
expect(tombstone.method).toBe("delete");
|
|
1168
1391
|
expect(tombstone.stream).toBe("sockStuff|owner:user1");
|
|
@@ -1193,7 +1416,7 @@ describe("emitSyncDeltaForChange", () => {
|
|
|
1193
1416
|
logDebug: () => {},
|
|
1194
1417
|
});
|
|
1195
1418
|
|
|
1196
|
-
const deltas = io.emissions.filter((e
|
|
1419
|
+
const deltas = io.emissions.filter((e) => e.event === "sync:delta");
|
|
1197
1420
|
expect(deltas).toHaveLength(1);
|
|
1198
1421
|
expect((deltas[0].payload as SyncDelta).method).toBe("update");
|
|
1199
1422
|
});
|
|
@@ -1211,7 +1434,44 @@ describe("emitSyncDeltaForChange", () => {
|
|
|
1211
1434
|
logDebug: () => {},
|
|
1212
1435
|
});
|
|
1213
1436
|
|
|
1214
|
-
expect(io.emissions.filter((e
|
|
1437
|
+
expect(io.emissions.filter((e) => e.event === "sync:delta")).toHaveLength(0);
|
|
1438
|
+
});
|
|
1439
|
+
|
|
1440
|
+
it("logs and skips changes without a full document", async () => {
|
|
1441
|
+
const entry = ownerEntry();
|
|
1442
|
+
const io = makeTrackedIo();
|
|
1443
|
+
const logs: string[] = [];
|
|
1444
|
+
|
|
1445
|
+
await emitSyncDeltaForChange({
|
|
1446
|
+
change: makeChange({operationType: "update"}),
|
|
1447
|
+
docId: "doc-no-image",
|
|
1448
|
+
entry,
|
|
1449
|
+
io,
|
|
1450
|
+
logDebug: (message) => logs.push(message),
|
|
1451
|
+
});
|
|
1452
|
+
|
|
1453
|
+
assert.deepEqual(logs, ["[sync] Skipping sockStuff/doc-no-image: change has no fullDocument"]);
|
|
1454
|
+
assert.isEmpty(io.emissions);
|
|
1455
|
+
});
|
|
1456
|
+
|
|
1457
|
+
it("skips changes whose operation type does not map to a sync method", async () => {
|
|
1458
|
+
const entry = ownerEntry();
|
|
1459
|
+
const io = makeTrackedIo();
|
|
1460
|
+
const logs: string[] = [];
|
|
1461
|
+
|
|
1462
|
+
await emitSyncDeltaForChange({
|
|
1463
|
+
change: makeChange({
|
|
1464
|
+
fullDocument: {_id: "doc-invalid", _syncSeq: 1, ownerId: "user1"},
|
|
1465
|
+
operationType: "invalidate",
|
|
1466
|
+
}),
|
|
1467
|
+
docId: "doc-invalid",
|
|
1468
|
+
entry,
|
|
1469
|
+
io,
|
|
1470
|
+
logDebug: (message) => logs.push(message),
|
|
1471
|
+
});
|
|
1472
|
+
|
|
1473
|
+
assert.isEmpty(logs);
|
|
1474
|
+
assert.isEmpty(io.emissions);
|
|
1215
1475
|
});
|
|
1216
1476
|
|
|
1217
1477
|
it("applies the sync responseHandler to delta data", async () => {
|
|
@@ -1221,7 +1481,7 @@ describe("emitSyncDeltaForChange", () => {
|
|
|
1221
1481
|
responseHandler: (doc: Record<string, unknown>) => ({onlyName: doc.name}),
|
|
1222
1482
|
scope: {type: "owner"},
|
|
1223
1483
|
},
|
|
1224
|
-
model: SockStuffModel as
|
|
1484
|
+
model: SockStuffModel as unknown as Model<unknown>,
|
|
1225
1485
|
options: permissiveOptions,
|
|
1226
1486
|
routePath: "/sockStuff",
|
|
1227
1487
|
});
|
|
@@ -1239,7 +1499,7 @@ describe("emitSyncDeltaForChange", () => {
|
|
|
1239
1499
|
logDebug: () => {},
|
|
1240
1500
|
});
|
|
1241
1501
|
|
|
1242
|
-
const delta = io.emissions.find((e
|
|
1502
|
+
const delta = io.emissions.find((e) => e.event === "sync:delta")?.payload as SyncDelta;
|
|
1243
1503
|
expect(delta.data).toEqual({onlyName: "shaped"});
|
|
1244
1504
|
});
|
|
1245
1505
|
});
|
|
@@ -1263,20 +1523,20 @@ const hasReplicaSet = async (): Promise<boolean> => {
|
|
|
1263
1523
|
* Start the watcher and give the change-stream cursor a moment to open so writes made
|
|
1264
1524
|
* immediately afterwards are not missed (change streams only deliver post-open events).
|
|
1265
1525
|
*/
|
|
1266
|
-
const startWatcherAndSettle = async (io:
|
|
1526
|
+
const startWatcherAndSettle = async (io: TrackedIo): Promise<void> => {
|
|
1267
1527
|
startChangeStreamWatcher(io, {}, true);
|
|
1268
1528
|
await new Promise((resolve) => setTimeout(resolve, 300));
|
|
1269
1529
|
};
|
|
1270
1530
|
|
|
1271
1531
|
const waitForDelta = async (
|
|
1272
|
-
io:
|
|
1273
|
-
predicate: (delta: SyncDelta, emission:
|
|
1532
|
+
io: TrackedIo,
|
|
1533
|
+
predicate: (delta: SyncDelta, emission: TrackedEmission) => boolean,
|
|
1274
1534
|
timeoutMs = 5000
|
|
1275
1535
|
): Promise<void> => {
|
|
1276
1536
|
const start = Date.now();
|
|
1277
1537
|
while (Date.now() - start < timeoutMs) {
|
|
1278
1538
|
const match = io.emissions.some(
|
|
1279
|
-
(e
|
|
1539
|
+
(e) => e.event === "sync:delta" && predicate(e.payload as SyncDelta, e)
|
|
1280
1540
|
);
|
|
1281
1541
|
if (match) {
|
|
1282
1542
|
return;
|
|
@@ -1330,8 +1590,8 @@ describe("sync:delta — change stream integration", () => {
|
|
|
1330
1590
|
await waitForDelta(io, (d) => d.id === docId && d.method === "delete");
|
|
1331
1591
|
|
|
1332
1592
|
const deltas = io.emissions
|
|
1333
|
-
.filter((e
|
|
1334
|
-
.map((e
|
|
1593
|
+
.filter((e) => e.event === "sync:delta")
|
|
1594
|
+
.map((e) => e.payload as SyncDelta);
|
|
1335
1595
|
|
|
1336
1596
|
const creates = deltas.filter((d) => d.method === "create");
|
|
1337
1597
|
const updates = deltas.filter((d) => d.method === "update");
|
|
@@ -1348,7 +1608,7 @@ describe("sync:delta — change stream integration", () => {
|
|
|
1348
1608
|
expect(delta.collection).toBe("sockStuff");
|
|
1349
1609
|
}
|
|
1350
1610
|
expect(deletes[0].deleted).toBe(true);
|
|
1351
|
-
expect((deletes[0].data as
|
|
1611
|
+
expect((deletes[0].data as Record<string, unknown>).name).toBe("cs-updated");
|
|
1352
1612
|
});
|
|
1353
1613
|
|
|
1354
1614
|
it("a socket subscribed to tenant org1 never receives org2's delta", async () => {
|
|
@@ -1366,8 +1626,8 @@ describe("sync:delta — change stream integration", () => {
|
|
|
1366
1626
|
await new Promise((resolve) => setTimeout(resolve, 500));
|
|
1367
1627
|
|
|
1368
1628
|
const deltas = io.emissions
|
|
1369
|
-
.filter((e
|
|
1370
|
-
.map((e
|
|
1629
|
+
.filter((e) => e.event === "sync:delta")
|
|
1630
|
+
.map((e) => e.payload as SyncDelta);
|
|
1371
1631
|
expect(deltas.some((d) => d.id === String(org1Doc._id))).toBe(true);
|
|
1372
1632
|
expect(deltas.some((d) => d.id === String(org2Doc._id))).toBe(false);
|
|
1373
1633
|
expect(deltas.every((d) => d.stream === "sockProjects|tenant:org1")).toBe(true);
|
|
@@ -1393,10 +1653,10 @@ describe("sync:delta — change stream integration", () => {
|
|
|
1393
1653
|
await waitForDelta(io, (d, e) => d.id === docId && e.room === oldRoom);
|
|
1394
1654
|
|
|
1395
1655
|
const deltas = io.emissions.filter(
|
|
1396
|
-
(e
|
|
1656
|
+
(e) => e.event === "sync:delta" && (e.payload as SyncDelta).id === docId
|
|
1397
1657
|
);
|
|
1398
|
-
const tombstones = deltas.filter((e
|
|
1399
|
-
const creates = deltas.filter((e
|
|
1658
|
+
const tombstones = deltas.filter((e) => e.room === oldRoom);
|
|
1659
|
+
const creates = deltas.filter((e) => e.room === newRoom);
|
|
1400
1660
|
expect(tombstones).toHaveLength(1);
|
|
1401
1661
|
expect(creates).toHaveLength(1);
|
|
1402
1662
|
|
|
@@ -1409,7 +1669,7 @@ describe("sync:delta — change stream integration", () => {
|
|
|
1409
1669
|
const create = creates[0].payload as SyncDelta;
|
|
1410
1670
|
expect(create.method).toBe("create");
|
|
1411
1671
|
expect(create.stream).toBe("sockProjects|tenant:org2");
|
|
1412
|
-
expect((create.data as
|
|
1672
|
+
expect((create.data as Record<string, unknown>).orgId).toBe("org2");
|
|
1413
1673
|
});
|
|
1414
1674
|
|
|
1415
1675
|
it("a model with both realtime and sync configs emits both event types", async () => {
|
|
@@ -1437,10 +1697,10 @@ describe("sync:delta — change stream integration", () => {
|
|
|
1437
1697
|
await waitForDelta(io, (d) => d.id === docId);
|
|
1438
1698
|
|
|
1439
1699
|
const legacy = io.emissions.filter(
|
|
1440
|
-
(e
|
|
1700
|
+
(e) => e.event === "sync" && e.payload?.id === docId && e.payload?.method === "create"
|
|
1441
1701
|
);
|
|
1442
1702
|
const deltas = io.emissions.filter(
|
|
1443
|
-
(e
|
|
1703
|
+
(e) => e.event === "sync:delta" && (e.payload as SyncDelta).id === docId
|
|
1444
1704
|
);
|
|
1445
1705
|
expect(legacy.length).toBeGreaterThanOrEqual(1);
|
|
1446
1706
|
expect(deltas).toHaveLength(1);
|
|
@@ -1461,8 +1721,8 @@ describe("sync:delta — change stream integration", () => {
|
|
|
1461
1721
|
const doc = await SockStuffModel.create({name: "sync only", ownerId: "only-user"});
|
|
1462
1722
|
await waitForDelta(io, (d) => d.id === String(doc._id));
|
|
1463
1723
|
|
|
1464
|
-
const deltas = io.emissions.filter((e
|
|
1724
|
+
const deltas = io.emissions.filter((e) => e.event === "sync:delta");
|
|
1465
1725
|
expect(deltas).toHaveLength(1);
|
|
1466
|
-
expect(io.emissions.filter((e
|
|
1726
|
+
expect(io.emissions.filter((e) => e.event === "sync")).toHaveLength(0);
|
|
1467
1727
|
});
|
|
1468
1728
|
});
|