Self-hosted personal gallery application with online photo management and albums, supporting Live/Motion Photos, EXIF parsing, geolocation recognition, and an explore map.
TypeScript albumsexif-extractiongeocodinglive-photomotion-photophoto-galleryphoto-sharingwebgl-viewer
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.tsindex 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.tsindex 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.tsindex 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).platformplatformPortalOrigin(event, config.portalOrigin, true)diff --git a/apps/cloud/server/api/auth/session.get.ts b/apps/cloud/server/api/auth/session.get.tsindex 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).platformplatformPortalOrigin(event, config.portalOrigin)diff --git a/apps/cloud/server/api/auth/status.get.ts b/apps/cloud/server/api/auth/status.get.tsindex 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).platformconst origin = platformRequestURL(event).origindiff --git a/apps/cloud/server/api/sites/[siteId]/context.get.ts b/apps/cloud/server/api/sites/[siteId]/context.get.tsindex 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.tsindex 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.tsindex 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.tsindex 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).platformdiff --git a/apps/shared/platform/README.md b/apps/shared/platform/README.mdnew file mode 100644index 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.tssimilarity index 86%rename from apps/platform-context.tsrename to apps/shared/platform/context.tsindex 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.tssimilarity index 96%rename from apps/platform-crypto.tsrename to apps/shared/platform/crypto.tsindex 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.tssimilarity index 93%rename from apps/platform-email.tsrename to apps/shared/platform/email.tsindex 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.tssimilarity index 89%rename from apps/platform.runtime.tsrename to apps/shared/platform/runtime.tsindex 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.tssimilarity index 94%rename from apps/platform-visitor.tsrename to apps/shared/platform/visitor.tsindex 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.tsindex 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.tsindex 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.tsindex 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.mjsindex 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): specifierif (- /\/(?: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.tsindex 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.tsindex 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.tsindex 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.tsindex 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 execconst { 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: {