@terreno/api 57.3.0 → 57.4.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 (293) hide show
  1. package/.ai/skills/mongoose-schema-safety/SKILL.md +23 -10
  2. package/README.md +6 -0
  3. package/dist/adminTypes.d.ts +7 -0
  4. package/dist/adminTypes.js +6 -1
  5. package/dist/api.d.ts +10 -0
  6. package/dist/api.js +99 -36
  7. package/dist/audit/auditApp.d.ts +30 -0
  8. package/dist/audit/auditApp.js +155 -0
  9. package/dist/audit/auditEventModel.d.ts +29 -0
  10. package/dist/audit/auditEventModel.js +102 -0
  11. package/dist/audit/cloudTasksEnqueue.d.ts +32 -0
  12. package/dist/audit/cloudTasksEnqueue.js +162 -0
  13. package/dist/audit/diff.d.ts +10 -0
  14. package/dist/audit/diff.js +230 -0
  15. package/dist/audit/processQueue.d.ts +6 -0
  16. package/dist/audit/processQueue.js +101 -0
  17. package/dist/audit/rbacSink.d.ts +2 -0
  18. package/dist/audit/rbacSink.js +82 -0
  19. package/dist/audit/record.d.ts +56 -0
  20. package/dist/audit/record.js +373 -0
  21. package/dist/betterAuth.d.ts +6 -0
  22. package/dist/betterAuthSetup.js +1 -1
  23. package/dist/collectionRegistry.d.ts +3 -1
  24. package/dist/collectionRegistry.js +25 -0
  25. package/dist/index.d.ts +26 -1
  26. package/dist/index.js +48 -2
  27. package/dist/mcp/query.d.ts +0 -13
  28. package/dist/mcp/query.js +8 -8
  29. package/dist/migrations/fixtures/all-down/20260910120000-one.d.ts +4 -0
  30. package/dist/migrations/fixtures/all-down/20260910120000-one.js +49 -0
  31. package/dist/migrations/fixtures/all-down/20260910120001-two.d.ts +4 -0
  32. package/dist/migrations/fixtures/all-down/20260910120001-two.js +49 -0
  33. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.d.ts +3 -0
  34. package/dist/migrations/fixtures/bad-id/20260910120000-mismatch.js +45 -0
  35. package/dist/migrations/fixtures/bad-name/not-a-migration.d.ts +3 -0
  36. package/dist/migrations/fixtures/bad-name/not-a-migration.js +45 -0
  37. package/dist/migrations/fixtures/missing-up/20260910120000-noup.d.ts +2 -0
  38. package/dist/migrations/fixtures/missing-up/20260910120000-noup.js +5 -0
  39. package/dist/migrations/fixtures/valid/20260910120000-alpha.d.ts +3 -0
  40. package/dist/migrations/fixtures/valid/20260910120000-alpha.js +45 -0
  41. package/dist/migrations/fixtures/valid/20260910120001-beta.d.ts +4 -0
  42. package/dist/migrations/fixtures/valid/20260910120001-beta.js +49 -0
  43. package/dist/migrations/generate.d.ts +17 -0
  44. package/dist/migrations/generate.js +277 -0
  45. package/dist/migrations/load.d.ts +20 -0
  46. package/dist/migrations/load.js +236 -0
  47. package/dist/migrations/lock.d.ts +13 -0
  48. package/dist/migrations/lock.js +145 -0
  49. package/dist/migrations/runner.d.ts +42 -0
  50. package/dist/migrations/runner.js +503 -0
  51. package/dist/migrations/schemaCatalog.d.ts +44 -0
  52. package/dist/migrations/schemaCatalog.js +326 -0
  53. package/dist/migrations/types.d.ts +87 -0
  54. package/dist/migrations/types.js +7 -0
  55. package/dist/models/notification.d.ts +2 -0
  56. package/dist/models/notification.js +62 -0
  57. package/dist/models/notificationPreference.d.ts +2 -0
  58. package/dist/models/notificationPreference.js +49 -0
  59. package/dist/notifications/notificationService.d.ts +40 -0
  60. package/dist/notifications/notificationService.js +323 -0
  61. package/dist/notifications/notificationsApp.d.ts +18 -0
  62. package/dist/notifications/notificationsApp.js +250 -0
  63. package/dist/notifications/notificationsBeforeSend.d.ts +14 -0
  64. package/dist/notifications/notificationsBeforeSend.js +77 -0
  65. package/dist/openApi.d.ts +1 -7
  66. package/dist/openApi.js +7 -6
  67. package/dist/openApiBuilder.d.ts +14 -3
  68. package/dist/openApiValidator.d.ts +13 -1
  69. package/dist/openApiValidator.js +200 -36
  70. package/dist/orgs/orgContext.d.ts +23 -0
  71. package/dist/orgs/orgContext.js +198 -0
  72. package/dist/orgs/orgPermissions.d.ts +4 -0
  73. package/dist/orgs/orgPermissions.js +77 -0
  74. package/dist/orgs/orgPlugin.d.ts +13 -0
  75. package/dist/orgs/orgPlugin.js +84 -0
  76. package/dist/orgs/organizationModel.d.ts +13 -0
  77. package/dist/orgs/organizationModel.js +301 -0
  78. package/dist/orgs/organizationSettings.d.ts +19 -0
  79. package/dist/orgs/organizationSettings.js +120 -0
  80. package/dist/orgs/orgsApp.d.ts +28 -0
  81. package/dist/orgs/orgsApp.js +678 -0
  82. package/dist/permissions.d.ts +7 -13
  83. package/dist/permissions.js +8 -31
  84. package/dist/rateLimit/middleware.d.ts +0 -8
  85. package/dist/rateLimit/middleware.js +2 -3
  86. package/dist/rateLimit/mongoStore.d.ts +1 -0
  87. package/dist/rateLimit/mongoStore.js +1 -0
  88. package/dist/rateLimit/policies.d.ts +0 -4
  89. package/dist/rateLimit/policies.js +5 -7
  90. package/dist/rateLimit/redisStore.d.ts +1 -0
  91. package/dist/rateLimit/redisStore.js +1 -0
  92. package/dist/rbac/access.js +30 -13
  93. package/dist/rbac/membershipOrgAdminSource.d.ts +6 -0
  94. package/dist/rbac/membershipOrgAdminSource.js +122 -0
  95. package/dist/rbac/modelRouterAccess.d.ts +3 -0
  96. package/dist/rbac/modelRouterAccess.js +3 -0
  97. package/dist/rbac/resolve.js +60 -31
  98. package/dist/rbac/roleModel.d.ts +2 -5
  99. package/dist/rbac/roleModel.js +18 -4
  100. package/dist/rbac/statements.d.ts +10 -1
  101. package/dist/rbac/statements.js +19 -2
  102. package/dist/rbac/types.d.ts +5 -0
  103. package/dist/realtime/changeStreamWatcher.d.ts +10 -4
  104. package/dist/realtime/changeStreamWatcher.js +110 -64
  105. package/dist/realtime/deprecation.d.ts +1 -0
  106. package/dist/realtime/deprecation.js +1 -0
  107. package/dist/realtime/realtimeApp.d.ts +1 -0
  108. package/dist/realtime/realtimeApp.js +1 -0
  109. package/dist/schemaMetadata.js +16 -5
  110. package/dist/sync/adminBroadcastScope.d.ts +40 -0
  111. package/dist/sync/adminBroadcastScope.js +194 -0
  112. package/dist/sync/adminWindowAccess.d.ts +13 -0
  113. package/dist/sync/adminWindowAccess.js +96 -0
  114. package/dist/sync/adminWindowMutation.d.ts +88 -0
  115. package/dist/sync/adminWindowMutation.js +247 -0
  116. package/dist/sync/executors.d.ts +9 -3
  117. package/dist/sync/executors.js +190 -159
  118. package/dist/sync/mutationHandler.d.ts +5 -2
  119. package/dist/sync/mutationHandler.js +191 -71
  120. package/dist/sync/registry.js +4 -0
  121. package/dist/sync/routes.d.ts +13 -0
  122. package/dist/sync/routes.js +113 -56
  123. package/dist/sync/socketHandlers.d.ts +8 -2
  124. package/dist/sync/socketHandlers.js +144 -50
  125. package/dist/sync/streams.d.ts +2 -0
  126. package/dist/sync/streams.js +7 -1
  127. package/dist/sync/syncApp.d.ts +2 -1
  128. package/dist/sync/syncApp.js +2 -1
  129. package/dist/sync/syncBatch.d.ts +5 -2
  130. package/dist/sync/syncBatch.js +4 -4
  131. package/dist/sync/types.d.ts +18 -0
  132. package/dist/terrenoApp.d.ts +29 -0
  133. package/dist/terrenoApp.js +91 -54
  134. package/dist/tests/createTestData.d.ts +1 -3
  135. package/dist/tests/createTestData.js +3 -5
  136. package/dist/tests/models.d.ts +1 -0
  137. package/dist/tests/models.js +9 -2
  138. package/dist/tests/testHelper.d.ts +0 -5
  139. package/dist/tests/testHelper.js +2 -9
  140. package/dist/types/authToken.d.ts +3 -3
  141. package/dist/types/mcpServiceToken.d.ts +2 -2
  142. package/dist/types/membership.d.ts +23 -0
  143. package/dist/types/membership.js +2 -0
  144. package/dist/types/notification.d.ts +28 -0
  145. package/dist/types/notification.js +2 -0
  146. package/dist/types/notificationPreference.d.ts +20 -0
  147. package/dist/types/notificationPreference.js +2 -0
  148. package/dist/types/organization.d.ts +36 -0
  149. package/dist/types/organization.js +2 -0
  150. package/dist/webhooks/idempotency/webhookReceipt.d.ts +4 -49
  151. package/dist/webhooks/idempotency/webhookReceipt.js +7 -7
  152. package/dist/webhooks/rawBody.d.ts +1 -0
  153. package/dist/webhooks/rawBody.js +1 -0
  154. package/package.json +31 -25
  155. package/src/__snapshots__/openApi.test.ts.snap +192 -54
  156. package/src/__snapshots__/openApiBuilder.test.ts.snap +0 -18
  157. package/src/__snapshots__/schemaMetadata.test.ts.snap +0 -1
  158. package/src/adminTypes.ts +8 -0
  159. package/src/api.test.ts +39 -2
  160. package/src/api.ts +68 -0
  161. package/src/audit/auditApp.test.ts +243 -0
  162. package/src/audit/auditApp.ts +139 -0
  163. package/src/audit/auditEventModel.ts +156 -0
  164. package/src/audit/auditRouter.test.ts +456 -0
  165. package/src/audit/cloudTasksEnqueue.test.ts +124 -0
  166. package/src/audit/cloudTasksEnqueue.ts +104 -0
  167. package/src/audit/diff.ts +163 -0
  168. package/src/audit/processQueue.ts +69 -0
  169. package/src/audit/rbacSink.test.ts +86 -0
  170. package/src/audit/rbacSink.ts +42 -0
  171. package/src/audit/record.test.ts +402 -0
  172. package/src/audit/record.ts +328 -0
  173. package/src/auth.test.ts +1 -1
  174. package/src/betterAuth.ts +7 -0
  175. package/src/betterAuthSetup.test.ts +27 -0
  176. package/src/betterAuthSetup.ts +1 -0
  177. package/src/collectionRegistry.test.ts +8 -9
  178. package/src/collectionRegistry.ts +21 -1
  179. package/src/express.d.ts +2 -0
  180. package/src/expressServer.test.ts +50 -2
  181. package/src/index.ts +69 -0
  182. package/src/mcp/handlers.test.ts +275 -0
  183. package/src/mcp/query.ts +3 -3
  184. package/src/mcp/toolGenerator.test.ts +81 -0
  185. package/src/migrations/cli.test.ts +376 -0
  186. package/src/migrations/cli.ts +283 -0
  187. package/src/migrations/fixtures/all-down/20260910120000-one.ts +6 -0
  188. package/src/migrations/fixtures/all-down/20260910120001-two.ts +6 -0
  189. package/src/migrations/fixtures/bad-id/20260910120000-mismatch.ts +4 -0
  190. package/src/migrations/fixtures/bad-name/not-a-migration.ts +4 -0
  191. package/src/migrations/fixtures/missing-up/20260910120000-noup.ts +2 -0
  192. package/src/migrations/fixtures/valid/20260910120000-alpha.ts +4 -0
  193. package/src/migrations/fixtures/valid/20260910120001-beta.ts +6 -0
  194. package/src/migrations/generate.test.ts +333 -0
  195. package/src/migrations/generate.ts +216 -0
  196. package/src/migrations/load.test.ts +103 -0
  197. package/src/migrations/load.ts +124 -0
  198. package/src/migrations/lock.test.ts +133 -0
  199. package/src/migrations/lock.ts +118 -0
  200. package/src/migrations/runner.test.ts +504 -0
  201. package/src/migrations/runner.ts +358 -0
  202. package/src/migrations/schemaCatalog.test.ts +159 -0
  203. package/src/migrations/schemaCatalog.ts +262 -0
  204. package/src/migrations/types.ts +94 -0
  205. package/src/models/notification.ts +68 -0
  206. package/src/models/notificationPreference.ts +62 -0
  207. package/src/notifications/notificationService.ts +254 -0
  208. package/src/notifications/notificationsApp.test.ts +505 -0
  209. package/src/notifications/notificationsApp.ts +200 -0
  210. package/src/notifications/notificationsBeforeSend.ts +51 -0
  211. package/src/openApi.test.ts +0 -1
  212. package/src/openApi.ts +2 -1
  213. package/src/openApiBuilder.ts +14 -3
  214. package/src/openApiValidator.test.ts +221 -2
  215. package/src/openApiValidator.ts +218 -33
  216. package/src/orgs/orgAccessOptIn.test.ts +87 -0
  217. package/src/orgs/orgContext.test.ts +259 -0
  218. package/src/orgs/orgContext.ts +151 -0
  219. package/src/orgs/orgPermissions.test.ts +105 -0
  220. package/src/orgs/orgPermissions.ts +40 -0
  221. package/src/orgs/orgPlugin.test.ts +130 -0
  222. package/src/orgs/orgPlugin.ts +70 -0
  223. package/src/orgs/orgRbac.test.ts +267 -0
  224. package/src/orgs/orgSecurityDefects.test.ts +415 -0
  225. package/src/orgs/organizationModel.test.ts +205 -0
  226. package/src/orgs/organizationModel.ts +257 -0
  227. package/src/orgs/organizationSettings.test.ts +113 -0
  228. package/src/orgs/organizationSettings.ts +126 -0
  229. package/src/orgs/orgsApp.test.ts +382 -0
  230. package/src/orgs/orgsApp.ts +563 -0
  231. package/src/permissions.test.ts +62 -36
  232. package/src/permissions.ts +8 -30
  233. package/src/rateLimit/middleware.ts +1 -1
  234. package/src/rateLimit/mongoStore.ts +1 -0
  235. package/src/rateLimit/policies.ts +2 -2
  236. package/src/rateLimit/redisStore.ts +1 -0
  237. package/src/rbac/access.ts +11 -3
  238. package/src/rbac/membershipOrgAdminSource.ts +59 -0
  239. package/src/rbac/modelRouterAccess.ts +3 -0
  240. package/src/rbac/permissionUtils.test.ts +26 -5
  241. package/src/rbac/resolve.test.ts +34 -2
  242. package/src/rbac/resolve.ts +26 -7
  243. package/src/rbac/roleModel.test.ts +34 -1
  244. package/src/rbac/roleModel.ts +17 -1
  245. package/src/rbac/statements.test.ts +19 -0
  246. package/src/rbac/statements.ts +19 -1
  247. package/src/rbac/types.ts +5 -0
  248. package/src/realtime/changeStreamWatcher.ts +73 -33
  249. package/src/realtime/deprecation.ts +1 -0
  250. package/src/realtime/realtime.test.ts +357 -185
  251. package/src/realtime/realtimeApp.ts +1 -0
  252. package/src/schemaMetadata.test.ts +14 -0
  253. package/src/schemaMetadata.ts +5 -5
  254. package/src/sync/adminBroadcastConfig.test.ts +96 -0
  255. package/src/sync/adminBroadcastScope.test.ts +155 -0
  256. package/src/sync/adminBroadcastScope.ts +123 -0
  257. package/src/sync/adminWindowAccess.test.ts +57 -0
  258. package/src/sync/adminWindowAccess.ts +32 -0
  259. package/src/sync/adminWindowMutation.test.ts +450 -0
  260. package/src/sync/adminWindowMutation.ts +283 -0
  261. package/src/sync/executors.ts +33 -6
  262. package/src/sync/mutationHandler.test.ts +277 -1
  263. package/src/sync/mutationHandler.ts +171 -29
  264. package/src/sync/registry.ts +4 -0
  265. package/src/sync/routes.ts +52 -8
  266. package/src/sync/socketHandlers.ts +154 -58
  267. package/src/sync/streams.ts +6 -0
  268. package/src/sync/sync.test.ts +3 -2
  269. package/src/sync/syncApp.ts +2 -1
  270. package/src/sync/syncBatch.ts +7 -2
  271. package/src/sync/syncRoutes.test.ts +297 -3
  272. package/src/sync/syncSocket.test.ts +229 -0
  273. package/src/sync/types.ts +20 -0
  274. package/src/terrenoApp.migrations.test.ts +114 -0
  275. package/src/terrenoApp.test.ts +41 -0
  276. package/src/terrenoApp.ts +94 -31
  277. package/src/tests/createTestData.ts +2 -2
  278. package/src/tests/models.ts +10 -2
  279. package/src/tests/testHelper.ts +1 -7
  280. package/src/types/authToken.ts +2 -4
  281. package/src/types/mcpServiceToken.ts +1 -7
  282. package/src/types/membership.ts +48 -0
  283. package/src/types/notification.ts +34 -0
  284. package/src/types/notificationPreference.ts +28 -0
  285. package/src/types/organization.ts +49 -0
  286. package/src/webhooks/idempotency/webhookReceipt.ts +4 -7
  287. package/src/webhooks/rawBody.test.ts +33 -0
  288. package/src/webhooks/rawBody.ts +1 -0
  289. package/tsconfig.json +1 -1
  290. package/tsconfig.typedoc.json +2 -1
  291. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.d.ts +0 -2
  292. package/dist/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
  293. package/src/vendor/wesleytodd-openapi/lib/convert-yaml.js +0 -13
@@ -0,0 +1,96 @@
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 __read = (this && this.__read) || function (o, n) {
39
+ var m = typeof Symbol === "function" && o[Symbol.iterator];
40
+ if (!m) return o;
41
+ var i = m.call(o), r, ar = [], e;
42
+ try {
43
+ while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
44
+ }
45
+ catch (error) { e = { error: error }; }
46
+ finally {
47
+ try {
48
+ if (r && !r.done && (m = i["return"])) m.call(i);
49
+ }
50
+ finally { if (e) throw e.error; }
51
+ }
52
+ return ar;
53
+ };
54
+ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
55
+ if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
56
+ if (ar || !(i in from)) {
57
+ if (!ar) ar = Array.prototype.slice.call(from, 0, i);
58
+ ar[i] = from[i];
59
+ }
60
+ }
61
+ return to.concat(ar || Array.prototype.slice.call(from));
62
+ };
63
+ Object.defineProperty(exports, "__esModule", { value: true });
64
+ exports.canUseAdminBroadcastWindow = void 0;
65
+ var permissions_1 = require("../permissions");
66
+ var statements_1 = require("../rbac/statements");
67
+ /**
68
+ * Gate for `{collection}|admin` window subscribe and cross-owner `GET /sync/entities`.
69
+ *
70
+ * Matches the admin UI shell: with `accessControl`, require `admin:access`.
71
+ * Without RBAC, fall back to the legacy `user.admin` flag.
72
+ */
73
+ var canUseAdminBroadcastWindow = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
74
+ var _c, result;
75
+ var accessControl = _b.accessControl, canOpenAdminWindow = _b.canOpenAdminWindow, user = _b.user;
76
+ return __generator(this, function (_d) {
77
+ switch (_d.label) {
78
+ case 0:
79
+ if (!canOpenAdminWindow) return [3 /*break*/, 2];
80
+ _c = Boolean;
81
+ return [4 /*yield*/, canOpenAdminWindow(user)];
82
+ case 1: return [2 /*return*/, _c.apply(void 0, [_d.sent()])];
83
+ case 2:
84
+ if (!accessControl) return [3 /*break*/, 4];
85
+ return [4 /*yield*/, accessControl.can({
86
+ permissions: { admin: __spreadArray([], __read(statements_1.ADMIN_PAGE_PERMISSION.admin), false) },
87
+ user: user,
88
+ })];
89
+ case 3:
90
+ result = _d.sent();
91
+ return [2 /*return*/, result.allowed];
92
+ case 4: return [2 /*return*/, permissions_1.Permissions.IsAdmin("list", user)];
93
+ }
94
+ });
95
+ }); };
96
+ exports.canUseAdminBroadcastWindow = canUseAdminBroadcastWindow;
@@ -0,0 +1,88 @@
1
+ import type express from "express";
2
+ import mongoose from "mongoose";
3
+ import type { ModelRouterOptions } from "../api";
4
+ import type { User } from "../auth";
5
+ import { type PermissionMethod } from "../permissions";
6
+ import type { AnyTerrenoAccess } from "../rbac/types";
7
+ import type { SyncRegistryEntry } from "./registry";
8
+ import type { SyncAppOptions } from "./routes";
9
+ import type { SyncMutateRequest } from "./types";
10
+ export interface AdminWindowMutationAuditEvent {
11
+ actorId?: string;
12
+ /** Serialized document after the successful mutation. */
13
+ doc?: Record<string, unknown>;
14
+ modelName: string;
15
+ recordId?: string;
16
+ recordLabel?: string;
17
+ verb: "created" | "deleted" | "updated";
18
+ }
19
+ export interface AdminWindowMutationScopeHooks {
20
+ preCreate?: ModelRouterOptions<unknown>["preCreate"];
21
+ preUpdate?: ModelRouterOptions<unknown>["preUpdate"];
22
+ preDelete?: ModelRouterOptions<unknown>["preDelete"];
23
+ postCreate?: ModelRouterOptions<unknown>["postCreate"];
24
+ postUpdate?: ModelRouterOptions<unknown>["postUpdate"];
25
+ postDelete?: ModelRouterOptions<unknown>["postDelete"];
26
+ }
27
+ export interface AdminWindowMutationScope extends AdminWindowMutationScopeHooks {
28
+ /** RBAC access used by AdminApp User admin-flag and role assignment hooks. */
29
+ accessControl?: AnyTerrenoAccess;
30
+ modelName: string;
31
+ permissions: {
32
+ create: boolean;
33
+ update: boolean;
34
+ delete: boolean;
35
+ };
36
+ createPermissions: PermissionMethod<unknown>[];
37
+ updatePermissions: PermissionMethod<unknown>[];
38
+ deletePermissions: PermissionMethod<unknown>[];
39
+ stripMutationData: (data: Record<string, unknown>) => Record<string, unknown>;
40
+ /** Legacy standalone audit callback; prefer `postCreate` / `postUpdate` / `postDelete`. */
41
+ emitAudit?: (args: {
42
+ event: AdminWindowMutationAuditEvent;
43
+ req: express.Request;
44
+ }) => void | Promise<void>;
45
+ }
46
+ /** Coalesce `req.user.id` and `req.user._id` to match Admin REST audit actor ids. */
47
+ export declare const auditActorIdFromRequest: (req: express.Request) => string | undefined;
48
+ /**
49
+ * Admin-window sync mutations use AdminApp router pre/post hooks, not product `modelRouter`
50
+ * hooks. Product hooks can overwrite stripped or admin-authorized fields (for example by
51
+ * forcing `ownerId` in `preCreate`).
52
+ */
53
+ export declare const buildAdminWindowExecutorOptions: <T>({ productOptions, scope, }: {
54
+ productOptions: ModelRouterOptions<T>;
55
+ scope: AdminWindowMutationScope;
56
+ }) => ModelRouterOptions<T>;
57
+ /** Ensure `req.params.id` is set for AdminApp update/delete hooks (User admin-flag gates). */
58
+ export declare const withAdminWindowMutationRequestContext: ({ mutation, req, }: {
59
+ mutation: SyncMutateRequest;
60
+ req: express.Request;
61
+ }) => express.Request;
62
+ export declare const registerAdminWindowMutationScope: (modelName: string, scope: AdminWindowMutationScope) => void;
63
+ export declare const getAdminWindowMutationScope: (modelName: string) => AdminWindowMutationScope | undefined;
64
+ export declare const clearAdminWindowMutationScopes: () => void;
65
+ /**
66
+ * Validates an explicit `mutationMode: "adminWindow"` marker and applies AdminApp write
67
+ * semantics before the product sync executor runs. Returns the mutation with stripped
68
+ * data, or `undefined` when the request stays on the product path.
69
+ *
70
+ * The marker alone is never trusted: callers must also have admin-window access, the
71
+ * collection must be `adminBroadcast`, and AdminApp must have registered a write scope.
72
+ */
73
+ export declare const prepareAdminWindowMutation: ({ entry, mutation, req: _req, syncOptions, user, }: {
74
+ entry: SyncRegistryEntry;
75
+ mutation: SyncMutateRequest;
76
+ req: express.Request;
77
+ syncOptions?: SyncAppOptions;
78
+ user: User;
79
+ }) => Promise<{
80
+ mutation: SyncMutateRequest;
81
+ scope: AdminWindowMutationScope;
82
+ } | undefined>;
83
+ export declare const emitAdminWindowMutationAudit: ({ doc, mutation, req, scope, }: {
84
+ doc: mongoose.Document;
85
+ mutation: SyncMutateRequest;
86
+ req: express.Request;
87
+ scope: AdminWindowMutationScope;
88
+ }) => Promise<void>;
@@ -0,0 +1,247 @@
1
+ "use strict";
2
+ var __assign = (this && this.__assign) || function () {
3
+ __assign = Object.assign || function(t) {
4
+ for (var s, i = 1, n = arguments.length; i < n; i++) {
5
+ s = arguments[i];
6
+ for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
7
+ t[p] = s[p];
8
+ }
9
+ return t;
10
+ };
11
+ return __assign.apply(this, arguments);
12
+ };
13
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
14
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
15
+ return new (P || (P = Promise))(function (resolve, reject) {
16
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
17
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
18
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
19
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
20
+ });
21
+ };
22
+ var __generator = (this && this.__generator) || function (thisArg, body) {
23
+ 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);
24
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
+ function verb(n) { return function (v) { return step([n, v]); }; }
26
+ function step(op) {
27
+ if (f) throw new TypeError("Generator is already executing.");
28
+ while (g && (g = 0, op[0] && (_ = 0)), _) try {
29
+ 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;
30
+ if (y = 0, t) op = [op[0] & 2, t.value];
31
+ switch (op[0]) {
32
+ case 0: case 1: t = op; break;
33
+ case 4: _.label++; return { value: op[1], done: false };
34
+ case 5: _.label++; y = op[1]; op = [0]; continue;
35
+ case 7: op = _.ops.pop(); _.trys.pop(); continue;
36
+ default:
37
+ if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
38
+ if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
39
+ if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
40
+ if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
41
+ if (t[2]) _.ops.pop();
42
+ _.trys.pop(); continue;
43
+ }
44
+ op = body.call(thisArg, _);
45
+ } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
46
+ if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
47
+ }
48
+ };
49
+ var __importDefault = (this && this.__importDefault) || function (mod) {
50
+ return (mod && mod.__esModule) ? mod : { "default": mod };
51
+ };
52
+ Object.defineProperty(exports, "__esModule", { value: true });
53
+ exports.emitAdminWindowMutationAudit = exports.prepareAdminWindowMutation = exports.clearAdminWindowMutationScopes = exports.getAdminWindowMutationScope = exports.registerAdminWindowMutationScope = exports.withAdminWindowMutationRequestContext = exports.buildAdminWindowExecutorOptions = exports.auditActorIdFromRequest = void 0;
54
+ var mongoose_1 = __importDefault(require("mongoose"));
55
+ var errors_1 = require("../errors");
56
+ var permissions_1 = require("../permissions");
57
+ var plugins_1 = require("../plugins");
58
+ var adminWindowAccess_1 = require("./adminWindowAccess");
59
+ /** Coalesce `req.user.id` and `req.user._id` to match Admin REST audit actor ids. */
60
+ var auditActorIdFromRequest = function (req) {
61
+ var actor = req.user;
62
+ if (!actor) {
63
+ return undefined;
64
+ }
65
+ if (actor.id != null) {
66
+ return String(actor.id);
67
+ }
68
+ if (actor._id != null) {
69
+ return String(actor._id);
70
+ }
71
+ return undefined;
72
+ };
73
+ exports.auditActorIdFromRequest = auditActorIdFromRequest;
74
+ /**
75
+ * Admin-window sync mutations use AdminApp router pre/post hooks, not product `modelRouter`
76
+ * hooks. Product hooks can overwrite stripped or admin-authorized fields (for example by
77
+ * forcing `ownerId` in `preCreate`).
78
+ */
79
+ var buildAdminWindowExecutorOptions = function (_a) {
80
+ var _b;
81
+ var productOptions = _a.productOptions, scope = _a.scope;
82
+ return (__assign(__assign({}, productOptions), { accessControl: (_b = scope.accessControl) !== null && _b !== void 0 ? _b : productOptions.accessControl, postCreate: scope.postCreate, postDelete: scope.postDelete, postUpdate: scope.postUpdate, preCreate: scope.preCreate, preDelete: scope.preDelete, preUpdate: scope.preUpdate }));
83
+ };
84
+ exports.buildAdminWindowExecutorOptions = buildAdminWindowExecutorOptions;
85
+ /** Ensure `req.params.id` is set for AdminApp update/delete hooks (User admin-flag gates). */
86
+ var withAdminWindowMutationRequestContext = function (_a) {
87
+ var _b;
88
+ var mutation = _a.mutation, req = _a.req;
89
+ if (mutation.operation === "create" || mutation.id == null) {
90
+ return req;
91
+ }
92
+ var params = __assign(__assign({}, ((_b = req.params) !== null && _b !== void 0 ? _b : {})), { id: mutation.id });
93
+ return Object.assign(req, { params: params });
94
+ };
95
+ exports.withAdminWindowMutationRequestContext = withAdminWindowMutationRequestContext;
96
+ var adminWindowMutationScopes = new Map();
97
+ var registerAdminWindowMutationScope = function (modelName, scope) {
98
+ adminWindowMutationScopes.set(modelName, scope);
99
+ };
100
+ exports.registerAdminWindowMutationScope = registerAdminWindowMutationScope;
101
+ var getAdminWindowMutationScope = function (modelName) { return adminWindowMutationScopes.get(modelName); };
102
+ exports.getAdminWindowMutationScope = getAdminWindowMutationScope;
103
+ var clearAdminWindowMutationScopes = function () {
104
+ adminWindowMutationScopes.clear();
105
+ };
106
+ exports.clearAdminWindowMutationScopes = clearAdminWindowMutationScopes;
107
+ var operationEnabled = function (scope, operation) {
108
+ if (operation === "create") {
109
+ return scope.permissions.create;
110
+ }
111
+ if (operation === "update") {
112
+ return scope.permissions.update;
113
+ }
114
+ return scope.permissions.delete;
115
+ };
116
+ var permissionsForOperation = function (scope, operation) {
117
+ if (operation === "create") {
118
+ return scope.createPermissions;
119
+ }
120
+ if (operation === "update") {
121
+ return scope.updatePermissions;
122
+ }
123
+ return scope.deletePermissions;
124
+ };
125
+ var loadInstance = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
126
+ var model;
127
+ var entry = _b.entry, id = _b.id;
128
+ return __generator(this, function (_c) {
129
+ model = mongoose_1.default.model(entry.modelName);
130
+ return [2 /*return*/, (0, plugins_1.findOneOrNoneFor)(model, { _id: id, deleted: { $in: [true, false] } })];
131
+ });
132
+ }); };
133
+ /**
134
+ * Validates an explicit `mutationMode: "adminWindow"` marker and applies AdminApp write
135
+ * semantics before the product sync executor runs. Returns the mutation with stripped
136
+ * data, or `undefined` when the request stays on the product path.
137
+ *
138
+ * The marker alone is never trusted: callers must also have admin-window access, the
139
+ * collection must be `adminBroadcast`, and AdminApp must have registered a write scope.
140
+ */
141
+ var prepareAdminWindowMutation = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
142
+ var scope, instance, permissionMethod, permissionInstance;
143
+ var entry = _b.entry, mutation = _b.mutation, _req = _b.req, syncOptions = _b.syncOptions, user = _b.user;
144
+ return __generator(this, function (_c) {
145
+ switch (_c.label) {
146
+ case 0:
147
+ if (mutation.mutationMode !== "adminWindow") {
148
+ return [2 /*return*/, undefined];
149
+ }
150
+ if (!entry.config.adminBroadcast) {
151
+ throw new errors_1.APIError({
152
+ status: 403,
153
+ title: "Admin window mutations require an adminBroadcast collection",
154
+ });
155
+ }
156
+ return [4 /*yield*/, (0, adminWindowAccess_1.canUseAdminBroadcastWindow)({
157
+ accessControl: syncOptions === null || syncOptions === void 0 ? void 0 : syncOptions.accessControl,
158
+ canOpenAdminWindow: syncOptions === null || syncOptions === void 0 ? void 0 : syncOptions.canOpenAdminWindow,
159
+ user: user,
160
+ })];
161
+ case 1:
162
+ if (!(_c.sent())) {
163
+ throw new errors_1.APIError({ status: 403, title: "Admin window access required" });
164
+ }
165
+ scope = (0, exports.getAdminWindowMutationScope)(entry.modelName);
166
+ if (!scope) {
167
+ throw new errors_1.APIError({
168
+ status: 403,
169
+ title: "Admin window mutations are not registered for this collection",
170
+ });
171
+ }
172
+ if (!operationEnabled(scope, mutation.operation)) {
173
+ throw new errors_1.APIError({
174
+ status: 403,
175
+ title: "".concat(mutation.operation, " is disabled for this admin model"),
176
+ });
177
+ }
178
+ if (!(mutation.operation !== "create")) return [3 /*break*/, 3];
179
+ if (!mutation.id) {
180
+ throw new errors_1.APIError({
181
+ status: 400,
182
+ title: "id is required for ".concat(mutation.operation, " mutations"),
183
+ });
184
+ }
185
+ return [4 /*yield*/, loadInstance({ entry: entry, id: mutation.id })];
186
+ case 2:
187
+ instance = _c.sent();
188
+ if (!instance && mutation.operation === "update") {
189
+ throw new errors_1.APIError({ status: 404, title: "Not found" });
190
+ }
191
+ _c.label = 3;
192
+ case 3:
193
+ permissionMethod = mutation.operation === "create"
194
+ ? "create"
195
+ : mutation.operation === "update"
196
+ ? "update"
197
+ : "delete";
198
+ permissionInstance = mutation.operation === "create" ? mutation.data : instance;
199
+ return [4 /*yield*/, (0, permissions_1.checkPermissions)(permissionMethod, permissionsForOperation(scope, mutation.operation), user, permissionInstance)];
200
+ case 4:
201
+ if (!(_c.sent())) {
202
+ throw new errors_1.APIError({ status: 403, title: "Admin write access denied" });
203
+ }
204
+ if (mutation.operation === "delete" || !mutation.data) {
205
+ return [2 /*return*/, { mutation: mutation, scope: scope }];
206
+ }
207
+ return [2 /*return*/, {
208
+ mutation: __assign(__assign({}, mutation), { data: scope.stripMutationData(mutation.data) }),
209
+ scope: scope,
210
+ }];
211
+ }
212
+ });
213
+ }); };
214
+ exports.prepareAdminWindowMutation = prepareAdminWindowMutation;
215
+ var emitAdminWindowMutationAudit = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
216
+ var plain, recordId, verb;
217
+ var doc = _b.doc, mutation = _b.mutation, req = _b.req, scope = _b.scope;
218
+ return __generator(this, function (_c) {
219
+ switch (_c.label) {
220
+ case 0:
221
+ if (!scope.emitAudit) {
222
+ return [2 /*return*/];
223
+ }
224
+ plain = doc.toObject();
225
+ recordId = plain._id != null ? String(plain._id) : mutation.id;
226
+ verb = mutation.operation === "create"
227
+ ? "created"
228
+ : mutation.operation === "delete"
229
+ ? "deleted"
230
+ : "updated";
231
+ return [4 /*yield*/, scope.emitAudit({
232
+ event: {
233
+ actorId: (0, exports.auditActorIdFromRequest)(req),
234
+ doc: plain,
235
+ modelName: scope.modelName,
236
+ recordId: recordId,
237
+ verb: verb,
238
+ },
239
+ req: req,
240
+ })];
241
+ case 1:
242
+ _c.sent();
243
+ return [2 /*return*/];
244
+ }
245
+ });
246
+ }); };
247
+ exports.emitAdminWindowMutationAudit = emitAdminWindowMutationAudit;
@@ -107,7 +107,7 @@ export declare const isVersionError: (error: unknown) => boolean;
107
107
  * `transformer.transform`, `preCreate`, `Model.create` (Mongoose validation), population,
108
108
  * and `postCreate`. Throws APIErrors with the same statuses/titles as the REST handler.
109
109
  */
110
- export declare const executeCreate: <T>({ model, options, user, body, req, skipPostHooks, writeModelName, }: {
110
+ export declare const executeCreate: <T>({ model, options, user, body, req, skipPermissionChecks, skipPostHooks, writeModelName, }: {
111
111
  model: Model<T>;
112
112
  options: ModelRouterOptions<T>;
113
113
  user?: User;
@@ -126,6 +126,8 @@ export declare const executeCreate: <T>({ model, options, user, body, req, skipP
126
126
  * committed write look like a failure. REST handlers never set this.
127
127
  */
128
128
  skipPostHooks?: boolean;
129
+ /** When true, skip modelRouter permission checks (admin-window sync mutations). */
130
+ skipPermissionChecks?: boolean;
129
131
  }) => Promise<ExecutorResult<T>>;
130
132
  /**
131
133
  * C5 (FIX 6): run `postCreate` outside the write transaction/ledger-finalize
@@ -146,7 +148,7 @@ export declare const runPostCreate: <T>({ doc, options, request, }: {
146
148
  * population, and `postUpdate`. Throws APIErrors with the same statuses/titles as the REST
147
149
  * handler; concurrency conflicts throw `ExecutorConflictError` (409) carrying the server doc.
148
150
  */
149
- export declare const executeUpdate: <T>({ model, options, user, id, body, concurrencyCheck, existingDoc, req, skipPostHooks, writeModelName, }: {
151
+ export declare const executeUpdate: <T>({ model, options, user, id, body, concurrencyCheck, existingDoc, req, skipPermissionChecks, skipPostHooks, writeModelName, }: {
150
152
  model: Model<T>;
151
153
  options: ModelRouterOptions<T>;
152
154
  user?: User;
@@ -167,6 +169,8 @@ export declare const executeUpdate: <T>({ model, options, user, id, body, concur
167
169
  * MCP passes the registry `modelName` because compiled mongoose names can differ.
168
170
  */
169
171
  writeModelName?: string;
172
+ /** When true, skip modelRouter permission checks (admin-window sync mutations). */
173
+ skipPermissionChecks?: boolean;
170
174
  }) => Promise<ExecutorResult<T>>;
171
175
  /** C5 (FIX 6): run `postUpdate` outside the write/ledger-finalize window — see `runPostCreate`. */
172
176
  export declare const runPostUpdate: <T>({ doc, cleanedBody, prevDoc, options, request, }: {
@@ -182,7 +186,7 @@ export declare const runPostUpdate: <T>({ doc, cleanedBody, prevDoc, options, re
182
186
  * schema has a Boolean `deleted` path, else `doc.deleteOne()`), and `postDelete`. Throws
183
187
  * APIErrors with the same statuses/titles as the REST handler.
184
188
  */
185
- export declare const executeDelete: <T>({ model, options, user, id, existingDoc, req, skipPostHooks, }: {
189
+ export declare const executeDelete: <T>({ model, options, user, id, existingDoc, req, skipPermissionChecks, skipPostHooks, }: {
186
190
  model: Model<T>;
187
191
  options: ModelRouterOptions<T>;
188
192
  user?: User;
@@ -198,6 +202,8 @@ export declare const executeDelete: <T>({ model, options, user, id, existingDoc,
198
202
  req?: express.Request;
199
203
  /** C5 (FIX 6): see `executeCreate`'s `skipPostHooks` doc comment. */
200
204
  skipPostHooks?: boolean;
205
+ /** When true, skip modelRouter permission checks (admin-window sync mutations). */
206
+ skipPermissionChecks?: boolean;
201
207
  }) => Promise<ExecutorResult<T>>;
202
208
  /** C5 (FIX 6): run `postDelete` outside the write/ledger-finalize window — see `runPostCreate`. */
203
209
  export declare const runPostDelete: <T>({ doc, options, request, }: {