@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
@@ -119,8 +119,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
119
119
  return (mod && mod.__esModule) ? mod : { "default": mod };
120
120
  };
121
121
  Object.defineProperty(exports, "__esModule", { value: true });
122
- // noExplicitAny: the harness bridges generic model/router/client types, mirroring integration.test.ts
123
- // biome-ignore-all lint/suspicious/noExplicitAny: the harness bridges generic model/router/client types, mirroring integration.test.ts
124
122
  /**
125
123
  * This is a manual load-generation script — NOT run by `bun test`. Invoke via
126
124
  * `bun run api:load` (see root package.json) or directly:
@@ -289,7 +287,7 @@ var makeHarnessClient = function (_a) {
289
287
  };
290
288
  /** Build the Express + Socket.io rig: synced model, SyncApp, RealtimeApp, listening server. */
291
289
  var buildRig = function (config) { return __awaiter(void 0, void 0, void 0, function () {
292
- var userSchema, UserModel, registration, app, realtimeApp, httpServer, port, baseUrl;
290
+ var userSchema, UserModel, registration, app, authUserModel, realtimeApp, httpServer, port, baseUrl;
293
291
  var _a, _b, _c, _d, _e;
294
292
  return __generator(this, function (_f) {
295
293
  switch (_f.label) {
@@ -323,8 +321,9 @@ var buildRig = function (config) { return __awaiter(void 0, void 0, void 0, func
323
321
  });
324
322
  app = (0, express_1.default)();
325
323
  app.use(express_1.default.json());
326
- (0, auth_1.setupAuth)(app, UserModel);
327
- (0, auth_1.addAuthRoutes)(app, UserModel);
324
+ authUserModel = UserModel;
325
+ (0, auth_1.setupAuth)(app, authUserModel);
326
+ (0, auth_1.addAuthRoutes)(app, authUserModel);
328
327
  new syncApp_1.SyncApp({}).register(app);
329
328
  app.use(registration.path, registration.router);
330
329
  realtimeApp = new realtimeApp_1.RealtimeApp({});
@@ -39,6 +39,11 @@ export declare const registerSync: <T>({ model, routePath, config, options, }: {
39
39
  config: SyncConfig;
40
40
  options: ModelRouterOptions<T>;
41
41
  }) => void;
42
+ /**
43
+ * Replace options on an existing sync registry entry after TerrenoApp injects
44
+ * accessControl and modelRouter resolves RBAC permissions.
45
+ */
46
+ export declare const updateSyncRegistryOptions: (routePath: string, options: ModelRouterOptions<unknown>) => void;
42
47
  /**
43
48
  * C8: await every enqueued sync index creation — per-model snapshot indexes from
44
49
  * `registerSync` plus the bookkeeping-model indexes from `SyncApp.register` — throwing on
@@ -36,7 +36,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
36
36
  }
37
37
  };
38
38
  Object.defineProperty(exports, "__esModule", { value: true });
39
- exports.clearSyncRegistry = exports.findSyncEntryByCollectionName = exports.findSyncEntryByCollectionTag = exports.findSyncEntryByModelName = exports.warnOnSyncScopesWithoutUserModel = exports.getSyncRegistry = exports.ensureSyncIndexes = exports.registerSync = exports.trackSyncIndexCreation = void 0;
39
+ exports.clearSyncRegistry = exports.findSyncEntryByCollectionName = exports.findSyncEntryByCollectionTag = exports.findSyncEntryByModelName = exports.warnOnSyncScopesWithoutUserModel = exports.getSyncRegistry = exports.ensureSyncIndexes = exports.updateSyncRegistryOptions = exports.registerSync = exports.trackSyncIndexCreation = void 0;
40
40
  var logger_1 = require("../logger");
41
41
  var streams_1 = require("./streams");
42
42
  var syncRegistry = [];
@@ -140,6 +140,18 @@ var registerSync = function (_a) {
140
140
  indexPromise.catch(function () { });
141
141
  };
142
142
  exports.registerSync = registerSync;
143
+ /**
144
+ * Replace options on an existing sync registry entry after TerrenoApp injects
145
+ * accessControl and modelRouter resolves RBAC permissions.
146
+ */
147
+ var updateSyncRegistryOptions = function (routePath, options) {
148
+ var existing = syncRegistry.find(function (entry) { return entry.routePath === routePath; });
149
+ if (!existing) {
150
+ return;
151
+ }
152
+ existing.options = options;
153
+ };
154
+ exports.updateSyncRegistryOptions = updateSyncRegistryOptions;
143
155
  /**
144
156
  * C8: await every enqueued sync index creation — per-model snapshot indexes from
145
157
  * `registerSync` plus the bookkeeping-model indexes from `SyncApp.register` — throwing on
@@ -87,8 +87,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
87
87
  };
88
88
  Object.defineProperty(exports, "__esModule", { value: true });
89
89
  exports.addSyncRoutes = exports.MAX_ENTITY_FETCH = exports.buildSnapshotScopeFilter = exports.serializeSyncDoc = exports.MAX_SYNC_HTTP_MUTATIONS_PER_SECOND = void 0;
90
- // noExplicitAny: sync routes operate generically across registered models
91
- // biome-ignore-all lint/suspicious/noExplicitAny: sync routes operate generically across registered models
92
90
  var express_1 = __importDefault(require("express"));
93
91
  var mongoose_1 = __importDefault(require("mongoose"));
94
92
  var api_1 = require("../api");
@@ -113,6 +111,13 @@ var syncBatch_2 = require("./syncBatch");
113
111
  Object.defineProperty(exports, "MAX_SYNC_HTTP_MUTATIONS_PER_SECOND", { enumerable: true, get: function () { return syncBatch_2.MAX_SYNC_MUTATIONS_PER_SECOND; } });
114
112
  var MAX_SNAPSHOT_LIMIT = 100;
115
113
  var DEFAULT_SNAPSHOT_LIMIT = 100;
114
+ /**
115
+ * Look up a registered model by name as a `SyncedModel`. `mongoose.model(name)` has no
116
+ * schema to infer from, so its static type carries none of the synced-document fields.
117
+ */
118
+ var getSyncedModel = function (modelName) {
119
+ return mongoose_1.default.model(modelName);
120
+ };
116
121
  /** HTTP status for each nack code returned by `POST /sync/mutate`. */
117
122
  var NACK_HTTP_STATUS = {
118
123
  conflict: 409,
@@ -372,12 +377,12 @@ var frontierBelowStreamHead = function (streamKey, frontierSeq) { return __await
372
377
  * Returns the page's entities plus the cursor to resume from and whether more remains.
373
378
  */
374
379
  var pageSeqStratum = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
375
- var user, seqFilter, query, docs, markers, page, markerPage, docsHaveMore, markersHaveMore, lastDocSeq, lastMarkerSeq, coveredSeq, docEntities, _c, _d, doc, allowed, isTombstone, _e, _f, _g, e_2_1, markerEntities, merged, entities, entitiesTruncated, frontierBelowHead, hasMore, advanceTo;
376
- var e_2, _h, _j;
377
- var _k, _l;
380
+ var user, seqFilter, query, docs, markers, page, markerPage, docsHaveMore, markersHaveMore, lastDocSeq, lastMarkerSeq, coveredSeq, docEntities, page_2, page_2_1, doc, allowed, isTombstone, _c, _d, _e, e_2_1, markerEntities, merged, entities, entitiesTruncated, frontierBelowHead, hasMore, advanceTo;
381
+ var e_2, _f, _g;
382
+ var _h, _j;
378
383
  var model = _b.model, scopeFilter = _b.scopeFilter, cursor = _b.cursor, limit = _b.limit, frontierSeq = _b.frontierSeq, streamKey = _b.streamKey, entry = _b.entry, req = _b.req;
379
- return __generator(this, function (_m) {
380
- switch (_m.label) {
384
+ return __generator(this, function (_k) {
385
+ switch (_k.label) {
381
386
  case 0:
382
387
  user = req.user;
383
388
  seqFilter = { _syncSeq: { $gt: cursor, $lte: frontierSeq } };
@@ -387,7 +392,7 @@ var pageSeqStratum = function (_a) { return __awaiter(void 0, [_a], void 0, func
387
392
  .sort({ _syncSeq: 1 })
388
393
  .limit(limit + 1)];
389
394
  case 1:
390
- docs = _m.sent();
395
+ docs = _k.sent();
391
396
  return [4 /*yield*/, models_1.SyncScopeMove.find({
392
397
  fromStream: streamKey,
393
398
  seq: { $gt: cursor, $lte: frontierSeq },
@@ -396,59 +401,59 @@ var pageSeqStratum = function (_a) { return __awaiter(void 0, [_a], void 0, func
396
401
  .limit(limit + 1)
397
402
  .lean()];
398
403
  case 2:
399
- markers = _m.sent();
404
+ markers = _k.sent();
400
405
  page = docs.slice(0, limit);
401
406
  markerPage = markers.slice(0, limit);
402
407
  docsHaveMore = docs.length > limit;
403
408
  markersHaveMore = markers.length > limit;
404
- lastDocSeq = page.length > 0 ? ((_k = page[page.length - 1]._syncSeq) !== null && _k !== void 0 ? _k : 0) : 0;
409
+ lastDocSeq = page.length > 0 ? ((_h = page[page.length - 1]._syncSeq) !== null && _h !== void 0 ? _h : 0) : 0;
405
410
  lastMarkerSeq = markerPage.length > 0 ? markerPage[markerPage.length - 1].seq : 0;
406
411
  coveredSeq = Math.min(docsHaveMore ? lastDocSeq : frontierSeq, markersHaveMore ? lastMarkerSeq : frontierSeq);
407
412
  docEntities = [];
408
- _m.label = 3;
413
+ _k.label = 3;
409
414
  case 3:
410
- _m.trys.push([3, 11, 12, 13]);
411
- _c = __values(page), _d = _c.next();
412
- _m.label = 4;
415
+ _k.trys.push([3, 11, 12, 13]);
416
+ page_2 = __values(page), page_2_1 = page_2.next();
417
+ _k.label = 4;
413
418
  case 4:
414
- if (!!_d.done) return [3 /*break*/, 10];
415
- doc = _d.value;
419
+ if (!!page_2_1.done) return [3 /*break*/, 10];
420
+ doc = page_2_1.value;
416
421
  return [4 /*yield*/, (0, permissions_1.checkPermissions)("read", entry.options.permissions.read, user, doc)];
417
422
  case 5:
418
- allowed = _m.sent();
423
+ allowed = _k.sent();
419
424
  if (!allowed) {
420
425
  return [3 /*break*/, 9];
421
426
  }
422
427
  isTombstone = Boolean(doc.deleted);
423
- _f = (_e = docEntities).push;
424
- _j = {};
428
+ _d = (_c = docEntities).push;
429
+ _g = {};
425
430
  if (!isTombstone) return [3 /*break*/, 6];
426
- _g = null;
431
+ _e = null;
427
432
  return [3 /*break*/, 8];
428
433
  case 6: return [4 /*yield*/, (0, exports.serializeSyncDoc)({ doc: doc, entry: entry, req: req })];
429
434
  case 7:
430
- _g = _m.sent();
431
- _m.label = 8;
435
+ _e = _k.sent();
436
+ _k.label = 8;
432
437
  case 8:
433
- _f.apply(_e, [(
438
+ _d.apply(_c, [(
434
439
  // C7: tombstones carry no data (privacy + payload growth) — only id/seq/deleted.
435
- _j.data = _g,
436
- _j.deleted = isTombstone,
437
- _j.id = String(doc._id),
438
- _j.seq = (_l = doc._syncSeq) !== null && _l !== void 0 ? _l : 0,
439
- _j)]);
440
- _m.label = 9;
440
+ _g.data = _e,
441
+ _g.deleted = isTombstone,
442
+ _g.id = String(doc._id),
443
+ _g.seq = (_j = doc._syncSeq) !== null && _j !== void 0 ? _j : 0,
444
+ _g)]);
445
+ _k.label = 9;
441
446
  case 9:
442
- _d = _c.next();
447
+ page_2_1 = page_2.next();
443
448
  return [3 /*break*/, 4];
444
449
  case 10: return [3 /*break*/, 13];
445
450
  case 11:
446
- e_2_1 = _m.sent();
451
+ e_2_1 = _k.sent();
447
452
  e_2 = { error: e_2_1 };
448
453
  return [3 /*break*/, 13];
449
454
  case 12:
450
455
  try {
451
- if (_d && !_d.done && (_h = _c.return)) _h.call(_c);
456
+ if (page_2_1 && !page_2_1.done && (_f = page_2.return)) _f.call(page_2);
452
457
  }
453
458
  finally { if (e_2) throw e_2.error; }
454
459
  return [7 /*endfinally*/];
@@ -465,7 +470,7 @@ var pageSeqStratum = function (_a) { return __awaiter(void 0, [_a], void 0, func
465
470
  entitiesTruncated = merged.length > entities.length;
466
471
  return [4 /*yield*/, frontierBelowStreamHead(streamKey, frontierSeq)];
467
472
  case 14:
468
- frontierBelowHead = _m.sent();
473
+ frontierBelowHead = _k.sent();
469
474
  hasMore = docsHaveMore || markersHaveMore || entitiesTruncated || frontierBelowHead;
470
475
  advanceTo = entitiesTruncated ? entities[entities.length - 1].seq : coveredSeq;
471
476
  return [2 /*return*/, { cursor: Math.max(cursor, Math.min(advanceTo, frontierSeq)), entities: entities, hasMore: hasMore }];
@@ -491,7 +496,7 @@ var castEntityIds = function (_a) {
491
496
  if (invalid.length > 0) {
492
497
  throw new errors_1.APIError({
493
498
  status: 400,
494
- title: "Invalid ids for ".concat(String(model.modelName), ": ").concat(invalid.join(",")),
499
+ title: "Invalid ids for ".concat(model.modelName, ": ").concat(invalid.join(",")),
495
500
  });
496
501
  }
497
502
  return ids.map(function (id) { return new mongoose_1.default.Types.ObjectId(id); });
@@ -655,7 +660,7 @@ var addSyncRoutes = function (app, options) {
655
660
  snapshotFilterResult: snapshotFilterResult,
656
661
  }),
657
662
  });
658
- model = mongoose_1.default.model(entry.modelName);
663
+ model = getSyncedModel(entry.modelName);
659
664
  return [4 /*yield*/, (0, models_1.computeStableFrontier)({ stream: streamKey })];
660
665
  case 7:
661
666
  frontierSeq = _d.sent();
@@ -788,7 +793,7 @@ var addSyncRoutes = function (app, options) {
788
793
  deniedResponse = { entities: [] };
789
794
  return [2 /*return*/, res.json(deniedResponse)];
790
795
  }
791
- model = mongoose_1.default.model(entry.modelName);
796
+ model = getSyncedModel(entry.modelName);
792
797
  castIds = castEntityIds({ ids: ids, model: model });
793
798
  return [4 /*yield*/, model.find(__assign(__assign({}, composeSyncReadFilter({
794
799
  queryFilter: queryFilterResult.filter,
@@ -49,12 +49,11 @@ exports.serializeSyncPayload = void 0;
49
49
  * streams deliver (which have neither `toObject` nor `toJSON`).
50
50
  */
51
51
  var serializeSyncPayload = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
52
- var plain;
52
+ var maybeHydrated, plain;
53
53
  var entry = _b.entry, doc = _b.doc, _c = _b.method, method = _c === void 0 ? "update" : _c, req = _b.req;
54
54
  return __generator(this, function (_d) {
55
- plain = typeof doc.toObject === "function"
56
- ? doc.toObject()
57
- : doc;
55
+ maybeHydrated = doc;
56
+ plain = typeof maybeHydrated.toObject === "function" ? maybeHydrated.toObject() : doc;
58
57
  if (entry.config.responseHandler) {
59
58
  return [2 /*return*/, entry.config.responseHandler(plain, method)];
60
59
  }
@@ -65,8 +64,8 @@ var serializeSyncPayload = function (_a) { return __awaiter(void 0, [_a], void 0
65
64
  // wrapping) that corrupts a single-doc payload.
66
65
  return [2 /*return*/, entry.options.responseHandler(doc, "read", req, entry.options)];
67
66
  }
68
- if (typeof doc.toJSON === "function") {
69
- return [2 /*return*/, doc.toJSON()];
67
+ if (typeof maybeHydrated.toJSON === "function") {
68
+ return [2 /*return*/, maybeHydrated.toJSON()];
70
69
  }
71
70
  return [2 /*return*/, plain];
72
71
  });
@@ -1,5 +1,6 @@
1
1
  import * as Sentry from "@sentry/bun";
2
2
  import express from "express";
3
+ import type { AdminChangeEvent, TerrenoAppAdminEvent } from "./adminTypes";
3
4
  import type { ModelRouterRegistration } from "./api";
4
5
  import { type UserModel as UserMongooseModel } from "./auth";
5
6
  import { type ConfigurationAppOptions } from "./configurationApp";
@@ -38,6 +39,10 @@ export interface TerrenoAppOptions {
38
39
  * Set to `true` for defaults, or pass a RealtimeAppOptions object for full control.
39
40
  */
40
41
  realtime?: boolean | RealtimeAppOptions;
42
+ /**
43
+ * RBAC access controller injected into model routers and `/auth/me` enrichment.
44
+ */
45
+ accessControl?: import("./rbac/types").AnyTerrenoAccess;
41
46
  /**
42
47
  * Runs after CORS and before the `addMiddleware` chain and JSON body parsing.
43
48
  * Use to attach early middleware via `app.use(...)` before JSON parsing.
@@ -116,6 +121,7 @@ export declare class TerrenoApp {
116
121
  private registrations;
117
122
  private middlewareFns;
118
123
  private configurationApp;
124
+ private readonly adminEvents;
119
125
  /**
120
126
  * Create a new TerrenoApp builder.
121
127
  *
@@ -143,6 +149,18 @@ export declare class TerrenoApp {
143
149
  * ```
144
150
  */
145
151
  register(registration: ModelRouterRegistration | TerrenoPlugin): this;
152
+ /**
153
+ * Returns registered model routers and plugins in mount order.
154
+ */
155
+ getRegistrations(): readonly (ModelRouterRegistration | TerrenoPlugin)[];
156
+ /**
157
+ * Returns only TerrenoPlugin registrations (excludes model routers).
158
+ */
159
+ getPlugins(): TerrenoPlugin[];
160
+ on(event: TerrenoAppAdminEvent, listener: (payload: AdminChangeEvent) => void): this;
161
+ off(event: TerrenoAppAdminEvent, listener: (payload: AdminChangeEvent) => void): this;
162
+ /** @internal Emits scrubbed admin model change events from modelRouter hooks. */
163
+ emitAdminModelChanged(payload: AdminChangeEvent): void;
146
164
  /**
147
165
  * Add custom Express middleware to the application.
148
166
  *
@@ -95,6 +95,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
95
95
  };
96
96
  Object.defineProperty(exports, "__esModule", { value: true });
97
97
  exports.TerrenoApp = void 0;
98
+ var node_events_1 = require("node:events");
98
99
  var node_http_1 = require("node:http");
99
100
  var Sentry = __importStar(require("@sentry/bun"));
100
101
  var cors_1 = __importDefault(require("cors"));
@@ -106,6 +107,7 @@ var errors_1 = require("./errors");
106
107
  var expressServer_1 = require("./expressServer");
107
108
  var githubAuth_1 = require("./githubAuth");
108
109
  var logger_1 = require("./logger");
110
+ var server_1 = require("./mcp/server");
109
111
  var middleware_1 = require("./middleware");
110
112
  var openApiCompat_1 = require("./openApiCompat");
111
113
  var openApiEtag_1 = require("./openApiEtag");
@@ -185,7 +187,9 @@ var TerrenoApp = /** @class */ (function () {
185
187
  this.registrations = [];
186
188
  this.middlewareFns = [];
187
189
  this.configurationApp = null;
190
+ this.adminEvents = new node_events_1.EventEmitter();
188
191
  this.options = options;
192
+ this.adminEvents.setMaxListeners(50);
189
193
  }
190
194
  /**
191
195
  * Register a model router or plugin with the application.
@@ -211,6 +215,31 @@ var TerrenoApp = /** @class */ (function () {
211
215
  this.registrations.push(registration);
212
216
  return this;
213
217
  };
218
+ /**
219
+ * Returns registered model routers and plugins in mount order.
220
+ */
221
+ TerrenoApp.prototype.getRegistrations = function () {
222
+ return this.registrations;
223
+ };
224
+ /**
225
+ * Returns only TerrenoPlugin registrations (excludes model routers).
226
+ */
227
+ TerrenoApp.prototype.getPlugins = function () {
228
+ var _this = this;
229
+ return this.registrations.filter(function (registration) { return !_this.isModelRouterRegistration(registration); });
230
+ };
231
+ TerrenoApp.prototype.on = function (event, listener) {
232
+ this.adminEvents.on(event, listener);
233
+ return this;
234
+ };
235
+ TerrenoApp.prototype.off = function (event, listener) {
236
+ this.adminEvents.off(event, listener);
237
+ return this;
238
+ };
239
+ /** @internal Emits scrubbed admin model change events from modelRouter hooks. */
240
+ TerrenoApp.prototype.emitAdminModelChanged = function (payload) {
241
+ this.adminEvents.emit("admin:model.changed", payload);
242
+ };
214
243
  /**
215
244
  * Add custom Express middleware to the application.
216
245
  *
@@ -385,11 +414,16 @@ var TerrenoApp = /** @class */ (function () {
385
414
  for (var _f = __values(this.registrations), _g = _f.next(); !_g.done; _g = _f.next()) {
386
415
  var registration = _g.value;
387
416
  if (this.isModelRouterRegistration(registration)) {
388
- var router = registration._buildWithOpenApi(oapi);
417
+ var router = registration._buildWithContext({
418
+ accessControl: options.accessControl,
419
+ openApi: oapi,
420
+ routePath: registration.path,
421
+ terrenoApp: this,
422
+ });
389
423
  app.use(registration.path, router);
390
424
  }
391
425
  else {
392
- registration.register(app, oapi);
426
+ registration.register(app, oapi, this);
393
427
  }
394
428
  }
395
429
  }
@@ -400,12 +434,21 @@ var TerrenoApp = /** @class */ (function () {
400
434
  }
401
435
  finally { if (e_2) throw e_2.error; }
402
436
  }
437
+ // Mount MCP at POST /mcp when any model opted in or a custom tool was registered.
438
+ var betterAuthPlugin = this.registrations.find(function (registration) {
439
+ return "getAuth" in registration &&
440
+ typeof registration.getAuth === "function";
441
+ });
442
+ (0, server_1.mountMCPServer)(app, {
443
+ betterAuth: betterAuthPlugin === null || betterAuthPlugin === void 0 ? void 0 : betterAuthPlugin.getAuth(),
444
+ userModel: options.userModel,
445
+ });
403
446
  if (options.configureApp) {
404
447
  options.configureApp(app, { openApi: oapi });
405
448
  }
406
449
  // /auth/me must be registered after plugins so that session middleware
407
450
  // (e.g. Better Auth) has a chance to populate req.user first.
408
- (0, auth_1.addMeRoutes)(app, options.userModel, options.authOptions);
451
+ (0, auth_1.addMeRoutes)(app, options.userModel, options.authOptions, options.accessControl);
409
452
  Sentry.setupExpressErrorHandler(app);
410
453
  // Error middleware
411
454
  app.use(errors_1.apiUnauthorizedMiddleware);
@@ -1,5 +1,7 @@
1
1
  import type http from "node:http";
2
2
  import type express from "express";
3
+ import type { AdminContribution } from "./adminTypes";
4
+ import type { TerrenoApp } from "./terrenoApp";
3
5
  /**
4
6
  * Interface for plugins that can be registered with TerrenoApp.
5
7
  *
@@ -35,7 +37,7 @@ export interface TerrenoPlugin {
35
37
  *
36
38
  * @param app - The Express application instance to register with
37
39
  */
38
- register(app: express.Application, openApi?: unknown): void;
40
+ register(app: express.Application, openApi?: unknown, terrenoApp?: TerrenoApp): void;
39
41
  /**
40
42
  * Called after the HTTP server is created but before it starts listening.
41
43
  * Use this to attach services that need the raw HTTP server, such as
@@ -46,4 +48,9 @@ export interface TerrenoPlugin {
46
48
  * @param server - The Node.js HTTP server instance
47
49
  */
48
50
  onServerCreated?(server: http.Server): void;
51
+ /**
52
+ * Optional admin metadata for {@link AdminApp} aggregation.
53
+ * Called during admin plugin registration to collect models, screens, widgets, and scripts.
54
+ */
55
+ adminContribution?(): AdminContribution;
49
56
  }
@@ -51,11 +51,17 @@ var __read = (this && this.__read) || function (o, n) {
51
51
  }
52
52
  return ar;
53
53
  };
54
+ var __importDefault = (this && this.__importDefault) || function (mod) {
55
+ return (mod && mod.__esModule) ? mod : { "default": mod };
56
+ };
54
57
  Object.defineProperty(exports, "__esModule", { value: true });
55
58
  exports.loadTestDataFromDocuments = exports.toCachedTestData = exports.createTestData = exports.createRequiredFixtures = exports.createStandardFoods = exports.createTestUsers = exports.clearTestCollections = void 0;
56
59
  var luxon_1 = require("luxon");
60
+ var mongoose_1 = __importDefault(require("mongoose"));
57
61
  var errors_1 = require("../errors");
58
62
  var logger_1 = require("../logger");
63
+ var auditModel_1 = require("../rbac/auditModel");
64
+ var roleModel_1 = require("../rbac/roleModel");
59
65
  var models_1 = require("./models");
60
66
  var setPassword = function (user, password) { return __awaiter(void 0, void 0, void 0, function () {
61
67
  return __generator(this, function (_a) {
@@ -77,6 +83,8 @@ var clearTestCollections = function () { return __awaiter(void 0, void 0, void 0
77
83
  models_1.UserModel.deleteMany({}),
78
84
  models_1.FoodModel.deleteMany({}),
79
85
  models_1.RequiredModel.deleteMany({}),
86
+ (0, roleModel_1.createRbacRoleModel)(mongoose_1.default.connection).deleteMany({}),
87
+ (0, auditModel_1.createRbacAuditModel)(mongoose_1.default.connection).deleteMany({}),
80
88
  ]).catch(logger_1.logger.catch)];
81
89
  case 1:
82
90
  _a.sent();
@@ -6,6 +6,7 @@ export interface User {
6
6
  email: string;
7
7
  age?: number;
8
8
  disabled?: boolean;
9
+ organizationIds?: string[];
9
10
  }
10
11
  export interface SuperUser extends User {
11
12
  superTitle: string;
@@ -47,6 +47,11 @@ var userSchema = new mongoose_1.Schema({
47
47
  admin: { default: false, description: "Whether the user has admin privileges", type: Boolean },
48
48
  age: { description: "The user's age", type: Number },
49
49
  name: { description: "The user's display name", type: String },
50
+ organizationIds: {
51
+ default: [],
52
+ description: "Organization memberships",
53
+ type: [String],
54
+ },
50
55
  username: { description: "The user's username", type: String },
51
56
  });
52
57
  userSchema.plugin(passport_local_mongoose_1.default, {
@@ -40,7 +40,6 @@ exports.loadTestData = exports.createTestData = exports.resetTestCollections = e
40
40
  var test_1 = require("@terreno/test");
41
41
  var logger_1 = require("../logger");
42
42
  var createTestData_1 = require("./createTestData");
43
- var models_1 = require("./models");
44
43
  var mongoTestSetup_1 = require("./mongoTestSetup");
45
44
  var defaultTestMongoUri = "mongodb://127.0.0.1/terreno?&connectTimeoutMS=360000";
46
45
  var applyTestAuthEnv = function () {
@@ -73,7 +72,7 @@ var setupDb = function () { return __awaiter(void 0, void 0, void 0, function ()
73
72
  case 0: return [4 /*yield*/, ensureConnected()];
74
73
  case 1:
75
74
  _a.sent();
76
- return [4 /*yield*/, Promise.all([models_1.UserModel.deleteMany({}), models_1.FoodModel.deleteMany({})]).catch(logger_1.logger.catch)];
75
+ return [4 /*yield*/, (0, createTestData_1.clearTestCollections)()];
77
76
  case 2:
78
77
  _a.sent();
79
78
  _a.label = 3;
@@ -1,4 +1,15 @@
1
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
+ };
2
13
  var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
14
  function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
15
  return new (P || (P = Promise))(function (resolve, reject) {
@@ -171,7 +182,11 @@ var serialize = function (req, options, data) {
171
182
  var _a;
172
183
  var serializeFn = function (serializeData, serializeUser) {
173
184
  var _a, _b;
174
- var dataObject = serializeData.toObject();
185
+ // Change-stream post-images are plain BSON objects (no toObject). Calling
186
+ // toObject on them throws and used to drop every sync:delta / realtime emit.
187
+ var dataObject = (typeof serializeData.toObject === "function"
188
+ ? serializeData.toObject()
189
+ : __assign({}, serializeData));
175
190
  dataObject.id = serializeData._id;
176
191
  // Search for any value that is a Map and transform it to a plain object.
177
192
  // Otherwise Express drops the contents.
package/package.json CHANGED
@@ -5,20 +5,16 @@
5
5
  },
6
6
  "dependencies": {
7
7
  "@asteasolutions/zod-to-openapi": "^8.5.0",
8
+ "@modelcontextprotocol/node": "^2.0.0",
9
+ "@modelcontextprotocol/server": "^2.0.0",
8
10
  "@sentry/bun": "^10.39.0",
9
11
  "@sentry/profiling-node": "^10.25.0",
10
- "@terreno/test": "57.0.0",
12
+ "@terreno/test": "57.2.0",
13
+ "@thream/socketio-jwt": "^3.1.4",
11
14
  "@types/qs": "^6.14.0",
12
15
  "ajv": "8.20.0",
13
16
  "ajv-formats": "^3.0.1",
14
17
  "ajv-keywords": "^5.1.0",
15
- "http-errors": "^2.0.0",
16
- "path-to-regexp": "^8.4.2",
17
- "router": "^2.2.0",
18
- "serve-static": "^2.2.1",
19
- "swagger-parser": "^10.0.3",
20
- "swagger-ui-dist": "^5.11.8",
21
- "yaml": "^2.4.0",
22
18
  "axios": "^1.13.2",
23
19
  "better-auth": "^1.6.25",
24
20
  "cors": "^2.8.5",
@@ -26,6 +22,7 @@
26
22
  "expo-server-sdk": "^6.0.0",
27
23
  "express": "^5.2.1",
28
24
  "generaterr": "^1.5.0",
25
+ "http-errors": "^2.0.0",
29
26
  "jsonwebtoken": "^9.0.2",
30
27
  "lodash": "^4.18.1",
31
28
  "luxon": "^3.7.2",
@@ -38,18 +35,24 @@
38
35
  "passport-jwt": "^4.0.0",
39
36
  "passport-local": "^1.0.0",
40
37
  "passport-local-mongoose": "^9.0.1",
38
+ "path-to-regexp": "^8.4.2",
41
39
  "qs": "^6.15.0",
42
- "@thream/socketio-jwt": "^3.1.4",
40
+ "router": "^2.2.0",
43
41
  "scmp": "^2.1.0",
42
+ "serve-static": "^2.2.1",
44
43
  "socket.io": "^4.8.1",
45
- "winston": "^3.18.3"
44
+ "swagger-parser": "^10.0.3",
45
+ "swagger-ui-dist": "^5.11.8",
46
+ "winston": "^3.18.3",
47
+ "yaml": "^2.4.0"
46
48
  },
47
49
  "description": "Styled after the Django & Django REST Framework, a batteries-include framework for building REST APIs with Node/Express/Mongoose.",
48
50
  "devDependencies": {
49
51
  "@biomejs/biome": "^2.3.6",
50
- "@terreno/syncdb": "57.0.0",
52
+ "@modelcontextprotocol/client": "^2.0.0",
53
+ "@terreno/syncdb": "57.2.0",
51
54
  "@types/bcrypt": "^6.0.0",
52
- "@types/bun": "^1.3.8",
55
+ "@types/bun": "^1.4.0",
53
56
  "@types/cors": "^2.8.17",
54
57
  "@types/cron": "^2.4.3",
55
58
  "@types/express": "^5.0.6",
@@ -115,6 +118,7 @@
115
118
  "lint:unsafefix": "biome check --fix --unsafe ./src",
116
119
  "load": "bun src/sync/loadHarness.ts",
117
120
  "test": "bun test --update-snapshots",
121
+ "test:agent": "AGENT=1 bun test --only-failures",
118
122
  "test:ci": "bun test",
119
123
  "test:coverage": "bun run ../scripts/check-coverage.ts",
120
124
  "test:cache:clean": "bun ./src/tests/mongoTestSetup.ts clean",
@@ -123,5 +127,5 @@
123
127
  "updateSnapshot": "bun test --update-snapshots"
124
128
  },
125
129
  "types": "dist/index.d.ts",
126
- "version": "57.0.0"
130
+ "version": "57.2.0"
127
131
  }