@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
package/dist/sync/registry.d.ts
CHANGED
|
@@ -1,78 +1,28 @@
|
|
|
1
1
|
import type { Model } from "mongoose";
|
|
2
2
|
import type { ModelRouterOptions } from "../api";
|
|
3
|
+
import { ensureSyncIndexes, trackSyncIndexCreation } from "./registrationSideEffects";
|
|
3
4
|
import type { SyncConfig } from "./types";
|
|
4
|
-
/**
|
|
5
|
-
* A registered model with SyncDB local-first sync configuration.
|
|
6
|
-
*/
|
|
7
5
|
export interface SyncRegistryEntry {
|
|
8
|
-
/** Mongoose model name (e.g. "Todo") */
|
|
9
6
|
modelName: string;
|
|
10
|
-
/** Route path (e.g. "/todos") */
|
|
11
7
|
routePath: string;
|
|
12
|
-
/** Collection tag used in the sync protocol (route path without the leading slash) */
|
|
13
8
|
collectionTag: string;
|
|
14
|
-
/** MongoDB collection name (e.g. "todos") */
|
|
15
9
|
collectionName: string;
|
|
16
|
-
/** Sync configuration from modelRouter options */
|
|
17
10
|
config: SyncConfig;
|
|
18
|
-
/** Full modelRouter options (for responseHandler, permissions, etc.) */
|
|
19
11
|
options: ModelRouterOptions<unknown>;
|
|
20
12
|
}
|
|
21
|
-
|
|
22
|
-
* Enqueue an index-creation promise for `ensureSyncIndexes()` to await at startup. Used by
|
|
23
|
-
* `SyncApp.register` for the bookkeeping-model indexes (`SyncCounter`, `SyncMutation`,
|
|
24
|
-
* `SyncScopeMove`, `SyncKey`), which are correctness-critical and must not depend on
|
|
25
|
-
* Mongoose `autoIndex` being enabled.
|
|
26
|
-
*/
|
|
27
|
-
export declare const trackSyncIndexCreation: (promise: Promise<void>) => void;
|
|
28
|
-
/**
|
|
29
|
-
* Register a model for local-first sync. Called automatically by modelRouter when the
|
|
30
|
-
* `sync` option is provided. Validates the schema contract at startup and throws with
|
|
31
|
-
* an actionable message when it is not met:
|
|
32
|
-
* - soft delete (`isDeletedPlugin`) is required so deletes remain queryable tombstones;
|
|
33
|
-
* - `syncPlugin` is required so every write stamps a per-stream `_syncSeq`;
|
|
34
|
-
* - owner/tenant scope fields must exist on the schema.
|
|
35
|
-
*/
|
|
13
|
+
export { ensureSyncIndexes, trackSyncIndexCreation };
|
|
36
14
|
export declare const registerSync: <T>({ model, routePath, config, options, }: {
|
|
37
15
|
model: Model<T>;
|
|
38
16
|
routePath: string;
|
|
39
17
|
config: SyncConfig;
|
|
40
18
|
options: ModelRouterOptions<T>;
|
|
41
19
|
}) => void;
|
|
42
|
-
/**
|
|
43
|
-
* Replace options on an existing sync registry entry after TerrenoApp injects
|
|
44
|
-
* accessControl and modelRouter resolves RBAC permissions.
|
|
45
|
-
*/
|
|
46
20
|
export declare const updateSyncRegistryOptions: (routePath: string, options: ModelRouterOptions<unknown>) => void;
|
|
47
|
-
/**
|
|
48
|
-
* C8: await every enqueued sync index creation — per-model snapshot indexes from
|
|
49
|
-
* `registerSync` plus the bookkeeping-model indexes from `SyncApp.register` — throwing on
|
|
50
|
-
* the first failure. Called at server startup by `TerrenoApp.start()` (after all models
|
|
51
|
-
* and plugins register) so a missing index fails the boot loudly rather than silently
|
|
52
|
-
* degrading the snapshot query to a table scan or breaking mutation idempotency.
|
|
53
|
-
*/
|
|
54
|
-
export declare const ensureSyncIndexes: () => Promise<void>;
|
|
55
|
-
/** Get all registered sync models. */
|
|
56
21
|
export declare const getSyncRegistry: () => SyncRegistryEntry[];
|
|
57
|
-
/**
|
|
58
|
-
* Task 9.21: warn loudly at startup when a tenant/custom-scoped collection is registered
|
|
59
|
-
* but no `userModel` is configured for socket handshakes.
|
|
60
|
-
*
|
|
61
|
-
* Without one, `getSocketUser` falls back to the synthetic decoded-token user: `admin`
|
|
62
|
-
* comes from a JWT claim rather than the database, and `getUserScopes` sees no
|
|
63
|
-
* `organizationIds`, so tenant subscriptions silently resolve to no streams (a client that
|
|
64
|
-
* appears connected but never receives data). This warns rather than throws so an existing
|
|
65
|
-
* deployment cannot be bricked by an upgrade; the message names the collections and the
|
|
66
|
-
* fix. Returns the offending collection tags for tests and callers that want to escalate.
|
|
67
|
-
*/
|
|
68
22
|
export declare const warnOnSyncScopesWithoutUserModel: ({ userModel }: {
|
|
69
23
|
userModel?: unknown;
|
|
70
24
|
}) => string[];
|
|
71
|
-
/** Find a sync registry entry by Mongoose model name. */
|
|
72
25
|
export declare const findSyncEntryByModelName: (modelName: string) => SyncRegistryEntry | undefined;
|
|
73
|
-
/** Find a sync registry entry by collection tag (e.g. "todos"). */
|
|
74
26
|
export declare const findSyncEntryByCollectionTag: (collectionTag: string) => SyncRegistryEntry | undefined;
|
|
75
|
-
/** Find a sync registry entry by MongoDB collection name. */
|
|
76
27
|
export declare const findSyncEntryByCollectionName: (collectionName: string) => SyncRegistryEntry | undefined;
|
|
77
|
-
/** Clear the registry (for testing). */
|
|
78
28
|
export declare const clearSyncRegistry: () => void;
|
package/dist/sync/registry.js
CHANGED
|
@@ -1,200 +1,57 @@
|
|
|
1
1
|
"use strict";
|
|
2
|
-
var
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
};
|
|
11
|
-
|
|
12
|
-
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
|
|
13
|
-
return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
|
|
14
|
-
function verb(n) { return function (v) { return step([n, v]); }; }
|
|
15
|
-
function step(op) {
|
|
16
|
-
if (f) throw new TypeError("Generator is already executing.");
|
|
17
|
-
while (g && (g = 0, op[0] && (_ = 0)), _) try {
|
|
18
|
-
if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
|
|
19
|
-
if (y = 0, t) op = [op[0] & 2, t.value];
|
|
20
|
-
switch (op[0]) {
|
|
21
|
-
case 0: case 1: t = op; break;
|
|
22
|
-
case 4: _.label++; return { value: op[1], done: false };
|
|
23
|
-
case 5: _.label++; y = op[1]; op = [0]; continue;
|
|
24
|
-
case 7: op = _.ops.pop(); _.trys.pop(); continue;
|
|
25
|
-
default:
|
|
26
|
-
if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
|
|
27
|
-
if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
|
|
28
|
-
if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
|
|
29
|
-
if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
|
|
30
|
-
if (t[2]) _.ops.pop();
|
|
31
|
-
_.trys.pop(); continue;
|
|
32
|
-
}
|
|
33
|
-
op = body.call(thisArg, _);
|
|
34
|
-
} catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
|
|
35
|
-
if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
|
|
36
|
-
}
|
|
2
|
+
var __assign = (this && this.__assign) || function () {
|
|
3
|
+
__assign = Object.assign || function(t) {
|
|
4
|
+
for (var s, i = 1, n = arguments.length; i < n; i++) {
|
|
5
|
+
s = arguments[i];
|
|
6
|
+
for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
|
|
7
|
+
t[p] = s[p];
|
|
8
|
+
}
|
|
9
|
+
return t;
|
|
10
|
+
};
|
|
11
|
+
return __assign.apply(this, arguments);
|
|
37
12
|
};
|
|
38
13
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
39
|
-
exports.clearSyncRegistry = exports.findSyncEntryByCollectionName = exports.findSyncEntryByCollectionTag = exports.findSyncEntryByModelName = exports.warnOnSyncScopesWithoutUserModel = exports.getSyncRegistry = exports.
|
|
14
|
+
exports.clearSyncRegistry = exports.findSyncEntryByCollectionName = exports.findSyncEntryByCollectionTag = exports.findSyncEntryByModelName = exports.warnOnSyncScopesWithoutUserModel = exports.getSyncRegistry = exports.updateSyncRegistryOptions = exports.registerSync = exports.trackSyncIndexCreation = exports.ensureSyncIndexes = void 0;
|
|
15
|
+
var collectionRegistry_1 = require("../collectionRegistry");
|
|
40
16
|
var logger_1 = require("../logger");
|
|
41
|
-
var
|
|
42
|
-
var
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
var trackSyncIndexCreation = function (promise) {
|
|
59
|
-
indexCreationPromises.push(promise);
|
|
60
|
-
// Swallow the detached rejection (the failure is logged where it happens and rethrown
|
|
61
|
-
// by `ensureSyncIndexes()` via the retained promise above).
|
|
62
|
-
promise.catch(function () { });
|
|
17
|
+
var adminBroadcastScope_1 = require("./adminBroadcastScope");
|
|
18
|
+
var adminWindowMutation_1 = require("./adminWindowMutation");
|
|
19
|
+
var registrationSideEffects_1 = require("./registrationSideEffects");
|
|
20
|
+
Object.defineProperty(exports, "ensureSyncIndexes", { enumerable: true, get: function () { return registrationSideEffects_1.ensureSyncIndexes; } });
|
|
21
|
+
Object.defineProperty(exports, "trackSyncIndexCreation", { enumerable: true, get: function () { return registrationSideEffects_1.trackSyncIndexCreation; } });
|
|
22
|
+
var toSyncEntry = function (record) { return ({
|
|
23
|
+
collectionName: record.model.collection.collectionName,
|
|
24
|
+
collectionTag: record.routePath.replace(/^\//, ""),
|
|
25
|
+
config: record.options.sync,
|
|
26
|
+
modelName: record.model.modelName,
|
|
27
|
+
options: record.options,
|
|
28
|
+
routePath: record.routePath,
|
|
29
|
+
}); };
|
|
30
|
+
var syncCollections = function () {
|
|
31
|
+
return (0, collectionRegistry_1.listCollections)()
|
|
32
|
+
.filter(function (record) { return record.surfaces.sync; })
|
|
33
|
+
.map(toSyncEntry);
|
|
63
34
|
};
|
|
64
|
-
exports.trackSyncIndexCreation = trackSyncIndexCreation;
|
|
65
|
-
/**
|
|
66
|
-
* Register a model for local-first sync. Called automatically by modelRouter when the
|
|
67
|
-
* `sync` option is provided. Validates the schema contract at startup and throws with
|
|
68
|
-
* an actionable message when it is not met:
|
|
69
|
-
* - soft delete (`isDeletedPlugin`) is required so deletes remain queryable tombstones;
|
|
70
|
-
* - `syncPlugin` is required so every write stamps a per-stream `_syncSeq`;
|
|
71
|
-
* - owner/tenant scope fields must exist on the schema.
|
|
72
|
-
*/
|
|
73
35
|
var registerSync = function (_a) {
|
|
74
|
-
var _b;
|
|
75
36
|
var model = _a.model, routePath = _a.routePath, config = _a.config, options = _a.options;
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
throw new Error("Model ".concat(name, " has a sync config but no soft delete support. ") +
|
|
80
|
-
"Apply isDeletedPlugin to the schema — sync catch-up requires delete tombstones.");
|
|
81
|
-
}
|
|
82
|
-
if (!model.schema.path("_syncSeq")) {
|
|
83
|
-
throw new Error("Model ".concat(name, " has a sync config but syncPlugin is not applied to its schema. ") +
|
|
84
|
-
"Apply syncPlugin so every write stamps a per-stream _syncSeq.");
|
|
85
|
-
}
|
|
86
|
-
var scopeField = (0, streams_1.getScopeField)(config.scope);
|
|
87
|
-
if (scopeField && !model.schema.path(scopeField)) {
|
|
88
|
-
throw new Error("Model ".concat(name, " has a sync scope on field \"").concat(scopeField, "\" but the schema has no such path."));
|
|
89
|
-
}
|
|
90
|
-
if (typeof config.scope === "function" && !config.snapshotFilter) {
|
|
91
|
-
throw new Error("Model ".concat(name, " uses a custom sync scope resolver, which requires a snapshotFilter ") +
|
|
92
|
-
"so the snapshot endpoint can restrict queries to the caller's documents.");
|
|
93
|
-
}
|
|
94
|
-
if (syncRegistry.some(function (entry) { return entry.modelName === name; })) {
|
|
95
|
-
throw new Error("Model ".concat(name, " is already registered for sync."));
|
|
96
|
-
}
|
|
97
|
-
// C8: a duplicate collectionTag would make two models share sync streams and route
|
|
98
|
-
// snapshots/deltas ambiguously — reject it loudly at registration.
|
|
99
|
-
var collectionTag = routePath.replace(/^\//, "");
|
|
100
|
-
if (syncRegistry.some(function (entry) { return entry.collectionTag === collectionTag; })) {
|
|
101
|
-
throw new Error("Sync collection tag \"".concat(collectionTag, "\" is already registered (routePath ").concat(routePath, "). ") +
|
|
102
|
-
"Each synced model must have a unique route path.");
|
|
103
|
-
}
|
|
104
|
-
syncRegistry.push({
|
|
105
|
-
collectionName: model.collection.collectionName,
|
|
106
|
-
collectionTag: collectionTag,
|
|
107
|
-
config: config,
|
|
108
|
-
modelName: name,
|
|
109
|
-
options: options,
|
|
37
|
+
(0, collectionRegistry_1.registerCollection)({
|
|
38
|
+
model: model,
|
|
39
|
+
options: __assign(__assign({}, options), { sync: config }),
|
|
110
40
|
routePath: routePath,
|
|
111
41
|
});
|
|
112
|
-
// `Model.bulkWrite` bypasses Mongoose middleware entirely, so `syncPlugin`'s query
|
|
113
|
-
// guards never see it: writes land with no `_syncSeq`, invisible to both delta emission
|
|
114
|
-
// and snapshot catch-up, and clients silently never learn about them. The restriction
|
|
115
|
-
// used to be documentation only — replace the static so it throws the same way the
|
|
116
|
-
// guarded multi-document paths do. Idempotent: the replacement never delegates, so a
|
|
117
|
-
// re-registration (tests clearing the registry) re-patching it is harmless.
|
|
118
|
-
model.bulkWrite = function () {
|
|
119
|
-
throw new Error("bulkWrite is not supported on sync-enabled model ".concat(name, ": it bypasses Mongoose ") +
|
|
120
|
-
"middleware, so writes are never stamped with a per-stream _syncSeq and become " +
|
|
121
|
-
"invisible to sync delta emission and snapshot catch-up. Loop per document instead.");
|
|
122
|
-
};
|
|
123
|
-
// Compound index for snapshot/catch-up queries: {scopeField, _syncSeq}. Created
|
|
124
|
-
// directly on the collection because the model is already compiled at registration.
|
|
125
|
-
// C8: track the promise so `ensureSyncIndexes()` (server startup) can fail loudly on a
|
|
126
|
-
// createIndex error — a missing index table-scans the snapshot query under load. The
|
|
127
|
-
// detached path only logs (never throws into an orphaned promise).
|
|
128
|
-
var indexSpec = scopeField ? (_b = {}, _b[scopeField] = 1, _b._syncSeq = 1, _b) : { _syncSeq: 1 };
|
|
129
|
-
var indexPromise = model.collection
|
|
130
|
-
.createIndex(indexSpec)
|
|
131
|
-
.then(function () { })
|
|
132
|
-
.catch(function (error) {
|
|
133
|
-
logger_1.logger.error("[sync] Failed to create sync index for ".concat(name), { error: String(error) });
|
|
134
|
-
throw new Error("Failed to create sync snapshot index for ".concat(name, ": ").concat(String(error), ". ") +
|
|
135
|
-
"The snapshot/catch-up query requires this index; fix the schema/DB and restart.");
|
|
136
|
-
});
|
|
137
|
-
indexCreationPromises.push(indexPromise);
|
|
138
|
-
// Swallow the detached rejection (already logged) so it is not an unhandled rejection;
|
|
139
|
-
// `ensureSyncIndexes()` still observes it via the retained promise above.
|
|
140
|
-
indexPromise.catch(function () { });
|
|
141
42
|
};
|
|
142
43
|
exports.registerSync = registerSync;
|
|
143
|
-
/**
|
|
144
|
-
* Replace options on an existing sync registry entry after TerrenoApp injects
|
|
145
|
-
* accessControl and modelRouter resolves RBAC permissions.
|
|
146
|
-
*/
|
|
147
44
|
var updateSyncRegistryOptions = function (routePath, options) {
|
|
148
|
-
|
|
149
|
-
if (!existing) {
|
|
150
|
-
return;
|
|
151
|
-
}
|
|
152
|
-
existing.options = options;
|
|
45
|
+
(0, collectionRegistry_1.replaceCollectionOptions)(routePath, options);
|
|
153
46
|
};
|
|
154
47
|
exports.updateSyncRegistryOptions = updateSyncRegistryOptions;
|
|
155
|
-
|
|
156
|
-
* C8: await every enqueued sync index creation — per-model snapshot indexes from
|
|
157
|
-
* `registerSync` plus the bookkeeping-model indexes from `SyncApp.register` — throwing on
|
|
158
|
-
* the first failure. Called at server startup by `TerrenoApp.start()` (after all models
|
|
159
|
-
* and plugins register) so a missing index fails the boot loudly rather than silently
|
|
160
|
-
* degrading the snapshot query to a table scan or breaking mutation idempotency.
|
|
161
|
-
*/
|
|
162
|
-
var ensureSyncIndexes = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
163
|
-
return __generator(this, function (_a) {
|
|
164
|
-
switch (_a.label) {
|
|
165
|
-
case 0: return [4 /*yield*/, Promise.all(indexCreationPromises)];
|
|
166
|
-
case 1:
|
|
167
|
-
_a.sent();
|
|
168
|
-
return [2 /*return*/];
|
|
169
|
-
}
|
|
170
|
-
});
|
|
171
|
-
}); };
|
|
172
|
-
exports.ensureSyncIndexes = ensureSyncIndexes;
|
|
173
|
-
/** Get all registered sync models. */
|
|
174
|
-
var getSyncRegistry = function () { return syncRegistry; };
|
|
48
|
+
var getSyncRegistry = function () { return syncCollections(); };
|
|
175
49
|
exports.getSyncRegistry = getSyncRegistry;
|
|
176
|
-
/**
|
|
177
|
-
* Collection tags whose scope can only be resolved from the FULL user document —
|
|
178
|
-
* tenant scopes read `organizationIds` (or whatever `getUserScopes` looks at) and custom
|
|
179
|
-
* resolvers may read anything. The synthetic `{_id, admin, id}` user built from JWT claims
|
|
180
|
-
* carries none of that.
|
|
181
|
-
*/
|
|
182
50
|
var scopesRequiringFullUser = function () {
|
|
183
|
-
return
|
|
51
|
+
return syncCollections()
|
|
184
52
|
.filter(function (entry) { return typeof entry.config.scope === "function" || entry.config.scope.type === "tenant"; })
|
|
185
53
|
.map(function (entry) { return entry.collectionTag; });
|
|
186
54
|
};
|
|
187
|
-
/**
|
|
188
|
-
* Task 9.21: warn loudly at startup when a tenant/custom-scoped collection is registered
|
|
189
|
-
* but no `userModel` is configured for socket handshakes.
|
|
190
|
-
*
|
|
191
|
-
* Without one, `getSocketUser` falls back to the synthetic decoded-token user: `admin`
|
|
192
|
-
* comes from a JWT claim rather than the database, and `getUserScopes` sees no
|
|
193
|
-
* `organizationIds`, so tenant subscriptions silently resolve to no streams (a client that
|
|
194
|
-
* appears connected but never receives data). This warns rather than throws so an existing
|
|
195
|
-
* deployment cannot be bricked by an upgrade; the message names the collections and the
|
|
196
|
-
* fix. Returns the offending collection tags for tests and callers that want to escalate.
|
|
197
|
-
*/
|
|
198
55
|
var warnOnSyncScopesWithoutUserModel = function (_a) {
|
|
199
56
|
var userModel = _a.userModel;
|
|
200
57
|
if (userModel) {
|
|
@@ -212,24 +69,22 @@ var warnOnSyncScopesWithoutUserModel = function (_a) {
|
|
|
212
69
|
return collections;
|
|
213
70
|
};
|
|
214
71
|
exports.warnOnSyncScopesWithoutUserModel = warnOnSyncScopesWithoutUserModel;
|
|
215
|
-
/** Find a sync registry entry by Mongoose model name. */
|
|
216
72
|
var findSyncEntryByModelName = function (modelName) {
|
|
217
|
-
return
|
|
73
|
+
return syncCollections().find(function (entry) { return entry.modelName === modelName; });
|
|
218
74
|
};
|
|
219
75
|
exports.findSyncEntryByModelName = findSyncEntryByModelName;
|
|
220
|
-
/** Find a sync registry entry by collection tag (e.g. "todos"). */
|
|
221
76
|
var findSyncEntryByCollectionTag = function (collectionTag) {
|
|
222
|
-
return
|
|
77
|
+
return syncCollections().find(function (entry) { return entry.collectionTag === collectionTag; });
|
|
223
78
|
};
|
|
224
79
|
exports.findSyncEntryByCollectionTag = findSyncEntryByCollectionTag;
|
|
225
|
-
/** Find a sync registry entry by MongoDB collection name. */
|
|
226
80
|
var findSyncEntryByCollectionName = function (collectionName) {
|
|
227
|
-
return
|
|
81
|
+
return syncCollections().find(function (entry) { return entry.collectionName === collectionName; });
|
|
228
82
|
};
|
|
229
83
|
exports.findSyncEntryByCollectionName = findSyncEntryByCollectionName;
|
|
230
|
-
/** Clear the registry (for testing). */
|
|
231
84
|
var clearSyncRegistry = function () {
|
|
232
|
-
|
|
233
|
-
|
|
85
|
+
(0, collectionRegistry_1.clearCollectionRegistry)();
|
|
86
|
+
(0, registrationSideEffects_1.clearSyncIndexCreationTasks)();
|
|
87
|
+
(0, adminBroadcastScope_1.clearAdminBroadcastScopes)();
|
|
88
|
+
(0, adminWindowMutation_1.clearAdminWindowMutationScopes)();
|
|
234
89
|
};
|
|
235
90
|
exports.clearSyncRegistry = clearSyncRegistry;
|
package/dist/sync/routes.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import express from "express";
|
|
2
2
|
import mongoose from "mongoose";
|
|
3
3
|
import { type User } from "../auth";
|
|
4
|
+
import type { AnyTerrenoAccess } from "../rbac/types";
|
|
4
5
|
import { type SyncRegistryEntry } from "./registry";
|
|
5
6
|
/**
|
|
6
7
|
* Maximum mutations per user per second on the HTTP mutate routes.
|
|
@@ -21,6 +22,18 @@ export interface SyncAppOptions {
|
|
|
21
22
|
getUserScopes?: (user: User, entry: SyncRegistryEntry) => Promise<string[]> | string[];
|
|
22
23
|
/** Default page size for snapshots (default 100, max 100). */
|
|
23
24
|
defaultSnapshotLimit?: number;
|
|
25
|
+
/**
|
|
26
|
+
* When set, `{collection}|admin` window subscribe and cross-owner entity
|
|
27
|
+
* hydrate require `admin:access` instead of the legacy `user.admin` flag.
|
|
28
|
+
* AdminApp also registers per-model list/read/`queryFilter` so hydrate and
|
|
29
|
+
* `|admin` deltas match `/admin` REST, not product `IsOwner`.
|
|
30
|
+
*/
|
|
31
|
+
accessControl?: AnyTerrenoAccess;
|
|
32
|
+
/**
|
|
33
|
+
* Override the admin-window gate. Defaults to `admin:access` when
|
|
34
|
+
* `accessControl` is set, otherwise `Permissions.IsAdmin`.
|
|
35
|
+
*/
|
|
36
|
+
canOpenAdminWindow?: (user: User) => boolean | Promise<boolean>;
|
|
24
37
|
}
|
|
25
38
|
/**
|
|
26
39
|
* Serialize a document for a sync payload through the fallback chain:
|
package/dist/sync/routes.js
CHANGED
|
@@ -94,6 +94,9 @@ var auth_1 = require("../auth");
|
|
|
94
94
|
var errors_1 = require("../errors");
|
|
95
95
|
var logger_1 = require("../logger");
|
|
96
96
|
var permissions_1 = require("../permissions");
|
|
97
|
+
var plugins_1 = require("../plugins");
|
|
98
|
+
var adminBroadcastScope_1 = require("./adminBroadcastScope");
|
|
99
|
+
var adminWindowAccess_1 = require("./adminWindowAccess");
|
|
97
100
|
var models_1 = require("./models");
|
|
98
101
|
var registry_1 = require("./registry");
|
|
99
102
|
var serialize_1 = require("./serialize");
|
|
@@ -360,10 +363,10 @@ var frontierBelowStreamHead = function (streamKey, frontierSeq) { return __await
|
|
|
360
363
|
var _a;
|
|
361
364
|
return __generator(this, function (_b) {
|
|
362
365
|
switch (_b.label) {
|
|
363
|
-
case 0: return [4 /*yield*/, models_1.SyncCounter
|
|
366
|
+
case 0: return [4 /*yield*/, (0, plugins_1.findOneOrNoneFor)(models_1.SyncCounter, { stream: streamKey })];
|
|
364
367
|
case 1:
|
|
365
368
|
counter = _b.sent();
|
|
366
|
-
head = counter ?
|
|
369
|
+
head = (_a = counter === null || counter === void 0 ? void 0 : counter.seq) !== null && _a !== void 0 ? _a : 0;
|
|
367
370
|
return [2 /*return*/, head > frontierSeq];
|
|
368
371
|
}
|
|
369
372
|
});
|
|
@@ -730,17 +733,17 @@ var addSyncRoutes = function (app, options) {
|
|
|
730
733
|
});
|
|
731
734
|
}); }));
|
|
732
735
|
router.get("/sync/entities", (0, auth_1.authenticateMiddleware)(), (0, api_1.asyncHandler)(function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
|
|
733
|
-
var user, collection, idsParam, ids, entry, memberStreams, memberSet, queryFilterResult, deniedResponse, model, castIds, docs, entities,
|
|
734
|
-
var e_5,
|
|
735
|
-
var
|
|
736
|
-
return __generator(this, function (
|
|
737
|
-
switch (
|
|
736
|
+
var user, collection, idsParam, ids, entry, isAdminWindow, _a, adminScope, _b, deniedResponse, memberStreams, _c, memberSet, queryFilterResult, _d, _e, deniedResponse, model, castIds, docs, entities, _f, _g, doc, allowed, _h, docObj, stream, isTombstone, _j, _k, _l, e_5_1, response;
|
|
737
|
+
var e_5, _m, _o;
|
|
738
|
+
var _p, _q;
|
|
739
|
+
return __generator(this, function (_r) {
|
|
740
|
+
switch (_r.label) {
|
|
738
741
|
case 0:
|
|
739
742
|
user = req.user;
|
|
740
743
|
if (!user) {
|
|
741
744
|
throw new errors_1.APIError({ status: 401, title: "Authentication required" });
|
|
742
745
|
}
|
|
743
|
-
collection = String((
|
|
746
|
+
collection = String((_p = req.query.collection) !== null && _p !== void 0 ? _p : "").trim();
|
|
744
747
|
if (!collection) {
|
|
745
748
|
throw new errors_1.APIError({ status: 400, title: "collection query parameter is required" });
|
|
746
749
|
}
|
|
@@ -772,23 +775,68 @@ var addSyncRoutes = function (app, options) {
|
|
|
772
775
|
}
|
|
773
776
|
return [4 /*yield*/, (0, permissions_1.checkPermissions)("list", entry.options.permissions.list, user)];
|
|
774
777
|
case 1:
|
|
775
|
-
if (!(
|
|
778
|
+
if (!(_r.sent())) {
|
|
776
779
|
throw new errors_1.APIError({
|
|
777
780
|
status: 403,
|
|
778
781
|
title: "Access to sync entities for ".concat(collection, " denied for ").concat(user.id),
|
|
779
782
|
});
|
|
780
783
|
}
|
|
781
|
-
|
|
782
|
-
|
|
783
|
-
|
|
784
|
+
_a = entry.config.adminBroadcast === true;
|
|
785
|
+
if (!_a) return [3 /*break*/, 3];
|
|
786
|
+
return [4 /*yield*/, (0, adminWindowAccess_1.canUseAdminBroadcastWindow)({
|
|
787
|
+
accessControl: options.accessControl,
|
|
788
|
+
canOpenAdminWindow: options.canOpenAdminWindow,
|
|
784
789
|
user: user,
|
|
785
790
|
})];
|
|
786
791
|
case 2:
|
|
787
|
-
|
|
788
|
-
|
|
789
|
-
return [4 /*yield*/, resolveSyncQueryFilter({ entry: entry, user: user })];
|
|
792
|
+
_a = (_r.sent());
|
|
793
|
+
_r.label = 3;
|
|
790
794
|
case 3:
|
|
791
|
-
|
|
795
|
+
isAdminWindow = _a;
|
|
796
|
+
adminScope = isAdminWindow ? (0, adminBroadcastScope_1.getAdminBroadcastScope)(entry.modelName) : undefined;
|
|
797
|
+
_b = adminScope;
|
|
798
|
+
if (!_b) return [3 /*break*/, 5];
|
|
799
|
+
return [4 /*yield*/, (0, adminBroadcastScope_1.canListAdminBroadcastScope)({ scope: adminScope, user: user })];
|
|
800
|
+
case 4:
|
|
801
|
+
_b = !(_r.sent());
|
|
802
|
+
_r.label = 5;
|
|
803
|
+
case 5:
|
|
804
|
+
if (_b) {
|
|
805
|
+
deniedResponse = { entities: [] };
|
|
806
|
+
return [2 /*return*/, res.json(deniedResponse)];
|
|
807
|
+
}
|
|
808
|
+
if (!isAdminWindow) return [3 /*break*/, 6];
|
|
809
|
+
_c = [];
|
|
810
|
+
return [3 /*break*/, 8];
|
|
811
|
+
case 6: return [4 /*yield*/, (0, streams_1.resolveUserStreamsForEntry)({
|
|
812
|
+
entry: entry,
|
|
813
|
+
getUserScopes: options.getUserScopes,
|
|
814
|
+
user: user,
|
|
815
|
+
})];
|
|
816
|
+
case 7:
|
|
817
|
+
_c = _r.sent();
|
|
818
|
+
_r.label = 8;
|
|
819
|
+
case 8:
|
|
820
|
+
memberStreams = _c;
|
|
821
|
+
memberSet = new Set(memberStreams);
|
|
822
|
+
if (!adminScope) return [3 /*break*/, 10];
|
|
823
|
+
return [4 /*yield*/, (0, adminBroadcastScope_1.resolveAdminBroadcastQueryFilter)({ scope: adminScope, user: user })];
|
|
824
|
+
case 9:
|
|
825
|
+
_d = _r.sent();
|
|
826
|
+
return [3 /*break*/, 14];
|
|
827
|
+
case 10:
|
|
828
|
+
if (!isAdminWindow) return [3 /*break*/, 11];
|
|
829
|
+
_e = { denied: false, filter: undefined };
|
|
830
|
+
return [3 /*break*/, 13];
|
|
831
|
+
case 11: return [4 /*yield*/, resolveSyncQueryFilter({ entry: entry, user: user })];
|
|
832
|
+
case 12:
|
|
833
|
+
_e = _r.sent();
|
|
834
|
+
_r.label = 13;
|
|
835
|
+
case 13:
|
|
836
|
+
_d = _e;
|
|
837
|
+
_r.label = 14;
|
|
838
|
+
case 14:
|
|
839
|
+
queryFilterResult = _d;
|
|
792
840
|
if (queryFilterResult.denied) {
|
|
793
841
|
deniedResponse = { entities: [] };
|
|
794
842
|
return [2 /*return*/, res.json(deniedResponse)];
|
|
@@ -799,22 +847,30 @@ var addSyncRoutes = function (app, options) {
|
|
|
799
847
|
queryFilter: queryFilterResult.filter,
|
|
800
848
|
scopeFilter: { _id: { $in: castIds } },
|
|
801
849
|
})), { deleted: { $in: [true, false] } }))];
|
|
802
|
-
case
|
|
803
|
-
docs =
|
|
850
|
+
case 15:
|
|
851
|
+
docs = _r.sent();
|
|
804
852
|
entities = [];
|
|
805
|
-
|
|
806
|
-
case
|
|
807
|
-
|
|
808
|
-
|
|
809
|
-
|
|
810
|
-
case
|
|
811
|
-
if (!!
|
|
812
|
-
doc =
|
|
813
|
-
return [
|
|
814
|
-
|
|
815
|
-
|
|
853
|
+
_r.label = 16;
|
|
854
|
+
case 16:
|
|
855
|
+
_r.trys.push([16, 27, 28, 29]);
|
|
856
|
+
_f = __values(docs), _g = _f.next();
|
|
857
|
+
_r.label = 17;
|
|
858
|
+
case 17:
|
|
859
|
+
if (!!_g.done) return [3 /*break*/, 26];
|
|
860
|
+
doc = _g.value;
|
|
861
|
+
if (!adminScope) return [3 /*break*/, 19];
|
|
862
|
+
return [4 /*yield*/, (0, permissions_1.checkPermissions)("read", adminScope.readPermissions, user, doc)];
|
|
863
|
+
case 18:
|
|
864
|
+
_h = _r.sent();
|
|
865
|
+
return [3 /*break*/, 21];
|
|
866
|
+
case 19: return [4 /*yield*/, (0, permissions_1.checkPermissions)("read", entry.options.permissions.read, user, doc)];
|
|
867
|
+
case 20:
|
|
868
|
+
_h = _r.sent();
|
|
869
|
+
_r.label = 21;
|
|
870
|
+
case 21:
|
|
871
|
+
allowed = _h;
|
|
816
872
|
if (!allowed) {
|
|
817
|
-
return [3 /*break*/,
|
|
873
|
+
return [3 /*break*/, 25];
|
|
818
874
|
}
|
|
819
875
|
docObj = doc.toObject();
|
|
820
876
|
stream = (0, streams_1.resolveStreamForDoc)({
|
|
@@ -822,41 +878,41 @@ var addSyncRoutes = function (app, options) {
|
|
|
822
878
|
doc: docObj,
|
|
823
879
|
scope: entry.config.scope,
|
|
824
880
|
});
|
|
825
|
-
if (!memberSet.has(stream)) {
|
|
826
|
-
return [3 /*break*/,
|
|
881
|
+
if (!isAdminWindow && !memberSet.has(stream)) {
|
|
882
|
+
return [3 /*break*/, 25];
|
|
827
883
|
}
|
|
828
884
|
isTombstone = Boolean(docObj.deleted);
|
|
829
|
-
|
|
830
|
-
|
|
831
|
-
if (!isTombstone) return [3 /*break*/,
|
|
832
|
-
|
|
833
|
-
return [3 /*break*/,
|
|
834
|
-
case
|
|
835
|
-
case
|
|
836
|
-
|
|
837
|
-
|
|
838
|
-
case
|
|
839
|
-
|
|
840
|
-
|
|
841
|
-
|
|
842
|
-
|
|
843
|
-
|
|
844
|
-
|
|
845
|
-
case
|
|
846
|
-
|
|
847
|
-
return [3 /*break*/,
|
|
848
|
-
case
|
|
849
|
-
case
|
|
850
|
-
e_5_1 =
|
|
885
|
+
_k = (_j = entities).push;
|
|
886
|
+
_o = {};
|
|
887
|
+
if (!isTombstone) return [3 /*break*/, 22];
|
|
888
|
+
_l = null;
|
|
889
|
+
return [3 /*break*/, 24];
|
|
890
|
+
case 22: return [4 /*yield*/, (0, exports.serializeSyncDoc)({ doc: doc, entry: entry, req: req })];
|
|
891
|
+
case 23:
|
|
892
|
+
_l = _r.sent();
|
|
893
|
+
_r.label = 24;
|
|
894
|
+
case 24:
|
|
895
|
+
_k.apply(_j, [(_o.data = _l,
|
|
896
|
+
_o.deleted = isTombstone,
|
|
897
|
+
_o.id = String(doc._id),
|
|
898
|
+
_o.seq = (_q = docObj._syncSeq) !== null && _q !== void 0 ? _q : 0,
|
|
899
|
+
_o)]);
|
|
900
|
+
_r.label = 25;
|
|
901
|
+
case 25:
|
|
902
|
+
_g = _f.next();
|
|
903
|
+
return [3 /*break*/, 17];
|
|
904
|
+
case 26: return [3 /*break*/, 29];
|
|
905
|
+
case 27:
|
|
906
|
+
e_5_1 = _r.sent();
|
|
851
907
|
e_5 = { error: e_5_1 };
|
|
852
|
-
return [3 /*break*/,
|
|
853
|
-
case
|
|
908
|
+
return [3 /*break*/, 29];
|
|
909
|
+
case 28:
|
|
854
910
|
try {
|
|
855
|
-
if (
|
|
911
|
+
if (_g && !_g.done && (_m = _f.return)) _m.call(_f);
|
|
856
912
|
}
|
|
857
913
|
finally { if (e_5) throw e_5.error; }
|
|
858
914
|
return [7 /*endfinally*/];
|
|
859
|
-
case
|
|
915
|
+
case 29:
|
|
860
916
|
response = { entities: entities };
|
|
861
917
|
return [2 /*return*/, res.json(response)];
|
|
862
918
|
}
|
|
@@ -875,6 +931,7 @@ var addSyncRoutes = function (app, options) {
|
|
|
875
931
|
mutation: req.body,
|
|
876
932
|
req: req,
|
|
877
933
|
scopeResolver: options.getUserScopes,
|
|
934
|
+
syncOptions: options,
|
|
878
935
|
user: user,
|
|
879
936
|
})];
|
|
880
937
|
case 1:
|
|
@@ -902,6 +959,7 @@ var addSyncRoutes = function (app, options) {
|
|
|
902
959
|
mutations: mutations,
|
|
903
960
|
req: req,
|
|
904
961
|
scopeResolver: options.getUserScopes,
|
|
962
|
+
syncOptions: options,
|
|
905
963
|
user: user,
|
|
906
964
|
})];
|
|
907
965
|
case 1:
|
|
@@ -67,8 +67,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
|
67
67
|
};
|
|
68
68
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
69
69
|
exports.compactTombstones = exports.compactEntryTombstones = exports.DEFAULT_TOMBSTONE_RETENTION_DAYS = void 0;
|
|
70
|
-
// noExplicitAny: operates generically across registered sync models
|
|
71
|
-
// biome-ignore-all lint/suspicious/noExplicitAny: operates generically across registered sync models
|
|
72
70
|
var luxon_1 = require("luxon");
|
|
73
71
|
var mongoose_1 = __importDefault(require("mongoose"));
|
|
74
72
|
var logger_1 = require("../../logger");
|