@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
|
@@ -38,63 +38,14 @@ var __values = (this && this.__values) || function(o) {
|
|
|
38
38
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
39
39
|
exports.generateToolDescription = exports.generateInputSchema = exports.writeExcludeFields = exports.restWriteExcludeFields = exports.isFieldExcluded = void 0;
|
|
40
40
|
var zod_1 = require("zod");
|
|
41
|
-
var
|
|
42
|
-
/** Shown to the calling LLM so it knows filters accept Mongo comparison operators. */
|
|
41
|
+
var schemaMetadata_1 = require("../schemaMetadata");
|
|
43
42
|
var OPERATOR_HINT = "{\"$in\": [...]} or {\"$gte\": ...}";
|
|
44
|
-
/** Operators an LLM may use in a list filter, kept in sync with ALLOWED_FIELD_OPERATORS. */
|
|
45
43
|
var DOCUMENTED_FIELD_OPERATORS = "$eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $exists, $regex";
|
|
46
|
-
var mongooseTypeToZod = function (schemaPath) {
|
|
47
|
-
var _a, _b;
|
|
48
|
-
var instance = schemaPath.instance;
|
|
49
|
-
switch (instance) {
|
|
50
|
-
case "String":
|
|
51
|
-
if ((_a = schemaPath.enumValues) === null || _a === void 0 ? void 0 : _a.length) {
|
|
52
|
-
var values = schemaPath.enumValues;
|
|
53
|
-
return zod_1.z.enum(values);
|
|
54
|
-
}
|
|
55
|
-
return zod_1.z.string();
|
|
56
|
-
case "Number":
|
|
57
|
-
return zod_1.z.number();
|
|
58
|
-
case "Boolean":
|
|
59
|
-
return zod_1.z.boolean();
|
|
60
|
-
case "Date":
|
|
61
|
-
return zod_1.z.string().describe("ISO 8601 date string");
|
|
62
|
-
case "ObjectId":
|
|
63
|
-
case "ObjectID":
|
|
64
|
-
return zod_1.z
|
|
65
|
-
.string()
|
|
66
|
-
.describe(((_b = schemaPath.options) === null || _b === void 0 ? void 0 : _b.ref) ? "ObjectId reference to ".concat(schemaPath.options.ref) : "ObjectId");
|
|
67
|
-
case "Array": {
|
|
68
|
-
if (schemaPath.schema) {
|
|
69
|
-
// Array of subdocuments
|
|
70
|
-
return zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.any())).describe("Array of subdocuments");
|
|
71
|
-
}
|
|
72
|
-
// Array of primitives
|
|
73
|
-
var caster = schemaPath.caster;
|
|
74
|
-
if (caster) {
|
|
75
|
-
var innerType = mongooseTypeToZod({
|
|
76
|
-
instance: caster.instance,
|
|
77
|
-
options: caster.options,
|
|
78
|
-
});
|
|
79
|
-
return zod_1.z.array(innerType);
|
|
80
|
-
}
|
|
81
|
-
return zod_1.z.array(zod_1.z.any());
|
|
82
|
-
}
|
|
83
|
-
case "Mixed":
|
|
84
|
-
case "Map":
|
|
85
|
-
return zod_1.z.record(zod_1.z.string(), zod_1.z.any());
|
|
86
|
-
case "Embedded":
|
|
87
|
-
return zod_1.z.record(zod_1.z.string(), zod_1.z.any()).describe("Embedded document");
|
|
88
|
-
default:
|
|
89
|
-
return zod_1.z.any();
|
|
90
|
-
}
|
|
91
|
-
};
|
|
92
44
|
var isFieldExcluded = function (fieldPath, excludeFields) {
|
|
93
45
|
return excludeFields.some(function (excluded) {
|
|
94
46
|
if (fieldPath === excluded) {
|
|
95
47
|
return true;
|
|
96
48
|
}
|
|
97
|
-
// Support dot-notation parent matching: excluding "metadata" excludes "metadata.secretKey"
|
|
98
49
|
if (fieldPath.startsWith("".concat(excluded, "."))) {
|
|
99
50
|
return true;
|
|
100
51
|
}
|
|
@@ -102,10 +53,6 @@ var isFieldExcluded = function (fieldPath, excludeFields) {
|
|
|
102
53
|
});
|
|
103
54
|
};
|
|
104
55
|
exports.isFieldExcluded = isFieldExcluded;
|
|
105
|
-
/**
|
|
106
|
-
* REST write denylist from `validation.excludeFromCreate` / `excludeFromUpdate`.
|
|
107
|
-
* MCP create/update must apply the same keys REST strips in `validateModelRequestBody`.
|
|
108
|
-
*/
|
|
109
56
|
var restWriteExcludeFields = function (method, validation) {
|
|
110
57
|
var _a, _b;
|
|
111
58
|
if (typeof validation !== "object" || validation === null) {
|
|
@@ -121,58 +68,47 @@ var restWriteExcludeFields = function (method, validation) {
|
|
|
121
68
|
return [];
|
|
122
69
|
};
|
|
123
70
|
exports.restWriteExcludeFields = restWriteExcludeFields;
|
|
124
|
-
/** MCP `excludeFields` plus REST write denylist — used for tool schemas and persist. */
|
|
125
71
|
var writeExcludeFields = function (config, restExcludeFields) {
|
|
126
72
|
var _a;
|
|
127
73
|
return __spreadArray(__spreadArray([], __read(((_a = config.excludeFields) !== null && _a !== void 0 ? _a : [])), false), __read(restExcludeFields), false);
|
|
128
74
|
};
|
|
129
75
|
exports.writeExcludeFields = writeExcludeFields;
|
|
130
|
-
var getModelFields = function (
|
|
131
|
-
// noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
|
|
132
|
-
// biome-ignore lint/suspicious/noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
|
|
133
|
-
model, excludeFields) {
|
|
76
|
+
var getModelFields = function (model, excludeFields) {
|
|
134
77
|
var e_1, _a;
|
|
135
|
-
var
|
|
78
|
+
var description = (0, schemaMetadata_1.describeModel)(model);
|
|
136
79
|
var fields = [];
|
|
137
|
-
var schemaPaths = model.schema.paths;
|
|
138
80
|
try {
|
|
139
|
-
for (var
|
|
140
|
-
var
|
|
141
|
-
if (
|
|
81
|
+
for (var _b = __values(Object.entries(description.fields)), _c = _b.next(); !_c.done; _c = _b.next()) {
|
|
82
|
+
var _d = __read(_c.value, 2), path = _d[0], field = _d[1];
|
|
83
|
+
if (schemaMetadata_1.SYSTEM_FIELD_PATHS.has(path) || field.system) {
|
|
142
84
|
continue;
|
|
143
85
|
}
|
|
144
86
|
if ((0, exports.isFieldExcluded)(path, excludeFields)) {
|
|
145
87
|
continue;
|
|
146
88
|
}
|
|
147
|
-
var schemaPath = rawSchemaPath;
|
|
148
89
|
fields.push({
|
|
149
|
-
description:
|
|
90
|
+
description: field.description,
|
|
91
|
+
field: field,
|
|
150
92
|
path: path,
|
|
151
|
-
required:
|
|
152
|
-
schemaPath: schemaPath,
|
|
93
|
+
required: field.required,
|
|
153
94
|
});
|
|
154
95
|
}
|
|
155
96
|
}
|
|
156
97
|
catch (e_1_1) { e_1 = { error: e_1_1 }; }
|
|
157
98
|
finally {
|
|
158
99
|
try {
|
|
159
|
-
if (
|
|
100
|
+
if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
|
|
160
101
|
}
|
|
161
102
|
finally { if (e_1) throw e_1.error; }
|
|
162
103
|
}
|
|
163
104
|
return fields;
|
|
164
105
|
};
|
|
165
|
-
var generateInputSchema = function (
|
|
166
|
-
// noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
|
|
167
|
-
// biome-ignore lint/suspicious/noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
|
|
168
|
-
model, method, config, queryFields, populatePaths, restExcludeFields) {
|
|
106
|
+
var generateInputSchema = function (model, method, config, queryFields, populatePaths, restExcludeFields) {
|
|
169
107
|
var e_2, _a, e_3, _b, e_4, _c;
|
|
170
108
|
var _d;
|
|
171
109
|
if (restExcludeFields === void 0) { restExcludeFields = []; }
|
|
172
110
|
var excludeFields = (0, exports.writeExcludeFields)(config, restExcludeFields);
|
|
173
111
|
var populatable = (populatePaths !== null && populatePaths !== void 0 ? populatePaths : []).map(function (populatePath) { return populatePath.path; });
|
|
174
|
-
// Only the model router's declared paths can be populated, so omit the parameter
|
|
175
|
-
// entirely when there are none rather than inviting a request that must be refused.
|
|
176
112
|
var populateParam = populatable.length
|
|
177
113
|
? zod_1.z
|
|
178
114
|
.string()
|
|
@@ -185,12 +121,9 @@ model, method, config, queryFields, populatePaths, restExcludeFields) {
|
|
|
185
121
|
var shape = {};
|
|
186
122
|
try {
|
|
187
123
|
for (var fields_1 = __values(fields), fields_1_1 = fields_1.next(); !fields_1_1.done; fields_1_1 = fields_1.next()) {
|
|
188
|
-
var
|
|
189
|
-
var zodType =
|
|
190
|
-
|
|
191
|
-
zodType = zodType.describe(field.description);
|
|
192
|
-
}
|
|
193
|
-
shape[field.path] = field.required ? zodType : zodType.optional();
|
|
124
|
+
var _e = fields_1_1.value, field = _e.field, path = _e.path, required = _e.required;
|
|
125
|
+
var zodType = (0, schemaMetadata_1.fieldDescriptionToZodType)(field, zod_1.z);
|
|
126
|
+
shape[path] = required ? zodType : zodType.optional();
|
|
194
127
|
}
|
|
195
128
|
}
|
|
196
129
|
catch (e_2_1) { e_2 = { error: e_2_1 }; }
|
|
@@ -209,12 +142,8 @@ model, method, config, queryFields, populatePaths, restExcludeFields) {
|
|
|
209
142
|
};
|
|
210
143
|
try {
|
|
211
144
|
for (var fields_2 = __values(fields), fields_2_1 = fields_2.next(); !fields_2_1.done; fields_2_1 = fields_2.next()) {
|
|
212
|
-
var
|
|
213
|
-
|
|
214
|
-
if (field.description) {
|
|
215
|
-
zodType = zodType.describe(field.description);
|
|
216
|
-
}
|
|
217
|
-
shape[field.path] = zodType.optional();
|
|
145
|
+
var _f = fields_2_1.value, field = _f.field, path = _f.path;
|
|
146
|
+
shape[path] = (0, schemaMetadata_1.fieldDescriptionToZodType)(field, zod_1.z).optional();
|
|
218
147
|
}
|
|
219
148
|
}
|
|
220
149
|
catch (e_3_1) { e_3 = { error: e_3_1 }; }
|
|
@@ -247,7 +176,6 @@ model, method, config, queryFields, populatePaths, restExcludeFields) {
|
|
|
247
176
|
if (populateParam) {
|
|
248
177
|
shape.populate = populateParam;
|
|
249
178
|
}
|
|
250
|
-
// Add queryFields as optional filter parameters
|
|
251
179
|
var filterableFields = (queryFields !== null && queryFields !== void 0 ? queryFields : []).filter(function (field) { return !(0, exports.isFieldExcluded)(field, excludeFields); });
|
|
252
180
|
try {
|
|
253
181
|
for (var filterableFields_1 = __values(filterableFields), filterableFields_1_1 = filterableFields_1.next(); !filterableFields_1_1.done; filterableFields_1_1 = filterableFields_1.next()) {
|
|
@@ -287,38 +215,37 @@ model, method, config, queryFields, populatePaths, restExcludeFields) {
|
|
|
287
215
|
}
|
|
288
216
|
};
|
|
289
217
|
exports.generateInputSchema = generateInputSchema;
|
|
290
|
-
var
|
|
291
|
-
var _a, _b
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
if ((_b = field.schemaPath.caster) === null || _b === void 0 ? void 0 : _b.instance) {
|
|
301
|
-
parts.push("(".concat(field.schemaPath.caster.instance, "[])"));
|
|
302
|
-
}
|
|
303
|
-
else {
|
|
304
|
-
parts.push("(Array)");
|
|
218
|
+
var describeFieldKind = function (field) {
|
|
219
|
+
var _a, _b;
|
|
220
|
+
if (field.isArray) {
|
|
221
|
+
if ((_a = field.item) === null || _a === void 0 ? void 0 : _a.kind) {
|
|
222
|
+
var itemLabel = field.item.kind === "objectId"
|
|
223
|
+
? field.item.ref
|
|
224
|
+
? "ref:".concat(field.item.ref)
|
|
225
|
+
: "ObjectId"
|
|
226
|
+
: field.item.kind.charAt(0).toUpperCase() + field.item.kind.slice(1);
|
|
227
|
+
return "(".concat(itemLabel, "[])");
|
|
305
228
|
}
|
|
229
|
+
return "(Array)";
|
|
306
230
|
}
|
|
307
|
-
|
|
308
|
-
|
|
231
|
+
if (field.kind === "objectId") {
|
|
232
|
+
return field.ref ? "(ref: ".concat(field.ref, ")") : "(ObjectId)";
|
|
309
233
|
}
|
|
310
|
-
|
|
311
|
-
|
|
234
|
+
if (field.kind === "string" && ((_b = field.enum) === null || _b === void 0 ? void 0 : _b.length)) {
|
|
235
|
+
return "(enum: ".concat(field.enum.join("|"), ")");
|
|
312
236
|
}
|
|
313
|
-
|
|
237
|
+
var label = field.kind.charAt(0).toUpperCase() + field.kind.slice(1);
|
|
238
|
+
return "(".concat(label, ")");
|
|
239
|
+
};
|
|
240
|
+
var describeField = function (_a) {
|
|
241
|
+
var field = _a.field, path = _a.path, required = _a.required;
|
|
242
|
+
var parts = [path, describeFieldKind(field)];
|
|
243
|
+
if (required) {
|
|
314
244
|
parts.push("required");
|
|
315
245
|
}
|
|
316
246
|
return parts.join(" ");
|
|
317
247
|
};
|
|
318
|
-
var generateToolDescription = function (
|
|
319
|
-
// noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
|
|
320
|
-
// biome-ignore lint/suspicious/noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
|
|
321
|
-
model, method, config, queryFields, populatePaths, restExcludeFields) {
|
|
248
|
+
var generateToolDescription = function (model, method, config, queryFields, populatePaths, restExcludeFields) {
|
|
322
249
|
var _a;
|
|
323
250
|
if (restExcludeFields === void 0) { restExcludeFields = []; }
|
|
324
251
|
if (config.description) {
|
|
@@ -341,14 +268,12 @@ model, method, config, queryFields, populatePaths, restExcludeFields) {
|
|
|
341
268
|
}
|
|
342
269
|
case "read": {
|
|
343
270
|
var parts = ["Read a single ".concat(modelName, " by ID.")];
|
|
344
|
-
// Only the model router's declared paths can be populated, so advertising every ref
|
|
345
|
-
// field would point the model at requests that are refused.
|
|
346
271
|
var fields_3 = getModelFields(model, excludeFields);
|
|
347
272
|
var refFields = (populatePaths !== null && populatePaths !== void 0 ? populatePaths : [])
|
|
348
273
|
.map(function (populatePath) { return fields_3.find(function (field) { return field.path === populatePath.path; }); })
|
|
349
|
-
.filter(function (field) {
|
|
274
|
+
.filter(function (field) { return Boolean(field === null || field === void 0 ? void 0 : field.field.ref); });
|
|
350
275
|
if (refFields.length) {
|
|
351
|
-
parts.push("Populate-able refs: ".concat(refFields.map(function (f) {
|
|
276
|
+
parts.push("Populate-able refs: ".concat(refFields.map(function (f) { return "".concat(f.path, " (").concat(f.field.ref, ")"); }).join(", "), "."));
|
|
352
277
|
}
|
|
353
278
|
return parts.join(" ");
|
|
354
279
|
}
|
package/dist/mcp/server.d.ts
CHANGED
|
@@ -4,5 +4,6 @@ import type { BetterAuthInstance } from "../betterAuthSetup";
|
|
|
4
4
|
export interface MCPServerOptions {
|
|
5
5
|
userModel: UserModel;
|
|
6
6
|
betterAuth?: BetterAuthInstance;
|
|
7
|
+
mcpServiceTokens?: boolean;
|
|
7
8
|
}
|
|
8
9
|
export declare const mountMCPServer: (app: Application, options: MCPServerOptions) => void;
|
package/dist/mcp/server.js
CHANGED
|
@@ -61,6 +61,7 @@ var mountMCPServer = function (app, options) {
|
|
|
61
61
|
}
|
|
62
62
|
var authContext = {
|
|
63
63
|
betterAuth: options.betterAuth,
|
|
64
|
+
mcpServiceTokens: options.mcpServiceTokens,
|
|
64
65
|
userModel: options.userModel,
|
|
65
66
|
};
|
|
66
67
|
logger_1.logger.info("Mounting MCP server with ".concat(tools.length, " tools at /mcp"));
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import type { Application } from "express";
|
|
2
|
+
import { type OpenApiMiddleware } from "../api";
|
|
3
|
+
export declare const MAX_ACTIVE_MCP_SERVICE_TOKENS = 10;
|
|
4
|
+
export interface McpServiceTokenRoutesOptions {
|
|
5
|
+
openApi?: OpenApiMiddleware;
|
|
6
|
+
publicMcpUrl?: string;
|
|
7
|
+
}
|
|
8
|
+
export type McpServiceTokensAppOption = boolean | {
|
|
9
|
+
enabled: boolean;
|
|
10
|
+
publicMcpUrl?: string;
|
|
11
|
+
};
|
|
12
|
+
export declare const resolveMcpServiceTokensOption: (option: McpServiceTokensAppOption | undefined) => {
|
|
13
|
+
enabled: boolean;
|
|
14
|
+
publicMcpUrl?: string;
|
|
15
|
+
};
|
|
16
|
+
export declare const addMcpServiceTokenRoutes: (app: Application, options?: McpServiceTokenRoutesOptions) => void;
|
|
@@ -0,0 +1,345 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
|
|
3
|
+
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
|
|
4
|
+
return new (P || (P = Promise))(function (resolve, reject) {
|
|
5
|
+
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
|
|
6
|
+
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
|
|
7
|
+
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
|
|
8
|
+
step((generator = generator.apply(thisArg, _arguments || [])).next());
|
|
9
|
+
});
|
|
10
|
+
};
|
|
11
|
+
var __generator = (this && this.__generator) || function (thisArg, body) {
|
|
12
|
+
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
|
|
13
|
+
return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
|
|
14
|
+
function verb(n) { return function (v) { return step([n, v]); }; }
|
|
15
|
+
function step(op) {
|
|
16
|
+
if (f) throw new TypeError("Generator is already executing.");
|
|
17
|
+
while (g && (g = 0, op[0] && (_ = 0)), _) try {
|
|
18
|
+
if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
|
|
19
|
+
if (y = 0, t) op = [op[0] & 2, t.value];
|
|
20
|
+
switch (op[0]) {
|
|
21
|
+
case 0: case 1: t = op; break;
|
|
22
|
+
case 4: _.label++; return { value: op[1], done: false };
|
|
23
|
+
case 5: _.label++; y = op[1]; op = [0]; continue;
|
|
24
|
+
case 7: op = _.ops.pop(); _.trys.pop(); continue;
|
|
25
|
+
default:
|
|
26
|
+
if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
|
|
27
|
+
if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
|
|
28
|
+
if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
|
|
29
|
+
if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
|
|
30
|
+
if (t[2]) _.ops.pop();
|
|
31
|
+
_.trys.pop(); continue;
|
|
32
|
+
}
|
|
33
|
+
op = body.call(thisArg, _);
|
|
34
|
+
} catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
|
|
35
|
+
if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
|
|
36
|
+
}
|
|
37
|
+
};
|
|
38
|
+
var __read = (this && this.__read) || function (o, n) {
|
|
39
|
+
var m = typeof Symbol === "function" && o[Symbol.iterator];
|
|
40
|
+
if (!m) return o;
|
|
41
|
+
var i = m.call(o), r, ar = [], e;
|
|
42
|
+
try {
|
|
43
|
+
while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
|
|
44
|
+
}
|
|
45
|
+
catch (error) { e = { error: error }; }
|
|
46
|
+
finally {
|
|
47
|
+
try {
|
|
48
|
+
if (r && !r.done && (m = i["return"])) m.call(i);
|
|
49
|
+
}
|
|
50
|
+
finally { if (e) throw e.error; }
|
|
51
|
+
}
|
|
52
|
+
return ar;
|
|
53
|
+
};
|
|
54
|
+
var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
|
|
55
|
+
if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
|
|
56
|
+
if (ar || !(i in from)) {
|
|
57
|
+
if (!ar) ar = Array.prototype.slice.call(from, 0, i);
|
|
58
|
+
ar[i] = from[i];
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
return to.concat(ar || Array.prototype.slice.call(from));
|
|
62
|
+
};
|
|
63
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
64
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
65
|
+
};
|
|
66
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
67
|
+
exports.addMcpServiceTokenRoutes = exports.resolveMcpServiceTokensOption = exports.MAX_ACTIVE_MCP_SERVICE_TOKENS = void 0;
|
|
68
|
+
var luxon_1 = require("luxon");
|
|
69
|
+
var mongoose_1 = __importDefault(require("mongoose"));
|
|
70
|
+
var api_1 = require("../api");
|
|
71
|
+
var auth_1 = require("../auth");
|
|
72
|
+
var errors_1 = require("../errors");
|
|
73
|
+
var mcpServiceToken_1 = require("../models/mcpServiceToken");
|
|
74
|
+
var openApiBuilder_1 = require("../openApiBuilder");
|
|
75
|
+
exports.MAX_ACTIVE_MCP_SERVICE_TOKENS = 10;
|
|
76
|
+
var DEFAULT_LIST_LIMIT = 100;
|
|
77
|
+
var MAX_LIST_LIMIT = 100;
|
|
78
|
+
var resolveMcpServiceTokensOption = function (option) {
|
|
79
|
+
if (option === true) {
|
|
80
|
+
return { enabled: true };
|
|
81
|
+
}
|
|
82
|
+
if (option && typeof option === "object" && option.enabled === true) {
|
|
83
|
+
return { enabled: true, publicMcpUrl: option.publicMcpUrl };
|
|
84
|
+
}
|
|
85
|
+
return { enabled: false };
|
|
86
|
+
};
|
|
87
|
+
exports.resolveMcpServiceTokensOption = resolveMcpServiceTokensOption;
|
|
88
|
+
var bearerFromRequest = function (req) {
|
|
89
|
+
var authorization = req.headers.authorization;
|
|
90
|
+
if (typeof authorization !== "string") {
|
|
91
|
+
return undefined;
|
|
92
|
+
}
|
|
93
|
+
if (authorization.startsWith("Bearer ")) {
|
|
94
|
+
return authorization.slice("Bearer ".length);
|
|
95
|
+
}
|
|
96
|
+
return authorization;
|
|
97
|
+
};
|
|
98
|
+
var rejectMcpServiceTokenBearer = function (req, _res, next) {
|
|
99
|
+
var token = bearerFromRequest(req);
|
|
100
|
+
if (token === null || token === void 0 ? void 0 : token.startsWith("mcp_")) {
|
|
101
|
+
next(new errors_1.UnauthorizedError("MCP service tokens cannot manage service tokens"));
|
|
102
|
+
return;
|
|
103
|
+
}
|
|
104
|
+
next();
|
|
105
|
+
};
|
|
106
|
+
var requireAuthenticatedUser = function (req) {
|
|
107
|
+
var user = req.user;
|
|
108
|
+
if (!(user === null || user === void 0 ? void 0 : user._id)) {
|
|
109
|
+
throw new errors_1.UnauthorizedError("Unauthorized");
|
|
110
|
+
}
|
|
111
|
+
return user;
|
|
112
|
+
};
|
|
113
|
+
var parseName = function (value) {
|
|
114
|
+
if (typeof value !== "string") {
|
|
115
|
+
throw new errors_1.BadRequestError({ title: "name is required" });
|
|
116
|
+
}
|
|
117
|
+
var name = value.trim();
|
|
118
|
+
if (!name) {
|
|
119
|
+
throw new errors_1.BadRequestError({ title: "name is required" });
|
|
120
|
+
}
|
|
121
|
+
return name;
|
|
122
|
+
};
|
|
123
|
+
var parseExpiresAt = function (value) {
|
|
124
|
+
if (value === undefined || value === null || value === "") {
|
|
125
|
+
return undefined;
|
|
126
|
+
}
|
|
127
|
+
if (typeof value !== "string") {
|
|
128
|
+
throw new errors_1.BadRequestError({ title: "expiresAt must be an ISO-8601 datetime string" });
|
|
129
|
+
}
|
|
130
|
+
var parsed = luxon_1.DateTime.fromISO(value, { setZone: true });
|
|
131
|
+
if (!parsed.isValid) {
|
|
132
|
+
throw new errors_1.BadRequestError({ title: "expiresAt must be an ISO-8601 datetime string" });
|
|
133
|
+
}
|
|
134
|
+
if (parsed.toMillis() <= luxon_1.DateTime.now().toMillis()) {
|
|
135
|
+
throw new errors_1.BadRequestError({ title: "expiresAt must be in the future" });
|
|
136
|
+
}
|
|
137
|
+
return parsed.toUTC().toJSDate();
|
|
138
|
+
};
|
|
139
|
+
var parsePage = function (value) {
|
|
140
|
+
if (value === undefined) {
|
|
141
|
+
return 1;
|
|
142
|
+
}
|
|
143
|
+
var page = Number(value);
|
|
144
|
+
if (!Number.isInteger(page) || page < 1) {
|
|
145
|
+
throw new errors_1.BadRequestError({ code: "invalid-page", title: "Invalid page" });
|
|
146
|
+
}
|
|
147
|
+
return page;
|
|
148
|
+
};
|
|
149
|
+
var parseLimit = function (value) {
|
|
150
|
+
if (value === undefined) {
|
|
151
|
+
return DEFAULT_LIST_LIMIT;
|
|
152
|
+
}
|
|
153
|
+
var limit = Number(value);
|
|
154
|
+
if (!Number.isInteger(limit) || limit < 1) {
|
|
155
|
+
throw new errors_1.BadRequestError({ title: "Invalid limit" });
|
|
156
|
+
}
|
|
157
|
+
return Math.min(limit, MAX_LIST_LIMIT);
|
|
158
|
+
};
|
|
159
|
+
var resolveMcpUrl = function (req, publicMcpUrl) {
|
|
160
|
+
var _a;
|
|
161
|
+
var configured = publicMcpUrl !== null && publicMcpUrl !== void 0 ? publicMcpUrl : process.env.BETTER_AUTH_URL;
|
|
162
|
+
if (configured) {
|
|
163
|
+
var base = configured.replace(/\/$/, "");
|
|
164
|
+
if (base.endsWith("/mcp")) {
|
|
165
|
+
return base;
|
|
166
|
+
}
|
|
167
|
+
return "".concat(base, "/mcp");
|
|
168
|
+
}
|
|
169
|
+
var host = (_a = req.get("host")) !== null && _a !== void 0 ? _a : "localhost";
|
|
170
|
+
return "".concat(req.protocol, "://").concat(host, "/mcp");
|
|
171
|
+
};
|
|
172
|
+
var toListItem = function (doc) {
|
|
173
|
+
return {
|
|
174
|
+
created: doc.created.toISOString(),
|
|
175
|
+
expiresAt: doc.expiresAt ? doc.expiresAt.toISOString() : null,
|
|
176
|
+
id: String(doc._id),
|
|
177
|
+
lastUsedAt: doc.lastUsedAt ? doc.lastUsedAt.toISOString() : null,
|
|
178
|
+
name: doc.name,
|
|
179
|
+
revokedAt: doc.revokedAt ? doc.revokedAt.toISOString() : null,
|
|
180
|
+
tokenPrefix: doc.tokenPrefix,
|
|
181
|
+
};
|
|
182
|
+
};
|
|
183
|
+
var serviceTokenGuards = [rejectMcpServiceTokenBearer, (0, auth_1.authenticateMiddleware)()];
|
|
184
|
+
var createdTokenFields = {
|
|
185
|
+
created: { type: "string" },
|
|
186
|
+
expiresAt: { type: "string" },
|
|
187
|
+
id: { type: "string" },
|
|
188
|
+
mcpUrl: { type: "string" },
|
|
189
|
+
name: { type: "string" },
|
|
190
|
+
token: { type: "string" },
|
|
191
|
+
tokenPrefix: { type: "string" },
|
|
192
|
+
};
|
|
193
|
+
var addMcpServiceTokenRoutes = function (app, options) {
|
|
194
|
+
if (options === void 0) { options = {}; }
|
|
195
|
+
var openApiOptions = { openApi: options.openApi };
|
|
196
|
+
app.post("/mcp/service-tokens", __spreadArray(__spreadArray([], __read(serviceTokenGuards), false), [
|
|
197
|
+
(0, openApiBuilder_1.createOpenApiBuilder)(openApiOptions)
|
|
198
|
+
.withTags(["mcp"])
|
|
199
|
+
.withOperationId("createMcpServiceToken")
|
|
200
|
+
.withSummary("Create an MCP service token")
|
|
201
|
+
.withDescription("Mints a personal MCP service token that acts as the signed-in user on POST /mcp. The plaintext token is returned once.")
|
|
202
|
+
.withRequestBody({
|
|
203
|
+
expiresAt: {
|
|
204
|
+
description: "Optional ISO-8601 expiry; omit for a token that does not expire",
|
|
205
|
+
type: "string",
|
|
206
|
+
},
|
|
207
|
+
name: {
|
|
208
|
+
description: "User-visible label for this token",
|
|
209
|
+
required: true,
|
|
210
|
+
type: "string",
|
|
211
|
+
},
|
|
212
|
+
})
|
|
213
|
+
.withResponse(200, {
|
|
214
|
+
data: {
|
|
215
|
+
properties: createdTokenFields,
|
|
216
|
+
type: "object",
|
|
217
|
+
},
|
|
218
|
+
})
|
|
219
|
+
.build(),
|
|
220
|
+
], false), (0, api_1.asyncHandler)(function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
|
|
221
|
+
var user, name, expiresAt, activeCount, issued;
|
|
222
|
+
var _a, _b;
|
|
223
|
+
return __generator(this, function (_c) {
|
|
224
|
+
switch (_c.label) {
|
|
225
|
+
case 0:
|
|
226
|
+
user = requireAuthenticatedUser(req);
|
|
227
|
+
name = parseName((_a = req.body) === null || _a === void 0 ? void 0 : _a.name);
|
|
228
|
+
expiresAt = parseExpiresAt((_b = req.body) === null || _b === void 0 ? void 0 : _b.expiresAt);
|
|
229
|
+
return [4 /*yield*/, mcpServiceToken_1.McpServiceToken.countActiveForUser(new mongoose_1.default.Types.ObjectId(String(user._id)))];
|
|
230
|
+
case 1:
|
|
231
|
+
activeCount = _c.sent();
|
|
232
|
+
if (activeCount >= exports.MAX_ACTIVE_MCP_SERVICE_TOKENS) {
|
|
233
|
+
throw new errors_1.BadRequestError({
|
|
234
|
+
title: "Maximum of ".concat(exports.MAX_ACTIVE_MCP_SERVICE_TOKENS, " active MCP service tokens"),
|
|
235
|
+
});
|
|
236
|
+
}
|
|
237
|
+
return [4 /*yield*/, mcpServiceToken_1.McpServiceToken.issueFor({ _id: user._id }, { expiresAt: expiresAt, name: name })];
|
|
238
|
+
case 2:
|
|
239
|
+
issued = _c.sent();
|
|
240
|
+
return [2 /*return*/, res.json({
|
|
241
|
+
data: {
|
|
242
|
+
created: issued.mcpServiceToken.created.toISOString(),
|
|
243
|
+
expiresAt: issued.mcpServiceToken.expiresAt
|
|
244
|
+
? issued.mcpServiceToken.expiresAt.toISOString()
|
|
245
|
+
: null,
|
|
246
|
+
id: String(issued.mcpServiceToken._id),
|
|
247
|
+
mcpUrl: resolveMcpUrl(req, options.publicMcpUrl),
|
|
248
|
+
name: issued.mcpServiceToken.name,
|
|
249
|
+
token: issued.token,
|
|
250
|
+
tokenPrefix: issued.mcpServiceToken.tokenPrefix,
|
|
251
|
+
},
|
|
252
|
+
})];
|
|
253
|
+
}
|
|
254
|
+
});
|
|
255
|
+
}); }));
|
|
256
|
+
app.get("/mcp/service-tokens", __spreadArray(__spreadArray([], __read(serviceTokenGuards), false), [
|
|
257
|
+
(0, openApiBuilder_1.createOpenApiBuilder)(openApiOptions)
|
|
258
|
+
.withTags(["mcp"])
|
|
259
|
+
.withOperationId("listMcpServiceTokens")
|
|
260
|
+
.withSummary("List MCP service tokens")
|
|
261
|
+
.withDescription("Lists MCP service tokens owned by the signed-in user. Never includes plaintext or tokenHash.")
|
|
262
|
+
.withQueryParameter("page", { type: "number" }, { required: false })
|
|
263
|
+
.withQueryParameter("limit", { type: "number" }, { required: false })
|
|
264
|
+
.withResponse(200, {
|
|
265
|
+
data: { type: "array" },
|
|
266
|
+
limit: { type: "number" },
|
|
267
|
+
more: { type: "boolean" },
|
|
268
|
+
page: { type: "number" },
|
|
269
|
+
total: { type: "number" },
|
|
270
|
+
})
|
|
271
|
+
.build(),
|
|
272
|
+
], false), (0, api_1.asyncHandler)(function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
|
|
273
|
+
var user, page, limit, filter, total, docs, more, pageDocs;
|
|
274
|
+
return __generator(this, function (_a) {
|
|
275
|
+
switch (_a.label) {
|
|
276
|
+
case 0:
|
|
277
|
+
user = requireAuthenticatedUser(req);
|
|
278
|
+
page = parsePage(req.query.page);
|
|
279
|
+
limit = parseLimit(req.query.limit);
|
|
280
|
+
filter = { userId: new mongoose_1.default.Types.ObjectId(String(user._id)) };
|
|
281
|
+
return [4 /*yield*/, mcpServiceToken_1.McpServiceToken.countDocuments(filter)];
|
|
282
|
+
case 1:
|
|
283
|
+
total = _a.sent();
|
|
284
|
+
return [4 /*yield*/, mcpServiceToken_1.McpServiceToken.find(filter)
|
|
285
|
+
.sort("-created")
|
|
286
|
+
.skip((page - 1) * limit)
|
|
287
|
+
.limit(limit + 1)];
|
|
288
|
+
case 2:
|
|
289
|
+
docs = _a.sent();
|
|
290
|
+
more = docs.length > limit;
|
|
291
|
+
pageDocs = more ? docs.slice(0, limit) : docs;
|
|
292
|
+
return [2 /*return*/, res.json({
|
|
293
|
+
data: pageDocs.map(toListItem),
|
|
294
|
+
limit: limit,
|
|
295
|
+
more: more,
|
|
296
|
+
page: page,
|
|
297
|
+
total: total,
|
|
298
|
+
})];
|
|
299
|
+
}
|
|
300
|
+
});
|
|
301
|
+
}); }));
|
|
302
|
+
app.delete("/mcp/service-tokens/:id", __spreadArray(__spreadArray([], __read(serviceTokenGuards), false), [
|
|
303
|
+
(0, openApiBuilder_1.createOpenApiBuilder)(openApiOptions)
|
|
304
|
+
.withTags(["mcp"])
|
|
305
|
+
.withOperationId("revokeMcpServiceToken")
|
|
306
|
+
.withSummary("Revoke an MCP service token")
|
|
307
|
+
.withDescription("Sets revokedAt on a token owned by the signed-in user.")
|
|
308
|
+
.withPathParameter("id", { type: "string" })
|
|
309
|
+
.withResponse(200, {
|
|
310
|
+
data: {
|
|
311
|
+
properties: {
|
|
312
|
+
id: { type: "string" },
|
|
313
|
+
revokedAt: { type: "string" },
|
|
314
|
+
},
|
|
315
|
+
type: "object",
|
|
316
|
+
},
|
|
317
|
+
})
|
|
318
|
+
.build(),
|
|
319
|
+
], false), (0, api_1.asyncHandler)(function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
|
|
320
|
+
var user, tokenId, revoked;
|
|
321
|
+
return __generator(this, function (_a) {
|
|
322
|
+
switch (_a.label) {
|
|
323
|
+
case 0:
|
|
324
|
+
user = requireAuthenticatedUser(req);
|
|
325
|
+
tokenId = req.params.id;
|
|
326
|
+
if (!mongoose_1.default.Types.ObjectId.isValid(tokenId)) {
|
|
327
|
+
throw new errors_1.NotFoundError("MCP service token not found");
|
|
328
|
+
}
|
|
329
|
+
return [4 /*yield*/, mcpServiceToken_1.McpServiceToken.revokeForUser({ _id: user._id }, new mongoose_1.default.Types.ObjectId(tokenId))];
|
|
330
|
+
case 1:
|
|
331
|
+
revoked = _a.sent();
|
|
332
|
+
if (!revoked) {
|
|
333
|
+
throw new errors_1.NotFoundError("MCP service token not found");
|
|
334
|
+
}
|
|
335
|
+
return [2 /*return*/, res.json({
|
|
336
|
+
data: {
|
|
337
|
+
id: String(revoked._id),
|
|
338
|
+
revokedAt: revoked.revokedAt ? revoked.revokedAt.toISOString() : null,
|
|
339
|
+
},
|
|
340
|
+
})];
|
|
341
|
+
}
|
|
342
|
+
});
|
|
343
|
+
}); }));
|
|
344
|
+
};
|
|
345
|
+
exports.addMcpServiceTokenRoutes = addMcpServiceTokenRoutes;
|
package/dist/mcp/types.d.ts
CHANGED