구독형 (SaaS) — 처음부터 판매까지

import { Saemol } from '@saemol/sdk'
const saemol = new Saemol({ secret: process.env.SAEMOL_SECRET! })

const ent = await saemol.verifyEntitlement({ apiKey: userApiKey })

if (!ent.valid) return deny()        // 만료·해지·환불 포함
ent.plan_name                         // 'Pro' — 구매한 플랜
ent.plan_features                     // 플랜별 기능 목록 (상품 설정)
ent.current_period_end                // 이번 구독 주기 종료 시각

import { SaemolOAuth } from '@saemol/sdk'

export const oauth = new SaemolOAuth({
  clientId:     process.env.SAEMOL_OAUTH_CLIENT_ID!,
  clientSecret: process.env.SAEMOL_OAUTH_CLIENT_SECRET!,
  redirectUri:  'https://app.taskflow.io/auth/saemol/callback',
})

// state(CSRF 토큰)는 SDK가 만들어 돌려줍니다 — 세션에 저장했다가 콜백에서 대조
// scope 생략 = entitlement(로그인 + 구독). 신원만 받으려면 { scope: 'identity' }
const { url, state } = oauth.createAuthorizationUrl()
session.oauthState = state
res.redirect(url)

import { isSubscriptionActive, hasPlanFeature } from '@saemol/sdk'

// GET /auth/saemol/callback?code=mfoc_…&state=…
// 오류 확인 → state 검증 → 토큰 교환 → userinfo까지 한 번에 처리합니다
const { user, tokens } = await oauth.handleCallback({
  url:           req.url,
  expectedState: session.oauthState,
})

// user → { sub, name, email, entitlement?: { valid, plan_name, plan_features, … } | null }
// scope='identity'로 요청했다면 entitlement는 없습니다 — 신원만 연결하고 끝냅니다.
if (user.entitlement) {
  if (!isSubscriptionActive(user)) return showSubscribePage()
  if (hasPlanFeature(user, 'advanced')) enableAdvancedFeatures()
}

createSession({
  saemolUserId: user.sub,
  plan:         user.entitlement?.plan_name ?? null,
  refreshToken: tokens.refresh_token,   // 갱신용으로 보관
})

import { SaemolOAuthError } from '@saemol/sdk'

try {
  user = await oauth.getUserInfo({ accessToken })
} catch (err) {
  if (err instanceof SaemolOAuthError && err.code === 'invalid_token') {
    const tokens = await oauth.refresh({ refreshToken })
    await saveTokens(tokens)          // refresh_token이 회전됨 — 새 값 저장 필수
    user = await oauth.getUserInfo({ accessToken: tokens.access_token })
  } else {
    throw err
  }
}