@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/terrenoApp.ts
CHANGED
|
@@ -1,15 +1,25 @@
|
|
|
1
1
|
import {EventEmitter} from "node:events";
|
|
2
|
-
import {createServer} from "node:http";
|
|
2
|
+
import {createServer, type Server as HttpServer} from "node:http";
|
|
3
3
|
import * as Sentry from "@sentry/bun";
|
|
4
4
|
import cors from "cors";
|
|
5
5
|
import express from "express";
|
|
6
|
+
import mongoose from "mongoose";
|
|
6
7
|
import qs from "qs";
|
|
7
8
|
import type {AdminChangeEvent, TerrenoAppAdminEvent} from "./adminTypes";
|
|
8
9
|
import type {ModelRouterRegistration} from "./api";
|
|
9
10
|
import {addAuthRoutes, addMeRoutes, setupAuth, type UserModel as UserMongooseModel} from "./auth";
|
|
10
|
-
import type {BetterAuthInstance} from "./betterAuthSetup";
|
|
11
|
-
import {ConfigurationApp, type ConfigurationAppOptions} from "./configurationApp";
|
|
12
11
|
import {
|
|
12
|
+
applyJwtPasswordResetToBetterAuth,
|
|
13
|
+
type BetterAuthInstance,
|
|
14
|
+
createBetterAuthSessionMiddleware,
|
|
15
|
+
} from "./betterAuthSetup";
|
|
16
|
+
import {
|
|
17
|
+
ConfigurationApp,
|
|
18
|
+
type ConfigurationAppOptions,
|
|
19
|
+
type ConfigurationModelLike,
|
|
20
|
+
} from "./configurationApp";
|
|
21
|
+
import {
|
|
22
|
+
APIError,
|
|
13
23
|
apiErrorMiddleware,
|
|
14
24
|
apiFallthroughErrorMiddleware,
|
|
15
25
|
apiUnauthorizedMiddleware,
|
|
@@ -18,9 +28,20 @@ import {type AddRoutes, type AuthOptions, logRequests} from "./expressServer";
|
|
|
18
28
|
import {addGitHubAuthRoutes, type GitHubAuthOptions, setupGitHubAuth} from "./githubAuth";
|
|
19
29
|
import {type LoggingOptions, logger, setupLogging} from "./logger";
|
|
20
30
|
import {mountMCPServer} from "./mcp/server";
|
|
31
|
+
import {
|
|
32
|
+
addMcpServiceTokenRoutes,
|
|
33
|
+
type McpServiceTokensAppOption,
|
|
34
|
+
resolveMcpServiceTokensOption,
|
|
35
|
+
} from "./mcp/serviceTokens";
|
|
21
36
|
import {jsonResponseRequestIdMiddleware} from "./middleware";
|
|
37
|
+
import {runStartupMigrations, type StartupMigrationsOption} from "./migrations/runner";
|
|
22
38
|
import {openApiCompatMiddleware, patchAppUse} from "./openApiCompat";
|
|
23
39
|
import {openApiEtagMiddleware} from "./openApiEtag";
|
|
40
|
+
import {OrgsApp, type OrgsAppOptions} from "./orgs/orgsApp";
|
|
41
|
+
import {applyRateLimitTrustProxy} from "./rateLimit/applyTrustProxy";
|
|
42
|
+
import {createRateLimitStore} from "./rateLimit/createStore";
|
|
43
|
+
import {createRateLimitMiddleware} from "./rateLimit/middleware";
|
|
44
|
+
import type {RateLimitOptions} from "./rateLimit/types";
|
|
24
45
|
import {RealtimeApp} from "./realtime/realtimeApp";
|
|
25
46
|
import type {RealtimeAppOptions} from "./realtime/types";
|
|
26
47
|
import {
|
|
@@ -31,10 +52,14 @@ import {
|
|
|
31
52
|
import {ensureSyncIndexes} from "./sync/registry";
|
|
32
53
|
import type {TerrenoPlugin} from "./terrenoPlugin";
|
|
33
54
|
import openapi from "./vendor/wesleytodd-openapi/index";
|
|
55
|
+
import {jsonBodyParserOptions, urlencodedBodyParserOptions} from "./webhooks/rawBody";
|
|
34
56
|
|
|
35
57
|
/** A registered plugin that exposes a Better Auth instance, e.g. BetterAuthApp. */
|
|
36
58
|
interface BetterAuthProvider {
|
|
37
59
|
getAuth: () => BetterAuthInstance | undefined;
|
|
60
|
+
ensureAuth?: () => BetterAuthInstance;
|
|
61
|
+
markSessionMiddlewareMounted?: () => void;
|
|
62
|
+
getBetterAuthBasePath?: () => string;
|
|
38
63
|
}
|
|
39
64
|
|
|
40
65
|
type CorsOrigin =
|
|
@@ -66,6 +91,12 @@ export interface TerrenoAppOptions {
|
|
|
66
91
|
githubAuth?: GitHubAuthOptions;
|
|
67
92
|
/** Skip calling app.listen() in start() method (useful for testing) */
|
|
68
93
|
skipListen?: boolean;
|
|
94
|
+
/**
|
|
95
|
+
* Already-listening HTTP server. `start()` attaches the Express app to it
|
|
96
|
+
* instead of creating and binding a new server, so Cloud Run can see PORT
|
|
97
|
+
* before MongoDB connect and plugin registration finish.
|
|
98
|
+
*/
|
|
99
|
+
httpServer?: HttpServer;
|
|
69
100
|
/** Sentry configuration options */
|
|
70
101
|
sentryOptions?: Sentry.BunOptions;
|
|
71
102
|
/** Maximum number of array items in query parameters (default: 200) */
|
|
@@ -83,6 +114,13 @@ export interface TerrenoAppOptions {
|
|
|
83
114
|
* RBAC access controller injected into model routers and `/auth/me` enrichment.
|
|
84
115
|
*/
|
|
85
116
|
accessControl?: import("./rbac/types").AnyTerrenoAccess;
|
|
117
|
+
/**
|
|
118
|
+
* Multi-tenant organizations. Default off so existing single-tenant apps stay unchanged.
|
|
119
|
+
* New apps from `terreno_bootstrap_app` pass `true`. Requires `accessControl` from
|
|
120
|
+
* `createAccess({ organizations: true })`. Pass `{ settingsSchema }` to type and
|
|
121
|
+
* validate `Organization.settings`.
|
|
122
|
+
*/
|
|
123
|
+
organizations?: boolean | Omit<OrgsAppOptions, "access" | "userModel">;
|
|
86
124
|
/**
|
|
87
125
|
* Runs after CORS and before the `addMiddleware` chain and JSON body parsing.
|
|
88
126
|
* Use to attach early middleware via `app.use(...)` before JSON parsing.
|
|
@@ -93,6 +131,23 @@ export interface TerrenoAppOptions {
|
|
|
93
131
|
* Receives the Express app and OpenAPI bundle for `modelRouter` / `createOpenApiBuilder` wiring.
|
|
94
132
|
*/
|
|
95
133
|
configureApp?: AddRoutes;
|
|
134
|
+
/**
|
|
135
|
+
* Optional HTTP rate limiting. Omitted or `undefined` leaves the limiter off
|
|
136
|
+
* (Terreno 58 will default it on). Pass `{}` or `{store, limits, trustProxy}`
|
|
137
|
+
* to enable. See [Rate limiting](../how-to/rate-limiting.md).
|
|
138
|
+
*/
|
|
139
|
+
rateLimit?: RateLimitOptions;
|
|
140
|
+
/**
|
|
141
|
+
* Opt-in personal MCP service tokens. `true` is `{enabled: true}`. When enabled,
|
|
142
|
+
* mounts `/mcp/service-tokens` and accepts `Authorization: Bearer mcp_…` on `/mcp`.
|
|
143
|
+
*/
|
|
144
|
+
mcpServiceTokens?: McpServiceTokensAppOption;
|
|
145
|
+
/**
|
|
146
|
+
* Versioned MongoDB migrations. `runOnStart` defaults to false. When true, wet `up`
|
|
147
|
+
* runs after listen and `ensureSyncIndexes`. Production still requires
|
|
148
|
+
* `ALLOW_MIGRATIONS=true`.
|
|
149
|
+
*/
|
|
150
|
+
migrations?: StartupMigrationsOption;
|
|
96
151
|
}
|
|
97
152
|
|
|
98
153
|
/**
|
|
@@ -106,7 +161,7 @@ export interface TerrenoAppOptions {
|
|
|
106
161
|
* 1. CORS
|
|
107
162
|
* 2. Optional `beforeJsonSetup` (configure the app before JSON parsing)
|
|
108
163
|
* 3. Custom middleware (via addMiddleware)
|
|
109
|
-
* 4. JSON body
|
|
164
|
+
* 4. JSON and urlencoded body parsers (stash `req.rawBody`)
|
|
110
165
|
* 5. Auth routes (/auth/login, /auth/signup, etc.)
|
|
111
166
|
* 6. JWT authentication setup
|
|
112
167
|
* 7. Request logging
|
|
@@ -163,6 +218,7 @@ export class TerrenoApp {
|
|
|
163
218
|
private middlewareFns: (express.RequestHandler | ((app: express.Application) => void))[] = [];
|
|
164
219
|
private configurationApp: ConfigurationApp | null = null;
|
|
165
220
|
private readonly adminEvents = new EventEmitter();
|
|
221
|
+
private bootPromise: Promise<void> = Promise.resolve();
|
|
166
222
|
|
|
167
223
|
/**
|
|
168
224
|
* Create a new TerrenoApp builder.
|
|
@@ -274,12 +330,7 @@ export class TerrenoApp {
|
|
|
274
330
|
* .start();
|
|
275
331
|
* ```
|
|
276
332
|
*/
|
|
277
|
-
configure(
|
|
278
|
-
// noExplicitAny: Model<any> required for invariance — consumers pass arbitrary configuration models
|
|
279
|
-
// biome-ignore lint/suspicious/noExplicitAny: Model<any> required for invariance — consumers pass arbitrary configuration models
|
|
280
|
-
model: import("mongoose").Model<any>,
|
|
281
|
-
options?: Omit<ConfigurationAppOptions, "model">
|
|
282
|
-
): this {
|
|
333
|
+
configure(model: ConfigurationModelLike, options?: Omit<ConfigurationAppOptions, "model">): this {
|
|
283
334
|
this.configurationApp = new ConfigurationApp({model, ...options});
|
|
284
335
|
return this;
|
|
285
336
|
}
|
|
@@ -288,8 +339,9 @@ export class TerrenoApp {
|
|
|
288
339
|
* Build the Express application without starting the server.
|
|
289
340
|
*
|
|
290
341
|
* Configures the complete middleware stack including:
|
|
291
|
-
* - CORS, JSON parsing,
|
|
292
|
-
* -
|
|
342
|
+
* - CORS, JSON parsing, JWT decode, optional HTTP rate limiting, auth routes
|
|
343
|
+
* - Better Auth session (when BetterAuthApp is registered) before the limiter
|
|
344
|
+
* - Logging, Sentry, OpenAPI, model routers and plugins
|
|
293
345
|
* - Error handling middleware
|
|
294
346
|
*
|
|
295
347
|
* Use this method when you need the Express app instance for testing
|
|
@@ -339,16 +391,46 @@ export class TerrenoApp {
|
|
|
339
391
|
}
|
|
340
392
|
}
|
|
341
393
|
|
|
342
|
-
app.use(express.json(
|
|
394
|
+
app.use(express.json(jsonBodyParserOptions));
|
|
395
|
+
app.use(express.urlencoded(urlencodedBodyParserOptions) as unknown as express.RequestHandler);
|
|
343
396
|
|
|
344
|
-
//
|
|
345
|
-
|
|
397
|
+
// JWT decode before rate limiting so authenticated keys use userId.
|
|
398
|
+
// Auth routes mount after the limiter so login is in the auth bucket.
|
|
346
399
|
setupAuth(app, options.userModel);
|
|
347
400
|
app.use((req, res, next) => {
|
|
348
401
|
updateRequestContextFromRequest(req, res);
|
|
349
402
|
next();
|
|
350
403
|
});
|
|
351
404
|
|
|
405
|
+
const betterAuthForLimiter = this.registrations.find(
|
|
406
|
+
(registration) =>
|
|
407
|
+
"getAuth" in registration &&
|
|
408
|
+
typeof (registration as Partial<BetterAuthProvider>).getAuth === "function"
|
|
409
|
+
) as BetterAuthProvider | undefined;
|
|
410
|
+
if (betterAuthForLimiter?.ensureAuth) {
|
|
411
|
+
const auth = betterAuthForLimiter.ensureAuth();
|
|
412
|
+
app.use(createBetterAuthSessionMiddleware(auth, options.userModel));
|
|
413
|
+
betterAuthForLimiter.markSessionMiddlewareMounted?.();
|
|
414
|
+
}
|
|
415
|
+
|
|
416
|
+
if (options.rateLimit) {
|
|
417
|
+
const betterAuthBasePath =
|
|
418
|
+
options.rateLimit.betterAuthBasePath ?? betterAuthForLimiter?.getBetterAuthBasePath?.();
|
|
419
|
+
const rateLimit = {
|
|
420
|
+
...options.rateLimit,
|
|
421
|
+
...(betterAuthBasePath ? {betterAuthBasePath} : {}),
|
|
422
|
+
};
|
|
423
|
+
applyRateLimitTrustProxy(app, rateLimit);
|
|
424
|
+
const store = createRateLimitStore(rateLimit);
|
|
425
|
+
app.use(createRateLimitMiddleware(store, rateLimit));
|
|
426
|
+
}
|
|
427
|
+
|
|
428
|
+
if (!options.authOptions) {
|
|
429
|
+
options.authOptions = {};
|
|
430
|
+
}
|
|
431
|
+
const authOptions = options.authOptions;
|
|
432
|
+
addAuthRoutes(app, options.userModel, authOptions);
|
|
433
|
+
|
|
352
434
|
if (options.logRequests !== false) {
|
|
353
435
|
app.use(logRequests);
|
|
354
436
|
}
|
|
@@ -429,8 +511,22 @@ export class TerrenoApp {
|
|
|
429
511
|
"getAuth" in registration &&
|
|
430
512
|
typeof (registration as Partial<BetterAuthProvider>).getAuth === "function"
|
|
431
513
|
) as BetterAuthProvider | undefined;
|
|
514
|
+
const betterAuth = betterAuthPlugin?.ensureAuth?.() ?? betterAuthPlugin?.getAuth();
|
|
515
|
+
if (betterAuth) {
|
|
516
|
+
authOptions.syncPasswordResetToBetterAuth = async (user, password): Promise<void> => {
|
|
517
|
+
await applyJwtPasswordResetToBetterAuth(betterAuth, user, password);
|
|
518
|
+
};
|
|
519
|
+
}
|
|
520
|
+
const mcpServiceTokens = resolveMcpServiceTokensOption(options.mcpServiceTokens);
|
|
521
|
+
if (mcpServiceTokens.enabled) {
|
|
522
|
+
addMcpServiceTokenRoutes(app, {
|
|
523
|
+
openApi: oapi,
|
|
524
|
+
publicMcpUrl: mcpServiceTokens.publicMcpUrl,
|
|
525
|
+
});
|
|
526
|
+
}
|
|
432
527
|
mountMCPServer(app, {
|
|
433
|
-
betterAuth
|
|
528
|
+
betterAuth,
|
|
529
|
+
mcpServiceTokens: mcpServiceTokens.enabled,
|
|
434
530
|
userModel: options.userModel,
|
|
435
531
|
});
|
|
436
532
|
|
|
@@ -474,6 +570,31 @@ export class TerrenoApp {
|
|
|
474
570
|
* ```
|
|
475
571
|
*/
|
|
476
572
|
start(): express.Application {
|
|
573
|
+
if (this.options.organizations) {
|
|
574
|
+
if (!this.options.accessControl) {
|
|
575
|
+
throw new APIError({
|
|
576
|
+
status: 500,
|
|
577
|
+
title:
|
|
578
|
+
"TerrenoApp organizations requires accessControl from createAccess({ organizations: true })",
|
|
579
|
+
});
|
|
580
|
+
}
|
|
581
|
+
const hasOrgsPlugin = this.registrations.some(
|
|
582
|
+
(registration) =>
|
|
583
|
+
!this.isModelRouterRegistration(registration) && registration instanceof OrgsApp
|
|
584
|
+
);
|
|
585
|
+
if (!hasOrgsPlugin) {
|
|
586
|
+
const orgConfig =
|
|
587
|
+
typeof this.options.organizations === "object" ? this.options.organizations : {};
|
|
588
|
+
this.register(
|
|
589
|
+
new OrgsApp({
|
|
590
|
+
...orgConfig,
|
|
591
|
+
access: this.options.accessControl,
|
|
592
|
+
userModel: this.options.userModel,
|
|
593
|
+
})
|
|
594
|
+
);
|
|
595
|
+
}
|
|
596
|
+
}
|
|
597
|
+
|
|
477
598
|
// If realtime option is set, auto-register the RealtimeApp plugin
|
|
478
599
|
if (this.options.realtime) {
|
|
479
600
|
const hasRealtimePlugin = this.registrations.some(
|
|
@@ -496,41 +617,55 @@ export class TerrenoApp {
|
|
|
496
617
|
}
|
|
497
618
|
|
|
498
619
|
const app = this.build();
|
|
620
|
+
this.bootPromise = this.completeStart(app);
|
|
621
|
+
if (!this.options.skipListen) {
|
|
622
|
+
void this.bootPromise.catch((error: unknown) => {
|
|
623
|
+
const stack = error instanceof Error ? error.stack : String(error);
|
|
624
|
+
logger.error(`Error trying to start HTTP server: ${error}\n${stack}`);
|
|
625
|
+
process.exit(1);
|
|
626
|
+
});
|
|
627
|
+
}
|
|
628
|
+
return app;
|
|
629
|
+
}
|
|
499
630
|
|
|
631
|
+
/**
|
|
632
|
+
* Resolves after startup migrations (and listen, unless `skipListen`).
|
|
633
|
+
* Tests with `skipListen` should await this instead of assuming `start()` is idle.
|
|
634
|
+
*/
|
|
635
|
+
whenReady(): Promise<void> {
|
|
636
|
+
return this.bootPromise;
|
|
637
|
+
}
|
|
638
|
+
|
|
639
|
+
private completeStart = async (app: express.Application): Promise<void> => {
|
|
500
640
|
if (!this.options.skipListen) {
|
|
501
641
|
const port = process.env.PORT || "9000";
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
await ensureSyncIndexes();
|
|
512
|
-
const server = createServer(app);
|
|
513
|
-
|
|
514
|
-
// Notify plugins that need access to the HTTP server (e.g. WebSocket plugins)
|
|
515
|
-
for (const reg of this.registrations) {
|
|
516
|
-
if (!this.isModelRouterRegistration(reg) && typeof reg.onServerCreated === "function") {
|
|
517
|
-
reg.onServerCreated(server);
|
|
518
|
-
}
|
|
519
|
-
}
|
|
520
|
-
|
|
521
|
-
server.listen(port, () => {
|
|
522
|
-
logger.info(`Listening on port ${port}`);
|
|
523
|
-
});
|
|
524
|
-
} catch (error) {
|
|
525
|
-
const stack = error instanceof Error ? error.stack : String(error);
|
|
526
|
-
logger.error(`Error trying to start HTTP server: ${error}\n${stack}`);
|
|
527
|
-
process.exit(1);
|
|
642
|
+
const existingServer = this.options.httpServer;
|
|
643
|
+
const server = existingServer ?? createServer(app);
|
|
644
|
+
if (existingServer) {
|
|
645
|
+
existingServer.removeAllListeners("request");
|
|
646
|
+
existingServer.on("request", app);
|
|
647
|
+
}
|
|
648
|
+
for (const reg of this.registrations) {
|
|
649
|
+
if (!this.isModelRouterRegistration(reg) && typeof reg.onServerCreated === "function") {
|
|
650
|
+
reg.onServerCreated(server);
|
|
528
651
|
}
|
|
529
|
-
}
|
|
652
|
+
}
|
|
653
|
+
// Bind PORT before index/migration work so Cloud Run's startup probe can
|
|
654
|
+
// succeed while `ensureSyncIndexes` still runs. whenReady() still waits.
|
|
655
|
+
if (!existingServer) {
|
|
656
|
+
server.listen(port, () => {
|
|
657
|
+
logger.info(`Listening on port ${port}`);
|
|
658
|
+
});
|
|
659
|
+
} else {
|
|
660
|
+
logger.info(`Listening on port ${port}`);
|
|
661
|
+
}
|
|
662
|
+
await ensureSyncIndexes();
|
|
530
663
|
}
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
664
|
+
await runStartupMigrations({
|
|
665
|
+
migrations: this.options.migrations,
|
|
666
|
+
mongoose,
|
|
667
|
+
});
|
|
668
|
+
};
|
|
534
669
|
|
|
535
670
|
private isModelRouterRegistration(
|
|
536
671
|
registration: ModelRouterRegistration | TerrenoPlugin
|
|
@@ -40,7 +40,7 @@ export const createTestUsers = async (): Promise<TestUsers> => {
|
|
|
40
40
|
return {admin, adminOther, notAdmin};
|
|
41
41
|
};
|
|
42
42
|
|
|
43
|
-
|
|
43
|
+
const createStandardFoods = async (users: TestUsers): Promise<TestFoods> => {
|
|
44
44
|
const {admin, adminOther, notAdmin} = users;
|
|
45
45
|
|
|
46
46
|
const [spinach, apple, carrots, pizza] = await Promise.all([
|
|
@@ -106,7 +106,7 @@ export const createStandardFoods = async (users: TestUsers): Promise<TestFoods>
|
|
|
106
106
|
return {apple, carrots, pizza, spinach};
|
|
107
107
|
};
|
|
108
108
|
|
|
109
|
-
|
|
109
|
+
const createRequiredFixtures = async (): Promise<TestRequired> => {
|
|
110
110
|
const [sample, withAbout] = await Promise.all([
|
|
111
111
|
RequiredModel.create({name: "Sample Required"}),
|
|
112
112
|
RequiredModel.create({about: "Optional about text", name: "Required With About"}),
|
package/src/tests/models.ts
CHANGED
|
@@ -1,7 +1,12 @@
|
|
|
1
1
|
import mongoose, {type Model, model, Schema, type StringSchemaDefinition} from "mongoose";
|
|
2
2
|
import passportLocalMongoose from "passport-local-mongoose";
|
|
3
3
|
|
|
4
|
-
import {
|
|
4
|
+
import {
|
|
5
|
+
createdUpdatedPlugin,
|
|
6
|
+
DateOnly,
|
|
7
|
+
emailVerificationPlugin,
|
|
8
|
+
isDisabledPlugin,
|
|
9
|
+
} from "../plugins";
|
|
5
10
|
|
|
6
11
|
export interface User {
|
|
7
12
|
admin: boolean;
|
|
@@ -11,6 +16,9 @@ export interface User {
|
|
|
11
16
|
age?: number;
|
|
12
17
|
disabled?: boolean;
|
|
13
18
|
organizationIds?: string[];
|
|
19
|
+
roles?: string[];
|
|
20
|
+
tokenEpoch?: number;
|
|
21
|
+
emailVerified?: boolean;
|
|
14
22
|
}
|
|
15
23
|
|
|
16
24
|
export interface SuperUser extends User {
|
|
@@ -63,6 +71,16 @@ const userSchema = new Schema<User>({
|
|
|
63
71
|
description: "Organization memberships",
|
|
64
72
|
type: [String],
|
|
65
73
|
},
|
|
74
|
+
roles: {
|
|
75
|
+
default: [],
|
|
76
|
+
description: "RBAC role names assigned to this user",
|
|
77
|
+
type: [String],
|
|
78
|
+
},
|
|
79
|
+
tokenEpoch: {
|
|
80
|
+
default: 0,
|
|
81
|
+
description: "Incremented on password reset to invalidate outstanding refresh tokens",
|
|
82
|
+
type: Number,
|
|
83
|
+
},
|
|
66
84
|
username: {description: "The user's username", type: String},
|
|
67
85
|
});
|
|
68
86
|
|
|
@@ -70,16 +88,19 @@ userSchema.plugin(
|
|
|
70
88
|
passportLocalMongoose as unknown as (schema: Schema, options?: Record<string, unknown>) => void,
|
|
71
89
|
{
|
|
72
90
|
attemptsField: "attempts",
|
|
73
|
-
interval:
|
|
91
|
+
interval: 1,
|
|
74
92
|
limitAttempts: true,
|
|
75
93
|
maxAttempts: 3,
|
|
76
|
-
|
|
94
|
+
// Test-only schema: maxInterval 0 caps calculatedInterval at 0 so AttemptTooSoon
|
|
95
|
+
// never preempts maxAttempts lockout under rapid supertest logins.
|
|
96
|
+
maxInterval: 0,
|
|
77
97
|
usernameCaseInsensitive: true,
|
|
78
98
|
usernameField: "email",
|
|
79
99
|
}
|
|
80
100
|
);
|
|
81
101
|
userSchema.plugin(createdUpdatedPlugin);
|
|
82
102
|
userSchema.plugin(isDisabledPlugin);
|
|
103
|
+
userSchema.plugin(emailVerificationPlugin);
|
|
83
104
|
userSchema.methods.postCreate = async function (body: {age?: number}) {
|
|
84
105
|
this.age = body.age;
|
|
85
106
|
return this.save();
|
package/src/tests/testHelper.ts
CHANGED
|
@@ -7,7 +7,7 @@ import type {TestData} from "./types";
|
|
|
7
7
|
|
|
8
8
|
const defaultTestMongoUri = "mongodb://127.0.0.1/terreno?&connectTimeoutMS=360000";
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
const applyTestAuthEnv = (): void => {
|
|
11
11
|
process.env.REFRESH_TOKEN_SECRET = "refresh_secret";
|
|
12
12
|
process.env.TOKEN_SECRET = "secret";
|
|
13
13
|
process.env.TOKEN_EXPIRES_IN = "30m";
|
|
@@ -47,9 +47,3 @@ export const setupTestData = async (): Promise<TestData> => {
|
|
|
47
47
|
|
|
48
48
|
return createTestData();
|
|
49
49
|
};
|
|
50
|
-
|
|
51
|
-
/** Clears all API test collections without re-seeding. */
|
|
52
|
-
export const resetTestCollections = clearTestCollections;
|
|
53
|
-
|
|
54
|
-
export {createTestData} from "./createTestData";
|
|
55
|
-
export {loadTestData} from "./mongoTestSetup";
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import type mongoose from "mongoose";
|
|
2
|
+
import type {FindExactlyOnePlugin, FindOneOrNonePlugin} from "../plugins";
|
|
3
|
+
|
|
4
|
+
export type AuthTokenType = "passwordReset" | "emailVerification";
|
|
5
|
+
|
|
6
|
+
type AuthTokenMethods = Record<string, never>;
|
|
7
|
+
|
|
8
|
+
interface AuthTokenStatics
|
|
9
|
+
extends FindExactlyOnePlugin<AuthTokenDocument>,
|
|
10
|
+
FindOneOrNonePlugin<AuthTokenDocument> {
|
|
11
|
+
consume: (
|
|
12
|
+
this: AuthTokenModel,
|
|
13
|
+
token: string,
|
|
14
|
+
type: AuthTokenType
|
|
15
|
+
) => Promise<AuthTokenDocument | null>;
|
|
16
|
+
invalidateUnusedFor: (
|
|
17
|
+
this: AuthTokenModel,
|
|
18
|
+
user: {_id: {toString(): string}},
|
|
19
|
+
type: AuthTokenType
|
|
20
|
+
) => Promise<void>;
|
|
21
|
+
issueFor: (
|
|
22
|
+
this: AuthTokenModel,
|
|
23
|
+
user: {_id: {toString(): string}},
|
|
24
|
+
type: AuthTokenType
|
|
25
|
+
) => Promise<{authToken: AuthTokenDocument; token: string}>;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export interface AuthTokenModel
|
|
29
|
+
extends mongoose.Model<AuthTokenDocument, object, AuthTokenMethods>,
|
|
30
|
+
AuthTokenStatics {}
|
|
31
|
+
|
|
32
|
+
export interface AuthTokenDocument extends mongoose.Document {
|
|
33
|
+
_id: mongoose.Types.ObjectId;
|
|
34
|
+
userId: mongoose.Types.ObjectId;
|
|
35
|
+
tokenHash: string;
|
|
36
|
+
type: AuthTokenType;
|
|
37
|
+
expiresAt: Date;
|
|
38
|
+
consumedAt?: Date;
|
|
39
|
+
created: Date;
|
|
40
|
+
updated: Date;
|
|
41
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import type mongoose from "mongoose";
|
|
2
|
+
import type {FindExactlyOnePlugin, FindOneOrNonePlugin} from "../plugins";
|
|
3
|
+
|
|
4
|
+
export interface McpServiceTokenIssueOptions {
|
|
5
|
+
expiresAt?: Date;
|
|
6
|
+
name: string;
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
interface McpServiceTokenMethods {
|
|
10
|
+
deleteOne: (this: McpServiceTokenDocument) => Promise<McpServiceTokenDocument>;
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
export interface McpServiceTokenStatics
|
|
14
|
+
extends FindExactlyOnePlugin<McpServiceTokenDocument>,
|
|
15
|
+
FindOneOrNonePlugin<McpServiceTokenDocument> {
|
|
16
|
+
countActiveForUser: (
|
|
17
|
+
this: McpServiceTokenModel,
|
|
18
|
+
userId: mongoose.Types.ObjectId
|
|
19
|
+
) => Promise<number>;
|
|
20
|
+
issueFor: (
|
|
21
|
+
this: McpServiceTokenModel,
|
|
22
|
+
user: {_id: {toString(): string}},
|
|
23
|
+
options: McpServiceTokenIssueOptions
|
|
24
|
+
) => Promise<{mcpServiceToken: McpServiceTokenDocument; token: string}>;
|
|
25
|
+
revokeForUser: (
|
|
26
|
+
this: McpServiceTokenModel,
|
|
27
|
+
user: {_id: {toString(): string}},
|
|
28
|
+
tokenId: mongoose.Types.ObjectId
|
|
29
|
+
) => Promise<McpServiceTokenDocument | null>;
|
|
30
|
+
verify: (this: McpServiceTokenModel, token: string) => Promise<McpServiceTokenDocument | null>;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export interface McpServiceTokenModel
|
|
34
|
+
extends mongoose.Model<McpServiceTokenDocument, object, McpServiceTokenMethods>,
|
|
35
|
+
McpServiceTokenStatics {}
|
|
36
|
+
|
|
37
|
+
export interface McpServiceTokenDocument extends mongoose.Document {
|
|
38
|
+
_id: mongoose.Types.ObjectId;
|
|
39
|
+
created: Date;
|
|
40
|
+
expiresAt?: Date;
|
|
41
|
+
lastUsedAt?: Date;
|
|
42
|
+
name: string;
|
|
43
|
+
revokedAt?: Date;
|
|
44
|
+
tokenHash: string;
|
|
45
|
+
tokenPrefix: string;
|
|
46
|
+
updated: Date;
|
|
47
|
+
userId: mongoose.Types.ObjectId;
|
|
48
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import type mongoose from "mongoose";
|
|
2
|
+
import type {FindExactlyOnePlugin, FindOneOrNonePlugin} from "../plugins";
|
|
3
|
+
|
|
4
|
+
export type MembershipRoleName = "org-admin" | "member";
|
|
5
|
+
export type MembershipStatus = "active" | "suspended";
|
|
6
|
+
|
|
7
|
+
// biome-ignore lint/complexity/noBannedTypes: No instance methods.
|
|
8
|
+
export type MembershipMethods = {};
|
|
9
|
+
|
|
10
|
+
export interface MembershipStatics
|
|
11
|
+
extends FindExactlyOnePlugin<MembershipDocument>,
|
|
12
|
+
FindOneOrNonePlugin<MembershipDocument> {
|
|
13
|
+
findActiveForUser: (
|
|
14
|
+
this: MembershipModel,
|
|
15
|
+
userId: mongoose.Types.ObjectId | string
|
|
16
|
+
) => Promise<MembershipDocument[]>;
|
|
17
|
+
isMember: (
|
|
18
|
+
this: MembershipModel,
|
|
19
|
+
userId: mongoose.Types.ObjectId | string,
|
|
20
|
+
organizationId: mongoose.Types.ObjectId | string
|
|
21
|
+
) => Promise<boolean>;
|
|
22
|
+
isOrgAdmin: (
|
|
23
|
+
this: MembershipModel,
|
|
24
|
+
userId: mongoose.Types.ObjectId | string,
|
|
25
|
+
organizationId: mongoose.Types.ObjectId | string
|
|
26
|
+
) => Promise<boolean>;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
export interface MembershipModel
|
|
30
|
+
extends mongoose.Model<MembershipDocument, object, MembershipMethods>,
|
|
31
|
+
MembershipStatics {}
|
|
32
|
+
|
|
33
|
+
export type MembershipSchema = mongoose.Schema<
|
|
34
|
+
MembershipDocument,
|
|
35
|
+
MembershipModel,
|
|
36
|
+
MembershipMethods
|
|
37
|
+
>;
|
|
38
|
+
|
|
39
|
+
export interface MembershipDocument extends mongoose.Document {
|
|
40
|
+
_id: mongoose.Types.ObjectId;
|
|
41
|
+
created: Date;
|
|
42
|
+
deleted: boolean;
|
|
43
|
+
organizationId: mongoose.Types.ObjectId;
|
|
44
|
+
roleName: MembershipRoleName;
|
|
45
|
+
status: MembershipStatus;
|
|
46
|
+
updated: Date;
|
|
47
|
+
userId: mongoose.Types.ObjectId;
|
|
48
|
+
}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import type mongoose from "mongoose";
|
|
2
|
+
import type {FindExactlyOnePlugin, FindOneOrNonePlugin} from "../plugins";
|
|
3
|
+
|
|
4
|
+
type NotificationMethods = Record<never, never>;
|
|
5
|
+
|
|
6
|
+
interface NotificationStatics
|
|
7
|
+
extends FindExactlyOnePlugin<NotificationDocument>,
|
|
8
|
+
FindOneOrNonePlugin<NotificationDocument> {}
|
|
9
|
+
|
|
10
|
+
export interface NotificationModel
|
|
11
|
+
extends mongoose.Model<NotificationDocument, object, NotificationMethods>,
|
|
12
|
+
NotificationStatics {}
|
|
13
|
+
|
|
14
|
+
export interface NotificationDocument extends mongoose.Document<string>, NotificationMethods {
|
|
15
|
+
_id: string;
|
|
16
|
+
archivedAt: Date | null;
|
|
17
|
+
body: string;
|
|
18
|
+
href?: string;
|
|
19
|
+
kind?: string;
|
|
20
|
+
ownerId: mongoose.Types.ObjectId;
|
|
21
|
+
readAt: Date | null;
|
|
22
|
+
title: string;
|
|
23
|
+
created: Date;
|
|
24
|
+
updated: Date;
|
|
25
|
+
deleted: boolean;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export interface NotifyInput {
|
|
29
|
+
body: string;
|
|
30
|
+
href?: string;
|
|
31
|
+
kind?: string;
|
|
32
|
+
title: string;
|
|
33
|
+
userId: string;
|
|
34
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type mongoose from "mongoose";
|
|
2
|
+
import type {FindExactlyOnePlugin, FindOneOrNonePlugin} from "../plugins";
|
|
3
|
+
|
|
4
|
+
export type NotificationPreferenceChannel = "inapp" | "mail" | "push" | "sms";
|
|
5
|
+
|
|
6
|
+
type NotificationPreferenceMethods = Record<never, never>;
|
|
7
|
+
|
|
8
|
+
interface NotificationPreferenceStatics
|
|
9
|
+
extends FindExactlyOnePlugin<NotificationPreferenceDocument>,
|
|
10
|
+
FindOneOrNonePlugin<NotificationPreferenceDocument> {}
|
|
11
|
+
|
|
12
|
+
export interface NotificationPreferenceModel
|
|
13
|
+
extends mongoose.Model<NotificationPreferenceDocument, object, NotificationPreferenceMethods>,
|
|
14
|
+
NotificationPreferenceStatics {}
|
|
15
|
+
|
|
16
|
+
export interface NotificationPreferenceDocument
|
|
17
|
+
extends mongoose.Document<string>,
|
|
18
|
+
NotificationPreferenceMethods {
|
|
19
|
+
_id: string;
|
|
20
|
+
inapp: boolean;
|
|
21
|
+
mail: boolean;
|
|
22
|
+
ownerId: mongoose.Types.ObjectId;
|
|
23
|
+
push: boolean;
|
|
24
|
+
sms: boolean;
|
|
25
|
+
created: Date;
|
|
26
|
+
updated: Date;
|
|
27
|
+
deleted: boolean;
|
|
28
|
+
}
|