@terreno/api 57.3.0 → 57.6.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 +11 -5
- package/bunfig.toml +1 -1
- package/dist/actions.js +197 -368
- package/dist/adminModelRouter.js +88 -173
- package/dist/adminTypes.d.ts +7 -0
- package/dist/adminTypes.js +6 -1
- package/dist/api.d.ts +10 -0
- package/dist/api.js +601 -792
- package/dist/audit/auditApp.d.ts +30 -0
- package/dist/audit/auditApp.js +114 -0
- package/dist/audit/auditEventModel.d.ts +29 -0
- package/dist/audit/auditEventModel.js +101 -0
- package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
- package/dist/audit/cloudTasksEnqueue.js +69 -0
- package/dist/audit/diff.d.ts +10 -0
- package/dist/audit/diff.js +140 -0
- package/dist/audit/processQueue.d.ts +6 -0
- package/dist/audit/processQueue.js +56 -0
- package/dist/audit/rbacSink.d.ts +2 -0
- package/dist/audit/rbacSink.js +41 -0
- package/dist/audit/record.d.ts +56 -0
- package/dist/audit/record.js +251 -0
- package/dist/auth.js +432 -681
- package/dist/authRecovery.js +155 -269
- package/dist/authTokens.js +43 -118
- package/dist/betterAuth.d.ts +6 -0
- package/dist/betterAuthApp.js +25 -26
- package/dist/betterAuthSetup.js +258 -413
- package/dist/browserLogsRoute.d.ts +6 -0
- package/dist/browserLogsRoute.js +97 -0
- package/dist/collectionRegistry.d.ts +3 -1
- package/dist/collectionRegistry.js +43 -33
- package/dist/config.js +53 -122
- package/dist/configurationApp.js +180 -361
- package/dist/configurationPlugin.js +130 -302
- package/dist/consentApp.js +276 -421
- package/dist/docLoader.js +78 -126
- package/dist/envConfigurationPlugin.js +25 -147
- package/dist/errors.js +151 -247
- package/dist/example.js +28 -34
- package/dist/expressServer.d.ts +10 -0
- package/dist/expressServer.js +109 -255
- package/dist/frameworkModelNames.d.ts +24 -0
- package/dist/frameworkModelNames.js +31 -0
- package/dist/githubAuth.js +152 -216
- package/dist/httpClient.js +176 -264
- package/dist/index.d.ts +28 -1
- package/dist/index.js +53 -2
- package/dist/logger.js +145 -278
- package/dist/mcp/auth.js +76 -128
- package/dist/mcp/createMCPRequest.js +4 -5
- package/dist/mcp/handlers.js +268 -480
- package/dist/mcp/query.d.ts +0 -13
- package/dist/mcp/query.js +57 -151
- package/dist/mcp/registry.js +17 -30
- package/dist/mcp/schemaGenerator.js +95 -181
- package/dist/mcp/server.js +28 -100
- package/dist/mcp/serviceTokens.js +102 -191
- package/dist/mcp/toolGenerator.js +78 -191
- package/dist/middleware.js +15 -27
- package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
- package/dist/migrations/fixtures/all-down/20260910120000-one.js +9 -0
- package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
- package/dist/migrations/fixtures/all-down/20260910120001-two.js +9 -0
- package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
- package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +7 -0
- package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
- package/dist/migrations/fixtures/bad-name/not-a-migration.js +7 -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 +7 -0
- package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
- package/dist/migrations/fixtures/valid/20260910120001-beta.js +9 -0
- package/dist/migrations/generate.d.ts +17 -0
- package/dist/migrations/generate.js +155 -0
- package/dist/migrations/load.d.ts +20 -0
- package/dist/migrations/load.js +110 -0
- package/dist/migrations/lock.d.ts +13 -0
- package/dist/migrations/lock.js +73 -0
- package/dist/migrations/runner.d.ts +42 -0
- package/dist/migrations/runner.js +249 -0
- package/dist/migrations/schemaCatalog.d.ts +44 -0
- package/dist/migrations/schemaCatalog.js +185 -0
- package/dist/migrations/types.d.ts +87 -0
- package/dist/migrations/types.js +7 -0
- package/dist/models/consentForm.js +6 -6
- package/dist/models/consentResponse.js +5 -5
- package/dist/models/mcpServiceToken.js +66 -156
- 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/models/versionConfig.js +5 -5
- package/dist/notifications/notificationService.d.ts +40 -0
- package/dist/notifications/notificationService.js +183 -0
- package/dist/notifications/notificationsApp.d.ts +18 -0
- package/dist/notifications/notificationsApp.js +156 -0
- package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
- package/dist/notifications/notificationsBeforeSend.js +32 -0
- package/dist/notifiers/googleChatNotifier.js +36 -117
- package/dist/notifiers/slackNotifier.d.ts +31 -2
- package/dist/notifiers/slackNotifier.js +170 -119
- package/dist/notifiers/zoomNotifier.js +60 -111
- package/dist/openApi.d.ts +1 -7
- package/dist/openApi.js +113 -127
- package/dist/openApiBuilder.d.ts +14 -3
- package/dist/openApiBuilder.js +117 -159
- package/dist/openApiCompat.js +81 -148
- package/dist/openApiEtag.js +7 -7
- package/dist/openApiValidator.d.ts +13 -1
- package/dist/openApiValidator.js +301 -246
- package/dist/orgs/orgContext.d.ts +23 -0
- package/dist/orgs/orgContext.js +128 -0
- package/dist/orgs/orgPermissions.d.ts +4 -0
- package/dist/orgs/orgPermissions.js +38 -0
- package/dist/orgs/orgPlugin.d.ts +13 -0
- package/dist/orgs/orgPlugin.js +66 -0
- package/dist/orgs/organizationModel.d.ts +13 -0
- package/dist/orgs/organizationModel.js +200 -0
- package/dist/orgs/organizationSettings.d.ts +19 -0
- package/dist/orgs/organizationSettings.js +113 -0
- package/dist/orgs/orgsApp.d.ts +28 -0
- package/dist/orgs/orgsApp.js +416 -0
- package/dist/permissions.d.ts +7 -13
- package/dist/permissions.js +95 -211
- package/dist/plugins.js +125 -218
- package/dist/populate.js +130 -240
- package/dist/rateLimit/applyTrustProxy.js +1 -1
- package/dist/rateLimit/createStore.js +7 -8
- package/dist/rateLimit/memoryStore.js +22 -100
- package/dist/rateLimit/middleware.d.ts +0 -8
- package/dist/rateLimit/middleware.js +49 -101
- package/dist/rateLimit/mongoStore.d.ts +1 -0
- package/dist/rateLimit/mongoStore.js +55 -112
- package/dist/rateLimit/policies.d.ts +0 -4
- package/dist/rateLimit/policies.js +44 -80
- package/dist/rateLimit/redisStore.d.ts +1 -0
- package/dist/rateLimit/redisStore.js +40 -133
- package/dist/rbac/access.js +122 -253
- package/dist/rbac/assertAllowed.js +95 -171
- package/dist/rbac/auditModel.js +14 -58
- package/dist/rbac/backfillAdmins.js +24 -130
- package/dist/rbac/fieldViews.js +46 -141
- package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
- package/dist/rbac/membershipOrgAdminSource.js +51 -0
- package/dist/rbac/middleware.js +30 -96
- package/dist/rbac/modelRouterAccess.d.ts +3 -0
- package/dist/rbac/modelRouterAccess.js +133 -307
- package/dist/rbac/permissionUtils.js +40 -179
- package/dist/rbac/realtimeAccess.js +81 -147
- package/dist/rbac/resolve.d.ts +1 -1
- package/dist/rbac/resolve.js +154 -319
- package/dist/rbac/roleManager.js +318 -700
- package/dist/rbac/roleModel.d.ts +2 -5
- package/dist/rbac/roleModel.js +60 -173
- package/dist/rbac/routes.js +93 -196
- package/dist/rbac/scopes.js +39 -133
- package/dist/rbac/statements.d.ts +10 -1
- package/dist/rbac/statements.js +42 -93
- package/dist/rbac/types.d.ts +5 -0
- package/dist/rbac/userPlugin.js +3 -29
- package/dist/realtime/changeStreamWatcher.d.ts +10 -4
- package/dist/realtime/changeStreamWatcher.js +499 -764
- package/dist/realtime/deprecation.d.ts +1 -0
- package/dist/realtime/deprecation.js +9 -10
- package/dist/realtime/queryMatcher.js +110 -191
- package/dist/realtime/queryStore.js +35 -118
- package/dist/realtime/realtimeApp.d.ts +1 -0
- package/dist/realtime/realtimeApp.js +248 -401
- package/dist/realtime/registry.js +19 -30
- package/dist/realtime/sessionRevalidation.js +132 -358
- package/dist/realtime/socketAuth.js +89 -208
- package/dist/realtime/socketUser.js +10 -56
- package/dist/requestContext.js +93 -139
- package/dist/schemaMetadata.js +181 -265
- package/dist/scriptRunner.js +96 -266
- package/dist/scrubAdminFields.js +36 -108
- package/dist/secretProviders.js +130 -299
- package/dist/seedRunner.js +221 -514
- package/dist/sync/adminBroadcastScope.d.ts +40 -0
- package/dist/sync/adminBroadcastScope.js +82 -0
- package/dist/sync/adminWindowAccess.d.ts +13 -0
- package/dist/sync/adminWindowAccess.js +25 -0
- package/dist/sync/adminWindowMutation.d.ts +88 -0
- package/dist/sync/adminWindowMutation.js +176 -0
- package/dist/sync/executors.d.ts +9 -3
- package/dist/sync/executors.js +425 -598
- package/dist/sync/loadHarness.js +392 -689
- package/dist/sync/models.js +181 -341
- package/dist/sync/mutationHandler.d.ts +5 -2
- package/dist/sync/mutationHandler.js +549 -697
- package/dist/sync/registrationSideEffects.js +41 -95
- package/dist/sync/registry.js +31 -47
- package/dist/sync/routes.d.ts +13 -0
- package/dist/sync/routes.js +484 -760
- package/dist/sync/scripts/compactTombstones.js +83 -228
- package/dist/sync/serialize.js +18 -58
- package/dist/sync/socketHandlers.d.ts +8 -2
- package/dist/sync/socketHandlers.js +271 -402
- package/dist/sync/streams.d.ts +2 -0
- package/dist/sync/streams.js +54 -116
- package/dist/sync/syncApp.d.ts +2 -1
- package/dist/sync/syncApp.js +14 -16
- package/dist/sync/syncBatch.d.ts +5 -2
- package/dist/sync/syncBatch.js +63 -168
- package/dist/sync/syncSeqPlugin.js +430 -702
- package/dist/sync/types.d.ts +18 -0
- package/dist/syncConsents.js +113 -253
- package/dist/terrenoApp.d.ts +29 -0
- package/dist/terrenoApp.js +184 -257
- package/dist/tests/createTestData.d.ts +1 -3
- package/dist/tests/createTestData.js +147 -259
- package/dist/tests/models.d.ts +1 -0
- package/dist/tests/models.js +23 -56
- package/dist/tests/mongoTestSetup.js +42 -103
- package/dist/tests/testHelper.d.ts +0 -5
- package/dist/tests/testHelper.js +32 -101
- package/dist/tests.js +12 -51
- package/dist/transformers.js +61 -164
- package/dist/types/authToken.d.ts +3 -3
- package/dist/types/mcpServiceToken.d.ts +2 -2
- 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/utils.js +31 -93
- package/dist/vendor/wesleytodd-openapi/index.js +37 -51
- package/dist/vendor/wesleytodd-openapi/lib/generate-doc.js +32 -40
- package/dist/vendor/wesleytodd-openapi/lib/layer-schema.js +3 -3
- package/dist/vendor/wesleytodd-openapi/lib/ui.js +50 -19
- package/dist/vendor/wesleytodd-openapi/lib/validate.js +19 -47
- package/dist/versionCheckPlugin.js +52 -100
- package/dist/webhooks/headerValue.js +2 -2
- package/dist/webhooks/idempotency/memoryStore.js +16 -59
- package/dist/webhooks/idempotency/mongoStore.js +55 -130
- package/dist/webhooks/idempotency/webhookReceipt.d.ts +4 -49
- package/dist/webhooks/idempotency/webhookReceipt.js +14 -14
- package/dist/webhooks/rawBody.d.ts +1 -0
- package/dist/webhooks/rawBody.js +2 -1
- package/dist/webhooks/timingSafeEqual.js +4 -5
- package/dist/webhooks/verifiers/hmac.js +17 -18
- package/dist/webhooks/verifiers/sendgrid.js +20 -22
- package/dist/webhooks/verifiers/stripe.js +31 -65
- package/dist/webhooks/verifiers/twilio.js +23 -73
- package/dist/webhooks/webhooksApp.js +78 -177
- package/dist/zodOpenApi.js +2 -2
- package/package.json +34 -28
- package/src/__snapshots__/openApi.test.ts.snap +192 -54
- package/src/__snapshots__/openApiBuilder.test.ts.snap +0 -18
- package/src/__snapshots__/schemaMetadata.test.ts.snap +0 -1
- package/src/__tests__/browserLogsRoute.test.ts +165 -0
- package/src/adminTypes.ts +8 -0
- package/src/api.test.ts +39 -2
- package/src/api.ts +68 -0
- package/src/audit/auditApp.test.ts +243 -0
- package/src/audit/auditApp.ts +139 -0
- package/src/audit/auditEventModel.ts +160 -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 +329 -0
- package/src/auth.test.ts +1 -1
- package/src/auth.ts +1 -1
- package/src/authRecovery.test.ts +43 -0
- package/src/authRecovery.ts +16 -10
- package/src/authTokens.ts +6 -2
- package/src/authVerification.test.ts +22 -0
- package/src/betterAuth.ts +7 -0
- package/src/betterAuthSetup.test.ts +27 -0
- package/src/betterAuthSetup.ts +1 -0
- package/src/browserLogsRoute.ts +110 -0
- package/src/collectionRegistry.test.ts +8 -9
- package/src/collectionRegistry.ts +21 -1
- package/src/configurationPlugin.test.ts +1 -11
- package/src/express.d.ts +2 -0
- package/src/expressServer.test.ts +50 -2
- package/src/expressServer.ts +10 -0
- package/src/frameworkModelNames.test.ts +62 -0
- package/src/frameworkModelNames.ts +33 -0
- package/src/index.ts +76 -0
- package/src/isolated/migrateCliConnect.isolated.ts +51 -0
- package/src/mcp/auth.test.ts +34 -1
- package/src/mcp/handlers.test.ts +275 -0
- package/src/mcp/query.ts +3 -3
- package/src/mcp/toolGenerator.test.ts +81 -0
- package/src/migrations/cli.test.ts +353 -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.ts +4 -3
- package/src/models/notification.ts +69 -0
- package/src/models/notificationPreference.ts +62 -0
- package/src/notifications/notificationService.ts +254 -0
- package/src/notifications/notificationsApp.test.ts +528 -0
- package/src/notifications/notificationsApp.ts +200 -0
- package/src/notifications/notificationsBeforeSend.ts +51 -0
- package/src/notifiers/slackNotifier.test.ts +186 -1
- package/src/notifiers/slackNotifier.ts +167 -8
- package/src/openApi.test.ts +0 -1
- package/src/openApi.ts +2 -1
- package/src/openApiBuilder.ts +14 -3
- package/src/openApiValidator.test.ts +221 -2
- package/src/openApiValidator.ts +218 -33
- 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 +262 -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 +5 -0
- package/src/plugins.ts +3 -0
- package/src/rateLimit/middleware.ts +1 -1
- package/src/rateLimit/mongoStore.ts +1 -0
- package/src/rateLimit/policies.ts +2 -2
- package/src/rateLimit/redisStore.ts +1 -0
- package/src/rbac/access.ts +11 -3
- package/src/rbac/membershipOrgAdminSource.ts +59 -0
- package/src/rbac/modelRouterAccess.ts +3 -0
- package/src/rbac/permissionUtils.test.ts +26 -5
- package/src/rbac/resolve.test.ts +34 -2
- package/src/rbac/resolve.ts +26 -7
- package/src/rbac/roleModel.test.ts +34 -1
- package/src/rbac/roleModel.ts +17 -1
- 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.ts +1 -0
- package/src/realtime/realtime.test.ts +357 -185
- package/src/realtime/realtimeApp.ts +2 -1
- package/src/schemaMetadata.test.ts +14 -0
- package/src/schemaMetadata.ts +5 -5
- 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/executors.ts +33 -6
- package/src/sync/integration.test.ts +2 -2
- package/src/sync/mutationHandler.test.ts +277 -1
- package/src/sync/mutationHandler.ts +171 -29
- package/src/sync/registry.ts +4 -0
- package/src/sync/routes.ts +52 -8
- package/src/sync/socketHandlers.ts +154 -58
- package/src/sync/streams.ts +6 -0
- package/src/sync/sync.test.ts +3 -2
- package/src/sync/syncApp.ts +2 -1
- package/src/sync/syncBatch.ts +7 -2
- package/src/sync/syncRoutes.test.ts +297 -3
- package/src/sync/syncSocket.test.ts +229 -0
- package/src/sync/types.ts +20 -0
- package/src/terrenoApp.migrations.test.ts +114 -0
- package/src/terrenoApp.test.ts +41 -0
- package/src/terrenoApp.ts +97 -31
- package/src/tests/createTestData.ts +2 -2
- package/src/tests/models.ts +10 -2
- package/src/tests/testHelper.ts +1 -7
- package/src/types/authToken.ts +2 -4
- package/src/types/mcpServiceToken.ts +1 -7
- 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/types.d.ts +1 -0
- package/src/webhooks/idempotency/webhookReceipt.ts +8 -10
- package/src/webhooks/rawBody.test.ts +33 -0
- package/src/webhooks/rawBody.ts +1 -0
- package/tsconfig.json +13 -54
- package/tsconfig.typedoc.json +4 -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
|
@@ -1,78 +1,15 @@
|
|
|
1
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 __values = (this && this.__values) || function(o) {
|
|
39
|
-
var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
|
|
40
|
-
if (m) return m.call(o);
|
|
41
|
-
if (o && typeof o.length === "number") return {
|
|
42
|
-
next: function () {
|
|
43
|
-
if (o && i >= o.length) o = void 0;
|
|
44
|
-
return { value: o && o[i++], done: !o };
|
|
45
|
-
}
|
|
46
|
-
};
|
|
47
|
-
throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
|
|
48
|
-
};
|
|
49
|
-
var __read = (this && this.__read) || function (o, n) {
|
|
50
|
-
var m = typeof Symbol === "function" && o[Symbol.iterator];
|
|
51
|
-
if (!m) return o;
|
|
52
|
-
var i = m.call(o), r, ar = [], e;
|
|
53
|
-
try {
|
|
54
|
-
while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
|
|
55
|
-
}
|
|
56
|
-
catch (error) { e = { error: error }; }
|
|
57
|
-
finally {
|
|
58
|
-
try {
|
|
59
|
-
if (r && !r.done && (m = i["return"])) m.call(i);
|
|
60
|
-
}
|
|
61
|
-
finally { if (e) throw e.error; }
|
|
62
|
-
}
|
|
63
|
-
return ar;
|
|
64
|
-
};
|
|
65
2
|
var __importDefault = (this && this.__importDefault) || function (mod) {
|
|
66
3
|
return (mod && mod.__esModule) ? mod : { "default": mod };
|
|
67
4
|
};
|
|
68
5
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
69
6
|
exports.compactTombstones = exports.compactEntryTombstones = exports.DEFAULT_TOMBSTONE_RETENTION_DAYS = void 0;
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
7
|
+
const luxon_1 = require("luxon");
|
|
8
|
+
const mongoose_1 = __importDefault(require("mongoose"));
|
|
9
|
+
const logger_1 = require("../../logger");
|
|
10
|
+
const models_1 = require("../models");
|
|
11
|
+
const registry_1 = require("../registry");
|
|
12
|
+
const streams_1 = require("../streams");
|
|
76
13
|
/**
|
|
77
14
|
* C7 tombstone retention maintenance.
|
|
78
15
|
*
|
|
@@ -89,10 +26,9 @@ var streams_1 = require("../streams");
|
|
|
89
26
|
*/
|
|
90
27
|
/** Default retention window when a model does not override `sync.retentionDays`. */
|
|
91
28
|
exports.DEFAULT_TOMBSTONE_RETENTION_DAYS = 90;
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
return luxon_1.DateTime.now().minus({ days: days }).toJSDate();
|
|
29
|
+
const retentionCutoff = (entry) => {
|
|
30
|
+
const days = entry.config.retentionDays ?? exports.DEFAULT_TOMBSTONE_RETENTION_DAYS;
|
|
31
|
+
return luxon_1.DateTime.now().minus({ days }).toJSDate();
|
|
96
32
|
};
|
|
97
33
|
/**
|
|
98
34
|
* Compact tombstones and scope-move markers for one registry entry: hard-delete
|
|
@@ -107,162 +43,81 @@ var retentionCutoff = function (entry) {
|
|
|
107
43
|
* carries a TTL index: an expiry that fires outside this function reaps rows with no
|
|
108
44
|
* watermark update and ignores the model's `retentionDays`.
|
|
109
45
|
*/
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
markerFilter = { collectionTag: entry.collectionTag, created: { $lt: cutoff } };
|
|
125
|
-
watermarks = new Map();
|
|
126
|
-
raiseWatermark = function (stream, seq) {
|
|
127
|
-
var _a;
|
|
128
|
-
if (typeof seq !== "number" || seq <= 0) {
|
|
129
|
-
return;
|
|
130
|
-
}
|
|
131
|
-
if (seq > ((_a = watermarks.get(stream)) !== null && _a !== void 0 ? _a : 0)) {
|
|
132
|
-
watermarks.set(stream, seq);
|
|
133
|
-
}
|
|
134
|
-
};
|
|
135
|
-
isCustomScope = typeof entry.config.scope === "function";
|
|
136
|
-
projection = scopeField
|
|
137
|
-
? (_b = { _id: 1, _syncSeq: 1 }, _b[scopeField] = 1, _b) : isCustomScope
|
|
138
|
-
? undefined
|
|
139
|
-
: { _id: 1, _syncSeq: 1 };
|
|
140
|
-
return [4 /*yield*/, model.collection
|
|
141
|
-
.find(tombstoneFilter, projection ? { projection: projection } : {})
|
|
142
|
-
.toArray()];
|
|
143
|
-
case 1:
|
|
144
|
-
doomedTombstones = _h.sent();
|
|
145
|
-
try {
|
|
146
|
-
for (doomedTombstones_1 = __values(doomedTombstones), doomedTombstones_1_1 = doomedTombstones_1.next(); !doomedTombstones_1_1.done; doomedTombstones_1_1 = doomedTombstones_1.next()) {
|
|
147
|
-
row = doomedTombstones_1_1.value;
|
|
148
|
-
raiseWatermark((0, streams_1.resolveStreamForDoc)({
|
|
149
|
-
collectionTag: entry.collectionTag,
|
|
150
|
-
doc: row,
|
|
151
|
-
scope: entry.config.scope,
|
|
152
|
-
}), row._syncSeq);
|
|
153
|
-
}
|
|
154
|
-
}
|
|
155
|
-
catch (e_2_1) { e_2 = { error: e_2_1 }; }
|
|
156
|
-
finally {
|
|
157
|
-
try {
|
|
158
|
-
if (doomedTombstones_1_1 && !doomedTombstones_1_1.done && (_c = doomedTombstones_1.return)) _c.call(doomedTombstones_1);
|
|
159
|
-
}
|
|
160
|
-
finally { if (e_2) throw e_2.error; }
|
|
161
|
-
}
|
|
162
|
-
return [4 /*yield*/, models_1.SyncScopeMove.collection
|
|
163
|
-
.find(markerFilter, { projection: { _id: 1, fromStream: 1, seq: 1 } })
|
|
164
|
-
.toArray()];
|
|
165
|
-
case 2:
|
|
166
|
-
doomedMarkers = _h.sent();
|
|
167
|
-
try {
|
|
168
|
-
for (doomedMarkers_1 = __values(doomedMarkers), doomedMarkers_1_1 = doomedMarkers_1.next(); !doomedMarkers_1_1.done; doomedMarkers_1_1 = doomedMarkers_1.next()) {
|
|
169
|
-
marker = doomedMarkers_1_1.value;
|
|
170
|
-
raiseWatermark(String(marker.fromStream), marker.seq);
|
|
171
|
-
}
|
|
172
|
-
}
|
|
173
|
-
catch (e_3_1) { e_3 = { error: e_3_1 }; }
|
|
174
|
-
finally {
|
|
175
|
-
try {
|
|
176
|
-
if (doomedMarkers_1_1 && !doomedMarkers_1_1.done && (_d = doomedMarkers_1.return)) _d.call(doomedMarkers_1);
|
|
177
|
-
}
|
|
178
|
-
finally { if (e_3) throw e_3.error; }
|
|
179
|
-
}
|
|
180
|
-
return [4 /*yield*/, model.collection.deleteMany(tombstoneFilter)];
|
|
181
|
-
case 3:
|
|
182
|
-
tombstoneResult = _h.sent();
|
|
183
|
-
return [4 /*yield*/, models_1.SyncScopeMove.collection.deleteMany(markerFilter)];
|
|
184
|
-
case 4:
|
|
185
|
-
markerResult = _h.sent();
|
|
186
|
-
_h.label = 5;
|
|
187
|
-
case 5:
|
|
188
|
-
_h.trys.push([5, 10, 11, 12]);
|
|
189
|
-
watermarks_1 = __values(watermarks), watermarks_1_1 = watermarks_1.next();
|
|
190
|
-
_h.label = 6;
|
|
191
|
-
case 6:
|
|
192
|
-
if (!!watermarks_1_1.done) return [3 /*break*/, 9];
|
|
193
|
-
_a = __read(watermarks_1_1.value, 2), stream = _a[0], seq = _a[1];
|
|
194
|
-
return [4 /*yield*/, (0, models_1.recordCompactedThroughSeq)({ seq: seq, stream: stream })];
|
|
195
|
-
case 7:
|
|
196
|
-
_h.sent();
|
|
197
|
-
_h.label = 8;
|
|
198
|
-
case 8:
|
|
199
|
-
watermarks_1_1 = watermarks_1.next();
|
|
200
|
-
return [3 /*break*/, 6];
|
|
201
|
-
case 9: return [3 /*break*/, 12];
|
|
202
|
-
case 10:
|
|
203
|
-
e_1_1 = _h.sent();
|
|
204
|
-
e_1 = { error: e_1_1 };
|
|
205
|
-
return [3 /*break*/, 12];
|
|
206
|
-
case 11:
|
|
207
|
-
try {
|
|
208
|
-
if (watermarks_1_1 && !watermarks_1_1.done && (_e = watermarks_1.return)) _e.call(watermarks_1);
|
|
209
|
-
}
|
|
210
|
-
finally { if (e_1) throw e_1.error; }
|
|
211
|
-
return [7 /*endfinally*/];
|
|
212
|
-
case 12: return [2 /*return*/, {
|
|
213
|
-
markers: (_f = markerResult.deletedCount) !== null && _f !== void 0 ? _f : 0,
|
|
214
|
-
tombstones: (_g = tombstoneResult.deletedCount) !== null && _g !== void 0 ? _g : 0,
|
|
215
|
-
}];
|
|
46
|
+
const compactEntryTombstones = async (entry) => {
|
|
47
|
+
const cutoff = retentionCutoff(entry);
|
|
48
|
+
const model = mongoose_1.default.model(entry.modelName);
|
|
49
|
+
const scopeField = (0, streams_1.getScopeField)(entry.config.scope);
|
|
50
|
+
const tombstoneFilter = {
|
|
51
|
+
$or: [{ updated: { $lt: cutoff } }, { created: { $lt: cutoff }, updated: { $exists: false } }],
|
|
52
|
+
deleted: true,
|
|
53
|
+
};
|
|
54
|
+
const markerFilter = { collectionTag: entry.collectionTag, created: { $lt: cutoff } };
|
|
55
|
+
/** stream key -> highest seq being reaped on that stream. */
|
|
56
|
+
const watermarks = new Map();
|
|
57
|
+
const raiseWatermark = (stream, seq) => {
|
|
58
|
+
if (typeof seq !== "number" || seq <= 0) {
|
|
59
|
+
return;
|
|
216
60
|
}
|
|
217
|
-
|
|
218
|
-
|
|
61
|
+
if (seq > (watermarks.get(stream) ?? 0)) {
|
|
62
|
+
watermarks.set(stream, seq);
|
|
63
|
+
}
|
|
64
|
+
};
|
|
65
|
+
// A custom scope resolver may read any field, so it needs whole documents; broadcast and
|
|
66
|
+
// field-based scopes only need the seq (plus the scope field) to resolve the stream.
|
|
67
|
+
const isCustomScope = typeof entry.config.scope === "function";
|
|
68
|
+
const projection = scopeField
|
|
69
|
+
? { _id: 1, _syncSeq: 1, [scopeField]: 1 }
|
|
70
|
+
: isCustomScope
|
|
71
|
+
? undefined
|
|
72
|
+
: { _id: 1, _syncSeq: 1 };
|
|
73
|
+
const doomedTombstones = await model.collection
|
|
74
|
+
.find(tombstoneFilter, projection ? { projection } : {})
|
|
75
|
+
.toArray();
|
|
76
|
+
for (const row of doomedTombstones) {
|
|
77
|
+
raiseWatermark((0, streams_1.resolveStreamForDoc)({
|
|
78
|
+
collectionTag: entry.collectionTag,
|
|
79
|
+
doc: row,
|
|
80
|
+
scope: entry.config.scope,
|
|
81
|
+
}), row._syncSeq);
|
|
82
|
+
}
|
|
83
|
+
const doomedMarkers = await models_1.SyncScopeMove.collection
|
|
84
|
+
.find(markerFilter, { projection: { _id: 1, fromStream: 1, seq: 1 } })
|
|
85
|
+
.toArray();
|
|
86
|
+
for (const marker of doomedMarkers) {
|
|
87
|
+
raiseWatermark(String(marker.fromStream), marker.seq);
|
|
88
|
+
}
|
|
89
|
+
// Hard delete soft-deleted docs older than the cutoff. deleteMany on the raw collection
|
|
90
|
+
// bypasses the syncPlugin guard (which blocks deleteMany on the model) — this is a
|
|
91
|
+
// deliberate maintenance-only escape hatch.
|
|
92
|
+
const tombstoneResult = await model.collection.deleteMany(tombstoneFilter);
|
|
93
|
+
const markerResult = await models_1.SyncScopeMove.collection.deleteMany(markerFilter);
|
|
94
|
+
// Raise the watermarks AFTER the deletes: a watermark that runs ahead of the actual
|
|
95
|
+
// deletion would force re-bootstraps for data still perfectly readable.
|
|
96
|
+
for (const [stream, seq] of watermarks) {
|
|
97
|
+
await (0, models_1.recordCompactedThroughSeq)({ seq, stream });
|
|
98
|
+
}
|
|
99
|
+
return {
|
|
100
|
+
markers: markerResult.deletedCount ?? 0,
|
|
101
|
+
tombstones: tombstoneResult.deletedCount ?? 0,
|
|
102
|
+
};
|
|
103
|
+
};
|
|
219
104
|
exports.compactEntryTombstones = compactEntryTombstones;
|
|
220
105
|
/** Compact tombstones across every registered sync model. */
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
return [4 /*yield*/, (0, exports.compactEntryTombstones)(entry)];
|
|
239
|
-
case 3:
|
|
240
|
-
counts = _d.sent();
|
|
241
|
-
byCollection[entry.collectionTag] = counts;
|
|
242
|
-
totalTombstones += counts.tombstones;
|
|
243
|
-
totalMarkers += counts.markers;
|
|
244
|
-
logger_1.logger.info("[sync] Compacted tombstones", {
|
|
245
|
-
collection: entry.collectionTag,
|
|
246
|
-
markers: counts.markers,
|
|
247
|
-
tombstones: counts.tombstones,
|
|
248
|
-
});
|
|
249
|
-
_d.label = 4;
|
|
250
|
-
case 4:
|
|
251
|
-
_b = _a.next();
|
|
252
|
-
return [3 /*break*/, 2];
|
|
253
|
-
case 5: return [3 /*break*/, 8];
|
|
254
|
-
case 6:
|
|
255
|
-
e_4_1 = _d.sent();
|
|
256
|
-
e_4 = { error: e_4_1 };
|
|
257
|
-
return [3 /*break*/, 8];
|
|
258
|
-
case 7:
|
|
259
|
-
try {
|
|
260
|
-
if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
|
|
261
|
-
}
|
|
262
|
-
finally { if (e_4) throw e_4.error; }
|
|
263
|
-
return [7 /*endfinally*/];
|
|
264
|
-
case 8: return [2 /*return*/, { byCollection: byCollection, totalMarkers: totalMarkers, totalTombstones: totalTombstones }];
|
|
265
|
-
}
|
|
266
|
-
});
|
|
267
|
-
}); };
|
|
106
|
+
const compactTombstones = async () => {
|
|
107
|
+
const byCollection = {};
|
|
108
|
+
let totalTombstones = 0;
|
|
109
|
+
let totalMarkers = 0;
|
|
110
|
+
for (const entry of (0, registry_1.getSyncRegistry)()) {
|
|
111
|
+
const counts = await (0, exports.compactEntryTombstones)(entry);
|
|
112
|
+
byCollection[entry.collectionTag] = counts;
|
|
113
|
+
totalTombstones += counts.tombstones;
|
|
114
|
+
totalMarkers += counts.markers;
|
|
115
|
+
logger_1.logger.info("[sync] Compacted tombstones", {
|
|
116
|
+
collection: entry.collectionTag,
|
|
117
|
+
markers: counts.markers,
|
|
118
|
+
tombstones: counts.tombstones,
|
|
119
|
+
});
|
|
120
|
+
}
|
|
121
|
+
return { byCollection, totalMarkers, totalTombstones };
|
|
122
|
+
};
|
|
268
123
|
exports.compactTombstones = compactTombstones;
|
package/dist/sync/serialize.js
CHANGED
|
@@ -1,40 +1,4 @@
|
|
|
1
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
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
39
3
|
exports.serializeSyncPayload = void 0;
|
|
40
4
|
/**
|
|
@@ -48,26 +12,22 @@ exports.serializeSyncPayload = void 0;
|
|
|
48
12
|
* import cycle. Accepts hydrated Mongoose documents and the raw BSON objects change
|
|
49
13
|
* streams deliver (which have neither `toObject` nor `toJSON`).
|
|
50
14
|
*/
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
}
|
|
70
|
-
return [2 /*return*/, plain];
|
|
71
|
-
});
|
|
72
|
-
}); };
|
|
15
|
+
const serializeSyncPayload = async ({ entry, doc, method = "update", req, }) => {
|
|
16
|
+
const maybeHydrated = doc;
|
|
17
|
+
const plain = typeof maybeHydrated.toObject === "function" ? maybeHydrated.toObject() : doc;
|
|
18
|
+
if (entry.config.responseHandler) {
|
|
19
|
+
return entry.config.responseHandler(plain, method);
|
|
20
|
+
}
|
|
21
|
+
if (entry.options.responseHandler) {
|
|
22
|
+
// C8: sync serializes a SINGLE entity (snapshot row, conflict doc, or delta), so the
|
|
23
|
+
// modelRouter responseHandler must run with single-entity `"read"` semantics — not
|
|
24
|
+
// the hardcoded `"list"`, which can trigger list-only shaping (field trimming, array
|
|
25
|
+
// wrapping) that corrupts a single-doc payload.
|
|
26
|
+
return entry.options.responseHandler(doc, "read", req, entry.options);
|
|
27
|
+
}
|
|
28
|
+
if (typeof maybeHydrated.toJSON === "function") {
|
|
29
|
+
return maybeHydrated.toJSON();
|
|
30
|
+
}
|
|
31
|
+
return plain;
|
|
32
|
+
};
|
|
73
33
|
exports.serializeSyncPayload = serializeSyncPayload;
|
|
@@ -4,17 +4,23 @@ import type { SyncAppOptions } from "./routes";
|
|
|
4
4
|
/**
|
|
5
5
|
* Socket handlers for the SyncDB local-first protocol:
|
|
6
6
|
*
|
|
7
|
-
* - `sync:subscribe {collections}` / `sync:unsubscribe {collections}` — resolves the
|
|
7
|
+
* - `sync:subscribe {collections, mode?}` / `sync:unsubscribe {collections}` — resolves the
|
|
8
8
|
* caller's streams from the sync registry scope config and joins/leaves `sync:{stream}`
|
|
9
9
|
* rooms. Owner scopes always use the socket's own userId (never a client-supplied one);
|
|
10
10
|
* tenant and custom scopes resolve stream values via `SyncAppOptions.getUserScopes`.
|
|
11
|
+
* `mode: "window"` joins `{collection}|admin` only (requires `adminBroadcast` and
|
|
12
|
+
* admin panel access: `admin:access` when `SyncApp` has `accessControl`, else
|
|
13
|
+
* `user.admin`). When AdminApp has registered a broadcast scope, list
|
|
14
|
+
* permission for that model is required as well. Confirms with
|
|
15
|
+
* `sync:subscribed {mode: "window"}` without dumping snapshot pages.
|
|
11
16
|
* Sync deltas fan out through these dedicated `sync:{stream}` rooms rather than the
|
|
12
17
|
* legacy realtime rooms so the two event families never overlap.
|
|
13
18
|
* - `sync:mutate` — applies a mutation through `applySyncMutation` and replies with
|
|
14
19
|
* `sync:ack {mutationId, id, seq}` or `sync:nack {mutationId, code, ...}`; when the
|
|
15
20
|
* client supplied a Socket.io ack callback it also receives `{ack}` / `{nack}`.
|
|
16
21
|
* - `sync:error {collection, message}` — emitted for per-collection subscribe failures
|
|
17
|
-
* (unknown collection, permission denied,
|
|
22
|
+
* (unknown collection, permission denied, non-admin window subscribe, missing scope
|
|
23
|
+
* resolver, cap exceeded).
|
|
18
24
|
*
|
|
19
25
|
* ## Wiring
|
|
20
26
|
*
|