@01.software/sdk 0.68.0 → 0.69.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @01.software/sdk
 
+## 0.69.0
+
+### Minor Changes
+
+- 88a5db7: 상품의 고객별 누적 구매 한도 타입과 `purchase_limit_exceeded` 오류 reason을 추가합니다.
+
+  운영 주의: 애플리케이션을 rollback하면 이 상한 집행이 사라집니다. **rollback 전 한도 상품 판매 중지**가 필요합니다. 스키마 마이그레이션은 forward-only이며, 컬럼·미검증 CHECK 추가 → CHECK 검증 → 트랜잭션 밖 동시 인덱스 생성 순서로 적용합니다.
+
+- 349785e: Add the `product_not_eligible` commerce reason for products restricted to eligible Customer Groups. Restricted purchases require a Customer-bound Cart and verified Customer session or server delegation; unrestricted products retain existing behavior.
+- 7488329: Add the stable `admission_required` error reason for public event registration.
+  RSVP/approval registration now rejects applicable non-deleted admission types,
+  including inactive, out-of-sale and zero-price types. Use the admission purchase
+  flow for these events; the SDK preserves the 409 reason without retrying.
+
 ## 0.68.0
 
 ### Minor Changes

package/README.md

@@ -2659,3 +2659,5 @@ Reuse the same sourceNamespace/sourceRef and identical issue input on an unknown
 `client.benefitVouchers.listMine({ status: 'available', limit: 20 })` uses the Customer JWT and returns only identity, customer-visible copy, state and timestamps. Use `status: 'all'` for history and the returned `nextCursor` for another page (maximum 100). The response is private, no-store. Server lists return the server DTO and require customerId; cross-customer/tenant targets are masked as 404. Console customer detail shows a read-only list; Console action buttons follow separately.
 
 The staff app server must verify the staff member and Customer before redeeming: voucherId is not a bearer capability. `actorRef` is app-attested evidence, never a platform-verified staff identity or an authorization input. Use opaque references without personal data in sourceRef and actorRef. Definitions snapshot name, description and expiry at issue; later edits do not change issued vouchers. Voucher history survives Customer erasure and blocks tenant hard deletion. Referenced definitions must be archived.
+
+Product purchase quantity policies are enforced by Console at Cart ingress and Checkout creation. A product's optional `maxQuantityPerCustomer` combines all variants, committed Orders minus completed Returns, and open Checkouts. Limited products require a verified Customer; delegated server purchases use the existing `customerToken`. Handle `409 purchase_limit_exceeded` by its scalar `details.productId`, `maxQuantityPerCustomer` and `remainingQuantity`; guests receive `product_not_eligible`. See the [Commerce guide](https://docs.01.software/en/commerce).

package/dist/client.cjs

@@ -154,6 +154,7 @@ var COMMERCE_ERROR_CODES = [
   "admission_metadata_invalid",
   "admission_metadata_required",
   "capacity_exceeded",
+  "admission_required",
   "occurrence_lock_unavailable",
   "occurrence_not_open",
   "admission_type_capacity_exceeded",
@@ -172,6 +173,8 @@ var COMMERCE_ERROR_CODES = [
   "variant_inactive",
   "variant_product_mismatch",
   "product_not_public",
+  "product_not_eligible",
+  "purchase_limit_exceeded",
   "market_not_found",
   "market_shipping_currency_unsupported",
   "missing_market_rate",