@terreno/api 57.2.0 → 57.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
- package/README.md +23 -7
- package/dist/actions.js +19 -7
- package/dist/adminTypes.d.ts +7 -0
- package/dist/adminTypes.js +6 -1
- package/dist/api.d.ts +14 -0
- package/dist/api.js +111 -60
- package/dist/audit/auditApp.d.ts +30 -0
- package/dist/audit/auditApp.js +155 -0
- package/dist/audit/auditEventModel.d.ts +29 -0
- package/dist/audit/auditEventModel.js +102 -0
- package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
- package/dist/audit/cloudTasksEnqueue.js +162 -0
- package/dist/audit/diff.d.ts +10 -0
- package/dist/audit/diff.js +230 -0
- package/dist/audit/processQueue.d.ts +6 -0
- package/dist/audit/processQueue.js +101 -0
- package/dist/audit/rbacSink.d.ts +2 -0
- package/dist/audit/rbacSink.js +82 -0
- package/dist/audit/record.d.ts +56 -0
- package/dist/audit/record.js +373 -0
- package/dist/auth.d.ts +23 -10
- package/dist/auth.js +97 -32
- package/dist/authRecovery.d.ts +5 -0
- package/dist/authRecovery.js +350 -0
- package/dist/authTokens.d.ts +8 -0
- package/dist/authTokens.js +162 -0
- package/dist/betterAuth.d.ts +39 -0
- package/dist/betterAuthApp.d.ts +4 -0
- package/dist/betterAuthApp.js +26 -8
- package/dist/betterAuthSetup.d.ts +44 -2
- package/dist/betterAuthSetup.js +288 -18
- package/dist/collectionRegistry.d.ts +40 -0
- package/dist/collectionRegistry.js +97 -0
- package/dist/configurationApp.d.ts +11 -2
- package/dist/configurationApp.js +2 -4
- package/dist/docLoader.js +35 -6
- package/dist/expressServer.d.ts +26 -3
- package/dist/expressServer.js +79 -11
- package/dist/index.d.ts +42 -1
- package/dist/index.js +84 -2
- package/dist/mcp/auth.d.ts +1 -0
- package/dist/mcp/auth.js +47 -25
- package/dist/mcp/handlers.d.ts +1 -1
- package/dist/mcp/handlers.js +67 -233
- package/dist/mcp/query.d.ts +2 -15
- package/dist/mcp/query.js +8 -8
- package/dist/mcp/registry.d.ts +1 -5
- package/dist/mcp/registry.js +31 -20
- package/dist/mcp/schemaGenerator.d.ts +2 -7
- package/dist/mcp/schemaGenerator.js +41 -116
- package/dist/mcp/server.d.ts +1 -0
- package/dist/mcp/server.js +1 -0
- package/dist/mcp/serviceTokens.d.ts +16 -0
- package/dist/mcp/serviceTokens.js +345 -0
- package/dist/mcp/types.d.ts +2 -2
- package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
- package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
- package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
- package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
- package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
- package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
- package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
- package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
- package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
- package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
- package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
- package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
- package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
- package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
- package/dist/migrations/generate.d.ts +17 -0
- package/dist/migrations/generate.js +277 -0
- package/dist/migrations/load.d.ts +20 -0
- package/dist/migrations/load.js +236 -0
- package/dist/migrations/lock.d.ts +13 -0
- package/dist/migrations/lock.js +145 -0
- package/dist/migrations/runner.d.ts +42 -0
- package/dist/migrations/runner.js +503 -0
- package/dist/migrations/schemaCatalog.d.ts +44 -0
- package/dist/migrations/schemaCatalog.js +326 -0
- package/dist/migrations/types.d.ts +87 -0
- package/dist/migrations/types.js +7 -0
- package/dist/models/mcpServiceToken.d.ts +3 -0
- package/dist/models/mcpServiceToken.js +208 -0
- package/dist/models/notification.d.ts +2 -0
- package/dist/models/notification.js +62 -0
- package/dist/models/notificationPreference.d.ts +2 -0
- package/dist/models/notificationPreference.js +49 -0
- package/dist/notifications/notificationService.d.ts +40 -0
- package/dist/notifications/notificationService.js +323 -0
- package/dist/notifications/notificationsApp.d.ts +18 -0
- package/dist/notifications/notificationsApp.js +250 -0
- package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
- package/dist/notifications/notificationsBeforeSend.js +77 -0
- package/dist/openApi.d.ts +1 -7
- package/dist/openApi.js +7 -6
- package/dist/openApiBuilder.d.ts +19 -7
- package/dist/openApiBuilder.js +61 -8
- package/dist/openApiCompat.js +1 -1
- package/dist/openApiValidator.d.ts +13 -1
- package/dist/openApiValidator.js +200 -38
- package/dist/orgs/orgContext.d.ts +23 -0
- package/dist/orgs/orgContext.js +198 -0
- package/dist/orgs/orgPermissions.d.ts +4 -0
- package/dist/orgs/orgPermissions.js +77 -0
- package/dist/orgs/orgPlugin.d.ts +13 -0
- package/dist/orgs/orgPlugin.js +84 -0
- package/dist/orgs/organizationModel.d.ts +13 -0
- package/dist/orgs/organizationModel.js +301 -0
- package/dist/orgs/organizationSettings.d.ts +19 -0
- package/dist/orgs/organizationSettings.js +120 -0
- package/dist/orgs/orgsApp.d.ts +28 -0
- package/dist/orgs/orgsApp.js +678 -0
- package/dist/permissions.d.ts +7 -13
- package/dist/permissions.js +8 -31
- package/dist/plugins.d.ts +14 -1
- package/dist/plugins.js +17 -6
- package/dist/populate.d.ts +2 -2
- package/dist/populate.js +47 -42
- package/dist/rateLimit/applyTrustProxy.d.ts +3 -0
- package/dist/rateLimit/applyTrustProxy.js +17 -0
- package/dist/rateLimit/createStore.d.ts +2 -0
- package/dist/rateLimit/createStore.js +28 -0
- package/dist/rateLimit/memoryStore.d.ts +2 -0
- package/dist/rateLimit/memoryStore.js +108 -0
- package/dist/rateLimit/middleware.d.ts +3 -0
- package/dist/rateLimit/middleware.js +109 -0
- package/dist/rateLimit/mongoStore.d.ts +4 -0
- package/dist/rateLimit/mongoStore.js +123 -0
- package/dist/rateLimit/policies.d.ts +10 -0
- package/dist/rateLimit/policies.js +149 -0
- package/dist/rateLimit/redisStore.d.ts +4 -0
- package/dist/rateLimit/redisStore.js +156 -0
- package/dist/rateLimit/types.d.ts +54 -0
- package/dist/rateLimit/types.js +9 -0
- package/dist/rbac/access.js +35 -14
- package/dist/rbac/assertAllowed.d.ts +9 -0
- package/dist/rbac/assertAllowed.js +182 -0
- package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
- package/dist/rbac/membershipOrgAdminSource.js +122 -0
- package/dist/rbac/modelRouterAccess.d.ts +4 -0
- package/dist/rbac/modelRouterAccess.js +11 -4
- package/dist/rbac/permissionUtils.js +3 -2
- package/dist/rbac/resolve.js +65 -35
- package/dist/rbac/roleModel.d.ts +2 -5
- package/dist/rbac/roleModel.js +18 -4
- package/dist/rbac/routes.js +15 -6
- package/dist/rbac/statements.d.ts +10 -1
- package/dist/rbac/statements.js +19 -2
- package/dist/rbac/types.d.ts +5 -0
- package/dist/realtime/changeStreamWatcher.d.ts +10 -4
- package/dist/realtime/changeStreamWatcher.js +110 -64
- package/dist/realtime/deprecation.d.ts +13 -0
- package/dist/realtime/deprecation.js +33 -0
- package/dist/realtime/realtimeApp.d.ts +2 -1
- package/dist/realtime/realtimeApp.js +11 -11
- package/dist/realtime/registry.d.ts +0 -31
- package/dist/realtime/registry.js +44 -31
- package/dist/realtime/socketAuth.d.ts +5 -5
- package/dist/realtime/socketAuth.js +11 -1
- package/dist/realtime/socketUser.d.ts +5 -1
- package/dist/realtime/types.d.ts +14 -4
- package/dist/schemaMetadata.d.ts +56 -0
- package/dist/schemaMetadata.js +524 -0
- package/dist/seedRunner.d.ts +88 -0
- package/dist/seedRunner.js +627 -0
- package/dist/sync/adminBroadcastScope.d.ts +40 -0
- package/dist/sync/adminBroadcastScope.js +194 -0
- package/dist/sync/adminWindowAccess.d.ts +13 -0
- package/dist/sync/adminWindowAccess.js +96 -0
- package/dist/sync/adminWindowMutation.d.ts +88 -0
- package/dist/sync/adminWindowMutation.js +247 -0
- package/dist/sync/executors.d.ts +19 -3
- package/dist/sync/executors.js +194 -165
- package/dist/sync/loadHarness.js +28 -19
- package/dist/sync/models.js +26 -24
- package/dist/sync/mutationHandler.d.ts +14 -2
- package/dist/sync/mutationHandler.js +201 -76
- package/dist/sync/registrationSideEffects.d.ts +35 -0
- package/dist/sync/registrationSideEffects.js +151 -0
- package/dist/sync/registry.d.ts +2 -52
- package/dist/sync/registry.js +42 -187
- package/dist/sync/routes.d.ts +13 -0
- package/dist/sync/routes.js +116 -58
- package/dist/sync/scripts/compactTombstones.js +0 -2
- package/dist/sync/socketHandlers.d.ts +8 -2
- package/dist/sync/socketHandlers.js +144 -50
- package/dist/sync/streams.d.ts +2 -0
- package/dist/sync/streams.js +7 -1
- package/dist/sync/syncApp.d.ts +4 -3
- package/dist/sync/syncApp.js +5 -4
- package/dist/sync/syncBatch.d.ts +5 -2
- package/dist/sync/syncBatch.js +7 -6
- package/dist/sync/syncSeqPlugin.d.ts +1 -1
- package/dist/sync/syncSeqPlugin.js +20 -16
- package/dist/sync/types.d.ts +18 -0
- package/dist/terrenoApp.d.ts +48 -5
- package/dist/terrenoApp.js +157 -72
- package/dist/tests/createTestData.d.ts +1 -3
- package/dist/tests/createTestData.js +3 -5
- package/dist/tests/models.d.ts +3 -0
- package/dist/tests/models.js +15 -2
- package/dist/tests/testHelper.d.ts +0 -5
- package/dist/tests/testHelper.js +2 -9
- package/dist/types/authToken.d.ts +33 -0
- package/dist/types/authToken.js +2 -0
- package/dist/types/mcpServiceToken.d.ts +41 -0
- package/dist/types/mcpServiceToken.js +2 -0
- package/dist/types/membership.d.ts +23 -0
- package/dist/types/membership.js +2 -0
- package/dist/types/notification.d.ts +28 -0
- package/dist/types/notification.js +2 -0
- package/dist/types/notificationPreference.d.ts +20 -0
- package/dist/types/notificationPreference.js +2 -0
- package/dist/types/organization.d.ts +36 -0
- package/dist/types/organization.js +2 -0
- package/dist/webhooks/headerValue.d.ts +2 -0
- package/dist/webhooks/headerValue.js +14 -0
- package/dist/webhooks/idempotency/memoryStore.d.ts +10 -0
- package/dist/webhooks/idempotency/memoryStore.js +65 -0
- package/dist/webhooks/idempotency/mongoStore.d.ts +4 -0
- package/dist/webhooks/idempotency/mongoStore.js +150 -0
- package/dist/webhooks/idempotency/webhookReceipt.d.ts +17 -0
- package/dist/webhooks/idempotency/webhookReceipt.js +39 -0
- package/dist/webhooks/rawBody.d.ts +15 -0
- package/dist/webhooks/rawBody.js +23 -0
- package/dist/webhooks/timingSafeEqual.d.ts +4 -0
- package/dist/webhooks/timingSafeEqual.js +17 -0
- package/dist/webhooks/verifiers/hmac.d.ts +15 -0
- package/dist/webhooks/verifiers/hmac.js +49 -0
- package/dist/webhooks/verifiers/sendgrid.d.ts +10 -0
- package/dist/webhooks/verifiers/sendgrid.js +56 -0
- package/dist/webhooks/verifiers/stripe.d.ts +9 -0
- package/dist/webhooks/verifiers/stripe.js +99 -0
- package/dist/webhooks/verifiers/twilio.d.ts +9 -0
- package/dist/webhooks/verifiers/twilio.js +112 -0
- package/dist/webhooks/webhooksApp.d.ts +33 -0
- package/dist/webhooks/webhooksApp.js +195 -0
- package/package.json +32 -27
- package/src/__snapshots__/openApi.test.ts.snap +444 -36
- package/src/__snapshots__/openApiBuilder.test.ts.snap +24 -24
- package/src/__snapshots__/schemaMetadata.test.ts.snap +196 -0
- package/src/actions.ts +20 -13
- package/src/adminModelRouter.test.ts +133 -0
- package/src/adminTypes.ts +8 -0
- package/src/api.arrayOperations.test.ts +43 -31
- package/src/api.hooks.test.ts +38 -29
- package/src/api.query.test.ts +31 -31
- package/src/api.test.ts +133 -97
- package/src/api.ts +84 -27
- package/src/audit/auditApp.test.ts +243 -0
- package/src/audit/auditApp.ts +139 -0
- package/src/audit/auditEventModel.ts +156 -0
- package/src/audit/auditRouter.test.ts +456 -0
- package/src/audit/cloudTasksEnqueue.test.ts +124 -0
- package/src/audit/cloudTasksEnqueue.ts +104 -0
- package/src/audit/diff.ts +163 -0
- package/src/audit/processQueue.ts +69 -0
- package/src/audit/rbacSink.test.ts +86 -0
- package/src/audit/rbacSink.ts +42 -0
- package/src/audit/record.test.ts +402 -0
- package/src/audit/record.ts +328 -0
- package/src/auth.test.ts +108 -52
- package/src/auth.ts +98 -29
- package/src/authRecovery.test.ts +281 -0
- package/src/authRecovery.ts +279 -0
- package/src/authTokens.test.ts +94 -0
- package/src/authTokens.ts +118 -0
- package/src/authVerification.test.ts +293 -0
- package/src/betterAuth.ts +31 -0
- package/src/betterAuthApp.test.ts +1 -0
- package/src/betterAuthApp.ts +27 -9
- package/src/betterAuthSetup.test.ts +595 -38
- package/src/betterAuthSetup.ts +261 -5
- package/src/collectionRegistry.test.ts +164 -0
- package/src/collectionRegistry.ts +135 -0
- package/src/configurationApp.ts +13 -7
- package/src/docLoader.test.ts +45 -1
- package/src/docLoader.ts +37 -6
- package/src/express.d.ts +3 -0
- package/src/expressServer.test.ts +180 -68
- package/src/expressServer.ts +75 -19
- package/src/githubAuth.test.ts +60 -55
- package/src/index.ts +127 -0
- package/src/mcp/auth.test.ts +47 -0
- package/src/mcp/auth.ts +32 -11
- package/src/mcp/handlers.test.ts +275 -0
- package/src/mcp/handlers.ts +45 -172
- package/src/mcp/integration.test.ts +59 -9
- package/src/mcp/query.ts +5 -7
- package/src/mcp/registry.ts +29 -20
- package/src/mcp/schemaGenerator.test.ts +8 -0
- package/src/mcp/schemaGenerator.ts +49 -131
- package/src/mcp/server.ts +2 -0
- package/src/mcp/serviceTokens.test.ts +330 -0
- package/src/mcp/serviceTokens.ts +307 -0
- package/src/mcp/toolGenerator.test.ts +82 -1
- package/src/mcp/types.ts +2 -6
- package/src/migrations/cli.test.ts +376 -0
- package/src/migrations/cli.ts +283 -0
- package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
- package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
- package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
- package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
- package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
- package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
- package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
- package/src/migrations/generate.test.ts +333 -0
- package/src/migrations/generate.ts +216 -0
- package/src/migrations/load.test.ts +103 -0
- package/src/migrations/load.ts +124 -0
- package/src/migrations/lock.test.ts +133 -0
- package/src/migrations/lock.ts +118 -0
- package/src/migrations/runner.test.ts +504 -0
- package/src/migrations/runner.ts +358 -0
- package/src/migrations/schemaCatalog.test.ts +159 -0
- package/src/migrations/schemaCatalog.ts +262 -0
- package/src/migrations/types.ts +94 -0
- package/src/models/mcpServiceToken.test.ts +129 -0
- package/src/models/mcpServiceToken.ts +158 -0
- package/src/models/notification.ts +68 -0
- package/src/models/notificationPreference.ts +62 -0
- package/src/notifications/notificationService.ts +254 -0
- package/src/notifications/notificationsApp.test.ts +505 -0
- package/src/notifications/notificationsApp.ts +200 -0
- package/src/notifications/notificationsBeforeSend.ts +51 -0
- package/src/openApi.test.ts +80 -65
- package/src/openApi.ts +2 -1
- package/src/openApiBuilder.test.ts +95 -7
- package/src/openApiBuilder.ts +60 -12
- package/src/openApiCompat.ts +1 -1
- package/src/openApiValidator.test.ts +270 -56
- package/src/openApiValidator.ts +219 -36
- package/src/orgs/orgAccessOptIn.test.ts +87 -0
- package/src/orgs/orgContext.test.ts +259 -0
- package/src/orgs/orgContext.ts +151 -0
- package/src/orgs/orgPermissions.test.ts +105 -0
- package/src/orgs/orgPermissions.ts +40 -0
- package/src/orgs/orgPlugin.test.ts +130 -0
- package/src/orgs/orgPlugin.ts +70 -0
- package/src/orgs/orgRbac.test.ts +267 -0
- package/src/orgs/orgSecurityDefects.test.ts +415 -0
- package/src/orgs/organizationModel.test.ts +205 -0
- package/src/orgs/organizationModel.ts +257 -0
- package/src/orgs/organizationSettings.test.ts +113 -0
- package/src/orgs/organizationSettings.ts +126 -0
- package/src/orgs/orgsApp.test.ts +382 -0
- package/src/orgs/orgsApp.ts +563 -0
- package/src/permissions.test.ts +62 -36
- package/src/permissions.ts +8 -30
- package/src/plugins.test.ts +14 -0
- package/src/plugins.ts +34 -9
- package/src/populate.test.ts +34 -0
- package/src/populate.ts +40 -29
- package/src/rateLimit/applyTrustProxy.ts +17 -0
- package/src/rateLimit/createStore.ts +25 -0
- package/src/rateLimit/memoryStore.ts +40 -0
- package/src/rateLimit/middleware.ts +79 -0
- package/src/rateLimit/mongoStore.test.ts +80 -0
- package/src/rateLimit/mongoStore.ts +77 -0
- package/src/rateLimit/policies.ts +130 -0
- package/src/rateLimit/rateLimit.test.ts +328 -0
- package/src/rateLimit/redisStore.ioredis.test.ts +29 -0
- package/src/rateLimit/redisStore.test.ts +114 -0
- package/src/rateLimit/redisStore.ts +86 -0
- package/src/rateLimit/types.ts +64 -0
- package/src/rbac/access.ts +16 -4
- package/src/rbac/assertAllowed.test.ts +325 -0
- package/src/rbac/assertAllowed.ts +157 -0
- package/src/rbac/backfillAdmins.test.ts +124 -0
- package/src/rbac/fieldViews.test.ts +89 -0
- package/src/rbac/membershipOrgAdminSource.ts +59 -0
- package/src/rbac/modelRouterAccess.test.ts +126 -0
- package/src/rbac/modelRouterAccess.ts +8 -2
- package/src/rbac/permissionUtils.test.ts +26 -5
- package/src/rbac/permissionUtils.ts +3 -2
- package/src/rbac/realtimeAccess.test.ts +109 -1
- package/src/rbac/resolve.test.ts +34 -2
- package/src/rbac/resolve.ts +31 -11
- package/src/rbac/roleManager.test.ts +169 -0
- package/src/rbac/roleModel.test.ts +34 -1
- package/src/rbac/roleModel.ts +17 -1
- package/src/rbac/routes.test.ts +233 -0
- package/src/rbac/routes.ts +16 -6
- package/src/rbac/statements.test.ts +19 -0
- package/src/rbac/statements.ts +19 -1
- package/src/rbac/types.ts +5 -0
- package/src/realtime/changeStreamWatcher.ts +73 -33
- package/src/realtime/deprecation.test.ts +60 -0
- package/src/realtime/deprecation.ts +33 -0
- package/src/realtime/realtime.test.ts +365 -189
- package/src/realtime/realtimeApp.ts +11 -11
- package/src/realtime/realtimeAppSetup.test.ts +32 -5
- package/src/realtime/registry.ts +48 -42
- package/src/realtime/sessionRevalidation.test.ts +57 -44
- package/src/realtime/socketAuth.test.ts +75 -23
- package/src/realtime/socketAuth.ts +17 -6
- package/src/realtime/socketUser.ts +5 -3
- package/src/realtime/types.ts +14 -4
- package/src/schemaMetadata.test.ts +419 -0
- package/src/schemaMetadata.ts +593 -0
- package/src/scrubAdminFields.test.ts +105 -0
- package/src/seedRunner.test.ts +591 -0
- package/src/seedRunner.ts +464 -0
- package/src/sync/adminBroadcastConfig.test.ts +96 -0
- package/src/sync/adminBroadcastScope.test.ts +155 -0
- package/src/sync/adminBroadcastScope.ts +123 -0
- package/src/sync/adminWindowAccess.test.ts +57 -0
- package/src/sync/adminWindowAccess.ts +32 -0
- package/src/sync/adminWindowMutation.test.ts +450 -0
- package/src/sync/adminWindowMutation.ts +283 -0
- package/src/sync/docMatchesMutationData.test.ts +16 -0
- package/src/sync/ensureSyncIndexes.test.ts +54 -15
- package/src/sync/executors.test.ts +40 -0
- package/src/sync/executors.ts +57 -18
- package/src/sync/integration.test.ts +15 -7
- package/src/sync/loadHarness.ts +28 -19
- package/src/sync/models.ts +32 -18
- package/src/sync/mutationHandler.test.ts +293 -17
- package/src/sync/mutationHandler.ts +180 -36
- package/src/sync/registrationSideEffects.test.ts +126 -0
- package/src/sync/registrationSideEffects.ts +131 -0
- package/src/sync/registry.ts +49 -171
- package/src/sync/routes.ts +55 -10
- package/src/sync/scripts/compactTombstones.ts +0 -2
- package/src/sync/sessionRevalidationIntegration.test.ts +12 -11
- package/src/sync/socketHandlers.ts +154 -58
- package/src/sync/streams.ts +6 -0
- package/src/sync/sync.test.ts +28 -25
- package/src/sync/syncApp.ts +5 -4
- package/src/sync/syncBatch.ts +10 -4
- package/src/sync/syncFrontier.test.ts +17 -15
- package/src/sync/syncPhaseC.test.ts +54 -43
- package/src/sync/syncRoutes.test.ts +347 -38
- package/src/sync/syncSeqPlugin.ts +66 -44
- package/src/sync/syncSocket.test.ts +341 -81
- package/src/sync/types.ts +20 -0
- package/src/terrenoApp.mcpServiceTokens.test.ts +173 -0
- package/src/terrenoApp.migrations.test.ts +114 -0
- package/src/terrenoApp.test.ts +41 -0
- package/src/terrenoApp.ts +181 -46
- package/src/tests/createTestData.ts +2 -2
- package/src/tests/models.ts +24 -3
- package/src/tests/testHelper.ts +1 -7
- package/src/types/authToken.ts +41 -0
- package/src/types/mcpServiceToken.ts +48 -0
- package/src/types/membership.ts +48 -0
- package/src/types/notification.ts +34 -0
- package/src/types/notificationPreference.ts +28 -0
- package/src/types/organization.ts +49 -0
- package/src/webhooks/headerValue.test.ts +22 -0
- package/src/webhooks/headerValue.ts +12 -0
- package/src/webhooks/idempotency/memoryStore.ts +34 -0
- package/src/webhooks/idempotency/mongoStore.test.ts +274 -0
- package/src/webhooks/idempotency/mongoStore.ts +83 -0
- package/src/webhooks/idempotency/webhookReceipt.ts +67 -0
- package/src/webhooks/rawBody.test.ts +107 -0
- package/src/webhooks/rawBody.ts +24 -0
- package/src/webhooks/timingSafeEqual.ts +16 -0
- package/src/webhooks/verifiers/hmac.test.ts +110 -0
- package/src/webhooks/verifiers/hmac.ts +54 -0
- package/src/webhooks/verifiers/providerVerifiers.test.ts +388 -0
- package/src/webhooks/verifiers/sendgrid.ts +59 -0
- package/src/webhooks/verifiers/stripe.ts +67 -0
- package/src/webhooks/verifiers/twilio.ts +69 -0
- package/src/webhooks/webhooksApp.test.ts +221 -0
- package/src/webhooks/webhooksApp.ts +144 -0
- package/tsconfig.json +1 -1
- package/tsconfig.typedoc.json +2 -1
- package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
- package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
- package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
package/dist/sync/loadHarness.js
CHANGED
|
@@ -143,10 +143,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
143
143
|
var node_http_1 = require("node:http");
|
|
144
144
|
var syncdb_1 = require("@terreno/syncdb");
|
|
145
145
|
var express_1 = __importDefault(require("express"));
|
|
146
|
+
var luxon_1 = require("luxon");
|
|
146
147
|
var mongoose_1 = __importStar(require("mongoose"));
|
|
147
148
|
var passport_local_mongoose_1 = __importDefault(require("passport-local-mongoose"));
|
|
148
149
|
var api_1 = require("../api");
|
|
149
150
|
var auth_1 = require("../auth");
|
|
151
|
+
var errors_1 = require("../errors");
|
|
150
152
|
var logger_1 = require("../logger");
|
|
151
153
|
var permissions_1 = require("../permissions");
|
|
152
154
|
var plugins_1 = require("../plugins");
|
|
@@ -237,10 +239,10 @@ var waitFor = function (predicate_1) {
|
|
|
237
239
|
return __generator(this, function (_f) {
|
|
238
240
|
switch (_f.label) {
|
|
239
241
|
case 0:
|
|
240
|
-
start =
|
|
242
|
+
start = luxon_1.DateTime.now().toMillis();
|
|
241
243
|
_f.label = 1;
|
|
242
244
|
case 1:
|
|
243
|
-
if (!(
|
|
245
|
+
if (!(luxon_1.DateTime.now().toMillis() - start < timeoutMs)) return [3 /*break*/, 4];
|
|
244
246
|
return [4 /*yield*/, predicate()];
|
|
245
247
|
case 2:
|
|
246
248
|
if (_f.sent()) {
|
|
@@ -250,7 +252,10 @@ var waitFor = function (predicate_1) {
|
|
|
250
252
|
case 3:
|
|
251
253
|
_f.sent();
|
|
252
254
|
return [3 /*break*/, 1];
|
|
253
|
-
case 4: throw new
|
|
255
|
+
case 4: throw new errors_1.APIError({
|
|
256
|
+
status: 500,
|
|
257
|
+
title: "Timed out after ".concat(timeoutMs, "ms waiting for ").concat(label),
|
|
258
|
+
});
|
|
254
259
|
}
|
|
255
260
|
});
|
|
256
261
|
});
|
|
@@ -413,7 +418,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
|
413
418
|
perOwnerCount_1.set(owner.ownerId, ((_a = perOwnerCount_1.get(owner.ownerId)) !== null && _a !== void 0 ? _a : 0) + 1);
|
|
414
419
|
return { ownerId: owner.ownerId, title: "seed-".concat(i) };
|
|
415
420
|
});
|
|
416
|
-
bootstrapStart =
|
|
421
|
+
bootstrapStart = luxon_1.DateTime.now().toMillis();
|
|
417
422
|
if (!(seeds.length > 0)) return [3 /*break*/, 12];
|
|
418
423
|
return [4 /*yield*/, LoadTodoModel.insertMany(seeds)];
|
|
419
424
|
case 11:
|
|
@@ -428,7 +433,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
|
428
433
|
}, { label: "bootstrap convergence at ".concat(config.seedDocs, " docs"), timeoutMs: 120000 })];
|
|
429
434
|
case 13:
|
|
430
435
|
_w.sent();
|
|
431
|
-
bootstrapWallMs =
|
|
436
|
+
bootstrapWallMs = luxon_1.DateTime.now().toMillis() - bootstrapStart;
|
|
432
437
|
logger_1.logger.info("[loadHarness] bootstrap converged in ".concat(bootstrapWallMs, "ms"));
|
|
433
438
|
mutateLatenciesMs_1 = [];
|
|
434
439
|
fanoutLagsMs_1 = [];
|
|
@@ -451,7 +456,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
|
451
456
|
}, { intervalMs: 8, label: "mutation ".concat(mutationId, " terminal"), timeoutMs: 15000 })];
|
|
452
457
|
case 1:
|
|
453
458
|
_b.sent();
|
|
454
|
-
mutateLatenciesMs_1.push(
|
|
459
|
+
mutateLatenciesMs_1.push(luxon_1.DateTime.now().toMillis() - startedAt);
|
|
455
460
|
mutation = hc.client.outbox.getMutation({ mutationId: mutationId });
|
|
456
461
|
if ((mutation === null || mutation === void 0 ? void 0 : mutation.status) === "conflicted") {
|
|
457
462
|
conflictCount_1 += 1;
|
|
@@ -466,7 +471,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
|
466
471
|
case 2:
|
|
467
472
|
_a = _b.sent();
|
|
468
473
|
// Timed out waiting; still record whatever elapsed so the report reflects it.
|
|
469
|
-
mutateLatenciesMs_1.push(
|
|
474
|
+
mutateLatenciesMs_1.push(luxon_1.DateTime.now().toMillis() - startedAt);
|
|
470
475
|
return [3 /*break*/, 3];
|
|
471
476
|
case 3: return [2 /*return*/];
|
|
472
477
|
}
|
|
@@ -503,7 +508,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
|
503
508
|
}
|
|
504
509
|
loadPromises = [];
|
|
505
510
|
intervalMs_1 = 1000 / config.targetRate;
|
|
506
|
-
loadEnd =
|
|
511
|
+
loadEnd = luxon_1.DateTime.now().plus({ seconds: config.durationSec }).toMillis();
|
|
507
512
|
_loop_1 = function () {
|
|
508
513
|
var hc, opRoll, startedAt, mutationId, target, owner_1, startedAt, mutationId, dupRequest_1, idx, target, owner, startedAt, mutationId, anyOwner, writeStart_1, doc, id_1;
|
|
509
514
|
return __generator(this, function (_x) {
|
|
@@ -512,10 +517,12 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
|
512
517
|
hc = randomClient();
|
|
513
518
|
opRoll = Math.random();
|
|
514
519
|
if (opRoll < 0.5 || knownEntityIds.length === 0) {
|
|
515
|
-
startedAt =
|
|
520
|
+
startedAt = luxon_1.DateTime.now().toMillis();
|
|
516
521
|
mutationId = hc.client.mutate({
|
|
517
522
|
collection: COLLECTION,
|
|
518
|
-
data: {
|
|
523
|
+
data: {
|
|
524
|
+
title: "load-".concat(luxon_1.DateTime.now().toMillis(), "-").concat(Math.random().toString(36).slice(2, 8)),
|
|
525
|
+
},
|
|
519
526
|
operation: "create",
|
|
520
527
|
}).mutationId;
|
|
521
528
|
loadPromises.push(trackMutation(hc, mutationId, startedAt));
|
|
@@ -523,10 +530,10 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
|
523
530
|
else if (opRoll < 0.85) {
|
|
524
531
|
target = knownEntityIds[Math.floor(Math.random() * knownEntityIds.length)];
|
|
525
532
|
owner_1 = harnessClients[target.clientIndex];
|
|
526
|
-
startedAt =
|
|
533
|
+
startedAt = luxon_1.DateTime.now().toMillis();
|
|
527
534
|
mutationId = owner_1.client.mutate({
|
|
528
535
|
collection: COLLECTION,
|
|
529
|
-
data: { title: "updated-".concat(
|
|
536
|
+
data: { title: "updated-".concat(luxon_1.DateTime.now().toMillis()) },
|
|
530
537
|
id: target.id,
|
|
531
538
|
operation: "update",
|
|
532
539
|
}).mutationId;
|
|
@@ -541,7 +548,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
|
541
548
|
if (!doc) {
|
|
542
549
|
return;
|
|
543
550
|
}
|
|
544
|
-
doc.title = "server-race-".concat(
|
|
551
|
+
doc.title = "server-race-".concat(luxon_1.DateTime.now().toMillis());
|
|
545
552
|
return doc.save();
|
|
546
553
|
})
|
|
547
554
|
.catch(function () { });
|
|
@@ -553,8 +560,10 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
|
553
560
|
if (Math.random() < 0.05) {
|
|
554
561
|
dupRequest_1 = {
|
|
555
562
|
collection: COLLECTION,
|
|
556
|
-
data: { title: "dup-".concat(
|
|
557
|
-
mutationId: "load-dup-".concat(
|
|
563
|
+
data: { title: "dup-".concat(luxon_1.DateTime.now().toMillis()) },
|
|
564
|
+
mutationId: "load-dup-".concat(luxon_1.DateTime.now().toMillis(), "-").concat(Math.random()
|
|
565
|
+
.toString(36)
|
|
566
|
+
.slice(2, 8)),
|
|
558
567
|
operation: "create",
|
|
559
568
|
};
|
|
560
569
|
loadPromises.push(owner_1.httpChannel
|
|
@@ -570,7 +579,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
|
570
579
|
idx = Math.floor(Math.random() * knownEntityIds.length);
|
|
571
580
|
target = knownEntityIds[idx];
|
|
572
581
|
owner = harnessClients[target.clientIndex];
|
|
573
|
-
startedAt =
|
|
582
|
+
startedAt = luxon_1.DateTime.now().toMillis();
|
|
574
583
|
mutationId = owner.client.mutate({
|
|
575
584
|
collection: COLLECTION,
|
|
576
585
|
id: target.id,
|
|
@@ -581,7 +590,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
|
581
590
|
}
|
|
582
591
|
if (!(Math.random() < 0.02)) return [3 /*break*/, 2];
|
|
583
592
|
anyOwner = randomClient();
|
|
584
|
-
writeStart_1 =
|
|
593
|
+
writeStart_1 = luxon_1.DateTime.now().toMillis();
|
|
585
594
|
return [4 /*yield*/, LoadTodoModel.create({
|
|
586
595
|
ownerId: anyOwner.ownerId,
|
|
587
596
|
title: "fanout-".concat(writeStart_1),
|
|
@@ -598,7 +607,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
|
598
607
|
timeoutMs: 15000,
|
|
599
608
|
})
|
|
600
609
|
.then(function () {
|
|
601
|
-
fanoutLagsMs_1.push(
|
|
610
|
+
fanoutLagsMs_1.push(luxon_1.DateTime.now().toMillis() - writeStart_1);
|
|
602
611
|
})
|
|
603
612
|
.catch(function () { }));
|
|
604
613
|
_x.label = 2;
|
|
@@ -611,7 +620,7 @@ var main = function () { return __awaiter(void 0, void 0, void 0, function () {
|
|
|
611
620
|
};
|
|
612
621
|
_w.label = 14;
|
|
613
622
|
case 14:
|
|
614
|
-
if (!(
|
|
623
|
+
if (!(luxon_1.DateTime.now().toMillis() < loadEnd)) return [3 /*break*/, 16];
|
|
615
624
|
return [5 /*yield**/, _loop_1()];
|
|
616
625
|
case 15:
|
|
617
626
|
_w.sent();
|
package/dist/sync/models.js
CHANGED
|
@@ -86,7 +86,9 @@ var _a, _b, _c, _d;
|
|
|
86
86
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
87
87
|
exports.getOrCreateSyncKeyMaterial = exports.ensureSyncModelIndexes = exports.SyncKey = exports.SyncMutation = exports.SYNC_MUTATION_LEASE_MS = exports.SyncScopeMove = exports.getCompactedThroughSeq = exports.recordCompactedThroughSeq = exports.computeStableFrontier = exports.releaseSyncSeqs = exports.confirmSyncSeqs = exports.claimSyncSeqs = exports.SyncCounter = exports.PENDING_CLAIM_LEASE_MS = void 0;
|
|
88
88
|
var node_crypto_1 = __importDefault(require("node:crypto"));
|
|
89
|
+
var luxon_1 = require("luxon");
|
|
89
90
|
var mongoose_1 = __importStar(require("mongoose"));
|
|
91
|
+
var errors_1 = require("../errors");
|
|
90
92
|
var logger_1 = require("../logger");
|
|
91
93
|
var plugins_1 = require("../plugins");
|
|
92
94
|
/**
|
|
@@ -97,7 +99,7 @@ var plugins_1 = require("../plugins");
|
|
|
97
99
|
exports.PENDING_CLAIM_LEASE_MS = 60 * 1000;
|
|
98
100
|
var syncPendingClaimSchema = new mongoose_1.Schema({
|
|
99
101
|
claimedAt: {
|
|
100
|
-
default: function () { return
|
|
102
|
+
default: function () { return luxon_1.DateTime.now().toJSDate(); },
|
|
101
103
|
description: "When this seq was claimed; a claim older than PENDING_CLAIM_LEASE_MS is stale",
|
|
102
104
|
type: Date,
|
|
103
105
|
},
|
|
@@ -175,7 +177,7 @@ var claimSyncSeqs = function (_a) { return __awaiter(void 0, [_a], void 0, funct
|
|
|
175
177
|
return __generator(this, function (_a) {
|
|
176
178
|
switch (_a.label) {
|
|
177
179
|
case 0:
|
|
178
|
-
now =
|
|
180
|
+
now = luxon_1.DateTime.now().toJSDate();
|
|
179
181
|
return [4 /*yield*/, exports.SyncCounter.findOneAndUpdate({ stream: stream }, [
|
|
180
182
|
{ $set: { _syncOldSeq: { $ifNull: ["$seq", 0] } } },
|
|
181
183
|
{ $set: { seq: { $add: ["$_syncOldSeq", count] } } },
|
|
@@ -295,7 +297,7 @@ var computeStableFrontier = function (_a) { return __awaiter(void 0, [_a], void
|
|
|
295
297
|
var stream = _b.stream;
|
|
296
298
|
return __generator(this, function (_e) {
|
|
297
299
|
switch (_e.label) {
|
|
298
|
-
case 0: return [4 /*yield*/, exports.SyncCounter
|
|
300
|
+
case 0: return [4 /*yield*/, (0, plugins_1.findOneOrNoneFor)(exports.SyncCounter, { stream: stream })];
|
|
299
301
|
case 1:
|
|
300
302
|
counter = _e.sent();
|
|
301
303
|
if (!counter) {
|
|
@@ -305,13 +307,13 @@ var computeStableFrontier = function (_a) { return __awaiter(void 0, [_a], void
|
|
|
305
307
|
if (pending.length === 0) {
|
|
306
308
|
return [2 /*return*/, counter.seq];
|
|
307
309
|
}
|
|
308
|
-
cutoff =
|
|
310
|
+
cutoff = luxon_1.DateTime.now().minus({ milliseconds: exports.PENDING_CLAIM_LEASE_MS }).toMillis();
|
|
309
311
|
staleSeqs = [];
|
|
310
312
|
minLiveSeq = Number.POSITIVE_INFINITY;
|
|
311
313
|
try {
|
|
312
314
|
for (pending_1 = __values(pending), pending_1_1 = pending_1.next(); !pending_1_1.done; pending_1_1 = pending_1.next()) {
|
|
313
315
|
claim = pending_1_1.value;
|
|
314
|
-
claimedAtMs =
|
|
316
|
+
claimedAtMs = luxon_1.DateTime.fromJSDate(claim.claimedAt).toMillis();
|
|
315
317
|
if (claimedAtMs < cutoff) {
|
|
316
318
|
staleSeqs.push(claim.seq);
|
|
317
319
|
continue;
|
|
@@ -390,7 +392,7 @@ var syncScopeMoveSchema = new mongoose_1.Schema({
|
|
|
390
392
|
type: String,
|
|
391
393
|
},
|
|
392
394
|
created: {
|
|
393
|
-
default: function () { return
|
|
395
|
+
default: function () { return luxon_1.DateTime.now().toJSDate(); },
|
|
394
396
|
description: "When the move was recorded; reaped by compactTombstones once older than the " +
|
|
395
397
|
"owning model's retentionDays (deliberately NOT TTL-indexed — see the model doc)",
|
|
396
398
|
type: Date,
|
|
@@ -452,13 +454,13 @@ var SYNC_MUTATION_TTL_SECONDS = 30 * 24 * 60 * 60;
|
|
|
452
454
|
exports.SYNC_MUTATION_LEASE_MS = 60 * 1000;
|
|
453
455
|
var syncMutationSchema = new mongoose_1.Schema({
|
|
454
456
|
claimedAt: {
|
|
455
|
-
default: function () { return
|
|
457
|
+
default: function () { return luxon_1.DateTime.now().toJSDate(); },
|
|
456
458
|
description: "When this delivery claimed the mutation (lease); a pending row older than " +
|
|
457
459
|
"SYNC_MUTATION_LEASE_MS may be taken over by a fresh delivery via findOneAndUpdate",
|
|
458
460
|
type: Date,
|
|
459
461
|
},
|
|
460
462
|
created: {
|
|
461
|
-
default: function () { return
|
|
463
|
+
default: function () { return luxon_1.DateTime.now().toJSDate(); },
|
|
462
464
|
description: "When the mutation was first claimed; TTL-indexed so rows expire after 30 days",
|
|
463
465
|
type: Date,
|
|
464
466
|
},
|
|
@@ -515,7 +517,7 @@ syncMutationSchema.index({ created: 1 }, { expireAfterSeconds: SYNC_MUTATION_TTL
|
|
|
515
517
|
exports.SyncMutation = (_c = mongoose_1.default.models.SyncMutation) !== null && _c !== void 0 ? _c : mongoose_1.default.model("SyncMutation", syncMutationSchema);
|
|
516
518
|
var syncKeySchema = new mongoose_1.Schema({
|
|
517
519
|
created: {
|
|
518
|
-
default: function () { return
|
|
520
|
+
default: function () { return luxon_1.DateTime.now().toJSDate(); },
|
|
519
521
|
description: "When this key material was generated",
|
|
520
522
|
type: Date,
|
|
521
523
|
},
|
|
@@ -534,17 +536,12 @@ var syncKeySchema = new mongoose_1.Schema({
|
|
|
534
536
|
// Consumer apps run checkModelsStrict() at startup; framework models must comply.
|
|
535
537
|
{ strict: "throw", toJSON: { virtuals: true }, toObject: { virtuals: true } });
|
|
536
538
|
exports.SyncKey = (_d = mongoose_1.default.models.SyncKey) !== null && _d !== void 0 ? _d : mongoose_1.default.model("SyncKey", syncKeySchema);
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
* startup builds them explicitly.
|
|
544
|
-
*/
|
|
545
|
-
// noExplicitAny: a heterogeneous list of models is only used for ensureIndexes
|
|
546
|
-
// biome-ignore lint/suspicious/noExplicitAny: a heterogeneous list of models is only used for ensureIndexes
|
|
547
|
-
var SYNC_BOOKKEEPING_MODELS = [exports.SyncCounter, exports.SyncMutation, exports.SyncScopeMove, exports.SyncKey];
|
|
539
|
+
var SYNC_BOOKKEEPING_MODELS = [
|
|
540
|
+
exports.SyncCounter,
|
|
541
|
+
exports.SyncMutation,
|
|
542
|
+
exports.SyncScopeMove,
|
|
543
|
+
exports.SyncKey,
|
|
544
|
+
];
|
|
548
545
|
/**
|
|
549
546
|
* Best-effort removal of the pre-Task-9.15 `SyncScopeMove` TTL index. Failure is only
|
|
550
547
|
* logged: a leftover TTL index degrades retention accounting but must never block
|
|
@@ -607,9 +604,14 @@ var ensureSyncModelIndexes = function () { return __awaiter(void 0, void 0, void
|
|
|
607
604
|
logger_1.logger.error("[sync] Failed to ensure sync indexes for ".concat(model.modelName), {
|
|
608
605
|
error: String(error_3),
|
|
609
606
|
});
|
|
610
|
-
throw new
|
|
611
|
-
|
|
612
|
-
"
|
|
607
|
+
throw new errors_1.APIError({
|
|
608
|
+
cause: error_3,
|
|
609
|
+
code: "sync-indexes-failed",
|
|
610
|
+
detail: "".concat((0, errors_1.errorDetail)(error_3), ". The sync protocol depends on these indexes (unique mutationId for ") +
|
|
611
|
+
"mutation idempotency, unique stream for seq allocation); fix the DB and restart.",
|
|
612
|
+
status: 500,
|
|
613
|
+
title: "Failed to ensure sync indexes for ".concat(model.modelName),
|
|
614
|
+
});
|
|
613
615
|
case 3: return [2 /*return*/];
|
|
614
616
|
}
|
|
615
617
|
});
|
|
@@ -634,7 +636,7 @@ var getOrCreateSyncKeyMaterial = function (_a) { return __awaiter(void 0, [_a],
|
|
|
634
636
|
switch (_c.label) {
|
|
635
637
|
case 0:
|
|
636
638
|
candidate = node_crypto_1.default.randomBytes(32).toString("base64");
|
|
637
|
-
return [4 /*yield*/, exports.SyncKey.findOneAndUpdate({ userId: userId }, { $setOnInsert: { created:
|
|
639
|
+
return [4 /*yield*/, exports.SyncKey.findOneAndUpdate({ userId: userId }, { $setOnInsert: { created: luxon_1.DateTime.now().toJSDate(), keyMaterial: candidate, userId: userId } }, { new: true, upsert: true })];
|
|
638
640
|
case 1:
|
|
639
641
|
doc = _c.sent();
|
|
640
642
|
return [2 /*return*/, doc.keyMaterial];
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import type express from "express";
|
|
2
2
|
import type { User } from "../auth";
|
|
3
3
|
import { type SyncRegistryEntry } from "./registry";
|
|
4
|
+
import type { SyncAppOptions } from "./routes";
|
|
4
5
|
import type { SyncAck, SyncMutateBatchResponse, SyncMutateRequest, SyncNack } from "./types";
|
|
5
6
|
export type SyncMutationScopeResolver = (user: User, entry: SyncRegistryEntry) => Promise<string[]> | string[];
|
|
6
7
|
/**
|
|
@@ -49,17 +50,27 @@ export type SyncMutationOutcome = {
|
|
|
49
50
|
};
|
|
50
51
|
/** Maximum mutations accepted in a single `sync:mutateBatch` / `POST /sync/mutate/batch` request. */
|
|
51
52
|
export declare const MAX_SYNC_MUTATIONS_PER_BATCH = 100;
|
|
53
|
+
/**
|
|
54
|
+
* C5 (FIX 6): true when every key/value in `data` (the mutation's own
|
|
55
|
+
* intended write) is already present on `doc` — used alongside the
|
|
56
|
+
* expected-post-write-seq check to distinguish "this mutation's own write
|
|
57
|
+
* already landed" (safe to report as already-applied) from "a genuinely
|
|
58
|
+
* different write landed and happens to have advanced the seq by exactly
|
|
59
|
+
* one" (a real conflict; a seq match alone cannot tell these apart).
|
|
60
|
+
*/
|
|
61
|
+
export declare const docMatchesMutationData: (doc: unknown, data: Record<string, unknown> | undefined) => boolean;
|
|
52
62
|
/**
|
|
53
63
|
* Apply a client mutation through the transport-agnostic executors (permissions,
|
|
54
64
|
* pre/post hooks, validation) with an atomic idempotency claim. Always finalizes the
|
|
55
65
|
* claimed ledger row before returning so duplicate deliveries can read the outcome back.
|
|
56
66
|
*/
|
|
57
|
-
export declare const applySyncMutation: ({ user, mutation, req, scopeResolver, }: {
|
|
67
|
+
export declare const applySyncMutation: ({ user, mutation, req, scopeResolver, syncOptions, }: {
|
|
58
68
|
user: User;
|
|
59
69
|
mutation: SyncMutateRequest;
|
|
60
70
|
/** The real Express request when called over HTTP; hooks receive a `{user}` stub otherwise. */
|
|
61
71
|
req?: express.Request;
|
|
62
72
|
scopeResolver?: SyncMutationScopeResolver;
|
|
73
|
+
syncOptions?: SyncAppOptions;
|
|
63
74
|
}) => Promise<SyncMutationOutcome>;
|
|
64
75
|
/** Outcome of a batch validation pre-check (before any mutation is attempted). */
|
|
65
76
|
export type SyncBatchValidationOutcome = {
|
|
@@ -88,10 +99,11 @@ export declare const validateSyncMutationBatch: (mutations: SyncMutateRequest[])
|
|
|
88
99
|
* rejection happens before any mutation is attempted); this function assumes the
|
|
89
100
|
* batch already passed that check.
|
|
90
101
|
*/
|
|
91
|
-
export declare const applySyncMutationBatch: ({ user, mutations, req, scopeResolver, }: {
|
|
102
|
+
export declare const applySyncMutationBatch: ({ user, mutations, req, scopeResolver, syncOptions, }: {
|
|
92
103
|
user: User;
|
|
93
104
|
mutations: SyncMutateRequest[];
|
|
94
105
|
/** The real Express request when called over HTTP; hooks receive a `{user}` stub otherwise. */
|
|
95
106
|
req?: express.Request;
|
|
96
107
|
scopeResolver?: SyncMutationScopeResolver;
|
|
108
|
+
syncOptions?: SyncAppOptions;
|
|
97
109
|
}) => Promise<SyncMutateBatchResponse>;
|