@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/src/rbac/resolve.test.ts
CHANGED
|
@@ -53,13 +53,45 @@ describe("createPermissionResolver", () => {
|
|
|
53
53
|
const first = await resolver.resolvePermissionsForUser(user);
|
|
54
54
|
expect(first.todo).toEqual(["read"]);
|
|
55
55
|
|
|
56
|
-
|
|
56
|
+
await RbacRole.findOneAndUpdate({name: "reader"}, {$set: {permissions: {todo: ["create"]}}});
|
|
57
57
|
const cached = await resolver.resolvePermissionsForUser(user);
|
|
58
58
|
expect(cached.todo).toEqual(["read"]);
|
|
59
59
|
|
|
60
60
|
resolver.invalidateCache({userId: user.id});
|
|
61
61
|
const refreshed = await resolver.resolvePermissionsForUser(user);
|
|
62
|
-
expect(refreshed.todo).
|
|
62
|
+
expect(refreshed.todo).toEqual(["create"]);
|
|
63
|
+
});
|
|
64
|
+
|
|
65
|
+
it("does not reuse cached permissions after the user's roles change", async () => {
|
|
66
|
+
await setupDb();
|
|
67
|
+
const RbacRole = createRbacRoleModel(mongoose.connection);
|
|
68
|
+
await RbacRole.seedDefaults({statements: appStatements});
|
|
69
|
+
await RbacRole.findOneAndUpdate(
|
|
70
|
+
{name: "reader"},
|
|
71
|
+
{
|
|
72
|
+
$set: {
|
|
73
|
+
displayName: "Reader",
|
|
74
|
+
name: "reader",
|
|
75
|
+
permissions: {todo: ["read"]},
|
|
76
|
+
},
|
|
77
|
+
},
|
|
78
|
+
{upsert: true}
|
|
79
|
+
);
|
|
80
|
+
|
|
81
|
+
const resolver = createPermissionResolver({
|
|
82
|
+
cacheTtlMs: 60_000,
|
|
83
|
+
rbacRoleModel: RbacRole,
|
|
84
|
+
statements: appStatements,
|
|
85
|
+
});
|
|
86
|
+
|
|
87
|
+
const user = createTestUser({roles: ["reader"]});
|
|
88
|
+
const first = await resolver.resolvePermissionsForUser(user);
|
|
89
|
+
expect(first.todo).toEqual(["read"]);
|
|
90
|
+
expect(first.admin).toBeUndefined();
|
|
91
|
+
|
|
92
|
+
user.roles = ["superadmin"];
|
|
93
|
+
const promoted = await resolver.resolvePermissionsForUser(user);
|
|
94
|
+
expect(promoted.admin).toEqual(expect.arrayContaining(["access"]));
|
|
63
95
|
});
|
|
64
96
|
|
|
65
97
|
it("clears all cached permissions when invalidateCache is called without userId", async () => {
|
package/src/rbac/resolve.ts
CHANGED
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
import {createAccessControl} from "better-auth/plugins/access";
|
|
2
|
+
import {DateTime} from "luxon";
|
|
2
3
|
|
|
3
4
|
import type {User} from "../auth";
|
|
4
5
|
import {logger} from "../logger";
|
|
6
|
+
import {getOrgContext} from "../orgs/orgContext";
|
|
5
7
|
import {unionPermissionSets} from "./permissionUtils";
|
|
6
8
|
import type {RbacRoleModel} from "./roleModel";
|
|
7
9
|
import type {PermissionSet, Statements} from "./statements";
|
|
@@ -25,6 +27,23 @@ const getUserRoles = (user: User): string[] => {
|
|
|
25
27
|
return withRoles.roles ?? [];
|
|
26
28
|
};
|
|
27
29
|
|
|
30
|
+
/** Include org context and roles so tenant switches and Mongo promotions are not stuck behind TTL. */
|
|
31
|
+
const permissionCacheKey = (user: User): string => {
|
|
32
|
+
const ctx = getOrgContext();
|
|
33
|
+
const organizationId = ctx?.organization?._id?.toString() ?? "";
|
|
34
|
+
const membershipRole = ctx?.membership?.roleName ?? "";
|
|
35
|
+
const roles = [...getUserRoles(user)].sort().join(",");
|
|
36
|
+
return `${user.id}::org=${organizationId}::role=${membershipRole}::roles=${roles}`;
|
|
37
|
+
};
|
|
38
|
+
|
|
39
|
+
const deletePermissionCacheForUser = (cache: Map<string, CacheEntry>, userId: string): void => {
|
|
40
|
+
for (const key of [...cache.keys()]) {
|
|
41
|
+
if (key === userId || key.startsWith(`${userId}:`) || key.startsWith(`${userId}::`)) {
|
|
42
|
+
cache.delete(key);
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
};
|
|
46
|
+
|
|
28
47
|
export const createPermissionResolver = <S extends Statements>(args: {
|
|
29
48
|
statements: S;
|
|
30
49
|
rbacRoleModel: RbacRoleModel;
|
|
@@ -47,7 +66,7 @@ export const createPermissionResolver = <S extends Statements>(args: {
|
|
|
47
66
|
const sourceCache = new Map<string, Map<string, SourceCacheEntry>>();
|
|
48
67
|
|
|
49
68
|
const enforceCacheBound = (): void => {
|
|
50
|
-
const now =
|
|
69
|
+
const now = DateTime.now().toMillis();
|
|
51
70
|
for (const [userId, entry] of permissionCache) {
|
|
52
71
|
if (entry.expiresAt <= now) {
|
|
53
72
|
permissionCache.delete(userId);
|
|
@@ -70,15 +89,15 @@ export const createPermissionResolver = <S extends Statements>(args: {
|
|
|
70
89
|
}
|
|
71
90
|
};
|
|
72
91
|
|
|
73
|
-
const rememberPermissions = (
|
|
74
|
-
permissionCache.delete(
|
|
75
|
-
permissionCache.set(
|
|
92
|
+
const rememberPermissions = (cacheKey: string, entry: CacheEntry): void => {
|
|
93
|
+
permissionCache.delete(cacheKey);
|
|
94
|
+
permissionCache.set(cacheKey, entry);
|
|
76
95
|
enforceCacheBound();
|
|
77
96
|
};
|
|
78
97
|
|
|
79
98
|
const invalidateCache = (invalidateArgs?: {userId?: string}): void => {
|
|
80
99
|
if (invalidateArgs?.userId) {
|
|
81
|
-
permissionCache
|
|
100
|
+
deletePermissionCacheForUser(permissionCache, invalidateArgs.userId);
|
|
82
101
|
sourceCache.delete(invalidateArgs.userId);
|
|
83
102
|
return;
|
|
84
103
|
}
|
|
@@ -159,7 +178,7 @@ export const createPermissionResolver = <S extends Statements>(args: {
|
|
|
159
178
|
source: PermissionSource,
|
|
160
179
|
shouldCache = true
|
|
161
180
|
): Promise<PermissionSourceGrants | null> => {
|
|
162
|
-
const now =
|
|
181
|
+
const now = DateTime.now().toMillis();
|
|
163
182
|
const cached = sourceCache.get(user.id)?.get(source.name);
|
|
164
183
|
|
|
165
184
|
if (!shouldCache) {
|
|
@@ -204,10 +223,11 @@ export const createPermissionResolver = <S extends Statements>(args: {
|
|
|
204
223
|
user: User,
|
|
205
224
|
shouldCache: boolean
|
|
206
225
|
): Promise<PermissionSet> => {
|
|
226
|
+
const cacheKey = permissionCacheKey(user);
|
|
207
227
|
if (shouldCache) {
|
|
208
|
-
const cached = permissionCache.get(
|
|
209
|
-
if (cached && cached.expiresAt >
|
|
210
|
-
rememberPermissions(
|
|
228
|
+
const cached = permissionCache.get(cacheKey);
|
|
229
|
+
if (cached && cached.expiresAt > DateTime.now().toMillis()) {
|
|
230
|
+
rememberPermissions(cacheKey, cached);
|
|
211
231
|
return cached.permissions;
|
|
212
232
|
}
|
|
213
233
|
}
|
|
@@ -250,8 +270,8 @@ export const createPermissionResolver = <S extends Statements>(args: {
|
|
|
250
270
|
}
|
|
251
271
|
|
|
252
272
|
if (shouldCache) {
|
|
253
|
-
rememberPermissions(
|
|
254
|
-
expiresAt:
|
|
273
|
+
rememberPermissions(cacheKey, {
|
|
274
|
+
expiresAt: DateTime.now().plus({milliseconds: cacheTtlMs}).toMillis(),
|
|
255
275
|
permissions,
|
|
256
276
|
});
|
|
257
277
|
}
|
|
@@ -880,6 +880,175 @@ describe("roleManager", () => {
|
|
|
880
880
|
expect(denied).toHaveLength(0);
|
|
881
881
|
});
|
|
882
882
|
|
|
883
|
+
it("requires a configured user model for unassign and modify checks", async () => {
|
|
884
|
+
await setupDb();
|
|
885
|
+
const access = createAccess({
|
|
886
|
+
connection: mongoose.connection,
|
|
887
|
+
statements: appStatements,
|
|
888
|
+
});
|
|
889
|
+
await access.roles.seedDefaults();
|
|
890
|
+
|
|
891
|
+
const actor = createTestUser({roles: ["superadmin"]});
|
|
892
|
+
const userId = new mongoose.Types.ObjectId().toString();
|
|
893
|
+
|
|
894
|
+
await expect(
|
|
895
|
+
access.roles.unassign({actor, roleNames: ["member"], userId})
|
|
896
|
+
).rejects.toMatchObject({status: 500, title: "User model not configured for role assignment"});
|
|
897
|
+
|
|
898
|
+
await expect(access.roles.assertCanModifyUser({actor, userId})).rejects.toMatchObject({
|
|
899
|
+
status: 500,
|
|
900
|
+
title: "User model not configured for role assignment",
|
|
901
|
+
});
|
|
902
|
+
});
|
|
903
|
+
|
|
904
|
+
it("returns 404 for unassign, previewAssignment, and assertCanModifyUser on missing users", async () => {
|
|
905
|
+
await setupDb();
|
|
906
|
+
const UserModel = getRbacTestUserModel();
|
|
907
|
+
const access = createAccess({
|
|
908
|
+
connection: mongoose.connection,
|
|
909
|
+
statements: appStatements,
|
|
910
|
+
userModel: UserModel as unknown as UserModel,
|
|
911
|
+
});
|
|
912
|
+
await access.roles.seedDefaults();
|
|
913
|
+
|
|
914
|
+
const actor = createTestUser({roles: ["superadmin"]});
|
|
915
|
+
const missingId = new mongoose.Types.ObjectId().toString();
|
|
916
|
+
|
|
917
|
+
await expect(
|
|
918
|
+
access.roles.unassign({actor, roleNames: ["member"], userId: missingId})
|
|
919
|
+
).rejects.toMatchObject({status: 404, title: "User not found"});
|
|
920
|
+
|
|
921
|
+
await expect(
|
|
922
|
+
access.roles.previewAssignment({actor, roleNames: ["member"], userId: missingId})
|
|
923
|
+
).rejects.toMatchObject({status: 404, title: "User not found"});
|
|
924
|
+
|
|
925
|
+
await expect(
|
|
926
|
+
access.roles.assertCanModifyUser({actor, userId: missingId})
|
|
927
|
+
).rejects.toMatchObject({status: 404, title: "User not found"});
|
|
928
|
+
});
|
|
929
|
+
|
|
930
|
+
it("rejects conflicting role assignments declared by the second role", async () => {
|
|
931
|
+
await setupDb();
|
|
932
|
+
const UserModel = getRbacTestUserModel();
|
|
933
|
+
const access = createAccess({
|
|
934
|
+
connection: mongoose.connection,
|
|
935
|
+
defaultRoles: [
|
|
936
|
+
{
|
|
937
|
+
displayName: "Role C",
|
|
938
|
+
name: "role-c",
|
|
939
|
+
permissions: {todo: ["read"]},
|
|
940
|
+
},
|
|
941
|
+
{
|
|
942
|
+
displayName: "Role D",
|
|
943
|
+
excludesRoles: ["role-c"],
|
|
944
|
+
name: "role-d",
|
|
945
|
+
permissions: {todo: ["update"]},
|
|
946
|
+
},
|
|
947
|
+
],
|
|
948
|
+
statements: appStatements,
|
|
949
|
+
userModel: UserModel as unknown as UserModel,
|
|
950
|
+
});
|
|
951
|
+
await access.roles.seedDefaults();
|
|
952
|
+
|
|
953
|
+
const actor = createTestUser({roles: ["superadmin"]});
|
|
954
|
+
const target = await UserModel.create({email: "reverse-conflict@example.com", roles: []});
|
|
955
|
+
|
|
956
|
+
await expect(
|
|
957
|
+
access.roles.assign({actor, roleNames: ["role-c", "role-d"], userId: target.id})
|
|
958
|
+
).rejects.toMatchObject({
|
|
959
|
+
status: 409,
|
|
960
|
+
title: "Role role-c conflicts with role-d",
|
|
961
|
+
});
|
|
962
|
+
});
|
|
963
|
+
|
|
964
|
+
it("rejects changing locked fields on a locked role", async () => {
|
|
965
|
+
await setupDb();
|
|
966
|
+
const access = createAccess({
|
|
967
|
+
connection: mongoose.connection,
|
|
968
|
+
statements: appStatements,
|
|
969
|
+
});
|
|
970
|
+
await access.roles.seedDefaults();
|
|
971
|
+
|
|
972
|
+
const actor = createTestUser({roles: ["superadmin"]});
|
|
973
|
+
await expect(
|
|
974
|
+
access.roles.update({
|
|
975
|
+
actor,
|
|
976
|
+
changes: {isSealed: true},
|
|
977
|
+
roleName: "admin",
|
|
978
|
+
})
|
|
979
|
+
).rejects.toMatchObject({status: 400, title: "Cannot change locked fields on a locked role"});
|
|
980
|
+
});
|
|
981
|
+
|
|
982
|
+
it("rejects excludesRoles updates that conflict with existing assignments", async () => {
|
|
983
|
+
await setupDb();
|
|
984
|
+
const UserModel = getRbacTestUserModel();
|
|
985
|
+
const access = createAccess({
|
|
986
|
+
connection: mongoose.connection,
|
|
987
|
+
defaultRoles: [
|
|
988
|
+
{
|
|
989
|
+
displayName: "Writer",
|
|
990
|
+
name: "writer",
|
|
991
|
+
permissions: {todo: ["update"]},
|
|
992
|
+
},
|
|
993
|
+
{
|
|
994
|
+
displayName: "Reader",
|
|
995
|
+
name: "reader",
|
|
996
|
+
permissions: {todo: ["read"]},
|
|
997
|
+
},
|
|
998
|
+
],
|
|
999
|
+
statements: appStatements,
|
|
1000
|
+
userModel: UserModel as unknown as UserModel,
|
|
1001
|
+
});
|
|
1002
|
+
await access.roles.seedDefaults();
|
|
1003
|
+
|
|
1004
|
+
const actor = createTestUser({roles: ["superadmin"]});
|
|
1005
|
+
await UserModel.create({email: "both@example.com", roles: ["writer", "reader"]});
|
|
1006
|
+
|
|
1007
|
+
await expect(
|
|
1008
|
+
access.roles.update({
|
|
1009
|
+
actor,
|
|
1010
|
+
changes: {excludesRoles: ["reader"]},
|
|
1011
|
+
roleName: "writer",
|
|
1012
|
+
})
|
|
1013
|
+
).rejects.toMatchObject({
|
|
1014
|
+
status: 400,
|
|
1015
|
+
title: "excludesRoles conflicts with existing assignments",
|
|
1016
|
+
});
|
|
1017
|
+
});
|
|
1018
|
+
|
|
1019
|
+
it("allows excludesRoles updates when no holder has the excluded role", async () => {
|
|
1020
|
+
await setupDb();
|
|
1021
|
+
const UserModel = getRbacTestUserModel();
|
|
1022
|
+
const access = createAccess({
|
|
1023
|
+
connection: mongoose.connection,
|
|
1024
|
+
defaultRoles: [
|
|
1025
|
+
{
|
|
1026
|
+
displayName: "Solo Writer",
|
|
1027
|
+
name: "solo-writer",
|
|
1028
|
+
permissions: {todo: ["update"]},
|
|
1029
|
+
},
|
|
1030
|
+
{
|
|
1031
|
+
displayName: "Solo Reader",
|
|
1032
|
+
name: "solo-reader",
|
|
1033
|
+
permissions: {todo: ["read"]},
|
|
1034
|
+
},
|
|
1035
|
+
],
|
|
1036
|
+
statements: appStatements,
|
|
1037
|
+
userModel: UserModel as unknown as UserModel,
|
|
1038
|
+
});
|
|
1039
|
+
await access.roles.seedDefaults();
|
|
1040
|
+
|
|
1041
|
+
const actor = createTestUser({roles: ["superadmin"]});
|
|
1042
|
+
await UserModel.create({email: "writer-only@example.com", roles: ["solo-writer"]});
|
|
1043
|
+
|
|
1044
|
+
const updated = await access.roles.update({
|
|
1045
|
+
actor,
|
|
1046
|
+
changes: {excludesRoles: ["solo-reader"]},
|
|
1047
|
+
roleName: "solo-writer",
|
|
1048
|
+
});
|
|
1049
|
+
expect(updated.excludesRoles).toEqual(["solo-reader"]);
|
|
1050
|
+
});
|
|
1051
|
+
|
|
883
1052
|
it("keeps the original escalation error when denied-audit persistence fails", async () => {
|
|
884
1053
|
await setupDb();
|
|
885
1054
|
await createRbacRoleModel(mongoose.connection).seedDefaults({statements: appStatements});
|
|
@@ -1,9 +1,15 @@
|
|
|
1
1
|
import {describe, expect, it} from "bun:test";
|
|
2
|
+
import {assert} from "chai";
|
|
2
3
|
import mongoose from "mongoose";
|
|
3
4
|
|
|
4
5
|
import {setupDb} from "../tests";
|
|
5
6
|
import {createRbacAuditModel} from "./auditModel";
|
|
6
|
-
import {
|
|
7
|
+
import {
|
|
8
|
+
createRbacRoleModel,
|
|
9
|
+
expandRolePermissions,
|
|
10
|
+
organizationOperatorRole,
|
|
11
|
+
terrenoDefaultRoles,
|
|
12
|
+
} from "./roleModel";
|
|
7
13
|
import {READ_ONLY_ROLE_PERMISSIONS, terrenoStatements} from "./statements";
|
|
8
14
|
|
|
9
15
|
describe("rbac role model", () => {
|
|
@@ -11,6 +17,15 @@ describe("rbac role model", () => {
|
|
|
11
17
|
const names = terrenoDefaultRoles.map((role) => role.name);
|
|
12
18
|
|
|
13
19
|
expect(names).toEqual(["superadmin", "admin", "auditor", "member"]);
|
|
20
|
+
|
|
21
|
+
const admin = terrenoDefaultRoles.find((role) => role.name === "admin");
|
|
22
|
+
assert.isObject(admin?.permissions);
|
|
23
|
+
if (!admin?.permissions || admin.permissions === "*" || "readOnly" in admin.permissions) {
|
|
24
|
+
assert.fail("Expected concrete admin permissions");
|
|
25
|
+
}
|
|
26
|
+
assert.deepEqual(admin.permissions.adminAnnouncementAcknowledgement, ["read"]);
|
|
27
|
+
assert.deepEqual(admin.permissions.adminAnnouncementClickEvent, ["read"]);
|
|
28
|
+
assert.deepEqual(admin.permissions.adminAnnouncementImpression, ["read"]);
|
|
14
29
|
});
|
|
15
30
|
|
|
16
31
|
it("seeds default roles with expanded permissions", async () => {
|
|
@@ -25,12 +40,30 @@ describe("rbac role model", () => {
|
|
|
25
40
|
expect(superadmin.permissions.featureFlag).toContain("list");
|
|
26
41
|
expect(superadmin.permissions.consentForm).toContain("list");
|
|
27
42
|
expect(superadmin.permissions.consentResponse).toEqual(["list", "read"]);
|
|
43
|
+
expect(superadmin.permissions.organization).toContain("list");
|
|
44
|
+
|
|
45
|
+
expect(await RbacRole.findOne({name: "operator"})).toBeNull();
|
|
28
46
|
|
|
29
47
|
const auditor = await RbacRole.findExactlyOne({name: "auditor"});
|
|
30
48
|
expect(auditor.permissions.user).toEqual(["list", "read"]);
|
|
31
49
|
expect(auditor.permissions.rbac).toEqual(["read"]);
|
|
32
50
|
});
|
|
33
51
|
|
|
52
|
+
it("seeds the locked operator role when passed as an extra role", async () => {
|
|
53
|
+
await setupDb();
|
|
54
|
+
const RbacRole = createRbacRoleModel(mongoose.connection);
|
|
55
|
+
await RbacRole.seedDefaults({
|
|
56
|
+
extraRoles: [organizationOperatorRole],
|
|
57
|
+
statements: terrenoStatements,
|
|
58
|
+
});
|
|
59
|
+
|
|
60
|
+
const operator = await RbacRole.findExactlyOne({name: "operator"});
|
|
61
|
+
expect(operator.isLocked).toBe(true);
|
|
62
|
+
expect(operator.permissions.organization).toEqual([...terrenoStatements.organization]);
|
|
63
|
+
expect(operator.permissions.admin).toEqual(["access"]);
|
|
64
|
+
expect(operator.permissions.user).toEqual(["list", "read", "update"]);
|
|
65
|
+
});
|
|
66
|
+
|
|
34
67
|
it("upserts default roles without duplicating", async () => {
|
|
35
68
|
await setupDb();
|
|
36
69
|
const RbacRole = createRbacRoleModel(mongoose.connection);
|
package/src/rbac/roleModel.ts
CHANGED
|
@@ -52,7 +52,7 @@ export {READ_ONLY_ROLE_PERMISSIONS} from "./statements";
|
|
|
52
52
|
* Insert missing default roles. Existing unsealed roles are left unchanged so admin
|
|
53
53
|
* customizations survive process restarts. Sealed roles are refreshed from code.
|
|
54
54
|
*/
|
|
55
|
-
|
|
55
|
+
const upsertSeededRole = async (
|
|
56
56
|
model: RbacRoleModel,
|
|
57
57
|
role: RoleDefinition,
|
|
58
58
|
statements: Statements
|
|
@@ -89,6 +89,18 @@ export const expandRolePermissions = (
|
|
|
89
89
|
readActions: readonly string[] = READ_ACTIONS
|
|
90
90
|
): PermissionSet => expandRolePermissionSpec(spec, statements, readActions);
|
|
91
91
|
|
|
92
|
+
/** Locked platform role seeded only when `createAccess({organizations: true})`. */
|
|
93
|
+
export const organizationOperatorRole: RoleDefinition = {
|
|
94
|
+
displayName: "Operator",
|
|
95
|
+
isLocked: true,
|
|
96
|
+
name: "operator",
|
|
97
|
+
permissions: {
|
|
98
|
+
admin: ["access"],
|
|
99
|
+
organization: ["create", "list", "read", "update", "delete", "manageMembers", "disable"],
|
|
100
|
+
user: ["list", "read", "update"],
|
|
101
|
+
},
|
|
102
|
+
};
|
|
103
|
+
|
|
92
104
|
export const terrenoDefaultRoles: RoleDefinition[] = [
|
|
93
105
|
{
|
|
94
106
|
displayName: "Super Admin",
|
|
@@ -103,6 +115,10 @@ export const terrenoDefaultRoles: RoleDefinition[] = [
|
|
|
103
115
|
name: "admin",
|
|
104
116
|
permissions: {
|
|
105
117
|
admin: ["access"],
|
|
118
|
+
adminAnnouncement: ["read", "write", "writeOwned"],
|
|
119
|
+
adminAnnouncementAcknowledgement: ["read"],
|
|
120
|
+
adminAnnouncementClickEvent: ["read"],
|
|
121
|
+
adminAnnouncementImpression: ["read"],
|
|
106
122
|
configuration: ["read", "update"],
|
|
107
123
|
user: ["create", "list", "read", "update"],
|
|
108
124
|
},
|
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
import {beforeEach, describe, expect, it} from "bun:test";
|
|
2
|
+
import type express from "express";
|
|
3
|
+
import mongoose, {type Model, model, Schema} from "mongoose";
|
|
4
|
+
import type TestAgent from "supertest/lib/agent";
|
|
5
|
+
|
|
6
|
+
import {type UserModel as AuthUserModel, addAuthRoutes, setupAuth} from "../auth";
|
|
7
|
+
import {apiErrorMiddleware} from "../errors";
|
|
8
|
+
import {authAsUser, getBaseServer, setupDb, UserModel} from "../tests";
|
|
9
|
+
import {createAccess} from "./access";
|
|
10
|
+
import {rbacRouter} from "./routes";
|
|
11
|
+
import {type PermissionSet, terrenoStatements} from "./statements";
|
|
12
|
+
import type {AnyTerrenoAccess} from "./types";
|
|
13
|
+
|
|
14
|
+
interface RouteUser {
|
|
15
|
+
admin: boolean;
|
|
16
|
+
email: string;
|
|
17
|
+
roles: string[];
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
const appStatements = {
|
|
21
|
+
...terrenoStatements,
|
|
22
|
+
todo: ["create", "read", "update", "delete", "list"],
|
|
23
|
+
} as const;
|
|
24
|
+
|
|
25
|
+
const allPermissions: PermissionSet = Object.fromEntries(
|
|
26
|
+
Object.entries(appStatements).map(([resource, actions]) => [resource, [...actions]])
|
|
27
|
+
);
|
|
28
|
+
|
|
29
|
+
const getRouteUserModel = (): Model<RouteUser> => {
|
|
30
|
+
const modelName = "RbacRoutesTestUser";
|
|
31
|
+
if (mongoose.models[modelName]) {
|
|
32
|
+
return mongoose.models[modelName] as Model<RouteUser>;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
const schema = new Schema<RouteUser>({
|
|
36
|
+
admin: {default: false, description: "Whether the user is an administrator", type: Boolean},
|
|
37
|
+
email: {description: "The user's email address", required: true, type: String},
|
|
38
|
+
roles: {default: [], description: "The user's RBAC roles", type: [String]},
|
|
39
|
+
});
|
|
40
|
+
|
|
41
|
+
return model<RouteUser>(modelName, schema);
|
|
42
|
+
};
|
|
43
|
+
|
|
44
|
+
const authUserModel = UserModel as unknown as AuthUserModel;
|
|
45
|
+
|
|
46
|
+
const createRequestMutationAccess = (
|
|
47
|
+
access: AnyTerrenoAccess,
|
|
48
|
+
mutate: (request: express.Request) => void
|
|
49
|
+
): AnyTerrenoAccess => ({
|
|
50
|
+
...access,
|
|
51
|
+
middleware: (permissions, options) => {
|
|
52
|
+
const accessMiddleware = access.middleware(permissions, options);
|
|
53
|
+
return (request, response, next) => {
|
|
54
|
+
accessMiddleware(request, response, (error?: unknown) => {
|
|
55
|
+
if (error) {
|
|
56
|
+
next(error);
|
|
57
|
+
return;
|
|
58
|
+
}
|
|
59
|
+
mutate(request);
|
|
60
|
+
next();
|
|
61
|
+
});
|
|
62
|
+
};
|
|
63
|
+
},
|
|
64
|
+
});
|
|
65
|
+
|
|
66
|
+
describe("rbacRouter", () => {
|
|
67
|
+
let app: express.Application;
|
|
68
|
+
let adminAgent: TestAgent;
|
|
69
|
+
let routeUserModel: Model<RouteUser>;
|
|
70
|
+
let targetUserId: string;
|
|
71
|
+
|
|
72
|
+
beforeEach(async () => {
|
|
73
|
+
await setupDb();
|
|
74
|
+
routeUserModel = getRouteUserModel();
|
|
75
|
+
await routeUserModel.deleteMany({});
|
|
76
|
+
const targetUser = await routeUserModel.create({
|
|
77
|
+
email: "target@example.com",
|
|
78
|
+
roles: ["member"],
|
|
79
|
+
});
|
|
80
|
+
targetUserId = targetUser.id;
|
|
81
|
+
|
|
82
|
+
const access = createAccess({
|
|
83
|
+
connection: mongoose.connection,
|
|
84
|
+
resolvePermissions: async ({user}) => (user.admin ? allPermissions : {}),
|
|
85
|
+
statements: appStatements,
|
|
86
|
+
userModel: routeUserModel as unknown as AuthUserModel,
|
|
87
|
+
});
|
|
88
|
+
await access.roles.seedDefaults();
|
|
89
|
+
|
|
90
|
+
app = getBaseServer();
|
|
91
|
+
setupAuth(app, authUserModel);
|
|
92
|
+
addAuthRoutes(app, authUserModel);
|
|
93
|
+
rbacRouter({
|
|
94
|
+
access,
|
|
95
|
+
basePath: "/rbac",
|
|
96
|
+
userModel: routeUserModel as unknown as AuthUserModel,
|
|
97
|
+
}).register(app);
|
|
98
|
+
rbacRouter({
|
|
99
|
+
access: createRequestMutationAccess(access, (request) => {
|
|
100
|
+
request.user = undefined;
|
|
101
|
+
}),
|
|
102
|
+
basePath: "/rbac-unauthorized",
|
|
103
|
+
userModel: routeUserModel as unknown as AuthUserModel,
|
|
104
|
+
}).register(app);
|
|
105
|
+
rbacRouter({
|
|
106
|
+
access: createRequestMutationAccess(access, (request) => {
|
|
107
|
+
Reflect.deleteProperty(request.params, "id");
|
|
108
|
+
Reflect.deleteProperty(request.params, "name");
|
|
109
|
+
}),
|
|
110
|
+
basePath: "/rbac-invalid-params",
|
|
111
|
+
userModel: routeUserModel as unknown as AuthUserModel,
|
|
112
|
+
}).register(app);
|
|
113
|
+
app.use(apiErrorMiddleware);
|
|
114
|
+
|
|
115
|
+
adminAgent = await authAsUser(app, "admin");
|
|
116
|
+
});
|
|
117
|
+
|
|
118
|
+
it("serves statements and supports role and user operations", async () => {
|
|
119
|
+
const statementsResponse = await adminAgent.get("/rbac/statements").expect(200);
|
|
120
|
+
expect(statementsResponse.body.data.statements.rbac).toEqual([
|
|
121
|
+
"read",
|
|
122
|
+
"manageRoles",
|
|
123
|
+
"assignRoles",
|
|
124
|
+
]);
|
|
125
|
+
|
|
126
|
+
const rolesResponse = await adminAgent.get("/rbac/roles").expect(200);
|
|
127
|
+
expect(rolesResponse.body.data.map((role: {name: string}) => role.name)).toEqual(
|
|
128
|
+
expect.arrayContaining(["superadmin", "member"])
|
|
129
|
+
);
|
|
130
|
+
|
|
131
|
+
const createResponse = await adminAgent
|
|
132
|
+
.post("/rbac/roles")
|
|
133
|
+
.send({
|
|
134
|
+
displayName: "Route Editor",
|
|
135
|
+
name: "route-editor",
|
|
136
|
+
permissions: {todo: ["read"]},
|
|
137
|
+
})
|
|
138
|
+
.expect(201);
|
|
139
|
+
expect(createResponse.body.data.name).toBe("route-editor");
|
|
140
|
+
|
|
141
|
+
const updateResponse = await adminAgent
|
|
142
|
+
.patch("/rbac/roles/route-editor")
|
|
143
|
+
.send({displayName: "Updated Route Editor"})
|
|
144
|
+
.expect(200);
|
|
145
|
+
expect(updateResponse.body.data.displayName).toBe("Updated Route Editor");
|
|
146
|
+
|
|
147
|
+
const rolePreviewResponse = await adminAgent
|
|
148
|
+
.post("/rbac/roles/route-editor/preview")
|
|
149
|
+
.send({permissions: {todo: ["read", "update"]}})
|
|
150
|
+
.expect(200);
|
|
151
|
+
expect(rolePreviewResponse.body.data.gained.todo).toEqual(["update"]);
|
|
152
|
+
|
|
153
|
+
const permissionsResponse = await adminAgent
|
|
154
|
+
.get(`/rbac/users/${targetUserId}/permissions`)
|
|
155
|
+
.expect(200);
|
|
156
|
+
expect(permissionsResponse.body.data.roles).toEqual(["member"]);
|
|
157
|
+
|
|
158
|
+
await adminAgent
|
|
159
|
+
.put(`/rbac/users/${targetUserId}/roles`)
|
|
160
|
+
.send({roleNames: ["auditor"]})
|
|
161
|
+
.expect(200);
|
|
162
|
+
const assignedUser = await routeUserModel.findById(targetUserId);
|
|
163
|
+
expect(assignedUser?.roles).toEqual(["auditor"]);
|
|
164
|
+
|
|
165
|
+
const assignmentPreviewResponse = await adminAgent
|
|
166
|
+
.post(`/rbac/users/${targetUserId}/roles/preview`)
|
|
167
|
+
.send({roleNames: ["member"]})
|
|
168
|
+
.expect(200);
|
|
169
|
+
expect(assignmentPreviewResponse.body.data).toHaveProperty("gained");
|
|
170
|
+
|
|
171
|
+
await adminAgent.delete("/rbac/roles/route-editor").expect(204);
|
|
172
|
+
});
|
|
173
|
+
|
|
174
|
+
it("returns unauthorized when a handler has no actor", async () => {
|
|
175
|
+
const actorlessRoutes = [
|
|
176
|
+
{body: {}, method: "post", path: "/rbac-unauthorized/roles"},
|
|
177
|
+
{body: {}, method: "patch", path: "/rbac-unauthorized/roles/member"},
|
|
178
|
+
{method: "delete", path: "/rbac-unauthorized/roles/member"},
|
|
179
|
+
{
|
|
180
|
+
body: {roleNames: ["member"]},
|
|
181
|
+
method: "put",
|
|
182
|
+
path: `/rbac-unauthorized/users/${targetUserId}/roles`,
|
|
183
|
+
},
|
|
184
|
+
] as const;
|
|
185
|
+
|
|
186
|
+
for (const route of actorlessRoutes) {
|
|
187
|
+
const response =
|
|
188
|
+
route.method === "post"
|
|
189
|
+
? await adminAgent.post(route.path).send(route.body)
|
|
190
|
+
: route.method === "patch"
|
|
191
|
+
? await adminAgent.patch(route.path).send(route.body)
|
|
192
|
+
: route.method === "put"
|
|
193
|
+
? await adminAgent.put(route.path).send(route.body)
|
|
194
|
+
: await adminAgent.delete(route.path);
|
|
195
|
+
expect(response.status).toBe(401);
|
|
196
|
+
expect(response.body.title).toBe("Unauthorized");
|
|
197
|
+
}
|
|
198
|
+
});
|
|
199
|
+
|
|
200
|
+
it("validates missing route parameters", async () => {
|
|
201
|
+
const roleResponse = await adminAgent
|
|
202
|
+
.patch("/rbac-invalid-params/roles/member")
|
|
203
|
+
.send({displayName: "Missing Name"});
|
|
204
|
+
expect(roleResponse.status).toBe(400);
|
|
205
|
+
expect(roleResponse.body.title).toBe("Role name is required");
|
|
206
|
+
|
|
207
|
+
const userResponse = await adminAgent.get(
|
|
208
|
+
`/rbac-invalid-params/users/${targetUserId}/permissions`
|
|
209
|
+
);
|
|
210
|
+
expect(userResponse.status).toBe(400);
|
|
211
|
+
expect(userResponse.body.title).toBe("User id is required");
|
|
212
|
+
});
|
|
213
|
+
|
|
214
|
+
it("validates role assignment bodies and missing users", async () => {
|
|
215
|
+
const missingRoleNamesResponse = await adminAgent
|
|
216
|
+
.put(`/rbac/users/${targetUserId}/roles`)
|
|
217
|
+
.send({});
|
|
218
|
+
expect(missingRoleNamesResponse.status).toBe(400);
|
|
219
|
+
expect(missingRoleNamesResponse.body.title).toBe("roleNames is required");
|
|
220
|
+
|
|
221
|
+
const missingPreviewRoleNamesResponse = await adminAgent
|
|
222
|
+
.post(`/rbac/users/${targetUserId}/roles/preview`)
|
|
223
|
+
.send({});
|
|
224
|
+
expect(missingPreviewRoleNamesResponse.status).toBe(400);
|
|
225
|
+
expect(missingPreviewRoleNamesResponse.body.title).toBe("roleNames is required");
|
|
226
|
+
|
|
227
|
+
const missingUserResponse = await adminAgent.get(
|
|
228
|
+
`/rbac/users/${new mongoose.Types.ObjectId()}/permissions`
|
|
229
|
+
);
|
|
230
|
+
expect(missingUserResponse.status).toBe(404);
|
|
231
|
+
expect(missingUserResponse.body.title).toBe("User not found");
|
|
232
|
+
});
|
|
233
|
+
});
|