@terreno/api 57.0.0 → 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,294 @@
1
+ "use strict";
2
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
+ return new (P || (P = Promise))(function (resolve, reject) {
5
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
9
+ });
10
+ };
11
+ var __generator = (this && this.__generator) || function (thisArg, body) {
12
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
+ function verb(n) { return function (v) { return step([n, v]); }; }
15
+ function step(op) {
16
+ if (f) throw new TypeError("Generator is already executing.");
17
+ while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
+ if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
+ if (y = 0, t) op = [op[0] & 2, t.value];
20
+ switch (op[0]) {
21
+ case 0: case 1: t = op; break;
22
+ case 4: _.label++; return { value: op[1], done: false };
23
+ case 5: _.label++; y = op[1]; op = [0]; continue;
24
+ case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
+ default:
26
+ if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
+ if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
+ if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
+ if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
+ if (t[2]) _.ops.pop();
31
+ _.trys.pop(); continue;
32
+ }
33
+ op = body.call(thisArg, _);
34
+ } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
+ if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
+ }
37
+ };
38
+ var __values = (this && this.__values) || function(o) {
39
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
40
+ if (m) return m.call(o);
41
+ if (o && typeof o.length === "number") return {
42
+ next: function () {
43
+ if (o && i >= o.length) o = void 0;
44
+ return { value: o && o[i++], done: !o };
45
+ }
46
+ };
47
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
48
+ };
49
+ var __read = (this && this.__read) || function (o, n) {
50
+ var m = typeof Symbol === "function" && o[Symbol.iterator];
51
+ if (!m) return o;
52
+ var i = m.call(o), r, ar = [], e;
53
+ try {
54
+ while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
55
+ }
56
+ catch (error) { e = { error: error }; }
57
+ finally {
58
+ try {
59
+ if (r && !r.done && (m = i["return"])) m.call(i);
60
+ }
61
+ finally { if (e) throw e.error; }
62
+ }
63
+ return ar;
64
+ };
65
+ Object.defineProperty(exports, "__esModule", { value: true });
66
+ exports.createAccess = void 0;
67
+ var auditModel_1 = require("./auditModel");
68
+ var middleware_1 = require("./middleware");
69
+ var resolve_1 = require("./resolve");
70
+ var roleManager_1 = require("./roleManager");
71
+ var roleModel_1 = require("./roleModel");
72
+ var statements_1 = require("./statements");
73
+ var FULL_FIELD_MASK = {
74
+ omit: [],
75
+ read: "*",
76
+ write: "*",
77
+ };
78
+ var EMPTY_FIELD_MASK = {
79
+ omit: [],
80
+ read: [],
81
+ write: [],
82
+ };
83
+ var createAccess = function (options) {
84
+ var persistAudit = options.persistAudit !== false;
85
+ var auditSinks = (0, auditModel_1.normalizeRbacAuditSinks)(options.auditSink);
86
+ if (!persistAudit && auditSinks.length === 0) {
87
+ throw new Error("RBAC audit requires persistAudit or at least one auditSink");
88
+ }
89
+ var mergedStatements = (0, statements_1.mergeStatements)(options.statements);
90
+ var rbacRoleModel = (0, roleModel_1.createRbacRoleModel)(options.connection);
91
+ var resolver = (0, resolve_1.createPermissionResolver)({
92
+ cacheTtlMs: options.cacheTtlMs,
93
+ rbacRoleModel: rbacRoleModel,
94
+ resolvePermissions: options.resolvePermissions,
95
+ sources: options.sources,
96
+ statements: mergedStatements,
97
+ });
98
+ var roleManager = (0, roleManager_1.createRoleManager)({
99
+ auditSinks: auditSinks,
100
+ connection: options.connection,
101
+ defaultRoles: options.defaultRoles,
102
+ getActorPermissions: function (user) { return resolver.resolvePermissionsForUser(user); },
103
+ getPreviewPermissions: function (user) { return resolver.resolvePermissionsForUserUncached(user); },
104
+ invalidateCache: resolver.invalidateCache,
105
+ persistAudit: persistAudit,
106
+ statements: mergedStatements,
107
+ userModel: options.userModel,
108
+ }).roleManager;
109
+ var can = function (args) { return __awaiter(void 0, void 0, void 0, function () {
110
+ var effectivePermissions, roleResult, _a, _b, _c, resource, actions, _d, _e, action, scopeKey, wildcardScope, scope, checkResult, extraResult, e_1_1, e_2_1;
111
+ var e_2, _f, e_1, _g;
112
+ var _h;
113
+ return __generator(this, function (_j) {
114
+ switch (_j.label) {
115
+ case 0:
116
+ if (!args.user) {
117
+ return [2 /*return*/, { allowed: false, deniedBy: "role", reason: "Unauthenticated" }];
118
+ }
119
+ return [4 /*yield*/, resolver.resolvePermissionsForUser(args.user)];
120
+ case 1:
121
+ effectivePermissions = _j.sent();
122
+ roleResult = resolver.authorizePermissions(effectivePermissions, args.permissions);
123
+ if (!roleResult.success) {
124
+ return [2 /*return*/, {
125
+ allowed: false,
126
+ deniedBy: "role",
127
+ reason: roleResult.error,
128
+ }];
129
+ }
130
+ if (!options.scopes) return [3 /*break*/, 15];
131
+ _j.label = 2;
132
+ case 2:
133
+ _j.trys.push([2, 13, 14, 15]);
134
+ _a = __values(Object.entries(args.permissions)), _b = _a.next();
135
+ _j.label = 3;
136
+ case 3:
137
+ if (!!_b.done) return [3 /*break*/, 12];
138
+ _c = __read(_b.value, 2), resource = _c[0], actions = _c[1];
139
+ _j.label = 4;
140
+ case 4:
141
+ _j.trys.push([4, 9, 10, 11]);
142
+ _d = (e_1 = void 0, __values(actions !== null && actions !== void 0 ? actions : [])), _e = _d.next();
143
+ _j.label = 5;
144
+ case 5:
145
+ if (!!_e.done) return [3 /*break*/, 8];
146
+ action = _e.value;
147
+ scopeKey = "".concat(resource, ".").concat(action);
148
+ wildcardScope = options.scopes["".concat(resource, ".*")];
149
+ scope = (_h = options.scopes[scopeKey]) !== null && _h !== void 0 ? _h : wildcardScope;
150
+ if (!(scope === null || scope === void 0 ? void 0 : scope.check)) {
151
+ return [3 /*break*/, 7];
152
+ }
153
+ return [4 /*yield*/, scope.check({
154
+ action: action,
155
+ context: args.context,
156
+ doc: args.doc,
157
+ user: args.user,
158
+ })];
159
+ case 6:
160
+ checkResult = _j.sent();
161
+ if (checkResult === false) {
162
+ return [2 /*return*/, { allowed: false, deniedBy: "scope", reason: "Denied by ".concat(scopeKey) }];
163
+ }
164
+ if (checkResult && typeof checkResult === "object") {
165
+ extraResult = resolver.authorizePermissions(effectivePermissions, checkResult);
166
+ if (!extraResult.success) {
167
+ return [2 /*return*/, {
168
+ allowed: false,
169
+ deniedBy: "scope",
170
+ reason: extraResult.error,
171
+ }];
172
+ }
173
+ }
174
+ _j.label = 7;
175
+ case 7:
176
+ _e = _d.next();
177
+ return [3 /*break*/, 5];
178
+ case 8: return [3 /*break*/, 11];
179
+ case 9:
180
+ e_1_1 = _j.sent();
181
+ e_1 = { error: e_1_1 };
182
+ return [3 /*break*/, 11];
183
+ case 10:
184
+ try {
185
+ if (_e && !_e.done && (_g = _d.return)) _g.call(_d);
186
+ }
187
+ finally { if (e_1) throw e_1.error; }
188
+ return [7 /*endfinally*/];
189
+ case 11:
190
+ _b = _a.next();
191
+ return [3 /*break*/, 3];
192
+ case 12: return [3 /*break*/, 15];
193
+ case 13:
194
+ e_2_1 = _j.sent();
195
+ e_2 = { error: e_2_1 };
196
+ return [3 /*break*/, 15];
197
+ case 14:
198
+ try {
199
+ if (_b && !_b.done && (_f = _a.return)) _f.call(_a);
200
+ }
201
+ finally { if (e_2) throw e_2.error; }
202
+ return [7 /*endfinally*/];
203
+ case 15: return [2 /*return*/, { allowed: true }];
204
+ }
205
+ });
206
+ }); };
207
+ var queryFilter = function (args) { return __awaiter(void 0, void 0, void 0, function () {
208
+ var roleResult, scopeKey, scope;
209
+ var _a;
210
+ var _b, _c, _d;
211
+ return __generator(this, function (_e) {
212
+ switch (_e.label) {
213
+ case 0:
214
+ if (!args.user) {
215
+ return [2 /*return*/, null];
216
+ }
217
+ return [4 /*yield*/, can({
218
+ context: args.context,
219
+ permissions: (_a = {}, _a[args.resource] = [args.action], _a),
220
+ user: args.user,
221
+ })];
222
+ case 1:
223
+ roleResult = _e.sent();
224
+ if (!roleResult.allowed) {
225
+ return [2 /*return*/, null];
226
+ }
227
+ scopeKey = "".concat(args.resource, ".").concat(args.action);
228
+ scope = (_c = (_b = options.scopes) === null || _b === void 0 ? void 0 : _b[scopeKey]) !== null && _c !== void 0 ? _c : (_d = options.scopes) === null || _d === void 0 ? void 0 : _d["".concat(args.resource, ".*")];
229
+ if (!(scope === null || scope === void 0 ? void 0 : scope.filter)) {
230
+ return [2 /*return*/, {}];
231
+ }
232
+ return [2 /*return*/, scope.filter({
233
+ action: args.action,
234
+ context: args.context,
235
+ user: args.user,
236
+ })];
237
+ }
238
+ });
239
+ }); };
240
+ var fieldMask = function (args) { return __awaiter(void 0, void 0, void 0, function () {
241
+ var fieldView, permissions, phase, selected;
242
+ var _a, _b, _c, _d;
243
+ return __generator(this, function (_e) {
244
+ switch (_e.label) {
245
+ case 0:
246
+ fieldView = (_a = options.fieldViews) === null || _a === void 0 ? void 0 : _a[args.resource];
247
+ if (!fieldView || !args.user) {
248
+ return [2 /*return*/, FULL_FIELD_MASK];
249
+ }
250
+ return [4 /*yield*/, resolver.resolvePermissionsForUser(args.user)];
251
+ case 1:
252
+ permissions = _e.sent();
253
+ phase = (_b = args.phase) !== null && _b !== void 0 ? _b : "read";
254
+ if (phase === "create" && fieldView.createView !== undefined) {
255
+ if (fieldView.createView === "deny") {
256
+ return [2 /*return*/, EMPTY_FIELD_MASK];
257
+ }
258
+ if (typeof fieldView.createView === "string") {
259
+ return [2 /*return*/, (_c = fieldView.views[fieldView.createView]) !== null && _c !== void 0 ? _c : EMPTY_FIELD_MASK];
260
+ }
261
+ return [2 /*return*/, fieldView.createView];
262
+ }
263
+ return [4 /*yield*/, fieldView.select({
264
+ doc: args.doc,
265
+ permissions: permissions,
266
+ phase: phase,
267
+ user: args.user,
268
+ })];
269
+ case 2:
270
+ selected = _e.sent();
271
+ if (typeof selected === "string") {
272
+ return [2 /*return*/, (_d = fieldView.views[selected]) !== null && _d !== void 0 ? _d : EMPTY_FIELD_MASK];
273
+ }
274
+ return [2 /*return*/, selected];
275
+ }
276
+ });
277
+ }); };
278
+ return {
279
+ ac: resolver.ac,
280
+ can: can,
281
+ fieldMask: fieldMask,
282
+ getPermissions: function (_a) {
283
+ var user = _a.user;
284
+ return resolver.resolvePermissionsForUser(user);
285
+ },
286
+ invalidateCache: resolver.invalidateCache,
287
+ middleware: (0, middleware_1.createRequireAccess)({ can: can }),
288
+ permission: (0, middleware_1.createIsPermitted)({ can: can }),
289
+ queryFilter: queryFilter,
290
+ roles: roleManager,
291
+ statements: mergedStatements,
292
+ };
293
+ };
294
+ exports.createAccess = createAccess;
@@ -0,0 +1,31 @@
1
+ import mongoose from "mongoose";
2
+ import type { PermissionSet } from "./statements";
3
+ export interface RbacAuditDocument {
4
+ _id: mongoose.Types.ObjectId;
5
+ action: string;
6
+ actorId: string;
7
+ targetRoleName?: string;
8
+ targetUserId?: string;
9
+ permissionDelta?: {
10
+ gained: PermissionSet;
11
+ lost: PermissionSet;
12
+ };
13
+ denied: boolean;
14
+ created: Date;
15
+ updated: Date;
16
+ }
17
+ export type RbacAuditModel = mongoose.Model<RbacAuditDocument>;
18
+ export declare const createRbacAuditModel: (connection: mongoose.Connection) => RbacAuditModel;
19
+ export interface RbacAuditWrite {
20
+ action: string;
21
+ actorId: string;
22
+ denied?: boolean;
23
+ permissionDelta?: {
24
+ gained: PermissionSet;
25
+ lost: PermissionSet;
26
+ };
27
+ targetRoleName?: string;
28
+ targetUserId?: string;
29
+ }
30
+ export declare const recordRbacAudit: (model: RbacAuditModel, args: RbacAuditWrite) => Promise<void>;
31
+ export declare const normalizeRbacAuditSinks: <T extends (record: RbacAuditWrite) => unknown>(auditSink?: T | T[]) => T[];
@@ -0,0 +1,112 @@
1
+ "use strict";
2
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
+ return new (P || (P = Promise))(function (resolve, reject) {
5
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
9
+ });
10
+ };
11
+ var __generator = (this && this.__generator) || function (thisArg, body) {
12
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
+ function verb(n) { return function (v) { return step([n, v]); }; }
15
+ function step(op) {
16
+ if (f) throw new TypeError("Generator is already executing.");
17
+ while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
+ if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
+ if (y = 0, t) op = [op[0] & 2, t.value];
20
+ switch (op[0]) {
21
+ case 0: case 1: t = op; break;
22
+ case 4: _.label++; return { value: op[1], done: false };
23
+ case 5: _.label++; y = op[1]; op = [0]; continue;
24
+ case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
+ default:
26
+ if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
+ if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
+ if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
+ if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
+ if (t[2]) _.ops.pop();
31
+ _.trys.pop(); continue;
32
+ }
33
+ op = body.call(thisArg, _);
34
+ } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
+ if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
+ }
37
+ };
38
+ var __importDefault = (this && this.__importDefault) || function (mod) {
39
+ return (mod && mod.__esModule) ? mod : { "default": mod };
40
+ };
41
+ Object.defineProperty(exports, "__esModule", { value: true });
42
+ exports.normalizeRbacAuditSinks = exports.recordRbacAudit = exports.createRbacAuditModel = void 0;
43
+ var mongoose_1 = __importDefault(require("mongoose"));
44
+ var plugins_1 = require("../plugins");
45
+ var rbacAuditSchema = new mongoose_1.default.Schema({
46
+ action: {
47
+ description: "RBAC action that was attempted or performed",
48
+ required: true,
49
+ type: String,
50
+ },
51
+ actorId: {
52
+ description: "User id of the actor who performed the action",
53
+ index: true,
54
+ required: true,
55
+ type: String,
56
+ },
57
+ denied: {
58
+ default: false,
59
+ description: "Whether the action was denied (e.g. escalation attempt)",
60
+ type: Boolean,
61
+ },
62
+ permissionDelta: {
63
+ description: "Permissions gained and lost by the change",
64
+ type: mongoose_1.default.Schema.Types.Mixed,
65
+ },
66
+ targetRoleName: {
67
+ description: "Role name affected by the action",
68
+ index: true,
69
+ type: String,
70
+ },
71
+ targetUserId: {
72
+ description: "User id affected by the action",
73
+ index: true,
74
+ type: String,
75
+ },
76
+ }, { strict: "throw", toJSON: { virtuals: true }, toObject: { virtuals: true } });
77
+ rbacAuditSchema.plugin(plugins_1.createdUpdatedPlugin);
78
+ rbacAuditSchema.plugin(plugins_1.findOneOrNone);
79
+ rbacAuditSchema.plugin(plugins_1.findExactlyOne);
80
+ var createRbacAuditModel = function (connection) {
81
+ if (connection.models.RbacAudit) {
82
+ return connection.models.RbacAudit;
83
+ }
84
+ return connection.model("RbacAudit", rbacAuditSchema);
85
+ };
86
+ exports.createRbacAuditModel = createRbacAuditModel;
87
+ var recordRbacAudit = function (model, args) { return __awaiter(void 0, void 0, void 0, function () {
88
+ var _a;
89
+ return __generator(this, function (_b) {
90
+ switch (_b.label) {
91
+ case 0: return [4 /*yield*/, model.create({
92
+ action: args.action,
93
+ actorId: args.actorId,
94
+ denied: (_a = args.denied) !== null && _a !== void 0 ? _a : false,
95
+ permissionDelta: args.permissionDelta,
96
+ targetRoleName: args.targetRoleName,
97
+ targetUserId: args.targetUserId,
98
+ })];
99
+ case 1:
100
+ _b.sent();
101
+ return [2 /*return*/];
102
+ }
103
+ });
104
+ }); };
105
+ exports.recordRbacAudit = recordRbacAudit;
106
+ var normalizeRbacAuditSinks = function (auditSink) {
107
+ if (!auditSink) {
108
+ return [];
109
+ }
110
+ return Array.isArray(auditSink) ? auditSink : [auditSink];
111
+ };
112
+ exports.normalizeRbacAuditSinks = normalizeRbacAuditSinks;
@@ -0,0 +1,18 @@
1
+ import type { UserModel } from "../auth";
2
+ import type { AnyTerrenoAccess } from "./types";
3
+ export interface BackfillAdminsOptions {
4
+ access: AnyTerrenoAccess;
5
+ userModel: UserModel;
6
+ roleName?: string;
7
+ wetRun?: boolean;
8
+ }
9
+ export interface BackfillAdminsResult {
10
+ dryRun: boolean;
11
+ matched: number;
12
+ updated: number;
13
+ }
14
+ /**
15
+ * Assigns a superadmin (or custom) role to users with `admin: true`.
16
+ * Dry-run by default — pass `wetRun: true` to persist changes.
17
+ */
18
+ export declare const backfillAdmins: ({ access, userModel, roleName, wetRun, }: BackfillAdminsOptions) => Promise<BackfillAdminsResult>;
@@ -0,0 +1,139 @@
1
+ "use strict";
2
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
+ return new (P || (P = Promise))(function (resolve, reject) {
5
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
9
+ });
10
+ };
11
+ var __generator = (this && this.__generator) || function (thisArg, body) {
12
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
+ function verb(n) { return function (v) { return step([n, v]); }; }
15
+ function step(op) {
16
+ if (f) throw new TypeError("Generator is already executing.");
17
+ while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
+ if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
+ if (y = 0, t) op = [op[0] & 2, t.value];
20
+ switch (op[0]) {
21
+ case 0: case 1: t = op; break;
22
+ case 4: _.label++; return { value: op[1], done: false };
23
+ case 5: _.label++; y = op[1]; op = [0]; continue;
24
+ case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
+ default:
26
+ if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
+ if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
+ if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
+ if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
+ if (t[2]) _.ops.pop();
31
+ _.trys.pop(); continue;
32
+ }
33
+ op = body.call(thisArg, _);
34
+ } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
+ if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
+ }
37
+ };
38
+ var __values = (this && this.__values) || function(o) {
39
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
40
+ if (m) return m.call(o);
41
+ if (o && typeof o.length === "number") return {
42
+ next: function () {
43
+ if (o && i >= o.length) o = void 0;
44
+ return { value: o && o[i++], done: !o };
45
+ }
46
+ };
47
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
48
+ };
49
+ var __read = (this && this.__read) || function (o, n) {
50
+ var m = typeof Symbol === "function" && o[Symbol.iterator];
51
+ if (!m) return o;
52
+ var i = m.call(o), r, ar = [], e;
53
+ try {
54
+ while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
55
+ }
56
+ catch (error) { e = { error: error }; }
57
+ finally {
58
+ try {
59
+ if (r && !r.done && (m = i["return"])) m.call(i);
60
+ }
61
+ finally { if (e) throw e.error; }
62
+ }
63
+ return ar;
64
+ };
65
+ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
66
+ if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
67
+ if (ar || !(i in from)) {
68
+ if (!ar) ar = Array.prototype.slice.call(from, 0, i);
69
+ ar[i] = from[i];
70
+ }
71
+ }
72
+ return to.concat(ar || Array.prototype.slice.call(from));
73
+ };
74
+ Object.defineProperty(exports, "__esModule", { value: true });
75
+ exports.backfillAdmins = void 0;
76
+ var logger_1 = require("../logger");
77
+ /**
78
+ * Assigns a superadmin (or custom) role to users with `admin: true`.
79
+ * Dry-run by default — pass `wetRun: true` to persist changes.
80
+ */
81
+ var backfillAdmins = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
82
+ var admins, updated, admins_1, admins_1_1, user, rbacUser, roles, e_1_1;
83
+ var e_1, _c;
84
+ var _d;
85
+ var access = _b.access, userModel = _b.userModel, _e = _b.roleName, roleName = _e === void 0 ? "superadmin" : _e, _f = _b.wetRun, wetRun = _f === void 0 ? false : _f;
86
+ return __generator(this, function (_g) {
87
+ switch (_g.label) {
88
+ case 0: return [4 /*yield*/, userModel.find({ admin: true })];
89
+ case 1:
90
+ admins = _g.sent();
91
+ logger_1.logger.info("[rbac:backfill-admins] Found ".concat(admins.length, " admin user(s); target role=").concat(roleName, "; wetRun=").concat(wetRun));
92
+ updated = 0;
93
+ _g.label = 2;
94
+ case 2:
95
+ _g.trys.push([2, 8, 9, 10]);
96
+ admins_1 = __values(admins), admins_1_1 = admins_1.next();
97
+ _g.label = 3;
98
+ case 3:
99
+ if (!!admins_1_1.done) return [3 /*break*/, 7];
100
+ user = admins_1_1.value;
101
+ rbacUser = user;
102
+ roles = new Set((_d = rbacUser.roles) !== null && _d !== void 0 ? _d : []);
103
+ if (roles.has(roleName)) {
104
+ return [3 /*break*/, 6];
105
+ }
106
+ roles.add(roleName);
107
+ if (!wetRun) return [3 /*break*/, 5];
108
+ rbacUser.roles = __spreadArray([], __read(roles), false);
109
+ return [4 /*yield*/, user.save()];
110
+ case 4:
111
+ _g.sent();
112
+ access.invalidateCache({ userId: user.id });
113
+ _g.label = 5;
114
+ case 5:
115
+ updated += 1;
116
+ _g.label = 6;
117
+ case 6:
118
+ admins_1_1 = admins_1.next();
119
+ return [3 /*break*/, 3];
120
+ case 7: return [3 /*break*/, 10];
121
+ case 8:
122
+ e_1_1 = _g.sent();
123
+ e_1 = { error: e_1_1 };
124
+ return [3 /*break*/, 10];
125
+ case 9:
126
+ try {
127
+ if (admins_1_1 && !admins_1_1.done && (_c = admins_1.return)) _c.call(admins_1);
128
+ }
129
+ finally { if (e_1) throw e_1.error; }
130
+ return [7 /*endfinally*/];
131
+ case 10: return [2 /*return*/, {
132
+ dryRun: !wetRun,
133
+ matched: admins.length,
134
+ updated: updated,
135
+ }];
136
+ }
137
+ });
138
+ }); };
139
+ exports.backfillAdmins = backfillAdmins;
@@ -0,0 +1,3 @@
1
+ import type { FieldMask } from "./types";
2
+ export declare const applyReadMask: (value: unknown, mask: FieldMask) => unknown;
3
+ export declare const getDisallowedWriteKeys: (body: Record<string, unknown>, mask: FieldMask) => string[];