connectbase-client 1.9.1 → 1.10.0
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.
- package/CHANGELOG.md +50 -0
- package/dist/connect-base.umd.js +3 -3
- package/dist/index.d.mts +157 -0
- package/dist/index.d.ts +157 -0
- package/dist/index.js +116 -1
- package/dist/index.mjs +116 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,56 @@
|
|
|
3
3
|
본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
|
|
4
4
|
버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
|
|
5
5
|
|
|
6
|
+
## [1.10.0] - 2026-04-26
|
|
7
|
+
|
|
8
|
+
OAuth 콜백 응답 email 노출 + Analytics 조회 메서드 신규 + Functions 자동화용 Push 발송 메서드 신규.
|
|
9
|
+
sisun 팀(`019d85c7-...`) 의 운영 피드백 3건이 시작점이며, 백엔드 라우트는 콘솔 JWT 와 User Secret Key(`cb_sk_`)
|
|
10
|
+
둘 다 받는 dual-auth 로 확장되었습니다. 모든 변경은 추가 성격이며 기존 호출 시그니처는 유지됩니다.
|
|
11
|
+
|
|
12
|
+
### Added — OAuth 콜백 응답에 `email`
|
|
13
|
+
|
|
14
|
+
- `OAuthCallbackResponse.email?: string` — `signInWithPopup` / `getCallbackResult` /
|
|
15
|
+
`exchangeCodeFromCallback` 모두 첫 응답에 이메일을 포함하도록 확장.
|
|
16
|
+
- 백엔드는 2026-04-19 부터 OAuth 신규 가입/재로그인 시 `AppMember.email` 을 자동 저장해왔으나,
|
|
17
|
+
콜백 응답 DTO 에는 노출되지 않아 SDK 사용자가 추가로 `getMember()` 를 호출해야 했음. 이번
|
|
18
|
+
릴리즈로 한 번의 로그인 응답만으로 이메일을 확보할 수 있다.
|
|
19
|
+
- Apple private relay / 이메일 권한 미동의 시 `email` 은 비어 있을 수 있다 (선택 필드).
|
|
20
|
+
|
|
21
|
+
### Added — Analytics 조회 메서드 (Functions / cb_sk_ 전용)
|
|
22
|
+
|
|
23
|
+
- `cb.analytics.getPopularPages(storageWebId?, options?)` — 인기 페이지.
|
|
24
|
+
- `cb.analytics.getNavigationFlow(storageWebId?, options?)` — 페이지 전환 플로우 (Sankey).
|
|
25
|
+
- `cb.analytics.getVisitors(storageWebId?, options?)` — 방문자 목록.
|
|
26
|
+
- 백엔드 라우트 `/v1/storages/web/:id/{popular-pages,navigation/flow,visitors}` 가 dual-auth 로 변경되어
|
|
27
|
+
콘솔 JWT 외에 User Secret Key(`cb_sk_`) 호출도 허용. 어드민 앱이 Function 에서 호출해 자체
|
|
28
|
+
대시보드를 구성할 수 있다.
|
|
29
|
+
- 브라우저 SDK (Public Key `cb_pk_`) 인스턴스에서는 호출 시 명확한 에러를 던져 권한 누설을 차단.
|
|
30
|
+
|
|
31
|
+
### Added — Push 발송 메서드 `cb.push.sendToMembers`
|
|
32
|
+
|
|
33
|
+
- `cb.push.sendToMembers(appId, memberIds, payload)` — Functions / 서버 자동화 환경에서
|
|
34
|
+
회원 ID 목록으로 푸시 발송. payload 는 title/body/imageUrl/data/platforms/ttlSeconds/priority/
|
|
35
|
+
clickAction/scheduledAt 지원.
|
|
36
|
+
- 백엔드 `/v1/apps/:appID/push/send` 가 cb_sk_ 인증을 받도록 dual-auth 로 변경. 1.9 까지 안내되던
|
|
37
|
+
`CONSOLE_ACCESS_TOKEN` (만료 있는 콘솔 JWT) 우회 패턴이 더 이상 필요 없음.
|
|
38
|
+
- Public Key 인스턴스 호출 시 명확한 에러로 차단.
|
|
39
|
+
|
|
40
|
+
### Changed — 문서
|
|
41
|
+
|
|
42
|
+
- `embedded/sections/15-sdk-push.md` — Functions 발송 예제를 cb_sk_ 권장 패턴으로 갱신, legacy
|
|
43
|
+
`CONSOLE_ACCESS_TOKEN` 마이그레이션 안내 추가.
|
|
44
|
+
- `embedded/sections/33-sdk-analytics.md`, `38-sdk-analytics-advanced.md` — REST 표에
|
|
45
|
+
visitors/popular-pages/navigation/flow 라우트의 dual-auth 를 명시.
|
|
46
|
+
|
|
47
|
+
### Migration
|
|
48
|
+
|
|
49
|
+
기존 호출은 그대로 동작합니다.
|
|
50
|
+
|
|
51
|
+
- OAuth: `signInWithPopup()` 결과의 `email` 이 신규 추가 — 사용 안 해도 무방.
|
|
52
|
+
- Analytics 조회: 1.9 까지 SDK 에 조회 메서드가 없었으므로 신규 도입.
|
|
53
|
+
- Push 발송: Functions 코드의 `fetch + Authorization: Bearer ${CONSOLE_ACCESS_TOKEN}` 패턴은
|
|
54
|
+
유지 가능하지만, secret 을 `cb_sk_` 로 교체 후 SDK 메서드로 옮기는 것을 권장 (만료 없음).
|
|
55
|
+
|
|
6
56
|
## [1.9.1] - 2026-04-25
|
|
7
57
|
|
|
8
58
|
문서 정합성 패치. 런타임 동작은 1.9.0 과 동일합니다.
|