Skip to content

v0.4.0 — list envelope 통일 호환 강화

Choose a tag to compare

View all tags
@southglory southglory released this 11 May 02:10
· 1 commit to master since this release
v0.4.0
9f6f499

photobook-api commit 6fbf346 (2026-05-11) 의 list 응답 envelope 평탄화에 대응. v0.2.1 부터 ResponseParser.toListResult 가 신·구 envelope 양쪽 분기를 지원하던 토대 위에 다음을 보강.

Changed

  • ResponseParser.getList — 인식 키 19개로 확장: orders / items / books / templates / photos / keys / accounts / memos / configs / deliveries / notifications / categories / transactions / targetTypes / daily / referrers / events / logs / bookSpecs. 마지막 fallback 으로 data 객체의 첫 배열 자동 채택
  • ResponseParser.getPagination — 구 photos 응답의 data.totalCount 를 pagination.total 로 자동 흡수
  • ResponseParser.toListResult — 빈 pagination 일 때 응답에 포함하지 않음 (template-categories 등 pagination 없는 list 응답이 깔끔)
  • client.bookSpecs.list / client.credits.transactions — toListResult 사용으로 통일

변경된 envelope

Before:
```json
{ "success": true, "data": { "books": [...], "pagination": {...} } }
```

After (commit 6fbf346 이후):
```json
{
"success": true,
"data": [...],
"pagination": { "total": 120, "limit": 20, "offset": 0, "hasNext": true }
}
```

두 envelope 모두에서 result.books (또는 toListResult key) 가 항상 배열, result.pagination 이 항상 최상위.

Tests

  • tests/response_envelope.test.js 8건 추가
  • npm test 24/24 통과 (helpers 16 + envelope 8)

Migration

v0.3.x → v0.4.0: 추가 호환 only. 기존 list 메서드 시그니처/리턴 shape 그대로. 의존하는 4 demo (diaryBook-demo, kidsDailyBook-demo, socialBook-demo, partner-order-demo) 도 v0.4.0 으로 갱신 완료.

이슈: #3

Assets 2
Loading