@open-pencil/cloud 0.0.0-stage → 0.17.0-beta.1

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 (279) hide show
  1. package/LICENSE +202 -0
  2. package/LICENSE-MIT +21 -0
  3. package/NOTICE +7 -0
  4. package/README.md +37 -2
  5. package/dist/bin/ai-relay.d.mts +1 -0
  6. package/dist/bin/ai-relay.mjs +31 -0
  7. package/dist/bin/ai-relay.mjs.map +1 -0
  8. package/dist/bin/server.d.mts +1 -0
  9. package/dist/bin/server.mjs +29 -0
  10. package/dist/bin/server.mjs.map +1 -0
  11. package/dist/client.d.ts +1520 -0
  12. package/dist/client.d.ts.map +1 -0
  13. package/dist/client.js +1917 -0
  14. package/dist/client.js.map +1 -0
  15. package/dist/contract.d.ts +2 -0
  16. package/dist/contract.js +2 -0
  17. package/dist/contract2.js +1453 -0
  18. package/dist/contract2.js.map +1 -0
  19. package/dist/email.d.ts +169 -0
  20. package/dist/email.d.ts.map +1 -0
  21. package/dist/email.js +670 -0
  22. package/dist/email.js.map +1 -0
  23. package/dist/index.d.ts +1755 -0
  24. package/dist/index.d.ts.map +1 -0
  25. package/dist/listen.mjs +1881 -0
  26. package/dist/listen.mjs.map +1 -0
  27. package/dist/runtime-node.d.mts +10040 -0
  28. package/dist/runtime-node.d.mts.map +1 -0
  29. package/dist/runtime-node.mjs +32 -0
  30. package/dist/runtime-node.mjs.map +1 -0
  31. package/dist/server.d.ts +12792 -0
  32. package/dist/server.d.ts.map +1 -0
  33. package/dist/server.js +8475 -0
  34. package/dist/server.js.map +1 -0
  35. package/dist/server.mjs +8324 -0
  36. package/dist/server.mjs.map +1 -0
  37. package/dist/server2.mjs +505 -0
  38. package/dist/server2.mjs.map +1 -0
  39. package/package.json +124 -4
  40. package/src/admin/api/routes.ts +223 -0
  41. package/src/admin/api/security.ts +12 -0
  42. package/src/admin/audit/service.ts +138 -0
  43. package/src/admin/email/service.ts +140 -0
  44. package/src/admin/enrollment/email.ts +77 -0
  45. package/src/admin/enrollment/service.ts +308 -0
  46. package/src/admin/errors.ts +20 -0
  47. package/src/admin/index.ts +19 -0
  48. package/src/admin/list.ts +61 -0
  49. package/src/admin/operations/service.ts +70 -0
  50. package/src/admin/schema.ts +28 -0
  51. package/src/admin/users/service.ts +369 -0
  52. package/src/ai-relay/app.ts +251 -0
  53. package/src/ai-relay/config.ts +120 -0
  54. package/src/ai-relay/db/index.ts +10 -0
  55. package/src/ai-relay/db/migrate.ts +32 -0
  56. package/src/ai-relay/db/migrations/001_usage.ts +26 -0
  57. package/src/ai-relay/db/schema.ts +20 -0
  58. package/src/ai-relay/index.ts +18 -0
  59. package/src/ai-relay/metering.ts +68 -0
  60. package/src/ai-relay/usage.ts +115 -0
  61. package/src/client/ai.ts +96 -0
  62. package/src/client/api.ts +528 -0
  63. package/src/client/auth/client.ts +188 -0
  64. package/src/client/auth/failure.ts +54 -0
  65. package/src/client/auth/navigation.ts +45 -0
  66. package/src/client/device-authorization.ts +134 -0
  67. package/src/client/discovery.ts +105 -0
  68. package/src/client/images.ts +81 -0
  69. package/src/client/index.ts +53 -0
  70. package/src/client/portal/account.ts +183 -0
  71. package/src/client/portal/administration.ts +130 -0
  72. package/src/client/portal/client.ts +18 -0
  73. package/src/client/portal/request.ts +115 -0
  74. package/src/client/response.ts +51 -0
  75. package/src/client/workspaces.ts +142 -0
  76. package/src/contract/account.ts +204 -0
  77. package/src/contract/admin/index.ts +187 -0
  78. package/src/contract/ai.ts +150 -0
  79. package/src/contract/collaboration.ts +45 -0
  80. package/src/contract/discovery.ts +81 -0
  81. package/src/contract/documents.ts +265 -0
  82. package/src/contract/entitlements.ts +28 -0
  83. package/src/contract/index.ts +204 -0
  84. package/src/contract/links.ts +87 -0
  85. package/src/contract/portal.ts +11 -0
  86. package/src/contract/relay.ts +368 -0
  87. package/src/contract/sharing.ts +191 -0
  88. package/src/contract/versions.ts +87 -0
  89. package/src/contract/workspaces.ts +100 -0
  90. package/src/email/index.ts +14 -0
  91. package/src/email/render.ts +276 -0
  92. package/src/email/schema.ts +144 -0
  93. package/src/email/templates/brand.ts +105 -0
  94. package/src/email/templates/document-invitation.ts +35 -0
  95. package/src/email/templates/enrollment.ts +27 -0
  96. package/src/email/templates/layout.ts +18 -0
  97. package/src/runtime/cloudflare/email.ts +70 -0
  98. package/src/runtime/cloudflare/environment.ts +57 -0
  99. package/src/runtime/cloudflare/index.ts +3 -0
  100. package/src/runtime/cloudflare/relay.ts +136 -0
  101. package/src/runtime/cloudflare/site.ts +13 -0
  102. package/src/runtime/cloudflare/tsconfig.json +21 -0
  103. package/src/runtime/cloudflare/worker.ts +160 -0
  104. package/src/runtime/node/admin.ts +59 -0
  105. package/src/runtime/node/ai-relay/main.ts +35 -0
  106. package/src/runtime/node/ai-relay/server.ts +63 -0
  107. package/src/runtime/node/application.ts +50 -0
  108. package/src/runtime/node/bootstrap.ts +22 -0
  109. package/src/runtime/node/cleanup.ts +24 -0
  110. package/src/runtime/node/command.ts +17 -0
  111. package/src/runtime/node/config.ts +16 -0
  112. package/src/runtime/node/email/runtime.ts +43 -0
  113. package/src/runtime/node/email/transport.ts +112 -0
  114. package/src/runtime/node/entitlements/main.ts +41 -0
  115. package/src/runtime/node/entitlements/refusal.ts +15 -0
  116. package/src/runtime/node/index.ts +25 -0
  117. package/src/runtime/node/listen.ts +35 -0
  118. package/src/runtime/node/main.ts +29 -0
  119. package/src/runtime/node/migrate.ts +13 -0
  120. package/src/runtime/node/quota-reconcile.ts +9 -0
  121. package/src/runtime/node/relay.ts +54 -0
  122. package/src/runtime/node/server.ts +121 -0
  123. package/src/runtime/node/site.ts +64 -0
  124. package/src/runtime/postgres/database.ts +19 -0
  125. package/src/runtime/s3/objects.ts +244 -0
  126. package/src/runtime/site/server.ts +82 -0
  127. package/src/server/account/actions.ts +66 -0
  128. package/src/server/account/routes.ts +300 -0
  129. package/src/server/ai/errors.ts +7 -0
  130. package/src/server/ai/index.ts +4 -0
  131. package/src/server/ai/keys.ts +43 -0
  132. package/src/server/ai/routes.ts +43 -0
  133. package/src/server/ai/service.ts +70 -0
  134. package/src/server/api/index.ts +8 -0
  135. package/src/server/api/router.ts +117 -0
  136. package/src/server/api/types.ts +7 -0
  137. package/src/server/app.ts +375 -0
  138. package/src/server/auth/account.ts +73 -0
  139. package/src/server/auth/activity.ts +213 -0
  140. package/src/server/auth/adapter.ts +79 -0
  141. package/src/server/auth/email.ts +125 -0
  142. package/src/server/auth/endpoints.ts +57 -0
  143. package/src/server/auth/factory.ts +583 -0
  144. package/src/server/auth/index.ts +17 -0
  145. package/src/server/auth/mfa-assurance.ts +55 -0
  146. package/src/server/auth/runtime.ts +26 -0
  147. package/src/server/auth/session.ts +19 -0
  148. package/src/server/auth/social-providers.ts +55 -0
  149. package/src/server/auth/user-agent.ts +16 -0
  150. package/src/server/auth/workspace-access.ts +23 -0
  151. package/src/server/cleanup/configured.ts +38 -0
  152. package/src/server/cleanup/documents.ts +231 -0
  153. package/src/server/cleanup/index.ts +29 -0
  154. package/src/server/cleanup/objects.ts +27 -0
  155. package/src/server/cleanup/revisions.ts +232 -0
  156. package/src/server/cleanup/uploads.ts +129 -0
  157. package/src/server/cleanup/worker.ts +79 -0
  158. package/src/server/collaboration/index.ts +28 -0
  159. package/src/server/collaboration/relay/authorize.ts +53 -0
  160. package/src/server/collaboration/relay/awareness.ts +104 -0
  161. package/src/server/collaboration/relay/documents.ts +39 -0
  162. package/src/server/collaboration/relay/hub.ts +524 -0
  163. package/src/server/collaboration/relay/index.ts +15 -0
  164. package/src/server/collaboration/relay/persistence.ts +48 -0
  165. package/src/server/collaboration/routes.ts +77 -0
  166. package/src/server/collaboration/service.ts +188 -0
  167. package/src/server/config/deployment.ts +178 -0
  168. package/src/server/config/index.ts +20 -0
  169. package/src/server/config/limits.ts +8 -0
  170. package/src/server/config/public.ts +66 -0
  171. package/src/server/config/schema.ts +512 -0
  172. package/src/server/db/database.ts +15 -0
  173. package/src/server/db/expressions.ts +13 -0
  174. package/src/server/db/index.ts +21 -0
  175. package/src/server/db/migrate.ts +177 -0
  176. package/src/server/db/migrations/001_foundation.ts +164 -0
  177. package/src/server/db/migrations/002_upload_cleanup_claims.ts +34 -0
  178. package/src/server/db/migrations/003_document_cleanup_claims.ts +23 -0
  179. package/src/server/db/migrations/004_document_sharing.ts +82 -0
  180. package/src/server/db/migrations/005_document_collaboration_epoch.ts +13 -0
  181. package/src/server/db/migrations/006_invitation_continuation.ts +27 -0
  182. package/src/server/db/migrations/007_collaboration_state.ts +25 -0
  183. package/src/server/db/migrations/008_storage_reservations.ts +37 -0
  184. package/src/server/db/migrations/009_workspace_entitlements.ts +22 -0
  185. package/src/server/db/migrations/010_upload_finalization.ts +22 -0
  186. package/src/server/db/migrations/011_upload_finalization_lease.ts +12 -0
  187. package/src/server/db/migrations/012_transactional_email.ts +48 -0
  188. package/src/server/db/migrations/013_admin_enrollment.ts +54 -0
  189. package/src/server/db/migrations/014_enrollment_email_kinds.ts +30 -0
  190. package/src/server/db/migrations/015_cloud_rate_limit.ts +22 -0
  191. package/src/server/db/migrations/016_auth_schema.ts +16 -0
  192. package/src/server/db/migrations/017_authentication_email_kinds.ts +32 -0
  193. package/src/server/db/migrations/018_authentication_mfa.ts +78 -0
  194. package/src/server/db/migrations/019_better_auth_account_issuer.ts +42 -0
  195. package/src/server/db/migrations/020_workspace_invitations.ts +57 -0
  196. package/src/server/db/migrations/021_document_versions.ts +66 -0
  197. package/src/server/db/migrations/022_entitlement_external_version.ts +17 -0
  198. package/src/server/db/migrations/023_document_images.ts +61 -0
  199. package/src/server/db/migrations/024_account_activity.ts +66 -0
  200. package/src/server/db/migrations/025_table_names.ts +58 -0
  201. package/src/server/db/migrations/026_user_picture.ts +30 -0
  202. package/src/server/db/migrations/027_document_kind.ts +19 -0
  203. package/src/server/db/migrations/helpers.ts +78 -0
  204. package/src/server/db/tables.ts +394 -0
  205. package/src/server/documents/access.ts +103 -0
  206. package/src/server/documents/errors.ts +16 -0
  207. package/src/server/documents/images.ts +407 -0
  208. package/src/server/documents/index.ts +14 -0
  209. package/src/server/documents/limits.ts +57 -0
  210. package/src/server/documents/repository.ts +141 -0
  211. package/src/server/documents/routes.ts +239 -0
  212. package/src/server/documents/service.ts +597 -0
  213. package/src/server/documents/summary.ts +37 -0
  214. package/src/server/documents/types.ts +14 -0
  215. package/src/server/documents/versions/checkpoint.ts +98 -0
  216. package/src/server/documents/versions/history.ts +25 -0
  217. package/src/server/documents/versions/index.ts +4 -0
  218. package/src/server/documents/versions/routes.ts +112 -0
  219. package/src/server/documents/versions/service.ts +397 -0
  220. package/src/server/email/crypto.ts +57 -0
  221. package/src/server/email/index.ts +18 -0
  222. package/src/server/email/invitations.ts +30 -0
  223. package/src/server/email/service.ts +245 -0
  224. package/src/server/email/types.ts +56 -0
  225. package/src/server/email/worker.ts +33 -0
  226. package/src/server/index.ts +279 -0
  227. package/src/server/internal/index.ts +8 -0
  228. package/src/server/internal/routes.ts +41 -0
  229. package/src/server/internal/schema.ts +10 -0
  230. package/src/server/internal/service.ts +44 -0
  231. package/src/server/invitations/index.ts +6 -0
  232. package/src/server/invitations/types.ts +30 -0
  233. package/src/server/objects/index.ts +16 -0
  234. package/src/server/objects/types.ts +81 -0
  235. package/src/server/pictures/index.ts +9 -0
  236. package/src/server/pictures/provider.ts +61 -0
  237. package/src/server/pictures/routes.ts +21 -0
  238. package/src/server/pictures/service.ts +235 -0
  239. package/src/server/policy/configured.ts +23 -0
  240. package/src/server/policy/database.ts +108 -0
  241. package/src/server/policy/entitlements.ts +29 -0
  242. package/src/server/policy/index.ts +17 -0
  243. package/src/server/policy/keys.ts +23 -0
  244. package/src/server/policy/policy.ts +117 -0
  245. package/src/server/policy/provider.ts +67 -0
  246. package/src/server/policy/schema.ts +69 -0
  247. package/src/server/policy/service.ts +85 -0
  248. package/src/server/policy/static.ts +62 -0
  249. package/src/server/quota/index.ts +7 -0
  250. package/src/server/quota/reconcile.ts +61 -0
  251. package/src/server/quota/storage.ts +165 -0
  252. package/src/server/rate-limit/cleanup.ts +16 -0
  253. package/src/server/rate-limit/index.ts +12 -0
  254. package/src/server/rate-limit/keys.ts +38 -0
  255. package/src/server/rate-limit/middleware.ts +137 -0
  256. package/src/server/rate-limit/postgres.ts +79 -0
  257. package/src/server/sharing/access.ts +29 -0
  258. package/src/server/sharing/actor.ts +12 -0
  259. package/src/server/sharing/capabilities/service.ts +262 -0
  260. package/src/server/sharing/continuation.ts +85 -0
  261. package/src/server/sharing/contracts.ts +80 -0
  262. package/src/server/sharing/crypto.ts +48 -0
  263. package/src/server/sharing/document-routes.ts +41 -0
  264. package/src/server/sharing/errors.ts +12 -0
  265. package/src/server/sharing/grants/service.ts +79 -0
  266. package/src/server/sharing/http.ts +41 -0
  267. package/src/server/sharing/index.ts +39 -0
  268. package/src/server/sharing/invitations/service.ts +315 -0
  269. package/src/server/sharing/policy.ts +44 -0
  270. package/src/server/sharing/routes.ts +251 -0
  271. package/src/server/sharing/service.ts +117 -0
  272. package/src/server/validation.ts +24 -0
  273. package/src/server/worker/interval.ts +23 -0
  274. package/src/server/worker/periodic.ts +42 -0
  275. package/src/server/workspaces/index.ts +16 -0
  276. package/src/server/workspaces/members.ts +502 -0
  277. package/src/server/workspaces/repository.ts +91 -0
  278. package/src/server/workspaces/routes.ts +198 -0
  279. package/src/server/workspaces/service.ts +84 -0
@@ -0,0 +1,77 @@
1
+ import type { CloudDatabase } from '#cloud/server/db'
2
+ import type { TransactionalEmailService } from '#cloud/server/email'
3
+ import type { Transaction } from 'kysely'
4
+
5
+ import type { EnrollmentStatus } from './service'
6
+
7
+ export type EnrollmentEmailOptions = {
8
+ /**
9
+ * The server's address: its editor, where an approved account goes next, and its own pages,
10
+ * where people sign in and administrators review requests.
11
+ */
12
+ publicURL: string
13
+ adminRecipients: string[]
14
+ email?: TransactionalEmailService
15
+ }
16
+
17
+ export async function enqueueEnrollmentRequested(
18
+ transaction: Transaction<CloudDatabase>,
19
+ options: EnrollmentEmailOptions,
20
+ input: { enrollmentId: string; email: string; name: string; reason: string; revision: number }
21
+ ): Promise<void> {
22
+ if (!options.email) return
23
+ await options.email.enqueue(
24
+ {
25
+ idempotencyKey: `enrollment-requested/${input.enrollmentId}/${input.revision}`,
26
+ kind: 'enrollment-requested',
27
+ recipientEmail: input.email,
28
+ payload: { name: input.name, actionURL: new URL('/auth/sign-in', options.publicURL).href }
29
+ },
30
+ transaction
31
+ )
32
+ for (const recipientEmail of options.adminRecipients) {
33
+ await options.email.enqueue(
34
+ {
35
+ idempotencyKey: `admin-enrollment-notification/${input.enrollmentId}/${input.revision}/${recipientEmail}`,
36
+ kind: 'admin-enrollment-notification',
37
+ recipientEmail,
38
+ payload: {
39
+ requesterEmail: input.email,
40
+ requesterName: input.name,
41
+ reason: input.reason,
42
+ actionURL: new URL('/admin/requests', options.publicURL).href
43
+ }
44
+ },
45
+ transaction
46
+ )
47
+ }
48
+ }
49
+
50
+ export async function enqueueEnrollmentReview(
51
+ transaction: Transaction<CloudDatabase>,
52
+ options: EnrollmentEmailOptions,
53
+ input: {
54
+ enrollmentId: string
55
+ recipientEmail: string
56
+ name: string
57
+ status: Exclude<EnrollmentStatus, 'pending'>
58
+ reviewedAt: Date
59
+ }
60
+ ): Promise<void> {
61
+ if (!options.email) return
62
+ await options.email.enqueue(
63
+ {
64
+ idempotencyKey: `enrollment-${input.status}/${input.enrollmentId}/${input.reviewedAt.toISOString()}`,
65
+ kind: `enrollment-${input.status}`,
66
+ recipientEmail: input.recipientEmail,
67
+ payload: {
68
+ name: input.name,
69
+ actionURL:
70
+ input.status === 'approved'
71
+ ? options.publicURL
72
+ : new URL('/auth/sign-in', options.publicURL).href
73
+ }
74
+ },
75
+ transaction
76
+ )
77
+ }
@@ -0,0 +1,308 @@
1
+ import { AdminDomainError } from '#cloud/admin/errors'
2
+ import {
3
+ containsPattern,
4
+ countEachFilter,
5
+ listSearch,
6
+ listWindow,
7
+ type AdminListQuery,
8
+ type ListFilters
9
+ } from '#cloud/admin/list'
10
+ import { isUUID } from '#cloud/admin/schema'
11
+ import { enrollmentStatusSchema } from '#cloud/contract'
12
+ import type { CloudDatabase } from '#cloud/server/db'
13
+ import { compact, uniq } from 'es-toolkit'
14
+ import type { Kysely } from 'kysely'
15
+
16
+ import {
17
+ enqueueEnrollmentRequested,
18
+ enqueueEnrollmentReview,
19
+ type EnrollmentEmailOptions
20
+ } from './email'
21
+
22
+ export type EnrollmentStatus = 'pending' | 'approved' | 'rejected' | 'revoked'
23
+ export type EnrollmentMode = 'open' | 'approval' | 'closed'
24
+
25
+ export type EnrollmentRequestInput = { email: string; name?: string; reason?: string }
26
+ export type EnrollmentReviewInput = { note?: string }
27
+ export type EnrollmentRecord = {
28
+ id: string
29
+ email: string
30
+ name: string | null
31
+ reason: string | null
32
+ status: EnrollmentStatus
33
+ requestedAt: string
34
+ reviewedAt: string | null
35
+ reviewedBy: string | null
36
+ reviewerName?: string | null
37
+ reviewNote: string | null
38
+ approvedUserId: string | null
39
+ requestRevision: number
40
+ }
41
+
42
+ type EnrollmentRow = {
43
+ id: string
44
+ emailNormalized: string
45
+ name: string | null
46
+ reason: string | null
47
+ status: EnrollmentStatus
48
+ requestedAt: Date | string
49
+ reviewedAt: Date | string | null
50
+ reviewedBy: string | null
51
+ reviewNote: string | null
52
+ approvedUserId: string | null
53
+ requestRevision: number
54
+ }
55
+
56
+ const ALLOWED_TRANSITIONS: Record<EnrollmentStatus, ReadonlySet<EnrollmentStatus>> = {
57
+ pending: new Set(['approved', 'rejected']),
58
+ approved: new Set(['revoked']),
59
+ rejected: new Set(['pending', 'approved']),
60
+ revoked: new Set(['pending', 'approved'])
61
+ }
62
+
63
+ /** Requests by their status; each is in exactly one. */
64
+ const FILTERS: ListFilters<EnrollmentStatus, 'enrollment'> = {
65
+ pending: (expression) => expression('status', '=', 'pending'),
66
+ approved: (expression) => expression('status', '=', 'approved'),
67
+ rejected: (expression) => expression('status', '=', 'rejected'),
68
+ revoked: (expression) => expression('status', '=', 'revoked')
69
+ }
70
+
71
+ function dateString(value: Date | string | null): string | null {
72
+ return value ? new Date(value).toISOString() : null
73
+ }
74
+ function enrollmentRecord(row: EnrollmentRow): EnrollmentRecord {
75
+ return {
76
+ id: row.id,
77
+ email: row.emailNormalized,
78
+ name: row.name,
79
+ reason: row.reason,
80
+ status: row.status,
81
+ requestedAt: dateString(row.requestedAt) ?? '',
82
+ reviewedAt: dateString(row.reviewedAt),
83
+ reviewedBy: row.reviewedBy,
84
+ reviewNote: row.reviewNote,
85
+ approvedUserId: row.approvedUserId,
86
+ requestRevision: row.requestRevision
87
+ }
88
+ }
89
+ export function normalizeEnrollmentEmail(value: string): string {
90
+ return value.trim().toLowerCase()
91
+ }
92
+
93
+ export function createEnrollmentService(
94
+ database: Kysely<CloudDatabase>,
95
+ emailOptions: EnrollmentEmailOptions = { publicURL: '', adminRecipients: [] }
96
+ ) {
97
+ const statusForEmail = async (email: string): Promise<EnrollmentStatus | null> => {
98
+ const row = await database
99
+ .selectFrom('enrollment')
100
+ .select('status')
101
+ .where('emailNormalized', '=', normalizeEnrollmentEmail(email))
102
+ .executeTakeFirst()
103
+ return row?.status ?? null
104
+ }
105
+ return {
106
+ async request(input: EnrollmentRequestInput): Promise<void> {
107
+ const emailNormalized = normalizeEnrollmentEmail(input.email)
108
+ await database.transaction().execute(async (transaction) => {
109
+ const existing = await transaction
110
+ .selectFrom('enrollment')
111
+ .selectAll()
112
+ .where('emailNormalized', '=', emailNormalized)
113
+ .forUpdate()
114
+ .executeTakeFirst()
115
+ if (existing?.status === 'approved' || existing?.status === 'pending') return
116
+ const revision = (existing?.requestRevision ?? 0) + 1
117
+ const values = {
118
+ name: input.name?.trim() || existing?.name || null,
119
+ reason: input.reason?.trim() || null,
120
+ status: 'pending' as const,
121
+ reviewedAt: null,
122
+ reviewedBy: null,
123
+ reviewNote: null,
124
+ requestRevision: revision
125
+ }
126
+ let row: EnrollmentRow
127
+ if (existing) {
128
+ row = await transaction
129
+ .updateTable('enrollment')
130
+ .set(values)
131
+ .where('id', '=', existing.id)
132
+ .returningAll()
133
+ .executeTakeFirstOrThrow()
134
+ } else {
135
+ row = await transaction
136
+ .insertInto('enrollment')
137
+ .values({
138
+ id: crypto.randomUUID(),
139
+ emailNormalized,
140
+ ...values,
141
+ approvedUserId: null
142
+ })
143
+ .returningAll()
144
+ .executeTakeFirstOrThrow()
145
+ }
146
+ await enqueueEnrollmentRequested(transaction, emailOptions, {
147
+ enrollmentId: row.id,
148
+ email: row.emailNormalized,
149
+ name: row.name ?? 'there',
150
+ reason: row.reason ?? 'No reason provided.',
151
+ revision
152
+ })
153
+ })
154
+ },
155
+ statusForEmail,
156
+ async isApproved(email: string): Promise<boolean> {
157
+ return (await statusForEmail(email)) === 'approved'
158
+ },
159
+ /** A page of requests in one status, newest first, with how many match the search in each. */
160
+ async list(query: AdminListQuery<EnrollmentStatus> = {}) {
161
+ const search = listSearch(query)
162
+ const status = query.filter ?? 'pending'
163
+ const { limit, offset } = listWindow(query)
164
+ let searched = database.selectFrom('enrollment')
165
+ if (search) {
166
+ const pattern = containsPattern(search)
167
+ searched = searched.where((expression) =>
168
+ expression.or([
169
+ expression('name', 'ilike', pattern),
170
+ expression('emailNormalized', 'ilike', pattern)
171
+ ])
172
+ )
173
+ }
174
+ const counts = await countEachFilter(searched, enrollmentStatusSchema.options, FILTERS)
175
+ const rows = await searched
176
+ .where(FILTERS[status])
177
+ .selectAll()
178
+ .orderBy('requestedAt', 'desc')
179
+ .orderBy('id', 'desc')
180
+ .limit(limit)
181
+ .offset(offset)
182
+ .execute()
183
+ // Reviewers are named by account ID; anything else names no one.
184
+ const reviewerIds = uniq(compact(rows.map((row) => row.reviewedBy))).filter(isUUID)
185
+ const reviewers = reviewerIds.length
186
+ ? await database
187
+ .selectFrom('user')
188
+ .select(['id', 'name'])
189
+ .where('id', 'in', reviewerIds)
190
+ .execute()
191
+ : []
192
+ const names = new Map(reviewers.map((reviewer) => [reviewer.id, reviewer.name]))
193
+ const enrollments = rows.map((row) => ({
194
+ ...enrollmentRecord(row),
195
+ reviewerName: row.reviewedBy ? (names.get(row.reviewedBy) ?? null) : null
196
+ }))
197
+ return { enrollments, total: counts[status], counts }
198
+ },
199
+ async review(
200
+ actorId: string,
201
+ enrollmentId: string,
202
+ status: Exclude<EnrollmentStatus, 'pending'>,
203
+ input: EnrollmentReviewInput
204
+ ): Promise<EnrollmentRecord> {
205
+ return database.transaction().execute(async (transaction) => {
206
+ const current = await transaction
207
+ .selectFrom('enrollment')
208
+ .selectAll()
209
+ .where('id', '=', enrollmentId)
210
+ .forUpdate()
211
+ .executeTakeFirstOrThrow()
212
+ if (!ALLOWED_TRANSITIONS[current.status].has(status)) {
213
+ throw new AdminDomainError(
214
+ 'invalid_enrollment_transition',
215
+ `Enrollment cannot transition from ${current.status} to ${status}`
216
+ )
217
+ }
218
+ const now = new Date()
219
+ const approvedUser =
220
+ status === 'approved'
221
+ ? await transaction
222
+ .selectFrom('user')
223
+ .select('id')
224
+ .where('email', '=', current.emailNormalized)
225
+ .executeTakeFirst()
226
+ : undefined
227
+ const row = await transaction
228
+ .updateTable('enrollment')
229
+ .set({
230
+ status,
231
+ reviewedAt: now,
232
+ reviewedBy: actorId,
233
+ reviewNote: input.note?.trim() || null,
234
+ approvedUserId: approvedUser?.id ?? current.approvedUserId
235
+ })
236
+ .where('id', '=', enrollmentId)
237
+ .where('status', '=', current.status)
238
+ .returningAll()
239
+ .executeTakeFirstOrThrow()
240
+ await transaction
241
+ .insertInto('adminAuditEvent')
242
+ .values({
243
+ id: crypto.randomUUID(),
244
+ actorUserId: actorId,
245
+ action: `enrollment.${status}`,
246
+ subjectType: 'enrollment',
247
+ subjectId: enrollmentId,
248
+ metadata: { email: row.emailNormalized },
249
+ createdAt: now
250
+ })
251
+ .execute()
252
+ await enqueueEnrollmentReview(transaction, emailOptions, {
253
+ enrollmentId,
254
+ recipientEmail: row.emailNormalized,
255
+ name: row.name ?? 'there',
256
+ status,
257
+ reviewedAt: now
258
+ })
259
+ return enrollmentRecord(row)
260
+ })
261
+ },
262
+ async bindApprovedUser(email: string, userId: string): Promise<void> {
263
+ await database
264
+ .updateTable('enrollment')
265
+ .set({ approvedUserId: userId })
266
+ .where('emailNormalized', '=', normalizeEnrollmentEmail(email))
267
+ .where('status', '=', 'approved')
268
+ .execute()
269
+ },
270
+ /**
271
+ * Moves an approved account's enrollment to the address it changed to, so the approval stays
272
+ * with the account rather than with an address it no longer uses. Any other request from the
273
+ * new address gives way to it.
274
+ */
275
+ async followEmailChange(userId: string, email: string): Promise<void> {
276
+ const emailNormalized = normalizeEnrollmentEmail(email)
277
+ await database.transaction().execute(async (transaction) => {
278
+ const approved = await transaction
279
+ .selectFrom('enrollment')
280
+ .select(['id', 'emailNormalized'])
281
+ .where('approvedUserId', '=', userId)
282
+ .where('status', '=', 'approved')
283
+ .forUpdate()
284
+ .executeTakeFirst()
285
+ if (!approved || approved.emailNormalized === emailNormalized) return
286
+ await transaction
287
+ .deleteFrom('enrollment')
288
+ .where('emailNormalized', '=', emailNormalized)
289
+ .where('id', '!=', approved.id)
290
+ .execute()
291
+ await transaction
292
+ .updateTable('enrollment')
293
+ .set({ emailNormalized })
294
+ .where('id', '=', approved.id)
295
+ .execute()
296
+ })
297
+ },
298
+ async pendingCount(): Promise<number> {
299
+ const row = await database
300
+ .selectFrom('enrollment')
301
+ .select(({ fn }) => fn.countAll<number>().as('count'))
302
+ .where('status', '=', 'pending')
303
+ .executeTakeFirstOrThrow()
304
+ return Number(row.count)
305
+ }
306
+ }
307
+ }
308
+ export type EnrollmentService = ReturnType<typeof createEnrollmentService>
@@ -0,0 +1,20 @@
1
+ export type AdminErrorCode =
2
+ | 'invalid_enrollment_transition'
3
+ | 'last_admin_required'
4
+ | 'self_admin_action_forbidden'
5
+ | 'email_regeneration_unavailable'
6
+ | 'mfa_required'
7
+
8
+ export class AdminDomainError extends Error {
9
+ override readonly name = 'AdminDomainError'
10
+ constructor(
11
+ readonly code: AdminErrorCode,
12
+ message: string
13
+ ) {
14
+ super(message)
15
+ }
16
+ }
17
+
18
+ export function adminErrorStatus(error: AdminDomainError): 400 | 409 {
19
+ return error.code === 'invalid_enrollment_transition' ? 409 : 400
20
+ }
@@ -0,0 +1,19 @@
1
+ export { adminErrorStatus, AdminDomainError, type AdminErrorCode } from './errors'
2
+ export {
3
+ createCloudAdminRoutes,
4
+ type CloudAdminRoutes,
5
+ type CloudAdminServices
6
+ } from './api/routes'
7
+ export { createAdminAuditService, type AdminAuditService } from './audit/service'
8
+ export { createAdminEmailService, type AdminEmailService } from './email/service'
9
+ export { PostgresRateLimitStore } from '#cloud/server/rate-limit'
10
+ export {
11
+ createEnrollmentService,
12
+ normalizeEnrollmentEmail,
13
+ type EnrollmentMode,
14
+ type EnrollmentRecord,
15
+ type EnrollmentService,
16
+ type EnrollmentStatus
17
+ } from './enrollment/service'
18
+ export { createAdminOperationsService, type AdminOperationsService } from './operations/service'
19
+ export { createAdminUserService, type AdminUserService } from './users/service'
@@ -0,0 +1,61 @@
1
+ import { ADMIN_LIST_MAXIMUM } from '#cloud/admin/schema'
2
+ import type { CloudDatabase } from '#cloud/server/db'
3
+ import { clamp, zipObject } from 'es-toolkit'
4
+ import type { Expression, ExpressionBuilder, SelectQueryBuilder, SqlBool } from 'kysely'
5
+
6
+ /** The rows an admin list returns when the request does not say. */
7
+ export const ADMIN_PAGE_SIZE = 50
8
+
9
+ /** What every admin list takes: words to search for, one of its filters, and a page. */
10
+ export type AdminListQuery<Filter extends string> = {
11
+ search?: string
12
+ filter?: Filter
13
+ limit?: number
14
+ offset?: number
15
+ }
16
+
17
+ /** A `like` pattern that finds `search` anywhere, matching `%`, `_`, and `\` literally. */
18
+ export function containsPattern(search: string): string {
19
+ return `%${search.replace(/[\\%_]/g, (character) => `\\${character}`)}%`
20
+ }
21
+
22
+ /** The search words, or undefined when there are none. */
23
+ export function listSearch(query: AdminListQuery<string>): string | undefined {
24
+ return query.search?.trim() || undefined
25
+ }
26
+
27
+ /** The page a query asks for, kept within what one request may return. */
28
+ export function listWindow(query: AdminListQuery<string>) {
29
+ return {
30
+ limit: clamp(query.limit ?? ADMIN_PAGE_SIZE, 1, ADMIN_LIST_MAXIMUM),
31
+ offset: Math.max(0, query.offset ?? 0)
32
+ }
33
+ }
34
+
35
+ /** A list's filters, each the condition its rows meet; the same one counts them and pages them. */
36
+ export type ListFilters<Filter extends string, Table extends keyof CloudDatabase> = Record<
37
+ Filter,
38
+ (expression: ExpressionBuilder<CloudDatabase, Table>) => Expression<SqlBool>
39
+ >
40
+
41
+ /**
42
+ * How many of `searched`'s rows meet each filter, in one query: each count is an aggregate with a
43
+ * `filter (where …)` clause rather than a query of its own.
44
+ */
45
+ export async function countEachFilter<Filter extends string, Table extends keyof CloudDatabase>(
46
+ searched: SelectQueryBuilder<CloudDatabase, Table, object>,
47
+ names: readonly Filter[],
48
+ filters: ListFilters<Filter, Table>
49
+ ): Promise<Record<Filter, number>> {
50
+ // Kysely names each column after its filter but cannot type a generic name, so the row is read
51
+ // as counts by name.
52
+ const row: Record<string, unknown> = await searched
53
+ .select((expression) =>
54
+ names.map((name) => expression.fn.countAll<number>().filterWhere(filters[name]).as(name))
55
+ )
56
+ .executeTakeFirstOrThrow()
57
+ return zipObject(
58
+ names,
59
+ names.map((name) => Number(row[name]))
60
+ )
61
+ }
@@ -0,0 +1,70 @@
1
+ import type { CloudServerConfig } from '#cloud/server/config'
2
+ import type { CloudDatabase } from '#cloud/server/db'
3
+ import type { Kysely } from 'kysely'
4
+
5
+ export function createAdminOperationsService(
6
+ database: Kysely<CloudDatabase>,
7
+ config: CloudServerConfig
8
+ ) {
9
+ async function emailCount(status: 'pending' | 'failed'): Promise<number> {
10
+ const row = await database
11
+ .selectFrom('transactionalEmail')
12
+ .select(({ fn }) => fn.countAll<number>().as('count'))
13
+ .where('status', '=', status)
14
+ .executeTakeFirstOrThrow()
15
+ return Number(row.count)
16
+ }
17
+
18
+ return {
19
+ async summary() {
20
+ const [
21
+ pendingEnrollment,
22
+ pendingEmail,
23
+ failedEmail,
24
+ accounts,
25
+ workspaces,
26
+ documents,
27
+ stored
28
+ ] = await Promise.all([
29
+ database
30
+ .selectFrom('enrollment')
31
+ .select(({ fn }) => fn.countAll<number>().as('count'))
32
+ .where('status', '=', 'pending')
33
+ .executeTakeFirstOrThrow(),
34
+ emailCount('pending'),
35
+ emailCount('failed'),
36
+ database
37
+ .selectFrom('user')
38
+ .select(({ fn }) => fn.countAll<number>().as('count'))
39
+ .executeTakeFirstOrThrow(),
40
+ database
41
+ .selectFrom('workspace')
42
+ .select(({ fn }) => fn.countAll<number>().as('count'))
43
+ .executeTakeFirstOrThrow(),
44
+ database
45
+ .selectFrom('document')
46
+ .select(({ fn }) => fn.countAll<number>().as('count'))
47
+ .where('deletedAt', 'is', null)
48
+ .executeTakeFirstOrThrow(),
49
+ database
50
+ .selectFrom('workspaceStorageUsage')
51
+ .select(({ fn }) => fn.sum<number | null>('committedBytes').as('bytes'))
52
+ .executeTakeFirstOrThrow()
53
+ ])
54
+ return {
55
+ deployment: config.deployment,
56
+ enrollmentMode: config.enrollmentMode,
57
+ emailTransport: config.emailTransport,
58
+ pendingEnrollment: Number(pendingEnrollment.count),
59
+ pendingEmail,
60
+ failedEmail,
61
+ accounts: Number(accounts.count),
62
+ workspaces: Number(workspaces.count),
63
+ documents: Number(documents.count),
64
+ storedBytes: Number(stored.bytes ?? 0)
65
+ }
66
+ }
67
+ }
68
+ }
69
+
70
+ export type AdminOperationsService = ReturnType<typeof createAdminOperationsService>
@@ -0,0 +1,28 @@
1
+ import * as v from 'valibot'
2
+
3
+ const uuidSchema = v.pipe(v.string(), v.uuid())
4
+ /** Accounts and access requests are named by UUID; anything else names no row. */
5
+ export const isUUID = (value: string) => v.is(uuidSchema, value)
6
+
7
+ /** The most rows one admin list request returns. */
8
+ export const ADMIN_LIST_MAXIMUM = 500
9
+
10
+ export const enrollmentStatusSchema = v.picklist(['pending', 'approved', 'rejected', 'revoked'])
11
+ export const enrollmentReviewSchema = v.object({
12
+ note: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(1000)))
13
+ })
14
+ export const userRoleMutationSchema = v.object({
15
+ userId: v.pipe(v.string(), v.trim(), v.minLength(1)),
16
+ enabled: v.boolean()
17
+ })
18
+
19
+ export const userMutationSchema = v.object({
20
+ userId: v.pipe(v.string(), v.trim(), v.minLength(1)),
21
+ reason: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(500)))
22
+ })
23
+
24
+ export type EnrollmentReview = v.InferOutput<typeof enrollmentReviewSchema>
25
+
26
+ export const parseEnrollmentReview = (input: unknown) => v.parse(enrollmentReviewSchema, input)
27
+ export const parseUserMutation = (input: unknown) => v.parse(userMutationSchema, input)
28
+ export const parseUserRoleMutation = (input: unknown) => v.parse(userRoleMutationSchema, input)