@terreno/api 57.2.0 → 57.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
- package/README.md +23 -7
- package/dist/actions.js +19 -7
- package/dist/adminTypes.d.ts +7 -0
- package/dist/adminTypes.js +6 -1
- package/dist/api.d.ts +14 -0
- package/dist/api.js +111 -60
- package/dist/audit/auditApp.d.ts +30 -0
- package/dist/audit/auditApp.js +155 -0
- package/dist/audit/auditEventModel.d.ts +29 -0
- package/dist/audit/auditEventModel.js +102 -0
- package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
- package/dist/audit/cloudTasksEnqueue.js +162 -0
- package/dist/audit/diff.d.ts +10 -0
- package/dist/audit/diff.js +230 -0
- package/dist/audit/processQueue.d.ts +6 -0
- package/dist/audit/processQueue.js +101 -0
- package/dist/audit/rbacSink.d.ts +2 -0
- package/dist/audit/rbacSink.js +82 -0
- package/dist/audit/record.d.ts +56 -0
- package/dist/audit/record.js +373 -0
- package/dist/auth.d.ts +23 -10
- package/dist/auth.js +97 -32
- package/dist/authRecovery.d.ts +5 -0
- package/dist/authRecovery.js +350 -0
- package/dist/authTokens.d.ts +8 -0
- package/dist/authTokens.js +162 -0
- package/dist/betterAuth.d.ts +39 -0
- package/dist/betterAuthApp.d.ts +4 -0
- package/dist/betterAuthApp.js +26 -8
- package/dist/betterAuthSetup.d.ts +44 -2
- package/dist/betterAuthSetup.js +288 -18
- package/dist/collectionRegistry.d.ts +40 -0
- package/dist/collectionRegistry.js +97 -0
- package/dist/configurationApp.d.ts +11 -2
- package/dist/configurationApp.js +2 -4
- package/dist/docLoader.js +35 -6
- package/dist/expressServer.d.ts +26 -3
- package/dist/expressServer.js +79 -11
- package/dist/index.d.ts +42 -1
- package/dist/index.js +84 -2
- package/dist/mcp/auth.d.ts +1 -0
- package/dist/mcp/auth.js +47 -25
- package/dist/mcp/handlers.d.ts +1 -1
- package/dist/mcp/handlers.js +67 -233
- package/dist/mcp/query.d.ts +2 -15
- package/dist/mcp/query.js +8 -8
- package/dist/mcp/registry.d.ts +1 -5
- package/dist/mcp/registry.js +31 -20
- package/dist/mcp/schemaGenerator.d.ts +2 -7
- package/dist/mcp/schemaGenerator.js +41 -116
- package/dist/mcp/server.d.ts +1 -0
- package/dist/mcp/server.js +1 -0
- package/dist/mcp/serviceTokens.d.ts +16 -0
- package/dist/mcp/serviceTokens.js +345 -0
- package/dist/mcp/types.d.ts +2 -2
- package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
- package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
- package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
- package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
- package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
- package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
- package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
- package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
- package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
- package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
- package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
- package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
- package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
- package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
- package/dist/migrations/generate.d.ts +17 -0
- package/dist/migrations/generate.js +277 -0
- package/dist/migrations/load.d.ts +20 -0
- package/dist/migrations/load.js +236 -0
- package/dist/migrations/lock.d.ts +13 -0
- package/dist/migrations/lock.js +145 -0
- package/dist/migrations/runner.d.ts +42 -0
- package/dist/migrations/runner.js +503 -0
- package/dist/migrations/schemaCatalog.d.ts +44 -0
- package/dist/migrations/schemaCatalog.js +326 -0
- package/dist/migrations/types.d.ts +87 -0
- package/dist/migrations/types.js +7 -0
- package/dist/models/mcpServiceToken.d.ts +3 -0
- package/dist/models/mcpServiceToken.js +208 -0
- package/dist/models/notification.d.ts +2 -0
- package/dist/models/notification.js +62 -0
- package/dist/models/notificationPreference.d.ts +2 -0
- package/dist/models/notificationPreference.js +49 -0
- package/dist/notifications/notificationService.d.ts +40 -0
- package/dist/notifications/notificationService.js +323 -0
- package/dist/notifications/notificationsApp.d.ts +18 -0
- package/dist/notifications/notificationsApp.js +250 -0
- package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
- package/dist/notifications/notificationsBeforeSend.js +77 -0
- package/dist/openApi.d.ts +1 -7
- package/dist/openApi.js +7 -6
- package/dist/openApiBuilder.d.ts +19 -7
- package/dist/openApiBuilder.js +61 -8
- package/dist/openApiCompat.js +1 -1
- package/dist/openApiValidator.d.ts +13 -1
- package/dist/openApiValidator.js +200 -38
- package/dist/orgs/orgContext.d.ts +23 -0
- package/dist/orgs/orgContext.js +198 -0
- package/dist/orgs/orgPermissions.d.ts +4 -0
- package/dist/orgs/orgPermissions.js +77 -0
- package/dist/orgs/orgPlugin.d.ts +13 -0
- package/dist/orgs/orgPlugin.js +84 -0
- package/dist/orgs/organizationModel.d.ts +13 -0
- package/dist/orgs/organizationModel.js +301 -0
- package/dist/orgs/organizationSettings.d.ts +19 -0
- package/dist/orgs/organizationSettings.js +120 -0
- package/dist/orgs/orgsApp.d.ts +28 -0
- package/dist/orgs/orgsApp.js +678 -0
- package/dist/permissions.d.ts +7 -13
- package/dist/permissions.js +8 -31
- package/dist/plugins.d.ts +14 -1
- package/dist/plugins.js +17 -6
- package/dist/populate.d.ts +2 -2
- package/dist/populate.js +47 -42
- package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
- package/dist/rateLimit/applyTrustProxy.js +17 -0
- package/dist/rateLimit/createStore.d.ts +2 -0
- package/dist/rateLimit/createStore.js +28 -0
- package/dist/rateLimit/memoryStore.d.ts +2 -0
- package/dist/rateLimit/memoryStore.js +108 -0
- package/dist/rateLimit/middleware.d.ts +3 -0
- package/dist/rateLimit/middleware.js +109 -0
- package/dist/rateLimit/mongoStore.d.ts +4 -0
- package/dist/rateLimit/mongoStore.js +123 -0
- package/dist/rateLimit/policies.d.ts +10 -0
- package/dist/rateLimit/policies.js +149 -0
- package/dist/rateLimit/redisStore.d.ts +4 -0
- package/dist/rateLimit/redisStore.js +156 -0
- package/dist/rateLimit/types.d.ts +54 -0
- package/dist/rateLimit/types.js +9 -0
- package/dist/rbac/access.js +35 -14
- package/dist/rbac/assertAllowed.d.ts +9 -0
- package/dist/rbac/assertAllowed.js +182 -0
- package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
- package/dist/rbac/membershipOrgAdminSource.js +122 -0
- package/dist/rbac/modelRouterAccess.d.ts +4 -0
- package/dist/rbac/modelRouterAccess.js +11 -4
- package/dist/rbac/permissionUtils.js +3 -2
- package/dist/rbac/resolve.js +65 -35
- package/dist/rbac/roleModel.d.ts +2 -5
- package/dist/rbac/roleModel.js +18 -4
- package/dist/rbac/routes.js +15 -6
- package/dist/rbac/statements.d.ts +10 -1
- package/dist/rbac/statements.js +19 -2
- package/dist/rbac/types.d.ts +5 -0
- package/dist/realtime/changeStreamWatcher.d.ts +10 -4
- package/dist/realtime/changeStreamWatcher.js +110 -64
- package/dist/realtime/deprecation.d.ts +13 -0
- package/dist/realtime/deprecation.js +33 -0
- package/dist/realtime/realtimeApp.d.ts +2 -1
- package/dist/realtime/realtimeApp.js +11 -11
- package/dist/realtime/registry.d.ts +0 -31
- package/dist/realtime/registry.js +44 -31
- package/dist/realtime/socketAuth.d.ts +5 -5
- package/dist/realtime/socketAuth.js +11 -1
- package/dist/realtime/socketUser.d.ts +5 -1
- package/dist/realtime/types.d.ts +14 -4
- package/dist/schemaMetadata.d.ts +56 -0
- package/dist/schemaMetadata.js +524 -0
- package/dist/seedRunner.d.ts +88 -0
- package/dist/seedRunner.js +627 -0
- package/dist/sync/adminBroadcastScope.d.ts +40 -0
- package/dist/sync/adminBroadcastScope.js +194 -0
- package/dist/sync/adminWindowAccess.d.ts +13 -0
- package/dist/sync/adminWindowAccess.js +96 -0
- package/dist/sync/adminWindowMutation.d.ts +88 -0
- package/dist/sync/adminWindowMutation.js +247 -0
- package/dist/sync/executors.d.ts +19 -3
- package/dist/sync/executors.js +194 -165
- package/dist/sync/loadHarness.js +28 -19
- package/dist/sync/models.js +26 -24
- package/dist/sync/mutationHandler.d.ts +14 -2
- package/dist/sync/mutationHandler.js +201 -76
- package/dist/sync/registrationSideEffects.d.ts +35 -0
- package/dist/sync/registrationSideEffects.js +151 -0
- package/dist/sync/registry.d.ts +2 -52
- package/dist/sync/registry.js +42 -187
- package/dist/sync/routes.d.ts +13 -0
- package/dist/sync/routes.js +116 -58
- package/dist/sync/scripts/compactTombstones.js +0 -2
- package/dist/sync/socketHandlers.d.ts +8 -2
- package/dist/sync/socketHandlers.js +144 -50
- package/dist/sync/streams.d.ts +2 -0
- package/dist/sync/streams.js +7 -1
- package/dist/sync/syncApp.d.ts +4 -3
- package/dist/sync/syncApp.js +5 -4
- package/dist/sync/syncBatch.d.ts +5 -2
- package/dist/sync/syncBatch.js +7 -6
- package/dist/sync/syncSeqPlugin.d.ts +1 -1
- package/dist/sync/syncSeqPlugin.js +20 -16
- package/dist/sync/types.d.ts +18 -0
- package/dist/terrenoApp.d.ts +48 -5
- package/dist/terrenoApp.js +157 -72
- package/dist/tests/createTestData.d.ts +1 -3
- package/dist/tests/createTestData.js +3 -5
- package/dist/tests/models.d.ts +3 -0
- package/dist/tests/models.js +15 -2
- package/dist/tests/testHelper.d.ts +0 -5
- package/dist/tests/testHelper.js +2 -9
- package/dist/types/authToken.d.ts +33 -0
- package/dist/types/authToken.js +2 -0
- package/dist/types/mcpServiceToken.d.ts +41 -0
- package/dist/types/mcpServiceToken.js +2 -0
- package/dist/types/membership.d.ts +23 -0
- package/dist/types/membership.js +2 -0
- package/dist/types/notification.d.ts +28 -0
- package/dist/types/notification.js +2 -0
- package/dist/types/notificationPreference.d.ts +20 -0
- package/dist/types/notificationPreference.js +2 -0
- package/dist/types/organization.d.ts +36 -0
- package/dist/types/organization.js +2 -0
- package/dist/webhooks/headerValue.d.ts +2 -0
- package/dist/webhooks/headerValue.js +14 -0
- package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
- package/dist/webhooks/idempotency/memoryStore.js +65 -0
- package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
- package/dist/webhooks/idempotency/mongoStore.js +150 -0
- package/dist/webhooks/idempotency/webhookReceipt.d.ts +17 -0
- package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
- package/dist/webhooks/rawBody.d.ts +15 -0
- package/dist/webhooks/rawBody.js +23 -0
- package/dist/webhooks/timingSafeEqual.d.ts +4 -0
- package/dist/webhooks/timingSafeEqual.js +17 -0
- package/dist/webhooks/verifiers/hmac.d.ts +15 -0
- package/dist/webhooks/verifiers/hmac.js +49 -0
- package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
- package/dist/webhooks/verifiers/sendgrid.js +56 -0
- package/dist/webhooks/verifiers/stripe.d.ts +9 -0
- package/dist/webhooks/verifiers/stripe.js +99 -0
- package/dist/webhooks/verifiers/twilio.d.ts +9 -0
- package/dist/webhooks/verifiers/twilio.js +112 -0
- package/dist/webhooks/webhooksApp.d.ts +33 -0
- package/dist/webhooks/webhooksApp.js +195 -0
- package/package.json +32 -27
- package/src/__snapshots__/openApi.test.ts.snap +444 -36
- package/src/__snapshots__/openApiBuilder.test.ts.snap +24 -24
- package/src/__snapshots__/schemaMetadata.test.ts.snap +196 -0
- package/src/actions.ts +20 -13
- package/src/adminModelRouter.test.ts +133 -0
- package/src/adminTypes.ts +8 -0
- package/src/api.arrayOperations.test.ts +43 -31
- package/src/api.hooks.test.ts +38 -29
- package/src/api.query.test.ts +31 -31
- package/src/api.test.ts +133 -97
- package/src/api.ts +84 -27
- package/src/audit/auditApp.test.ts +243 -0
- package/src/audit/auditApp.ts +139 -0
- package/src/audit/auditEventModel.ts +156 -0
- package/src/audit/auditRouter.test.ts +456 -0
- package/src/audit/cloudTasksEnqueue.test.ts +124 -0
- package/src/audit/cloudTasksEnqueue.ts +104 -0
- package/src/audit/diff.ts +163 -0
- package/src/audit/processQueue.ts +69 -0
- package/src/audit/rbacSink.test.ts +86 -0
- package/src/audit/rbacSink.ts +42 -0
- package/src/audit/record.test.ts +402 -0
- package/src/audit/record.ts +328 -0
- package/src/auth.test.ts +108 -52
- package/src/auth.ts +98 -29
- package/src/authRecovery.test.ts +281 -0
- package/src/authRecovery.ts +279 -0
- package/src/authTokens.test.ts +94 -0
- package/src/authTokens.ts +118 -0
- package/src/authVerification.test.ts +293 -0
- package/src/betterAuth.ts +31 -0
- package/src/betterAuthApp.test.ts +1 -0
- package/src/betterAuthApp.ts +27 -9
- package/src/betterAuthSetup.test.ts +595 -38
- package/src/betterAuthSetup.ts +261 -5
- package/src/collectionRegistry.test.ts +164 -0
- package/src/collectionRegistry.ts +135 -0
- package/src/configurationApp.ts +13 -7
- package/src/docLoader.test.ts +45 -1
- package/src/docLoader.ts +37 -6
- package/src/express.d.ts +3 -0
- package/src/expressServer.test.ts +180 -68
- package/src/expressServer.ts +75 -19
- package/src/githubAuth.test.ts +60 -55
- package/src/index.ts +127 -0
- package/src/mcp/auth.test.ts +47 -0
- package/src/mcp/auth.ts +32 -11
- package/src/mcp/handlers.test.ts +275 -0
- package/src/mcp/handlers.ts +45 -172
- package/src/mcp/integration.test.ts +59 -9
- package/src/mcp/query.ts +5 -7
- package/src/mcp/registry.ts +29 -20
- package/src/mcp/schemaGenerator.test.ts +8 -0
- package/src/mcp/schemaGenerator.ts +49 -131
- package/src/mcp/server.ts +2 -0
- package/src/mcp/serviceTokens.test.ts +330 -0
- package/src/mcp/serviceTokens.ts +307 -0
- package/src/mcp/toolGenerator.test.ts +82 -1
- package/src/mcp/types.ts +2 -6
- package/src/migrations/cli.test.ts +376 -0
- package/src/migrations/cli.ts +283 -0
- package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
- package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
- package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
- package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
- package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
- package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
- package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
- package/src/migrations/generate.test.ts +333 -0
- package/src/migrations/generate.ts +216 -0
- package/src/migrations/load.test.ts +103 -0
- package/src/migrations/load.ts +124 -0
- package/src/migrations/lock.test.ts +133 -0
- package/src/migrations/lock.ts +118 -0
- package/src/migrations/runner.test.ts +504 -0
- package/src/migrations/runner.ts +358 -0
- package/src/migrations/schemaCatalog.test.ts +159 -0
- package/src/migrations/schemaCatalog.ts +262 -0
- package/src/migrations/types.ts +94 -0
- package/src/models/mcpServiceToken.test.ts +129 -0
- package/src/models/mcpServiceToken.ts +158 -0
- package/src/models/notification.ts +68 -0
- package/src/models/notificationPreference.ts +62 -0
- package/src/notifications/notificationService.ts +254 -0
- package/src/notifications/notificationsApp.test.ts +505 -0
- package/src/notifications/notificationsApp.ts +200 -0
- package/src/notifications/notificationsBeforeSend.ts +51 -0
- package/src/openApi.test.ts +80 -65
- package/src/openApi.ts +2 -1
- package/src/openApiBuilder.test.ts +95 -7
- package/src/openApiBuilder.ts +60 -12
- package/src/openApiCompat.ts +1 -1
- package/src/openApiValidator.test.ts +270 -56
- package/src/openApiValidator.ts +219 -36
- package/src/orgs/orgAccessOptIn.test.ts +87 -0
- package/src/orgs/orgContext.test.ts +259 -0
- package/src/orgs/orgContext.ts +151 -0
- package/src/orgs/orgPermissions.test.ts +105 -0
- package/src/orgs/orgPermissions.ts +40 -0
- package/src/orgs/orgPlugin.test.ts +130 -0
- package/src/orgs/orgPlugin.ts +70 -0
- package/src/orgs/orgRbac.test.ts +267 -0
- package/src/orgs/orgSecurityDefects.test.ts +415 -0
- package/src/orgs/organizationModel.test.ts +205 -0
- package/src/orgs/organizationModel.ts +257 -0
- package/src/orgs/organizationSettings.test.ts +113 -0
- package/src/orgs/organizationSettings.ts +126 -0
- package/src/orgs/orgsApp.test.ts +382 -0
- package/src/orgs/orgsApp.ts +563 -0
- package/src/permissions.test.ts +62 -36
- package/src/permissions.ts +8 -30
- package/src/plugins.test.ts +14 -0
- package/src/plugins.ts +34 -9
- package/src/populate.test.ts +34 -0
- package/src/populate.ts +40 -29
- package/src/rateLimit/applyTrustProxy.ts +17 -0
- package/src/rateLimit/createStore.ts +25 -0
- package/src/rateLimit/memoryStore.ts +40 -0
- package/src/rateLimit/middleware.ts +79 -0
- package/src/rateLimit/mongoStore.test.ts +80 -0
- package/src/rateLimit/mongoStore.ts +77 -0
- package/src/rateLimit/policies.ts +130 -0
- package/src/rateLimit/rateLimit.test.ts +328 -0
- package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
- package/src/rateLimit/redisStore.test.ts +114 -0
- package/src/rateLimit/redisStore.ts +86 -0
- package/src/rateLimit/types.ts +64 -0
- package/src/rbac/access.ts +16 -4
- package/src/rbac/assertAllowed.test.ts +325 -0
- package/src/rbac/assertAllowed.ts +157 -0
- package/src/rbac/backfillAdmins.test.ts +124 -0
- package/src/rbac/fieldViews.test.ts +89 -0
- package/src/rbac/membershipOrgAdminSource.ts +59 -0
- package/src/rbac/modelRouterAccess.test.ts +126 -0
- package/src/rbac/modelRouterAccess.ts +8 -2
- package/src/rbac/permissionUtils.test.ts +26 -5
- package/src/rbac/permissionUtils.ts +3 -2
- package/src/rbac/realtimeAccess.test.ts +109 -1
- package/src/rbac/resolve.test.ts +34 -2
- package/src/rbac/resolve.ts +31 -11
- package/src/rbac/roleManager.test.ts +169 -0
- package/src/rbac/roleModel.test.ts +34 -1
- package/src/rbac/roleModel.ts +17 -1
- package/src/rbac/routes.test.ts +233 -0
- package/src/rbac/routes.ts +16 -6
- package/src/rbac/statements.test.ts +19 -0
- package/src/rbac/statements.ts +19 -1
- package/src/rbac/types.ts +5 -0
- package/src/realtime/changeStreamWatcher.ts +73 -33
- package/src/realtime/deprecation.test.ts +60 -0
- package/src/realtime/deprecation.ts +33 -0
- package/src/realtime/realtime.test.ts +365 -189
- package/src/realtime/realtimeApp.ts +11 -11
- package/src/realtime/realtimeAppSetup.test.ts +32 -5
- package/src/realtime/registry.ts +48 -42
- package/src/realtime/sessionRevalidation.test.ts +57 -44
- package/src/realtime/socketAuth.test.ts +75 -23
- package/src/realtime/socketAuth.ts +17 -6
- package/src/realtime/socketUser.ts +5 -3
- package/src/realtime/types.ts +14 -4
- package/src/schemaMetadata.test.ts +419 -0
- package/src/schemaMetadata.ts +593 -0
- package/src/scrubAdminFields.test.ts +105 -0
- package/src/seedRunner.test.ts +591 -0
- package/src/seedRunner.ts +464 -0
- package/src/sync/adminBroadcastConfig.test.ts +96 -0
- package/src/sync/adminBroadcastScope.test.ts +155 -0
- package/src/sync/adminBroadcastScope.ts +123 -0
- package/src/sync/adminWindowAccess.test.ts +57 -0
- package/src/sync/adminWindowAccess.ts +32 -0
- package/src/sync/adminWindowMutation.test.ts +450 -0
- package/src/sync/adminWindowMutation.ts +283 -0
- package/src/sync/docMatchesMutationData.test.ts +16 -0
- package/src/sync/ensureSyncIndexes.test.ts +54 -15
- package/src/sync/executors.test.ts +40 -0
- package/src/sync/executors.ts +57 -18
- package/src/sync/integration.test.ts +15 -7
- package/src/sync/loadHarness.ts +28 -19
- package/src/sync/models.ts +32 -18
- package/src/sync/mutationHandler.test.ts +293 -17
- package/src/sync/mutationHandler.ts +180 -36
- package/src/sync/registrationSideEffects.test.ts +126 -0
- package/src/sync/registrationSideEffects.ts +131 -0
- package/src/sync/registry.ts +49 -171
- package/src/sync/routes.ts +55 -10
- package/src/sync/scripts/compactTombstones.ts +0 -2
- package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
- package/src/sync/socketHandlers.ts +154 -58
- package/src/sync/streams.ts +6 -0
- package/src/sync/sync.test.ts +28 -25
- package/src/sync/syncApp.ts +5 -4
- package/src/sync/syncBatch.ts +10 -4
- package/src/sync/syncFrontier.test.ts +17 -15
- package/src/sync/syncPhaseC.test.ts +54 -43
- package/src/sync/syncRoutes.test.ts +347 -38
- package/src/sync/syncSeqPlugin.ts +66 -44
- package/src/sync/syncSocket.test.ts +341 -81
- package/src/sync/types.ts +20 -0
- package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
- package/src/terrenoApp.migrations.test.ts +114 -0
- package/src/terrenoApp.test.ts +41 -0
- package/src/terrenoApp.ts +181 -46
- package/src/tests/createTestData.ts +2 -2
- package/src/tests/models.ts +24 -3
- package/src/tests/testHelper.ts +1 -7
- package/src/types/authToken.ts +41 -0
- package/src/types/mcpServiceToken.ts +48 -0
- package/src/types/membership.ts +48 -0
- package/src/types/notification.ts +34 -0
- package/src/types/notificationPreference.ts +28 -0
- package/src/types/organization.ts +49 -0
- package/src/webhooks/headerValue.test.ts +22 -0
- package/src/webhooks/headerValue.ts +12 -0
- package/src/webhooks/idempotency/memoryStore.ts +34 -0
- package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
- package/src/webhooks/idempotency/mongoStore.ts +83 -0
- package/src/webhooks/idempotency/webhookReceipt.ts +67 -0
- package/src/webhooks/rawBody.test.ts +107 -0
- package/src/webhooks/rawBody.ts +24 -0
- package/src/webhooks/timingSafeEqual.ts +16 -0
- package/src/webhooks/verifiers/hmac.test.ts +110 -0
- package/src/webhooks/verifiers/hmac.ts +54 -0
- package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
- package/src/webhooks/verifiers/sendgrid.ts +59 -0
- package/src/webhooks/verifiers/stripe.ts +67 -0
- package/src/webhooks/verifiers/twilio.ts +69 -0
- package/src/webhooks/webhooksApp.test.ts +221 -0
- package/src/webhooks/webhooksApp.ts +144 -0
- package/tsconfig.json +1 -1
- package/tsconfig.typedoc.json +2 -1
- package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
- package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
- package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
package/src/docLoader.test.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import {describe, expect, it, mock} from "bun:test";
|
|
2
|
-
import type
|
|
2
|
+
import mongoose, {type Model} from "mongoose";
|
|
3
3
|
import {loadDocOr404} from "./docLoader";
|
|
4
4
|
import {APIError} from "./errors";
|
|
5
5
|
|
|
@@ -38,6 +38,50 @@ describe("loadDocOr404", () => {
|
|
|
38
38
|
await expect(loadDocOr404(model, "507f1f77bcf86cd799439011")).rejects.toBe(original);
|
|
39
39
|
});
|
|
40
40
|
|
|
41
|
+
it("maps CastError on a populate path to a GET error, not 404", async () => {
|
|
42
|
+
const model = {
|
|
43
|
+
collection: {findOne: mock(async () => null)},
|
|
44
|
+
findById: mock(() => ({
|
|
45
|
+
exec: mock(async () => {
|
|
46
|
+
throw new mongoose.Error.CastError("ObjectId", "not-an-object-id", "ownerId");
|
|
47
|
+
}),
|
|
48
|
+
})),
|
|
49
|
+
modelName: "MockModel",
|
|
50
|
+
} as unknown as Model<unknown>;
|
|
51
|
+
|
|
52
|
+
try {
|
|
53
|
+
await loadDocOr404(model, "507f1f77bcf86cd799439011");
|
|
54
|
+
expect.unreachable("expected loadDocOr404 to throw");
|
|
55
|
+
} catch (error) {
|
|
56
|
+
expect(error).toBeInstanceOf(APIError);
|
|
57
|
+
const apiError = error as APIError;
|
|
58
|
+
expect(apiError.status).toBe(500);
|
|
59
|
+
expect(apiError.title).toBe("GET error");
|
|
60
|
+
}
|
|
61
|
+
});
|
|
62
|
+
|
|
63
|
+
it("maps CastError from findById to a 404", async () => {
|
|
64
|
+
const model = {
|
|
65
|
+
collection: {findOne: mock(async () => null)},
|
|
66
|
+
findById: mock(() => ({
|
|
67
|
+
exec: mock(async () => {
|
|
68
|
+
throw new mongoose.Error.CastError("ObjectId", "not-an-object-id", "_id");
|
|
69
|
+
}),
|
|
70
|
+
})),
|
|
71
|
+
modelName: "MockModel",
|
|
72
|
+
} as unknown as Model<unknown>;
|
|
73
|
+
|
|
74
|
+
try {
|
|
75
|
+
await loadDocOr404(model, "not-an-object-id");
|
|
76
|
+
expect.unreachable("expected loadDocOr404 to throw");
|
|
77
|
+
} catch (error) {
|
|
78
|
+
expect(error).toBeInstanceOf(APIError);
|
|
79
|
+
const apiError = error as APIError;
|
|
80
|
+
expect(apiError.status).toBe(404);
|
|
81
|
+
expect(apiError.title).toBe("Document not found");
|
|
82
|
+
}
|
|
83
|
+
});
|
|
84
|
+
|
|
41
85
|
it("returns plain not found when document does not exist", async () => {
|
|
42
86
|
const model = {
|
|
43
87
|
collection: {findOne: mock(async () => null)},
|
package/src/docLoader.ts
CHANGED
|
@@ -4,6 +4,30 @@ import {addPopulateToQuery} from "./api";
|
|
|
4
4
|
import {APIError, errorDetail, isAPIError, NotFoundError} from "./errors";
|
|
5
5
|
import type {PopulatePath} from "./populate";
|
|
6
6
|
|
|
7
|
+
const isCastErrorOnDocumentId = (error: unknown): boolean => {
|
|
8
|
+
if (error instanceof mongoose.Error.CastError) {
|
|
9
|
+
return error.path === "_id";
|
|
10
|
+
}
|
|
11
|
+
const maybe = error as {name?: string; path?: string} | undefined;
|
|
12
|
+
return maybe?.name === "CastError" && maybe.path === "_id";
|
|
13
|
+
};
|
|
14
|
+
|
|
15
|
+
const isInvalidIdError = (error: unknown): boolean => {
|
|
16
|
+
if (isCastErrorOnDocumentId(error)) {
|
|
17
|
+
return true;
|
|
18
|
+
}
|
|
19
|
+
const name = (error as {name?: string} | undefined)?.name;
|
|
20
|
+
return name === "BSONError" || name === "BSONTypeError";
|
|
21
|
+
};
|
|
22
|
+
|
|
23
|
+
const documentNotFound = (modelName: string, id: string): NotFoundError => {
|
|
24
|
+
return new NotFoundError({
|
|
25
|
+
code: "document-not-found",
|
|
26
|
+
detail: `Document ${id} not found for model ${modelName}`,
|
|
27
|
+
title: "Document not found",
|
|
28
|
+
});
|
|
29
|
+
};
|
|
30
|
+
|
|
7
31
|
/**
|
|
8
32
|
* Loads a document by id or throws a 404 APIError.
|
|
9
33
|
* Matches permission middleware behavior including soft-delete metadata.
|
|
@@ -25,6 +49,9 @@ export const loadDocOr404 = async <T>(
|
|
|
25
49
|
if (isAPIError(error)) {
|
|
26
50
|
throw error;
|
|
27
51
|
}
|
|
52
|
+
if (isInvalidIdError(error)) {
|
|
53
|
+
throw documentNotFound(model.modelName, id);
|
|
54
|
+
}
|
|
28
55
|
throw new APIError({
|
|
29
56
|
cause: error,
|
|
30
57
|
code: "get-error",
|
|
@@ -36,7 +63,15 @@ export const loadDocOr404 = async <T>(
|
|
|
36
63
|
}
|
|
37
64
|
if (!data) {
|
|
38
65
|
const idSchemaType = model.schema?.path("_id");
|
|
39
|
-
|
|
66
|
+
let hiddenId: unknown;
|
|
67
|
+
try {
|
|
68
|
+
hiddenId = idSchemaType?.instance === "String" ? id : new mongoose.Types.ObjectId(id);
|
|
69
|
+
} catch (error: unknown) {
|
|
70
|
+
if (isInvalidIdError(error)) {
|
|
71
|
+
throw documentNotFound(model.modelName, id);
|
|
72
|
+
}
|
|
73
|
+
throw error;
|
|
74
|
+
}
|
|
40
75
|
const hiddenDoc = await model.collection.findOne({
|
|
41
76
|
_id: hiddenId as never,
|
|
42
77
|
});
|
|
@@ -44,11 +79,7 @@ export const loadDocOr404 = async <T>(
|
|
|
44
79
|
const notFoundDetail = `Document ${id} not found for model ${model.modelName}`;
|
|
45
80
|
|
|
46
81
|
if (!hiddenDoc) {
|
|
47
|
-
throw
|
|
48
|
-
code: "document-not-found",
|
|
49
|
-
detail: notFoundDetail,
|
|
50
|
-
title: "Document not found",
|
|
51
|
-
});
|
|
82
|
+
throw documentNotFound(model.modelName, id);
|
|
52
83
|
}
|
|
53
84
|
|
|
54
85
|
let reason: {[key: string]: string} | null = null;
|
package/src/express.d.ts
CHANGED
|
@@ -6,6 +6,7 @@ declare namespace Express {
|
|
|
6
6
|
[key: string]: unknown;
|
|
7
7
|
};
|
|
8
8
|
jobId?: string;
|
|
9
|
+
rawBody?: Buffer;
|
|
9
10
|
requestId?: string;
|
|
10
11
|
sessionId?: string;
|
|
11
12
|
user?: {
|
|
@@ -18,5 +19,7 @@ declare namespace Express {
|
|
|
18
19
|
email?: string;
|
|
19
20
|
[key: string]: unknown;
|
|
20
21
|
};
|
|
22
|
+
organization?: unknown;
|
|
23
|
+
membership?: unknown;
|
|
21
24
|
}
|
|
22
25
|
}
|
|
@@ -1,8 +1,6 @@
|
|
|
1
|
-
// noExplicitAny: test mock typing
|
|
2
|
-
// biome-ignore-all lint/suspicious/noExplicitAny: test mock typing
|
|
3
1
|
import {afterEach, beforeEach, describe, expect, it, mock} from "bun:test";
|
|
4
2
|
import {Writable} from "node:stream";
|
|
5
|
-
import express from "express";
|
|
3
|
+
import express, {type Router} from "express";
|
|
6
4
|
import supertest from "supertest";
|
|
7
5
|
import winston from "winston";
|
|
8
6
|
|
|
@@ -21,6 +19,12 @@ import {UserModel} from "./tests";
|
|
|
21
19
|
|
|
22
20
|
const typedUserModel = UserModel as unknown as UserModelType;
|
|
23
21
|
|
|
22
|
+
// `routeMount` is set by createRouter's internal middleware and is not part of the
|
|
23
|
+
// Express request types.
|
|
24
|
+
interface RouteMountRequest extends express.Request {
|
|
25
|
+
routeMount?: string[] | string;
|
|
26
|
+
}
|
|
27
|
+
|
|
24
28
|
describe("expressServer", () => {
|
|
25
29
|
describe("setupEnvironment", () => {
|
|
26
30
|
const originalEnv = process.env;
|
|
@@ -88,7 +92,7 @@ describe("expressServer", () => {
|
|
|
88
92
|
},
|
|
89
93
|
logRequests: false,
|
|
90
94
|
skipListen: true,
|
|
91
|
-
userModel:
|
|
95
|
+
userModel: typedUserModel,
|
|
92
96
|
}).build();
|
|
93
97
|
winstonLogger.add(transport);
|
|
94
98
|
|
|
@@ -193,12 +197,64 @@ describe("expressServer", () => {
|
|
|
193
197
|
expect(req.body.password).toBe("secret123");
|
|
194
198
|
});
|
|
195
199
|
|
|
200
|
+
it("redacts token and newPassword in logged request bodies", () => {
|
|
201
|
+
const logged: string[] = [];
|
|
202
|
+
const originalDebug = logger.debug;
|
|
203
|
+
logger.debug = ((message: string) => {
|
|
204
|
+
logged.push(message);
|
|
205
|
+
}) as typeof logger.debug;
|
|
206
|
+
try {
|
|
207
|
+
const req = {
|
|
208
|
+
body: {newPassword: "fresh-secret", token: "one-time-token", username: "testuser"},
|
|
209
|
+
method: "POST",
|
|
210
|
+
url: "/auth/resetPassword",
|
|
211
|
+
};
|
|
212
|
+
const res = {
|
|
213
|
+
locals: {},
|
|
214
|
+
on: () => {},
|
|
215
|
+
};
|
|
216
|
+
logRequests(req as never, res as never, () => {});
|
|
217
|
+
const combined = logged.join("\n");
|
|
218
|
+
expect(combined).toContain("<REDACTED>");
|
|
219
|
+
expect(combined).not.toContain("fresh-secret");
|
|
220
|
+
expect(combined).not.toContain("one-time-token");
|
|
221
|
+
expect(req.body.token).toBe("one-time-token");
|
|
222
|
+
expect(req.body.newPassword).toBe("fresh-secret");
|
|
223
|
+
} finally {
|
|
224
|
+
logger.debug = originalDebug;
|
|
225
|
+
}
|
|
226
|
+
});
|
|
227
|
+
|
|
228
|
+
it("redacts token query params in request URLs", () => {
|
|
229
|
+
const logged: string[] = [];
|
|
230
|
+
const originalDebug = logger.debug;
|
|
231
|
+
logger.debug = ((message: string) => {
|
|
232
|
+
logged.push(message);
|
|
233
|
+
}) as typeof logger.debug;
|
|
234
|
+
try {
|
|
235
|
+
const req = {
|
|
236
|
+
body: {},
|
|
237
|
+
method: "GET",
|
|
238
|
+
url: "/api/auth/verify-email?token=one-time-token",
|
|
239
|
+
};
|
|
240
|
+
const res = {
|
|
241
|
+
locals: {},
|
|
242
|
+
on: () => {},
|
|
243
|
+
};
|
|
244
|
+
logRequests(req as never, res as never, () => {});
|
|
245
|
+
const combined = logged.join("\n");
|
|
246
|
+
expect(combined).toContain("token=%3CREDACTED%3E");
|
|
247
|
+
expect(combined).not.toContain("one-time-token");
|
|
248
|
+
} finally {
|
|
249
|
+
logger.debug = originalDebug;
|
|
250
|
+
}
|
|
251
|
+
});
|
|
252
|
+
|
|
196
253
|
it("triggers onFinished callback with route info", async () => {
|
|
197
254
|
const app = express();
|
|
198
255
|
app.use(logRequests);
|
|
199
|
-
app.get("/test", (req
|
|
200
|
-
req.
|
|
201
|
-
req.routeMount = "/api";
|
|
256
|
+
app.get("/test", (req, res) => {
|
|
257
|
+
(req as RouteMountRequest).routeMount = "/api";
|
|
202
258
|
res.json({ok: true});
|
|
203
259
|
});
|
|
204
260
|
|
|
@@ -255,8 +311,7 @@ describe("expressServer", () => {
|
|
|
255
311
|
it("handles request with route path only (no routeMount)", async () => {
|
|
256
312
|
const app = express();
|
|
257
313
|
app.use(logRequests);
|
|
258
|
-
app.get("/test", (
|
|
259
|
-
req.route = {path: "/test"};
|
|
314
|
+
app.get("/test", (_req, res) => {
|
|
260
315
|
// No routeMount set
|
|
261
316
|
res.json({ok: true});
|
|
262
317
|
});
|
|
@@ -268,9 +323,9 @@ describe("expressServer", () => {
|
|
|
268
323
|
describe("createRouter", () => {
|
|
269
324
|
it("creates router with root path and adds routes", () => {
|
|
270
325
|
let routesCalled = false;
|
|
271
|
-
const addRoutes = (router:
|
|
326
|
+
const addRoutes = (router: Router) => {
|
|
272
327
|
routesCalled = true;
|
|
273
|
-
router.get("/test", (_req
|
|
328
|
+
router.get("/test", (_req, res) => res.send("ok"));
|
|
274
329
|
};
|
|
275
330
|
|
|
276
331
|
const result = createRouter("/api", addRoutes);
|
|
@@ -281,8 +336,8 @@ describe("expressServer", () => {
|
|
|
281
336
|
});
|
|
282
337
|
|
|
283
338
|
it("creates router with middleware", () => {
|
|
284
|
-
const middleware1 = (_req
|
|
285
|
-
const middleware2 = (_req
|
|
339
|
+
const middleware1: express.RequestHandler = (_req, _res, next) => next();
|
|
340
|
+
const middleware2: express.RequestHandler = (_req, _res, next) => next();
|
|
286
341
|
const addRoutes = () => {};
|
|
287
342
|
|
|
288
343
|
const result = createRouter("/api", addRoutes, [middleware1, middleware2]);
|
|
@@ -292,15 +347,15 @@ describe("expressServer", () => {
|
|
|
292
347
|
});
|
|
293
348
|
|
|
294
349
|
it("routePathMiddleware sets routeMount on request", () => {
|
|
295
|
-
const addRoutes = (router:
|
|
296
|
-
router.get("/test", (req
|
|
297
|
-
res.json({routeMount: req.routeMount});
|
|
350
|
+
const addRoutes = (router: Router) => {
|
|
351
|
+
router.get("/test", (req, res) => {
|
|
352
|
+
res.json({routeMount: (req as RouteMountRequest).routeMount});
|
|
298
353
|
});
|
|
299
354
|
};
|
|
300
355
|
|
|
301
356
|
const result = createRouter("/api", addRoutes);
|
|
302
357
|
const app = express();
|
|
303
|
-
app.use(...(result as [string, ...
|
|
358
|
+
app.use(...(result as [string, ...express.RequestHandler[]]));
|
|
304
359
|
|
|
305
360
|
// The routePathMiddleware is internal, but we can verify the router works
|
|
306
361
|
expect(result[0]).toBe("/api");
|
|
@@ -310,9 +365,9 @@ describe("expressServer", () => {
|
|
|
310
365
|
describe("createRouterWithAuth", () => {
|
|
311
366
|
it("creates router with passport authentication middleware", () => {
|
|
312
367
|
let routesCalled = false;
|
|
313
|
-
const addRoutes = (router:
|
|
368
|
+
const addRoutes = (router: Router) => {
|
|
314
369
|
routesCalled = true;
|
|
315
|
-
router.get("/protected", (_req
|
|
370
|
+
router.get("/protected", (_req, res) => res.send("ok"));
|
|
316
371
|
};
|
|
317
372
|
|
|
318
373
|
const result = createRouterWithAuth("/secure", addRoutes);
|
|
@@ -324,7 +379,7 @@ describe("expressServer", () => {
|
|
|
324
379
|
});
|
|
325
380
|
|
|
326
381
|
it("includes additional middleware", () => {
|
|
327
|
-
const customMiddleware = (_req
|
|
382
|
+
const customMiddleware: express.RequestHandler = (_req, _res, next) => next();
|
|
328
383
|
const addRoutes = () => {};
|
|
329
384
|
|
|
330
385
|
const result = createRouterWithAuth("/secure", addRoutes, [customMiddleware]);
|
|
@@ -378,36 +433,36 @@ describe("expressServer", () => {
|
|
|
378
433
|
|
|
379
434
|
describe("createRouter routePathMiddleware", () => {
|
|
380
435
|
it("initializes routeMount array when not present", async () => {
|
|
381
|
-
const addRoutes = (router:
|
|
382
|
-
router.get("/test", (req
|
|
383
|
-
res.json({routeMount: req.routeMount});
|
|
436
|
+
const addRoutes = (router: Router) => {
|
|
437
|
+
router.get("/test", (req, res) => {
|
|
438
|
+
res.json({routeMount: (req as RouteMountRequest).routeMount});
|
|
384
439
|
});
|
|
385
440
|
};
|
|
386
441
|
|
|
387
442
|
const result = createRouter("/api", addRoutes);
|
|
388
443
|
const app = express();
|
|
389
|
-
app.use(...(result as [string, ...
|
|
444
|
+
app.use(...(result as [string, ...express.RequestHandler[]]));
|
|
390
445
|
|
|
391
446
|
const response = await supertest(app).get("/api/test").expect(200);
|
|
392
447
|
expect(response.body.routeMount).toEqual(["/api"]);
|
|
393
448
|
});
|
|
394
449
|
|
|
395
450
|
it("appends to existing routeMount array", async () => {
|
|
396
|
-
const addRoutes = (router:
|
|
397
|
-
router.get("/test", (req
|
|
398
|
-
res.json({routeMount: req.routeMount});
|
|
451
|
+
const addRoutes = (router: Router) => {
|
|
452
|
+
router.get("/test", (req, res) => {
|
|
453
|
+
res.json({routeMount: (req as RouteMountRequest).routeMount});
|
|
399
454
|
});
|
|
400
455
|
};
|
|
401
456
|
|
|
402
457
|
// Create nested routers
|
|
403
458
|
const innerResult = createRouter("/inner", addRoutes);
|
|
404
|
-
const outerAddRoutes = (router:
|
|
405
|
-
router.use(...(innerResult as [string, ...
|
|
459
|
+
const outerAddRoutes = (router: Router) => {
|
|
460
|
+
router.use(...(innerResult as [string, ...express.RequestHandler[]]));
|
|
406
461
|
};
|
|
407
462
|
const outerResult = createRouter("/outer", outerAddRoutes);
|
|
408
463
|
|
|
409
464
|
const app = express();
|
|
410
|
-
app.use(...(outerResult as [string, ...
|
|
465
|
+
app.use(...(outerResult as [string, ...express.RequestHandler[]]));
|
|
411
466
|
|
|
412
467
|
const response = await supertest(app).get("/outer/inner/test").expect(200);
|
|
413
468
|
expect(response.body.routeMount).toEqual(["/outer", "/inner"]);
|
|
@@ -438,7 +493,7 @@ describe("expressServer", () => {
|
|
|
438
493
|
const app = new TerrenoApp({
|
|
439
494
|
configureApp,
|
|
440
495
|
skipListen: true,
|
|
441
|
-
userModel:
|
|
496
|
+
userModel: typedUserModel,
|
|
442
497
|
}).build();
|
|
443
498
|
|
|
444
499
|
expect(app).toBeDefined();
|
|
@@ -449,13 +504,14 @@ describe("expressServer", () => {
|
|
|
449
504
|
const configureApp = (): void => {};
|
|
450
505
|
|
|
451
506
|
const app = new TerrenoApp({
|
|
452
|
-
beforeJsonSetup: (httpApp:
|
|
507
|
+
beforeJsonSetup: (httpApp: express.Application) => {
|
|
453
508
|
middlewareCalled = true;
|
|
454
|
-
|
|
509
|
+
const passthrough: express.RequestHandler = (_req, _res, next) => next();
|
|
510
|
+
httpApp.use(passthrough);
|
|
455
511
|
},
|
|
456
512
|
configureApp,
|
|
457
513
|
skipListen: true,
|
|
458
|
-
userModel:
|
|
514
|
+
userModel: typedUserModel,
|
|
459
515
|
}).build();
|
|
460
516
|
|
|
461
517
|
expect(app).toBeDefined();
|
|
@@ -469,7 +525,7 @@ describe("expressServer", () => {
|
|
|
469
525
|
configureApp,
|
|
470
526
|
corsOrigin: "https://example.com",
|
|
471
527
|
skipListen: true,
|
|
472
|
-
userModel:
|
|
528
|
+
userModel: typedUserModel,
|
|
473
529
|
}).build();
|
|
474
530
|
|
|
475
531
|
expect(app).toBeDefined();
|
|
@@ -485,7 +541,7 @@ describe("expressServer", () => {
|
|
|
485
541
|
},
|
|
486
542
|
configureApp,
|
|
487
543
|
skipListen: true,
|
|
488
|
-
userModel:
|
|
544
|
+
userModel: typedUserModel,
|
|
489
545
|
}).build();
|
|
490
546
|
|
|
491
547
|
expect(app).toBeDefined();
|
|
@@ -497,7 +553,7 @@ describe("expressServer", () => {
|
|
|
497
553
|
const app = express();
|
|
498
554
|
app.use(logRequests);
|
|
499
555
|
// Middleware that sets statusCode < 400 but doesn't define route
|
|
500
|
-
app.use((_req
|
|
556
|
+
app.use((_req, res) => {
|
|
501
557
|
res.status(200).json({ok: true});
|
|
502
558
|
});
|
|
503
559
|
|
|
@@ -507,9 +563,8 @@ describe("expressServer", () => {
|
|
|
507
563
|
it("handles request with routeMount as string (legacy)", async () => {
|
|
508
564
|
const app = express();
|
|
509
565
|
app.use(logRequests);
|
|
510
|
-
app.get("/test", (req
|
|
511
|
-
req.
|
|
512
|
-
req.routeMount = "/api"; // String instead of array
|
|
566
|
+
app.get("/test", (req, res) => {
|
|
567
|
+
(req as RouteMountRequest).routeMount = "/api"; // String instead of array
|
|
513
568
|
res.json({ok: true});
|
|
514
569
|
});
|
|
515
570
|
|
|
@@ -536,8 +591,8 @@ describe("expressServer", () => {
|
|
|
536
591
|
});
|
|
537
592
|
|
|
538
593
|
it("sets Sentry transaction ID tag from header", async () => {
|
|
539
|
-
const configureApp = (httpApp:
|
|
540
|
-
httpApp.get("/test", (_req
|
|
594
|
+
const configureApp = (httpApp: Router) => {
|
|
595
|
+
httpApp.get("/test", (_req, res) => {
|
|
541
596
|
res.json({ok: true});
|
|
542
597
|
});
|
|
543
598
|
};
|
|
@@ -545,15 +600,15 @@ describe("expressServer", () => {
|
|
|
545
600
|
const app = new TerrenoApp({
|
|
546
601
|
configureApp,
|
|
547
602
|
skipListen: true,
|
|
548
|
-
userModel:
|
|
603
|
+
userModel: typedUserModel,
|
|
549
604
|
}).build();
|
|
550
605
|
|
|
551
606
|
await supertest(app).get("/test").set("X-Transaction-ID", "txn-123").expect(200);
|
|
552
607
|
});
|
|
553
608
|
|
|
554
609
|
it("sets Sentry session ID tag from header", async () => {
|
|
555
|
-
const configureApp = (httpApp:
|
|
556
|
-
httpApp.get("/test", (_req
|
|
610
|
+
const configureApp = (httpApp: Router) => {
|
|
611
|
+
httpApp.get("/test", (_req, res) => {
|
|
557
612
|
res.json({ok: true});
|
|
558
613
|
});
|
|
559
614
|
};
|
|
@@ -561,15 +616,15 @@ describe("expressServer", () => {
|
|
|
561
616
|
const app = new TerrenoApp({
|
|
562
617
|
configureApp,
|
|
563
618
|
skipListen: true,
|
|
564
|
-
userModel:
|
|
619
|
+
userModel: typedUserModel,
|
|
565
620
|
}).build();
|
|
566
621
|
|
|
567
622
|
await supertest(app).get("/test").set("X-Session-ID", "session-456").expect(200);
|
|
568
623
|
});
|
|
569
624
|
|
|
570
625
|
it("sets both transaction and session ID tags", async () => {
|
|
571
|
-
const configureApp = (httpApp:
|
|
572
|
-
httpApp.get("/test", (_req
|
|
626
|
+
const configureApp = (httpApp: Router) => {
|
|
627
|
+
httpApp.get("/test", (_req, res) => {
|
|
573
628
|
res.json({ok: true});
|
|
574
629
|
});
|
|
575
630
|
};
|
|
@@ -577,7 +632,7 @@ describe("expressServer", () => {
|
|
|
577
632
|
const app = new TerrenoApp({
|
|
578
633
|
configureApp,
|
|
579
634
|
skipListen: true,
|
|
580
|
-
userModel:
|
|
635
|
+
userModel: typedUserModel,
|
|
581
636
|
}).build();
|
|
582
637
|
|
|
583
638
|
await supertest(app)
|
|
@@ -588,8 +643,8 @@ describe("expressServer", () => {
|
|
|
588
643
|
});
|
|
589
644
|
|
|
590
645
|
it("handles fallthrough error handler", async () => {
|
|
591
|
-
const configureApp = (httpApp:
|
|
592
|
-
httpApp.get("/error", (
|
|
646
|
+
const configureApp = (httpApp: Router) => {
|
|
647
|
+
httpApp.get("/error", () => {
|
|
593
648
|
throw new Error("Unexpected error");
|
|
594
649
|
});
|
|
595
650
|
};
|
|
@@ -597,15 +652,15 @@ describe("expressServer", () => {
|
|
|
597
652
|
const app = new TerrenoApp({
|
|
598
653
|
configureApp,
|
|
599
654
|
skipListen: true,
|
|
600
|
-
userModel:
|
|
655
|
+
userModel: typedUserModel,
|
|
601
656
|
}).build();
|
|
602
657
|
|
|
603
658
|
await supertest(app).get("/error").expect(500);
|
|
604
659
|
});
|
|
605
660
|
|
|
606
661
|
it("handles loggingOptions passed to TerrenoApp", async () => {
|
|
607
|
-
const configureApp = (httpApp:
|
|
608
|
-
httpApp.get("/test", (_req
|
|
662
|
+
const configureApp = (httpApp: Router) => {
|
|
663
|
+
httpApp.get("/test", (_req, res) => {
|
|
609
664
|
res.json({ok: true});
|
|
610
665
|
});
|
|
611
666
|
};
|
|
@@ -617,7 +672,7 @@ describe("expressServer", () => {
|
|
|
617
672
|
logSlowRequestsReadMs: 100,
|
|
618
673
|
},
|
|
619
674
|
skipListen: true,
|
|
620
|
-
userModel:
|
|
675
|
+
userModel: typedUserModel,
|
|
621
676
|
}).build();
|
|
622
677
|
|
|
623
678
|
await supertest(app).get("/test").expect(200);
|
|
@@ -632,7 +687,7 @@ describe("expressServer", () => {
|
|
|
632
687
|
new TerrenoApp({
|
|
633
688
|
configureApp,
|
|
634
689
|
skipListen: true,
|
|
635
|
-
userModel:
|
|
690
|
+
userModel: typedUserModel,
|
|
636
691
|
}).build()
|
|
637
692
|
).toThrow("Route init boom");
|
|
638
693
|
});
|
|
@@ -849,8 +904,8 @@ describe("expressServer", () => {
|
|
|
849
904
|
skipListen: false,
|
|
850
905
|
userModel: typedUserModel,
|
|
851
906
|
}).start();
|
|
852
|
-
// start()
|
|
853
|
-
// exit-on-listen-error path settles asynchronously.
|
|
907
|
+
// start() binds listen first, then awaits ensureSyncIndexes(), so the
|
|
908
|
+
// exit-on-listen-error path still settles asynchronously if listen throws.
|
|
854
909
|
const deadline = Date.now() + 2_000;
|
|
855
910
|
while (exit.mock.calls.length === 0 && Date.now() < deadline) {
|
|
856
911
|
await new Promise((resolve) => setTimeout(resolve, 5));
|
|
@@ -865,9 +920,9 @@ describe("expressServer", () => {
|
|
|
865
920
|
|
|
866
921
|
describe("TerrenoApp with listen", () => {
|
|
867
922
|
const originalEnv = process.env;
|
|
868
|
-
const http = require("node:http");
|
|
869
|
-
let activeServer:
|
|
870
|
-
let originalListen:
|
|
923
|
+
const http = require("node:http") as typeof import("node:http");
|
|
924
|
+
let activeServer: import("node:http").Server | null = null;
|
|
925
|
+
let originalListen: typeof http.Server.prototype.listen | null = null;
|
|
871
926
|
|
|
872
927
|
beforeEach(() => {
|
|
873
928
|
process.env = {
|
|
@@ -881,17 +936,26 @@ describe("expressServer", () => {
|
|
|
881
936
|
};
|
|
882
937
|
|
|
883
938
|
originalListen = http.Server.prototype.listen;
|
|
884
|
-
http.Server.prototype.listen = function (
|
|
939
|
+
http.Server.prototype.listen = function (
|
|
940
|
+
this: import("node:http").Server,
|
|
941
|
+
...args: unknown[]
|
|
942
|
+
) {
|
|
885
943
|
activeServer = this;
|
|
886
|
-
return originalListen.apply(
|
|
887
|
-
|
|
944
|
+
return (originalListen as (...listenArgs: unknown[]) => import("node:http").Server).apply(
|
|
945
|
+
this,
|
|
946
|
+
args
|
|
947
|
+
);
|
|
948
|
+
} as typeof http.Server.prototype.listen;
|
|
888
949
|
});
|
|
889
950
|
|
|
890
951
|
afterEach(async () => {
|
|
891
952
|
process.env = originalEnv;
|
|
892
|
-
|
|
953
|
+
if (originalListen) {
|
|
954
|
+
http.Server.prototype.listen = originalListen;
|
|
955
|
+
}
|
|
893
956
|
if (activeServer) {
|
|
894
|
-
|
|
957
|
+
const server = activeServer;
|
|
958
|
+
await new Promise<void>((resolve) => server.close(() => resolve()));
|
|
895
959
|
activeServer = null;
|
|
896
960
|
}
|
|
897
961
|
});
|
|
@@ -902,12 +966,60 @@ describe("expressServer", () => {
|
|
|
902
966
|
const app = new TerrenoApp({
|
|
903
967
|
configureApp,
|
|
904
968
|
skipListen: false,
|
|
905
|
-
userModel:
|
|
969
|
+
userModel: typedUserModel,
|
|
906
970
|
}).start();
|
|
907
971
|
|
|
908
972
|
expect(app).toBeDefined();
|
|
909
973
|
await new Promise((resolve) => setTimeout(resolve, 100));
|
|
910
974
|
});
|
|
975
|
+
|
|
976
|
+
it("attaches the Express app to an already-listening httpServer", async () => {
|
|
977
|
+
const http = await import("node:http");
|
|
978
|
+
const holder = http.createServer((_req, res) => {
|
|
979
|
+
res.writeHead(503);
|
|
980
|
+
res.end("starting");
|
|
981
|
+
});
|
|
982
|
+
await new Promise<void>((resolve) => {
|
|
983
|
+
holder.listen(0, "127.0.0.1", () => {
|
|
984
|
+
resolve();
|
|
985
|
+
});
|
|
986
|
+
});
|
|
987
|
+
const address = holder.address();
|
|
988
|
+
const port = typeof address === "object" && address ? address.port : 0;
|
|
989
|
+
try {
|
|
990
|
+
new TerrenoApp({
|
|
991
|
+
configureApp: (app) => {
|
|
992
|
+
app.get("/ping", (_req, res) => {
|
|
993
|
+
res.json({ok: true});
|
|
994
|
+
});
|
|
995
|
+
},
|
|
996
|
+
httpServer: holder,
|
|
997
|
+
skipListen: false,
|
|
998
|
+
userModel: typedUserModel,
|
|
999
|
+
}).start();
|
|
1000
|
+
const deadline = Date.now() + 2_000;
|
|
1001
|
+
let status = 0;
|
|
1002
|
+
while (Date.now() < deadline) {
|
|
1003
|
+
const response = await fetch(`http://127.0.0.1:${port}/ping`);
|
|
1004
|
+
status = response.status;
|
|
1005
|
+
if (status === 200) {
|
|
1006
|
+
break;
|
|
1007
|
+
}
|
|
1008
|
+
await new Promise((resolve) => setTimeout(resolve, 20));
|
|
1009
|
+
}
|
|
1010
|
+
expect(status).toBe(200);
|
|
1011
|
+
} finally {
|
|
1012
|
+
await new Promise<void>((resolve, reject) => {
|
|
1013
|
+
holder.close((error) => {
|
|
1014
|
+
if (error) {
|
|
1015
|
+
reject(error);
|
|
1016
|
+
return;
|
|
1017
|
+
}
|
|
1018
|
+
resolve();
|
|
1019
|
+
});
|
|
1020
|
+
});
|
|
1021
|
+
}
|
|
1022
|
+
});
|
|
911
1023
|
});
|
|
912
1024
|
|
|
913
1025
|
describe("wrapScript timeout callbacks", () => {
|
|
@@ -999,7 +1111,7 @@ describe("expressServer", () => {
|
|
|
999
1111
|
new TerrenoApp({
|
|
1000
1112
|
configureApp,
|
|
1001
1113
|
skipListen: true,
|
|
1002
|
-
userModel:
|
|
1114
|
+
userModel: typedUserModel,
|
|
1003
1115
|
}).build()
|
|
1004
1116
|
).toThrow("route initialization failed");
|
|
1005
1117
|
});
|