@beechcms/api 0.6.0-preview.2 → 0.6.0-preview.3

package/src/auth/login.ts

@@ -1,78 +0,0 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-/// <reference types="@cloudflare/workers-types" />
-import type { IHashProvider } from '@beechcms/core'
-
-export type LoginCredentials = {
-  email: string
-  password: string
-}
-
-/** 
- * Regex per validare formato email.
- * Utilizza classi di caratteri che non si sovrappongono per evitare il backtracking catastrofico (ReDoS).
- */
-const EMAIL_REGEX = /^[^\s@]+@[^\s@.]+(?:\.[^\s@.]+)+$/
-/** Lunghezza massima email secondo standard RFC 5321 */
-const MAX_EMAIL_LENGTH = 254
-
-/** Lunghezza minima password (caratteri) */
-const MIN_PASSWORD_LENGTH = 8
-
-/** Lunghezza massima password (caratteri) - limite ragionevole per evitare DoS */
-const MAX_PASSWORD_LENGTH = 128
-
-/**
- * Hash bcrypt dummy valido.
- * Usato quando l'utente non esiste per evitare timing attack
- * (stesso tempo di risposta che con password errata).
- */
-export const DUMMY_PASSWORD_HASH =
-  '$2a$10$SbkRFOafACxVM2ahxerVDu3tSkCXWm29b62WdB.4WGG02Qjsfzni6'
-
-/**
- * Estrae e valida email e password dal body della richiesta.
- * @param body - Body grezzo (tipicamente da req.json())
- * @returns Oggetto {email, password} se valido, null altrimenti
- */
-export function parseLoginBody(body: unknown): LoginCredentials | null {
-  if (body === null || typeof body !== 'object') return null
-  const obj = body as Record<string, unknown>
-  const email = obj.email
-  const password = obj.password
-  if (typeof email !== 'string' || typeof password !== 'string') return null
-  if (!email.trim() || !password) return null
-  return { email: email.trim(), password }
-}
-
-/**
- * Verifica che email e password rispettino i formati richiesti.
- * @param email - Email da validare (deve contenere @ e punto dopo @)
- * @param password - Password (8-128 caratteri)
- * @returns true se valido
- */
-export function validateLoginInput(email: string, password: string): boolean {
-  return (
-    email.length <= MAX_EMAIL_LENGTH &&
-    EMAIL_REGEX.test(email) &&
-    password.trim().length >= MIN_PASSWORD_LENGTH &&
-    password.length <= MAX_PASSWORD_LENGTH
-  )
-}
-
-/**
- * Verifica che la password in chiaro corrisponda all'hash salvato.
- * @param plainPassword - Password in chiaro
- * @param hash - Hash salvato nel DB
- * @param hashProvider - Provider usato per la comparazione costante-time
- * @returns true se la password è corretta
- */
-export async function verifyPassword(
-  plainPassword: string,
-  hash: string,
-  hashProvider: IHashProvider
-): Promise<boolean> {
-  return hashProvider.verify(plainPassword, hash)
-}

package/src/auth/refresh.ts

@@ -1,11 +0,0 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-/// <reference types="@cloudflare/workers-types" />
-
-export function generateRefreshToken(): string {
-  const bytes = new Uint8Array(32)
-  crypto.getRandomValues(bytes)
-  return Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('')
-}

package/src/auth/token-service.test.ts

@@ -1,90 +0,0 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import { describe, it, expect } from 'vitest'
-import { SystemClock } from '@beechcms/core'
-import { JoseTokenService } from './jose-token-service'
-import { StaticTokenService } from './__fixtures__/static-token-service'
-
-const TEST_SECRET = 'super-secret-key-used-only-in-the-vitest-suite-min-length'
-
-describe('JoseTokenService', () => {
-  const service = new JoseTokenService(TEST_SECRET, {}, SystemClock)
-
-  it('issue returns a three-part JWT string', async () => {
-    const token = await service.issue({ sub: 'user-1', email: 'a@b.com' })
-    expect(token.split('.')).toHaveLength(3)
-  })
-
-  it('verify returns the original claims for a valid token', async () => {
-    const token = await service.issue({ sub: 'user-1', email: 'a@b.com' })
-    const claims = await service.verify(token)
-    expect(claims?.sub).toBe('user-1')
-    expect(claims?.email).toBe('a@b.com')
-  })
-
-  it('verify returns null for a malformed token', async () => {
-    expect(await service.verify('not.a.valid.jwt')).toBeNull()
-  })
-
-  it('verify returns null for a token signed with a different secret', async () => {
-    const otherService = new JoseTokenService('completely-different-secret-key-xyz', {}, SystemClock)
-    const token = await otherService.issue({ sub: 'user-1' })
-    expect(await service.verify(token)).toBeNull()
-  })
-
-  it('verify returns null for an expired token (ttlSeconds = -1)', async () => {
-    const token = await service.issue({ sub: 'user-1' }, { ttlSeconds: -1 })
-    expect(await service.verify(token)).toBeNull()
-  })
-
-  it('issuer mismatch causes verify to return null', async () => {
-    const issuerA = new JoseTokenService(TEST_SECRET, { issuer: 'issuer-a' }, SystemClock)
-    const issuerB = new JoseTokenService(TEST_SECRET, { issuer: 'issuer-b' }, SystemClock)
-    const token = await issuerA.issue({ sub: 'user-1' })
-    expect(await issuerB.verify(token)).toBeNull()
-  })
-
-  it('custom TTL is respected — token issued with longer TTL verifies successfully', async () => {
-    const token = await service.issue({ sub: 'user-1' }, { ttlSeconds: 3600 })
-    const claims = await service.verify(token)
-    expect(claims?.sub).toBe('user-1')
-  })
-
-  it('throws if the secret is shorter than 32 bytes', () => {
-    expect(() => new JoseTokenService('short-secret', {}, SystemClock)).toThrow('JWT secret must be at least 32 bytes')
-  })
-})
-
-describe('StaticTokenService', () => {
-  it('issue returns "test:" + claims.sub', async () => {
-    const service = new StaticTokenService()
-    expect(await service.issue({ sub: 'abc' })).toBe('test:abc')
-  })
-
-  it('verify returns the stored claims for an issued token', async () => {
-    const service = new StaticTokenService()
-    await service.issue({ sub: 'abc', email: 'x@y.com' })
-    const claims = await service.verify('test:abc')
-    expect(claims?.email).toBe('x@y.com')
-    expect(claims?.sub).toBe('abc')
-  })
-
-  it('verify returns null for an unknown test sub', async () => {
-    const service = new StaticTokenService()
-    expect(await service.verify('test:unknown')).toBeNull()
-  })
-
-  it('verify returns null for a token that does not start with "test:"', async () => {
-    const service = new StaticTokenService()
-    expect(await service.verify('real.jwt.token')).toBeNull()
-  })
-
-  it('each StaticTokenService instance has its own isolated claims store', async () => {
-    const serviceA = new StaticTokenService()
-    const serviceB = new StaticTokenService()
-    await serviceA.issue({ sub: 'user-1' })
-    expect(await serviceB.verify('test:user-1')).toBeNull()
-  })
-})

package/src/factory.ts

@@ -1,370 +0,0 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-/// <reference types="@cloudflare/workers-types" />
-import { Hono } from 'hono'
-import { cors } from 'hono/cors'
-import { getCookie, setCookie, deleteCookie } from 'hono/cookie'
-import type { Seed, ContentRepository, IdempotencyRepository, BeechBucket, MediaRepository, SystemStatsRepository } from '@beechcms/core'
-import { sha256hex, SystemClock, SystemIdGenerator } from '@beechcms/core'
-import type { Env, Variables } from './types'
-import { getClientIp } from './shared/request-utils'
-
-// Imports delle rotte e middleware
-import { AUTH_ERRORS } from './auth/constants'
-import {
-  parseLoginBody,
-  validateLoginInput,
-  verifyPassword,
-  DUMMY_PASSWORD_HASH,
-} from './auth/login'
-import { generateRefreshToken } from './auth/refresh'
-import { authMiddleware } from './middleware'
-import contentFeature from './features/content'
-import { widgetApp } from './widget'
-import { rotateFieldApp } from './features/rotate-field'
-import { passwordResetApp } from './features/password-reset'
-import { setupApp } from './features/setup'
-import { draftApp } from './features/draft'
-import { settingsApp } from './features/settings/settings.handler'
-import { schemaApp } from './features/schema/schema.handler'
-import { dashboardLayoutApp } from './features/dashboard-layout'
-import { seedsApp } from './features/seeds'
-import { notificationsApp } from './features/notifications'
-import { automationsApp } from './features/automations'
-import { statsApp } from './features/stats'
-import { backrefsApp } from './features/backrefs'
-import { webhooksApp } from './features/webhooks'
-import { uploadRoutes, serveMediaHandler } from './upload'
-import { publicRoutes, apiKeyMiddleware, publicRateLimitMiddleware } from './public'
-import { searchRouter } from "./search"
-import type { ISeedRepository } from '@beechcms/core'
-import { repositoryMiddleware } from './middleware/repository.middleware'
-import { seedRegistryMiddleware } from './middleware/seed-registry.middleware'
-import { storageMiddleware } from './middleware/storage.middleware'
-import { InMemorySeedRepository } from './shared/in-memory-seed.repository'
-import { authProvidersMiddleware } from './middleware/auth-providers.middleware'
-import { rateLimiterMiddleware } from './middleware/rate-limit.middleware'
-import { observabilityMiddleware } from './middleware/observability.middleware'
-
-export interface BeechConfig {
-  seeds: Seed[] | Record<string, Seed>
-  repository?: ContentRepository
-  idempotencyRepository?: IdempotencyRepository
-  bucket?: BeechBucket
-  mediaRepository?: MediaRepository
-  systemStatsRepository?: SystemStatsRepository
-  // Optional override: inject a custom ISeedRepository (e.g. InMemorySeedRepository for tests).
-  // When omitted and seeds is non-empty, an InMemorySeedRepository is created automatically
-  // for backward compatibility.
-  seedRepository?: ISeedRepository
-}
-
-// --- Costanti e helper ---
-const REFRESH_TOKEN_EXPIRY_DAYS = 7
-const SECONDS_PER_DAY = 24 * 60 * 60
-
-function isRequestSecure(url: string): boolean {
-  return new URL(url).protocol === 'https:'
-}
-
-function getRefreshTokenCookieOptions(secure: boolean) {
-  return {
-    httpOnly: true,
-    secure,
-    sameSite: 'Strict' as const,
-    maxAge: REFRESH_TOKEN_EXPIRY_DAYS * SECONDS_PER_DAY,
-    path: '/auth',
-  }
-}
-
-function getRefreshTokenDeleteCookieOptions(secure: boolean) {
-  return {
-    httpOnly: true,
-    secure,
-    sameSite: 'Strict' as const,
-    path: '/auth',
-  }
-}
-
-function handleAuthError(context: any, error: unknown, operationName: string): Response {
-  if (context.env.ENV !== 'production') {
-    console.error(`${operationName} error:`, error)
-  }
-  return context.json({ error: AUTH_ERRORS.GENERIC_ERROR }, 500)
-}
-
-function extractPublicSeed(path: string): string {
-  const match = path.match(/^\/api\/v1\/public\/([^/?]+)/)
-  return match ? match[1] : ''
-}
-
-/**
- * Builds a fully configured Hono app. Seeds are hydrated from D1 at runtime via
- * seedRegistryMiddleware; config.seeds is retained for back-compat but no longer
- * drives request handling.
- */
-export function createBeechApp(config: BeechConfig): Hono<{ Bindings: Env; Variables: Variables }> {
-  // Back-compat shim: when callers (e.g. existing tests) pass seeds without a custom
-  // seedRepository, wrap them in an InMemorySeedRepository so the middleware can serve
-  // them without touching D1. Production index.ts passes seeds:[] so D1SeedRepository
-  // is used as the live path.
-  const seedsArray = Array.isArray(config.seeds) ? config.seeds : Object.values(config.seeds)
-  const seedRepository = config.seedRepository
-    ?? (seedsArray.length > 0 ? new InMemorySeedRepository(seedsArray) : undefined)
-
-  const app = new Hono<{ Bindings: Env; Variables: Variables }>()
-
-  // 1. Repository Injection (must be first — seedRegistryMiddleware depends on seedRepository)
-  app.use('*', repositoryMiddleware({
-    repository: config.repository,
-    idempotencyRepository: config.idempotencyRepository,
-    mediaRepository: config.mediaRepository,
-    systemStatsRepository: config.systemStatsRepository,
-    seedRepository,
-  }))
-
-  // 2. Seed Registry Hydration (D1-backed, version-token-cached per isolate)
-  app.use('*', seedRegistryMiddleware())
-
-  // 3. Storage / Auth / Rate Limiting / Observability
-  app.use('*', storageMiddleware({
-    bucket: config.bucket,
-  }))
-
-  app.use('*', authProvidersMiddleware())
-  app.use('*', rateLimiterMiddleware())
-  app.use('*', observabilityMiddleware())
-
-  app.use('*', async (context, next) => {
-    const isDev = context.env.ENV !== 'production'
-
-    return cors({
-      origin: (origin) => {
-        if (!origin) return origin ?? ''
-
-        // In dev, allow all localhost/127.0.0.1 origins regardless of port
-        if (isDev) {
-          try {
-            const { hostname } = new URL(origin)
-            if (hostname === 'localhost' || hostname === '127.0.0.1') return origin
-          } catch {}
-        }
-
-        const origins = (context.env.CORS_ORIGINS ?? 'http://localhost:5173')
-          .split(',')
-          .map((o) => o.trim())
-          .filter(Boolean)
-
-        if (origins.includes(origin)) return origin
-
-        // Allow same-origin requests
-        try {
-          const originUrl = new URL(origin)
-          const requestUrl = new URL(context.req.url)
-          if (originUrl.hostname === requestUrl.hostname && originUrl.port === requestUrl.port) {
-            return origin
-          }
-        } catch {}
-
-        return null
-      },
-      allowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
-      allowHeaders: ['Content-Type', 'Authorization', 'X-API-Key'],
-      credentials: true,
-    })(context, next)
-  })
-
-  app.use('*', async (context, next) => {
-    await next()
-    if (context.req.path.startsWith('/admin')) return
-    context.header('X-Frame-Options', 'DENY')
-    context.header('X-Content-Type-Options', 'nosniff')
-    context.header('Referrer-Policy', 'strict-origin-when-cross-origin')
-    context.header('Permissions-Policy', 'geolocation=(), microphone=(), camera=()')
-    context.header('Content-Security-Policy', "default-src 'self'; frame-ancestors 'none'")
-  })
-
-  // 2. Analytics Middleware
-  app.use('/api/*', async (context, next) => {
-    await next()
-    if (context.req.method === 'OPTIONS') return
-    if (context.res.status < 200 || context.res.status >= 300) return
-
-    let executionCtx: any
-    try { executionCtx = context.executionCtx } catch {}
-    if (!executionCtx) return
-
-    const analyticsRepository = context.get('analyticsRepository')
-    if (!analyticsRepository) return
-
-    const seedSlug = extractPublicSeed(context.req.path)
-
-    executionCtx.waitUntil(
-      analyticsRepository.recordRequest(seedSlug).catch((error: unknown) => {
-        console.error('Analytics middleware error:', error)
-      })
-    )
-  })
-
-  // 3. Auth Routes
-  app.post('/auth/login', async (context) => {
-    try {
-      let body: any
-      try { body = await context.req.json() } catch { return context.json({ error: AUTH_ERRORS.INVALID_REQUEST }, 400) }
-      const credentials = parseLoginBody(body)
-      if (!credentials) return context.json({ error: AUTH_ERRORS.INVALID_REQUEST }, 400)
-      const { email, password } = credentials
-      if (!validateLoginInput(email, password)) return context.json({ error: AUTH_ERRORS.INVALID_REQUEST }, 400)
-
-      const clientIp = getClientIp(context.req)
-      const loginRateLimit = await context.get('rateLimiters').getLimiter('login').checkLimit(clientIp)
-      if (!loginRateLimit.isAllowed) return context.json({ error: AUTH_ERRORS.RATE_LIMIT_EXCEEDED }, 429)
-
-      const user = await context.get('userRepository').findByEmail(email)
-      const hashToCompare = user?.passwordHash ?? DUMMY_PASSWORD_HASH
-      const isValid = await verifyPassword(password, hashToCompare, context.get('hashProvider'))
-
-      if (!user || !isValid) return context.json({ error: AUTH_ERRORS.INVALID_CREDENTIALS }, 401)
-
-      const accessToken = await context.get('tokenService').issue({ sub: user.id, email: user.email, name: user.name ?? undefined, surname: user.surname ?? undefined, role: user.role })
-      const refreshToken = generateRefreshToken()
-      const refreshTokenHash = await sha256hex(refreshToken)
-      const nowSeconds = SystemClock.nowSeconds()
-
-      await context.get('sessionRepository').saveRefreshToken({
-        id: SystemIdGenerator.uuid(),
-        userId: user.id,
-        tokenHash: refreshTokenHash,
-        expiresAt: nowSeconds + REFRESH_TOKEN_EXPIRY_DAYS * SECONDS_PER_DAY,
-      })
-      setCookie(context, 'refresh_token', refreshToken, getRefreshTokenCookieOptions(isRequestSecure(context.req.url)))
-      return context.json({ token: accessToken, expiresIn: '15m' }, 200)
-    } catch (error) {
-      return handleAuthError(context, error, 'Login')
-    }
-  })
-
-  app.post('/auth/refresh', async (context) => {
-    try {
-      const refreshClientIp = getClientIp(context.req)
-      const refreshRateLimit = await context.get('rateLimiters').getLimiter('tokenRefresh').checkLimit(refreshClientIp)
-      if (!refreshRateLimit.isAllowed) return context.json({ error: AUTH_ERRORS.RATE_LIMIT_EXCEEDED }, 429)
-
-      const refreshToken = getCookie(context, 'refresh_token')
-      if (!refreshToken) return context.json({ error: 'Refresh token missing' }, 401)
-
-      const nowSeconds = SystemClock.nowSeconds()
-      const tokenHash = await sha256hex(refreshToken)
-      const activeSession = await context.get('sessionRepository').findActiveByHash(tokenHash, nowSeconds)
-      if (!activeSession) return context.json({ error: 'Invalid refresh token' }, 401)
-
-      const user = await context.get('userRepository').findById(activeSession.userId)
-      if (!user) {
-        await context.get('sessionRepository').revokeByHash(tokenHash, nowSeconds)
-        return context.json({ error: 'User not found' }, 401)
-      }
-
-      // Issue new tokens before revoking the old one: if saveRefreshToken fails,
-      // the old token stays valid and the user is not locked out.
-      const newAccessToken = await context.get('tokenService').issue({ sub: user.id, email: user.email, name: user.name ?? undefined, surname: user.surname ?? undefined, role: user.role })
-      const newRefreshToken = generateRefreshToken()
-      const newRefreshTokenHash = await sha256hex(newRefreshToken)
-
-      await context.get('sessionRepository').saveRefreshToken({
-        id: SystemIdGenerator.uuid(),
-        userId: user.id,
-        tokenHash: newRefreshTokenHash,
-        expiresAt: nowSeconds + REFRESH_TOKEN_EXPIRY_DAYS * SECONDS_PER_DAY,
-      })
-
-      const revoked = await context.get('sessionRepository').revokeByHash(tokenHash, nowSeconds)
-      if (!revoked) return context.json({ error: 'Invalid refresh token' }, 401)
-
-      setCookie(context, 'refresh_token', newRefreshToken, getRefreshTokenCookieOptions(isRequestSecure(context.req.url)))
-      return context.json({ token: newAccessToken, expiresIn: '15m' }, 200)
-    } catch (error) {
-      return handleAuthError(context, error, 'Refresh')
-    }
-  })
-
-  app.post('/auth/logout', async (context) => {
-    try {
-      const refreshToken = getCookie(context, 'refresh_token')
-      if (refreshToken) {
-        const nowSeconds = SystemClock.nowSeconds()
-        const tokenHash = await sha256hex(refreshToken)
-        await context.get('sessionRepository').revokeByHash(tokenHash, nowSeconds)
-      }
-      deleteCookie(context, 'refresh_token', getRefreshTokenDeleteCookieOptions(isRequestSecure(context.req.url)))
-      return context.json({ message: 'Logged out' }, 200)
-    } catch (error) {
-      return handleAuthError(context, error, 'Logout')
-    }
-  })
-
-  // 4. Setup & Password Reset
-  app.route('/', setupApp)
-  app.route('/', passwordResetApp)
-
-  // 5. Protected CMS API
-  const apiProtected = new Hono<{ Bindings: Env; Variables: Variables }>()
-  apiProtected.use('*', authMiddleware())
-
-  apiProtected.route('/settings', settingsApp)
-  apiProtected.route('/schema', schemaApp)
-  apiProtected.route('/dashboard-layout', dashboardLayoutApp)
-  apiProtected.route('/seeds', seedsApp)
-  apiProtected.route('/content', notificationsApp)
-  apiProtected.route('/content', statsApp)
-  apiProtected.route('/content', rotateFieldApp)
-  apiProtected.route('/content', draftApp)
-  apiProtected.route('/content', backrefsApp)
-  apiProtected.route('/content', contentFeature)
-  apiProtected.route('/widget', widgetApp)
-  apiProtected.route('/automations', automationsApp)
-  apiProtected.route('/', uploadRoutes)
-  
-  // 6. Public API (must be registered before apiProtected to avoid auth middleware interception)
-  const apiPublic = new Hono<{ Bindings: Env; Variables: Variables }>()
-  apiPublic.use('*', publicRateLimitMiddleware())
-  apiPublic.use('*', apiKeyMiddleware())
-  apiPublic.route('/', publicRoutes)
-  app.route('/api/v1/public', apiPublic)
-
-  // Webhooks API (public, verified via signature)
-  app.route('/api/webhooks', webhooksApp)
-
-  app.get('/api/media/:key', (context) => serveMediaHandler(context))
-  app.route('/api', apiProtected)
-  app.route('/api/search', searchRouter)
-
-  // 7. Dashboard SPA — serve static assets from Workers Assets binding
-  app.get('/admin', (context) => context.redirect('/admin/', 301))
-  app.get('/admin/*', async (context) => {
-    if (!context.env.ASSETS) {
-      return context.text('Dashboard not configured. Set up the ASSETS binding in wrangler.toml pointing to node_modules/@beechcms/api/assets/dashboard', 503)
-    }
-    const url = new URL(context.req.url)
-    const originalPath = url.pathname
-    url.pathname = originalPath.replace(/^\/admin/, '') || '/'
-    
-    let assetResponse = await context.env.ASSETS.fetch(new Request(url.toString(), context.req.raw))
-    if (assetResponse.status === 404) {
-      // SPA fallback: any unmatched /admin/* route serves index.html
-      assetResponse = await context.env.ASSETS.fetch(new Request(new URL('/index.html', context.req.url)))
-    }
-    // ASSETS returns an immutable Response — wrap it to inject security headers
-    const headers = new Headers(assetResponse.headers)
-    headers.set('Content-Security-Policy',
-      "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob: https:; connect-src 'self'; frame-ancestors 'none'"
-    )
-    headers.set('X-Frame-Options', 'DENY')
-    headers.set('X-Content-Type-Options', 'nosniff')
-    headers.set('Referrer-Policy', 'strict-origin-when-cross-origin')
-    return new Response(assetResponse.body, { status: assetResponse.status, headers })
-  })
-
-  return app
-}