@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,379 @@
1
+ "use strict";
2
+ var __read = (this && this.__read) || function (o, n) {
3
+ var m = typeof Symbol === "function" && o[Symbol.iterator];
4
+ if (!m) return o;
5
+ var i = m.call(o), r, ar = [], e;
6
+ try {
7
+ while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
8
+ }
9
+ catch (error) { e = { error: error }; }
10
+ finally {
11
+ try {
12
+ if (r && !r.done && (m = i["return"])) m.call(i);
13
+ }
14
+ finally { if (e) throw e.error; }
15
+ }
16
+ return ar;
17
+ };
18
+ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
19
+ if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
20
+ if (ar || !(i in from)) {
21
+ if (!ar) ar = Array.prototype.slice.call(from, 0, i);
22
+ ar[i] = from[i];
23
+ }
24
+ }
25
+ return to.concat(ar || Array.prototype.slice.call(from));
26
+ };
27
+ var __values = (this && this.__values) || function(o) {
28
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
29
+ if (m) return m.call(o);
30
+ if (o && typeof o.length === "number") return {
31
+ next: function () {
32
+ if (o && i >= o.length) o = void 0;
33
+ return { value: o && o[i++], done: !o };
34
+ }
35
+ };
36
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
37
+ };
38
+ Object.defineProperty(exports, "__esModule", { value: true });
39
+ exports.generateToolDescription = exports.generateInputSchema = exports.writeExcludeFields = exports.restWriteExcludeFields = exports.isFieldExcluded = void 0;
40
+ var zod_1 = require("zod");
41
+ var SYSTEM_FIELDS = new Set(["_id", "id", "__v", "created", "updated", "deleted"]);
42
+ /** Shown to the calling LLM so it knows filters accept Mongo comparison operators. */
43
+ var OPERATOR_HINT = "{\"$in\": [...]} or {\"$gte\": ...}";
44
+ /** Operators an LLM may use in a list filter, kept in sync with ALLOWED_FIELD_OPERATORS. */
45
+ var DOCUMENTED_FIELD_OPERATORS = "$eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $exists, $regex";
46
+ var mongooseTypeToZod = function (schemaPath) {
47
+ var _a, _b;
48
+ var instance = schemaPath.instance;
49
+ switch (instance) {
50
+ case "String":
51
+ if ((_a = schemaPath.enumValues) === null || _a === void 0 ? void 0 : _a.length) {
52
+ var values = schemaPath.enumValues;
53
+ return zod_1.z.enum(values);
54
+ }
55
+ return zod_1.z.string();
56
+ case "Number":
57
+ return zod_1.z.number();
58
+ case "Boolean":
59
+ return zod_1.z.boolean();
60
+ case "Date":
61
+ return zod_1.z.string().describe("ISO 8601 date string");
62
+ case "ObjectId":
63
+ case "ObjectID":
64
+ return zod_1.z
65
+ .string()
66
+ .describe(((_b = schemaPath.options) === null || _b === void 0 ? void 0 : _b.ref) ? "ObjectId reference to ".concat(schemaPath.options.ref) : "ObjectId");
67
+ case "Array": {
68
+ if (schemaPath.schema) {
69
+ // Array of subdocuments
70
+ return zod_1.z.array(zod_1.z.record(zod_1.z.string(), zod_1.z.any())).describe("Array of subdocuments");
71
+ }
72
+ // Array of primitives
73
+ var caster = schemaPath.caster;
74
+ if (caster) {
75
+ var innerType = mongooseTypeToZod({
76
+ instance: caster.instance,
77
+ options: caster.options,
78
+ });
79
+ return zod_1.z.array(innerType);
80
+ }
81
+ return zod_1.z.array(zod_1.z.any());
82
+ }
83
+ case "Mixed":
84
+ case "Map":
85
+ return zod_1.z.record(zod_1.z.string(), zod_1.z.any());
86
+ case "Embedded":
87
+ return zod_1.z.record(zod_1.z.string(), zod_1.z.any()).describe("Embedded document");
88
+ default:
89
+ return zod_1.z.any();
90
+ }
91
+ };
92
+ var isFieldExcluded = function (fieldPath, excludeFields) {
93
+ return excludeFields.some(function (excluded) {
94
+ if (fieldPath === excluded) {
95
+ return true;
96
+ }
97
+ // Support dot-notation parent matching: excluding "metadata" excludes "metadata.secretKey"
98
+ if (fieldPath.startsWith("".concat(excluded, "."))) {
99
+ return true;
100
+ }
101
+ return false;
102
+ });
103
+ };
104
+ exports.isFieldExcluded = isFieldExcluded;
105
+ /**
106
+ * REST write denylist from `validation.excludeFromCreate` / `excludeFromUpdate`.
107
+ * MCP create/update must apply the same keys REST strips in `validateModelRequestBody`.
108
+ */
109
+ var restWriteExcludeFields = function (method, validation) {
110
+ var _a, _b;
111
+ if (typeof validation !== "object" || validation === null) {
112
+ return [];
113
+ }
114
+ var options = validation;
115
+ if (method === "create") {
116
+ return (_a = options.excludeFromCreate) !== null && _a !== void 0 ? _a : [];
117
+ }
118
+ if (method === "update") {
119
+ return (_b = options.excludeFromUpdate) !== null && _b !== void 0 ? _b : [];
120
+ }
121
+ return [];
122
+ };
123
+ exports.restWriteExcludeFields = restWriteExcludeFields;
124
+ /** MCP `excludeFields` plus REST write denylist — used for tool schemas and persist. */
125
+ var writeExcludeFields = function (config, restExcludeFields) {
126
+ var _a;
127
+ return __spreadArray(__spreadArray([], __read(((_a = config.excludeFields) !== null && _a !== void 0 ? _a : [])), false), __read(restExcludeFields), false);
128
+ };
129
+ exports.writeExcludeFields = writeExcludeFields;
130
+ var getModelFields = function (
131
+ // noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
132
+ // biome-ignore lint/suspicious/noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
133
+ model, excludeFields) {
134
+ var e_1, _a;
135
+ var _b;
136
+ var fields = [];
137
+ var schemaPaths = model.schema.paths;
138
+ try {
139
+ for (var _c = __values(Object.entries(schemaPaths)), _d = _c.next(); !_d.done; _d = _c.next()) {
140
+ var _e = __read(_d.value, 2), path = _e[0], rawSchemaPath = _e[1];
141
+ if (SYSTEM_FIELDS.has(path)) {
142
+ continue;
143
+ }
144
+ if ((0, exports.isFieldExcluded)(path, excludeFields)) {
145
+ continue;
146
+ }
147
+ var schemaPath = rawSchemaPath;
148
+ fields.push({
149
+ description: (_b = schemaPath.options) === null || _b === void 0 ? void 0 : _b.description,
150
+ path: path,
151
+ required: Boolean(schemaPath.isRequired),
152
+ schemaPath: schemaPath,
153
+ });
154
+ }
155
+ }
156
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
157
+ finally {
158
+ try {
159
+ if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
160
+ }
161
+ finally { if (e_1) throw e_1.error; }
162
+ }
163
+ return fields;
164
+ };
165
+ var generateInputSchema = function (
166
+ // noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
167
+ // biome-ignore lint/suspicious/noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
168
+ model, method, config, queryFields, populatePaths, restExcludeFields) {
169
+ var e_2, _a, e_3, _b, e_4, _c;
170
+ var _d;
171
+ if (restExcludeFields === void 0) { restExcludeFields = []; }
172
+ var excludeFields = (0, exports.writeExcludeFields)(config, restExcludeFields);
173
+ var populatable = (populatePaths !== null && populatePaths !== void 0 ? populatePaths : []).map(function (populatePath) { return populatePath.path; });
174
+ // Only the model router's declared paths can be populated, so omit the parameter
175
+ // entirely when there are none rather than inviting a request that must be refused.
176
+ var populateParam = populatable.length
177
+ ? zod_1.z
178
+ .string()
179
+ .optional()
180
+ .describe("Comma-separated subset of the populate-able paths: ".concat(populatable.join(", ")))
181
+ : undefined;
182
+ switch (method) {
183
+ case "create": {
184
+ var fields = getModelFields(model, excludeFields);
185
+ var shape = {};
186
+ try {
187
+ for (var fields_1 = __values(fields), fields_1_1 = fields_1.next(); !fields_1_1.done; fields_1_1 = fields_1.next()) {
188
+ var field = fields_1_1.value;
189
+ var zodType = mongooseTypeToZod(field.schemaPath);
190
+ if (field.description) {
191
+ zodType = zodType.describe(field.description);
192
+ }
193
+ shape[field.path] = field.required ? zodType : zodType.optional();
194
+ }
195
+ }
196
+ catch (e_2_1) { e_2 = { error: e_2_1 }; }
197
+ finally {
198
+ try {
199
+ if (fields_1_1 && !fields_1_1.done && (_a = fields_1.return)) _a.call(fields_1);
200
+ }
201
+ finally { if (e_2) throw e_2.error; }
202
+ }
203
+ return zod_1.z.object(shape);
204
+ }
205
+ case "update": {
206
+ var fields = getModelFields(model, excludeFields);
207
+ var shape = {
208
+ id: zod_1.z.string().describe("Document ID to update"),
209
+ };
210
+ try {
211
+ for (var fields_2 = __values(fields), fields_2_1 = fields_2.next(); !fields_2_1.done; fields_2_1 = fields_2.next()) {
212
+ var field = fields_2_1.value;
213
+ var zodType = mongooseTypeToZod(field.schemaPath);
214
+ if (field.description) {
215
+ zodType = zodType.describe(field.description);
216
+ }
217
+ shape[field.path] = zodType.optional();
218
+ }
219
+ }
220
+ catch (e_3_1) { e_3 = { error: e_3_1 }; }
221
+ finally {
222
+ try {
223
+ if (fields_2_1 && !fields_2_1.done && (_b = fields_2.return)) _b.call(fields_2);
224
+ }
225
+ finally { if (e_3) throw e_3.error; }
226
+ }
227
+ return zod_1.z.object(shape);
228
+ }
229
+ case "read": {
230
+ var shape = {
231
+ id: zod_1.z.string().describe("Document ID to read"),
232
+ };
233
+ if (populateParam) {
234
+ shape.populate = populateParam;
235
+ }
236
+ return zod_1.z.object(shape);
237
+ }
238
+ case "list": {
239
+ var shape = {
240
+ limit: zod_1.z
241
+ .number()
242
+ .optional()
243
+ .describe("Max items to return (default: ".concat((_d = config.maxLimit) !== null && _d !== void 0 ? _d : 50, ")")),
244
+ page: zod_1.z.number().optional().describe("Page number (1-based)"),
245
+ sort: zod_1.z.string().optional().describe("Sort field (prefix with - for descending)"),
246
+ };
247
+ if (populateParam) {
248
+ shape.populate = populateParam;
249
+ }
250
+ // Add queryFields as optional filter parameters
251
+ var filterableFields = (queryFields !== null && queryFields !== void 0 ? queryFields : []).filter(function (field) { return !(0, exports.isFieldExcluded)(field, excludeFields); });
252
+ try {
253
+ for (var filterableFields_1 = __values(filterableFields), filterableFields_1_1 = filterableFields_1.next(); !filterableFields_1_1.done; filterableFields_1_1 = filterableFields_1.next()) {
254
+ var field = filterableFields_1_1.value;
255
+ shape[field] = zod_1.z
256
+ .any()
257
+ .optional()
258
+ .describe("Filter by ".concat(field, ": an exact value or an operator object, e.g. ").concat(OPERATOR_HINT));
259
+ }
260
+ }
261
+ catch (e_4_1) { e_4 = { error: e_4_1 }; }
262
+ finally {
263
+ try {
264
+ if (filterableFields_1_1 && !filterableFields_1_1.done && (_c = filterableFields_1.return)) _c.call(filterableFields_1);
265
+ }
266
+ finally { if (e_4) throw e_4.error; }
267
+ }
268
+ if (filterableFields.length) {
269
+ var logicalDescription = "Combine filters on ".concat(filterableFields.join(", "), ", e.g. [{\"").concat(filterableFields[0], "\": ...}]");
270
+ shape.$and = zod_1.z
271
+ .array(zod_1.z.record(zod_1.z.string(), zod_1.z.any()))
272
+ .optional()
273
+ .describe("Match all of these filters. ".concat(logicalDescription));
274
+ shape.$or = zod_1.z
275
+ .array(zod_1.z.record(zod_1.z.string(), zod_1.z.any()))
276
+ .optional()
277
+ .describe("Match any of these filters. ".concat(logicalDescription));
278
+ }
279
+ return zod_1.z.object(shape);
280
+ }
281
+ case "delete":
282
+ return zod_1.z.object({
283
+ id: zod_1.z.string().describe("Document ID to delete"),
284
+ });
285
+ default:
286
+ return zod_1.z.object({});
287
+ }
288
+ };
289
+ exports.generateInputSchema = generateInputSchema;
290
+ var describeField = function (field) {
291
+ var _a, _b, _c;
292
+ var parts = [field.path];
293
+ var instance = field.schemaPath.instance;
294
+ // Type info
295
+ if (instance === "ObjectId" || instance === "ObjectID") {
296
+ var ref = (_a = field.schemaPath.options) === null || _a === void 0 ? void 0 : _a.ref;
297
+ parts.push(ref ? "(ref: ".concat(ref, ")") : "(ObjectId)");
298
+ }
299
+ else if (instance === "Array") {
300
+ if ((_b = field.schemaPath.caster) === null || _b === void 0 ? void 0 : _b.instance) {
301
+ parts.push("(".concat(field.schemaPath.caster.instance, "[])"));
302
+ }
303
+ else {
304
+ parts.push("(Array)");
305
+ }
306
+ }
307
+ else if (instance === "String" && ((_c = field.schemaPath.enumValues) === null || _c === void 0 ? void 0 : _c.length)) {
308
+ parts.push("(enum: ".concat(field.schemaPath.enumValues.join("|"), ")"));
309
+ }
310
+ else {
311
+ parts.push("(".concat(instance, ")"));
312
+ }
313
+ if (field.required) {
314
+ parts.push("required");
315
+ }
316
+ return parts.join(" ");
317
+ };
318
+ var generateToolDescription = function (
319
+ // noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
320
+ // biome-ignore lint/suspicious/noExplicitAny: Mongoose's invariant generics require any to accept arbitrary consumer models
321
+ model, method, config, queryFields, populatePaths, restExcludeFields) {
322
+ var _a;
323
+ if (restExcludeFields === void 0) { restExcludeFields = []; }
324
+ if (config.description) {
325
+ var methodPrefix = "".concat(method.charAt(0).toUpperCase()).concat(method.slice(1));
326
+ return "".concat(methodPrefix, ": ").concat(config.description);
327
+ }
328
+ var modelName = model.modelName;
329
+ var excludeFields = (0, exports.writeExcludeFields)(config, restExcludeFields);
330
+ var maxLimit = (_a = config.maxLimit) !== null && _a !== void 0 ? _a : 50;
331
+ switch (method) {
332
+ case "list": {
333
+ var parts = ["List ".concat(modelName, " items.")];
334
+ var availableQueryFields = queryFields === null || queryFields === void 0 ? void 0 : queryFields.filter(function (f) { return !(0, exports.isFieldExcluded)(f, excludeFields); });
335
+ if (availableQueryFields === null || availableQueryFields === void 0 ? void 0 : availableQueryFields.length) {
336
+ parts.push("Filterable by: ".concat(availableQueryFields.join(", "), "."));
337
+ parts.push("Filters accept an exact value or an operator object (".concat(DOCUMENTED_FIELD_OPERATORS, "), and can be combined with $and/$or."));
338
+ }
339
+ parts.push("Sortable. Paginated (max ".concat(maxLimit, ")."));
340
+ return parts.join(" ");
341
+ }
342
+ case "read": {
343
+ var parts = ["Read a single ".concat(modelName, " by ID.")];
344
+ // Only the model router's declared paths can be populated, so advertising every ref
345
+ // field would point the model at requests that are refused.
346
+ var fields_3 = getModelFields(model, excludeFields);
347
+ var refFields = (populatePaths !== null && populatePaths !== void 0 ? populatePaths : [])
348
+ .map(function (populatePath) { return fields_3.find(function (field) { return field.path === populatePath.path; }); })
349
+ .filter(function (field) { var _a; return Boolean((_a = field === null || field === void 0 ? void 0 : field.schemaPath.options) === null || _a === void 0 ? void 0 : _a.ref); });
350
+ if (refFields.length) {
351
+ parts.push("Populate-able refs: ".concat(refFields.map(function (f) { var _a; return "".concat(f.path, " (").concat((_a = f.schemaPath.options) === null || _a === void 0 ? void 0 : _a.ref, ")"); }).join(", "), "."));
352
+ }
353
+ return parts.join(" ");
354
+ }
355
+ case "create": {
356
+ var fields = getModelFields(model, excludeFields);
357
+ var parts = ["Create a new ".concat(modelName, ".")];
358
+ var fieldDescs = fields.map(describeField);
359
+ if (fieldDescs.length) {
360
+ parts.push("Fields: ".concat(fieldDescs.join(", "), "."));
361
+ }
362
+ return parts.join(" ");
363
+ }
364
+ case "update": {
365
+ var fields = getModelFields(model, excludeFields);
366
+ var parts = ["Update an existing ".concat(modelName, " by ID. Send only the fields to change.")];
367
+ var fieldNames = fields.map(function (f) { return f.path; });
368
+ if (fieldNames.length) {
369
+ parts.push("Updatable fields: ".concat(fieldNames.join(", "), "."));
370
+ }
371
+ return parts.join(" ");
372
+ }
373
+ case "delete":
374
+ return "Delete a ".concat(modelName, " by ID.");
375
+ default:
376
+ return "".concat(method, " on ").concat(modelName);
377
+ }
378
+ };
379
+ exports.generateToolDescription = generateToolDescription;
@@ -0,0 +1,8 @@
1
+ import type { Application } from "express";
2
+ import type { UserModel } from "../auth";
3
+ import type { BetterAuthInstance } from "../betterAuthSetup";
4
+ export interface MCPServerOptions {
5
+ userModel: UserModel;
6
+ betterAuth?: BetterAuthInstance;
7
+ }
8
+ export declare const mountMCPServer: (app: Application, options: MCPServerOptions) => void;
@@ -0,0 +1,133 @@
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
+ Object.defineProperty(exports, "__esModule", { value: true });
50
+ exports.mountMCPServer = void 0;
51
+ var node_1 = require("@modelcontextprotocol/node");
52
+ var server_1 = require("@modelcontextprotocol/server");
53
+ var logger_1 = require("../logger");
54
+ var requestContext_1 = require("../requestContext");
55
+ var auth_1 = require("./auth");
56
+ var toolGenerator_1 = require("./toolGenerator");
57
+ var mountMCPServer = function (app, options) {
58
+ var tools = (0, toolGenerator_1.getAllMCPTools)();
59
+ if (tools.length === 0) {
60
+ return;
61
+ }
62
+ var authContext = {
63
+ betterAuth: options.betterAuth,
64
+ userModel: options.userModel,
65
+ };
66
+ logger_1.logger.info("Mounting MCP server with ".concat(tools.length, " tools at /mcp"));
67
+ // The 2026-07-28 handler is stateless: it creates one server per request and also serves
68
+ // 2025-era clients through the SDK's stateless legacy fallback.
69
+ var handler = (0, server_1.createMcpHandler)(function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
70
+ var headers, user;
71
+ var requestInfo = _b.requestInfo;
72
+ return __generator(this, function (_c) {
73
+ switch (_c.label) {
74
+ case 0:
75
+ headers = {};
76
+ requestInfo === null || requestInfo === void 0 ? void 0 : requestInfo.headers.forEach(function (value, key) {
77
+ headers[key] = value;
78
+ });
79
+ return [4 /*yield*/, (0, auth_1.extractUserFromHeaders)(headers, authContext)];
80
+ case 1:
81
+ user = _c.sent();
82
+ if (user === null || user === void 0 ? void 0 : user.id) {
83
+ (0, requestContext_1.setRequestContext)({ userId: user.id });
84
+ }
85
+ return [2 /*return*/, createMcpServerInstance(tools, user)];
86
+ }
87
+ });
88
+ }); }, {
89
+ legacy: "stateless",
90
+ onerror: function (error) { return logger_1.logger.catch(error); },
91
+ responseMode: "auto",
92
+ });
93
+ var nodeHandler = (0, node_1.toNodeHandler)(handler);
94
+ app.all("/mcp", function (req, res) {
95
+ // express.json() consumed the request stream, so pass its parsed body explicitly.
96
+ void nodeHandler(req, res, req.body);
97
+ });
98
+ };
99
+ exports.mountMCPServer = mountMCPServer;
100
+ var createMcpServerInstance = function (tools, user) {
101
+ var e_1, _a;
102
+ var server = new server_1.McpServer({
103
+ name: "terreno-api-mcp",
104
+ version: "1.0.0",
105
+ }, {
106
+ capabilities: {
107
+ tools: {},
108
+ },
109
+ });
110
+ var _loop_1 = function (tool) {
111
+ server.registerTool(tool.name, {
112
+ description: tool.description,
113
+ inputSchema: tool.zodSchema,
114
+ }, function (args) { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
115
+ return [2 /*return*/, tool.handler(args, user)];
116
+ }); }); });
117
+ };
118
+ try {
119
+ // Register each tool with the MCP server
120
+ for (var tools_1 = __values(tools), tools_1_1 = tools_1.next(); !tools_1_1.done; tools_1_1 = tools_1.next()) {
121
+ var tool = tools_1_1.value;
122
+ _loop_1(tool);
123
+ }
124
+ }
125
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
126
+ finally {
127
+ try {
128
+ if (tools_1_1 && !tools_1_1.done && (_a = tools_1.return)) _a.call(tools_1);
129
+ }
130
+ finally { if (e_1) throw e_1.error; }
131
+ }
132
+ return server;
133
+ };
@@ -0,0 +1,14 @@
1
+ import { type ZodType } from "zod";
2
+ import type { User } from "../auth";
3
+ import type { MCPRegistryEntry, MCPToolArgs, MCPToolInputSchema, MCPToolResult } from "./types";
4
+ export interface MCPToolDefinition {
5
+ name: string;
6
+ description: string;
7
+ inputSchema: MCPToolInputSchema;
8
+ zodSchema: ZodType;
9
+ handler: (args: MCPToolArgs, user?: User) => Promise<MCPToolResult>;
10
+ }
11
+ export declare const generateToolsForEntry: (entry: MCPRegistryEntry) => MCPToolDefinition[];
12
+ export declare const generateAllTools: (entries: MCPRegistryEntry[]) => MCPToolDefinition[];
13
+ /** Model-router tools plus any custom tools registered with `registerMCPTool`. */
14
+ export declare const getAllMCPTools: () => MCPToolDefinition[];