@sayren/store-sdk 0.8.0 → 0.10.0

package/dist/index.mjs

@@ -693,6 +693,7 @@ const changeTypeSchema = z.enum([
 	"CLAIM.CANCEL_REQUESTED",
 	"CLAIM.RETURN_REQUESTED",
 	"CLAIM.EXCHANGE_REQUESTED",
+	"CLAIM.COMPLETED",
 	"ORDER.ADDRESS_CHANGE_REQUESTED"
 ]);
 //#endregion
@@ -732,8 +733,9 @@ const claimSchema = z.object({
 	reason: claimReasonSchema,
 	reasonDetail: z.string().nullable(),
 	responsibility: z.enum(["BUYER", "SELLER"]),
-	claimDeliveryFee: z.number().int(),
-	expectedRefundAmount: z.number().int().nullable(),
+	claimDeliveryFee: z.number().int().describe("구매자가 부담하는 반품·교환 배송비. 원 단위"),
+	expectedRefundAmount: z.number().int().nullable().describe("접수 시점에 계산한 예상 환불액 — 수량 비율 상품 금액 − 반품 배송비 − 조건부 무료배송 미달 차감. **배송비 환불은 포함되지 않고 `expectedDeliveryFeeRefundAmount`로 따로 온다**(승인 시점의 배송 묶음 상태로 확정되기 때문이다). 교환은 환불이 없어 null이다"),
+	expectedDeliveryFeeRefundAmount: z.number().int().nullable().describe("접수 시점에 계산한 예상 배송비 환불액. 배송 묶음(같은 상품의 주문상품)이 모두 취소되거나 판매자 귀책일 때만 0보다 크다. 이 필드가 생기기 전에 접수된 클레임은 null이다"),
 	exchangeOption: z.object({
 		optionId: z.string(),
 		optionName: z.string()
@@ -787,8 +789,11 @@ const rejectClaimRequestSchema = z.object({
 });
 const approveClaimResultSchema = z.object({
 	claimId: z.string(),
-	refundAmount: z.number().int(),
-	deductAmount: z.number().int(),
+	refundAmount: z.number().int().describe("실제 환불한 금액 — 수량 비율 상품 금액 + 배송비 환불 − 반품 배송비 − 조건부 무료배송 미달 차감 − 추가 차감(`deductAmount`)"),
+	deductAmount: z.number().int().describe("승인 때 셀러가 추가로 차감한 금액"),
+	quantity: z.number().int().describe("환불한 수량"),
+	deliveryFeeRefundAmount: z.number().int().describe("환불에 포함된 배송비. 배송 묶음 전량 취소나 판매자 귀책일 때만 0보다 크다"),
+	deliveryFeeChargeAmount: z.number().int().describe("환불액에서 뺀 **배송비** — 반품·교환 배송비 + 조건부 무료배송 미달 차감. 추가 차감(`deductAmount`)은 포함하지 않는다"),
 	refundedAt: z.string()
 });
 //#endregion
@@ -837,6 +842,64 @@ const customerAddressSchema = z.object({
 	address1: z.string(),
 	address2: z.string().nullable()
 });
+/** 동의 종류 — 이용약관·개인정보 수집이용은 가입 필수, 마케팅 수신은 선택 */
+const consentKindSchema = z.enum([
+	"TERMS",
+	"PRIVACY",
+	"MARKETING"
+]);
+const consentActionSchema = z.enum(["AGREED", "WITHDRAWN"]);
+/**
+* 동의가 일어난 경로. 값이 추가될 수 있어 모르는 값은 그대로 보여 준다.
+* `SIGNUP` 비밀번호 가입 · `SOCIAL_SIGNUP` 소셜 가입 · `DELEGATED` 셀러 자체 회원 연동 ·
+* `RECONSENT` 약관 개정 재동의 · `MEMBER_UPDATE` 구매자가 직접 변경 · `SELLER` 셀러가 처리
+*/
+const consentSourceSchema = z.enum([
+	"SIGNUP",
+	"SOCIAL_SIGNUP",
+	"DELEGATED",
+	"RECONSENT",
+	"MEMBER_UPDATE",
+	"SELLER"
+]);
+/** 동의 이력 한 줄 — 추가만 되고 지워지지 않는다(구매자 탈퇴 시에만 함께 지워진다) */
+const customerConsentSchema = z.object({
+	consentId: z.string(),
+	kind: consentKindSchema,
+	/** 동의한 약관 버전. 마케팅은 버전이 없어 null */
+	version: z.string().nullable(),
+	/** 동의 시점의 약관 문서 주소. 스토어가 주소를 정하지 않았거나 마케팅이면 null */
+	documentUrl: z.string().nullable(),
+	action: consentActionSchema,
+	source: consentSourceSchema,
+	occurredAt: z.string()
+});
+/** 종류별 현재 동의 상태 */
+const customerConsentStateSchema = z.object({
+	kind: consentKindSchema,
+	agreed: z.boolean(),
+	/** 동의한 약관 버전. 마케팅이거나 이력이 없으면 null */
+	agreedVersion: z.string().nullable(),
+	/** 스토어의 현재 약관 버전. 마케팅은 null */
+	currentVersion: z.string().nullable(),
+	/** 스토어가 정한 현재 약관 문서 주소. 정하지 않았거나 마케팅이면 null */
+	currentDocumentUrl: z.string().nullable(),
+	updatedAt: z.string().nullable(),
+	/** 약관이 개정돼 다시 받아야 하는가. 마케팅은 항상 false */
+	reconsentRequired: z.boolean()
+});
+const customerConsentsSchema = z.object({
+	terms: customerConsentStateSchema,
+	privacy: customerConsentStateSchema,
+	marketing: customerConsentStateSchema,
+	/** 필수 동의 중 하나라도 현재 버전이 아니면 true */
+	reconsentRequired: z.boolean()
+});
+/** `GET /v1/customers/{id}/consents` 쿼리 — 최근 순이다 */
+const customerConsentListQuerySchema = z.object({
+	kind: consentKindSchema.optional().describe("동의 종류 필터. 생략하면 전체"),
+	...pageQueryShape()
+});
 /** 구매자 상세 — 휴대폰 전체를 보여 준다 */
 const customerDetailSchema = z.object({
 	customerId: z.string(),
@@ -856,6 +919,7 @@ const customerDetailSchema = z.object({
 		/** 소셜 연결 시각. 비밀번호는 가입 시각 */
 		linkedAt: z.string()
 	})).describe("로그인 방법 — 이메일·비밀번호(`password`)와 연결된 소셜 계정"),
+	consents: customerConsentsSchema.describe("약관·개인정보·마케팅 동의의 현재 상태. 이력은 `GET /v1/customers/{customerId}/consents`"),
 	addresses: z.array(customerAddressSchema),
 	stats: customerStatsSchema.extend({
 		canceledOrReturnedCount: z.number().int().describe("취소된 주문 상품 + 완료된 반품 수"),
@@ -1525,10 +1589,12 @@ const orderItemSchema = z.object({
 	optionId: z.string().nullable(),
 	optionName: z.string().nullable(),
 	sellerCode: z.string().nullable(),
-	quantity: z.number().int(),
+	quantity: z.number().int().describe("주문 수량"),
+	canceledQuantity: z.number().int().describe("취소·반품으로 환불된 누적 수량. 수량 단위 부분 취소가 없었으면 0이다"),
+	activeQuantity: z.number().int().describe("살아 있는 수량 (`quantity` − `canceledQuantity`). 0이면 주문상품이 전량 취소됐다"),
 	unitPrice: z.number().int(),
 	discountAmount: z.number().int(),
-	totalPrice: z.number().int(),
+	totalPrice: z.number().int().describe("주문상품 금액 (할인 반영 단가 × 주문 수량)"),
 	hold: z.object({
 		reason: z.string(),
 		expectedDispatchDate: z.string()
@@ -1662,12 +1728,17 @@ const cancelBySellerRequestSchema = z.object({
 		"DELIVERY_IMPOSSIBLE",
 		"ETC"
 	]),
-	detail: z.string().max(500).optional()
+	detail: z.string().max(500).optional(),
+	quantity: z.number().int().min(1).optional().describe("취소할 수량. 생략하면 남은 수량 전체다. 남은 수량보다 크면 400 `INVALID_QUANTITY`. 일부만 취소하면 주문상품은 상태를 유지한 채 `canceledQuantity`가 늘고, 전 수량이 소진되면 `CANCELED`가 된다")
 });
 /** `POST /v1/order-items/{orderItemId}/cancel` 응답 — 셀러 직권취소 환불 결과 */
 const cancelBySellerResultSchema = z.object({
 	orderItemId: z.string(),
-	refundAmount: z.number().int(),
+	refundAmount: z.number().int().describe("실제 환불한 금액 — 수량 비율 상품 금액 + 배송비 환불 − 조건부 무료배송 미달 차감"),
+	quantity: z.number().int().describe("취소한 수량"),
+	canceledQuantity: z.number().int().describe("취소 후 누적 취소 수량"),
+	deliveryFeeRefundAmount: z.number().int().describe("환불에 포함된 배송비. 배송 묶음(같은 상품)이 모두 취소됐고 환불 정책이 켜져 있을 때만 0보다 크다"),
+	deliveryFeeChargeAmount: z.number().int().describe("조건부 무료배송 기준 미달로 환불액에서 뺀 배송비. 정책이 꺼져 있으면 항상 0이다"),
 	refundedAt: z.string()
 });
 /** `PUT /v1/order-items/{orderItemId}/memo` 응답 — 빈 문자열로 저장하면 메모가 지워져 `null`이다 */
@@ -1692,6 +1763,202 @@ const purchaseDecisionExtendResultSchema = z.object({
 */
 const addressChangeRequestListSchema = z.array(z.record(z.string(), z.unknown())).describe("배송지 변경 요청 목록 (현재 항상 빈 배열)");
 //#endregion
+//#region src/schemas/refund-policy.ts
+/**
+* 환불 정책 (이슈 #25) — 취소·반품·교환에서 **배송비를 누가 부담하는지**를 정한다.
+*
+* 두 층이다. 스토어 설정(`PATCH /v1/store`의 `refundPolicy`)이 기본값이고, 상품별 정책
+* (`POST/PUT /v1/products`의 `refundPolicy`)이 그 상품에만 덮어쓴다. 상품이 정하지 않은 항목은
+* 스토어 기본을 따르고, 스토어도 정하지 않았으면 `REFUND_POLICY_DEFAULTS`다.
+*
+* 한 주문에 정책이 섞이면 **상품별로 계산한다**. 배송비 묶음도 상품 단위다(주문서·장바구니의
+* 배송비 합산과 같은 규칙: 같은 상품의 주문상품이 한 묶음이고 묶음마다 배송비가 붙는다).
+*/
+const descriptions = {
+	preShipmentDeliveryFeeRefund: "발송 전 취소로 배송 묶음(같은 상품의 주문상품)이 모두 취소되면 그 묶음의 배송비를 환불한다. false면 배송비를 환불하지 않는다. 기본 true",
+	returnDeliveryFee: "단순 변심(구매자 귀책) 반품의 반품 배송비. 원 단위. 환불액에서 뺀다. 기본 0(무료). 상품별 정책에서 이 값을 주면 상품의 `returnFee`도 같은 값으로 맞춘다",
+	exchangeDeliveryFee: "단순 변심(구매자 귀책) 교환의 교환 배송비. 원 단위. 구매자에게 청구할 금액을 안내값으로 싣는다. 기본 0(무료). 상품별 정책에서 이 값을 주면 상품의 `exchangeFee`도 같은 값으로 맞춘다",
+	sellerFaultFreeShipping: "판매자 귀책(셀러 직권취소, 불량·오배송 반품)이면 배송비를 셀러가 부담한다 — 배송비를 환불하고 반품비를 받지 않는다. false면 구매자 귀책과 같은 규칙을 쓴다. 기본 true",
+	conditionalFreeShortfallCharge: "조건부 무료배송(`CONDITIONAL_FREE`) 상품에서 일부 취소로 남은 금액이 무료 기준액에 미달하면 그 배송비를 환불액에서 뺀다. false면 추가 청구 없이 셀러가 부담한다. 기본 false"
+};
+/** 유효 환불 정책 — 스토어 기본 + 상품별 덮어쓰기를 합친 결과 */
+const refundPolicySchema = z.object({
+	preShipmentDeliveryFeeRefund: z.boolean().describe(descriptions.preShipmentDeliveryFeeRefund),
+	returnDeliveryFee: z.number().int().min(0).describe(descriptions.returnDeliveryFee),
+	exchangeDeliveryFee: z.number().int().min(0).describe(descriptions.exchangeDeliveryFee),
+	sellerFaultFreeShipping: z.boolean().describe(descriptions.sellerFaultFreeShipping),
+	conditionalFreeShortfallCharge: z.boolean().describe(descriptions.conditionalFreeShortfallCharge)
+});
+/**
+* 스토어가 정하지 않았을 때 서버가 쓰는 값.
+*
+* `as const`가 아니라 `RefundPolicy`로 타입을 좁힌다 — 리터럴 타입이면 `Partial<typeof …>`로 일부만 바꿀 때
+* `true` 자리에 `false`를 넣을 수 없다.
+*/
+const REFUND_POLICY_DEFAULTS = {
+	preShipmentDeliveryFeeRefund: true,
+	returnDeliveryFee: 0,
+	exchangeDeliveryFee: 0,
+	sellerFaultFreeShipping: true,
+	conditionalFreeShortfallCharge: false
+};
+/**
+* 부분 정책 — 스토어 설정 요청과 상품별 덮어쓰기가 쓴다. 준 항목만 바뀐다.
+*
+* `strictObject`라 모르는 키는 400이다. 오타(`returnFee` 등)를 조용히 무시하면 셀러는 저장됐다고
+* 믿는데 정책은 기본값으로 남는다.
+*/
+const refundPolicyPatchSchema = z.strictObject({
+	preShipmentDeliveryFeeRefund: z.boolean().optional().describe(descriptions.preShipmentDeliveryFeeRefund),
+	returnDeliveryFee: z.number().int().min(0).optional().describe(descriptions.returnDeliveryFee),
+	exchangeDeliveryFee: z.number().int().min(0).optional().describe(descriptions.exchangeDeliveryFee),
+	sellerFaultFreeShipping: z.boolean().optional().describe(descriptions.sellerFaultFreeShipping),
+	conditionalFreeShortfallCharge: z.boolean().optional().describe(descriptions.conditionalFreeShortfallCharge)
+});
+/**
+* 유효 정책 해석 — 상품별 덮어쓰기 → 스토어 기본 → `REFUND_POLICY_DEFAULTS` 순이다.
+*
+* 반품비·교환비는 레거시 필드(`products.returnFee`·`exchangeFee`)와 **연결**한다. 상품이
+* `refundPolicy.returnDeliveryFee`를 정하면 그 값이 원천이고(서버가 `returnFee`도 같은 값으로 맞춘다),
+* 정하지 않았으면 레거시 값이 0보다 클 때 그 값을 쓴다. 0이면 스토어 기본을 따른다 —
+* 정책이 생기기 전에 만든 상품(반품비 0)이 스토어 기본을 물려받게 하는 규칙이다.
+*/
+function resolveRefundPolicy(storePolicy, product) {
+	return {
+		...REFUND_POLICY_DEFAULTS,
+		...dropUndefined(storePolicy),
+		...productRefundPolicyOverride(product) ?? {}
+	};
+}
+/**
+* 상품의 **덮어쓰기 자체** — 레거시 반품비·교환비를 같은 형태로 승격한 값이다. 덮어쓰기가 없으면 null.
+*
+* `resolveRefundPolicy`가 합친 결과로는 "상품이 정한 값"과 "스토어 기본을 물려받은 값"을 가를 수 없다.
+* 관리 API 응답의 `refundPolicy`와 콘솔 폼의 덮어쓰기 스위치가 이 함수를 원천으로 쓴다 — 가르지 못하면
+* 스토어 기본을 쓰는 상품을 저장할 때 그 순간의 기본값이 상품에 박히거나, 레거시 값이 조용히 사라진다.
+*/
+function productRefundPolicyOverride(product) {
+	const override = dropUndefined(product?.refundPolicy);
+	const legacy = {};
+	if (override.returnDeliveryFee === void 0 && (product?.returnFee ?? 0) > 0) legacy.returnDeliveryFee = product?.returnFee ?? 0;
+	if (override.exchangeDeliveryFee === void 0 && (product?.exchangeFee ?? 0) > 0) legacy.exchangeDeliveryFee = product?.exchangeFee ?? 0;
+	const merged = {
+		...legacy,
+		...override
+	};
+	if (product?.refundPolicy == null && Object.keys(merged).length === 0) return null;
+	return merged;
+}
+/** `undefined` 값을 빼고 얕게 복사한다 — 전개 순서로 덮어쓸 때 `undefined`가 기본값을 지우지 않게 */
+function dropUndefined(patch) {
+	if (!patch) return {};
+	return Object.fromEntries(Object.entries(patch).filter(([, value]) => value !== void 0));
+}
+/**
+* 수량 단위 부분 취소의 환불 기준액 — **누적 내림의 차분**이다.
+*
+* 원 단위 반올림 규칙: `floor(주문상품 금액 × 누적 수량 ÷ 전체 수량)`을 두 번 구해 그 차를 쓴다.
+* 부분 취소를 몇 번 나눠도 합이 주문상품 금액과 정확히 같아서 1원이 남거나 넘치지 않는다.
+* 할인은 이미 단가에 들어 있어(주문 단위 쿠폰이 없다) 별도 안분이 없다.
+*
+* @param totalPrice 주문상품 금액 (할인 반영 단가 × 전체 수량)
+* @param quantity 주문상품 전체 수량
+* @param settledQuantity 이미 취소·반품된 누적 수량
+* @param cancelQuantity 이번에 취소·반품할 수량
+*/
+function proratedRefundBase(totalPrice, quantity, settledQuantity, cancelQuantity) {
+	if (quantity <= 0 || cancelQuantity <= 0) return 0;
+	const before = Math.floor(totalPrice * settledQuantity / quantity);
+	const after = Math.floor(totalPrice * (settledQuantity + cancelQuantity) / quantity);
+	return Math.max(0, after - before);
+}
+//#endregion
+//#region src/schemas/upload.ts
+/**
+* 업로드 용도. 허용 확장자와 크기 상한이 용도별로 다르다.
+*
+* - `product-image`: 상품 목록·상세의 상품 이미지. 목록 썸네일로 쓰이므로 정지 이미지만 받는다.
+* - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
+*/
+const uploadPurposeSchema = z.enum(["product-image", "description"]);
+const MB = 1048576;
+/**
+* 용도별 업로드 제한 — 서버(`POST /v1/uploads`)와 클라이언트가 공유하는 단일 원천이다.
+*
+* 크기는 **요청이 스스로 신고한 값**으로만 검사한다. 바이트는 api를 거치지 않고 CDN으로
+* 직접 PUT되므로 이 검사는 셀러가 올리기 전에 알게 하는 장치이고, 실제 상한은 CDN이 강제한다.
+*/
+const UPLOAD_PURPOSE_LIMITS = {
+	"product-image": {
+		extensions: [
+			"jpg",
+			"jpeg",
+			"png",
+			"webp",
+			"avif",
+			"gif"
+		],
+		maxBytes: 10 * MB
+	},
+	description: {
+		extensions: [
+			"jpg",
+			"jpeg",
+			"png",
+			"gif",
+			"webp",
+			"avif",
+			"svg",
+			"mp4",
+			"webm",
+			"mov"
+		],
+		maxBytes: 50 * MB
+	}
+};
+/** 파일명의 소문자 확장자. 확장자가 없으면 `""` */
+function uploadExtensionOf(filename) {
+	const dot = filename.lastIndexOf(".");
+	if (dot < 0 || dot === filename.length - 1) return "";
+	return filename.slice(dot + 1).toLowerCase();
+}
+/**
+* 용도 제한 위반 여부. 통과하면 `null`.
+* 서버가 던지는 오류와 콘솔이 먼저 띄우는 안내가 갈리지 않도록 한 함수로 판정한다.
+*/
+function uploadRejection(purpose, filename, size) {
+	const limit = UPLOAD_PURPOSE_LIMITS[purpose];
+	if (!limit.extensions.includes(uploadExtensionOf(filename))) return {
+		status: 400,
+		code: "UNSUPPORTED_FILE_TYPE",
+		message: `지원하지 않는 파일 형식입니다. ${limit.extensions.join(", ")}만 올릴 수 있습니다`
+	};
+	if (size !== void 0 && size > limit.maxBytes) return {
+		status: 413,
+		code: "FILE_TOO_LARGE",
+		message: `파일이 너무 큽니다. ${Math.floor(limit.maxBytes / MB)}MB까지 올릴 수 있습니다`
+	};
+	return null;
+}
+/**
+* 미디어 업로드 자리 발급 — `POST /v1/uploads`.
+*
+* 파일 바이트는 api를 거치지 않는다. 응답의 `uploadUrl`로 클라이언트가 직접 PUT하고,
+* 끝나면 `url`이 공개 주소가 된다. 서버가 객체 키를 정하므로 요청은 파일명만 보낸다
+* (확장자만 쓰이고 이름 자체는 저장되지 않는다).
+*/
+const uploadRequestSchema = z.object({
+	filename: z.string().min(1).max(255),
+	purpose: uploadPurposeSchema.default("description").describe("업로드 용도. 허용 확장자와 크기 상한이 용도별로 다르다"),
+	size: z.number().int().positive().optional().describe("파일 바이트 크기. 주면 용도별 상한을 발급 전에 검사한다")
+});
+const uploadTicketSchema = z.object({
+	/** 업로드 완료 후 공개될 주소 */
+	url: z.url(),
+	/** 파일 바이트를 PUT할 presigned URL. 1시간 유효 */
+	uploadUrl: z.url()
+});
+//#endregion
 //#region src/schemas/product.ts
 const productStatusSchema = z.enum([
 	"SALE",
@@ -1771,10 +2038,59 @@ const productSchema = productSummarySchema.extend({
 	conditionalFreeAmount: z.number().int().nullable().optional(),
 	returnFee: z.number().int().optional(),
 	exchangeFee: z.number().int().optional(),
+	refundPolicy: refundPolicyPatchSchema.nullable().optional().describe("상품별 환불 정책 덮어쓰기. null이면 스토어 기본 환불 정책을 쓴다"),
 	shippingAddressId: z.string().nullable().optional(),
 	returnAddressId: z.string().nullable().optional(),
 	createdAt: z.string().optional()
 });
+/** 상품 하나에 등록할 수 있는 이미지 최대 장수 — 첫 장이 대표(썸네일)다 */
+const MAX_PRODUCT_IMAGES = 10;
+/**
+* 상품 이미지 주소의 와이어 형식 — URL이고 2048자 이하다.
+*
+* https·확장자 규칙은 여기서 강제하지 않고 `productImageRejection`이 판정한다. 서버가
+* **새로 추가된 주소에만** 그 규칙을 적용해야 하기 때문이다(규칙이 생기기 전에 저장된
+* 주소 하나로 상품 수정 전체가 막히면 셀러가 빠져나갈 길이 없다).
+*
+* 응답 스키마(`productSchema.images`)도 넓게 둔다. 과거에 저장된 주소를 파싱 오류로
+* 만들면 상품 조회 자체가 막힌다.
+*/
+const productImageUrlSchema = z.url().max(2048).describe("상품 이미지 주소. https만 허용하고, 확장자가 있으면 이미지 형식이어야 한다");
+/**
+* 상품에 **새로 붙이는** 이미지 주소의 규칙. 통과하면 `null`.
+*
+* - https만 받는다. http는 https 스토어프론트에서 혼합 콘텐츠로 차단되고 `data:`·`javascript:`는
+*   상세 화면에 박히는 주입 경로가 된다.
+* - 호스트는 제한하지 않는다 — 셀러가 이미 쓰는 이미지 호스트를 그대로 붙일 수 있어야 한다.
+* - 경로에 확장자가 있으면 상품 이미지 형식이어야 한다(svg·동영상 거부). **확장자가 없으면 통과시킨다**
+*   — 외부 이미지 CDN은 확장자 없는 키를 쓰는 경우가 흔하고, 주소만으로는 실제 형식을 알 수 없다.
+*/
+function productImageRejection(url) {
+	if (url.length > 2048) return {
+		code: "INVALID_IMAGE_URL",
+		message: "이미지 주소가 너무 깁니다"
+	};
+	let parsed;
+	try {
+		parsed = new URL(url);
+	} catch {
+		return {
+			code: "INVALID_IMAGE_URL",
+			message: "이미지 주소 형식이 아닙니다"
+		};
+	}
+	if (parsed.protocol !== "https:") return {
+		code: "INVALID_IMAGE_URL",
+		message: "이미지 주소는 https로 시작해야 합니다"
+	};
+	const extension = uploadExtensionOf(parsed.pathname);
+	const allowed = UPLOAD_PURPOSE_LIMITS["product-image"].extensions;
+	if (extension && !allowed.includes(extension)) return {
+		code: "UNSUPPORTED_FILE_TYPE",
+		message: `상품 이미지는 ${allowed.join(", ")}만 쓸 수 있습니다`
+	};
+	return null;
+}
 /** 옵션 축(그룹) 최대 개수 — 스키마 상한의 단일 원천 */
 const MAX_OPTION_GROUPS = 3;
 /** 축 하나가 가질 수 있는 값의 최대 개수 */
@@ -1856,7 +2172,7 @@ const productCreateRequestSchema = z.object({
 	* 표시는 `description`(HTML)이 맡는다 — 소비자는 이 필드를 몰라도 된다.
 	*/
 	descriptionJson: z.string().nullable().optional(),
-	images: z.array(z.url()).min(1).max(10).optional(),
+	images: z.array(productImageUrlSchema).min(1).max(10).optional().describe("상품 이미지 주소 목록. 첫 장이 대표 이미지(썸네일)다"),
 	attributes: z.array(z.object({
 		attributeId: z.string(),
 		value: z.string()
@@ -1864,8 +2180,9 @@ const productCreateRequestSchema = z.object({
 	deliveryType: deliveryTypeSchema.default("PAID").describe("배송비 유형. FREE 무료, PAID 유료, CONDITIONAL_FREE 조건부 무료"),
 	deliveryFee: z.number().int().default(0).describe("배송비. 원 단위"),
 	conditionalFreeAmount: z.number().int().optional().describe("CONDITIONAL_FREE일 때 무료 배송이 되는 주문 금액. 원 단위"),
-	returnFee: z.number().int().default(0).describe("반품 배송비. 원 단위"),
-	exchangeFee: z.number().int().default(0).describe("교환 배송비. 원 단위"),
+	returnFee: z.number().int().default(0).describe("반품 배송비. 원 단위. `refundPolicy.returnDeliveryFee`와 같은 값이다"),
+	exchangeFee: z.number().int().default(0).describe("교환 배송비. 원 단위. `refundPolicy.exchangeDeliveryFee`와 같은 값이다"),
+	refundPolicy: refundPolicyPatchSchema.nullish().describe("상품별 환불 정책 — 준 항목만 스토어 기본을 덮어쓴다. `null`이나 생략은 스토어 기본을 그대로 쓴다는 뜻이다. `returnDeliveryFee`·`exchangeDeliveryFee`를 주면 `returnFee`·`exchangeFee`도 같은 값으로 맞춘다"),
 	shippingAddressId: z.string().optional(),
 	returnAddressId: z.string().optional()
 }).extend(optionModelRequestSchema.shape);
@@ -1891,12 +2208,6 @@ const productListQuerySchema = z.object({
 	sort: productSortSchema.optional().describe("정렬 (기본 createdAt.desc)"),
 	...pageQueryShape()
 });
-/** `POST /v1/product-images` 응답 — 업로드된 이미지의 CDN 주소 */
-const productImageUploadResultSchema = z.object({ images: z.array(z.object({
-	url: z.url(),
-	width: z.number().int(),
-	height: z.number().int()
-})) });
 const discountSchema = z.object({
 	productId: z.string(),
 	discountType: z.enum(["RATE", "AMOUNT"]),
@@ -1985,6 +2296,20 @@ function isWebOrigin(value) {
 const analyticsOriginSchema = z.string().trim().max(255).refine(isWebOrigin, "https://shop.example.com 형식(경로 없이)으로 입력해 주세요").describe("스토어프론트 오리진. 예: `https://shop.example.com`");
 /** 허용 오리진 상한 */
 const MAX_ANALYTICS_ALLOWED_ORIGINS = 20;
+/** 자동 배송완료·자동 구매확정 대기일 상한 */
+const MAX_AUTO_TRANSITION_DAYS = 30;
+/**
+* 약관 버전 — 스토어가 정하는 문자열이다(`1`·`2`·`2026-09-26`·`v1.2` 등). 형식은 강제하지 않고 값이 다르면 다른 버전이다.
+* 올리면 그 약관에 동의한 구매자의 `reconsentRequired`가 켜지고, 재동의가 이력에 남는다. 되돌리면 재동의 요구도 풀린다.
+*/
+const policyVersionSchema = z.string().trim().min(1).max(20).describe("약관 버전 문자열(1~20자). 예: `1`, `2026-09-26`");
+/**
+* 약관 문서 주소 — 구매자에게 보여 주는 약관 본문의 주소다. 동의 시점 값이 이력 행에 복사되므로
+* 나중에 주소를 바꿔도 "무엇에 동의했는지"가 남는다. `null`로 지울 수 있다.
+*/
+const policyDocumentUrlSchema = z.url().max(500).refine((value) => value.startsWith("https://"), "https 주소만 쓸 수 있어요").nullable();
+const autoDeliverDaysDescription = "발송 후 자동 배송완료까지의 일수(0~30, 기본 7). 발송(`DISPATCHED`)·배송중(`DELIVERING`) 주문상품을 이 기간이 지나면 배송완료(`DELIVERED`)로 바꾼다. `0`이면 자동 배송완료를 하지 않는다";
+const autoConfirmDaysDescription = "배송완료 후 자동 구매확정까지의 일수(0~30, 기본 7). 배송완료 시점에 구매확정 예정일(`autoDecisionDate`)을 이 값으로 잡고, 그 날짜가 지나면 구매확정(`PURCHASE_DECIDED`)으로 바꾼다. 진행 중인 클레임이 있으면 건너뛴다. `0`이면 자동 구매확정을 하지 않는다";
 /** `PATCH /v1/store` 본문 — 바꿀 필드만 보낸다 */
 const updateStoreRequestSchema = z.object({
 	name: z.string().min(2).max(50).optional(),
@@ -1993,7 +2318,14 @@ const updateStoreRequestSchema = z.object({
 	businessHours: z.string().max(100).optional(),
 	analyticsAllowedOrigins: z.array(analyticsOriginSchema).max(20).optional().describe("@deprecated `storefrontOrigins`를 쓴다(같은 목록). 방문 분석 수집을 받을 스토어프론트 오리진(최대 20개). 비우면 모든 오리진에서 받는다. 넣으면 목록에 없는 오리진의 수집 요청은 403 `ORIGIN_NOT_ALLOWED`이고, 페이지 URL이 목록 밖인 이벤트는 버린다"),
 	storefrontOrigins: z.array(analyticsOriginSchema).max(20).optional().describe("스토어프론트 도메인(최대 20개) — 소셜 로그인 뒤 돌아갈 주소와 방문 분석 수집을 함께 제한한다. `analyticsAllowedOrigins`와 같은 목록이다(둘 다 주면 이 값이 이긴다)"),
-	guestCheckoutEnabled: z.boolean().optional().describe("비회원 주문 허용. false(회원만)면 로그인하지 않은 구매자의 주문서 생성·결제 요청이 403 `GUEST_CHECKOUT_DISABLED`다. 장바구니 담기와 이미 받은 비회원 주문의 조회·취소는 막지 않는다")
+	guestCheckoutEnabled: z.boolean().optional().describe("비회원 주문 허용. false(회원만)면 로그인하지 않은 구매자의 주문서 생성·결제 요청이 403 `GUEST_CHECKOUT_DISABLED`다. 장바구니 담기와 이미 받은 비회원 주문의 조회·취소는 막지 않는다"),
+	autoDeliverDays: z.number().int().min(0).max(30).optional().describe(autoDeliverDaysDescription),
+	autoConfirmDays: z.number().int().min(0).max(30).optional().describe(autoConfirmDaysDescription),
+	refundPolicy: refundPolicyPatchSchema.optional().describe("스토어 기본 환불 정책 — 준 항목만 바꾼다. 상품별 정책(`products.refundPolicy`)이 없는 상품에 적용된다"),
+	termsVersion: policyVersionSchema.optional().describe("이용약관 버전. 올리면 이 약관에 동의한 구매자에게 재동의를 요구한다(`GET /storefront/v1/me`의 `reconsentRequired`)"),
+	privacyVersion: policyVersionSchema.optional().describe("개인정보 수집이용 동의 버전. 올리면 구매자에게 재동의를 요구한다"),
+	termsUrl: policyDocumentUrlSchema.optional().describe("이용약관 문서 주소(https). 동의 시점의 값이 동의 이력에 복사된다. `null`을 주면 지운다"),
+	privacyUrl: policyDocumentUrlSchema.optional().describe("개인정보 수집이용 동의 문서 주소(https). `null`을 주면 지운다")
 }).refine((value) => Object.values(value).some((v) => v !== void 0), { message: "최소 1개 필드가 필요합니다" });
 const storeSchema = z.object({
 	storeId: z.string(),
@@ -2011,6 +2343,15 @@ const storeSchema = z.object({
 	analyticsAllowedOrigins: z.array(z.string()).describe("방문 분석 수집을 받는 스토어프론트 오리진. 비어 있으면 모든 오리진에서 받는다"),
 	storefrontOrigins: z.array(z.string()).describe("스토어프론트 도메인 — 소셜 로그인 리디렉트와 방문 분석 수집이 함께 쓴다(`analyticsAllowedOrigins`와 같은 값)"),
 	guestCheckoutEnabled: z.boolean().describe("비회원 주문 허용. false면 회원만 주문할 수 있다"),
+	autoDeliverDays: z.number().int().describe(autoDeliverDaysDescription),
+	autoConfirmDays: z.number().int().describe(autoConfirmDaysDescription),
+	refundPolicy: refundPolicySchema.describe("스토어 기본 환불 정책. 스토어가 정하지 않은 항목은 플랫폼 기본값으로 채워 항상 전부 싣는다"),
+	termsVersion: z.string().describe("현재 이용약관 버전. 가입·재동의가 이 값으로 이력에 남는다"),
+	privacyVersion: z.string().describe("현재 개인정보 수집이용 동의 버전"),
+	termsVersionUpdatedAt: z.string().nullable().describe("이용약관 버전을 마지막으로 바꾼 시각. 바꾼 적이 없으면 null"),
+	privacyVersionUpdatedAt: z.string().nullable(),
+	termsUrl: z.string().nullable().describe("이용약관 문서 주소. 정하지 않았으면 null이고 동의 이력에도 주소가 남지 않는다"),
+	privacyUrl: z.string().nullable().describe("개인정보 수집이용 동의 문서 주소"),
 	memberCount: z.number().int(),
 	createdAt: z.string()
 });
@@ -2068,22 +2409,6 @@ const sellerAddressRequestSchema = z.object({
 	address2: z.string().optional()
 });
 //#endregion
-//#region src/schemas/upload.ts
-/**
-* 미디어 업로드 자리 발급 — `POST /v1/uploads`.
-*
-* 파일 바이트는 api를 거치지 않는다. 응답의 `uploadUrl`로 클라이언트가 직접 PUT하고,
-* 끝나면 `url`이 공개 주소가 된다. 서버가 객체 키를 정하므로 요청은 파일명만 보낸다
-* (확장자만 쓰이고 이름 자체는 저장되지 않는다).
-*/
-const uploadRequestSchema = z.object({ filename: z.string().min(1).max(255) });
-const uploadTicketSchema = z.object({
-	/** 업로드 완료 후 공개될 주소 */
-	url: z.url(),
-	/** 파일 바이트를 PUT할 presigned URL. 1시간 유효 */
-	uploadUrl: z.url()
-});
-//#endregion
 //#region src/client.ts
 function formBody(fields) {
 	return new URLSearchParams(fields).toString();
@@ -2211,7 +2536,35 @@ function createStoreClient(options) {
 		* 미디어 업로드 — 자리를 받아(`POST /uploads`) 파일 바이트는 호출자가
 		* `uploadUrl`로 직접 PUT한다. 업로드가 끝나면 `url`이 공개 주소가 된다.
 		*/
-		uploads: { create: (body) => storeHttp.request("POST", "/uploads", uploadTicketSchema, { body: uploadRequestSchema.parse(body) }) },
+		uploads: {
+			create: (body) => storeHttp.request("POST", "/uploads", uploadTicketSchema, { body: uploadRequestSchema.parse(body) }),
+			/**
+			* 자리 발급 + 바이트 PUT을 한 번에 — 끝나면 `url`이 공개 주소다.
+			*
+			* 용도 제한(확장자·크기)은 서버가 판정하지만, 같은 규칙으로 여기서 먼저 걸러
+			* 큰 파일을 CDN까지 보내고 나서 거절되는 왕복을 없앤다.
+			*/
+			upload: async (file, options) => {
+				const filename = options?.filename ?? (typeof File !== "undefined" && file instanceof File ? file.name : "");
+				if (!filename) throw new ApiError(400, "UPLOAD_FILENAME_REQUIRED", "파일명이 필요합니다");
+				if (file.size === 0) throw new ApiError(400, "EMPTY_FILE", `파일이 비어 있습니다: ${filename}`);
+				const purpose = options?.purpose ?? "description";
+				const rejection = uploadRejection(purpose, filename, file.size);
+				if (rejection) throw new ApiError(rejection.status, rejection.code, rejection.message);
+				const ticket = await storeHttp.request("POST", "/uploads", uploadTicketSchema, { body: uploadRequestSchema.parse({
+					filename,
+					purpose,
+					size: file.size
+				}) });
+				const put = await fetchFn(ticket.uploadUrl, {
+					method: "PUT",
+					headers: { "content-type": file.type || "application/octet-stream" },
+					body: file
+				});
+				if (!put.ok) throw new ApiError(put.status, "UPLOAD_PUT_FAILED", `업로드에 실패했습니다: ${filename}`);
+				return ticket;
+			}
+		},
 		products: {
 			list: (params) => storeHttp.request("GET", "/products", pageSchema(productSummarySchema), { query: params }),
 			get: (productId) => storeHttp.request("GET", path`/products/${productId}`, productSchema),
@@ -2292,6 +2645,16 @@ function createStoreClient(options) {
 				carrierCode,
 				trackingNumber
 			} }),
+			/**
+			* 배송완료 처리 — `DISPATCHED`·`DELIVERING`만 넘어간다. 응답의 `autoDecisionDate`가 자동 구매확정 예정일이다
+			* (스토어 설정 `autoConfirmDays`가 0이면 null).
+			*/
+			markDelivered: (orderItemId, idempotencyKey) => storeHttp.request("POST", path`/order-items/${orderItemId}/delivered`, orderItemSchema, { headers: idempotency(idempotencyKey) }),
+			/** 배송완료 일괄 처리 — 항목별 부분 성공이다 */
+			markDeliveredBulk: (orderItemIds, idempotencyKey) => storeHttp.request("POST", "/order-items/delivered", bulkResultSchema, {
+				body: { orderItemIds },
+				headers: idempotency(idempotencyKey)
+			}),
 			getDelivery: (orderItemId) => storeHttp.request("GET", path`/order-items/${orderItemId}/delivery`, deliveryStatusSchema)
 		},
 		carriers: { list: () => storeHttp.request("GET", "/carriers", z.array(carrierSchema)) },
@@ -2341,6 +2704,8 @@ function createStoreClient(options) {
 			list: (params) => storeHttp.request("GET", "/customers", pageSchema(customerSummarySchema), { query: params }),
 			get: (customerId) => storeHttp.request("GET", path`/customers/${customerId}`, customerDetailSchema),
 			orders: (customerId, params) => storeHttp.request("GET", path`/customers/${customerId}/orders`, pageSchema(customerOrderSchema), { query: params }),
+			/** 동의 이력 — 최근 순. 가입·재동의·마케팅 변경이 한 줄씩 남는다 */
+			consents: (customerId, params) => storeHttp.request("GET", path`/customers/${customerId}/consents`, pageSchema(customerConsentSchema), { query: params }),
 			withdraw: (customerId, body) => storeHttp.requestVoid("POST", path`/customers/${customerId}/withdraw`, { body: withdrawCustomerRequestSchema.parse(body) })
 		},
 		customerInquiries: {
@@ -2716,6 +3081,11 @@ const claimWebhookEventDataSchema = z.object({
 	orderItemId: z.string().describe("클레임 대상 주문 상품 ID"),
 	claimType: claimTypeSchema.describe("클레임 유형"),
 	status: claimStatusSchema.describe("이벤트 발생 시점의 클레임 상태"),
+	quantity: z.number().int().optional().default(0).describe("클레임 대상 수량. 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
+	refundAmount: z.number().int().nullable().optional().default(null).describe("환불액 (원). 배송비 환불을 포함하고 배송비 차감·추가 차감을 뺀 실제 금액이다. 환불이 확정되지 않은 접수 이벤트는 예상 환불액이고, 교환처럼 환불이 없으면 null이다"),
+	deliveryFeeRefundAmount: z.number().int().optional().default(0).describe("환불액에 포함된 배송비 (원). 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
+	deliveryFeeChargeAmount: z.number().int().optional().default(0).describe("환불액에서 뺀 배송비 (원) — 반품·교환 배송비와 조건부 무료배송 미달 차감의 합. 셀러가 승인에 넣은 추가 차감은 `deductAmount`로 따로 온다. 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
+	deductAmount: z.number().int().optional().default(0).describe("환불액에서 뺀 추가 차감 (원) — 셀러가 클레임 승인에 넣은 금액이다(상품 훼손 등). 배송비 차감과 별개이므로 `deliveryFeeChargeAmount`와 더해서 뺀다. 접수 이벤트와 이 필드가 없는 이전 이벤트는 0이다"),
 	testPayment: z.boolean().optional().default(false).describe("테스트 결제(샌드박스 결제) 주문의 클레임인가. 이 필드가 없는 이전 이벤트는 false로 읽는다")
 });
 const inquiryWebhookEventDataSchema = z.object({
@@ -2926,4 +3296,4 @@ function createStoreSession(options) {
 	};
 }
 //#endregion
-export { ApiError, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_OPTION_GROUPS, MAX_VALUES_PER_GROUP, MAX_VARIANTS, PAYMENT_ROUTING_EXCLUSION_CODES, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, RESERVED_STORE_CODES, STORE_CODE_PATTERN, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, VARIANT_STOCK_EXCLUSIVE_MESSAGE, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_HEADERS, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, addressChangeRequestListSchema, addressTypeSchema, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiClientListQuerySchema, apiClientSchema, apiClientSecretRotatedSchema, apiClientStatusSchema, apiClientTypeSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, apiTokenCreateRequestSchema, apiTokenCreatedSchema, apiTokenSchema, approveClaimResultSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, clientCredentialsTokenResponseSchema, createPkcePair, createStoreClient, createStoreSession, customerAddressSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationListQuerySchema, invitationSchema, isReservedStoreCode, isStoreScope, isWebOrigin, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, myAccountSchema, myStoreSchema, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionValueRequestSchema, optionValueSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productImageUploadResultSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, refreshUserToken, rejectClaimRequestSchema, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, scopeAccessSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, tossPaymentsCredentialsInputSchema, trackingUpdateResultSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookRedeliverFailedResultSchema, webhookRequestSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema };
+export { ApiError, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_OPTION_GROUPS, MAX_PRODUCT_IMAGES, MAX_VALUES_PER_GROUP, MAX_VARIANTS, PAYMENT_ROUTING_EXCLUSION_CODES, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, REFUND_POLICY_DEFAULTS, RESERVED_STORE_CODES, STORE_CODE_PATTERN, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, UPLOAD_PURPOSE_LIMITS, VARIANT_STOCK_EXCLUSIVE_MESSAGE, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_HEADERS, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, addressChangeRequestListSchema, addressTypeSchema, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiClientListQuerySchema, apiClientSchema, apiClientSecretRotatedSchema, apiClientStatusSchema, apiClientTypeSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, apiTokenCreateRequestSchema, apiTokenCreatedSchema, apiTokenSchema, approveClaimResultSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, clientCredentialsTokenResponseSchema, consentActionSchema, consentKindSchema, consentSourceSchema, createPkcePair, createStoreClient, createStoreSession, customerAddressSchema, customerConsentListQuerySchema, customerConsentSchema, customerConsentStateSchema, customerConsentsSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationListQuerySchema, invitationSchema, isReservedStoreCode, isStoreScope, isWebOrigin, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, myAccountSchema, myStoreSchema, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionValueRequestSchema, optionValueSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productRefundPolicyOverride, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, proratedRefundBase, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, refreshUserToken, refundPolicyPatchSchema, refundPolicySchema, rejectClaimRequestSchema, resolveRefundPolicy, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, scopeAccessSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, tossPaymentsCredentialsInputSchema, trackingUpdateResultSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookRedeliverFailedResultSchema, webhookRequestSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema };

package/package.json

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