@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,741 @@
1
+ "use strict";
2
+ var __assign = (this && this.__assign) || function () {
3
+ __assign = Object.assign || function(t) {
4
+ for (var s, i = 1, n = arguments.length; i < n; i++) {
5
+ s = arguments[i];
6
+ for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
7
+ t[p] = s[p];
8
+ }
9
+ return t;
10
+ };
11
+ return __assign.apply(this, arguments);
12
+ };
13
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
14
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
15
+ return new (P || (P = Promise))(function (resolve, reject) {
16
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
17
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
18
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
19
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
20
+ });
21
+ };
22
+ var __generator = (this && this.__generator) || function (thisArg, body) {
23
+ 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);
24
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
+ function verb(n) { return function (v) { return step([n, v]); }; }
26
+ function step(op) {
27
+ if (f) throw new TypeError("Generator is already executing.");
28
+ while (g && (g = 0, op[0] && (_ = 0)), _) try {
29
+ 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;
30
+ if (y = 0, t) op = [op[0] & 2, t.value];
31
+ switch (op[0]) {
32
+ case 0: case 1: t = op; break;
33
+ case 4: _.label++; return { value: op[1], done: false };
34
+ case 5: _.label++; y = op[1]; op = [0]; continue;
35
+ case 7: op = _.ops.pop(); _.trys.pop(); continue;
36
+ default:
37
+ if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
38
+ if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
39
+ if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
40
+ if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
41
+ if (t[2]) _.ops.pop();
42
+ _.trys.pop(); continue;
43
+ }
44
+ op = body.call(thisArg, _);
45
+ } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
46
+ if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
47
+ }
48
+ };
49
+ var __values = (this && this.__values) || function(o) {
50
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
51
+ if (m) return m.call(o);
52
+ if (o && typeof o.length === "number") return {
53
+ next: function () {
54
+ if (o && i >= o.length) o = void 0;
55
+ return { value: o && o[i++], done: !o };
56
+ }
57
+ };
58
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
59
+ };
60
+ var __read = (this && this.__read) || function (o, n) {
61
+ var m = typeof Symbol === "function" && o[Symbol.iterator];
62
+ if (!m) return o;
63
+ var i = m.call(o), r, ar = [], e;
64
+ try {
65
+ while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
66
+ }
67
+ catch (error) { e = { error: error }; }
68
+ finally {
69
+ try {
70
+ if (r && !r.done && (m = i["return"])) m.call(i);
71
+ }
72
+ finally { if (e) throw e.error; }
73
+ }
74
+ return ar;
75
+ };
76
+ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
77
+ if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
78
+ if (ar || !(i in from)) {
79
+ if (!ar) ar = Array.prototype.slice.call(from, 0, i);
80
+ ar[i] = from[i];
81
+ }
82
+ }
83
+ return to.concat(ar || Array.prototype.slice.call(from));
84
+ };
85
+ Object.defineProperty(exports, "__esModule", { value: true });
86
+ exports.createRoleManager = void 0;
87
+ var errors_1 = require("../errors");
88
+ var logger_1 = require("../logger");
89
+ var auditModel_1 = require("./auditModel");
90
+ var permissionUtils_1 = require("./permissionUtils");
91
+ var roleModel_1 = require("./roleModel");
92
+ var assertCanManageRoles = function (actor, getActorPermissions) { return __awaiter(void 0, void 0, void 0, function () {
93
+ var actorPermissions;
94
+ var _a;
95
+ return __generator(this, function (_b) {
96
+ switch (_b.label) {
97
+ case 0: return [4 /*yield*/, getActorPermissions(actor)];
98
+ case 1:
99
+ actorPermissions = _b.sent();
100
+ if (!((_a = actorPermissions.rbac) === null || _a === void 0 ? void 0 : _a.includes("manageRoles"))) {
101
+ throw new errors_1.APIError({ status: 403, title: "Missing rbac:manageRoles permission" });
102
+ }
103
+ return [2 /*return*/];
104
+ }
105
+ });
106
+ }); };
107
+ var assertCanAssignRoles = function (actor, getActorPermissions) { return __awaiter(void 0, void 0, void 0, function () {
108
+ var actorPermissions;
109
+ var _a;
110
+ return __generator(this, function (_b) {
111
+ switch (_b.label) {
112
+ case 0: return [4 /*yield*/, getActorPermissions(actor)];
113
+ case 1:
114
+ actorPermissions = _b.sent();
115
+ if (!((_a = actorPermissions.rbac) === null || _a === void 0 ? void 0 : _a.includes("assignRoles"))) {
116
+ throw new errors_1.APIError({ status: 403, title: "Missing rbac:assignRoles permission" });
117
+ }
118
+ return [2 /*return*/];
119
+ }
120
+ });
121
+ }); };
122
+ var assertValidPermissionSet = function (permissions, statements) {
123
+ try {
124
+ (0, permissionUtils_1.validatePermissionSet)(permissions, statements);
125
+ }
126
+ catch (error) {
127
+ var message = error instanceof Error ? error.message : "Invalid permissions";
128
+ throw new errors_1.APIError({ detail: message, status: 400, title: "Invalid permissions" });
129
+ }
130
+ };
131
+ var assertUserSaveAvailable = function (targetUser) {
132
+ if (typeof targetUser.save !== "function") {
133
+ throw new errors_1.APIError({
134
+ status: 500,
135
+ title: "User model does not support saving role assignments",
136
+ });
137
+ }
138
+ };
139
+ var isEscalationDenial = function (error) {
140
+ return ((0, errors_1.isAPIError)(error) &&
141
+ error.status === 403 &&
142
+ error.title === "Cannot grant permissions you do not hold");
143
+ };
144
+ var assertNoEscalation = function (actor, permissions, getActorPermissions) { return __awaiter(void 0, void 0, void 0, function () {
145
+ var actorPermissions;
146
+ return __generator(this, function (_a) {
147
+ switch (_a.label) {
148
+ case 0: return [4 /*yield*/, getActorPermissions(actor)];
149
+ case 1:
150
+ actorPermissions = _a.sent();
151
+ if (!(0, permissionUtils_1.isPermissionSubset)(actorPermissions, permissions)) {
152
+ logger_1.logger.warn("RBAC escalation attempt denied", {
153
+ actorId: actor.id,
154
+ requestedPermissions: permissions,
155
+ });
156
+ throw new errors_1.APIError({
157
+ status: 403,
158
+ title: "Cannot grant permissions you do not hold",
159
+ });
160
+ }
161
+ return [2 /*return*/];
162
+ }
163
+ });
164
+ }); };
165
+ var assertCanModifyTargetUser = function (actor, target, getActorPermissions) { return __awaiter(void 0, void 0, void 0, function () {
166
+ var actorPermissions, targetPermissions;
167
+ return __generator(this, function (_a) {
168
+ switch (_a.label) {
169
+ case 0: return [4 /*yield*/, getActorPermissions(actor)];
170
+ case 1:
171
+ actorPermissions = _a.sent();
172
+ return [4 /*yield*/, getActorPermissions(target)];
173
+ case 2:
174
+ targetPermissions = _a.sent();
175
+ if (!(0, permissionUtils_1.isPermissionSubset)(actorPermissions, targetPermissions)) {
176
+ logger_1.logger.warn("RBAC privileged-user mutation denied", {
177
+ actorId: actor.id,
178
+ targetId: target.id,
179
+ });
180
+ throw new errors_1.APIError({
181
+ status: 403,
182
+ title: "Cannot modify a user with permissions you do not hold",
183
+ });
184
+ }
185
+ return [2 /*return*/];
186
+ }
187
+ });
188
+ }); };
189
+ var createRoleManager = function (args) {
190
+ var connection = args.connection, statements = args.statements, _a = args.defaultRoles, defaultRoles = _a === void 0 ? roleModel_1.terrenoDefaultRoles : _a, getActorPermissions = args.getActorPermissions, getPreviewPermissions = args.getPreviewPermissions, invalidateCache = args.invalidateCache, userModel = args.userModel, _b = args.persistAudit, persistAudit = _b === void 0 ? true : _b, _c = args.auditSinks, auditSinks = _c === void 0 ? [] : _c;
191
+ var rbacRoleModel = (0, roleModel_1.createRbacRoleModel)(connection);
192
+ var rbacAuditModel = persistAudit ? (0, auditModel_1.createRbacAuditModel)(connection) : undefined;
193
+ var emitAudit = function (record) { return __awaiter(void 0, void 0, void 0, function () {
194
+ var auditSinks_1, auditSinks_1_1, sink, e_1_1, error_1;
195
+ var e_1, _a;
196
+ return __generator(this, function (_b) {
197
+ switch (_b.label) {
198
+ case 0:
199
+ _b.trys.push([0, 10, , 11]);
200
+ if (!rbacAuditModel) return [3 /*break*/, 2];
201
+ return [4 /*yield*/, (0, auditModel_1.recordRbacAudit)(rbacAuditModel, record)];
202
+ case 1:
203
+ _b.sent();
204
+ _b.label = 2;
205
+ case 2:
206
+ _b.trys.push([2, 7, 8, 9]);
207
+ auditSinks_1 = __values(auditSinks), auditSinks_1_1 = auditSinks_1.next();
208
+ _b.label = 3;
209
+ case 3:
210
+ if (!!auditSinks_1_1.done) return [3 /*break*/, 6];
211
+ sink = auditSinks_1_1.value;
212
+ return [4 /*yield*/, sink(record)];
213
+ case 4:
214
+ _b.sent();
215
+ _b.label = 5;
216
+ case 5:
217
+ auditSinks_1_1 = auditSinks_1.next();
218
+ return [3 /*break*/, 3];
219
+ case 6: return [3 /*break*/, 9];
220
+ case 7:
221
+ e_1_1 = _b.sent();
222
+ e_1 = { error: e_1_1 };
223
+ return [3 /*break*/, 9];
224
+ case 8:
225
+ try {
226
+ if (auditSinks_1_1 && !auditSinks_1_1.done && (_a = auditSinks_1.return)) _a.call(auditSinks_1);
227
+ }
228
+ finally { if (e_1) throw e_1.error; }
229
+ return [7 /*endfinally*/];
230
+ case 9: return [3 /*break*/, 11];
231
+ case 10:
232
+ error_1 = _b.sent();
233
+ logger_1.logger.error("Failed to write RbacAudit", {
234
+ action: record.action,
235
+ actorId: record.actorId,
236
+ error: error_1,
237
+ });
238
+ throw error_1;
239
+ case 11: return [2 /*return*/];
240
+ }
241
+ });
242
+ }); };
243
+ var assertNoEscalationOrAudit = function (args) { return __awaiter(void 0, void 0, void 0, function () {
244
+ var error_2, auditError_1;
245
+ return __generator(this, function (_a) {
246
+ switch (_a.label) {
247
+ case 0:
248
+ _a.trys.push([0, 2, , 7]);
249
+ return [4 /*yield*/, assertNoEscalation(args.actor, args.permissions, getActorPermissions)];
250
+ case 1:
251
+ _a.sent();
252
+ return [3 /*break*/, 7];
253
+ case 2:
254
+ error_2 = _a.sent();
255
+ if (!isEscalationDenial(error_2)) {
256
+ throw error_2;
257
+ }
258
+ _a.label = 3;
259
+ case 3:
260
+ _a.trys.push([3, 5, , 6]);
261
+ return [4 /*yield*/, emitAudit({
262
+ action: args.action,
263
+ actorId: args.actor.id,
264
+ denied: true,
265
+ permissionDelta: { gained: args.permissions, lost: {} },
266
+ targetRoleName: args.targetRoleName,
267
+ targetUserId: args.targetUserId,
268
+ })];
269
+ case 4:
270
+ _a.sent();
271
+ return [3 /*break*/, 6];
272
+ case 5:
273
+ auditError_1 = _a.sent();
274
+ logger_1.logger.error("Failed to write denied RbacAudit", {
275
+ action: args.action,
276
+ actorId: args.actor.id,
277
+ error: auditError_1,
278
+ });
279
+ return [3 /*break*/, 6];
280
+ case 6: throw error_2;
281
+ case 7: return [2 /*return*/];
282
+ }
283
+ });
284
+ }); };
285
+ var seedDefaults = function () { return __awaiter(void 0, void 0, void 0, function () {
286
+ return __generator(this, function (_a) {
287
+ switch (_a.label) {
288
+ case 0: return [4 /*yield*/, rbacRoleModel.seedDefaults({ extraRoles: defaultRoles, statements: statements })];
289
+ case 1:
290
+ _a.sent();
291
+ return [2 /*return*/];
292
+ }
293
+ });
294
+ }); };
295
+ var roleManager = {
296
+ assertCanModifyUser: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
297
+ var targetUser;
298
+ var actor = _b.actor, userId = _b.userId;
299
+ return __generator(this, function (_c) {
300
+ switch (_c.label) {
301
+ case 0:
302
+ if (!userModel) {
303
+ throw new errors_1.APIError({ status: 500, title: "User model not configured for role assignment" });
304
+ }
305
+ return [4 /*yield*/, userModel.findById(userId)];
306
+ case 1:
307
+ targetUser = _c.sent();
308
+ if (!targetUser) {
309
+ throw new errors_1.APIError({ status: 404, title: "User not found" });
310
+ }
311
+ return [4 /*yield*/, assertCanModifyTargetUser(actor, targetUser, getActorPermissions)];
312
+ case 2:
313
+ _c.sent();
314
+ return [2 /*return*/];
315
+ }
316
+ });
317
+ }); },
318
+ assign: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
319
+ var targetUser, uniqueRoleNames, i, j, roleA, roleB, uniqueRoleNames_1, uniqueRoleNames_1_1, roleName, role, permissions, e_2_1, before, rbacUser, after;
320
+ var e_2, _c;
321
+ var _d;
322
+ var actor = _b.actor, userId = _b.userId, roleNames = _b.roleNames;
323
+ return __generator(this, function (_e) {
324
+ switch (_e.label) {
325
+ case 0: return [4 /*yield*/, assertCanAssignRoles(actor, getActorPermissions)];
326
+ case 1:
327
+ _e.sent();
328
+ if (!userModel) {
329
+ throw new errors_1.APIError({ status: 500, title: "User model not configured for role assignment" });
330
+ }
331
+ return [4 /*yield*/, userModel.findById(userId)];
332
+ case 2:
333
+ targetUser = _e.sent();
334
+ if (!targetUser) {
335
+ throw new errors_1.APIError({ status: 404, title: "User not found" });
336
+ }
337
+ return [4 /*yield*/, assertCanModifyTargetUser(actor, targetUser, getActorPermissions)];
338
+ case 3:
339
+ _e.sent();
340
+ uniqueRoleNames = __spreadArray([], __read(new Set(roleNames)), false);
341
+ i = 0;
342
+ _e.label = 4;
343
+ case 4:
344
+ if (!(i < uniqueRoleNames.length)) return [3 /*break*/, 10];
345
+ j = i + 1;
346
+ _e.label = 5;
347
+ case 5:
348
+ if (!(j < uniqueRoleNames.length)) return [3 /*break*/, 9];
349
+ return [4 /*yield*/, rbacRoleModel.findExactlyOne({ name: uniqueRoleNames[i] })];
350
+ case 6:
351
+ roleA = _e.sent();
352
+ return [4 /*yield*/, rbacRoleModel.findExactlyOne({ name: uniqueRoleNames[j] })];
353
+ case 7:
354
+ roleB = _e.sent();
355
+ if (roleA.excludesRoles.includes(roleB.name) ||
356
+ roleB.excludesRoles.includes(roleA.name)) {
357
+ throw new errors_1.APIError({
358
+ status: 409,
359
+ title: "Role ".concat(roleA.name, " conflicts with ").concat(roleB.name),
360
+ });
361
+ }
362
+ _e.label = 8;
363
+ case 8:
364
+ j++;
365
+ return [3 /*break*/, 5];
366
+ case 9:
367
+ i++;
368
+ return [3 /*break*/, 4];
369
+ case 10:
370
+ _e.trys.push([10, 16, 17, 18]);
371
+ uniqueRoleNames_1 = __values(uniqueRoleNames), uniqueRoleNames_1_1 = uniqueRoleNames_1.next();
372
+ _e.label = 11;
373
+ case 11:
374
+ if (!!uniqueRoleNames_1_1.done) return [3 /*break*/, 15];
375
+ roleName = uniqueRoleNames_1_1.value;
376
+ return [4 /*yield*/, rbacRoleModel.findExactlyOne({ name: roleName })];
377
+ case 12:
378
+ role = _e.sent();
379
+ permissions = (_d = role.permissions) !== null && _d !== void 0 ? _d : {};
380
+ return [4 /*yield*/, assertNoEscalationOrAudit({
381
+ action: "role.assign",
382
+ actor: actor,
383
+ permissions: permissions,
384
+ targetUserId: userId,
385
+ })];
386
+ case 13:
387
+ _e.sent();
388
+ _e.label = 14;
389
+ case 14:
390
+ uniqueRoleNames_1_1 = uniqueRoleNames_1.next();
391
+ return [3 /*break*/, 11];
392
+ case 15: return [3 /*break*/, 18];
393
+ case 16:
394
+ e_2_1 = _e.sent();
395
+ e_2 = { error: e_2_1 };
396
+ return [3 /*break*/, 18];
397
+ case 17:
398
+ try {
399
+ if (uniqueRoleNames_1_1 && !uniqueRoleNames_1_1.done && (_c = uniqueRoleNames_1.return)) _c.call(uniqueRoleNames_1);
400
+ }
401
+ finally { if (e_2) throw e_2.error; }
402
+ return [7 /*endfinally*/];
403
+ case 18:
404
+ assertUserSaveAvailable(targetUser);
405
+ return [4 /*yield*/, getPreviewPermissions(targetUser)];
406
+ case 19:
407
+ before = _e.sent();
408
+ rbacUser = targetUser;
409
+ rbacUser.roles = uniqueRoleNames;
410
+ return [4 /*yield*/, targetUser.save()];
411
+ case 20:
412
+ _e.sent();
413
+ invalidateCache({ userId: userId });
414
+ return [4 /*yield*/, getPreviewPermissions(targetUser)];
415
+ case 21:
416
+ after = _e.sent();
417
+ return [4 /*yield*/, emitAudit({
418
+ action: "role.assign",
419
+ actorId: actor.id,
420
+ permissionDelta: (0, permissionUtils_1.diffPermissionSets)(before, after),
421
+ targetUserId: userId,
422
+ })];
423
+ case 22:
424
+ _e.sent();
425
+ return [2 /*return*/];
426
+ }
427
+ });
428
+ }); },
429
+ create: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
430
+ var created;
431
+ var _c, _d, _e, _f;
432
+ var actor = _b.actor, role = _b.role;
433
+ return __generator(this, function (_g) {
434
+ switch (_g.label) {
435
+ case 0: return [4 /*yield*/, assertCanManageRoles(actor, getActorPermissions)];
436
+ case 1:
437
+ _g.sent();
438
+ assertValidPermissionSet(role.permissions, statements);
439
+ return [4 /*yield*/, assertNoEscalationOrAudit({
440
+ action: "role.create",
441
+ actor: actor,
442
+ permissions: role.permissions,
443
+ targetRoleName: role.name,
444
+ })];
445
+ case 2:
446
+ _g.sent();
447
+ return [4 /*yield*/, rbacRoleModel.create(__assign(__assign({}, role), { description: (_c = role.description) !== null && _c !== void 0 ? _c : undefined, excludesRoles: (_d = role.excludesRoles) !== null && _d !== void 0 ? _d : [], isLocked: (_e = role.isLocked) !== null && _e !== void 0 ? _e : false, isSealed: (_f = role.isSealed) !== null && _f !== void 0 ? _f : false }))];
448
+ case 3:
449
+ created = _g.sent();
450
+ return [4 /*yield*/, emitAudit({
451
+ action: "role.create",
452
+ actorId: actor.id,
453
+ permissionDelta: { gained: created.permissions, lost: {} },
454
+ targetRoleName: created.name,
455
+ })];
456
+ case 4:
457
+ _g.sent();
458
+ return [2 /*return*/, created];
459
+ }
460
+ });
461
+ }); },
462
+ list: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
463
+ return [2 /*return*/, rbacRoleModel.find({}).sort({ name: 1 })];
464
+ }); }); },
465
+ previewAssignment: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
466
+ var targetUser, uniqueRoleNames, uniqueRoleNames_2, uniqueRoleNames_2_1, roleName, role, e_3_1, before, previewUser, after, diff;
467
+ var e_3, _c;
468
+ var _d;
469
+ var actor = _b.actor, userId = _b.userId, roleNames = _b.roleNames;
470
+ return __generator(this, function (_e) {
471
+ switch (_e.label) {
472
+ case 0: return [4 /*yield*/, assertCanAssignRoles(actor, getActorPermissions)];
473
+ case 1:
474
+ _e.sent();
475
+ if (!userModel) {
476
+ throw new errors_1.APIError({ status: 500, title: "User model not configured for role assignment" });
477
+ }
478
+ return [4 /*yield*/, userModel.findById(userId)];
479
+ case 2:
480
+ targetUser = _e.sent();
481
+ if (!targetUser) {
482
+ throw new errors_1.APIError({ status: 404, title: "User not found" });
483
+ }
484
+ return [4 /*yield*/, assertCanModifyTargetUser(actor, targetUser, getActorPermissions)];
485
+ case 3:
486
+ _e.sent();
487
+ uniqueRoleNames = __spreadArray([], __read(new Set(roleNames)), false);
488
+ _e.label = 4;
489
+ case 4:
490
+ _e.trys.push([4, 10, 11, 12]);
491
+ uniqueRoleNames_2 = __values(uniqueRoleNames), uniqueRoleNames_2_1 = uniqueRoleNames_2.next();
492
+ _e.label = 5;
493
+ case 5:
494
+ if (!!uniqueRoleNames_2_1.done) return [3 /*break*/, 9];
495
+ roleName = uniqueRoleNames_2_1.value;
496
+ return [4 /*yield*/, rbacRoleModel.findExactlyOne({ name: roleName })];
497
+ case 6:
498
+ role = _e.sent();
499
+ return [4 /*yield*/, assertNoEscalation(actor, (_d = role.permissions) !== null && _d !== void 0 ? _d : {}, getActorPermissions)];
500
+ case 7:
501
+ _e.sent();
502
+ _e.label = 8;
503
+ case 8:
504
+ uniqueRoleNames_2_1 = uniqueRoleNames_2.next();
505
+ return [3 /*break*/, 5];
506
+ case 9: return [3 /*break*/, 12];
507
+ case 10:
508
+ e_3_1 = _e.sent();
509
+ e_3 = { error: e_3_1 };
510
+ return [3 /*break*/, 12];
511
+ case 11:
512
+ try {
513
+ if (uniqueRoleNames_2_1 && !uniqueRoleNames_2_1.done && (_c = uniqueRoleNames_2.return)) _c.call(uniqueRoleNames_2);
514
+ }
515
+ finally { if (e_3) throw e_3.error; }
516
+ return [7 /*endfinally*/];
517
+ case 12: return [4 /*yield*/, getPreviewPermissions(targetUser)];
518
+ case 13:
519
+ before = _e.sent();
520
+ previewUser = __assign(__assign({}, (typeof targetUser.toObject ===
521
+ "function"
522
+ ? targetUser.toObject()
523
+ : targetUser)), { id: targetUser.id, roles: uniqueRoleNames });
524
+ return [4 /*yield*/, getPreviewPermissions(previewUser)];
525
+ case 14:
526
+ after = _e.sent();
527
+ diff = (0, permissionUtils_1.diffPermissionSets)(before, after);
528
+ return [2 /*return*/, __assign(__assign({}, diff), { resulting: after })];
529
+ }
530
+ });
531
+ }); },
532
+ previewRoleChange: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
533
+ var existing, diff, affectedUserCount, _c;
534
+ var roleName = _b.roleName, permissions = _b.permissions;
535
+ return __generator(this, function (_d) {
536
+ switch (_d.label) {
537
+ case 0: return [4 /*yield*/, rbacRoleModel.findExactlyOne({ name: roleName })];
538
+ case 1:
539
+ existing = _d.sent();
540
+ diff = (0, permissionUtils_1.diffPermissionSets)(existing.permissions, permissions);
541
+ if (!userModel) return [3 /*break*/, 3];
542
+ return [4 /*yield*/, userModel.countDocuments({ roles: roleName })];
543
+ case 2:
544
+ _c = _d.sent();
545
+ return [3 /*break*/, 4];
546
+ case 3:
547
+ _c = 0;
548
+ _d.label = 4;
549
+ case 4:
550
+ affectedUserCount = _c;
551
+ return [2 /*return*/, __assign(__assign({}, diff), { affectedUserCount: affectedUserCount })];
552
+ }
553
+ });
554
+ }); },
555
+ remove: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
556
+ var existing;
557
+ var _c;
558
+ var actor = _b.actor, roleName = _b.roleName;
559
+ return __generator(this, function (_d) {
560
+ switch (_d.label) {
561
+ case 0: return [4 /*yield*/, assertCanManageRoles(actor, getActorPermissions)];
562
+ case 1:
563
+ _d.sent();
564
+ return [4 /*yield*/, rbacRoleModel.findExactlyOne({ name: roleName })];
565
+ case 2:
566
+ existing = _d.sent();
567
+ if (existing.isLocked) {
568
+ throw new errors_1.APIError({ status: 400, title: "Cannot delete a locked role" });
569
+ }
570
+ return [4 /*yield*/, assertNoEscalationOrAudit({
571
+ action: "role.remove",
572
+ actor: actor,
573
+ permissions: (_c = existing.permissions) !== null && _c !== void 0 ? _c : {},
574
+ targetRoleName: roleName,
575
+ })];
576
+ case 3:
577
+ _d.sent();
578
+ return [4 /*yield*/, existing.deleteOne()];
579
+ case 4:
580
+ _d.sent();
581
+ invalidateCache();
582
+ return [4 /*yield*/, emitAudit({
583
+ action: "role.remove",
584
+ actorId: actor.id,
585
+ permissionDelta: { gained: {}, lost: existing.permissions },
586
+ targetRoleName: roleName,
587
+ })];
588
+ case 5:
589
+ _d.sent();
590
+ return [2 /*return*/];
591
+ }
592
+ });
593
+ }); },
594
+ seedDefaults: seedDefaults,
595
+ unassign: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
596
+ var targetUser, before, rbacUser, after;
597
+ var actor = _b.actor, userId = _b.userId, roleNames = _b.roleNames;
598
+ return __generator(this, function (_c) {
599
+ switch (_c.label) {
600
+ case 0: return [4 /*yield*/, assertCanAssignRoles(actor, getActorPermissions)];
601
+ case 1:
602
+ _c.sent();
603
+ if (!userModel) {
604
+ throw new errors_1.APIError({ status: 500, title: "User model not configured for role assignment" });
605
+ }
606
+ return [4 /*yield*/, userModel.findById(userId)];
607
+ case 2:
608
+ targetUser = _c.sent();
609
+ if (!targetUser) {
610
+ throw new errors_1.APIError({ status: 404, title: "User not found" });
611
+ }
612
+ return [4 /*yield*/, assertCanModifyTargetUser(actor, targetUser, getActorPermissions)];
613
+ case 3:
614
+ _c.sent();
615
+ assertUserSaveAvailable(targetUser);
616
+ return [4 /*yield*/, getPreviewPermissions(targetUser)];
617
+ case 4:
618
+ before = _c.sent();
619
+ rbacUser = targetUser;
620
+ rbacUser.roles = rbacUser.roles.filter(function (role) { return !roleNames.includes(role); });
621
+ return [4 /*yield*/, targetUser.save()];
622
+ case 5:
623
+ _c.sent();
624
+ invalidateCache({ userId: userId });
625
+ return [4 /*yield*/, getPreviewPermissions(targetUser)];
626
+ case 6:
627
+ after = _c.sent();
628
+ return [4 /*yield*/, emitAudit({
629
+ action: "role.unassign",
630
+ actorId: actor.id,
631
+ permissionDelta: (0, permissionUtils_1.diffPermissionSets)(before, after),
632
+ targetUserId: userId,
633
+ })];
634
+ case 7:
635
+ _c.sent();
636
+ return [2 /*return*/];
637
+ }
638
+ });
639
+ }); },
640
+ update: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
641
+ var existing, forbidden, holders, excluded_1, conflicts, allowedChanges, _c, _d, key, value, beforePermissions;
642
+ var e_4, _e;
643
+ var _f;
644
+ var actor = _b.actor, roleName = _b.roleName, changes = _b.changes;
645
+ return __generator(this, function (_g) {
646
+ switch (_g.label) {
647
+ case 0: return [4 /*yield*/, assertCanManageRoles(actor, getActorPermissions)];
648
+ case 1:
649
+ _g.sent();
650
+ return [4 /*yield*/, rbacRoleModel.findExactlyOne({ name: roleName })];
651
+ case 2:
652
+ existing = _g.sent();
653
+ if (existing.isSealed) {
654
+ throw new errors_1.APIError({ status: 400, title: "Cannot modify a sealed role" });
655
+ }
656
+ if (existing.isLocked) {
657
+ forbidden = Object.keys(changes).filter(function (key) {
658
+ return !["description", "displayName", "permissions", "excludesRoles", "name"].includes(key);
659
+ });
660
+ if (forbidden.length > 0) {
661
+ throw new errors_1.APIError({
662
+ status: 400,
663
+ title: "Cannot change locked fields on a locked role",
664
+ });
665
+ }
666
+ }
667
+ if (!changes.permissions) return [3 /*break*/, 4];
668
+ assertValidPermissionSet(changes.permissions, statements);
669
+ return [4 /*yield*/, assertNoEscalationOrAudit({
670
+ action: "role.update",
671
+ actor: actor,
672
+ permissions: (0, permissionUtils_1.unionPermissionSets)((_f = existing.permissions) !== null && _f !== void 0 ? _f : {}, changes.permissions),
673
+ targetRoleName: roleName,
674
+ })];
675
+ case 3:
676
+ _g.sent();
677
+ _g.label = 4;
678
+ case 4:
679
+ if (changes.name && existing.isLocked) {
680
+ throw new errors_1.APIError({ status: 400, title: "Cannot rename a locked role" });
681
+ }
682
+ if (!(changes.excludesRoles && userModel)) return [3 /*break*/, 6];
683
+ return [4 /*yield*/, userModel.find({ roles: roleName })];
684
+ case 5:
685
+ holders = _g.sent();
686
+ excluded_1 = new Set(changes.excludesRoles);
687
+ conflicts = holders.filter(function (holder) {
688
+ var _a;
689
+ var holderRoles = ((_a = holder.roles) !== null && _a !== void 0 ? _a : []).filter(function (role) { return role !== roleName; });
690
+ return holderRoles.some(function (role) { return excluded_1.has(role); });
691
+ });
692
+ if (conflicts.length > 0) {
693
+ throw new errors_1.APIError({
694
+ status: 400,
695
+ title: "excludesRoles conflicts with existing assignments",
696
+ });
697
+ }
698
+ _g.label = 6;
699
+ case 6:
700
+ allowedChanges = {};
701
+ try {
702
+ for (_c = __values(["description", "displayName", "permissions", "excludesRoles", "name"]), _d = _c.next(); !_d.done; _d = _c.next()) {
703
+ key = _d.value;
704
+ if (key in changes) {
705
+ value = changes[key];
706
+ allowedChanges[key] = value === null ? undefined : value;
707
+ }
708
+ }
709
+ }
710
+ catch (e_4_1) { e_4 = { error: e_4_1 }; }
711
+ finally {
712
+ try {
713
+ if (_d && !_d.done && (_e = _c.return)) _e.call(_c);
714
+ }
715
+ finally { if (e_4) throw e_4.error; }
716
+ }
717
+ beforePermissions = existing.permissions;
718
+ Object.assign(existing, allowedChanges);
719
+ if (changes.description === null) {
720
+ existing.set("description", undefined);
721
+ }
722
+ return [4 /*yield*/, existing.save()];
723
+ case 7:
724
+ _g.sent();
725
+ invalidateCache();
726
+ return [4 /*yield*/, emitAudit({
727
+ action: "role.update",
728
+ actorId: actor.id,
729
+ permissionDelta: (0, permissionUtils_1.diffPermissionSets)(beforePermissions, existing.permissions),
730
+ targetRoleName: existing.name,
731
+ })];
732
+ case 8:
733
+ _g.sent();
734
+ return [2 /*return*/, existing];
735
+ }
736
+ });
737
+ }); },
738
+ };
739
+ return { roleManager: roleManager };
740
+ };
741
+ exports.createRoleManager = createRoleManager;