@open-pencil/cloud 0.17.0-beta.4 → 0.17.0-beta.6

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 (280) hide show
  1. package/README.md +2 -1
  2. package/dist/bin/server.mjs +1 -1
  3. package/dist/bin/server.mjs.map +1 -1
  4. package/dist/bin/services.mjs +1 -1
  5. package/dist/bin/services.mjs.map +1 -1
  6. package/dist/client.d.ts +783 -47
  7. package/dist/client.d.ts.map +1 -1
  8. package/dist/client.js +1651 -382
  9. package/dist/client.js.map +1 -1
  10. package/dist/contract.d.ts +2 -2
  11. package/dist/contract.js +2 -2
  12. package/dist/contract2.js +701 -45
  13. package/dist/contract2.js.map +1 -1
  14. package/dist/email.d.ts +2138 -34
  15. package/dist/email.d.ts.map +1 -1
  16. package/dist/email.js +4343 -306
  17. package/dist/email.js.map +1 -1
  18. package/dist/errors.d.ts +2 -0
  19. package/dist/errors.js +61 -0
  20. package/dist/errors.js.map +1 -0
  21. package/dist/index.d.ts +1338 -44
  22. package/dist/index.d.ts.map +1 -1
  23. package/dist/index2.d.ts +45 -0
  24. package/dist/index2.d.ts.map +1 -0
  25. package/dist/listen.mjs +958 -340
  26. package/dist/listen.mjs.map +1 -1
  27. package/dist/runtime-cloudflare.d.ts +93 -0
  28. package/dist/runtime-cloudflare.d.ts.map +1 -0
  29. package/dist/runtime-cloudflare.js +18032 -0
  30. package/dist/runtime-cloudflare.js.map +1 -0
  31. package/dist/runtime-node.d.mts +12615 -5249
  32. package/dist/runtime-node.d.mts.map +1 -1
  33. package/dist/server.d.ts +17367 -8567
  34. package/dist/server.d.ts.map +1 -1
  35. package/dist/server.js +13587 -7333
  36. package/dist/server.js.map +1 -1
  37. package/dist/server.mjs +11601 -5401
  38. package/dist/server.mjs.map +1 -1
  39. package/dist/server2.mjs +84 -62
  40. package/dist/server2.mjs.map +1 -1
  41. package/package.json +31 -5
  42. package/src/admin/api/routes.ts +263 -190
  43. package/src/admin/audit/service.ts +11 -3
  44. package/src/admin/bootstrap.ts +86 -0
  45. package/src/admin/documents/service.ts +195 -10
  46. package/src/admin/email/service.ts +2 -1
  47. package/src/admin/enrollment/email.ts +17 -3
  48. package/src/admin/enrollment/service.ts +71 -10
  49. package/src/admin/errors.ts +5 -0
  50. package/src/admin/index.ts +1 -0
  51. package/src/admin/reports/service.ts +15 -3
  52. package/src/admin/schema.ts +6 -5
  53. package/src/admin/users/service.ts +173 -16
  54. package/src/client/api.ts +52 -473
  55. package/src/client/auth/client.ts +22 -3
  56. package/src/client/comments.ts +205 -0
  57. package/src/client/community.ts +40 -0
  58. package/src/client/device-authorization.ts +4 -20
  59. package/src/client/discovery.ts +39 -11
  60. package/src/client/documents.ts +160 -0
  61. package/src/client/files/archive.ts +60 -0
  62. package/src/client/files/checksum.ts +7 -0
  63. package/src/client/files/download.ts +122 -0
  64. package/src/client/files/images.ts +89 -0
  65. package/src/client/files/index.ts +15 -0
  66. package/src/client/files/objects.ts +173 -0
  67. package/src/client/files/save.ts +79 -0
  68. package/src/client/index.ts +4 -0
  69. package/src/client/portal/account.ts +73 -3
  70. package/src/client/portal/administration.ts +52 -5
  71. package/src/client/portal/request.ts +6 -2
  72. package/src/client/response.ts +21 -0
  73. package/src/client/schema.ts +8 -0
  74. package/src/client/services.ts +23 -18
  75. package/src/client/sharing.ts +262 -0
  76. package/src/client/tour.ts +44 -0
  77. package/src/client/versions.ts +110 -0
  78. package/src/contract/account.ts +111 -11
  79. package/src/contract/admin/index.ts +48 -3
  80. package/src/contract/billing.ts +235 -0
  81. package/src/contract/collaboration.ts +5 -0
  82. package/src/contract/comments.ts +223 -0
  83. package/src/contract/community.ts +60 -0
  84. package/src/contract/discovery.ts +94 -5
  85. package/src/contract/entitlements.ts +10 -0
  86. package/src/contract/index.ts +64 -5
  87. package/src/contract/links.ts +62 -4
  88. package/src/contract/locale.ts +27 -0
  89. package/src/contract/portal.ts +12 -1
  90. package/src/contract/relay.ts +3 -1
  91. package/src/contract/routes.ts +10 -0
  92. package/src/contract/services.ts +62 -20
  93. package/src/contract/workspaces.ts +5 -0
  94. package/src/email/i18n.ts +174 -0
  95. package/src/email/index.ts +13 -2
  96. package/src/email/locales/ar.json +169 -0
  97. package/src/email/locales/de.json +169 -0
  98. package/src/email/locales/es.json +169 -0
  99. package/src/email/locales/fr.json +169 -0
  100. package/src/email/locales/it.json +169 -0
  101. package/src/email/locales/ja.json +169 -0
  102. package/src/email/locales/pl.json +169 -0
  103. package/src/email/locales/pt-br.json +169 -0
  104. package/src/email/locales/ru.json +169 -0
  105. package/src/email/locales/zh-cn.json +169 -0
  106. package/src/email/messages.ts +235 -0
  107. package/src/email/render.ts +160 -276
  108. package/src/email/samples.ts +142 -0
  109. package/src/email/schema.ts +98 -8
  110. package/src/email/templates/BrandEmail.vue +56 -0
  111. package/src/email/templates/CommentNotification.vue +39 -0
  112. package/src/email/templates/DocumentBlocked.vue +45 -0
  113. package/src/email/templates/DocumentInvitation.vue +24 -0
  114. package/src/email/templates/DocumentReport.vue +32 -0
  115. package/src/email/templates/DocumentReportDecided.vue +36 -0
  116. package/src/email/templates/DocumentReportReceived.vue +18 -0
  117. package/src/email/templates/DocumentRestored.vue +24 -0
  118. package/src/email/templates/EmailChangeRequested.vue +24 -0
  119. package/src/email/templates/EmailRoot.vue +19 -0
  120. package/src/email/templates/EmailText.vue +9 -0
  121. package/src/email/templates/EmailVerification.vue +38 -0
  122. package/src/email/templates/EnrollmentInvitation.vue +53 -0
  123. package/src/email/templates/EnrollmentNotification.vue +24 -0
  124. package/src/email/templates/EnrollmentUpdate.vue +52 -0
  125. package/src/email/templates/NewSignIn.vue +37 -0
  126. package/src/email/templates/PasswordChanged.vue +22 -0
  127. package/src/email/templates/PasswordReset.vue +23 -0
  128. package/src/email/templates/StorageLimitReached.vue +28 -0
  129. package/src/email/templates/TwoStepChanged.vue +47 -0
  130. package/src/email/templates/WaitlistConfirmation.vue +29 -0
  131. package/src/email/templates/WorkspaceInvitation.vue +28 -0
  132. package/src/email/templates/brand.ts +15 -61
  133. package/src/email/templates/localization.ts +17 -0
  134. package/src/errors/index.ts +6 -0
  135. package/src/{server/errors → errors}/posthog.ts +28 -4
  136. package/src/global.d.ts +7 -0
  137. package/src/runtime/cloudflare/email.ts +2 -0
  138. package/src/runtime/cloudflare/relay/index.ts +28 -7
  139. package/src/runtime/cloudflare/tsconfig.json +2 -1
  140. package/src/runtime/cloudflare/worker.ts +14 -1
  141. package/src/runtime/cloudflare/xml.ts +12 -0
  142. package/src/runtime/node/admin.ts +51 -47
  143. package/src/runtime/node/cleanup.ts +5 -1
  144. package/src/runtime/node/email/runtime.ts +1 -0
  145. package/src/runtime/node/email/transport.ts +14 -10
  146. package/src/runtime/node/main.ts +1 -1
  147. package/src/runtime/node/server.ts +20 -4
  148. package/src/runtime/node/services/main.ts +1 -1
  149. package/src/runtime/posthog/errors.ts +5 -2
  150. package/src/runtime/s3/objects.ts +17 -0
  151. package/src/runtime/site/community.ts +101 -0
  152. package/src/runtime/site/server.ts +17 -1
  153. package/src/server/account/actions.ts +3 -1
  154. package/src/server/account/deletion.ts +40 -4
  155. package/src/server/account/routes.ts +305 -253
  156. package/src/server/account/tokens.ts +57 -0
  157. package/src/server/api/router.ts +44 -6
  158. package/src/server/app/checks.ts +89 -0
  159. package/src/server/app/cors.ts +44 -0
  160. package/src/server/app/editors.ts +20 -0
  161. package/src/server/app/index.ts +128 -0
  162. package/src/server/app/indexing.ts +40 -0
  163. package/src/server/app/limiters.ts +53 -0
  164. package/src/server/app/routes.ts +123 -0
  165. package/src/server/app/services.ts +219 -0
  166. package/src/server/auth/access-control.ts +13 -8
  167. package/src/server/auth/access-tokens.ts +62 -0
  168. package/src/server/auth/account.ts +13 -12
  169. package/src/server/auth/activity.ts +7 -2
  170. package/src/server/auth/adapter.ts +36 -3
  171. package/src/server/auth/email.ts +33 -18
  172. package/src/server/auth/endpoints.ts +4 -0
  173. package/src/server/auth/enrollment.ts +116 -0
  174. package/src/server/auth/factory.ts +165 -189
  175. package/src/server/auth/index.ts +1 -1
  176. package/src/server/auth/logger.ts +23 -0
  177. package/src/server/auth/methods.ts +162 -0
  178. package/src/server/auth/mfa-assurance.ts +190 -2
  179. package/src/server/auth/passwords.ts +43 -0
  180. package/src/server/auth/rate-limit.ts +31 -0
  181. package/src/server/auth/runtime.ts +19 -5
  182. package/src/server/auth/session.ts +2 -0
  183. package/src/server/auth/social-providers.ts +70 -24
  184. package/src/server/billing/index.ts +8 -0
  185. package/src/server/billing/notify.ts +55 -0
  186. package/src/server/billing/routes.ts +27 -0
  187. package/src/server/billing/seats.ts +17 -0
  188. package/src/server/billing/tokens.ts +37 -0
  189. package/src/server/cleanup/configured.ts +16 -3
  190. package/src/server/cleanup/documents.ts +5 -2
  191. package/src/server/cleanup/revisions.ts +6 -3
  192. package/src/server/cleanup/uploads.ts +2 -1
  193. package/src/server/cleanup/worker.ts +10 -1
  194. package/src/server/collaboration/relay/connection.ts +7 -2
  195. package/src/server/collaboration/relay/hub.ts +80 -166
  196. package/src/server/collaboration/relay/room.ts +154 -0
  197. package/src/server/collaboration/routes.ts +8 -5
  198. package/src/server/collaboration/service.ts +21 -2
  199. package/src/server/comments/index.ts +9 -0
  200. package/src/server/comments/notify.ts +277 -0
  201. package/src/server/comments/routes.ts +352 -0
  202. package/src/server/comments/rows.ts +249 -0
  203. package/src/server/comments/service.ts +570 -0
  204. package/src/server/community/index.ts +2 -0
  205. package/src/server/community/routes.ts +93 -0
  206. package/src/server/community/service.ts +134 -0
  207. package/src/server/config/deployment.ts +35 -10
  208. package/src/server/config/index.ts +2 -2
  209. package/src/server/config/public.ts +25 -6
  210. package/src/server/config/schema.ts +53 -293
  211. package/src/server/config/toml/schema.ts +330 -0
  212. package/src/server/db/index.ts +3 -1
  213. package/src/server/db/migrate.ts +33 -1
  214. package/src/server/db/migrations/009_access_tokens.ts +47 -0
  215. package/src/server/db/migrations/010_storage_limit_notices.ts +50 -0
  216. package/src/server/db/migrations/011_account_ids.ts +30 -0
  217. package/src/server/db/migrations/012_email_locales.ts +34 -0
  218. package/src/server/db/migrations/013_document_block_emails.ts +40 -0
  219. package/src/server/db/migrations/014_report_replies.ts +28 -0
  220. package/src/server/db/migrations/015_comments.ts +57 -0
  221. package/src/server/db/migrations/016_comment_notifications.ts +76 -0
  222. package/src/server/db/migrations/017_invitation_emails.ts +19 -0
  223. package/src/server/db/migrations/018_enrollment_source.ts +17 -0
  224. package/src/server/db/migrations/schema.ts +26 -1
  225. package/src/server/db/tables.ts +122 -3
  226. package/src/server/db/users.ts +22 -0
  227. package/src/server/documents/access.ts +17 -0
  228. package/src/server/documents/images.ts +6 -1
  229. package/src/server/documents/index.ts +1 -1
  230. package/src/server/documents/limits.ts +7 -1
  231. package/src/server/documents/routes.ts +12 -12
  232. package/src/server/documents/service.ts +31 -407
  233. package/src/server/documents/summary.ts +15 -0
  234. package/src/server/documents/uploads.ts +450 -0
  235. package/src/server/documents/versions/routes.ts +7 -8
  236. package/src/server/documents/versions/service.ts +86 -26
  237. package/src/server/email/invitations.ts +1 -0
  238. package/src/server/email/service.ts +39 -6
  239. package/src/server/email/types.ts +13 -0
  240. package/src/server/errors/index.ts +49 -12
  241. package/src/server/index.ts +27 -6
  242. package/src/server/internal/routes.ts +8 -2
  243. package/src/server/internal/service.ts +10 -0
  244. package/src/server/invitations/budget.ts +3 -1
  245. package/src/server/invitations/index.ts +1 -0
  246. package/src/server/invitations/links.ts +6 -0
  247. package/src/server/invitations/types.ts +5 -1
  248. package/src/server/objects/types.ts +5 -0
  249. package/src/server/pictures/service.ts +3 -1
  250. package/src/server/policy/configured.ts +9 -3
  251. package/src/server/policy/database.ts +13 -2
  252. package/src/server/policy/policy.ts +39 -12
  253. package/src/server/policy/service.ts +71 -52
  254. package/src/server/policy/storage.ts +33 -0
  255. package/src/server/policy/workspace.ts +5 -2
  256. package/src/server/quota/index.ts +6 -0
  257. package/src/server/quota/notices.ts +121 -0
  258. package/src/server/quota/storage.ts +5 -0
  259. package/src/server/rate-limit/middleware.ts +4 -0
  260. package/src/server/reports/index.ts +1 -0
  261. package/src/server/reports/replies.ts +55 -0
  262. package/src/server/reports/routes.ts +5 -3
  263. package/src/server/reports/service.ts +27 -3
  264. package/src/server/services/routes.ts +2 -2
  265. package/src/server/sharing/capabilities/service.ts +3 -4
  266. package/src/server/sharing/document-routes.ts +3 -3
  267. package/src/server/sharing/invitations/service.ts +17 -8
  268. package/src/server/sharing/routes.ts +15 -15
  269. package/src/server/validation.ts +35 -24
  270. package/src/server/workspaces/members.ts +57 -31
  271. package/src/server/workspaces/repository.ts +23 -12
  272. package/src/server/workspaces/routes.ts +8 -8
  273. package/src/services/app.ts +31 -22
  274. package/src/services/config.ts +48 -8
  275. package/src/services/metering.ts +15 -27
  276. package/src/services/usage.ts +6 -14
  277. package/src/email/templates/document-invitation.ts +0 -35
  278. package/src/email/templates/enrollment.ts +0 -27
  279. package/src/email/templates/layout.ts +0 -18
  280. package/src/server/app.ts +0 -453
@@ -0,0 +1,249 @@
1
+ import type { CloudComment, CloudCommentThread, CommentAnchor } from '#cloud/contract'
2
+ import { userIdText, type CloudDatabase } from '#cloud/server/db'
3
+ import { DocumentNotFoundError } from '#cloud/server/documents/errors'
4
+ import { groupBy } from 'es-toolkit'
5
+ import type { Kysely, Transaction } from 'kysely'
6
+
7
+ export type Source = Kysely<CloudDatabase> | Transaction<CloudDatabase>
8
+
9
+ export type ThreadRow = {
10
+ id: string
11
+ pageId: string
12
+ pageName: string | null
13
+ nodeId: string | null
14
+ nodeName: string | null
15
+ offsetX: number | null
16
+ offsetY: number | null
17
+ x: number
18
+ y: number
19
+ createdBy: string
20
+ createdAt: Date
21
+ updatedAt: Date
22
+ resolvedAt: Date | null
23
+ resolvedBy: string | null
24
+ }
25
+
26
+ type CommentRow = {
27
+ id: string
28
+ threadId: string
29
+ mentions: string[]
30
+ authorId: string | null
31
+ authorName: string | null
32
+ importedAuthorName: string | null
33
+ agent: string | null
34
+ body: string
35
+ createdAt: Date
36
+ editedAt: Date | null
37
+ }
38
+
39
+ function commentOf(row: CommentRow): CloudComment {
40
+ return {
41
+ id: row.id,
42
+ author:
43
+ row.authorId === null
44
+ ? { kind: 'imported', name: row.importedAuthorName ?? '' }
45
+ : { kind: 'user', id: row.authorId, name: row.authorName },
46
+ agent: row.agent,
47
+ body: row.body,
48
+ mentions: row.mentions,
49
+ createdAt: row.createdAt.toISOString(),
50
+ editedAt: row.editedAt?.toISOString() ?? null
51
+ }
52
+ }
53
+
54
+ /**
55
+ * Whether someone other than `viewer` wrote in the thread since `readAt`, or at all when the viewer
56
+ * never read it; never for a guest, who has no account to keep it for.
57
+ */
58
+ function unreadBy(
59
+ comments: readonly CommentRow[],
60
+ viewer: string | null,
61
+ readAt: Date | undefined
62
+ ): boolean {
63
+ if (viewer === null) return false
64
+ return comments.some(
65
+ (comment) => comment.authorId !== viewer && (!readAt || comment.createdAt > readAt)
66
+ )
67
+ }
68
+
69
+ export function threadOf(
70
+ row: ThreadRow,
71
+ comments: readonly CommentRow[],
72
+ viewer: string | null,
73
+ readAt: Date | undefined
74
+ ): CloudCommentThread {
75
+ return {
76
+ id: row.id,
77
+ pageId: row.pageId,
78
+ pageName: row.pageName,
79
+ nodeId: row.nodeId,
80
+ nodeName: row.nodeName,
81
+ offsetX: row.offsetX,
82
+ offsetY: row.offsetY,
83
+ x: row.x,
84
+ y: row.y,
85
+ createdAt: row.createdAt.toISOString(),
86
+ updatedAt: row.updatedAt.toISOString(),
87
+ resolvedAt: row.resolvedAt?.toISOString() ?? null,
88
+ resolvedBy: row.resolvedBy,
89
+ createdBy: row.createdBy,
90
+ unread: unreadBy(comments, viewer, readAt),
91
+ comments: comments.map(commentOf)
92
+ }
93
+ }
94
+
95
+ export function anchorValues(anchor: CommentAnchor) {
96
+ return {
97
+ pageId: anchor.pageId,
98
+ pageName: anchor.pageName,
99
+ nodeId: anchor.nodeId,
100
+ nodeName: anchor.nodeName,
101
+ offsetX: anchor.offsetX,
102
+ offsetY: anchor.offsetY,
103
+ x: anchor.x,
104
+ y: anchor.y
105
+ }
106
+ }
107
+
108
+ /** How many threads the document holds, resolved ones included. */
109
+ export async function documentThreadCount(
110
+ transaction: Transaction<CloudDatabase>,
111
+ documentId: string
112
+ ): Promise<number> {
113
+ const { count } = await transaction
114
+ .selectFrom('commentThread')
115
+ .select((expression) => expression.fn.countAll<string>().as('count'))
116
+ .where('documentId', '=', documentId)
117
+ .executeTakeFirstOrThrow()
118
+ return Number(count)
119
+ }
120
+
121
+ /** Holds the document's row, so one writer at a time counts and adds its threads. */
122
+ export async function lockDocument(transaction: Transaction<CloudDatabase>, documentId: string) {
123
+ await transaction
124
+ .selectFrom('document')
125
+ .select('id')
126
+ .where('id', '=', documentId)
127
+ .forUpdate()
128
+ .executeTakeFirstOrThrow()
129
+ }
130
+
131
+ /** What resolving or reopening sets, or nothing when the thread already is as asked. */
132
+ export function resolutionChange(
133
+ resolved: boolean | undefined,
134
+ isResolved: boolean,
135
+ userId: string
136
+ ) {
137
+ if (resolved === undefined || resolved === isResolved) return {}
138
+ return resolved
139
+ ? { resolvedAt: new Date(), resolvedBy: userId }
140
+ : { resolvedAt: null, resolvedBy: null }
141
+ }
142
+
143
+ /** Threads with what a reply shows of them, to narrow by document or ID. */
144
+ export function threads(source: Source) {
145
+ return source
146
+ .selectFrom('commentThread')
147
+ .select([
148
+ 'commentThread.id',
149
+ 'commentThread.pageId',
150
+ 'commentThread.pageName',
151
+ 'commentThread.nodeId',
152
+ 'commentThread.nodeName',
153
+ 'commentThread.offsetX',
154
+ 'commentThread.offsetY',
155
+ 'commentThread.x',
156
+ 'commentThread.y',
157
+ 'commentThread.createdBy',
158
+ 'commentThread.createdAt',
159
+ 'commentThread.updatedAt',
160
+ 'commentThread.resolvedAt',
161
+ 'commentThread.resolvedBy'
162
+ ])
163
+ }
164
+
165
+ /** The threads' comments, oldest first, each with whom it names. */
166
+ export async function comments(
167
+ source: Source,
168
+ threadIds: readonly string[]
169
+ ): Promise<CommentRow[]> {
170
+ const rows = await source
171
+ .selectFrom('comment')
172
+ .leftJoin('user', (join) => join.onRef(userIdText, '=', 'comment.authorId'))
173
+ .select([
174
+ 'comment.id',
175
+ 'comment.threadId',
176
+ 'comment.authorId',
177
+ 'user.name as authorName',
178
+ 'comment.importedAuthorName',
179
+ 'comment.agent',
180
+ 'comment.body',
181
+ 'comment.createdAt',
182
+ 'comment.editedAt'
183
+ ])
184
+ .where('comment.threadId', 'in', [...threadIds])
185
+ .orderBy('comment.createdAt')
186
+ .orderBy('comment.id')
187
+ .execute()
188
+ if (rows.length === 0) return []
189
+ const mentions = groupBy(
190
+ await source
191
+ .selectFrom('commentMention')
192
+ .select(['commentId', 'userId'])
193
+ .where(
194
+ 'commentId',
195
+ 'in',
196
+ rows.map((row) => row.id)
197
+ )
198
+ .orderBy('createdAt')
199
+ .execute(),
200
+ (mention) => mention.commentId
201
+ )
202
+ return rows.map((row) => ({
203
+ ...row,
204
+ mentions: (mentions[row.id] ?? []).map((mention) => mention.userId)
205
+ }))
206
+ }
207
+
208
+ /** When `viewer` last read each of the threads. */
209
+ export async function readsOf(source: Source, viewer: string | null, threadIds: readonly string[]) {
210
+ if (viewer === null || threadIds.length === 0) return new Map<string, Date>()
211
+ const rows = await source
212
+ .selectFrom('commentRead')
213
+ .select(['threadId', 'readAt'])
214
+ .where('userId', '=', viewer)
215
+ .where('threadId', 'in', [...threadIds])
216
+ .execute()
217
+ return new Map(rows.map((row) => [row.threadId, row.readAt]))
218
+ }
219
+
220
+ /** Records that `userId` has read the thread as it is now. */
221
+ export async function markRead(source: Source, userId: string, threadId: string) {
222
+ const readAt = new Date()
223
+ await source
224
+ .insertInto('commentRead')
225
+ .values({ userId, threadId, readAt })
226
+ // A request that read the thread earlier but lands later never moves the marker back.
227
+ .onConflict((conflict) =>
228
+ conflict
229
+ .columns(['userId', 'threadId'])
230
+ .doUpdateSet({ readAt })
231
+ .where('commentRead.readAt', '<', readAt)
232
+ )
233
+ .execute()
234
+ }
235
+
236
+ export async function findThread(
237
+ source: Source,
238
+ documentId: string,
239
+ threadId: string,
240
+ lock = false
241
+ ) {
242
+ let query = threads(source)
243
+ .where('commentThread.documentId', '=', documentId)
244
+ .where('commentThread.id', '=', threadId)
245
+ if (lock) query = query.forUpdate()
246
+ const row = await query.executeTakeFirst()
247
+ if (!row) throw new DocumentNotFoundError()
248
+ return row
249
+ }