@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
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import type { User } from "../auth";
|
|
2
|
+
import type { PermissionMethod } from "../permissions";
|
|
3
|
+
/**
|
|
4
|
+
* AdminApp row/resource rules for `{collection}|admin` and admin-window
|
|
5
|
+
* `GET /sync/entities`. Product `queryFilter` / `IsOwner` stay on app streams;
|
|
6
|
+
* this registry is the AdminApp list/read contract (resource actions + tenant
|
|
7
|
+
* `queryFilter`) so a panel user cannot fetch or live-stream rows `/admin` REST
|
|
8
|
+
* would hide.
|
|
9
|
+
*/
|
|
10
|
+
export interface AdminBroadcastScope {
|
|
11
|
+
listPermissions: PermissionMethod<unknown>[];
|
|
12
|
+
queryFilter?: (user?: User, query?: Record<string, unknown>) => Record<string, unknown> | null | Promise<Record<string, unknown> | null>;
|
|
13
|
+
readPermissions: PermissionMethod<unknown>[];
|
|
14
|
+
}
|
|
15
|
+
export declare const registerAdminBroadcastScope: (modelName: string, scope: AdminBroadcastScope) => void;
|
|
16
|
+
export declare const getAdminBroadcastScope: (modelName: string) => AdminBroadcastScope | undefined;
|
|
17
|
+
export declare const clearAdminBroadcastScopes: () => void;
|
|
18
|
+
/** Socket.io room for `{collection}|admin` (`sync:{tag}|admin`). */
|
|
19
|
+
export declare const isAdminBroadcastSocketRoom: (room: string, collectionTag: string) => boolean;
|
|
20
|
+
export declare const resolveAdminBroadcastQueryFilter: ({ scope, user, }: {
|
|
21
|
+
scope: AdminBroadcastScope;
|
|
22
|
+
user: User;
|
|
23
|
+
}) => Promise<{
|
|
24
|
+
denied: boolean;
|
|
25
|
+
filter?: Record<string, unknown>;
|
|
26
|
+
}>;
|
|
27
|
+
export declare const canListAdminBroadcastScope: ({ scope, user, }: {
|
|
28
|
+
scope: AdminBroadcastScope;
|
|
29
|
+
user: User;
|
|
30
|
+
}) => Promise<boolean>;
|
|
31
|
+
/**
|
|
32
|
+
* `unscoped` means AdminApp has not registered this model — keep product
|
|
33
|
+
* `IsOwner` / `queryFilter` behavior. `deny` / `allow` replace product read
|
|
34
|
+
* for the admin window.
|
|
35
|
+
*/
|
|
36
|
+
export declare const authorizeAdminBroadcastDocument: ({ doc, modelName, user, }: {
|
|
37
|
+
doc?: Record<string, unknown>;
|
|
38
|
+
modelName: string;
|
|
39
|
+
user?: User;
|
|
40
|
+
}) => Promise<"allow" | "deny" | "unscoped">;
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.authorizeAdminBroadcastDocument = exports.canListAdminBroadcastScope = exports.resolveAdminBroadcastQueryFilter = exports.isAdminBroadcastSocketRoom = exports.clearAdminBroadcastScopes = exports.getAdminBroadcastScope = exports.registerAdminBroadcastScope = void 0;
|
|
4
|
+
const logger_1 = require("../logger");
|
|
5
|
+
const permissions_1 = require("../permissions");
|
|
6
|
+
const queryMatcher_1 = require("../realtime/queryMatcher");
|
|
7
|
+
const streams_1 = require("./streams");
|
|
8
|
+
const adminBroadcastScopes = new Map();
|
|
9
|
+
const registerAdminBroadcastScope = (modelName, scope) => {
|
|
10
|
+
adminBroadcastScopes.set(modelName, scope);
|
|
11
|
+
};
|
|
12
|
+
exports.registerAdminBroadcastScope = registerAdminBroadcastScope;
|
|
13
|
+
const getAdminBroadcastScope = (modelName) => adminBroadcastScopes.get(modelName);
|
|
14
|
+
exports.getAdminBroadcastScope = getAdminBroadcastScope;
|
|
15
|
+
const clearAdminBroadcastScopes = () => {
|
|
16
|
+
adminBroadcastScopes.clear();
|
|
17
|
+
};
|
|
18
|
+
exports.clearAdminBroadcastScopes = clearAdminBroadcastScopes;
|
|
19
|
+
/** Socket.io room for `{collection}|admin` (`sync:{tag}|admin`). */
|
|
20
|
+
const isAdminBroadcastSocketRoom = (room, collectionTag) => room === `sync:${(0, streams_1.adminBroadcastStream)(collectionTag)}`;
|
|
21
|
+
exports.isAdminBroadcastSocketRoom = isAdminBroadcastSocketRoom;
|
|
22
|
+
const compactFilter = (filter) => {
|
|
23
|
+
const next = {};
|
|
24
|
+
for (const [key, value] of Object.entries(filter)) {
|
|
25
|
+
if (value !== undefined) {
|
|
26
|
+
next[key] = value;
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
return Object.keys(next).length > 0 ? next : undefined;
|
|
30
|
+
};
|
|
31
|
+
const resolveAdminBroadcastQueryFilter = async ({ scope, user, }) => {
|
|
32
|
+
if (!scope.queryFilter) {
|
|
33
|
+
return { denied: false };
|
|
34
|
+
}
|
|
35
|
+
let resolved;
|
|
36
|
+
try {
|
|
37
|
+
resolved = await scope.queryFilter(user, {});
|
|
38
|
+
}
|
|
39
|
+
catch (error) {
|
|
40
|
+
logger_1.logger.error("[sync] admin broadcast queryFilter threw; denying the read", {
|
|
41
|
+
error: String(error),
|
|
42
|
+
userId: String(user.id),
|
|
43
|
+
});
|
|
44
|
+
return { denied: true };
|
|
45
|
+
}
|
|
46
|
+
if (resolved === null) {
|
|
47
|
+
return { denied: true };
|
|
48
|
+
}
|
|
49
|
+
return { denied: false, filter: compactFilter(resolved) };
|
|
50
|
+
};
|
|
51
|
+
exports.resolveAdminBroadcastQueryFilter = resolveAdminBroadcastQueryFilter;
|
|
52
|
+
const canListAdminBroadcastScope = async ({ scope, user, }) => (0, permissions_1.checkPermissions)("list", scope.listPermissions, user);
|
|
53
|
+
exports.canListAdminBroadcastScope = canListAdminBroadcastScope;
|
|
54
|
+
/**
|
|
55
|
+
* `unscoped` means AdminApp has not registered this model — keep product
|
|
56
|
+
* `IsOwner` / `queryFilter` behavior. `deny` / `allow` replace product read
|
|
57
|
+
* for the admin window.
|
|
58
|
+
*/
|
|
59
|
+
const authorizeAdminBroadcastDocument = async ({ doc, modelName, user, }) => {
|
|
60
|
+
const scope = (0, exports.getAdminBroadcastScope)(modelName);
|
|
61
|
+
if (!scope) {
|
|
62
|
+
return "unscoped";
|
|
63
|
+
}
|
|
64
|
+
if (!user) {
|
|
65
|
+
return "deny";
|
|
66
|
+
}
|
|
67
|
+
if (!(await (0, exports.canListAdminBroadcastScope)({ scope, user }))) {
|
|
68
|
+
return "deny";
|
|
69
|
+
}
|
|
70
|
+
const filterResult = await (0, exports.resolveAdminBroadcastQueryFilter)({ scope, user });
|
|
71
|
+
if (filterResult.denied) {
|
|
72
|
+
return "deny";
|
|
73
|
+
}
|
|
74
|
+
if (doc && filterResult.filter && !(0, queryMatcher_1.matchesQuery)(doc, filterResult.filter)) {
|
|
75
|
+
return "deny";
|
|
76
|
+
}
|
|
77
|
+
if (doc && !(await (0, permissions_1.checkPermissions)("read", scope.readPermissions, user, doc))) {
|
|
78
|
+
return "deny";
|
|
79
|
+
}
|
|
80
|
+
return "allow";
|
|
81
|
+
};
|
|
82
|
+
exports.authorizeAdminBroadcastDocument = authorizeAdminBroadcastDocument;
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { User } from "../auth";
|
|
2
|
+
import type { AnyTerrenoAccess } from "../rbac/types";
|
|
3
|
+
/**
|
|
4
|
+
* Gate for `{collection}|admin` window subscribe and cross-owner `GET /sync/entities`.
|
|
5
|
+
*
|
|
6
|
+
* Matches the admin UI shell: with `accessControl`, require `admin:access`.
|
|
7
|
+
* Without RBAC, fall back to the legacy `user.admin` flag.
|
|
8
|
+
*/
|
|
9
|
+
export declare const canUseAdminBroadcastWindow: ({ accessControl, canOpenAdminWindow, user, }: {
|
|
10
|
+
accessControl?: AnyTerrenoAccess;
|
|
11
|
+
canOpenAdminWindow?: (user: User) => boolean | Promise<boolean>;
|
|
12
|
+
user: User;
|
|
13
|
+
}) => Promise<boolean>;
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.canUseAdminBroadcastWindow = void 0;
|
|
4
|
+
const permissions_1 = require("../permissions");
|
|
5
|
+
const statements_1 = require("../rbac/statements");
|
|
6
|
+
/**
|
|
7
|
+
* Gate for `{collection}|admin` window subscribe and cross-owner `GET /sync/entities`.
|
|
8
|
+
*
|
|
9
|
+
* Matches the admin UI shell: with `accessControl`, require `admin:access`.
|
|
10
|
+
* Without RBAC, fall back to the legacy `user.admin` flag.
|
|
11
|
+
*/
|
|
12
|
+
const canUseAdminBroadcastWindow = async ({ accessControl, canOpenAdminWindow, user, }) => {
|
|
13
|
+
if (canOpenAdminWindow) {
|
|
14
|
+
return Boolean(await canOpenAdminWindow(user));
|
|
15
|
+
}
|
|
16
|
+
if (accessControl) {
|
|
17
|
+
const result = await accessControl.can({
|
|
18
|
+
permissions: { admin: [...statements_1.ADMIN_PAGE_PERMISSION.admin] },
|
|
19
|
+
user,
|
|
20
|
+
});
|
|
21
|
+
return result.allowed;
|
|
22
|
+
}
|
|
23
|
+
return permissions_1.Permissions.IsAdmin("list", user);
|
|
24
|
+
};
|
|
25
|
+
exports.canUseAdminBroadcastWindow = canUseAdminBroadcastWindow;
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import type express from "express";
|
|
2
|
+
import mongoose from "mongoose";
|
|
3
|
+
import type { ModelRouterOptions } from "../api";
|
|
4
|
+
import type { User } from "../auth";
|
|
5
|
+
import { type PermissionMethod } from "../permissions";
|
|
6
|
+
import type { AnyTerrenoAccess } from "../rbac/types";
|
|
7
|
+
import type { SyncRegistryEntry } from "./registry";
|
|
8
|
+
import type { SyncAppOptions } from "./routes";
|
|
9
|
+
import type { SyncMutateRequest } from "./types";
|
|
10
|
+
export interface AdminWindowMutationAuditEvent {
|
|
11
|
+
actorId?: string;
|
|
12
|
+
/** Serialized document after the successful mutation. */
|
|
13
|
+
doc?: Record<string, unknown>;
|
|
14
|
+
modelName: string;
|
|
15
|
+
recordId?: string;
|
|
16
|
+
recordLabel?: string;
|
|
17
|
+
verb: "created" | "deleted" | "updated";
|
|
18
|
+
}
|
|
19
|
+
export interface AdminWindowMutationScopeHooks {
|
|
20
|
+
preCreate?: ModelRouterOptions<unknown>["preCreate"];
|
|
21
|
+
preUpdate?: ModelRouterOptions<unknown>["preUpdate"];
|
|
22
|
+
preDelete?: ModelRouterOptions<unknown>["preDelete"];
|
|
23
|
+
postCreate?: ModelRouterOptions<unknown>["postCreate"];
|
|
24
|
+
postUpdate?: ModelRouterOptions<unknown>["postUpdate"];
|
|
25
|
+
postDelete?: ModelRouterOptions<unknown>["postDelete"];
|
|
26
|
+
}
|
|
27
|
+
export interface AdminWindowMutationScope extends AdminWindowMutationScopeHooks {
|
|
28
|
+
/** RBAC access used by AdminApp User admin-flag and role assignment hooks. */
|
|
29
|
+
accessControl?: AnyTerrenoAccess;
|
|
30
|
+
modelName: string;
|
|
31
|
+
permissions: {
|
|
32
|
+
create: boolean;
|
|
33
|
+
update: boolean;
|
|
34
|
+
delete: boolean;
|
|
35
|
+
};
|
|
36
|
+
createPermissions: PermissionMethod<unknown>[];
|
|
37
|
+
updatePermissions: PermissionMethod<unknown>[];
|
|
38
|
+
deletePermissions: PermissionMethod<unknown>[];
|
|
39
|
+
stripMutationData: (data: Record<string, unknown>) => Record<string, unknown>;
|
|
40
|
+
/** Legacy standalone audit callback; prefer `postCreate` / `postUpdate` / `postDelete`. */
|
|
41
|
+
emitAudit?: (args: {
|
|
42
|
+
event: AdminWindowMutationAuditEvent;
|
|
43
|
+
req: express.Request;
|
|
44
|
+
}) => void | Promise<void>;
|
|
45
|
+
}
|
|
46
|
+
/** Coalesce `req.user.id` and `req.user._id` to match Admin REST audit actor ids. */
|
|
47
|
+
export declare const auditActorIdFromRequest: (req: express.Request) => string | undefined;
|
|
48
|
+
/**
|
|
49
|
+
* Admin-window sync mutations use AdminApp router pre/post hooks, not product `modelRouter`
|
|
50
|
+
* hooks. Product hooks can overwrite stripped or admin-authorized fields (for example by
|
|
51
|
+
* forcing `ownerId` in `preCreate`).
|
|
52
|
+
*/
|
|
53
|
+
export declare const buildAdminWindowExecutorOptions: <T>({ productOptions, scope, }: {
|
|
54
|
+
productOptions: ModelRouterOptions<T>;
|
|
55
|
+
scope: AdminWindowMutationScope;
|
|
56
|
+
}) => ModelRouterOptions<T>;
|
|
57
|
+
/** Ensure `req.params.id` is set for AdminApp update/delete hooks (User admin-flag gates). */
|
|
58
|
+
export declare const withAdminWindowMutationRequestContext: ({ mutation, req, }: {
|
|
59
|
+
mutation: SyncMutateRequest;
|
|
60
|
+
req: express.Request;
|
|
61
|
+
}) => express.Request;
|
|
62
|
+
export declare const registerAdminWindowMutationScope: (modelName: string, scope: AdminWindowMutationScope) => void;
|
|
63
|
+
export declare const getAdminWindowMutationScope: (modelName: string) => AdminWindowMutationScope | undefined;
|
|
64
|
+
export declare const clearAdminWindowMutationScopes: () => void;
|
|
65
|
+
/**
|
|
66
|
+
* Validates an explicit `mutationMode: "adminWindow"` marker and applies AdminApp write
|
|
67
|
+
* semantics before the product sync executor runs. Returns the mutation with stripped
|
|
68
|
+
* data, or `undefined` when the request stays on the product path.
|
|
69
|
+
*
|
|
70
|
+
* The marker alone is never trusted: callers must also have admin-window access, the
|
|
71
|
+
* collection must be `adminBroadcast`, and AdminApp must have registered a write scope.
|
|
72
|
+
*/
|
|
73
|
+
export declare const prepareAdminWindowMutation: ({ entry, mutation, req: _req, syncOptions, user, }: {
|
|
74
|
+
entry: SyncRegistryEntry;
|
|
75
|
+
mutation: SyncMutateRequest;
|
|
76
|
+
req: express.Request;
|
|
77
|
+
syncOptions?: SyncAppOptions;
|
|
78
|
+
user: User;
|
|
79
|
+
}) => Promise<{
|
|
80
|
+
mutation: SyncMutateRequest;
|
|
81
|
+
scope: AdminWindowMutationScope;
|
|
82
|
+
} | undefined>;
|
|
83
|
+
export declare const emitAdminWindowMutationAudit: ({ doc, mutation, req, scope, }: {
|
|
84
|
+
doc: mongoose.Document;
|
|
85
|
+
mutation: SyncMutateRequest;
|
|
86
|
+
req: express.Request;
|
|
87
|
+
scope: AdminWindowMutationScope;
|
|
88
|
+
}) => Promise<void>;
|
|
@@ -0,0 +1,176 @@
|
|
|
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.emitAdminWindowMutationAudit = exports.prepareAdminWindowMutation = exports.clearAdminWindowMutationScopes = exports.getAdminWindowMutationScope = exports.registerAdminWindowMutationScope = exports.withAdminWindowMutationRequestContext = exports.buildAdminWindowExecutorOptions = exports.auditActorIdFromRequest = void 0;
|
|
7
|
+
const mongoose_1 = __importDefault(require("mongoose"));
|
|
8
|
+
const errors_1 = require("../errors");
|
|
9
|
+
const permissions_1 = require("../permissions");
|
|
10
|
+
const plugins_1 = require("../plugins");
|
|
11
|
+
const adminWindowAccess_1 = require("./adminWindowAccess");
|
|
12
|
+
/** Coalesce `req.user.id` and `req.user._id` to match Admin REST audit actor ids. */
|
|
13
|
+
const auditActorIdFromRequest = (req) => {
|
|
14
|
+
const actor = req.user;
|
|
15
|
+
if (!actor) {
|
|
16
|
+
return undefined;
|
|
17
|
+
}
|
|
18
|
+
if (actor.id != null) {
|
|
19
|
+
return String(actor.id);
|
|
20
|
+
}
|
|
21
|
+
if (actor._id != null) {
|
|
22
|
+
return String(actor._id);
|
|
23
|
+
}
|
|
24
|
+
return undefined;
|
|
25
|
+
};
|
|
26
|
+
exports.auditActorIdFromRequest = auditActorIdFromRequest;
|
|
27
|
+
/**
|
|
28
|
+
* Admin-window sync mutations use AdminApp router pre/post hooks, not product `modelRouter`
|
|
29
|
+
* hooks. Product hooks can overwrite stripped or admin-authorized fields (for example by
|
|
30
|
+
* forcing `ownerId` in `preCreate`).
|
|
31
|
+
*/
|
|
32
|
+
const buildAdminWindowExecutorOptions = ({ productOptions, scope, }) => ({
|
|
33
|
+
...productOptions,
|
|
34
|
+
accessControl: scope.accessControl ?? productOptions.accessControl,
|
|
35
|
+
postCreate: scope.postCreate,
|
|
36
|
+
postDelete: scope.postDelete,
|
|
37
|
+
postUpdate: scope.postUpdate,
|
|
38
|
+
preCreate: scope.preCreate,
|
|
39
|
+
preDelete: scope.preDelete,
|
|
40
|
+
preUpdate: scope.preUpdate,
|
|
41
|
+
});
|
|
42
|
+
exports.buildAdminWindowExecutorOptions = buildAdminWindowExecutorOptions;
|
|
43
|
+
/** Ensure `req.params.id` is set for AdminApp update/delete hooks (User admin-flag gates). */
|
|
44
|
+
const withAdminWindowMutationRequestContext = ({ mutation, req, }) => {
|
|
45
|
+
if (mutation.operation === "create" || mutation.id == null) {
|
|
46
|
+
return req;
|
|
47
|
+
}
|
|
48
|
+
const params = { ...(req.params ?? {}), id: mutation.id };
|
|
49
|
+
return Object.assign(req, { params });
|
|
50
|
+
};
|
|
51
|
+
exports.withAdminWindowMutationRequestContext = withAdminWindowMutationRequestContext;
|
|
52
|
+
const adminWindowMutationScopes = new Map();
|
|
53
|
+
const registerAdminWindowMutationScope = (modelName, scope) => {
|
|
54
|
+
adminWindowMutationScopes.set(modelName, scope);
|
|
55
|
+
};
|
|
56
|
+
exports.registerAdminWindowMutationScope = registerAdminWindowMutationScope;
|
|
57
|
+
const getAdminWindowMutationScope = (modelName) => adminWindowMutationScopes.get(modelName);
|
|
58
|
+
exports.getAdminWindowMutationScope = getAdminWindowMutationScope;
|
|
59
|
+
const clearAdminWindowMutationScopes = () => {
|
|
60
|
+
adminWindowMutationScopes.clear();
|
|
61
|
+
};
|
|
62
|
+
exports.clearAdminWindowMutationScopes = clearAdminWindowMutationScopes;
|
|
63
|
+
const operationEnabled = (scope, operation) => {
|
|
64
|
+
if (operation === "create") {
|
|
65
|
+
return scope.permissions.create;
|
|
66
|
+
}
|
|
67
|
+
if (operation === "update") {
|
|
68
|
+
return scope.permissions.update;
|
|
69
|
+
}
|
|
70
|
+
return scope.permissions.delete;
|
|
71
|
+
};
|
|
72
|
+
const permissionsForOperation = (scope, operation) => {
|
|
73
|
+
if (operation === "create") {
|
|
74
|
+
return scope.createPermissions;
|
|
75
|
+
}
|
|
76
|
+
if (operation === "update") {
|
|
77
|
+
return scope.updatePermissions;
|
|
78
|
+
}
|
|
79
|
+
return scope.deletePermissions;
|
|
80
|
+
};
|
|
81
|
+
const loadInstance = async ({ entry, id, }) => {
|
|
82
|
+
const model = mongoose_1.default.model(entry.modelName);
|
|
83
|
+
return (0, plugins_1.findOneOrNoneFor)(model, { _id: id, deleted: { $in: [true, false] } });
|
|
84
|
+
};
|
|
85
|
+
/**
|
|
86
|
+
* Validates an explicit `mutationMode: "adminWindow"` marker and applies AdminApp write
|
|
87
|
+
* semantics before the product sync executor runs. Returns the mutation with stripped
|
|
88
|
+
* data, or `undefined` when the request stays on the product path.
|
|
89
|
+
*
|
|
90
|
+
* The marker alone is never trusted: callers must also have admin-window access, the
|
|
91
|
+
* collection must be `adminBroadcast`, and AdminApp must have registered a write scope.
|
|
92
|
+
*/
|
|
93
|
+
const prepareAdminWindowMutation = async ({ entry, mutation, req: _req, syncOptions, user, }) => {
|
|
94
|
+
if (mutation.mutationMode !== "adminWindow") {
|
|
95
|
+
return undefined;
|
|
96
|
+
}
|
|
97
|
+
if (!entry.config.adminBroadcast) {
|
|
98
|
+
throw new errors_1.APIError({
|
|
99
|
+
status: 403,
|
|
100
|
+
title: "Admin window mutations require an adminBroadcast collection",
|
|
101
|
+
});
|
|
102
|
+
}
|
|
103
|
+
if (!(await (0, adminWindowAccess_1.canUseAdminBroadcastWindow)({
|
|
104
|
+
accessControl: syncOptions?.accessControl,
|
|
105
|
+
canOpenAdminWindow: syncOptions?.canOpenAdminWindow,
|
|
106
|
+
user,
|
|
107
|
+
}))) {
|
|
108
|
+
throw new errors_1.APIError({ status: 403, title: "Admin window access required" });
|
|
109
|
+
}
|
|
110
|
+
const scope = (0, exports.getAdminWindowMutationScope)(entry.modelName);
|
|
111
|
+
if (!scope) {
|
|
112
|
+
throw new errors_1.APIError({
|
|
113
|
+
status: 403,
|
|
114
|
+
title: "Admin window mutations are not registered for this collection",
|
|
115
|
+
});
|
|
116
|
+
}
|
|
117
|
+
if (!operationEnabled(scope, mutation.operation)) {
|
|
118
|
+
throw new errors_1.APIError({
|
|
119
|
+
status: 403,
|
|
120
|
+
title: `${mutation.operation} is disabled for this admin model`,
|
|
121
|
+
});
|
|
122
|
+
}
|
|
123
|
+
let instance;
|
|
124
|
+
if (mutation.operation !== "create") {
|
|
125
|
+
if (!mutation.id) {
|
|
126
|
+
throw new errors_1.APIError({
|
|
127
|
+
status: 400,
|
|
128
|
+
title: `id is required for ${mutation.operation} mutations`,
|
|
129
|
+
});
|
|
130
|
+
}
|
|
131
|
+
instance = await loadInstance({ entry, id: mutation.id });
|
|
132
|
+
if (!instance && mutation.operation === "update") {
|
|
133
|
+
throw new errors_1.APIError({ status: 404, title: "Not found" });
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
const permissionMethod = mutation.operation === "create"
|
|
137
|
+
? "create"
|
|
138
|
+
: mutation.operation === "update"
|
|
139
|
+
? "update"
|
|
140
|
+
: "delete";
|
|
141
|
+
const permissionInstance = mutation.operation === "create" ? mutation.data : instance;
|
|
142
|
+
if (!(await (0, permissions_1.checkPermissions)(permissionMethod, permissionsForOperation(scope, mutation.operation), user, permissionInstance))) {
|
|
143
|
+
throw new errors_1.APIError({ status: 403, title: "Admin write access denied" });
|
|
144
|
+
}
|
|
145
|
+
if (mutation.operation === "delete" || !mutation.data) {
|
|
146
|
+
return { mutation, scope };
|
|
147
|
+
}
|
|
148
|
+
return {
|
|
149
|
+
mutation: { ...mutation, data: scope.stripMutationData(mutation.data) },
|
|
150
|
+
scope,
|
|
151
|
+
};
|
|
152
|
+
};
|
|
153
|
+
exports.prepareAdminWindowMutation = prepareAdminWindowMutation;
|
|
154
|
+
const emitAdminWindowMutationAudit = async ({ doc, mutation, req, scope, }) => {
|
|
155
|
+
if (!scope.emitAudit) {
|
|
156
|
+
return;
|
|
157
|
+
}
|
|
158
|
+
const plain = doc.toObject();
|
|
159
|
+
const recordId = plain._id != null ? String(plain._id) : mutation.id;
|
|
160
|
+
const verb = mutation.operation === "create"
|
|
161
|
+
? "created"
|
|
162
|
+
: mutation.operation === "delete"
|
|
163
|
+
? "deleted"
|
|
164
|
+
: "updated";
|
|
165
|
+
await scope.emitAudit({
|
|
166
|
+
event: {
|
|
167
|
+
actorId: (0, exports.auditActorIdFromRequest)(req),
|
|
168
|
+
doc: plain,
|
|
169
|
+
modelName: scope.modelName,
|
|
170
|
+
recordId,
|
|
171
|
+
verb,
|
|
172
|
+
},
|
|
173
|
+
req,
|
|
174
|
+
});
|
|
175
|
+
};
|
|
176
|
+
exports.emitAdminWindowMutationAudit = emitAdminWindowMutationAudit;
|
package/dist/sync/executors.d.ts
CHANGED
|
@@ -107,7 +107,7 @@ export declare const isVersionError: (error: unknown) => boolean;
|
|
|
107
107
|
* `transformer.transform`, `preCreate`, `Model.create` (Mongoose validation), population,
|
|
108
108
|
* and `postCreate`. Throws APIErrors with the same statuses/titles as the REST handler.
|
|
109
109
|
*/
|
|
110
|
-
export declare const executeCreate: <T>({ model, options, user, body, req, skipPostHooks, writeModelName, }: {
|
|
110
|
+
export declare const executeCreate: <T>({ model, options, user, body, req, skipPermissionChecks, skipPostHooks, writeModelName, }: {
|
|
111
111
|
model: Model<T>;
|
|
112
112
|
options: ModelRouterOptions<T>;
|
|
113
113
|
user?: User;
|
|
@@ -126,6 +126,8 @@ export declare const executeCreate: <T>({ model, options, user, body, req, skipP
|
|
|
126
126
|
* committed write look like a failure. REST handlers never set this.
|
|
127
127
|
*/
|
|
128
128
|
skipPostHooks?: boolean;
|
|
129
|
+
/** When true, skip modelRouter permission checks (admin-window sync mutations). */
|
|
130
|
+
skipPermissionChecks?: boolean;
|
|
129
131
|
}) => Promise<ExecutorResult<T>>;
|
|
130
132
|
/**
|
|
131
133
|
* C5 (FIX 6): run `postCreate` outside the write transaction/ledger-finalize
|
|
@@ -146,7 +148,7 @@ export declare const runPostCreate: <T>({ doc, options, request, }: {
|
|
|
146
148
|
* population, and `postUpdate`. Throws APIErrors with the same statuses/titles as the REST
|
|
147
149
|
* handler; concurrency conflicts throw `ExecutorConflictError` (409) carrying the server doc.
|
|
148
150
|
*/
|
|
149
|
-
export declare const executeUpdate: <T>({ model, options, user, id, body, concurrencyCheck, existingDoc, req, skipPostHooks, writeModelName, }: {
|
|
151
|
+
export declare const executeUpdate: <T>({ model, options, user, id, body, concurrencyCheck, existingDoc, req, skipPermissionChecks, skipPostHooks, writeModelName, }: {
|
|
150
152
|
model: Model<T>;
|
|
151
153
|
options: ModelRouterOptions<T>;
|
|
152
154
|
user?: User;
|
|
@@ -167,6 +169,8 @@ export declare const executeUpdate: <T>({ model, options, user, id, body, concur
|
|
|
167
169
|
* MCP passes the registry `modelName` because compiled mongoose names can differ.
|
|
168
170
|
*/
|
|
169
171
|
writeModelName?: string;
|
|
172
|
+
/** When true, skip modelRouter permission checks (admin-window sync mutations). */
|
|
173
|
+
skipPermissionChecks?: boolean;
|
|
170
174
|
}) => Promise<ExecutorResult<T>>;
|
|
171
175
|
/** C5 (FIX 6): run `postUpdate` outside the write/ledger-finalize window — see `runPostCreate`. */
|
|
172
176
|
export declare const runPostUpdate: <T>({ doc, cleanedBody, prevDoc, options, request, }: {
|
|
@@ -182,7 +186,7 @@ export declare const runPostUpdate: <T>({ doc, cleanedBody, prevDoc, options, re
|
|
|
182
186
|
* schema has a Boolean `deleted` path, else `doc.deleteOne()`), and `postDelete`. Throws
|
|
183
187
|
* APIErrors with the same statuses/titles as the REST handler.
|
|
184
188
|
*/
|
|
185
|
-
export declare const executeDelete: <T>({ model, options, user, id, existingDoc, req, skipPostHooks, }: {
|
|
189
|
+
export declare const executeDelete: <T>({ model, options, user, id, existingDoc, req, skipPermissionChecks, skipPostHooks, }: {
|
|
186
190
|
model: Model<T>;
|
|
187
191
|
options: ModelRouterOptions<T>;
|
|
188
192
|
user?: User;
|
|
@@ -198,6 +202,8 @@ export declare const executeDelete: <T>({ model, options, user, id, existingDoc,
|
|
|
198
202
|
req?: express.Request;
|
|
199
203
|
/** C5 (FIX 6): see `executeCreate`'s `skipPostHooks` doc comment. */
|
|
200
204
|
skipPostHooks?: boolean;
|
|
205
|
+
/** When true, skip modelRouter permission checks (admin-window sync mutations). */
|
|
206
|
+
skipPermissionChecks?: boolean;
|
|
201
207
|
}) => Promise<ExecutorResult<T>>;
|
|
202
208
|
/** C5 (FIX 6): run `postDelete` outside the write/ledger-finalize window — see `runPostCreate`. */
|
|
203
209
|
export declare const runPostDelete: <T>({ doc, options, request, }: {
|