@open-pencil/cloud 0.17.0-beta.2 → 0.17.0-beta.5

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 (339) hide show
  1. package/README.md +3 -2
  2. package/dist/bin/server.mjs +1 -1
  3. package/dist/bin/server.mjs.map +1 -1
  4. package/dist/bin/{ai-relay.mjs → services.mjs} +9 -9
  5. package/dist/bin/services.mjs.map +1 -0
  6. package/dist/client.d.ts +525 -66
  7. package/dist/client.d.ts.map +1 -1
  8. package/dist/client.js +1257 -654
  9. package/dist/client.js.map +1 -1
  10. package/dist/contract.d.ts +2 -2
  11. package/dist/contract.js +2 -2
  12. package/dist/contract2.js +1028 -481
  13. package/dist/contract2.js.map +1 -1
  14. package/dist/email.d.ts +1780 -31
  15. package/dist/email.d.ts.map +1 -1
  16. package/dist/email.js +3556 -325
  17. package/dist/email.js.map +1 -1
  18. package/dist/errors.d.ts +2 -0
  19. package/dist/errors.js +48 -0
  20. package/dist/errors.js.map +1 -0
  21. package/dist/index.d.ts +929 -72
  22. package/dist/index.d.ts.map +1 -1
  23. package/dist/index2.d.ts +35 -0
  24. package/dist/index2.d.ts.map +1 -0
  25. package/dist/listen.mjs +802 -927
  26. package/dist/listen.mjs.map +1 -1
  27. package/dist/runtime-cloudflare.d.ts +89 -0
  28. package/dist/runtime-cloudflare.d.ts.map +1 -0
  29. package/dist/runtime-cloudflare.js +15667 -0
  30. package/dist/runtime-cloudflare.js.map +1 -0
  31. package/dist/runtime-node.d.mts +7166 -3101
  32. package/dist/runtime-node.d.mts.map +1 -1
  33. package/dist/runtime-node.mjs +6 -5
  34. package/dist/runtime-node.mjs.map +1 -1
  35. package/dist/server.d.ts +6525 -2205
  36. package/dist/server.d.ts.map +1 -1
  37. package/dist/server.js +12500 -7613
  38. package/dist/server.js.map +1 -1
  39. package/dist/server.mjs +8625 -2878
  40. package/dist/server.mjs.map +1 -1
  41. package/dist/server2.mjs +101 -79
  42. package/dist/server2.mjs.map +1 -1
  43. package/package.json +27 -9
  44. package/src/admin/api/routes.ts +59 -0
  45. package/src/admin/audit/service.ts +27 -8
  46. package/src/admin/documents/service.ts +431 -0
  47. package/src/admin/errors.ts +9 -1
  48. package/src/admin/index.ts +6 -0
  49. package/src/admin/operations/service.ts +7 -0
  50. package/src/admin/reports/service.ts +153 -0
  51. package/src/admin/schema.ts +6 -0
  52. package/src/client/api.ts +28 -461
  53. package/src/client/auth/client.ts +22 -3
  54. package/src/client/auth/navigation.ts +6 -5
  55. package/src/client/billing.ts +80 -0
  56. package/src/client/community.ts +40 -0
  57. package/src/client/discovery.ts +35 -9
  58. package/src/client/documents.ts +160 -0
  59. package/src/client/index.ts +14 -7
  60. package/src/client/portal/account.ts +79 -2
  61. package/src/client/portal/administration.ts +56 -0
  62. package/src/client/portal/request.ts +2 -0
  63. package/src/client/response.ts +21 -0
  64. package/src/client/schema.ts +8 -0
  65. package/src/client/services.ts +118 -0
  66. package/src/client/sharing.ts +262 -0
  67. package/src/client/versions.ts +104 -0
  68. package/src/contract/account.ts +108 -2
  69. package/src/contract/admin/index.ts +67 -3
  70. package/src/contract/billing.ts +166 -0
  71. package/src/contract/collaboration.ts +11 -1
  72. package/src/contract/community.ts +60 -0
  73. package/src/contract/discovery.ts +83 -4
  74. package/src/contract/documents.ts +27 -0
  75. package/src/contract/entitlements.ts +12 -2
  76. package/src/contract/index.ts +114 -39
  77. package/src/contract/links.ts +57 -4
  78. package/src/contract/locale.ts +27 -0
  79. package/src/contract/portal.ts +12 -1
  80. package/src/contract/relay.ts +6 -0
  81. package/src/contract/reports.ts +42 -0
  82. package/src/contract/routes.ts +10 -0
  83. package/src/contract/services.ts +235 -0
  84. package/src/contract/sharing.ts +3 -9
  85. package/src/email/i18n.ts +174 -0
  86. package/src/email/index.ts +13 -2
  87. package/src/email/locales/ar.json +141 -0
  88. package/src/email/locales/de.json +141 -0
  89. package/src/email/locales/es.json +141 -0
  90. package/src/email/locales/fr.json +141 -0
  91. package/src/email/locales/it.json +141 -0
  92. package/src/email/locales/ja.json +141 -0
  93. package/src/email/locales/pl.json +141 -0
  94. package/src/email/locales/pt-br.json +141 -0
  95. package/src/email/locales/ru.json +141 -0
  96. package/src/email/locales/zh-cn.json +141 -0
  97. package/src/email/messages.ts +200 -0
  98. package/src/email/render.ts +138 -246
  99. package/src/email/samples.ts +115 -0
  100. package/src/email/schema.ts +79 -5
  101. package/src/email/templates/BrandEmail.vue +54 -0
  102. package/src/email/templates/DocumentBlocked.vue +45 -0
  103. package/src/email/templates/DocumentInvitation.vue +24 -0
  104. package/src/email/templates/DocumentReport.vue +32 -0
  105. package/src/email/templates/DocumentReportDecided.vue +36 -0
  106. package/src/email/templates/DocumentReportReceived.vue +18 -0
  107. package/src/email/templates/DocumentRestored.vue +24 -0
  108. package/src/email/templates/EmailChangeRequested.vue +24 -0
  109. package/src/email/templates/EmailRoot.vue +19 -0
  110. package/src/email/templates/EmailText.vue +9 -0
  111. package/src/email/templates/EmailVerification.vue +38 -0
  112. package/src/email/templates/EnrollmentNotification.vue +24 -0
  113. package/src/email/templates/EnrollmentUpdate.vue +52 -0
  114. package/src/email/templates/NewSignIn.vue +37 -0
  115. package/src/email/templates/PasswordChanged.vue +22 -0
  116. package/src/email/templates/PasswordReset.vue +23 -0
  117. package/src/email/templates/StorageLimitReached.vue +28 -0
  118. package/src/email/templates/TwoStepChanged.vue +32 -0
  119. package/src/email/templates/WaitlistConfirmation.vue +29 -0
  120. package/src/email/templates/WorkspaceInvitation.vue +28 -0
  121. package/src/email/templates/brand.ts +9 -61
  122. package/src/email/templates/localization.ts +17 -0
  123. package/src/errors/index.ts +6 -0
  124. package/src/errors/posthog.ts +80 -0
  125. package/src/global.d.ts +7 -0
  126. package/src/runtime/cloudflare/environment.ts +22 -11
  127. package/src/runtime/cloudflare/index.ts +1 -1
  128. package/src/runtime/cloudflare/logging.ts +15 -0
  129. package/src/runtime/cloudflare/maintenance.ts +31 -0
  130. package/src/runtime/cloudflare/relay/index.ts +69 -15
  131. package/src/runtime/cloudflare/tsconfig.json +2 -1
  132. package/src/runtime/cloudflare/worker.ts +46 -13
  133. package/src/runtime/node/application.ts +5 -3
  134. package/src/runtime/node/bootstrap.ts +15 -4
  135. package/src/runtime/node/cleanup.ts +20 -3
  136. package/src/runtime/node/email/transport.ts +13 -10
  137. package/src/runtime/node/entitlements/main.ts +14 -11
  138. package/src/runtime/node/index.ts +1 -1
  139. package/src/runtime/node/main.ts +1 -1
  140. package/src/runtime/node/migrate.ts +5 -1
  141. package/src/runtime/node/relay.ts +8 -2
  142. package/src/runtime/node/request-id.ts +13 -0
  143. package/src/runtime/node/server.ts +50 -16
  144. package/src/runtime/node/{ai-relay → services}/main.ts +7 -7
  145. package/src/runtime/node/{ai-relay → services}/server.ts +18 -18
  146. package/src/runtime/postgres/database.ts +20 -1
  147. package/src/runtime/posthog/errors.ts +15 -30
  148. package/src/runtime/s3/objects.ts +41 -1
  149. package/src/runtime/site/community.ts +101 -0
  150. package/src/runtime/site/server.ts +49 -6
  151. package/src/server/account/actions.ts +5 -0
  152. package/src/server/account/deletion.ts +304 -0
  153. package/src/server/account/routes.ts +281 -206
  154. package/src/server/account/terms.ts +42 -0
  155. package/src/server/account/tokens.ts +57 -0
  156. package/src/server/api/router.ts +32 -5
  157. package/src/server/api/types.ts +2 -0
  158. package/src/server/app/checks.ts +84 -0
  159. package/src/server/app/editors.ts +20 -0
  160. package/src/server/app/index.ts +128 -0
  161. package/src/server/app/indexing.ts +40 -0
  162. package/src/server/app/limiters.ts +53 -0
  163. package/src/server/app/routes.ts +114 -0
  164. package/src/server/app/services.ts +185 -0
  165. package/src/server/auth/access-control.ts +63 -0
  166. package/src/server/auth/access-tokens.ts +62 -0
  167. package/src/server/auth/adapter.ts +32 -1
  168. package/src/server/auth/email.ts +4 -1
  169. package/src/server/auth/endpoints.ts +5 -1
  170. package/src/server/auth/enrollment.ts +116 -0
  171. package/src/server/auth/factory.ts +116 -132
  172. package/src/server/auth/index.ts +10 -1
  173. package/src/server/auth/logger.ts +23 -0
  174. package/src/server/auth/mfa-assurance.ts +51 -0
  175. package/src/server/auth/passwords.ts +43 -0
  176. package/src/server/auth/session.ts +2 -0
  177. package/src/server/billing/index.ts +6 -0
  178. package/src/server/billing/routes.ts +27 -0
  179. package/src/server/billing/tokens.ts +37 -0
  180. package/src/server/cleanup/configured.ts +27 -7
  181. package/src/server/cleanup/documents.ts +165 -71
  182. package/src/server/cleanup/revisions.ts +16 -5
  183. package/src/server/cleanup/uploads.ts +8 -2
  184. package/src/server/cleanup/worker.ts +15 -3
  185. package/src/server/collaboration/relay/connection.ts +4 -3
  186. package/src/server/collaboration/relay/documents.ts +13 -10
  187. package/src/server/collaboration/relay/hub.ts +77 -122
  188. package/src/server/collaboration/relay/log.ts +5 -2
  189. package/src/server/collaboration/relay/room.ts +154 -0
  190. package/src/server/collaboration/service.ts +48 -33
  191. package/src/server/community/index.ts +2 -0
  192. package/src/server/community/routes.ts +93 -0
  193. package/src/server/community/service.ts +134 -0
  194. package/src/server/config/deployment.ts +41 -9
  195. package/src/server/config/index.ts +1 -1
  196. package/src/server/config/public.ts +11 -4
  197. package/src/server/config/schema.ts +91 -277
  198. package/src/server/config/toml/schema.ts +307 -0
  199. package/src/server/db/expressions.ts +15 -1
  200. package/src/server/db/index.ts +1 -0
  201. package/src/server/db/migrate.ts +46 -116
  202. package/src/server/db/migrations/001_accounts.ts +79 -0
  203. package/src/server/db/migrations/002_workspaces.ts +48 -0
  204. package/src/server/db/migrations/003_storage.ts +44 -0
  205. package/src/server/db/migrations/004_documents.ts +193 -0
  206. package/src/server/db/migrations/005_sharing.ts +95 -0
  207. package/src/server/db/migrations/006_operations.ts +110 -0
  208. package/src/server/db/migrations/007_trash.ts +33 -0
  209. package/src/server/db/migrations/008_terms.ts +18 -0
  210. package/src/server/db/migrations/009_access_tokens.ts +47 -0
  211. package/src/server/db/migrations/010_storage_limit_notices.ts +50 -0
  212. package/src/server/db/migrations/011_account_ids.ts +30 -0
  213. package/src/server/db/migrations/012_email_locales.ts +34 -0
  214. package/src/server/db/migrations/013_document_block_emails.ts +40 -0
  215. package/src/server/db/migrations/014_report_replies.ts +28 -0
  216. package/src/server/db/migrations/schema.ts +96 -0
  217. package/src/server/db/tables.ts +82 -4
  218. package/src/server/db/users.ts +22 -0
  219. package/src/server/documents/access.ts +66 -55
  220. package/src/server/documents/errors.ts +7 -0
  221. package/src/server/documents/images.ts +2 -1
  222. package/src/server/documents/index.ts +1 -1
  223. package/src/server/documents/limits.ts +14 -8
  224. package/src/server/documents/purge.ts +75 -0
  225. package/src/server/documents/repository.ts +2 -0
  226. package/src/server/documents/routes.ts +26 -0
  227. package/src/server/documents/service.ts +30 -406
  228. package/src/server/documents/summary.ts +1 -0
  229. package/src/server/documents/trash.ts +203 -0
  230. package/src/server/documents/uploads.ts +450 -0
  231. package/src/server/documents/versions/checkpoint.ts +2 -1
  232. package/src/server/documents/versions/history.ts +11 -7
  233. package/src/server/documents/versions/service.ts +94 -28
  234. package/src/server/email/invitations.ts +1 -0
  235. package/src/server/email/service.ts +31 -4
  236. package/src/server/email/types.ts +12 -0
  237. package/src/server/errors/index.ts +51 -16
  238. package/src/server/index.ts +52 -16
  239. package/src/server/internal/index.ts +3 -3
  240. package/src/server/internal/routes.ts +7 -10
  241. package/src/server/internal/schema.ts +1 -1
  242. package/src/server/internal/service.ts +17 -23
  243. package/src/server/invitations/budget.ts +66 -0
  244. package/src/server/invitations/index.ts +1 -0
  245. package/src/server/invitations/types.ts +5 -1
  246. package/src/server/logging.ts +76 -0
  247. package/src/server/objects/types.ts +5 -0
  248. package/src/server/pictures/service.ts +2 -1
  249. package/src/server/policy/configured.ts +9 -3
  250. package/src/server/policy/database.ts +52 -27
  251. package/src/server/policy/index.ts +2 -1
  252. package/src/server/policy/keys.ts +5 -2
  253. package/src/server/policy/policy.ts +40 -12
  254. package/src/server/policy/schema.ts +2 -2
  255. package/src/server/policy/service.ts +78 -56
  256. package/src/server/policy/static.ts +5 -5
  257. package/src/server/policy/storage.ts +33 -0
  258. package/src/server/policy/workspace.ts +41 -0
  259. package/src/server/quota/index.ts +6 -0
  260. package/src/server/quota/notices.ts +121 -0
  261. package/src/server/quota/reconcile.ts +2 -0
  262. package/src/server/quota/storage.ts +74 -31
  263. package/src/server/rate-limit/cleanup.ts +17 -5
  264. package/src/server/rate-limit/middleware.ts +6 -2
  265. package/src/server/reports/index.ts +9 -0
  266. package/src/server/reports/replies.ts +55 -0
  267. package/src/server/reports/routes.ts +39 -0
  268. package/src/server/reports/service.ts +145 -0
  269. package/src/server/services/errors.ts +7 -0
  270. package/src/server/services/index.ts +8 -0
  271. package/src/server/{ai → services}/keys.ts +11 -11
  272. package/src/server/services/routes.ts +47 -0
  273. package/src/server/{ai/service.ts → services/tokens.ts} +23 -20
  274. package/src/server/sharing/capabilities/service.ts +68 -23
  275. package/src/server/sharing/grants/service.ts +11 -18
  276. package/src/server/sharing/http.ts +4 -0
  277. package/src/server/sharing/invitations/service.ts +35 -15
  278. package/src/server/sharing/policy.ts +9 -14
  279. package/src/server/sharing/routes.ts +0 -16
  280. package/src/server/sharing/service.ts +1 -17
  281. package/src/server/validation.ts +4 -0
  282. package/src/server/workspaces/index.ts +1 -0
  283. package/src/server/workspaces/members.ts +91 -52
  284. package/src/server/workspaces/repository.ts +2 -1
  285. package/src/server/workspaces/routes.ts +4 -0
  286. package/src/{ai-relay → services}/app.ts +46 -44
  287. package/src/{ai-relay → services}/config.ts +26 -19
  288. package/src/services/db/index.ts +10 -0
  289. package/src/services/db/migrate.ts +37 -0
  290. package/src/{ai-relay/db/migrations/001_usage.ts → services/db/migrations/001_baseline.ts} +18 -7
  291. package/src/services/db/schema.ts +22 -0
  292. package/src/services/index.ts +18 -0
  293. package/src/{ai-relay → services}/metering.ts +2 -2
  294. package/src/{ai-relay → services}/usage.ts +35 -19
  295. package/dist/bin/ai-relay.mjs.map +0 -1
  296. package/src/ai-relay/db/index.ts +0 -10
  297. package/src/ai-relay/db/migrate.ts +0 -32
  298. package/src/ai-relay/db/schema.ts +0 -20
  299. package/src/ai-relay/index.ts +0 -18
  300. package/src/client/ai.ts +0 -96
  301. package/src/contract/ai.ts +0 -150
  302. package/src/email/templates/document-invitation.ts +0 -35
  303. package/src/email/templates/enrollment.ts +0 -27
  304. package/src/email/templates/layout.ts +0 -18
  305. package/src/server/ai/errors.ts +0 -7
  306. package/src/server/ai/index.ts +0 -4
  307. package/src/server/ai/routes.ts +0 -43
  308. package/src/server/app.ts +0 -379
  309. package/src/server/auth/workspace-access.ts +0 -23
  310. package/src/server/db/migrations/001_foundation.ts +0 -164
  311. package/src/server/db/migrations/002_upload_cleanup_claims.ts +0 -34
  312. package/src/server/db/migrations/003_document_cleanup_claims.ts +0 -23
  313. package/src/server/db/migrations/004_document_sharing.ts +0 -82
  314. package/src/server/db/migrations/005_document_collaboration_epoch.ts +0 -13
  315. package/src/server/db/migrations/006_invitation_continuation.ts +0 -27
  316. package/src/server/db/migrations/007_collaboration_state.ts +0 -25
  317. package/src/server/db/migrations/008_storage_reservations.ts +0 -37
  318. package/src/server/db/migrations/009_workspace_entitlements.ts +0 -22
  319. package/src/server/db/migrations/010_upload_finalization.ts +0 -22
  320. package/src/server/db/migrations/011_upload_finalization_lease.ts +0 -12
  321. package/src/server/db/migrations/012_transactional_email.ts +0 -48
  322. package/src/server/db/migrations/013_admin_enrollment.ts +0 -54
  323. package/src/server/db/migrations/014_enrollment_email_kinds.ts +0 -30
  324. package/src/server/db/migrations/015_cloud_rate_limit.ts +0 -22
  325. package/src/server/db/migrations/016_auth_schema.ts +0 -16
  326. package/src/server/db/migrations/017_authentication_email_kinds.ts +0 -32
  327. package/src/server/db/migrations/018_authentication_mfa.ts +0 -78
  328. package/src/server/db/migrations/019_better_auth_account_issuer.ts +0 -42
  329. package/src/server/db/migrations/020_workspace_invitations.ts +0 -57
  330. package/src/server/db/migrations/021_document_versions.ts +0 -66
  331. package/src/server/db/migrations/022_entitlement_external_version.ts +0 -17
  332. package/src/server/db/migrations/023_document_images.ts +0 -61
  333. package/src/server/db/migrations/024_account_activity.ts +0 -66
  334. package/src/server/db/migrations/025_table_names.ts +0 -58
  335. package/src/server/db/migrations/026_user_picture.ts +0 -30
  336. package/src/server/db/migrations/027_document_kind.ts +0 -19
  337. package/src/server/db/migrations/028_collaboration_updates.ts +0 -84
  338. package/src/server/db/migrations/helpers.ts +0 -78
  339. /package/dist/bin/{ai-relay.d.mts → services.d.mts} +0 -0
@@ -0,0 +1,185 @@
1
+ import { createEnrollmentService, type EnrollmentService } from '#cloud/admin'
2
+ import type {
3
+ CloudAuthAdapter,
4
+ CloudIdentityResolver,
5
+ CloudSessionResolver
6
+ } from '#cloud/server/auth'
7
+ import { createBillingTokenService } from '#cloud/server/billing'
8
+ import { createCollaborationTicketService } from '#cloud/server/collaboration'
9
+ import { createCommunityService } from '#cloud/server/community'
10
+ import { CloudConfigError, type CloudServerConfig } from '#cloud/server/config'
11
+ import type { CloudDatabase } from '#cloud/server/db'
12
+ import { createDocumentService } from '#cloud/server/documents'
13
+ import { createDocumentVersionService } from '#cloud/server/documents/versions'
14
+ import type { TransactionalEmailService } from '#cloud/server/email'
15
+ import type { CloudErrorReporter } from '#cloud/server/errors'
16
+ import type { InvitationDelivery, InvitationOutbox } from '#cloud/server/invitations'
17
+ import type { ForwardedRequestId } from '#cloud/server/logging'
18
+ import type { ObjectStore } from '#cloud/server/objects'
19
+ import { createUserPictures } from '#cloud/server/pictures'
20
+ import {
21
+ createConfiguredCloudPolicy,
22
+ createDefaultCloudPolicy,
23
+ createEntitlementService,
24
+ EntitlementOpenFeatureProvider,
25
+ type CloudPolicy,
26
+ type EntitlementSource
27
+ } from '#cloud/server/policy'
28
+ import { createDocumentReportService } from '#cloud/server/reports'
29
+ import { createServicesTokenService, type ServicesSigningKey } from '#cloud/server/services'
30
+ import { createDocumentSharingService } from '#cloud/server/sharing'
31
+ import { createWorkspaceMemberService, createWorkspaceService } from '#cloud/server/workspaces'
32
+ import type { Kysely } from 'kysely'
33
+
34
+ export type CloudServices = {
35
+ config: CloudServerConfig
36
+ database: Kysely<CloudDatabase>
37
+ auth: CloudAuthAdapter
38
+ objects: ObjectStore
39
+ resolveIdentity?: CloudIdentityResolver
40
+ resolveSession?: CloudSessionResolver
41
+ /**
42
+ * An approved account even before it accepted the current terms, for leaving: reading its
43
+ * documents and deleting the account. Defaults to `resolveSession` when that is given.
44
+ */
45
+ resolveAccountSession?: CloudSessionResolver
46
+ invitationDelivery?: InvitationDelivery
47
+ invitationOutbox?: InvitationOutbox
48
+ transactionalEmail?: TransactionalEmailService
49
+ enrollment?: EnrollmentService
50
+ entitlementSource?: EntitlementSource
51
+ policy?: CloudPolicy
52
+ /** The imported `servicesSigningKey`, required when the config names one. See `loadServicesSigningKey`. */
53
+ servicesSigningKey?: ServicesSigningKey
54
+ /**
55
+ * Where clients reach this runtime's collaboration relay. Without one, Cloud rooms fall back to
56
+ * peer-to-peer and writes are not enforced by the server.
57
+ */
58
+ relayURL?: string
59
+ /** Ends a restored document's live rooms, on the relay this runtime runs, if any. */
60
+ onDocumentRestored?: (documentId: string) => void
61
+ /** Ends a taken-down document's live rooms, saving them for when it is restored. */
62
+ onDocumentTakenDown?: (documentId: string) => void
63
+ /** Tells a document's live rooms its version history changed, on the relay this runtime runs. */
64
+ onDocumentVersionsChanged?: (documentId: string) => void
65
+ /** Logs errors no route handled, and reports them when the deployment configures error tracking. */
66
+ reportError?: CloudErrorReporter
67
+ /** The request ID this runtime trusts from what stands in front of it, such as `cf-ray`. */
68
+ forwardedRequestId?: ForwardedRequestId
69
+ }
70
+
71
+ /** The domain services the app's routes are built from, over the runtime's injected services. */
72
+ export function createAppServices(services: CloudServices) {
73
+ const { config, database, objects } = services
74
+ const workspaces = createWorkspaceService(database)
75
+ const pictures = createUserPictures(database, { publicURL: config.publicURL })
76
+ const workspaceMembers = createWorkspaceMemberService(database, {
77
+ email: services.transactionalEmail,
78
+ publicURL: config.publicURL
79
+ })
80
+ const enrollment =
81
+ services.enrollment ??
82
+ createEnrollmentService(database, {
83
+ publicURL: config.publicURL,
84
+ adminRecipients: config.enrollmentAdminNotificationEmails,
85
+ email: services.transactionalEmail
86
+ })
87
+ const policy =
88
+ services.policy ??
89
+ (services.entitlementSource
90
+ ? createDefaultCloudPolicy(new EntitlementOpenFeatureProvider(services.entitlementSource))
91
+ : createConfiguredCloudPolicy(config, database))
92
+ const documents = createDocumentService(database, objects, {
93
+ policy,
94
+ technicalMaximumUploadBytes: config.technicalLimits.maximumUploadBytes,
95
+ onVersionsChanged: services.onDocumentVersionsChanged,
96
+ trash: {
97
+ retentionMs: config.documentRetentionMs,
98
+ purgeGraceMs: config.documentPurgeGraceMs,
99
+ leaseDurationMs: config.cleanupLeaseDurationMs,
100
+ reportError: services.reportError
101
+ },
102
+ reportError: services.reportError
103
+ })
104
+ const versions = createDocumentVersionService(database, objects, {
105
+ policy,
106
+ deploymentMode: config.deployment,
107
+ onRestored: services.onDocumentRestored,
108
+ onVersionsChanged: services.onDocumentVersionsChanged
109
+ })
110
+ const community = createCommunityService(
111
+ database,
112
+ objects,
113
+ documents,
114
+ versions,
115
+ config.community?.workspaceId ?? null
116
+ )
117
+ const entitlements = createEntitlementService(
118
+ database,
119
+ policy,
120
+ config.technicalLimits.maximumUploadBytes,
121
+ config.technicalLimits.maximumConnectionsPerRoom
122
+ )
123
+ const sharing = createDocumentSharingService(database, {
124
+ delivery: services.invitationDelivery,
125
+ outbox: services.invitationOutbox,
126
+ continuationSecret: config.authSecret,
127
+ publicURL: config.publicURL,
128
+ policy,
129
+ deploymentMode: config.deployment,
130
+ workspaceInvitations: workspaceMembers
131
+ })
132
+ const collaboration = createCollaborationTicketService({
133
+ database,
134
+ sharing,
135
+ authSecret: config.authSecret,
136
+ relayURL: services.relayURL,
137
+ policy,
138
+ deploymentMode: config.deployment
139
+ })
140
+ if (config.servicesSigningKey && !services.servicesSigningKey) {
141
+ throw new CloudConfigError('Services need the signing key imported by loadServicesSigningKey')
142
+ }
143
+ const servicesTokens = services.servicesSigningKey
144
+ ? createServicesTokenService({
145
+ database,
146
+ policy,
147
+ deploymentMode: config.deployment,
148
+ issuer: new URL(config.publicURL).origin,
149
+ signingKey: services.servicesSigningKey,
150
+ lifetimeSeconds: config.servicesTokenLifetimeSeconds
151
+ })
152
+ : undefined
153
+ const billingTokens =
154
+ services.servicesSigningKey && config.billingEndpoint
155
+ ? createBillingTokenService({
156
+ issuer: new URL(config.publicURL).origin,
157
+ signingKey: services.servicesSigningKey,
158
+ lifetimeSeconds: config.servicesTokenLifetimeSeconds
159
+ })
160
+ : undefined
161
+ const reports = createDocumentReportService(database, {
162
+ sharing,
163
+ email: services.transactionalEmail,
164
+ adminRecipients: config.enrollmentAdminNotificationEmails,
165
+ publicURL: config.publicURL
166
+ })
167
+ return {
168
+ workspaces,
169
+ pictures,
170
+ workspaceMembers,
171
+ enrollment,
172
+ policy,
173
+ documents,
174
+ versions,
175
+ community,
176
+ entitlements,
177
+ sharing,
178
+ collaboration,
179
+ servicesTokens,
180
+ billingTokens,
181
+ reports
182
+ }
183
+ }
184
+
185
+ export type CloudAppServices = ReturnType<typeof createAppServices>
@@ -0,0 +1,63 @@
1
+ import type { DocumentPermission, WorkspaceRole } from '#cloud/contract'
2
+ import { createAccessControl } from 'better-auth/plugins/access'
3
+
4
+ export const accessStatements = {
5
+ workspace: ['read', 'update', 'delete', 'invite', 'manage-members'],
6
+ /** `delete` moves a document to Trash and back; `purge` deletes it from Trash for good. */
7
+ document: ['create', 'read', 'edit', 'share', 'delete', 'purge']
8
+ } as const
9
+
10
+ type AccessStatements = typeof accessStatements
11
+
12
+ /** Actions a check asks for, by resource; every listed action must be allowed. */
13
+ export type AccessRequest = {
14
+ [Resource in keyof AccessStatements]?: AccessStatements[Resource][number][]
15
+ }
16
+
17
+ export const accessControl = createAccessControl(accessStatements)
18
+
19
+ /**
20
+ * What a workspace member may do there, by role. Together with `documentRoles` this is the whole
21
+ * permission policy: every check goes through `workspaceRoleCan` or `documentRoleCan`.
22
+ */
23
+ export const workspaceRoles = {
24
+ admin: accessControl.newRole({
25
+ workspace: ['read', 'update', 'delete', 'invite', 'manage-members'],
26
+ document: ['create', 'read', 'edit', 'share', 'delete', 'purge']
27
+ }),
28
+ editor: accessControl.newRole({
29
+ workspace: ['read'],
30
+ document: ['create', 'read', 'edit', 'share', 'delete']
31
+ }),
32
+ viewer: accessControl.newRole({
33
+ workspace: ['read'],
34
+ document: ['read']
35
+ })
36
+ } satisfies Record<WorkspaceRole, unknown>
37
+
38
+ /**
39
+ * What someone may do with one document through something other than workspace membership: being
40
+ * its owner, or a grant made to them. A grant lets its holder edit and share, never delete the
41
+ * owner's document. Deleting from Trash for good is for the owner and workspace administrators.
42
+ */
43
+ export const documentRoles = {
44
+ owner: accessControl.newRole({ document: ['read', 'edit', 'share', 'delete', 'purge'] }),
45
+ editor: accessControl.newRole({ document: ['read', 'edit', 'share'] }),
46
+ viewer: accessControl.newRole({ document: ['read'] })
47
+ }
48
+
49
+ export type DocumentRole = keyof typeof documentRoles
50
+
51
+ /** The document role a direct grant of this permission gives. */
52
+ export const GRANT_DOCUMENT_ROLE: Record<DocumentPermission, DocumentRole> = {
53
+ view: 'viewer',
54
+ edit: 'editor'
55
+ }
56
+
57
+ export function workspaceRoleCan(role: WorkspaceRole, request: AccessRequest): boolean {
58
+ return workspaceRoles[role].authorize(request).success
59
+ }
60
+
61
+ export function documentRoleCan(role: DocumentRole, request: AccessRequest): boolean {
62
+ return documentRoles[role].authorize(request).success
63
+ }
@@ -0,0 +1,62 @@
1
+ import type { EnrollmentService } from '#cloud/admin/enrollment/service'
2
+ import { CLOUD_ACCESS_TOKEN_PREFIX, type CloudAccessToken } from '#cloud/contract'
3
+ import type { TermsService } from '#cloud/server/account/terms'
4
+ import type { CloudServerConfig } from '#cloud/server/config'
5
+ import type { CloudDatabase } from '#cloud/server/db'
6
+ import type { Kysely } from 'kysely'
7
+
8
+ /** The personal access token in `Authorization: Bearer`, when the header carries one of Cloud's. */
9
+ export function bearerAccessToken(headers: Headers): string | null {
10
+ const key = headers.get('authorization')?.match(/^Bearer\s+(\S+)$/i)?.[1]
11
+ return key?.startsWith(CLOUD_ACCESS_TOKEN_PREFIX) ? key : null
12
+ }
13
+
14
+ /**
15
+ * The account a verified token belongs to, held to what a session would be: not banned, approved,
16
+ * and with the current terms accepted.
17
+ */
18
+ export async function accessTokenAccount(
19
+ {
20
+ database,
21
+ config,
22
+ enrollment,
23
+ terms
24
+ }: {
25
+ database: Kysely<CloudDatabase>
26
+ config: CloudServerConfig
27
+ enrollment: EnrollmentService
28
+ terms: TermsService
29
+ },
30
+ userId: string
31
+ ) {
32
+ const user = await database
33
+ .selectFrom('user')
34
+ .select(['id', 'email', 'name', 'image', 'role', 'banned', 'banExpires'])
35
+ .where('id', '=', userId)
36
+ .executeTakeFirst()
37
+ if (!user) return null
38
+ const banExpires = user.banExpires ? new Date(user.banExpires).getTime() : null
39
+ if (user.banned && (banExpires === null || banExpires > Date.now())) return null
40
+ if (config.enrollmentMode === 'approval' && !(await enrollment.isApproved(user.email))) {
41
+ return null
42
+ }
43
+ if (!(await terms.hasAccepted(user.id))) return null
44
+ return user
45
+ }
46
+
47
+ /** A stored token as the account's token list shows it, without the secret. */
48
+ export const toAccessToken = (key: {
49
+ id: string
50
+ name: string | null
51
+ start: string | null
52
+ createdAt: Date
53
+ expiresAt: Date | null
54
+ lastRequest: Date | null
55
+ }): CloudAccessToken => ({
56
+ id: key.id,
57
+ name: key.name ?? '',
58
+ start: key.start,
59
+ createdAt: new Date(key.createdAt).toISOString(),
60
+ expiresAt: key.expiresAt ? new Date(key.expiresAt).toISOString() : null,
61
+ lastUsedAt: key.lastRequest ? new Date(key.lastRequest).toISOString() : null
62
+ })
@@ -1,4 +1,9 @@
1
- import type { CloudAccountSession, CloudSignIn } from '#cloud/contract'
1
+ import type {
2
+ CloudAccessToken,
3
+ CloudAccessTokenCreate,
4
+ CloudAccountSession,
5
+ CloudSignIn
6
+ } from '#cloud/contract'
2
7
  import type { CloudActor } from '#cloud/server/auth/session'
3
8
 
4
9
  export type CloudMFAStatus = {
@@ -38,6 +43,23 @@ export interface CloudAuthAdapter {
38
43
  handler(request: Request): Promise<Response>
39
44
  resolveIdentity(headers: Headers): Promise<CloudIdentity | null>
40
45
  resolveSession(headers: Headers): Promise<CloudActor | null>
46
+ /**
47
+ * The signed-in person while their account is approved, whether or not it accepted the current
48
+ * terms: enough to leave, by downloading its documents and deleting the account.
49
+ */
50
+ resolveAccountSession(headers: Headers): Promise<CloudActor | null>
51
+ /**
52
+ * The account a personal access token stands for, from `Authorization: Bearer`, once it is held
53
+ * to what a session would be. Only the document API reads tokens.
54
+ */
55
+ resolveAccessToken(headers: Headers): Promise<CloudActor | null>
56
+ listAccessTokens(headers: Headers): Promise<CloudAccessToken[] | null>
57
+ /** Makes a token for the signed-in account; answers the whole token, shown this once. */
58
+ createAccessToken(
59
+ headers: Headers,
60
+ input: CloudAccessTokenCreate
61
+ ): Promise<{ token: string; accessToken: CloudAccessToken }>
62
+ revokeAccessToken(headers: Headers, id: string): Promise<void>
41
63
  listAuthenticationMethods(headers: Headers): Promise<CloudAuthenticationMethodRecord[]>
42
64
  changePassword(
43
65
  headers: Headers,
@@ -67,6 +89,9 @@ export interface CloudAuthAdapter {
67
89
  emailChangeAvailable: boolean
68
90
  profile(headers: Headers): Promise<CloudAccountProfile | null>
69
91
  updateProfile(headers: Headers, input: { name: string }): Promise<void>
92
+ /** The language Cloud writes to the account in, as the app says it uses. */
93
+ /** Takes the app's language tag; the server keeps the nearest language it writes in. */
94
+ setLocale(headers: Headers, locale: string): Promise<void>
70
95
  /** Sends the confirmation to the new address and tells the old one which address it is. */
71
96
  changeEmail(headers: Headers, input: { newEmail: string; callbackURL: string }): Promise<void>
72
97
  sessions(headers: Headers): Promise<CloudAccountSession[] | null>
@@ -74,6 +99,12 @@ export interface CloudAuthAdapter {
74
99
  revokeSession(headers: Headers, sessionId: string): Promise<void>
75
100
  revokeOtherSessions(headers: Headers): Promise<void>
76
101
  signIns(headers: Headers): Promise<CloudSignIn[] | null>
102
+ /**
103
+ * Deletes the signed-in account through Better Auth, after Cloud removes what it keeps about
104
+ * it; a session that signed in a while ago gives its password. Answers the headers that clear the
105
+ * session cookie.
106
+ */
107
+ deleteAccount(headers: Headers, password?: string): Promise<Headers>
77
108
  migrate: () => Promise<void>
78
109
  schemaVersion: string
79
110
  }
@@ -1,4 +1,4 @@
1
- import type { TwoStepChange } from '#cloud/email'
1
+ import type { EmailLocale, TwoStepChange } from '#cloud/email'
2
2
  import type { TransactionalEmailService } from '#cloud/server/email'
3
3
  import { sha256 } from '@noble/hashes/sha2.js'
4
4
  import { bytesToHex, utf8ToBytes } from '@noble/hashes/utils.js'
@@ -10,6 +10,8 @@ export type AuthenticationEmailService = {
10
10
  url: string
11
11
  token: string
12
12
  purpose?: 'account' | 'change'
13
+ /** The account's own language, or null for none; nothing is looked up, as sign-up needs. */
14
+ locale?: EmailLocale | null
13
15
  }): Promise<void>
14
16
  sendPasswordReset(input: {
15
17
  email: string
@@ -62,6 +64,7 @@ export function createAuthenticationEmailService(
62
64
  idempotencyKey: `email-verification/${input.email.toLowerCase()}/${tokenHash(input.token)}`,
63
65
  kind: 'email-verification',
64
66
  recipientEmail: input.email,
67
+ recipientLocale: input.locale ?? null,
65
68
  payload: { name: input.name, actionURL: input.url, purpose: input.purpose }
66
69
  })
67
70
  },
@@ -15,12 +15,14 @@ type CorePaths<Names extends keyof typeof BetterAuthEndpoints> = {
15
15
 
16
16
  /**
17
17
  * The core endpoints whose paths Better Auth's own options need before it is built: rate limits,
18
- * captcha, and the hooks that record sign-ins. Plugin endpoints come from the plugin objects and
18
+ * captcha, disabled paths, and the hooks that record sign-ins. Plugin endpoints come from the plugin objects and
19
19
  * the rest from `auth.api`; these few are written out, and the type check holds each to the path
20
20
  * the library declares, so a renamed endpoint fails to compile.
21
21
  */
22
22
  export const CORE_AUTH_PATHS: CorePaths<
23
23
  | 'callbackOAuth'
24
+ | 'deleteUser'
25
+ | 'deleteUserCallback'
24
26
  | 'requestPasswordReset'
25
27
  | 'sendVerificationEmail'
26
28
  | 'signInEmail'
@@ -28,6 +30,8 @@ export const CORE_AUTH_PATHS: CorePaths<
28
30
  | 'verifyEmail'
29
31
  > = {
30
32
  callbackOAuth: '/callback/:id',
33
+ deleteUser: '/delete-user',
34
+ deleteUserCallback: '/delete-user/callback',
31
35
  requestPasswordReset: '/request-password-reset',
32
36
  sendVerificationEmail: '/send-verification-email',
33
37
  signInEmail: '/sign-in/email',
@@ -0,0 +1,116 @@
1
+ import type { EnrollmentService } from '#cloud/admin/enrollment/service'
2
+ import { cloudLanguageTagSchema } from '#cloud/contract'
3
+ import { acceptedLocale, emailLocale, isEmailLocale, type EmailLocale } from '#cloud/email'
4
+ import { accountDeletionOptions } from '#cloud/server/account/deletion'
5
+ import type { CloudServerConfig } from '#cloud/server/config'
6
+ import type { CloudDatabase } from '#cloud/server/db'
7
+ import type { BetterAuthOptions } from 'better-auth'
8
+ import type { Kysely } from 'kysely'
9
+ import * as v from 'valibot'
10
+
11
+ import type { AuthenticationEmailService } from './email'
12
+
13
+ /** The language an account writes in, which Better Auth's types don't know it has. */
14
+ function accountLocale(user: object): EmailLocale | null {
15
+ return 'locale' in user && isEmailLocale(user.locale) ? user.locale : null
16
+ }
17
+
18
+ /** The language tag the app sent, if any, before it's matched to one Cloud writes in. */
19
+ function languageTag(user: object): string | null {
20
+ return 'locale' in user && typeof user.locale === 'string' ? user.locale : null
21
+ }
22
+
23
+ /**
24
+ * Who may join and when an account counts as enrolled: addresses are verified before an account
25
+ * asks for approval or binds an approved invitation, and a closed deployment creates no accounts.
26
+ */
27
+ export function enrollmentOptions(
28
+ config: CloudServerConfig,
29
+ database: Kysely<CloudDatabase>,
30
+ enrollment: EnrollmentService,
31
+ authenticationEmail: AuthenticationEmailService | undefined,
32
+ emailChangeAvailable: boolean
33
+ ) {
34
+ async function enroll(user: { id: string; email: string; name: string }) {
35
+ if (config.enrollmentMode === 'approval') {
36
+ await enrollment.request({ email: user.email, name: user.name })
37
+ }
38
+ await enrollment.bindApprovedUser(user.email, user.id)
39
+ }
40
+
41
+ return {
42
+ emailVerification:
43
+ config.emailPasswordEnabled && authenticationEmail
44
+ ? {
45
+ expiresIn: config.emailVerificationExpiresIn,
46
+ sendOnSignUp: true,
47
+ // Signing in unverified only says so; people ask for another link with Send again.
48
+ sendOnSignIn: false,
49
+ autoSignInAfterVerification: true,
50
+ // A change of address sends the link to the new address as `user.email`, on the
51
+ // account it already confirmed; a new account has not confirmed one yet. This runs
52
+ // inside sign-up's transaction, so it must not query the database itself.
53
+ sendVerificationEmail: ({ user, url, token }) =>
54
+ authenticationEmail.sendVerification({
55
+ email: user.email,
56
+ name: user.name,
57
+ url,
58
+ token,
59
+ purpose: user.emailVerified ? 'change' : 'account',
60
+ // The account carries its language, so nothing is looked up in the transaction.
61
+ locale: accountLocale(user)
62
+ }),
63
+ afterEmailVerification: async (user) => {
64
+ await enrollment.followEmailChange(user.id, user.email)
65
+ await enroll(user)
66
+ }
67
+ }
68
+ : undefined,
69
+ user: {
70
+ additionalFields: {
71
+ // The language Cloud writes to the account in: the app's, sent when signing up and
72
+ // whenever the person changes it, as the nearest language Cloud has (the hooks below).
73
+ locale: {
74
+ type: 'string' as const,
75
+ required: false,
76
+ input: true,
77
+ validator: { input: v.nullish(cloudLanguageTagSchema) }
78
+ }
79
+ },
80
+ changeEmail: { enabled: emailChangeAvailable },
81
+ deleteUser: accountDeletionOptions(database),
82
+ validateUserInfo: ({ source }) => {
83
+ if (source.action === 'create-user' && config.enrollmentMode === 'closed') {
84
+ return { error: 'enrollment_closed', errorDescription: 'Cloud enrollment is closed' }
85
+ }
86
+ return undefined
87
+ }
88
+ },
89
+ databaseHooks: {
90
+ user: {
91
+ create: {
92
+ // The app's language, or for an account it didn't name one for, as one made through
93
+ // Google or Apple, the browser's. A language Cloud doesn't write in reads English.
94
+ before: async (user, context) => {
95
+ const tag = languageTag(user)
96
+ const locale = tag
97
+ ? emailLocale([tag])
98
+ : acceptedLocale(context?.headers?.get('accept-language'))
99
+ return { data: { ...user, locale } }
100
+ },
101
+ after: async (user) => {
102
+ if (user.emailVerified) await enroll(user)
103
+ }
104
+ },
105
+ update: {
106
+ // Whoever changes it, Cloud keeps the nearest language it writes in, or English.
107
+ before: async (user) => {
108
+ if (!('locale' in user)) return undefined
109
+ const tag = languageTag(user)
110
+ return { data: { ...user, locale: emailLocale(tag ? [tag] : []) } }
111
+ }
112
+ }
113
+ }
114
+ }
115
+ } satisfies Pick<BetterAuthOptions, 'emailVerification' | 'user' | 'databaseHooks'>
116
+ }