d3ro-voice/server/supabase/functions/_shared/core-contract.generated.ts

198 lines
8.5 KiB
TypeScript

// 생성 파일 — 직접 수정 금지.
// 정본: packages/core/src/plan-catalog.ts, packages/core/src/web-urls.ts, packages/core/src/guards.ts, packages/core/src/admin-roles.ts
// 갱신: npm run contract:sync / 검사: npm run contract:check
// Deno Edge Function은 packages/core를 번들할 수 없어서 정본 소스를 그대로 복사한다.
// ── 원본: packages/core/src/plan-catalog.ts ───────────────────────────
// packages/core/src/plan-catalog.ts
// 요금제 가격 SSOT — 데스크톱·웹·관리자·모바일·랜딩 사이트가 모두 여기서 읽는다.
//
// Supabase Edge Function(Deno)은 저장소의 이 경로를 번들할 수 없으므로
// `npm run contract:sync`가 server/supabase/functions/_shared/core-contract.generated.ts 로
// 값을 복사하고, `npm run contract:check`가 CI에서 어긋남을 막는다.
// 그래서 이 파일은 import 없이 순수 값만 둔다.
export type PaidPlanTier = 'pro' | 'pro_plus'
export type PlanTier = 'free' | PaidPlanTier
/**
* 월 요금(원). Payple 청구 금액이며, 기존 구독자도 다음 갱신부터 이 값으로 청구된다.
* Google Play 가격은 Play Console에서 따로 관리한다. 웹 결제는 Payple(KRW) 하나다.
*/
export const PLAN_PRICE_KRW: Readonly<Record<PlanTier, number>> = {
free: 0,
pro: 2900,
pro_plus: 8900,
}
// ── 클라우드 사용량 한도 ─────────────────────────────────
// 서버(Deno `_shared/quota.ts`)가 실제로 집행하고, 데스크톱·사이트는 표시만 한다.
// Free 는 주간, 나머지는 일간. limit: -1=무제한, 0=사용 불가, 양수=한도.
/** 사용량 한도를 갖는 티어. 결제 티어 외에 팀·엔터프라이즈 계약 티어를 포함한다. */
export type PlanQuotaTier = PlanTier | 'team' | 'enterprise'
/** 쿼터 추적 키 — 서버 daily_usage.feature 값과 같다. */
export type PlanQuotaFeature =
| 'stt_transcribe'
| 'llm_haiku'
| 'llm_sonnet'
| 'llm_opus'
| 'realtime_session'
| 'knowledge_embedding'
export type PlanQuotaPeriod = 'daily' | 'weekly'
export interface PlanQuota {
/** -1=무제한, 0=사용 불가, 양수=한도 */
readonly limit: number
readonly period: PlanQuotaPeriod
}
export const PLAN_QUOTA: Readonly<Record<PlanQuotaTier, Readonly<Record<PlanQuotaFeature, PlanQuota>>>> = {
free: {
stt_transcribe: { limit: 250, period: 'weekly' },
llm_haiku: { limit: 250, period: 'weekly' },
llm_sonnet: { limit: 0, period: 'daily' },
llm_opus: { limit: 0, period: 'daily' },
realtime_session: { limit: 0, period: 'daily' },
knowledge_embedding: { limit: 5_000, period: 'weekly' },
},
pro: {
stt_transcribe: { limit: -1, period: 'daily' },
llm_haiku: { limit: 1500, period: 'daily' },
llm_sonnet: { limit: 300, period: 'daily' },
llm_opus: { limit: 50, period: 'daily' },
// 세션 수 기준 (~$0.016/분 mini — 세션당 평균 수 분 가정)
realtime_session: { limit: 30, period: 'daily' },
knowledge_embedding: { limit: 50_000, period: 'daily' },
},
pro_plus: {
stt_transcribe: { limit: -1, period: 'daily' },
llm_haiku: { limit: -1, period: 'daily' },
llm_sonnet: { limit: 1500, period: 'daily' },
llm_opus: { limit: 300, period: 'daily' },
realtime_session: { limit: 120, period: 'daily' },
knowledge_embedding: { limit: 150_000, period: 'daily' },
},
team: {
stt_transcribe: { limit: -1, period: 'daily' },
llm_haiku: { limit: -1, period: 'daily' },
llm_sonnet: { limit: 3000, period: 'daily' },
llm_opus: { limit: 600, period: 'daily' },
realtime_session: { limit: 300, period: 'daily' },
knowledge_embedding: { limit: 300_000, period: 'daily' },
},
enterprise: {
stt_transcribe: { limit: -1, period: 'daily' },
llm_haiku: { limit: -1, period: 'daily' },
llm_sonnet: { limit: -1, period: 'daily' },
llm_opus: { limit: -1, period: 'daily' },
realtime_session: { limit: -1, period: 'daily' },
knowledge_embedding: { limit: -1, period: 'daily' },
},
}
// ── 원본: packages/core/src/web-urls.ts ───────────────────────────────
// packages/core/src/web-urls.ts
// 공개 웹 주소 SSOT — 결제·법률·다운로드·초대 링크는 모두 여기서 만든다.
//
// 한 도메인 아래 세 서비스가 있다.
// / 랜딩 사이트(site/, Cloudflare Pages) — 다운로드, 법률 문서, 초대 수락
// /app/... 웹앱(apps/web, Next basePath '/app') — 로그인, 결제, 대시보드
// /api, /health API 서버(apps/api-server) — 관리자 인증, STT 중계
// 사이트 브리지 워커(server/cloudflare-site-bridge)가 /app·/api 요청을 도메인 원본
// (Cloudflare Tunnel kd-nas → NAS)으로 흘려보내고, 나머지는 Pages로 보낸다.
// 터널 ingress: d3ro.chanpaca.net path ^/app → NAS 3002, 그 밖 → NAS 5050.
// Deno 쪽 사본은 plan-catalog.ts 와 같은 방식으로 생성된다. 이 파일도 순수 값만 둔다.
export const PUBLIC_SITE_ORIGIN = 'https://d3ro.chanpaca.net'
/** apps/web 의 Next basePath. next.config 와 브리지 워커 라우팅이 이 값을 따른다. */
export const WEB_APP_BASE_PATH = '/app'
export const WEB_APP_URL = `${PUBLIC_SITE_ORIGIN}${WEB_APP_BASE_PATH}`
/** API 서버(apps/api-server)가 받는 경로. 관리자 로그인·stt-proxy가 이 도메인으로 부른다. */
export const API_PATH_PREFIXES = ['/api', '/health'] as const
export const SITE_URLS = {
home: `${PUBLIC_SITE_ORIGIN}/`,
download: `${PUBLIC_SITE_ORIGIN}/#download`,
privacy: `${PUBLIC_SITE_ORIGIN}/privacy/`,
terms: `${PUBLIC_SITE_ORIGIN}/terms/`,
deleteAccount: `${PUBLIC_SITE_ORIGIN}/delete-account/`,
acceptInvite: `${PUBLIC_SITE_ORIGIN}/accept-invite/`,
} as const
/**
* 웹 결제 페이지 URL. 결제는 이 페이지 안의 Payple 창에서 끝나므로 복귀 쿼리가 없다.
* - `tier`: 고를 요금제를 미리 선택한다.
*/
export function billingUrl(options: { tier?: PaidPlanTier } = {}): string {
const params = new URLSearchParams()
if (options.tier) params.set('tier', options.tier)
const query = params.toString()
return `${WEB_APP_URL}/billing${query ? `?${query}` : ''}`
}
// ── 원본: packages/core/src/guards.ts ─────────────────────────────────
// packages/core/src/guards.ts
// 앱·서버 간 중복되던 순수 런타임 타입 가드 및 LIKE 패턴 이스케이프 정본 (W5-05).
// 오류 클래스는 표면마다 다르므로 throw 대신 boolean 판정 함수만 제공한다.
const RFC_UUID_PATTERN =
/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i
export function isRecord(value: unknown): value is Record<string, unknown> {
return typeof value === 'object' && value !== null && !Array.isArray(value)
}
export function isUuid(value: unknown): value is string {
return typeof value === 'string' && RFC_UUID_PATTERN.test(value)
}
export function escapeLikePattern(value: string): string {
return value.replace(/[\\%_]/g, (character) => `\\${character}`)
}
export function escapePostgrestLikePattern(value: string): string {
const escaped = value.replace(/[\\%_*]/g, (character) => `\\${character}`)
return `*${escaped}*`
}
// ── 원본: packages/core/src/admin-roles.ts ────────────────────────────
// packages/core/src/admin-roles.ts
// 어드민 콘솔(apps/admin)과 Supabase Edge(_shared/admin-auth.ts) 공용 권한 계층 정본 (W5-07).
// sync-core-contract.mjs를 통해 Deno Edge Function 사본으로도 복제되므로 외부 import를 두지 않는다.
export type CanonicalAdminRole = 'user' | 'manager' | 'admin' | 'super_admin'
export const ADMIN_ROLE_RANK: Readonly<Record<CanonicalAdminRole, number>> = {
user: 0,
manager: 1,
admin: 2,
super_admin: 3,
}
export function normalizeAdminRoleAlias(value: unknown): CanonicalAdminRole {
if (typeof value !== 'string') return 'user'
const compact = value.replace(/[_-]/g, '').trim().toLowerCase()
if (compact === 'superadmin') return 'super_admin'
if (compact === 'admin') return 'admin'
if (compact === 'manager') return 'manager'
return 'user'
}
export function hasMinimumAdminRole(
actualRole: unknown,
minimumRole: Exclude<CanonicalAdminRole, 'user'>,
): boolean {
const actual = normalizeAdminRoleAlias(actualRole)
return ADMIN_ROLE_RANK[actual] >= ADMIN_ROLE_RANK[minimumRole]
}