@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
|
@@ -0,0 +1,283 @@
|
|
|
1
|
+
import type express from "express";
|
|
2
|
+
import mongoose from "mongoose";
|
|
3
|
+
|
|
4
|
+
import type {ModelRouterOptions} from "../api";
|
|
5
|
+
import type {User} from "../auth";
|
|
6
|
+
import {APIError} from "../errors";
|
|
7
|
+
import {checkPermissions, type PermissionMethod} from "../permissions";
|
|
8
|
+
import {findOneOrNoneFor} from "../plugins";
|
|
9
|
+
import type {AnyTerrenoAccess} from "../rbac/types";
|
|
10
|
+
import {canUseAdminBroadcastWindow} from "./adminWindowAccess";
|
|
11
|
+
import type {SyncRegistryEntry} from "./registry";
|
|
12
|
+
import type {SyncAppOptions} from "./routes";
|
|
13
|
+
import type {SyncMutateRequest, SyncMutationOperation} from "./types";
|
|
14
|
+
|
|
15
|
+
export interface AdminWindowMutationAuditEvent {
|
|
16
|
+
actorId?: string;
|
|
17
|
+
/** Serialized document after the successful mutation. */
|
|
18
|
+
doc?: Record<string, unknown>;
|
|
19
|
+
modelName: string;
|
|
20
|
+
recordId?: string;
|
|
21
|
+
recordLabel?: string;
|
|
22
|
+
verb: "created" | "deleted" | "updated";
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
export interface AdminWindowMutationScopeHooks {
|
|
26
|
+
preCreate?: ModelRouterOptions<unknown>["preCreate"];
|
|
27
|
+
preUpdate?: ModelRouterOptions<unknown>["preUpdate"];
|
|
28
|
+
preDelete?: ModelRouterOptions<unknown>["preDelete"];
|
|
29
|
+
postCreate?: ModelRouterOptions<unknown>["postCreate"];
|
|
30
|
+
postUpdate?: ModelRouterOptions<unknown>["postUpdate"];
|
|
31
|
+
postDelete?: ModelRouterOptions<unknown>["postDelete"];
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export interface AdminWindowMutationScope extends AdminWindowMutationScopeHooks {
|
|
35
|
+
/** RBAC access used by AdminApp User admin-flag and role assignment hooks. */
|
|
36
|
+
accessControl?: AnyTerrenoAccess;
|
|
37
|
+
modelName: string;
|
|
38
|
+
permissions: {create: boolean; update: boolean; delete: boolean};
|
|
39
|
+
createPermissions: PermissionMethod<unknown>[];
|
|
40
|
+
updatePermissions: PermissionMethod<unknown>[];
|
|
41
|
+
deletePermissions: PermissionMethod<unknown>[];
|
|
42
|
+
stripMutationData: (data: Record<string, unknown>) => Record<string, unknown>;
|
|
43
|
+
/** Legacy standalone audit callback; prefer `postCreate` / `postUpdate` / `postDelete`. */
|
|
44
|
+
emitAudit?: (args: {
|
|
45
|
+
event: AdminWindowMutationAuditEvent;
|
|
46
|
+
req: express.Request;
|
|
47
|
+
}) => void | Promise<void>;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/** Coalesce `req.user.id` and `req.user._id` to match Admin REST audit actor ids. */
|
|
51
|
+
export const auditActorIdFromRequest = (req: express.Request): string | undefined => {
|
|
52
|
+
const actor = req.user as {id?: unknown; _id?: unknown} | undefined;
|
|
53
|
+
if (!actor) {
|
|
54
|
+
return undefined;
|
|
55
|
+
}
|
|
56
|
+
if (actor.id != null) {
|
|
57
|
+
return String(actor.id);
|
|
58
|
+
}
|
|
59
|
+
if (actor._id != null) {
|
|
60
|
+
return String(actor._id);
|
|
61
|
+
}
|
|
62
|
+
return undefined;
|
|
63
|
+
};
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* Admin-window sync mutations use AdminApp router pre/post hooks, not product `modelRouter`
|
|
67
|
+
* hooks. Product hooks can overwrite stripped or admin-authorized fields (for example by
|
|
68
|
+
* forcing `ownerId` in `preCreate`).
|
|
69
|
+
*/
|
|
70
|
+
export const buildAdminWindowExecutorOptions = <T>({
|
|
71
|
+
productOptions,
|
|
72
|
+
scope,
|
|
73
|
+
}: {
|
|
74
|
+
productOptions: ModelRouterOptions<T>;
|
|
75
|
+
scope: AdminWindowMutationScope;
|
|
76
|
+
}): ModelRouterOptions<T> => ({
|
|
77
|
+
...productOptions,
|
|
78
|
+
accessControl: scope.accessControl ?? productOptions.accessControl,
|
|
79
|
+
postCreate: scope.postCreate as ModelRouterOptions<T>["postCreate"],
|
|
80
|
+
postDelete: scope.postDelete as ModelRouterOptions<T>["postDelete"],
|
|
81
|
+
postUpdate: scope.postUpdate as ModelRouterOptions<T>["postUpdate"],
|
|
82
|
+
preCreate: scope.preCreate as ModelRouterOptions<T>["preCreate"],
|
|
83
|
+
preDelete: scope.preDelete as ModelRouterOptions<T>["preDelete"],
|
|
84
|
+
preUpdate: scope.preUpdate as ModelRouterOptions<T>["preUpdate"],
|
|
85
|
+
});
|
|
86
|
+
|
|
87
|
+
/** Ensure `req.params.id` is set for AdminApp update/delete hooks (User admin-flag gates). */
|
|
88
|
+
export const withAdminWindowMutationRequestContext = ({
|
|
89
|
+
mutation,
|
|
90
|
+
req,
|
|
91
|
+
}: {
|
|
92
|
+
mutation: SyncMutateRequest;
|
|
93
|
+
req: express.Request;
|
|
94
|
+
}): express.Request => {
|
|
95
|
+
if (mutation.operation === "create" || mutation.id == null) {
|
|
96
|
+
return req;
|
|
97
|
+
}
|
|
98
|
+
const params = {...(req.params ?? {}), id: mutation.id};
|
|
99
|
+
return Object.assign(req, {params}) as express.Request;
|
|
100
|
+
};
|
|
101
|
+
|
|
102
|
+
const adminWindowMutationScopes = new Map<string, AdminWindowMutationScope>();
|
|
103
|
+
|
|
104
|
+
export const registerAdminWindowMutationScope = (
|
|
105
|
+
modelName: string,
|
|
106
|
+
scope: AdminWindowMutationScope
|
|
107
|
+
): void => {
|
|
108
|
+
adminWindowMutationScopes.set(modelName, scope);
|
|
109
|
+
};
|
|
110
|
+
|
|
111
|
+
export const getAdminWindowMutationScope = (
|
|
112
|
+
modelName: string
|
|
113
|
+
): AdminWindowMutationScope | undefined => adminWindowMutationScopes.get(modelName);
|
|
114
|
+
|
|
115
|
+
export const clearAdminWindowMutationScopes = (): void => {
|
|
116
|
+
adminWindowMutationScopes.clear();
|
|
117
|
+
};
|
|
118
|
+
|
|
119
|
+
const operationEnabled = (
|
|
120
|
+
scope: AdminWindowMutationScope,
|
|
121
|
+
operation: SyncMutationOperation
|
|
122
|
+
): boolean => {
|
|
123
|
+
if (operation === "create") {
|
|
124
|
+
return scope.permissions.create;
|
|
125
|
+
}
|
|
126
|
+
if (operation === "update") {
|
|
127
|
+
return scope.permissions.update;
|
|
128
|
+
}
|
|
129
|
+
return scope.permissions.delete;
|
|
130
|
+
};
|
|
131
|
+
|
|
132
|
+
const permissionsForOperation = (
|
|
133
|
+
scope: AdminWindowMutationScope,
|
|
134
|
+
operation: SyncMutationOperation
|
|
135
|
+
): PermissionMethod<unknown>[] => {
|
|
136
|
+
if (operation === "create") {
|
|
137
|
+
return scope.createPermissions;
|
|
138
|
+
}
|
|
139
|
+
if (operation === "update") {
|
|
140
|
+
return scope.updatePermissions;
|
|
141
|
+
}
|
|
142
|
+
return scope.deletePermissions;
|
|
143
|
+
};
|
|
144
|
+
|
|
145
|
+
const loadInstance = async ({
|
|
146
|
+
entry,
|
|
147
|
+
id,
|
|
148
|
+
}: {
|
|
149
|
+
entry: SyncRegistryEntry;
|
|
150
|
+
id: string;
|
|
151
|
+
}): Promise<unknown> => {
|
|
152
|
+
const model = mongoose.model(entry.modelName);
|
|
153
|
+
return findOneOrNoneFor(model, {_id: id, deleted: {$in: [true, false]}});
|
|
154
|
+
};
|
|
155
|
+
|
|
156
|
+
/**
|
|
157
|
+
* Validates an explicit `mutationMode: "adminWindow"` marker and applies AdminApp write
|
|
158
|
+
* semantics before the product sync executor runs. Returns the mutation with stripped
|
|
159
|
+
* data, or `undefined` when the request stays on the product path.
|
|
160
|
+
*
|
|
161
|
+
* The marker alone is never trusted: callers must also have admin-window access, the
|
|
162
|
+
* collection must be `adminBroadcast`, and AdminApp must have registered a write scope.
|
|
163
|
+
*/
|
|
164
|
+
export const prepareAdminWindowMutation = async ({
|
|
165
|
+
entry,
|
|
166
|
+
mutation,
|
|
167
|
+
req: _req,
|
|
168
|
+
syncOptions,
|
|
169
|
+
user,
|
|
170
|
+
}: {
|
|
171
|
+
entry: SyncRegistryEntry;
|
|
172
|
+
mutation: SyncMutateRequest;
|
|
173
|
+
req: express.Request;
|
|
174
|
+
syncOptions?: SyncAppOptions;
|
|
175
|
+
user: User;
|
|
176
|
+
}): Promise<{mutation: SyncMutateRequest; scope: AdminWindowMutationScope} | undefined> => {
|
|
177
|
+
if (mutation.mutationMode !== "adminWindow") {
|
|
178
|
+
return undefined;
|
|
179
|
+
}
|
|
180
|
+
if (!entry.config.adminBroadcast) {
|
|
181
|
+
throw new APIError({
|
|
182
|
+
status: 403,
|
|
183
|
+
title: "Admin window mutations require an adminBroadcast collection",
|
|
184
|
+
});
|
|
185
|
+
}
|
|
186
|
+
if (
|
|
187
|
+
!(await canUseAdminBroadcastWindow({
|
|
188
|
+
accessControl: syncOptions?.accessControl,
|
|
189
|
+
canOpenAdminWindow: syncOptions?.canOpenAdminWindow,
|
|
190
|
+
user,
|
|
191
|
+
}))
|
|
192
|
+
) {
|
|
193
|
+
throw new APIError({status: 403, title: "Admin window access required"});
|
|
194
|
+
}
|
|
195
|
+
const scope = getAdminWindowMutationScope(entry.modelName);
|
|
196
|
+
if (!scope) {
|
|
197
|
+
throw new APIError({
|
|
198
|
+
status: 403,
|
|
199
|
+
title: "Admin window mutations are not registered for this collection",
|
|
200
|
+
});
|
|
201
|
+
}
|
|
202
|
+
if (!operationEnabled(scope, mutation.operation)) {
|
|
203
|
+
throw new APIError({
|
|
204
|
+
status: 403,
|
|
205
|
+
title: `${mutation.operation} is disabled for this admin model`,
|
|
206
|
+
});
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
let instance: unknown;
|
|
210
|
+
if (mutation.operation !== "create") {
|
|
211
|
+
if (!mutation.id) {
|
|
212
|
+
throw new APIError({
|
|
213
|
+
status: 400,
|
|
214
|
+
title: `id is required for ${mutation.operation} mutations`,
|
|
215
|
+
});
|
|
216
|
+
}
|
|
217
|
+
instance = await loadInstance({entry, id: mutation.id});
|
|
218
|
+
if (!instance && mutation.operation === "update") {
|
|
219
|
+
throw new APIError({status: 404, title: "Not found"});
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
|
|
223
|
+
const permissionMethod =
|
|
224
|
+
mutation.operation === "create"
|
|
225
|
+
? "create"
|
|
226
|
+
: mutation.operation === "update"
|
|
227
|
+
? "update"
|
|
228
|
+
: "delete";
|
|
229
|
+
const permissionInstance =
|
|
230
|
+
mutation.operation === "create" ? (mutation.data as unknown) : instance;
|
|
231
|
+
if (
|
|
232
|
+
!(await checkPermissions(
|
|
233
|
+
permissionMethod,
|
|
234
|
+
permissionsForOperation(scope, mutation.operation),
|
|
235
|
+
user,
|
|
236
|
+
permissionInstance
|
|
237
|
+
))
|
|
238
|
+
) {
|
|
239
|
+
throw new APIError({status: 403, title: "Admin write access denied"});
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
if (mutation.operation === "delete" || !mutation.data) {
|
|
243
|
+
return {mutation, scope};
|
|
244
|
+
}
|
|
245
|
+
return {
|
|
246
|
+
mutation: {...mutation, data: scope.stripMutationData(mutation.data)},
|
|
247
|
+
scope,
|
|
248
|
+
};
|
|
249
|
+
};
|
|
250
|
+
|
|
251
|
+
export const emitAdminWindowMutationAudit = async ({
|
|
252
|
+
doc,
|
|
253
|
+
mutation,
|
|
254
|
+
req,
|
|
255
|
+
scope,
|
|
256
|
+
}: {
|
|
257
|
+
doc: mongoose.Document;
|
|
258
|
+
mutation: SyncMutateRequest;
|
|
259
|
+
req: express.Request;
|
|
260
|
+
scope: AdminWindowMutationScope;
|
|
261
|
+
}): Promise<void> => {
|
|
262
|
+
if (!scope.emitAudit) {
|
|
263
|
+
return;
|
|
264
|
+
}
|
|
265
|
+
const plain = doc.toObject() as Record<string, unknown>;
|
|
266
|
+
const recordId = plain._id != null ? String(plain._id) : mutation.id;
|
|
267
|
+
const verb =
|
|
268
|
+
mutation.operation === "create"
|
|
269
|
+
? "created"
|
|
270
|
+
: mutation.operation === "delete"
|
|
271
|
+
? "deleted"
|
|
272
|
+
: "updated";
|
|
273
|
+
await scope.emitAudit({
|
|
274
|
+
event: {
|
|
275
|
+
actorId: auditActorIdFromRequest(req),
|
|
276
|
+
doc: plain,
|
|
277
|
+
modelName: scope.modelName,
|
|
278
|
+
recordId,
|
|
279
|
+
verb,
|
|
280
|
+
},
|
|
281
|
+
req,
|
|
282
|
+
});
|
|
283
|
+
};
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import {describe, expect, it} from "bun:test";
|
|
2
|
+
import {DateTime} from "luxon";
|
|
3
|
+
|
|
4
|
+
import {docMatchesMutationData} from "./mutationHandler";
|
|
5
|
+
|
|
6
|
+
describe("docMatchesMutationData date compare", () => {
|
|
7
|
+
it("treats date-only ISO strings as UTC midnight like Date parsing", () => {
|
|
8
|
+
const stored = DateTime.fromISO("2024-01-15T00:00:00.000Z", {zone: "utc"}).toJSDate();
|
|
9
|
+
expect(docMatchesMutationData({due: stored}, {due: "2024-01-15"})).toBe(true);
|
|
10
|
+
});
|
|
11
|
+
|
|
12
|
+
it("returns false for invalid date strings instead of throwing", () => {
|
|
13
|
+
const stored = DateTime.fromISO("2024-01-15T00:00:00.000Z", {zone: "utc"}).toJSDate();
|
|
14
|
+
expect(docMatchesMutationData({due: stored}, {due: "not-a-date"})).toBe(false);
|
|
15
|
+
});
|
|
16
|
+
});
|
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
// noExplicitAny: test model typing
|
|
2
|
-
// biome-ignore-all lint/suspicious/noExplicitAny: test model typing
|
|
3
1
|
import {beforeEach, describe, expect, it} from "bun:test";
|
|
2
|
+
import {assert} from "chai";
|
|
4
3
|
import express from "express";
|
|
5
4
|
import {model, Schema} from "mongoose";
|
|
6
5
|
import type {ModelRouterOptions} from "../api";
|
|
6
|
+
import {APIError} from "../errors";
|
|
7
7
|
import {Permissions} from "../permissions";
|
|
8
8
|
import {createdUpdatedPlugin, type IsDeleted, isDeletedPlugin} from "../plugins";
|
|
9
9
|
import {setupDb} from "../tests";
|
|
@@ -21,7 +21,8 @@ import {syncPlugin} from "./syncSeqPlugin";
|
|
|
21
21
|
* (`SyncCounter.stream` / `SyncMutation.mutationId` uniques, the scope-move lookups,
|
|
22
22
|
* `SyncKey.userId`), so they exist after startup without any manual `ensureIndexes()`
|
|
23
23
|
* call — without the unique indexes, duplicate mutation deliveries double-apply and the
|
|
24
|
-
* counter upsert race mints duplicate seqs.
|
|
24
|
+
* counter upsert race mints duplicate seqs. Index work must remain deferred until this
|
|
25
|
+
* function runs because model registration can happen before MongoDB connects.
|
|
25
26
|
*/
|
|
26
27
|
|
|
27
28
|
interface IndexTodo extends IsDeleted {
|
|
@@ -50,7 +51,7 @@ const authedOptions = {
|
|
|
50
51
|
read: [Permissions.IsAuthenticated],
|
|
51
52
|
update: [Permissions.IsAuthenticated],
|
|
52
53
|
},
|
|
53
|
-
} as unknown as ModelRouterOptions<
|
|
54
|
+
} as unknown as ModelRouterOptions<IndexTodo>;
|
|
54
55
|
|
|
55
56
|
describe("ensureSyncIndexes (C8)", () => {
|
|
56
57
|
beforeEach(() => {
|
|
@@ -65,28 +66,58 @@ describe("ensureSyncIndexes (C8)", () => {
|
|
|
65
66
|
const IndexTodoModel = buildModel("EnsureIndexTodoOk");
|
|
66
67
|
registerSync({
|
|
67
68
|
config: {scope: {type: "owner"}},
|
|
68
|
-
model: IndexTodoModel
|
|
69
|
+
model: IndexTodoModel,
|
|
69
70
|
options: authedOptions,
|
|
70
71
|
routePath: "/ensureIndexTodosOk",
|
|
71
72
|
});
|
|
72
73
|
await expect(ensureSyncIndexes()).resolves.toBeUndefined();
|
|
73
74
|
});
|
|
74
75
|
|
|
76
|
+
it("defers snapshot index creation until startup ensures indexes", async () => {
|
|
77
|
+
const IndexTodoModel = buildModel("EnsureIndexTodoDeferred");
|
|
78
|
+
let createIndexCalls = 0;
|
|
79
|
+
IndexTodoModel.collection.createIndex = async (): Promise<string> => {
|
|
80
|
+
createIndexCalls += 1;
|
|
81
|
+
return "ownerId_1__syncSeq_1";
|
|
82
|
+
};
|
|
83
|
+
|
|
84
|
+
registerSync({
|
|
85
|
+
config: {scope: {type: "owner"}},
|
|
86
|
+
model: IndexTodoModel,
|
|
87
|
+
options: authedOptions,
|
|
88
|
+
routePath: "/ensureIndexTodosDeferred",
|
|
89
|
+
});
|
|
90
|
+
|
|
91
|
+
assert.strictEqual(createIndexCalls, 0);
|
|
92
|
+
await ensureSyncIndexes();
|
|
93
|
+
assert.strictEqual(createIndexCalls, 1);
|
|
94
|
+
});
|
|
95
|
+
|
|
75
96
|
it("rejects with an actionable error when createIndex fails, so startup fails loudly", async () => {
|
|
76
97
|
const IndexTodoModel = buildModel("EnsureIndexTodoFail");
|
|
98
|
+
const sentinel = new Error("boom-sentinel-snapshot-index");
|
|
77
99
|
// Force the collection's createIndex to reject, simulating a DB/schema failure.
|
|
78
|
-
|
|
79
|
-
throw
|
|
100
|
+
IndexTodoModel.collection.createIndex = async (): Promise<string> => {
|
|
101
|
+
throw sentinel;
|
|
80
102
|
};
|
|
81
103
|
registerSync({
|
|
82
104
|
config: {scope: {type: "owner"}},
|
|
83
|
-
model: IndexTodoModel
|
|
105
|
+
model: IndexTodoModel,
|
|
84
106
|
options: authedOptions,
|
|
85
107
|
routePath: "/ensureIndexTodosFail",
|
|
86
108
|
});
|
|
87
|
-
|
|
109
|
+
const rejection = ensureSyncIndexes();
|
|
110
|
+
await expect(rejection).rejects.toThrow(
|
|
88
111
|
/Failed to create sync snapshot index for EnsureIndexTodoFail/
|
|
89
112
|
);
|
|
113
|
+
const error = await rejection.catch((caught: unknown) => caught);
|
|
114
|
+
expect(error).toBeInstanceOf(APIError);
|
|
115
|
+
const apiError = error as APIError;
|
|
116
|
+
expect(apiError.code).toBe("sync-snapshot-index-failed");
|
|
117
|
+
expect(apiError.cause).toBe(sentinel);
|
|
118
|
+
expect(apiError.status).toBe(500);
|
|
119
|
+
expect(apiError.message).not.toContain(sentinel.message);
|
|
120
|
+
expect(apiError.detail).toContain(sentinel.message);
|
|
90
121
|
});
|
|
91
122
|
});
|
|
92
123
|
|
|
@@ -129,16 +160,24 @@ describe("sync bookkeeping indexes at startup (Task 9.9)", () => {
|
|
|
129
160
|
|
|
130
161
|
it("rejects with an actionable error when a bookkeeping index build fails", async () => {
|
|
131
162
|
const originalEnsure = SyncMutation.ensureIndexes.bind(SyncMutation);
|
|
132
|
-
|
|
133
|
-
|
|
163
|
+
const sentinel = new Error("boom-sentinel-mutation-index");
|
|
164
|
+
SyncMutation.ensureIndexes = async (): Promise<void> => {
|
|
165
|
+
throw sentinel;
|
|
134
166
|
};
|
|
135
167
|
try {
|
|
136
168
|
new SyncApp().register(express());
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
);
|
|
169
|
+
const rejection = ensureSyncIndexes();
|
|
170
|
+
await expect(rejection).rejects.toThrow(/Failed to ensure sync indexes for SyncMutation/);
|
|
171
|
+
const error = await rejection.catch((caught: unknown) => caught);
|
|
172
|
+
expect(error).toBeInstanceOf(APIError);
|
|
173
|
+
const apiError = error as APIError;
|
|
174
|
+
expect(apiError.code).toBe("sync-indexes-failed");
|
|
175
|
+
expect(apiError.cause).toBe(sentinel);
|
|
176
|
+
expect(apiError.status).toBe(500);
|
|
177
|
+
expect(apiError.message).not.toContain(sentinel.message);
|
|
178
|
+
expect(apiError.detail).toContain(sentinel.message);
|
|
140
179
|
} finally {
|
|
141
|
-
|
|
180
|
+
SyncMutation.ensureIndexes = originalEnsure;
|
|
142
181
|
}
|
|
143
182
|
});
|
|
144
183
|
});
|
|
@@ -59,6 +59,17 @@ const execHardSchema = new Schema<ExecHardStuff>({
|
|
|
59
59
|
});
|
|
60
60
|
const ExecHardModel = model<ExecHardStuff>("ExecHardStuff", execHardSchema);
|
|
61
61
|
|
|
62
|
+
interface ExecUserish {
|
|
63
|
+
email: string;
|
|
64
|
+
roles?: string[];
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
const execUserishSchema = new Schema<ExecUserish>({
|
|
68
|
+
email: {description: "Login email", required: true, type: String},
|
|
69
|
+
roles: {description: "Authority-bearing roles stripped after hooks", type: [String]},
|
|
70
|
+
});
|
|
71
|
+
const ExecUserishModel = model<ExecUserish>("ExecUserish", execUserishSchema);
|
|
72
|
+
|
|
62
73
|
const owner = {_id: "u-owner", admin: false, id: "u-owner"} as unknown as User;
|
|
63
74
|
const stranger = {_id: "u-stranger", admin: false, id: "u-stranger"} as unknown as User;
|
|
64
75
|
|
|
@@ -133,6 +144,35 @@ describe("executeCreate", () => {
|
|
|
133
144
|
expect(error.title).toContain("Access to CREATE on ExecStuff");
|
|
134
145
|
});
|
|
135
146
|
|
|
147
|
+
it("strips User roles after preCreate when writeModelName is User", async () => {
|
|
148
|
+
await ExecUserishModel.deleteMany({});
|
|
149
|
+
let seenRoles: unknown;
|
|
150
|
+
const {doc} = await executeCreate<ExecUserish>({
|
|
151
|
+
body: {email: "exec-roles@example.com", roles: ["superadmin"]},
|
|
152
|
+
model: ExecUserishModel,
|
|
153
|
+
options: {
|
|
154
|
+
accessControl: {} as never,
|
|
155
|
+
permissions: {
|
|
156
|
+
create: [Permissions.IsAuthenticated],
|
|
157
|
+
delete: [],
|
|
158
|
+
list: [],
|
|
159
|
+
read: [],
|
|
160
|
+
update: [],
|
|
161
|
+
},
|
|
162
|
+
preCreate: (body) => {
|
|
163
|
+
seenRoles = (body as ExecUserish).roles;
|
|
164
|
+
return body;
|
|
165
|
+
},
|
|
166
|
+
} as ModelRouterOptions<ExecUserish>,
|
|
167
|
+
user: owner,
|
|
168
|
+
writeModelName: "User",
|
|
169
|
+
});
|
|
170
|
+
assert.deepEqual(seenRoles, ["superadmin"]);
|
|
171
|
+
assert.deepEqual(doc.roles ?? [], []);
|
|
172
|
+
const stored = await ExecUserishModel.findById(doc._id).lean();
|
|
173
|
+
assert.deepEqual(stored?.roles ?? [], []);
|
|
174
|
+
});
|
|
175
|
+
|
|
136
176
|
it("passes a {user} stub request to preCreate when no req is provided", async () => {
|
|
137
177
|
const options = baseOptions({
|
|
138
178
|
preCreate: (body, request) => ({
|
package/src/sync/executors.ts
CHANGED
|
@@ -184,7 +184,9 @@ export const executeCreate = async <T>({
|
|
|
184
184
|
user,
|
|
185
185
|
body,
|
|
186
186
|
req,
|
|
187
|
+
skipPermissionChecks,
|
|
187
188
|
skipPostHooks,
|
|
189
|
+
writeModelName,
|
|
188
190
|
}: {
|
|
189
191
|
model: Model<T>;
|
|
190
192
|
options: ModelRouterOptions<T>;
|
|
@@ -192,6 +194,11 @@ export const executeCreate = async <T>({
|
|
|
192
194
|
body: unknown;
|
|
193
195
|
/** The real Express request when called over HTTP; hooks receive a `{user}` stub otherwise. */
|
|
194
196
|
req?: express.Request;
|
|
197
|
+
/**
|
|
198
|
+
* Name used for User-role stripping after hooks. Defaults to `model.modelName`.
|
|
199
|
+
* MCP passes the registry `modelName` because compiled mongoose names can differ.
|
|
200
|
+
*/
|
|
201
|
+
writeModelName?: string;
|
|
195
202
|
/**
|
|
196
203
|
* C5 (FIX 6): when true, skip the built-in `postCreate` call — the caller
|
|
197
204
|
* (the sync mutation handler) runs it manually AFTER finalizing the
|
|
@@ -199,10 +206,15 @@ export const executeCreate = async <T>({
|
|
|
199
206
|
* committed write look like a failure. REST handlers never set this.
|
|
200
207
|
*/
|
|
201
208
|
skipPostHooks?: boolean;
|
|
209
|
+
/** When true, skip modelRouter permission checks (admin-window sync mutations). */
|
|
210
|
+
skipPermissionChecks?: boolean;
|
|
202
211
|
}): Promise<ExecutorResult<T>> => {
|
|
203
212
|
const request = req ?? stubRequest(user);
|
|
204
213
|
|
|
205
|
-
if (
|
|
214
|
+
if (
|
|
215
|
+
!skipPermissionChecks &&
|
|
216
|
+
!(await checkPermissions("create", options.permissions.create, user))
|
|
217
|
+
) {
|
|
206
218
|
throw new APIError({
|
|
207
219
|
status: 405,
|
|
208
220
|
title: `Access to CREATE on ${model.modelName} denied for ${user?.id}`,
|
|
@@ -245,7 +257,7 @@ export const executeCreate = async <T>({
|
|
|
245
257
|
}
|
|
246
258
|
}
|
|
247
259
|
cleanedBody = omitUserRolesFromWriteBody(
|
|
248
|
-
model.modelName,
|
|
260
|
+
writeModelName ?? model.modelName,
|
|
249
261
|
options.accessControl,
|
|
250
262
|
cleanedBody,
|
|
251
263
|
(request as express.Request & {terrenoAllowUserAdminWrite?: boolean})
|
|
@@ -277,11 +289,11 @@ export const executeCreate = async <T>({
|
|
|
277
289
|
|
|
278
290
|
if (options.populatePaths) {
|
|
279
291
|
try {
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
data = await populateQuery.exec()
|
|
292
|
+
const populateQuery = addPopulateToQuery(
|
|
293
|
+
model.findById(data._id) as unknown as Parameters<typeof addPopulateToQuery>[0],
|
|
294
|
+
options.populatePaths
|
|
295
|
+
);
|
|
296
|
+
data = (await populateQuery.exec()) as unknown as ExecutorDoc<T>;
|
|
285
297
|
} catch (error: unknown) {
|
|
286
298
|
throw passthroughOrWrap(error, {
|
|
287
299
|
code: "populate-error",
|
|
@@ -342,7 +354,9 @@ export const executeUpdate = async <T>({
|
|
|
342
354
|
concurrencyCheck,
|
|
343
355
|
existingDoc,
|
|
344
356
|
req,
|
|
357
|
+
skipPermissionChecks,
|
|
345
358
|
skipPostHooks,
|
|
359
|
+
writeModelName,
|
|
346
360
|
}: {
|
|
347
361
|
model: Model<T>;
|
|
348
362
|
options: ModelRouterOptions<T>;
|
|
@@ -359,10 +373,20 @@ export const executeUpdate = async <T>({
|
|
|
359
373
|
req?: express.Request;
|
|
360
374
|
/** C5 (FIX 6): see `executeCreate`'s `skipPostHooks` doc comment. */
|
|
361
375
|
skipPostHooks?: boolean;
|
|
376
|
+
/**
|
|
377
|
+
* Name used for User-role stripping after hooks. Defaults to `model.modelName`.
|
|
378
|
+
* MCP passes the registry `modelName` because compiled mongoose names can differ.
|
|
379
|
+
*/
|
|
380
|
+
writeModelName?: string;
|
|
381
|
+
/** When true, skip modelRouter permission checks (admin-window sync mutations). */
|
|
382
|
+
skipPermissionChecks?: boolean;
|
|
362
383
|
}): Promise<ExecutorResult<T>> => {
|
|
363
384
|
const request = req ?? stubRequest(user);
|
|
364
385
|
|
|
365
|
-
if (
|
|
386
|
+
if (
|
|
387
|
+
!skipPermissionChecks &&
|
|
388
|
+
!(await checkPermissions("update", options.permissions.update, user))
|
|
389
|
+
) {
|
|
366
390
|
throw new APIError({
|
|
367
391
|
status: 405,
|
|
368
392
|
title: `Access to UPDATE on ${model.modelName} denied for ${user?.id}`,
|
|
@@ -372,7 +396,10 @@ export const executeUpdate = async <T>({
|
|
|
372
396
|
let doc =
|
|
373
397
|
existingDoc ?? ((await loadDocOr404<T>(model, id, options.populatePaths)) as ExecutorDoc<T>);
|
|
374
398
|
|
|
375
|
-
if (
|
|
399
|
+
if (
|
|
400
|
+
!skipPermissionChecks &&
|
|
401
|
+
!(await checkPermissions("update", options.permissions.update, user, doc))
|
|
402
|
+
) {
|
|
376
403
|
throw new APIError({
|
|
377
404
|
status: 403,
|
|
378
405
|
title: `Access to GET on ${model.modelName}:${id} denied for ${user?.id}`,
|
|
@@ -428,7 +455,7 @@ export const executeUpdate = async <T>({
|
|
|
428
455
|
}
|
|
429
456
|
|
|
430
457
|
cleanedBody = omitUserRolesFromWriteBody(
|
|
431
|
-
model.modelName,
|
|
458
|
+
writeModelName ?? model.modelName,
|
|
432
459
|
options.accessControl,
|
|
433
460
|
cleanedBody,
|
|
434
461
|
(request as express.Request & {terrenoAllowUserAdminWrite?: boolean})
|
|
@@ -536,11 +563,11 @@ export const executeUpdate = async <T>({
|
|
|
536
563
|
}
|
|
537
564
|
|
|
538
565
|
if (options.populatePaths) {
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
doc = await populateQuery.exec()
|
|
566
|
+
const populateQuery = addPopulateToQuery(
|
|
567
|
+
model.findById(doc._id) as unknown as Parameters<typeof addPopulateToQuery>[0],
|
|
568
|
+
options.populatePaths
|
|
569
|
+
);
|
|
570
|
+
doc = (await populateQuery.exec()) as unknown as ExecutorDoc<T>;
|
|
544
571
|
}
|
|
545
572
|
|
|
546
573
|
if (options.postUpdate && !skipPostHooks) {
|
|
@@ -591,6 +618,7 @@ export const executeDelete = async <T>({
|
|
|
591
618
|
id,
|
|
592
619
|
existingDoc,
|
|
593
620
|
req,
|
|
621
|
+
skipPermissionChecks,
|
|
594
622
|
skipPostHooks,
|
|
595
623
|
}: {
|
|
596
624
|
model: Model<T>;
|
|
@@ -606,10 +634,15 @@ export const executeDelete = async <T>({
|
|
|
606
634
|
req?: express.Request;
|
|
607
635
|
/** C5 (FIX 6): see `executeCreate`'s `skipPostHooks` doc comment. */
|
|
608
636
|
skipPostHooks?: boolean;
|
|
637
|
+
/** When true, skip modelRouter permission checks (admin-window sync mutations). */
|
|
638
|
+
skipPermissionChecks?: boolean;
|
|
609
639
|
}): Promise<ExecutorResult<T>> => {
|
|
610
640
|
const request = req ?? stubRequest(user);
|
|
611
641
|
|
|
612
|
-
if (
|
|
642
|
+
if (
|
|
643
|
+
!skipPermissionChecks &&
|
|
644
|
+
!(await checkPermissions("delete", options.permissions.delete, user))
|
|
645
|
+
) {
|
|
613
646
|
throw new APIError({
|
|
614
647
|
status: 405,
|
|
615
648
|
title: `Access to DELETE on ${model.modelName} denied for ${user?.id}`,
|
|
@@ -637,7 +670,10 @@ export const executeDelete = async <T>({
|
|
|
637
670
|
if (!resolved) {
|
|
638
671
|
throw error;
|
|
639
672
|
}
|
|
640
|
-
if (
|
|
673
|
+
if (
|
|
674
|
+
!skipPermissionChecks &&
|
|
675
|
+
!(await checkPermissions("delete", options.permissions.delete, user, resolved))
|
|
676
|
+
) {
|
|
641
677
|
throw new APIError({
|
|
642
678
|
status: 403,
|
|
643
679
|
title: `Access to GET on ${model.modelName}:${id} denied for ${user?.id}`,
|
|
@@ -649,7 +685,10 @@ export const executeDelete = async <T>({
|
|
|
649
685
|
}
|
|
650
686
|
}
|
|
651
687
|
|
|
652
|
-
if (
|
|
688
|
+
if (
|
|
689
|
+
!skipPermissionChecks &&
|
|
690
|
+
!(await checkPermissions("delete", options.permissions.delete, user, doc))
|
|
691
|
+
) {
|
|
653
692
|
throw new APIError({
|
|
654
693
|
status: 403,
|
|
655
694
|
title: `Access to GET on ${model.modelName}:${id} denied for ${user?.id}`,
|