@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
@@ -25,27 +25,21 @@ export interface OrganizationScopedUser extends User {
25
25
  /** Reads the caller's organization ids, tolerating users without the `organizationIds` field. */
26
26
  export declare const getUserOrganizationIds: (user?: User) => string[];
27
27
  /**
28
- * Restricts list queries to documents belonging to one of the caller's organizations. This is the
29
- * tenant-scoped analog of {@link OwnerQueryFilter}: it filters on the document's `organizationId`
30
- * field using the user's `organizationIds`. Returns `null` for anonymous callers (no user).
28
+ * Restricts list queries to the current request organization (`X-Organization-Id` or inferred
29
+ * single org-admin membership). Does not read `User.organizationIds`.
31
30
  */
32
- export declare const OrganizationQueryFilter: (user?: User) => {
33
- organizationId: {
34
- $in: string[];
35
- };
36
- } | null;
31
+ export declare const OrganizationQueryFilter: (_user?: User, _query?: Record<string, unknown>) => Record<string, unknown>;
37
32
  export declare const Permissions: {
38
33
  IsAdmin: (_method: RESTMethod, user?: User) => boolean;
39
34
  IsAny: () => boolean;
40
35
  IsAuthenticated: (_method: RESTMethod, user?: User) => boolean;
41
36
  IsAuthenticatedOrReadOnly: (method: RESTMethod, user?: User) => boolean;
42
37
  /**
43
- * Object-level permission for tenant-scoped documents: the caller must belong to the document's
44
- * organization (admins always pass). With no object (list/create checks) it returns true and
45
- * defers to the {@link OrganizationQueryFilter} / a `preCreate` hook to scope access. Expects the
46
- * document to expose an `organizationId` and the user an `organizationIds` array.
38
+ * Object-level permission for tenant-scoped documents: platform org actors must match the
39
+ * current org context; everyone else needs an active Membership. With no object (list/create)
40
+ * it returns true and defers to {@link OrganizationQueryFilter}.
47
41
  */
48
- IsOrganizationMember: (_method: RESTMethod, user?: User, obj?: unknown) => boolean;
42
+ IsOrganizationMember: PermissionMethod<unknown>;
49
43
  IsOwner: (_method: RESTMethod, user?: User, obj?: unknown) => boolean;
50
44
  IsOwnerOrReadOnly: (method: RESTMethod, user?: User, obj?: unknown) => boolean;
51
45
  };
@@ -50,6 +50,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
50
50
  exports.permissionMiddleware = exports.checkPermissions = exports.Permissions = exports.OrganizationQueryFilter = exports.getUserOrganizationIds = exports.OwnerQueryFilter = void 0;
51
51
  var docLoader_1 = require("./docLoader");
52
52
  var errors_1 = require("./errors");
53
+ var orgPermissions_1 = require("./orgs/orgPermissions");
53
54
  var OwnerQueryFilter = function (user) {
54
55
  if (user) {
55
56
  return { ownerId: user === null || user === void 0 ? void 0 : user.id };
@@ -64,17 +65,10 @@ var getUserOrganizationIds = function (user) {
64
65
  };
65
66
  exports.getUserOrganizationIds = getUserOrganizationIds;
66
67
  /**
67
- * Restricts list queries to documents belonging to one of the caller's organizations. This is the
68
- * tenant-scoped analog of {@link OwnerQueryFilter}: it filters on the document's `organizationId`
69
- * field using the user's `organizationIds`. Returns `null` for anonymous callers (no user).
68
+ * Restricts list queries to the current request organization (`X-Organization-Id` or inferred
69
+ * single org-admin membership). Does not read `User.organizationIds`.
70
70
  */
71
- var OrganizationQueryFilter = function (user) {
72
- if (!user) {
73
- return null;
74
- }
75
- return { organizationId: { $in: (0, exports.getUserOrganizationIds)(user) } };
76
- };
77
- exports.OrganizationQueryFilter = OrganizationQueryFilter;
71
+ exports.OrganizationQueryFilter = orgPermissions_1.OrgQueryFilter;
78
72
  exports.Permissions = {
79
73
  IsAdmin: function (_method, user) {
80
74
  return Boolean(user === null || user === void 0 ? void 0 : user.admin);
@@ -95,28 +89,11 @@ exports.Permissions = {
95
89
  return method === "list" || method === "read";
96
90
  },
97
91
  /**
98
- * Object-level permission for tenant-scoped documents: the caller must belong to the document's
99
- * organization (admins always pass). With no object (list/create checks) it returns true and
100
- * defers to the {@link OrganizationQueryFilter} / a `preCreate` hook to scope access. Expects the
101
- * document to expose an `organizationId` and the user an `organizationIds` array.
92
+ * Object-level permission for tenant-scoped documents: platform org actors must match the
93
+ * current org context; everyone else needs an active Membership. With no object (list/create)
94
+ * it returns true and defers to {@link OrganizationQueryFilter}.
102
95
  */
103
- IsOrganizationMember: function (_method, user, obj) {
104
- // When checking if we can possibly perform the action, return true.
105
- if (!obj) {
106
- return true;
107
- }
108
- if (!user) {
109
- return false;
110
- }
111
- if (user === null || user === void 0 ? void 0 : user.admin) {
112
- return true;
113
- }
114
- var organizationId = obj.organizationId;
115
- if (!organizationId) {
116
- return false;
117
- }
118
- return (0, exports.getUserOrganizationIds)(user).includes(organizationId);
119
- },
96
+ IsOrganizationMember: orgPermissions_1.isOrgMemberPermission,
120
97
  IsOwner: function (_method, user, obj) {
121
98
  var _a;
122
99
  // When checking if we can possibly perform the action, return true.
@@ -1,11 +1,3 @@
1
1
  import type { NextFunction, Request, Response } from "express";
2
2
  import type { RateLimitOptions, RateLimitStore } from "./types";
3
- export declare const setRateLimitExceededHeaders: ({ max, remaining, resetAt, now, windowMs, res, }: {
4
- max: number;
5
- remaining: number;
6
- resetAt: number;
7
- now: number;
8
- windowMs: number;
9
- res: Response;
10
- }) => void;
11
3
  export declare const createRateLimitMiddleware: (store: RateLimitStore, options?: RateLimitOptions) => ((req: Request, res: Response, next: NextFunction) => Promise<void>);
@@ -36,7 +36,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
36
36
  }
37
37
  };
38
38
  Object.defineProperty(exports, "__esModule", { value: true });
39
- exports.createRateLimitMiddleware = exports.setRateLimitExceededHeaders = void 0;
39
+ exports.createRateLimitMiddleware = void 0;
40
40
  var luxon_1 = require("luxon");
41
41
  var errors_1 = require("../errors");
42
42
  var policies_1 = require("./policies");
@@ -52,7 +52,6 @@ var setRateLimitExceededHeaders = function (_a) {
52
52
  res.setHeader("RateLimit", "limit=".concat(max, ", remaining=").concat(remaining, ", reset=").concat(retryAfter));
53
53
  res.setHeader("RateLimit-Policy", "".concat(max, ";w=").concat(windowSec));
54
54
  };
55
- exports.setRateLimitExceededHeaders = setRateLimitExceededHeaders;
56
55
  var createRateLimitMiddleware = function (store, options) {
57
56
  var _a, _b, _c, _d, _e, _f, _g;
58
57
  if (options === void 0) { options = {}; }
@@ -84,7 +83,7 @@ var createRateLimitMiddleware = function (store, options) {
84
83
  next();
85
84
  return [2 /*return*/];
86
85
  }
87
- (0, exports.setRateLimitExceededHeaders)({
86
+ setRateLimitExceededHeaders({
88
87
  max: max,
89
88
  now: now,
90
89
  remaining: result.remaining,
@@ -1,3 +1,4 @@
1
1
  import type { RateLimitStore } from "./types";
2
+ /** @internal */
2
3
  export declare const RATE_LIMIT_HITS_COLLECTION = "rateLimitHits";
3
4
  export declare const createMongoRateLimitStore: () => RateLimitStore;
@@ -43,6 +43,7 @@ exports.createMongoRateLimitStore = exports.RATE_LIMIT_HITS_COLLECTION = void 0;
43
43
  var luxon_1 = require("luxon");
44
44
  var mongoose_1 = __importDefault(require("mongoose"));
45
45
  var errors_1 = require("../errors");
46
+ /** @internal */
46
47
  exports.RATE_LIMIT_HITS_COLLECTION = "rateLimitHits";
47
48
  var ensureIndexes = function (collection) { return __awaiter(void 0, void 0, void 0, function () {
48
49
  return __generator(this, function (_a) {
@@ -1,9 +1,5 @@
1
1
  import type { Request } from "express";
2
2
  import type { RateLimitPolicyName } from "./types";
3
- /** Strip query, fragment, and a trailing slash so `/auth/login/` matches `/auth/login`. */
4
- export declare const normalizeRequestPath: (url: string) => string;
5
- /** Prefer Express `req.path` (routing) over the raw request-target. */
6
- export declare const requestPath: (req: Request) => string;
7
3
  /**
8
4
  * JWT login, signup, and refresh must not 401 on a stale access token.
9
5
  * `setupAuth` runs before those routes so the client can still exchange credentials.
@@ -11,7 +11,7 @@ var __values = (this && this.__values) || function(o) {
11
11
  throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
12
12
  };
13
13
  Object.defineProperty(exports, "__esModule", { value: true });
14
- exports.rateLimitKey = exports.classifyRateLimitPolicy = exports.shouldSkipRateLimit = exports.isJwtCredentialExchangePath = exports.requestPath = exports.normalizeRequestPath = void 0;
14
+ exports.rateLimitKey = exports.classifyRateLimitPolicy = exports.shouldSkipRateLimit = exports.isJwtCredentialExchangePath = void 0;
15
15
  var DEFAULT_BETTER_AUTH_BASE_PATH = "/api/auth";
16
16
  var stripQueryAndFragment = function (url) {
17
17
  var hash = url.indexOf("#");
@@ -27,13 +27,11 @@ var normalizeRequestPath = function (url) {
27
27
  : withoutQuery;
28
28
  return withoutSlash.toLowerCase();
29
29
  };
30
- exports.normalizeRequestPath = normalizeRequestPath;
31
30
  /** Prefer Express `req.path` (routing) over the raw request-target. */
32
31
  var requestPath = function (req) {
33
32
  var raw = req.path || req.url || req.originalUrl || "";
34
- return (0, exports.normalizeRequestPath)(raw);
33
+ return normalizeRequestPath(raw);
35
34
  };
36
- exports.requestPath = requestPath;
37
35
  var JWT_CREDENTIAL_EXCHANGE_EXACT = new Set([
38
36
  "/auth/login",
39
37
  "/auth/signup",
@@ -48,11 +46,11 @@ var JWT_CREDENTIAL_EXCHANGE_EXACT = new Set([
48
46
  * `setupAuth` runs before those routes so the client can still exchange credentials.
49
47
  */
50
48
  var isJwtCredentialExchangePath = function (req) {
51
- return JWT_CREDENTIAL_EXCHANGE_EXACT.has((0, exports.requestPath)(req));
49
+ return JWT_CREDENTIAL_EXCHANGE_EXACT.has(requestPath(req));
52
50
  };
53
51
  exports.isJwtCredentialExchangePath = isJwtCredentialExchangePath;
54
52
  var shouldSkipRateLimit = function (req, extraSkip) {
55
- var path = (0, exports.requestPath)(req);
53
+ var path = requestPath(req);
56
54
  if (req.method === "GET" && (path === "/health" || path === "/healthz")) {
57
55
  return true;
58
56
  }
@@ -100,7 +98,7 @@ var betterAuthAuthPrefixes = function (basePath) {
100
98
  var classifyRateLimitPolicy = function (req, betterAuthBasePath) {
101
99
  var e_1, _a, e_2, _b;
102
100
  if (betterAuthBasePath === void 0) { betterAuthBasePath = DEFAULT_BETTER_AUTH_BASE_PATH; }
103
- var path = (0, exports.requestPath)(req);
101
+ var path = requestPath(req);
104
102
  if (AUTH_EXACT.has(path)) {
105
103
  return "auth";
106
104
  }
@@ -1,3 +1,4 @@
1
1
  import type { RateLimitOptions, RateLimitStore } from "./types";
2
+ /** @internal */
2
3
  export declare const redisUrlFromEnv: () => string | undefined;
3
4
  export declare const createRedisRateLimitStore: (options?: RateLimitOptions) => RateLimitStore;
@@ -71,6 +71,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
71
71
  Object.defineProperty(exports, "__esModule", { value: true });
72
72
  exports.createRedisRateLimitStore = exports.redisUrlFromEnv = void 0;
73
73
  var errors_1 = require("../errors");
74
+ /** @internal */
74
75
  var redisUrlFromEnv = function () {
75
76
  return process.env.VALKEY_URL || process.env.REDIS_URL;
76
77
  };
@@ -35,17 +35,6 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
35
35
  if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
36
36
  }
37
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
38
  var __read = (this && this.__read) || function (o, n) {
50
39
  var m = typeof Symbol === "function" && o[Symbol.iterator];
51
40
  if (!m) return o;
@@ -62,10 +51,31 @@ var __read = (this && this.__read) || function (o, n) {
62
51
  }
63
52
  return ar;
64
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
+ var __values = (this && this.__values) || function(o) {
64
+ var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
65
+ if (m) return m.call(o);
66
+ if (o && typeof o.length === "number") return {
67
+ next: function () {
68
+ if (o && i >= o.length) o = void 0;
69
+ return { value: o && o[i++], done: !o };
70
+ }
71
+ };
72
+ throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
73
+ };
65
74
  Object.defineProperty(exports, "__esModule", { value: true });
66
75
  exports.createAccess = void 0;
67
76
  var errors_1 = require("../errors");
68
77
  var auditModel_1 = require("./auditModel");
78
+ var membershipOrgAdminSource_1 = require("./membershipOrgAdminSource");
69
79
  var middleware_1 = require("./middleware");
70
80
  var resolve_1 = require("./resolve");
71
81
  var roleManager_1 = require("./roleManager");
@@ -82,6 +92,7 @@ var EMPTY_FIELD_MASK = {
82
92
  write: [],
83
93
  };
84
94
  var createAccess = function (options) {
95
+ var _a, _b, _c;
85
96
  var persistAudit = options.persistAudit !== false;
86
97
  var auditSinks = (0, auditModel_1.normalizeRbacAuditSinks)(options.auditSink);
87
98
  if (!persistAudit && auditSinks.length === 0) {
@@ -92,17 +103,23 @@ var createAccess = function (options) {
92
103
  }
93
104
  var mergedStatements = (0, statements_1.mergeStatements)(options.statements);
94
105
  var rbacRoleModel = (0, roleModel_1.createRbacRoleModel)(options.connection);
106
+ var extraRoles = __spreadArray([], __read(((_a = options.defaultRoles) !== null && _a !== void 0 ? _a : [])), false);
107
+ if (options.organizations && !extraRoles.some(function (role) { return role.name === "operator"; })) {
108
+ extraRoles.push(roleModel_1.organizationOperatorRole);
109
+ }
110
+ var sources = options.organizations
111
+ ? __spreadArray([(0, membershipOrgAdminSource_1.membershipOrgAdminPermissionSource)()], __read(((_b = options.sources) !== null && _b !== void 0 ? _b : [])), false) : ((_c = options.sources) !== null && _c !== void 0 ? _c : []);
95
112
  var resolver = (0, resolve_1.createPermissionResolver)({
96
113
  cacheTtlMs: options.cacheTtlMs,
97
114
  rbacRoleModel: rbacRoleModel,
98
115
  resolvePermissions: options.resolvePermissions,
99
- sources: options.sources,
116
+ sources: sources,
100
117
  statements: mergedStatements,
101
118
  });
102
119
  var roleManager = (0, roleManager_1.createRoleManager)({
103
120
  auditSinks: auditSinks,
104
121
  connection: options.connection,
105
- defaultRoles: options.defaultRoles,
122
+ defaultRoles: extraRoles,
106
123
  getActorPermissions: function (user) { return resolver.resolvePermissionsForUser(user); },
107
124
  getPreviewPermissions: function (user) { return resolver.resolvePermissionsForUserUncached(user); },
108
125
  invalidateCache: resolver.invalidateCache,
@@ -0,0 +1,6 @@
1
+ import type { PermissionSet } from "./statements";
2
+ import type { PermissionSource } from "./types";
3
+ export declare const MEMBERSHIP_ORG_ADMIN_PERMISSION_SOURCE_NAME = "membership-org-admin";
4
+ /** Grants applied when `Membership.roleName` is `org-admin` in the current org context. */
5
+ export declare const ORG_ADMIN_PERMISSION_BUNDLE: PermissionSet;
6
+ export declare const membershipOrgAdminPermissionSource: () => PermissionSource;
@@ -0,0 +1,122 @@
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.membershipOrgAdminPermissionSource = exports.ORG_ADMIN_PERMISSION_BUNDLE = exports.MEMBERSHIP_ORG_ADMIN_PERMISSION_SOURCE_NAME = void 0;
65
+ var organizationModel_1 = require("../orgs/organizationModel");
66
+ var orgContext_1 = require("../orgs/orgContext");
67
+ exports.MEMBERSHIP_ORG_ADMIN_PERMISSION_SOURCE_NAME = "membership-org-admin";
68
+ /** Grants applied when `Membership.roleName` is `org-admin` in the current org context. */
69
+ exports.ORG_ADMIN_PERMISSION_BUNDLE = {
70
+ admin: ["access"],
71
+ organization: ["read", "update", "manageMembers"],
72
+ };
73
+ var userIdForMembershipLookup = function (user) {
74
+ if (user._id) {
75
+ return String(user._id);
76
+ }
77
+ return user.id;
78
+ };
79
+ var isActiveOrgAdminMembership = function (membership) {
80
+ return (membership === null || membership === void 0 ? void 0 : membership.roleName) === "org-admin" && membership.status === "active";
81
+ };
82
+ var fullOrgAdminGrants = function () { return ({
83
+ permissions: {
84
+ admin: __spreadArray([], __read(exports.ORG_ADMIN_PERMISSION_BUNDLE.admin), false),
85
+ organization: __spreadArray([], __read(exports.ORG_ADMIN_PERMISSION_BUNDLE.organization), false),
86
+ },
87
+ }); };
88
+ var shellOnlyOrgAdminGrants = function () { return ({
89
+ permissions: {
90
+ admin: __spreadArray([], __read(exports.ORG_ADMIN_PERMISSION_BUNDLE.admin), false),
91
+ },
92
+ }); };
93
+ var membershipOrgAdminPermissionSource = function () { return ({
94
+ getGrants: function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
95
+ var contextMembership, activeMemberships, hasOrgAdminMembership;
96
+ var _c;
97
+ var user = _b.user;
98
+ return __generator(this, function (_d) {
99
+ switch (_d.label) {
100
+ case 0:
101
+ contextMembership = (_c = (0, orgContext_1.getOrgContext)()) === null || _c === void 0 ? void 0 : _c.membership;
102
+ if (contextMembership) {
103
+ if (!isActiveOrgAdminMembership(contextMembership)) {
104
+ return [2 /*return*/, null];
105
+ }
106
+ return [2 /*return*/, fullOrgAdminGrants()];
107
+ }
108
+ return [4 /*yield*/, organizationModel_1.Membership.findActiveForUser(userIdForMembershipLookup(user))];
109
+ case 1:
110
+ activeMemberships = _d.sent();
111
+ hasOrgAdminMembership = activeMemberships.some(function (row) { return row.roleName === "org-admin"; });
112
+ if (!hasOrgAdminMembership) {
113
+ return [2 /*return*/, null];
114
+ }
115
+ return [2 /*return*/, shellOnlyOrgAdminGrants()];
116
+ }
117
+ });
118
+ }); },
119
+ name: exports.MEMBERSHIP_ORG_ADMIN_PERMISSION_SOURCE_NAME,
120
+ ttlMs: 0,
121
+ }); };
122
+ exports.membershipOrgAdminPermissionSource = membershipOrgAdminPermissionSource;
@@ -4,8 +4,11 @@ import type { User } from "../auth";
4
4
  import type { RESTPermissions } from "../permissions";
5
5
  import type { AnyTerrenoAccess, ModelRouterAccessOptions, ResourceScope } from "./types";
6
6
  export declare const resolveActionForMethod: (method: RESTMethod, access: ModelRouterAccessOptions, statements: Record<string, readonly string[]>) => string | null;
7
+ /** @internal */
7
8
  export declare const buildAccessPermissions: <T>(accessControl: AnyTerrenoAccess, access: ModelRouterAccessOptions) => RESTPermissions<T>;
9
+ /** @internal */
8
10
  export declare const buildAccessQueryFilter: <_T>(accessControl: AnyTerrenoAccess, access: ModelRouterAccessOptions, existing?: (user?: express.Request["user"], query?: Record<string, unknown>) => Record<string, unknown> | null | Promise<Record<string, unknown> | null>) => (user?: express.Request["user"], query?: Record<string, unknown>) => Promise<Record<string, unknown> | null>;
11
+ /** @internal */
9
12
  export declare const wrapAccessResponseHandler: <T>(accessControl: AnyTerrenoAccess, access: ModelRouterAccessOptions, baseHandler: (value: T | T[], method: RESTMethod, request: express.Request, options: {
10
13
  access?: ModelRouterAccessOptions;
11
14
  }) => Promise<unknown> | unknown) => (value: T | T[], method: "list" | "create" | "read" | "update" | "delete", request: express.Request, options: {
@@ -135,6 +135,7 @@ var buildPermissionRequest = function (resource, action) {
135
135
  _a[resource] = [action],
136
136
  _a);
137
137
  };
138
+ /** @internal */
138
139
  var buildAccessPermissions = function (accessControl, access) {
139
140
  var isPermitted = (0, middleware_1.createIsPermitted)({ can: accessControl.can });
140
141
  var statements = accessControl.statements;
@@ -193,6 +194,7 @@ var buildAccessPermissions = function (accessControl, access) {
193
194
  };
194
195
  };
195
196
  exports.buildAccessPermissions = buildAccessPermissions;
197
+ /** @internal */
196
198
  var buildAccessQueryFilter = function (accessControl, access, existing) {
197
199
  return function (user, query) { return __awaiter(void 0, void 0, void 0, function () {
198
200
  var merged, statements, listAction, scopeFilter, withAccessScope, routerScopeFilter;
@@ -239,6 +241,7 @@ var buildAccessQueryFilter = function (accessControl, access, existing) {
239
241
  }); };
240
242
  };
241
243
  exports.buildAccessQueryFilter = buildAccessQueryFilter;
244
+ /** @internal */
242
245
  var wrapAccessResponseHandler = function (accessControl, access, baseHandler) {
243
246
  return function (value, method, request, options) { return __awaiter(void 0, void 0, void 0, function () {
244
247
  var serialized, docs, masked;