Skip to content

Self-hosted personal gallery application with online photo management and albums, supporting Live/Motion Photos, EXIF parsing, geolocation recognition, and an explore map.

refactor: organize shared platform adapters under apps/shared

Timothy Yin7d714a954ad6
diff --git a/apps/cloud/server/api/auth/email/request.post.ts b/apps/cloud/server/api/auth/email/request.post.ts
index 3155b447..7783d8b0 100644
--- a/apps/cloud/server/api/auth/email/request.post.ts
+++ b/apps/cloud/server/api/auth/email/request.post.ts
@@ -1,4 +1,4 @@
-import { definePlatformHandler } from '../../../../../platform.runtime'
+import { definePlatformHandler } from '../../../../../shared/platform/runtime'
import { emailSignIn } from '../../../utils/platform-auth'
export default definePlatformHandler(async (event) => {
const body = await readBody(event)
diff --git a/apps/cloud/server/api/auth/email/verify.post.ts b/apps/cloud/server/api/auth/email/verify.post.ts
index d3318d01..fe40128f 100644
--- a/apps/cloud/server/api/auth/email/verify.post.ts
+++ b/apps/cloud/server/api/auth/email/verify.post.ts
@@ -1,11 +1,11 @@
-import { definePlatformHandler } from '../../../../../platform.runtime'
+import { definePlatformHandler } from '../../../../../shared/platform/runtime'
import { emailSignIn } from '../../../utils/platform-auth'
import { createD1Sessions } from '../../../../../../packages/platform/src/index'
-import { createEmailCodeCrypto } from '../../../../../platform-crypto'
+import { createEmailCodeCrypto } from '../../../../../shared/platform/crypto'
import {
PLATFORM_COOKIE,
platformDatabase,
-} from '../../../../../platform.runtime'
+} from '../../../../../shared/platform/runtime'
export default definePlatformHandler(async (event) => {
const body = await readBody(event)
if (
diff --git a/apps/cloud/server/api/auth/logout.post.ts b/apps/cloud/server/api/auth/logout.post.ts
index 9f7bb28b..eda5bf0b 100644
--- a/apps/cloud/server/api/auth/logout.post.ts
+++ b/apps/cloud/server/api/auth/logout.post.ts
@@ -1,11 +1,11 @@
-import { definePlatformHandler } from '../../../../platform.runtime'
+import { definePlatformHandler } from '../../../../shared/platform/runtime'
import { createD1Sessions } from '../../../../../packages/platform/src/index'
-import { createEmailCodeCrypto } from '../../../../platform-crypto'
+import { createEmailCodeCrypto } from '../../../../shared/platform/crypto'
import {
PLATFORM_COOKIE,
platformDatabase,
platformPortalOrigin,
-} from '../../../../platform.runtime'
+} from '../../../../shared/platform/runtime'
export default definePlatformHandler(async (event) => {
const config = useRuntimeConfig(event).platform
platformPortalOrigin(event, config.portalOrigin, true)
diff --git a/apps/cloud/server/api/auth/session.get.ts b/apps/cloud/server/api/auth/session.get.ts
index 1b274a4f..c59d59bb 100644
--- a/apps/cloud/server/api/auth/session.get.ts
+++ b/apps/cloud/server/api/auth/session.get.ts
@@ -1,8 +1,8 @@
-import { definePlatformHandler } from '../../../../platform.runtime'
+import { definePlatformHandler } from '../../../../shared/platform/runtime'
import {
platformPortalOrigin,
platformSession,
-} from '../../../../platform.runtime'
+} from '../../../../shared/platform/runtime'
export default definePlatformHandler(async (event) => {
const config = useRuntimeConfig(event).platform
platformPortalOrigin(event, config.portalOrigin)
diff --git a/apps/cloud/server/api/auth/status.get.ts b/apps/cloud/server/api/auth/status.get.ts
index 245072f7..d7225863 100644
--- a/apps/cloud/server/api/auth/status.get.ts
+++ b/apps/cloud/server/api/auth/status.get.ts
@@ -1,8 +1,8 @@
-import { platformEmailReady } from '../../../../platform-email'
+import { platformEmailReady } from '../../../../shared/platform/email'
import {
platformRequestURL,
platformDatabase,
-} from '../../../../platform.runtime'
+} from '../../../../shared/platform/runtime'
export default defineEventHandler(async (event) => {
const config = useRuntimeConfig(event).platform
const origin = platformRequestURL(event).origin
diff --git a/apps/cloud/server/api/sites/[siteId]/context.get.ts b/apps/cloud/server/api/sites/[siteId]/context.get.ts
index 8c76e380..8f83524b 100644
--- a/apps/cloud/server/api/sites/[siteId]/context.get.ts
+++ b/apps/cloud/server/api/sites/[siteId]/context.get.ts
@@ -1,8 +1,8 @@
-import { definePlatformHandler } from '../../../../../platform.runtime'
+import { definePlatformHandler } from '../../../../../shared/platform/runtime'
import {
portalSiteContext,
siteContextDTO,
-} from '../../../../../platform-context'
+} from '../../../../../shared/platform/context'
export default definePlatformHandler(async (event) =>
siteContextDTO(
event,
diff --git a/apps/cloud/server/api/sites/[siteId]/events.get.ts b/apps/cloud/server/api/sites/[siteId]/events.get.ts
index b9612545..2c9b3b09 100644
--- a/apps/cloud/server/api/sites/[siteId]/events.get.ts
+++ b/apps/cloud/server/api/sites/[siteId]/events.get.ts
@@ -1,8 +1,8 @@
-import { definePlatformHandler } from '../../../../../platform.runtime'
+import { definePlatformHandler } from '../../../../../shared/platform/runtime'
import {
portalSiteContext,
siteContextDTO,
-} from '../../../../../platform-context'
+} from '../../../../../shared/platform/context'
/** Each reconnect rechecks live membership; never hold a stale authorized stream open. */
export default definePlatformHandler(async (event) => {
const context = await siteContextDTO(
diff --git a/apps/cloud/server/api/sites/index.get.ts b/apps/cloud/server/api/sites/index.get.ts
index 3224a9b5..64d407e7 100644
--- a/apps/cloud/server/api/sites/index.get.ts
+++ b/apps/cloud/server/api/sites/index.get.ts
@@ -1,8 +1,8 @@
import {
definePlatformHandler,
platformDatabase,
-} from '../../../../platform.runtime'
-import { requirePlatformSession } from '../../../../platform-context'
+} from '../../../../shared/platform/runtime'
+import { requirePlatformSession } from '../../../../shared/platform/context'
import { createD1SiteCatalog } from '../../../../../packages/platform/src/index'
export default definePlatformHandler(async (event) => {
const session = await requirePlatformSession(
diff --git a/apps/cloud/server/utils/platform-auth.ts b/apps/cloud/server/utils/platform-auth.ts
index 4f7de61d..9a99507f 100644
--- a/apps/cloud/server/utils/platform-auth.ts
+++ b/apps/cloud/server/utils/platform-auth.ts
@@ -3,13 +3,13 @@ import { createD1EmailCodeStore } from '../../../../packages/platform/src/index'
import {
platformDatabase,
platformPortalOrigin,
-} from '../../../platform.runtime'
-import { createEmailCodeCrypto } from '../../../platform-crypto'
+} from '../../../shared/platform/runtime'
+import { createEmailCodeCrypto } from '../../../shared/platform/crypto'
import type { H3Event } from 'h3'
import {
createCloudflareEmailSender,
platformEmailReady,
-} from '../../../platform-email'
+} from '../../../shared/platform/email'
export async function emailSignIn(event: H3Event) {
const config = useRuntimeConfig(event).platform
diff --git a/apps/shared/platform/README.md b/apps/shared/platform/README.md
new file mode 100644
index 00000000..8a793e82
--- /dev/null
+++ b/apps/shared/platform/README.md
@@ -0,0 +1,14 @@
+# Shared platform adapters
+
+Worker-compatible application adapters used by Cloud and Site. This directory is
+not a Nuxt application or a workspace package; consumers import modules explicitly.
+
+- `runtime.ts`: request origin, D1 binding, platform sessions and HTTP errors.
+- `context.ts`: authorized portal and public Site contexts and DTOs.
+- `crypto.ts`: email/session MAC and visitor password verification.
+- `email.ts`: Cloudflare Email Sending binding adapter.
+- `visitor.ts`: host-only visitor cookies, password policies and attempt limits.
+
+Business rules remain in `packages/core`; D1 repositories remain in
+`packages/platform`. Self-hosted does not import these adapters. Keep this directory
+free of native media tools, filesystem storage and other Node-only runtime code.
diff --git a/apps/platform-context.ts b/apps/shared/platform/context.ts
similarity index 86%
rename from apps/platform-context.ts
rename to apps/shared/platform/context.ts
index 20e16b6c..6dc02f8f 100644
--- a/apps/platform-context.ts
+++ b/apps/shared/platform/context.ts
@@ -1,21 +1,21 @@
-import { platformStateKey } from '../packages/core/src/platform'
-import { createD1SiteCatalog } from '../packages/platform/src/index'
+import { platformStateKey } from '../../../packages/core/src/platform'
+import { createD1SiteCatalog } from '../../../packages/platform/src/index'
import {
CLOUD_CAPABILITIES,
SITE_CAPABILITIES,
-} from '../packages/contracts/src/entry'
-import type { EntrySiteContext } from '../packages/contracts/src/entry'
+} from '../../../packages/contracts/src/entry'
+import type { EntrySiteContext } from '../../../packages/contracts/src/entry'
import type {
PortalContext,
PublicSiteContext,
-} from '../packages/core/src/platform'
+} from '../../../packages/core/src/platform'
import {
platformAccess,
platformDatabase,
platformPortalOrigin,
platformSession,
platformRequestURL,
-} from './platform.runtime'
+} from './runtime'
import { createError, getRouterParam } from 'h3'
import type { H3Event } from 'h3'
diff --git a/apps/platform-crypto.ts b/apps/shared/platform/crypto.ts
similarity index 96%
rename from apps/platform-crypto.ts
rename to apps/shared/platform/crypto.ts
index e232cbe9..62b8f95e 100644
--- a/apps/platform-crypto.ts
+++ b/apps/shared/platform/crypto.ts
@@ -1,4 +1,4 @@
-import type { EmailCodeCrypto } from '../packages/core/src/email-auth'
+import type { EmailCodeCrypto } from '../../../packages/core/src/email-auth'
/** The secret is server-only and must be independently configured for each environment. */
export async function createEmailCodeCrypto(
diff --git a/apps/platform-email.ts b/apps/shared/platform/email.ts
similarity index 93%
rename from apps/platform-email.ts
rename to apps/shared/platform/email.ts
index 9231727f..7b4eb0cd 100644
--- a/apps/platform-email.ts
+++ b/apps/shared/platform/email.ts
@@ -1,4 +1,4 @@
-import type { EmailCodeSender } from '../packages/core/src/email-auth'
+import type { EmailCodeSender } from '../../../packages/core/src/email-auth'
/** Cloudflare Email Sending structured-message binding; no REST credentials. */
export interface PlatformEmailBinding {
diff --git a/apps/platform.runtime.ts b/apps/shared/platform/runtime.ts
similarity index 89%
rename from apps/platform.runtime.ts
rename to apps/shared/platform/runtime.ts
index 7e5a59c7..3825795e 100644
--- a/apps/platform.runtime.ts
+++ b/apps/shared/platform/runtime.ts
@@ -11,11 +11,11 @@ import type { H3Event, EventHandler, EventHandlerRequest } from 'h3'
import {
createD1Directory,
createD1Sessions,
-} from '../packages/platform/src/index.ts'
-import type { PlatformD1 } from '../packages/platform/src/index.ts'
-import { createPlatformAccess } from '../packages/core/src/platform.ts'
-import type { PlatformSession } from '../packages/core/src/platform.ts'
-import { createEmailCodeCrypto } from './platform-crypto.ts'
+} from '../../../packages/platform/src/index.ts'
+import type { PlatformD1 } from '../../../packages/platform/src/index.ts'
+import { createPlatformAccess } from '../../../packages/core/src/platform.ts'
+import type { PlatformSession } from '../../../packages/core/src/platform.ts'
+import { createEmailCodeCrypto } from './crypto.ts'
export const PLATFORM_COOKIE = '__Host-chronoframe-session'
export function platformDatabase(event: H3Event): PlatformD1 {
diff --git a/apps/platform-visitor.ts b/apps/shared/platform/visitor.ts
similarity index 94%
rename from apps/platform-visitor.ts
rename to apps/shared/platform/visitor.ts
index c9fd40e1..3dabb229 100644
--- a/apps/platform-visitor.ts
+++ b/apps/shared/platform/visitor.ts
@@ -3,14 +3,11 @@ import type { H3Event } from 'h3'
import type {
PublicSiteContext,
SiteVisitorGrant,
-} from '../packages/core/src/platform.ts'
-import { hasSiteVisitorGrant } from '../packages/core/src/platform.ts'
-import { platformDatabase, platformRequestURL } from './platform.runtime.ts'
-import {
- createEmailCodeCrypto,
- visitorPasswordHash,
-} from './platform-crypto.ts'
-export { visitorPasswordHash } from './platform-crypto.ts'
+} from '../../../packages/core/src/platform.ts'
+import { hasSiteVisitorGrant } from '../../../packages/core/src/platform.ts'
+import { platformDatabase, platformRequestURL } from './runtime.ts'
+import { createEmailCodeCrypto, visitorPasswordHash } from './crypto.ts'
+export { visitorPasswordHash } from './crypto.ts'
const encoder = new TextEncoder()
const COOKIE = '__Host-chronoframe-visitor'
diff --git a/apps/site/server/api/public/albums/[albumId]/access.get.ts b/apps/site/server/api/public/albums/[albumId]/access.get.ts
index 7e2693b6..23f47d17 100644
--- a/apps/site/server/api/public/albums/[albumId]/access.get.ts
+++ b/apps/site/server/api/public/albums/[albumId]/access.get.ts
@@ -1,6 +1,6 @@
-import { definePlatformHandler } from '../../../../../../platform.runtime'
-import { publicSiteContext } from '../../../../../../platform-context'
-import { visitorAccess } from '../../../../../../platform-visitor'
+import { definePlatformHandler } from '../../../../../../shared/platform/runtime'
+import { publicSiteContext } from '../../../../../../shared/platform/context'
+import { visitorAccess } from '../../../../../../shared/platform/visitor'
export default definePlatformHandler(async (event) =>
visitorAccess(
event,
diff --git a/apps/site/server/api/public/albums/[albumId]/unlock.post.ts b/apps/site/server/api/public/albums/[albumId]/unlock.post.ts
index 1c5ed88a..fc5e937a 100644
--- a/apps/site/server/api/public/albums/[albumId]/unlock.post.ts
+++ b/apps/site/server/api/public/albums/[albumId]/unlock.post.ts
@@ -1,6 +1,6 @@
-import { definePlatformHandler } from '../../../../../../platform.runtime'
-import { publicSiteContext } from '../../../../../../platform-context'
-import { unlockVisitor } from '../../../../../../platform-visitor'
+import { definePlatformHandler } from '../../../../../../shared/platform/runtime'
+import { publicSiteContext } from '../../../../../../shared/platform/context'
+import { unlockVisitor } from '../../../../../../shared/platform/visitor'
export default definePlatformHandler(async (event) => {
const context = await publicSiteContext(event)
const body = await readBody(event)
diff --git a/apps/site/server/api/public/context.get.ts b/apps/site/server/api/public/context.get.ts
index 4302d86b..4bc755b9 100644
--- a/apps/site/server/api/public/context.get.ts
+++ b/apps/site/server/api/public/context.get.ts
@@ -1,5 +1,8 @@
-import { definePlatformHandler } from '../../../../platform.runtime'
-import { publicSiteContext, siteContextDTO } from '../../../../platform-context'
+import { definePlatformHandler } from '../../../../shared/platform/runtime'
+import {
+ publicSiteContext,
+ siteContextDTO,
+} from '../../../../shared/platform/context'
export default definePlatformHandler(async (event) =>
siteContextDTO(event, await publicSiteContext(event)),
)
diff --git a/scripts/check-entry-boundaries.mjs b/scripts/check-entry-boundaries.mjs
index 53c2534f..194bd132 100644
--- a/scripts/check-entry-boundaries.mjs
+++ b/scripts/check-entry-boundaries.mjs
@@ -25,11 +25,7 @@ for (const entry of ['cloud', 'site']) {
for (const file of [
...(await sources(`apps/${entry}`)),
'apps/nuxt.shared.ts',
- 'apps/platform.runtime.ts',
- 'apps/platform-crypto.ts',
- 'apps/platform-email.ts',
- 'apps/platform-context.ts',
- 'apps/platform-visitor.ts',
+ ...(await sources('apps/shared/platform')),
]) {
const code = await readFile(file, 'utf8')
for (const match of code.matchAll(
@@ -40,7 +36,7 @@ for (const entry of ['cloud', 'site']) {
? path.resolve(path.dirname(file), specifier)
: specifier
if (
- /\/(?:server|app)\//.test(file) &&
+ /\/(?:server|app|shared)\//.test(file) &&
/^(?:node:)?(?:fs(?:\/|$)|child_process|worker_threads)/.test(specifier)
)
failures.push(`${file}: ${specifier}`)
diff --git a/tests/entry-context.test.ts b/tests/entry-context.test.ts
index f49f8407..81caad2c 100644
--- a/tests/entry-context.test.ts
+++ b/tests/entry-context.test.ts
@@ -10,7 +10,7 @@ import {
encodeVisitorGrants,
decodeVisitorGrants,
visitorPasswordHash,
-} from '../apps/platform-visitor.ts'
+} from '../apps/shared/platform/visitor.ts'
import { hasSiteVisitorGrant } from '../packages/core/src/platform.ts'
const secret = 'independent-site-test-secret-at-least-32-bytes'
diff --git a/tests/platform-email-binding.test.ts b/tests/platform-email-binding.test.ts
index f6ec7711..48928e05 100644
--- a/tests/platform-email-binding.test.ts
+++ b/tests/platform-email-binding.test.ts
@@ -3,7 +3,7 @@ import assert from 'node:assert/strict'
import {
createCloudflareEmailSender,
platformEmailReady,
-} from '../apps/platform-email.ts'
+} from '../apps/shared/platform/email.ts'
test('Cloudflare Email Sending uses the structured binding without REST credentials', async () => {
const messages: unknown[] = []
diff --git a/tests/platform-email-d1.test.ts b/tests/platform-email-d1.test.ts
index 5e0a01d9..6c9a0f8f 100644
--- a/tests/platform-email-d1.test.ts
+++ b/tests/platform-email-d1.test.ts
@@ -10,7 +10,7 @@ import {
createD1Sessions,
} from '../packages/platform/src/index.ts'
import type { PlatformD1, D1Statement } from '../packages/platform/src/index.ts'
-import { createEmailCodeCrypto } from '../apps/platform-crypto.ts'
+import { createEmailCodeCrypto } from '../apps/shared/platform/crypto.ts'
/** Actual SQLite SQL/transactions behind the D1 statement API; no storage mock. */
async function database() {
diff --git a/tests/visitor-worker-crypto.test.ts b/tests/visitor-worker-crypto.test.ts
index 3c822d1d..590aa973 100644
--- a/tests/visitor-worker-crypto.test.ts
+++ b/tests/visitor-worker-crypto.test.ts
@@ -3,7 +3,7 @@ import test from 'node:test'
import { createRequire } from 'node:module'
import { pbkdf2Sync } from 'node:crypto'
import { fileURLToPath } from 'node:url'
-import { VISITOR_PBKDF2_ITERATIONS } from '../apps/platform-crypto.ts'
+import { VISITOR_PBKDF2_ITERATIONS } from '../apps/shared/platform/crypto.ts'
test('visitor password hashing stays within the portable Workers budget and executes in workerd', async () => {
assert.ok(
@@ -16,7 +16,7 @@ test('visitor password hashing stays within the portable Workers budget and exec
const { build } = wranglerRequire('esbuild')
const { Miniflare, convertV4MiniflareOptions } = wranglerRequire('miniflare')
const module = fileURLToPath(
- new URL('../apps/platform-crypto.ts', import.meta.url),
+ new URL('../apps/shared/platform/crypto.ts', import.meta.url),
)
const bundle = await build({
stdin: {