@terreno/api 57.3.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.
Files changed (293) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +6 -0
  3. package/dist/adminTypes.d.ts +7 -0
  4. package/dist/adminTypes.js +6 -1
  5. package/dist/api.d.ts +10 -0
  6. package/dist/api.js +99 -36
  7. package/dist/audit/auditApp.d.ts +30 -0
  8. package/dist/audit/auditApp.js +155 -0
  9. package/dist/audit/auditEventModel.d.ts +29 -0
  10. package/dist/audit/auditEventModel.js +102 -0
  11. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  12. package/dist/audit/cloudTasksEnqueue.js +162 -0
  13. package/dist/audit/diff.d.ts +10 -0
  14. package/dist/audit/diff.js +230 -0
  15. package/dist/audit/processQueue.d.ts +6 -0
  16. package/dist/audit/processQueue.js +101 -0
  17. package/dist/audit/rbacSink.d.ts +2 -0
  18. package/dist/audit/rbacSink.js +82 -0
  19. package/dist/audit/record.d.ts +56 -0
  20. package/dist/audit/record.js +373 -0
  21. package/dist/betterAuth.d.ts +6 -0
  22. package/dist/betterAuthSetup.js +1 -1
  23. package/dist/collectionRegistry.d.ts +3 -1
  24. package/dist/collectionRegistry.js +25 -0
  25. package/dist/index.d.ts +26 -1
  26. package/dist/index.js +48 -2
  27. package/dist/mcp/query.d.ts +0 -13
  28. package/dist/mcp/query.js +8 -8
  29. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  30. package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
  31. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  32. package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
  33. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  34. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
  35. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  36. package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
  37. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  38. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  39. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  40. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
  41. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  42. package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
  43. package/dist/migrations/generate.d.ts +17 -0
  44. package/dist/migrations/generate.js +277 -0
  45. package/dist/migrations/load.d.ts +20 -0
  46. package/dist/migrations/load.js +236 -0
  47. package/dist/migrations/lock.d.ts +13 -0
  48. package/dist/migrations/lock.js +145 -0
  49. package/dist/migrations/runner.d.ts +42 -0
  50. package/dist/migrations/runner.js +503 -0
  51. package/dist/migrations/schemaCatalog.d.ts +44 -0
  52. package/dist/migrations/schemaCatalog.js +326 -0
  53. package/dist/migrations/types.d.ts +87 -0
  54. package/dist/migrations/types.js +7 -0
  55. package/dist/models/notification.d.ts +2 -0
  56. package/dist/models/notification.js +62 -0
  57. package/dist/models/notificationPreference.d.ts +2 -0
  58. package/dist/models/notificationPreference.js +49 -0
  59. package/dist/notifications/notificationService.d.ts +40 -0
  60. package/dist/notifications/notificationService.js +323 -0
  61. package/dist/notifications/notificationsApp.d.ts +18 -0
  62. package/dist/notifications/notificationsApp.js +250 -0
  63. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  64. package/dist/notifications/notificationsBeforeSend.js +77 -0
  65. package/dist/openApi.d.ts +1 -7
  66. package/dist/openApi.js +7 -6
  67. package/dist/openApiBuilder.d.ts +14 -3
  68. package/dist/openApiValidator.d.ts +13 -1
  69. package/dist/openApiValidator.js +200 -36
  70. package/dist/orgs/orgContext.d.ts +23 -0
  71. package/dist/orgs/orgContext.js +198 -0
  72. package/dist/orgs/orgPermissions.d.ts +4 -0
  73. package/dist/orgs/orgPermissions.js +77 -0
  74. package/dist/orgs/orgPlugin.d.ts +13 -0
  75. package/dist/orgs/orgPlugin.js +84 -0
  76. package/dist/orgs/organizationModel.d.ts +13 -0
  77. package/dist/orgs/organizationModel.js +301 -0
  78. package/dist/orgs/organizationSettings.d.ts +19 -0
  79. package/dist/orgs/organizationSettings.js +120 -0
  80. package/dist/orgs/orgsApp.d.ts +28 -0
  81. package/dist/orgs/orgsApp.js +678 -0
  82. package/dist/permissions.d.ts +7 -13
  83. package/dist/permissions.js +8 -31
  84. package/dist/rateLimit/middleware.d.ts +0 -8
  85. package/dist/rateLimit/middleware.js +2 -3
  86. package/dist/rateLimit/mongoStore.d.ts +1 -0
  87. package/dist/rateLimit/mongoStore.js +1 -0
  88. package/dist/rateLimit/policies.d.ts +0 -4
  89. package/dist/rateLimit/policies.js +5 -7
  90. package/dist/rateLimit/redisStore.d.ts +1 -0
  91. package/dist/rateLimit/redisStore.js +1 -0
  92. package/dist/rbac/access.js +30 -13
  93. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  94. package/dist/rbac/membershipOrgAdminSource.js +122 -0
  95. package/dist/rbac/modelRouterAccess.d.ts +3 -0
  96. package/dist/rbac/modelRouterAccess.js +3 -0
  97. package/dist/rbac/resolve.js +60 -31
  98. package/dist/rbac/roleModel.d.ts +2 -5
  99. package/dist/rbac/roleModel.js +18 -4
  100. package/dist/rbac/statements.d.ts +10 -1
  101. package/dist/rbac/statements.js +19 -2
  102. package/dist/rbac/types.d.ts +5 -0
  103. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  104. package/dist/realtime/changeStreamWatcher.js +110 -64
  105. package/dist/realtime/deprecation.d.ts +1 -0
  106. package/dist/realtime/deprecation.js +1 -0
  107. package/dist/realtime/realtimeApp.d.ts +1 -0
  108. package/dist/realtime/realtimeApp.js +1 -0
  109. package/dist/schemaMetadata.js +16 -5
  110. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  111. package/dist/sync/adminBroadcastScope.js +194 -0
  112. package/dist/sync/adminWindowAccess.d.ts +13 -0
  113. package/dist/sync/adminWindowAccess.js +96 -0
  114. package/dist/sync/adminWindowMutation.d.ts +88 -0
  115. package/dist/sync/adminWindowMutation.js +247 -0
  116. package/dist/sync/executors.d.ts +9 -3
  117. package/dist/sync/executors.js +190 -159
  118. package/dist/sync/mutationHandler.d.ts +5 -2
  119. package/dist/sync/mutationHandler.js +191 -71
  120. package/dist/sync/registry.js +4 -0
  121. package/dist/sync/routes.d.ts +13 -0
  122. package/dist/sync/routes.js +113 -56
  123. package/dist/sync/socketHandlers.d.ts +8 -2
  124. package/dist/sync/socketHandlers.js +144 -50
  125. package/dist/sync/streams.d.ts +2 -0
  126. package/dist/sync/streams.js +7 -1
  127. package/dist/sync/syncApp.d.ts +2 -1
  128. package/dist/sync/syncApp.js +2 -1
  129. package/dist/sync/syncBatch.d.ts +5 -2
  130. package/dist/sync/syncBatch.js +4 -4
  131. package/dist/sync/types.d.ts +18 -0
  132. package/dist/terrenoApp.d.ts +29 -0
  133. package/dist/terrenoApp.js +91 -54
  134. package/dist/tests/createTestData.d.ts +1 -3
  135. package/dist/tests/createTestData.js +3 -5
  136. package/dist/tests/models.d.ts +1 -0
  137. package/dist/tests/models.js +9 -2
  138. package/dist/tests/testHelper.d.ts +0 -5
  139. package/dist/tests/testHelper.js +2 -9
  140. package/dist/types/authToken.d.ts +3 -3
  141. package/dist/types/mcpServiceToken.d.ts +2 -2
  142. package/dist/types/membership.d.ts +23 -0
  143. package/dist/types/membership.js +2 -0
  144. package/dist/types/notification.d.ts +28 -0
  145. package/dist/types/notification.js +2 -0
  146. package/dist/types/notificationPreference.d.ts +20 -0
  147. package/dist/types/notificationPreference.js +2 -0
  148. package/dist/types/organization.d.ts +36 -0
  149. package/dist/types/organization.js +2 -0
  150. package/dist/webhooks/idempotency/webhookReceipt.d.ts +4 -49
  151. package/dist/webhooks/idempotency/webhookReceipt.js +7 -7
  152. package/dist/webhooks/rawBody.d.ts +1 -0
  153. package/dist/webhooks/rawBody.js +1 -0
  154. package/package.json +31 -25
  155. package/src/__snapshots__/openApi.test.ts.snap +192 -54
  156. package/src/__snapshots__/openApiBuilder.test.ts.snap +0 -18
  157. package/src/__snapshots__/schemaMetadata.test.ts.snap +0 -1
  158. package/src/adminTypes.ts +8 -0
  159. package/src/api.test.ts +39 -2
  160. package/src/api.ts +68 -0
  161. package/src/audit/auditApp.test.ts +243 -0
  162. package/src/audit/auditApp.ts +139 -0
  163. package/src/audit/auditEventModel.ts +156 -0
  164. package/src/audit/auditRouter.test.ts +456 -0
  165. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  166. package/src/audit/cloudTasksEnqueue.ts +104 -0
  167. package/src/audit/diff.ts +163 -0
  168. package/src/audit/processQueue.ts +69 -0
  169. package/src/audit/rbacSink.test.ts +86 -0
  170. package/src/audit/rbacSink.ts +42 -0
  171. package/src/audit/record.test.ts +402 -0
  172. package/src/audit/record.ts +328 -0
  173. package/src/auth.test.ts +1 -1
  174. package/src/betterAuth.ts +7 -0
  175. package/src/betterAuthSetup.test.ts +27 -0
  176. package/src/betterAuthSetup.ts +1 -0
  177. package/src/collectionRegistry.test.ts +8 -9
  178. package/src/collectionRegistry.ts +21 -1
  179. package/src/express.d.ts +2 -0
  180. package/src/expressServer.test.ts +50 -2
  181. package/src/index.ts +69 -0
  182. package/src/mcp/handlers.test.ts +275 -0
  183. package/src/mcp/query.ts +3 -3
  184. package/src/mcp/toolGenerator.test.ts +81 -0
  185. package/src/migrations/cli.test.ts +376 -0
  186. package/src/migrations/cli.ts +283 -0
  187. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  188. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  189. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  190. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  191. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  192. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  193. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  194. package/src/migrations/generate.test.ts +333 -0
  195. package/src/migrations/generate.ts +216 -0
  196. package/src/migrations/load.test.ts +103 -0
  197. package/src/migrations/load.ts +124 -0
  198. package/src/migrations/lock.test.ts +133 -0
  199. package/src/migrations/lock.ts +118 -0
  200. package/src/migrations/runner.test.ts +504 -0
  201. package/src/migrations/runner.ts +358 -0
  202. package/src/migrations/schemaCatalog.test.ts +159 -0
  203. package/src/migrations/schemaCatalog.ts +262 -0
  204. package/src/migrations/types.ts +94 -0
  205. package/src/models/notification.ts +68 -0
  206. package/src/models/notificationPreference.ts +62 -0
  207. package/src/notifications/notificationService.ts +254 -0
  208. package/src/notifications/notificationsApp.test.ts +505 -0
  209. package/src/notifications/notificationsApp.ts +200 -0
  210. package/src/notifications/notificationsBeforeSend.ts +51 -0
  211. package/src/openApi.test.ts +0 -1
  212. package/src/openApi.ts +2 -1
  213. package/src/openApiBuilder.ts +14 -3
  214. package/src/openApiValidator.test.ts +221 -2
  215. package/src/openApiValidator.ts +218 -33
  216. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  217. package/src/orgs/orgContext.test.ts +259 -0
  218. package/src/orgs/orgContext.ts +151 -0
  219. package/src/orgs/orgPermissions.test.ts +105 -0
  220. package/src/orgs/orgPermissions.ts +40 -0
  221. package/src/orgs/orgPlugin.test.ts +130 -0
  222. package/src/orgs/orgPlugin.ts +70 -0
  223. package/src/orgs/orgRbac.test.ts +267 -0
  224. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  225. package/src/orgs/organizationModel.test.ts +205 -0
  226. package/src/orgs/organizationModel.ts +257 -0
  227. package/src/orgs/organizationSettings.test.ts +113 -0
  228. package/src/orgs/organizationSettings.ts +126 -0
  229. package/src/orgs/orgsApp.test.ts +382 -0
  230. package/src/orgs/orgsApp.ts +563 -0
  231. package/src/permissions.test.ts +62 -36
  232. package/src/permissions.ts +8 -30
  233. package/src/rateLimit/middleware.ts +1 -1
  234. package/src/rateLimit/mongoStore.ts +1 -0
  235. package/src/rateLimit/policies.ts +2 -2
  236. package/src/rateLimit/redisStore.ts +1 -0
  237. package/src/rbac/access.ts +11 -3
  238. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  239. package/src/rbac/modelRouterAccess.ts +3 -0
  240. package/src/rbac/permissionUtils.test.ts +26 -5
  241. package/src/rbac/resolve.test.ts +34 -2
  242. package/src/rbac/resolve.ts +26 -7
  243. package/src/rbac/roleModel.test.ts +34 -1
  244. package/src/rbac/roleModel.ts +17 -1
  245. package/src/rbac/statements.test.ts +19 -0
  246. package/src/rbac/statements.ts +19 -1
  247. package/src/rbac/types.ts +5 -0
  248. package/src/realtime/changeStreamWatcher.ts +73 -33
  249. package/src/realtime/deprecation.ts +1 -0
  250. package/src/realtime/realtime.test.ts +357 -185
  251. package/src/realtime/realtimeApp.ts +1 -0
  252. package/src/schemaMetadata.test.ts +14 -0
  253. package/src/schemaMetadata.ts +5 -5
  254. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  255. package/src/sync/adminBroadcastScope.test.ts +155 -0
  256. package/src/sync/adminBroadcastScope.ts +123 -0
  257. package/src/sync/adminWindowAccess.test.ts +57 -0
  258. package/src/sync/adminWindowAccess.ts +32 -0
  259. package/src/sync/adminWindowMutation.test.ts +450 -0
  260. package/src/sync/adminWindowMutation.ts +283 -0
  261. package/src/sync/executors.ts +33 -6
  262. package/src/sync/mutationHandler.test.ts +277 -1
  263. package/src/sync/mutationHandler.ts +171 -29
  264. package/src/sync/registry.ts +4 -0
  265. package/src/sync/routes.ts +52 -8
  266. package/src/sync/socketHandlers.ts +154 -58
  267. package/src/sync/streams.ts +6 -0
  268. package/src/sync/sync.test.ts +3 -2
  269. package/src/sync/syncApp.ts +2 -1
  270. package/src/sync/syncBatch.ts +7 -2
  271. package/src/sync/syncRoutes.test.ts +297 -3
  272. package/src/sync/syncSocket.test.ts +229 -0
  273. package/src/sync/types.ts +20 -0
  274. package/src/terrenoApp.migrations.test.ts +114 -0
  275. package/src/terrenoApp.test.ts +41 -0
  276. package/src/terrenoApp.ts +94 -31
  277. package/src/tests/createTestData.ts +2 -2
  278. package/src/tests/models.ts +10 -2
  279. package/src/tests/testHelper.ts +1 -7
  280. package/src/types/authToken.ts +2 -4
  281. package/src/types/mcpServiceToken.ts +1 -7
  282. package/src/types/membership.ts +48 -0
  283. package/src/types/notification.ts +34 -0
  284. package/src/types/notificationPreference.ts +28 -0
  285. package/src/types/organization.ts +49 -0
  286. package/src/webhooks/idempotency/webhookReceipt.ts +4 -7
  287. package/src/webhooks/rawBody.test.ts +33 -0
  288. package/src/webhooks/rawBody.ts +1 -0
  289. package/tsconfig.json +1 -1
  290. package/tsconfig.typedoc.json +2 -1
  291. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  292. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  293. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -119,13 +119,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
119
119
  return (mod && mod.__esModule) ? mod : { "default": mod };
120
120
  };
121
121
  Object.defineProperty(exports, "__esModule", { value: true });
122
- exports.stopChangeStreamWatcher = exports.startChangeStreamWatcher = exports.emitSyncDeltaForChange = exports.emitToDocumentAndQueryRooms = exports.emitToAuthorizedRoom = exports.emitPayloadToAuthorizedRoom = exports.serializeDoc = exports.ensureApiId = exports.resolveRooms = exports.mapOperationType = exports.DEFAULT_IGNORED_COLLECTIONS = exports.SYNC_RESYNC_EVENT = exports.CHANGE_STREAM_RESTART_MAX_DELAY_MS = exports.CHANGE_STREAM_RESTART_BASE_DELAY_MS = void 0;
122
+ exports.stopChangeStreamWatcher = exports.startChangeStreamWatcher = exports.emitSyncDeltaForChange = exports.emitToDocumentAndQueryRooms = exports.emitToAuthorizedRoom = exports.emitPayloadToAuthorizedRoom = exports.serializeDoc = exports.ensureApiId = exports.resolveRooms = exports.mapOperationType = exports.DEFAULT_IGNORED_COLLECTIONS = exports.SYNC_RESYNC_EVENT = void 0;
123
123
  var Sentry = __importStar(require("@sentry/bun"));
124
124
  var luxon_1 = require("luxon");
125
125
  var mongoose_1 = __importDefault(require("mongoose"));
126
126
  var errors_1 = require("../errors");
127
127
  var logger_1 = require("../logger");
128
128
  var realtimeAccess_1 = require("../rbac/realtimeAccess");
129
+ var adminBroadcastScope_1 = require("../sync/adminBroadcastScope");
129
130
  var models_1 = require("../sync/models");
130
131
  var registry_1 = require("../sync/registry");
131
132
  var serialize_1 = require("../sync/serialize");
@@ -155,15 +156,16 @@ var watcherStopped = true;
155
156
  var restartAttempts = 0;
156
157
  var restartTimer = null;
157
158
  /** First restart delay; doubles per consecutive attempt up to the max. */
158
- exports.CHANGE_STREAM_RESTART_BASE_DELAY_MS = 250;
159
+ var CHANGE_STREAM_RESTART_BASE_DELAY_MS = 250;
159
160
  /** Ceiling for the restart backoff — a long outage retries once every 30s, forever. */
160
- exports.CHANGE_STREAM_RESTART_MAX_DELAY_MS = 30000;
161
+ var CHANGE_STREAM_RESTART_MAX_DELAY_MS = 30000;
161
162
  /**
162
163
  * Socket event telling clients their cached cursors may have gaps and they must
163
164
  * re-bootstrap. Emitted when the change stream's oplog history is gone
164
165
  * (`ChangeStreamHistoryLost`), which is the one failure a resume token cannot repair.
165
166
  * Payload: {@link SyncResyncHint}.
166
167
  */
168
+ /** @internal */
167
169
  exports.SYNC_RESYNC_EVENT = "sync:resync-required";
168
170
  /** MongoDB error code / codeName for an unresumable change stream (oplog rolled past). */
169
171
  var CHANGE_STREAM_HISTORY_LOST_CODE = 286;
@@ -201,6 +203,7 @@ var serializePerEntity = function (key, task) {
201
203
  * events are internal (counters/ledger/markers/keys), and processing them would emit
202
204
  * spurious deltas or reprocess scope-move markers. Exported for testing.
203
205
  */
206
+ /** @internal */
204
207
  exports.DEFAULT_IGNORED_COLLECTIONS = [
205
208
  "socketio",
206
209
  "sessions",
@@ -221,6 +224,7 @@ exports.DEFAULT_IGNORED_COLLECTIONS = [
221
224
  *
222
225
  * Exported for testing.
223
226
  */
227
+ /** @internal */
224
228
  var mapOperationType = function (operationType, change, enabledMethods) {
225
229
  var _a, _b;
226
230
  if (enabledMethods === void 0) { enabledMethods = ["create", "update", "delete"]; }
@@ -274,6 +278,7 @@ var getSocketsInRoom = function (io, room) {
274
278
  }
275
279
  return sockets;
276
280
  };
281
+ var emitCollectionTag = function (entry) { var _a; return (_a = entry.collectionTag) !== null && _a !== void 0 ? _a : (entry.routePath ? getCollectionTag(entry.routePath) : undefined); };
277
282
  var canReadDocument = function (entry, user, doc) { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
278
283
  return [2 /*return*/, (0, realtimeAccess_1.canReadDocumentRealtime)(entry, user, doc)];
279
284
  }); }); };
@@ -281,6 +286,7 @@ var canReadDocument = function (entry, user, doc) { return __awaiter(void 0, voi
281
286
  * Determine which Socket.io rooms to emit to based on the room strategy.
282
287
  * Exported for testing.
283
288
  */
289
+ /** @internal */
284
290
  var resolveRooms = function (entry, doc, method) {
285
291
  var roomStrategy = entry.config.roomStrategy;
286
292
  // Use the collection tag (e.g. "todos") for model rooms, matching what the frontend subscribes to
@@ -312,6 +318,7 @@ exports.resolveRooms = resolveRooms;
312
318
  * Ensure serialized documents include `id` to match REST API responses.
313
319
  * Change stream fullDocument payloads are raw BSON objects with `_id` only.
314
320
  */
321
+ /** @internal */
315
322
  var ensureApiId = function (data) {
316
323
  if (data == null || typeof data !== "object" || Array.isArray(data)) {
317
324
  return data;
@@ -339,6 +346,7 @@ exports.ensureApiId = ensureApiId;
339
346
  * would risk leaking unsanitized fields (e.g. `hash`/`salt`) that the handler
340
347
  * was supposed to strip.
341
348
  */
349
+ /** @internal */
342
350
  var serializeDoc = function (entry, doc, method, user) { return __awaiter(void 0, void 0, void 0, function () {
343
351
  var _a, error_1, responseHandler, restMethod, syntheticReq, serialized, masked, error_2, fallback, maskedFallback;
344
352
  var _b;
@@ -396,65 +404,86 @@ exports.serializeDoc = serializeDoc;
396
404
  * emission both delegate here.
397
405
  */
398
406
  var emitPayloadToAuthorizedRoom = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
399
- var sockets, sockets_1, sockets_1_1, socket, user, permissionDocument, canRead, _c, _d, _e, error_3, e_2_1;
400
- var e_2, _f;
407
+ var sockets, sockets_1, sockets_1_1, socket, user, permissionDocument, collectionTag, adminDecision, _c, _d, _e, canRead, _f, _g, _h, error_3, e_2_1;
408
+ var e_2, _j;
401
409
  var io = _b.io, room = _b.room, eventName = _b.eventName, entry = _b.entry, fullDocument = _b.fullDocument, buildPayload = _b.buildPayload, logDebug = _b.logDebug;
402
- return __generator(this, function (_g) {
403
- switch (_g.label) {
410
+ return __generator(this, function (_k) {
411
+ switch (_k.label) {
404
412
  case 0:
405
413
  sockets = getSocketsInRoom(io, room);
406
- _g.label = 1;
414
+ _k.label = 1;
407
415
  case 1:
408
- _g.trys.push([1, 10, 11, 12]);
416
+ _k.trys.push([1, 13, 14, 15]);
409
417
  sockets_1 = __values(sockets), sockets_1_1 = sockets_1.next();
410
- _g.label = 2;
418
+ _k.label = 2;
411
419
  case 2:
412
- if (!!sockets_1_1.done) return [3 /*break*/, 9];
420
+ if (!!sockets_1_1.done) return [3 /*break*/, 12];
413
421
  socket = sockets_1_1.value;
414
422
  return [4 /*yield*/, (0, socketUser_1.awaitSocketFullUser)(socket)];
415
423
  case 3:
416
- user = _g.sent();
417
- _g.label = 4;
424
+ user = _k.sent();
425
+ _k.label = 4;
418
426
  case 4:
419
- _g.trys.push([4, 7, , 8]);
427
+ _k.trys.push([4, 10, , 11]);
420
428
  permissionDocument = fullDocument !== null && fullDocument !== void 0 ? fullDocument : {};
421
- return [4 /*yield*/, canReadDocument(entry, user, permissionDocument)];
429
+ collectionTag = emitCollectionTag(entry);
430
+ if (!(collectionTag && (0, adminBroadcastScope_1.isAdminBroadcastSocketRoom)(room, collectionTag))) return [3 /*break*/, 7];
431
+ return [4 /*yield*/, (0, adminBroadcastScope_1.authorizeAdminBroadcastDocument)({
432
+ doc: fullDocument,
433
+ modelName: entry.modelName,
434
+ user: user,
435
+ })];
422
436
  case 5:
423
- canRead = _g.sent();
424
- if (!canRead) {
425
- logDebug("[realtime] Skipped ".concat(room, " for ").concat(socket.id, ": read permission denied"));
426
- return [3 /*break*/, 8];
437
+ adminDecision = _k.sent();
438
+ if (adminDecision === "deny") {
439
+ logDebug("[realtime] Skipped ".concat(room, " for ").concat(socket.id, ": admin broadcast scope denied"));
440
+ return [3 /*break*/, 11];
427
441
  }
442
+ if (!(adminDecision === "allow")) return [3 /*break*/, 7];
428
443
  _d = (_c = socket).emit;
429
444
  _e = [eventName];
430
445
  return [4 /*yield*/, buildPayload(user)];
431
446
  case 6:
432
- _d.apply(_c, _e.concat([_g.sent()]));
433
- return [3 /*break*/, 8];
434
- case 7:
435
- error_3 = _g.sent();
447
+ _d.apply(_c, _e.concat([_k.sent()]));
448
+ return [3 /*break*/, 11];
449
+ case 7: return [4 /*yield*/, canReadDocument(entry, user, permissionDocument)];
450
+ case 8:
451
+ canRead = _k.sent();
452
+ if (!canRead) {
453
+ logDebug("[realtime] Skipped ".concat(room, " for ").concat(socket.id, ": read permission denied"));
454
+ return [3 /*break*/, 11];
455
+ }
456
+ _g = (_f = socket).emit;
457
+ _h = [eventName];
458
+ return [4 /*yield*/, buildPayload(user)];
459
+ case 9:
460
+ _g.apply(_f, _h.concat([_k.sent()]));
461
+ return [3 /*break*/, 11];
462
+ case 10:
463
+ error_3 = _k.sent();
436
464
  logger_1.logger.error("[realtime] Failed to emit ".concat(eventName, " for ").concat(entry.modelName, " to socket ").concat(socket.id, ": ").concat(error_3));
437
465
  Sentry.captureException(error_3);
438
- return [3 /*break*/, 8];
439
- case 8:
466
+ return [3 /*break*/, 11];
467
+ case 11:
440
468
  sockets_1_1 = sockets_1.next();
441
469
  return [3 /*break*/, 2];
442
- case 9: return [3 /*break*/, 12];
443
- case 10:
444
- e_2_1 = _g.sent();
470
+ case 12: return [3 /*break*/, 15];
471
+ case 13:
472
+ e_2_1 = _k.sent();
445
473
  e_2 = { error: e_2_1 };
446
- return [3 /*break*/, 12];
447
- case 11:
474
+ return [3 /*break*/, 15];
475
+ case 14:
448
476
  try {
449
- if (sockets_1_1 && !sockets_1_1.done && (_f = sockets_1.return)) _f.call(sockets_1);
477
+ if (sockets_1_1 && !sockets_1_1.done && (_j = sockets_1.return)) _j.call(sockets_1);
450
478
  }
451
479
  finally { if (e_2) throw e_2.error; }
452
480
  return [7 /*endfinally*/];
453
- case 12: return [2 /*return*/];
481
+ case 15: return [2 /*return*/];
454
482
  }
455
483
  });
456
484
  }); };
457
485
  exports.emitPayloadToAuthorizedRoom = emitPayloadToAuthorizedRoom;
486
+ /** @internal */
458
487
  var emitToAuthorizedRoom = function (io, room, event, entry, fullDocument, logDebug) { return __awaiter(void 0, void 0, void 0, function () {
459
488
  return __generator(this, function (_a) {
460
489
  return [2 /*return*/, (0, exports.emitPayloadToAuthorizedRoom)({
@@ -499,6 +528,7 @@ exports.emitToAuthorizedRoom = emitToAuthorizedRoom;
499
528
  *
500
529
  * Exported for testing.
501
530
  */
531
+ /** @internal */
502
532
  var emitToDocumentAndQueryRooms = function (io, collection, event, fullDocument, logDebug, entry) { return __awaiter(void 0, void 0, void 0, function () {
503
533
  var docRoom, isOwnerStrategy, querySubscriptions, querySubscriptions_1, querySubscriptions_1_1, _a, queryId, query, queryRoom, docMatches, removeEvent, e_3_1;
504
534
  var e_3, _b;
@@ -749,7 +779,7 @@ var processRealtimeChange = function (_a) { return __awaiter(void 0, [_a], void
749
779
  * Exported for testing.
750
780
  */
751
781
  var emitSyncDeltaForChange = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
752
- var fullDocument, mapped, method, deleted, seq, stream, markers, movedAway, _loop_1, markers_1, markers_1_1, marker, e_5_1, frontierSeq, delta;
782
+ var fullDocument, mapped, method, deleted, seq, stream, markers, movedAway, _loop_1, markers_1, markers_1_1, marker, e_5_1, emitLiveDelta;
753
783
  var e_5, _c;
754
784
  var io = _b.io, entry = _b.entry, change = _b.change, docId = _b.docId, logDebug = _b.logDebug;
755
785
  return __generator(this, function (_d) {
@@ -856,39 +886,55 @@ var emitSyncDeltaForChange = function (_a) { return __awaiter(void 0, [_a], void
856
886
  if (movedAway && method !== "delete") {
857
887
  method = "create";
858
888
  }
859
- return [4 /*yield*/, (0, models_1.computeStableFrontier)({ stream: stream })];
889
+ emitLiveDelta = function (targetStream) { return __awaiter(void 0, void 0, void 0, function () {
890
+ var frontierSeq, liveDelta;
891
+ return __generator(this, function (_a) {
892
+ switch (_a.label) {
893
+ case 0: return [4 /*yield*/, (0, models_1.computeStableFrontier)({ stream: targetStream })];
894
+ case 1:
895
+ frontierSeq = _a.sent();
896
+ liveDelta = __assign({ collection: entry.collectionTag, frontierSeq: frontierSeq, id: docId, method: method, seq: seq, stream: targetStream }, (deleted ? { deleted: true } : {}));
897
+ return [4 /*yield*/, (0, exports.emitPayloadToAuthorizedRoom)({
898
+ // C7: tombstone deltas carry no data (only id/seq/deleted); live deltas serialize.
899
+ buildPayload: deleted
900
+ ? function () { return liveDelta; }
901
+ : function (user) { return __awaiter(void 0, void 0, void 0, function () {
902
+ var syntheticReq, data, _a;
903
+ return __generator(this, function (_b) {
904
+ switch (_b.label) {
905
+ case 0:
906
+ syntheticReq = { params: {}, query: {}, user: user };
907
+ _a = exports.ensureApiId;
908
+ return [4 /*yield*/, (0, serialize_1.serializeSyncPayload)({ doc: fullDocument, entry: entry, method: method, req: syntheticReq })];
909
+ case 1:
910
+ data = _a.apply(void 0, [_b.sent()]);
911
+ return [2 /*return*/, __assign(__assign({}, liveDelta), { data: data })];
912
+ }
913
+ });
914
+ }); },
915
+ entry: entry,
916
+ eventName: "sync:delta",
917
+ fullDocument: fullDocument,
918
+ io: io,
919
+ logDebug: logDebug,
920
+ room: (0, socketHandlers_1.syncRoomForStream)(targetStream),
921
+ })];
922
+ case 2:
923
+ _a.sent();
924
+ logDebug("[sync] Emitted sync:delta ".concat(method, " for ").concat(entry.collectionTag, "/").concat(docId, " seq=").concat(seq, " stream=").concat(targetStream, " frontier=").concat(frontierSeq));
925
+ return [2 /*return*/];
926
+ }
927
+ });
928
+ }); };
929
+ return [4 /*yield*/, emitLiveDelta(stream)];
860
930
  case 10:
861
- frontierSeq = _d.sent();
862
- delta = __assign({ collection: entry.collectionTag, frontierSeq: frontierSeq, id: docId, method: method, seq: seq, stream: stream }, (deleted ? { deleted: true } : {}));
863
- return [4 /*yield*/, (0, exports.emitPayloadToAuthorizedRoom)({
864
- // C7: tombstone deltas carry no data (only id/seq/deleted); live deltas serialize.
865
- buildPayload: deleted
866
- ? function () { return delta; }
867
- : function (user) { return __awaiter(void 0, void 0, void 0, function () {
868
- var syntheticReq, data, _a;
869
- return __generator(this, function (_b) {
870
- switch (_b.label) {
871
- case 0:
872
- syntheticReq = { params: {}, query: {}, user: user };
873
- _a = exports.ensureApiId;
874
- return [4 /*yield*/, (0, serialize_1.serializeSyncPayload)({ doc: fullDocument, entry: entry, method: method, req: syntheticReq })];
875
- case 1:
876
- data = _a.apply(void 0, [_b.sent()]);
877
- return [2 /*return*/, __assign(__assign({}, delta), { data: data })];
878
- }
879
- });
880
- }); },
881
- entry: entry,
882
- eventName: "sync:delta",
883
- fullDocument: fullDocument,
884
- io: io,
885
- logDebug: logDebug,
886
- room: (0, socketHandlers_1.syncRoomForStream)(stream),
887
- })];
931
+ _d.sent();
932
+ if (!(entry.config.adminBroadcast === true)) return [3 /*break*/, 12];
933
+ return [4 /*yield*/, emitLiveDelta((0, streams_1.adminBroadcastStream)(entry.collectionTag))];
888
934
  case 11:
889
935
  _d.sent();
890
- logDebug("[sync] Emitted sync:delta ".concat(method, " for ").concat(entry.collectionTag, "/").concat(docId, " seq=").concat(seq, " stream=").concat(stream, " frontier=").concat(frontierSeq));
891
- return [2 /*return*/];
936
+ _d.label = 12;
937
+ case 12: return [2 /*return*/];
892
938
  }
893
939
  });
894
940
  }); };
@@ -921,7 +967,7 @@ var scheduleChangeStreamRestart = function (_a) {
921
967
  return;
922
968
  }
923
969
  restartAttempts += 1;
924
- var delayMs = Math.min(exports.CHANGE_STREAM_RESTART_BASE_DELAY_MS * Math.pow(2, (restartAttempts - 1)), exports.CHANGE_STREAM_RESTART_MAX_DELAY_MS);
970
+ var delayMs = Math.min(CHANGE_STREAM_RESTART_BASE_DELAY_MS * Math.pow(2, (restartAttempts - 1)), CHANGE_STREAM_RESTART_MAX_DELAY_MS);
925
971
  logger_1.logger.warn("[realtime] Change stream ".concat(reason, "; reopening in ").concat(delayMs, "ms (attempt ").concat(restartAttempts, ")"), { resumable: lastResumeToken !== undefined });
926
972
  restartTimer = setTimeout(function () {
927
973
  restartTimer = null;
@@ -2,6 +2,7 @@
2
2
  * One-line warning for modelRouter `realtime`. Keep in sync with the
3
3
  * `@terreno/rtk` helpers and `docs/implementationPlans/remove-legacy-realtime.md`.
4
4
  */
5
+ /** @internal */
5
6
  export declare const REALTIME_DEPRECATION_MESSAGE = "modelRouter `realtime` is deprecated and will be removed in Terreno 58. Use `sync` with `@terreno/syncdb` instead. See docs/how-to/migrate-rtk-to-syncdb.md. RealtimeApp remains required for sync sockets.";
6
7
  /**
7
8
  * Emits a one-time deprecation warning per model/routePath per process when a
@@ -6,6 +6,7 @@ var logger_1 = require("../logger");
6
6
  * One-line warning for modelRouter `realtime`. Keep in sync with the
7
7
  * `@terreno/rtk` helpers and `docs/implementationPlans/remove-legacy-realtime.md`.
8
8
  */
9
+ /** @internal */
9
10
  exports.REALTIME_DEPRECATION_MESSAGE = "modelRouter `realtime` is deprecated and will be removed in Terreno 58. Use `sync` with `@terreno/syncdb` instead. See docs/how-to/migrate-rtk-to-syncdb.md. RealtimeApp remains required for sync sockets.";
10
11
  var warnedKeys = new Set();
11
12
  var warningKey = function (modelName, routePath) {
@@ -18,6 +18,7 @@ export declare const MAX_QUERY_SUBSCRIPTIONS = 100;
18
18
  *
19
19
  * Exported for testing.
20
20
  */
21
+ /** @internal */
21
22
  export declare const redactCredentials: (url: string) => string;
22
23
  /**
23
24
  * Minimal shape this module requires from a Socket.io socket. Lets tests pass a
@@ -109,6 +109,7 @@ exports.MAX_QUERY_SUBSCRIPTIONS = 100;
109
109
  *
110
110
  * Exported for testing.
111
111
  */
112
+ /** @internal */
112
113
  var redactCredentials = function (url) {
113
114
  try {
114
115
  var parsed = new URL(url);
@@ -10,6 +10,17 @@ var __assign = (this && this.__assign) || function () {
10
10
  };
11
11
  return __assign.apply(this, arguments);
12
12
  };
13
+ var __rest = (this && this.__rest) || function (s, e) {
14
+ var t = {};
15
+ for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
16
+ t[p] = s[p];
17
+ if (s != null && typeof Object.getOwnPropertySymbols === "function")
18
+ for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
19
+ if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
20
+ t[p[i]] = s[p[i]];
21
+ }
22
+ return t;
23
+ };
13
24
  var __values = (this && this.__values) || function(o) {
14
25
  var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
15
26
  if (m) return m.call(o);
@@ -142,7 +153,8 @@ var describeSchemaPath = function (path, schemaPath) {
142
153
  var itemSchemaPath = getNestedValueSchemaPath(schemaPath);
143
154
  if (itemSchemaPath) {
144
155
  var item = describeCaster(itemSchemaPath);
145
- return __assign(__assign({}, base), { isArray: true, item: item, kind: item.kind });
156
+ var _arrayEnum = base.enum, arrayBase = __rest(base, ["enum"]);
157
+ return __assign(__assign({}, arrayBase), { isArray: true, item: item, kind: item.kind });
146
158
  }
147
159
  return __assign(__assign({}, base), { isArray: true, item: { kind: "mixed", required: false }, kind: "mixed" });
148
160
  }
@@ -303,9 +315,6 @@ var fieldDescriptionToOpenApiProperty = function (field) {
303
315
  items: items,
304
316
  type: "array",
305
317
  };
306
- if (field.enum) {
307
- property_1.enum = field.enum;
308
- }
309
318
  return property_1;
310
319
  }
311
320
  if (field.kind === "embedded" && field.fields) {
@@ -317,7 +326,9 @@ var fieldDescriptionToOpenApiProperty = function (field) {
317
326
  if (field.description) {
318
327
  property_2.description = field.description;
319
328
  }
320
- property_2.required = nested.required.length ? nested.required : [];
329
+ if (nested.required.length > 0) {
330
+ property_2.required = nested.required;
331
+ }
321
332
  return property_2;
322
333
  }
323
334
  if (field.kind === "mixed") {
@@ -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,194 @@
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
+ Object.defineProperty(exports, "__esModule", { value: true });
66
+ exports.authorizeAdminBroadcastDocument = exports.canListAdminBroadcastScope = exports.resolveAdminBroadcastQueryFilter = exports.isAdminBroadcastSocketRoom = exports.clearAdminBroadcastScopes = exports.getAdminBroadcastScope = exports.registerAdminBroadcastScope = void 0;
67
+ var logger_1 = require("../logger");
68
+ var permissions_1 = require("../permissions");
69
+ var queryMatcher_1 = require("../realtime/queryMatcher");
70
+ var streams_1 = require("./streams");
71
+ var adminBroadcastScopes = new Map();
72
+ var registerAdminBroadcastScope = function (modelName, scope) {
73
+ adminBroadcastScopes.set(modelName, scope);
74
+ };
75
+ exports.registerAdminBroadcastScope = registerAdminBroadcastScope;
76
+ var getAdminBroadcastScope = function (modelName) {
77
+ return adminBroadcastScopes.get(modelName);
78
+ };
79
+ exports.getAdminBroadcastScope = getAdminBroadcastScope;
80
+ var clearAdminBroadcastScopes = function () {
81
+ adminBroadcastScopes.clear();
82
+ };
83
+ exports.clearAdminBroadcastScopes = clearAdminBroadcastScopes;
84
+ /** Socket.io room for `{collection}|admin` (`sync:{tag}|admin`). */
85
+ var isAdminBroadcastSocketRoom = function (room, collectionTag) {
86
+ return room === "sync:".concat((0, streams_1.adminBroadcastStream)(collectionTag));
87
+ };
88
+ exports.isAdminBroadcastSocketRoom = isAdminBroadcastSocketRoom;
89
+ var compactFilter = function (filter) {
90
+ var e_1, _a;
91
+ var next = {};
92
+ try {
93
+ for (var _b = __values(Object.entries(filter)), _c = _b.next(); !_c.done; _c = _b.next()) {
94
+ var _d = __read(_c.value, 2), key = _d[0], value = _d[1];
95
+ if (value !== undefined) {
96
+ next[key] = value;
97
+ }
98
+ }
99
+ }
100
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
101
+ finally {
102
+ try {
103
+ if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
104
+ }
105
+ finally { if (e_1) throw e_1.error; }
106
+ }
107
+ return Object.keys(next).length > 0 ? next : undefined;
108
+ };
109
+ var resolveAdminBroadcastQueryFilter = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
110
+ var resolved, error_1;
111
+ var scope = _b.scope, user = _b.user;
112
+ return __generator(this, function (_c) {
113
+ switch (_c.label) {
114
+ case 0:
115
+ if (!scope.queryFilter) {
116
+ return [2 /*return*/, { denied: false }];
117
+ }
118
+ _c.label = 1;
119
+ case 1:
120
+ _c.trys.push([1, 3, , 4]);
121
+ return [4 /*yield*/, scope.queryFilter(user, {})];
122
+ case 2:
123
+ resolved = _c.sent();
124
+ return [3 /*break*/, 4];
125
+ case 3:
126
+ error_1 = _c.sent();
127
+ logger_1.logger.error("[sync] admin broadcast queryFilter threw; denying the read", {
128
+ error: String(error_1),
129
+ userId: String(user.id),
130
+ });
131
+ return [2 /*return*/, { denied: true }];
132
+ case 4:
133
+ if (resolved === null) {
134
+ return [2 /*return*/, { denied: true }];
135
+ }
136
+ return [2 /*return*/, { denied: false, filter: compactFilter(resolved) }];
137
+ }
138
+ });
139
+ }); };
140
+ exports.resolveAdminBroadcastQueryFilter = resolveAdminBroadcastQueryFilter;
141
+ var canListAdminBroadcastScope = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
142
+ var scope = _b.scope, user = _b.user;
143
+ return __generator(this, function (_c) {
144
+ return [2 /*return*/, (0, permissions_1.checkPermissions)("list", scope.listPermissions, user)];
145
+ });
146
+ }); };
147
+ exports.canListAdminBroadcastScope = canListAdminBroadcastScope;
148
+ /**
149
+ * `unscoped` means AdminApp has not registered this model — keep product
150
+ * `IsOwner` / `queryFilter` behavior. `deny` / `allow` replace product read
151
+ * for the admin window.
152
+ */
153
+ var authorizeAdminBroadcastDocument = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
154
+ var scope, filterResult, _c;
155
+ var doc = _b.doc, modelName = _b.modelName, user = _b.user;
156
+ return __generator(this, function (_d) {
157
+ switch (_d.label) {
158
+ case 0:
159
+ scope = (0, exports.getAdminBroadcastScope)(modelName);
160
+ if (!scope) {
161
+ return [2 /*return*/, "unscoped"];
162
+ }
163
+ if (!user) {
164
+ return [2 /*return*/, "deny"];
165
+ }
166
+ return [4 /*yield*/, (0, exports.canListAdminBroadcastScope)({ scope: scope, user: user })];
167
+ case 1:
168
+ if (!(_d.sent())) {
169
+ return [2 /*return*/, "deny"];
170
+ }
171
+ return [4 /*yield*/, (0, exports.resolveAdminBroadcastQueryFilter)({ scope: scope, user: user })];
172
+ case 2:
173
+ filterResult = _d.sent();
174
+ if (filterResult.denied) {
175
+ return [2 /*return*/, "deny"];
176
+ }
177
+ if (doc && filterResult.filter && !(0, queryMatcher_1.matchesQuery)(doc, filterResult.filter)) {
178
+ return [2 /*return*/, "deny"];
179
+ }
180
+ _c = doc;
181
+ if (!_c) return [3 /*break*/, 4];
182
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)("read", scope.readPermissions, user, doc)];
183
+ case 3:
184
+ _c = !(_d.sent());
185
+ _d.label = 4;
186
+ case 4:
187
+ if (_c) {
188
+ return [2 /*return*/, "deny"];
189
+ }
190
+ return [2 /*return*/, "allow"];
191
+ }
192
+ });
193
+ }); };
194
+ 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>;