@terreno/api 57.0.0 → 57.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (175) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +8 -0
  2. package/dist/actions.d.ts +7 -2
  3. package/dist/actions.js +60 -25
  4. package/dist/adminModelRouter.d.ts +14 -0
  5. package/dist/adminModelRouter.js +199 -0
  6. package/dist/adminTypes.d.ts +182 -0
  7. package/dist/adminTypes.js +5 -0
  8. package/dist/api.d.ts +44 -3
  9. package/dist/api.js +74 -26
  10. package/dist/auth.d.ts +18 -1
  11. package/dist/auth.js +122 -20
  12. package/dist/consentApp.d.ts +2 -0
  13. package/dist/consentApp.js +98 -0
  14. package/dist/index.d.ts +22 -1
  15. package/dist/index.js +51 -7
  16. package/dist/mcp/auth.d.ts +11 -0
  17. package/dist/mcp/auth.js +133 -0
  18. package/dist/mcp/createMCPRequest.d.ts +16 -0
  19. package/dist/mcp/createMCPRequest.js +26 -0
  20. package/dist/mcp/handlers.d.ts +8 -0
  21. package/dist/mcp/handlers.js +793 -0
  22. package/dist/mcp/query.d.ts +32 -0
  23. package/dist/mcp/query.js +232 -0
  24. package/dist/mcp/registry.d.ts +21 -0
  25. package/dist/mcp/registry.js +54 -0
  26. package/dist/mcp/schemaGenerator.d.ts +14 -0
  27. package/dist/mcp/schemaGenerator.js +379 -0
  28. package/dist/mcp/server.d.ts +8 -0
  29. package/dist/mcp/server.js +133 -0
  30. package/dist/mcp/toolGenerator.d.ts +14 -0
  31. package/dist/mcp/toolGenerator.js +246 -0
  32. package/dist/mcp/types.d.ts +85 -0
  33. package/dist/mcp/types.js +2 -0
  34. package/dist/openApi.d.ts +1 -1
  35. package/dist/openApi.js +26 -8
  36. package/dist/permissions.js +15 -15
  37. package/dist/rbac/access.d.ts +3 -0
  38. package/dist/rbac/access.js +294 -0
  39. package/dist/rbac/auditModel.d.ts +31 -0
  40. package/dist/rbac/auditModel.js +112 -0
  41. package/dist/rbac/backfillAdmins.d.ts +18 -0
  42. package/dist/rbac/backfillAdmins.js +139 -0
  43. package/dist/rbac/fieldViews.d.ts +3 -0
  44. package/dist/rbac/fieldViews.js +201 -0
  45. package/dist/rbac/middleware.d.ts +21 -0
  46. package/dist/rbac/middleware.js +108 -0
  47. package/dist/rbac/modelRouterAccess.d.ts +42 -0
  48. package/dist/rbac/modelRouterAccess.js +388 -0
  49. package/dist/rbac/permissionUtils.d.ts +8 -0
  50. package/dist/rbac/permissionUtils.js +209 -0
  51. package/dist/rbac/realtimeAccess.d.ts +18 -0
  52. package/dist/rbac/realtimeAccess.js +173 -0
  53. package/dist/rbac/resolve.d.ts +28 -0
  54. package/dist/rbac/resolve.js +387 -0
  55. package/dist/rbac/roleManager.d.ts +20 -0
  56. package/dist/rbac/roleManager.js +741 -0
  57. package/dist/rbac/roleModel.d.ts +42 -0
  58. package/dist/rbac/roleModel.js +267 -0
  59. package/dist/rbac/routes.d.ts +9 -0
  60. package/dist/rbac/routes.js +211 -0
  61. package/dist/rbac/scopes.d.ts +15 -0
  62. package/dist/rbac/scopes.js +155 -0
  63. package/dist/rbac/statements.d.ts +30 -0
  64. package/dist/rbac/statements.js +126 -0
  65. package/dist/rbac/types.d.ts +202 -0
  66. package/dist/rbac/types.js +2 -0
  67. package/dist/rbac/userPlugin.d.ts +12 -0
  68. package/dist/rbac/userPlugin.js +41 -0
  69. package/dist/realtime/changeStreamWatcher.d.ts +1 -1
  70. package/dist/realtime/changeStreamWatcher.js +48 -39
  71. package/dist/realtime/realtimeApp.js +4 -8
  72. package/dist/realtime/registry.d.ts +5 -0
  73. package/dist/realtime/registry.js +13 -1
  74. package/dist/scrubAdminFields.d.ts +17 -0
  75. package/dist/scrubAdminFields.js +192 -0
  76. package/dist/sync/executors.d.ts +1 -1
  77. package/dist/sync/executors.js +63 -40
  78. package/dist/sync/loadHarness.js +4 -5
  79. package/dist/sync/registry.d.ts +5 -0
  80. package/dist/sync/registry.js +13 -1
  81. package/dist/sync/routes.js +41 -36
  82. package/dist/sync/serialize.js +5 -6
  83. package/dist/terrenoApp.d.ts +18 -0
  84. package/dist/terrenoApp.js +46 -3
  85. package/dist/terrenoPlugin.d.ts +8 -1
  86. package/dist/tests/createTestData.js +8 -0
  87. package/dist/tests/models.d.ts +1 -0
  88. package/dist/tests/models.js +5 -0
  89. package/dist/tests/testHelper.js +1 -2
  90. package/dist/transformers.js +16 -1
  91. package/package.json +17 -13
  92. package/src/__snapshots__/openApi.test.ts.snap +192 -0
  93. package/src/actions.test.ts +194 -1
  94. package/src/actions.ts +65 -8
  95. package/src/adminModelRouter.ts +154 -0
  96. package/src/adminTypes.ts +206 -0
  97. package/src/api.test.ts +66 -1
  98. package/src/api.ts +131 -12
  99. package/src/auth.test.ts +135 -1
  100. package/src/auth.ts +81 -3
  101. package/src/consentApp.test.ts +24 -0
  102. package/src/consentApp.ts +100 -0
  103. package/src/index.ts +56 -0
  104. package/src/mcp/auth.test.ts +197 -0
  105. package/src/mcp/auth.ts +100 -0
  106. package/src/mcp/createMCPRequest.test.ts +47 -0
  107. package/src/mcp/createMCPRequest.ts +32 -0
  108. package/src/mcp/customTools.test.ts +54 -0
  109. package/src/mcp/handlers.ts +639 -0
  110. package/src/mcp/integration.test.ts +1493 -0
  111. package/src/mcp/query.test.ts +172 -0
  112. package/src/mcp/query.ts +179 -0
  113. package/src/mcp/registry.ts +70 -0
  114. package/src/mcp/schemaGenerator.test.ts +182 -0
  115. package/src/mcp/schemaGenerator.ts +354 -0
  116. package/src/mcp/server.test.ts +226 -0
  117. package/src/mcp/server.ts +86 -0
  118. package/src/mcp/toolGenerator.test.ts +284 -0
  119. package/src/mcp/toolGenerator.ts +199 -0
  120. package/src/mcp/types.ts +95 -0
  121. package/src/openApi.test.ts +107 -0
  122. package/src/openApi.ts +32 -1
  123. package/src/permissions.ts +3 -2
  124. package/src/rbac/access.test.ts +357 -0
  125. package/src/rbac/access.ts +201 -0
  126. package/src/rbac/auditModel.ts +103 -0
  127. package/src/rbac/backfillAdmins.ts +54 -0
  128. package/src/rbac/fieldViews.test.ts +39 -0
  129. package/src/rbac/fieldViews.ts +122 -0
  130. package/src/rbac/middleware.ts +55 -0
  131. package/src/rbac/modelRouterAccess.test.ts +336 -0
  132. package/src/rbac/modelRouterAccess.ts +331 -0
  133. package/src/rbac/permissionUtils.test.ts +112 -0
  134. package/src/rbac/permissionUtils.ts +83 -0
  135. package/src/rbac/realtimeAccess.test.ts +242 -0
  136. package/src/rbac/realtimeAccess.ts +138 -0
  137. package/src/rbac/resolve.test.ts +358 -0
  138. package/src/rbac/resolve.ts +285 -0
  139. package/src/rbac/roleManager.test.ts +915 -0
  140. package/src/rbac/roleManager.ts +440 -0
  141. package/src/rbac/roleModel.test.ts +114 -0
  142. package/src/rbac/roleModel.ts +196 -0
  143. package/src/rbac/routes.ts +170 -0
  144. package/src/rbac/scopes.test.ts +105 -0
  145. package/src/rbac/scopes.ts +81 -0
  146. package/src/rbac/statements.test.ts +67 -0
  147. package/src/rbac/statements.ts +73 -0
  148. package/src/rbac/types.ts +198 -0
  149. package/src/rbac/userPlugin.test.ts +55 -0
  150. package/src/rbac/userPlugin.ts +25 -0
  151. package/src/realtime/changeStreamWatcher.ts +20 -15
  152. package/src/realtime/realtime.test.ts +25 -1
  153. package/src/realtime/realtimeApp.ts +2 -5
  154. package/src/realtime/registry.ts +15 -0
  155. package/src/scrubAdminFields.test.ts +113 -0
  156. package/src/scrubAdminFields.ts +158 -0
  157. package/src/sync/executors.ts +31 -1
  158. package/src/sync/loadHarness.ts +8 -7
  159. package/src/sync/models.test.ts +262 -0
  160. package/src/sync/registry.ts +15 -0
  161. package/src/sync/routes.ts +25 -11
  162. package/src/sync/scripts/compactTombstones.test.ts +4 -6
  163. package/src/sync/serialize.ts +17 -9
  164. package/src/sync/sync.test.ts +52 -0
  165. package/src/sync/syncRoutes.test.ts +5 -2
  166. package/src/sync/syncSocket.test.ts +28 -0
  167. package/src/terrenoApp.test.ts +100 -0
  168. package/src/terrenoApp.ts +65 -3
  169. package/src/terrenoPlugin.ts +10 -1
  170. package/src/tests/bunSetup.ts +2 -0
  171. package/src/tests/createTestData.ts +5 -1
  172. package/src/tests/models.ts +6 -0
  173. package/src/tests/testHelper.ts +1 -3
  174. package/src/transformers.test.ts +12 -0
  175. package/src/transformers.ts +7 -1
@@ -0,0 +1,173 @@
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
+ Object.defineProperty(exports, "__esModule", { value: true });
39
+ exports.maskRealtimeDocument = exports.canReadDocumentRealtime = exports.canSubscribeRealtime = void 0;
40
+ var permissions_1 = require("../permissions");
41
+ var fieldViews_1 = require("./fieldViews");
42
+ var DEFAULT_METHOD_ACTIONS = {
43
+ list: "list",
44
+ read: "read",
45
+ };
46
+ var resolveActionForMethod = function (method, access, statements) {
47
+ var _a, _b;
48
+ var override = (_a = access.actions) === null || _a === void 0 ? void 0 : _a[method];
49
+ if (override === null) {
50
+ return null;
51
+ }
52
+ if (override) {
53
+ return override;
54
+ }
55
+ var resourceActions = (_b = statements[access.resource]) !== null && _b !== void 0 ? _b : [];
56
+ if (method === "list" && resourceActions.includes("list")) {
57
+ return "list";
58
+ }
59
+ if (method === "list") {
60
+ return "read";
61
+ }
62
+ return DEFAULT_METHOD_ACTIONS[method];
63
+ };
64
+ var canSubscribeRealtime = function (entry, method, user) { return __awaiter(void 0, void 0, void 0, function () {
65
+ var access, accessControl, statements, action, result, permissions;
66
+ var _a;
67
+ var _b, _c;
68
+ return __generator(this, function (_d) {
69
+ switch (_d.label) {
70
+ case 0:
71
+ access = entry.options.access;
72
+ accessControl = entry.options.accessControl;
73
+ if (!(access && accessControl)) return [3 /*break*/, 2];
74
+ statements = accessControl.statements;
75
+ action = resolveActionForMethod(method, access, statements);
76
+ if (!action) {
77
+ return [2 /*return*/, false];
78
+ }
79
+ return [4 /*yield*/, accessControl.can({
80
+ context: { transport: "socket" },
81
+ permissions: (_a = {}, _a[access.resource] = [action], _a),
82
+ user: user,
83
+ })];
84
+ case 1:
85
+ result = _d.sent();
86
+ return [2 /*return*/, result.allowed];
87
+ case 2:
88
+ permissions = (_c = (_b = entry.options.permissions) === null || _b === void 0 ? void 0 : _b[method]) !== null && _c !== void 0 ? _c : [];
89
+ return [2 /*return*/, (0, permissions_1.checkPermissions)(method, permissions, user)];
90
+ }
91
+ });
92
+ }); };
93
+ exports.canSubscribeRealtime = canSubscribeRealtime;
94
+ var canReadDocumentRealtime = function (entry, user, doc) { return __awaiter(void 0, void 0, void 0, function () {
95
+ var access, accessControl, statements, action, result, scopeResult, extra;
96
+ var _a;
97
+ var _b, _c, _d;
98
+ return __generator(this, function (_e) {
99
+ switch (_e.label) {
100
+ case 0:
101
+ access = entry.options.access;
102
+ accessControl = entry.options.accessControl;
103
+ if (!(access && accessControl)) return [3 /*break*/, 5];
104
+ statements = accessControl.statements;
105
+ action = resolveActionForMethod("read", access, statements);
106
+ if (!action) {
107
+ return [2 /*return*/, false];
108
+ }
109
+ return [4 /*yield*/, accessControl.can({
110
+ context: { transport: "socket" },
111
+ doc: doc,
112
+ permissions: (_a = {}, _a[access.resource] = [action], _a),
113
+ user: user,
114
+ })];
115
+ case 1:
116
+ result = _e.sent();
117
+ if (!result.allowed) {
118
+ return [2 /*return*/, false];
119
+ }
120
+ if (!((_b = access.scope) === null || _b === void 0 ? void 0 : _b.check)) return [3 /*break*/, 4];
121
+ if (!user) {
122
+ return [2 /*return*/, false];
123
+ }
124
+ return [4 /*yield*/, access.scope.check({
125
+ action: action,
126
+ doc: doc,
127
+ user: user,
128
+ })];
129
+ case 2:
130
+ scopeResult = _e.sent();
131
+ if (scopeResult === false) {
132
+ return [2 /*return*/, false];
133
+ }
134
+ if (!(scopeResult && typeof scopeResult === "object")) return [3 /*break*/, 4];
135
+ return [4 /*yield*/, accessControl.can({
136
+ context: { transport: "socket" },
137
+ doc: doc,
138
+ permissions: scopeResult,
139
+ user: user,
140
+ })];
141
+ case 3:
142
+ extra = _e.sent();
143
+ return [2 /*return*/, extra.allowed];
144
+ case 4: return [2 /*return*/, true];
145
+ case 5: return [2 /*return*/, (0, permissions_1.checkPermissions)("read", (_d = (_c = entry.options.permissions) === null || _c === void 0 ? void 0 : _c.read) !== null && _d !== void 0 ? _d : [], user, doc)];
146
+ }
147
+ });
148
+ }); };
149
+ exports.canReadDocumentRealtime = canReadDocumentRealtime;
150
+ var maskRealtimeDocument = function (entry, user, doc, _method) { return __awaiter(void 0, void 0, void 0, function () {
151
+ var access, accessControl, phase, mask;
152
+ return __generator(this, function (_a) {
153
+ switch (_a.label) {
154
+ case 0:
155
+ access = entry.options.access;
156
+ accessControl = entry.options.accessControl;
157
+ if (!access || !accessControl) {
158
+ return [2 /*return*/, doc];
159
+ }
160
+ phase = "read";
161
+ return [4 /*yield*/, accessControl.fieldMask({
162
+ doc: doc,
163
+ phase: phase,
164
+ resource: access.resource,
165
+ user: user,
166
+ })];
167
+ case 1:
168
+ mask = _a.sent();
169
+ return [2 /*return*/, (0, fieldViews_1.applyReadMask)(doc, mask)];
170
+ }
171
+ });
172
+ }); };
173
+ exports.maskRealtimeDocument = maskRealtimeDocument;
@@ -0,0 +1,28 @@
1
+ import type { User } from "../auth";
2
+ import type { RbacRoleModel } from "./roleModel";
3
+ import type { PermissionSet, Statements } from "./statements";
4
+ import type { PermissionSource } from "./types";
5
+ export declare const createPermissionResolver: <S extends Statements>(args: {
6
+ statements: S;
7
+ rbacRoleModel: RbacRoleModel;
8
+ sources?: PermissionSource[];
9
+ cacheTtlMs?: number;
10
+ maxCacheEntries?: number;
11
+ resolvePermissions?: (args: {
12
+ user: User;
13
+ }) => Promise<PermissionSet | null>;
14
+ }) => {
15
+ ac: {
16
+ newRole<const TRoleStatements extends import("better-auth/plugins/access").Statements>(statements: import("better-auth/plugins/access").RoleInput<S, TRoleStatements>): import("better-auth/plugins/access").Role<import("better-auth/plugins/access").ExactRoleStatements<TRoleStatements>, S>;
17
+ statements: S;
18
+ };
19
+ authorizePermissions: (permissions: PermissionSet, request: PermissionSet) => {
20
+ success: boolean;
21
+ error?: string;
22
+ };
23
+ invalidateCache: (invalidateArgs?: {
24
+ userId?: string;
25
+ }) => void;
26
+ resolvePermissionsForUser: (user: User) => Promise<PermissionSet>;
27
+ resolvePermissionsForUserUncached: (user: User) => Promise<PermissionSet>;
28
+ };
@@ -0,0 +1,387 @@
1
+ "use strict";
2
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
3
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
4
+ return new (P || (P = Promise))(function (resolve, reject) {
5
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
6
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
7
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
8
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
9
+ });
10
+ };
11
+ var __generator = (this && this.__generator) || function (thisArg, body) {
12
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
+ function verb(n) { return function (v) { return step([n, v]); }; }
15
+ function step(op) {
16
+ if (f) throw new TypeError("Generator is already executing.");
17
+ while (g && (g = 0, op[0] && (_ = 0)), _) try {
18
+ if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
19
+ if (y = 0, t) op = [op[0] & 2, t.value];
20
+ switch (op[0]) {
21
+ case 0: case 1: t = op; break;
22
+ case 4: _.label++; return { value: op[1], done: false };
23
+ case 5: _.label++; y = op[1]; op = [0]; continue;
24
+ case 7: op = _.ops.pop(); _.trys.pop(); continue;
25
+ default:
26
+ if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
27
+ if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
28
+ if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
29
+ if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
30
+ if (t[2]) _.ops.pop();
31
+ _.trys.pop(); continue;
32
+ }
33
+ op = body.call(thisArg, _);
34
+ } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
35
+ if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
+ }
37
+ };
38
+ var __values = (this && this.__values) || function(o) {
39
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
40
+ if (m) return m.call(o);
41
+ if (o && typeof o.length === "number") return {
42
+ next: function () {
43
+ if (o && i >= o.length) o = void 0;
44
+ return { value: o && o[i++], done: !o };
45
+ }
46
+ };
47
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
48
+ };
49
+ var __read = (this && this.__read) || function (o, n) {
50
+ var m = typeof Symbol === "function" && o[Symbol.iterator];
51
+ if (!m) return o;
52
+ var i = m.call(o), r, ar = [], e;
53
+ try {
54
+ while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
55
+ }
56
+ catch (error) { e = { error: error }; }
57
+ finally {
58
+ try {
59
+ if (r && !r.done && (m = i["return"])) m.call(i);
60
+ }
61
+ finally { if (e) throw e.error; }
62
+ }
63
+ return ar;
64
+ };
65
+ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
66
+ if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
67
+ if (ar || !(i in from)) {
68
+ if (!ar) ar = Array.prototype.slice.call(from, 0, i);
69
+ ar[i] = from[i];
70
+ }
71
+ }
72
+ return to.concat(ar || Array.prototype.slice.call(from));
73
+ };
74
+ Object.defineProperty(exports, "__esModule", { value: true });
75
+ exports.createPermissionResolver = void 0;
76
+ var access_1 = require("better-auth/plugins/access");
77
+ var logger_1 = require("../logger");
78
+ var permissionUtils_1 = require("./permissionUtils");
79
+ var DEFAULT_CACHE_TTL_MS = 30000;
80
+ var DEFAULT_MAX_CACHE_ENTRIES = 10000;
81
+ var getUserRoles = function (user) {
82
+ var _a;
83
+ var withRoles = user;
84
+ return (_a = withRoles.roles) !== null && _a !== void 0 ? _a : [];
85
+ };
86
+ var createPermissionResolver = function (args) {
87
+ var statements = args.statements, rbacRoleModel = args.rbacRoleModel, _a = args.sources, sources = _a === void 0 ? [] : _a, _b = args.cacheTtlMs, cacheTtlMs = _b === void 0 ? DEFAULT_CACHE_TTL_MS : _b, _c = args.maxCacheEntries, maxCacheEntries = _c === void 0 ? DEFAULT_MAX_CACHE_ENTRIES : _c, resolvePermissions = args.resolvePermissions;
88
+ var ac = (0, access_1.createAccessControl)(statements);
89
+ var permissionCache = new Map();
90
+ var sourceCache = new Map();
91
+ var enforceCacheBound = function () {
92
+ var e_1, _a;
93
+ var now = Date.now();
94
+ try {
95
+ for (var permissionCache_1 = __values(permissionCache), permissionCache_1_1 = permissionCache_1.next(); !permissionCache_1_1.done; permissionCache_1_1 = permissionCache_1.next()) {
96
+ var _b = __read(permissionCache_1_1.value, 2), userId = _b[0], entry = _b[1];
97
+ if (entry.expiresAt <= now) {
98
+ permissionCache.delete(userId);
99
+ }
100
+ }
101
+ }
102
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
103
+ finally {
104
+ try {
105
+ if (permissionCache_1_1 && !permissionCache_1_1.done && (_a = permissionCache_1.return)) _a.call(permissionCache_1);
106
+ }
107
+ finally { if (e_1) throw e_1.error; }
108
+ }
109
+ while (permissionCache.size > maxCacheEntries) {
110
+ var oldestUserId = permissionCache.keys().next().value;
111
+ if (oldestUserId === undefined) {
112
+ break;
113
+ }
114
+ permissionCache.delete(oldestUserId);
115
+ sourceCache.delete(oldestUserId);
116
+ }
117
+ while (sourceCache.size > maxCacheEntries) {
118
+ var oldestUserId = sourceCache.keys().next().value;
119
+ if (oldestUserId === undefined) {
120
+ break;
121
+ }
122
+ sourceCache.delete(oldestUserId);
123
+ }
124
+ };
125
+ var rememberPermissions = function (userId, entry) {
126
+ permissionCache.delete(userId);
127
+ permissionCache.set(userId, entry);
128
+ enforceCacheBound();
129
+ };
130
+ var invalidateCache = function (invalidateArgs) {
131
+ if (invalidateArgs === null || invalidateArgs === void 0 ? void 0 : invalidateArgs.userId) {
132
+ permissionCache.delete(invalidateArgs.userId);
133
+ sourceCache.delete(invalidateArgs.userId);
134
+ return;
135
+ }
136
+ permissionCache.clear();
137
+ sourceCache.clear();
138
+ };
139
+ var loadRolePermissions = function (roleNames) { return __awaiter(void 0, void 0, void 0, function () {
140
+ var roleDocs;
141
+ return __generator(this, function (_a) {
142
+ switch (_a.label) {
143
+ case 0:
144
+ if (roleNames.length === 0) {
145
+ return [2 /*return*/, []];
146
+ }
147
+ return [4 /*yield*/, rbacRoleModel.find({ name: { $in: roleNames } })];
148
+ case 1:
149
+ roleDocs = _a.sent();
150
+ return [2 /*return*/, roleDocs.map(function (roleDoc) { var _a; return (_a = roleDoc.permissions) !== null && _a !== void 0 ? _a : {}; })];
151
+ }
152
+ });
153
+ }); };
154
+ var applyDenyGrants = function (permissions, deny) {
155
+ var e_2, _a;
156
+ var _b;
157
+ if (!deny) {
158
+ return permissions;
159
+ }
160
+ var result = {};
161
+ var _loop_1 = function (resource, actions) {
162
+ var denied = new Set((_b = deny[resource]) !== null && _b !== void 0 ? _b : []);
163
+ var remaining = actions.filter(function (action) { return !denied.has(action); });
164
+ if (remaining.length > 0) {
165
+ result[resource] = remaining;
166
+ }
167
+ };
168
+ try {
169
+ for (var _c = __values(Object.entries(permissions)), _d = _c.next(); !_d.done; _d = _c.next()) {
170
+ var _e = __read(_d.value, 2), resource = _e[0], actions = _e[1];
171
+ _loop_1(resource, actions);
172
+ }
173
+ }
174
+ catch (e_2_1) { e_2 = { error: e_2_1 }; }
175
+ finally {
176
+ try {
177
+ if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
178
+ }
179
+ finally { if (e_2) throw e_2.error; }
180
+ }
181
+ return result;
182
+ };
183
+ var grantsFromStaleCache = function (source, cached, now) {
184
+ if (source.staleOnFailure === "use-stale-bounded" &&
185
+ cached &&
186
+ source.staleMaxAgeMs &&
187
+ now - cached.fetchedAt < source.staleMaxAgeMs) {
188
+ return cached.grants;
189
+ }
190
+ if (source.staleOnFailure === "use-stale" && cached) {
191
+ return cached.grants;
192
+ }
193
+ return null;
194
+ };
195
+ var denyOnlyFromCache = function (cached) {
196
+ var _a;
197
+ var deny = (_a = cached === null || cached === void 0 ? void 0 : cached.grants) === null || _a === void 0 ? void 0 : _a.deny;
198
+ if (!deny) {
199
+ return null;
200
+ }
201
+ return { deny: deny };
202
+ };
203
+ var grantsAfterSourceFailure = function (source, cached, now) {
204
+ var stale = grantsFromStaleCache(source, cached, now);
205
+ if (stale) {
206
+ return stale;
207
+ }
208
+ return denyOnlyFromCache(cached);
209
+ };
210
+ var fetchSourceGrants = function (user_1, source_1) {
211
+ var args_1 = [];
212
+ for (var _i = 2; _i < arguments.length; _i++) {
213
+ args_1[_i - 2] = arguments[_i];
214
+ }
215
+ return __awaiter(void 0, __spreadArray([user_1, source_1], __read(args_1), false), void 0, function (user, source, shouldCache) {
216
+ var now, cached, error_1, userSources, ttlMs, cachedAfterTouch, grants, error_2;
217
+ var _a, _b, _c, _d, _e;
218
+ if (shouldCache === void 0) { shouldCache = true; }
219
+ return __generator(this, function (_f) {
220
+ switch (_f.label) {
221
+ case 0:
222
+ now = Date.now();
223
+ cached = (_a = sourceCache.get(user.id)) === null || _a === void 0 ? void 0 : _a.get(source.name);
224
+ if (!!shouldCache) return [3 /*break*/, 4];
225
+ _f.label = 1;
226
+ case 1:
227
+ _f.trys.push([1, 3, , 4]);
228
+ return [4 /*yield*/, source.getGrants({ user: user })];
229
+ case 2: return [2 /*return*/, _f.sent()];
230
+ case 3:
231
+ error_1 = _f.sent();
232
+ logger_1.logger.warn("Permission source refresh failed during uncached resolution", {
233
+ error: error_1 instanceof Error ? error_1.message : String(error_1),
234
+ policy: (_b = source.staleOnFailure) !== null && _b !== void 0 ? _b : "deny",
235
+ source: source.name,
236
+ });
237
+ return [2 /*return*/, grantsAfterSourceFailure(source, cached, now)];
238
+ case 4:
239
+ userSources = (_c = sourceCache.get(user.id)) !== null && _c !== void 0 ? _c : new Map();
240
+ sourceCache.delete(user.id);
241
+ sourceCache.set(user.id, userSources);
242
+ ttlMs = (_d = source.ttlMs) !== null && _d !== void 0 ? _d : cacheTtlMs;
243
+ cachedAfterTouch = userSources.get(source.name);
244
+ if (cachedAfterTouch && now - cachedAfterTouch.fetchedAt < ttlMs) {
245
+ return [2 /*return*/, cachedAfterTouch.grants];
246
+ }
247
+ _f.label = 5;
248
+ case 5:
249
+ _f.trys.push([5, 7, , 8]);
250
+ return [4 /*yield*/, source.getGrants({ user: user })];
251
+ case 6:
252
+ grants = _f.sent();
253
+ userSources.set(source.name, { fetchedAt: now, grants: grants });
254
+ return [2 /*return*/, grants];
255
+ case 7:
256
+ error_2 = _f.sent();
257
+ logger_1.logger.warn("Permission source refresh failed", {
258
+ error: error_2 instanceof Error ? error_2.message : String(error_2),
259
+ policy: (_e = source.staleOnFailure) !== null && _e !== void 0 ? _e : "deny",
260
+ source: source.name,
261
+ });
262
+ return [2 /*return*/, grantsAfterSourceFailure(source, cachedAfterTouch, now)];
263
+ case 8: return [2 /*return*/];
264
+ }
265
+ });
266
+ });
267
+ };
268
+ var resolveEffectivePermissions = function (user, shouldCache) { return __awaiter(void 0, void 0, void 0, function () {
269
+ var cached, roleNames, permissionSets, sourceResults, sources_1, sources_1_1, source, grants, e_3_1, uniqueRoleNames, _a, _b, _c, _d, custom, permissions, sources_2, sources_2_1, source, grants;
270
+ var e_3, _e, e_4, _f;
271
+ var _g;
272
+ return __generator(this, function (_h) {
273
+ switch (_h.label) {
274
+ case 0:
275
+ if (shouldCache) {
276
+ cached = permissionCache.get(user.id);
277
+ if (cached && cached.expiresAt > Date.now()) {
278
+ rememberPermissions(user.id, cached);
279
+ return [2 /*return*/, cached.permissions];
280
+ }
281
+ }
282
+ roleNames = __spreadArray([], __read(getUserRoles(user)), false);
283
+ permissionSets = [];
284
+ sourceResults = new Map();
285
+ _h.label = 1;
286
+ case 1:
287
+ _h.trys.push([1, 6, 7, 8]);
288
+ sources_1 = __values(sources), sources_1_1 = sources_1.next();
289
+ _h.label = 2;
290
+ case 2:
291
+ if (!!sources_1_1.done) return [3 /*break*/, 5];
292
+ source = sources_1_1.value;
293
+ return [4 /*yield*/, fetchSourceGrants(user, source, shouldCache)];
294
+ case 3:
295
+ grants = _h.sent();
296
+ sourceResults.set(source.name, grants);
297
+ if (!grants) {
298
+ return [3 /*break*/, 4];
299
+ }
300
+ if ((_g = grants.roles) === null || _g === void 0 ? void 0 : _g.length) {
301
+ roleNames.push.apply(roleNames, __spreadArray([], __read(grants.roles), false));
302
+ }
303
+ if (grants.permissions) {
304
+ permissionSets.push(grants.permissions);
305
+ }
306
+ _h.label = 4;
307
+ case 4:
308
+ sources_1_1 = sources_1.next();
309
+ return [3 /*break*/, 2];
310
+ case 5: return [3 /*break*/, 8];
311
+ case 6:
312
+ e_3_1 = _h.sent();
313
+ e_3 = { error: e_3_1 };
314
+ return [3 /*break*/, 8];
315
+ case 7:
316
+ try {
317
+ if (sources_1_1 && !sources_1_1.done && (_e = sources_1.return)) _e.call(sources_1);
318
+ }
319
+ finally { if (e_3) throw e_3.error; }
320
+ return [7 /*endfinally*/];
321
+ case 8:
322
+ uniqueRoleNames = __spreadArray([], __read(new Set(roleNames)), false);
323
+ _b = (_a = permissionSets.push).apply;
324
+ _c = [permissionSets];
325
+ _d = [[]];
326
+ return [4 /*yield*/, loadRolePermissions(uniqueRoleNames)];
327
+ case 9:
328
+ _b.apply(_a, _c.concat([__spreadArray.apply(void 0, _d.concat([__read.apply(void 0, [(_h.sent())]), false]))]));
329
+ if (!resolvePermissions) return [3 /*break*/, 11];
330
+ return [4 /*yield*/, resolvePermissions({ user: user })];
331
+ case 10:
332
+ custom = _h.sent();
333
+ if (custom) {
334
+ permissionSets.push(custom);
335
+ }
336
+ _h.label = 11;
337
+ case 11:
338
+ permissions = permissionUtils_1.unionPermissionSets.apply(void 0, __spreadArray([], __read(permissionSets), false));
339
+ try {
340
+ for (sources_2 = __values(sources), sources_2_1 = sources_2.next(); !sources_2_1.done; sources_2_1 = sources_2.next()) {
341
+ source = sources_2_1.value;
342
+ grants = sourceResults.get(source.name);
343
+ if (grants === null || grants === void 0 ? void 0 : grants.deny) {
344
+ permissions = applyDenyGrants(permissions, grants.deny);
345
+ }
346
+ }
347
+ }
348
+ catch (e_4_1) { e_4 = { error: e_4_1 }; }
349
+ finally {
350
+ try {
351
+ if (sources_2_1 && !sources_2_1.done && (_f = sources_2.return)) _f.call(sources_2);
352
+ }
353
+ finally { if (e_4) throw e_4.error; }
354
+ }
355
+ if (shouldCache) {
356
+ rememberPermissions(user.id, {
357
+ expiresAt: Date.now() + cacheTtlMs,
358
+ permissions: permissions,
359
+ });
360
+ }
361
+ return [2 /*return*/, permissions];
362
+ }
363
+ });
364
+ }); };
365
+ var resolvePermissionsForUser = function (user) { return __awaiter(void 0, void 0, void 0, function () {
366
+ return __generator(this, function (_a) {
367
+ return [2 /*return*/, resolveEffectivePermissions(user, true)];
368
+ });
369
+ }); };
370
+ var resolvePermissionsForUserUncached = function (user) { return __awaiter(void 0, void 0, void 0, function () {
371
+ return __generator(this, function (_a) {
372
+ return [2 /*return*/, resolveEffectivePermissions(user, false)];
373
+ });
374
+ }); };
375
+ var authorizePermissions = function (permissions, request) {
376
+ var role = ac.newRole(permissions);
377
+ return role.authorize(request);
378
+ };
379
+ return {
380
+ ac: ac,
381
+ authorizePermissions: authorizePermissions,
382
+ invalidateCache: invalidateCache,
383
+ resolvePermissionsForUser: resolvePermissionsForUser,
384
+ resolvePermissionsForUserUncached: resolvePermissionsForUserUncached,
385
+ };
386
+ };
387
+ exports.createPermissionResolver = createPermissionResolver;
@@ -0,0 +1,20 @@
1
+ import type { User, UserModel } from "../auth";
2
+ import { createRbacRoleModel, type RbacRoleDocument, type RoleDefinition } from "./roleModel";
3
+ import type { PermissionSet, Statements } from "./statements";
4
+ import type { RbacAuditSink, RoleManager } from "./types";
5
+ export declare const createRoleManager: (args: {
6
+ connection: Parameters<typeof createRbacRoleModel>[0];
7
+ statements: Statements;
8
+ defaultRoles?: RoleDefinition[];
9
+ getActorPermissions: (user: User) => Promise<PermissionSet>;
10
+ getPreviewPermissions: (user: User) => Promise<PermissionSet>;
11
+ invalidateCache: (invalidateArgs?: {
12
+ userId?: string;
13
+ }) => void;
14
+ userModel?: UserModel;
15
+ persistAudit?: boolean;
16
+ auditSinks?: RbacAuditSink[];
17
+ }) => {
18
+ roleManager: RoleManager;
19
+ };
20
+ export type { RbacRoleDocument };