@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
@@ -35,17 +35,6 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
35
35
  if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
36
  }
37
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
38
  var __read = (this && this.__read) || function (o, n) {
50
39
  var m = typeof Symbol === "function" && o[Symbol.iterator];
51
40
  if (!m) return o;
@@ -71,11 +60,23 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
71
60
  }
72
61
  return to.concat(ar || Array.prototype.slice.call(from));
73
62
  };
63
+ var __values = (this && this.__values) || function(o) {
64
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
65
+ if (m) return m.call(o);
66
+ if (o && typeof o.length === "number") return {
67
+ next: function () {
68
+ if (o && i >= o.length) o = void 0;
69
+ return { value: o && o[i++], done: !o };
70
+ }
71
+ };
72
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
73
+ };
74
74
  Object.defineProperty(exports, "__esModule", { value: true });
75
75
  exports.createPermissionResolver = void 0;
76
76
  var access_1 = require("better-auth/plugins/access");
77
77
  var luxon_1 = require("luxon");
78
78
  var logger_1 = require("../logger");
79
+ var orgContext_1 = require("../orgs/orgContext");
79
80
  var permissionUtils_1 = require("./permissionUtils");
80
81
  var DEFAULT_CACHE_TTL_MS = 30000;
81
82
  var DEFAULT_MAX_CACHE_ENTRIES = 10000;
@@ -84,13 +85,40 @@ var getUserRoles = function (user) {
84
85
  var withRoles = user;
85
86
  return (_a = withRoles.roles) !== null && _a !== void 0 ? _a : [];
86
87
  };
88
+ /** Include org context and roles so tenant switches and Mongo promotions are not stuck behind TTL. */
89
+ var permissionCacheKey = function (user) {
90
+ var _a, _b, _c, _d, _e;
91
+ var ctx = (0, orgContext_1.getOrgContext)();
92
+ var organizationId = (_c = (_b = (_a = ctx === null || ctx === void 0 ? void 0 : ctx.organization) === null || _a === void 0 ? void 0 : _a._id) === null || _b === void 0 ? void 0 : _b.toString()) !== null && _c !== void 0 ? _c : "";
93
+ var membershipRole = (_e = (_d = ctx === null || ctx === void 0 ? void 0 : ctx.membership) === null || _d === void 0 ? void 0 : _d.roleName) !== null && _e !== void 0 ? _e : "";
94
+ var roles = __spreadArray([], __read(getUserRoles(user)), false).sort().join(",");
95
+ return "".concat(user.id, "::org=").concat(organizationId, "::role=").concat(membershipRole, "::roles=").concat(roles);
96
+ };
97
+ var deletePermissionCacheForUser = function (cache, userId) {
98
+ var e_1, _a;
99
+ try {
100
+ for (var _b = __values(__spreadArray([], __read(cache.keys()), false)), _c = _b.next(); !_c.done; _c = _b.next()) {
101
+ var key = _c.value;
102
+ if (key === userId || key.startsWith("".concat(userId, ":")) || key.startsWith("".concat(userId, "::"))) {
103
+ cache.delete(key);
104
+ }
105
+ }
106
+ }
107
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
108
+ finally {
109
+ try {
110
+ if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
111
+ }
112
+ finally { if (e_1) throw e_1.error; }
113
+ }
114
+ };
87
115
  var createPermissionResolver = function (args) {
88
116
  var statements = args.statements, rbacRoleModel = args.rbacRoleModel, _a = args.sources, sources = _a === void 0 ? [] : _a, _b = args.cacheTtlMs, cacheTtlMs = _b === void 0 ? DEFAULT_CACHE_TTL_MS : _b, _c = args.maxCacheEntries, maxCacheEntries = _c === void 0 ? DEFAULT_MAX_CACHE_ENTRIES : _c, resolvePermissions = args.resolvePermissions;
89
117
  var ac = (0, access_1.createAccessControl)(statements);
90
118
  var permissionCache = new Map();
91
119
  var sourceCache = new Map();
92
120
  var enforceCacheBound = function () {
93
- var e_1, _a;
121
+ var e_2, _a;
94
122
  var now = luxon_1.DateTime.now().toMillis();
95
123
  try {
96
124
  for (var permissionCache_1 = __values(permissionCache), permissionCache_1_1 = permissionCache_1.next(); !permissionCache_1_1.done; permissionCache_1_1 = permissionCache_1.next()) {
@@ -100,12 +128,12 @@ var createPermissionResolver = function (args) {
100
128
  }
101
129
  }
102
130
  }
103
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
131
+ catch (e_2_1) { e_2 = { error: e_2_1 }; }
104
132
  finally {
105
133
  try {
106
134
  if (permissionCache_1_1 && !permissionCache_1_1.done && (_a = permissionCache_1.return)) _a.call(permissionCache_1);
107
135
  }
108
- finally { if (e_1) throw e_1.error; }
136
+ finally { if (e_2) throw e_2.error; }
109
137
  }
110
138
  while (permissionCache.size > maxCacheEntries) {
111
139
  var oldestUserId = permissionCache.keys().next().value;
@@ -123,14 +151,14 @@ var createPermissionResolver = function (args) {
123
151
  sourceCache.delete(oldestUserId);
124
152
  }
125
153
  };
126
- var rememberPermissions = function (userId, entry) {
127
- permissionCache.delete(userId);
128
- permissionCache.set(userId, entry);
154
+ var rememberPermissions = function (cacheKey, entry) {
155
+ permissionCache.delete(cacheKey);
156
+ permissionCache.set(cacheKey, entry);
129
157
  enforceCacheBound();
130
158
  };
131
159
  var invalidateCache = function (invalidateArgs) {
132
160
  if (invalidateArgs === null || invalidateArgs === void 0 ? void 0 : invalidateArgs.userId) {
133
- permissionCache.delete(invalidateArgs.userId);
161
+ deletePermissionCacheForUser(permissionCache, invalidateArgs.userId);
134
162
  sourceCache.delete(invalidateArgs.userId);
135
163
  return;
136
164
  }
@@ -153,7 +181,7 @@ var createPermissionResolver = function (args) {
153
181
  });
154
182
  }); };
155
183
  var applyDenyGrants = function (permissions, deny) {
156
- var e_2, _a;
184
+ var e_3, _a;
157
185
  var _b;
158
186
  if (!deny) {
159
187
  return permissions;
@@ -172,12 +200,12 @@ var createPermissionResolver = function (args) {
172
200
  _loop_1(resource, actions);
173
201
  }
174
202
  }
175
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
203
+ catch (e_3_1) { e_3 = { error: e_3_1 }; }
176
204
  finally {
177
205
  try {
178
206
  if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
179
207
  }
180
- finally { if (e_2) throw e_2.error; }
208
+ finally { if (e_3) throw e_3.error; }
181
209
  }
182
210
  return result;
183
211
  };
@@ -267,16 +295,17 @@ var createPermissionResolver = function (args) {
267
295
  });
268
296
  };
269
297
  var resolveEffectivePermissions = function (user, shouldCache) { return __awaiter(void 0, void 0, void 0, function () {
270
- var cached, roleNames, permissionSets, sourceResults, sources_1, sources_1_1, source, grants, e_3_1, uniqueRoleNames, _a, _b, _c, _d, custom, permissions, sources_2, sources_2_1, source, grants;
271
- var e_3, _e, e_4, _f;
298
+ var cacheKey, cached, roleNames, permissionSets, sourceResults, sources_1, sources_1_1, source, grants, e_4_1, uniqueRoleNames, _a, _b, _c, _d, custom, permissions, sources_2, sources_2_1, source, grants;
299
+ var e_4, _e, e_5, _f;
272
300
  var _g;
273
301
  return __generator(this, function (_h) {
274
302
  switch (_h.label) {
275
303
  case 0:
304
+ cacheKey = permissionCacheKey(user);
276
305
  if (shouldCache) {
277
- cached = permissionCache.get(user.id);
306
+ cached = permissionCache.get(cacheKey);
278
307
  if (cached && cached.expiresAt > luxon_1.DateTime.now().toMillis()) {
279
- rememberPermissions(user.id, cached);
308
+ rememberPermissions(cacheKey, cached);
280
309
  return [2 /*return*/, cached.permissions];
281
310
  }
282
311
  }
@@ -310,14 +339,14 @@ var createPermissionResolver = function (args) {
310
339
  return [3 /*break*/, 2];
311
340
  case 5: return [3 /*break*/, 8];
312
341
  case 6:
313
- e_3_1 = _h.sent();
314
- e_3 = { error: e_3_1 };
342
+ e_4_1 = _h.sent();
343
+ e_4 = { error: e_4_1 };
315
344
  return [3 /*break*/, 8];
316
345
  case 7:
317
346
  try {
318
347
  if (sources_1_1 && !sources_1_1.done && (_e = sources_1.return)) _e.call(sources_1);
319
348
  }
320
- finally { if (e_3) throw e_3.error; }
349
+ finally { if (e_4) throw e_4.error; }
321
350
  return [7 /*endfinally*/];
322
351
  case 8:
323
352
  uniqueRoleNames = __spreadArray([], __read(new Set(roleNames)), false);
@@ -346,15 +375,15 @@ var createPermissionResolver = function (args) {
346
375
  }
347
376
  }
348
377
  }
349
- catch (e_4_1) { e_4 = { error: e_4_1 }; }
378
+ catch (e_5_1) { e_5 = { error: e_5_1 }; }
350
379
  finally {
351
380
  try {
352
381
  if (sources_2_1 && !sources_2_1.done && (_f = sources_2.return)) _f.call(sources_2);
353
382
  }
354
- finally { if (e_4) throw e_4.error; }
383
+ finally { if (e_5) throw e_5.error; }
355
384
  }
356
385
  if (shouldCache) {
357
- rememberPermissions(user.id, {
386
+ rememberPermissions(cacheKey, {
358
387
  expiresAt: luxon_1.DateTime.now().plus({ milliseconds: cacheTtlMs }).toMillis(),
359
388
  permissions: permissions,
360
389
  });
@@ -32,11 +32,8 @@ export type RbacRoleModel = Model<RbacRoleDocument> & {
32
32
  }) => Promise<void>;
33
33
  };
34
34
  export { READ_ONLY_ROLE_PERMISSIONS } from "./statements";
35
- /**
36
- * Insert missing default roles. Existing unsealed roles are left unchanged so admin
37
- * customizations survive process restarts. Sealed roles are refreshed from code.
38
- */
39
- export declare const upsertSeededRole: (model: RbacRoleModel, role: RoleDefinition, statements: Statements) => Promise<void>;
40
35
  export declare const expandRolePermissions: (spec: RolePermissionSpec, statements: Statements, readActions?: readonly string[]) => PermissionSet;
36
+ /** Locked platform role seeded only when `createAccess({organizations: true})`. */
37
+ export declare const organizationOperatorRole: RoleDefinition;
41
38
  export declare const terrenoDefaultRoles: RoleDefinition[];
42
39
  export declare const createRbacRoleModel: (connection: Connection) => RbacRoleModel;
@@ -61,7 +61,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
61
61
  return (mod && mod.__esModule) ? mod : { "default": mod };
62
62
  };
63
63
  Object.defineProperty(exports, "__esModule", { value: true });
64
- exports.createRbacRoleModel = exports.terrenoDefaultRoles = exports.expandRolePermissions = exports.upsertSeededRole = exports.READ_ONLY_ROLE_PERMISSIONS = void 0;
64
+ exports.createRbacRoleModel = exports.terrenoDefaultRoles = exports.organizationOperatorRole = exports.expandRolePermissions = exports.READ_ONLY_ROLE_PERMISSIONS = void 0;
65
65
  var mongoose_1 = __importDefault(require("mongoose"));
66
66
  var plugins_1 = require("../plugins");
67
67
  var statements_1 = require("./statements");
@@ -110,12 +110,22 @@ var upsertSeededRole = function (model, role, statements) { return __awaiter(voi
110
110
  }
111
111
  });
112
112
  }); };
113
- exports.upsertSeededRole = upsertSeededRole;
114
113
  var expandRolePermissions = function (spec, statements, readActions) {
115
114
  if (readActions === void 0) { readActions = statements_1.READ_ACTIONS; }
116
115
  return (0, statements_1.expandRolePermissions)(spec, statements, readActions);
117
116
  };
118
117
  exports.expandRolePermissions = expandRolePermissions;
118
+ /** Locked platform role seeded only when `createAccess({organizations: true})`. */
119
+ exports.organizationOperatorRole = {
120
+ displayName: "Operator",
121
+ isLocked: true,
122
+ name: "operator",
123
+ permissions: {
124
+ admin: ["access"],
125
+ organization: ["create", "list", "read", "update", "delete", "manageMembers", "disable"],
126
+ user: ["list", "read", "update"],
127
+ },
128
+ };
119
129
  exports.terrenoDefaultRoles = [
120
130
  {
121
131
  displayName: "Super Admin",
@@ -130,6 +140,10 @@ exports.terrenoDefaultRoles = [
130
140
  name: "admin",
131
141
  permissions: {
132
142
  admin: ["access"],
143
+ adminAnnouncement: ["read", "write", "writeOwned"],
144
+ adminAnnouncementAcknowledgement: ["read"],
145
+ adminAnnouncementClickEvent: ["read"],
146
+ adminAnnouncementImpression: ["read"],
133
147
  configuration: ["read", "update"],
134
148
  user: ["create", "list", "read", "update"],
135
149
  },
@@ -207,7 +221,7 @@ rbacRoleSchema.statics = __assign(__assign({}, rbacRoleSchema.statics), { seedDe
207
221
  case 2:
208
222
  if (!!terrenoDefaultRoles_1_1.done) return [3 /*break*/, 5];
209
223
  role = terrenoDefaultRoles_1_1.value;
210
- return [4 /*yield*/, (0, exports.upsertSeededRole)(this, role, statements)];
224
+ return [4 /*yield*/, upsertSeededRole(this, role, statements)];
211
225
  case 3:
212
226
  _g.sent();
213
227
  _g.label = 4;
@@ -235,7 +249,7 @@ rbacRoleSchema.statics = __assign(__assign({}, rbacRoleSchema.statics), { seedDe
235
249
  if (terrenoNames.has(role.name)) {
236
250
  return [3 /*break*/, 11];
237
251
  }
238
- return [4 /*yield*/, (0, exports.upsertSeededRole)(this, role, statements)];
252
+ return [4 /*yield*/, upsertSeededRole(this, role, statements)];
239
253
  case 10:
240
254
  _g.sent();
241
255
  _g.label = 11;
@@ -5,15 +5,24 @@ export declare const ADMIN_PAGE_ACTION: "access";
5
5
  export declare const ADMIN_PAGE_PERMISSION: {
6
6
  readonly admin: readonly ["access"];
7
7
  };
8
+ export declare const ORGANIZATION_ACTIONS: readonly ["create", "list", "read", "update", "delete", "manageMembers", "disable"];
8
9
  export declare const terrenoStatements: {
9
- readonly admin: readonly ["access", "runScripts", "viewBackgroundTasks"];
10
+ readonly admin: readonly ["access", "jobs", "runScripts", "viewBackgroundTasks"];
11
+ readonly adminAnnouncement: readonly ["read", "write", "writeOwned"];
12
+ readonly adminAnnouncementAcknowledgement: readonly ["read", "write", "writeOwned"];
13
+ readonly adminAnnouncementClickEvent: readonly ["read", "write", "writeOwned"];
14
+ readonly adminAnnouncementImpression: readonly ["read", "write", "writeOwned"];
10
15
  readonly adminConsentForm: readonly ["read", "write", "writeOwned"];
11
16
  readonly adminConsentResponse: readonly ["read", "write", "writeOwned"];
12
17
  readonly adminFeatureFlag: readonly ["read", "write", "writeOwned"];
18
+ readonly announcement: readonly ["create", "list", "read", "update", "delete"];
19
+ readonly announcementAcknowledgement: readonly ["list", "read"];
20
+ readonly announcementImpression: readonly ["list", "read"];
13
21
  readonly configuration: readonly ["read", "update"];
14
22
  readonly consentForm: readonly ["create", "list", "read", "update", "delete"];
15
23
  readonly consentResponse: readonly ["list", "read"];
16
24
  readonly featureFlag: readonly ["create", "list", "read", "update", "delete"];
25
+ readonly organization: readonly ["create", "list", "read", "update", "delete", "manageMembers", "disable"];
17
26
  readonly rbac: readonly ["read", "manageRoles", "assignRoles"];
18
27
  readonly user: readonly ["create", "list", "read", "update", "delete", "impersonate", "setPassword"];
19
28
  };
@@ -48,7 +48,7 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
48
48
  };
49
49
  var _a;
50
50
  Object.defineProperty(exports, "__esModule", { value: true });
51
- exports.expandRolePermissions = exports.mergeStatements = exports.READ_ONLY_ROLE_PERMISSIONS = exports.READ_ACTIONS = exports.terrenoStatements = exports.ADMIN_PAGE_PERMISSION = exports.ADMIN_PAGE_ACTION = exports.ADMIN_PAGE_RESOURCE = exports.ADMIN_MODEL_ACCESS = void 0;
51
+ exports.expandRolePermissions = exports.mergeStatements = exports.READ_ONLY_ROLE_PERMISSIONS = exports.READ_ACTIONS = exports.terrenoStatements = exports.ORGANIZATION_ACTIONS = exports.ADMIN_PAGE_PERMISSION = exports.ADMIN_PAGE_ACTION = exports.ADMIN_PAGE_RESOURCE = exports.ADMIN_MODEL_ACCESS = void 0;
52
52
  var MODEL_CRUD = ["create", "list", "read", "update", "delete"];
53
53
  exports.ADMIN_MODEL_ACCESS = ["read", "write", "writeOwned"];
54
54
  /** Resource/action that opens the admin panel. Other admin permissions do not grant entry. */
@@ -57,15 +57,32 @@ exports.ADMIN_PAGE_ACTION = "access";
57
57
  exports.ADMIN_PAGE_PERMISSION = (_a = {},
58
58
  _a[exports.ADMIN_PAGE_RESOURCE] = [exports.ADMIN_PAGE_ACTION],
59
59
  _a);
60
+ exports.ORGANIZATION_ACTIONS = [
61
+ "create",
62
+ "list",
63
+ "read",
64
+ "update",
65
+ "delete",
66
+ "manageMembers",
67
+ "disable",
68
+ ];
60
69
  exports.terrenoStatements = {
61
- admin: [exports.ADMIN_PAGE_ACTION, "runScripts", "viewBackgroundTasks"],
70
+ admin: [exports.ADMIN_PAGE_ACTION, "jobs", "runScripts", "viewBackgroundTasks"],
71
+ adminAnnouncement: exports.ADMIN_MODEL_ACCESS,
72
+ adminAnnouncementAcknowledgement: exports.ADMIN_MODEL_ACCESS,
73
+ adminAnnouncementClickEvent: exports.ADMIN_MODEL_ACCESS,
74
+ adminAnnouncementImpression: exports.ADMIN_MODEL_ACCESS,
62
75
  adminConsentForm: exports.ADMIN_MODEL_ACCESS,
63
76
  adminConsentResponse: exports.ADMIN_MODEL_ACCESS,
64
77
  adminFeatureFlag: exports.ADMIN_MODEL_ACCESS,
78
+ announcement: MODEL_CRUD,
79
+ announcementAcknowledgement: ["list", "read"],
80
+ announcementImpression: ["list", "read"],
65
81
  configuration: ["read", "update"],
66
82
  consentForm: MODEL_CRUD,
67
83
  consentResponse: ["list", "read"],
68
84
  featureFlag: MODEL_CRUD,
85
+ organization: exports.ORGANIZATION_ACTIONS,
69
86
  rbac: ["read", "manageRoles", "assignRoles"],
70
87
  user: ["create", "list", "read", "update", "delete", "impersonate", "setPassword"],
71
88
  };
@@ -150,6 +150,11 @@ export type RbacAuditSink = (record: RbacAuditWrite) => void | Promise<void>;
150
150
  export interface AccessOptions<S extends Statements> {
151
151
  connection: Connection;
152
152
  statements: S;
153
+ /**
154
+ * Opt in to organization RBAC: membership `org-admin` grants and the locked `operator` seed.
155
+ * Default `false` so existing single-tenant apps stay unchanged. New apps from bootstrap pass `true`.
156
+ */
157
+ organizations?: boolean;
153
158
  userModel?: UserModel;
154
159
  defaultRoles?: RoleDefinition[];
155
160
  scopes?: ResourceScopes<S>;
@@ -13,22 +13,20 @@ import type { ChangeStreamConfig, RealtimeEvent } from "./types";
13
13
  type WatchedChange = Extract<ChangeStreamDocument, {
14
14
  operationType: "insert" | "update" | "replace" | "delete";
15
15
  }>;
16
- /** First restart delay; doubles per consecutive attempt up to the max. */
17
- export declare const CHANGE_STREAM_RESTART_BASE_DELAY_MS = 250;
18
- /** Ceiling for the restart backoff — a long outage retries once every 30s, forever. */
19
- export declare const CHANGE_STREAM_RESTART_MAX_DELAY_MS = 30000;
20
16
  /**
21
17
  * Socket event telling clients their cached cursors may have gaps and they must
22
18
  * re-bootstrap. Emitted when the change stream's oplog history is gone
23
19
  * (`ChangeStreamHistoryLost`), which is the one failure a resume token cannot repair.
24
20
  * Payload: {@link SyncResyncHint}.
25
21
  */
22
+ /** @internal */
26
23
  export declare const SYNC_RESYNC_EVENT = "sync:resync-required";
27
24
  /**
28
25
  * C7: the sync bookkeeping collections must never drive fan-out — their own change
29
26
  * events are internal (counters/ledger/markers/keys), and processing them would emit
30
27
  * spurious deltas or reprocess scope-move markers. Exported for testing.
31
28
  */
29
+ /** @internal */
32
30
  export declare const DEFAULT_IGNORED_COLLECTIONS: string[];
33
31
  /**
34
32
  * Map MongoDB change stream operation types to our method names.
@@ -42,28 +40,33 @@ export declare const DEFAULT_IGNORED_COLLECTIONS: string[];
42
40
  *
43
41
  * Exported for testing.
44
42
  */
43
+ /** @internal */
45
44
  export declare const mapOperationType: (operationType: string, change: ChangeStreamDocument, enabledMethods?: ReadonlyArray<"create" | "update" | "delete">) => "create" | "update" | "delete" | null;
46
45
  /**
47
46
  * The minimal registry-entry shape the authorized-room emitters need. Both
48
47
  * `RealtimeRegistryEntry` and `SyncRegistryEntry` satisfy it structurally.
49
48
  */
50
49
  export interface AuthorizedEmitEntry {
50
+ collectionTag?: string;
51
51
  modelName: string;
52
52
  options: {
53
53
  permissions: {
54
54
  read: PermissionMethod<unknown>[];
55
55
  };
56
56
  };
57
+ routePath?: string;
57
58
  }
58
59
  /**
59
60
  * Determine which Socket.io rooms to emit to based on the room strategy.
60
61
  * Exported for testing.
61
62
  */
63
+ /** @internal */
62
64
  export declare const resolveRooms: (entry: RealtimeRegistryEntry, doc: Record<string, unknown>, method: string) => string[];
63
65
  /**
64
66
  * Ensure serialized documents include `id` to match REST API responses.
65
67
  * Change stream fullDocument payloads are raw BSON objects with `_id` only.
66
68
  */
69
+ /** @internal */
67
70
  export declare const ensureApiId: (data: unknown) => unknown;
68
71
  /**
69
72
  * Serialize a document for emission.
@@ -81,6 +84,7 @@ export declare const ensureApiId: (data: unknown) => unknown;
81
84
  * would risk leaking unsanitized fields (e.g. `hash`/`salt`) that the handler
82
85
  * was supposed to strip.
83
86
  */
87
+ /** @internal */
84
88
  export declare const serializeDoc: (entry: RealtimeRegistryEntry, doc: Record<string, unknown>, method: "create" | "update" | "delete", user?: User) => Promise<unknown>;
85
89
  /**
86
90
  * Generalized authorized-room emitter: iterates the sockets in `room`, runs the per-socket
@@ -100,6 +104,7 @@ export declare const emitPayloadToAuthorizedRoom: ({ io, room, eventName, entry,
100
104
  buildPayload: (user: User | undefined) => Promise<unknown> | unknown;
101
105
  logDebug: (msg: string) => void;
102
106
  }) => Promise<void>;
107
+ /** @internal */
103
108
  export declare const emitToAuthorizedRoom: (io: Server, room: string, event: RealtimeEvent, entry: RealtimeRegistryEntry, fullDocument: Record<string, unknown> | undefined, logDebug: (msg: string) => void) => Promise<void>;
104
109
  /**
105
110
  * Emit a sync event to document-specific and query rooms.
@@ -117,6 +122,7 @@ export declare const emitToAuthorizedRoom: (io: Server, room: string, event: Rea
117
122
  *
118
123
  * Exported for testing.
119
124
  */
125
+ /** @internal */
120
126
  export declare const emitToDocumentAndQueryRooms: (io: Server, collection: string, event: RealtimeEvent, fullDocument: Record<string, unknown> | undefined, logDebug: (msg: string) => void, entry?: RealtimeRegistryEntry) => Promise<void>;
121
127
  /**
122
128
  * Emit `sync:delta` events for a change on a sync-registered collection.