@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,388 @@
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 __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
+ var __values = (this && this.__values) || function(o) {
75
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
76
+ if (m) return m.call(o);
77
+ if (o && typeof o.length === "number") return {
78
+ next: function () {
79
+ if (o && i >= o.length) o = void 0;
80
+ return { value: o && o[i++], done: !o };
81
+ }
82
+ };
83
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
84
+ };
85
+ Object.defineProperty(exports, "__esModule", { value: true });
86
+ exports.resolveModelRouterAccess = exports.validateAccessWritePayload = exports.validateAccessWriteBody = exports.wrapAccessResponseHandler = exports.buildAccessQueryFilter = exports.buildAccessPermissions = void 0;
87
+ var errors_1 = require("../errors");
88
+ var transformers_1 = require("../transformers");
89
+ var fieldViews_1 = require("./fieldViews");
90
+ var middleware_1 = require("./middleware");
91
+ var DEFAULT_METHOD_ACTIONS = {
92
+ create: "create",
93
+ delete: "delete",
94
+ list: "list",
95
+ read: "read",
96
+ update: "update",
97
+ };
98
+ var mergeFilters = function (existing, scopeFilter) {
99
+ if (existing === null || scopeFilter === null) {
100
+ return null;
101
+ }
102
+ if (!existing && !scopeFilter) {
103
+ return {};
104
+ }
105
+ if (!existing) {
106
+ return scopeFilter !== null && scopeFilter !== void 0 ? scopeFilter : {};
107
+ }
108
+ if (!scopeFilter || Object.keys(scopeFilter).length === 0) {
109
+ return existing;
110
+ }
111
+ return { $and: [existing, scopeFilter] };
112
+ };
113
+ var resolveActionForMethod = function (method, access, statements) {
114
+ var _a, _b;
115
+ var override = (_a = access.actions) === null || _a === void 0 ? void 0 : _a[method];
116
+ if (override === null) {
117
+ return null;
118
+ }
119
+ if (override) {
120
+ return override;
121
+ }
122
+ var resourceActions = (_b = statements[access.resource]) !== null && _b !== void 0 ? _b : [];
123
+ if (method === "list" && resourceActions.includes("list")) {
124
+ return "list";
125
+ }
126
+ if (method === "list") {
127
+ return "read";
128
+ }
129
+ return DEFAULT_METHOD_ACTIONS[method];
130
+ };
131
+ var buildPermissionRequest = function (resource, action) {
132
+ var _a;
133
+ return (_a = {},
134
+ _a[resource] = [action],
135
+ _a);
136
+ };
137
+ var buildAccessPermissions = function (accessControl, access) {
138
+ var isPermitted = (0, middleware_1.createIsPermitted)({ can: accessControl.can });
139
+ var statements = accessControl.statements;
140
+ var buildMethodPermissions = function (method) {
141
+ var _a, _b, _c;
142
+ var action = resolveActionForMethod(method, access, statements);
143
+ if (!action) {
144
+ return [];
145
+ }
146
+ var checks = [
147
+ isPermitted(buildPermissionRequest(access.resource, action)),
148
+ ];
149
+ if ((_a = access.scope) === null || _a === void 0 ? void 0 : _a.check) {
150
+ checks.push(function (_method, user, obj) { return __awaiter(void 0, void 0, void 0, function () {
151
+ var result, extra;
152
+ var _a, _b;
153
+ return __generator(this, function (_c) {
154
+ switch (_c.label) {
155
+ case 0:
156
+ if (!user) {
157
+ return [2 /*return*/, false];
158
+ }
159
+ return [4 /*yield*/, ((_b = (_a = access.scope) === null || _a === void 0 ? void 0 : _a.check) === null || _b === void 0 ? void 0 : _b.call(_a, {
160
+ action: action,
161
+ doc: obj,
162
+ user: user,
163
+ }))];
164
+ case 1:
165
+ result = _c.sent();
166
+ if (result === false) {
167
+ return [2 /*return*/, false];
168
+ }
169
+ if (!(result && typeof result === "object")) return [3 /*break*/, 3];
170
+ return [4 /*yield*/, accessControl.can({
171
+ doc: obj,
172
+ permissions: result,
173
+ user: user,
174
+ })];
175
+ case 2:
176
+ extra = _c.sent();
177
+ return [2 /*return*/, extra.allowed];
178
+ case 3: return [2 /*return*/, true];
179
+ }
180
+ });
181
+ }); });
182
+ }
183
+ var also = (_c = (_b = access.also) === null || _b === void 0 ? void 0 : _b[method]) !== null && _c !== void 0 ? _c : [];
184
+ return __spreadArray(__spreadArray([], __read(checks), false), __read(also), false);
185
+ };
186
+ return {
187
+ create: buildMethodPermissions("create"),
188
+ delete: buildMethodPermissions("delete"),
189
+ list: buildMethodPermissions("list"),
190
+ read: buildMethodPermissions("read"),
191
+ update: buildMethodPermissions("update"),
192
+ };
193
+ };
194
+ exports.buildAccessPermissions = buildAccessPermissions;
195
+ var buildAccessQueryFilter = function (accessControl, access, existing) {
196
+ return function (user, query) { return __awaiter(void 0, void 0, void 0, function () {
197
+ var merged, statements, listAction, scopeFilter, withAccessScope, routerScopeFilter;
198
+ var _a;
199
+ return __generator(this, function (_b) {
200
+ switch (_b.label) {
201
+ case 0:
202
+ merged = query !== null && query !== void 0 ? query : {};
203
+ if (!existing) return [3 /*break*/, 2];
204
+ return [4 /*yield*/, existing(user, query)];
205
+ case 1:
206
+ merged = _b.sent();
207
+ if (merged === null) {
208
+ return [2 /*return*/, null];
209
+ }
210
+ _b.label = 2;
211
+ case 2:
212
+ statements = accessControl.statements;
213
+ listAction = resolveActionForMethod("list", access, statements);
214
+ if (!listAction) {
215
+ return [2 /*return*/, merged];
216
+ }
217
+ return [4 /*yield*/, accessControl.queryFilter({
218
+ action: listAction,
219
+ context: { query: query },
220
+ resource: access.resource,
221
+ user: user,
222
+ })];
223
+ case 3:
224
+ scopeFilter = _b.sent();
225
+ withAccessScope = mergeFilters(merged, scopeFilter);
226
+ if (!(((_a = access.scope) === null || _a === void 0 ? void 0 : _a.filter) && user)) return [3 /*break*/, 5];
227
+ return [4 /*yield*/, access.scope.filter({
228
+ action: listAction,
229
+ user: user,
230
+ })];
231
+ case 4:
232
+ routerScopeFilter = _b.sent();
233
+ withAccessScope = mergeFilters(withAccessScope, routerScopeFilter);
234
+ _b.label = 5;
235
+ case 5: return [2 /*return*/, withAccessScope];
236
+ }
237
+ });
238
+ }); };
239
+ };
240
+ exports.buildAccessQueryFilter = buildAccessQueryFilter;
241
+ var wrapAccessResponseHandler = function (accessControl, access, baseHandler) {
242
+ return function (value, method, request, options) { return __awaiter(void 0, void 0, void 0, function () {
243
+ var serialized, docs, masked;
244
+ return __generator(this, function (_a) {
245
+ switch (_a.label) {
246
+ case 0: return [4 /*yield*/, baseHandler(value, method, request, options)];
247
+ case 1:
248
+ serialized = _a.sent();
249
+ docs = Array.isArray(serialized) ? serialized : [serialized];
250
+ return [4 /*yield*/, Promise.all(docs.map(function (doc) { return __awaiter(void 0, void 0, void 0, function () {
251
+ var mask;
252
+ return __generator(this, function (_a) {
253
+ switch (_a.label) {
254
+ case 0: return [4 /*yield*/, accessControl.fieldMask({
255
+ doc: doc,
256
+ phase: "read",
257
+ resource: access.resource,
258
+ user: request.user,
259
+ })];
260
+ case 1:
261
+ mask = _a.sent();
262
+ return [2 /*return*/, (0, fieldViews_1.applyReadMask)(doc, mask)];
263
+ }
264
+ });
265
+ }); }))];
266
+ case 2:
267
+ masked = _a.sent();
268
+ return [2 /*return*/, Array.isArray(serialized) ? masked : masked[0]];
269
+ }
270
+ });
271
+ }); };
272
+ };
273
+ exports.wrapAccessResponseHandler = wrapAccessResponseHandler;
274
+ var validateAccessWriteBody = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
275
+ var mask, disallowed, fields, disallowed_1, disallowed_1_1, key;
276
+ var e_1, _c;
277
+ var accessControl = _b.accessControl, access = _b.access, body = _b.body, doc = _b.doc, phase = _b.phase, user = _b.user;
278
+ return __generator(this, function (_d) {
279
+ switch (_d.label) {
280
+ case 0: return [4 /*yield*/, accessControl.fieldMask({
281
+ doc: doc,
282
+ phase: phase === "create" ? "create" : "write",
283
+ resource: access.resource,
284
+ user: user,
285
+ })];
286
+ case 1:
287
+ mask = _d.sent();
288
+ disallowed = (0, fieldViews_1.getDisallowedWriteKeys)(body, mask);
289
+ if (disallowed.length === 0) {
290
+ return [2 /*return*/];
291
+ }
292
+ fields = {};
293
+ try {
294
+ for (disallowed_1 = __values(disallowed), disallowed_1_1 = disallowed_1.next(); !disallowed_1_1.done; disallowed_1_1 = disallowed_1.next()) {
295
+ key = disallowed_1_1.value;
296
+ fields[key] = "Field is not writable";
297
+ }
298
+ }
299
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
300
+ finally {
301
+ try {
302
+ if (disallowed_1_1 && !disallowed_1_1.done && (_c = disallowed_1.return)) _c.call(disallowed_1);
303
+ }
304
+ finally { if (e_1) throw e_1.error; }
305
+ }
306
+ throw new errors_1.APIError({
307
+ fields: fields,
308
+ status: 400,
309
+ title: "Validation failed",
310
+ });
311
+ }
312
+ });
313
+ }); };
314
+ exports.validateAccessWriteBody = validateAccessWriteBody;
315
+ var validateAccessWritePayload = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
316
+ var items, items_1, items_1_1, item, e_2_1;
317
+ var e_2, _c;
318
+ var options = _b.options, body = _b.body, doc = _b.doc, phase = _b.phase, user = _b.user;
319
+ return __generator(this, function (_d) {
320
+ switch (_d.label) {
321
+ case 0:
322
+ if (!options.access || !options.accessControl || body == null) {
323
+ return [2 /*return*/];
324
+ }
325
+ items = Array.isArray(body) ? body : [body];
326
+ _d.label = 1;
327
+ case 1:
328
+ _d.trys.push([1, 6, 7, 8]);
329
+ items_1 = __values(items), items_1_1 = items_1.next();
330
+ _d.label = 2;
331
+ case 2:
332
+ if (!!items_1_1.done) return [3 /*break*/, 5];
333
+ item = items_1_1.value;
334
+ if (!item || typeof item !== "object" || Array.isArray(item)) {
335
+ return [3 /*break*/, 4];
336
+ }
337
+ return [4 /*yield*/, (0, exports.validateAccessWriteBody)({
338
+ access: options.access,
339
+ accessControl: options.accessControl,
340
+ body: item,
341
+ doc: doc,
342
+ phase: phase,
343
+ user: user,
344
+ })];
345
+ case 3:
346
+ _d.sent();
347
+ _d.label = 4;
348
+ case 4:
349
+ items_1_1 = items_1.next();
350
+ return [3 /*break*/, 2];
351
+ case 5: return [3 /*break*/, 8];
352
+ case 6:
353
+ e_2_1 = _d.sent();
354
+ e_2 = { error: e_2_1 };
355
+ return [3 /*break*/, 8];
356
+ case 7:
357
+ try {
358
+ if (items_1_1 && !items_1_1.done && (_c = items_1.return)) _c.call(items_1);
359
+ }
360
+ finally { if (e_2) throw e_2.error; }
361
+ return [7 /*endfinally*/];
362
+ case 8: return [2 /*return*/];
363
+ }
364
+ });
365
+ }); };
366
+ exports.validateAccessWritePayload = validateAccessWritePayload;
367
+ var resolveModelRouterAccess = function (options) {
368
+ var _a, _b;
369
+ if (!options.access || !options.accessControl) {
370
+ if (!options.permissions) {
371
+ throw new Error("modelRouter requires permissions or access with accessControl");
372
+ }
373
+ return {
374
+ permissions: options.permissions,
375
+ queryFilter: options.queryFilter,
376
+ responseHandler: options.responseHandler,
377
+ };
378
+ }
379
+ var access = __assign(__assign({}, options.access), { scope: (_a = options.access.scope) !== null && _a !== void 0 ? _a : options.scope });
380
+ return {
381
+ permissions: (0, exports.buildAccessPermissions)(options.accessControl, access),
382
+ queryFilter: (0, exports.buildAccessQueryFilter)(options.accessControl, access, options.queryFilter),
383
+ // Without an app handler the base must stay defaultResponseHandler: masking a raw
384
+ // Mongoose document would emit internal state instead of the serialized payload.
385
+ responseHandler: (0, exports.wrapAccessResponseHandler)(options.accessControl, access, ((_b = options.responseHandler) !== null && _b !== void 0 ? _b : transformers_1.defaultResponseHandler)),
386
+ };
387
+ };
388
+ exports.resolveModelRouterAccess = resolveModelRouterAccess;
@@ -0,0 +1,8 @@
1
+ import type { PermissionSet } from "./statements";
2
+ export declare const unionPermissionSets: (...sets: PermissionSet[]) => PermissionSet;
3
+ export declare const isPermissionSubset: (actorPermissions: PermissionSet, requestedPermissions: PermissionSet) => boolean;
4
+ export declare const diffPermissionSets: (before: PermissionSet, after: PermissionSet) => {
5
+ gained: PermissionSet;
6
+ lost: PermissionSet;
7
+ };
8
+ export declare const validatePermissionSet: (permissions: PermissionSet, statements: Record<string, readonly string[]>) => void;
@@ -0,0 +1,209 @@
1
+ "use strict";
2
+ var __values = (this && this.__values) || function(o) {
3
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
4
+ if (m) return m.call(o);
5
+ if (o && typeof o.length === "number") return {
6
+ next: function () {
7
+ if (o && i >= o.length) o = void 0;
8
+ return { value: o && o[i++], done: !o };
9
+ }
10
+ };
11
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
12
+ };
13
+ var __read = (this && this.__read) || function (o, n) {
14
+ var m = typeof Symbol === "function" && o[Symbol.iterator];
15
+ if (!m) return o;
16
+ var i = m.call(o), r, ar = [], e;
17
+ try {
18
+ while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
19
+ }
20
+ catch (error) { e = { error: error }; }
21
+ finally {
22
+ try {
23
+ if (r && !r.done && (m = i["return"])) m.call(i);
24
+ }
25
+ finally { if (e) throw e.error; }
26
+ }
27
+ return ar;
28
+ };
29
+ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
30
+ if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
31
+ if (ar || !(i in from)) {
32
+ if (!ar) ar = Array.prototype.slice.call(from, 0, i);
33
+ ar[i] = from[i];
34
+ }
35
+ }
36
+ return to.concat(ar || Array.prototype.slice.call(from));
37
+ };
38
+ Object.defineProperty(exports, "__esModule", { value: true });
39
+ exports.validatePermissionSet = exports.diffPermissionSets = exports.isPermissionSubset = exports.unionPermissionSets = void 0;
40
+ var unionPermissionSets = function () {
41
+ var e_1, _a, e_2, _b, e_3, _c, e_4, _d;
42
+ var sets = [];
43
+ for (var _i = 0; _i < arguments.length; _i++) {
44
+ sets[_i] = arguments[_i];
45
+ }
46
+ var merged = {};
47
+ try {
48
+ for (var sets_1 = __values(sets), sets_1_1 = sets_1.next(); !sets_1_1.done; sets_1_1 = sets_1.next()) {
49
+ var set = sets_1_1.value;
50
+ if (!set) {
51
+ continue;
52
+ }
53
+ try {
54
+ for (var _e = (e_2 = void 0, __values(Object.entries(set))), _f = _e.next(); !_f.done; _f = _e.next()) {
55
+ var _g = __read(_f.value, 2), resource = _g[0], actions = _g[1];
56
+ if (!merged[resource]) {
57
+ merged[resource] = new Set();
58
+ }
59
+ try {
60
+ for (var actions_1 = (e_3 = void 0, __values(actions)), actions_1_1 = actions_1.next(); !actions_1_1.done; actions_1_1 = actions_1.next()) {
61
+ var action = actions_1_1.value;
62
+ merged[resource].add(action);
63
+ }
64
+ }
65
+ catch (e_3_1) { e_3 = { error: e_3_1 }; }
66
+ finally {
67
+ try {
68
+ if (actions_1_1 && !actions_1_1.done && (_c = actions_1.return)) _c.call(actions_1);
69
+ }
70
+ finally { if (e_3) throw e_3.error; }
71
+ }
72
+ }
73
+ }
74
+ catch (e_2_1) { e_2 = { error: e_2_1 }; }
75
+ finally {
76
+ try {
77
+ if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
78
+ }
79
+ finally { if (e_2) throw e_2.error; }
80
+ }
81
+ }
82
+ }
83
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
84
+ finally {
85
+ try {
86
+ if (sets_1_1 && !sets_1_1.done && (_a = sets_1.return)) _a.call(sets_1);
87
+ }
88
+ finally { if (e_1) throw e_1.error; }
89
+ }
90
+ var result = {};
91
+ try {
92
+ for (var _h = __values(Object.entries(merged)), _j = _h.next(); !_j.done; _j = _h.next()) {
93
+ var _k = __read(_j.value, 2), resource = _k[0], actions = _k[1];
94
+ result[resource] = __spreadArray([], __read(actions), false);
95
+ }
96
+ }
97
+ catch (e_4_1) { e_4 = { error: e_4_1 }; }
98
+ finally {
99
+ try {
100
+ if (_j && !_j.done && (_d = _h.return)) _d.call(_h);
101
+ }
102
+ finally { if (e_4) throw e_4.error; }
103
+ }
104
+ return result;
105
+ };
106
+ exports.unionPermissionSets = unionPermissionSets;
107
+ var isPermissionSubset = function (actorPermissions, requestedPermissions) {
108
+ var e_5, _a, e_6, _b;
109
+ var _c;
110
+ try {
111
+ for (var _d = __values(Object.entries(requestedPermissions !== null && requestedPermissions !== void 0 ? requestedPermissions : {})), _e = _d.next(); !_e.done; _e = _d.next()) {
112
+ var _f = __read(_e.value, 2), resource = _f[0], actions = _f[1];
113
+ var actorActions = (_c = actorPermissions[resource]) !== null && _c !== void 0 ? _c : [];
114
+ try {
115
+ for (var actions_2 = (e_6 = void 0, __values(actions)), actions_2_1 = actions_2.next(); !actions_2_1.done; actions_2_1 = actions_2.next()) {
116
+ var action = actions_2_1.value;
117
+ if (!actorActions.includes(action)) {
118
+ return false;
119
+ }
120
+ }
121
+ }
122
+ catch (e_6_1) { e_6 = { error: e_6_1 }; }
123
+ finally {
124
+ try {
125
+ if (actions_2_1 && !actions_2_1.done && (_b = actions_2.return)) _b.call(actions_2);
126
+ }
127
+ finally { if (e_6) throw e_6.error; }
128
+ }
129
+ }
130
+ }
131
+ catch (e_5_1) { e_5 = { error: e_5_1 }; }
132
+ finally {
133
+ try {
134
+ if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
135
+ }
136
+ finally { if (e_5) throw e_5.error; }
137
+ }
138
+ return true;
139
+ };
140
+ exports.isPermissionSubset = isPermissionSubset;
141
+ var diffPermissionSets = function (before, after) {
142
+ var e_7, _a;
143
+ var _b, _c;
144
+ var gained = {};
145
+ var lost = {};
146
+ var resources = new Set(__spreadArray(__spreadArray([], __read(Object.keys(before)), false), __read(Object.keys(after)), false));
147
+ var _loop_1 = function (resource) {
148
+ var beforeActions = new Set((_b = before[resource]) !== null && _b !== void 0 ? _b : []);
149
+ var afterActions = new Set((_c = after[resource]) !== null && _c !== void 0 ? _c : []);
150
+ var gainedActions = __spreadArray([], __read(afterActions), false).filter(function (action) { return !beforeActions.has(action); });
151
+ var lostActions = __spreadArray([], __read(beforeActions), false).filter(function (action) { return !afterActions.has(action); });
152
+ if (gainedActions.length > 0) {
153
+ gained[resource] = gainedActions;
154
+ }
155
+ if (lostActions.length > 0) {
156
+ lost[resource] = lostActions;
157
+ }
158
+ };
159
+ try {
160
+ for (var resources_1 = __values(resources), resources_1_1 = resources_1.next(); !resources_1_1.done; resources_1_1 = resources_1.next()) {
161
+ var resource = resources_1_1.value;
162
+ _loop_1(resource);
163
+ }
164
+ }
165
+ catch (e_7_1) { e_7 = { error: e_7_1 }; }
166
+ finally {
167
+ try {
168
+ if (resources_1_1 && !resources_1_1.done && (_a = resources_1.return)) _a.call(resources_1);
169
+ }
170
+ finally { if (e_7) throw e_7.error; }
171
+ }
172
+ return { gained: gained, lost: lost };
173
+ };
174
+ exports.diffPermissionSets = diffPermissionSets;
175
+ var validatePermissionSet = function (permissions, statements) {
176
+ var e_8, _a, e_9, _b;
177
+ try {
178
+ for (var _c = __values(Object.entries(permissions)), _d = _c.next(); !_d.done; _d = _c.next()) {
179
+ var _e = __read(_d.value, 2), resource = _e[0], actions = _e[1];
180
+ var allowedActions = statements[resource];
181
+ if (!allowedActions) {
182
+ throw new Error("Unknown resource: ".concat(resource));
183
+ }
184
+ try {
185
+ for (var actions_3 = (e_9 = void 0, __values(actions)), actions_3_1 = actions_3.next(); !actions_3_1.done; actions_3_1 = actions_3.next()) {
186
+ var action = actions_3_1.value;
187
+ if (!allowedActions.includes(action)) {
188
+ throw new Error("Unknown permission: ".concat(resource, ":").concat(action));
189
+ }
190
+ }
191
+ }
192
+ catch (e_9_1) { e_9 = { error: e_9_1 }; }
193
+ finally {
194
+ try {
195
+ if (actions_3_1 && !actions_3_1.done && (_b = actions_3.return)) _b.call(actions_3);
196
+ }
197
+ finally { if (e_9) throw e_9.error; }
198
+ }
199
+ }
200
+ }
201
+ catch (e_8_1) { e_8 = { error: e_8_1 }; }
202
+ finally {
203
+ try {
204
+ if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
205
+ }
206
+ finally { if (e_8) throw e_8.error; }
207
+ }
208
+ };
209
+ exports.validatePermissionSet = validatePermissionSet;
@@ -0,0 +1,18 @@
1
+ import type { RESTMethod } from "../api";
2
+ import type { User } from "../auth";
3
+ import { type PermissionMethod } from "../permissions";
4
+ import type { AnyTerrenoAccess, ModelRouterAccessOptions } from "./types";
5
+ interface RealtimeAccessEntry {
6
+ options: {
7
+ access?: ModelRouterAccessOptions;
8
+ accessControl?: AnyTerrenoAccess;
9
+ permissions?: {
10
+ read?: PermissionMethod<unknown>[];
11
+ list?: PermissionMethod<unknown>[];
12
+ };
13
+ };
14
+ }
15
+ export declare const canSubscribeRealtime: (entry: RealtimeAccessEntry, method: "list" | "read", user?: User) => Promise<boolean>;
16
+ export declare const canReadDocumentRealtime: (entry: RealtimeAccessEntry, user?: User, doc?: Record<string, unknown>) => Promise<boolean>;
17
+ export declare const maskRealtimeDocument: (entry: RealtimeAccessEntry, user: User | undefined, doc: unknown, _method: RESTMethod) => Promise<unknown>;
18
+ export {};