@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,64 @@
1
+ import { readFile } from 'node:fs/promises'
2
+ import { resolve, sep } from 'node:path'
3
+
4
+ import type { SiteFiles } from '#cloud/runtime/site/server'
5
+ import { getMimeType } from 'hono/utils/mime'
6
+
7
+ /**
8
+ * The only request headers Vite reads to pick a reply: which module, style, or page form to send.
9
+ * Others stay behind, such as credentials, ranges, and validators that would get a partial or 304.
10
+ */
11
+ const FORWARDED_HEADERS = ['accept', 'sec-fetch-dest']
12
+
13
+ /** The built site's files in `directory`, never anything outside it. */
14
+ export function nodeSiteFiles(directory: string): SiteFiles {
15
+ const root = resolve(directory)
16
+ return async (path) => {
17
+ let decoded: string
18
+ try {
19
+ decoded = decodeURIComponent(path)
20
+ } catch {
21
+ return null
22
+ }
23
+ const file = resolve(root, `.${decoded}`)
24
+ if (!file.startsWith(`${root}${sep}`)) return null
25
+ try {
26
+ return {
27
+ body: new Uint8Array(await readFile(file)),
28
+ // Documents such as the editor's demo `.fig` have no registered type.
29
+ type: getMimeType(decoded) ?? 'application/octet-stream'
30
+ }
31
+ } catch {
32
+ return null
33
+ }
34
+ }
35
+ }
36
+
37
+ /**
38
+ * The site as the Vite development server at `origin` serves it, for `bun run cloud:dev`: pages,
39
+ * modules, and styles come from source as they are now, so an edit shows without a build.
40
+ */
41
+ export function developmentSiteFiles(origin: string): SiteFiles {
42
+ return async (path, request) => {
43
+ const url = new URL(path, origin)
44
+ const requested = new URL(request.url)
45
+ // Vite tells module requests apart by their query, such as `?import` or `?t=`.
46
+ if (requested.pathname === path) url.search = requested.search
47
+ const headers = new Headers()
48
+ for (const name of FORWARDED_HEADERS) {
49
+ const value = request.headers.get(name)
50
+ if (value !== null) headers.set(name, value)
51
+ }
52
+ try {
53
+ const response = await fetch(url, { headers })
54
+ if (!response.ok || !response.body) return null
55
+ return {
56
+ body: response.body,
57
+ type: response.headers.get('Content-Type') ?? 'application/octet-stream',
58
+ cacheControl: 'no-cache'
59
+ }
60
+ } catch {
61
+ return null
62
+ }
63
+ }
64
+ }
@@ -0,0 +1,19 @@
1
+ import { createCloudDatabase } from '#cloud/server'
2
+ import { PostgresDialect } from 'kysely'
3
+ import { Pool, type PoolConfig } from 'pg'
4
+
5
+ export type PostgresCloudDatabaseOptions = {
6
+ connectionString: string
7
+ pool?: Omit<PoolConfig, 'connectionString'>
8
+ }
9
+
10
+ export function createPostgresCloudDatabase(options: PostgresCloudDatabaseOptions) {
11
+ return createCloudDatabase({
12
+ dialect: new PostgresDialect({
13
+ pool: new Pool({
14
+ ...options.pool,
15
+ connectionString: options.connectionString
16
+ })
17
+ })
18
+ })
19
+ }
@@ -0,0 +1,244 @@
1
+ import type { CloudServerConfig } from '#cloud/server'
2
+ import type { ObjectStore } from '#cloud/server/objects'
3
+ import {
4
+ AbortMultipartUploadCommand,
5
+ CompleteMultipartUploadCommand,
6
+ CreateMultipartUploadCommand,
7
+ DeleteObjectCommand,
8
+ GetObjectCommand,
9
+ HeadObjectCommand,
10
+ PutObjectCommand,
11
+ S3Client,
12
+ UploadPartCommand
13
+ } from '@aws-sdk/client-s3'
14
+ // eslint-disable-next-line open-pencil/no-mixed-case-acronym-identifiers -- Upstream export spelling.
15
+ import { getSignedUrl as getSignedURL } from '@aws-sdk/s3-request-presigner'
16
+
17
+ const CHECKSUM_METADATA_KEY = 'openpencil-sha256'
18
+ const READINESS_BODY = new TextEncoder().encode('openpencil-ready')
19
+ const READINESS_CHECKSUM = 'Hq6g3mmWpyBNobXoWZIz/d0/d8KLjJyEKqNnJh6KXjA='
20
+ const MULTIPART_THRESHOLD = 32 * 1024 * 1024
21
+ const MULTIPART_PART_SIZE = 16 * 1024 * 1024
22
+ const MAX_MULTIPART_PARTS = 10_000
23
+
24
+ type S3ErrorMetadata = {
25
+ $metadata?: {
26
+ httpStatusCode?: number
27
+ }
28
+ }
29
+
30
+ function isNotFoundError(error: unknown): boolean {
31
+ return (
32
+ typeof error === 'object' &&
33
+ error !== null &&
34
+ '$metadata' in error &&
35
+ (error as S3ErrorMetadata).$metadata?.httpStatusCode === 404
36
+ )
37
+ }
38
+
39
+ function encryption(config: CloudServerConfig) {
40
+ return config.s3ServerSideEncryption
41
+ ? {
42
+ ServerSideEncryption: config.s3ServerSideEncryption,
43
+ ...(config.s3KmsKeyId ? { SSEKMSKeyId: config.s3KmsKeyId } : {})
44
+ }
45
+ : {}
46
+ }
47
+
48
+ export function createS3ObjectStore(config: CloudServerConfig): ObjectStore {
49
+ const client = new S3Client({
50
+ endpoint: config.s3Endpoint,
51
+ region: config.s3Region,
52
+ forcePathStyle: config.s3ForcePathStyle,
53
+ requestChecksumCalculation: 'WHEN_REQUIRED',
54
+ responseChecksumValidation: 'WHEN_REQUIRED',
55
+ credentials: {
56
+ accessKeyId: config.s3AccessKeyId,
57
+ secretAccessKey: config.s3SecretAccessKey,
58
+ ...(config.s3SessionToken ? { sessionToken: config.s3SessionToken } : {})
59
+ }
60
+ })
61
+ const nativeSHA256 = config.s3ChecksumVerification === 'native'
62
+
63
+ async function headObject(key: string) {
64
+ return client.send(
65
+ new HeadObjectCommand({
66
+ Bucket: config.s3Bucket,
67
+ Key: key,
68
+ ...(nativeSHA256 ? { ChecksumMode: 'ENABLED' as const } : {})
69
+ })
70
+ )
71
+ }
72
+
73
+ return {
74
+ capabilities: {
75
+ nativeSHA256,
76
+ multipartUpload: true,
77
+ conditionalWrites: false
78
+ },
79
+
80
+ async checkReadiness() {
81
+ const key = `.openpencil/readiness/${crypto.randomUUID()}`
82
+ try {
83
+ await client.send(
84
+ new PutObjectCommand({
85
+ Bucket: config.s3Bucket,
86
+ Key: key,
87
+ Body: READINESS_BODY,
88
+ ContentType: 'application/octet-stream',
89
+ ChecksumSHA256: nativeSHA256 ? READINESS_CHECKSUM : undefined,
90
+ Metadata: { [CHECKSUM_METADATA_KEY]: READINESS_CHECKSUM },
91
+ ...encryption(config)
92
+ })
93
+ )
94
+ const object = await headObject(key)
95
+ const checksum = nativeSHA256
96
+ ? object.ChecksumSHA256
97
+ : object.Metadata?.[CHECKSUM_METADATA_KEY]
98
+ return {
99
+ ok: object.ContentLength === READINESS_BODY.byteLength && checksum === READINESS_CHECKSUM,
100
+ checksumVerification: nativeSHA256 ? 'native' : 'metadata'
101
+ }
102
+ } finally {
103
+ await client.send(new DeleteObjectCommand({ Bucket: config.s3Bucket, Key: key }))
104
+ }
105
+ },
106
+
107
+ async createDownload(input) {
108
+ const expiresIn = Math.max(1, Math.floor((input.expiresAt.getTime() - Date.now()) / 1000))
109
+ const url = await getSignedURL(
110
+ client,
111
+ new GetObjectCommand({ Bucket: config.s3Bucket, Key: input.key }),
112
+ { expiresIn }
113
+ )
114
+ return {
115
+ url,
116
+ method: 'GET',
117
+ headers: {},
118
+ expiresAt: input.expiresAt.toISOString()
119
+ }
120
+ },
121
+
122
+ async createUpload(input) {
123
+ if (input.byteSize > MULTIPART_THRESHOLD) {
124
+ const created = await client.send(
125
+ new CreateMultipartUploadCommand({
126
+ Bucket: config.s3Bucket,
127
+ Key: input.key,
128
+ ContentType: input.contentType,
129
+ Metadata: { [CHECKSUM_METADATA_KEY]: input.checksum },
130
+ ...encryption(config)
131
+ })
132
+ )
133
+ if (!created.UploadId) throw new Error('S3 did not return a multipart upload ID')
134
+ const partCount = Math.ceil(input.byteSize / MULTIPART_PART_SIZE)
135
+ if (partCount > MAX_MULTIPART_PARTS) throw new Error('Object requires too many S3 parts')
136
+ const expiresIn = Math.max(1, Math.floor((input.expiresAt.getTime() - Date.now()) / 1000))
137
+ const parts = await Promise.all(
138
+ Array.from({ length: partCount }, async (_, index) => {
139
+ const partNumber = index + 1
140
+ return {
141
+ partNumber,
142
+ url: await getSignedURL(
143
+ client,
144
+ new UploadPartCommand({
145
+ Bucket: config.s3Bucket,
146
+ Key: input.key,
147
+ UploadId: created.UploadId,
148
+ PartNumber: partNumber
149
+ }),
150
+ { expiresIn }
151
+ ),
152
+ method: 'PUT' as const,
153
+ headers: {}
154
+ }
155
+ })
156
+ )
157
+ return {
158
+ kind: 'multipart',
159
+ uploadId: created.UploadId,
160
+ partSize: MULTIPART_PART_SIZE,
161
+ parts,
162
+ expiresAt: input.expiresAt.toISOString()
163
+ }
164
+ }
165
+ const expiresIn = Math.max(1, Math.floor((input.expiresAt.getTime() - Date.now()) / 1000))
166
+ const command = new PutObjectCommand({
167
+ Bucket: config.s3Bucket,
168
+ Key: input.key,
169
+ ContentType: input.contentType,
170
+ ChecksumSHA256: nativeSHA256 ? input.checksum : undefined,
171
+ Metadata: { [CHECKSUM_METADATA_KEY]: input.checksum },
172
+ ...encryption(config)
173
+ })
174
+ const url = await getSignedURL(client, command, {
175
+ expiresIn,
176
+ unhoistableHeaders: new Set([
177
+ ...(nativeSHA256 ? ['x-amz-checksum-sha256'] : []),
178
+ `x-amz-meta-${CHECKSUM_METADATA_KEY}`
179
+ ])
180
+ })
181
+ return {
182
+ kind: 'single',
183
+ url,
184
+ method: 'PUT',
185
+ headers: {
186
+ 'Content-Type': input.contentType,
187
+ ...(nativeSHA256 ? { 'x-amz-checksum-sha256': input.checksum } : {}),
188
+ [`x-amz-meta-${CHECKSUM_METADATA_KEY}`]: input.checksum
189
+ },
190
+ expiresAt: input.expiresAt.toISOString()
191
+ }
192
+ },
193
+
194
+ async completeUpload(input) {
195
+ await client.send(
196
+ new CompleteMultipartUploadCommand({
197
+ Bucket: config.s3Bucket,
198
+ Key: input.key,
199
+ UploadId: input.uploadId,
200
+ MultipartUpload: {
201
+ Parts: input.parts.map((part) => ({ ETag: part.etag, PartNumber: part.partNumber }))
202
+ }
203
+ })
204
+ )
205
+ },
206
+
207
+ async abortUpload(input) {
208
+ try {
209
+ await client.send(
210
+ new AbortMultipartUploadCommand({
211
+ Bucket: config.s3Bucket,
212
+ Key: input.key,
213
+ UploadId: input.uploadId
214
+ })
215
+ )
216
+ } catch (error) {
217
+ if (!isNotFoundError(error)) throw error
218
+ }
219
+ },
220
+
221
+ async head(key) {
222
+ try {
223
+ const object = await headObject(key)
224
+ const checksum = nativeSHA256
225
+ ? object.ChecksumSHA256
226
+ : object.Metadata?.[CHECKSUM_METADATA_KEY]
227
+ if (object.ContentLength == null || !checksum || !object.ContentType) return null
228
+ return {
229
+ byteSize: object.ContentLength,
230
+ checksum,
231
+ checksumVerification: nativeSHA256 ? 'native' : 'metadata',
232
+ contentType: object.ContentType
233
+ }
234
+ } catch (error) {
235
+ if (isNotFoundError(error)) return null
236
+ throw error
237
+ }
238
+ },
239
+
240
+ async delete(key) {
241
+ await client.send(new DeleteObjectCommand({ Bucket: config.s3Bucket, Key: key }))
242
+ }
243
+ }
244
+ }
@@ -0,0 +1,82 @@
1
+ import { CLOUD_PORTAL_PAGE_ROOTS } from '#cloud/contract'
2
+ import { withIndexingPolicy } from '#cloud/server'
3
+ import { Hono } from 'hono'
4
+
5
+ /** A file of the Cloud site (`bun run build:cloud`): the editor and the portal. */
6
+ export type SiteFile = {
7
+ body: ReadableStream | Uint8Array<ArrayBuffer>
8
+ type: string
9
+ /** Overrides the cache policy built files get, for a site whose files change in place. */
10
+ cacheControl?: string
11
+ }
12
+
13
+ /** Reads the built site's file at a URL path, or null when there is none. */
14
+ export type SiteFiles = (path: string, request: Request) => Promise<SiteFile | null>
15
+
16
+ const PORTAL_PAGE = '/cloud.html'
17
+ const EDITOR_PAGE = '/index.html'
18
+
19
+ const PAGE_HEADERS = {
20
+ 'Content-Type': 'text/html; charset=utf-8',
21
+ 'Cache-Control': 'no-cache',
22
+ // Desktop sign-in approval and the editor must never be framed by another site.
23
+ 'Content-Security-Policy': "frame-ancestors 'none'",
24
+ 'Referrer-Policy': 'no-referrer',
25
+ 'X-Content-Type-Options': 'nosniff'
26
+ }
27
+
28
+ export type CloudServerOptions = {
29
+ /** The built site; without it, the server answers only its API. */
30
+ site?: SiteFiles
31
+ indexingPolicy: 'allow' | 'deny'
32
+ }
33
+
34
+ function cacheControl(path: string): string {
35
+ if (path.startsWith('/assets/')) return 'public, max-age=31536000, immutable'
36
+ return 'public, max-age=3600'
37
+ }
38
+
39
+ /**
40
+ * A Cloud server as every runtime serves it: the portal's `cloud.html` at portal pages, the API
41
+ * everywhere else, and, where the API has nothing, the site's files, or the editor's
42
+ * `index.html` for any other page, whose router knows the editor's own addresses.
43
+ */
44
+ export function createCloudServer(
45
+ api: { fetch(request: Request): Response | Promise<Response> },
46
+ { site, indexingPolicy }: CloudServerOptions
47
+ ) {
48
+ const server = new Hono()
49
+ server.use(async (c, next) => {
50
+ await next()
51
+ c.res = withIndexingPolicy(c.res, c.req.path, indexingPolicy)
52
+ })
53
+ if (site) {
54
+ const pages = CLOUD_PORTAL_PAGE_ROOTS.flatMap((root) => [root, `${root}/*`])
55
+ server.on(['GET', 'HEAD'], pages, async (c) => {
56
+ const page = await site(PORTAL_PAGE, c.req.raw)
57
+ return page ? c.body(page.body, 200, PAGE_HEADERS) : c.notFound()
58
+ })
59
+ server.on(['GET', 'HEAD'], '*', async (c, next) => {
60
+ await next()
61
+ if (c.res.status !== 404) return
62
+ const file = await site(c.req.path, c.req.raw)
63
+ if (file) {
64
+ c.res = file.type.startsWith('text/html')
65
+ ? new Response(file.body, { headers: PAGE_HEADERS })
66
+ : new Response(file.body, {
67
+ headers: {
68
+ 'Content-Type': file.type,
69
+ 'Cache-Control': file.cacheControl ?? cacheControl(c.req.path),
70
+ 'X-Content-Type-Options': 'nosniff'
71
+ }
72
+ })
73
+ return
74
+ }
75
+ if (!c.req.header('Accept')?.includes('text/html')) return
76
+ const editor = await site(EDITOR_PAGE, c.req.raw)
77
+ if (editor) c.res = new Response(editor.body, { headers: PAGE_HEADERS })
78
+ })
79
+ }
80
+ server.all('*', (c) => api.fetch(c.req.raw))
81
+ return server
82
+ }
@@ -0,0 +1,66 @@
1
+ import type { AccountSecurityErrorCode } from '#cloud/contract'
2
+ import type { CloudIdentityResolver, CloudSessionResolver } from '#cloud/server/auth'
3
+ import { APIError } from 'better-auth'
4
+ import type { Context } from 'hono'
5
+
6
+ const ACCOUNT_SECURITY_ERROR_CODES: Record<string, AccountSecurityErrorCode> = {
7
+ INVALID_PASSWORD: 'current_password_invalid',
8
+ PASSWORD_TOO_SHORT: 'password_too_short',
9
+ PASSWORD_TOO_LONG: 'password_too_long',
10
+ FAILED_TO_UNLINK_LAST_ACCOUNT: 'last_authentication_method',
11
+ SESSION_NOT_FRESH: 'session_not_fresh',
12
+ CHANGE_EMAIL_DISABLED: 'email_change_unavailable',
13
+ CURRENT_SESSION: 'current_session',
14
+ EMAIL_UNCHANGED: 'email_unchanged'
15
+ }
16
+
17
+ async function accountAction<Value>(operation: () => Promise<Value>, context: Context) {
18
+ try {
19
+ return await operation()
20
+ } catch (error) {
21
+ if (!(error instanceof APIError)) throw error
22
+ return context.json(
23
+ {
24
+ error: {
25
+ code:
26
+ ACCOUNT_SECURITY_ERROR_CODES[error.body?.code ?? ''] ?? 'authentication_method_failed'
27
+ }
28
+ },
29
+ error.statusCode as 400 | 401 | 403 | 404 | 409 | 422 | 429 | 500
30
+ )
31
+ }
32
+ }
33
+
34
+ function completedMFAResponse(result: Response | undefined, context: Context): Response {
35
+ if (!(result instanceof Response)) return context.json({ ok: true as const })
36
+ if (!result.ok) return result
37
+ const headers = new Headers(result.headers)
38
+ headers.set('Content-Type', 'application/json')
39
+ return new Response(JSON.stringify({ ok: true }), { status: 200, headers })
40
+ }
41
+
42
+ export function createAccountActions(resolveSession: CloudSessionResolver) {
43
+ return {
44
+ accountAction,
45
+ activeAccountAction: async <Value>(
46
+ context: Context,
47
+ operation: () => Promise<Value>
48
+ ): Promise<Value | Response> => {
49
+ if (!(await resolveSession(context.req.raw))) {
50
+ return context.json({ error: { code: 'unauthorized' as const } }, 401)
51
+ }
52
+ return accountAction(operation, context)
53
+ },
54
+ verifiedMFAAction: async (
55
+ context: Context,
56
+ identityResolver: CloudIdentityResolver,
57
+ verify: () => Promise<Response | undefined>
58
+ ): Promise<Response> => {
59
+ if (!(await identityResolver(context.req.raw))) {
60
+ return context.json({ error: { code: 'unauthorized' as const } }, 401)
61
+ }
62
+ const result = await accountAction(verify, context)
63
+ return completedMFAResponse(result instanceof Response ? result : undefined, context)
64
+ }
65
+ }
66
+ }