connectbase-client 3.48.2 → 3.50.0

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.50.0] - 2026-07-18
+
+### Added — 파일 업로드 진행률 콜백 (`cb.storage.uploadFile` onProgress)
+
+영상 업로드(`cb.video.upload`)만 제공하던 진행률 콜백을 파일 스토리지 업로드에도 추가했다. 파일 업로드 UI에서 실시간 퍼센트(%) 진행 바를 그릴 수 있다. (platform-issue 019f70e3)
+
+- `cb.storage.uploadFile(storageId, file, options)` — 3번째 인자가 부모 폴더 ID(문자열) 또는 옵션 객체를 받는다. **기존 `uploadFile(id, file, 'folder-id')` 시그니처와 하위 호환**.
+- 옵션: `onProgress?: (p: { loaded, total, percentage }) => void`, `parentId?`, `signal?`(AbortSignal, 취소), `timeout?`(PUT 타임아웃 ms).
+- `onProgress` 는 브라우저(XMLHttpRequest) 환경에서 presigned PUT 의 `upload.onprogress` 로 바이트 단위 진행률을 실시간 보고한다. Node/Edge 등 XHR 이 없는 환경에서는 시작 0% / 완료 100% 만 통지(계약 유지).
+- `cb.storage.uploadByPath(storageId, path, file, options)` 및 `cb.storage.uploadFiles()` 도 동일한 `onProgress`/`signal`/`timeout` 을 지원한다(uploadFiles 는 파일별 0→100%).
+- `percentage` 필드명은 `cb.video.upload` 의 `UploadProgress` 와 통일. 신규 타입 export: `StorageUploadProgress`, `UploadFileOptions`. `UploadByPathOptions` 에 `onProgress`/`signal`/`timeout` 추가.
+
 ## [3.47.0] - 2026-07-16
 
 ### Added — ctx.cbAdmin 관리 REST (service_role + management_scopes)

package/README.md

@@ -792,6 +792,13 @@ console.log(result.url)
 // 특정 폴더에 업로드
 const result = await cb.storage.uploadFile('storage-id', file, 'folder-id')
 
+// 업로드 진행률(%) 표시 (옵션 객체 — 문자열 parentId 와 하위 호환)
+const result = await cb.storage.uploadFile('storage-id', file, {
+    parentId: 'folder-id',                                 // 선택
+    onProgress: (p) => console.log(`${p.percentage}%`),    // { loaded, total, percentage }
+})
+// 진행률은 브라우저(XMLHttpRequest) 환경에서만 실시간 보고, 그 외에는 0%→100% 만 통지
+
 // 경로 기반 업로드 (고정 URL - Firebase Storage 스타일)
 // 같은 경로에 다시 업로드하면 URL이 유지된 채로 파일만 교체
 const result = await cb.storage.uploadByPath(