@terreno/api 57.2.0 → 57.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
- package/README.md +23 -7
- package/dist/actions.js +19 -7
- package/dist/adminTypes.d.ts +7 -0
- package/dist/adminTypes.js +6 -1
- package/dist/api.d.ts +14 -0
- package/dist/api.js +111 -60
- package/dist/audit/auditApp.d.ts +30 -0
- package/dist/audit/auditApp.js +155 -0
- package/dist/audit/auditEventModel.d.ts +29 -0
- package/dist/audit/auditEventModel.js +102 -0
- package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
- package/dist/audit/cloudTasksEnqueue.js +162 -0
- package/dist/audit/diff.d.ts +10 -0
- package/dist/audit/diff.js +230 -0
- package/dist/audit/processQueue.d.ts +6 -0
- package/dist/audit/processQueue.js +101 -0
- package/dist/audit/rbacSink.d.ts +2 -0
- package/dist/audit/rbacSink.js +82 -0
- package/dist/audit/record.d.ts +56 -0
- package/dist/audit/record.js +373 -0
- package/dist/auth.d.ts +23 -10
- package/dist/auth.js +97 -32
- package/dist/authRecovery.d.ts +5 -0
- package/dist/authRecovery.js +350 -0
- package/dist/authTokens.d.ts +8 -0
- package/dist/authTokens.js +162 -0
- package/dist/betterAuth.d.ts +39 -0
- package/dist/betterAuthApp.d.ts +4 -0
- package/dist/betterAuthApp.js +26 -8
- package/dist/betterAuthSetup.d.ts +44 -2
- package/dist/betterAuthSetup.js +288 -18
- package/dist/collectionRegistry.d.ts +40 -0
- package/dist/collectionRegistry.js +97 -0
- package/dist/configurationApp.d.ts +11 -2
- package/dist/configurationApp.js +2 -4
- package/dist/docLoader.js +35 -6
- package/dist/expressServer.d.ts +26 -3
- package/dist/expressServer.js +79 -11
- package/dist/index.d.ts +42 -1
- package/dist/index.js +84 -2
- package/dist/mcp/auth.d.ts +1 -0
- package/dist/mcp/auth.js +47 -25
- package/dist/mcp/handlers.d.ts +1 -1
- package/dist/mcp/handlers.js +67 -233
- package/dist/mcp/query.d.ts +2 -15
- package/dist/mcp/query.js +8 -8
- package/dist/mcp/registry.d.ts +1 -5
- package/dist/mcp/registry.js +31 -20
- package/dist/mcp/schemaGenerator.d.ts +2 -7
- package/dist/mcp/schemaGenerator.js +41 -116
- package/dist/mcp/server.d.ts +1 -0
- package/dist/mcp/server.js +1 -0
- package/dist/mcp/serviceTokens.d.ts +16 -0
- package/dist/mcp/serviceTokens.js +345 -0
- package/dist/mcp/types.d.ts +2 -2
- package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
- package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
- package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
- package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
- package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
- package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
- package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
- package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
- package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
- package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
- package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
- package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
- package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
- package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
- package/dist/migrations/generate.d.ts +17 -0
- package/dist/migrations/generate.js +277 -0
- package/dist/migrations/load.d.ts +20 -0
- package/dist/migrations/load.js +236 -0
- package/dist/migrations/lock.d.ts +13 -0
- package/dist/migrations/lock.js +145 -0
- package/dist/migrations/runner.d.ts +42 -0
- package/dist/migrations/runner.js +503 -0
- package/dist/migrations/schemaCatalog.d.ts +44 -0
- package/dist/migrations/schemaCatalog.js +326 -0
- package/dist/migrations/types.d.ts +87 -0
- package/dist/migrations/types.js +7 -0
- package/dist/models/mcpServiceToken.d.ts +3 -0
- package/dist/models/mcpServiceToken.js +208 -0
- package/dist/models/notification.d.ts +2 -0
- package/dist/models/notification.js +62 -0
- package/dist/models/notificationPreference.d.ts +2 -0
- package/dist/models/notificationPreference.js +49 -0
- package/dist/notifications/notificationService.d.ts +40 -0
- package/dist/notifications/notificationService.js +323 -0
- package/dist/notifications/notificationsApp.d.ts +18 -0
- package/dist/notifications/notificationsApp.js +250 -0
- package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
- package/dist/notifications/notificationsBeforeSend.js +77 -0
- package/dist/openApi.d.ts +1 -7
- package/dist/openApi.js +7 -6
- package/dist/openApiBuilder.d.ts +19 -7
- package/dist/openApiBuilder.js +61 -8
- package/dist/openApiCompat.js +1 -1
- package/dist/openApiValidator.d.ts +13 -1
- package/dist/openApiValidator.js +200 -38
- package/dist/orgs/orgContext.d.ts +23 -0
- package/dist/orgs/orgContext.js +198 -0
- package/dist/orgs/orgPermissions.d.ts +4 -0
- package/dist/orgs/orgPermissions.js +77 -0
- package/dist/orgs/orgPlugin.d.ts +13 -0
- package/dist/orgs/orgPlugin.js +84 -0
- package/dist/orgs/organizationModel.d.ts +13 -0
- package/dist/orgs/organizationModel.js +301 -0
- package/dist/orgs/organizationSettings.d.ts +19 -0
- package/dist/orgs/organizationSettings.js +120 -0
- package/dist/orgs/orgsApp.d.ts +28 -0
- package/dist/orgs/orgsApp.js +678 -0
- package/dist/permissions.d.ts +7 -13
- package/dist/permissions.js +8 -31
- package/dist/plugins.d.ts +14 -1
- package/dist/plugins.js +17 -6
- package/dist/populate.d.ts +2 -2
- package/dist/populate.js +47 -42
- package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
- package/dist/rateLimit/applyTrustProxy.js +17 -0
- package/dist/rateLimit/createStore.d.ts +2 -0
- package/dist/rateLimit/createStore.js +28 -0
- package/dist/rateLimit/memoryStore.d.ts +2 -0
- package/dist/rateLimit/memoryStore.js +108 -0
- package/dist/rateLimit/middleware.d.ts +3 -0
- package/dist/rateLimit/middleware.js +109 -0
- package/dist/rateLimit/mongoStore.d.ts +4 -0
- package/dist/rateLimit/mongoStore.js +123 -0
- package/dist/rateLimit/policies.d.ts +10 -0
- package/dist/rateLimit/policies.js +149 -0
- package/dist/rateLimit/redisStore.d.ts +4 -0
- package/dist/rateLimit/redisStore.js +156 -0
- package/dist/rateLimit/types.d.ts +54 -0
- package/dist/rateLimit/types.js +9 -0
- package/dist/rbac/access.js +35 -14
- package/dist/rbac/assertAllowed.d.ts +9 -0
- package/dist/rbac/assertAllowed.js +182 -0
- package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
- package/dist/rbac/membershipOrgAdminSource.js +122 -0
- package/dist/rbac/modelRouterAccess.d.ts +4 -0
- package/dist/rbac/modelRouterAccess.js +11 -4
- package/dist/rbac/permissionUtils.js +3 -2
- package/dist/rbac/resolve.js +65 -35
- package/dist/rbac/roleModel.d.ts +2 -5
- package/dist/rbac/roleModel.js +18 -4
- package/dist/rbac/routes.js +15 -6
- package/dist/rbac/statements.d.ts +10 -1
- package/dist/rbac/statements.js +19 -2
- package/dist/rbac/types.d.ts +5 -0
- package/dist/realtime/changeStreamWatcher.d.ts +10 -4
- package/dist/realtime/changeStreamWatcher.js +110 -64
- package/dist/realtime/deprecation.d.ts +13 -0
- package/dist/realtime/deprecation.js +33 -0
- package/dist/realtime/realtimeApp.d.ts +2 -1
- package/dist/realtime/realtimeApp.js +11 -11
- package/dist/realtime/registry.d.ts +0 -31
- package/dist/realtime/registry.js +44 -31
- package/dist/realtime/socketAuth.d.ts +5 -5
- package/dist/realtime/socketAuth.js +11 -1
- package/dist/realtime/socketUser.d.ts +5 -1
- package/dist/realtime/types.d.ts +14 -4
- package/dist/schemaMetadata.d.ts +56 -0
- package/dist/schemaMetadata.js +524 -0
- package/dist/seedRunner.d.ts +88 -0
- package/dist/seedRunner.js +627 -0
- package/dist/sync/adminBroadcastScope.d.ts +40 -0
- package/dist/sync/adminBroadcastScope.js +194 -0
- package/dist/sync/adminWindowAccess.d.ts +13 -0
- package/dist/sync/adminWindowAccess.js +96 -0
- package/dist/sync/adminWindowMutation.d.ts +88 -0
- package/dist/sync/adminWindowMutation.js +247 -0
- package/dist/sync/executors.d.ts +19 -3
- package/dist/sync/executors.js +194 -165
- package/dist/sync/loadHarness.js +28 -19
- package/dist/sync/models.js +26 -24
- package/dist/sync/mutationHandler.d.ts +14 -2
- package/dist/sync/mutationHandler.js +201 -76
- package/dist/sync/registrationSideEffects.d.ts +35 -0
- package/dist/sync/registrationSideEffects.js +151 -0
- package/dist/sync/registry.d.ts +2 -52
- package/dist/sync/registry.js +42 -187
- package/dist/sync/routes.d.ts +13 -0
- package/dist/sync/routes.js +116 -58
- package/dist/sync/scripts/compactTombstones.js +0 -2
- package/dist/sync/socketHandlers.d.ts +8 -2
- package/dist/sync/socketHandlers.js +144 -50
- package/dist/sync/streams.d.ts +2 -0
- package/dist/sync/streams.js +7 -1
- package/dist/sync/syncApp.d.ts +4 -3
- package/dist/sync/syncApp.js +5 -4
- package/dist/sync/syncBatch.d.ts +5 -2
- package/dist/sync/syncBatch.js +7 -6
- package/dist/sync/syncSeqPlugin.d.ts +1 -1
- package/dist/sync/syncSeqPlugin.js +20 -16
- package/dist/sync/types.d.ts +18 -0
- package/dist/terrenoApp.d.ts +48 -5
- package/dist/terrenoApp.js +157 -72
- package/dist/tests/createTestData.d.ts +1 -3
- package/dist/tests/createTestData.js +3 -5
- package/dist/tests/models.d.ts +3 -0
- package/dist/tests/models.js +15 -2
- package/dist/tests/testHelper.d.ts +0 -5
- package/dist/tests/testHelper.js +2 -9
- package/dist/types/authToken.d.ts +33 -0
- package/dist/types/authToken.js +2 -0
- package/dist/types/mcpServiceToken.d.ts +41 -0
- package/dist/types/mcpServiceToken.js +2 -0
- package/dist/types/membership.d.ts +23 -0
- package/dist/types/membership.js +2 -0
- package/dist/types/notification.d.ts +28 -0
- package/dist/types/notification.js +2 -0
- package/dist/types/notificationPreference.d.ts +20 -0
- package/dist/types/notificationPreference.js +2 -0
- package/dist/types/organization.d.ts +36 -0
- package/dist/types/organization.js +2 -0
- package/dist/webhooks/headerValue.d.ts +2 -0
- package/dist/webhooks/headerValue.js +14 -0
- package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
- package/dist/webhooks/idempotency/memoryStore.js +65 -0
- package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
- package/dist/webhooks/idempotency/mongoStore.js +150 -0
- package/dist/webhooks/idempotency/webhookReceipt.d.ts +17 -0
- package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
- package/dist/webhooks/rawBody.d.ts +15 -0
- package/dist/webhooks/rawBody.js +23 -0
- package/dist/webhooks/timingSafeEqual.d.ts +4 -0
- package/dist/webhooks/timingSafeEqual.js +17 -0
- package/dist/webhooks/verifiers/hmac.d.ts +15 -0
- package/dist/webhooks/verifiers/hmac.js +49 -0
- package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
- package/dist/webhooks/verifiers/sendgrid.js +56 -0
- package/dist/webhooks/verifiers/stripe.d.ts +9 -0
- package/dist/webhooks/verifiers/stripe.js +99 -0
- package/dist/webhooks/verifiers/twilio.d.ts +9 -0
- package/dist/webhooks/verifiers/twilio.js +112 -0
- package/dist/webhooks/webhooksApp.d.ts +33 -0
- package/dist/webhooks/webhooksApp.js +195 -0
- package/package.json +32 -27
- package/src/__snapshots__/openApi.test.ts.snap +444 -36
- package/src/__snapshots__/openApiBuilder.test.ts.snap +24 -24
- package/src/__snapshots__/schemaMetadata.test.ts.snap +196 -0
- package/src/actions.ts +20 -13
- package/src/adminModelRouter.test.ts +133 -0
- package/src/adminTypes.ts +8 -0
- package/src/api.arrayOperations.test.ts +43 -31
- package/src/api.hooks.test.ts +38 -29
- package/src/api.query.test.ts +31 -31
- package/src/api.test.ts +133 -97
- package/src/api.ts +84 -27
- package/src/audit/auditApp.test.ts +243 -0
- package/src/audit/auditApp.ts +139 -0
- package/src/audit/auditEventModel.ts +156 -0
- package/src/audit/auditRouter.test.ts +456 -0
- package/src/audit/cloudTasksEnqueue.test.ts +124 -0
- package/src/audit/cloudTasksEnqueue.ts +104 -0
- package/src/audit/diff.ts +163 -0
- package/src/audit/processQueue.ts +69 -0
- package/src/audit/rbacSink.test.ts +86 -0
- package/src/audit/rbacSink.ts +42 -0
- package/src/audit/record.test.ts +402 -0
- package/src/audit/record.ts +328 -0
- package/src/auth.test.ts +108 -52
- package/src/auth.ts +98 -29
- package/src/authRecovery.test.ts +281 -0
- package/src/authRecovery.ts +279 -0
- package/src/authTokens.test.ts +94 -0
- package/src/authTokens.ts +118 -0
- package/src/authVerification.test.ts +293 -0
- package/src/betterAuth.ts +31 -0
- package/src/betterAuthApp.test.ts +1 -0
- package/src/betterAuthApp.ts +27 -9
- package/src/betterAuthSetup.test.ts +595 -38
- package/src/betterAuthSetup.ts +261 -5
- package/src/collectionRegistry.test.ts +164 -0
- package/src/collectionRegistry.ts +135 -0
- package/src/configurationApp.ts +13 -7
- package/src/docLoader.test.ts +45 -1
- package/src/docLoader.ts +37 -6
- package/src/express.d.ts +3 -0
- package/src/expressServer.test.ts +180 -68
- package/src/expressServer.ts +75 -19
- package/src/githubAuth.test.ts +60 -55
- package/src/index.ts +127 -0
- package/src/mcp/auth.test.ts +47 -0
- package/src/mcp/auth.ts +32 -11
- package/src/mcp/handlers.test.ts +275 -0
- package/src/mcp/handlers.ts +45 -172
- package/src/mcp/integration.test.ts +59 -9
- package/src/mcp/query.ts +5 -7
- package/src/mcp/registry.ts +29 -20
- package/src/mcp/schemaGenerator.test.ts +8 -0
- package/src/mcp/schemaGenerator.ts +49 -131
- package/src/mcp/server.ts +2 -0
- package/src/mcp/serviceTokens.test.ts +330 -0
- package/src/mcp/serviceTokens.ts +307 -0
- package/src/mcp/toolGenerator.test.ts +82 -1
- package/src/mcp/types.ts +2 -6
- package/src/migrations/cli.test.ts +376 -0
- package/src/migrations/cli.ts +283 -0
- package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
- package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
- package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
- package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
- package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
- package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
- package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
- package/src/migrations/generate.test.ts +333 -0
- package/src/migrations/generate.ts +216 -0
- package/src/migrations/load.test.ts +103 -0
- package/src/migrations/load.ts +124 -0
- package/src/migrations/lock.test.ts +133 -0
- package/src/migrations/lock.ts +118 -0
- package/src/migrations/runner.test.ts +504 -0
- package/src/migrations/runner.ts +358 -0
- package/src/migrations/schemaCatalog.test.ts +159 -0
- package/src/migrations/schemaCatalog.ts +262 -0
- package/src/migrations/types.ts +94 -0
- package/src/models/mcpServiceToken.test.ts +129 -0
- package/src/models/mcpServiceToken.ts +158 -0
- package/src/models/notification.ts +68 -0
- package/src/models/notificationPreference.ts +62 -0
- package/src/notifications/notificationService.ts +254 -0
- package/src/notifications/notificationsApp.test.ts +505 -0
- package/src/notifications/notificationsApp.ts +200 -0
- package/src/notifications/notificationsBeforeSend.ts +51 -0
- package/src/openApi.test.ts +80 -65
- package/src/openApi.ts +2 -1
- package/src/openApiBuilder.test.ts +95 -7
- package/src/openApiBuilder.ts +60 -12
- package/src/openApiCompat.ts +1 -1
- package/src/openApiValidator.test.ts +270 -56
- package/src/openApiValidator.ts +219 -36
- package/src/orgs/orgAccessOptIn.test.ts +87 -0
- package/src/orgs/orgContext.test.ts +259 -0
- package/src/orgs/orgContext.ts +151 -0
- package/src/orgs/orgPermissions.test.ts +105 -0
- package/src/orgs/orgPermissions.ts +40 -0
- package/src/orgs/orgPlugin.test.ts +130 -0
- package/src/orgs/orgPlugin.ts +70 -0
- package/src/orgs/orgRbac.test.ts +267 -0
- package/src/orgs/orgSecurityDefects.test.ts +415 -0
- package/src/orgs/organizationModel.test.ts +205 -0
- package/src/orgs/organizationModel.ts +257 -0
- package/src/orgs/organizationSettings.test.ts +113 -0
- package/src/orgs/organizationSettings.ts +126 -0
- package/src/orgs/orgsApp.test.ts +382 -0
- package/src/orgs/orgsApp.ts +563 -0
- package/src/permissions.test.ts +62 -36
- package/src/permissions.ts +8 -30
- package/src/plugins.test.ts +14 -0
- package/src/plugins.ts +34 -9
- package/src/populate.test.ts +34 -0
- package/src/populate.ts +40 -29
- package/src/rateLimit/applyTrustProxy.ts +17 -0
- package/src/rateLimit/createStore.ts +25 -0
- package/src/rateLimit/memoryStore.ts +40 -0
- package/src/rateLimit/middleware.ts +79 -0
- package/src/rateLimit/mongoStore.test.ts +80 -0
- package/src/rateLimit/mongoStore.ts +77 -0
- package/src/rateLimit/policies.ts +130 -0
- package/src/rateLimit/rateLimit.test.ts +328 -0
- package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
- package/src/rateLimit/redisStore.test.ts +114 -0
- package/src/rateLimit/redisStore.ts +86 -0
- package/src/rateLimit/types.ts +64 -0
- package/src/rbac/access.ts +16 -4
- package/src/rbac/assertAllowed.test.ts +325 -0
- package/src/rbac/assertAllowed.ts +157 -0
- package/src/rbac/backfillAdmins.test.ts +124 -0
- package/src/rbac/fieldViews.test.ts +89 -0
- package/src/rbac/membershipOrgAdminSource.ts +59 -0
- package/src/rbac/modelRouterAccess.test.ts +126 -0
- package/src/rbac/modelRouterAccess.ts +8 -2
- package/src/rbac/permissionUtils.test.ts +26 -5
- package/src/rbac/permissionUtils.ts +3 -2
- package/src/rbac/realtimeAccess.test.ts +109 -1
- package/src/rbac/resolve.test.ts +34 -2
- package/src/rbac/resolve.ts +31 -11
- package/src/rbac/roleManager.test.ts +169 -0
- package/src/rbac/roleModel.test.ts +34 -1
- package/src/rbac/roleModel.ts +17 -1
- package/src/rbac/routes.test.ts +233 -0
- package/src/rbac/routes.ts +16 -6
- package/src/rbac/statements.test.ts +19 -0
- package/src/rbac/statements.ts +19 -1
- package/src/rbac/types.ts +5 -0
- package/src/realtime/changeStreamWatcher.ts +73 -33
- package/src/realtime/deprecation.test.ts +60 -0
- package/src/realtime/deprecation.ts +33 -0
- package/src/realtime/realtime.test.ts +365 -189
- package/src/realtime/realtimeApp.ts +11 -11
- package/src/realtime/realtimeAppSetup.test.ts +32 -5
- package/src/realtime/registry.ts +48 -42
- package/src/realtime/sessionRevalidation.test.ts +57 -44
- package/src/realtime/socketAuth.test.ts +75 -23
- package/src/realtime/socketAuth.ts +17 -6
- package/src/realtime/socketUser.ts +5 -3
- package/src/realtime/types.ts +14 -4
- package/src/schemaMetadata.test.ts +419 -0
- package/src/schemaMetadata.ts +593 -0
- package/src/scrubAdminFields.test.ts +105 -0
- package/src/seedRunner.test.ts +591 -0
- package/src/seedRunner.ts +464 -0
- package/src/sync/adminBroadcastConfig.test.ts +96 -0
- package/src/sync/adminBroadcastScope.test.ts +155 -0
- package/src/sync/adminBroadcastScope.ts +123 -0
- package/src/sync/adminWindowAccess.test.ts +57 -0
- package/src/sync/adminWindowAccess.ts +32 -0
- package/src/sync/adminWindowMutation.test.ts +450 -0
- package/src/sync/adminWindowMutation.ts +283 -0
- package/src/sync/docMatchesMutationData.test.ts +16 -0
- package/src/sync/ensureSyncIndexes.test.ts +54 -15
- package/src/sync/executors.test.ts +40 -0
- package/src/sync/executors.ts +57 -18
- package/src/sync/integration.test.ts +15 -7
- package/src/sync/loadHarness.ts +28 -19
- package/src/sync/models.ts +32 -18
- package/src/sync/mutationHandler.test.ts +293 -17
- package/src/sync/mutationHandler.ts +180 -36
- package/src/sync/registrationSideEffects.test.ts +126 -0
- package/src/sync/registrationSideEffects.ts +131 -0
- package/src/sync/registry.ts +49 -171
- package/src/sync/routes.ts +55 -10
- package/src/sync/scripts/compactTombstones.ts +0 -2
- package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
- package/src/sync/socketHandlers.ts +154 -58
- package/src/sync/streams.ts +6 -0
- package/src/sync/sync.test.ts +28 -25
- package/src/sync/syncApp.ts +5 -4
- package/src/sync/syncBatch.ts +10 -4
- package/src/sync/syncFrontier.test.ts +17 -15
- package/src/sync/syncPhaseC.test.ts +54 -43
- package/src/sync/syncRoutes.test.ts +347 -38
- package/src/sync/syncSeqPlugin.ts +66 -44
- package/src/sync/syncSocket.test.ts +341 -81
- package/src/sync/types.ts +20 -0
- package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
- package/src/terrenoApp.migrations.test.ts +114 -0
- package/src/terrenoApp.test.ts +41 -0
- package/src/terrenoApp.ts +181 -46
- package/src/tests/createTestData.ts +2 -2
- package/src/tests/models.ts +24 -3
- package/src/tests/testHelper.ts +1 -7
- package/src/types/authToken.ts +41 -0
- package/src/types/mcpServiceToken.ts +48 -0
- package/src/types/membership.ts +48 -0
- package/src/types/notification.ts +34 -0
- package/src/types/notificationPreference.ts +28 -0
- package/src/types/organization.ts +49 -0
- package/src/webhooks/headerValue.test.ts +22 -0
- package/src/webhooks/headerValue.ts +12 -0
- package/src/webhooks/idempotency/memoryStore.ts +34 -0
- package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
- package/src/webhooks/idempotency/mongoStore.ts +83 -0
- package/src/webhooks/idempotency/webhookReceipt.ts +67 -0
- package/src/webhooks/rawBody.test.ts +107 -0
- package/src/webhooks/rawBody.ts +24 -0
- package/src/webhooks/timingSafeEqual.ts +16 -0
- package/src/webhooks/verifiers/hmac.test.ts +110 -0
- package/src/webhooks/verifiers/hmac.ts +54 -0
- package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
- package/src/webhooks/verifiers/sendgrid.ts +59 -0
- package/src/webhooks/verifiers/stripe.ts +67 -0
- package/src/webhooks/verifiers/twilio.ts +69 -0
- package/src/webhooks/webhooksApp.test.ts +221 -0
- package/src/webhooks/webhooksApp.ts +144 -0
- package/tsconfig.json +1 -1
- package/tsconfig.typedoc.json +2 -1
- package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
- package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
- package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
package/dist/terrenoApp.d.ts
CHANGED
|
@@ -1,12 +1,17 @@
|
|
|
1
|
+
import { type Server as HttpServer } from "node:http";
|
|
1
2
|
import * as Sentry from "@sentry/bun";
|
|
2
3
|
import express from "express";
|
|
3
4
|
import type { AdminChangeEvent, TerrenoAppAdminEvent } from "./adminTypes";
|
|
4
5
|
import type { ModelRouterRegistration } from "./api";
|
|
5
6
|
import { type UserModel as UserMongooseModel } from "./auth";
|
|
6
|
-
import { type ConfigurationAppOptions } from "./configurationApp";
|
|
7
|
+
import { type ConfigurationAppOptions, type ConfigurationModelLike } from "./configurationApp";
|
|
7
8
|
import { type AddRoutes, type AuthOptions } from "./expressServer";
|
|
8
9
|
import { type GitHubAuthOptions } from "./githubAuth";
|
|
9
10
|
import { type LoggingOptions } from "./logger";
|
|
11
|
+
import { type McpServiceTokensAppOption } from "./mcp/serviceTokens";
|
|
12
|
+
import { type StartupMigrationsOption } from "./migrations/runner";
|
|
13
|
+
import { type OrgsAppOptions } from "./orgs/orgsApp";
|
|
14
|
+
import type { RateLimitOptions } from "./rateLimit/types";
|
|
10
15
|
import type { RealtimeAppOptions } from "./realtime/types";
|
|
11
16
|
import type { TerrenoPlugin } from "./terrenoPlugin";
|
|
12
17
|
type CorsOrigin = string | boolean | RegExp | Array<boolean | string | RegExp> | ((requestOrigin: string | undefined, callback: (err: Error | null, origin?: boolean | string | RegExp | Array<boolean | string | RegExp>) => void) => void);
|
|
@@ -26,6 +31,12 @@ export interface TerrenoAppOptions {
|
|
|
26
31
|
githubAuth?: GitHubAuthOptions;
|
|
27
32
|
/** Skip calling app.listen() in start() method (useful for testing) */
|
|
28
33
|
skipListen?: boolean;
|
|
34
|
+
/**
|
|
35
|
+
* Already-listening HTTP server. `start()` attaches the Express app to it
|
|
36
|
+
* instead of creating and binding a new server, so Cloud Run can see PORT
|
|
37
|
+
* before MongoDB connect and plugin registration finish.
|
|
38
|
+
*/
|
|
39
|
+
httpServer?: HttpServer;
|
|
29
40
|
/** Sentry configuration options */
|
|
30
41
|
sentryOptions?: Sentry.BunOptions;
|
|
31
42
|
/** Maximum number of array items in query parameters (default: 200) */
|
|
@@ -43,6 +54,13 @@ export interface TerrenoAppOptions {
|
|
|
43
54
|
* RBAC access controller injected into model routers and `/auth/me` enrichment.
|
|
44
55
|
*/
|
|
45
56
|
accessControl?: import("./rbac/types").AnyTerrenoAccess;
|
|
57
|
+
/**
|
|
58
|
+
* Multi-tenant organizations. Default off so existing single-tenant apps stay unchanged.
|
|
59
|
+
* New apps from `terreno_bootstrap_app` pass `true`. Requires `accessControl` from
|
|
60
|
+
* `createAccess({ organizations: true })`. Pass `{ settingsSchema }` to type and
|
|
61
|
+
* validate `Organization.settings`.
|
|
62
|
+
*/
|
|
63
|
+
organizations?: boolean | Omit<OrgsAppOptions, "access" | "userModel">;
|
|
46
64
|
/**
|
|
47
65
|
* Runs after CORS and before the `addMiddleware` chain and JSON body parsing.
|
|
48
66
|
* Use to attach early middleware via `app.use(...)` before JSON parsing.
|
|
@@ -53,6 +71,23 @@ export interface TerrenoAppOptions {
|
|
|
53
71
|
* Receives the Express app and OpenAPI bundle for `modelRouter` / `createOpenApiBuilder` wiring.
|
|
54
72
|
*/
|
|
55
73
|
configureApp?: AddRoutes;
|
|
74
|
+
/**
|
|
75
|
+
* Optional HTTP rate limiting. Omitted or `undefined` leaves the limiter off
|
|
76
|
+
* (Terreno 58 will default it on). Pass `{}` or `{store, limits, trustProxy}`
|
|
77
|
+
* to enable. See [Rate limiting](../how-to/rate-limiting.md).
|
|
78
|
+
*/
|
|
79
|
+
rateLimit?: RateLimitOptions;
|
|
80
|
+
/**
|
|
81
|
+
* Opt-in personal MCP service tokens. `true` is `{enabled: true}`. When enabled,
|
|
82
|
+
* mounts `/mcp/service-tokens` and accepts `Authorization: Bearer mcp_…` on `/mcp`.
|
|
83
|
+
*/
|
|
84
|
+
mcpServiceTokens?: McpServiceTokensAppOption;
|
|
85
|
+
/**
|
|
86
|
+
* Versioned MongoDB migrations. `runOnStart` defaults to false. When true, wet `up`
|
|
87
|
+
* runs after listen and `ensureSyncIndexes`. Production still requires
|
|
88
|
+
* `ALLOW_MIGRATIONS=true`.
|
|
89
|
+
*/
|
|
90
|
+
migrations?: StartupMigrationsOption;
|
|
56
91
|
}
|
|
57
92
|
/**
|
|
58
93
|
* Fluent API for building Express applications with Terreno framework.
|
|
@@ -65,7 +100,7 @@ export interface TerrenoAppOptions {
|
|
|
65
100
|
* 1. CORS
|
|
66
101
|
* 2. Optional `beforeJsonSetup` (configure the app before JSON parsing)
|
|
67
102
|
* 3. Custom middleware (via addMiddleware)
|
|
68
|
-
* 4. JSON body
|
|
103
|
+
* 4. JSON and urlencoded body parsers (stash `req.rawBody`)
|
|
69
104
|
* 5. Auth routes (/auth/login, /auth/signup, etc.)
|
|
70
105
|
* 6. JWT authentication setup
|
|
71
106
|
* 7. Request logging
|
|
@@ -122,6 +157,7 @@ export declare class TerrenoApp {
|
|
|
122
157
|
private middlewareFns;
|
|
123
158
|
private configurationApp;
|
|
124
159
|
private readonly adminEvents;
|
|
160
|
+
private bootPromise;
|
|
125
161
|
/**
|
|
126
162
|
* Create a new TerrenoApp builder.
|
|
127
163
|
*
|
|
@@ -201,13 +237,14 @@ export declare class TerrenoApp {
|
|
|
201
237
|
* .start();
|
|
202
238
|
* ```
|
|
203
239
|
*/
|
|
204
|
-
configure(model:
|
|
240
|
+
configure(model: ConfigurationModelLike, options?: Omit<ConfigurationAppOptions, "model">): this;
|
|
205
241
|
/**
|
|
206
242
|
* Build the Express application without starting the server.
|
|
207
243
|
*
|
|
208
244
|
* Configures the complete middleware stack including:
|
|
209
|
-
* - CORS, JSON parsing,
|
|
210
|
-
* -
|
|
245
|
+
* - CORS, JSON parsing, JWT decode, optional HTTP rate limiting, auth routes
|
|
246
|
+
* - Better Auth session (when BetterAuthApp is registered) before the limiter
|
|
247
|
+
* - Logging, Sentry, OpenAPI, model routers and plugins
|
|
211
248
|
* - Error handling middleware
|
|
212
249
|
*
|
|
213
250
|
* Use this method when you need the Express app instance for testing
|
|
@@ -247,6 +284,12 @@ export declare class TerrenoApp {
|
|
|
247
284
|
* ```
|
|
248
285
|
*/
|
|
249
286
|
start(): express.Application;
|
|
287
|
+
/**
|
|
288
|
+
* Resolves after startup migrations (and listen, unless `skipListen`).
|
|
289
|
+
* Tests with `skipListen` should await this instead of assuming `start()` is idle.
|
|
290
|
+
*/
|
|
291
|
+
whenReady(): Promise<void>;
|
|
292
|
+
private completeStart;
|
|
250
293
|
private isModelRouterRegistration;
|
|
251
294
|
}
|
|
252
295
|
export {};
|
package/dist/terrenoApp.js
CHANGED
|
@@ -100,21 +100,30 @@ var node_http_1 = require("node:http");
|
|
|
100
100
|
var Sentry = __importStar(require("@sentry/bun"));
|
|
101
101
|
var cors_1 = __importDefault(require("cors"));
|
|
102
102
|
var express_1 = __importDefault(require("express"));
|
|
103
|
+
var mongoose_1 = __importDefault(require("mongoose"));
|
|
103
104
|
var qs_1 = __importDefault(require("qs"));
|
|
104
105
|
var auth_1 = require("./auth");
|
|
106
|
+
var betterAuthSetup_1 = require("./betterAuthSetup");
|
|
105
107
|
var configurationApp_1 = require("./configurationApp");
|
|
106
108
|
var errors_1 = require("./errors");
|
|
107
109
|
var expressServer_1 = require("./expressServer");
|
|
108
110
|
var githubAuth_1 = require("./githubAuth");
|
|
109
111
|
var logger_1 = require("./logger");
|
|
110
112
|
var server_1 = require("./mcp/server");
|
|
113
|
+
var serviceTokens_1 = require("./mcp/serviceTokens");
|
|
111
114
|
var middleware_1 = require("./middleware");
|
|
115
|
+
var runner_1 = require("./migrations/runner");
|
|
112
116
|
var openApiCompat_1 = require("./openApiCompat");
|
|
113
117
|
var openApiEtag_1 = require("./openApiEtag");
|
|
118
|
+
var orgsApp_1 = require("./orgs/orgsApp");
|
|
119
|
+
var applyTrustProxy_1 = require("./rateLimit/applyTrustProxy");
|
|
120
|
+
var createStore_1 = require("./rateLimit/createStore");
|
|
121
|
+
var middleware_2 = require("./rateLimit/middleware");
|
|
114
122
|
var realtimeApp_1 = require("./realtime/realtimeApp");
|
|
115
123
|
var requestContext_1 = require("./requestContext");
|
|
116
124
|
var registry_1 = require("./sync/registry");
|
|
117
125
|
var index_1 = __importDefault(require("./vendor/wesleytodd-openapi/index"));
|
|
126
|
+
var rawBody_1 = require("./webhooks/rawBody");
|
|
118
127
|
/**
|
|
119
128
|
* Fluent API for building Express applications with Terreno framework.
|
|
120
129
|
*
|
|
@@ -126,7 +135,7 @@ var index_1 = __importDefault(require("./vendor/wesleytodd-openapi/index"));
|
|
|
126
135
|
* 1. CORS
|
|
127
136
|
* 2. Optional `beforeJsonSetup` (configure the app before JSON parsing)
|
|
128
137
|
* 3. Custom middleware (via addMiddleware)
|
|
129
|
-
* 4. JSON body
|
|
138
|
+
* 4. JSON and urlencoded body parsers (stash `req.rawBody`)
|
|
130
139
|
* 5. Auth routes (/auth/login, /auth/signup, etc.)
|
|
131
140
|
* 6. JWT authentication setup
|
|
132
141
|
* 7. Request logging
|
|
@@ -184,10 +193,65 @@ var TerrenoApp = /** @class */ (function () {
|
|
|
184
193
|
* @param options - Application configuration options including user model and auth settings
|
|
185
194
|
*/
|
|
186
195
|
function TerrenoApp(options) {
|
|
196
|
+
var _this = this;
|
|
187
197
|
this.registrations = [];
|
|
188
198
|
this.middlewareFns = [];
|
|
189
199
|
this.configurationApp = null;
|
|
190
200
|
this.adminEvents = new node_events_1.EventEmitter();
|
|
201
|
+
this.bootPromise = Promise.resolve();
|
|
202
|
+
this.completeStart = function (app) { return __awaiter(_this, void 0, void 0, function () {
|
|
203
|
+
var port_1, existingServer, server, _a, _b, reg;
|
|
204
|
+
var e_1, _c;
|
|
205
|
+
return __generator(this, function (_d) {
|
|
206
|
+
switch (_d.label) {
|
|
207
|
+
case 0:
|
|
208
|
+
if (!!this.options.skipListen) return [3 /*break*/, 2];
|
|
209
|
+
port_1 = process.env.PORT || "9000";
|
|
210
|
+
existingServer = this.options.httpServer;
|
|
211
|
+
server = existingServer !== null && existingServer !== void 0 ? existingServer : (0, node_http_1.createServer)(app);
|
|
212
|
+
if (existingServer) {
|
|
213
|
+
existingServer.removeAllListeners("request");
|
|
214
|
+
existingServer.on("request", app);
|
|
215
|
+
}
|
|
216
|
+
try {
|
|
217
|
+
for (_a = __values(this.registrations), _b = _a.next(); !_b.done; _b = _a.next()) {
|
|
218
|
+
reg = _b.value;
|
|
219
|
+
if (!this.isModelRouterRegistration(reg) && typeof reg.onServerCreated === "function") {
|
|
220
|
+
reg.onServerCreated(server);
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
catch (e_1_1) { e_1 = { error: e_1_1 }; }
|
|
225
|
+
finally {
|
|
226
|
+
try {
|
|
227
|
+
if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
|
|
228
|
+
}
|
|
229
|
+
finally { if (e_1) throw e_1.error; }
|
|
230
|
+
}
|
|
231
|
+
// Bind PORT before index/migration work so Cloud Run's startup probe can
|
|
232
|
+
// succeed while `ensureSyncIndexes` still runs. whenReady() still waits.
|
|
233
|
+
if (!existingServer) {
|
|
234
|
+
server.listen(port_1, function () {
|
|
235
|
+
logger_1.logger.info("Listening on port ".concat(port_1));
|
|
236
|
+
});
|
|
237
|
+
}
|
|
238
|
+
else {
|
|
239
|
+
logger_1.logger.info("Listening on port ".concat(port_1));
|
|
240
|
+
}
|
|
241
|
+
return [4 /*yield*/, (0, registry_1.ensureSyncIndexes)()];
|
|
242
|
+
case 1:
|
|
243
|
+
_d.sent();
|
|
244
|
+
_d.label = 2;
|
|
245
|
+
case 2: return [4 /*yield*/, (0, runner_1.runStartupMigrations)({
|
|
246
|
+
migrations: this.options.migrations,
|
|
247
|
+
mongoose: mongoose_1.default,
|
|
248
|
+
})];
|
|
249
|
+
case 3:
|
|
250
|
+
_d.sent();
|
|
251
|
+
return [2 /*return*/];
|
|
252
|
+
}
|
|
253
|
+
});
|
|
254
|
+
}); };
|
|
191
255
|
this.options = options;
|
|
192
256
|
this.adminEvents.setMaxListeners(50);
|
|
193
257
|
}
|
|
@@ -283,10 +347,7 @@ var TerrenoApp = /** @class */ (function () {
|
|
|
283
347
|
* .start();
|
|
284
348
|
* ```
|
|
285
349
|
*/
|
|
286
|
-
TerrenoApp.prototype.configure = function (
|
|
287
|
-
// noExplicitAny: Model<any> required for invariance — consumers pass arbitrary configuration models
|
|
288
|
-
// biome-ignore lint/suspicious/noExplicitAny: Model<any> required for invariance — consumers pass arbitrary configuration models
|
|
289
|
-
model, options) {
|
|
350
|
+
TerrenoApp.prototype.configure = function (model, options) {
|
|
290
351
|
this.configurationApp = new configurationApp_1.ConfigurationApp(__assign({ model: model }, options));
|
|
291
352
|
return this;
|
|
292
353
|
};
|
|
@@ -294,8 +355,9 @@ var TerrenoApp = /** @class */ (function () {
|
|
|
294
355
|
* Build the Express application without starting the server.
|
|
295
356
|
*
|
|
296
357
|
* Configures the complete middleware stack including:
|
|
297
|
-
* - CORS, JSON parsing,
|
|
298
|
-
* -
|
|
358
|
+
* - CORS, JSON parsing, JWT decode, optional HTTP rate limiting, auth routes
|
|
359
|
+
* - Better Auth session (when BetterAuthApp is registered) before the limiter
|
|
360
|
+
* - Logging, Sentry, OpenAPI, model routers and plugins
|
|
299
361
|
* - Error handling middleware
|
|
300
362
|
*
|
|
301
363
|
* Use this method when you need the Express app instance for testing
|
|
@@ -314,8 +376,9 @@ var TerrenoApp = /** @class */ (function () {
|
|
|
314
376
|
* ```
|
|
315
377
|
*/
|
|
316
378
|
TerrenoApp.prototype.build = function () {
|
|
317
|
-
var
|
|
318
|
-
var
|
|
379
|
+
var e_2, _a, e_3, _b;
|
|
380
|
+
var _this = this;
|
|
381
|
+
var _c, _d, _e, _f, _g, _h;
|
|
319
382
|
(0, logger_1.setupLogging)(this.options.loggingOptions);
|
|
320
383
|
var app = (0, express_1.default)();
|
|
321
384
|
var options = this.options;
|
|
@@ -329,8 +392,8 @@ var TerrenoApp = /** @class */ (function () {
|
|
|
329
392
|
}
|
|
330
393
|
try {
|
|
331
394
|
// Apply custom middleware before JSON parsing
|
|
332
|
-
for (var
|
|
333
|
-
var fn =
|
|
395
|
+
for (var _j = __values(this.middlewareFns), _k = _j.next(); !_k.done; _k = _j.next()) {
|
|
396
|
+
var fn = _k.value;
|
|
334
397
|
if (fn.length <= 3) {
|
|
335
398
|
// express.RequestHandler (req, res, next)
|
|
336
399
|
app.use(fn);
|
|
@@ -341,21 +404,43 @@ var TerrenoApp = /** @class */ (function () {
|
|
|
341
404
|
}
|
|
342
405
|
}
|
|
343
406
|
}
|
|
344
|
-
catch (
|
|
407
|
+
catch (e_2_1) { e_2 = { error: e_2_1 }; }
|
|
345
408
|
finally {
|
|
346
409
|
try {
|
|
347
|
-
if (
|
|
410
|
+
if (_k && !_k.done && (_a = _j.return)) _a.call(_j);
|
|
348
411
|
}
|
|
349
|
-
finally { if (
|
|
412
|
+
finally { if (e_2) throw e_2.error; }
|
|
350
413
|
}
|
|
351
|
-
app.use(express_1.default.json(
|
|
352
|
-
|
|
353
|
-
|
|
414
|
+
app.use(express_1.default.json(rawBody_1.jsonBodyParserOptions));
|
|
415
|
+
app.use(express_1.default.urlencoded(rawBody_1.urlencodedBodyParserOptions));
|
|
416
|
+
// JWT decode before rate limiting so authenticated keys use userId.
|
|
417
|
+
// Auth routes mount after the limiter so login is in the auth bucket.
|
|
354
418
|
(0, auth_1.setupAuth)(app, options.userModel);
|
|
355
419
|
app.use(function (req, res, next) {
|
|
356
420
|
(0, requestContext_1.updateRequestContextFromRequest)(req, res);
|
|
357
421
|
next();
|
|
358
422
|
});
|
|
423
|
+
var betterAuthForLimiter = this.registrations.find(function (registration) {
|
|
424
|
+
return "getAuth" in registration &&
|
|
425
|
+
typeof registration.getAuth === "function";
|
|
426
|
+
});
|
|
427
|
+
if (betterAuthForLimiter === null || betterAuthForLimiter === void 0 ? void 0 : betterAuthForLimiter.ensureAuth) {
|
|
428
|
+
var auth = betterAuthForLimiter.ensureAuth();
|
|
429
|
+
app.use((0, betterAuthSetup_1.createBetterAuthSessionMiddleware)(auth, options.userModel));
|
|
430
|
+
(_d = betterAuthForLimiter.markSessionMiddlewareMounted) === null || _d === void 0 ? void 0 : _d.call(betterAuthForLimiter);
|
|
431
|
+
}
|
|
432
|
+
if (options.rateLimit) {
|
|
433
|
+
var betterAuthBasePath = (_e = options.rateLimit.betterAuthBasePath) !== null && _e !== void 0 ? _e : (_f = betterAuthForLimiter === null || betterAuthForLimiter === void 0 ? void 0 : betterAuthForLimiter.getBetterAuthBasePath) === null || _f === void 0 ? void 0 : _f.call(betterAuthForLimiter);
|
|
434
|
+
var rateLimit = __assign(__assign({}, options.rateLimit), (betterAuthBasePath ? { betterAuthBasePath: betterAuthBasePath } : {}));
|
|
435
|
+
(0, applyTrustProxy_1.applyRateLimitTrustProxy)(app, rateLimit);
|
|
436
|
+
var store = (0, createStore_1.createRateLimitStore)(rateLimit);
|
|
437
|
+
app.use((0, middleware_2.createRateLimitMiddleware)(store, rateLimit));
|
|
438
|
+
}
|
|
439
|
+
if (!options.authOptions) {
|
|
440
|
+
options.authOptions = {};
|
|
441
|
+
}
|
|
442
|
+
var authOptions = options.authOptions;
|
|
443
|
+
(0, auth_1.addAuthRoutes)(app, options.userModel, authOptions);
|
|
359
444
|
if (options.logRequests !== false) {
|
|
360
445
|
app.use(expressServer_1.logRequests);
|
|
361
446
|
}
|
|
@@ -411,8 +496,8 @@ var TerrenoApp = /** @class */ (function () {
|
|
|
411
496
|
}
|
|
412
497
|
try {
|
|
413
498
|
// Mount registered model routers and plugins
|
|
414
|
-
for (var
|
|
415
|
-
var registration =
|
|
499
|
+
for (var _l = __values(this.registrations), _m = _l.next(); !_m.done; _m = _l.next()) {
|
|
500
|
+
var registration = _m.value;
|
|
416
501
|
if (this.isModelRouterRegistration(registration)) {
|
|
417
502
|
var router = registration._buildWithContext({
|
|
418
503
|
accessControl: options.accessControl,
|
|
@@ -427,20 +512,41 @@ var TerrenoApp = /** @class */ (function () {
|
|
|
427
512
|
}
|
|
428
513
|
}
|
|
429
514
|
}
|
|
430
|
-
catch (
|
|
515
|
+
catch (e_3_1) { e_3 = { error: e_3_1 }; }
|
|
431
516
|
finally {
|
|
432
517
|
try {
|
|
433
|
-
if (
|
|
518
|
+
if (_m && !_m.done && (_b = _l.return)) _b.call(_l);
|
|
434
519
|
}
|
|
435
|
-
finally { if (
|
|
520
|
+
finally { if (e_3) throw e_3.error; }
|
|
436
521
|
}
|
|
437
522
|
// Mount MCP at POST /mcp when any model opted in or a custom tool was registered.
|
|
438
523
|
var betterAuthPlugin = this.registrations.find(function (registration) {
|
|
439
524
|
return "getAuth" in registration &&
|
|
440
525
|
typeof registration.getAuth === "function";
|
|
441
526
|
});
|
|
527
|
+
var betterAuth = (_h = (_g = betterAuthPlugin === null || betterAuthPlugin === void 0 ? void 0 : betterAuthPlugin.ensureAuth) === null || _g === void 0 ? void 0 : _g.call(betterAuthPlugin)) !== null && _h !== void 0 ? _h : betterAuthPlugin === null || betterAuthPlugin === void 0 ? void 0 : betterAuthPlugin.getAuth();
|
|
528
|
+
if (betterAuth) {
|
|
529
|
+
authOptions.syncPasswordResetToBetterAuth = function (user, password) { return __awaiter(_this, void 0, void 0, function () {
|
|
530
|
+
return __generator(this, function (_a) {
|
|
531
|
+
switch (_a.label) {
|
|
532
|
+
case 0: return [4 /*yield*/, (0, betterAuthSetup_1.applyJwtPasswordResetToBetterAuth)(betterAuth, user, password)];
|
|
533
|
+
case 1:
|
|
534
|
+
_a.sent();
|
|
535
|
+
return [2 /*return*/];
|
|
536
|
+
}
|
|
537
|
+
});
|
|
538
|
+
}); };
|
|
539
|
+
}
|
|
540
|
+
var mcpServiceTokens = (0, serviceTokens_1.resolveMcpServiceTokensOption)(options.mcpServiceTokens);
|
|
541
|
+
if (mcpServiceTokens.enabled) {
|
|
542
|
+
(0, serviceTokens_1.addMcpServiceTokenRoutes)(app, {
|
|
543
|
+
openApi: oapi,
|
|
544
|
+
publicMcpUrl: mcpServiceTokens.publicMcpUrl,
|
|
545
|
+
});
|
|
546
|
+
}
|
|
442
547
|
(0, server_1.mountMCPServer)(app, {
|
|
443
|
-
betterAuth:
|
|
548
|
+
betterAuth: betterAuth,
|
|
549
|
+
mcpServiceTokens: mcpServiceTokens.enabled,
|
|
444
550
|
userModel: options.userModel,
|
|
445
551
|
});
|
|
446
552
|
if (options.configureApp) {
|
|
@@ -479,6 +585,21 @@ var TerrenoApp = /** @class */ (function () {
|
|
|
479
585
|
TerrenoApp.prototype.start = function () {
|
|
480
586
|
var _this = this;
|
|
481
587
|
var _a;
|
|
588
|
+
if (this.options.organizations) {
|
|
589
|
+
if (!this.options.accessControl) {
|
|
590
|
+
throw new errors_1.APIError({
|
|
591
|
+
status: 500,
|
|
592
|
+
title: "TerrenoApp organizations requires accessControl from createAccess({ organizations: true })",
|
|
593
|
+
});
|
|
594
|
+
}
|
|
595
|
+
var hasOrgsPlugin = this.registrations.some(function (registration) {
|
|
596
|
+
return !_this.isModelRouterRegistration(registration) && registration instanceof orgsApp_1.OrgsApp;
|
|
597
|
+
});
|
|
598
|
+
if (!hasOrgsPlugin) {
|
|
599
|
+
var orgConfig = typeof this.options.organizations === "object" ? this.options.organizations : {};
|
|
600
|
+
this.register(new orgsApp_1.OrgsApp(__assign(__assign({}, orgConfig), { access: this.options.accessControl, userModel: this.options.userModel })));
|
|
601
|
+
}
|
|
602
|
+
}
|
|
482
603
|
// If realtime option is set, auto-register the RealtimeApp plugin
|
|
483
604
|
if (this.options.realtime) {
|
|
484
605
|
var hasRealtimePlugin = this.registrations.some(function (r) { return !_this.isModelRouterRegistration(r) && r instanceof realtimeApp_1.RealtimeApp; });
|
|
@@ -493,59 +614,23 @@ var TerrenoApp = /** @class */ (function () {
|
|
|
493
614
|
}
|
|
494
615
|
}
|
|
495
616
|
var app = this.build();
|
|
617
|
+
this.bootPromise = this.completeStart(app);
|
|
496
618
|
if (!this.options.skipListen) {
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
// keeps the counter upsert race from minting duplicate seqs). Either failure is a
|
|
503
|
-
// loud startup error rather than a silent correctness cliff. No-op when no sync
|
|
504
|
-
// models or SyncApp are registered. Detached because start() returns synchronously.
|
|
505
|
-
void (function () { return __awaiter(_this, void 0, void 0, function () {
|
|
506
|
-
var server, _a, _b, reg, error_1, stack;
|
|
507
|
-
var e_3, _c;
|
|
508
|
-
return __generator(this, function (_d) {
|
|
509
|
-
switch (_d.label) {
|
|
510
|
-
case 0:
|
|
511
|
-
_d.trys.push([0, 2, , 3]);
|
|
512
|
-
return [4 /*yield*/, (0, registry_1.ensureSyncIndexes)()];
|
|
513
|
-
case 1:
|
|
514
|
-
_d.sent();
|
|
515
|
-
server = (0, node_http_1.createServer)(app);
|
|
516
|
-
try {
|
|
517
|
-
// Notify plugins that need access to the HTTP server (e.g. WebSocket plugins)
|
|
518
|
-
for (_a = __values(this.registrations), _b = _a.next(); !_b.done; _b = _a.next()) {
|
|
519
|
-
reg = _b.value;
|
|
520
|
-
if (!this.isModelRouterRegistration(reg) && typeof reg.onServerCreated === "function") {
|
|
521
|
-
reg.onServerCreated(server);
|
|
522
|
-
}
|
|
523
|
-
}
|
|
524
|
-
}
|
|
525
|
-
catch (e_3_1) { e_3 = { error: e_3_1 }; }
|
|
526
|
-
finally {
|
|
527
|
-
try {
|
|
528
|
-
if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
|
|
529
|
-
}
|
|
530
|
-
finally { if (e_3) throw e_3.error; }
|
|
531
|
-
}
|
|
532
|
-
server.listen(port_1, function () {
|
|
533
|
-
logger_1.logger.info("Listening on port ".concat(port_1));
|
|
534
|
-
});
|
|
535
|
-
return [3 /*break*/, 3];
|
|
536
|
-
case 2:
|
|
537
|
-
error_1 = _d.sent();
|
|
538
|
-
stack = error_1 instanceof Error ? error_1.stack : String(error_1);
|
|
539
|
-
logger_1.logger.error("Error trying to start HTTP server: ".concat(error_1, "\n").concat(stack));
|
|
540
|
-
process.exit(1);
|
|
541
|
-
return [3 /*break*/, 3];
|
|
542
|
-
case 3: return [2 /*return*/];
|
|
543
|
-
}
|
|
544
|
-
});
|
|
545
|
-
}); })();
|
|
619
|
+
void this.bootPromise.catch(function (error) {
|
|
620
|
+
var stack = error instanceof Error ? error.stack : String(error);
|
|
621
|
+
logger_1.logger.error("Error trying to start HTTP server: ".concat(error, "\n").concat(stack));
|
|
622
|
+
process.exit(1);
|
|
623
|
+
});
|
|
546
624
|
}
|
|
547
625
|
return app;
|
|
548
626
|
};
|
|
627
|
+
/**
|
|
628
|
+
* Resolves after startup migrations (and listen, unless `skipListen`).
|
|
629
|
+
* Tests with `skipListen` should await this instead of assuming `start()` is idle.
|
|
630
|
+
*/
|
|
631
|
+
TerrenoApp.prototype.whenReady = function () {
|
|
632
|
+
return this.bootPromise;
|
|
633
|
+
};
|
|
549
634
|
TerrenoApp.prototype.isModelRouterRegistration = function (registration) {
|
|
550
635
|
return registration.__type === "modelRouter";
|
|
551
636
|
};
|
|
@@ -1,8 +1,6 @@
|
|
|
1
|
-
import type { CachedTestData, TestData,
|
|
1
|
+
import type { CachedTestData, TestData, TestUsers } from "./types";
|
|
2
2
|
export declare const clearTestCollections: () => Promise<void>;
|
|
3
3
|
export declare const createTestUsers: () => Promise<TestUsers>;
|
|
4
|
-
export declare const createStandardFoods: (users: TestUsers) => Promise<TestFoods>;
|
|
5
|
-
export declare const createRequiredFixtures: () => Promise<TestRequired>;
|
|
6
4
|
/** Builds the standard Terreno API test database (users, foods, required docs). */
|
|
7
5
|
export declare const createTestData: () => Promise<TestData>;
|
|
8
6
|
export declare const toCachedTestData: (testData: TestData) => CachedTestData;
|
|
@@ -55,7 +55,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
|
55
55
|
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
56
56
|
};
|
|
57
57
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
58
|
-
exports.loadTestDataFromDocuments = exports.toCachedTestData = exports.createTestData = exports.
|
|
58
|
+
exports.loadTestDataFromDocuments = exports.toCachedTestData = exports.createTestData = exports.createTestUsers = exports.clearTestCollections = void 0;
|
|
59
59
|
var luxon_1 = require("luxon");
|
|
60
60
|
var mongoose_1 = __importDefault(require("mongoose"));
|
|
61
61
|
var errors_1 = require("../errors");
|
|
@@ -187,7 +187,6 @@ var createStandardFoods = function (users) { return __awaiter(void 0, void 0, vo
|
|
|
187
187
|
}
|
|
188
188
|
});
|
|
189
189
|
}); };
|
|
190
|
-
exports.createStandardFoods = createStandardFoods;
|
|
191
190
|
var createRequiredFixtures = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
192
191
|
var _a, sample, withAbout;
|
|
193
192
|
return __generator(this, function (_b) {
|
|
@@ -202,7 +201,6 @@ var createRequiredFixtures = function () { return __awaiter(void 0, void 0, void
|
|
|
202
201
|
}
|
|
203
202
|
});
|
|
204
203
|
}); };
|
|
205
|
-
exports.createRequiredFixtures = createRequiredFixtures;
|
|
206
204
|
/** Builds the standard Terreno API test database (users, foods, required docs). */
|
|
207
205
|
var createTestData = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
208
206
|
var users, _a, foods, required;
|
|
@@ -215,8 +213,8 @@ var createTestData = function () { return __awaiter(void 0, void 0, void 0, func
|
|
|
215
213
|
case 2:
|
|
216
214
|
users = _b.sent();
|
|
217
215
|
return [4 /*yield*/, Promise.all([
|
|
218
|
-
|
|
219
|
-
|
|
216
|
+
createStandardFoods(users),
|
|
217
|
+
createRequiredFixtures(),
|
|
220
218
|
])];
|
|
221
219
|
case 3:
|
|
222
220
|
_a = __read.apply(void 0, [_b.sent(), 2]), foods = _a[0], required = _a[1];
|
package/dist/tests/models.d.ts
CHANGED
package/dist/tests/models.js
CHANGED
|
@@ -52,19 +52,32 @@ var userSchema = new mongoose_1.Schema({
|
|
|
52
52
|
description: "Organization memberships",
|
|
53
53
|
type: [String],
|
|
54
54
|
},
|
|
55
|
+
roles: {
|
|
56
|
+
default: [],
|
|
57
|
+
description: "RBAC role names assigned to this user",
|
|
58
|
+
type: [String],
|
|
59
|
+
},
|
|
60
|
+
tokenEpoch: {
|
|
61
|
+
default: 0,
|
|
62
|
+
description: "Incremented on password reset to invalidate outstanding refresh tokens",
|
|
63
|
+
type: Number,
|
|
64
|
+
},
|
|
55
65
|
username: { description: "The user's username", type: String },
|
|
56
66
|
});
|
|
57
67
|
userSchema.plugin(passport_local_mongoose_1.default, {
|
|
58
68
|
attemptsField: "attempts",
|
|
59
|
-
interval:
|
|
69
|
+
interval: 1,
|
|
60
70
|
limitAttempts: true,
|
|
61
71
|
maxAttempts: 3,
|
|
62
|
-
|
|
72
|
+
// Test-only schema: maxInterval 0 caps calculatedInterval at 0 so AttemptTooSoon
|
|
73
|
+
// never preempts maxAttempts lockout under rapid supertest logins.
|
|
74
|
+
maxInterval: 0,
|
|
63
75
|
usernameCaseInsensitive: true,
|
|
64
76
|
usernameField: "email",
|
|
65
77
|
});
|
|
66
78
|
userSchema.plugin(plugins_1.createdUpdatedPlugin);
|
|
67
79
|
userSchema.plugin(plugins_1.isDisabledPlugin);
|
|
80
|
+
userSchema.plugin(plugins_1.emailVerificationPlugin);
|
|
68
81
|
userSchema.methods.postCreate = function (body) {
|
|
69
82
|
return __awaiter(this, void 0, void 0, function () {
|
|
70
83
|
return __generator(this, function (_a) {
|
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
import type { TestData } from "./types";
|
|
2
|
-
export declare const applyTestAuthEnv: () => void;
|
|
3
2
|
/** Seeds only the standard users (legacy helper). */
|
|
4
3
|
export declare const setupDb: () => Promise<readonly [import("mongoose").Document<unknown, {}, import("./models").User, {}, import("mongoose").DefaultSchemaOptions> & import("./models").User & {
|
|
5
4
|
_id: import("mongoose").Types.ObjectId;
|
|
@@ -22,7 +21,3 @@ export declare const setupDb: () => Promise<readonly [import("mongoose").Documen
|
|
|
22
21
|
}]>;
|
|
23
22
|
/** Seeds users, foods, and required docs — the recommended API test baseline. */
|
|
24
23
|
export declare const setupTestData: () => Promise<TestData>;
|
|
25
|
-
/** Clears all API test collections without re-seeding. */
|
|
26
|
-
export declare const resetTestCollections: () => Promise<void>;
|
|
27
|
-
export { createTestData } from "./createTestData";
|
|
28
|
-
export { loadTestData } from "./mongoTestSetup";
|
package/dist/tests/testHelper.js
CHANGED
|
@@ -36,7 +36,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
|
|
|
36
36
|
}
|
|
37
37
|
};
|
|
38
38
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
39
|
-
exports.
|
|
39
|
+
exports.setupTestData = exports.setupDb = void 0;
|
|
40
40
|
var test_1 = require("@terreno/test");
|
|
41
41
|
var logger_1 = require("../logger");
|
|
42
42
|
var createTestData_1 = require("./createTestData");
|
|
@@ -49,7 +49,6 @@ var applyTestAuthEnv = function () {
|
|
|
49
49
|
process.env.TOKEN_ISSUER = "example.com";
|
|
50
50
|
process.env.SESSION_SECRET = "session";
|
|
51
51
|
};
|
|
52
|
-
exports.applyTestAuthEnv = applyTestAuthEnv;
|
|
53
52
|
var ensureConnected = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
54
53
|
return __generator(this, function (_a) {
|
|
55
54
|
switch (_a.label) {
|
|
@@ -59,7 +58,7 @@ var ensureConnected = function () { return __awaiter(void 0, void 0, void 0, fun
|
|
|
59
58
|
})];
|
|
60
59
|
case 1:
|
|
61
60
|
_a.sent();
|
|
62
|
-
|
|
61
|
+
applyTestAuthEnv();
|
|
63
62
|
return [2 /*return*/];
|
|
64
63
|
}
|
|
65
64
|
});
|
|
@@ -106,9 +105,3 @@ var setupTestData = function () { return __awaiter(void 0, void 0, void 0, funct
|
|
|
106
105
|
});
|
|
107
106
|
}); };
|
|
108
107
|
exports.setupTestData = setupTestData;
|
|
109
|
-
/** Clears all API test collections without re-seeding. */
|
|
110
|
-
exports.resetTestCollections = createTestData_1.clearTestCollections;
|
|
111
|
-
var createTestData_2 = require("./createTestData");
|
|
112
|
-
Object.defineProperty(exports, "createTestData", { enumerable: true, get: function () { return createTestData_2.createTestData; } });
|
|
113
|
-
var mongoTestSetup_2 = require("./mongoTestSetup");
|
|
114
|
-
Object.defineProperty(exports, "loadTestData", { enumerable: true, get: function () { return mongoTestSetup_2.loadTestData; } });
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type mongoose from "mongoose";
|
|
2
|
+
import type { FindExactlyOnePlugin, FindOneOrNonePlugin } from "../plugins";
|
|
3
|
+
export type AuthTokenType = "passwordReset" | "emailVerification";
|
|
4
|
+
type AuthTokenMethods = Record<string, never>;
|
|
5
|
+
interface AuthTokenStatics extends FindExactlyOnePlugin<AuthTokenDocument>, FindOneOrNonePlugin<AuthTokenDocument> {
|
|
6
|
+
consume: (this: AuthTokenModel, token: string, type: AuthTokenType) => Promise<AuthTokenDocument | null>;
|
|
7
|
+
invalidateUnusedFor: (this: AuthTokenModel, user: {
|
|
8
|
+
_id: {
|
|
9
|
+
toString(): string;
|
|
10
|
+
};
|
|
11
|
+
}, type: AuthTokenType) => Promise<void>;
|
|
12
|
+
issueFor: (this: AuthTokenModel, user: {
|
|
13
|
+
_id: {
|
|
14
|
+
toString(): string;
|
|
15
|
+
};
|
|
16
|
+
}, type: AuthTokenType) => Promise<{
|
|
17
|
+
authToken: AuthTokenDocument;
|
|
18
|
+
token: string;
|
|
19
|
+
}>;
|
|
20
|
+
}
|
|
21
|
+
export interface AuthTokenModel extends mongoose.Model<AuthTokenDocument, object, AuthTokenMethods>, AuthTokenStatics {
|
|
22
|
+
}
|
|
23
|
+
export interface AuthTokenDocument extends mongoose.Document {
|
|
24
|
+
_id: mongoose.Types.ObjectId;
|
|
25
|
+
userId: mongoose.Types.ObjectId;
|
|
26
|
+
tokenHash: string;
|
|
27
|
+
type: AuthTokenType;
|
|
28
|
+
expiresAt: Date;
|
|
29
|
+
consumedAt?: Date;
|
|
30
|
+
created: Date;
|
|
31
|
+
updated: Date;
|
|
32
|
+
}
|
|
33
|
+
export {};
|