sori.studio/server/utils/member-avatar.js

import { join, relative } from 'node:path'
import { createError } from 'h3'
import { recordMediaCatalogFile } from '../repositories/media-catalog-repository'
import { getPostgresClient } from '../repositories/postgres-client'
import { getUploadRoot } from './upload-root'

const managedAvatarPrefix = '/uploads/members/avatars/'

/**
 * 회원 전용 썸네일 URL인지 확인한다.
 * @param {string} url - 대상 URL
 * @returns {boolean} 회원 썸네일 여부
 */
export const isManagedAvatarUrl = (url) => String(url || '').startsWith(managedAvatarPrefix)

/**
 * 회원 썸네일 URL을 실제 파일 경로로 변환한다.
 * @param {string} url - 썸네일 URL
 * @returns {string} 파일 시스템 경로
 */
export const resolveMemberAvatarPath = (url) => {
  if (!isManagedAvatarUrl(url)) {
    throw createError({
      statusCode: 400,
      message: '회원 썸네일 경로가 아닙니다.'
    })
  }

  const decodedUrl = decodeURIComponent(url)
  const uploadRoot = getUploadRoot()
  const filePath = join(uploadRoot, decodedUrl.replace(/^\/uploads\//, ''))
  const relativePath = relative(uploadRoot, filePath)

  if (relativePath.startsWith('..') || relativePath === '') {
    throw createError({
      statusCode: 400,
      message: '회원 썸네일 경로가 올바르지 않습니다.'
    })
  }

  return filePath
}

/**
 * 프로필에서 연결을 끊어도 디스크와 카탈로그 행은 유지한다.
 * 참조가 제거된 파일은 관리자 미디어의 미사용 썸네일로 계속 확인할 수 있다.
 * @param {string} url - 정리 대상 URL
 * @returns {Promise<void>}
 */
export const removeManagedAvatarAsset = async (url) => {
  if (!isManagedAvatarUrl(url)) {
    return
  }

  const sql = getPostgresClient()

  if (sql) {
    await sql`
      DELETE FROM media_references
      WHERE media_url = ${url}
        AND reference_type = 'user'
    `
  }

  await recordMediaCatalogFile(url, {
    category: '썸네일',
    origin: 'upload',
    role: 'avatar'
  })
}