@terreno/api 57.0.0-beta.1 → 57.1.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 (175) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +8 -0
  2. package/dist/actions.d.ts +7 -2
  3. package/dist/actions.js +60 -25
  4. package/dist/adminModelRouter.d.ts +14 -0
  5. package/dist/adminModelRouter.js +199 -0
  6. package/dist/adminTypes.d.ts +156 -0
  7. package/dist/adminTypes.js +5 -0
  8. package/dist/api.d.ts +44 -3
  9. package/dist/api.js +74 -26
  10. package/dist/auth.d.ts +18 -1
  11. package/dist/auth.js +122 -20
  12. package/dist/consentApp.d.ts +2 -0
  13. package/dist/consentApp.js +98 -0
  14. package/dist/index.d.ts +22 -1
  15. package/dist/index.js +51 -7
  16. package/dist/mcp/auth.d.ts +11 -0
  17. package/dist/mcp/auth.js +133 -0
  18. package/dist/mcp/createMCPRequest.d.ts +16 -0
  19. package/dist/mcp/createMCPRequest.js +26 -0
  20. package/dist/mcp/handlers.d.ts +8 -0
  21. package/dist/mcp/handlers.js +793 -0
  22. package/dist/mcp/query.d.ts +32 -0
  23. package/dist/mcp/query.js +232 -0
  24. package/dist/mcp/registry.d.ts +21 -0
  25. package/dist/mcp/registry.js +54 -0
  26. package/dist/mcp/schemaGenerator.d.ts +14 -0
  27. package/dist/mcp/schemaGenerator.js +379 -0
  28. package/dist/mcp/server.d.ts +8 -0
  29. package/dist/mcp/server.js +133 -0
  30. package/dist/mcp/toolGenerator.d.ts +14 -0
  31. package/dist/mcp/toolGenerator.js +246 -0
  32. package/dist/mcp/types.d.ts +85 -0
  33. package/dist/mcp/types.js +2 -0
  34. package/dist/openApi.d.ts +1 -1
  35. package/dist/openApi.js +26 -8
  36. package/dist/permissions.js +15 -15
  37. package/dist/rbac/access.d.ts +3 -0
  38. package/dist/rbac/access.js +294 -0
  39. package/dist/rbac/auditModel.d.ts +31 -0
  40. package/dist/rbac/auditModel.js +112 -0
  41. package/dist/rbac/backfillAdmins.d.ts +18 -0
  42. package/dist/rbac/backfillAdmins.js +139 -0
  43. package/dist/rbac/fieldViews.d.ts +3 -0
  44. package/dist/rbac/fieldViews.js +201 -0
  45. package/dist/rbac/middleware.d.ts +21 -0
  46. package/dist/rbac/middleware.js +108 -0
  47. package/dist/rbac/modelRouterAccess.d.ts +42 -0
  48. package/dist/rbac/modelRouterAccess.js +388 -0
  49. package/dist/rbac/permissionUtils.d.ts +8 -0
  50. package/dist/rbac/permissionUtils.js +209 -0
  51. package/dist/rbac/realtimeAccess.d.ts +18 -0
  52. package/dist/rbac/realtimeAccess.js +173 -0
  53. package/dist/rbac/resolve.d.ts +28 -0
  54. package/dist/rbac/resolve.js +387 -0
  55. package/dist/rbac/roleManager.d.ts +20 -0
  56. package/dist/rbac/roleManager.js +741 -0
  57. package/dist/rbac/roleModel.d.ts +42 -0
  58. package/dist/rbac/roleModel.js +267 -0
  59. package/dist/rbac/routes.d.ts +9 -0
  60. package/dist/rbac/routes.js +211 -0
  61. package/dist/rbac/scopes.d.ts +15 -0
  62. package/dist/rbac/scopes.js +155 -0
  63. package/dist/rbac/statements.d.ts +20 -0
  64. package/dist/rbac/statements.js +115 -0
  65. package/dist/rbac/types.d.ts +202 -0
  66. package/dist/rbac/types.js +2 -0
  67. package/dist/rbac/userPlugin.d.ts +12 -0
  68. package/dist/rbac/userPlugin.js +41 -0
  69. package/dist/realtime/changeStreamWatcher.d.ts +1 -1
  70. package/dist/realtime/changeStreamWatcher.js +48 -39
  71. package/dist/realtime/realtimeApp.js +4 -8
  72. package/dist/realtime/registry.d.ts +5 -0
  73. package/dist/realtime/registry.js +13 -1
  74. package/dist/scrubAdminFields.d.ts +17 -0
  75. package/dist/scrubAdminFields.js +192 -0
  76. package/dist/sync/executors.d.ts +1 -1
  77. package/dist/sync/executors.js +63 -40
  78. package/dist/sync/loadHarness.js +4 -5
  79. package/dist/sync/registry.d.ts +5 -0
  80. package/dist/sync/registry.js +13 -1
  81. package/dist/sync/routes.js +41 -36
  82. package/dist/sync/serialize.js +5 -6
  83. package/dist/terrenoApp.d.ts +18 -0
  84. package/dist/terrenoApp.js +46 -3
  85. package/dist/terrenoPlugin.d.ts +8 -1
  86. package/dist/tests/createTestData.js +8 -0
  87. package/dist/tests/models.d.ts +1 -0
  88. package/dist/tests/models.js +5 -0
  89. package/dist/tests/testHelper.js +1 -2
  90. package/dist/transformers.js +16 -1
  91. package/package.json +16 -12
  92. package/src/__snapshots__/openApi.test.ts.snap +192 -0
  93. package/src/actions.test.ts +194 -1
  94. package/src/actions.ts +65 -8
  95. package/src/adminModelRouter.ts +154 -0
  96. package/src/adminTypes.ts +183 -0
  97. package/src/api.test.ts +66 -1
  98. package/src/api.ts +131 -12
  99. package/src/auth.test.ts +135 -1
  100. package/src/auth.ts +81 -3
  101. package/src/consentApp.test.ts +24 -0
  102. package/src/consentApp.ts +100 -0
  103. package/src/index.ts +56 -0
  104. package/src/mcp/auth.test.ts +197 -0
  105. package/src/mcp/auth.ts +100 -0
  106. package/src/mcp/createMCPRequest.test.ts +47 -0
  107. package/src/mcp/createMCPRequest.ts +32 -0
  108. package/src/mcp/customTools.test.ts +54 -0
  109. package/src/mcp/handlers.ts +639 -0
  110. package/src/mcp/integration.test.ts +1493 -0
  111. package/src/mcp/query.test.ts +172 -0
  112. package/src/mcp/query.ts +179 -0
  113. package/src/mcp/registry.ts +70 -0
  114. package/src/mcp/schemaGenerator.test.ts +182 -0
  115. package/src/mcp/schemaGenerator.ts +354 -0
  116. package/src/mcp/server.test.ts +226 -0
  117. package/src/mcp/server.ts +86 -0
  118. package/src/mcp/toolGenerator.test.ts +284 -0
  119. package/src/mcp/toolGenerator.ts +199 -0
  120. package/src/mcp/types.ts +95 -0
  121. package/src/openApi.test.ts +107 -0
  122. package/src/openApi.ts +32 -1
  123. package/src/permissions.ts +3 -2
  124. package/src/rbac/access.test.ts +357 -0
  125. package/src/rbac/access.ts +201 -0
  126. package/src/rbac/auditModel.ts +103 -0
  127. package/src/rbac/backfillAdmins.ts +54 -0
  128. package/src/rbac/fieldViews.test.ts +39 -0
  129. package/src/rbac/fieldViews.ts +122 -0
  130. package/src/rbac/middleware.ts +55 -0
  131. package/src/rbac/modelRouterAccess.test.ts +336 -0
  132. package/src/rbac/modelRouterAccess.ts +331 -0
  133. package/src/rbac/permissionUtils.test.ts +112 -0
  134. package/src/rbac/permissionUtils.ts +83 -0
  135. package/src/rbac/realtimeAccess.test.ts +242 -0
  136. package/src/rbac/realtimeAccess.ts +138 -0
  137. package/src/rbac/resolve.test.ts +358 -0
  138. package/src/rbac/resolve.ts +285 -0
  139. package/src/rbac/roleManager.test.ts +915 -0
  140. package/src/rbac/roleManager.ts +440 -0
  141. package/src/rbac/roleModel.test.ts +114 -0
  142. package/src/rbac/roleModel.ts +196 -0
  143. package/src/rbac/routes.ts +170 -0
  144. package/src/rbac/scopes.test.ts +105 -0
  145. package/src/rbac/scopes.ts +81 -0
  146. package/src/rbac/statements.test.ts +65 -0
  147. package/src/rbac/statements.ts +62 -0
  148. package/src/rbac/types.ts +198 -0
  149. package/src/rbac/userPlugin.test.ts +55 -0
  150. package/src/rbac/userPlugin.ts +25 -0
  151. package/src/realtime/changeStreamWatcher.ts +20 -15
  152. package/src/realtime/realtime.test.ts +25 -1
  153. package/src/realtime/realtimeApp.ts +2 -5
  154. package/src/realtime/registry.ts +15 -0
  155. package/src/scrubAdminFields.test.ts +113 -0
  156. package/src/scrubAdminFields.ts +158 -0
  157. package/src/sync/executors.ts +31 -1
  158. package/src/sync/loadHarness.ts +8 -7
  159. package/src/sync/models.test.ts +262 -0
  160. package/src/sync/registry.ts +15 -0
  161. package/src/sync/routes.ts +25 -11
  162. package/src/sync/scripts/compactTombstones.test.ts +4 -6
  163. package/src/sync/serialize.ts +17 -9
  164. package/src/sync/sync.test.ts +52 -0
  165. package/src/sync/syncRoutes.test.ts +5 -2
  166. package/src/sync/syncSocket.test.ts +28 -0
  167. package/src/terrenoApp.test.ts +100 -0
  168. package/src/terrenoApp.ts +65 -3
  169. package/src/terrenoPlugin.ts +10 -1
  170. package/src/tests/bunSetup.ts +2 -0
  171. package/src/tests/createTestData.ts +5 -1
  172. package/src/tests/models.ts +6 -0
  173. package/src/tests/testHelper.ts +1 -3
  174. package/src/transformers.test.ts +12 -0
  175. package/src/transformers.ts +7 -1
@@ -0,0 +1,440 @@
1
+ import type {User, UserModel} from "../auth";
2
+ import {APIError, isAPIError} from "../errors";
3
+ import {logger} from "../logger";
4
+ import {createRbacAuditModel, type RbacAuditWrite, recordRbacAudit} from "./auditModel";
5
+ import {
6
+ diffPermissionSets,
7
+ isPermissionSubset,
8
+ unionPermissionSets,
9
+ validatePermissionSet,
10
+ } from "./permissionUtils";
11
+ import {
12
+ createRbacRoleModel,
13
+ type RbacRoleDocument,
14
+ type RoleDefinition,
15
+ terrenoDefaultRoles,
16
+ } from "./roleModel";
17
+ import type {PermissionSet, Statements} from "./statements";
18
+ import type {RbacAuditSink, RoleManager} from "./types";
19
+
20
+ const assertCanManageRoles = async (
21
+ actor: User,
22
+ getActorPermissions: (user: User) => Promise<PermissionSet>
23
+ ): Promise<void> => {
24
+ const actorPermissions = await getActorPermissions(actor);
25
+ if (!actorPermissions.rbac?.includes("manageRoles")) {
26
+ throw new APIError({status: 403, title: "Missing rbac:manageRoles permission"});
27
+ }
28
+ };
29
+
30
+ const assertCanAssignRoles = async (
31
+ actor: User,
32
+ getActorPermissions: (user: User) => Promise<PermissionSet>
33
+ ): Promise<void> => {
34
+ const actorPermissions = await getActorPermissions(actor);
35
+ if (!actorPermissions.rbac?.includes("assignRoles")) {
36
+ throw new APIError({status: 403, title: "Missing rbac:assignRoles permission"});
37
+ }
38
+ };
39
+
40
+ const assertValidPermissionSet = (
41
+ permissions: PermissionSet,
42
+ statements: Parameters<typeof validatePermissionSet>[1]
43
+ ): void => {
44
+ try {
45
+ validatePermissionSet(permissions, statements);
46
+ } catch (error) {
47
+ const message = error instanceof Error ? error.message : "Invalid permissions";
48
+ throw new APIError({detail: message, status: 400, title: "Invalid permissions"});
49
+ }
50
+ };
51
+
52
+ const assertUserSaveAvailable = (targetUser: {save?: unknown}): void => {
53
+ if (typeof targetUser.save !== "function") {
54
+ throw new APIError({
55
+ status: 500,
56
+ title: "User model does not support saving role assignments",
57
+ });
58
+ }
59
+ };
60
+
61
+ const isEscalationDenial = (error: unknown): boolean => {
62
+ return (
63
+ isAPIError(error) &&
64
+ error.status === 403 &&
65
+ error.title === "Cannot grant permissions you do not hold"
66
+ );
67
+ };
68
+
69
+ const assertNoEscalation = async (
70
+ actor: User,
71
+ permissions: PermissionSet,
72
+ getActorPermissions: (user: User) => Promise<PermissionSet>
73
+ ): Promise<void> => {
74
+ const actorPermissions = await getActorPermissions(actor);
75
+ if (!isPermissionSubset(actorPermissions, permissions)) {
76
+ logger.warn("RBAC escalation attempt denied", {
77
+ actorId: actor.id,
78
+ requestedPermissions: permissions,
79
+ });
80
+ throw new APIError({
81
+ status: 403,
82
+ title: "Cannot grant permissions you do not hold",
83
+ });
84
+ }
85
+ };
86
+
87
+ const assertCanModifyTargetUser = async (
88
+ actor: User,
89
+ target: User,
90
+ getActorPermissions: (user: User) => Promise<PermissionSet>
91
+ ): Promise<void> => {
92
+ const actorPermissions = await getActorPermissions(actor);
93
+ const targetPermissions = await getActorPermissions(target);
94
+ if (!isPermissionSubset(actorPermissions, targetPermissions)) {
95
+ logger.warn("RBAC privileged-user mutation denied", {
96
+ actorId: actor.id,
97
+ targetId: target.id,
98
+ });
99
+ throw new APIError({
100
+ status: 403,
101
+ title: "Cannot modify a user with permissions you do not hold",
102
+ });
103
+ }
104
+ };
105
+
106
+ export const createRoleManager = (args: {
107
+ connection: Parameters<typeof createRbacRoleModel>[0];
108
+ statements: Statements;
109
+ defaultRoles?: RoleDefinition[];
110
+ getActorPermissions: (user: User) => Promise<PermissionSet>;
111
+ getPreviewPermissions: (user: User) => Promise<PermissionSet>;
112
+ invalidateCache: (invalidateArgs?: {userId?: string}) => void;
113
+ userModel?: UserModel;
114
+ persistAudit?: boolean;
115
+ auditSinks?: RbacAuditSink[];
116
+ }): {roleManager: RoleManager} => {
117
+ const {
118
+ connection,
119
+ statements,
120
+ defaultRoles = terrenoDefaultRoles,
121
+ getActorPermissions,
122
+ getPreviewPermissions,
123
+ invalidateCache,
124
+ userModel,
125
+ persistAudit = true,
126
+ auditSinks = [],
127
+ } = args;
128
+
129
+ const rbacRoleModel = createRbacRoleModel(connection);
130
+ const rbacAuditModel = persistAudit ? createRbacAuditModel(connection) : undefined;
131
+
132
+ const emitAudit = async (record: RbacAuditWrite): Promise<void> => {
133
+ try {
134
+ if (rbacAuditModel) {
135
+ await recordRbacAudit(rbacAuditModel, record);
136
+ }
137
+ for (const sink of auditSinks) {
138
+ await sink(record);
139
+ }
140
+ } catch (error) {
141
+ logger.error("Failed to write RbacAudit", {
142
+ action: record.action,
143
+ actorId: record.actorId,
144
+ error,
145
+ });
146
+ throw error;
147
+ }
148
+ };
149
+
150
+ const assertNoEscalationOrAudit = async (args: {
151
+ actor: User;
152
+ permissions: PermissionSet;
153
+ action: string;
154
+ targetRoleName?: string;
155
+ targetUserId?: string;
156
+ }): Promise<void> => {
157
+ try {
158
+ await assertNoEscalation(args.actor, args.permissions, getActorPermissions);
159
+ } catch (error) {
160
+ if (!isEscalationDenial(error)) {
161
+ throw error;
162
+ }
163
+ try {
164
+ await emitAudit({
165
+ action: args.action,
166
+ actorId: args.actor.id,
167
+ denied: true,
168
+ permissionDelta: {gained: args.permissions, lost: {}},
169
+ targetRoleName: args.targetRoleName,
170
+ targetUserId: args.targetUserId,
171
+ });
172
+ } catch (auditError) {
173
+ logger.error("Failed to write denied RbacAudit", {
174
+ action: args.action,
175
+ actorId: args.actor.id,
176
+ error: auditError,
177
+ });
178
+ }
179
+ throw error;
180
+ }
181
+ };
182
+
183
+ const seedDefaults = async (): Promise<void> => {
184
+ await rbacRoleModel.seedDefaults({extraRoles: defaultRoles, statements});
185
+ };
186
+
187
+ const roleManager: RoleManager = {
188
+ assertCanModifyUser: async ({actor, userId}) => {
189
+ if (!userModel) {
190
+ throw new APIError({status: 500, title: "User model not configured for role assignment"});
191
+ }
192
+ const targetUser = await userModel.findById(userId);
193
+ if (!targetUser) {
194
+ throw new APIError({status: 404, title: "User not found"});
195
+ }
196
+ await assertCanModifyTargetUser(actor, targetUser, getActorPermissions);
197
+ },
198
+ assign: async ({actor, userId, roleNames}) => {
199
+ await assertCanAssignRoles(actor, getActorPermissions);
200
+ if (!userModel) {
201
+ throw new APIError({status: 500, title: "User model not configured for role assignment"});
202
+ }
203
+
204
+ const targetUser = await userModel.findById(userId);
205
+ if (!targetUser) {
206
+ throw new APIError({status: 404, title: "User not found"});
207
+ }
208
+ await assertCanModifyTargetUser(actor, targetUser, getActorPermissions);
209
+ const uniqueRoleNames = [...new Set(roleNames)];
210
+ for (let i = 0; i < uniqueRoleNames.length; i++) {
211
+ for (let j = i + 1; j < uniqueRoleNames.length; j++) {
212
+ const roleA = await rbacRoleModel.findExactlyOne({name: uniqueRoleNames[i]});
213
+ const roleB = await rbacRoleModel.findExactlyOne({name: uniqueRoleNames[j]});
214
+ if (
215
+ roleA.excludesRoles.includes(roleB.name) ||
216
+ roleB.excludesRoles.includes(roleA.name)
217
+ ) {
218
+ throw new APIError({
219
+ status: 409,
220
+ title: `Role ${roleA.name} conflicts with ${roleB.name}`,
221
+ });
222
+ }
223
+ }
224
+ }
225
+
226
+ for (const roleName of uniqueRoleNames) {
227
+ const role = await rbacRoleModel.findExactlyOne({name: roleName});
228
+ const permissions = role.permissions ?? {};
229
+ await assertNoEscalationOrAudit({
230
+ action: "role.assign",
231
+ actor,
232
+ permissions,
233
+ targetUserId: userId,
234
+ });
235
+ }
236
+
237
+ assertUserSaveAvailable(targetUser);
238
+ const before = await getPreviewPermissions(targetUser);
239
+ const rbacUser = targetUser as unknown as User & {roles: string[]};
240
+ rbacUser.roles = uniqueRoleNames;
241
+ await targetUser.save();
242
+ invalidateCache({userId});
243
+ const after = await getPreviewPermissions(targetUser);
244
+ await emitAudit({
245
+ action: "role.assign",
246
+ actorId: actor.id,
247
+ permissionDelta: diffPermissionSets(before, after),
248
+ targetUserId: userId,
249
+ });
250
+ },
251
+ create: async ({actor, role}) => {
252
+ await assertCanManageRoles(actor, getActorPermissions);
253
+ assertValidPermissionSet(role.permissions, statements);
254
+ await assertNoEscalationOrAudit({
255
+ action: "role.create",
256
+ actor,
257
+ permissions: role.permissions,
258
+ targetRoleName: role.name,
259
+ });
260
+
261
+ const created = await rbacRoleModel.create({
262
+ ...role,
263
+ description: role.description ?? undefined,
264
+ excludesRoles: role.excludesRoles ?? [],
265
+ isLocked: role.isLocked ?? false,
266
+ isSealed: role.isSealed ?? false,
267
+ });
268
+ await emitAudit({
269
+ action: "role.create",
270
+ actorId: actor.id,
271
+ permissionDelta: {gained: created.permissions, lost: {}},
272
+ targetRoleName: created.name,
273
+ });
274
+ return created;
275
+ },
276
+ list: async () => rbacRoleModel.find({}).sort({name: 1}),
277
+ previewAssignment: async ({actor, userId, roleNames}) => {
278
+ await assertCanAssignRoles(actor, getActorPermissions);
279
+ if (!userModel) {
280
+ throw new APIError({status: 500, title: "User model not configured for role assignment"});
281
+ }
282
+
283
+ const targetUser = await userModel.findById(userId);
284
+ if (!targetUser) {
285
+ throw new APIError({status: 404, title: "User not found"});
286
+ }
287
+ await assertCanModifyTargetUser(actor, targetUser, getActorPermissions);
288
+ const uniqueRoleNames = [...new Set(roleNames)];
289
+ for (const roleName of uniqueRoleNames) {
290
+ const role = await rbacRoleModel.findExactlyOne({name: roleName});
291
+ await assertNoEscalation(actor, role.permissions ?? {}, getActorPermissions);
292
+ }
293
+
294
+ const before = await getPreviewPermissions(targetUser);
295
+ const previewUser = {
296
+ ...(typeof (targetUser as {toObject?: () => Record<string, unknown>}).toObject ===
297
+ "function"
298
+ ? (targetUser as {toObject: () => Record<string, unknown>}).toObject()
299
+ : targetUser),
300
+ id: targetUser.id,
301
+ roles: uniqueRoleNames,
302
+ } as unknown as User;
303
+ const after = await getPreviewPermissions(previewUser);
304
+ const diff = diffPermissionSets(before, after);
305
+ return {
306
+ ...diff,
307
+ resulting: after,
308
+ };
309
+ },
310
+ previewRoleChange: async ({roleName, permissions}) => {
311
+ const existing = await rbacRoleModel.findExactlyOne({name: roleName});
312
+ const diff = diffPermissionSets(existing.permissions, permissions);
313
+ const affectedUserCount = userModel ? await userModel.countDocuments({roles: roleName}) : 0;
314
+ return {
315
+ ...diff,
316
+ affectedUserCount,
317
+ };
318
+ },
319
+ remove: async ({actor, roleName}) => {
320
+ await assertCanManageRoles(actor, getActorPermissions);
321
+ const existing = await rbacRoleModel.findExactlyOne({name: roleName});
322
+ if (existing.isLocked) {
323
+ throw new APIError({status: 400, title: "Cannot delete a locked role"});
324
+ }
325
+ await assertNoEscalationOrAudit({
326
+ action: "role.remove",
327
+ actor,
328
+ permissions: existing.permissions ?? {},
329
+ targetRoleName: roleName,
330
+ });
331
+ await existing.deleteOne();
332
+ invalidateCache();
333
+ await emitAudit({
334
+ action: "role.remove",
335
+ actorId: actor.id,
336
+ permissionDelta: {gained: {}, lost: existing.permissions},
337
+ targetRoleName: roleName,
338
+ });
339
+ },
340
+ seedDefaults,
341
+ unassign: async ({actor, userId, roleNames}) => {
342
+ await assertCanAssignRoles(actor, getActorPermissions);
343
+ if (!userModel) {
344
+ throw new APIError({status: 500, title: "User model not configured for role assignment"});
345
+ }
346
+
347
+ const targetUser = await userModel.findById(userId);
348
+ if (!targetUser) {
349
+ throw new APIError({status: 404, title: "User not found"});
350
+ }
351
+ await assertCanModifyTargetUser(actor, targetUser, getActorPermissions);
352
+ assertUserSaveAvailable(targetUser);
353
+ const before = await getPreviewPermissions(targetUser);
354
+ const rbacUser = targetUser as unknown as User & {roles: string[]};
355
+ rbacUser.roles = rbacUser.roles.filter((role) => !roleNames.includes(role));
356
+ await targetUser.save();
357
+ invalidateCache({userId});
358
+ const after = await getPreviewPermissions(targetUser);
359
+ await emitAudit({
360
+ action: "role.unassign",
361
+ actorId: actor.id,
362
+ permissionDelta: diffPermissionSets(before, after),
363
+ targetUserId: userId,
364
+ });
365
+ },
366
+ update: async ({actor, roleName, changes}) => {
367
+ await assertCanManageRoles(actor, getActorPermissions);
368
+ const existing = await rbacRoleModel.findExactlyOne({name: roleName});
369
+ if (existing.isSealed) {
370
+ throw new APIError({status: 400, title: "Cannot modify a sealed role"});
371
+ }
372
+ if (existing.isLocked) {
373
+ const forbidden = Object.keys(changes).filter(
374
+ (key) =>
375
+ !["description", "displayName", "permissions", "excludesRoles", "name"].includes(key)
376
+ );
377
+ if (forbidden.length > 0) {
378
+ throw new APIError({
379
+ status: 400,
380
+ title: "Cannot change locked fields on a locked role",
381
+ });
382
+ }
383
+ }
384
+ if (changes.permissions) {
385
+ assertValidPermissionSet(changes.permissions, statements);
386
+ await assertNoEscalationOrAudit({
387
+ action: "role.update",
388
+ actor,
389
+ permissions: unionPermissionSets(existing.permissions ?? {}, changes.permissions),
390
+ targetRoleName: roleName,
391
+ });
392
+ }
393
+ if (changes.name && existing.isLocked) {
394
+ throw new APIError({status: 400, title: "Cannot rename a locked role"});
395
+ }
396
+ if (changes.excludesRoles && userModel) {
397
+ const holders = await userModel.find({roles: roleName});
398
+ const excluded = new Set(changes.excludesRoles);
399
+ const conflicts = holders.filter((holder) => {
400
+ const holderRoles = ((holder as unknown as {roles?: string[]}).roles ?? []).filter(
401
+ (role) => role !== roleName
402
+ );
403
+ return holderRoles.some((role) => excluded.has(role));
404
+ });
405
+ if (conflicts.length > 0) {
406
+ throw new APIError({
407
+ status: 400,
408
+ title: "excludesRoles conflicts with existing assignments",
409
+ });
410
+ }
411
+ }
412
+
413
+ const allowedChanges: Record<string, unknown> = {};
414
+ for (const key of ["description", "displayName", "permissions", "excludesRoles", "name"]) {
415
+ if (key in changes) {
416
+ const value = (changes as Record<string, unknown>)[key];
417
+ allowedChanges[key] = value === null ? undefined : value;
418
+ }
419
+ }
420
+ const beforePermissions = existing.permissions;
421
+ Object.assign(existing, allowedChanges);
422
+ if (changes.description === null) {
423
+ existing.set("description", undefined);
424
+ }
425
+ await existing.save();
426
+ invalidateCache();
427
+ await emitAudit({
428
+ action: "role.update",
429
+ actorId: actor.id,
430
+ permissionDelta: diffPermissionSets(beforePermissions, existing.permissions),
431
+ targetRoleName: existing.name,
432
+ });
433
+ return existing;
434
+ },
435
+ };
436
+
437
+ return {roleManager};
438
+ };
439
+
440
+ export type {RbacRoleDocument};
@@ -0,0 +1,114 @@
1
+ import {describe, expect, it} from "bun:test";
2
+ import mongoose from "mongoose";
3
+
4
+ import {setupDb} from "../tests";
5
+ import {createRbacAuditModel} from "./auditModel";
6
+ import {createRbacRoleModel, expandRolePermissions, terrenoDefaultRoles} from "./roleModel";
7
+ import {READ_ONLY_ROLE_PERMISSIONS, terrenoStatements} from "./statements";
8
+
9
+ describe("rbac role model", () => {
10
+ it("defines terreno default roles with expected names", () => {
11
+ const names = terrenoDefaultRoles.map((role) => role.name);
12
+
13
+ expect(names).toEqual(["superadmin", "admin", "auditor", "member"]);
14
+ });
15
+
16
+ it("seeds default roles with expanded permissions", async () => {
17
+ await setupDb();
18
+ const RbacRole = createRbacRoleModel(mongoose.connection);
19
+ await RbacRole.seedDefaults({statements: terrenoStatements});
20
+
21
+ const superadmin = await RbacRole.findExactlyOne({name: "superadmin"});
22
+ expect(superadmin.isSealed).toBe(true);
23
+ expect(superadmin.permissions.admin).toContain("access");
24
+ expect(superadmin.permissions.user).toContain("delete");
25
+ expect(superadmin.permissions.featureFlag).toContain("list");
26
+ expect(superadmin.permissions.consentForm).toContain("list");
27
+ expect(superadmin.permissions.consentResponse).toEqual(["list", "read"]);
28
+
29
+ const auditor = await RbacRole.findExactlyOne({name: "auditor"});
30
+ expect(auditor.permissions.user).toEqual(["list", "read"]);
31
+ expect(auditor.permissions.rbac).toEqual(["read"]);
32
+ });
33
+
34
+ it("upserts default roles without duplicating", async () => {
35
+ await setupDb();
36
+ const RbacRole = createRbacRoleModel(mongoose.connection);
37
+ await RbacRole.seedDefaults({statements: terrenoStatements});
38
+ await RbacRole.seedDefaults({statements: terrenoStatements});
39
+
40
+ const defaultRoleNames = terrenoDefaultRoles.map((role) => role.name);
41
+ const roles = await RbacRole.find({name: {$in: defaultRoleNames}});
42
+ expect(roles).toHaveLength(terrenoDefaultRoles.length);
43
+ });
44
+
45
+ it("does not overwrite customized unsealed roles on re-seed", async () => {
46
+ await setupDb();
47
+ const RbacRole = createRbacRoleModel(mongoose.connection);
48
+ await RbacRole.seedDefaults({statements: terrenoStatements});
49
+ await RbacRole.updateOne({name: "admin"}, {$set: {permissions: {user: ["read"]}}});
50
+ await RbacRole.seedDefaults({statements: terrenoStatements});
51
+
52
+ const admin = await RbacRole.findExactlyOne({name: "admin"});
53
+ expect(admin.permissions.user).toEqual(["read"]);
54
+ });
55
+
56
+ it("refreshes sealed default roles on re-seed", async () => {
57
+ await setupDb();
58
+ const RbacRole = createRbacRoleModel(mongoose.connection);
59
+ await RbacRole.seedDefaults({statements: terrenoStatements});
60
+ await RbacRole.updateOne({name: "superadmin"}, {$set: {permissions: {user: ["read"]}}});
61
+ await RbacRole.seedDefaults({statements: terrenoStatements});
62
+
63
+ const superadmin = await RbacRole.findExactlyOne({name: "superadmin"});
64
+ expect(superadmin.permissions.admin).toContain("access");
65
+ expect(superadmin.permissions.user).toContain("delete");
66
+ });
67
+
68
+ it("seeds extra roles through the same upsert as terreno defaults", async () => {
69
+ await setupDb();
70
+ const RbacRole = createRbacRoleModel(mongoose.connection);
71
+ await RbacRole.seedDefaults({
72
+ extraRoles: [
73
+ {
74
+ displayName: "App Editor",
75
+ name: "app-editor",
76
+ permissions: {user: ["read"]},
77
+ },
78
+ ],
79
+ statements: terrenoStatements,
80
+ });
81
+
82
+ const extra = await RbacRole.findExactlyOne({name: "app-editor"});
83
+ expect(extra.displayName).toBe("App Editor");
84
+ expect(extra.permissions.user).toEqual(["read"]);
85
+ });
86
+
87
+ it("registers models only on the connection passed to the factory", async () => {
88
+ await setupDb();
89
+ const uri = `mongodb://${mongoose.connection.host}:${mongoose.connection.port}/${mongoose.connection.name}`;
90
+ const isolated = await mongoose.createConnection(uri).asPromise();
91
+ try {
92
+ expect(isolated.models.RbacRole).toBeUndefined();
93
+ expect(isolated.models.RbacAudit).toBeUndefined();
94
+ createRbacRoleModel(isolated);
95
+ expect(isolated.models.RbacRole).toBeDefined();
96
+ expect(isolated.models.RbacAudit).toBeUndefined();
97
+ createRbacAuditModel(isolated);
98
+ expect(isolated.models.RbacAudit).toBeDefined();
99
+ } finally {
100
+ await isolated.close();
101
+ }
102
+ });
103
+
104
+ it("expands read-only sentinel at seed time", () => {
105
+ const auditor = terrenoDefaultRoles.find((role) => role.name === "auditor");
106
+ expect(auditor?.permissions).toBe(READ_ONLY_ROLE_PERMISSIONS);
107
+
108
+ const expanded = expandRolePermissions(
109
+ auditor?.permissions ?? READ_ONLY_ROLE_PERMISSIONS,
110
+ terrenoStatements
111
+ );
112
+ expect(expanded.configuration).toEqual(["read"]);
113
+ });
114
+ });