@terreno/api 57.0.0-beta.1 → 57.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (175) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +8 -0
  2. package/dist/actions.d.ts +7 -2
  3. package/dist/actions.js +60 -25
  4. package/dist/adminModelRouter.d.ts +14 -0
  5. package/dist/adminModelRouter.js +199 -0
  6. package/dist/adminTypes.d.ts +156 -0
  7. package/dist/adminTypes.js +5 -0
  8. package/dist/api.d.ts +44 -3
  9. package/dist/api.js +74 -26
  10. package/dist/auth.d.ts +18 -1
  11. package/dist/auth.js +122 -20
  12. package/dist/consentApp.d.ts +2 -0
  13. package/dist/consentApp.js +98 -0
  14. package/dist/index.d.ts +22 -1
  15. package/dist/index.js +51 -7
  16. package/dist/mcp/auth.d.ts +11 -0
  17. package/dist/mcp/auth.js +133 -0
  18. package/dist/mcp/createMCPRequest.d.ts +16 -0
  19. package/dist/mcp/createMCPRequest.js +26 -0
  20. package/dist/mcp/handlers.d.ts +8 -0
  21. package/dist/mcp/handlers.js +793 -0
  22. package/dist/mcp/query.d.ts +32 -0
  23. package/dist/mcp/query.js +232 -0
  24. package/dist/mcp/registry.d.ts +21 -0
  25. package/dist/mcp/registry.js +54 -0
  26. package/dist/mcp/schemaGenerator.d.ts +14 -0
  27. package/dist/mcp/schemaGenerator.js +379 -0
  28. package/dist/mcp/server.d.ts +8 -0
  29. package/dist/mcp/server.js +133 -0
  30. package/dist/mcp/toolGenerator.d.ts +14 -0
  31. package/dist/mcp/toolGenerator.js +246 -0
  32. package/dist/mcp/types.d.ts +85 -0
  33. package/dist/mcp/types.js +2 -0
  34. package/dist/openApi.d.ts +1 -1
  35. package/dist/openApi.js +26 -8
  36. package/dist/permissions.js +15 -15
  37. package/dist/rbac/access.d.ts +3 -0
  38. package/dist/rbac/access.js +294 -0
  39. package/dist/rbac/auditModel.d.ts +31 -0
  40. package/dist/rbac/auditModel.js +112 -0
  41. package/dist/rbac/backfillAdmins.d.ts +18 -0
  42. package/dist/rbac/backfillAdmins.js +139 -0
  43. package/dist/rbac/fieldViews.d.ts +3 -0
  44. package/dist/rbac/fieldViews.js +201 -0
  45. package/dist/rbac/middleware.d.ts +21 -0
  46. package/dist/rbac/middleware.js +108 -0
  47. package/dist/rbac/modelRouterAccess.d.ts +42 -0
  48. package/dist/rbac/modelRouterAccess.js +388 -0
  49. package/dist/rbac/permissionUtils.d.ts +8 -0
  50. package/dist/rbac/permissionUtils.js +209 -0
  51. package/dist/rbac/realtimeAccess.d.ts +18 -0
  52. package/dist/rbac/realtimeAccess.js +173 -0
  53. package/dist/rbac/resolve.d.ts +28 -0
  54. package/dist/rbac/resolve.js +387 -0
  55. package/dist/rbac/roleManager.d.ts +20 -0
  56. package/dist/rbac/roleManager.js +741 -0
  57. package/dist/rbac/roleModel.d.ts +42 -0
  58. package/dist/rbac/roleModel.js +267 -0
  59. package/dist/rbac/routes.d.ts +9 -0
  60. package/dist/rbac/routes.js +211 -0
  61. package/dist/rbac/scopes.d.ts +15 -0
  62. package/dist/rbac/scopes.js +155 -0
  63. package/dist/rbac/statements.d.ts +20 -0
  64. package/dist/rbac/statements.js +115 -0
  65. package/dist/rbac/types.d.ts +202 -0
  66. package/dist/rbac/types.js +2 -0
  67. package/dist/rbac/userPlugin.d.ts +12 -0
  68. package/dist/rbac/userPlugin.js +41 -0
  69. package/dist/realtime/changeStreamWatcher.d.ts +1 -1
  70. package/dist/realtime/changeStreamWatcher.js +48 -39
  71. package/dist/realtime/realtimeApp.js +4 -8
  72. package/dist/realtime/registry.d.ts +5 -0
  73. package/dist/realtime/registry.js +13 -1
  74. package/dist/scrubAdminFields.d.ts +17 -0
  75. package/dist/scrubAdminFields.js +192 -0
  76. package/dist/sync/executors.d.ts +1 -1
  77. package/dist/sync/executors.js +63 -40
  78. package/dist/sync/loadHarness.js +4 -5
  79. package/dist/sync/registry.d.ts +5 -0
  80. package/dist/sync/registry.js +13 -1
  81. package/dist/sync/routes.js +41 -36
  82. package/dist/sync/serialize.js +5 -6
  83. package/dist/terrenoApp.d.ts +18 -0
  84. package/dist/terrenoApp.js +46 -3
  85. package/dist/terrenoPlugin.d.ts +8 -1
  86. package/dist/tests/createTestData.js +8 -0
  87. package/dist/tests/models.d.ts +1 -0
  88. package/dist/tests/models.js +5 -0
  89. package/dist/tests/testHelper.js +1 -2
  90. package/dist/transformers.js +16 -1
  91. package/package.json +16 -12
  92. package/src/__snapshots__/openApi.test.ts.snap +192 -0
  93. package/src/actions.test.ts +194 -1
  94. package/src/actions.ts +65 -8
  95. package/src/adminModelRouter.ts +154 -0
  96. package/src/adminTypes.ts +183 -0
  97. package/src/api.test.ts +66 -1
  98. package/src/api.ts +131 -12
  99. package/src/auth.test.ts +135 -1
  100. package/src/auth.ts +81 -3
  101. package/src/consentApp.test.ts +24 -0
  102. package/src/consentApp.ts +100 -0
  103. package/src/index.ts +56 -0
  104. package/src/mcp/auth.test.ts +197 -0
  105. package/src/mcp/auth.ts +100 -0
  106. package/src/mcp/createMCPRequest.test.ts +47 -0
  107. package/src/mcp/createMCPRequest.ts +32 -0
  108. package/src/mcp/customTools.test.ts +54 -0
  109. package/src/mcp/handlers.ts +639 -0
  110. package/src/mcp/integration.test.ts +1493 -0
  111. package/src/mcp/query.test.ts +172 -0
  112. package/src/mcp/query.ts +179 -0
  113. package/src/mcp/registry.ts +70 -0
  114. package/src/mcp/schemaGenerator.test.ts +182 -0
  115. package/src/mcp/schemaGenerator.ts +354 -0
  116. package/src/mcp/server.test.ts +226 -0
  117. package/src/mcp/server.ts +86 -0
  118. package/src/mcp/toolGenerator.test.ts +284 -0
  119. package/src/mcp/toolGenerator.ts +199 -0
  120. package/src/mcp/types.ts +95 -0
  121. package/src/openApi.test.ts +107 -0
  122. package/src/openApi.ts +32 -1
  123. package/src/permissions.ts +3 -2
  124. package/src/rbac/access.test.ts +357 -0
  125. package/src/rbac/access.ts +201 -0
  126. package/src/rbac/auditModel.ts +103 -0
  127. package/src/rbac/backfillAdmins.ts +54 -0
  128. package/src/rbac/fieldViews.test.ts +39 -0
  129. package/src/rbac/fieldViews.ts +122 -0
  130. package/src/rbac/middleware.ts +55 -0
  131. package/src/rbac/modelRouterAccess.test.ts +336 -0
  132. package/src/rbac/modelRouterAccess.ts +331 -0
  133. package/src/rbac/permissionUtils.test.ts +112 -0
  134. package/src/rbac/permissionUtils.ts +83 -0
  135. package/src/rbac/realtimeAccess.test.ts +242 -0
  136. package/src/rbac/realtimeAccess.ts +138 -0
  137. package/src/rbac/resolve.test.ts +358 -0
  138. package/src/rbac/resolve.ts +285 -0
  139. package/src/rbac/roleManager.test.ts +915 -0
  140. package/src/rbac/roleManager.ts +440 -0
  141. package/src/rbac/roleModel.test.ts +114 -0
  142. package/src/rbac/roleModel.ts +196 -0
  143. package/src/rbac/routes.ts +170 -0
  144. package/src/rbac/scopes.test.ts +105 -0
  145. package/src/rbac/scopes.ts +81 -0
  146. package/src/rbac/statements.test.ts +65 -0
  147. package/src/rbac/statements.ts +62 -0
  148. package/src/rbac/types.ts +198 -0
  149. package/src/rbac/userPlugin.test.ts +55 -0
  150. package/src/rbac/userPlugin.ts +25 -0
  151. package/src/realtime/changeStreamWatcher.ts +20 -15
  152. package/src/realtime/realtime.test.ts +25 -1
  153. package/src/realtime/realtimeApp.ts +2 -5
  154. package/src/realtime/registry.ts +15 -0
  155. package/src/scrubAdminFields.test.ts +113 -0
  156. package/src/scrubAdminFields.ts +158 -0
  157. package/src/sync/executors.ts +31 -1
  158. package/src/sync/loadHarness.ts +8 -7
  159. package/src/sync/models.test.ts +262 -0
  160. package/src/sync/registry.ts +15 -0
  161. package/src/sync/routes.ts +25 -11
  162. package/src/sync/scripts/compactTombstones.test.ts +4 -6
  163. package/src/sync/serialize.ts +17 -9
  164. package/src/sync/sync.test.ts +52 -0
  165. package/src/sync/syncRoutes.test.ts +5 -2
  166. package/src/sync/syncSocket.test.ts +28 -0
  167. package/src/terrenoApp.test.ts +100 -0
  168. package/src/terrenoApp.ts +65 -3
  169. package/src/terrenoPlugin.ts +10 -1
  170. package/src/tests/bunSetup.ts +2 -0
  171. package/src/tests/createTestData.ts +5 -1
  172. package/src/tests/models.ts +6 -0
  173. package/src/tests/testHelper.ts +1 -3
  174. package/src/transformers.test.ts +12 -0
  175. package/src/transformers.ts +7 -1
package/dist/api.js CHANGED
@@ -132,15 +132,18 @@ var cloneDeep_1 = __importDefault(require("lodash/cloneDeep"));
132
132
  var luxon_1 = require("luxon");
133
133
  var mongoose_1 = __importDefault(require("mongoose"));
134
134
  var actions_1 = require("./actions");
135
+ var adminModelRouter_1 = require("./adminModelRouter");
135
136
  var auth_1 = require("./auth");
136
137
  var errors_1 = require("./errors");
137
138
  var logger_1 = require("./logger");
139
+ var registry_1 = require("./mcp/registry");
138
140
  var openApi_1 = require("./openApi");
139
141
  var openApiValidator_1 = require("./openApiValidator");
140
142
  var permissions_1 = require("./permissions");
141
- var registry_1 = require("./realtime/registry");
143
+ var modelRouterAccess_1 = require("./rbac/modelRouterAccess");
144
+ var registry_2 = require("./realtime/registry");
142
145
  var executors_1 = require("./sync/executors");
143
- var registry_2 = require("./sync/registry");
146
+ var registry_3 = require("./sync/registry");
144
147
  var transformers_1 = require("./transformers");
145
148
  var utils_1 = require("./utils");
146
149
  var addPopulateToQuery = function (
@@ -397,11 +400,17 @@ function modelRouter(pathOrModel, modelOrOptions, maybeOptions) {
397
400
  model = pathOrModel;
398
401
  options = modelOrOptions;
399
402
  }
400
- var router = _buildModelRouter(model, options);
403
+ // Register MCP before building so _buildModelRouter can replace options
404
+ // with RBAC-resolved permissions (access+accessControl is not deferred).
405
+ if (options.mcp) {
406
+ (0, registry_1.registerMCPModel)(model, options.mcp, options);
407
+ }
408
+ var shouldDeferBuild = path !== undefined && Boolean(options.access) && !options.accessControl;
401
409
  if (path !== undefined) {
402
- // Register for real-time sync if configured
410
+ // Register before building so _buildModelRouter can replace options with
411
+ // RBAC-resolved permissions (same contract as MCP).
403
412
  if (options.realtime) {
404
- (0, registry_1.registerRealtime)({
413
+ (0, registry_2.registerRealtime)({
405
414
  collectionName: model.collection.collectionName,
406
415
  config: options.realtime,
407
416
  modelName: model.modelName,
@@ -409,15 +418,25 @@ function modelRouter(pathOrModel, modelOrOptions, maybeOptions) {
409
418
  routePath: path,
410
419
  });
411
420
  }
412
- // Register for local-first sync if configured (validates the schema contract)
413
421
  if (options.sync) {
414
- (0, registry_2.registerSync)({ config: options.sync, model: model, options: options, routePath: path });
422
+ (0, registry_3.registerSync)({ config: options.sync, model: model, options: options, routePath: path });
415
423
  }
424
+ }
425
+ var router = shouldDeferBuild ? express_1.default.Router() : _buildModelRouter(model, options, path);
426
+ if (path !== undefined) {
416
427
  return {
417
428
  __type: "modelRouter",
418
- _buildWithOpenApi: function (openApi) {
419
- return _buildModelRouter(model, __assign(__assign({}, options), { openApi: openApi }));
429
+ _buildWithContext: function (context) {
430
+ var _a;
431
+ var enrichedOptions = (0, adminModelRouter_1.enrichModelRouterOptions)(model, __assign(__assign({}, options), { openApi: context.openApi }), context);
432
+ var runtimeOptions = __assign(__assign({}, enrichedOptions), { accessControl: (_a = enrichedOptions.accessControl) !== null && _a !== void 0 ? _a : context.accessControl });
433
+ if (options.realtime) {
434
+ (0, registry_2.updateRealtimeRegistryOptions)(path, runtimeOptions);
435
+ }
436
+ return _buildModelRouter(model, runtimeOptions, path);
420
437
  },
438
+ model: model,
439
+ options: options,
421
440
  path: path,
422
441
  router: router,
423
442
  };
@@ -432,16 +451,31 @@ function modelRouter(pathOrModel, modelOrOptions, maybeOptions) {
432
451
  }
433
452
  return router;
434
453
  }
435
- var _buildModelRouter = function (model, options) {
436
- var _a;
454
+ var _buildModelRouter = function (model, options, routePath) {
455
+ var _a, _b, _c, _d, _e;
437
456
  var router = express_1.default.Router();
457
+ var resolvedAccess = (0, modelRouterAccess_1.resolveModelRouterAccess)({
458
+ access: options.access,
459
+ accessControl: options.accessControl,
460
+ permissions: options.permissions,
461
+ queryFilter: options.queryFilter,
462
+ responseHandler: options.responseHandler,
463
+ scope: (_a = options.access) === null || _a === void 0 ? void 0 : _a.scope,
464
+ });
465
+ options = __assign(__assign({}, options), { permissions: resolvedAccess.permissions, queryFilter: ((_b = resolvedAccess.queryFilter) !== null && _b !== void 0 ? _b : options.queryFilter), responseHandler: ((_d = (_c = resolvedAccess.responseHandler) !== null && _c !== void 0 ? _c : options.responseHandler) !== null && _d !== void 0 ? _d : transformers_1.defaultResponseHandler) });
466
+ if (options.mcp) {
467
+ (0, registry_1.updateMCPRegistryOptions)(model.modelName, options);
468
+ }
469
+ if (options.sync && routePath) {
470
+ (0, registry_3.updateSyncRegistryOptions)(routePath, options);
471
+ }
438
472
  (0, actions_1.assertNoActionCollisions)(model, options);
439
473
  (0, actions_1.registerActionRoutes)(router, model, options);
440
474
  // User endpoints run after actions; actions win on path conflicts.
441
475
  if (options.endpoints) {
442
476
  options.endpoints(router, options);
443
477
  }
444
- var responseHandler = (_a = options.responseHandler) !== null && _a !== void 0 ? _a : transformers_1.defaultResponseHandler;
478
+ var responseHandler = (_e = options.responseHandler) !== null && _e !== void 0 ? _e : transformers_1.defaultResponseHandler;
445
479
  // Always install validation middleware — they are no-ops until configureOpenApiValidator() is called
446
480
  var createValidation = getBodyValidationMiddleware(model, options, "create");
447
481
  var updateValidation = getBodyValidationMiddleware(model, options, "update");
@@ -485,7 +519,7 @@ var _buildModelRouter = function (model, options) {
485
519
  router.get("/", [
486
520
  (0, auth_1.authenticateMiddleware)(options.allowAnonymous),
487
521
  (0, permissions_1.permissionMiddleware)(model, options),
488
- (0, openApi_1.listOpenApiMiddleware)(model, options),
522
+ (0, openApi_1.listOpenApiMiddleware)(model, options, routePath),
489
523
  queryValidation,
490
524
  ], (0, exports.asyncHandler)(function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
491
525
  var query, _a, _b, queryParam, _c, _d, queryParam, queryFilter, error_2, limit, builtQuery, total, populatedQuery, data, error_3, serialized, error_4, more, msg;
@@ -945,13 +979,27 @@ var _buildModelRouter = function (model, options) {
945
979
  }
946
980
  _d.label = 8;
947
981
  case 8:
948
- _d.trys.push([8, 10, , 11]);
949
- Object.assign(doc, body);
950
- return [4 /*yield*/, doc.save()];
982
+ body = (0, auth_1.omitUserRolesFromWriteBody)(model.modelName, options.accessControl, body, req.terrenoAllowUserAdminWrite === true);
983
+ if (!(options.access && options.accessControl && body && typeof body === "object")) return [3 /*break*/, 10];
984
+ return [4 /*yield*/, (0, modelRouterAccess_1.validateAccessWriteBody)({
985
+ access: options.access,
986
+ accessControl: options.accessControl,
987
+ body: body,
988
+ doc: doc,
989
+ phase: "write",
990
+ user: req.user,
991
+ })];
951
992
  case 9:
952
993
  _d.sent();
953
- return [3 /*break*/, 11];
994
+ _d.label = 10;
954
995
  case 10:
996
+ _d.trys.push([10, 12, , 13]);
997
+ Object.assign(doc, body);
998
+ return [4 /*yield*/, doc.save()];
999
+ case 11:
1000
+ _d.sent();
1001
+ return [3 /*break*/, 13];
1002
+ case 12:
955
1003
  error_9 = _d.sent();
956
1004
  throw (0, errors_1.passthroughOrWrapWrite)(error_9, {
957
1005
  code: "update-save-error",
@@ -959,16 +1007,16 @@ var _buildModelRouter = function (model, options) {
959
1007
  status: 400,
960
1008
  title: "PATCH Pre Update error",
961
1009
  });
962
- case 11:
963
- if (!options.postUpdate) return [3 /*break*/, 15];
964
- _d.label = 12;
965
- case 12:
966
- _d.trys.push([12, 14, , 15]);
967
- return [4 /*yield*/, options.postUpdate(doc, body, req, prevDoc)];
968
1010
  case 13:
969
- _d.sent();
970
- return [3 /*break*/, 15];
1011
+ if (!options.postUpdate) return [3 /*break*/, 17];
1012
+ _d.label = 14;
971
1013
  case 14:
1014
+ _d.trys.push([14, 16, , 17]);
1015
+ return [4 /*yield*/, options.postUpdate(doc, body, req, prevDoc)];
1016
+ case 15:
1017
+ _d.sent();
1018
+ return [3 /*break*/, 17];
1019
+ case 16:
972
1020
  error_10 = _d.sent();
973
1021
  throw (0, errors_1.passthroughOrWrap)(error_10, {
974
1022
  code: "post-update-hook-error",
@@ -976,7 +1024,7 @@ var _buildModelRouter = function (model, options) {
976
1024
  status: 400,
977
1025
  title: "PATCH Post Update error",
978
1026
  });
979
- case 15: return [2 /*return*/, res.json({
1027
+ case 17: return [2 /*return*/, res.json({
980
1028
  data: (0, transformers_1.serialize)(req, options, doc),
981
1029
  })];
982
1030
  }
package/dist/auth.d.ts CHANGED
@@ -23,6 +23,23 @@ export interface GenerateTokensOptions {
23
23
  sessionId?: string;
24
24
  }
25
25
  export declare const authenticateMiddleware: (anonymous?: boolean) => (req: express.Request, res: express.Response, next: express.NextFunction) => any;
26
+ /**
27
+ * User fields that confer authority. Self-service requests (anonymous signup, `PATCH /me`)
28
+ * must never set them, or any caller could grant themselves admin or an RBAC role. Elevate
29
+ * users through the admin API or `access.roles.assign` instead.
30
+ */
31
+ export declare const PRIVILEGED_USER_FIELDS: readonly ["admin", "roles", "organizationIds"];
32
+ /**
33
+ * Removes {@link PRIVILEGED_USER_FIELDS} from a self-service body. Fields are dropped rather
34
+ * than rejected so clients that echo a whole user object back still succeed.
35
+ */
36
+ export declare const stripPrivilegedUserFields: (body: Record<string, unknown>, context: string) => Record<string, unknown>;
37
+ /**
38
+ * When RBAC is enabled, authority-bearing User fields must not flow through ordinary mongoose
39
+ * writes on `/users`, sync, or MCP. AdminApp captures role assignments before this runs and
40
+ * explicitly marks authorized legacy-admin writes after its additional checks.
41
+ */
42
+ export declare const omitUserRolesFromWriteBody: (modelName: string, accessControl: unknown, body: unknown, allowAdminWrite?: boolean) => unknown;
26
43
  export declare const signupUser: (userModel: UserModel, email: string, password: string, body?: Record<string, unknown>) => Promise<any>;
27
44
  /** A user document exposing passport-local-mongoose's `setPassword`. */
28
45
  export interface HasSetPassword {
@@ -78,4 +95,4 @@ export declare const generateTokens: (user: unknown, authOptions?: AuthOptions,
78
95
  }>;
79
96
  export declare const setupAuth: (app: express.Application, userModel: UserModel) => void;
80
97
  export declare const addAuthRoutes: (app: express.Application, userModel: UserModel, authOptions?: AuthOptions) => void;
81
- export declare const addMeRoutes: (app: express.Application, userModel: UserModel, _authOptions?: AuthOptions) => void;
98
+ export declare const addMeRoutes: (app: express.Application, userModel: UserModel, _authOptions?: AuthOptions, accessControl?: import("./rbac/types").AnyTerrenoAccess) => void;
package/dist/auth.js CHANGED
@@ -57,6 +57,17 @@ var __rest = (this && this.__rest) || function (s, e) {
57
57
  }
58
58
  return t;
59
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
+ };
60
71
  var __read = (this && this.__read) || function (o, n) {
61
72
  var m = typeof Symbol === "function" && o[Symbol.iterator];
62
73
  if (!m) return o;
@@ -86,7 +97,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
86
97
  return (mod && mod.__esModule) ? mod : { "default": mod };
87
98
  };
88
99
  Object.defineProperty(exports, "__esModule", { value: true });
89
- exports.addMeRoutes = exports.addAuthRoutes = exports.setupAuth = exports.generateTokens = exports.setPasswordForUser = exports.MAX_PASSWORD_LENGTH = exports.signupUser = exports.authenticateMiddleware = void 0;
100
+ exports.addMeRoutes = exports.addAuthRoutes = exports.setupAuth = exports.generateTokens = exports.setPasswordForUser = exports.MAX_PASSWORD_LENGTH = exports.signupUser = exports.omitUserRolesFromWriteBody = exports.stripPrivilegedUserFields = exports.PRIVILEGED_USER_FIELDS = exports.authenticateMiddleware = void 0;
90
101
  var node_crypto_1 = require("node:crypto");
91
102
  var express_1 = __importDefault(require("express"));
92
103
  var jsonwebtoken_1 = __importDefault(require("jsonwebtoken"));
@@ -133,12 +144,93 @@ var authenticateMiddleware = function (anonymous) {
133
144
  };
134
145
  };
135
146
  exports.authenticateMiddleware = authenticateMiddleware;
147
+ /**
148
+ * User fields that confer authority. Self-service requests (anonymous signup, `PATCH /me`)
149
+ * must never set them, or any caller could grant themselves admin or an RBAC role. Elevate
150
+ * users through the admin API or `access.roles.assign` instead.
151
+ */
152
+ exports.PRIVILEGED_USER_FIELDS = ["admin", "roles", "organizationIds"];
153
+ /**
154
+ * Removes {@link PRIVILEGED_USER_FIELDS} from a self-service body. Fields are dropped rather
155
+ * than rejected so clients that echo a whole user object back still succeed.
156
+ */
157
+ var stripPrivilegedUserFields = function (body, context) {
158
+ var e_1, _a;
159
+ var sanitized = {};
160
+ var dropped = [];
161
+ try {
162
+ for (var _b = __values(Object.entries(body)), _c = _b.next(); !_c.done; _c = _b.next()) {
163
+ var _d = __read(_c.value, 2), key = _d[0], value = _d[1];
164
+ if (exports.PRIVILEGED_USER_FIELDS.includes(key)) {
165
+ dropped.push(key);
166
+ continue;
167
+ }
168
+ sanitized[key] = value;
169
+ }
170
+ }
171
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
172
+ finally {
173
+ try {
174
+ if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
175
+ }
176
+ finally { if (e_1) throw e_1.error; }
177
+ }
178
+ if (dropped.length > 0) {
179
+ logger_1.logger.warn("Ignored privileged user fields on ".concat(context, ": ").concat(dropped.join(", ")));
180
+ }
181
+ return sanitized;
182
+ };
183
+ exports.stripPrivilegedUserFields = stripPrivilegedUserFields;
184
+ var omitPrivilegedFieldsFromObject = function (item, allowAdminWrite) {
185
+ var e_2, _a;
186
+ if (!item || typeof item !== "object" || Array.isArray(item)) {
187
+ return item;
188
+ }
189
+ var record = item;
190
+ var fieldsToDrop = exports.PRIVILEGED_USER_FIELDS.filter(function (field) { return field in record && !(field === "admin" && allowAdminWrite); });
191
+ if (fieldsToDrop.length === 0) {
192
+ return item;
193
+ }
194
+ var next = __assign({}, record);
195
+ try {
196
+ for (var fieldsToDrop_1 = __values(fieldsToDrop), fieldsToDrop_1_1 = fieldsToDrop_1.next(); !fieldsToDrop_1_1.done; fieldsToDrop_1_1 = fieldsToDrop_1.next()) {
197
+ var field = fieldsToDrop_1_1.value;
198
+ Reflect.deleteProperty(next, field);
199
+ }
200
+ }
201
+ catch (e_2_1) { e_2 = { error: e_2_1 }; }
202
+ finally {
203
+ try {
204
+ if (fieldsToDrop_1_1 && !fieldsToDrop_1_1.done && (_a = fieldsToDrop_1.return)) _a.call(fieldsToDrop_1);
205
+ }
206
+ finally { if (e_2) throw e_2.error; }
207
+ }
208
+ logger_1.logger.warn("Ignored privileged User fields on a modelRouter write: ".concat(fieldsToDrop.join(", ")));
209
+ return next;
210
+ };
211
+ /**
212
+ * When RBAC is enabled, authority-bearing User fields must not flow through ordinary mongoose
213
+ * writes on `/users`, sync, or MCP. AdminApp captures role assignments before this runs and
214
+ * explicitly marks authorized legacy-admin writes after its additional checks.
215
+ */
216
+ var omitUserRolesFromWriteBody = function (modelName, accessControl, body, allowAdminWrite) {
217
+ if (allowAdminWrite === void 0) { allowAdminWrite = false; }
218
+ if (modelName !== "User" || !accessControl || body == null) {
219
+ return body;
220
+ }
221
+ if (Array.isArray(body)) {
222
+ return body.map(function (item) { return omitPrivilegedFieldsFromObject(item, allowAdminWrite); });
223
+ }
224
+ return omitPrivilegedFieldsFromObject(body, allowAdminWrite);
225
+ };
226
+ exports.omitUserRolesFromWriteBody = omitUserRolesFromWriteBody;
136
227
  var signupUser = function (userModel, email, password, body) { return __awaiter(void 0, void 0, void 0, function () {
137
- var _a, _email, _password, bodyRest, user, error_1, error_2, message;
228
+ var _a, _email, _password, rawBody, bodyRest, user, error_1, error_2, message;
138
229
  return __generator(this, function (_b) {
139
230
  switch (_b.label) {
140
231
  case 0:
141
- _a = body !== null && body !== void 0 ? body : {}, _email = _a.email, _password = _a.password, bodyRest = __rest(_a, ["email", "password"]);
232
+ _a = body !== null && body !== void 0 ? body : {}, _email = _a.email, _password = _a.password, rawBody = __rest(_a, ["email", "password"]);
233
+ bodyRest = (0, exports.stripPrivilegedUserFields)(rawBody, "signup");
142
234
  _b.label = 1;
143
235
  case 1:
144
236
  _b.trys.push([1, 8, , 9]);
@@ -647,58 +739,68 @@ var addAuthRoutes = function (app, userModel, authOptions) {
647
739
  app.use("/auth", router);
648
740
  };
649
741
  exports.addAuthRoutes = addAuthRoutes;
650
- var addMeRoutes = function (app, userModel, _authOptions) {
742
+ var addMeRoutes = function (app, userModel, _authOptions, accessControl) {
651
743
  var router = express_1.default.Router();
652
744
  router.get("/me", (0, exports.authenticateMiddleware)(), function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
653
- var data, dataObject;
654
- var _a;
655
- return __generator(this, function (_b) {
656
- switch (_b.label) {
745
+ var data, dataObject, withRoles, _a;
746
+ var _b, _c;
747
+ return __generator(this, function (_d) {
748
+ switch (_d.label) {
657
749
  case 0:
658
- if (!((_a = req.user) === null || _a === void 0 ? void 0 : _a.id)) {
750
+ if (!((_b = req.user) === null || _b === void 0 ? void 0 : _b.id)) {
659
751
  logger_1.logger.debug("Not user found for /me");
660
752
  return [2 /*return*/, res.sendStatus(401)];
661
753
  }
662
754
  return [4 /*yield*/, userModel.findById(req.user.id)];
663
755
  case 1:
664
- data = _b.sent();
756
+ data = _d.sent();
665
757
  if (!data) {
666
758
  logger_1.logger.debug("Not user data found for /me");
667
759
  return [2 /*return*/, res.sendStatus(404)];
668
760
  }
669
761
  dataObject = data.toObject();
670
762
  dataObject.id = data._id;
671
- return [2 /*return*/, res.json({ data: dataObject })];
763
+ if (!accessControl) return [3 /*break*/, 3];
764
+ withRoles = data;
765
+ dataObject.roles = (_c = withRoles.roles) !== null && _c !== void 0 ? _c : [];
766
+ _a = dataObject;
767
+ return [4 /*yield*/, accessControl.getPermissions({
768
+ user: data,
769
+ })];
770
+ case 2:
771
+ _a.permissions = _d.sent();
772
+ _d.label = 3;
773
+ case 3: return [2 /*return*/, res.json({ data: dataObject })];
672
774
  }
673
775
  });
674
776
  }); });
675
777
  router.patch("/me", (0, exports.authenticateMiddleware)(), function (req, res) { return __awaiter(void 0, void 0, void 0, function () {
676
778
  var doc, dataObject, error_6, message;
677
- var _a;
678
- return __generator(this, function (_b) {
679
- switch (_b.label) {
779
+ var _a, _b;
780
+ return __generator(this, function (_c) {
781
+ switch (_c.label) {
680
782
  case 0:
681
783
  if (!((_a = req.user) === null || _a === void 0 ? void 0 : _a.id)) {
682
784
  return [2 /*return*/, res.sendStatus(401)];
683
785
  }
684
786
  return [4 /*yield*/, userModel.findById(req.user.id)];
685
787
  case 1:
686
- doc = _b.sent();
788
+ doc = _c.sent();
687
789
  if (!doc) {
688
790
  return [2 /*return*/, res.sendStatus(404)];
689
791
  }
690
- _b.label = 2;
792
+ _c.label = 2;
691
793
  case 2:
692
- _b.trys.push([2, 4, , 5]);
693
- Object.assign(doc, req.body);
794
+ _c.trys.push([2, 4, , 5]);
795
+ Object.assign(doc, (0, exports.stripPrivilegedUserFields)((_b = req.body) !== null && _b !== void 0 ? _b : {}, "PATCH /auth/me"));
694
796
  return [4 /*yield*/, doc.save()];
695
797
  case 3:
696
- _b.sent();
798
+ _c.sent();
697
799
  dataObject = doc.toObject();
698
800
  dataObject.id = doc._id;
699
801
  return [2 /*return*/, res.json({ data: dataObject })];
700
802
  case 4:
701
- error_6 = _b.sent();
803
+ error_6 = _c.sent();
702
804
  message = (0, errors_1.errorMessage)(error_6);
703
805
  return [2 /*return*/, res.status(403).send({ message: message })];
704
806
  case 5: return [2 /*return*/];
@@ -6,6 +6,7 @@
6
6
  * endpoints for fetching pending consents and submitting responses.
7
7
  */
8
8
  import { type Application } from "express";
9
+ import type { AdminContribution } from "./adminTypes";
9
10
  import type { User } from "./auth";
10
11
  import type { PopulatePath } from "./populate";
11
12
  import type { TerrenoPlugin } from "./terrenoPlugin";
@@ -32,5 +33,6 @@ export interface ConsentAppOptions {
32
33
  export declare class ConsentApp implements TerrenoPlugin {
33
34
  private options;
34
35
  constructor(options?: ConsentAppOptions);
36
+ adminContribution(): AdminContribution;
35
37
  register(app: Application): void;
36
38
  }
@@ -85,6 +85,104 @@ var ConsentApp = /** @class */ (function () {
85
85
  if (options === void 0) { options = {}; }
86
86
  this.options = options;
87
87
  }
88
+ ConsentApp.prototype.adminContribution = function () {
89
+ return {
90
+ models: [
91
+ {
92
+ admin: {
93
+ defaultSort: "order",
94
+ displayName: "Consent Forms",
95
+ fieldOrder: [
96
+ "title",
97
+ "slug",
98
+ "type",
99
+ "version",
100
+ "order",
101
+ "active",
102
+ "required",
103
+ "content",
104
+ "defaultLocale",
105
+ "requireScrollToBottom",
106
+ "captureSignature",
107
+ "agreeButtonText",
108
+ "allowDecline",
109
+ "declineButtonText",
110
+ "checkboxes",
111
+ ],
112
+ fieldOverrides: {
113
+ checkboxes: { widget: "checkbox-list" },
114
+ content: { widget: "locale-content" },
115
+ defaultLocale: { widget: "locale-default" },
116
+ },
117
+ fieldsets: [
118
+ {
119
+ fields: ["title", "slug", "type", "version", "order", "active", "required"],
120
+ title: "Basics",
121
+ },
122
+ {
123
+ fields: ["content", "defaultLocale", "requireScrollToBottom", "checkboxes"],
124
+ title: "Content",
125
+ },
126
+ {
127
+ fields: [
128
+ "captureSignature",
129
+ "agreeButtonText",
130
+ "allowDecline",
131
+ "declineButtonText",
132
+ ],
133
+ title: "Actions",
134
+ },
135
+ ],
136
+ filters: [
137
+ { field: "active", kind: "boolean", label: "Active" },
138
+ {
139
+ choices: [
140
+ { label: "Agreement", value: "agreement" },
141
+ { label: "Privacy", value: "privacy" },
142
+ { label: "HIPAA", value: "hipaa" },
143
+ { label: "Research", value: "research" },
144
+ { label: "Terms", value: "terms" },
145
+ { label: "Custom", value: "custom" },
146
+ ],
147
+ field: "type",
148
+ kind: "choice",
149
+ label: "Type",
150
+ },
151
+ ],
152
+ group: "Compliance",
153
+ listDisplay: ["title", "type", "version", "active", "order"],
154
+ listFields: ["title", "type", "version", "active", "order"],
155
+ searchFields: ["title", "slug"],
156
+ sortableFields: ["title", "type", "version", "active", "order", "created"],
157
+ },
158
+ model: consentForm_1.ConsentForm,
159
+ routePath: "/consent-forms",
160
+ },
161
+ {
162
+ admin: {
163
+ adminPermissions: {
164
+ create: [],
165
+ delete: [],
166
+ update: [],
167
+ },
168
+ defaultSort: "-agreedAt",
169
+ displayName: "Consent Responses",
170
+ filters: [
171
+ { field: "agreed", kind: "boolean", label: "Agreed" },
172
+ { field: "locale", kind: "text", label: "Locale" },
173
+ ],
174
+ group: "Compliance",
175
+ listFields: ["userId", "agreed", "locale", "agreedAt"],
176
+ searchFields: ["locale"],
177
+ sortableFields: ["agreed", "locale", "agreedAt", "created"],
178
+ },
179
+ model: consentResponse_1.ConsentResponse,
180
+ populatePaths: exports.consentResponsePopulatePaths,
181
+ routePath: "/consent-responses",
182
+ },
183
+ ],
184
+ };
185
+ };
88
186
  ConsentApp.prototype.register = function (app) {
89
187
  var _this = this;
90
188
  var _a = this.options, auditTrail = _a.auditTrail, resolveConsentForms = _a.resolveConsentForms, aiConfig = _a.aiConfig;
package/dist/index.d.ts CHANGED
@@ -1,4 +1,5 @@
1
1
  export * from "./actions";
2
+ export * from "./adminTypes";
2
3
  export * from "./api";
3
4
  export * from "./auth";
4
5
  export * from "./betterAuth";
@@ -14,6 +15,13 @@ export * from "./expressServer";
14
15
  export * from "./githubAuth";
15
16
  export * from "./httpClient";
16
17
  export * from "./logger";
18
+ export { extractUserFromHeaders, type MCPAuthContext } from "./mcp/auth";
19
+ export type { MCPCustomTool } from "./mcp/registry";
20
+ export { clearMCPRegistry, getMCPRegistry, registerMCPModel, registerMCPTool, updateMCPRegistryOptions, } from "./mcp/registry";
21
+ export { generateInputSchema, generateToolDescription } from "./mcp/schemaGenerator";
22
+ export { type MCPServerOptions, mountMCPServer } from "./mcp/server";
23
+ export { generateAllTools, generateToolsForEntry, getAllMCPTools, type MCPToolDefinition, } from "./mcp/toolGenerator";
24
+ export type { MCPConfig, MCPMethod, MCPRegistryEntry, MCPRequest, MCPToolArgs, MCPToolResult, } from "./mcp/types";
17
25
  export * from "./middleware";
18
26
  export * from "./models/consentForm";
19
27
  export * from "./models/consentResponse";
@@ -28,17 +36,30 @@ export * from "./openApiValidator";
28
36
  export * from "./permissions";
29
37
  export * from "./plugins";
30
38
  export * from "./populate";
39
+ export * from "./rbac/access";
40
+ export { createRbacAuditModel, type RbacAuditDocument, recordRbacAudit, } from "./rbac/auditModel";
41
+ export { type BackfillAdminsOptions, type BackfillAdminsResult, backfillAdmins, } from "./rbac/backfillAdmins";
42
+ export * from "./rbac/fieldViews";
43
+ export * from "./rbac/middleware";
44
+ export * from "./rbac/permissionUtils";
45
+ export { createRbacRoleModel, expandRolePermissions, type RbacRoleDocument, type RbacRoleModel, READ_ONLY_ROLE_PERMISSIONS, type RoleDefinition, terrenoDefaultRoles, } from "./rbac/roleModel";
46
+ export { type RbacRouterOptions, rbacRouter } from "./rbac/routes";
47
+ export * from "./rbac/scopes";
48
+ export * from "./rbac/statements";
49
+ export * from "./rbac/types";
50
+ export * from "./rbac/userPlugin";
31
51
  export { type AuthorizedEmitEntry, emitPayloadToAuthorizedRoom, emitSyncDeltaForChange, startChangeStreamWatcher, stopChangeStreamWatcher, } from "./realtime/changeStreamWatcher";
32
52
  export { matchesQuery } from "./realtime/queryMatcher";
33
53
  export { addQuerySubscription, clearQueryStore, computeQueryId, getQuerySubscriptionsForCollection, removeAllSocketQueries, removeQuerySubscription, } from "./realtime/queryStore";
34
54
  export { installRealtimeSocketHandlers, MAX_DOCUMENT_SUBSCRIPTIONS, MAX_MODEL_SUBSCRIPTIONS, MAX_QUERY_SUBSCRIPTIONS, RealtimeApp, type RealtimeSocketLike, } from "./realtime/realtimeApp";
35
- export { clearRealtimeRegistry, findRegistryEntryByCollection, findRegistryEntryByRoutePath, getRealtimeRegistry, type RealtimeRegistryEntry, registerRealtime, } from "./realtime/registry";
55
+ export { clearRealtimeRegistry, findRegistryEntryByCollection, findRegistryEntryByRoutePath, getRealtimeRegistry, type RealtimeRegistryEntry, registerRealtime, updateRealtimeRegistryOptions, } from "./realtime/registry";
36
56
  export { DEFAULT_SESSION_REVALIDATION_INTERVAL_MS, loadFullUserForSocket, type RevalidatableSocket, type RevalidationOutcome, reresolveSyncRoomsForSocket, revalidateSocketSession, runSessionRevalidationSweep, type SessionRevalidationHandle, type SessionRevalidationOptions, startSessionRevalidationSweep, } from "./realtime/sessionRevalidation";
37
57
  export { type AuthenticatableSocket, type BetterAuthSocketOptions, createBetterAuthValidator, createLegacyJwtValidator, createSocketAuthMiddleware, type SocketAuthValidator, } from "./realtime/socketAuth";
38
58
  export { type DecodedRealtimeToken, getSocketUser, type SocketDataBag, type SocketWithDecodedToken, } from "./realtime/socketUser";
39
59
  export type { ChangeStreamConfig, DocumentSubscription, QuerySubscription, RealtimeAppOptions, RealtimeConfig, RealtimeEvent, } from "./realtime/types";
40
60
  export * from "./requestContext";
41
61
  export * from "./scriptRunner";
62
+ export { adminBodyFieldsToStrip, scrubAdminFields, stripAdminBodyFields } from "./scrubAdminFields";
42
63
  export * from "./secretProviders";
43
64
  export * from "./sync/executors";
44
65
  export * from "./sync/models";