@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/index.js CHANGED
@@ -14,8 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
14
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
15
  };
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
- exports.z = exports.getSocketUser = exports.createSocketAuthMiddleware = exports.createLegacyJwtValidator = exports.createBetterAuthValidator = exports.startSessionRevalidationSweep = exports.runSessionRevalidationSweep = exports.revalidateSocketSession = exports.reresolveSyncRoomsForSocket = exports.loadFullUserForSocket = exports.DEFAULT_SESSION_REVALIDATION_INTERVAL_MS = exports.registerRealtime = exports.getRealtimeRegistry = exports.findRegistryEntryByRoutePath = exports.findRegistryEntryByCollection = exports.clearRealtimeRegistry = exports.RealtimeApp = exports.MAX_QUERY_SUBSCRIPTIONS = exports.MAX_MODEL_SUBSCRIPTIONS = exports.MAX_DOCUMENT_SUBSCRIPTIONS = exports.installRealtimeSocketHandlers = exports.removeQuerySubscription = exports.removeAllSocketQueries = exports.getQuerySubscriptionsForCollection = exports.computeQueryId = exports.clearQueryStore = exports.addQuerySubscription = exports.matchesQuery = exports.stopChangeStreamWatcher = exports.startChangeStreamWatcher = exports.emitSyncDeltaForChange = exports.emitPayloadToAuthorizedRoom = void 0;
17
+ exports.createLegacyJwtValidator = exports.createBetterAuthValidator = exports.startSessionRevalidationSweep = exports.runSessionRevalidationSweep = exports.revalidateSocketSession = exports.reresolveSyncRoomsForSocket = exports.loadFullUserForSocket = exports.DEFAULT_SESSION_REVALIDATION_INTERVAL_MS = exports.updateRealtimeRegistryOptions = exports.registerRealtime = exports.getRealtimeRegistry = exports.findRegistryEntryByRoutePath = exports.findRegistryEntryByCollection = exports.clearRealtimeRegistry = exports.RealtimeApp = exports.MAX_QUERY_SUBSCRIPTIONS = exports.MAX_MODEL_SUBSCRIPTIONS = exports.MAX_DOCUMENT_SUBSCRIPTIONS = exports.installRealtimeSocketHandlers = exports.removeQuerySubscription = exports.removeAllSocketQueries = exports.getQuerySubscriptionsForCollection = exports.computeQueryId = exports.clearQueryStore = exports.addQuerySubscription = exports.matchesQuery = exports.stopChangeStreamWatcher = exports.startChangeStreamWatcher = exports.emitSyncDeltaForChange = exports.emitPayloadToAuthorizedRoom = exports.rbacRouter = exports.terrenoDefaultRoles = exports.READ_ONLY_ROLE_PERMISSIONS = exports.expandRolePermissions = exports.createRbacRoleModel = exports.backfillAdmins = exports.recordRbacAudit = exports.createRbacAuditModel = exports.getAllMCPTools = exports.generateToolsForEntry = exports.generateAllTools = exports.mountMCPServer = exports.generateToolDescription = exports.generateInputSchema = exports.updateMCPRegistryOptions = exports.registerMCPTool = exports.registerMCPModel = exports.getMCPRegistry = exports.clearMCPRegistry = exports.extractUserFromHeaders = void 0;
18
+ exports.z = exports.stripAdminBodyFields = exports.scrubAdminFields = exports.adminBodyFieldsToStrip = exports.getSocketUser = exports.createSocketAuthMiddleware = void 0;
18
19
  __exportStar(require("./actions"), exports);
20
+ __exportStar(require("./adminTypes"), exports);
19
21
  __exportStar(require("./api"), exports);
20
22
  __exportStar(require("./auth"), exports);
21
23
  __exportStar(require("./betterAuth"), exports);
@@ -31,6 +33,23 @@ __exportStar(require("./expressServer"), exports);
31
33
  __exportStar(require("./githubAuth"), exports);
32
34
  __exportStar(require("./httpClient"), exports);
33
35
  __exportStar(require("./logger"), exports);
36
+ var auth_1 = require("./mcp/auth");
37
+ Object.defineProperty(exports, "extractUserFromHeaders", { enumerable: true, get: function () { return auth_1.extractUserFromHeaders; } });
38
+ var registry_1 = require("./mcp/registry");
39
+ Object.defineProperty(exports, "clearMCPRegistry", { enumerable: true, get: function () { return registry_1.clearMCPRegistry; } });
40
+ Object.defineProperty(exports, "getMCPRegistry", { enumerable: true, get: function () { return registry_1.getMCPRegistry; } });
41
+ Object.defineProperty(exports, "registerMCPModel", { enumerable: true, get: function () { return registry_1.registerMCPModel; } });
42
+ Object.defineProperty(exports, "registerMCPTool", { enumerable: true, get: function () { return registry_1.registerMCPTool; } });
43
+ Object.defineProperty(exports, "updateMCPRegistryOptions", { enumerable: true, get: function () { return registry_1.updateMCPRegistryOptions; } });
44
+ var schemaGenerator_1 = require("./mcp/schemaGenerator");
45
+ Object.defineProperty(exports, "generateInputSchema", { enumerable: true, get: function () { return schemaGenerator_1.generateInputSchema; } });
46
+ Object.defineProperty(exports, "generateToolDescription", { enumerable: true, get: function () { return schemaGenerator_1.generateToolDescription; } });
47
+ var server_1 = require("./mcp/server");
48
+ Object.defineProperty(exports, "mountMCPServer", { enumerable: true, get: function () { return server_1.mountMCPServer; } });
49
+ var toolGenerator_1 = require("./mcp/toolGenerator");
50
+ Object.defineProperty(exports, "generateAllTools", { enumerable: true, get: function () { return toolGenerator_1.generateAllTools; } });
51
+ Object.defineProperty(exports, "generateToolsForEntry", { enumerable: true, get: function () { return toolGenerator_1.generateToolsForEntry; } });
52
+ Object.defineProperty(exports, "getAllMCPTools", { enumerable: true, get: function () { return toolGenerator_1.getAllMCPTools; } });
34
53
  __exportStar(require("./middleware"), exports);
35
54
  __exportStar(require("./models/consentForm"), exports);
36
55
  __exportStar(require("./models/consentResponse"), exports);
@@ -45,6 +64,26 @@ __exportStar(require("./openApiValidator"), exports);
45
64
  __exportStar(require("./permissions"), exports);
46
65
  __exportStar(require("./plugins"), exports);
47
66
  __exportStar(require("./populate"), exports);
67
+ __exportStar(require("./rbac/access"), exports);
68
+ var auditModel_1 = require("./rbac/auditModel");
69
+ Object.defineProperty(exports, "createRbacAuditModel", { enumerable: true, get: function () { return auditModel_1.createRbacAuditModel; } });
70
+ Object.defineProperty(exports, "recordRbacAudit", { enumerable: true, get: function () { return auditModel_1.recordRbacAudit; } });
71
+ var backfillAdmins_1 = require("./rbac/backfillAdmins");
72
+ Object.defineProperty(exports, "backfillAdmins", { enumerable: true, get: function () { return backfillAdmins_1.backfillAdmins; } });
73
+ __exportStar(require("./rbac/fieldViews"), exports);
74
+ __exportStar(require("./rbac/middleware"), exports);
75
+ __exportStar(require("./rbac/permissionUtils"), exports);
76
+ var roleModel_1 = require("./rbac/roleModel");
77
+ Object.defineProperty(exports, "createRbacRoleModel", { enumerable: true, get: function () { return roleModel_1.createRbacRoleModel; } });
78
+ Object.defineProperty(exports, "expandRolePermissions", { enumerable: true, get: function () { return roleModel_1.expandRolePermissions; } });
79
+ Object.defineProperty(exports, "READ_ONLY_ROLE_PERMISSIONS", { enumerable: true, get: function () { return roleModel_1.READ_ONLY_ROLE_PERMISSIONS; } });
80
+ Object.defineProperty(exports, "terrenoDefaultRoles", { enumerable: true, get: function () { return roleModel_1.terrenoDefaultRoles; } });
81
+ var routes_1 = require("./rbac/routes");
82
+ Object.defineProperty(exports, "rbacRouter", { enumerable: true, get: function () { return routes_1.rbacRouter; } });
83
+ __exportStar(require("./rbac/scopes"), exports);
84
+ __exportStar(require("./rbac/statements"), exports);
85
+ __exportStar(require("./rbac/types"), exports);
86
+ __exportStar(require("./rbac/userPlugin"), exports);
48
87
  var changeStreamWatcher_1 = require("./realtime/changeStreamWatcher");
49
88
  Object.defineProperty(exports, "emitPayloadToAuthorizedRoom", { enumerable: true, get: function () { return changeStreamWatcher_1.emitPayloadToAuthorizedRoom; } });
50
89
  Object.defineProperty(exports, "emitSyncDeltaForChange", { enumerable: true, get: function () { return changeStreamWatcher_1.emitSyncDeltaForChange; } });
@@ -65,12 +104,13 @@ Object.defineProperty(exports, "MAX_DOCUMENT_SUBSCRIPTIONS", { enumerable: true,
65
104
  Object.defineProperty(exports, "MAX_MODEL_SUBSCRIPTIONS", { enumerable: true, get: function () { return realtimeApp_1.MAX_MODEL_SUBSCRIPTIONS; } });
66
105
  Object.defineProperty(exports, "MAX_QUERY_SUBSCRIPTIONS", { enumerable: true, get: function () { return realtimeApp_1.MAX_QUERY_SUBSCRIPTIONS; } });
67
106
  Object.defineProperty(exports, "RealtimeApp", { enumerable: true, get: function () { return realtimeApp_1.RealtimeApp; } });
68
- var registry_1 = require("./realtime/registry");
69
- Object.defineProperty(exports, "clearRealtimeRegistry", { enumerable: true, get: function () { return registry_1.clearRealtimeRegistry; } });
70
- Object.defineProperty(exports, "findRegistryEntryByCollection", { enumerable: true, get: function () { return registry_1.findRegistryEntryByCollection; } });
71
- Object.defineProperty(exports, "findRegistryEntryByRoutePath", { enumerable: true, get: function () { return registry_1.findRegistryEntryByRoutePath; } });
72
- Object.defineProperty(exports, "getRealtimeRegistry", { enumerable: true, get: function () { return registry_1.getRealtimeRegistry; } });
73
- Object.defineProperty(exports, "registerRealtime", { enumerable: true, get: function () { return registry_1.registerRealtime; } });
107
+ var registry_2 = require("./realtime/registry");
108
+ Object.defineProperty(exports, "clearRealtimeRegistry", { enumerable: true, get: function () { return registry_2.clearRealtimeRegistry; } });
109
+ Object.defineProperty(exports, "findRegistryEntryByCollection", { enumerable: true, get: function () { return registry_2.findRegistryEntryByCollection; } });
110
+ Object.defineProperty(exports, "findRegistryEntryByRoutePath", { enumerable: true, get: function () { return registry_2.findRegistryEntryByRoutePath; } });
111
+ Object.defineProperty(exports, "getRealtimeRegistry", { enumerable: true, get: function () { return registry_2.getRealtimeRegistry; } });
112
+ Object.defineProperty(exports, "registerRealtime", { enumerable: true, get: function () { return registry_2.registerRealtime; } });
113
+ Object.defineProperty(exports, "updateRealtimeRegistryOptions", { enumerable: true, get: function () { return registry_2.updateRealtimeRegistryOptions; } });
74
114
  var sessionRevalidation_1 = require("./realtime/sessionRevalidation");
75
115
  Object.defineProperty(exports, "DEFAULT_SESSION_REVALIDATION_INTERVAL_MS", { enumerable: true, get: function () { return sessionRevalidation_1.DEFAULT_SESSION_REVALIDATION_INTERVAL_MS; } });
76
116
  Object.defineProperty(exports, "loadFullUserForSocket", { enumerable: true, get: function () { return sessionRevalidation_1.loadFullUserForSocket; } });
@@ -86,6 +126,10 @@ var socketUser_1 = require("./realtime/socketUser");
86
126
  Object.defineProperty(exports, "getSocketUser", { enumerable: true, get: function () { return socketUser_1.getSocketUser; } });
87
127
  __exportStar(require("./requestContext"), exports);
88
128
  __exportStar(require("./scriptRunner"), exports);
129
+ var scrubAdminFields_1 = require("./scrubAdminFields");
130
+ Object.defineProperty(exports, "adminBodyFieldsToStrip", { enumerable: true, get: function () { return scrubAdminFields_1.adminBodyFieldsToStrip; } });
131
+ Object.defineProperty(exports, "scrubAdminFields", { enumerable: true, get: function () { return scrubAdminFields_1.scrubAdminFields; } });
132
+ Object.defineProperty(exports, "stripAdminBodyFields", { enumerable: true, get: function () { return scrubAdminFields_1.stripAdminBodyFields; } });
89
133
  __exportStar(require("./secretProviders"), exports);
90
134
  __exportStar(require("./sync/executors"), exports);
91
135
  __exportStar(require("./sync/models"), exports);
@@ -0,0 +1,11 @@
1
+ import type { User, UserModel } from "../auth";
2
+ import type { BetterAuthInstance } from "../betterAuthSetup";
3
+ export interface MCPAuthContext {
4
+ userModel: UserModel;
5
+ betterAuth?: BetterAuthInstance;
6
+ }
7
+ /**
8
+ * Extract user from raw headers using whichever auth provider is configured.
9
+ * Works with both JWT and Better Auth, mirroring authenticateMiddleware behavior.
10
+ */
11
+ export declare const extractUserFromHeaders: (headers: Record<string, string | string[] | undefined>, context: MCPAuthContext) => Promise<User | undefined>;
@@ -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 __importDefault = (this && this.__importDefault) || function (mod) {
39
+ return (mod && mod.__esModule) ? mod : { "default": mod };
40
+ };
41
+ Object.defineProperty(exports, "__esModule", { value: true });
42
+ exports.extractUserFromHeaders = void 0;
43
+ var jsonwebtoken_1 = __importDefault(require("jsonwebtoken"));
44
+ var logger_1 = require("../logger");
45
+ var plugins_1 = require("../plugins");
46
+ /**
47
+ * Reject a disabled account the way the JWT middleware's 401 does. Without this an MCP
48
+ * client could keep calling tools with a still-valid token or session after the account
49
+ * was disabled, which REST already refuses.
50
+ */
51
+ var rejectIfDisabled = function (user, source) {
52
+ if (!user) {
53
+ return undefined;
54
+ }
55
+ if (user.disabled) {
56
+ logger_1.logger.warn("[mcp] User ".concat(user.id, " is disabled, rejecting ").concat(source, " credentials"));
57
+ return undefined;
58
+ }
59
+ return user;
60
+ };
61
+ /**
62
+ * Extract user from raw headers using whichever auth provider is configured.
63
+ * Works with both JWT and Better Auth, mirroring authenticateMiddleware behavior.
64
+ */
65
+ var extractUserFromHeaders = function (headers, context) { return __awaiter(void 0, void 0, void 0, function () {
66
+ var userModel, betterAuth, session, appUser, error_1, authorization, token, tokenSecret, decoded, userId, user, error_2;
67
+ return __generator(this, function (_a) {
68
+ switch (_a.label) {
69
+ case 0:
70
+ userModel = context.userModel, betterAuth = context.betterAuth;
71
+ if (!betterAuth) return [3 /*break*/, 6];
72
+ _a.label = 1;
73
+ case 1:
74
+ _a.trys.push([1, 5, , 6]);
75
+ return [4 /*yield*/, betterAuth.api.getSession({
76
+ headers: headers,
77
+ })];
78
+ case 2:
79
+ session = _a.sent();
80
+ if (!((session === null || session === void 0 ? void 0 : session.user) && (session === null || session === void 0 ? void 0 : session.session))) return [3 /*break*/, 4];
81
+ return [4 /*yield*/, (0, plugins_1.findOneOrNoneFor)(userModel, { betterAuthId: session.user.id })];
82
+ case 3:
83
+ appUser = _a.sent();
84
+ if (appUser) {
85
+ return [2 /*return*/, rejectIfDisabled(appUser, "Better Auth")];
86
+ }
87
+ _a.label = 4;
88
+ case 4: return [3 /*break*/, 6];
89
+ case 5:
90
+ error_1 = _a.sent();
91
+ logger_1.logger.debug("MCP Better Auth session extraction failed: ".concat(error_1));
92
+ return [3 /*break*/, 6];
93
+ case 6:
94
+ authorization = typeof headers.authorization === "string"
95
+ ? headers.authorization
96
+ : Array.isArray(headers.authorization)
97
+ ? headers.authorization[0]
98
+ : undefined;
99
+ if (!authorization) {
100
+ return [2 /*return*/, undefined];
101
+ }
102
+ token = authorization.startsWith("Bearer ") ? authorization.slice(7) : authorization;
103
+ if (!token) {
104
+ return [2 /*return*/, undefined];
105
+ }
106
+ tokenSecret = process.env.TOKEN_SECRET;
107
+ if (!tokenSecret) {
108
+ logger_1.logger.warn("TOKEN_SECRET not set, cannot verify JWT for MCP request");
109
+ return [2 /*return*/, undefined];
110
+ }
111
+ _a.label = 7;
112
+ case 7:
113
+ _a.trys.push([7, 9, , 10]);
114
+ decoded = jsonwebtoken_1.default.verify(token, tokenSecret, {
115
+ issuer: process.env.TOKEN_ISSUER,
116
+ });
117
+ userId = decoded.id || decoded.sub;
118
+ if (!userId) {
119
+ return [2 /*return*/, undefined];
120
+ }
121
+ return [4 /*yield*/, userModel.findById(userId)];
122
+ case 8:
123
+ user = _a.sent();
124
+ return [2 /*return*/, rejectIfDisabled(user, "JWT")];
125
+ case 9:
126
+ error_2 = _a.sent();
127
+ logger_1.logger.debug("MCP JWT verification failed: ".concat(error_2));
128
+ return [2 /*return*/, undefined];
129
+ case 10: return [2 /*return*/];
130
+ }
131
+ });
132
+ }); };
133
+ exports.extractUserFromHeaders = extractUserFromHeaders;
@@ -0,0 +1,16 @@
1
+ import type express from "express";
2
+ import type { User } from "../auth";
3
+ import type { MCPToolArgs } from "./types";
4
+ /**
5
+ * Build the Express-shaped request handed to lifecycle hooks and response handlers.
6
+ *
7
+ * An MCP tool call is JSON-RPC, not HTTP, so there is no real request to forward. The
8
+ * authenticated user is the only field with a genuine equivalent — everything else is
9
+ * filled in with empty defaults so hooks that read `req.body`, `req.query`, `req.params`,
10
+ * or `req.headers` get the shape they expect instead of a TypeError. `isMCPRequest` lets
11
+ * a hook detect the MCP path when it needs to behave differently from HTTP.
12
+ */
13
+ export declare const createMCPRequest: ({ body, user, }: {
14
+ body?: MCPToolArgs;
15
+ user?: User;
16
+ }) => express.Request;
@@ -0,0 +1,26 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.createMCPRequest = void 0;
4
+ /**
5
+ * Build the Express-shaped request handed to lifecycle hooks and response handlers.
6
+ *
7
+ * An MCP tool call is JSON-RPC, not HTTP, so there is no real request to forward. The
8
+ * authenticated user is the only field with a genuine equivalent — everything else is
9
+ * filled in with empty defaults so hooks that read `req.body`, `req.query`, `req.params`,
10
+ * or `req.headers` get the shape they expect instead of a TypeError. `isMCPRequest` lets
11
+ * a hook detect the MCP path when it needs to behave differently from HTTP.
12
+ */
13
+ var createMCPRequest = function (_a) {
14
+ var _b = _a.body, body = _b === void 0 ? {} : _b, user = _a.user;
15
+ var request = {
16
+ body: body,
17
+ headers: {},
18
+ isMCPRequest: true,
19
+ method: "MCP",
20
+ params: {},
21
+ query: {},
22
+ user: user,
23
+ };
24
+ return request;
25
+ };
26
+ exports.createMCPRequest = createMCPRequest;
@@ -0,0 +1,8 @@
1
+ import { type User } from "../auth";
2
+ import type { MCPRegistryEntry, MCPToolArgs, MCPToolResult } from "./types";
3
+ export declare const getMCPErrorCause: (result: MCPToolResult) => unknown;
4
+ export declare const handleList: (entry: MCPRegistryEntry, args: MCPToolArgs, user?: User) => Promise<MCPToolResult>;
5
+ export declare const handleRead: (entry: MCPRegistryEntry, args: MCPToolArgs, user?: User) => Promise<MCPToolResult>;
6
+ export declare const handleCreate: (entry: MCPRegistryEntry, args: MCPToolArgs, user?: User) => Promise<MCPToolResult>;
7
+ export declare const handleUpdate: (entry: MCPRegistryEntry, args: MCPToolArgs, user?: User) => Promise<MCPToolResult>;
8
+ export declare const handleDelete: (entry: MCPRegistryEntry, args: MCPToolArgs, user?: User) => Promise<MCPToolResult>;