@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.
- package/LICENSE +202 -0
- package/LICENSE-MIT +21 -0
- package/NOTICE +7 -0
- package/README.md +37 -2
- package/dist/bin/ai-relay.d.mts +1 -0
- package/dist/bin/ai-relay.mjs +31 -0
- package/dist/bin/ai-relay.mjs.map +1 -0
- package/dist/bin/server.d.mts +1 -0
- package/dist/bin/server.mjs +29 -0
- package/dist/bin/server.mjs.map +1 -0
- package/dist/client.d.ts +1520 -0
- package/dist/client.d.ts.map +1 -0
- package/dist/client.js +1917 -0
- package/dist/client.js.map +1 -0
- package/dist/contract.d.ts +2 -0
- package/dist/contract.js +2 -0
- package/dist/contract2.js +1453 -0
- package/dist/contract2.js.map +1 -0
- package/dist/email.d.ts +169 -0
- package/dist/email.d.ts.map +1 -0
- package/dist/email.js +670 -0
- package/dist/email.js.map +1 -0
- package/dist/index.d.ts +1755 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/listen.mjs +1881 -0
- package/dist/listen.mjs.map +1 -0
- package/dist/runtime-node.d.mts +10040 -0
- package/dist/runtime-node.d.mts.map +1 -0
- package/dist/runtime-node.mjs +32 -0
- package/dist/runtime-node.mjs.map +1 -0
- package/dist/server.d.ts +12792 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +8475 -0
- package/dist/server.js.map +1 -0
- package/dist/server.mjs +8324 -0
- package/dist/server.mjs.map +1 -0
- package/dist/server2.mjs +505 -0
- package/dist/server2.mjs.map +1 -0
- package/package.json +124 -4
- package/src/admin/api/routes.ts +223 -0
- package/src/admin/api/security.ts +12 -0
- package/src/admin/audit/service.ts +138 -0
- package/src/admin/email/service.ts +140 -0
- package/src/admin/enrollment/email.ts +77 -0
- package/src/admin/enrollment/service.ts +308 -0
- package/src/admin/errors.ts +20 -0
- package/src/admin/index.ts +19 -0
- package/src/admin/list.ts +61 -0
- package/src/admin/operations/service.ts +70 -0
- package/src/admin/schema.ts +28 -0
- package/src/admin/users/service.ts +369 -0
- package/src/ai-relay/app.ts +251 -0
- package/src/ai-relay/config.ts +120 -0
- package/src/ai-relay/db/index.ts +10 -0
- package/src/ai-relay/db/migrate.ts +32 -0
- package/src/ai-relay/db/migrations/001_usage.ts +26 -0
- package/src/ai-relay/db/schema.ts +20 -0
- package/src/ai-relay/index.ts +18 -0
- package/src/ai-relay/metering.ts +68 -0
- package/src/ai-relay/usage.ts +115 -0
- package/src/client/ai.ts +96 -0
- package/src/client/api.ts +528 -0
- package/src/client/auth/client.ts +188 -0
- package/src/client/auth/failure.ts +54 -0
- package/src/client/auth/navigation.ts +45 -0
- package/src/client/device-authorization.ts +134 -0
- package/src/client/discovery.ts +105 -0
- package/src/client/images.ts +81 -0
- package/src/client/index.ts +53 -0
- package/src/client/portal/account.ts +183 -0
- package/src/client/portal/administration.ts +130 -0
- package/src/client/portal/client.ts +18 -0
- package/src/client/portal/request.ts +115 -0
- package/src/client/response.ts +51 -0
- package/src/client/workspaces.ts +142 -0
- package/src/contract/account.ts +204 -0
- package/src/contract/admin/index.ts +187 -0
- package/src/contract/ai.ts +150 -0
- package/src/contract/collaboration.ts +45 -0
- package/src/contract/discovery.ts +81 -0
- package/src/contract/documents.ts +265 -0
- package/src/contract/entitlements.ts +28 -0
- package/src/contract/index.ts +204 -0
- package/src/contract/links.ts +87 -0
- package/src/contract/portal.ts +11 -0
- package/src/contract/relay.ts +368 -0
- package/src/contract/sharing.ts +191 -0
- package/src/contract/versions.ts +87 -0
- package/src/contract/workspaces.ts +100 -0
- package/src/email/index.ts +14 -0
- package/src/email/render.ts +276 -0
- package/src/email/schema.ts +144 -0
- package/src/email/templates/brand.ts +105 -0
- package/src/email/templates/document-invitation.ts +35 -0
- package/src/email/templates/enrollment.ts +27 -0
- package/src/email/templates/layout.ts +18 -0
- package/src/runtime/cloudflare/email.ts +70 -0
- package/src/runtime/cloudflare/environment.ts +57 -0
- package/src/runtime/cloudflare/index.ts +3 -0
- package/src/runtime/cloudflare/relay.ts +136 -0
- package/src/runtime/cloudflare/site.ts +13 -0
- package/src/runtime/cloudflare/tsconfig.json +21 -0
- package/src/runtime/cloudflare/worker.ts +160 -0
- package/src/runtime/node/admin.ts +59 -0
- package/src/runtime/node/ai-relay/main.ts +35 -0
- package/src/runtime/node/ai-relay/server.ts +63 -0
- package/src/runtime/node/application.ts +50 -0
- package/src/runtime/node/bootstrap.ts +22 -0
- package/src/runtime/node/cleanup.ts +24 -0
- package/src/runtime/node/command.ts +17 -0
- package/src/runtime/node/config.ts +16 -0
- package/src/runtime/node/email/runtime.ts +43 -0
- package/src/runtime/node/email/transport.ts +112 -0
- package/src/runtime/node/entitlements/main.ts +41 -0
- package/src/runtime/node/entitlements/refusal.ts +15 -0
- package/src/runtime/node/index.ts +25 -0
- package/src/runtime/node/listen.ts +35 -0
- package/src/runtime/node/main.ts +29 -0
- package/src/runtime/node/migrate.ts +13 -0
- package/src/runtime/node/quota-reconcile.ts +9 -0
- package/src/runtime/node/relay.ts +54 -0
- package/src/runtime/node/server.ts +121 -0
- package/src/runtime/node/site.ts +64 -0
- package/src/runtime/postgres/database.ts +19 -0
- package/src/runtime/s3/objects.ts +244 -0
- package/src/runtime/site/server.ts +82 -0
- package/src/server/account/actions.ts +66 -0
- package/src/server/account/routes.ts +300 -0
- package/src/server/ai/errors.ts +7 -0
- package/src/server/ai/index.ts +4 -0
- package/src/server/ai/keys.ts +43 -0
- package/src/server/ai/routes.ts +43 -0
- package/src/server/ai/service.ts +70 -0
- package/src/server/api/index.ts +8 -0
- package/src/server/api/router.ts +117 -0
- package/src/server/api/types.ts +7 -0
- package/src/server/app.ts +375 -0
- package/src/server/auth/account.ts +73 -0
- package/src/server/auth/activity.ts +213 -0
- package/src/server/auth/adapter.ts +79 -0
- package/src/server/auth/email.ts +125 -0
- package/src/server/auth/endpoints.ts +57 -0
- package/src/server/auth/factory.ts +583 -0
- package/src/server/auth/index.ts +17 -0
- package/src/server/auth/mfa-assurance.ts +55 -0
- package/src/server/auth/runtime.ts +26 -0
- package/src/server/auth/session.ts +19 -0
- package/src/server/auth/social-providers.ts +55 -0
- package/src/server/auth/user-agent.ts +16 -0
- package/src/server/auth/workspace-access.ts +23 -0
- package/src/server/cleanup/configured.ts +38 -0
- package/src/server/cleanup/documents.ts +231 -0
- package/src/server/cleanup/index.ts +29 -0
- package/src/server/cleanup/objects.ts +27 -0
- package/src/server/cleanup/revisions.ts +232 -0
- package/src/server/cleanup/uploads.ts +129 -0
- package/src/server/cleanup/worker.ts +79 -0
- package/src/server/collaboration/index.ts +28 -0
- package/src/server/collaboration/relay/authorize.ts +53 -0
- package/src/server/collaboration/relay/awareness.ts +104 -0
- package/src/server/collaboration/relay/documents.ts +39 -0
- package/src/server/collaboration/relay/hub.ts +524 -0
- package/src/server/collaboration/relay/index.ts +15 -0
- package/src/server/collaboration/relay/persistence.ts +48 -0
- package/src/server/collaboration/routes.ts +77 -0
- package/src/server/collaboration/service.ts +188 -0
- package/src/server/config/deployment.ts +178 -0
- package/src/server/config/index.ts +20 -0
- package/src/server/config/limits.ts +8 -0
- package/src/server/config/public.ts +66 -0
- package/src/server/config/schema.ts +512 -0
- package/src/server/db/database.ts +15 -0
- package/src/server/db/expressions.ts +13 -0
- package/src/server/db/index.ts +21 -0
- package/src/server/db/migrate.ts +177 -0
- package/src/server/db/migrations/001_foundation.ts +164 -0
- package/src/server/db/migrations/002_upload_cleanup_claims.ts +34 -0
- package/src/server/db/migrations/003_document_cleanup_claims.ts +23 -0
- package/src/server/db/migrations/004_document_sharing.ts +82 -0
- package/src/server/db/migrations/005_document_collaboration_epoch.ts +13 -0
- package/src/server/db/migrations/006_invitation_continuation.ts +27 -0
- package/src/server/db/migrations/007_collaboration_state.ts +25 -0
- package/src/server/db/migrations/008_storage_reservations.ts +37 -0
- package/src/server/db/migrations/009_workspace_entitlements.ts +22 -0
- package/src/server/db/migrations/010_upload_finalization.ts +22 -0
- package/src/server/db/migrations/011_upload_finalization_lease.ts +12 -0
- package/src/server/db/migrations/012_transactional_email.ts +48 -0
- package/src/server/db/migrations/013_admin_enrollment.ts +54 -0
- package/src/server/db/migrations/014_enrollment_email_kinds.ts +30 -0
- package/src/server/db/migrations/015_cloud_rate_limit.ts +22 -0
- package/src/server/db/migrations/016_auth_schema.ts +16 -0
- package/src/server/db/migrations/017_authentication_email_kinds.ts +32 -0
- package/src/server/db/migrations/018_authentication_mfa.ts +78 -0
- package/src/server/db/migrations/019_better_auth_account_issuer.ts +42 -0
- package/src/server/db/migrations/020_workspace_invitations.ts +57 -0
- package/src/server/db/migrations/021_document_versions.ts +66 -0
- package/src/server/db/migrations/022_entitlement_external_version.ts +17 -0
- package/src/server/db/migrations/023_document_images.ts +61 -0
- package/src/server/db/migrations/024_account_activity.ts +66 -0
- package/src/server/db/migrations/025_table_names.ts +58 -0
- package/src/server/db/migrations/026_user_picture.ts +30 -0
- package/src/server/db/migrations/027_document_kind.ts +19 -0
- package/src/server/db/migrations/helpers.ts +78 -0
- package/src/server/db/tables.ts +394 -0
- package/src/server/documents/access.ts +103 -0
- package/src/server/documents/errors.ts +16 -0
- package/src/server/documents/images.ts +407 -0
- package/src/server/documents/index.ts +14 -0
- package/src/server/documents/limits.ts +57 -0
- package/src/server/documents/repository.ts +141 -0
- package/src/server/documents/routes.ts +239 -0
- package/src/server/documents/service.ts +597 -0
- package/src/server/documents/summary.ts +37 -0
- package/src/server/documents/types.ts +14 -0
- package/src/server/documents/versions/checkpoint.ts +98 -0
- package/src/server/documents/versions/history.ts +25 -0
- package/src/server/documents/versions/index.ts +4 -0
- package/src/server/documents/versions/routes.ts +112 -0
- package/src/server/documents/versions/service.ts +397 -0
- package/src/server/email/crypto.ts +57 -0
- package/src/server/email/index.ts +18 -0
- package/src/server/email/invitations.ts +30 -0
- package/src/server/email/service.ts +245 -0
- package/src/server/email/types.ts +56 -0
- package/src/server/email/worker.ts +33 -0
- package/src/server/index.ts +279 -0
- package/src/server/internal/index.ts +8 -0
- package/src/server/internal/routes.ts +41 -0
- package/src/server/internal/schema.ts +10 -0
- package/src/server/internal/service.ts +44 -0
- package/src/server/invitations/index.ts +6 -0
- package/src/server/invitations/types.ts +30 -0
- package/src/server/objects/index.ts +16 -0
- package/src/server/objects/types.ts +81 -0
- package/src/server/pictures/index.ts +9 -0
- package/src/server/pictures/provider.ts +61 -0
- package/src/server/pictures/routes.ts +21 -0
- package/src/server/pictures/service.ts +235 -0
- package/src/server/policy/configured.ts +23 -0
- package/src/server/policy/database.ts +108 -0
- package/src/server/policy/entitlements.ts +29 -0
- package/src/server/policy/index.ts +17 -0
- package/src/server/policy/keys.ts +23 -0
- package/src/server/policy/policy.ts +117 -0
- package/src/server/policy/provider.ts +67 -0
- package/src/server/policy/schema.ts +69 -0
- package/src/server/policy/service.ts +85 -0
- package/src/server/policy/static.ts +62 -0
- package/src/server/quota/index.ts +7 -0
- package/src/server/quota/reconcile.ts +61 -0
- package/src/server/quota/storage.ts +165 -0
- package/src/server/rate-limit/cleanup.ts +16 -0
- package/src/server/rate-limit/index.ts +12 -0
- package/src/server/rate-limit/keys.ts +38 -0
- package/src/server/rate-limit/middleware.ts +137 -0
- package/src/server/rate-limit/postgres.ts +79 -0
- package/src/server/sharing/access.ts +29 -0
- package/src/server/sharing/actor.ts +12 -0
- package/src/server/sharing/capabilities/service.ts +262 -0
- package/src/server/sharing/continuation.ts +85 -0
- package/src/server/sharing/contracts.ts +80 -0
- package/src/server/sharing/crypto.ts +48 -0
- package/src/server/sharing/document-routes.ts +41 -0
- package/src/server/sharing/errors.ts +12 -0
- package/src/server/sharing/grants/service.ts +79 -0
- package/src/server/sharing/http.ts +41 -0
- package/src/server/sharing/index.ts +39 -0
- package/src/server/sharing/invitations/service.ts +315 -0
- package/src/server/sharing/policy.ts +44 -0
- package/src/server/sharing/routes.ts +251 -0
- package/src/server/sharing/service.ts +117 -0
- package/src/server/validation.ts +24 -0
- package/src/server/worker/interval.ts +23 -0
- package/src/server/worker/periodic.ts +42 -0
- package/src/server/workspaces/index.ts +16 -0
- package/src/server/workspaces/members.ts +502 -0
- package/src/server/workspaces/repository.ts +91 -0
- package/src/server/workspaces/routes.ts +198 -0
- package/src/server/workspaces/service.ts +84 -0
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import type { CloudDatabase } from '#cloud/server/db'
|
|
2
|
+
import type { TransactionalEmailService } from '#cloud/server/email'
|
|
3
|
+
import type { Transaction } from 'kysely'
|
|
4
|
+
|
|
5
|
+
import type { EnrollmentStatus } from './service'
|
|
6
|
+
|
|
7
|
+
export type EnrollmentEmailOptions = {
|
|
8
|
+
/**
|
|
9
|
+
* The server's address: its editor, where an approved account goes next, and its own pages,
|
|
10
|
+
* where people sign in and administrators review requests.
|
|
11
|
+
*/
|
|
12
|
+
publicURL: string
|
|
13
|
+
adminRecipients: string[]
|
|
14
|
+
email?: TransactionalEmailService
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
export async function enqueueEnrollmentRequested(
|
|
18
|
+
transaction: Transaction<CloudDatabase>,
|
|
19
|
+
options: EnrollmentEmailOptions,
|
|
20
|
+
input: { enrollmentId: string; email: string; name: string; reason: string; revision: number }
|
|
21
|
+
): Promise<void> {
|
|
22
|
+
if (!options.email) return
|
|
23
|
+
await options.email.enqueue(
|
|
24
|
+
{
|
|
25
|
+
idempotencyKey: `enrollment-requested/${input.enrollmentId}/${input.revision}`,
|
|
26
|
+
kind: 'enrollment-requested',
|
|
27
|
+
recipientEmail: input.email,
|
|
28
|
+
payload: { name: input.name, actionURL: new URL('/auth/sign-in', options.publicURL).href }
|
|
29
|
+
},
|
|
30
|
+
transaction
|
|
31
|
+
)
|
|
32
|
+
for (const recipientEmail of options.adminRecipients) {
|
|
33
|
+
await options.email.enqueue(
|
|
34
|
+
{
|
|
35
|
+
idempotencyKey: `admin-enrollment-notification/${input.enrollmentId}/${input.revision}/${recipientEmail}`,
|
|
36
|
+
kind: 'admin-enrollment-notification',
|
|
37
|
+
recipientEmail,
|
|
38
|
+
payload: {
|
|
39
|
+
requesterEmail: input.email,
|
|
40
|
+
requesterName: input.name,
|
|
41
|
+
reason: input.reason,
|
|
42
|
+
actionURL: new URL('/admin/requests', options.publicURL).href
|
|
43
|
+
}
|
|
44
|
+
},
|
|
45
|
+
transaction
|
|
46
|
+
)
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
export async function enqueueEnrollmentReview(
|
|
51
|
+
transaction: Transaction<CloudDatabase>,
|
|
52
|
+
options: EnrollmentEmailOptions,
|
|
53
|
+
input: {
|
|
54
|
+
enrollmentId: string
|
|
55
|
+
recipientEmail: string
|
|
56
|
+
name: string
|
|
57
|
+
status: Exclude<EnrollmentStatus, 'pending'>
|
|
58
|
+
reviewedAt: Date
|
|
59
|
+
}
|
|
60
|
+
): Promise<void> {
|
|
61
|
+
if (!options.email) return
|
|
62
|
+
await options.email.enqueue(
|
|
63
|
+
{
|
|
64
|
+
idempotencyKey: `enrollment-${input.status}/${input.enrollmentId}/${input.reviewedAt.toISOString()}`,
|
|
65
|
+
kind: `enrollment-${input.status}`,
|
|
66
|
+
recipientEmail: input.recipientEmail,
|
|
67
|
+
payload: {
|
|
68
|
+
name: input.name,
|
|
69
|
+
actionURL:
|
|
70
|
+
input.status === 'approved'
|
|
71
|
+
? options.publicURL
|
|
72
|
+
: new URL('/auth/sign-in', options.publicURL).href
|
|
73
|
+
}
|
|
74
|
+
},
|
|
75
|
+
transaction
|
|
76
|
+
)
|
|
77
|
+
}
|
|
@@ -0,0 +1,308 @@
|
|
|
1
|
+
import { AdminDomainError } from '#cloud/admin/errors'
|
|
2
|
+
import {
|
|
3
|
+
containsPattern,
|
|
4
|
+
countEachFilter,
|
|
5
|
+
listSearch,
|
|
6
|
+
listWindow,
|
|
7
|
+
type AdminListQuery,
|
|
8
|
+
type ListFilters
|
|
9
|
+
} from '#cloud/admin/list'
|
|
10
|
+
import { isUUID } from '#cloud/admin/schema'
|
|
11
|
+
import { enrollmentStatusSchema } from '#cloud/contract'
|
|
12
|
+
import type { CloudDatabase } from '#cloud/server/db'
|
|
13
|
+
import { compact, uniq } from 'es-toolkit'
|
|
14
|
+
import type { Kysely } from 'kysely'
|
|
15
|
+
|
|
16
|
+
import {
|
|
17
|
+
enqueueEnrollmentRequested,
|
|
18
|
+
enqueueEnrollmentReview,
|
|
19
|
+
type EnrollmentEmailOptions
|
|
20
|
+
} from './email'
|
|
21
|
+
|
|
22
|
+
export type EnrollmentStatus = 'pending' | 'approved' | 'rejected' | 'revoked'
|
|
23
|
+
export type EnrollmentMode = 'open' | 'approval' | 'closed'
|
|
24
|
+
|
|
25
|
+
export type EnrollmentRequestInput = { email: string; name?: string; reason?: string }
|
|
26
|
+
export type EnrollmentReviewInput = { note?: string }
|
|
27
|
+
export type EnrollmentRecord = {
|
|
28
|
+
id: string
|
|
29
|
+
email: string
|
|
30
|
+
name: string | null
|
|
31
|
+
reason: string | null
|
|
32
|
+
status: EnrollmentStatus
|
|
33
|
+
requestedAt: string
|
|
34
|
+
reviewedAt: string | null
|
|
35
|
+
reviewedBy: string | null
|
|
36
|
+
reviewerName?: string | null
|
|
37
|
+
reviewNote: string | null
|
|
38
|
+
approvedUserId: string | null
|
|
39
|
+
requestRevision: number
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
type EnrollmentRow = {
|
|
43
|
+
id: string
|
|
44
|
+
emailNormalized: string
|
|
45
|
+
name: string | null
|
|
46
|
+
reason: string | null
|
|
47
|
+
status: EnrollmentStatus
|
|
48
|
+
requestedAt: Date | string
|
|
49
|
+
reviewedAt: Date | string | null
|
|
50
|
+
reviewedBy: string | null
|
|
51
|
+
reviewNote: string | null
|
|
52
|
+
approvedUserId: string | null
|
|
53
|
+
requestRevision: number
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
const ALLOWED_TRANSITIONS: Record<EnrollmentStatus, ReadonlySet<EnrollmentStatus>> = {
|
|
57
|
+
pending: new Set(['approved', 'rejected']),
|
|
58
|
+
approved: new Set(['revoked']),
|
|
59
|
+
rejected: new Set(['pending', 'approved']),
|
|
60
|
+
revoked: new Set(['pending', 'approved'])
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** Requests by their status; each is in exactly one. */
|
|
64
|
+
const FILTERS: ListFilters<EnrollmentStatus, 'enrollment'> = {
|
|
65
|
+
pending: (expression) => expression('status', '=', 'pending'),
|
|
66
|
+
approved: (expression) => expression('status', '=', 'approved'),
|
|
67
|
+
rejected: (expression) => expression('status', '=', 'rejected'),
|
|
68
|
+
revoked: (expression) => expression('status', '=', 'revoked')
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
function dateString(value: Date | string | null): string | null {
|
|
72
|
+
return value ? new Date(value).toISOString() : null
|
|
73
|
+
}
|
|
74
|
+
function enrollmentRecord(row: EnrollmentRow): EnrollmentRecord {
|
|
75
|
+
return {
|
|
76
|
+
id: row.id,
|
|
77
|
+
email: row.emailNormalized,
|
|
78
|
+
name: row.name,
|
|
79
|
+
reason: row.reason,
|
|
80
|
+
status: row.status,
|
|
81
|
+
requestedAt: dateString(row.requestedAt) ?? '',
|
|
82
|
+
reviewedAt: dateString(row.reviewedAt),
|
|
83
|
+
reviewedBy: row.reviewedBy,
|
|
84
|
+
reviewNote: row.reviewNote,
|
|
85
|
+
approvedUserId: row.approvedUserId,
|
|
86
|
+
requestRevision: row.requestRevision
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
export function normalizeEnrollmentEmail(value: string): string {
|
|
90
|
+
return value.trim().toLowerCase()
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
export function createEnrollmentService(
|
|
94
|
+
database: Kysely<CloudDatabase>,
|
|
95
|
+
emailOptions: EnrollmentEmailOptions = { publicURL: '', adminRecipients: [] }
|
|
96
|
+
) {
|
|
97
|
+
const statusForEmail = async (email: string): Promise<EnrollmentStatus | null> => {
|
|
98
|
+
const row = await database
|
|
99
|
+
.selectFrom('enrollment')
|
|
100
|
+
.select('status')
|
|
101
|
+
.where('emailNormalized', '=', normalizeEnrollmentEmail(email))
|
|
102
|
+
.executeTakeFirst()
|
|
103
|
+
return row?.status ?? null
|
|
104
|
+
}
|
|
105
|
+
return {
|
|
106
|
+
async request(input: EnrollmentRequestInput): Promise<void> {
|
|
107
|
+
const emailNormalized = normalizeEnrollmentEmail(input.email)
|
|
108
|
+
await database.transaction().execute(async (transaction) => {
|
|
109
|
+
const existing = await transaction
|
|
110
|
+
.selectFrom('enrollment')
|
|
111
|
+
.selectAll()
|
|
112
|
+
.where('emailNormalized', '=', emailNormalized)
|
|
113
|
+
.forUpdate()
|
|
114
|
+
.executeTakeFirst()
|
|
115
|
+
if (existing?.status === 'approved' || existing?.status === 'pending') return
|
|
116
|
+
const revision = (existing?.requestRevision ?? 0) + 1
|
|
117
|
+
const values = {
|
|
118
|
+
name: input.name?.trim() || existing?.name || null,
|
|
119
|
+
reason: input.reason?.trim() || null,
|
|
120
|
+
status: 'pending' as const,
|
|
121
|
+
reviewedAt: null,
|
|
122
|
+
reviewedBy: null,
|
|
123
|
+
reviewNote: null,
|
|
124
|
+
requestRevision: revision
|
|
125
|
+
}
|
|
126
|
+
let row: EnrollmentRow
|
|
127
|
+
if (existing) {
|
|
128
|
+
row = await transaction
|
|
129
|
+
.updateTable('enrollment')
|
|
130
|
+
.set(values)
|
|
131
|
+
.where('id', '=', existing.id)
|
|
132
|
+
.returningAll()
|
|
133
|
+
.executeTakeFirstOrThrow()
|
|
134
|
+
} else {
|
|
135
|
+
row = await transaction
|
|
136
|
+
.insertInto('enrollment')
|
|
137
|
+
.values({
|
|
138
|
+
id: crypto.randomUUID(),
|
|
139
|
+
emailNormalized,
|
|
140
|
+
...values,
|
|
141
|
+
approvedUserId: null
|
|
142
|
+
})
|
|
143
|
+
.returningAll()
|
|
144
|
+
.executeTakeFirstOrThrow()
|
|
145
|
+
}
|
|
146
|
+
await enqueueEnrollmentRequested(transaction, emailOptions, {
|
|
147
|
+
enrollmentId: row.id,
|
|
148
|
+
email: row.emailNormalized,
|
|
149
|
+
name: row.name ?? 'there',
|
|
150
|
+
reason: row.reason ?? 'No reason provided.',
|
|
151
|
+
revision
|
|
152
|
+
})
|
|
153
|
+
})
|
|
154
|
+
},
|
|
155
|
+
statusForEmail,
|
|
156
|
+
async isApproved(email: string): Promise<boolean> {
|
|
157
|
+
return (await statusForEmail(email)) === 'approved'
|
|
158
|
+
},
|
|
159
|
+
/** A page of requests in one status, newest first, with how many match the search in each. */
|
|
160
|
+
async list(query: AdminListQuery<EnrollmentStatus> = {}) {
|
|
161
|
+
const search = listSearch(query)
|
|
162
|
+
const status = query.filter ?? 'pending'
|
|
163
|
+
const { limit, offset } = listWindow(query)
|
|
164
|
+
let searched = database.selectFrom('enrollment')
|
|
165
|
+
if (search) {
|
|
166
|
+
const pattern = containsPattern(search)
|
|
167
|
+
searched = searched.where((expression) =>
|
|
168
|
+
expression.or([
|
|
169
|
+
expression('name', 'ilike', pattern),
|
|
170
|
+
expression('emailNormalized', 'ilike', pattern)
|
|
171
|
+
])
|
|
172
|
+
)
|
|
173
|
+
}
|
|
174
|
+
const counts = await countEachFilter(searched, enrollmentStatusSchema.options, FILTERS)
|
|
175
|
+
const rows = await searched
|
|
176
|
+
.where(FILTERS[status])
|
|
177
|
+
.selectAll()
|
|
178
|
+
.orderBy('requestedAt', 'desc')
|
|
179
|
+
.orderBy('id', 'desc')
|
|
180
|
+
.limit(limit)
|
|
181
|
+
.offset(offset)
|
|
182
|
+
.execute()
|
|
183
|
+
// Reviewers are named by account ID; anything else names no one.
|
|
184
|
+
const reviewerIds = uniq(compact(rows.map((row) => row.reviewedBy))).filter(isUUID)
|
|
185
|
+
const reviewers = reviewerIds.length
|
|
186
|
+
? await database
|
|
187
|
+
.selectFrom('user')
|
|
188
|
+
.select(['id', 'name'])
|
|
189
|
+
.where('id', 'in', reviewerIds)
|
|
190
|
+
.execute()
|
|
191
|
+
: []
|
|
192
|
+
const names = new Map(reviewers.map((reviewer) => [reviewer.id, reviewer.name]))
|
|
193
|
+
const enrollments = rows.map((row) => ({
|
|
194
|
+
...enrollmentRecord(row),
|
|
195
|
+
reviewerName: row.reviewedBy ? (names.get(row.reviewedBy) ?? null) : null
|
|
196
|
+
}))
|
|
197
|
+
return { enrollments, total: counts[status], counts }
|
|
198
|
+
},
|
|
199
|
+
async review(
|
|
200
|
+
actorId: string,
|
|
201
|
+
enrollmentId: string,
|
|
202
|
+
status: Exclude<EnrollmentStatus, 'pending'>,
|
|
203
|
+
input: EnrollmentReviewInput
|
|
204
|
+
): Promise<EnrollmentRecord> {
|
|
205
|
+
return database.transaction().execute(async (transaction) => {
|
|
206
|
+
const current = await transaction
|
|
207
|
+
.selectFrom('enrollment')
|
|
208
|
+
.selectAll()
|
|
209
|
+
.where('id', '=', enrollmentId)
|
|
210
|
+
.forUpdate()
|
|
211
|
+
.executeTakeFirstOrThrow()
|
|
212
|
+
if (!ALLOWED_TRANSITIONS[current.status].has(status)) {
|
|
213
|
+
throw new AdminDomainError(
|
|
214
|
+
'invalid_enrollment_transition',
|
|
215
|
+
`Enrollment cannot transition from ${current.status} to ${status}`
|
|
216
|
+
)
|
|
217
|
+
}
|
|
218
|
+
const now = new Date()
|
|
219
|
+
const approvedUser =
|
|
220
|
+
status === 'approved'
|
|
221
|
+
? await transaction
|
|
222
|
+
.selectFrom('user')
|
|
223
|
+
.select('id')
|
|
224
|
+
.where('email', '=', current.emailNormalized)
|
|
225
|
+
.executeTakeFirst()
|
|
226
|
+
: undefined
|
|
227
|
+
const row = await transaction
|
|
228
|
+
.updateTable('enrollment')
|
|
229
|
+
.set({
|
|
230
|
+
status,
|
|
231
|
+
reviewedAt: now,
|
|
232
|
+
reviewedBy: actorId,
|
|
233
|
+
reviewNote: input.note?.trim() || null,
|
|
234
|
+
approvedUserId: approvedUser?.id ?? current.approvedUserId
|
|
235
|
+
})
|
|
236
|
+
.where('id', '=', enrollmentId)
|
|
237
|
+
.where('status', '=', current.status)
|
|
238
|
+
.returningAll()
|
|
239
|
+
.executeTakeFirstOrThrow()
|
|
240
|
+
await transaction
|
|
241
|
+
.insertInto('adminAuditEvent')
|
|
242
|
+
.values({
|
|
243
|
+
id: crypto.randomUUID(),
|
|
244
|
+
actorUserId: actorId,
|
|
245
|
+
action: `enrollment.${status}`,
|
|
246
|
+
subjectType: 'enrollment',
|
|
247
|
+
subjectId: enrollmentId,
|
|
248
|
+
metadata: { email: row.emailNormalized },
|
|
249
|
+
createdAt: now
|
|
250
|
+
})
|
|
251
|
+
.execute()
|
|
252
|
+
await enqueueEnrollmentReview(transaction, emailOptions, {
|
|
253
|
+
enrollmentId,
|
|
254
|
+
recipientEmail: row.emailNormalized,
|
|
255
|
+
name: row.name ?? 'there',
|
|
256
|
+
status,
|
|
257
|
+
reviewedAt: now
|
|
258
|
+
})
|
|
259
|
+
return enrollmentRecord(row)
|
|
260
|
+
})
|
|
261
|
+
},
|
|
262
|
+
async bindApprovedUser(email: string, userId: string): Promise<void> {
|
|
263
|
+
await database
|
|
264
|
+
.updateTable('enrollment')
|
|
265
|
+
.set({ approvedUserId: userId })
|
|
266
|
+
.where('emailNormalized', '=', normalizeEnrollmentEmail(email))
|
|
267
|
+
.where('status', '=', 'approved')
|
|
268
|
+
.execute()
|
|
269
|
+
},
|
|
270
|
+
/**
|
|
271
|
+
* Moves an approved account's enrollment to the address it changed to, so the approval stays
|
|
272
|
+
* with the account rather than with an address it no longer uses. Any other request from the
|
|
273
|
+
* new address gives way to it.
|
|
274
|
+
*/
|
|
275
|
+
async followEmailChange(userId: string, email: string): Promise<void> {
|
|
276
|
+
const emailNormalized = normalizeEnrollmentEmail(email)
|
|
277
|
+
await database.transaction().execute(async (transaction) => {
|
|
278
|
+
const approved = await transaction
|
|
279
|
+
.selectFrom('enrollment')
|
|
280
|
+
.select(['id', 'emailNormalized'])
|
|
281
|
+
.where('approvedUserId', '=', userId)
|
|
282
|
+
.where('status', '=', 'approved')
|
|
283
|
+
.forUpdate()
|
|
284
|
+
.executeTakeFirst()
|
|
285
|
+
if (!approved || approved.emailNormalized === emailNormalized) return
|
|
286
|
+
await transaction
|
|
287
|
+
.deleteFrom('enrollment')
|
|
288
|
+
.where('emailNormalized', '=', emailNormalized)
|
|
289
|
+
.where('id', '!=', approved.id)
|
|
290
|
+
.execute()
|
|
291
|
+
await transaction
|
|
292
|
+
.updateTable('enrollment')
|
|
293
|
+
.set({ emailNormalized })
|
|
294
|
+
.where('id', '=', approved.id)
|
|
295
|
+
.execute()
|
|
296
|
+
})
|
|
297
|
+
},
|
|
298
|
+
async pendingCount(): Promise<number> {
|
|
299
|
+
const row = await database
|
|
300
|
+
.selectFrom('enrollment')
|
|
301
|
+
.select(({ fn }) => fn.countAll<number>().as('count'))
|
|
302
|
+
.where('status', '=', 'pending')
|
|
303
|
+
.executeTakeFirstOrThrow()
|
|
304
|
+
return Number(row.count)
|
|
305
|
+
}
|
|
306
|
+
}
|
|
307
|
+
}
|
|
308
|
+
export type EnrollmentService = ReturnType<typeof createEnrollmentService>
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
export type AdminErrorCode =
|
|
2
|
+
| 'invalid_enrollment_transition'
|
|
3
|
+
| 'last_admin_required'
|
|
4
|
+
| 'self_admin_action_forbidden'
|
|
5
|
+
| 'email_regeneration_unavailable'
|
|
6
|
+
| 'mfa_required'
|
|
7
|
+
|
|
8
|
+
export class AdminDomainError extends Error {
|
|
9
|
+
override readonly name = 'AdminDomainError'
|
|
10
|
+
constructor(
|
|
11
|
+
readonly code: AdminErrorCode,
|
|
12
|
+
message: string
|
|
13
|
+
) {
|
|
14
|
+
super(message)
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
export function adminErrorStatus(error: AdminDomainError): 400 | 409 {
|
|
19
|
+
return error.code === 'invalid_enrollment_transition' ? 409 : 400
|
|
20
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
export { adminErrorStatus, AdminDomainError, type AdminErrorCode } from './errors'
|
|
2
|
+
export {
|
|
3
|
+
createCloudAdminRoutes,
|
|
4
|
+
type CloudAdminRoutes,
|
|
5
|
+
type CloudAdminServices
|
|
6
|
+
} from './api/routes'
|
|
7
|
+
export { createAdminAuditService, type AdminAuditService } from './audit/service'
|
|
8
|
+
export { createAdminEmailService, type AdminEmailService } from './email/service'
|
|
9
|
+
export { PostgresRateLimitStore } from '#cloud/server/rate-limit'
|
|
10
|
+
export {
|
|
11
|
+
createEnrollmentService,
|
|
12
|
+
normalizeEnrollmentEmail,
|
|
13
|
+
type EnrollmentMode,
|
|
14
|
+
type EnrollmentRecord,
|
|
15
|
+
type EnrollmentService,
|
|
16
|
+
type EnrollmentStatus
|
|
17
|
+
} from './enrollment/service'
|
|
18
|
+
export { createAdminOperationsService, type AdminOperationsService } from './operations/service'
|
|
19
|
+
export { createAdminUserService, type AdminUserService } from './users/service'
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import { ADMIN_LIST_MAXIMUM } from '#cloud/admin/schema'
|
|
2
|
+
import type { CloudDatabase } from '#cloud/server/db'
|
|
3
|
+
import { clamp, zipObject } from 'es-toolkit'
|
|
4
|
+
import type { Expression, ExpressionBuilder, SelectQueryBuilder, SqlBool } from 'kysely'
|
|
5
|
+
|
|
6
|
+
/** The rows an admin list returns when the request does not say. */
|
|
7
|
+
export const ADMIN_PAGE_SIZE = 50
|
|
8
|
+
|
|
9
|
+
/** What every admin list takes: words to search for, one of its filters, and a page. */
|
|
10
|
+
export type AdminListQuery<Filter extends string> = {
|
|
11
|
+
search?: string
|
|
12
|
+
filter?: Filter
|
|
13
|
+
limit?: number
|
|
14
|
+
offset?: number
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
/** A `like` pattern that finds `search` anywhere, matching `%`, `_`, and `\` literally. */
|
|
18
|
+
export function containsPattern(search: string): string {
|
|
19
|
+
return `%${search.replace(/[\\%_]/g, (character) => `\\${character}`)}%`
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/** The search words, or undefined when there are none. */
|
|
23
|
+
export function listSearch(query: AdminListQuery<string>): string | undefined {
|
|
24
|
+
return query.search?.trim() || undefined
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
/** The page a query asks for, kept within what one request may return. */
|
|
28
|
+
export function listWindow(query: AdminListQuery<string>) {
|
|
29
|
+
return {
|
|
30
|
+
limit: clamp(query.limit ?? ADMIN_PAGE_SIZE, 1, ADMIN_LIST_MAXIMUM),
|
|
31
|
+
offset: Math.max(0, query.offset ?? 0)
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/** A list's filters, each the condition its rows meet; the same one counts them and pages them. */
|
|
36
|
+
export type ListFilters<Filter extends string, Table extends keyof CloudDatabase> = Record<
|
|
37
|
+
Filter,
|
|
38
|
+
(expression: ExpressionBuilder<CloudDatabase, Table>) => Expression<SqlBool>
|
|
39
|
+
>
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* How many of `searched`'s rows meet each filter, in one query: each count is an aggregate with a
|
|
43
|
+
* `filter (where …)` clause rather than a query of its own.
|
|
44
|
+
*/
|
|
45
|
+
export async function countEachFilter<Filter extends string, Table extends keyof CloudDatabase>(
|
|
46
|
+
searched: SelectQueryBuilder<CloudDatabase, Table, object>,
|
|
47
|
+
names: readonly Filter[],
|
|
48
|
+
filters: ListFilters<Filter, Table>
|
|
49
|
+
): Promise<Record<Filter, number>> {
|
|
50
|
+
// Kysely names each column after its filter but cannot type a generic name, so the row is read
|
|
51
|
+
// as counts by name.
|
|
52
|
+
const row: Record<string, unknown> = await searched
|
|
53
|
+
.select((expression) =>
|
|
54
|
+
names.map((name) => expression.fn.countAll<number>().filterWhere(filters[name]).as(name))
|
|
55
|
+
)
|
|
56
|
+
.executeTakeFirstOrThrow()
|
|
57
|
+
return zipObject(
|
|
58
|
+
names,
|
|
59
|
+
names.map((name) => Number(row[name]))
|
|
60
|
+
)
|
|
61
|
+
}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import type { CloudServerConfig } from '#cloud/server/config'
|
|
2
|
+
import type { CloudDatabase } from '#cloud/server/db'
|
|
3
|
+
import type { Kysely } from 'kysely'
|
|
4
|
+
|
|
5
|
+
export function createAdminOperationsService(
|
|
6
|
+
database: Kysely<CloudDatabase>,
|
|
7
|
+
config: CloudServerConfig
|
|
8
|
+
) {
|
|
9
|
+
async function emailCount(status: 'pending' | 'failed'): Promise<number> {
|
|
10
|
+
const row = await database
|
|
11
|
+
.selectFrom('transactionalEmail')
|
|
12
|
+
.select(({ fn }) => fn.countAll<number>().as('count'))
|
|
13
|
+
.where('status', '=', status)
|
|
14
|
+
.executeTakeFirstOrThrow()
|
|
15
|
+
return Number(row.count)
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
return {
|
|
19
|
+
async summary() {
|
|
20
|
+
const [
|
|
21
|
+
pendingEnrollment,
|
|
22
|
+
pendingEmail,
|
|
23
|
+
failedEmail,
|
|
24
|
+
accounts,
|
|
25
|
+
workspaces,
|
|
26
|
+
documents,
|
|
27
|
+
stored
|
|
28
|
+
] = await Promise.all([
|
|
29
|
+
database
|
|
30
|
+
.selectFrom('enrollment')
|
|
31
|
+
.select(({ fn }) => fn.countAll<number>().as('count'))
|
|
32
|
+
.where('status', '=', 'pending')
|
|
33
|
+
.executeTakeFirstOrThrow(),
|
|
34
|
+
emailCount('pending'),
|
|
35
|
+
emailCount('failed'),
|
|
36
|
+
database
|
|
37
|
+
.selectFrom('user')
|
|
38
|
+
.select(({ fn }) => fn.countAll<number>().as('count'))
|
|
39
|
+
.executeTakeFirstOrThrow(),
|
|
40
|
+
database
|
|
41
|
+
.selectFrom('workspace')
|
|
42
|
+
.select(({ fn }) => fn.countAll<number>().as('count'))
|
|
43
|
+
.executeTakeFirstOrThrow(),
|
|
44
|
+
database
|
|
45
|
+
.selectFrom('document')
|
|
46
|
+
.select(({ fn }) => fn.countAll<number>().as('count'))
|
|
47
|
+
.where('deletedAt', 'is', null)
|
|
48
|
+
.executeTakeFirstOrThrow(),
|
|
49
|
+
database
|
|
50
|
+
.selectFrom('workspaceStorageUsage')
|
|
51
|
+
.select(({ fn }) => fn.sum<number | null>('committedBytes').as('bytes'))
|
|
52
|
+
.executeTakeFirstOrThrow()
|
|
53
|
+
])
|
|
54
|
+
return {
|
|
55
|
+
deployment: config.deployment,
|
|
56
|
+
enrollmentMode: config.enrollmentMode,
|
|
57
|
+
emailTransport: config.emailTransport,
|
|
58
|
+
pendingEnrollment: Number(pendingEnrollment.count),
|
|
59
|
+
pendingEmail,
|
|
60
|
+
failedEmail,
|
|
61
|
+
accounts: Number(accounts.count),
|
|
62
|
+
workspaces: Number(workspaces.count),
|
|
63
|
+
documents: Number(documents.count),
|
|
64
|
+
storedBytes: Number(stored.bytes ?? 0)
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
export type AdminOperationsService = ReturnType<typeof createAdminOperationsService>
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import * as v from 'valibot'
|
|
2
|
+
|
|
3
|
+
const uuidSchema = v.pipe(v.string(), v.uuid())
|
|
4
|
+
/** Accounts and access requests are named by UUID; anything else names no row. */
|
|
5
|
+
export const isUUID = (value: string) => v.is(uuidSchema, value)
|
|
6
|
+
|
|
7
|
+
/** The most rows one admin list request returns. */
|
|
8
|
+
export const ADMIN_LIST_MAXIMUM = 500
|
|
9
|
+
|
|
10
|
+
export const enrollmentStatusSchema = v.picklist(['pending', 'approved', 'rejected', 'revoked'])
|
|
11
|
+
export const enrollmentReviewSchema = v.object({
|
|
12
|
+
note: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(1000)))
|
|
13
|
+
})
|
|
14
|
+
export const userRoleMutationSchema = v.object({
|
|
15
|
+
userId: v.pipe(v.string(), v.trim(), v.minLength(1)),
|
|
16
|
+
enabled: v.boolean()
|
|
17
|
+
})
|
|
18
|
+
|
|
19
|
+
export const userMutationSchema = v.object({
|
|
20
|
+
userId: v.pipe(v.string(), v.trim(), v.minLength(1)),
|
|
21
|
+
reason: v.optional(v.pipe(v.string(), v.trim(), v.maxLength(500)))
|
|
22
|
+
})
|
|
23
|
+
|
|
24
|
+
export type EnrollmentReview = v.InferOutput<typeof enrollmentReviewSchema>
|
|
25
|
+
|
|
26
|
+
export const parseEnrollmentReview = (input: unknown) => v.parse(enrollmentReviewSchema, input)
|
|
27
|
+
export const parseUserMutation = (input: unknown) => v.parse(userMutationSchema, input)
|
|
28
|
+
export const parseUserRoleMutation = (input: unknown) => v.parse(userRoleMutationSchema, input)
|