@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,70 @@
1
+ import mongoose, {type Schema} from "mongoose";
2
+
3
+ import {BadRequestError} from "../errors";
4
+
5
+ export interface OrgScoped {
6
+ organizationId: mongoose.Types.ObjectId;
7
+ }
8
+
9
+ export const ORGANIZATION_ID_IMMUTABLE_TITLE = "organizationId cannot be changed";
10
+
11
+ const updateContainsOrganizationId = (value: unknown): boolean => {
12
+ if (Array.isArray(value)) {
13
+ return value.some(updateContainsOrganizationId);
14
+ }
15
+ if (!value || typeof value !== "object") {
16
+ return false;
17
+ }
18
+ return Object.entries(value).some(([key, nestedValue]) => {
19
+ if (key === "organizationId" || key.startsWith("organizationId.")) {
20
+ return true;
21
+ }
22
+ if (key === "$rename" && nestedValue && typeof nestedValue === "object") {
23
+ return Object.entries(nestedValue).some(([source, target]) => {
24
+ return (
25
+ source === "organizationId" ||
26
+ source.startsWith("organizationId.") ||
27
+ target === "organizationId" ||
28
+ String(target).startsWith("organizationId.")
29
+ );
30
+ });
31
+ }
32
+ return updateContainsOrganizationId(nestedValue);
33
+ });
34
+ };
35
+
36
+ /** Rejects post-create changes to an existing `organizationId` schema path. */
37
+ export const organizationIdImmutabilityPlugin = (schema: Schema): void => {
38
+ schema.pre("save", function () {
39
+ if (this.isNew || !this.isModified("organizationId")) {
40
+ return;
41
+ }
42
+ throw new BadRequestError(ORGANIZATION_ID_IMMUTABLE_TITLE);
43
+ });
44
+
45
+ schema.pre(["updateOne", "findOneAndUpdate"], function () {
46
+ const update = this.getUpdate();
47
+ if (!updateContainsOrganizationId(update)) {
48
+ return;
49
+ }
50
+ throw new BadRequestError(ORGANIZATION_ID_IMMUTABLE_TITLE);
51
+ });
52
+ };
53
+
54
+ /**
55
+ * Adds a required indexed `organizationId` so tenant-scoped consumer models cannot be saved
56
+ * without an organization. After creation, `organizationId` is immutable for REST, admin,
57
+ * sync, and direct saves.
58
+ */
59
+ export const orgScopedPlugin = (schema: Schema): void => {
60
+ schema.add({
61
+ organizationId: {
62
+ description: "Organization this document belongs to",
63
+ index: true,
64
+ ref: "Organization",
65
+ required: true,
66
+ type: mongoose.Schema.Types.ObjectId,
67
+ },
68
+ });
69
+ organizationIdImmutabilityPlugin(schema);
70
+ };
@@ -0,0 +1,267 @@
1
+ import {describe, it} from "bun:test";
2
+ import {assert} from "chai";
3
+ import mongoose from "mongoose";
4
+
5
+ import type {User} from "../auth";
6
+ import {createAccess} from "../rbac/access";
7
+ import {
8
+ createRbacRoleModel,
9
+ organizationOperatorRole,
10
+ terrenoDefaultRoles,
11
+ } from "../rbac/roleModel";
12
+ import {terrenoStatements} from "../rbac/statements";
13
+ import {setupDb} from "../tests";
14
+ import type {MembershipDocument} from "../types/membership";
15
+ import type {OrganizationDocument} from "../types/organization";
16
+ import {Membership, Organization} from "./organizationModel";
17
+ import {type ResolvedOrgContext, runWithOrgContext} from "./orgContext";
18
+
19
+ const createTestUser = (
20
+ overrides: Partial<User & {roles: string[]}> = {}
21
+ ): User & {roles: string[]} => {
22
+ const id = new mongoose.Types.ObjectId();
23
+ return {
24
+ _id: id as unknown as User["_id"],
25
+ admin: false,
26
+ id: id.toString(),
27
+ roles: [],
28
+ ...overrides,
29
+ };
30
+ };
31
+
32
+ const orgAdminContext = (): ResolvedOrgContext => ({
33
+ membership: {roleName: "org-admin", status: "active"} as MembershipDocument,
34
+ organization: {_id: new mongoose.Types.ObjectId()} as OrganizationDocument,
35
+ });
36
+
37
+ const memberContext = (): ResolvedOrgContext => ({
38
+ membership: {roleName: "member", status: "active"} as MembershipDocument,
39
+ organization: {_id: new mongoose.Types.ObjectId()} as OrganizationDocument,
40
+ });
41
+
42
+ describe("organization RBAC", () => {
43
+ it("adds organization actions to terreno statements", () => {
44
+ assert.deepEqual(terrenoStatements.organization, [
45
+ "create",
46
+ "list",
47
+ "read",
48
+ "update",
49
+ "delete",
50
+ "manageMembers",
51
+ "disable",
52
+ ]);
53
+ });
54
+
55
+ it("seeds a locked operator role with platform org grants", async () => {
56
+ await setupDb();
57
+ const RbacRole = createRbacRoleModel(mongoose.connection);
58
+ await RbacRole.seedDefaults({
59
+ extraRoles: [organizationOperatorRole],
60
+ statements: terrenoStatements,
61
+ });
62
+
63
+ assert.notInclude(
64
+ terrenoDefaultRoles.map((role) => role.name),
65
+ "operator"
66
+ );
67
+ assert.equal(organizationOperatorRole.name, "operator");
68
+ assert.notInclude(
69
+ terrenoDefaultRoles.map((role) => role.name),
70
+ "org-admin"
71
+ );
72
+
73
+ const operator = await RbacRole.findExactlyOne({name: "operator"});
74
+ assert.isTrue(operator.isLocked);
75
+ assert.deepEqual(operator.permissions.organization, [...terrenoStatements.organization]);
76
+ assert.deepEqual(operator.permissions.admin, ["access"]);
77
+ assert.deepEqual(operator.permissions.user, ["list", "read", "update"]);
78
+
79
+ const orgAdminRole = await RbacRole.findOne({name: "org-admin"});
80
+ assert.isNull(orgAdminRole);
81
+ });
82
+
83
+ it("lets operator organization:list and denies it to org-admin membership", async () => {
84
+ await setupDb();
85
+ const access = createAccess({
86
+ connection: mongoose.connection,
87
+ organizations: true,
88
+ statements: terrenoStatements,
89
+ });
90
+ await access.roles.seedDefaults();
91
+
92
+ const operator = createTestUser({roles: ["operator"]});
93
+ const operatorList = await access.can({
94
+ permissions: {organization: ["list"]},
95
+ user: operator,
96
+ });
97
+ assert.isTrue(operatorList.allowed);
98
+
99
+ const orgAdmin = createTestUser();
100
+ const orgAdminList = await runWithOrgContext(orgAdminContext(), () =>
101
+ access.can({
102
+ permissions: {organization: ["list"]},
103
+ user: orgAdmin,
104
+ })
105
+ );
106
+ assert.isFalse(orgAdminList.allowed);
107
+
108
+ const orgAdminUpdate = await runWithOrgContext(orgAdminContext(), () =>
109
+ access.can({
110
+ permissions: {organization: ["update", "read", "manageMembers"]},
111
+ user: orgAdmin,
112
+ })
113
+ );
114
+ assert.isTrue(orgAdminUpdate.allowed);
115
+ });
116
+
117
+ it("does not grant org-admin from user.roles; membership in context wins", async () => {
118
+ await setupDb();
119
+ const access = createAccess({
120
+ connection: mongoose.connection,
121
+ organizations: true,
122
+ statements: terrenoStatements,
123
+ });
124
+ await access.roles.seedDefaults();
125
+
126
+ const spoofed = createTestUser({roles: ["org-admin"]});
127
+ const spoofedUpdate = await access.can({
128
+ permissions: {organization: ["update"]},
129
+ user: spoofed,
130
+ });
131
+ assert.isFalse(spoofedUpdate.allowed);
132
+
133
+ const spoofedInMemberContext = await runWithOrgContext(memberContext(), () =>
134
+ access.can({
135
+ permissions: {organization: ["update"]},
136
+ user: spoofed,
137
+ })
138
+ );
139
+ assert.isFalse(spoofedInMemberContext.allowed);
140
+
141
+ const suspendedAdmin = createTestUser();
142
+ const suspendedContext: ResolvedOrgContext = {
143
+ membership: {roleName: "org-admin", status: "suspended"} as MembershipDocument,
144
+ organization: {_id: new mongoose.Types.ObjectId()} as OrganizationDocument,
145
+ };
146
+ const suspendedUpdate = await runWithOrgContext(suspendedContext, () =>
147
+ access.can({
148
+ permissions: {organization: ["update"]},
149
+ user: suspendedAdmin,
150
+ })
151
+ );
152
+ assert.isFalse(suspendedUpdate.allowed);
153
+
154
+ const memberOnly = createTestUser();
155
+ const memberUpdate = await runWithOrgContext(memberContext(), () =>
156
+ access.can({
157
+ permissions: {organization: ["update"]},
158
+ user: memberOnly,
159
+ })
160
+ );
161
+ assert.isFalse(memberUpdate.allowed);
162
+
163
+ const admin = createTestUser({roles: ["admin"]});
164
+ const adminList = await access.can({
165
+ permissions: {organization: ["list"]},
166
+ user: admin,
167
+ });
168
+ assert.isFalse(adminList.allowed);
169
+ });
170
+
171
+ it("grants only admin:access outside org context when the user has an active org-admin membership", async () => {
172
+ await setupDb();
173
+ const access = createAccess({
174
+ connection: mongoose.connection,
175
+ organizations: true,
176
+ statements: terrenoStatements,
177
+ });
178
+ await access.roles.seedDefaults();
179
+
180
+ const userId = new mongoose.Types.ObjectId();
181
+ const user = createTestUser({_id: userId as unknown as User["_id"], id: userId.toString()});
182
+ const org = await Organization.create({
183
+ name: "Alpha Workspace",
184
+ ownerId: userId,
185
+ });
186
+ await Membership.create({
187
+ organizationId: org._id,
188
+ roleName: "org-admin",
189
+ userId,
190
+ });
191
+
192
+ const shellAccess = await access.can({
193
+ permissions: {admin: ["access"]},
194
+ user,
195
+ });
196
+ assert.isTrue(shellAccess.allowed);
197
+
198
+ const orgList = await access.can({
199
+ permissions: {organization: ["list"]},
200
+ user,
201
+ });
202
+ assert.isFalse(orgList.allowed);
203
+
204
+ const orgUpdate = await access.can({
205
+ permissions: {organization: ["update"]},
206
+ user,
207
+ });
208
+ assert.isFalse(orgUpdate.allowed);
209
+ });
210
+
211
+ it("denies admin:access outside org context when the user has only member memberships", async () => {
212
+ await setupDb();
213
+ const access = createAccess({
214
+ connection: mongoose.connection,
215
+ organizations: true,
216
+ statements: terrenoStatements,
217
+ });
218
+ await access.roles.seedDefaults();
219
+
220
+ const userId = new mongoose.Types.ObjectId();
221
+ const user = createTestUser({_id: userId as unknown as User["_id"], id: userId.toString()});
222
+ const org = await Organization.create({
223
+ name: "Member Org",
224
+ ownerId: userId,
225
+ });
226
+ await Membership.create({
227
+ organizationId: org._id,
228
+ roleName: "member",
229
+ userId,
230
+ });
231
+
232
+ const shellAccess = await access.can({
233
+ permissions: {admin: ["access"]},
234
+ user,
235
+ });
236
+ assert.isFalse(shellAccess.allowed);
237
+ });
238
+
239
+ it("does not leak org-admin grants across organization contexts via the permission cache", async () => {
240
+ await setupDb();
241
+ const access = createAccess({
242
+ cacheTtlMs: 60_000,
243
+ connection: mongoose.connection,
244
+ organizations: true,
245
+ statements: terrenoStatements,
246
+ });
247
+ await access.roles.seedDefaults();
248
+
249
+ const user = createTestUser();
250
+ const firstOrg = orgAdminContext();
251
+ const allowed = await runWithOrgContext(firstOrg, () =>
252
+ access.can({
253
+ permissions: {organization: ["update"]},
254
+ user,
255
+ })
256
+ );
257
+ assert.isTrue(allowed.allowed);
258
+
259
+ const leaked = await runWithOrgContext(memberContext(), () =>
260
+ access.can({
261
+ permissions: {organization: ["update"]},
262
+ user,
263
+ })
264
+ );
265
+ assert.isFalse(leaked.allowed);
266
+ });
267
+ });