@sazuapp/client 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/README.md +9 -5
  2. package/dist/client.d.ts +1 -1
  3. package/dist/client.js +1 -1
  4. package/dist/index.d.ts +1 -1
  5. package/dist/index.d.ts.map +1 -1
  6. package/dist/types.d.ts +28 -7
  7. package/dist/types.d.ts.map +1 -1
  8. package/package.json +1 -1
package/README.md CHANGED
@@ -1,10 +1,14 @@
1
1
  # @sazuapp/client
2
2
 
3
- [SAZU API](https://www.sazu.app/manse-api) 의 공식 **TypeScript SDK**.
3
+ [SAZU API](https://www.sazu.app/manse-api) 의 공식 **TypeScript SDK** (서버 사이드 전용).
4
4
  한 줄로 사주·만세력·합형충파해·격국·용신 등 **14개 명리 모듈** 을 분석합니다.
5
5
 
6
6
  > sazu.app 에서 제공하는 manse-api 이용자들을 위한 공식 TypeScript SDK 입니다.
7
7
 
8
+ > ℹ️ **이름에 대해**: `client` 는 **SAZU API 의 클라이언트 (= API 를 호출하는 라이브러리)** 라는 의미입니다.
9
+ > 브라우저(client-side) 전용이라는 뜻이 아닙니다. **Node.js·서버 사이드에서만 사용**하세요.
10
+ > (`@aws-sdk/client-s3`·`@supabase/supabase-js` 같은 업계 관용 네이밍을 따릅니다.)
11
+
8
12
  <br/><br/><br/>
9
13
 
10
14
  ## 왜 SAZU SDK 인가
@@ -54,10 +58,10 @@ console.log(me.tier) // 'free' | 'pro' | 'event'
54
58
 
55
59
  // 사주 분석
56
60
  const result = await sazu.calculate({
57
- birthYear: 1979,
58
- birthMonth: 2,
59
- birthDay: 8,
60
- birthHour: 18,
61
+ birthYear: 1990,
62
+ birthMonth: 3,
63
+ birthDay: 15,
64
+ birthHour: 14,
61
65
  isFemale: false,
62
66
  isLunar: false,
63
67
  birthCity: '서울',
package/dist/client.d.ts CHANGED
@@ -11,7 +11,7 @@
11
11
  * console.log(me.tier) // 'free' | 'pro' | 'event'
12
12
  *
13
13
  * const result = await sazu.calculate({
14
- * birthYear: 1979, birthMonth: 2, birthDay: 8, birthHour: 18,
14
+ * birthYear: 1990, birthMonth: 3, birthDay: 15, birthHour: 14,
15
15
  * isFemale: false, isLunar: false, birthCity: '서울',
16
16
  * })
17
17
  * console.log(result.fourPillars)
package/dist/client.js CHANGED
@@ -11,7 +11,7 @@
11
11
  * console.log(me.tier) // 'free' | 'pro' | 'event'
12
12
  *
13
13
  * const result = await sazu.calculate({
14
- * birthYear: 1979, birthMonth: 2, birthDay: 8, birthHour: 18,
14
+ * birthYear: 1990, birthMonth: 3, birthDay: 15, birthHour: 14,
15
15
  * isFemale: false, isLunar: false, birthCity: '서울',
16
16
  * })
17
17
  * console.log(result.fourPillars)
package/dist/index.d.ts CHANGED
@@ -10,5 +10,5 @@
10
10
  export { SazuClient } from './client.js';
11
11
  export { SazuApiError } from './errors.js';
12
12
  export type { ClientOptions } from './http.js';
13
- export type { PlanTier, Locale, DetailLevel, ResponseMeta, SuccessResponse, ErrorResponse, MeData, CalculateInput, CalculateResult, CalendarDirection, CalendarConvertInput, CalendarConvertResult, } from './types.js';
13
+ export type { PlanTier, Locale, DetailLevel, ResponseMeta, SuccessResponse, ErrorResponse, MeData, CalculateInput, CalculateResult, CalculateModules, CalendarDirection, CalendarConvertInput, CalendarConvertResult, } from './types.js';
14
14
  //# sourceMappingURL=index.d.ts.map
package/dist/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,YAAY,EAEV,QAAQ,EACR,MAAM,EACN,WAAW,EACX,YAAY,EACZ,eAAe,EACf,aAAa,EAEb,MAAM,EAEN,cAAc,EACd,eAAe,EAEf,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,YAAY,EAEV,QAAQ,EACR,MAAM,EACN,WAAW,EACX,YAAY,EACZ,eAAe,EACf,aAAa,EAEb,MAAM,EAEN,cAAc,EACd,eAAe,EACf,gBAAgB,EAEhB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAA"}
package/dist/types.d.ts CHANGED
@@ -63,13 +63,13 @@ export interface CalculateInput {
63
63
  detail?: DetailLevel;
64
64
  }
65
65
  /**
66
- * 사주 분석 결과.
66
+ * 사주 분석 모듈 묶음.
67
67
  *
68
68
  * 모듈별 구조가 다양하므로 타입은 `Record<string, unknown>` 로 노출.
69
69
  * 정확한 모듈별 schema 는 docs 페이지의 예시 참조.
70
70
  * (https://www.sazu.app/manse-api/docs)
71
71
  */
72
- export interface CalculateResult {
72
+ export interface CalculateModules {
73
73
  /** 사주 원국 (연·월·일·시주) */
74
74
  fourPillars?: Record<string, unknown>;
75
75
  /** 10년 단위 대운 흐름 */
@@ -93,6 +93,17 @@ export interface CalculateResult {
93
93
  /** 기타 모듈 (확장 가능) */
94
94
  [moduleId: string]: unknown;
95
95
  }
96
+ /**
97
+ * 사주 분석 응답 — 서버가 반환하는 data 전체.
98
+ */
99
+ export interface CalculateResult {
100
+ /** 정규화된 입력값 (서버 측 검증·변환 결과) */
101
+ input: Record<string, unknown>;
102
+ /** 시간대·진태양시 등 보정 정보 */
103
+ timezone: Record<string, unknown>;
104
+ /** 요청한 모듈별 분석 결과 */
105
+ modules: CalculateModules;
106
+ }
96
107
  export type CalendarDirection = 'toSolar' | 'toLunar';
97
108
  export interface CalendarConvertInput {
98
109
  year: number;
@@ -101,10 +112,20 @@ export interface CalendarConvertInput {
101
112
  direction: CalendarDirection;
102
113
  }
103
114
  export interface CalendarConvertResult {
104
- year: number;
105
- month: number;
106
- day: number;
107
- isLeapMonth?: boolean;
108
- [key: string]: unknown;
115
+ /** 정규화된 입력값 */
116
+ input: {
117
+ year: number;
118
+ month: number;
119
+ day: number;
120
+ direction: CalendarDirection;
121
+ };
122
+ /** 변환 결과 */
123
+ result: {
124
+ year: number;
125
+ month: number;
126
+ day: number;
127
+ isLeapMonth?: boolean;
128
+ [key: string]: unknown;
129
+ };
109
130
  }
110
131
  //# sourceMappingURL=types.d.ts.map
package/dist/types.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sazuapp/client",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "SAZU API 공식 TypeScript SDK — 사주·만세력·합형충파해·격국·용신 등 14개 명리 분석을 한 줄로.",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",