@open-pencil/cloud 0.0.0-stage → 0.16.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 (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
package/package.json CHANGED
@@ -1,6 +1,126 @@
1
1
  {
2
2
  "name": "@open-pencil/cloud",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.16.0",
4
+ "license": "Apache-2.0 AND MIT",
5
+ "files": [
6
+ "dist",
7
+ "src",
8
+ "NOTICE",
9
+ "README.md",
10
+ "LICENSE-MIT"
11
+ ],
12
+ "bin": {
13
+ "openpencil-ai-relay": "./dist/bin/ai-relay.mjs",
14
+ "openpencil-cloud": "./dist/bin/server.mjs"
15
+ },
16
+ "dependencies": {
17
+ "@aws-sdk/client-s3": "^3.1149.0",
18
+ "@aws-sdk/s3-request-presigner": "^3.1149.0",
19
+ "@better-auth/core": "1.7.7",
20
+ "@better-auth/passkey": "1.7.7",
21
+ "@better-auth/utils": "0.4.2",
22
+ "@hono/node-server": "^1.19.17",
23
+ "@internationalized/date": "^3.12.3",
24
+ "@noble/hashes": "^2.4.0",
25
+ "@open-pencil/scene-graph": "^0.16.0",
26
+ "@openfeature/server-sdk": "^1.23.0",
27
+ "@vue-email/components": "^0.0.21",
28
+ "@vue-email/render": "^0.0.9",
29
+ "better-auth": "1.7.7",
30
+ "bowser": "^2.14.1",
31
+ "dedent": "^1.7.2",
32
+ "es-toolkit": "^1.52.0",
33
+ "fflate": "^0.8.3",
34
+ "hono": "^4.13.13",
35
+ "hono-rate-limiter": "^0.5.3",
36
+ "image-size": "^2.0.4",
37
+ "jose": "^6.2.8",
38
+ "js-base64": "^3.9.3",
39
+ "kysely": "^0.29.6",
40
+ "lib0": "^0.2.117",
41
+ "nodemailer": "^9.0.5",
42
+ "smol-toml": "^1.8.0",
43
+ "ufo": "^1.6.4",
44
+ "valibot": "^1.5.0",
45
+ "vue": "^3.5.43",
46
+ "ws": "^8.21.3",
47
+ "yjs": "^13.6.32"
48
+ },
49
+ "optionalDependencies": {
50
+ "pg": "^8.23.0"
51
+ },
52
+ "exports": {
53
+ "./contract": {
54
+ "types": "./dist/contract.d.ts",
55
+ "bun": "./src/contract/index.ts",
56
+ "import": "./dist/contract.js",
57
+ "default": "./dist/contract.js"
58
+ },
59
+ "./client": {
60
+ "types": "./dist/client.d.ts",
61
+ "bun": "./src/client/index.ts",
62
+ "import": "./dist/client.js",
63
+ "default": "./dist/client.js"
64
+ },
65
+ "./email": {
66
+ "types": "./dist/email.d.ts",
67
+ "bun": "./src/email/index.ts",
68
+ "import": "./dist/email.js",
69
+ "default": "./dist/email.js"
70
+ },
71
+ "./runtime/node": {
72
+ "types": "./dist/runtime-node.d.mts",
73
+ "bun": "./src/runtime/node/index.ts",
74
+ "import": "./dist/runtime-node.mjs",
75
+ "default": "./dist/runtime-node.mjs"
76
+ },
77
+ "./server": {
78
+ "types": "./dist/server.d.ts",
79
+ "bun": "./src/server/index.ts",
80
+ "import": "./dist/server.js",
81
+ "default": "./dist/server.js"
82
+ }
83
+ },
84
+ "imports": {
85
+ "#cloud/admin": "./src/admin/index.ts",
86
+ "#cloud/ai-relay": "./src/ai-relay/index.ts",
87
+ "#cloud/client": "./src/client/index.ts",
88
+ "#cloud/contract": "./src/contract/index.ts",
89
+ "#cloud/email": "./src/email/index.ts",
90
+ "#cloud/runtime/cloudflare": "./src/runtime/cloudflare/index.ts",
91
+ "#cloud/runtime/node": "./src/runtime/node/index.ts",
92
+ "#cloud/server": "./src/server/index.ts",
93
+ "#cloud/server/ai": "./src/server/ai/index.ts",
94
+ "#cloud/server/api": "./src/server/api/index.ts",
95
+ "#cloud/server/auth": "./src/server/auth/index.ts",
96
+ "#cloud/server/cleanup": "./src/server/cleanup/index.ts",
97
+ "#cloud/server/collaboration": "./src/server/collaboration/index.ts",
98
+ "#cloud/server/config": "./src/server/config/index.ts",
99
+ "#cloud/server/db": "./src/server/db/index.ts",
100
+ "#cloud/server/documents": "./src/server/documents/index.ts",
101
+ "#cloud/server/documents/versions": "./src/server/documents/versions/index.ts",
102
+ "#cloud/server/email": "./src/server/email/index.ts",
103
+ "#cloud/server/internal": "./src/server/internal/index.ts",
104
+ "#cloud/server/invitations": "./src/server/invitations/index.ts",
105
+ "#cloud/server/objects": "./src/server/objects/index.ts",
106
+ "#cloud/server/pictures": "./src/server/pictures/index.ts",
107
+ "#cloud/server/policy": "./src/server/policy/index.ts",
108
+ "#cloud/server/quota": "./src/server/quota/index.ts",
109
+ "#cloud/server/rate-limit": "./src/server/rate-limit/index.ts",
110
+ "#cloud/server/sharing": "./src/server/sharing/index.ts",
111
+ "#cloud/server/workspaces": "./src/server/workspaces/index.ts",
112
+ "#cloud/*": "./src/*.ts",
113
+ "#cloud-tests/*": "./tests/*.ts"
114
+ },
115
+ "description": "Self-hostable OpenPencil Cloud: accounts, workspaces, document revisions, sharing, collaboration, and the AI relay, for Node and Cloudflare Workers.",
116
+ "repository": {
117
+ "type": "git",
118
+ "url": "git+https://github.com/open-pencil/open-pencil.git",
119
+ "directory": "packages/cloud"
120
+ },
121
+ "type": "module",
122
+ "sideEffects": false,
123
+ "engines": {
124
+ "node": ">=22"
125
+ }
126
+ }
@@ -0,0 +1,223 @@
1
+ import { requireTrustedMutationOrigin } from '#cloud/admin/api/security'
2
+ import type { AdminAuditService } from '#cloud/admin/audit/service'
3
+ import type { AdminEmailService } from '#cloud/admin/email/service'
4
+ import type { EnrollmentService } from '#cloud/admin/enrollment/service'
5
+ import { adminErrorStatus, AdminDomainError } from '#cloud/admin/errors'
6
+ import type { AdminOperationsService } from '#cloud/admin/operations/service'
7
+ import {
8
+ enrollmentStatusSchema,
9
+ parseEnrollmentReview,
10
+ parseUserMutation,
11
+ parseUserRoleMutation
12
+ } from '#cloud/admin/schema'
13
+ import type { AdminUserService } from '#cloud/admin/users/service'
14
+ import {
15
+ cloudAdminAuditFilterSchema,
16
+ cloudAdminEmailFilterSchema,
17
+ cloudAdminUserFilterSchema
18
+ } from '#cloud/contract'
19
+ import type { CloudAPIEnvironment } from '#cloud/server/api'
20
+ import type { CloudAuthAdapter } from '#cloud/server/auth'
21
+ import type { CloudDatabase } from '#cloud/server/db'
22
+ import { CLOUD_RATE_LIMITS, createActorRateLimiter } from '#cloud/server/rate-limit'
23
+ import { validatedJSON, validatedQuery } from '#cloud/server/validation'
24
+ import { Hono, type Context } from 'hono'
25
+ import { NoResultError, type Kysely } from 'kysely'
26
+ import * as v from 'valibot'
27
+
28
+ /**
29
+ * A count from the query string; anything but digits, or a number too large to be exact, is a bad
30
+ * request rather than a NaN or out-of-range query.
31
+ */
32
+ const countSchema = v.optional(v.pipe(v.string(), v.digits(), v.toNumber(), v.safeInteger()))
33
+ /** What an admin list reads from its query string: a search, one of `filters`, and a page. */
34
+ function listQuery<const Filter extends string>(filters: v.PicklistSchema<Filter[], undefined>) {
35
+ const schema = v.object({
36
+ search: v.optional(v.string()),
37
+ filter: v.optional(filters),
38
+ limit: countSchema,
39
+ offset: countSchema
40
+ })
41
+ return (input: unknown) => v.parse(schema, input)
42
+ }
43
+ const parseEnrollmentQuery = listQuery(enrollmentStatusSchema)
44
+ const parseUserQuery = listQuery(cloudAdminUserFilterSchema)
45
+ const parseEmailQuery = listQuery(cloudAdminEmailFilterSchema)
46
+ const parseAuditQuery = listQuery(cloudAdminAuditFilterSchema)
47
+ /** Accounts are named by UUID; anything else names no one, rather than failing the query. */
48
+ const accountIdSchema = v.pipe(v.string(), v.uuid())
49
+
50
+ /** Does what an administrator asked to another account; one that is not an account is not found. */
51
+ async function accountMutation(
52
+ context: Context<CloudAPIEnvironment>,
53
+ userId: string,
54
+ mutate: (actorId: string, userId: string) => Promise<void>
55
+ ) {
56
+ if (!v.is(accountIdSchema, userId)) {
57
+ return context.json({ error: { code: 'not_found' as const } }, 404)
58
+ }
59
+ await mutate(context.get('actor').userId, userId)
60
+ return context.json({ ok: true as const })
61
+ }
62
+
63
+ export type CloudAdminServices = {
64
+ email: AdminEmailService
65
+ enrollment: EnrollmentService
66
+ users: AdminUserService
67
+ audit: AdminAuditService
68
+ operations: AdminOperationsService
69
+ }
70
+
71
+ export function createCloudAdminRoutes(
72
+ services: CloudAdminServices,
73
+ trustedOrigins: ReadonlySet<string>,
74
+ security: {
75
+ auth: CloudAuthAdapter
76
+ database: Kysely<CloudDatabase>
77
+ requireMFA: boolean
78
+ secret: string
79
+ }
80
+ ) {
81
+ const adminRead = createActorRateLimiter(
82
+ security.database,
83
+ security.secret,
84
+ CLOUD_RATE_LIMITS.adminRead,
85
+ (context) => context.req.method !== 'GET'
86
+ )
87
+ const adminMutation = createActorRateLimiter(
88
+ security.database,
89
+ security.secret,
90
+ CLOUD_RATE_LIMITS.adminMutation,
91
+ (context) => context.req.method === 'GET'
92
+ )
93
+ return new Hono<CloudAPIEnvironment>()
94
+ .use('*', requireTrustedMutationOrigin(trustedOrigins))
95
+ .use('*', async (context, next) => {
96
+ const actor = context.get('actor')
97
+ if (actor.deploymentRole !== 'admin') {
98
+ return context.json({ error: { code: 'forbidden' as const } }, 403)
99
+ }
100
+ if (security.requireMFA) {
101
+ const status = await security.auth.mfaStatus(context.req.raw.headers)
102
+ if (!status?.assured) {
103
+ return context.json({ error: { code: 'mfa_required' as const } }, 403)
104
+ }
105
+ }
106
+ return next()
107
+ })
108
+ .use('*', adminRead)
109
+ .use('*', adminMutation)
110
+ .onError((error, context) => {
111
+ if (error instanceof AdminDomainError) {
112
+ return context.json({ error: { code: error.code } }, adminErrorStatus(error))
113
+ }
114
+ if (error instanceof v.ValiError) {
115
+ return context.json({ error: { code: 'invalid_request' as const } }, 400)
116
+ }
117
+ // An enrollment or message ID that names nothing.
118
+ if (error instanceof NoResultError) {
119
+ return context.json({ error: { code: 'not_found' as const } }, 404)
120
+ }
121
+ throw error
122
+ })
123
+ .get('/enrollments', validatedQuery(parseEnrollmentQuery), async (context) =>
124
+ context.json(await services.enrollment.list(context.req.valid('query')))
125
+ )
126
+ .post('/enrollments/:id/approve', validatedJSON(parseEnrollmentReview), async (context) =>
127
+ context.json({
128
+ enrollment: await services.enrollment.review(
129
+ context.get('actor').userId,
130
+ context.req.param('id'),
131
+ 'approved',
132
+ context.req.valid('json')
133
+ )
134
+ })
135
+ )
136
+ .post('/enrollments/:id/reject', validatedJSON(parseEnrollmentReview), async (context) =>
137
+ context.json({
138
+ enrollment: await services.enrollment.review(
139
+ context.get('actor').userId,
140
+ context.req.param('id'),
141
+ 'rejected',
142
+ context.req.valid('json')
143
+ )
144
+ })
145
+ )
146
+ .post('/enrollments/:id/revoke', validatedJSON(parseEnrollmentReview), async (context) =>
147
+ context.json({
148
+ enrollment: await services.enrollment.review(
149
+ context.get('actor').userId,
150
+ context.req.param('id'),
151
+ 'revoked',
152
+ context.req.valid('json')
153
+ )
154
+ })
155
+ )
156
+ .get('/users', validatedQuery(parseUserQuery), async (context) =>
157
+ context.json(await services.users.list(context.req.valid('query')))
158
+ )
159
+ .get('/users/:id', async (context) => {
160
+ const id = context.req.param('id')
161
+ const detail = v.is(accountIdSchema, id) ? await services.users.detail(id) : null
162
+ if (!detail) return context.json({ error: { code: 'not_found' as const } }, 404)
163
+ return context.json(detail)
164
+ })
165
+ .post('/users/reset-two-step', validatedJSON(parseUserMutation), (context) =>
166
+ accountMutation(context, context.req.valid('json').userId, (actorId, userId) =>
167
+ services.users.resetTwoStep(actorId, userId)
168
+ )
169
+ )
170
+ .post('/users/remove-picture', validatedJSON(parseUserMutation), (context) =>
171
+ accountMutation(context, context.req.valid('json').userId, (actorId, userId) =>
172
+ services.users.removePicture(actorId, userId)
173
+ )
174
+ )
175
+ .post('/users/ban', validatedJSON(parseUserMutation), async (context) => {
176
+ const input = context.req.valid('json')
177
+ await services.users.ban(
178
+ context.req.raw.headers,
179
+ context.get('actor').userId,
180
+ input.userId,
181
+ input.reason
182
+ )
183
+ return context.json({ ok: true as const })
184
+ })
185
+ .post('/users/unban', validatedJSON(parseUserMutation), async (context) => {
186
+ const input = context.req.valid('json')
187
+ await services.users.unban(context.req.raw.headers, context.get('actor').userId, input.userId)
188
+ return context.json({ ok: true as const })
189
+ })
190
+ .post('/users/revoke-sessions', validatedJSON(parseUserMutation), async (context) => {
191
+ const input = context.req.valid('json')
192
+ await services.users.revokeSessions(
193
+ context.req.raw.headers,
194
+ context.get('actor').userId,
195
+ input.userId
196
+ )
197
+ return context.json({ ok: true as const })
198
+ })
199
+ .post('/users/set-admin', validatedJSON(parseUserRoleMutation), async (context) => {
200
+ const input = context.req.valid('json')
201
+ await services.users.setAdmin(
202
+ context.req.raw.headers,
203
+ context.get('actor').userId,
204
+ input.userId,
205
+ input.enabled
206
+ )
207
+ return context.json({ ok: true as const })
208
+ })
209
+ .get('/email', validatedQuery(parseEmailQuery), async (context) =>
210
+ context.json(await services.email.list(context.req.valid('query')))
211
+ )
212
+ .post('/email/:id/regenerate', async (context) => {
213
+ await services.email.regenerate(context.get('actor').userId, context.req.param('id'))
214
+ return context.json({ ok: true as const })
215
+ })
216
+ .get('/audit', validatedQuery(parseAuditQuery), async (context) =>
217
+ context.json(await services.audit.list(context.req.valid('query')))
218
+ )
219
+ .get('/operations', async (context) => context.json(await services.operations.summary()))
220
+ }
221
+
222
+ /** The administration routes' types, for the portal's typed client. */
223
+ export type CloudAdminRoutes = ReturnType<typeof createCloudAdminRoutes>
@@ -0,0 +1,12 @@
1
+ import type { Context, Next } from 'hono'
2
+
3
+ export function requireTrustedMutationOrigin(trustedOrigins: ReadonlySet<string>) {
4
+ return async (context: Context, next: Next) => {
5
+ if (!['POST', 'PUT', 'PATCH', 'DELETE'].includes(context.req.method)) return next()
6
+ const origin = context.req.header('origin')
7
+ if (!origin || !trustedOrigins.has(origin)) {
8
+ return context.json({ error: { code: 'forbidden' as const } }, 403)
9
+ }
10
+ return next()
11
+ }
12
+ }
@@ -0,0 +1,138 @@
1
+ import {
2
+ containsPattern,
3
+ countEachFilter,
4
+ listSearch,
5
+ listWindow,
6
+ type AdminListQuery,
7
+ type ListFilters
8
+ } from '#cloud/admin/list'
9
+ import { isUUID } from '#cloud/admin/schema'
10
+ import { cloudAdminAuditFilterSchema, type CloudAdminAuditFilter } from '#cloud/contract'
11
+ import type { CloudDatabase } from '#cloud/server/db'
12
+ import { uniq } from 'es-toolkit'
13
+ import type { ExpressionBuilder, Kysely } from 'kysely'
14
+
15
+ /** Events by what they are about; every event is under `all`. */
16
+ const FILTERS: ListFilters<CloudAdminAuditFilter, 'adminAuditEvent'> = {
17
+ all: (expression) => expression.lit(true),
18
+ accounts: (expression) => expression('adminAuditEvent.subjectType', '=', 'user'),
19
+ requests: (expression) => expression('adminAuditEvent.subjectType', '=', 'enrollment'),
20
+ email: (expression) => expression('adminAuditEvent.subjectType', '=', 'transactional-email')
21
+ }
22
+
23
+ type AuditExpression = ExpressionBuilder<CloudDatabase, 'adminAuditEvent'>
24
+
25
+ /** Events whose actor, or the account or request they are about, has `pattern` in a name or email. */
26
+ function searchCondition(pattern: string) {
27
+ return (expression: AuditExpression) => {
28
+ const account = (column: 'adminAuditEvent.actorUserId' | 'adminAuditEvent.subjectId') =>
29
+ expression.exists(
30
+ expression
31
+ .selectFrom('user')
32
+ .select('user.id')
33
+ .where((inner) => inner(inner.cast('user.id', 'text'), '=', inner.ref(column)))
34
+ .where((inner) =>
35
+ inner.or([inner('user.name', 'ilike', pattern), inner('user.email', 'ilike', pattern)])
36
+ )
37
+ )
38
+ return expression.or([
39
+ account('adminAuditEvent.actorUserId'),
40
+ expression.and([
41
+ expression('adminAuditEvent.subjectType', '=', 'user'),
42
+ account('adminAuditEvent.subjectId')
43
+ ]),
44
+ expression.and([
45
+ expression('adminAuditEvent.subjectType', '=', 'enrollment'),
46
+ expression.exists(
47
+ expression
48
+ .selectFrom('enrollment')
49
+ .select('enrollment.id')
50
+ .where((inner) =>
51
+ inner(
52
+ inner.cast('enrollment.id', 'text'),
53
+ '=',
54
+ inner.ref('adminAuditEvent.subjectId')
55
+ )
56
+ )
57
+ .where((inner) =>
58
+ inner.or([
59
+ inner('enrollment.name', 'ilike', pattern),
60
+ inner('enrollment.emailNormalized', 'ilike', pattern)
61
+ ])
62
+ )
63
+ )
64
+ ])
65
+ ])
66
+ }
67
+ }
68
+
69
+ export function createAdminAuditService(database: Kysely<CloudDatabase>) {
70
+ return {
71
+ /**
72
+ * A page of events, newest first, each with its actor's and subject's names while the server
73
+ * knows them, and how many match the search under each filter.
74
+ */
75
+ async list(query: AdminListQuery<CloudAdminAuditFilter> = {}) {
76
+ const search = listSearch(query)
77
+ const filter = query.filter ?? 'all'
78
+ const { limit, offset } = listWindow(query)
79
+ let searched = database.selectFrom('adminAuditEvent')
80
+ if (search) searched = searched.where(searchCondition(containsPattern(search)))
81
+ const counts = await countEachFilter(searched, cloudAdminAuditFilterSchema.options, FILTERS)
82
+ const events = await searched
83
+ .where(FILTERS[filter])
84
+ .selectAll()
85
+ .orderBy('createdAt', 'desc')
86
+ .orderBy('id', 'desc')
87
+ .limit(limit)
88
+ .offset(offset)
89
+ .execute()
90
+ // Accounts and requests are named by UUID; anything else is not looked up.
91
+ const userIds = uniq(
92
+ events.flatMap((event) =>
93
+ event.subjectType === 'user' ? [event.actorUserId, event.subjectId] : [event.actorUserId]
94
+ )
95
+ ).filter(isUUID)
96
+ const enrollmentIds = uniq(
97
+ events.flatMap((event) => (event.subjectType === 'enrollment' ? [event.subjectId] : []))
98
+ ).filter(isUUID)
99
+ const [users, enrollments] = await Promise.all([
100
+ userIds.length
101
+ ? database.selectFrom('user').select(['id', 'name']).where('id', 'in', userIds).execute()
102
+ : [],
103
+ enrollmentIds.length
104
+ ? database
105
+ .selectFrom('enrollment')
106
+ .select(['id', 'name', 'emailNormalized'])
107
+ .where('id', 'in', enrollmentIds)
108
+ .execute()
109
+ : []
110
+ ])
111
+ const names = new Map(users.map((user) => [user.id, user.name]))
112
+ const requesters = new Map(
113
+ enrollments.map((enrollment) => [
114
+ enrollment.id,
115
+ enrollment.name ?? enrollment.emailNormalized
116
+ ])
117
+ )
118
+ const rows = events.map((event) => ({
119
+ id: event.id,
120
+ actor: { id: event.actorUserId, name: names.get(event.actorUserId) ?? null },
121
+ action: event.action,
122
+ subject: {
123
+ type: event.subjectType,
124
+ id: event.subjectId,
125
+ name:
126
+ (event.subjectType === 'enrollment'
127
+ ? requesters.get(event.subjectId)
128
+ : names.get(event.subjectId)) ?? null
129
+ },
130
+ metadata: event.metadata,
131
+ createdAt: event.createdAt
132
+ }))
133
+ return { events: rows, total: counts[filter], counts }
134
+ }
135
+ }
136
+ }
137
+
138
+ export type AdminAuditService = ReturnType<typeof createAdminAuditService>
@@ -0,0 +1,140 @@
1
+ import type { EnrollmentStatus } from '#cloud/admin/enrollment/service'
2
+ import { AdminDomainError } from '#cloud/admin/errors'
3
+ import {
4
+ containsPattern,
5
+ countEachFilter,
6
+ listSearch,
7
+ listWindow,
8
+ type AdminListQuery,
9
+ type ListFilters
10
+ } from '#cloud/admin/list'
11
+ import { cloudAdminEmailFilterSchema, type CloudAdminEmailFilter } from '#cloud/contract'
12
+ import type { CloudDatabase } from '#cloud/server/db'
13
+ import type { TransactionalEmailService } from '#cloud/server/email'
14
+ import type { Kysely } from 'kysely'
15
+
16
+ /** The enrollment status each message describes; a message is resent only while it still holds. */
17
+ const ENROLLMENT_MESSAGE_STATUS: Partial<Record<string, EnrollmentStatus>> = {
18
+ 'enrollment-requested': 'pending',
19
+ 'enrollment-approved': 'approved',
20
+ 'enrollment-rejected': 'rejected',
21
+ 'enrollment-revoked': 'revoked'
22
+ }
23
+
24
+ /** Messages by how their delivery went; every message is under `all`. */
25
+ const FILTERS: ListFilters<CloudAdminEmailFilter, 'transactionalEmail'> = {
26
+ all: (expression) => expression.lit(true),
27
+ sent: (expression) => expression('status', '=', 'accepted'),
28
+ waiting: (expression) => expression('status', 'in', ['pending', 'sending']),
29
+ failed: (expression) => expression('status', '=', 'failed')
30
+ }
31
+
32
+ export function createAdminEmailService(
33
+ database: Kysely<CloudDatabase>,
34
+ email?: TransactionalEmailService,
35
+ links: { publicURL: string } = { publicURL: '' }
36
+ ) {
37
+ return {
38
+ /** A page of messages, newest first, with how many match the search under each filter. */
39
+ async list(query: AdminListQuery<CloudAdminEmailFilter> = {}) {
40
+ const search = listSearch(query)
41
+ const filter = query.filter ?? 'all'
42
+ const { limit, offset } = listWindow(query)
43
+ let searched = database.selectFrom('transactionalEmail')
44
+ if (search) {
45
+ searched = searched.where('recipientEmailNormalized', 'ilike', containsPattern(search))
46
+ }
47
+ const counts = await countEachFilter(searched, cloudAdminEmailFilterSchema.options, FILTERS)
48
+ const rows = await searched
49
+ .where(FILTERS[filter])
50
+ .select([
51
+ 'id',
52
+ 'kind',
53
+ 'recipientEmailNormalized',
54
+ 'status',
55
+ 'attemptCount',
56
+ 'nextAttemptAt',
57
+ 'transport',
58
+ 'transportMessageId',
59
+ 'lastErrorCode',
60
+ 'createdAt',
61
+ 'acceptedAt'
62
+ ])
63
+ .orderBy('createdAt', 'desc')
64
+ .orderBy('id', 'desc')
65
+ .limit(limit)
66
+ .offset(offset)
67
+ .execute()
68
+ return {
69
+ messages: rows.map((row) => ({
70
+ ...row,
71
+ regeneratable: row.kind.startsWith('enrollment-')
72
+ })),
73
+ total: counts[filter],
74
+ counts
75
+ }
76
+ },
77
+ async regenerate(actorId: string, messageId: string): Promise<void> {
78
+ if (!email)
79
+ throw new AdminDomainError('email_regeneration_unavailable', 'Email delivery is disabled')
80
+ await database.transaction().execute(async (transaction) => {
81
+ const original = await transaction
82
+ .selectFrom('transactionalEmail')
83
+ .select(['id', 'kind', 'recipientEmailNormalized'])
84
+ .where('id', '=', messageId)
85
+ .executeTakeFirstOrThrow()
86
+ if (
87
+ !original.kind.startsWith('enrollment-') ||
88
+ original.kind === 'admin-enrollment-notification'
89
+ ) {
90
+ throw new AdminDomainError(
91
+ 'email_regeneration_unavailable',
92
+ 'This message cannot be regenerated'
93
+ )
94
+ }
95
+ const kind = original.kind
96
+ const enrollment = await transaction
97
+ .selectFrom('enrollment')
98
+ .selectAll()
99
+ .where('emailNormalized', '=', original.recipientEmailNormalized)
100
+ .executeTakeFirst()
101
+ if (!enrollment)
102
+ throw new AdminDomainError('email_regeneration_unavailable', 'Enrollment is unavailable')
103
+ if (ENROLLMENT_MESSAGE_STATUS[kind] !== enrollment.status) {
104
+ throw new AdminDomainError(
105
+ 'email_regeneration_unavailable',
106
+ 'The enrollment no longer matches this message'
107
+ )
108
+ }
109
+ await email.enqueue(
110
+ {
111
+ idempotencyKey: `admin-regeneration/${messageId}/${crypto.randomUUID()}`,
112
+ kind,
113
+ recipientEmail: enrollment.emailNormalized,
114
+ payload: {
115
+ name: enrollment.name ?? 'there',
116
+ actionURL:
117
+ kind === 'enrollment-approved'
118
+ ? links.publicURL
119
+ : new URL('/auth/sign-in', links.publicURL).href
120
+ }
121
+ },
122
+ transaction
123
+ )
124
+ await transaction
125
+ .insertInto('adminAuditEvent')
126
+ .values({
127
+ id: crypto.randomUUID(),
128
+ actorUserId: actorId,
129
+ action: 'email.regenerated',
130
+ subjectType: 'transactional-email',
131
+ subjectId: messageId,
132
+ metadata: { replacementKind: kind }
133
+ })
134
+ .execute()
135
+ })
136
+ }
137
+ }
138
+ }
139
+
140
+ export type AdminEmailService = ReturnType<typeof createAdminEmailService>