connectbase-client 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -3,6 +3,30 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [1.4.0] - 2026-04-18
+
+`FetchDataResponse` 타입을 실제 서버 wire 포맷에 맞추는 타입 정정.
+
+### Fixed
+
+- **`FetchDataResponse` 필드명을 서버 응답에 맞춤**: `datas` → `data`, `total_size` → `total_count`.
+  - data-server 는 `/v1/public/tables/:tableID/data` (GET) 및 `/v1/public/tables/:tableID/data/query` (POST) 에서 실제로 `{ data: [...], total_count: N }` 를 반환합니다 (`internal_data_controller.go:598-604`, `845-848`). 따라서 이전 타입 정의(`datas` / `total_size`)를 기대한 구조분해는 런타임에 `undefined` 를 받고 있었습니다.
+  - `0.16.0` 에서 한 번 바로잡았다가 `0.16.1` 에서 "서버 wire 가 여전히 `datas`" 라는 잘못된 관찰로 롤백됐던 이슈를 다시 수정합니다. 서버 핸들러 (`gin.H{"data": ..., "total_count": ...}`) 를 직접 확인해 타입을 확정했습니다.
+
+### Breaking (types only, runtime unchanged)
+
+- `FetchDataResponse` 의 필드명이 TypeScript 레벨에서 변경됩니다. 런타임 동작(실제 네트워크 응답)은 동일합니다. 기존에 타입 경고를 무시하고 `result.data` / `result.total_count` 로 접근하던 코드는 **수정 없이 바로 동작**합니다. 반대로 타입 정의를 믿고 `result.datas` / `result.total_size` 로 접근하던 코드는 원래부터 런타임에 `undefined` 를 받고 있었으므로, 이번 기회에 `result.data` / `result.total_count` 로 고쳐주세요.
+
+### Migration
+
+```ts
+// Before (타입은 OK 였지만 런타임 undefined)
+const { datas, total_size } = await cb.database.getData(tableId)
+
+// After (v1.4.0+)
+const { data, total_count } = await cb.database.getData(tableId)
+```
+
 ## [1.3.0] - 2026-04-18
 
 파티 초대 수락/거절 SDK 메서드 추가. 기존 `acceptInvite` 는 로비 전용(`/lobbies/invites/...`) 이라 파티 초대에는 사용할 수 없었는데, 1.2.0 까지는 사용자가 직접 `fetch()` 로 백엔드의 `/v1/game/:appID/invites/:inviteID/accept` 를 호출해야 했음. 1.3.0 부터 SDK 에 전용 메서드 제공.

package/README.md

@@ -439,19 +439,19 @@ await cb.auth.signOut()
 
 ```typescript
 // Query data
-const { datas, total_size } = await cb.database.getData('table-id', {
+const { data, total_count } = await cb.database.getData('table-id', {
   where: { status: 'active' },
   limit: 10
 })
 
 // Query with field selection (Projection) - improves response speed
-const { datas } = await cb.database.getData('table-id', {
+const { data } = await cb.database.getData('table-id', {
   select: ['id', 'name', 'thumbnail'],  // Only return these fields
   limit: 20
 })
 
 // Exclude specific fields (e.g., large HTML/CSS content)
-const { datas } = await cb.database.getData('table-id', {
+const { data } = await cb.database.getData('table-id', {
   exclude: ['html_content', 'css_content'],
   limit: 20
 })

package/dist/index.d.mts

@@ -522,11 +522,21 @@ interface CreateDataRequest {
 interface UpdateDataRequest {
     data: Record<string, unknown>;
 }
+/**
+ * 테이블 데이터 조회 응답.
+ *
+ * 서버(data-server `internal_data_controller.go` 의 `FetchDataByTableGET`,
+ * `QueryDataByTable`) 가 반환하는 JSON 과 1:1 매핑합니다.
+ *
+ * 참고: `1.3.0` 이전 버전(`0.16.1` 기준)에서는 `datas` / `total_size` 로
+ * 선언돼 있었으나, 실제 서버 wire 포맷은 `data` / `total_count` 이므로 런타임에
+ * 속성 접근이 `undefined` 를 반환하는 결함이 있었습니다. `1.4.0` 에서 바로잡습니다.
+ */
 interface FetchDataResponse {
-    /** 조회된 문서 배열 (서버는 `datas` 키로 반환합니다) */
-    datas: DataItem[];
-    /** 총 매칭 문서 수 (서버는 `total_size` 키로 반환합니다) */
-    total_size: number;
+    /** 조회된 문서 배열 */
+    data: DataItem[];
+    /** 총 매칭 문서 수 */
+    total_count: number;
 }
 interface QueryOptions {
     limit?: number;

package/dist/index.d.ts

@@ -522,11 +522,21 @@ interface CreateDataRequest {
 interface UpdateDataRequest {
     data: Record<string, unknown>;
 }
+/**
+ * 테이블 데이터 조회 응답.
+ *
+ * 서버(data-server `internal_data_controller.go` 의 `FetchDataByTableGET`,
+ * `QueryDataByTable`) 가 반환하는 JSON 과 1:1 매핑합니다.
+ *
+ * 참고: `1.3.0` 이전 버전(`0.16.1` 기준)에서는 `datas` / `total_size` 로
+ * 선언돼 있었으나, 실제 서버 wire 포맷은 `data` / `total_count` 이므로 런타임에
+ * 속성 접근이 `undefined` 를 반환하는 결함이 있었습니다. `1.4.0` 에서 바로잡습니다.
+ */
 interface FetchDataResponse {
-    /** 조회된 문서 배열 (서버는 `datas` 키로 반환합니다) */
-    datas: DataItem[];
-    /** 총 매칭 문서 수 (서버는 `total_size` 키로 반환합니다) */
-    total_size: number;
+    /** 조회된 문서 배열 */
+    data: DataItem[];
+    /** 총 매칭 문서 수 */
+    total_count: number;
 }
 interface QueryOptions {
     limit?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "connectbase-client",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",