@sayren/store-sdk 0.4.0 → 0.6.0

package/dist/index.d.mts

@@ -976,11 +976,14 @@ export declare const claimSchema: z.ZodObject<{
   }, z.core.$strip>>;
   requestedAt: z.ZodString;
   completedAt: z.ZodNullable<z.ZodString>;
+  holdExpiresAt: z.ZodNullable<z.ZodString>;
+  holdUsed: z.ZodBoolean;
 }, z.core.$strip>;
 export type Claim = z.infer<typeof claimSchema>;
 export interface ClaimListParams extends PageParams {
   type?: ClaimType;
-  status?: ClaimStatus;
+  /** 여러 상태를 한 번에 거를 수 있다(처리 대기 목록 등) */
+  status?: ClaimStatus | ClaimStatus[];
   orderItemId?: string;
   requestedFrom?: string;
   requestedTo?: string;
@@ -994,17 +997,7 @@ export declare const claimListQuerySchema: z.ZodObject<{
     EXCHANGE: "EXCHANGE";
     CANCEL: "CANCEL";
   }>>;
-  status: z.ZodOptional<z.ZodEnum<{
-    REQUESTED: "REQUESTED";
-    HELD: "HELD";
-    COLLECTING: "COLLECTING";
-    COLLECTED: "COLLECTED";
-    REDELIVERING: "REDELIVERING";
-    APPROVED: "APPROVED";
-    REJECTED: "REJECTED";
-    COMPLETED: "COMPLETED";
-    WITHDRAWN: "WITHDRAWN";
-  }>>;
+  status: z.ZodOptional<z.ZodString>;
   orderItemId: z.ZodOptional<z.ZodString>;
   requestedFrom: z.ZodOptional<z.ZodString>;
   requestedTo: z.ZodOptional<z.ZodString>;
@@ -1061,6 +1054,8 @@ export declare const claimDetailSchema: z.ZodObject<{
   }, z.core.$strip>>;
   requestedAt: z.ZodString;
   completedAt: z.ZodNullable<z.ZodString>;
+  holdExpiresAt: z.ZodNullable<z.ZodString>;
+  holdUsed: z.ZodBoolean;
   histories: z.ZodOptional<z.ZodArray<z.ZodObject<{
     status: z.ZodEnum<{
       REQUESTED: "REQUESTED";
@@ -1147,7 +1142,7 @@ export declare const customerStatsSchema: z.ZodObject<{
 export declare const customerSummarySchema: z.ZodObject<{
   customerId: z.ZodString;
   name: z.ZodString;
-  email: z.ZodString;
+  email: z.ZodNullable<z.ZodString>;
   maskedPhone: z.ZodNullable<z.ZodString>;
   joinedAt: z.ZodString;
   point: z.ZodNumber;
@@ -1171,14 +1166,20 @@ export declare const customerAddressSchema: z.ZodObject<{
 export declare const customerDetailSchema: z.ZodObject<{
   customerId: z.ZodString;
   name: z.ZodString;
-  email: z.ZodString;
+  email: z.ZodNullable<z.ZodString>;
   phone: z.ZodNullable<z.ZodString>;
   joinedAt: z.ZodString;
   point: z.ZodNumber;
   marketingAgreed: z.ZodBoolean;
-  loginMethods: z.ZodArray<z.ZodEnum<{
-    password: "password";
-  }>>;
+  loginMethods: z.ZodArray<z.ZodObject<{
+    method: z.ZodEnum<{
+      kakao: "kakao";
+      naver: "naver";
+      google: "google";
+      password: "password";
+    }>;
+    linkedAt: z.ZodString;
+  }, z.core.$strip>>;
   addresses: z.ZodArray<z.ZodObject<{
     addressId: z.ZodString;
     alias: z.ZodString;
@@ -1239,7 +1240,7 @@ export declare const withdrawCustomerRequestSchema: z.ZodObject<{
   memo: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type WithdrawCustomerRequest = z.infer<typeof withdrawCustomerRequestSchema>;
-/** `WITHDRAWAL_BLOCKED`의 `error.details` — 탈퇴를 막는 항목 수(스토어프런트 탈퇴와 같다) */
+/** `WITHDRAWAL_BLOCKED`의 `error.details` — 탈퇴를 막는 항목 수(스토어프론트 탈퇴와 같다) */
 export declare const customerWithdrawalBlockedDetailsSchema: z.ZodObject<{
   inProgressOrderItems: z.ZodNumber;
   openClaims: z.ZodNumber;
@@ -1247,6 +1248,81 @@ export declare const customerWithdrawalBlockedDetailsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type CustomerWithdrawalBlockedDetails = z.infer<typeof customerWithdrawalBlockedDetailsSchema>;
 //#endregion
+//#region src/schemas/login.d.ts
+/** 소셜 로그인 공급자 */
+export declare const loginProviderSchema: z.ZodEnum<{
+  kakao: "kakao";
+  naver: "naver";
+  google: "google";
+}>;
+export type LoginProvider = z.infer<typeof loginProviderSchema>;
+/** 공급자 연결 상태 — 비밀 값은 앞 4자리만 */
+export declare const loginProviderStatusSchema: z.ZodObject<{
+  provider: z.ZodEnum<{
+    kakao: "kakao";
+    naver: "naver";
+    google: "google";
+  }>;
+  connected: z.ZodBoolean;
+  enabled: z.ZodBoolean;
+  clientIdPrefix: z.ZodNullable<z.ZodString>;
+  secretPrefix: z.ZodNullable<z.ZodString>;
+  lastTestedAt: z.ZodNullable<z.ZodString>;
+  lastTestOk: z.ZodNullable<z.ZodBoolean>;
+  linkedMemberCount: z.ZodNumber;
+  onlyMethodMemberCount: z.ZodNumber;
+  callbackUrl: z.ZodURL;
+}, z.core.$strip>;
+export type LoginProviderStatus = z.infer<typeof loginProviderStatusSchema>;
+/** `GET /v1/store/login-settings` */
+export declare const loginSettingsSchema: z.ZodObject<{
+  passwordLoginEnabled: z.ZodBoolean;
+  passwordOnlyMemberCount: z.ZodNumber;
+  storefrontOrigins: z.ZodArray<z.ZodString>;
+  providers: z.ZodArray<z.ZodObject<{
+    provider: z.ZodEnum<{
+      kakao: "kakao";
+      naver: "naver";
+      google: "google";
+    }>;
+    connected: z.ZodBoolean;
+    enabled: z.ZodBoolean;
+    clientIdPrefix: z.ZodNullable<z.ZodString>;
+    secretPrefix: z.ZodNullable<z.ZodString>;
+    lastTestedAt: z.ZodNullable<z.ZodString>;
+    lastTestOk: z.ZodNullable<z.ZodBoolean>;
+    linkedMemberCount: z.ZodNumber;
+    onlyMethodMemberCount: z.ZodNumber;
+    callbackUrl: z.ZodURL;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LoginSettings = z.infer<typeof loginSettingsSchema>;
+/** `PATCH /v1/store/login-settings` */
+export declare const updateLoginSettingsRequestSchema: z.ZodObject<{
+  passwordLoginEnabled: z.ZodBoolean;
+}, z.core.$strip>;
+export type UpdateLoginSettingsRequest = z.infer<typeof updateLoginSettingsRequestSchema>;
+/** `PUT /v1/store/auth-providers/{provider}` — 저장 전에 연결 테스트를 한다 */
+export declare const saveLoginProviderRequestSchema: z.ZodObject<{
+  clientId: z.ZodString;
+  clientSecret: z.ZodString;
+}, z.core.$strip>;
+export type SaveLoginProviderRequest = z.infer<typeof saveLoginProviderRequestSchema>;
+/** `PATCH /v1/store/auth-providers/{provider}` */
+export declare const updateLoginProviderRequestSchema: z.ZodObject<{
+  enabled: z.ZodBoolean;
+}, z.core.$strip>;
+/** 연결 테스트 결과 */
+export declare const loginProviderTestSchema: z.ZodObject<{
+  ok: z.ZodBoolean;
+  code: z.ZodNullable<z.ZodEnum<{
+    INVALID_CLIENT: "INVALID_CLIENT";
+    PROVIDER_UNAVAILABLE: "PROVIDER_UNAVAILABLE";
+  }>>;
+  testedAt: z.ZodString;
+}, z.core.$strip>;
+export type LoginProviderTest = z.infer<typeof loginProviderTestSchema>;
+//#endregion
 //#region src/schemas/misc.d.ts
 export declare const inquirySchema: z.ZodObject<{
   inquiryId: z.ZodString;
@@ -3461,7 +3537,7 @@ export declare function isReservedStoreCode(code: string): boolean;
 export declare const storeCodeSchema: z.ZodString;
 /** `https://shop.example.com`처럼 경로·쿼리 없는 http(s) 오리진인가 */
 export declare function isWebOrigin(value: string): boolean;
-/** 방문 분석을 보낼 수 있는 스토어프런트 오리진 — 스킴·호스트(·포트)만. 서버가 소문자·끝 슬래시 제거로 정규화한다 */
+/** 방문 분석을 보낼 수 있는 스토어프론트 오리진 — 스킴·호스트(·포트)만. 서버가 소문자·끝 슬래시 제거로 정규화한다 */
 export declare const analyticsOriginSchema: z.ZodString;
 /** 허용 오리진 상한 */
 export declare const MAX_ANALYTICS_ALLOWED_ORIGINS = 20;
@@ -3472,6 +3548,7 @@ export declare const updateStoreRequestSchema: z.ZodObject<{
   customerCenterPhone: z.ZodOptional<z.ZodString>;
   businessHours: z.ZodOptional<z.ZodString>;
   analyticsAllowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  storefrontOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
   guestCheckoutEnabled: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type UpdateStoreRequest = z.infer<typeof updateStoreRequestSchema>;
@@ -3489,6 +3566,7 @@ export declare const storeSchema: z.ZodObject<{
   businessNumber: z.ZodNullable<z.ZodString>;
   customerCenterPhone: z.ZodNullable<z.ZodString>;
   analyticsAllowedOrigins: z.ZodArray<z.ZodString>;
+  storefrontOrigins: z.ZodArray<z.ZodString>;
   guestCheckoutEnabled: z.ZodBoolean;
   memberCount: z.ZodNumber;
   createdAt: z.ZodString;
@@ -4506,6 +4584,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         } | null;
         requestedAt: string;
         completedAt: string | null;
+        holdExpiresAt: string | null;
+        holdUsed: boolean;
       }[];
     }>;
     get: (claimId: string) => Promise<{
@@ -4532,6 +4612,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       } | null;
       requestedAt: string;
       completedAt: string | null;
+      holdExpiresAt: string | null;
+      holdUsed: boolean;
       histories?: {
         status: "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "REJECTED" | "COMPLETED" | "WITHDRAWN";
         actor: "BUYER" | "SELLER" | "SYSTEM";
@@ -4556,6 +4638,34 @@ export declare function createStoreClient(options: StoreClientOptions): {
       holdExpiresAt: string;
     }>;
     releaseHold: (claimId: string) => Promise<void>;
+    /** 교환 완료 — 재배송 중인 교환을 셀러가 명시적으로 끝낸다 */
+    completeExchange: (claimId: string) => Promise<{
+      claimId: string;
+      type: "RETURN" | "EXCHANGE" | "CANCEL";
+      status: "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "REJECTED" | "COMPLETED" | "WITHDRAWN";
+      orderId: string;
+      orderItemId: string;
+      productName: string;
+      quantity: number;
+      reason: "CHANGE_OF_MIND" | "WRONG_ORDER" | "DEFECTIVE" | "WRONG_DELIVERY" | "DIFFERENT_FROM_PAGE" | "DELAY";
+      reasonDetail: string | null;
+      responsibility: "BUYER" | "SELLER";
+      claimDeliveryFee: number;
+      expectedRefundAmount: number | null;
+      exchangeOption: {
+        optionId: string;
+        optionName: string;
+      } | null;
+      collect: {
+        method: "SELLER_PICKUP" | "BUYER_SEND";
+        carrierCode: string | null;
+        trackingNumber: string | null;
+      } | null;
+      requestedAt: string;
+      completedAt: string | null;
+      holdExpiresAt: string | null;
+      holdUsed: boolean;
+    }>;
   };
   inquiries: {
     list: (params?: PageParams & {
@@ -4605,6 +4715,103 @@ export declare function createStoreClient(options: StoreClientOptions): {
     answer: (inquiryId: string, content: string) => Promise<void>;
     updateAnswer: (inquiryId: string, content: string) => Promise<void>;
   };
+  /**
+   * 구매자 로그인 설정 — 이메일·비밀번호 허용, 소셜 공급자 연결. 비밀 값을 다루므로 콘솔에 로그인한 OWNER만 호출할 수 있다
+   */
+  loginSettings: {
+    get: () => Promise<{
+      passwordLoginEnabled: boolean;
+      passwordOnlyMemberCount: number;
+      storefrontOrigins: string[];
+      providers: {
+        provider: "kakao" | "naver" | "google";
+        connected: boolean;
+        enabled: boolean;
+        clientIdPrefix: string | null;
+        secretPrefix: string | null;
+        lastTestedAt: string | null;
+        lastTestOk: boolean | null;
+        linkedMemberCount: number;
+        onlyMethodMemberCount: number;
+        callbackUrl: string;
+      }[];
+    }>;
+    update: (body: UpdateLoginSettingsRequest) => Promise<{
+      passwordLoginEnabled: boolean;
+      passwordOnlyMemberCount: number;
+      storefrontOrigins: string[];
+      providers: {
+        provider: "kakao" | "naver" | "google";
+        connected: boolean;
+        enabled: boolean;
+        clientIdPrefix: string | null;
+        secretPrefix: string | null;
+        lastTestedAt: string | null;
+        lastTestOk: boolean | null;
+        linkedMemberCount: number;
+        onlyMethodMemberCount: number;
+        callbackUrl: string;
+      }[];
+    }>;
+    /** 키 저장 — 저장 전에 연결 테스트를 하고, 실패하면 422 `LOGIN_PROVIDER_VERIFICATION_FAILED` */
+    saveProvider: (provider: LoginProvider, body: SaveLoginProviderRequest) => Promise<{
+      passwordLoginEnabled: boolean;
+      passwordOnlyMemberCount: number;
+      storefrontOrigins: string[];
+      providers: {
+        provider: "kakao" | "naver" | "google";
+        connected: boolean;
+        enabled: boolean;
+        clientIdPrefix: string | null;
+        secretPrefix: string | null;
+        lastTestedAt: string | null;
+        lastTestOk: boolean | null;
+        linkedMemberCount: number;
+        onlyMethodMemberCount: number;
+        callbackUrl: string;
+      }[];
+    }>;
+    setProviderEnabled: (provider: LoginProvider, enabled: boolean) => Promise<{
+      passwordLoginEnabled: boolean;
+      passwordOnlyMemberCount: number;
+      storefrontOrigins: string[];
+      providers: {
+        provider: "kakao" | "naver" | "google";
+        connected: boolean;
+        enabled: boolean;
+        clientIdPrefix: string | null;
+        secretPrefix: string | null;
+        lastTestedAt: string | null;
+        lastTestOk: boolean | null;
+        linkedMemberCount: number;
+        onlyMethodMemberCount: number;
+        callbackUrl: string;
+      }[];
+    }>;
+    testProvider: (provider: LoginProvider) => Promise<{
+      ok: boolean;
+      code: "INVALID_CLIENT" | "PROVIDER_UNAVAILABLE" | null;
+      testedAt: string;
+    }>;
+    /** 연결 해제 — 키를 지운다. 연결된 구매자 계정은 남는다 */
+    removeProvider: (provider: LoginProvider) => Promise<{
+      passwordLoginEnabled: boolean;
+      passwordOnlyMemberCount: number;
+      storefrontOrigins: string[];
+      providers: {
+        provider: "kakao" | "naver" | "google";
+        connected: boolean;
+        enabled: boolean;
+        clientIdPrefix: string | null;
+        secretPrefix: string | null;
+        lastTestedAt: string | null;
+        lastTestOk: boolean | null;
+        linkedMemberCount: number;
+        onlyMethodMemberCount: number;
+        callbackUrl: string;
+      }[];
+    }>;
+  };
   /** 구매자 관리 — 조회 `customer:r`, 탈퇴 처리 `customer:rw`(콘솔 OWNER·ADMIN) */
   customers: {
     list: (params?: PageParams & Omit<z.input<typeof customerListQuerySchema>, "page" | "size">) => Promise<{
@@ -4615,7 +4822,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       contents: {
         customerId: string;
         name: string;
-        email: string;
+        email: string | null;
         maskedPhone: string | null;
         joinedAt: string;
         point: number;
@@ -4628,12 +4835,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (customerId: string) => Promise<{
       customerId: string;
       name: string;
-      email: string;
+      email: string | null;
       phone: string | null;
       joinedAt: string;
       point: number;
       marketingAgreed: boolean;
-      loginMethods: "password"[];
+      loginMethods: {
+        method: "kakao" | "naver" | "google" | "password";
+        linkedAt: string;
+      }[];
       addresses: {
         addressId: string;
         alias: string;
@@ -4810,7 +5020,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
   };
   /**
-   * 방문 분석 — 스코프 `analytics:r`. 스토어프런트가 `@sayren/storefront-sdk`로 수집한 이벤트를 Asia/Seoul 날짜별로
+   * 방문 분석 — 스코프 `analytics:r`. 스토어프론트가 `@sayren/storefront-sdk`로 수집한 이벤트를 Asia/Seoul 날짜별로
    * 집계한 값이다. 집계는 주기적으로 갱신되고 응답 `lastComputedAt`이 마지막 집계 시각이다. 봇 세션은 빠진다.
    * 기간은 양끝 포함 최대 92일이고, 테스트 결제 구매는 `includeTest: "true"`일 때만 포함한다.
    */
@@ -5934,13 +6144,14 @@ export declare function createStoreClient(options: StoreClientOptions): {
       businessNumber: string | null;
       customerCenterPhone: string | null;
       analyticsAllowedOrigins: string[];
+      storefrontOrigins: string[];
       guestCheckoutEnabled: boolean;
       memberCount: number;
       createdAt: string;
     }>;
     /**
      * `PATCH /v1/store` — 스코프 `store:rw`. 바꿀 필드만 보낸다. `analyticsAllowedOrigins`는 방문 분석 수집을 받을
-     * 스토어프런트 오리진 목록이다(빈 배열이면 모든 오리진 허용).
+     * 스토어프론트 오리진 목록이다(빈 배열이면 모든 오리진 허용).
      */
     update: (body: UpdateStoreRequest) => Promise<{
       storeId: string;
@@ -5952,6 +6163,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       businessNumber: string | null;
       customerCenterPhone: string | null;
       analyticsAllowedOrigins: string[];
+      storefrontOrigins: string[];
       guestCheckoutEnabled: boolean;
       memberCount: number;
       createdAt: string;

package/dist/index.mjs

@@ -150,7 +150,7 @@ function createHttp(options) {
 /**
 * 방문 분석 조회 (관리 API `/v1/analytics/*`, 스코프 `analytics:r`).
 *
-* 스토어프런트가 `@sayren/storefront-sdk`로 수집한 이벤트를 서버가 날짜(Asia/Seoul)별로 집계한 값이다. 집계는 주기적으로
+* 스토어프론트가 `@sayren/storefront-sdk`로 수집한 이벤트를 서버가 날짜(Asia/Seoul)별로 집계한 값이다. 집계는 주기적으로
 * 갱신되므로 오늘 값은 `lastComputedAt` 시점까지 반영돼 있다. 봇·자동화 브라우저의 세션은 모든 집계에서 빠진다.
 */
 const reportDate$1 = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "날짜 형식은 YYYY-MM-DD 입니다");
@@ -654,12 +654,16 @@ const claimSchema = z.object({
 		trackingNumber: z.string().nullable()
 	}).nullable(),
 	requestedAt: z.string(),
-	completedAt: z.string().nullable()
+	completedAt: z.string().nullable(),
+	/** 보류 중이면 자동 해제 시각(ISO 8601), 아니면 null */
+	holdExpiresAt: z.string().nullable(),
+	/** 보류를 이미 썼는지 — 보류는 클레임당 1회라 해제·만료 뒤에도 true */
+	holdUsed: z.boolean()
 });
 /** `GET /v1/claims` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
 const claimListQuerySchema = z.object({
 	type: claimTypeSchema.optional().describe("클레임 유형 필터"),
-	status: claimStatusSchema.optional().describe("클레임 상태 필터"),
+	status: z.string().optional().describe("클레임 상태 필터. 쉼표로 여러 개를 줄 수 있다 (예: `REQUESTED,HELD,COLLECTED`)"),
 	orderItemId: z.string().optional().describe("주문상품 id 필터"),
 	requestedFrom: z.string().optional().describe("요청 시각 조회 시작 (ISO 8601, 포함)"),
 	requestedTo: z.string().optional().describe("요청 시각 조회 끝 (ISO 8601, 포함)"),
@@ -726,7 +730,8 @@ const customerStatsSchema = z.object({
 const customerSummarySchema = z.object({
 	customerId: z.string(),
 	name: z.string(),
-	email: z.string(),
+	/** 소셜 가입에서 이메일을 받지 못했으면 null */
+	email: z.string().nullable(),
 	maskedPhone: z.string().nullable(),
 	joinedAt: z.string(),
 	point: z.number().int(),
@@ -746,12 +751,21 @@ const customerAddressSchema = z.object({
 const customerDetailSchema = z.object({
 	customerId: z.string(),
 	name: z.string(),
-	email: z.string(),
+	email: z.string().nullable(),
 	phone: z.string().nullable(),
 	joinedAt: z.string(),
 	point: z.number().int(),
 	marketingAgreed: z.boolean(),
-	loginMethods: z.array(z.enum(["password"])).describe("로그인 방법. 지금은 이메일·비밀번호(`password`)뿐이다"),
+	loginMethods: z.array(z.object({
+		method: z.enum([
+			"password",
+			"kakao",
+			"naver",
+			"google"
+		]),
+		/** 소셜 연결 시각. 비밀번호는 가입 시각 */
+		linkedAt: z.string()
+	})).describe("로그인 방법 — 이메일·비밀번호(`password`)와 연결된 소셜 계정"),
 	addresses: z.array(customerAddressSchema),
 	stats: customerStatsSchema.extend({
 		canceledOrReturnedCount: z.number().int().describe("취소된 주문 상품 + 완료된 반품 수"),
@@ -788,13 +802,60 @@ const withdrawCustomerRequestSchema = z.object({
 	]).describe("처리 사유 — 구매자 요청·장기 미이용·부정 이용·기타. 감사 로그에 남는다"),
 	memo: z.string().max(200).optional().describe("사유 보충(선택)")
 });
-/** `WITHDRAWAL_BLOCKED`의 `error.details` — 탈퇴를 막는 항목 수(스토어프런트 탈퇴와 같다) */
+/** `WITHDRAWAL_BLOCKED`의 `error.details` — 탈퇴를 막는 항목 수(스토어프론트 탈퇴와 같다) */
 const customerWithdrawalBlockedDetailsSchema = z.object({
 	inProgressOrderItems: z.number().int(),
 	openClaims: z.number().int(),
 	pendingPayments: z.number().int()
 });
 //#endregion
+//#region src/schemas/login.ts
+/** 소셜 로그인 공급자 */
+const loginProviderSchema = z.enum([
+	"kakao",
+	"naver",
+	"google"
+]);
+/** 공급자 연결 상태 — 비밀 값은 앞 4자리만 */
+const loginProviderStatusSchema = z.object({
+	provider: loginProviderSchema,
+	connected: z.boolean(),
+	/** 스토어프론트에서 사용 중인지. 연결 안 됐으면 false */
+	enabled: z.boolean(),
+	clientIdPrefix: z.string().nullable().describe("클라이언트 ID(카카오 REST API 키) 앞 4자리"),
+	secretPrefix: z.string().nullable(),
+	lastTestedAt: z.string().nullable(),
+	lastTestOk: z.boolean().nullable(),
+	linkedMemberCount: z.number().int().describe("이 공급자로 연결된 구매자 수"),
+	/** 이 공급자로만 로그인하는 구매자 수 — 연결을 해제하면 로그인할 방법이 없어진다 */
+	onlyMethodMemberCount: z.number().int(),
+	callbackUrl: z.url().describe("공급자 개발자 콘솔에 등록할 리디렉트 URI")
+});
+/** `GET /v1/store/login-settings` */
+const loginSettingsSchema = z.object({
+	passwordLoginEnabled: z.boolean(),
+	/** 비밀번호로만 로그인하는 구매자 수 — 이메일·비밀번호를 끄면 이들은 로그인할 수 없다 */
+	passwordOnlyMemberCount: z.number().int(),
+	storefrontOrigins: z.array(z.string()),
+	providers: z.array(loginProviderStatusSchema)
+});
+/** `PATCH /v1/store/login-settings` */
+const updateLoginSettingsRequestSchema = z.object({ passwordLoginEnabled: z.boolean() });
+/** `PUT /v1/store/auth-providers/{provider}` — 저장 전에 연결 테스트를 한다 */
+const saveLoginProviderRequestSchema = z.object({
+	clientId: z.string().trim().min(1).max(200),
+	clientSecret: z.string().trim().min(1).max(500)
+});
+/** `PATCH /v1/store/auth-providers/{provider}` */
+const updateLoginProviderRequestSchema = z.object({ enabled: z.boolean() });
+/** 연결 테스트 결과 */
+const loginProviderTestSchema = z.object({
+	ok: z.boolean(),
+	/** 실패 이유 — `INVALID_CLIENT`(키가 틀림)·`PROVIDER_UNAVAILABLE`(공급자 응답 없음) */
+	code: z.enum(["INVALID_CLIENT", "PROVIDER_UNAVAILABLE"]).nullable(),
+	testedAt: z.string()
+});
+//#endregion
 //#region src/schemas/misc.ts
 const inquirySchema = z.object({
 	inquiryId: z.string(),
@@ -1543,10 +1604,10 @@ const productSummarySchema = z.object({
 	productId: z.string(),
 	name: z.string(),
 	status: productStatusSchema,
-	salePrice: z.number().int(),
-	discountedPrice: z.number().int().nullable(),
+	salePrice: z.number().int().describe("판매가. 원(KRW) 단위 정수"),
+	discountedPrice: z.number().int().nullable().describe("즉시 할인 적용가. 원 단위. 할인이 없으면 null"),
 	/** usable variant 재고 합계 (서버 계산) */
-	stockQuantity: z.number().int(),
+	stockQuantity: z.number().int().describe("판매 가능한 옵션 재고의 합계. 서버가 계산한다"),
 	categoryId: z.string().nullable(),
 	thumbnailUrl: z.url().optional(),
 	/** optionGroups.length > 0 */
@@ -1683,8 +1744,8 @@ const variantStockSchema = z.object({
 const productCreateRequestSchema = z.object({
 	name: z.string().min(1).max(100),
 	categoryId: z.string().min(1, "카테고리를 선택해주세요"),
-	salePrice: z.number().int().min(10).multipleOf(10, "판매가는 10원 단위여야 합니다 (INVALID_PRICE_UNIT)"),
-	originalPrice: z.number().int().optional(),
+	salePrice: z.number().int().min(10).multipleOf(10, "판매가는 10원 단위여야 합니다 (INVALID_PRICE_UNIT)").describe("판매가. 원(KRW) 단위 정수, 최소 10원, 10원 단위"),
+	originalPrice: z.number().int().optional().describe("정가(할인 전 표시 가격). 원 단위"),
 	description: z.string().optional(),
 	/**
 	* 상세설명 에디터(@avarlabs/editor)의 직렬화 상태. 재편집 때 이 값으로 문서를 복원한다.
@@ -1696,11 +1757,11 @@ const productCreateRequestSchema = z.object({
 		attributeId: z.string(),
 		value: z.string()
 	})).optional(),
-	deliveryType: deliveryTypeSchema.default("PAID"),
-	deliveryFee: z.number().int().default(0),
-	conditionalFreeAmount: z.number().int().optional(),
-	returnFee: z.number().int().default(0),
-	exchangeFee: z.number().int().default(0),
+	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("교환 배송비. 원 단위"),
 	shippingAddressId: z.string().optional(),
 	returnAddressId: z.string().optional()
 }).extend(optionModelRequestSchema.shape);
@@ -1816,8 +1877,8 @@ function isWebOrigin(value) {
 		return false;
 	}
 }
-/** 방문 분석을 보낼 수 있는 스토어프런트 오리진 — 스킴·호스트(·포트)만. 서버가 소문자·끝 슬래시 제거로 정규화한다 */
-const analyticsOriginSchema = z.string().trim().max(255).refine(isWebOrigin, "https://shop.example.com 형식(경로 없이)으로 입력해 주세요").describe("스토어프런트 오리진. 예: `https://shop.example.com`");
+/** 방문 분석을 보낼 수 있는 스토어프론트 오리진 — 스킴·호스트(·포트)만. 서버가 소문자·끝 슬래시 제거로 정규화한다 */
+const analyticsOriginSchema = z.string().trim().max(255).refine(isWebOrigin, "https://shop.example.com 형식(경로 없이)으로 입력해 주세요").describe("스토어프론트 오리진. 예: `https://shop.example.com`");
 /** 허용 오리진 상한 */
 const MAX_ANALYTICS_ALLOWED_ORIGINS = 20;
 /** `PATCH /v1/store` 본문 — 바꿀 필드만 보낸다 */
@@ -1826,7 +1887,8 @@ const updateStoreRequestSchema = z.object({
 	logoUrl: z.url().optional(),
 	customerCenterPhone: z.string().optional(),
 	businessHours: z.string().max(100).optional(),
-	analyticsAllowedOrigins: z.array(analyticsOriginSchema).max(20).optional().describe("방문 분석 수집을 받을 스토어프런트 오리진(최대 20개). 비우면 모든 오리진에서 받는다. 넣으면 목록에 없는 오리진의 수집 요청은 403 `ORIGIN_NOT_ALLOWED`이고, 페이지 URL이 목록 밖인 이벤트는 버린다"),
+	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`다. 장바구니 담기와 이미 받은 비회원 주문의 조회·취소는 막지 않는다")
 }).refine((value) => Object.values(value).some((v) => v !== void 0), { message: "최소 1개 필드가 필요합니다" });
 const storeSchema = z.object({
@@ -1842,7 +1904,8 @@ const storeSchema = z.object({
 	logoUrl: z.url().nullable(),
 	businessNumber: z.string().nullable(),
 	customerCenterPhone: z.string().nullable(),
-	analyticsAllowedOrigins: z.array(z.string()).describe("방문 분석 수집을 받는 스토어프런트 오리진. 비어 있으면 모든 오리진에서 받는다"),
+	analyticsAllowedOrigins: z.array(z.string()).describe("방문 분석 수집을 받는 스토어프론트 오리진. 비어 있으면 모든 오리진에서 받는다"),
+	storefrontOrigins: z.array(z.string()).describe("스토어프론트 도메인 — 소셜 로그인 리디렉트와 방문 분석 수집이 함께 쓴다(`analyticsAllowedOrigins`와 같은 값)"),
 	guestCheckoutEnabled: z.boolean().describe("비회원 주문 허용. false면 회원만 주문할 수 있다"),
 	memberCount: z.number().int(),
 	createdAt: z.string()
@@ -2129,7 +2192,10 @@ function createStoreClient(options) {
 		},
 		carriers: { list: () => storeHttp.request("GET", "/carriers", z.array(carrierSchema)) },
 		claims: {
-			list: (params) => storeHttp.request("GET", "/claims", pageSchema(claimSchema), { query: params }),
+			list: (params) => storeHttp.request("GET", "/claims", pageSchema(claimSchema), { query: {
+				...params,
+				status: Array.isArray(params?.status) ? params.status.join(",") : params?.status
+			} }),
 			get: (claimId) => storeHttp.request("GET", path`/claims/${claimId}`, claimDetailSchema),
 			approve: (claimId, deductAmount, idempotencyKey) => storeHttp.request("POST", path`/claims/${claimId}/approve`, approveClaimResultSchema, {
 				body: deductAmount !== void 0 ? { deductAmount } : {},
@@ -2143,7 +2209,9 @@ function createStoreClient(options) {
 				trackingNumber
 			} }),
 			hold: (claimId, reason) => storeHttp.request("POST", path`/claims/${claimId}/hold`, claimHoldResultSchema, { body: { reason } }),
-			releaseHold: (claimId) => storeHttp.requestVoid("DELETE", path`/claims/${claimId}/hold`)
+			releaseHold: (claimId) => storeHttp.requestVoid("DELETE", path`/claims/${claimId}/hold`),
+			/** 교환 완료 — 재배송 중인 교환을 셀러가 명시적으로 끝낸다 */
+			completeExchange: (claimId) => storeHttp.request("POST", path`/claims/${claimId}/complete-exchange`, claimSchema)
 		},
 		inquiries: {
 			list: (params) => storeHttp.request("GET", "/inquiries", pageSchema(inquirySchema), { query: params }),
@@ -2151,6 +2219,19 @@ function createStoreClient(options) {
 			answer: (inquiryId, content) => storeHttp.requestVoid("POST", path`/inquiries/${inquiryId}/answer`, { body: { content } }),
 			updateAnswer: (inquiryId, content) => storeHttp.requestVoid("PUT", path`/inquiries/${inquiryId}/answer`, { body: { content } })
 		},
+		/**
+		* 구매자 로그인 설정 — 이메일·비밀번호 허용, 소셜 공급자 연결. 비밀 값을 다루므로 콘솔에 로그인한 OWNER만 호출할 수 있다
+		*/
+		loginSettings: {
+			get: () => storeHttp.request("GET", "/store/login-settings", loginSettingsSchema),
+			update: (body) => storeHttp.request("PATCH", "/store/login-settings", loginSettingsSchema, { body: updateLoginSettingsRequestSchema.parse(body) }),
+			/** 키 저장 — 저장 전에 연결 테스트를 하고, 실패하면 422 `LOGIN_PROVIDER_VERIFICATION_FAILED` */
+			saveProvider: (provider, body) => storeHttp.request("PUT", path`/store/auth-providers/${provider}`, loginSettingsSchema, { body: saveLoginProviderRequestSchema.parse(body) }),
+			setProviderEnabled: (provider, enabled) => storeHttp.request("PATCH", path`/store/auth-providers/${provider}`, loginSettingsSchema, { body: { enabled } }),
+			testProvider: (provider) => storeHttp.request("POST", path`/store/auth-providers/${provider}/test`, loginProviderTestSchema),
+			/** 연결 해제 — 키를 지운다. 연결된 구매자 계정은 남는다 */
+			removeProvider: (provider) => storeHttp.request("DELETE", path`/store/auth-providers/${provider}`, loginSettingsSchema)
+		},
 		/** 구매자 관리 — 조회 `customer:r`, 탈퇴 처리 `customer:rw`(콘솔 OWNER·ADMIN) */
 		customers: {
 			list: (params) => storeHttp.request("GET", "/customers", pageSchema(customerSummarySchema), { query: params }),
@@ -2186,7 +2267,7 @@ function createStoreClient(options) {
 		*/
 get: (params) => storeHttp.request("GET", "/sales-report", salesReportSchema, { query: salesReportQuerySchema.parse(params) }) },
 		/**
-		* 방문 분석 — 스코프 `analytics:r`. 스토어프런트가 `@sayren/storefront-sdk`로 수집한 이벤트를 Asia/Seoul 날짜별로
+		* 방문 분석 — 스코프 `analytics:r`. 스토어프론트가 `@sayren/storefront-sdk`로 수집한 이벤트를 Asia/Seoul 날짜별로
 		* 집계한 값이다. 집계는 주기적으로 갱신되고 응답 `lastComputedAt`이 마지막 집계 시각이다. 봇 세션은 빠진다.
 		* 기간은 양끝 포함 최대 92일이고, 테스트 결제 구매는 `includeTest: "true"`일 때만 포함한다.
 		*/
@@ -2342,7 +2423,7 @@ get: (params) => storeHttp.request("GET", "/sales-report", salesReportSchema, {
 			get: () => storeHttp.request("GET", "/store", storeSchema),
 			/**
 			* `PATCH /v1/store` — 스코프 `store:rw`. 바꿀 필드만 보낸다. `analyticsAllowedOrigins`는 방문 분석 수집을 받을
-			* 스토어프런트 오리진 목록이다(빈 배열이면 모든 오리진 허용).
+			* 스토어프론트 오리진 목록이다(빈 배열이면 모든 오리진 허용).
 			*/
 			update: (body) => storeHttp.request("PATCH", "/store", storeSchema, { body: updateStoreRequestSchema.parse(body) }),
 			listMembers: () => storeHttp.request("GET", "/store/members", z.array(storeMemberSchema)),
@@ -2731,4 +2812,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, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, 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, effectivePaymentRoutingModeSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationListQuerySchema, invitationSchema, isReservedStoreCode, isStoreScope, isWebOrigin, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, 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, paymentRoutingModeSchema, 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, scopeAccessSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, tossPaymentsCredentialsInputSchema, trackingUpdateResultSchema, 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_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, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, 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, effectivePaymentRoutingModeSchema, 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, paymentRoutingModeSchema, 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 };

package/package.json

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

package/src/client.ts

@@ -60,6 +60,15 @@ import {
   type WithdrawCustomerRequest,
   withdrawCustomerRequestSchema,
 } from "./schemas/customer";
+import {
+  type LoginProvider,
+  loginProviderTestSchema,
+  loginSettingsSchema,
+  type SaveLoginProviderRequest,
+  saveLoginProviderRequestSchema,
+  type UpdateLoginSettingsRequest,
+  updateLoginSettingsRequestSchema,
+} from "./schemas/login";
 import {
   type CustomerInquiryCategory,
   inquirySchema,
@@ -524,7 +533,12 @@ export function createStoreClient(options: StoreClientOptions) {
 
     claims: {
       list: (params?: ClaimListParams) =>
-        storeHttp.request("GET", "/claims", pageSchema(claimSchema), { query: params as Query }),
+        storeHttp.request("GET", "/claims", pageSchema(claimSchema), {
+          query: {
+            ...params,
+            status: Array.isArray(params?.status) ? params.status.join(",") : params?.status,
+          } as Query,
+        }),
       get: (claimId: string) =>
         storeHttp.request("GET", path`/claims/${claimId}`, claimDetailSchema),
       approve: (claimId: string, deductAmount?: number, idempotencyKey?: string) =>
@@ -552,6 +566,9 @@ export function createStoreClient(options: StoreClientOptions) {
         }),
       releaseHold: (claimId: string) =>
         storeHttp.requestVoid("DELETE", path`/claims/${claimId}/hold`),
+      /** 교환 완료 — 재배송 중인 교환을 셀러가 명시적으로 끝낸다 */
+      completeExchange: (claimId: string) =>
+        storeHttp.request("POST", path`/claims/${claimId}/complete-exchange`, claimSchema),
     },
 
     inquiries: {
@@ -567,6 +584,35 @@ export function createStoreClient(options: StoreClientOptions) {
         storeHttp.requestVoid("PUT", path`/inquiries/${inquiryId}/answer`, { body: { content } }),
     },
 
+    /**
+     * 구매자 로그인 설정 — 이메일·비밀번호 허용, 소셜 공급자 연결. 비밀 값을 다루므로 콘솔에 로그인한 OWNER만 호출할 수 있다
+     */
+    loginSettings: {
+      get: () => storeHttp.request("GET", "/store/login-settings", loginSettingsSchema),
+      update: (body: UpdateLoginSettingsRequest) =>
+        storeHttp.request("PATCH", "/store/login-settings", loginSettingsSchema, {
+          body: updateLoginSettingsRequestSchema.parse(body),
+        }),
+      /** 키 저장 — 저장 전에 연결 테스트를 하고, 실패하면 422 `LOGIN_PROVIDER_VERIFICATION_FAILED` */
+      saveProvider: (provider: LoginProvider, body: SaveLoginProviderRequest) =>
+        storeHttp.request("PUT", path`/store/auth-providers/${provider}`, loginSettingsSchema, {
+          body: saveLoginProviderRequestSchema.parse(body),
+        }),
+      setProviderEnabled: (provider: LoginProvider, enabled: boolean) =>
+        storeHttp.request("PATCH", path`/store/auth-providers/${provider}`, loginSettingsSchema, {
+          body: { enabled },
+        }),
+      testProvider: (provider: LoginProvider) =>
+        storeHttp.request(
+          "POST",
+          path`/store/auth-providers/${provider}/test`,
+          loginProviderTestSchema,
+        ),
+      /** 연결 해제 — 키를 지운다. 연결된 구매자 계정은 남는다 */
+      removeProvider: (provider: LoginProvider) =>
+        storeHttp.request("DELETE", path`/store/auth-providers/${provider}`, loginSettingsSchema),
+    },
+
     /** 구매자 관리 — 조회 `customer:r`, 탈퇴 처리 `customer:rw`(콘솔 OWNER·ADMIN) */
     customers: {
       list: (
@@ -653,7 +699,7 @@ export function createStoreClient(options: StoreClientOptions) {
     },
 
     /**
-     * 방문 분석 — 스코프 `analytics:r`. 스토어프런트가 `@sayren/storefront-sdk`로 수집한 이벤트를 Asia/Seoul 날짜별로
+     * 방문 분석 — 스코프 `analytics:r`. 스토어프론트가 `@sayren/storefront-sdk`로 수집한 이벤트를 Asia/Seoul 날짜별로
      * 집계한 값이다. 집계는 주기적으로 갱신되고 응답 `lastComputedAt`이 마지막 집계 시각이다. 봇 세션은 빠진다.
      * 기간은 양끝 포함 최대 92일이고, 테스트 결제 구매는 `includeTest: "true"`일 때만 포함한다.
      */
@@ -906,7 +952,7 @@ export function createStoreClient(options: StoreClientOptions) {
       get: () => storeHttp.request("GET", "/store", storeSchema),
       /**
        * `PATCH /v1/store` — 스코프 `store:rw`. 바꿀 필드만 보낸다. `analyticsAllowedOrigins`는 방문 분석 수집을 받을
-       * 스토어프런트 오리진 목록이다(빈 배열이면 모든 오리진 허용).
+       * 스토어프론트 오리진 목록이다(빈 배열이면 모든 오리진 허용).
        */
       update: (body: UpdateStoreRequest) =>
         storeHttp.request("PATCH", "/store", storeSchema, {

package/src/index.ts

@@ -19,6 +19,7 @@ export * from "./schemas/category";
 export * from "./schemas/claim";
 export * from "./schemas/common";
 export * from "./schemas/customer";
+export * from "./schemas/login";
 export * from "./schemas/misc";
 export * from "./schemas/order";
 export * from "./schemas/payment";

package/src/schemas/analytics.ts

@@ -3,7 +3,7 @@ import { z } from "zod";
 /**
  * 방문 분석 조회 (관리 API `/v1/analytics/*`, 스코프 `analytics:r`).
  *
- * 스토어프런트가 `@sayren/storefront-sdk`로 수집한 이벤트를 서버가 날짜(Asia/Seoul)별로 집계한 값이다. 집계는 주기적으로
+ * 스토어프론트가 `@sayren/storefront-sdk`로 수집한 이벤트를 서버가 날짜(Asia/Seoul)별로 집계한 값이다. 집계는 주기적으로
  * 갱신되므로 오늘 값은 `lastComputedAt` 시점까지 반영돼 있다. 봇·자동화 브라우저의 세션은 모든 집계에서 빠진다.
  */
 

package/src/schemas/claim.ts

@@ -53,13 +53,18 @@ export const claimSchema = z.object({
     .nullable(),
   requestedAt: z.string(),
   completedAt: z.string().nullable(),
+  /** 보류 중이면 자동 해제 시각(ISO 8601), 아니면 null */
+  holdExpiresAt: z.string().nullable(),
+  /** 보류를 이미 썼는지 — 보류는 클레임당 1회라 해제·만료 뒤에도 true */
+  holdUsed: z.boolean(),
 });
 
 export type Claim = z.infer<typeof claimSchema>;
 
 export interface ClaimListParams extends PageParams {
   type?: ClaimType;
-  status?: ClaimStatus;
+  /** 여러 상태를 한 번에 거를 수 있다(처리 대기 목록 등) */
+  status?: ClaimStatus | ClaimStatus[];
   orderItemId?: string;
   requestedFrom?: string;
   requestedTo?: string;
@@ -68,7 +73,10 @@ export interface ClaimListParams extends PageParams {
 /** `GET /v1/claims` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
 export const claimListQuerySchema = z.object({
   type: claimTypeSchema.optional().describe("클레임 유형 필터"),
-  status: claimStatusSchema.optional().describe("클레임 상태 필터"),
+  status: z
+    .string()
+    .optional()
+    .describe("클레임 상태 필터. 쉼표로 여러 개를 줄 수 있다 (예: `REQUESTED,HELD,COLLECTED`)"),
   orderItemId: z.string().optional().describe("주문상품 id 필터"),
   requestedFrom: z.string().optional().describe("요청 시각 조회 시작 (ISO 8601, 포함)"),
   requestedTo: z.string().optional().describe("요청 시각 조회 끝 (ISO 8601, 포함)"),

package/src/schemas/customer.ts

@@ -37,7 +37,8 @@ export const customerSummarySchema = z
   .object({
     customerId: z.string(),
     name: z.string(),
-    email: z.string(),
+    /** 소셜 가입에서 이메일을 받지 못했으면 null */
+    email: z.string().nullable(),
     maskedPhone: z.string().nullable(),
     joinedAt: z.string(),
     point: z.number().int(),
@@ -61,14 +62,20 @@ export const customerAddressSchema = z.object({
 export const customerDetailSchema = z.object({
   customerId: z.string(),
   name: z.string(),
-  email: z.string(),
+  email: z.string().nullable(),
   phone: z.string().nullable(),
   joinedAt: z.string(),
   point: z.number().int(),
   marketingAgreed: z.boolean(),
   loginMethods: z
-    .array(z.enum(["password"]))
-    .describe("로그인 방법. 지금은 이메일·비밀번호(`password`)뿐이다"),
+    .array(
+      z.object({
+        method: z.enum(["password", "kakao", "naver", "google"]),
+        /** 소셜 연결 시각. 비밀번호는 가입 시각 */
+        linkedAt: z.string(),
+      }),
+    )
+    .describe("로그인 방법 — 이메일·비밀번호(`password`)와 연결된 소셜 계정"),
   addresses: z.array(customerAddressSchema),
   stats: customerStatsSchema.extend({
     canceledOrReturnedCount: z.number().int().describe("취소된 주문 상품 + 완료된 반품 수"),
@@ -108,7 +115,7 @@ export const withdrawCustomerRequestSchema = z.object({
 });
 export type WithdrawCustomerRequest = z.infer<typeof withdrawCustomerRequestSchema>;
 
-/** `WITHDRAWAL_BLOCKED`의 `error.details` — 탈퇴를 막는 항목 수(스토어프런트 탈퇴와 같다) */
+/** `WITHDRAWAL_BLOCKED`의 `error.details` — 탈퇴를 막는 항목 수(스토어프론트 탈퇴와 같다) */
 export const customerWithdrawalBlockedDetailsSchema = z.object({
   inProgressOrderItems: z.number().int(),
   openClaims: z.number().int(),

package/src/schemas/login.ts

@@ -0,0 +1,59 @@
+import { z } from "zod";
+
+/** 소셜 로그인 공급자 */
+export const loginProviderSchema = z.enum(["kakao", "naver", "google"]);
+export type LoginProvider = z.infer<typeof loginProviderSchema>;
+
+/** 공급자 연결 상태 — 비밀 값은 앞 4자리만 */
+export const loginProviderStatusSchema = z.object({
+  provider: loginProviderSchema,
+  connected: z.boolean(),
+  /** 스토어프론트에서 사용 중인지. 연결 안 됐으면 false */
+  enabled: z.boolean(),
+  clientIdPrefix: z.string().nullable().describe("클라이언트 ID(카카오 REST API 키) 앞 4자리"),
+  secretPrefix: z.string().nullable(),
+  lastTestedAt: z.string().nullable(),
+  lastTestOk: z.boolean().nullable(),
+  linkedMemberCount: z.number().int().describe("이 공급자로 연결된 구매자 수"),
+  /** 이 공급자로만 로그인하는 구매자 수 — 연결을 해제하면 로그인할 방법이 없어진다 */
+  onlyMethodMemberCount: z.number().int(),
+  callbackUrl: z.url().describe("공급자 개발자 콘솔에 등록할 리디렉트 URI"),
+});
+export type LoginProviderStatus = z.infer<typeof loginProviderStatusSchema>;
+
+/** `GET /v1/store/login-settings` */
+export const loginSettingsSchema = z.object({
+  passwordLoginEnabled: z.boolean(),
+  /** 비밀번호로만 로그인하는 구매자 수 — 이메일·비밀번호를 끄면 이들은 로그인할 수 없다 */
+  passwordOnlyMemberCount: z.number().int(),
+  storefrontOrigins: z.array(z.string()),
+  providers: z.array(loginProviderStatusSchema),
+});
+export type LoginSettings = z.infer<typeof loginSettingsSchema>;
+
+/** `PATCH /v1/store/login-settings` */
+export const updateLoginSettingsRequestSchema = z.object({
+  passwordLoginEnabled: z.boolean(),
+});
+export type UpdateLoginSettingsRequest = z.infer<typeof updateLoginSettingsRequestSchema>;
+
+/** `PUT /v1/store/auth-providers/{provider}` — 저장 전에 연결 테스트를 한다 */
+export const saveLoginProviderRequestSchema = z.object({
+  clientId: z.string().trim().min(1).max(200),
+  clientSecret: z.string().trim().min(1).max(500),
+});
+export type SaveLoginProviderRequest = z.infer<typeof saveLoginProviderRequestSchema>;
+
+/** `PATCH /v1/store/auth-providers/{provider}` */
+export const updateLoginProviderRequestSchema = z.object({
+  enabled: z.boolean(),
+});
+
+/** 연결 테스트 결과 */
+export const loginProviderTestSchema = z.object({
+  ok: z.boolean(),
+  /** 실패 이유 — `INVALID_CLIENT`(키가 틀림)·`PROVIDER_UNAVAILABLE`(공급자 응답 없음) */
+  code: z.enum(["INVALID_CLIENT", "PROVIDER_UNAVAILABLE"]).nullable(),
+  testedAt: z.string(),
+});
+export type LoginProviderTest = z.infer<typeof loginProviderTestSchema>;

package/src/schemas/product.ts

@@ -13,10 +13,14 @@ export const productSummarySchema = z.object({
   productId: z.string(),
   name: z.string(),
   status: productStatusSchema,
-  salePrice: z.number().int(),
-  discountedPrice: z.number().int().nullable(),
+  salePrice: z.number().int().describe("판매가. 원(KRW) 단위 정수"),
+  discountedPrice: z
+    .number()
+    .int()
+    .nullable()
+    .describe("즉시 할인 적용가. 원 단위. 할인이 없으면 null"),
   /** usable variant 재고 합계 (서버 계산) */
-  stockQuantity: z.number().int(),
+  stockQuantity: z.number().int().describe("판매 가능한 옵션 재고의 합계. 서버가 계산한다"),
   categoryId: z.string().nullable(),
   thumbnailUrl: z.url().optional(),
   /** optionGroups.length > 0 */
@@ -199,8 +203,9 @@ export const productCreateRequestSchema = z
       .number()
       .int()
       .min(10)
-      .multipleOf(10, "판매가는 10원 단위여야 합니다 (INVALID_PRICE_UNIT)"),
-    originalPrice: z.number().int().optional(),
+      .multipleOf(10, "판매가는 10원 단위여야 합니다 (INVALID_PRICE_UNIT)")
+      .describe("판매가. 원(KRW) 단위 정수, 최소 10원, 10원 단위"),
+    originalPrice: z.number().int().optional().describe("정가(할인 전 표시 가격). 원 단위"),
     description: z.string().optional(),
     /**
      * 상세설명 에디터(@avarlabs/editor)의 직렬화 상태. 재편집 때 이 값으로 문서를 복원한다.
@@ -209,11 +214,17 @@ export const productCreateRequestSchema = z
     descriptionJson: z.string().nullable().optional(),
     images: z.array(z.url()).min(1).max(10).optional(),
     attributes: z.array(z.object({ attributeId: z.string(), value: z.string() })).optional(),
-    deliveryType: deliveryTypeSchema.default("PAID"),
-    deliveryFee: z.number().int().default(0),
-    conditionalFreeAmount: z.number().int().optional(),
-    returnFee: z.number().int().default(0),
-    exchangeFee: z.number().int().default(0),
+    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("교환 배송비. 원 단위"),
     shippingAddressId: z.string().optional(),
     returnAddressId: z.string().optional(),
   })

package/src/schemas/store.ts

@@ -91,13 +91,13 @@ export function isWebOrigin(value: string): boolean {
   }
 }
 
-/** 방문 분석을 보낼 수 있는 스토어프런트 오리진 — 스킴·호스트(·포트)만. 서버가 소문자·끝 슬래시 제거로 정규화한다 */
+/** 방문 분석을 보낼 수 있는 스토어프론트 오리진 — 스킴·호스트(·포트)만. 서버가 소문자·끝 슬래시 제거로 정규화한다 */
 export const analyticsOriginSchema = z
   .string()
   .trim()
   .max(255)
   .refine(isWebOrigin, "https://shop.example.com 형식(경로 없이)으로 입력해 주세요")
-  .describe("스토어프런트 오리진. 예: `https://shop.example.com`");
+  .describe("스토어프론트 오리진. 예: `https://shop.example.com`");
 
 /** 허용 오리진 상한 */
 export const MAX_ANALYTICS_ALLOWED_ORIGINS = 20;
@@ -114,9 +114,17 @@ export const updateStoreRequestSchema = z
       .max(MAX_ANALYTICS_ALLOWED_ORIGINS)
       .optional()
       .describe(
-        "방문 분석 수집을 받을 스토어프런트 오리진(최대 20개). 비우면 모든 오리진에서 받는다. " +
+        "@deprecated `storefrontOrigins`를 쓴다(같은 목록). 방문 분석 수집을 받을 스토어프론트 오리진(최대 20개). 비우면 모든 오리진에서 받는다. " +
           "넣으면 목록에 없는 오리진의 수집 요청은 403 `ORIGIN_NOT_ALLOWED`이고, 페이지 URL이 목록 밖인 이벤트는 버린다",
       ),
+    storefrontOrigins: z
+      .array(analyticsOriginSchema)
+      .max(MAX_ANALYTICS_ALLOWED_ORIGINS)
+      .optional()
+      .describe(
+        "스토어프론트 도메인(최대 20개) — 소셜 로그인 뒤 돌아갈 주소와 방문 분석 수집을 함께 제한한다. " +
+          "`analyticsAllowedOrigins`와 같은 목록이다(둘 다 주면 이 값이 이긴다)",
+      ),
     guestCheckoutEnabled: z
       .boolean()
       .optional()
@@ -141,7 +149,12 @@ export const storeSchema = z.object({
   customerCenterPhone: z.string().nullable(),
   analyticsAllowedOrigins: z
     .array(z.string())
-    .describe("방문 분석 수집을 받는 스토어프런트 오리진. 비어 있으면 모든 오리진에서 받는다"),
+    .describe("방문 분석 수집을 받는 스토어프론트 오리진. 비어 있으면 모든 오리진에서 받는다"),
+  storefrontOrigins: z
+    .array(z.string())
+    .describe(
+      "스토어프론트 도메인 — 소셜 로그인 리디렉트와 방문 분석 수집이 함께 쓴다(`analyticsAllowedOrigins`와 같은 값)",
+    ),
   guestCheckoutEnabled: z.boolean().describe("비회원 주문 허용. false면 회원만 주문할 수 있다"),
   memberCount: z.number().int(),
   createdAt: z.string(),