@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,375 @@
1
+ import {
2
+ createAdminAuditService,
3
+ createAdminEmailService,
4
+ createAdminOperationsService,
5
+ createAdminUserService,
6
+ createCloudAdminRoutes,
7
+ createEnrollmentService,
8
+ type EnrollmentService
9
+ } from '#cloud/admin'
10
+ import {
11
+ CLOUD_AI_JWKS_PATH,
12
+ CLOUD_DISCOVERY_PATH,
13
+ CLOUD_PROTOCOL_VERSION,
14
+ type CloudDiscovery
15
+ } from '#cloud/contract'
16
+ import { createAccountRoutes } from '#cloud/server/account/routes'
17
+ import { createAITokenService, type AISigningKey } from '#cloud/server/ai'
18
+ import {
19
+ createCloudAPIRouter,
20
+ createPublicCloudAPIRouter,
21
+ type CloudAPIEnvironment
22
+ } from '#cloud/server/api'
23
+ import {
24
+ AUTH_BASE_PATH,
25
+ createAuthenticationEmailService,
26
+ createCloudIdentityResolver,
27
+ createCloudSessionResolver,
28
+ type CloudAuthAdapter,
29
+ type CloudIdentityResolver,
30
+ type CloudSessionResolver
31
+ } from '#cloud/server/auth'
32
+ import { createCollaborationTicketService } from '#cloud/server/collaboration'
33
+ import {
34
+ CloudConfigError,
35
+ cloudDiscoveryFromConfig,
36
+ type CloudServerConfig
37
+ } from '#cloud/server/config'
38
+ import type { CloudDatabase } from '#cloud/server/db'
39
+ import { createDocumentService } from '#cloud/server/documents'
40
+ import { createDocumentVersionService } from '#cloud/server/documents/versions'
41
+ import type { TransactionalEmailService } from '#cloud/server/email'
42
+ import { createInternalRoutes, createInternalService } from '#cloud/server/internal'
43
+ import type { InvitationDelivery, InvitationOutbox } from '#cloud/server/invitations'
44
+ import type { ObjectStore } from '#cloud/server/objects'
45
+ import { createPictureRoutes, createUserPictures } from '#cloud/server/pictures'
46
+ import {
47
+ createConfiguredCloudPolicy,
48
+ createDefaultCloudPolicy,
49
+ createEntitlementService,
50
+ EntitlementOpenFeatureProvider,
51
+ type CloudPolicy,
52
+ type EntitlementSource
53
+ } from '#cloud/server/policy'
54
+ import {
55
+ CLOUD_RATE_LIMITS,
56
+ createActorRateLimiter,
57
+ createTrustedIPRateLimiter,
58
+ routeHasOwnBudget
59
+ } from '#cloud/server/rate-limit'
60
+ import { createDocumentSharingService } from '#cloud/server/sharing'
61
+ import { createWorkspaceMemberService, createWorkspaceService } from '#cloud/server/workspaces'
62
+ import { Hono, type Context } from 'hono'
63
+ import { cors } from 'hono/cors'
64
+ import type { Kysely } from 'kysely'
65
+
66
+ export type CloudServices = {
67
+ config: CloudServerConfig
68
+ database: Kysely<CloudDatabase>
69
+ auth: CloudAuthAdapter
70
+ objects: ObjectStore
71
+ resolveIdentity?: CloudIdentityResolver
72
+ resolveSession?: CloudSessionResolver
73
+ invitationDelivery?: InvitationDelivery
74
+ invitationOutbox?: InvitationOutbox
75
+ transactionalEmail?: TransactionalEmailService
76
+ enrollment?: EnrollmentService
77
+ entitlementSource?: EntitlementSource
78
+ policy?: CloudPolicy
79
+ /** The imported `aiSigningKey`, required when the config names one. See `loadAISigningKey`. */
80
+ aiSigningKey?: AISigningKey
81
+ /**
82
+ * Where clients reach this runtime's collaboration relay. Without one, Cloud rooms fall back to
83
+ * peer-to-peer and writes are not enforced by the server.
84
+ */
85
+ relayURL?: string
86
+ /** Ends a restored document's live rooms, on the relay this runtime runs, if any. */
87
+ onDocumentRestored?: (documentId: string) => void
88
+ /** Tells a document's live rooms its version history changed, on the relay this runtime runs. */
89
+ onDocumentVersionsChanged?: (documentId: string) => void
90
+ }
91
+
92
+ type CloudEnvironment = CloudAPIEnvironment
93
+
94
+ function discoveryFromServices(services: CloudServices): CloudDiscovery {
95
+ return cloudDiscoveryFromConfig(services.config)
96
+ }
97
+
98
+ export function shouldPreventIndexing(path: string, policy: 'allow' | 'deny'): boolean {
99
+ return (
100
+ policy === 'deny' ||
101
+ path.startsWith('/api/') ||
102
+ path.startsWith('/admin') ||
103
+ path.startsWith('/auth') ||
104
+ path.startsWith('/account') ||
105
+ path === '/app' ||
106
+ path === '/sign-in' ||
107
+ path === '/sign-up' ||
108
+ path === '/join' ||
109
+ path === CLOUD_DISCOVERY_PATH
110
+ )
111
+ }
112
+
113
+ export function withIndexingPolicy(
114
+ response: Response,
115
+ path: string,
116
+ policy: 'allow' | 'deny'
117
+ ): Response {
118
+ if (!shouldPreventIndexing(path, policy)) return response
119
+ const headers = new Headers(response.headers)
120
+ headers.set('X-Robots-Tag', 'noindex, nofollow, noarchive')
121
+ return new Response(response.body, {
122
+ status: response.status,
123
+ statusText: response.statusText,
124
+ headers
125
+ })
126
+ }
127
+
128
+ export function createCloudApp(services: CloudServices) {
129
+ const discovery = discoveryFromServices(services)
130
+ const resolveIdentity = services.resolveIdentity ?? createCloudIdentityResolver(services.auth)
131
+ const resolveSession = services.resolveSession ?? createCloudSessionResolver(services.auth)
132
+ const allowedOrigins = new Set(
133
+ [services.config.publicURL, ...services.config.trustedOrigins].map(
134
+ (origin) => new URL(origin).origin
135
+ )
136
+ )
137
+ const cloudCORS = cors({
138
+ origin: (origin) => (allowedOrigins.has(origin) ? origin : null),
139
+ allowMethods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],
140
+ allowHeaders: ['Content-Type', 'Authorization'],
141
+ credentials: true,
142
+ maxAge: 600
143
+ })
144
+ const workspaces = createWorkspaceService(services.database)
145
+ const pictures = createUserPictures(services.database, { publicURL: services.config.publicURL })
146
+ const workspaceMembers = createWorkspaceMemberService(services.database, {
147
+ email: services.transactionalEmail,
148
+ publicURL: services.config.publicURL
149
+ })
150
+ const enrollment =
151
+ services.enrollment ??
152
+ createEnrollmentService(services.database, {
153
+ publicURL: services.config.publicURL,
154
+ adminRecipients: services.config.enrollmentAdminNotificationEmails,
155
+ email: services.transactionalEmail
156
+ })
157
+ const admin = createCloudAdminRoutes(
158
+ {
159
+ email: createAdminEmailService(services.database, services.transactionalEmail, {
160
+ publicURL: services.config.publicURL
161
+ }),
162
+ enrollment,
163
+ users: createAdminUserService(services.database, services.auth, {
164
+ requireMFA: services.config.deploymentAdminMFARequired,
165
+ pictures,
166
+ notify: services.transactionalEmail
167
+ ? createAuthenticationEmailService(services.transactionalEmail, services.config.publicURL)
168
+ : undefined
169
+ }),
170
+ audit: createAdminAuditService(services.database),
171
+ operations: createAdminOperationsService(services.database, services.config)
172
+ },
173
+ allowedOrigins,
174
+ {
175
+ database: services.database,
176
+ secret: services.config.authSecret,
177
+ auth: services.auth,
178
+ requireMFA: services.config.deploymentAdminMFARequired
179
+ }
180
+ )
181
+ const policy =
182
+ services.policy ??
183
+ (services.entitlementSource
184
+ ? createDefaultCloudPolicy(new EntitlementOpenFeatureProvider(services.entitlementSource))
185
+ : createConfiguredCloudPolicy(services.config, services.database))
186
+ const documents = createDocumentService(services.database, services.objects, {
187
+ policy,
188
+ technicalMaximumUploadBytes: services.config.technicalLimits.maximumUploadBytes,
189
+ onVersionsChanged: services.onDocumentVersionsChanged
190
+ })
191
+ const versions = createDocumentVersionService(services.database, services.objects, {
192
+ policy,
193
+ deploymentMode: services.config.deployment,
194
+ onRestored: services.onDocumentRestored,
195
+ onVersionsChanged: services.onDocumentVersionsChanged
196
+ })
197
+ const entitlements = createEntitlementService(
198
+ services.database,
199
+ policy,
200
+ services.config.technicalLimits.maximumUploadBytes,
201
+ services.config.technicalLimits.maximumConnectionsPerRoom
202
+ )
203
+ const sharing = createDocumentSharingService(services.database, {
204
+ delivery: services.invitationDelivery,
205
+ outbox: services.invitationOutbox,
206
+ continuationSecret: services.config.authSecret,
207
+ publicURL: services.config.publicURL,
208
+ policy,
209
+ deploymentMode: services.config.deployment,
210
+ workspaceInvitations: workspaceMembers
211
+ })
212
+ const collaboration = createCollaborationTicketService({
213
+ database: services.database,
214
+ sharing,
215
+ authSecret: services.config.authSecret,
216
+ relayURL: services.relayURL,
217
+ policy,
218
+ deploymentMode: services.config.deployment
219
+ })
220
+ if (services.config.aiSigningKey && !services.aiSigningKey) {
221
+ throw new CloudConfigError('The AI service needs the signing key imported by loadAISigningKey')
222
+ }
223
+ const aiTokens = services.aiSigningKey
224
+ ? createAITokenService({
225
+ database: services.database,
226
+ policy,
227
+ deploymentMode: services.config.deployment,
228
+ issuer: new URL(services.config.publicURL).origin,
229
+ signingKey: services.aiSigningKey,
230
+ lifetimeSeconds: services.config.aiTokenLifetimeSeconds
231
+ })
232
+ : undefined
233
+
234
+ const requireActiveSession = async (context: Context, next: () => Promise<void>) => {
235
+ const actor = await resolveSession(context.req.raw)
236
+ if (!actor) return context.json({ error: { code: 'unauthorized' as const } }, 401)
237
+ context.set('actor', actor)
238
+ return next()
239
+ }
240
+ const publicRateLimiter = createTrustedIPRateLimiter(
241
+ services.database,
242
+ services.config.authSecret,
243
+ CLOUD_RATE_LIMITS.publicCapability,
244
+ { trustedHeaders: services.config.authTrustedIPHeaders },
245
+ (context) => context.json({ error: { code: 'not_found' as const } }, 404),
246
+ {
247
+ resource: (context) => context.req.path,
248
+ // Guests refresh collaboration tickets on their own budget, `publicCollaborationLimiter`.
249
+ skip: routeHasOwnBudget
250
+ }
251
+ )
252
+ const publicCollaborationLimiter = createTrustedIPRateLimiter(
253
+ services.database,
254
+ services.config.authSecret,
255
+ CLOUD_RATE_LIMITS.collaborationTicket,
256
+ { trustedHeaders: services.config.authTrustedIPHeaders },
257
+ (context) => context.json({ error: { code: 'not_found' as const } }, 404),
258
+ { resource: (context) => context.req.path, route: true }
259
+ )
260
+ const authenticatedMutationLimiter = createActorRateLimiter(
261
+ services.database,
262
+ services.config.authSecret,
263
+ CLOUD_RATE_LIMITS.authenticatedMutation,
264
+ // Reads are free, and a route with a budget of its own, such as creating documents, counts
265
+ // against that instead.
266
+ (context) => context.req.method === 'GET' || routeHasOwnBudget(context)
267
+ )
268
+
269
+ const accountRoutes = createAccountRoutes({
270
+ auth: services.auth,
271
+ pictures,
272
+ config: services.config,
273
+ enrollment,
274
+ workspaces,
275
+ resolveIdentity,
276
+ resolveSession,
277
+ requireActiveSession,
278
+ authenticatedMutationLimiter
279
+ })
280
+ const cloudAPI = createCloudAPIRouter({
281
+ collaboration,
282
+ database: services.database,
283
+ rateLimitSecret: services.config.authSecret,
284
+ documents,
285
+ versions,
286
+ entitlements,
287
+ aiTokens,
288
+ sharing,
289
+ workspaces,
290
+ workspaceMembers,
291
+ resolveSession
292
+ })
293
+ const publicCloudAPI = createPublicCloudAPIRouter({
294
+ collaboration,
295
+ documents,
296
+ versions,
297
+ entitlements,
298
+ sharing,
299
+ workspaces,
300
+ workspaceMembers,
301
+ resolveSession
302
+ })
303
+
304
+ // Services such as billing authenticate with their own token, not a session.
305
+ const internalAPI = services.config.internalServiceToken
306
+ ? createInternalRoutes(
307
+ createInternalService(services.database),
308
+ services.config.internalServiceToken
309
+ )
310
+ : new Hono()
311
+
312
+ return new Hono<CloudEnvironment>()
313
+ .use(CLOUD_DISCOVERY_PATH, cloudCORS)
314
+ .use('/api/*', cloudCORS)
315
+ .use('*', async (context, next) => {
316
+ await next()
317
+ if (shouldPreventIndexing(context.req.path, services.config.indexingPolicy)) {
318
+ context.header('X-Robots-Tag', 'noindex, nofollow, noarchive')
319
+ }
320
+ })
321
+ .get('/robots.txt', (context) => {
322
+ context.header('Content-Type', 'text/plain; charset=utf-8')
323
+ return context.body(
324
+ services.config.indexingPolicy === 'deny'
325
+ ? 'User-agent: *\nDisallow: /\n'
326
+ : 'User-agent: *\nDisallow: /admin\nDisallow: /account\nDisallow: /app\nDisallow: /api\nDisallow: /auth\nDisallow: /sign-in\nDisallow: /sign-up\nDisallow: /join\nDisallow: /.well-known\n'
327
+ )
328
+ })
329
+ .get('/health', (context) =>
330
+ context.json({
331
+ status: 'ok' as const,
332
+ protocolVersion: CLOUD_PROTOCOL_VERSION
333
+ })
334
+ )
335
+ .get('/ready', async (context) => {
336
+ try {
337
+ await services.database.selectFrom('workspace').select('id').limit(1).execute()
338
+ const objects = await services.objects.checkReadiness()
339
+ if (!objects.ok) {
340
+ return context.json(
341
+ { status: 'unavailable' as const, dependency: 'object_storage' as const },
342
+ 503
343
+ )
344
+ }
345
+ return context.json({
346
+ status: 'ready' as const,
347
+ objectStorage: {
348
+ checksumVerification: objects.checksumVerification,
349
+ multipartUpload: services.objects.capabilities.multipartUpload
350
+ }
351
+ })
352
+ } catch {
353
+ return context.json({ status: 'unavailable' as const }, 503)
354
+ }
355
+ })
356
+ .get(CLOUD_DISCOVERY_PATH, (context) => context.json(discovery))
357
+ .get(CLOUD_AI_JWKS_PATH, async (context) =>
358
+ aiTokens ? context.json(aiTokens.jwks()) : context.notFound()
359
+ )
360
+ .on(['GET', 'POST'], `${AUTH_BASE_PATH}/*`, (context) => services.auth.handler(context.req.raw))
361
+ .route('/', accountRoutes)
362
+ .route('/', createPictureRoutes(pictures))
363
+ .use('/api/shares/:shareId/collaboration-ticket', publicCollaborationLimiter)
364
+ .use('/api/public/*', publicRateLimiter)
365
+ .use('/api/shares/*', publicRateLimiter)
366
+ .use('/api/invitations/*', publicRateLimiter)
367
+ .route('/api', publicCloudAPI)
368
+ .route('/api/internal', internalAPI)
369
+ .use('/api/*', requireActiveSession)
370
+ .route('/api/admin', admin)
371
+ .use('/api/*', authenticatedMutationLimiter)
372
+ .route('/api', cloudAPI)
373
+ }
374
+
375
+ export type CloudApp = ReturnType<typeof createCloudApp>
@@ -0,0 +1,73 @@
1
+ import type {
2
+ CloudAuthenticationMethod,
3
+ CloudAuthenticationProvider
4
+ } from '#cloud/contract/account'
5
+ import { configuredSocialProviders, type CloudServerConfig } from '#cloud/server/config'
6
+
7
+ import type { CloudAuthAdapter } from './adapter'
8
+
9
+ const supportedProvider = (provider: string): provider is CloudAuthenticationProvider =>
10
+ provider === 'credential' || provider === 'google' || provider === 'apple'
11
+
12
+ export function createAccountAuthenticationService(
13
+ auth: CloudAuthAdapter,
14
+ config: CloudServerConfig
15
+ ) {
16
+ return {
17
+ async methods(headers: Headers) {
18
+ const accounts = await auth.listAuthenticationMethods(headers)
19
+ const methods = accounts.flatMap((account): CloudAuthenticationMethod[] => {
20
+ if (!supportedProvider(account.providerId)) return []
21
+ return [
22
+ {
23
+ id: account.id,
24
+ provider: account.providerId,
25
+ createdAt: account.createdAt.toISOString(),
26
+ canUnlink: accounts.length > 1
27
+ }
28
+ ]
29
+ })
30
+ return {
31
+ methods,
32
+ availableSocialProviders: configuredSocialProviders(config).filter(
33
+ (provider) => !methods.some((method) => method.provider === provider)
34
+ )
35
+ }
36
+ },
37
+ async changePassword(
38
+ headers: Headers,
39
+ input: { currentPassword: string; newPassword: string }
40
+ ): Promise<void> {
41
+ await auth.changePassword(headers, input)
42
+ },
43
+ async startSocialLink(
44
+ headers: Headers,
45
+ input: { provider: 'google' | 'apple'; callbackURL: string }
46
+ ): Promise<string> {
47
+ if (!configuredSocialProviders(config).includes(input.provider)) {
48
+ throw new Error('Authentication provider is unavailable')
49
+ }
50
+ const callback = new URL(input.callbackURL)
51
+ if (callback.origin !== new URL(config.publicURL).origin) {
52
+ throw new Error('Authentication callback origin is unavailable')
53
+ }
54
+ return auth.startSocialLink(headers, { ...input, callbackURL: callback.href })
55
+ },
56
+ async unlink(headers: Headers, methodId: string): Promise<void> {
57
+ await auth.unlinkAuthenticationMethod(headers, methodId)
58
+ },
59
+ /** Asks for a new address; the link that confirms it comes back to this server's pages. */
60
+ async changeEmail(
61
+ headers: Headers,
62
+ input: { newEmail: string; callbackURL: string }
63
+ ): Promise<void> {
64
+ const callback = new URL(input.callbackURL)
65
+ if (callback.origin !== new URL(config.publicURL).origin) {
66
+ throw new Error('Email change callback origin is unavailable')
67
+ }
68
+ await auth.changeEmail(headers, { ...input, callbackURL: callback.href })
69
+ }
70
+ }
71
+ }
72
+
73
+ export type AccountAuthenticationService = ReturnType<typeof createAccountAuthenticationService>
@@ -0,0 +1,213 @@
1
+ import type { CloudAccountSession, CloudSignIn, CloudSignInMethod } from '#cloud/contract'
2
+ import type { CloudDatabase } from '#cloud/server/db'
3
+ import { dateString } from '#cloud/server/sharing/contracts'
4
+ import type { BetterAuthPlugin } from 'better-auth'
5
+ import { createAuthMiddleware, isAPIError } from 'better-auth/api'
6
+ import type { Kysely } from 'kysely'
7
+
8
+ import type { AuthenticationEmailService } from './email'
9
+ import { CORE_AUTH_PATHS, isAuthEndpoint } from './endpoints'
10
+ import { describeUserAgent } from './user-agent'
11
+
12
+ /** The newest sign-ins an account's history shows. */
13
+ const SIGN_IN_HISTORY_LIMIT = 50
14
+
15
+ type Endpoint = { path: string }
16
+
17
+ /** The plugin endpoints that sign someone in, as the server's plugins declare them. */
18
+ export type SignInPluginEndpoints = {
19
+ twoStep: { verifyTOTP: Endpoint; verifyBackupCode: Endpoint }
20
+ passkeys: { verifyPasskeyAuthentication: Endpoint; verifyPasskeyRegistration: Endpoint }
21
+ devices: { deviceToken: Endpoint }
22
+ }
23
+
24
+ /** The Better Auth endpoints that sign someone in, and the method each one is. */
25
+ export type SignInEndpoints = readonly (readonly [path: string, method: CloudSignInMethod])[]
26
+
27
+ /** The sign-in endpoints of the core and of the server's plugins, from their own paths. */
28
+ export function signInEndpoints(plugins: SignInPluginEndpoints): SignInEndpoints {
29
+ return [
30
+ [CORE_AUTH_PATHS.signInEmail, 'password'],
31
+ [plugins.passkeys.verifyPasskeyAuthentication.path, 'passkey'],
32
+ [plugins.twoStep.verifyTOTP.path, 'two-step'],
33
+ [plugins.twoStep.verifyBackupCode.path, 'two-step'],
34
+ [CORE_AUTH_PATHS.verifyEmail, 'email-link'],
35
+ [plugins.devices.deviceToken.path, 'desktop']
36
+ ]
37
+ }
38
+
39
+ /**
40
+ * How an endpoint signed someone in, or null when it signs nobody in, such as one that refreshes
41
+ * a session. A provider's callback names the provider, as Better Auth's own `lastLoginMethod`
42
+ * reads it.
43
+ */
44
+ export function signInMethod(
45
+ endpoint: { path?: string; params?: Record<string, string | undefined> },
46
+ methods: SignInEndpoints
47
+ ): CloudSignInMethod | null {
48
+ if (isAuthEndpoint(endpoint.path, CORE_AUTH_PATHS.callbackOAuth)) {
49
+ const provider = endpoint.params?.id
50
+ return provider === 'google' || provider === 'apple' ? provider : 'other'
51
+ }
52
+ return methods.find(([path]) => isAuthEndpoint(endpoint.path, path))?.[1] ?? null
53
+ }
54
+
55
+ /**
56
+ * Where an account signs in from. Each new session is written down with how it was made, so the
57
+ * account's owner can read its sign-ins and sessions, and a sign-in from an address the account
58
+ * never used before is told to its email; the first sign-in an account makes is not.
59
+ */
60
+ export function createSignInActivity(
61
+ database: Kysely<CloudDatabase>,
62
+ email?: AuthenticationEmailService
63
+ ) {
64
+ return {
65
+ /** Writes down a session an endpoint just issued, and mails a sign-in from a new address. */
66
+ async record(
67
+ issued: {
68
+ session: {
69
+ id: string
70
+ userId: string
71
+ ipAddress?: string | null
72
+ userAgent?: string | null
73
+ }
74
+ user: { email: string; name: string }
75
+ },
76
+ method: CloudSignInMethod
77
+ ): Promise<void> {
78
+ const { session, user } = issued
79
+ // Confirming a new email address issues the session it was confirmed in again.
80
+ const recorded = await database
81
+ .selectFrom('signIn')
82
+ .select('id')
83
+ .where('sessionId', '=', session.id)
84
+ .executeTakeFirst()
85
+ if (recorded) return
86
+ const ipAddress = session.ipAddress || null
87
+ const [known, earlier] = await Promise.all([
88
+ ipAddress
89
+ ? database
90
+ .selectFrom('signIn')
91
+ .select('id')
92
+ .where('userId', '=', session.userId)
93
+ .where('ipAddress', '=', ipAddress)
94
+ .executeTakeFirst()
95
+ : undefined,
96
+ database
97
+ .selectFrom('signIn')
98
+ .select('id')
99
+ .where('userId', '=', session.userId)
100
+ .executeTakeFirst()
101
+ ])
102
+ const id = crypto.randomUUID()
103
+ const signedInAt = new Date()
104
+ await database
105
+ .insertInto('signIn')
106
+ .values({
107
+ id,
108
+ userId: session.userId,
109
+ sessionId: session.id,
110
+ method,
111
+ ipAddress,
112
+ userAgent: session.userAgent || null,
113
+ createdAt: signedInAt
114
+ })
115
+ .execute()
116
+ if (!email || !earlier || known || !ipAddress) return
117
+ await email.sendNewSignIn({
118
+ email: user.email,
119
+ name: user.name,
120
+ signInId: id,
121
+ signedInAt,
122
+ ipAddress,
123
+ ...describeUserAgent(session.userAgent),
124
+ desktop: method === 'desktop'
125
+ })
126
+ },
127
+
128
+ /** The account's sessions that have not expired, newest activity first. */
129
+ async sessions(userId: string, currentSessionId: string): Promise<CloudAccountSession[]> {
130
+ const rows = await database
131
+ .selectFrom('session')
132
+ .leftJoin('signIn', 'signIn.sessionId', 'session.id')
133
+ .select([
134
+ 'session.id',
135
+ 'session.ipAddress',
136
+ 'session.userAgent',
137
+ 'session.createdAt',
138
+ 'session.updatedAt',
139
+ 'session.expiresAt',
140
+ 'signIn.method'
141
+ ])
142
+ .where('session.userId', '=', userId)
143
+ .where('session.expiresAt', '>', new Date())
144
+ .orderBy('session.updatedAt', 'desc')
145
+ .execute()
146
+ return rows.map((row) => ({
147
+ id: row.id,
148
+ current: row.id === currentSessionId,
149
+ method: row.method ?? null,
150
+ ipAddress: row.ipAddress || null,
151
+ ...describeUserAgent(row.userAgent),
152
+ createdAt: dateString(row.createdAt) ?? '',
153
+ lastActiveAt: dateString(row.updatedAt) ?? '',
154
+ expiresAt: dateString(row.expiresAt) ?? ''
155
+ }))
156
+ },
157
+
158
+ async signIns(userId: string, limit = SIGN_IN_HISTORY_LIMIT): Promise<CloudSignIn[]> {
159
+ const rows = await database
160
+ .selectFrom('signIn')
161
+ .select(['id', 'method', 'ipAddress', 'userAgent', 'createdAt'])
162
+ .where('userId', '=', userId)
163
+ .orderBy('createdAt', 'desc')
164
+ .limit(limit)
165
+ .execute()
166
+ return rows.map((row) => ({
167
+ id: row.id,
168
+ method: row.method,
169
+ ipAddress: row.ipAddress,
170
+ ...describeUserAgent(row.userAgent),
171
+ createdAt: dateString(row.createdAt) ?? ''
172
+ }))
173
+ }
174
+ }
175
+ }
176
+
177
+ export type SignInActivity = ReturnType<typeof createSignInActivity>
178
+
179
+ /**
180
+ * Better Auth's side of account activity. After an endpoint issues a session, Better Auth hands
181
+ * it to hooks as `newSession`; two-step sign-in clears it until the second step, so only
182
+ * sessions someone can use are written down. Adding a passkey is told to its owner.
183
+ */
184
+ export function accountActivity(
185
+ activity: SignInActivity,
186
+ plugins: SignInPluginEndpoints,
187
+ onPasskeyAdded: (user: { id: string; email: string; name: string }) => Promise<void>
188
+ ): BetterAuthPlugin {
189
+ const methods = signInEndpoints(plugins)
190
+ return {
191
+ id: 'openpencil-account-activity',
192
+ hooks: {
193
+ after: [
194
+ {
195
+ matcher: (context) => signInMethod(context, methods) !== null,
196
+ handler: createAuthMiddleware(async (context) => {
197
+ const issued = context.context.newSession
198
+ const method = signInMethod(context, methods)
199
+ if (issued && method) await activity.record(issued, method)
200
+ })
201
+ },
202
+ {
203
+ matcher: (context) =>
204
+ isAuthEndpoint(context.path, plugins.passkeys.verifyPasskeyRegistration.path),
205
+ handler: createAuthMiddleware(async (context) => {
206
+ const user = context.context.session?.user
207
+ if (user && !isAPIError(context.context.returned)) await onPasskeyAdded(user)
208
+ })
209
+ }
210
+ ]
211
+ }
212
+ }
213
+ }