@sayren/store-sdk 0.65.0 → 0.67.0

package/dist/index.mjs

@@ -3849,6 +3849,10 @@ const claimSchema = z$1.object({
 	holdExpiresAt: z$1.string().nullable(),
 	/** 보류를 이미 썼는지 — 보류는 클레임당 1회라 해제·만료 뒤에도 true */
 	holdUsed: z$1.boolean(),
+	rejection: z$1.object({
+		reason: z$1.string().describe("거절 사유 코드 — `USED_PRODUCT`·`MISSING_COMPONENT`·`PERIOD_EXPIRED`·`BUYER_FAULT_DAMAGE`·`ETC`. 값이 추가될 수 있어 문자열로 받는다"),
+		detail: z$1.string().describe("거절 상세 사유. 구매자에게 그대로 보인다")
+	}).nullable().optional().default(null).describe("판매자가 거절한 사유. 거절(`REJECTED`) 클레임만 값이 있고 그 밖에는 null이다. 서버는 항상 싣는다"),
 	returnAddress: claimReturnAddressSchema.nullable().describe("수거 안내에 쓸 반품지(이슈 #30). 상품이 지정한 반품지, 없으면 상점 기본 반품지다. 취소 클레임과 반품지를 등록하지 않은 상점은 null")
 });
 /** `GET /v1/claims` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
@@ -10323,6 +10327,7 @@ const customerDetailSchema = z$1.object({
 	joinedAt: z$1.string(),
 	point: z$1.number().int(),
 	marketingAgreed: z$1.boolean(),
+	lockedUntil: z$1.string().nullable().optional().default(null).describe("로그인 잠금이 풀리는 시각(ISO 8601). 비밀번호를 5회 연속 틀리면 10분 잠긴다. 잠겨 있지 않으면 null. `POST /v1/customers/{customerId}/unlock`으로 바로 풀 수 있다. 서버는 항상 싣는다"),
 	loginMethods: z$1.array(z$1.object({
 		method: z$1.enum([
 			"password",
@@ -11065,7 +11070,7 @@ const paymentRecordSchema = z$1.object({
 	status: paymentRecordStatusSchema,
 	amount: z$1.number().int().describe("결제 금액"),
 	refundedAmount: z$1.number().int().describe("환불 완료 금액 합계. 실패한 환불은 빼고 센다"),
-	heldRefundAmount: z$1.number().int().optional().default(0).describe("환불 대기 금액 합계(#115) — 주문만 취소하고 아직 환불하지 않은 몫. 결제 상세에서 환불 처리한다"),
+	heldRefundAmount: z$1.number().int().optional().default(0).describe("환불 대기 금액 합계(#115) — 주문만 취소하고 아직 환불하지 않은 몫(`HELD`)과 다시 요청할 수 있는 실패 환불(`FAILED`, 결제 잔액 안의 것). 결제 상세에서 환불 처리한다"),
 	provider: pgProviderResponseSchema.nullable().describe("승인한 PG. 승인 전에 끝났으면 마지막 시도의 PG"),
 	method: pgPaymentMethodSchema.nullable().describe("실제 결제수단. 모르면 요청 수단"),
 	easyPayProvider: easyPayProviderResponseSchema.nullable().optional().default(null).describe("간편결제사. `method`가 `EASY_PAY`일 때만 값이 있고, PG가 알려 주지 않았으면 요청한 간편결제사다. 그 밖의 결제수단과 간편결제 이전 결제는 null. 서버는 항상 싣는다. 현재 값은 `NAVERPAY`·`KAKAOPAY`·`TOSSPAY`·`PAYCO`이고 값이 추가될 수 있어 문자열로 받는다"),
@@ -11129,7 +11134,7 @@ const paymentListQuerySchema = z$1.object({
 	method: z$1.string().optional().describe("실제 결제수단 필터"),
 	keyword: z$1.string().optional().describe("결제 id·주문 id·PG 거래 id·시도 id·PG 주문번호(일치), 구매자명(포함)"),
 	includeTest: z$1.string().optional().describe("테스트 결제 포함 여부 (`true`·`false`. 기본 false — 실결제만)"),
-	refundHeld: z$1.string().optional().describe("`true`면 환불 대기가 있는 결제만(#115)"),
+	refundHeld: z$1.string().optional().describe("`true`면 환불 대기(`heldRefundAmount` > 0)가 있는 결제만(#115). 다시 요청할 수 있는 실패 환불도 포함한다"),
 	page: z$1.string().optional().describe("페이지 번호 (1부터)"),
 	size: z$1.string().optional().describe("페이지 크기 (기본 20, 최대 100)")
 });
@@ -12647,6 +12652,8 @@ listHistory: (params) => storeHttp.request("GET", "/points/history", pageSchema(
 			consents: (customerId, params) => storeHttp.request("GET", path`/customers/${customerId}/consents`, pageSchema(customerConsentSchema), { query: params }),
 			/** 보유 쿠폰 (이슈 #47) — 최근 지급 순, 최대 500장 */
 			coupons: (customerId) => storeHttp.request("GET", path`/customers/${customerId}/coupons`, z$1.array(customerCouponSchema)),
+			/** 로그인 잠금 해제 — 비밀번호 연속 실패 잠금과 실패 횟수를 지운다(멱등). 상점 플랫폼 OWNER·ADMIN */
+			unlock: (customerId) => storeHttp.request("POST", path`/customers/${customerId}/unlock`, customerDetailSchema),
 			withdraw: (customerId, body) => storeHttp.requestVoid("POST", path`/customers/${customerId}/withdraw`, { body: withdrawCustomerRequestSchema.parse(body) })
 		},
 		/** 쿠폰 (이슈 #47) — 조회 `promotion:r`, 쓰기 `promotion:rw` */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/store-sdk",
-  "version": "0.65.0",
+  "version": "0.67.0",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "exports": {

package/src/client.ts

@@ -1603,6 +1603,9 @@ export function createStoreClient(options: StoreClientOptions) {
           path`/customers/${customerId}/coupons`,
           z.array(customerCouponSchema),
         ),
+      /** 로그인 잠금 해제 — 비밀번호 연속 실패 잠금과 실패 횟수를 지운다(멱등). 상점 플랫폼 OWNER·ADMIN */
+      unlock: (customerId: string) =>
+        storeHttp.request("POST", path`/customers/${customerId}/unlock`, customerDetailSchema),
       withdraw: (customerId: string, body: WithdrawCustomerRequest) =>
         storeHttp.requestVoid("POST", path`/customers/${customerId}/withdraw`, {
           body: withdrawCustomerRequestSchema.parse(body),

package/src/schemas/claim.ts

@@ -113,6 +113,21 @@ export const claimSchema = z.object({
   holdExpiresAt: z.string().nullable(),
   /** 보류를 이미 썼는지 — 보류는 클레임당 1회라 해제·만료 뒤에도 true */
   holdUsed: z.boolean(),
+  rejection: z
+    .object({
+      reason: z
+        .string()
+        .describe(
+          "거절 사유 코드 — `USED_PRODUCT`·`MISSING_COMPONENT`·`PERIOD_EXPIRED`·`BUYER_FAULT_DAMAGE`·`ETC`. 값이 추가될 수 있어 문자열로 받는다",
+        ),
+      detail: z.string().describe("거절 상세 사유. 구매자에게 그대로 보인다"),
+    })
+    .nullable()
+    .optional()
+    .default(null)
+    .describe(
+      "판매자가 거절한 사유. 거절(`REJECTED`) 클레임만 값이 있고 그 밖에는 null이다. 서버는 항상 싣는다",
+    ),
   returnAddress: claimReturnAddressSchema
     .nullable()
     .describe(

package/src/schemas/customer.ts

@@ -236,6 +236,15 @@ export const customerDetailSchema = z.object({
   joinedAt: z.string(),
   point: z.number().int(),
   marketingAgreed: z.boolean(),
+  lockedUntil: z
+    .string()
+    .nullable()
+    .optional()
+    .default(null)
+    .describe(
+      "로그인 잠금이 풀리는 시각(ISO 8601). 비밀번호를 5회 연속 틀리면 10분 잠긴다. 잠겨 있지 않으면 null. " +
+        "`POST /v1/customers/{customerId}/unlock`으로 바로 풀 수 있다. 서버는 항상 싣는다",
+    ),
   loginMethods: z
     .array(
       z.object({

package/src/schemas/payment.ts

@@ -813,7 +813,7 @@ export const paymentRecordSchema = z.object({
     .optional()
     .default(0)
     .describe(
-      "환불 대기 금액 합계(#115) — 주문만 취소하고 아직 환불하지 않은 몫. 결제 상세에서 환불 처리한다",
+      "환불 대기 금액 합계(#115) — 주문만 취소하고 아직 환불하지 않은 몫(`HELD`)과 다시 요청할 수 있는 실패 환불(`FAILED`, 결제 잔액 안의 것). 결제 상세에서 환불 처리한다",
     ),
   provider: pgProviderResponseSchema
     .nullable()
@@ -974,7 +974,12 @@ export const paymentListQuerySchema = z.object({
     .string()
     .optional()
     .describe("테스트 결제 포함 여부 (`true`·`false`. 기본 false — 실결제만)"),
-  refundHeld: z.string().optional().describe("`true`면 환불 대기가 있는 결제만(#115)"),
+  refundHeld: z
+    .string()
+    .optional()
+    .describe(
+      "`true`면 환불 대기(`heldRefundAmount` > 0)가 있는 결제만(#115). 다시 요청할 수 있는 실패 환불도 포함한다",
+    ),
   page: z.string().optional().describe("페이지 번호 (1부터)"),
   size: z.string().optional().describe("페이지 크기 (기본 20, 최대 100)"),
 });