@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
@@ -0,0 +1,188 @@
1
+ import {
2
+ RELAY_DOCUMENT_PARAM,
3
+ type CollaborationPrincipal,
4
+ type CollaborationTicket,
5
+ type DocumentPermission,
6
+ type ResolveDocumentShareInput
7
+ } from '#cloud/contract'
8
+ import type { CloudActor } from '#cloud/server/auth'
9
+ import type { CloudDatabase } from '#cloud/server/db'
10
+ import { DocumentNotFoundError } from '#cloud/server/documents'
11
+ import { resolveDocumentAccess } from '#cloud/server/documents/access'
12
+ import { CLOUD_FEATURE_KEYS } from '#cloud/server/policy/keys'
13
+ import type { CloudPolicy } from '#cloud/server/policy/policy'
14
+ import type { DocumentSharingService } from '#cloud/server/sharing'
15
+ import { base64url, SignJWT } from 'jose'
16
+ import type { Kysely } from 'kysely'
17
+ import { withQuery } from 'ufo'
18
+
19
+ const TICKET_LIFETIME_SECONDS = 5 * 60
20
+
21
+ async function derivedRoomKey(authSecret: string, documentId: string, roomEpoch: number) {
22
+ const inputBytes = new TextEncoder().encode(`${authSecret}:room:${documentId}:${roomEpoch}`)
23
+ const key = await crypto.subtle.importKey('raw', inputBytes, 'HKDF', false, ['deriveBits'])
24
+ const bits = await crypto.subtle.deriveBits(
25
+ {
26
+ name: 'HKDF',
27
+ hash: 'SHA-256',
28
+ salt: new TextEncoder().encode(`openpencil-cloud:${documentId}`),
29
+ info: new TextEncoder().encode(`collaboration-room:${roomEpoch}`)
30
+ },
31
+ key,
32
+ 256
33
+ )
34
+ return base64url.encode(new Uint8Array(bits))
35
+ }
36
+
37
+ export type CollaborationTicketClaims = {
38
+ authSecret: string
39
+ documentId: string
40
+ principal: CollaborationPrincipal
41
+ permission: DocumentPermission
42
+ roomEpoch: number
43
+ /**
44
+ * The relay that enforces writes; without one the ticket is for peer-to-peer rooms. The ticket's
45
+ * URL names the document, so a runtime can route the socket to where the room lives.
46
+ */
47
+ relayURL?: string
48
+ }
49
+
50
+ /** Signs a ticket for a document's collaboration room once access has been decided. */
51
+ export async function signCollaborationTicket({
52
+ authSecret,
53
+ documentId,
54
+ principal,
55
+ permission,
56
+ roomEpoch,
57
+ relayURL
58
+ }: CollaborationTicketClaims): Promise<CollaborationTicket> {
59
+ const issuedAt = Math.floor(Date.now() / 1000)
60
+ const expiresAtSeconds = issuedAt + TICKET_LIFETIME_SECONDS
61
+ const roomId = `cloud:${documentId}:${roomEpoch}`
62
+ const roomKey = await derivedRoomKey(authSecret, documentId, roomEpoch)
63
+ const claims = {
64
+ documentId,
65
+ roomId,
66
+ principal,
67
+ permission,
68
+ roomEpoch,
69
+ serverEnforcedWrites: Boolean(relayURL)
70
+ }
71
+ const token = await new SignJWT(claims)
72
+ .setProtectedHeader({ alg: 'HS256', typ: 'JWT' })
73
+ .setIssuedAt(issuedAt)
74
+ .setExpirationTime(expiresAtSeconds)
75
+ .setSubject(principal.kind === 'user' ? principal.userId : principal.guestId)
76
+ .sign(new TextEncoder().encode(authSecret))
77
+ return {
78
+ token,
79
+ provider: relayURL ? ('relay' as const) : ('trystero' as const),
80
+ ...(relayURL ? { serverURL: withQuery(relayURL, { [RELAY_DOCUMENT_PARAM]: documentId }) } : {}),
81
+ ...claims,
82
+ roomKey,
83
+ expiresAt: new Date(expiresAtSeconds * 1000).toISOString()
84
+ }
85
+ }
86
+
87
+ export type CollaborationTicketServiceOptions = {
88
+ database: Kysely<CloudDatabase>
89
+ sharing: DocumentSharingService
90
+ authSecret: string
91
+ relayURL?: string
92
+ policy?: CloudPolicy
93
+ deploymentMode?: 'official' | 'self-hosted'
94
+ }
95
+
96
+ export function createCollaborationTicketService({
97
+ database,
98
+ sharing,
99
+ authSecret,
100
+ relayURL,
101
+ policy,
102
+ deploymentMode = 'self-hosted'
103
+ }: CollaborationTicketServiceOptions) {
104
+ return {
105
+ async issueUserTicket(actor: CloudActor, documentId: string): Promise<CollaborationTicket> {
106
+ const access = await resolveDocumentAccess(database, actor.userId, documentId)
107
+ if (!access) throw new DocumentNotFoundError()
108
+ if (policy) {
109
+ const workspace = await database
110
+ .selectFrom('document')
111
+ .select('workspaceId')
112
+ .where('id', '=', documentId)
113
+ .executeTakeFirstOrThrow()
114
+ if (
115
+ !(await policy.boolean(CLOUD_FEATURE_KEYS.collaboration, false, {
116
+ targetingKey: workspace.workspaceId,
117
+ actorId: actor.userId,
118
+ workspaceId: workspace.workspaceId,
119
+ documentId,
120
+ deploymentMode
121
+ }))
122
+ ) {
123
+ throw new DocumentNotFoundError()
124
+ }
125
+ }
126
+ const document = await database
127
+ .selectFrom('document')
128
+ .select('collaborationEpoch')
129
+ .where('id', '=', documentId)
130
+ .where('deletedAt', 'is', null)
131
+ .executeTakeFirst()
132
+ if (!document) throw new DocumentNotFoundError()
133
+ return signCollaborationTicket({
134
+ authSecret,
135
+ documentId,
136
+ principal: { kind: 'user', userId: actor.userId, name: actor.name, email: actor.email },
137
+ permission: access.permission,
138
+ roomEpoch: document.collaborationEpoch,
139
+ relayURL
140
+ })
141
+ },
142
+
143
+ async issueShareTicket(
144
+ shareId: string,
145
+ input: ResolveDocumentShareInput,
146
+ actor?: CloudActor
147
+ ): Promise<CollaborationTicket> {
148
+ const resolved = await sharing.resolveShare(shareId, input, actor)
149
+ if (policy) {
150
+ const workspace = await database
151
+ .selectFrom('document')
152
+ .select('workspaceId')
153
+ .where('id', '=', resolved.documentId)
154
+ .executeTakeFirstOrThrow()
155
+ const context = {
156
+ targetingKey: workspace.workspaceId,
157
+ ...(actor ? { actorId: actor.userId } : {}),
158
+ workspaceId: workspace.workspaceId,
159
+ documentId: resolved.documentId,
160
+ deploymentMode
161
+ }
162
+ if (!(await policy.boolean(CLOUD_FEATURE_KEYS.collaboration, false, context))) {
163
+ throw new DocumentNotFoundError()
164
+ }
165
+ if (!actor && !(await policy.boolean(CLOUD_FEATURE_KEYS.guestPresence, false, context))) {
166
+ throw new DocumentNotFoundError()
167
+ }
168
+ }
169
+ const document = await database
170
+ .selectFrom('document')
171
+ .select('collaborationEpoch')
172
+ .where('id', '=', resolved.documentId)
173
+ .where('deletedAt', 'is', null)
174
+ .executeTakeFirst()
175
+ if (!document) throw new DocumentNotFoundError()
176
+ return signCollaborationTicket({
177
+ authSecret,
178
+ documentId: resolved.documentId,
179
+ principal: resolved.principal,
180
+ permission: resolved.permission,
181
+ roomEpoch: document.collaborationEpoch,
182
+ relayURL
183
+ })
184
+ }
185
+ }
186
+ }
187
+
188
+ export type CollaborationTicketService = ReturnType<typeof createCollaborationTicketService>
@@ -0,0 +1,178 @@
1
+ import { staticEntitlementsFromTOML } from '#cloud/server/policy/static'
2
+ import { parse as parseTOML } from 'smol-toml'
3
+ import * as v from 'valibot'
4
+
5
+ import {
6
+ cloudDeploymentConfigSchema,
7
+ parseCloudServerConfig,
8
+ type CloudDeploymentConfig,
9
+ type CloudSecretReference,
10
+ type CloudServerConfig
11
+ } from './schema'
12
+
13
+ export type CloudEnvironment = Readonly<Record<string, string | undefined>>
14
+
15
+ export function parseCloudDeploymentSource(source: string): CloudDeploymentConfig {
16
+ return v.parse(cloudDeploymentConfigSchema, parseTOML(source))
17
+ }
18
+
19
+ function requiredSecret(environment: CloudEnvironment, reference: CloudSecretReference): string {
20
+ const value = environment[reference.from_env]
21
+ if (!value) throw new Error(`Required secret binding is unavailable: ${reference.from_env}`)
22
+ return value
23
+ }
24
+
25
+ function configuredText(
26
+ environment: CloudEnvironment,
27
+ value: string | CloudSecretReference
28
+ ): string {
29
+ return typeof value === 'string' ? value : requiredSecret(environment, value)
30
+ }
31
+
32
+ function optionalSecret(
33
+ environment: CloudEnvironment,
34
+ reference?: CloudSecretReference
35
+ ): string | undefined {
36
+ return reference ? environment[reference.from_env] : undefined
37
+ }
38
+
39
+ function staticEntitlements(config: CloudDeploymentConfig) {
40
+ if (config.entitlements?.source !== 'static') return undefined
41
+ return staticEntitlementsFromTOML(config.entitlements)
42
+ }
43
+
44
+ function emailConfig(config: CloudDeploymentConfig, environment: CloudEnvironment) {
45
+ if (config.email.transport === 'none') return { emailTransport: 'none' as const }
46
+ if (config.email.transport === 'cloudflare') {
47
+ return { emailTransport: 'cloudflare' as const, emailFrom: config.email.from }
48
+ }
49
+ return {
50
+ emailTransport: 'smtp' as const,
51
+ emailFrom: config.email.from,
52
+ smtpHost: config.email.smtp.host,
53
+ smtpPort: config.email.smtp.port,
54
+ smtpSecure: config.email.smtp.secure,
55
+ smtpUser: optionalSecret(environment, config.email.smtp.user),
56
+ smtpPassword: optionalSecret(environment, config.email.smtp.password)
57
+ }
58
+ }
59
+
60
+ function authenticationConfig(config: CloudDeploymentConfig, environment: CloudEnvironment) {
61
+ const google = config.authentication.providers.google
62
+ const apple = config.authentication.providers.apple
63
+ return {
64
+ googleClientId: google ? configuredText(environment, google.client_id) : undefined,
65
+ googleClientSecret: google ? requiredSecret(environment, google.client_secret) : undefined,
66
+ appleClientId: apple?.client_id,
67
+ appleTeamId: apple?.team_id,
68
+ appleKeyId: apple?.key_id,
69
+ applePrivateKey: apple ? requiredSecret(environment, apple.private_key) : undefined,
70
+ appleAppBundleIdentifier: apple?.app_bundle_identifier
71
+ }
72
+ }
73
+
74
+ function workerConfig(config: CloudDeploymentConfig) {
75
+ const email = config.workers?.email
76
+ const cleanup = config.workers?.cleanup
77
+ return {
78
+ emailBatchSize: email?.batch_size,
79
+ emailIntervalMs: email?.interval_ms,
80
+ emailLeaseDurationMs: email?.lease_ms,
81
+ emailMaximumAttempts: email?.maximum_attempts,
82
+ cleanupEnabled: cleanup?.enabled,
83
+ cleanupBatchSize: cleanup?.batch_size,
84
+ cleanupIntervalMs: cleanup?.interval_ms,
85
+ cleanupLeaseDurationMs: cleanup?.lease_ms,
86
+ documentRetentionMs: config.documents.retention_days * 86_400_000
87
+ }
88
+ }
89
+
90
+ function serviceConfig(config: CloudDeploymentConfig, environment: CloudEnvironment) {
91
+ return {
92
+ aiEndpoint: config.ai?.endpoint,
93
+ aiSigningKey: config.ai ? requiredSecret(environment, config.ai.signing_key) : undefined,
94
+ aiTokenLifetimeSeconds: config.ai ? config.ai.token_lifetime_minutes * 60 : undefined,
95
+ billingPortalURL: config.billing?.portal_url,
96
+ internalServiceToken: config.internal_api
97
+ ? requiredSecret(environment, config.internal_api.service_token)
98
+ : undefined
99
+ }
100
+ }
101
+
102
+ /** Hard limits, whatever a plan allows; each lives in the section it limits. */
103
+ function technicalLimits(config: CloudDeploymentConfig) {
104
+ return {
105
+ maximumUploadBytes: config.object_storage.maximum_upload_bytes,
106
+ maximumCollaborationMessageBytes: config.collaboration.maximum_message_bytes,
107
+ maximumConnectionsPerRoom: config.collaboration.maximum_connections_per_room
108
+ }
109
+ }
110
+
111
+ export function parseCloudDeploymentConfig(
112
+ input: unknown,
113
+ environment: CloudEnvironment
114
+ ): CloudServerConfig {
115
+ const config = v.parse(cloudDeploymentConfigSchema, input)
116
+ return parseCloudServerConfig({
117
+ deployment: config.deployment.mode,
118
+ publicURL: config.deployment.public_url,
119
+ indexingPolicy: config.deployment.indexing,
120
+ trustedOrigins: config.deployment.trusted_origins,
121
+ localEditor: config.deployment.local_editor,
122
+ listingMinimumEditorVersion: config.deployment.listing?.minimum_editor_version,
123
+ databaseURL: requiredSecret(environment, config.database.url),
124
+ authSecret: requiredSecret(environment, config.authentication.secret),
125
+ enrollmentMode: config.authentication.enrollment.mode,
126
+ enrollmentAdminNotificationEmails: config.authentication.enrollment.notification_emails,
127
+ emailPasswordEnabled: config.authentication.email_password.enabled,
128
+ emailPasswordSignUpEnabled: config.authentication.email_password.sign_up,
129
+ emailPasswordMinimumLength: config.authentication.email_password.minimum_password_length,
130
+ emailPasswordMaximumLength: config.authentication.email_password.maximum_password_length,
131
+ emailVerificationExpiresIn:
132
+ config.authentication.email_password.verification_link_lifetime_minutes * 60,
133
+ passwordResetExpiresIn:
134
+ config.authentication.email_password.password_reset_link_lifetime_minutes * 60,
135
+ compromisedPasswordCheck: config.authentication.email_password.compromised_password_check,
136
+ deploymentAdminMFARequired: config.authentication.mfa.required_for_admins,
137
+ totpEnabled: config.authentication.mfa.totp,
138
+ recoveryCodesEnabled: config.authentication.mfa.recovery_codes,
139
+ mfaTrustedDeviceDays: config.authentication.mfa.trusted_device_lifetime_days,
140
+ passkeysEnabled: config.authentication.passkeys.enabled,
141
+ passkeyRPName: config.authentication.passkeys.rp_name,
142
+ captchaProvider: config.authentication.captcha?.provider,
143
+ captchaSiteKey: config.authentication.captcha?.site_key,
144
+ captchaSecretKey: config.authentication.captcha
145
+ ? requiredSecret(environment, config.authentication.captcha.secret_key)
146
+ : undefined,
147
+ captchaAllowedHostnames: config.authentication.captcha?.allowed_hostnames,
148
+ authTrustedIPHeaders: config.authentication.trusted_proxies.headers,
149
+ authTrustedProxies: config.authentication.trusted_proxies.addresses,
150
+ ...authenticationConfig(config, environment),
151
+ s3Endpoint: config.object_storage.endpoint,
152
+ s3Region: config.object_storage.region,
153
+ s3Bucket: config.object_storage.bucket,
154
+ s3AccessKeyId: requiredSecret(environment, config.object_storage.credentials.access_key_id),
155
+ s3SecretAccessKey: requiredSecret(
156
+ environment,
157
+ config.object_storage.credentials.secret_access_key
158
+ ),
159
+ s3SessionToken: environment[config.object_storage.credentials.session_token.from_env],
160
+ s3ForcePathStyle: config.object_storage.force_path_style,
161
+ s3ChecksumVerification: config.object_storage.checksum_verification,
162
+ s3ServerSideEncryption: config.object_storage.server_side_encryption,
163
+ s3KmsKeyId: config.object_storage.kms_key_id,
164
+ relayURL: config.collaboration.relay_url,
165
+ staticEntitlements: staticEntitlements(config),
166
+ ...emailConfig(config, environment),
167
+ ...workerConfig(config),
168
+ ...serviceConfig(config, environment),
169
+ technicalLimits: technicalLimits(config)
170
+ })
171
+ }
172
+
173
+ export function parseCloudDeploymentTOML(
174
+ source: string,
175
+ environment: CloudEnvironment
176
+ ): CloudServerConfig {
177
+ return parseCloudDeploymentConfig(parseCloudDeploymentSource(source), environment)
178
+ }
@@ -0,0 +1,20 @@
1
+ export {
2
+ parseCloudDeploymentConfig,
3
+ parseCloudDeploymentSource,
4
+ parseCloudDeploymentTOML,
5
+ type CloudEnvironment
6
+ } from './deployment'
7
+ export {
8
+ cloudDeploymentConfigSchema,
9
+ type CloudDeploymentConfig,
10
+ type CloudDeploymentInput,
11
+ type CloudSecretReference
12
+ } from './schema'
13
+ export { CLOUD_PROTOCOL_MAX_UPLOAD_BYTES } from '#cloud/contract'
14
+ export {
15
+ CLOUD_DEFAULT_MAX_COLLABORATION_MESSAGE_BYTES,
16
+ CLOUD_DEFAULT_MAX_CONNECTIONS_PER_ROOM,
17
+ type CloudTechnicalLimits
18
+ } from './limits'
19
+ export { cloudDiscoveryFromConfig, configuredSocialProviders } from './public'
20
+ export { CloudConfigError, parseCloudServerConfig, type CloudServerConfig } from './schema'
@@ -0,0 +1,8 @@
1
+ export const CLOUD_DEFAULT_MAX_COLLABORATION_MESSAGE_BYTES = 1024 * 1024
2
+ export const CLOUD_DEFAULT_MAX_CONNECTIONS_PER_ROOM = 1000
3
+
4
+ export type CloudTechnicalLimits = {
5
+ maximumUploadBytes: number
6
+ maximumCollaborationMessageBytes: number
7
+ maximumConnectionsPerRoom: number
8
+ }
@@ -0,0 +1,66 @@
1
+ import {
2
+ CLOUD_AI_CONTRACT_VERSION,
3
+ CLOUD_PROTOCOL_VERSION,
4
+ parseCloudDiscovery,
5
+ type CloudDiscovery
6
+ } from '#cloud/contract'
7
+ import { withoutTrailingSlash } from 'ufo'
8
+
9
+ import type { CloudServerConfig } from './schema'
10
+
11
+ export function configuredSocialProviders(config: CloudServerConfig): Array<'apple' | 'google'> {
12
+ return [
13
+ ...(config.appleClientId ? (['apple'] as const) : []),
14
+ ...(config.googleClientId ? (['google'] as const) : [])
15
+ ]
16
+ }
17
+
18
+ export function cloudDiscoveryFromConfig(config: CloudServerConfig): CloudDiscovery {
19
+ const authentication: CloudDiscovery['authentication'] = {
20
+ socialProviders: configuredSocialProviders(config),
21
+ enterpriseSSO: false,
22
+ enrollmentMode: config.enrollmentMode
23
+ }
24
+ if (config.emailPasswordEnabled) {
25
+ authentication.emailPassword = {
26
+ signIn: true,
27
+ signUp: config.emailPasswordSignUpEnabled,
28
+ minimumPasswordLength: config.emailPasswordMinimumLength
29
+ }
30
+ if (config.captchaProvider && config.captchaSiteKey) {
31
+ authentication.emailPassword.captcha = {
32
+ provider: config.captchaProvider,
33
+ siteKey: config.captchaSiteKey
34
+ }
35
+ }
36
+ }
37
+ if (config.totpEnabled || config.passkeysEnabled) {
38
+ authentication.mfa = {
39
+ deploymentAdminRequired: config.deploymentAdminMFARequired,
40
+ totp: config.totpEnabled,
41
+ passkeys: config.passkeysEnabled,
42
+ recoveryCodes: config.totpEnabled && config.recoveryCodesEnabled
43
+ }
44
+ }
45
+
46
+ return parseCloudDiscovery({
47
+ protocolVersion: CLOUD_PROTOCOL_VERSION,
48
+ deployment: config.deployment,
49
+ apiURL: withoutTrailingSlash(new URL('/api', config.publicURL).href),
50
+ authURL: withoutTrailingSlash(new URL('/api/auth', config.publicURL).href),
51
+ localEditor: config.localEditor,
52
+ authentication,
53
+ capabilities: {
54
+ documents: true,
55
+ workspaces: true,
56
+ collaboration: true
57
+ },
58
+ listing: config.listingMinimumEditorVersion
59
+ ? { minimumEditorVersion: config.listingMinimumEditorVersion }
60
+ : undefined,
61
+ ai: config.aiEndpoint
62
+ ? { endpoint: config.aiEndpoint, contractVersion: CLOUD_AI_CONTRACT_VERSION }
63
+ : undefined,
64
+ billing: config.billingPortalURL ? { portalURL: config.billingPortalURL } : undefined
65
+ })
66
+ }