@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
@@ -1,6 +1,7 @@
1
1
  import type express from "express";
2
2
  import type { User } from "../auth";
3
3
  import { type SyncMutationOutcome, type SyncMutationScopeResolver } from "./mutationHandler";
4
+ import type { SyncAppOptions } from "./routes";
4
5
  import type { SyncMutateBatchResponse, SyncMutateRequest } from "./types";
5
6
  /**
6
7
  * Task 9.20: the single orchestration both mutation transports run.
@@ -47,11 +48,12 @@ export interface SyncBatchRunResult {
47
48
  response: SyncMutateBatchResponse;
48
49
  }
49
50
  /** Shared orchestration for a SINGLE mutation: rate limit, then apply. */
50
- export declare const runSyncMutation: ({ mutation, req, scopeResolver, user, }: {
51
+ export declare const runSyncMutation: ({ mutation, req, scopeResolver, syncOptions, user, }: {
51
52
  mutation: SyncMutateRequest;
52
53
  /** The real Express request when called over HTTP; hooks receive a `{user}` stub otherwise. */
53
54
  req?: express.Request;
54
55
  scopeResolver?: SyncMutationScopeResolver;
56
+ syncOptions?: SyncAppOptions;
55
57
  user: User;
56
58
  }) => Promise<SyncMutationRunResult>;
57
59
  /**
@@ -63,9 +65,10 @@ export declare const runSyncMutation: ({ mutation, req, scopeResolver, user, }:
63
65
  * mutations that would have succeeded. The budget is then charged per MUTATION (not per
64
66
  * batch), so batching cannot buy extra throughput over single sends.
65
67
  */
66
- export declare const runSyncBatch: ({ mutations, req, scopeResolver, user, }: {
68
+ export declare const runSyncBatch: ({ mutations, req, scopeResolver, syncOptions, user, }: {
67
69
  mutations: SyncMutateRequest[];
68
70
  req?: express.Request;
69
71
  scopeResolver?: SyncMutationScopeResolver;
72
+ syncOptions?: SyncAppOptions;
70
73
  user: User;
71
74
  }) => Promise<SyncBatchRunResult>;
@@ -185,7 +185,7 @@ var rateLimitNack = function (retryAfterMs) { return ({
185
185
  var runSyncMutation = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
186
186
  var userId, mutationId, retryAfterMs;
187
187
  var _c;
188
- var mutation = _b.mutation, req = _b.req, scopeResolver = _b.scopeResolver, user = _b.user;
188
+ var mutation = _b.mutation, req = _b.req, scopeResolver = _b.scopeResolver, syncOptions = _b.syncOptions, user = _b.user;
189
189
  return __generator(this, function (_d) {
190
190
  switch (_d.label) {
191
191
  case 0:
@@ -200,7 +200,7 @@ var runSyncMutation = function (_a) { return __awaiter(void 0, [_a], void 0, fun
200
200
  }];
201
201
  }
202
202
  _c = {};
203
- return [4 /*yield*/, (0, mutationHandler_1.applySyncMutation)({ mutation: mutation, req: req, scopeResolver: scopeResolver, user: user })];
203
+ return [4 /*yield*/, (0, mutationHandler_1.applySyncMutation)({ mutation: mutation, req: req, scopeResolver: scopeResolver, syncOptions: syncOptions, user: user })];
204
204
  case 1: return [2 /*return*/, (_c.outcome = _d.sent(),
205
205
  _c.stage = "applied",
206
206
  _c)];
@@ -220,7 +220,7 @@ exports.runSyncMutation = runSyncMutation;
220
220
  var runSyncBatch = function (_a) { return __awaiter(void 0, [_a], void 0, function (_b) {
221
221
  var validation, userId, retryAfterMs;
222
222
  var _c;
223
- var mutations = _b.mutations, req = _b.req, scopeResolver = _b.scopeResolver, user = _b.user;
223
+ var mutations = _b.mutations, req = _b.req, scopeResolver = _b.scopeResolver, syncOptions = _b.syncOptions, user = _b.user;
224
224
  return __generator(this, function (_d) {
225
225
  switch (_d.label) {
226
226
  case 0:
@@ -243,7 +243,7 @@ var runSyncBatch = function (_a) { return __awaiter(void 0, [_a], void 0, functi
243
243
  }];
244
244
  }
245
245
  _c = {};
246
- return [4 /*yield*/, (0, mutationHandler_1.applySyncMutationBatch)({ mutations: mutations, req: req, scopeResolver: scopeResolver, user: user })];
246
+ return [4 /*yield*/, (0, mutationHandler_1.applySyncMutationBatch)({ mutations: mutations, req: req, scopeResolver: scopeResolver, syncOptions: syncOptions, user: user })];
247
247
  case 1: return [2 /*return*/, (_c.response = _d.sent(),
248
248
  _c.stage = "applied",
249
249
  _c)];
@@ -33,6 +33,13 @@ export type SyncScope = SyncScopeOwner | SyncScopeTenant | SyncScopeBroadcast |
33
33
  * (seq stamping) — validated at registration.
34
34
  */
35
35
  export interface SyncConfig {
36
+ /**
37
+ * When true, change-stream `sync:delta` emission also fans in to `{collection}|admin`
38
+ * in addition to the owner/tenant/broadcast/custom stream. Default false. App clients
39
+ * keep their existing scope; only admin window subscribers join `|admin`. Join
40
+ * permission is admin-only (same checks as `/admin/*`), not owner-stream membership.
41
+ */
42
+ adminBroadcast?: boolean;
36
43
  /** Which stream a document belongs to. Multi-tenant by default via the tenant scope. */
37
44
  scope: SyncScope;
38
45
  /**
@@ -57,6 +64,10 @@ export interface SyncConfig {
57
64
  retentionDays?: number;
58
65
  }
59
66
  export type SyncMutationOperation = "create" | "update" | "delete";
67
+ /** Explicit client marker for admin-panel windowed sync writes. */
68
+ export type SyncMutationMode = "adminWindow";
69
+ /** `sync:subscribe` / `sync:subscribed` window mode for admin fan-in (no snapshot paging). */
70
+ export type SyncSubscribeMode = "window";
60
71
  /** A single entity in a snapshot response. */
61
72
  export interface SyncEntityPayload {
62
73
  /** Document id. */
@@ -125,6 +136,13 @@ export interface SyncMutateRequest {
125
136
  data?: Record<string, unknown>;
126
137
  /** The `_syncSeq` the client last saw for this document; enables LWW conflict detection. */
127
138
  baseVersion?: number;
139
+ /**
140
+ * When `"adminWindow"`, the server applies AdminApp write semantics (RBAC,
141
+ * writeOwned, readonly/hidden stripping, audit) instead of product sync
142
+ * permissions. Ignored unless the collection is `adminBroadcast`, the caller
143
+ * has admin-window access, and AdminApp registered a write scope.
144
+ */
145
+ mutationMode?: SyncMutationMode;
128
146
  }
129
147
  /** Successful mutation acknowledgement. */
130
148
  export interface SyncAck {
@@ -1,3 +1,4 @@
1
+ import { type Server as HttpServer } from "node:http";
1
2
  import * as Sentry from "@sentry/bun";
2
3
  import express from "express";
3
4
  import type { AdminChangeEvent, TerrenoAppAdminEvent } from "./adminTypes";
@@ -8,6 +9,8 @@ import { type AddRoutes, type AuthOptions } from "./expressServer";
8
9
  import { type GitHubAuthOptions } from "./githubAuth";
9
10
  import { type LoggingOptions } from "./logger";
10
11
  import { type McpServiceTokensAppOption } from "./mcp/serviceTokens";
12
+ import { type StartupMigrationsOption } from "./migrations/runner";
13
+ import { type OrgsAppOptions } from "./orgs/orgsApp";
11
14
  import type { RateLimitOptions } from "./rateLimit/types";
12
15
  import type { RealtimeAppOptions } from "./realtime/types";
13
16
  import type { TerrenoPlugin } from "./terrenoPlugin";
@@ -28,6 +31,12 @@ export interface TerrenoAppOptions {
28
31
  githubAuth?: GitHubAuthOptions;
29
32
  /** Skip calling app.listen() in start() method (useful for testing) */
30
33
  skipListen?: boolean;
34
+ /**
35
+ * Already-listening HTTP server. `start()` attaches the Express app to it
36
+ * instead of creating and binding a new server, so Cloud Run can see PORT
37
+ * before MongoDB connect and plugin registration finish.
38
+ */
39
+ httpServer?: HttpServer;
31
40
  /** Sentry configuration options */
32
41
  sentryOptions?: Sentry.BunOptions;
33
42
  /** Maximum number of array items in query parameters (default: 200) */
@@ -45,6 +54,13 @@ export interface TerrenoAppOptions {
45
54
  * RBAC access controller injected into model routers and `/auth/me` enrichment.
46
55
  */
47
56
  accessControl?: import("./rbac/types").AnyTerrenoAccess;
57
+ /**
58
+ * Multi-tenant organizations. Default off so existing single-tenant apps stay unchanged.
59
+ * New apps from `terreno_bootstrap_app` pass `true`. Requires `accessControl` from
60
+ * `createAccess({ organizations: true })`. Pass `{ settingsSchema }` to type and
61
+ * validate `Organization.settings`.
62
+ */
63
+ organizations?: boolean | Omit<OrgsAppOptions, "access" | "userModel">;
48
64
  /**
49
65
  * Runs after CORS and before the `addMiddleware` chain and JSON body parsing.
50
66
  * Use to attach early middleware via `app.use(...)` before JSON parsing.
@@ -66,6 +82,12 @@ export interface TerrenoAppOptions {
66
82
  * mounts `/mcp/service-tokens` and accepts `Authorization: Bearer mcp_…` on `/mcp`.
67
83
  */
68
84
  mcpServiceTokens?: McpServiceTokensAppOption;
85
+ /**
86
+ * Versioned MongoDB migrations. `runOnStart` defaults to false. When true, wet `up`
87
+ * runs after listen and `ensureSyncIndexes`. Production still requires
88
+ * `ALLOW_MIGRATIONS=true`.
89
+ */
90
+ migrations?: StartupMigrationsOption;
69
91
  }
70
92
  /**
71
93
  * Fluent API for building Express applications with Terreno framework.
@@ -135,6 +157,7 @@ export declare class TerrenoApp {
135
157
  private middlewareFns;
136
158
  private configurationApp;
137
159
  private readonly adminEvents;
160
+ private bootPromise;
138
161
  /**
139
162
  * Create a new TerrenoApp builder.
140
163
  *
@@ -261,6 +284,12 @@ export declare class TerrenoApp {
261
284
  * ```
262
285
  */
263
286
  start(): express.Application;
287
+ /**
288
+ * Resolves after startup migrations (and listen, unless `skipListen`).
289
+ * Tests with `skipListen` should await this instead of assuming `start()` is idle.
290
+ */
291
+ whenReady(): Promise<void>;
292
+ private completeStart;
264
293
  private isModelRouterRegistration;
265
294
  }
266
295
  export {};
@@ -100,6 +100,7 @@ var node_http_1 = require("node:http");
100
100
  var Sentry = __importStar(require("@sentry/bun"));
101
101
  var cors_1 = __importDefault(require("cors"));
102
102
  var express_1 = __importDefault(require("express"));
103
+ var mongoose_1 = __importDefault(require("mongoose"));
103
104
  var qs_1 = __importDefault(require("qs"));
104
105
  var auth_1 = require("./auth");
105
106
  var betterAuthSetup_1 = require("./betterAuthSetup");
@@ -111,8 +112,10 @@ var logger_1 = require("./logger");
111
112
  var server_1 = require("./mcp/server");
112
113
  var serviceTokens_1 = require("./mcp/serviceTokens");
113
114
  var middleware_1 = require("./middleware");
115
+ var runner_1 = require("./migrations/runner");
114
116
  var openApiCompat_1 = require("./openApiCompat");
115
117
  var openApiEtag_1 = require("./openApiEtag");
118
+ var orgsApp_1 = require("./orgs/orgsApp");
116
119
  var applyTrustProxy_1 = require("./rateLimit/applyTrustProxy");
117
120
  var createStore_1 = require("./rateLimit/createStore");
118
121
  var middleware_2 = require("./rateLimit/middleware");
@@ -190,10 +193,65 @@ var TerrenoApp = /** @class */ (function () {
190
193
  * @param options - Application configuration options including user model and auth settings
191
194
  */
192
195
  function TerrenoApp(options) {
196
+ var _this = this;
193
197
  this.registrations = [];
194
198
  this.middlewareFns = [];
195
199
  this.configurationApp = null;
196
200
  this.adminEvents = new node_events_1.EventEmitter();
201
+ this.bootPromise = Promise.resolve();
202
+ this.completeStart = function (app) { return __awaiter(_this, void 0, void 0, function () {
203
+ var port_1, existingServer, server, _a, _b, reg;
204
+ var e_1, _c;
205
+ return __generator(this, function (_d) {
206
+ switch (_d.label) {
207
+ case 0:
208
+ if (!!this.options.skipListen) return [3 /*break*/, 2];
209
+ port_1 = process.env.PORT || "9000";
210
+ existingServer = this.options.httpServer;
211
+ server = existingServer !== null && existingServer !== void 0 ? existingServer : (0, node_http_1.createServer)(app);
212
+ if (existingServer) {
213
+ existingServer.removeAllListeners("request");
214
+ existingServer.on("request", app);
215
+ }
216
+ try {
217
+ for (_a = __values(this.registrations), _b = _a.next(); !_b.done; _b = _a.next()) {
218
+ reg = _b.value;
219
+ if (!this.isModelRouterRegistration(reg) && typeof reg.onServerCreated === "function") {
220
+ reg.onServerCreated(server);
221
+ }
222
+ }
223
+ }
224
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
225
+ finally {
226
+ try {
227
+ if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
228
+ }
229
+ finally { if (e_1) throw e_1.error; }
230
+ }
231
+ // Bind PORT before index/migration work so Cloud Run's startup probe can
232
+ // succeed while `ensureSyncIndexes` still runs. whenReady() still waits.
233
+ if (!existingServer) {
234
+ server.listen(port_1, function () {
235
+ logger_1.logger.info("Listening on port ".concat(port_1));
236
+ });
237
+ }
238
+ else {
239
+ logger_1.logger.info("Listening on port ".concat(port_1));
240
+ }
241
+ return [4 /*yield*/, (0, registry_1.ensureSyncIndexes)()];
242
+ case 1:
243
+ _d.sent();
244
+ _d.label = 2;
245
+ case 2: return [4 /*yield*/, (0, runner_1.runStartupMigrations)({
246
+ migrations: this.options.migrations,
247
+ mongoose: mongoose_1.default,
248
+ })];
249
+ case 3:
250
+ _d.sent();
251
+ return [2 /*return*/];
252
+ }
253
+ });
254
+ }); };
197
255
  this.options = options;
198
256
  this.adminEvents.setMaxListeners(50);
199
257
  }
@@ -318,7 +376,7 @@ var TerrenoApp = /** @class */ (function () {
318
376
  * ```
319
377
  */
320
378
  TerrenoApp.prototype.build = function () {
321
- var e_1, _a, e_2, _b;
379
+ var e_2, _a, e_3, _b;
322
380
  var _this = this;
323
381
  var _c, _d, _e, _f, _g, _h;
324
382
  (0, logger_1.setupLogging)(this.options.loggingOptions);
@@ -346,12 +404,12 @@ var TerrenoApp = /** @class */ (function () {
346
404
  }
347
405
  }
348
406
  }
349
- catch (e_1_1) { e_1 = { error: e_1_1 }; }
407
+ catch (e_2_1) { e_2 = { error: e_2_1 }; }
350
408
  finally {
351
409
  try {
352
410
  if (_k && !_k.done && (_a = _j.return)) _a.call(_j);
353
411
  }
354
- finally { if (e_1) throw e_1.error; }
412
+ finally { if (e_2) throw e_2.error; }
355
413
  }
356
414
  app.use(express_1.default.json(rawBody_1.jsonBodyParserOptions));
357
415
  app.use(express_1.default.urlencoded(rawBody_1.urlencodedBodyParserOptions));
@@ -454,12 +512,12 @@ var TerrenoApp = /** @class */ (function () {
454
512
  }
455
513
  }
456
514
  }
457
- catch (e_2_1) { e_2 = { error: e_2_1 }; }
515
+ catch (e_3_1) { e_3 = { error: e_3_1 }; }
458
516
  finally {
459
517
  try {
460
518
  if (_m && !_m.done && (_b = _l.return)) _b.call(_l);
461
519
  }
462
- finally { if (e_2) throw e_2.error; }
520
+ finally { if (e_3) throw e_3.error; }
463
521
  }
464
522
  // Mount MCP at POST /mcp when any model opted in or a custom tool was registered.
465
523
  var betterAuthPlugin = this.registrations.find(function (registration) {
@@ -527,6 +585,21 @@ var TerrenoApp = /** @class */ (function () {
527
585
  TerrenoApp.prototype.start = function () {
528
586
  var _this = this;
529
587
  var _a;
588
+ if (this.options.organizations) {
589
+ if (!this.options.accessControl) {
590
+ throw new errors_1.APIError({
591
+ status: 500,
592
+ title: "TerrenoApp organizations requires accessControl from createAccess({ organizations: true })",
593
+ });
594
+ }
595
+ var hasOrgsPlugin = this.registrations.some(function (registration) {
596
+ return !_this.isModelRouterRegistration(registration) && registration instanceof orgsApp_1.OrgsApp;
597
+ });
598
+ if (!hasOrgsPlugin) {
599
+ var orgConfig = typeof this.options.organizations === "object" ? this.options.organizations : {};
600
+ this.register(new orgsApp_1.OrgsApp(__assign(__assign({}, orgConfig), { access: this.options.accessControl, userModel: this.options.userModel })));
601
+ }
602
+ }
530
603
  // If realtime option is set, auto-register the RealtimeApp plugin
531
604
  if (this.options.realtime) {
532
605
  var hasRealtimePlugin = this.registrations.some(function (r) { return !_this.isModelRouterRegistration(r) && r instanceof realtimeApp_1.RealtimeApp; });
@@ -541,59 +614,23 @@ var TerrenoApp = /** @class */ (function () {
541
614
  }
542
615
  }
543
616
  var app = this.build();
617
+ this.bootPromise = this.completeStart(app);
544
618
  if (!this.options.skipListen) {
545
- var port_1 = process.env.PORT || "9000";
546
- // Await sync index creation before listening: the per-model snapshot indexes (a
547
- // failed createIndex degrades the snapshot/catch-up query to a table scan) and the
548
- // bookkeeping-model indexes enqueued by SyncApp (the unique mutationId index is what
549
- // makes duplicate mutation deliveries idempotent, and the unique stream index is what
550
- // keeps the counter upsert race from minting duplicate seqs). Either failure is a
551
- // loud startup error rather than a silent correctness cliff. No-op when no sync
552
- // models or SyncApp are registered. Detached because start() returns synchronously.
553
- void (function () { return __awaiter(_this, void 0, void 0, function () {
554
- var server, _a, _b, reg, error_1, stack;
555
- var e_3, _c;
556
- return __generator(this, function (_d) {
557
- switch (_d.label) {
558
- case 0:
559
- _d.trys.push([0, 2, , 3]);
560
- return [4 /*yield*/, (0, registry_1.ensureSyncIndexes)()];
561
- case 1:
562
- _d.sent();
563
- server = (0, node_http_1.createServer)(app);
564
- try {
565
- // Notify plugins that need access to the HTTP server (e.g. WebSocket plugins)
566
- for (_a = __values(this.registrations), _b = _a.next(); !_b.done; _b = _a.next()) {
567
- reg = _b.value;
568
- if (!this.isModelRouterRegistration(reg) && typeof reg.onServerCreated === "function") {
569
- reg.onServerCreated(server);
570
- }
571
- }
572
- }
573
- catch (e_3_1) { e_3 = { error: e_3_1 }; }
574
- finally {
575
- try {
576
- if (_b && !_b.done && (_c = _a.return)) _c.call(_a);
577
- }
578
- finally { if (e_3) throw e_3.error; }
579
- }
580
- server.listen(port_1, function () {
581
- logger_1.logger.info("Listening on port ".concat(port_1));
582
- });
583
- return [3 /*break*/, 3];
584
- case 2:
585
- error_1 = _d.sent();
586
- stack = error_1 instanceof Error ? error_1.stack : String(error_1);
587
- logger_1.logger.error("Error trying to start HTTP server: ".concat(error_1, "\n").concat(stack));
588
- process.exit(1);
589
- return [3 /*break*/, 3];
590
- case 3: return [2 /*return*/];
591
- }
592
- });
593
- }); })();
619
+ void this.bootPromise.catch(function (error) {
620
+ var stack = error instanceof Error ? error.stack : String(error);
621
+ logger_1.logger.error("Error trying to start HTTP server: ".concat(error, "\n").concat(stack));
622
+ process.exit(1);
623
+ });
594
624
  }
595
625
  return app;
596
626
  };
627
+ /**
628
+ * Resolves after startup migrations (and listen, unless `skipListen`).
629
+ * Tests with `skipListen` should await this instead of assuming `start()` is idle.
630
+ */
631
+ TerrenoApp.prototype.whenReady = function () {
632
+ return this.bootPromise;
633
+ };
597
634
  TerrenoApp.prototype.isModelRouterRegistration = function (registration) {
598
635
  return registration.__type === "modelRouter";
599
636
  };
@@ -1,8 +1,6 @@
1
- import type { CachedTestData, TestData, TestFoods, TestRequired, TestUsers } from "./types";
1
+ import type { CachedTestData, TestData, TestUsers } from "./types";
2
2
  export declare const clearTestCollections: () => Promise<void>;
3
3
  export declare const createTestUsers: () => Promise<TestUsers>;
4
- export declare const createStandardFoods: (users: TestUsers) => Promise<TestFoods>;
5
- export declare const createRequiredFixtures: () => Promise<TestRequired>;
6
4
  /** Builds the standard Terreno API test database (users, foods, required docs). */
7
5
  export declare const createTestData: () => Promise<TestData>;
8
6
  export declare const toCachedTestData: (testData: TestData) => CachedTestData;
@@ -55,7 +55,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
55
55
  return (mod && mod.__esModule) ? mod : { "default": mod };
56
56
  };
57
57
  Object.defineProperty(exports, "__esModule", { value: true });
58
- exports.loadTestDataFromDocuments = exports.toCachedTestData = exports.createTestData = exports.createRequiredFixtures = exports.createStandardFoods = exports.createTestUsers = exports.clearTestCollections = void 0;
58
+ exports.loadTestDataFromDocuments = exports.toCachedTestData = exports.createTestData = exports.createTestUsers = exports.clearTestCollections = void 0;
59
59
  var luxon_1 = require("luxon");
60
60
  var mongoose_1 = __importDefault(require("mongoose"));
61
61
  var errors_1 = require("../errors");
@@ -187,7 +187,6 @@ var createStandardFoods = function (users) { return __awaiter(void 0, void 0, vo
187
187
  }
188
188
  });
189
189
  }); };
190
- exports.createStandardFoods = createStandardFoods;
191
190
  var createRequiredFixtures = function () { return __awaiter(void 0, void 0, void 0, function () {
192
191
  var _a, sample, withAbout;
193
192
  return __generator(this, function (_b) {
@@ -202,7 +201,6 @@ var createRequiredFixtures = function () { return __awaiter(void 0, void 0, void
202
201
  }
203
202
  });
204
203
  }); };
205
- exports.createRequiredFixtures = createRequiredFixtures;
206
204
  /** Builds the standard Terreno API test database (users, foods, required docs). */
207
205
  var createTestData = function () { return __awaiter(void 0, void 0, void 0, function () {
208
206
  var users, _a, foods, required;
@@ -215,8 +213,8 @@ var createTestData = function () { return __awaiter(void 0, void 0, void 0, func
215
213
  case 2:
216
214
  users = _b.sent();
217
215
  return [4 /*yield*/, Promise.all([
218
- (0, exports.createStandardFoods)(users),
219
- (0, exports.createRequiredFixtures)(),
216
+ createStandardFoods(users),
217
+ createRequiredFixtures(),
220
218
  ])];
221
219
  case 3:
222
220
  _a = __read.apply(void 0, [_b.sent(), 2]), foods = _a[0], required = _a[1];
@@ -7,6 +7,7 @@ export interface User {
7
7
  age?: number;
8
8
  disabled?: boolean;
9
9
  organizationIds?: string[];
10
+ roles?: string[];
10
11
  tokenEpoch?: number;
11
12
  emailVerified?: boolean;
12
13
  }
@@ -52,6 +52,11 @@ var userSchema = new mongoose_1.Schema({
52
52
  description: "Organization memberships",
53
53
  type: [String],
54
54
  },
55
+ roles: {
56
+ default: [],
57
+ description: "RBAC role names assigned to this user",
58
+ type: [String],
59
+ },
55
60
  tokenEpoch: {
56
61
  default: 0,
57
62
  description: "Incremented on password reset to invalidate outstanding refresh tokens",
@@ -61,10 +66,12 @@ var userSchema = new mongoose_1.Schema({
61
66
  });
62
67
  userSchema.plugin(passport_local_mongoose_1.default, {
63
68
  attemptsField: "attempts",
64
- interval: process.env.NODE_ENV === "test" ? 1 : 100,
69
+ interval: 1,
65
70
  limitAttempts: true,
66
71
  maxAttempts: 3,
67
- maxInterval: process.env.NODE_ENV === "test" ? 1 : 300000,
72
+ // Test-only schema: maxInterval 0 caps calculatedInterval at 0 so AttemptTooSoon
73
+ // never preempts maxAttempts lockout under rapid supertest logins.
74
+ maxInterval: 0,
68
75
  usernameCaseInsensitive: true,
69
76
  usernameField: "email",
70
77
  });
@@ -1,5 +1,4 @@
1
1
  import type { TestData } from "./types";
2
- export declare const applyTestAuthEnv: () => void;
3
2
  /** Seeds only the standard users (legacy helper). */
4
3
  export declare const setupDb: () => Promise<readonly [import("mongoose").Document<unknown, {}, import("./models").User, {}, import("mongoose").DefaultSchemaOptions> & import("./models").User & {
5
4
  _id: import("mongoose").Types.ObjectId;
@@ -22,7 +21,3 @@ export declare const setupDb: () => Promise<readonly [import("mongoose").Documen
22
21
  }]>;
23
22
  /** Seeds users, foods, and required docs — the recommended API test baseline. */
24
23
  export declare const setupTestData: () => Promise<TestData>;
25
- /** Clears all API test collections without re-seeding. */
26
- export declare const resetTestCollections: () => Promise<void>;
27
- export { createTestData } from "./createTestData";
28
- export { loadTestData } from "./mongoTestSetup";
@@ -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.loadTestData = exports.createTestData = exports.resetTestCollections = exports.setupTestData = exports.setupDb = exports.applyTestAuthEnv = void 0;
39
+ exports.setupTestData = exports.setupDb = void 0;
40
40
  var test_1 = require("@terreno/test");
41
41
  var logger_1 = require("../logger");
42
42
  var createTestData_1 = require("./createTestData");
@@ -49,7 +49,6 @@ var applyTestAuthEnv = function () {
49
49
  process.env.TOKEN_ISSUER = "example.com";
50
50
  process.env.SESSION_SECRET = "session";
51
51
  };
52
- exports.applyTestAuthEnv = applyTestAuthEnv;
53
52
  var ensureConnected = function () { return __awaiter(void 0, void 0, void 0, function () {
54
53
  return __generator(this, function (_a) {
55
54
  switch (_a.label) {
@@ -59,7 +58,7 @@ var ensureConnected = function () { return __awaiter(void 0, void 0, void 0, fun
59
58
  })];
60
59
  case 1:
61
60
  _a.sent();
62
- (0, exports.applyTestAuthEnv)();
61
+ applyTestAuthEnv();
63
62
  return [2 /*return*/];
64
63
  }
65
64
  });
@@ -106,9 +105,3 @@ var setupTestData = function () { return __awaiter(void 0, void 0, void 0, funct
106
105
  });
107
106
  }); };
108
107
  exports.setupTestData = setupTestData;
109
- /** Clears all API test collections without re-seeding. */
110
- exports.resetTestCollections = createTestData_1.clearTestCollections;
111
- var createTestData_2 = require("./createTestData");
112
- Object.defineProperty(exports, "createTestData", { enumerable: true, get: function () { return createTestData_2.createTestData; } });
113
- var mongoTestSetup_2 = require("./mongoTestSetup");
114
- Object.defineProperty(exports, "loadTestData", { enumerable: true, get: function () { return mongoTestSetup_2.loadTestData; } });
@@ -1,8 +1,8 @@
1
1
  import type mongoose from "mongoose";
2
2
  import type { FindExactlyOnePlugin, FindOneOrNonePlugin } from "../plugins";
3
3
  export type AuthTokenType = "passwordReset" | "emailVerification";
4
- export type AuthTokenMethods = Record<string, never>;
5
- export interface AuthTokenStatics extends FindExactlyOnePlugin<AuthTokenDocument>, FindOneOrNonePlugin<AuthTokenDocument> {
4
+ type AuthTokenMethods = Record<string, never>;
5
+ interface AuthTokenStatics extends FindExactlyOnePlugin<AuthTokenDocument>, FindOneOrNonePlugin<AuthTokenDocument> {
6
6
  consume: (this: AuthTokenModel, token: string, type: AuthTokenType) => Promise<AuthTokenDocument | null>;
7
7
  invalidateUnusedFor: (this: AuthTokenModel, user: {
8
8
  _id: {
@@ -20,7 +20,6 @@ export interface AuthTokenStatics extends FindExactlyOnePlugin<AuthTokenDocument
20
20
  }
21
21
  export interface AuthTokenModel extends mongoose.Model<AuthTokenDocument, object, AuthTokenMethods>, AuthTokenStatics {
22
22
  }
23
- export type AuthTokenSchema = mongoose.Schema<AuthTokenDocument, AuthTokenModel, AuthTokenMethods>;
24
23
  export interface AuthTokenDocument extends mongoose.Document {
25
24
  _id: mongoose.Types.ObjectId;
26
25
  userId: mongoose.Types.ObjectId;
@@ -31,3 +30,4 @@ export interface AuthTokenDocument extends mongoose.Document {
31
30
  created: Date;
32
31
  updated: Date;
33
32
  }
33
+ export {};
@@ -4,7 +4,7 @@ export interface McpServiceTokenIssueOptions {
4
4
  expiresAt?: Date;
5
5
  name: string;
6
6
  }
7
- export interface McpServiceTokenMethods {
7
+ interface McpServiceTokenMethods {
8
8
  deleteOne: (this: McpServiceTokenDocument) => Promise<McpServiceTokenDocument>;
9
9
  }
10
10
  export interface McpServiceTokenStatics extends FindExactlyOnePlugin<McpServiceTokenDocument>, FindOneOrNonePlugin<McpServiceTokenDocument> {
@@ -26,7 +26,6 @@ export interface McpServiceTokenStatics extends FindExactlyOnePlugin<McpServiceT
26
26
  }
27
27
  export interface McpServiceTokenModel extends mongoose.Model<McpServiceTokenDocument, object, McpServiceTokenMethods>, McpServiceTokenStatics {
28
28
  }
29
- export type McpServiceTokenSchema = mongoose.Schema<McpServiceTokenDocument, McpServiceTokenModel, McpServiceTokenMethods>;
30
29
  export interface McpServiceTokenDocument extends mongoose.Document {
31
30
  _id: mongoose.Types.ObjectId;
32
31
  created: Date;
@@ -39,3 +38,4 @@ export interface McpServiceTokenDocument extends mongoose.Document {
39
38
  updated: Date;
40
39
  userId: mongoose.Types.ObjectId;
41
40
  }
41
+ export {};
@@ -0,0 +1,23 @@
1
+ import type mongoose from "mongoose";
2
+ import type { FindExactlyOnePlugin, FindOneOrNonePlugin } from "../plugins";
3
+ export type MembershipRoleName = "org-admin" | "member";
4
+ export type MembershipStatus = "active" | "suspended";
5
+ export type MembershipMethods = {};
6
+ export interface MembershipStatics extends FindExactlyOnePlugin<MembershipDocument>, FindOneOrNonePlugin<MembershipDocument> {
7
+ findActiveForUser: (this: MembershipModel, userId: mongoose.Types.ObjectId | string) => Promise<MembershipDocument[]>;
8
+ isMember: (this: MembershipModel, userId: mongoose.Types.ObjectId | string, organizationId: mongoose.Types.ObjectId | string) => Promise<boolean>;
9
+ isOrgAdmin: (this: MembershipModel, userId: mongoose.Types.ObjectId | string, organizationId: mongoose.Types.ObjectId | string) => Promise<boolean>;
10
+ }
11
+ export interface MembershipModel extends mongoose.Model<MembershipDocument, object, MembershipMethods>, MembershipStatics {
12
+ }
13
+ export type MembershipSchema = mongoose.Schema<MembershipDocument, MembershipModel, MembershipMethods>;
14
+ export interface MembershipDocument extends mongoose.Document {
15
+ _id: mongoose.Types.ObjectId;
16
+ created: Date;
17
+ deleted: boolean;
18
+ organizationId: mongoose.Types.ObjectId;
19
+ roleName: MembershipRoleName;
20
+ status: MembershipStatus;
21
+ updated: Date;
22
+ userId: mongoose.Types.ObjectId;
23
+ }
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,28 @@
1
+ import type mongoose from "mongoose";
2
+ import type { FindExactlyOnePlugin, FindOneOrNonePlugin } from "../plugins";
3
+ type NotificationMethods = Record<never, never>;
4
+ interface NotificationStatics extends FindExactlyOnePlugin<NotificationDocument>, FindOneOrNonePlugin<NotificationDocument> {
5
+ }
6
+ export interface NotificationModel extends mongoose.Model<NotificationDocument, object, NotificationMethods>, NotificationStatics {
7
+ }
8
+ export interface NotificationDocument extends mongoose.Document<string>, NotificationMethods {
9
+ _id: string;
10
+ archivedAt: Date | null;
11
+ body: string;
12
+ href?: string;
13
+ kind?: string;
14
+ ownerId: mongoose.Types.ObjectId;
15
+ readAt: Date | null;
16
+ title: string;
17
+ created: Date;
18
+ updated: Date;
19
+ deleted: boolean;
20
+ }
21
+ export interface NotifyInput {
22
+ body: string;
23
+ href?: string;
24
+ kind?: string;
25
+ title: string;
26
+ userId: string;
27
+ }
28
+ export {};
@@ -0,0 +1,2 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });