connectbase-client 0.15.1 → 0.16.1

package/dist/index.d.mts

@@ -509,8 +509,10 @@ interface UpdateDataRequest {
     data: Record<string, unknown>;
 }
 interface FetchDataResponse {
-    data: DataItem[];
-    total_count: number;
+    /** 조회된 문서 배열 (서버는 `datas` 키로 반환합니다) */
+    datas: DataItem[];
+    /** 총 매칭 문서 수 (서버는 `total_size` 키로 반환합니다) */
+    total_size: number;
 }
 interface QueryOptions {
     limit?: number;
@@ -1676,8 +1678,20 @@ declare class StorageAPI {
     private getPublicPrefix;
     /**
      * 파일 목록 조회
+     *
+     * @param storageId - 파일 스토리지 ID
+     * @param parentId - 부모 폴더 ID (미지정 시 루트 폴더)
+     *
+     * @example
+     * ```ts
+     * // 루트 폴더의 파일 목록
+     * const files = await cb.storage.getFiles('storage-id')
+     *
+     * // 특정 폴더의 하위 파일 목록
+     * const subFiles = await cb.storage.getFiles('storage-id', 'folder-id')
+     * ```
      */
-    getFiles(storageId: string): Promise<FileItem[]>;
+    getFiles(storageId: string, parentId?: string): Promise<FileItem[]>;
     /**
      * 파일 업로드 (Presigned URL 방식)
      *
@@ -3776,8 +3790,8 @@ interface WebPushSubscription {
  *     device_name: 'Galaxy S24',
  * })
  *
- * // 토픽 구독
- * await cb.push.subscribeTopic('announcements')
+ * // 토픽 구독 (device_token 필수)
+ * await cb.push.subscribeTopic(device.device_token, 'announcements')
  *
  * // Web Push 등록 (브라우저)
  * const vapidKey = await cb.push.getVAPIDPublicKey()

package/dist/index.d.ts

@@ -509,8 +509,10 @@ interface UpdateDataRequest {
     data: Record<string, unknown>;
 }
 interface FetchDataResponse {
-    data: DataItem[];
-    total_count: number;
+    /** 조회된 문서 배열 (서버는 `datas` 키로 반환합니다) */
+    datas: DataItem[];
+    /** 총 매칭 문서 수 (서버는 `total_size` 키로 반환합니다) */
+    total_size: number;
 }
 interface QueryOptions {
     limit?: number;
@@ -1676,8 +1678,20 @@ declare class StorageAPI {
     private getPublicPrefix;
     /**
      * 파일 목록 조회
+     *
+     * @param storageId - 파일 스토리지 ID
+     * @param parentId - 부모 폴더 ID (미지정 시 루트 폴더)
+     *
+     * @example
+     * ```ts
+     * // 루트 폴더의 파일 목록
+     * const files = await cb.storage.getFiles('storage-id')
+     *
+     * // 특정 폴더의 하위 파일 목록
+     * const subFiles = await cb.storage.getFiles('storage-id', 'folder-id')
+     * ```
      */
-    getFiles(storageId: string): Promise<FileItem[]>;
+    getFiles(storageId: string, parentId?: string): Promise<FileItem[]>;
     /**
      * 파일 업로드 (Presigned URL 방식)
      *
@@ -3776,8 +3790,8 @@ interface WebPushSubscription {
  *     device_name: 'Galaxy S24',
  * })
  *
- * // 토픽 구독
- * await cb.push.subscribeTopic('announcements')
+ * // 토픽 구독 (device_token 필수)
+ * await cb.push.subscribeTopic(device.device_token, 'announcements')
  *
  * // Web Push 등록 (브라우저)
  * const vapidKey = await cb.push.getVAPIDPublicKey()

package/dist/index.js

@@ -1756,11 +1756,24 @@ var StorageAPI = class {
   }
   /**
    * 파일 목록 조회
+   *
+   * @param storageId - 파일 스토리지 ID
+   * @param parentId - 부모 폴더 ID (미지정 시 루트 폴더)
+   *
+   * @example
+   * ```ts
+   * // 루트 폴더의 파일 목록
+   * const files = await cb.storage.getFiles('storage-id')
+   *
+   * // 특정 폴더의 하위 파일 목록
+   * const subFiles = await cb.storage.getFiles('storage-id', 'folder-id')
+   * ```
    */
-  async getFiles(storageId) {
+  async getFiles(storageId, parentId) {
     const prefix = this.getPublicPrefix();
+    const params = parentId ? `?parent_id=${encodeURIComponent(parentId)}` : "";
     const response = await this.http.get(
-      `${prefix}/storages/files/${storageId}/items`
+      `${prefix}/storages/files/${storageId}/items${params}`
     );
     return response.files;
   }

package/dist/index.mjs

@@ -1718,11 +1718,24 @@ var StorageAPI = class {
   }
   /**
    * 파일 목록 조회
+   *
+   * @param storageId - 파일 스토리지 ID
+   * @param parentId - 부모 폴더 ID (미지정 시 루트 폴더)
+   *
+   * @example
+   * ```ts
+   * // 루트 폴더의 파일 목록
+   * const files = await cb.storage.getFiles('storage-id')
+   *
+   * // 특정 폴더의 하위 파일 목록
+   * const subFiles = await cb.storage.getFiles('storage-id', 'folder-id')
+   * ```
    */
-  async getFiles(storageId) {
+  async getFiles(storageId, parentId) {
     const prefix = this.getPublicPrefix();
+    const params = parentId ? `?parent_id=${encodeURIComponent(parentId)}` : "";
     const response = await this.http.get(
-      `${prefix}/storages/files/${storageId}/items`
+      `${prefix}/storages/files/${storageId}/items${params}`
     );
     return response.files;
   }

package/package.json

@@ -1,15 +1,20 @@
 {
   "name": "connectbase-client",
-  "version": "0.15.1",
+  "version": "0.16.1",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",
     "url": "https://github.com/connectbase-world/connectbase.git",
     "directory": "frontend/package/public/connect-base-client"
   },
+  "homepage": "https://github.com/connectbase-world/connectbase/tree/release/frontend/package/public/connect-base-client#readme",
+  "bugs": {
+    "url": "https://github.com/connectbase-world/connectbase/issues"
+  },
   "publishConfig": {
     "access": "public"
   },
+  "sideEffects": false,
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
@@ -27,7 +32,10 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "LICENSE",
+    "CHANGELOG.md",
+    "README.md"
   ],
   "scripts": {
     "build": "tsup",
@@ -51,7 +59,7 @@
     "realtime",
     "tunnel"
   ],
-  "author": "",
+  "author": "Connect Base",
   "license": "MIT",
   "devDependencies": {
     "@types/node": "^22.15.18",