@fetching-korea/mail-template-global

FETCHING 글로벌(US/JP) 이메일 템플릿. React Email 기반.

Install

npm install @fetching-korea/mail-template-global

Usage

import { getGlobalWelcomeBody, getMailSubject } from '@fetching-korea/mail-template-global'

// 영어 (US)
const subjectEn = getMailSubject('globalWelcome', 'en')   // 'Welcome to FETCHING'
const htmlEn = await getGlobalWelcomeBody({
  promoCode: 'FETCHING20',
  exploreUrl: 'https://fetching.co.kr/en',
  unsubscribeUrl: 'https://...',
  curation: undefined, items: undefined, magazine: undefined,
}, 'en')

// 일본어 (JP)
const subjectJa = getMailSubject('globalWelcome', 'ja')   // 'FETCHINGへようこそ'
const htmlJa = await getGlobalWelcomeBody({ /* 동일 props */ }, 'ja')

locale 은 메일 본문 텍스트와 푸터(送信者 실주소·配信停止 라벨)를 region 별로 분기합니다:

• en — 미국 외국 법인 주소 (CAN-SPAM)
• ja — KR 본사 주소 (特定電子メール法)

Templates

지원 트리거 (모두 en / ja 지원):

• getGlobalWelcomeBody — 글로벌 웰컴 메일
• getOrderCompleteBody — 주문 완료 메일
• getOrderCancelBody — 주문 취소 메일 (전체/부분)
• getOrderAdditionalPayBody — 차액(추가) 결제 메일

Development

npm install
npm test
npm run build
node scripts/preview.mjs && open preview-out.html

Roadmap

• 배송 트리거 (SHIPPING_SHIPPED / SHIPPING_DELIVERED)
• TrustStats 컴포넌트 locale 화 (현재 영문 하드코딩 — 브랜드 임팩트 유지 목적)

Architecture

• React Email 컴포넌트 → @react-email/render 로 HTML 문자열 생성
• ESM/CJS dual export (소비자가 어느 모듈 시스템이든 import 가능)
• locale 리소스 (src/locales/) 분리 — 언어 추가 시 기존 컴포넌트 재사용

관련 문서:

• 디자인 spec: 별도 저장소 (cafe24-backend/docs/superpowers/specs/2026-04-21-global-welcome-mail-design.md)
• 구현 plan: 별도 저장소 (cafe24-backend/docs/superpowers/plans/2026-04-21-global-welcome-mail.md)

License

ISC