@terreno/api 57.2.0 → 57.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
- package/README.md +23 -7
- package/dist/actions.js +19 -7
- package/dist/adminTypes.d.ts +7 -0
- package/dist/adminTypes.js +6 -1
- package/dist/api.d.ts +14 -0
- package/dist/api.js +111 -60
- package/dist/audit/auditApp.d.ts +30 -0
- package/dist/audit/auditApp.js +155 -0
- package/dist/audit/auditEventModel.d.ts +29 -0
- package/dist/audit/auditEventModel.js +102 -0
- package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
- package/dist/audit/cloudTasksEnqueue.js +162 -0
- package/dist/audit/diff.d.ts +10 -0
- package/dist/audit/diff.js +230 -0
- package/dist/audit/processQueue.d.ts +6 -0
- package/dist/audit/processQueue.js +101 -0
- package/dist/audit/rbacSink.d.ts +2 -0
- package/dist/audit/rbacSink.js +82 -0
- package/dist/audit/record.d.ts +56 -0
- package/dist/audit/record.js +373 -0
- package/dist/auth.d.ts +23 -10
- package/dist/auth.js +97 -32
- package/dist/authRecovery.d.ts +5 -0
- package/dist/authRecovery.js +350 -0
- package/dist/authTokens.d.ts +8 -0
- package/dist/authTokens.js +162 -0
- package/dist/betterAuth.d.ts +39 -0
- package/dist/betterAuthApp.d.ts +4 -0
- package/dist/betterAuthApp.js +26 -8
- package/dist/betterAuthSetup.d.ts +44 -2
- package/dist/betterAuthSetup.js +288 -18
- package/dist/collectionRegistry.d.ts +40 -0
- package/dist/collectionRegistry.js +97 -0
- package/dist/configurationApp.d.ts +11 -2
- package/dist/configurationApp.js +2 -4
- package/dist/docLoader.js +35 -6
- package/dist/expressServer.d.ts +26 -3
- package/dist/expressServer.js +79 -11
- package/dist/index.d.ts +42 -1
- package/dist/index.js +84 -2
- package/dist/mcp/auth.d.ts +1 -0
- package/dist/mcp/auth.js +47 -25
- package/dist/mcp/handlers.d.ts +1 -1
- package/dist/mcp/handlers.js +67 -233
- package/dist/mcp/query.d.ts +2 -15
- package/dist/mcp/query.js +8 -8
- package/dist/mcp/registry.d.ts +1 -5
- package/dist/mcp/registry.js +31 -20
- package/dist/mcp/schemaGenerator.d.ts +2 -7
- package/dist/mcp/schemaGenerator.js +41 -116
- package/dist/mcp/server.d.ts +1 -0
- package/dist/mcp/server.js +1 -0
- package/dist/mcp/serviceTokens.d.ts +16 -0
- package/dist/mcp/serviceTokens.js +345 -0
- package/dist/mcp/types.d.ts +2 -2
- package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
- package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
- package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
- package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
- package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
- package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
- package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
- package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
- package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
- package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
- package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
- package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
- package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
- package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
- package/dist/migrations/generate.d.ts +17 -0
- package/dist/migrations/generate.js +277 -0
- package/dist/migrations/load.d.ts +20 -0
- package/dist/migrations/load.js +236 -0
- package/dist/migrations/lock.d.ts +13 -0
- package/dist/migrations/lock.js +145 -0
- package/dist/migrations/runner.d.ts +42 -0
- package/dist/migrations/runner.js +503 -0
- package/dist/migrations/schemaCatalog.d.ts +44 -0
- package/dist/migrations/schemaCatalog.js +326 -0
- package/dist/migrations/types.d.ts +87 -0
- package/dist/migrations/types.js +7 -0
- package/dist/models/mcpServiceToken.d.ts +3 -0
- package/dist/models/mcpServiceToken.js +208 -0
- package/dist/models/notification.d.ts +2 -0
- package/dist/models/notification.js +62 -0
- package/dist/models/notificationPreference.d.ts +2 -0
- package/dist/models/notificationPreference.js +49 -0
- package/dist/notifications/notificationService.d.ts +40 -0
- package/dist/notifications/notificationService.js +323 -0
- package/dist/notifications/notificationsApp.d.ts +18 -0
- package/dist/notifications/notificationsApp.js +250 -0
- package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
- package/dist/notifications/notificationsBeforeSend.js +77 -0
- package/dist/openApi.d.ts +1 -7
- package/dist/openApi.js +7 -6
- package/dist/openApiBuilder.d.ts +19 -7
- package/dist/openApiBuilder.js +61 -8
- package/dist/openApiCompat.js +1 -1
- package/dist/openApiValidator.d.ts +13 -1
- package/dist/openApiValidator.js +200 -38
- package/dist/orgs/orgContext.d.ts +23 -0
- package/dist/orgs/orgContext.js +198 -0
- package/dist/orgs/orgPermissions.d.ts +4 -0
- package/dist/orgs/orgPermissions.js +77 -0
- package/dist/orgs/orgPlugin.d.ts +13 -0
- package/dist/orgs/orgPlugin.js +84 -0
- package/dist/orgs/organizationModel.d.ts +13 -0
- package/dist/orgs/organizationModel.js +301 -0
- package/dist/orgs/organizationSettings.d.ts +19 -0
- package/dist/orgs/organizationSettings.js +120 -0
- package/dist/orgs/orgsApp.d.ts +28 -0
- package/dist/orgs/orgsApp.js +678 -0
- package/dist/permissions.d.ts +7 -13
- package/dist/permissions.js +8 -31
- package/dist/plugins.d.ts +14 -1
- package/dist/plugins.js +17 -6
- package/dist/populate.d.ts +2 -2
- package/dist/populate.js +47 -42
- package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
- package/dist/rateLimit/applyTrustProxy.js +17 -0
- package/dist/rateLimit/createStore.d.ts +2 -0
- package/dist/rateLimit/createStore.js +28 -0
- package/dist/rateLimit/memoryStore.d.ts +2 -0
- package/dist/rateLimit/memoryStore.js +108 -0
- package/dist/rateLimit/middleware.d.ts +3 -0
- package/dist/rateLimit/middleware.js +109 -0
- package/dist/rateLimit/mongoStore.d.ts +4 -0
- package/dist/rateLimit/mongoStore.js +123 -0
- package/dist/rateLimit/policies.d.ts +10 -0
- package/dist/rateLimit/policies.js +149 -0
- package/dist/rateLimit/redisStore.d.ts +4 -0
- package/dist/rateLimit/redisStore.js +156 -0
- package/dist/rateLimit/types.d.ts +54 -0
- package/dist/rateLimit/types.js +9 -0
- package/dist/rbac/access.js +35 -14
- package/dist/rbac/assertAllowed.d.ts +9 -0
- package/dist/rbac/assertAllowed.js +182 -0
- package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
- package/dist/rbac/membershipOrgAdminSource.js +122 -0
- package/dist/rbac/modelRouterAccess.d.ts +4 -0
- package/dist/rbac/modelRouterAccess.js +11 -4
- package/dist/rbac/permissionUtils.js +3 -2
- package/dist/rbac/resolve.js +65 -35
- package/dist/rbac/roleModel.d.ts +2 -5
- package/dist/rbac/roleModel.js +18 -4
- package/dist/rbac/routes.js +15 -6
- package/dist/rbac/statements.d.ts +10 -1
- package/dist/rbac/statements.js +19 -2
- package/dist/rbac/types.d.ts +5 -0
- package/dist/realtime/changeStreamWatcher.d.ts +10 -4
- package/dist/realtime/changeStreamWatcher.js +110 -64
- package/dist/realtime/deprecation.d.ts +13 -0
- package/dist/realtime/deprecation.js +33 -0
- package/dist/realtime/realtimeApp.d.ts +2 -1
- package/dist/realtime/realtimeApp.js +11 -11
- package/dist/realtime/registry.d.ts +0 -31
- package/dist/realtime/registry.js +44 -31
- package/dist/realtime/socketAuth.d.ts +5 -5
- package/dist/realtime/socketAuth.js +11 -1
- package/dist/realtime/socketUser.d.ts +5 -1
- package/dist/realtime/types.d.ts +14 -4
- package/dist/schemaMetadata.d.ts +56 -0
- package/dist/schemaMetadata.js +524 -0
- package/dist/seedRunner.d.ts +88 -0
- package/dist/seedRunner.js +627 -0
- package/dist/sync/adminBroadcastScope.d.ts +40 -0
- package/dist/sync/adminBroadcastScope.js +194 -0
- package/dist/sync/adminWindowAccess.d.ts +13 -0
- package/dist/sync/adminWindowAccess.js +96 -0
- package/dist/sync/adminWindowMutation.d.ts +88 -0
- package/dist/sync/adminWindowMutation.js +247 -0
- package/dist/sync/executors.d.ts +19 -3
- package/dist/sync/executors.js +194 -165
- package/dist/sync/loadHarness.js +28 -19
- package/dist/sync/models.js +26 -24
- package/dist/sync/mutationHandler.d.ts +14 -2
- package/dist/sync/mutationHandler.js +201 -76
- package/dist/sync/registrationSideEffects.d.ts +35 -0
- package/dist/sync/registrationSideEffects.js +151 -0
- package/dist/sync/registry.d.ts +2 -52
- package/dist/sync/registry.js +42 -187
- package/dist/sync/routes.d.ts +13 -0
- package/dist/sync/routes.js +116 -58
- package/dist/sync/scripts/compactTombstones.js +0 -2
- package/dist/sync/socketHandlers.d.ts +8 -2
- package/dist/sync/socketHandlers.js +144 -50
- package/dist/sync/streams.d.ts +2 -0
- package/dist/sync/streams.js +7 -1
- package/dist/sync/syncApp.d.ts +4 -3
- package/dist/sync/syncApp.js +5 -4
- package/dist/sync/syncBatch.d.ts +5 -2
- package/dist/sync/syncBatch.js +7 -6
- package/dist/sync/syncSeqPlugin.d.ts +1 -1
- package/dist/sync/syncSeqPlugin.js +20 -16
- package/dist/sync/types.d.ts +18 -0
- package/dist/terrenoApp.d.ts +48 -5
- package/dist/terrenoApp.js +157 -72
- package/dist/tests/createTestData.d.ts +1 -3
- package/dist/tests/createTestData.js +3 -5
- package/dist/tests/models.d.ts +3 -0
- package/dist/tests/models.js +15 -2
- package/dist/tests/testHelper.d.ts +0 -5
- package/dist/tests/testHelper.js +2 -9
- package/dist/types/authToken.d.ts +33 -0
- package/dist/types/authToken.js +2 -0
- package/dist/types/mcpServiceToken.d.ts +41 -0
- package/dist/types/mcpServiceToken.js +2 -0
- package/dist/types/membership.d.ts +23 -0
- package/dist/types/membership.js +2 -0
- package/dist/types/notification.d.ts +28 -0
- package/dist/types/notification.js +2 -0
- package/dist/types/notificationPreference.d.ts +20 -0
- package/dist/types/notificationPreference.js +2 -0
- package/dist/types/organization.d.ts +36 -0
- package/dist/types/organization.js +2 -0
- package/dist/webhooks/headerValue.d.ts +2 -0
- package/dist/webhooks/headerValue.js +14 -0
- package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
- package/dist/webhooks/idempotency/memoryStore.js +65 -0
- package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
- package/dist/webhooks/idempotency/mongoStore.js +150 -0
- package/dist/webhooks/idempotency/webhookReceipt.d.ts +17 -0
- package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
- package/dist/webhooks/rawBody.d.ts +15 -0
- package/dist/webhooks/rawBody.js +23 -0
- package/dist/webhooks/timingSafeEqual.d.ts +4 -0
- package/dist/webhooks/timingSafeEqual.js +17 -0
- package/dist/webhooks/verifiers/hmac.d.ts +15 -0
- package/dist/webhooks/verifiers/hmac.js +49 -0
- package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
- package/dist/webhooks/verifiers/sendgrid.js +56 -0
- package/dist/webhooks/verifiers/stripe.d.ts +9 -0
- package/dist/webhooks/verifiers/stripe.js +99 -0
- package/dist/webhooks/verifiers/twilio.d.ts +9 -0
- package/dist/webhooks/verifiers/twilio.js +112 -0
- package/dist/webhooks/webhooksApp.d.ts +33 -0
- package/dist/webhooks/webhooksApp.js +195 -0
- package/package.json +32 -27
- package/src/__snapshots__/openApi.test.ts.snap +444 -36
- package/src/__snapshots__/openApiBuilder.test.ts.snap +24 -24
- package/src/__snapshots__/schemaMetadata.test.ts.snap +196 -0
- package/src/actions.ts +20 -13
- package/src/adminModelRouter.test.ts +133 -0
- package/src/adminTypes.ts +8 -0
- package/src/api.arrayOperations.test.ts +43 -31
- package/src/api.hooks.test.ts +38 -29
- package/src/api.query.test.ts +31 -31
- package/src/api.test.ts +133 -97
- package/src/api.ts +84 -27
- package/src/audit/auditApp.test.ts +243 -0
- package/src/audit/auditApp.ts +139 -0
- package/src/audit/auditEventModel.ts +156 -0
- package/src/audit/auditRouter.test.ts +456 -0
- package/src/audit/cloudTasksEnqueue.test.ts +124 -0
- package/src/audit/cloudTasksEnqueue.ts +104 -0
- package/src/audit/diff.ts +163 -0
- package/src/audit/processQueue.ts +69 -0
- package/src/audit/rbacSink.test.ts +86 -0
- package/src/audit/rbacSink.ts +42 -0
- package/src/audit/record.test.ts +402 -0
- package/src/audit/record.ts +328 -0
- package/src/auth.test.ts +108 -52
- package/src/auth.ts +98 -29
- package/src/authRecovery.test.ts +281 -0
- package/src/authRecovery.ts +279 -0
- package/src/authTokens.test.ts +94 -0
- package/src/authTokens.ts +118 -0
- package/src/authVerification.test.ts +293 -0
- package/src/betterAuth.ts +31 -0
- package/src/betterAuthApp.test.ts +1 -0
- package/src/betterAuthApp.ts +27 -9
- package/src/betterAuthSetup.test.ts +595 -38
- package/src/betterAuthSetup.ts +261 -5
- package/src/collectionRegistry.test.ts +164 -0
- package/src/collectionRegistry.ts +135 -0
- package/src/configurationApp.ts +13 -7
- package/src/docLoader.test.ts +45 -1
- package/src/docLoader.ts +37 -6
- package/src/express.d.ts +3 -0
- package/src/expressServer.test.ts +180 -68
- package/src/expressServer.ts +75 -19
- package/src/githubAuth.test.ts +60 -55
- package/src/index.ts +127 -0
- package/src/mcp/auth.test.ts +47 -0
- package/src/mcp/auth.ts +32 -11
- package/src/mcp/handlers.test.ts +275 -0
- package/src/mcp/handlers.ts +45 -172
- package/src/mcp/integration.test.ts +59 -9
- package/src/mcp/query.ts +5 -7
- package/src/mcp/registry.ts +29 -20
- package/src/mcp/schemaGenerator.test.ts +8 -0
- package/src/mcp/schemaGenerator.ts +49 -131
- package/src/mcp/server.ts +2 -0
- package/src/mcp/serviceTokens.test.ts +330 -0
- package/src/mcp/serviceTokens.ts +307 -0
- package/src/mcp/toolGenerator.test.ts +82 -1
- package/src/mcp/types.ts +2 -6
- package/src/migrations/cli.test.ts +376 -0
- package/src/migrations/cli.ts +283 -0
- package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
- package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
- package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
- package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
- package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
- package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
- package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
- package/src/migrations/generate.test.ts +333 -0
- package/src/migrations/generate.ts +216 -0
- package/src/migrations/load.test.ts +103 -0
- package/src/migrations/load.ts +124 -0
- package/src/migrations/lock.test.ts +133 -0
- package/src/migrations/lock.ts +118 -0
- package/src/migrations/runner.test.ts +504 -0
- package/src/migrations/runner.ts +358 -0
- package/src/migrations/schemaCatalog.test.ts +159 -0
- package/src/migrations/schemaCatalog.ts +262 -0
- package/src/migrations/types.ts +94 -0
- package/src/models/mcpServiceToken.test.ts +129 -0
- package/src/models/mcpServiceToken.ts +158 -0
- package/src/models/notification.ts +68 -0
- package/src/models/notificationPreference.ts +62 -0
- package/src/notifications/notificationService.ts +254 -0
- package/src/notifications/notificationsApp.test.ts +505 -0
- package/src/notifications/notificationsApp.ts +200 -0
- package/src/notifications/notificationsBeforeSend.ts +51 -0
- package/src/openApi.test.ts +80 -65
- package/src/openApi.ts +2 -1
- package/src/openApiBuilder.test.ts +95 -7
- package/src/openApiBuilder.ts +60 -12
- package/src/openApiCompat.ts +1 -1
- package/src/openApiValidator.test.ts +270 -56
- package/src/openApiValidator.ts +219 -36
- package/src/orgs/orgAccessOptIn.test.ts +87 -0
- package/src/orgs/orgContext.test.ts +259 -0
- package/src/orgs/orgContext.ts +151 -0
- package/src/orgs/orgPermissions.test.ts +105 -0
- package/src/orgs/orgPermissions.ts +40 -0
- package/src/orgs/orgPlugin.test.ts +130 -0
- package/src/orgs/orgPlugin.ts +70 -0
- package/src/orgs/orgRbac.test.ts +267 -0
- package/src/orgs/orgSecurityDefects.test.ts +415 -0
- package/src/orgs/organizationModel.test.ts +205 -0
- package/src/orgs/organizationModel.ts +257 -0
- package/src/orgs/organizationSettings.test.ts +113 -0
- package/src/orgs/organizationSettings.ts +126 -0
- package/src/orgs/orgsApp.test.ts +382 -0
- package/src/orgs/orgsApp.ts +563 -0
- package/src/permissions.test.ts +62 -36
- package/src/permissions.ts +8 -30
- package/src/plugins.test.ts +14 -0
- package/src/plugins.ts +34 -9
- package/src/populate.test.ts +34 -0
- package/src/populate.ts +40 -29
- package/src/rateLimit/applyTrustProxy.ts +17 -0
- package/src/rateLimit/createStore.ts +25 -0
- package/src/rateLimit/memoryStore.ts +40 -0
- package/src/rateLimit/middleware.ts +79 -0
- package/src/rateLimit/mongoStore.test.ts +80 -0
- package/src/rateLimit/mongoStore.ts +77 -0
- package/src/rateLimit/policies.ts +130 -0
- package/src/rateLimit/rateLimit.test.ts +328 -0
- package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
- package/src/rateLimit/redisStore.test.ts +114 -0
- package/src/rateLimit/redisStore.ts +86 -0
- package/src/rateLimit/types.ts +64 -0
- package/src/rbac/access.ts +16 -4
- package/src/rbac/assertAllowed.test.ts +325 -0
- package/src/rbac/assertAllowed.ts +157 -0
- package/src/rbac/backfillAdmins.test.ts +124 -0
- package/src/rbac/fieldViews.test.ts +89 -0
- package/src/rbac/membershipOrgAdminSource.ts +59 -0
- package/src/rbac/modelRouterAccess.test.ts +126 -0
- package/src/rbac/modelRouterAccess.ts +8 -2
- package/src/rbac/permissionUtils.test.ts +26 -5
- package/src/rbac/permissionUtils.ts +3 -2
- package/src/rbac/realtimeAccess.test.ts +109 -1
- package/src/rbac/resolve.test.ts +34 -2
- package/src/rbac/resolve.ts +31 -11
- package/src/rbac/roleManager.test.ts +169 -0
- package/src/rbac/roleModel.test.ts +34 -1
- package/src/rbac/roleModel.ts +17 -1
- package/src/rbac/routes.test.ts +233 -0
- package/src/rbac/routes.ts +16 -6
- package/src/rbac/statements.test.ts +19 -0
- package/src/rbac/statements.ts +19 -1
- package/src/rbac/types.ts +5 -0
- package/src/realtime/changeStreamWatcher.ts +73 -33
- package/src/realtime/deprecation.test.ts +60 -0
- package/src/realtime/deprecation.ts +33 -0
- package/src/realtime/realtime.test.ts +365 -189
- package/src/realtime/realtimeApp.ts +11 -11
- package/src/realtime/realtimeAppSetup.test.ts +32 -5
- package/src/realtime/registry.ts +48 -42
- package/src/realtime/sessionRevalidation.test.ts +57 -44
- package/src/realtime/socketAuth.test.ts +75 -23
- package/src/realtime/socketAuth.ts +17 -6
- package/src/realtime/socketUser.ts +5 -3
- package/src/realtime/types.ts +14 -4
- package/src/schemaMetadata.test.ts +419 -0
- package/src/schemaMetadata.ts +593 -0
- package/src/scrubAdminFields.test.ts +105 -0
- package/src/seedRunner.test.ts +591 -0
- package/src/seedRunner.ts +464 -0
- package/src/sync/adminBroadcastConfig.test.ts +96 -0
- package/src/sync/adminBroadcastScope.test.ts +155 -0
- package/src/sync/adminBroadcastScope.ts +123 -0
- package/src/sync/adminWindowAccess.test.ts +57 -0
- package/src/sync/adminWindowAccess.ts +32 -0
- package/src/sync/adminWindowMutation.test.ts +450 -0
- package/src/sync/adminWindowMutation.ts +283 -0
- package/src/sync/docMatchesMutationData.test.ts +16 -0
- package/src/sync/ensureSyncIndexes.test.ts +54 -15
- package/src/sync/executors.test.ts +40 -0
- package/src/sync/executors.ts +57 -18
- package/src/sync/integration.test.ts +15 -7
- package/src/sync/loadHarness.ts +28 -19
- package/src/sync/models.ts +32 -18
- package/src/sync/mutationHandler.test.ts +293 -17
- package/src/sync/mutationHandler.ts +180 -36
- package/src/sync/registrationSideEffects.test.ts +126 -0
- package/src/sync/registrationSideEffects.ts +131 -0
- package/src/sync/registry.ts +49 -171
- package/src/sync/routes.ts +55 -10
- package/src/sync/scripts/compactTombstones.ts +0 -2
- package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
- package/src/sync/socketHandlers.ts +154 -58
- package/src/sync/streams.ts +6 -0
- package/src/sync/sync.test.ts +28 -25
- package/src/sync/syncApp.ts +5 -4
- package/src/sync/syncBatch.ts +10 -4
- package/src/sync/syncFrontier.test.ts +17 -15
- package/src/sync/syncPhaseC.test.ts +54 -43
- package/src/sync/syncRoutes.test.ts +347 -38
- package/src/sync/syncSeqPlugin.ts +66 -44
- package/src/sync/syncSocket.test.ts +341 -81
- package/src/sync/types.ts +20 -0
- package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
- package/src/terrenoApp.migrations.test.ts +114 -0
- package/src/terrenoApp.test.ts +41 -0
- package/src/terrenoApp.ts +181 -46
- package/src/tests/createTestData.ts +2 -2
- package/src/tests/models.ts +24 -3
- package/src/tests/testHelper.ts +1 -7
- package/src/types/authToken.ts +41 -0
- package/src/types/mcpServiceToken.ts +48 -0
- package/src/types/membership.ts +48 -0
- package/src/types/notification.ts +34 -0
- package/src/types/notificationPreference.ts +28 -0
- package/src/types/organization.ts +49 -0
- package/src/webhooks/headerValue.test.ts +22 -0
- package/src/webhooks/headerValue.ts +12 -0
- package/src/webhooks/idempotency/memoryStore.ts +34 -0
- package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
- package/src/webhooks/idempotency/mongoStore.ts +83 -0
- package/src/webhooks/idempotency/webhookReceipt.ts +67 -0
- package/src/webhooks/rawBody.test.ts +107 -0
- package/src/webhooks/rawBody.ts +24 -0
- package/src/webhooks/timingSafeEqual.ts +16 -0
- package/src/webhooks/verifiers/hmac.test.ts +110 -0
- package/src/webhooks/verifiers/hmac.ts +54 -0
- package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
- package/src/webhooks/verifiers/sendgrid.ts +59 -0
- package/src/webhooks/verifiers/stripe.ts +67 -0
- package/src/webhooks/verifiers/twilio.ts +69 -0
- package/src/webhooks/webhooksApp.test.ts +221 -0
- package/src/webhooks/webhooksApp.ts +144 -0
- package/tsconfig.json +1 -1
- package/tsconfig.typedoc.json +2 -1
- package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
- package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
- package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import type mongoose from "mongoose";
|
|
2
|
+
import type { FindExactlyOnePlugin, FindOneOrNonePlugin } from "../plugins";
|
|
3
|
+
export interface McpServiceTokenIssueOptions {
|
|
4
|
+
expiresAt?: Date;
|
|
5
|
+
name: string;
|
|
6
|
+
}
|
|
7
|
+
interface McpServiceTokenMethods {
|
|
8
|
+
deleteOne: (this: McpServiceTokenDocument) => Promise<McpServiceTokenDocument>;
|
|
9
|
+
}
|
|
10
|
+
export interface McpServiceTokenStatics extends FindExactlyOnePlugin<McpServiceTokenDocument>, FindOneOrNonePlugin<McpServiceTokenDocument> {
|
|
11
|
+
countActiveForUser: (this: McpServiceTokenModel, userId: mongoose.Types.ObjectId) => Promise<number>;
|
|
12
|
+
issueFor: (this: McpServiceTokenModel, user: {
|
|
13
|
+
_id: {
|
|
14
|
+
toString(): string;
|
|
15
|
+
};
|
|
16
|
+
}, options: McpServiceTokenIssueOptions) => Promise<{
|
|
17
|
+
mcpServiceToken: McpServiceTokenDocument;
|
|
18
|
+
token: string;
|
|
19
|
+
}>;
|
|
20
|
+
revokeForUser: (this: McpServiceTokenModel, user: {
|
|
21
|
+
_id: {
|
|
22
|
+
toString(): string;
|
|
23
|
+
};
|
|
24
|
+
}, tokenId: mongoose.Types.ObjectId) => Promise<McpServiceTokenDocument | null>;
|
|
25
|
+
verify: (this: McpServiceTokenModel, token: string) => Promise<McpServiceTokenDocument | null>;
|
|
26
|
+
}
|
|
27
|
+
export interface McpServiceTokenModel extends mongoose.Model<McpServiceTokenDocument, object, McpServiceTokenMethods>, McpServiceTokenStatics {
|
|
28
|
+
}
|
|
29
|
+
export interface McpServiceTokenDocument extends mongoose.Document {
|
|
30
|
+
_id: mongoose.Types.ObjectId;
|
|
31
|
+
created: Date;
|
|
32
|
+
expiresAt?: Date;
|
|
33
|
+
lastUsedAt?: Date;
|
|
34
|
+
name: string;
|
|
35
|
+
revokedAt?: Date;
|
|
36
|
+
tokenHash: string;
|
|
37
|
+
tokenPrefix: string;
|
|
38
|
+
updated: Date;
|
|
39
|
+
userId: mongoose.Types.ObjectId;
|
|
40
|
+
}
|
|
41
|
+
export {};
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type mongoose from "mongoose";
|
|
2
|
+
import type { FindExactlyOnePlugin, FindOneOrNonePlugin } from "../plugins";
|
|
3
|
+
export type MembershipRoleName = "org-admin" | "member";
|
|
4
|
+
export type MembershipStatus = "active" | "suspended";
|
|
5
|
+
export type MembershipMethods = {};
|
|
6
|
+
export interface MembershipStatics extends FindExactlyOnePlugin<MembershipDocument>, FindOneOrNonePlugin<MembershipDocument> {
|
|
7
|
+
findActiveForUser: (this: MembershipModel, userId: mongoose.Types.ObjectId | string) => Promise<MembershipDocument[]>;
|
|
8
|
+
isMember: (this: MembershipModel, userId: mongoose.Types.ObjectId | string, organizationId: mongoose.Types.ObjectId | string) => Promise<boolean>;
|
|
9
|
+
isOrgAdmin: (this: MembershipModel, userId: mongoose.Types.ObjectId | string, organizationId: mongoose.Types.ObjectId | string) => Promise<boolean>;
|
|
10
|
+
}
|
|
11
|
+
export interface MembershipModel extends mongoose.Model<MembershipDocument, object, MembershipMethods>, MembershipStatics {
|
|
12
|
+
}
|
|
13
|
+
export type MembershipSchema = mongoose.Schema<MembershipDocument, MembershipModel, MembershipMethods>;
|
|
14
|
+
export interface MembershipDocument extends mongoose.Document {
|
|
15
|
+
_id: mongoose.Types.ObjectId;
|
|
16
|
+
created: Date;
|
|
17
|
+
deleted: boolean;
|
|
18
|
+
organizationId: mongoose.Types.ObjectId;
|
|
19
|
+
roleName: MembershipRoleName;
|
|
20
|
+
status: MembershipStatus;
|
|
21
|
+
updated: Date;
|
|
22
|
+
userId: mongoose.Types.ObjectId;
|
|
23
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type mongoose from "mongoose";
|
|
2
|
+
import type { FindExactlyOnePlugin, FindOneOrNonePlugin } from "../plugins";
|
|
3
|
+
type NotificationMethods = Record<never, never>;
|
|
4
|
+
interface NotificationStatics extends FindExactlyOnePlugin<NotificationDocument>, FindOneOrNonePlugin<NotificationDocument> {
|
|
5
|
+
}
|
|
6
|
+
export interface NotificationModel extends mongoose.Model<NotificationDocument, object, NotificationMethods>, NotificationStatics {
|
|
7
|
+
}
|
|
8
|
+
export interface NotificationDocument extends mongoose.Document<string>, NotificationMethods {
|
|
9
|
+
_id: string;
|
|
10
|
+
archivedAt: Date | null;
|
|
11
|
+
body: string;
|
|
12
|
+
href?: string;
|
|
13
|
+
kind?: string;
|
|
14
|
+
ownerId: mongoose.Types.ObjectId;
|
|
15
|
+
readAt: Date | null;
|
|
16
|
+
title: string;
|
|
17
|
+
created: Date;
|
|
18
|
+
updated: Date;
|
|
19
|
+
deleted: boolean;
|
|
20
|
+
}
|
|
21
|
+
export interface NotifyInput {
|
|
22
|
+
body: string;
|
|
23
|
+
href?: string;
|
|
24
|
+
kind?: string;
|
|
25
|
+
title: string;
|
|
26
|
+
userId: string;
|
|
27
|
+
}
|
|
28
|
+
export {};
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type mongoose from "mongoose";
|
|
2
|
+
import type { FindExactlyOnePlugin, FindOneOrNonePlugin } from "../plugins";
|
|
3
|
+
export type NotificationPreferenceChannel = "inapp" | "mail" | "push" | "sms";
|
|
4
|
+
type NotificationPreferenceMethods = Record<never, never>;
|
|
5
|
+
interface NotificationPreferenceStatics extends FindExactlyOnePlugin<NotificationPreferenceDocument>, FindOneOrNonePlugin<NotificationPreferenceDocument> {
|
|
6
|
+
}
|
|
7
|
+
export interface NotificationPreferenceModel extends mongoose.Model<NotificationPreferenceDocument, object, NotificationPreferenceMethods>, NotificationPreferenceStatics {
|
|
8
|
+
}
|
|
9
|
+
export interface NotificationPreferenceDocument extends mongoose.Document<string>, NotificationPreferenceMethods {
|
|
10
|
+
_id: string;
|
|
11
|
+
inapp: boolean;
|
|
12
|
+
mail: boolean;
|
|
13
|
+
ownerId: mongoose.Types.ObjectId;
|
|
14
|
+
push: boolean;
|
|
15
|
+
sms: boolean;
|
|
16
|
+
created: Date;
|
|
17
|
+
updated: Date;
|
|
18
|
+
deleted: boolean;
|
|
19
|
+
}
|
|
20
|
+
export {};
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import type mongoose from "mongoose";
|
|
2
|
+
import type { FindExactlyOnePlugin, FindOneOrNonePlugin } from "../plugins";
|
|
3
|
+
export type OrganizationMethods = {};
|
|
4
|
+
export interface OrganizationStatics extends FindExactlyOnePlugin<OrganizationDocument>, FindOneOrNonePlugin<OrganizationDocument> {
|
|
5
|
+
}
|
|
6
|
+
export interface OrganizationModel extends mongoose.Model<OrganizationDocument, object, OrganizationMethods>, OrganizationStatics {
|
|
7
|
+
}
|
|
8
|
+
export type OrganizationSchema = mongoose.Schema<OrganizationDocument, OrganizationModel, OrganizationMethods>;
|
|
9
|
+
/**
|
|
10
|
+
* App-defined `Organization.settings` shape.
|
|
11
|
+
*
|
|
12
|
+
* Augment in the consumer app:
|
|
13
|
+
*
|
|
14
|
+
* ```ts
|
|
15
|
+
* declare module "@terreno/api" {
|
|
16
|
+
* interface OrganizationSettings {
|
|
17
|
+
* timezone?: string;
|
|
18
|
+
* }
|
|
19
|
+
* }
|
|
20
|
+
* ```
|
|
21
|
+
*
|
|
22
|
+
* Or pass a generic to `organizationSettingsOf<MySettings>(organization)`.
|
|
23
|
+
*/
|
|
24
|
+
export interface OrganizationSettings {
|
|
25
|
+
}
|
|
26
|
+
export interface OrganizationDocument extends mongoose.Document {
|
|
27
|
+
_id: mongoose.Types.ObjectId;
|
|
28
|
+
created: Date;
|
|
29
|
+
deleted: boolean;
|
|
30
|
+
disabled: boolean;
|
|
31
|
+
name: string;
|
|
32
|
+
ownerId: mongoose.Types.ObjectId;
|
|
33
|
+
settings?: OrganizationSettings;
|
|
34
|
+
slug: string;
|
|
35
|
+
updated: Date;
|
|
36
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.headerValue = void 0;
|
|
4
|
+
var headerValue = function (req, header) {
|
|
5
|
+
var raw = req.headers[header.toLowerCase()];
|
|
6
|
+
if (Array.isArray(raw)) {
|
|
7
|
+
return raw[0];
|
|
8
|
+
}
|
|
9
|
+
if (typeof raw === "string") {
|
|
10
|
+
return raw;
|
|
11
|
+
}
|
|
12
|
+
return undefined;
|
|
13
|
+
};
|
|
14
|
+
exports.headerValue = headerValue;
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
export type WebhookClaimResult = "claimed" | "duplicate";
|
|
2
|
+
export interface WebhookClaimArgs {
|
|
3
|
+
eventId: string;
|
|
4
|
+
source: string;
|
|
5
|
+
}
|
|
6
|
+
export interface WebhookIdempotencyStore {
|
|
7
|
+
claim: (args: WebhookClaimArgs) => Promise<WebhookClaimResult>;
|
|
8
|
+
release: (args: WebhookClaimArgs) => Promise<void>;
|
|
9
|
+
}
|
|
10
|
+
export declare const createMemoryIdempotencyStore: () => WebhookIdempotencyStore;
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
|
|
3
|
+
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
|
|
4
|
+
return new (P || (P = Promise))(function (resolve, reject) {
|
|
5
|
+
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
|
|
6
|
+
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
|
|
7
|
+
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
|
|
8
|
+
step((generator = generator.apply(thisArg, _arguments || [])).next());
|
|
9
|
+
});
|
|
10
|
+
};
|
|
11
|
+
var __generator = (this && this.__generator) || function (thisArg, body) {
|
|
12
|
+
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
|
|
13
|
+
return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
|
|
14
|
+
function verb(n) { return function (v) { return step([n, v]); }; }
|
|
15
|
+
function step(op) {
|
|
16
|
+
if (f) throw new TypeError("Generator is already executing.");
|
|
17
|
+
while (g && (g = 0, op[0] && (_ = 0)), _) try {
|
|
18
|
+
if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
|
|
19
|
+
if (y = 0, t) op = [op[0] & 2, t.value];
|
|
20
|
+
switch (op[0]) {
|
|
21
|
+
case 0: case 1: t = op; break;
|
|
22
|
+
case 4: _.label++; return { value: op[1], done: false };
|
|
23
|
+
case 5: _.label++; y = op[1]; op = [0]; continue;
|
|
24
|
+
case 7: op = _.ops.pop(); _.trys.pop(); continue;
|
|
25
|
+
default:
|
|
26
|
+
if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
|
|
27
|
+
if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
|
|
28
|
+
if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
|
|
29
|
+
if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
|
|
30
|
+
if (t[2]) _.ops.pop();
|
|
31
|
+
_.trys.pop(); continue;
|
|
32
|
+
}
|
|
33
|
+
op = body.call(thisArg, _);
|
|
34
|
+
} catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
|
|
35
|
+
if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
|
|
36
|
+
}
|
|
37
|
+
};
|
|
38
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
39
|
+
exports.createMemoryIdempotencyStore = void 0;
|
|
40
|
+
var claimKey = function (_a) {
|
|
41
|
+
var source = _a.source, eventId = _a.eventId;
|
|
42
|
+
return "".concat(source, "\0").concat(eventId);
|
|
43
|
+
};
|
|
44
|
+
var createMemoryIdempotencyStore = function () {
|
|
45
|
+
var claimed = new Set();
|
|
46
|
+
var claim = function (args) { return __awaiter(void 0, void 0, void 0, function () {
|
|
47
|
+
var key;
|
|
48
|
+
return __generator(this, function (_a) {
|
|
49
|
+
key = claimKey(args);
|
|
50
|
+
if (claimed.has(key)) {
|
|
51
|
+
return [2 /*return*/, "duplicate"];
|
|
52
|
+
}
|
|
53
|
+
claimed.add(key);
|
|
54
|
+
return [2 /*return*/, "claimed"];
|
|
55
|
+
});
|
|
56
|
+
}); };
|
|
57
|
+
var release = function (args) { return __awaiter(void 0, void 0, void 0, function () {
|
|
58
|
+
return __generator(this, function (_a) {
|
|
59
|
+
claimed.delete(claimKey(args));
|
|
60
|
+
return [2 /*return*/];
|
|
61
|
+
});
|
|
62
|
+
}); };
|
|
63
|
+
return { claim: claim, release: release };
|
|
64
|
+
};
|
|
65
|
+
exports.createMemoryIdempotencyStore = createMemoryIdempotencyStore;
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
|
|
3
|
+
function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
|
|
4
|
+
return new (P || (P = Promise))(function (resolve, reject) {
|
|
5
|
+
function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
|
|
6
|
+
function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
|
|
7
|
+
function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
|
|
8
|
+
step((generator = generator.apply(thisArg, _arguments || [])).next());
|
|
9
|
+
});
|
|
10
|
+
};
|
|
11
|
+
var __generator = (this && this.__generator) || function (thisArg, body) {
|
|
12
|
+
var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
|
|
13
|
+
return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
|
|
14
|
+
function verb(n) { return function (v) { return step([n, v]); }; }
|
|
15
|
+
function step(op) {
|
|
16
|
+
if (f) throw new TypeError("Generator is already executing.");
|
|
17
|
+
while (g && (g = 0, op[0] && (_ = 0)), _) try {
|
|
18
|
+
if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
|
|
19
|
+
if (y = 0, t) op = [op[0] & 2, t.value];
|
|
20
|
+
switch (op[0]) {
|
|
21
|
+
case 0: case 1: t = op; break;
|
|
22
|
+
case 4: _.label++; return { value: op[1], done: false };
|
|
23
|
+
case 5: _.label++; y = op[1]; op = [0]; continue;
|
|
24
|
+
case 7: op = _.ops.pop(); _.trys.pop(); continue;
|
|
25
|
+
default:
|
|
26
|
+
if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
|
|
27
|
+
if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
|
|
28
|
+
if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
|
|
29
|
+
if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
|
|
30
|
+
if (t[2]) _.ops.pop();
|
|
31
|
+
_.trys.pop(); continue;
|
|
32
|
+
}
|
|
33
|
+
op = body.call(thisArg, _);
|
|
34
|
+
} catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
|
|
35
|
+
if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
|
|
36
|
+
}
|
|
37
|
+
};
|
|
38
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
39
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
40
|
+
};
|
|
41
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
42
|
+
exports.createMongoIdempotencyStore = void 0;
|
|
43
|
+
var mongoose_1 = __importDefault(require("mongoose"));
|
|
44
|
+
var errors_1 = require("../../errors");
|
|
45
|
+
var webhookReceipt_1 = require("./webhookReceipt");
|
|
46
|
+
var isDuplicateKeyError = function (error) {
|
|
47
|
+
if (!error || typeof error !== "object" || !("code" in error)) {
|
|
48
|
+
return false;
|
|
49
|
+
}
|
|
50
|
+
return error.code === 11000;
|
|
51
|
+
};
|
|
52
|
+
var createMongoIdempotencyStore = function (_a) {
|
|
53
|
+
var _b = _a === void 0 ? {} : _a, _c = _b.ttlDays, ttlDays = _c === void 0 ? webhookReceipt_1.DEFAULT_WEBHOOK_RECEIPT_TTL_DAYS : _c;
|
|
54
|
+
if (!Number.isFinite(ttlDays) || ttlDays <= 0) {
|
|
55
|
+
throw new errors_1.APIError({
|
|
56
|
+
status: 500,
|
|
57
|
+
title: "Mongo webhook idempotency ttlDays must be a positive number",
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
var expireAfterSeconds = Math.round(ttlDays * 86400);
|
|
61
|
+
var indexesReady;
|
|
62
|
+
var ensureIndexes = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
63
|
+
return __generator(this, function (_a) {
|
|
64
|
+
switch (_a.label) {
|
|
65
|
+
case 0:
|
|
66
|
+
if (!indexesReady) {
|
|
67
|
+
indexesReady = (0, webhookReceipt_1.getWebhookReceiptModel)()
|
|
68
|
+
.syncIndexes()
|
|
69
|
+
.then(function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
70
|
+
var db;
|
|
71
|
+
return __generator(this, function (_a) {
|
|
72
|
+
switch (_a.label) {
|
|
73
|
+
case 0:
|
|
74
|
+
db = mongoose_1.default.connection.db;
|
|
75
|
+
if (!db) {
|
|
76
|
+
return [2 /*return*/];
|
|
77
|
+
}
|
|
78
|
+
return [4 /*yield*/, db.command({
|
|
79
|
+
collMod: webhookReceipt_1.WEBHOOK_RECEIPTS_COLLECTION,
|
|
80
|
+
index: {
|
|
81
|
+
expireAfterSeconds: expireAfterSeconds,
|
|
82
|
+
keyPattern: { created: 1 },
|
|
83
|
+
},
|
|
84
|
+
})];
|
|
85
|
+
case 1:
|
|
86
|
+
_a.sent();
|
|
87
|
+
return [2 /*return*/];
|
|
88
|
+
}
|
|
89
|
+
});
|
|
90
|
+
}); })
|
|
91
|
+
.catch(function (error) {
|
|
92
|
+
indexesReady = undefined;
|
|
93
|
+
throw error;
|
|
94
|
+
});
|
|
95
|
+
}
|
|
96
|
+
return [4 /*yield*/, indexesReady];
|
|
97
|
+
case 1:
|
|
98
|
+
_a.sent();
|
|
99
|
+
return [2 /*return*/];
|
|
100
|
+
}
|
|
101
|
+
});
|
|
102
|
+
}); };
|
|
103
|
+
var claim = function (args) { return __awaiter(void 0, void 0, void 0, function () {
|
|
104
|
+
var WebhookReceipt, error_1;
|
|
105
|
+
return __generator(this, function (_a) {
|
|
106
|
+
switch (_a.label) {
|
|
107
|
+
case 0:
|
|
108
|
+
if (!mongoose_1.default.connection.db) {
|
|
109
|
+
throw new errors_1.APIError({
|
|
110
|
+
status: 500,
|
|
111
|
+
title: "Mongo webhook idempotency store requires an open mongoose connection",
|
|
112
|
+
});
|
|
113
|
+
}
|
|
114
|
+
return [4 /*yield*/, ensureIndexes()];
|
|
115
|
+
case 1:
|
|
116
|
+
_a.sent();
|
|
117
|
+
WebhookReceipt = (0, webhookReceipt_1.getWebhookReceiptModel)();
|
|
118
|
+
_a.label = 2;
|
|
119
|
+
case 2:
|
|
120
|
+
_a.trys.push([2, 4, , 5]);
|
|
121
|
+
return [4 /*yield*/, WebhookReceipt.create({ eventId: args.eventId, source: args.source })];
|
|
122
|
+
case 3:
|
|
123
|
+
_a.sent();
|
|
124
|
+
return [2 /*return*/, "claimed"];
|
|
125
|
+
case 4:
|
|
126
|
+
error_1 = _a.sent();
|
|
127
|
+
if (isDuplicateKeyError(error_1)) {
|
|
128
|
+
return [2 /*return*/, "duplicate"];
|
|
129
|
+
}
|
|
130
|
+
throw error_1;
|
|
131
|
+
case 5: return [2 /*return*/];
|
|
132
|
+
}
|
|
133
|
+
});
|
|
134
|
+
}); };
|
|
135
|
+
var release = function (args) { return __awaiter(void 0, void 0, void 0, function () {
|
|
136
|
+
var WebhookReceipt;
|
|
137
|
+
return __generator(this, function (_a) {
|
|
138
|
+
switch (_a.label) {
|
|
139
|
+
case 0:
|
|
140
|
+
WebhookReceipt = (0, webhookReceipt_1.getWebhookReceiptModel)();
|
|
141
|
+
return [4 /*yield*/, WebhookReceipt.deleteOne({ eventId: args.eventId, source: args.source })];
|
|
142
|
+
case 1:
|
|
143
|
+
_a.sent();
|
|
144
|
+
return [2 /*return*/];
|
|
145
|
+
}
|
|
146
|
+
});
|
|
147
|
+
}); };
|
|
148
|
+
return { claim: claim, release: release };
|
|
149
|
+
};
|
|
150
|
+
exports.createMongoIdempotencyStore = createMongoIdempotencyStore;
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import mongoose from "mongoose";
|
|
2
|
+
import type { FindExactlyOnePlugin, FindOneOrNonePlugin } from "../../plugins";
|
|
3
|
+
export declare const WEBHOOK_RECEIPTS_COLLECTION = "webhookReceipts";
|
|
4
|
+
export declare const DEFAULT_WEBHOOK_RECEIPT_TTL_DAYS = 7;
|
|
5
|
+
type WebhookReceiptMethods = Record<string, never>;
|
|
6
|
+
interface WebhookReceiptStatics extends FindExactlyOnePlugin<WebhookReceiptDocument>, FindOneOrNonePlugin<WebhookReceiptDocument> {
|
|
7
|
+
}
|
|
8
|
+
export interface WebhookReceiptModel extends mongoose.Model<WebhookReceiptDocument, object, WebhookReceiptMethods>, WebhookReceiptStatics {
|
|
9
|
+
}
|
|
10
|
+
interface WebhookReceiptDocument extends mongoose.Document {
|
|
11
|
+
_id: mongoose.Types.ObjectId;
|
|
12
|
+
created: Date;
|
|
13
|
+
eventId: string;
|
|
14
|
+
source: string;
|
|
15
|
+
}
|
|
16
|
+
export declare const getWebhookReceiptModel: () => WebhookReceiptModel;
|
|
17
|
+
export {};
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.getWebhookReceiptModel = exports.DEFAULT_WEBHOOK_RECEIPT_TTL_DAYS = exports.WEBHOOK_RECEIPTS_COLLECTION = void 0;
|
|
7
|
+
var luxon_1 = require("luxon");
|
|
8
|
+
var mongoose_1 = __importDefault(require("mongoose"));
|
|
9
|
+
var plugins_1 = require("../../plugins");
|
|
10
|
+
exports.WEBHOOK_RECEIPTS_COLLECTION = "webhookReceipts";
|
|
11
|
+
exports.DEFAULT_WEBHOOK_RECEIPT_TTL_DAYS = 7;
|
|
12
|
+
var secondsPerDay = 86400;
|
|
13
|
+
var webhookReceiptSchema = new mongoose_1.default.Schema({
|
|
14
|
+
created: {
|
|
15
|
+
default: function () { return luxon_1.DateTime.utc().toJSDate(); },
|
|
16
|
+
description: "When this webhook event id was first claimed",
|
|
17
|
+
required: true,
|
|
18
|
+
type: Date,
|
|
19
|
+
},
|
|
20
|
+
eventId: {
|
|
21
|
+
description: "Provider event id claimed for this source",
|
|
22
|
+
required: true,
|
|
23
|
+
type: String,
|
|
24
|
+
},
|
|
25
|
+
source: {
|
|
26
|
+
description: "Webhook source label (for example stripe or sendgrid)",
|
|
27
|
+
required: true,
|
|
28
|
+
type: String,
|
|
29
|
+
},
|
|
30
|
+
}, { collection: exports.WEBHOOK_RECEIPTS_COLLECTION, strict: "throw" });
|
|
31
|
+
webhookReceiptSchema.index({ eventId: 1, source: 1 }, { unique: true });
|
|
32
|
+
webhookReceiptSchema.index({ created: 1 }, { expireAfterSeconds: exports.DEFAULT_WEBHOOK_RECEIPT_TTL_DAYS * secondsPerDay });
|
|
33
|
+
webhookReceiptSchema.plugin(plugins_1.findOneOrNone);
|
|
34
|
+
webhookReceiptSchema.plugin(plugins_1.findExactlyOne);
|
|
35
|
+
var getWebhookReceiptModel = function () {
|
|
36
|
+
var _a;
|
|
37
|
+
return ((_a = mongoose_1.default.models.WebhookReceipt) !== null && _a !== void 0 ? _a : mongoose_1.default.model("WebhookReceipt", webhookReceiptSchema));
|
|
38
|
+
};
|
|
39
|
+
exports.getWebhookReceiptModel = getWebhookReceiptModel;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { IncomingMessage, OutgoingMessage } from "node:http";
|
|
2
|
+
/**
|
|
3
|
+
* Copies the parsed request buffer onto `req.rawBody`.
|
|
4
|
+
* Express may reuse `buf`; webhook signatures need the original bytes.
|
|
5
|
+
*/
|
|
6
|
+
/** @internal */
|
|
7
|
+
export declare const captureRawBody: (req: IncomingMessage, _res: OutgoingMessage, buf: Buffer) => void;
|
|
8
|
+
export declare const jsonBodyParserOptions: {
|
|
9
|
+
limit: "50mb";
|
|
10
|
+
verify: (req: IncomingMessage, _res: OutgoingMessage, buf: Buffer) => void;
|
|
11
|
+
};
|
|
12
|
+
export declare const urlencodedBodyParserOptions: {
|
|
13
|
+
extended: false;
|
|
14
|
+
verify: (req: IncomingMessage, _res: OutgoingMessage, buf: Buffer) => void;
|
|
15
|
+
};
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.urlencodedBodyParserOptions = exports.jsonBodyParserOptions = exports.captureRawBody = void 0;
|
|
4
|
+
/**
|
|
5
|
+
* Copies the parsed request buffer onto `req.rawBody`.
|
|
6
|
+
* Express may reuse `buf`; webhook signatures need the original bytes.
|
|
7
|
+
*/
|
|
8
|
+
/** @internal */
|
|
9
|
+
var captureRawBody = function (req, _res, buf) {
|
|
10
|
+
if (!Buffer.isBuffer(buf)) {
|
|
11
|
+
return;
|
|
12
|
+
}
|
|
13
|
+
req.rawBody = Buffer.from(buf);
|
|
14
|
+
};
|
|
15
|
+
exports.captureRawBody = captureRawBody;
|
|
16
|
+
exports.jsonBodyParserOptions = {
|
|
17
|
+
limit: "50mb",
|
|
18
|
+
verify: exports.captureRawBody,
|
|
19
|
+
};
|
|
20
|
+
exports.urlencodedBodyParserOptions = {
|
|
21
|
+
extended: false,
|
|
22
|
+
verify: exports.captureRawBody,
|
|
23
|
+
};
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.timingSafeEqualUtf8 = void 0;
|
|
7
|
+
var node_crypto_1 = __importDefault(require("node:crypto"));
|
|
8
|
+
var timingSafeEqualUtf8 = function (_a) {
|
|
9
|
+
var expected = _a.expected, provided = _a.provided;
|
|
10
|
+
var expectedBuf = Buffer.from(expected, "utf8");
|
|
11
|
+
var providedBuf = Buffer.from(provided, "utf8");
|
|
12
|
+
if (expectedBuf.length !== providedBuf.length) {
|
|
13
|
+
return false;
|
|
14
|
+
}
|
|
15
|
+
return node_crypto_1.default.timingSafeEqual(expectedBuf, providedBuf);
|
|
16
|
+
};
|
|
17
|
+
exports.timingSafeEqualUtf8 = timingSafeEqualUtf8;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { Request } from "express";
|
|
2
|
+
export interface HmacSignatureOptions {
|
|
3
|
+
algorithm?: "sha256" | "sha1" | "sha512";
|
|
4
|
+
encoding?: "hex" | "base64";
|
|
5
|
+
header: string;
|
|
6
|
+
secret: string;
|
|
7
|
+
timestampHeader?: string;
|
|
8
|
+
toleranceSec?: number;
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* Verifies `header` against HMAC of `req.rawBody`.
|
|
12
|
+
* When `timestampHeader` is set, the MAC is HMAC(`${timestamp}.${rawBody}`) and
|
|
13
|
+
* timestamps outside `toleranceSec` (default 300) are rejected.
|
|
14
|
+
*/
|
|
15
|
+
export declare const hmacSignature: (options: HmacSignatureOptions) => ((req: Request) => boolean);
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
3
|
+
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
4
|
+
};
|
|
5
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
6
|
+
exports.hmacSignature = void 0;
|
|
7
|
+
var node_crypto_1 = __importDefault(require("node:crypto"));
|
|
8
|
+
var luxon_1 = require("luxon");
|
|
9
|
+
var headerValue_1 = require("../headerValue");
|
|
10
|
+
var timingSafeEqual_1 = require("../timingSafeEqual");
|
|
11
|
+
/**
|
|
12
|
+
* Verifies `header` against HMAC of `req.rawBody`.
|
|
13
|
+
* When `timestampHeader` is set, the MAC is HMAC(`${timestamp}.${rawBody}`) and
|
|
14
|
+
* timestamps outside `toleranceSec` (default 300) are rejected.
|
|
15
|
+
*/
|
|
16
|
+
var hmacSignature = function (options) {
|
|
17
|
+
var _a, _b, _c;
|
|
18
|
+
var algorithm = (_a = options.algorithm) !== null && _a !== void 0 ? _a : "sha256";
|
|
19
|
+
var encoding = (_b = options.encoding) !== null && _b !== void 0 ? _b : "hex";
|
|
20
|
+
var toleranceSec = (_c = options.toleranceSec) !== null && _c !== void 0 ? _c : 300;
|
|
21
|
+
return function (req) {
|
|
22
|
+
var provided = (0, headerValue_1.headerValue)(req, options.header);
|
|
23
|
+
if (!provided) {
|
|
24
|
+
return false;
|
|
25
|
+
}
|
|
26
|
+
if (!req.rawBody) {
|
|
27
|
+
return false;
|
|
28
|
+
}
|
|
29
|
+
var mac = node_crypto_1.default.createHmac(algorithm, options.secret);
|
|
30
|
+
if (options.timestampHeader) {
|
|
31
|
+
var timestampRaw = (0, headerValue_1.headerValue)(req, options.timestampHeader);
|
|
32
|
+
if (!timestampRaw) {
|
|
33
|
+
return false;
|
|
34
|
+
}
|
|
35
|
+
var timestamp = Number(timestampRaw);
|
|
36
|
+
if (!Number.isFinite(timestamp)) {
|
|
37
|
+
return false;
|
|
38
|
+
}
|
|
39
|
+
var nowSec = luxon_1.DateTime.utc().toUnixInteger();
|
|
40
|
+
if (Math.abs(nowSec - timestamp) > toleranceSec) {
|
|
41
|
+
return false;
|
|
42
|
+
}
|
|
43
|
+
mac.update("".concat(timestampRaw, "."));
|
|
44
|
+
}
|
|
45
|
+
var expected = mac.update(req.rawBody).digest(encoding);
|
|
46
|
+
return (0, timingSafeEqual_1.timingSafeEqualUtf8)({ expected: expected, provided: provided });
|
|
47
|
+
};
|
|
48
|
+
};
|
|
49
|
+
exports.hmacSignature = hmacSignature;
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { Request } from "express";
|
|
2
|
+
export interface SendgridEventSignatureOptions {
|
|
3
|
+
publicKey: string;
|
|
4
|
+
toleranceSec?: number;
|
|
5
|
+
}
|
|
6
|
+
/**
|
|
7
|
+
* Verifies SendGrid Event Webhook ECDSA P-256 over `${timestamp}${rawBody}`.
|
|
8
|
+
* Timestamps outside `toleranceSec` (default 300) are rejected.
|
|
9
|
+
*/
|
|
10
|
+
export declare const sendgridEventSignature: (options: SendgridEventSignatureOptions) => ((req: Request) => boolean);
|