@sazuapp/client 0.1.1 → 0.3.0

package/README.md

@@ -7,7 +7,7 @@
 
 > ℹ️ **이름에 대해**: `client` 는 **SAZU API 의 클라이언트 (= API 를 호출하는 라이브러리)** 라는 의미입니다.
 > 브라우저(client-side) 전용이라는 뜻이 아닙니다. **Node.js·서버 사이드에서만 사용**하세요.
-> (`@aws-sdk/client-s3`·`@supabase/supabase-js` 같은 업계 관용 네이밍을 따릅니다.)
+> (`@aws-sdk/client-s3`·`@octokit/rest` 같은 업계 관용 네이밍을 따릅니다.)
 
 <br/><br/><br/>
 
@@ -143,10 +143,11 @@ export async function POST(req: Request) {
 ```ts
 const sazu = new SazuClient({
   apiKey: process.env.SAZU_API_KEY!,
-  baseUrl: 'https://api.sazu.app',  // 기본값
-  maxRetries: 2,                     // 기본 2 (5xx·네트워크 에러)
-  timeoutMs: 30000,                  // 기본 30s
-  headers: {                         // 추가 헤더 (선택)
+  baseUrl: 'https://api.sazu.app',  // 기본값 (*.sazu.app · localhost · 127.0.0.1 만 허용)
+  allowCustomBaseUrl: false,         // 자체 호스팅·프록시 사용 시 true 필요
+  maxRetries: 2,                     // 기본 2, 상한 5
+  timeoutMs: 30000,                  // 기본 30s, 하한 1000 / 상한 600000
+  headers: {                         // 추가 헤더 (Authorization·Cookie·X-Forwarded-* 등 위험 헤더는 자동 제거)
     'X-Trace-Id': '...',
   },
 })
@@ -154,6 +155,16 @@ const sazu = new SazuClient({
 
 <br/><br/><br/>
 
+## 보안 옵션 (v0.2.0+)
+
+- **baseUrl 화이트리스트**: 기본적으로 `*.sazu.app`, `localhost`, `127.0.0.1` 만 허용합니다. 자체 호스팅·프록시 사용 시 `allowCustomBaseUrl: true` 를 명시하세요. (공급망 공격에 의한 키 유출 차단)
+- **응답 크기 5MB 한도**: MITM/다운그레이드로 인한 OOM 방어. 초과 시 `RESPONSE_TOO_LARGE` 에러. (SDK 측 safety cap 입니다 — 서버 측 사용량 통계(대시보드)는 정상 호출로 기록됩니다. SAZU API 정상 응답은 1MB 미만이라 실제 발현 가능성은 극히 낮습니다.)
+- **재시도·타임아웃 clamp**: `maxRetries` 0~5, `timeoutMs` 1000~600000 범위로 자동 제한.
+- **위험 헤더 자동 제거**: `Authorization`·`Cookie`·`Host`·`X-Forwarded-*`·`X-API-Key`·`User-Agent` 등은 옵션으로 넘겨도 제거됩니다.
+- **브라우저 차단 강제**: `SAZU_CLIENT_BLOCK_BROWSER=1` 환경변수 설정 시 브라우저 환경에서 throw.
+
+<br/><br/><br/>
+
 ## 문의
 
 contact@sazu.app

package/dist/http.d.ts

@@ -1,22 +1,29 @@
 /**
  * HTTP fetch wrapper — 서버 사이드 전용.
  *
- * 보안 정책:
- *  - 브라우저 환경 감지 시 경고 (API 키 노출 방지)
+ * 보안 정책 (v0.2.0):
+ *  - baseUrl 화이트리스트 (*.sazu.app · localhost · 127.0.0.1). 다른 호스트는
+ *    allowCustomBaseUrl: true 옵션을 명시해야 통과 — 공급망 공격 차단.
+ *  - 응답 본문 5MB cap (ReadableStream) — MITM/다운그레이드 거대 응답 OOM 방어.
+ *  - maxRetries 0~5 clamp — 5xx 증폭 공격 차단.
+ *  - timeoutMs 1000~600000 clamp — 즉시 타임아웃 → 재시도 폭주 차단.
+ *  - 위험 헤더 (Cookie·Host·X-Forwarded-*·Authorization 등) 거부 — smuggling 차단.
+ *  - 브라우저 환경: 기본 console.warn. SAZU_CLIENT_BLOCK_BROWSER=1 시 throw.
  *  - 모든 요청에 X-Client-Type: sdk 헤더 부착 (서버 측 통계 분리)
  *  - 응답 _meta.responseId 자동 추출 → SazuApiError 에 포함
- *  - 5xx / 0 (네트워크) 에러는 exponential backoff 로 재시도 (옵션)
  */
 export interface ClientOptions {
     /** SAZU API 키 (필수). 환경변수 SAZU_API_KEY 권장. */
     apiKey: string;
-    /** API 베이스 URL. 기본 https://api.sazu.app */
+    /** API 베이스 URL. 기본 https://api.sazu.app. 다른 호스트 사용 시 allowCustomBaseUrl 옵션 필요. */
     baseUrl?: string;
-    /** 추가 HTTP 헤더 (재정의 금지: Authorization·x-api-key·X-Client-Type) */
+    /** baseUrl 화이트리스트 우회 (자체 호스팅·프록시 등 명시적 opt-in). 기본 false. */
+    allowCustomBaseUrl?: boolean;
+    /** 추가 HTTP 헤더 (위험 헤더 자동 제거). */
     headers?: Record<string, string>;
-    /** 재시도 횟수 (5xx·네트워크 에러). 기본 2. */
+    /** 재시도 횟수 (5xx·네트워크 에러). 기본 2. 상한 5. */
     maxRetries?: number;
-    /** fetch 타임아웃 ms. 기본 30000. */
+    /** fetch 타임아웃 ms. 기본 30000. 하한 1000, 상한 600000. */
     timeoutMs?: number;
 }
 export declare class HttpClient {

package/dist/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA8BD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,SAAS,CAAQ;gBAEb,IAAI,EAAE,aAAa;IAgBzB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;CA8GnE"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AA8KD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,SAAS,CAAQ;gBAEb,IAAI,EAAE,aAAa;IAgBzB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;CA4GnE"}

package/dist/http.js

@@ -1,37 +1,181 @@
 /**
  * HTTP fetch wrapper — 서버 사이드 전용.
  *
- * 보안 정책:
- *  - 브라우저 환경 감지 시 경고 (API 키 노출 방지)
+ * 보안 정책 (v0.2.0):
+ *  - baseUrl 화이트리스트 (*.sazu.app · localhost · 127.0.0.1). 다른 호스트는
+ *    allowCustomBaseUrl: true 옵션을 명시해야 통과 — 공급망 공격 차단.
+ *  - 응답 본문 5MB cap (ReadableStream) — MITM/다운그레이드 거대 응답 OOM 방어.
+ *  - maxRetries 0~5 clamp — 5xx 증폭 공격 차단.
+ *  - timeoutMs 1000~600000 clamp — 즉시 타임아웃 → 재시도 폭주 차단.
+ *  - 위험 헤더 (Cookie·Host·X-Forwarded-*·Authorization 등) 거부 — smuggling 차단.
+ *  - 브라우저 환경: 기본 console.warn. SAZU_CLIENT_BLOCK_BROWSER=1 시 throw.
  *  - 모든 요청에 X-Client-Type: sdk 헤더 부착 (서버 측 통계 분리)
  *  - 응답 _meta.responseId 자동 추출 → SazuApiError 에 포함
- *  - 5xx / 0 (네트워크) 에러는 exponential backoff 로 재시도 (옵션)
  */
 import { SazuApiError } from './errors.js';
 const DEFAULT_BASE_URL = 'https://api.sazu.app';
 const DEFAULT_MAX_RETRIES = 2;
 const DEFAULT_TIMEOUT_MS = 30_000;
-/**
- * 클라이언트 브라우저 환경 감지 — API 키 유출 위험 경고.
- *
- * 1회만 경고 출력 (반복 호출 시 spam 방지).
- */
+const MAX_RETRIES_HARD_CAP = 5;
+const MIN_TIMEOUT_MS = 1_000;
+const MAX_TIMEOUT_MS = 600_000;
+const MAX_RESPONSE_BYTES = 5 * 1024 * 1024; // 5MB
+// 화이트리스트: 정확 호스트 또는 suffix 매칭 (.sazu.app)
+const ALLOWED_HOST_SUFFIXES = ['.sazu.app'];
+const ALLOWED_HOSTS_EXACT = ['sazu.app', 'localhost', '127.0.0.1'];
+// 거부 헤더 (소문자 비교, smuggling/세션 위조/보호 헤더 override 차단)
+const DENIED_HEADER_LOWER = new Set([
+    'authorization',
+    'cookie',
+    'host',
+    'x-api-key',
+    'x-client-type',
+    'x-forwarded-for',
+    'x-forwarded-host',
+    'x-forwarded-proto',
+    'x-forwarded-port',
+    'x-real-ip',
+    'user-agent',
+    'content-length',
+    'transfer-encoding',
+]);
+// ── 환경 가드 ────────────────────────────────────────────────────────────
 let warnedBrowser = false;
 function warnIfBrowser() {
+    if (typeof window === 'undefined' || typeof window.document === 'undefined')
+        return;
+    if (typeof process !== 'undefined' &&
+        process.env?.SAZU_CLIENT_BLOCK_BROWSER === '1') {
+        throw new SazuApiError({
+            status: 0,
+            code: 'BROWSER_BLOCKED',
+            message: '[@sazuapp/client] 브라우저 환경에서 차단됨 (SAZU_CLIENT_BLOCK_BROWSER=1). 서버 사이드에서 사용하세요.',
+        });
+    }
     if (warnedBrowser)
         return;
-    if (typeof window !== 'undefined' && typeof window.document !== 'undefined') {
-        warnedBrowser = true;
+    warnedBrowser = true;
+    // eslint-disable-next-line no-console
+    console.warn('[@sazuapp/client] ⚠ 브라우저 환경 감지. 본 SDK 는 서버 사이드 전용입니다.\n' +
+        '  API 키가 클라이언트 번들에 포함되면 외부에 노출됩니다.\n' +
+        '  Next.js: app/api/* 또는 server actions 안에서만 사용하세요.\n' +
+        '  Vite/SvelteKit: +server.ts 또는 endpoint 에서만 사용하세요.\n' +
+        '  강제 차단: SAZU_CLIENT_BLOCK_BROWSER=1 환경변수 설정.');
+}
+// ── 입력 sanitize ────────────────────────────────────────────────────────
+function sanitizeBaseUrl(baseUrl, allowCustom) {
+    let parsed;
+    try {
+        parsed = new URL(baseUrl);
+    }
+    catch {
+        throw new SazuApiError({
+            status: 0,
+            code: 'INVALID_BASE_URL',
+            message: `baseUrl 파싱 실패: ${baseUrl}`,
+        });
+    }
+    if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {
+        throw new SazuApiError({
+            status: 0,
+            code: 'INVALID_BASE_URL',
+            message: `baseUrl 프로토콜은 http(s) 만 허용됩니다: ${parsed.protocol}`,
+        });
+    }
+    if (!allowCustom) {
+        const host = parsed.hostname.toLowerCase();
+        const isAllowed = ALLOWED_HOSTS_EXACT.includes(host) ||
+            ALLOWED_HOST_SUFFIXES.some((suffix) => host.endsWith(suffix));
+        if (!isAllowed) {
+            throw new SazuApiError({
+                status: 0,
+                code: 'BASE_URL_NOT_ALLOWED',
+                message: `baseUrl 호스트가 화이트리스트 밖입니다 (${host}). ` +
+                    `*.sazu.app · localhost · 127.0.0.1 만 기본 허용. ` +
+                    `자체 호스팅·프록시 사용 시 allowCustomBaseUrl: true 옵션을 명시하세요.`,
+            });
+        }
+    }
+    return baseUrl.replace(/\/$/, '');
+}
+let warnedStrippedHeaders = false;
+function sanitizeHeaders(input) {
+    if (!input)
+        return {};
+    const out = {};
+    const stripped = [];
+    for (const [k, v] of Object.entries(input)) {
+        if (typeof v !== 'string')
+            continue;
+        if (DENIED_HEADER_LOWER.has(k.toLowerCase())) {
+            stripped.push(k);
+            continue;
+        }
+        out[k] = v;
+    }
+    if (stripped.length > 0 && !warnedStrippedHeaders) {
+        warnedStrippedHeaders = true;
         // eslint-disable-next-line no-console
-        console.warn('[@sazuapp/client] ⚠ 브라우저 환경 감지. 본 SDK 는 서버 사이드 전용입니다.\n' +
-            '  API 키가 클라이언트 번들에 포함되면 외부에 노출됩니다.\n' +
-            '  Next.js: app/api/* 또는 server actions 안에서만 사용하세요.\n' +
-            '  Vite/SvelteKit: +server.ts 또는 endpoint 에서만 사용하세요.');
+        console.warn(`[@sazuapp/client] ⚠ 위험 헤더 자동 제거: ${stripped.join(', ')}. ` +
+            '보호 헤더 (x-api-key·Authorization·X-Client-Type·User-Agent) 와 ' +
+            'smuggling 위험 헤더 (Cookie·Host·X-Forwarded-*) 는 옵션으로 넘겨도 무시됩니다.');
     }
+    return out;
+}
+function clampNumber(value, fallback, min, max) {
+    const n = typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+    return Math.min(Math.max(n, min), max);
 }
 async function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+/**
+ * 응답 본문을 size cap 적용해 텍스트로 읽기.
+ * 한도 초과 시 SazuApiError throw.
+ */
+async function readBodyWithCap(res, maxBytes) {
+    if (!res.body)
+        return await res.text();
+    const reader = res.body.getReader();
+    const chunks = [];
+    let received = 0;
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (value) {
+                received += value.byteLength;
+                if (received > maxBytes) {
+                    try {
+                        await reader.cancel();
+                    }
+                    catch { /* ignore */ }
+                    throw new SazuApiError({
+                        status: res.status,
+                        code: 'RESPONSE_TOO_LARGE',
+                        message: `응답 본문이 ${maxBytes} bytes 한도를 초과했습니다.`,
+                    });
+                }
+                chunks.push(value);
+            }
+        }
+    }
+    finally {
+        try {
+            reader.releaseLock();
+        }
+        catch { /* ignore */ }
+    }
+    const merged = new Uint8Array(received);
+    let offset = 0;
+    for (const c of chunks) {
+        merged.set(c, offset);
+        offset += c.byteLength;
+    }
+    return new TextDecoder('utf-8').decode(merged);
+}
+// ── HttpClient ────────────────────────────────────────────────────────────
 export class HttpClient {
     apiKey;
     baseUrl;
@@ -47,10 +191,10 @@ export class HttpClient {
             });
         }
         this.apiKey = opts.apiKey;
-        this.baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, '');
-        this.headers = opts.headers ?? {};
-        this.maxRetries = opts.maxRetries ?? DEFAULT_MAX_RETRIES;
-        this.timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.baseUrl = sanitizeBaseUrl(opts.baseUrl ?? DEFAULT_BASE_URL, opts.allowCustomBaseUrl === true);
+        this.headers = sanitizeHeaders(opts.headers);
+        this.maxRetries = clampNumber(opts.maxRetries, DEFAULT_MAX_RETRIES, 0, MAX_RETRIES_HARD_CAP);
+        this.timeoutMs = clampNumber(opts.timeoutMs, DEFAULT_TIMEOUT_MS, MIN_TIMEOUT_MS, MAX_TIMEOUT_MS);
     }
     async request(path, init = {}) {
         warnIfBrowser();
@@ -58,7 +202,7 @@ export class HttpClient {
         const headers = {
             'Content-Type': 'application/json',
             ...this.headers,
-            // 아래 3개는 사용자가 override 불가
+            // 아래 3개는 사용자가 override 불가 (sanitizeHeaders 도 차단하지만 이중 보호)
             'x-api-key': this.apiKey,
             'X-Client-Type': 'sdk',
             'User-Agent': `@sazuapp/client/${PACKAGE_VERSION}`,
@@ -74,7 +218,7 @@ export class HttpClient {
                     signal: controller.signal,
                 });
                 clearTimeout(timeoutHandle);
-                const text = await res.text();
+                const text = await readBodyWithCap(res, MAX_RESPONSE_BYTES);
                 let body = null;
                 try {
                     body = text ? JSON.parse(text) : null;
@@ -96,7 +240,6 @@ export class HttpClient {
                         responseId,
                         retryAfterSec: Number.isFinite(retryAfterSec) ? retryAfterSec : undefined,
                     });
-                    // 재시도 가능한 케이스: 5xx, 429
                     if (err.isTransient && attempt < this.maxRetries) {
                         const backoffMs = Math.min(2 ** attempt * 500, 5000);
                         lastError = err;
@@ -132,7 +275,6 @@ export class HttpClient {
                     }
                     throw err;
                 }
-                // 네트워크·timeout 등
                 const message = err instanceof Error ? err.message : String(err);
                 const netErr = new SazuApiError({
                     status: 0,
@@ -152,6 +294,4 @@ export class HttpClient {
         throw lastError ?? new SazuApiError({ status: 0, code: 'UNKNOWN', message: '호출 실패.' });
     }
 }
-// build 시점에 tsc 가 dist/index.js 의 import 가 필요. 패키지 버전은 빌드 산출물에서 가져옴.
-// 단순화 위해 const 로 fix — 패키지 메이저 변경 시 동기 갱신.
-const PACKAGE_VERSION = '0.1.0';
+const PACKAGE_VERSION = '0.2.0';

package/dist/types.d.ts

@@ -1,11 +1,10 @@
 /**
  * SAZU API 입력·출력 타입.
  *
- * TypeScript 인터페이스만 정의 (런타임 zod 검증 안 함 — 의존성 0 유지).
+ * TypeScript 인터페이스만 정의 (런타임 검증 없음 — 의존성 0 유지).
  * 응답 schema 는 공개 docs (https://www.sazu.app/manse-api/docs) 와 동기.
  *
- * 비공개 내부 구조는 노출하지 않는다 — 본 SDK 는 REST API 의 얇은 wrapper 일 뿐,
- * sazu-logic 코드·계산 알고리즘은 절대 포함하지 않는다.
+ * 본 SDK 는 REST API 의 얇은 wrapper 일 뿐, 계산 엔진·내부 알고리즘은 포함하지 않습니다.
  */
 export interface ResponseMeta {
     /** forensics 추적용 응답 ID. 형식: `${ts36}-${keyHash8}-${rand8}` */
@@ -51,7 +50,7 @@ export interface CalculateInput {
     isFemale: boolean;
     /** 음력 여부. 기본 false. */
     isLunar?: boolean;
-    /** 출생 도시 (진태양시 보정용). 기본 '서울'. */
+    /** 출생 도시 (도시 경도 보정용). 기본 '서울'. */
     birthCity?: string;
     /** 한글 또는 한자 출력. 기본 'ko'. */
     locale?: Locale;
@@ -59,6 +58,11 @@ export interface CalculateInput {
     modules?: string[];
     /** 대운 개수 (13~20) */
     decadeCount?: number;
+    /**
+     * 진태양시(경도차 + 균시차) 적용 여부. 기본 false.
+     * false = 한국 관습(자시 23:30, 경도차만). true = 진태양시(자시 23:00, 균시차 포함).
+     */
+    trueSolarTime?: boolean;
     /** 응답 상세 수준. 기본 'standard'. */
     detail?: DetailLevel;
 }
@@ -93,14 +97,35 @@ export interface CalculateModules {
     /** 기타 모듈 (확장 가능) */
     [moduleId: string]: unknown;
 }
+/**
+ * 시간대·경도·진태양시 보정 정보 (응답 timezone).
+ */
+export interface TimezoneInfo {
+    /** 출생 도시 (요청값 echo) */
+    city: string;
+    /** 도시 표준시 UTC offset (분) */
+    utcOffset: number;
+    /** 도시 경도 (°, 동경 +) */
+    longitude: number;
+    /** 'convention' = 관습(자시 23:30, 경도만) / 'trueSolar' = 진태양시(자시 23:00, 균시차 포함) */
+    mode: 'convention' | 'trueSolar';
+    /** 경도차 보정 (분) */
+    longitudeCorrectionMinutes: number;
+    /** 균시차 (분). 관습 모드는 null. */
+    equationOfTimeMinutes: number | null;
+    /** 최종 보정 (분) */
+    correctionMinutes: number;
+    /** 확장 필드 대비 */
+    [key: string]: unknown;
+}
 /**
  * 사주 분석 응답 — 서버가 반환하는 data 전체.
  */
 export interface CalculateResult {
     /** 정규화된 입력값 (서버 측 검증·변환 결과) */
     input: Record<string, unknown>;
-    /** 시간대·진태양시 등 보정 정보 */
-    timezone: Record<string, unknown>;
+    /** 시간대·경도·진태양시 등 보정 정보 */
+    timezone: TimezoneInfo;
     /** 요청한 모듈별 분석 결과 */
     modules: CalculateModules;
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1,10 +1,9 @@
 /**
  * SAZU API 입력·출력 타입.
  *
- * TypeScript 인터페이스만 정의 (런타임 zod 검증 안 함 — 의존성 0 유지).
+ * TypeScript 인터페이스만 정의 (런타임 검증 없음 — 의존성 0 유지).
  * 응답 schema 는 공개 docs (https://www.sazu.app/manse-api/docs) 와 동기.
  *
- * 비공개 내부 구조는 노출하지 않는다 — 본 SDK 는 REST API 의 얇은 wrapper 일 뿐,
- * sazu-logic 코드·계산 알고리즘은 절대 포함하지 않는다.
+ * 본 SDK 는 REST API 의 얇은 wrapper 일 뿐, 계산 엔진·내부 알고리즘은 포함하지 않습니다.
  */
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sazuapp/client",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "SAZU API 공식 TypeScript SDK — 사주·만세력·합형충파해·격국·용신 등 14개 명리 분석을 한 줄로.",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,7 +19,8 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "dev": "tsc -p tsconfig.json --watch"
+    "dev": "tsc -p tsconfig.json --watch",
+    "prepublishOnly": "tsc -p tsconfig.json"
   },
   "engines": {
     "node": ">=18"