@terreno/api 57.0.0 → 57.2.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 +182 -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 +30 -0
  64. package/dist/rbac/statements.js +126 -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 +17 -13
  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 +206 -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 +67 -0
  147. package/src/rbac/statements.ts +73 -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,793 @@
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 __rest = (this && this.__rest) || function (s, e) {
50
+ var t = {};
51
+ for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
52
+ t[p] = s[p];
53
+ if (s != null && typeof Object.getOwnPropertySymbols === "function")
54
+ for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
55
+ if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
56
+ t[p[i]] = s[p[i]];
57
+ }
58
+ return t;
59
+ };
60
+ var __values = (this && this.__values) || function(o) {
61
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
62
+ if (m) return m.call(o);
63
+ if (o && typeof o.length === "number") return {
64
+ next: function () {
65
+ if (o && i >= o.length) o = void 0;
66
+ return { value: o && o[i++], done: !o };
67
+ }
68
+ };
69
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
70
+ };
71
+ var __read = (this && this.__read) || function (o, n) {
72
+ var m = typeof Symbol === "function" && o[Symbol.iterator];
73
+ if (!m) return o;
74
+ var i = m.call(o), r, ar = [], e;
75
+ try {
76
+ while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
77
+ }
78
+ catch (error) { e = { error: error }; }
79
+ finally {
80
+ try {
81
+ if (r && !r.done && (m = i["return"])) m.call(i);
82
+ }
83
+ finally { if (e) throw e.error; }
84
+ }
85
+ return ar;
86
+ };
87
+ var __importDefault = (this && this.__importDefault) || function (mod) {
88
+ return (mod && mod.__esModule) ? mod : { "default": mod };
89
+ };
90
+ Object.defineProperty(exports, "__esModule", { value: true });
91
+ exports.handleDelete = exports.handleUpdate = exports.handleCreate = exports.handleRead = exports.handleList = exports.getMCPErrorCause = void 0;
92
+ var mongoose_1 = __importDefault(require("mongoose"));
93
+ var api_1 = require("../api");
94
+ var auth_1 = require("../auth");
95
+ var errors_1 = require("../errors");
96
+ var permissions_1 = require("../permissions");
97
+ var modelRouterAccess_1 = require("../rbac/modelRouterAccess");
98
+ var transformers_1 = require("../transformers");
99
+ var createMCPRequest_1 = require("./createMCPRequest");
100
+ var query_1 = require("./query");
101
+ var schemaGenerator_1 = require("./schemaGenerator");
102
+ // Causes stay server-side: a WeakMap lets the observability wrapper capture the
103
+ // original exception without adding stack traces or internal details to the MCP result.
104
+ var errorCauses = new WeakMap();
105
+ var getMCPErrorCause = function (result) {
106
+ return errorCauses.get(result);
107
+ };
108
+ exports.getMCPErrorCause = getMCPErrorCause;
109
+ var isPlainObject = function (value) {
110
+ return typeof value === "object" && value !== null && !Array.isArray(value);
111
+ };
112
+ /** Mongoose documents only expose their fields through toObject(). */
113
+ var toPlain = function (value) {
114
+ if (isPlainObject(value) && typeof value.toObject === "function") {
115
+ return value.toObject();
116
+ }
117
+ return value;
118
+ };
119
+ /**
120
+ * Values that serialize themselves — ObjectId, Date, Decimal128, Buffer — must be passed
121
+ * through untouched. Rebuilding them entry by entry would replace an ObjectId with its
122
+ * raw `{buffer: ...}` internals and a Date with `{}`.
123
+ */
124
+ var isSelfSerializing = function (value) {
125
+ return typeof value.toJSON === "function";
126
+ };
127
+ /**
128
+ * Delete a dot-notation path, descending into arrays element-wise so paths through
129
+ * arrays of subdocuments (e.g. "items.secret") are removed from every element.
130
+ */
131
+ var deleteAtPath = function (obj, segments) {
132
+ var e_1, _a;
133
+ if (Array.isArray(obj)) {
134
+ try {
135
+ for (var obj_1 = __values(obj), obj_1_1 = obj_1.next(); !obj_1_1.done; obj_1_1 = obj_1.next()) {
136
+ var item = obj_1_1.value;
137
+ deleteAtPath(item, segments);
138
+ }
139
+ }
140
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
141
+ finally {
142
+ try {
143
+ if (obj_1_1 && !obj_1_1.done && (_a = obj_1.return)) _a.call(obj_1);
144
+ }
145
+ finally { if (e_1) throw e_1.error; }
146
+ }
147
+ return;
148
+ }
149
+ if (!isPlainObject(obj) || segments.length === 0) {
150
+ return;
151
+ }
152
+ var _b = __read(segments), head = _b[0], rest = _b.slice(1);
153
+ if (rest.length === 0) {
154
+ delete obj[head];
155
+ return;
156
+ }
157
+ deleteAtPath(obj[head], rest);
158
+ };
159
+ /**
160
+ * Remove excluded fields from an MCP response.
161
+ *
162
+ * Bare field names are removed at every depth (including inside arrays and populated
163
+ * refs) so a redacted name never leaks through a nested document. Use a dot-notation
164
+ * path when only one specific location should be removed. Literal object keys that
165
+ * equal a denylist entry (including dotted names) are also dropped.
166
+ */
167
+ var stripExcludedFields = function (data, excludeFields) {
168
+ var e_2, _a;
169
+ if (!excludeFields.length || !data) {
170
+ return data;
171
+ }
172
+ var bareKeys = new Set(excludeFields.filter(function (field) { return !field.includes("."); }));
173
+ var dotPaths = excludeFields
174
+ .filter(function (field) { return field.includes("."); })
175
+ .map(function (field) { return field.split("."); });
176
+ var strip = function (value) {
177
+ var e_3, _a;
178
+ var plain = toPlain(value);
179
+ if (Array.isArray(plain)) {
180
+ return plain.map(strip);
181
+ }
182
+ if (!isPlainObject(plain) || isSelfSerializing(plain)) {
183
+ return plain;
184
+ }
185
+ var result = {};
186
+ try {
187
+ for (var _b = __values(Object.entries(plain)), _c = _b.next(); !_c.done; _c = _b.next()) {
188
+ var _d = __read(_c.value, 2), key = _d[0], nested = _d[1];
189
+ // Exact key match covers both bare names and literal dotted keys
190
+ // ("metadata.nested.token") that Mongoose would otherwise treat as a path.
191
+ if (bareKeys.has(key) || excludeFields.includes(key)) {
192
+ continue;
193
+ }
194
+ result[key] = strip(nested);
195
+ }
196
+ }
197
+ catch (e_3_1) { e_3 = { error: e_3_1 }; }
198
+ finally {
199
+ try {
200
+ if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
201
+ }
202
+ finally { if (e_3) throw e_3.error; }
203
+ }
204
+ return result;
205
+ };
206
+ var stripped = strip(data);
207
+ try {
208
+ for (var dotPaths_1 = __values(dotPaths), dotPaths_1_1 = dotPaths_1.next(); !dotPaths_1_1.done; dotPaths_1_1 = dotPaths_1.next()) {
209
+ var segments = dotPaths_1_1.value;
210
+ deleteAtPath(stripped, segments);
211
+ }
212
+ }
213
+ catch (e_2_1) { e_2 = { error: e_2_1 }; }
214
+ finally {
215
+ try {
216
+ if (dotPaths_1_1 && !dotPaths_1_1.done && (_a = dotPaths_1.return)) _a.call(dotPaths_1);
217
+ }
218
+ finally { if (e_2) throw e_2.error; }
219
+ }
220
+ return stripped;
221
+ };
222
+ /**
223
+ * Resolve the `populate` tool argument against the model router's declared paths.
224
+ *
225
+ * REST never lets a caller choose populate paths — population comes entirely from
226
+ * `options.populatePaths`, whose `fields` limit which columns of the referenced document
227
+ * are exposed. An arbitrary path from an MCP client would bypass that limit and return
228
+ * whole referenced documents, so a requested path must match a declared one. Requesting
229
+ * paths only narrows the set; anything undeclared is an error rather than a silent widen.
230
+ */
231
+ var resolvePopulatePaths = function (populateStr, declaredPaths) {
232
+ var e_4, _a;
233
+ var declared = declaredPaths !== null && declaredPaths !== void 0 ? declaredPaths : [];
234
+ if (!populateStr) {
235
+ return { paths: declared };
236
+ }
237
+ var requested = populateStr
238
+ .split(",")
239
+ .map(function (path) { return path.trim(); })
240
+ .filter(Boolean);
241
+ if (!requested.length) {
242
+ return { paths: declared };
243
+ }
244
+ var paths = [];
245
+ var _loop_1 = function (path) {
246
+ var match = declared.find(function (declaredPath) { return declaredPath.path === path; });
247
+ if (!match) {
248
+ var allowed = declared.map(function (declaredPath) { return declaredPath.path; }).join(", ");
249
+ return { value: {
250
+ error: allowed
251
+ ? "".concat(path, " is not a populate-able path. Allowed: ").concat(allowed)
252
+ : "".concat(path, " is not a populate-able path. This model has no populate-able paths"),
253
+ } };
254
+ }
255
+ if (!paths.includes(match)) {
256
+ paths.push(match);
257
+ }
258
+ };
259
+ try {
260
+ for (var requested_1 = __values(requested), requested_1_1 = requested_1.next(); !requested_1_1.done; requested_1_1 = requested_1.next()) {
261
+ var path = requested_1_1.value;
262
+ var state_1 = _loop_1(path);
263
+ if (typeof state_1 === "object")
264
+ return state_1.value;
265
+ }
266
+ }
267
+ catch (e_4_1) { e_4 = { error: e_4_1 }; }
268
+ finally {
269
+ try {
270
+ if (requested_1_1 && !requested_1_1.done && (_a = requested_1.return)) _a.call(requested_1);
271
+ }
272
+ finally { if (e_4) throw e_4.error; }
273
+ }
274
+ return { paths: paths };
275
+ };
276
+ var asOptionalString = function (value) {
277
+ return typeof value === "string" ? value : undefined;
278
+ };
279
+ /**
280
+ * Remove denylisted keys from an MCP create/update body.
281
+ *
282
+ * Matches response redaction: a bare name is deleted at every depth (including
283
+ * Mixed/embedded objects and arrays), and a dotted path is deleted at that
284
+ * location only. The incoming args object is not mutated.
285
+ */
286
+ var omitDeniedWriteFields = function (body, denied) {
287
+ if (denied.length === 0) {
288
+ return body;
289
+ }
290
+ return stripExcludedFields(body, denied);
291
+ };
292
+ /** Mongoose's populated query result types don't narrow to a single document. */
293
+ var asDocument = function (result) {
294
+ return (result !== null && result !== void 0 ? result : null);
295
+ };
296
+ /**
297
+ * Run a findById query and map Mongoose CastError (malformed ids) to null so
298
+ * callers can return a structured not-found. 24-hex ids with mixed case are
299
+ * valid for findById even though `isValidObjectId` requires canonical lowercase.
300
+ */
301
+ var execFindByIdQuery = function (query) { return __awaiter(void 0, void 0, void 0, function () {
302
+ var _a, error_1;
303
+ return __generator(this, function (_b) {
304
+ switch (_b.label) {
305
+ case 0:
306
+ _b.trys.push([0, 2, , 3]);
307
+ _a = asDocument;
308
+ return [4 /*yield*/, query.exec()];
309
+ case 1: return [2 /*return*/, _a.apply(void 0, [_b.sent()])];
310
+ case 2:
311
+ error_1 = _b.sent();
312
+ if (error_1 instanceof mongoose_1.default.Error.CastError) {
313
+ return [2 /*return*/, null];
314
+ }
315
+ throw error_1;
316
+ case 3: return [2 /*return*/];
317
+ }
318
+ });
319
+ }); };
320
+ var missingDocumentResult = function (id) {
321
+ return errorResult("Document ".concat(id, " not found"));
322
+ };
323
+ /**
324
+ * Mirror REST's `authenticateMiddleware(options.allowAnonymous)`, which answers 401 before
325
+ * any permission check when credentials are missing. Without this, read-only helpers like
326
+ * `IsAuthenticatedOrReadOnly` would let an anonymous MCP client list or read data that the
327
+ * same router refuses over HTTP.
328
+ */
329
+ var requiresAuthentication = function (entry, user) {
330
+ return !user && entry.options.allowAnonymous !== true;
331
+ };
332
+ var hookFailureResult = function (label, error) {
333
+ if ((0, errors_1.isAPIError)(error)) {
334
+ return errorResult(error.title, error);
335
+ }
336
+ return errorResult("".concat(label, ": ").concat(errorMessage(error)), error);
337
+ };
338
+ var serializeResponse = function (data, method, entry, user) { return __awaiter(void 0, void 0, void 0, function () {
339
+ var excludeFields, result_1, responseHandler, result, error_2;
340
+ var _a, _b;
341
+ return __generator(this, function (_c) {
342
+ switch (_c.label) {
343
+ case 0:
344
+ _c.trys.push([0, 4, , 5]);
345
+ excludeFields = (_a = entry.config.excludeFields) !== null && _a !== void 0 ? _a : [];
346
+ if (!entry.config.mcpResponseHandler) return [3 /*break*/, 2];
347
+ return [4 /*yield*/, entry.config.mcpResponseHandler(data, method, user)];
348
+ case 1:
349
+ result_1 = _c.sent();
350
+ return [2 /*return*/, { value: stripExcludedFields(result_1, excludeFields) }];
351
+ case 2:
352
+ responseHandler = (_b = entry.options.responseHandler) !== null && _b !== void 0 ? _b : transformers_1.defaultResponseHandler;
353
+ return [4 /*yield*/, responseHandler(data, method, (0, createMCPRequest_1.createMCPRequest)({ user: user }), entry.options)];
354
+ case 3:
355
+ result = _c.sent();
356
+ return [2 /*return*/, { value: stripExcludedFields(result, excludeFields) }];
357
+ case 4:
358
+ error_2 = _c.sent();
359
+ if ((0, errors_1.isAPIError)(error_2)) {
360
+ return [2 /*return*/, { error: errorResult(error_2.title, error_2) }];
361
+ }
362
+ return [2 /*return*/, { error: errorResult("Response handler failed: ".concat(errorMessage(error_2)), error_2) }];
363
+ case 5: return [2 /*return*/];
364
+ }
365
+ });
366
+ }); };
367
+ var handleList = function (entry, args, user) { return __awaiter(void 0, void 0, void 0, function () {
368
+ var model, config, options, maxLimit, _a, queryError, builtFilter, query, filtered, error_3, limit, page, builtQuery, total, sort, _b, populateError, populatePaths, populatedQuery, data, more, sliced, serialized;
369
+ var _c, _d;
370
+ return __generator(this, function (_e) {
371
+ switch (_e.label) {
372
+ case 0:
373
+ model = entry.model, config = entry.config, options = entry.options;
374
+ maxLimit = (_c = config.maxLimit) !== null && _c !== void 0 ? _c : 50;
375
+ if (requiresAuthentication(entry, user)) {
376
+ return [2 /*return*/, errorResult("Permission denied: authentication required")];
377
+ }
378
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)("list", options.permissions.list, user)];
379
+ case 1:
380
+ // Check permissions
381
+ if (!(_e.sent())) {
382
+ return [2 /*return*/, errorResult("Permission denied: cannot list")];
383
+ }
384
+ _a = (0, query_1.buildListQuery)({ args: args, config: config, options: options }), queryError = _a.error, builtFilter = _a.query;
385
+ if (queryError || !builtFilter) {
386
+ return [2 /*return*/, errorResult(queryError !== null && queryError !== void 0 ? queryError : "Could not build query")];
387
+ }
388
+ query = builtFilter;
389
+ if (!options.queryFilter) return [3 /*break*/, 5];
390
+ _e.label = 2;
391
+ case 2:
392
+ _e.trys.push([2, 4, , 5]);
393
+ return [4 /*yield*/, options.queryFilter(user, query)];
394
+ case 3:
395
+ filtered = _e.sent();
396
+ if (filtered === null) {
397
+ return [2 /*return*/, textResult(JSON.stringify({ data: [], more: false, page: 1, total: 0 }))];
398
+ }
399
+ query = __assign(__assign({}, query), filtered);
400
+ return [3 /*break*/, 5];
401
+ case 4:
402
+ error_3 = _e.sent();
403
+ if ((0, errors_1.isAPIError)(error_3)) {
404
+ return [2 /*return*/, errorResult(error_3.title, error_3)];
405
+ }
406
+ return [2 /*return*/, errorResult("queryFilter failed: ".concat(errorMessage(error_3)), error_3)];
407
+ case 5:
408
+ limit = Math.max(1, Math.min(Number(args.limit) || maxLimit, maxLimit));
409
+ page = Math.max(1, Number(args.page) || 1);
410
+ builtQuery = model.find(query).limit(limit + 1);
411
+ return [4 /*yield*/, model.countDocuments(query)];
412
+ case 6:
413
+ total = _e.sent();
414
+ if (page > 1) {
415
+ builtQuery = builtQuery.skip((page - 1) * limit);
416
+ }
417
+ sort = (_d = asOptionalString(args.sort)) !== null && _d !== void 0 ? _d : options.sort;
418
+ if (sort) {
419
+ builtQuery = builtQuery.sort(sort);
420
+ }
421
+ _b = resolvePopulatePaths(asOptionalString(args.populate), options.populatePaths), populateError = _b.error, populatePaths = _b.paths;
422
+ if (populateError || !populatePaths) {
423
+ return [2 /*return*/, errorResult(populateError !== null && populateError !== void 0 ? populateError : "Could not resolve populate paths")];
424
+ }
425
+ populatedQuery = (0, api_1.addPopulateToQuery)(builtQuery, populatePaths);
426
+ return [4 /*yield*/, populatedQuery.exec()];
427
+ case 7:
428
+ data = _e.sent();
429
+ more = data.length > limit;
430
+ sliced = more ? data.slice(0, limit) : data;
431
+ return [4 /*yield*/, serializeResponse(sliced, "list", entry, user)];
432
+ case 8:
433
+ serialized = _e.sent();
434
+ if ("error" in serialized) {
435
+ return [2 /*return*/, serialized.error];
436
+ }
437
+ return [2 /*return*/, textResult(JSON.stringify({ data: serialized.value, more: more, page: page, total: total }))];
438
+ }
439
+ });
440
+ }); };
441
+ exports.handleList = handleList;
442
+ var handleRead = function (entry, args, user) { return __awaiter(void 0, void 0, void 0, function () {
443
+ var model, options, _a, populateError, populatePaths, id, data, serialized;
444
+ return __generator(this, function (_b) {
445
+ switch (_b.label) {
446
+ case 0:
447
+ model = entry.model, options = entry.options;
448
+ if (requiresAuthentication(entry, user)) {
449
+ return [2 /*return*/, errorResult("Permission denied: authentication required")];
450
+ }
451
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)("read", options.permissions.read, user)];
452
+ case 1:
453
+ // Check method-level permission
454
+ if (!(_b.sent())) {
455
+ return [2 /*return*/, errorResult("Permission denied: cannot read")];
456
+ }
457
+ _a = resolvePopulatePaths(asOptionalString(args.populate), options.populatePaths), populateError = _a.error, populatePaths = _a.paths;
458
+ if (populateError || !populatePaths) {
459
+ return [2 /*return*/, errorResult(populateError !== null && populateError !== void 0 ? populateError : "Could not resolve populate paths")];
460
+ }
461
+ id = asOptionalString(args.id);
462
+ if (!id) {
463
+ return [2 /*return*/, missingDocumentResult(args.id)];
464
+ }
465
+ return [4 /*yield*/, execFindByIdQuery((0, api_1.addPopulateToQuery)(model.findById(id), populatePaths))];
466
+ case 2:
467
+ data = _b.sent();
468
+ if (!data) {
469
+ return [2 /*return*/, missingDocumentResult(id)];
470
+ }
471
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)("read", options.permissions.read, user, data)];
472
+ case 3:
473
+ // Check object-level permission
474
+ if (!(_b.sent())) {
475
+ return [2 /*return*/, errorResult("Permission denied: cannot read this document")];
476
+ }
477
+ return [4 /*yield*/, serializeResponse(data, "read", entry, user)];
478
+ case 4:
479
+ serialized = _b.sent();
480
+ if ("error" in serialized) {
481
+ return [2 /*return*/, serialized.error];
482
+ }
483
+ return [2 /*return*/, textResult(JSON.stringify({ data: serialized.value }))];
484
+ }
485
+ });
486
+ }); };
487
+ exports.handleRead = handleRead;
488
+ var handleCreate = function (entry, args, user) { return __awaiter(void 0, void 0, void 0, function () {
489
+ var model, options, body, error_4, error_5, data, _a, error_6, populateQuery, _b, error_7, serialized;
490
+ return __generator(this, function (_c) {
491
+ switch (_c.label) {
492
+ case 0:
493
+ model = entry.model, options = entry.options;
494
+ if (requiresAuthentication(entry, user)) {
495
+ return [2 /*return*/, errorResult("Permission denied: authentication required")];
496
+ }
497
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)("create", options.permissions.create, user)];
498
+ case 1:
499
+ if (!(_c.sent())) {
500
+ return [2 /*return*/, errorResult("Permission denied: cannot create")];
501
+ }
502
+ body = omitDeniedWriteFields(args, (0, schemaGenerator_1.writeExcludeFields)(entry.config, (0, schemaGenerator_1.restWriteExcludeFields)("create", options.validation)));
503
+ try {
504
+ body = (0, transformers_1.transform)(options, body, "create", user);
505
+ }
506
+ catch (error) {
507
+ return [2 /*return*/, errorResult("Transform failed: ".concat(errorMessage(error)), error)];
508
+ }
509
+ if (!options.preCreate) return [3 /*break*/, 5];
510
+ _c.label = 2;
511
+ case 2:
512
+ _c.trys.push([2, 4, , 5]);
513
+ return [4 /*yield*/, options.preCreate(body, (0, createMCPRequest_1.createMCPRequest)({ body: body, user: user }))];
514
+ case 3:
515
+ body = _c.sent();
516
+ if (body === null || body === undefined) {
517
+ return [2 /*return*/, errorResult("Create not allowed")];
518
+ }
519
+ return [3 /*break*/, 5];
520
+ case 4:
521
+ error_4 = _c.sent();
522
+ return [2 /*return*/, hookFailureResult("preCreate hook failed", error_4)];
523
+ case 5:
524
+ body = (0, auth_1.omitUserRolesFromWriteBody)(entry.modelName, options.accessControl, body);
525
+ _c.label = 6;
526
+ case 6:
527
+ _c.trys.push([6, 8, , 9]);
528
+ return [4 /*yield*/, (0, modelRouterAccess_1.validateAccessWritePayload)({
529
+ body: body,
530
+ options: options,
531
+ phase: "create",
532
+ user: user,
533
+ })];
534
+ case 7:
535
+ _c.sent();
536
+ return [3 /*break*/, 9];
537
+ case 8:
538
+ error_5 = _c.sent();
539
+ if ((0, errors_1.isAPIError)(error_5)) {
540
+ return [2 /*return*/, errorResult(error_5.title, error_5)];
541
+ }
542
+ return [2 /*return*/, errorResult("Write validation failed: ".concat(errorMessage(error_5)), error_5)];
543
+ case 9:
544
+ _c.trys.push([9, 11, , 12]);
545
+ _a = asDocument;
546
+ return [4 /*yield*/, model.create(body)];
547
+ case 10:
548
+ data = _a.apply(void 0, [_c.sent()]);
549
+ return [3 /*break*/, 12];
550
+ case 11:
551
+ error_6 = _c.sent();
552
+ return [2 /*return*/, errorResult("Create failed: ".concat(errorMessage(error_6)), error_6)];
553
+ case 12:
554
+ if (!options.populatePaths) return [3 /*break*/, 14];
555
+ populateQuery = (0, api_1.addPopulateToQuery)(model.findById(data === null || data === void 0 ? void 0 : data._id), options.populatePaths);
556
+ _b = asDocument;
557
+ return [4 /*yield*/, populateQuery.exec()];
558
+ case 13:
559
+ data = _b.apply(void 0, [_c.sent()]);
560
+ _c.label = 14;
561
+ case 14:
562
+ if (!options.postCreate) return [3 /*break*/, 18];
563
+ _c.label = 15;
564
+ case 15:
565
+ _c.trys.push([15, 17, , 18]);
566
+ return [4 /*yield*/, options.postCreate(data, (0, createMCPRequest_1.createMCPRequest)({ body: body, user: user }))];
567
+ case 16:
568
+ _c.sent();
569
+ return [3 /*break*/, 18];
570
+ case 17:
571
+ error_7 = _c.sent();
572
+ return [2 /*return*/, hookFailureResult("postCreate hook failed", error_7)];
573
+ case 18: return [4 /*yield*/, serializeResponse(data, "create", entry, user)];
574
+ case 19:
575
+ serialized = _c.sent();
576
+ if ("error" in serialized) {
577
+ return [2 /*return*/, serialized.error];
578
+ }
579
+ return [2 /*return*/, textResult(JSON.stringify({ data: serialized.value }))];
580
+ }
581
+ });
582
+ }); };
583
+ exports.handleCreate = handleCreate;
584
+ var handleUpdate = function (entry, args, user) { return __awaiter(void 0, void 0, void 0, function () {
585
+ var model, options, id, updateFields, documentId, doc, body, error_8, error_9, prevDoc, error_10, populateQuery, _a, error_11, serialized;
586
+ return __generator(this, function (_b) {
587
+ switch (_b.label) {
588
+ case 0:
589
+ model = entry.model, options = entry.options;
590
+ id = args.id, updateFields = __rest(args, ["id"]);
591
+ if (requiresAuthentication(entry, user)) {
592
+ return [2 /*return*/, errorResult("Permission denied: authentication required")];
593
+ }
594
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)("update", options.permissions.update, user)];
595
+ case 1:
596
+ if (!(_b.sent())) {
597
+ return [2 /*return*/, errorResult("Permission denied: cannot update")];
598
+ }
599
+ documentId = asOptionalString(id);
600
+ if (!documentId) {
601
+ return [2 /*return*/, missingDocumentResult(id)];
602
+ }
603
+ return [4 /*yield*/, execFindByIdQuery((0, api_1.addPopulateToQuery)(model.findById(documentId), options.populatePaths))];
604
+ case 2:
605
+ doc = _b.sent();
606
+ if (!doc) {
607
+ return [2 /*return*/, missingDocumentResult(documentId)];
608
+ }
609
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)("update", options.permissions.update, user, doc)];
610
+ case 3:
611
+ if (!(_b.sent())) {
612
+ return [2 /*return*/, errorResult("Permission denied: cannot update this document")];
613
+ }
614
+ body = omitDeniedWriteFields(updateFields, (0, schemaGenerator_1.writeExcludeFields)(entry.config, (0, schemaGenerator_1.restWriteExcludeFields)("update", options.validation)));
615
+ try {
616
+ body = (0, transformers_1.transform)(options, body, "update", user);
617
+ }
618
+ catch (error) {
619
+ return [2 /*return*/, errorResult("Transform failed: ".concat(errorMessage(error)), error)];
620
+ }
621
+ if (!options.preUpdate) return [3 /*break*/, 7];
622
+ _b.label = 4;
623
+ case 4:
624
+ _b.trys.push([4, 6, , 7]);
625
+ return [4 /*yield*/, options.preUpdate(body, (0, createMCPRequest_1.createMCPRequest)({ body: body, user: user }))];
626
+ case 5:
627
+ body = _b.sent();
628
+ if (body === null || body === undefined) {
629
+ return [2 /*return*/, errorResult("Update not allowed")];
630
+ }
631
+ return [3 /*break*/, 7];
632
+ case 6:
633
+ error_8 = _b.sent();
634
+ return [2 /*return*/, hookFailureResult("preUpdate hook failed", error_8)];
635
+ case 7:
636
+ body = (0, auth_1.omitUserRolesFromWriteBody)(entry.modelName, options.accessControl, body);
637
+ _b.label = 8;
638
+ case 8:
639
+ _b.trys.push([8, 10, , 11]);
640
+ return [4 /*yield*/, (0, modelRouterAccess_1.validateAccessWritePayload)({
641
+ body: body,
642
+ doc: doc,
643
+ options: options,
644
+ phase: "write",
645
+ user: user,
646
+ })];
647
+ case 9:
648
+ _b.sent();
649
+ return [3 /*break*/, 11];
650
+ case 10:
651
+ error_9 = _b.sent();
652
+ if ((0, errors_1.isAPIError)(error_9)) {
653
+ return [2 /*return*/, errorResult(error_9.title, error_9)];
654
+ }
655
+ return [2 /*return*/, errorResult("Write validation failed: ".concat(errorMessage(error_9)), error_9)];
656
+ case 11:
657
+ prevDoc = doc.toObject();
658
+ _b.label = 12;
659
+ case 12:
660
+ _b.trys.push([12, 14, , 15]);
661
+ doc.set(body);
662
+ return [4 /*yield*/, doc.save()];
663
+ case 13:
664
+ _b.sent();
665
+ return [3 /*break*/, 15];
666
+ case 14:
667
+ error_10 = _b.sent();
668
+ return [2 /*return*/, errorResult("Update failed: ".concat(errorMessage(error_10)), error_10)];
669
+ case 15:
670
+ if (!options.populatePaths) return [3 /*break*/, 17];
671
+ populateQuery = (0, api_1.addPopulateToQuery)(model.findById(doc._id), options.populatePaths);
672
+ _a = asDocument;
673
+ return [4 /*yield*/, populateQuery.exec()];
674
+ case 16:
675
+ doc = _a.apply(void 0, [_b.sent()]);
676
+ _b.label = 17;
677
+ case 17:
678
+ if (!options.postUpdate) return [3 /*break*/, 21];
679
+ _b.label = 18;
680
+ case 18:
681
+ _b.trys.push([18, 20, , 21]);
682
+ return [4 /*yield*/, options.postUpdate(doc, body, (0, createMCPRequest_1.createMCPRequest)({ body: body, user: user }), prevDoc)];
683
+ case 19:
684
+ _b.sent();
685
+ return [3 /*break*/, 21];
686
+ case 20:
687
+ error_11 = _b.sent();
688
+ return [2 /*return*/, hookFailureResult("postUpdate hook failed", error_11)];
689
+ case 21: return [4 /*yield*/, serializeResponse(doc, "update", entry, user)];
690
+ case 22:
691
+ serialized = _b.sent();
692
+ if ("error" in serialized) {
693
+ return [2 /*return*/, serialized.error];
694
+ }
695
+ return [2 /*return*/, textResult(JSON.stringify({ data: serialized.value }))];
696
+ }
697
+ });
698
+ }); };
699
+ exports.handleUpdate = handleUpdate;
700
+ var handleDelete = function (entry, args, user) { return __awaiter(void 0, void 0, void 0, function () {
701
+ var model, options, id, documentId, doc, result, error_12, error_13, error_14;
702
+ return __generator(this, function (_a) {
703
+ switch (_a.label) {
704
+ case 0:
705
+ model = entry.model, options = entry.options;
706
+ id = args.id;
707
+ if (requiresAuthentication(entry, user)) {
708
+ return [2 /*return*/, errorResult("Permission denied: authentication required")];
709
+ }
710
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)("delete", options.permissions.delete, user)];
711
+ case 1:
712
+ if (!(_a.sent())) {
713
+ return [2 /*return*/, errorResult("Permission denied: cannot delete")];
714
+ }
715
+ documentId = asOptionalString(id);
716
+ if (!documentId) {
717
+ return [2 /*return*/, missingDocumentResult(id)];
718
+ }
719
+ return [4 /*yield*/, execFindByIdQuery((0, api_1.addPopulateToQuery)(model.findById(documentId), options.populatePaths))];
720
+ case 2:
721
+ doc = _a.sent();
722
+ if (!doc) {
723
+ return [2 /*return*/, missingDocumentResult(documentId)];
724
+ }
725
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)("delete", options.permissions.delete, user, doc)];
726
+ case 3:
727
+ if (!(_a.sent())) {
728
+ return [2 /*return*/, errorResult("Permission denied: cannot delete this document")];
729
+ }
730
+ if (!options.preDelete) return [3 /*break*/, 7];
731
+ _a.label = 4;
732
+ case 4:
733
+ _a.trys.push([4, 6, , 7]);
734
+ return [4 /*yield*/, options.preDelete(doc, (0, createMCPRequest_1.createMCPRequest)({ body: args, user: user }))];
735
+ case 5:
736
+ result = _a.sent();
737
+ if (result === null || result === undefined) {
738
+ return [2 /*return*/, errorResult("Delete not allowed")];
739
+ }
740
+ return [3 /*break*/, 7];
741
+ case 6:
742
+ error_12 = _a.sent();
743
+ return [2 /*return*/, hookFailureResult("preDelete hook failed", error_12)];
744
+ case 7:
745
+ _a.trys.push([7, 12, , 13]);
746
+ if (!(Object.keys(model.schema.paths).includes("deleted") &&
747
+ model.schema.paths.deleted.instance === "Boolean")) return [3 /*break*/, 9];
748
+ doc.deleted = true;
749
+ return [4 /*yield*/, doc.save()];
750
+ case 8:
751
+ _a.sent();
752
+ return [3 /*break*/, 11];
753
+ case 9: return [4 /*yield*/, doc.deleteOne()];
754
+ case 10:
755
+ _a.sent();
756
+ _a.label = 11;
757
+ case 11: return [3 /*break*/, 13];
758
+ case 12:
759
+ error_13 = _a.sent();
760
+ return [2 /*return*/, errorResult("Delete failed: ".concat(errorMessage(error_13)), error_13)];
761
+ case 13:
762
+ if (!options.postDelete) return [3 /*break*/, 17];
763
+ _a.label = 14;
764
+ case 14:
765
+ _a.trys.push([14, 16, , 17]);
766
+ return [4 /*yield*/, options.postDelete((0, createMCPRequest_1.createMCPRequest)({ body: args, user: user }), doc)];
767
+ case 15:
768
+ _a.sent();
769
+ return [3 /*break*/, 17];
770
+ case 16:
771
+ error_14 = _a.sent();
772
+ return [2 /*return*/, hookFailureResult("postDelete hook failed", error_14)];
773
+ case 17: return [2 /*return*/, textResult(JSON.stringify({ success: true }))];
774
+ }
775
+ });
776
+ }); };
777
+ exports.handleDelete = handleDelete;
778
+ var errorMessage = function (error) {
779
+ return error instanceof Error ? error.message : String(error);
780
+ };
781
+ var textResult = function (text) { return ({
782
+ content: [{ text: text, type: "text" }],
783
+ }); };
784
+ var errorResult = function (message, cause) {
785
+ var result = {
786
+ content: [{ text: JSON.stringify({ error: message }), type: "text" }],
787
+ isError: true,
788
+ };
789
+ if (cause !== undefined) {
790
+ errorCauses.set(result, cause);
791
+ }
792
+ return result;
793
+ };