@sayren/storefront-sdk 0.3.0 → 0.4.0

package/dist/auth/index.d.mts

@@ -1,4 +1,4 @@
-import { a as AnonymousSession, c as TokenPair, o as LoginRequest, s as SignupRequest, t as ApiError } from "../http-DWaRhLfG.mjs";
+import { a as AnonymousSession, c as TokenPair, l as WithdrawRequest, o as LoginRequest, s as SignupRequest, t as ApiError, u as WithdrawalBlockedDetails } from "../http-CxqZxTfE.mjs";
 //#region src/auth/index.d.ts
 export interface StorefrontAuthOptions {
   /** 예: https://api.sayren.app/storefront/v1 */
@@ -37,7 +37,13 @@ export declare function createStorefrontAuth(options: StorefrontAuthOptions): {
    * 액세스 토큰이 이미 만료됐으면(401) 서버에서 할 일이 없으므로 성공으로 본다.
    */
   signOut(accessToken: string): Promise<void>;
+  /**
+   * 구매자 탈퇴 — 계정·배송지·위시리스트·장바구니·적립금을 지우고 토큰을 모두 무효로 만든다. 되돌릴 수 없다.
+   * 주문·리뷰·문의 기록은 스토어가 보관한다. 진행 중인 주문이나 처리 중인 클레임이 있으면
+   * 409 `WITHDRAWAL_BLOCKED`(`error.details`: `WithdrawalBlockedDetails`)다. 앱은 성공 후 보관한 토큰을 지운다.
+   */
+  withdraw(accessToken: string, body: WithdrawRequest): Promise<void>;
 };
 export type StorefrontAuth = ReturnType<typeof createStorefrontAuth>;
 //#endregion
-export { type AnonymousSession, ApiError, type LoginRequest, type SignupRequest, type TokenPair };
+export { type AnonymousSession, ApiError, type LoginRequest, type SignupRequest, type TokenPair, type WithdrawRequest, type WithdrawalBlockedDetails };

package/dist/auth/index.mjs

@@ -1,4 +1,4 @@
-import { t as createStorefrontClient, tt as ApiError } from "../client-Xb-2tNKT.mjs";
+import { rt as ApiError, t as createStorefrontClient } from "../client-DHISrvXq.mjs";
 //#region src/auth/index.ts
 /**
 * 구매자 인증 — 화면은 스토어프런트가 그리고, 계정 저장과 인증 처리는 sayren이 한다.
@@ -51,6 +51,14 @@ function createStorefrontAuth(options) {
 				if (error instanceof ApiError && error.status === 401) return;
 				throw error;
 			}
+		},
+		/**
+		* 구매자 탈퇴 — 계정·배송지·위시리스트·장바구니·적립금을 지우고 토큰을 모두 무효로 만든다. 되돌릴 수 없다.
+		* 주문·리뷰·문의 기록은 스토어가 보관한다. 진행 중인 주문이나 처리 중인 클레임이 있으면
+		* 409 `WITHDRAWAL_BLOCKED`(`error.details`: `WithdrawalBlockedDetails`)다. 앱은 성공 후 보관한 토큰을 지운다.
+		*/
+		withdraw(accessToken, body) {
+			return client(accessToken).auth.withdraw(body);
 		}
 	};
 }

package/dist/{client-Xb-2tNKT.mjs → client-DHISrvXq.mjs}

@@ -150,6 +150,21 @@ const anonymousSessionSchema = z.object({
 	/** 이 시각까지 활동이 없으면 만료(ISO 8601). 쓸 때마다 늘어난다 */
 	expiresAt: z.string()
 });
+/**
+* 구매자 탈퇴 — `POST /auth/withdraw`. 본인 확인으로 비밀번호를 다시 받는다.
+* 진행 중인 주문(결제 대기~배송 중)·클레임·결제가 있으면 409 `WITHDRAWAL_BLOCKED`, 비밀번호가 틀리면
+* 403 `PASSWORD_MISMATCH`다(로그인과 같은 5회 잠금).
+*/
+const withdrawRequestSchema = z.object({ password: z.string().min(1) });
+/** `WITHDRAWAL_BLOCKED`의 `error.details` — 탈퇴를 막는 항목 수 */
+const withdrawalBlockedDetailsSchema = z.object({
+	/** 결제 대기~배송 중인 주문 상품 */
+	inProgressOrderItems: z.number().int(),
+	/** 처리 중인 취소·반품·교환 */
+	openClaims: z.number().int(),
+	/** 승인 중이거나 결제창이 열려 있을 수 있는 결제(결제창은 만료되면 풀린다) */
+	pendingPayments: z.number().int()
+});
 //#endregion
 //#region src/schemas/cart.ts
 const cartItemSchema = z.object({
@@ -679,7 +694,9 @@ function createStorefrontClient(options) {
 			signup: (body) => http.request("POST", "/auth/signup", tokenPairSchema, { body: signupRequestSchema.parse(body) }),
 			login: (body) => http.request("POST", "/auth/login", tokenPairSchema, { body: loginRequestSchema.parse(body) }),
 			refresh: (refreshToken) => http.request("POST", "/auth/token/refresh", tokenPairSchema, { body: { refreshToken } }),
-			logout: () => http.requestVoid("POST", "/auth/logout")
+			logout: () => http.requestVoid("POST", "/auth/logout"),
+			/** 구매자 탈퇴 — 로그인 상태(accessToken)에서 비밀번호로 본인 확인. 성공하면 토큰은 모두 무효 */
+			withdraw: (body) => http.requestVoid("POST", "/auth/withdraw", { body: withdrawRequestSchema.parse(body) })
 		},
 		catalog: {
 			listCategories: () => http.request("GET", "/categories", z.array(categoryNodeSchema)),
@@ -773,4 +790,4 @@ getStatus: (paymentId) => http.request("GET", path`/payments/${paymentId}`, paym
 	};
 }
 //#endregion
-export { signupRequestSchema as $, PAYMENT_STATUS_VALUES as A, requestPaymentRequestSchema as B, createClaimRequestSchema as C, orderItemStatusSchema as D, claimStatusSchema as E, guestInfoSchema as F, productFacetsSchema as G, categoryNodeSchema as H, paymentMethodSchema as I, cartItemSchema as J, productSortSchema as K, paymentParamsSchema as L, confirmPaymentRequestSchema as M, confirmPaymentResultSchema as N, pageInfoSchema as O, createCheckoutRequestSchema as P, loginRequestSchema as Q, paymentStatusSchema as R, claimTypeSchema as S, myClaimSchema as T, productCardSchema as U, shippingAddressInputSchema as V, productDetailSchema as W, updateCartItemRequestSchema as X, cartSchema as Y, anonymousSessionSchema as Z, publicInquirySchema as _, reviewSummarySchema as a, customerInquirySchema as b, deliveryTrackingSchema as c, orderShippingAddressSchema as d, tokenPairSchema as et, memberAddressRequestSchema as f, createInquiryRequestSchema as g, updateProfileRequestSchema as h, publicReviewSchema as i, unwrapData as it, checkoutSessionSchema as j, pageSchema as k, myOrderItemSchema as l, memberSchema as m, createReviewRequestSchema as n, buildQuery as nt, updateReviewRequestSchema as o, memberAddressSchema as p, addCartItemRequestSchema as q, createReviewResultSchema as r, toApiError as rt, writableReviewSchema as s, createStorefrontClient as t, ApiError as tt, myOrderSchema as u, createCustomerInquiryRequestSchema as v, createClaimResultSchema as w, claimReasonSchema as x, customerInquiryCategorySchema as y, pgParamsSchema as z };
+export { signupRequestSchema as $, PAYMENT_STATUS_VALUES as A, requestPaymentRequestSchema as B, createClaimRequestSchema as C, orderItemStatusSchema as D, claimStatusSchema as E, guestInfoSchema as F, productFacetsSchema as G, categoryNodeSchema as H, paymentMethodSchema as I, cartItemSchema as J, productSortSchema as K, paymentParamsSchema as L, confirmPaymentRequestSchema as M, confirmPaymentResultSchema as N, pageInfoSchema as O, createCheckoutRequestSchema as P, loginRequestSchema as Q, paymentStatusSchema as R, claimTypeSchema as S, myClaimSchema as T, productCardSchema as U, shippingAddressInputSchema as V, productDetailSchema as W, updateCartItemRequestSchema as X, cartSchema as Y, anonymousSessionSchema as Z, publicInquirySchema as _, reviewSummarySchema as a, toApiError as at, customerInquirySchema as b, deliveryTrackingSchema as c, orderShippingAddressSchema as d, tokenPairSchema as et, memberAddressRequestSchema as f, createInquiryRequestSchema as g, updateProfileRequestSchema as h, publicReviewSchema as i, buildQuery as it, checkoutSessionSchema as j, pageSchema as k, myOrderItemSchema as l, memberSchema as m, createReviewRequestSchema as n, withdrawalBlockedDetailsSchema as nt, updateReviewRequestSchema as o, unwrapData as ot, memberAddressSchema as p, addCartItemRequestSchema as q, createReviewResultSchema as r, ApiError as rt, writableReviewSchema as s, createStorefrontClient as t, withdrawRequestSchema as tt, myOrderSchema as u, createCustomerInquiryRequestSchema as v, createClaimResultSchema as w, claimReasonSchema as x, customerInquiryCategorySchema as y, pgParamsSchema as z };

package/dist/{http-DWaRhLfG.d.mts → http-CxqZxTfE.d.mts}

@@ -35,6 +35,22 @@ declare const anonymousSessionSchema: z.ZodObject<{
   expiresAt: z.ZodString;
 }, z.core.$strip>;
 type AnonymousSession = z.infer<typeof anonymousSessionSchema>;
+/**
+ * 구매자 탈퇴 — `POST /auth/withdraw`. 본인 확인으로 비밀번호를 다시 받는다.
+ * 진행 중인 주문(결제 대기~배송 중)·클레임·결제가 있으면 409 `WITHDRAWAL_BLOCKED`, 비밀번호가 틀리면
+ * 403 `PASSWORD_MISMATCH`다(로그인과 같은 5회 잠금).
+ */
+declare const withdrawRequestSchema: z.ZodObject<{
+  password: z.ZodString;
+}, z.core.$strip>;
+type WithdrawRequest = z.infer<typeof withdrawRequestSchema>;
+/** `WITHDRAWAL_BLOCKED`의 `error.details` — 탈퇴를 막는 항목 수 */
+declare const withdrawalBlockedDetailsSchema: z.ZodObject<{
+  inProgressOrderItems: z.ZodNumber;
+  openClaims: z.ZodNumber;
+  pendingPayments: z.ZodNumber;
+}, z.core.$strip>;
+type WithdrawalBlockedDetails = z.infer<typeof withdrawalBlockedDetailsSchema>;
 //#endregion
 //#region src/http.d.ts
 declare class ApiError extends Error {
@@ -52,4 +68,4 @@ type TokenSource = string | null | undefined | (() => string | null | undefined)
 type Query = Record<string, string | number | boolean | undefined>;
 declare function buildQuery(query?: Query): string;
 //#endregion
-export { AnonymousSession as a, TokenPair as c, signupRequestSchema as d, tokenPairSchema as f, buildQuery as i, anonymousSessionSchema as l, Query as n, LoginRequest as o, TokenSource as r, SignupRequest as s, ApiError as t, loginRequestSchema as u };
+export { AnonymousSession as a, TokenPair as c, anonymousSessionSchema as d, loginRequestSchema as f, withdrawalBlockedDetailsSchema as g, withdrawRequestSchema as h, buildQuery as i, WithdrawRequest as l, tokenPairSchema as m, Query as n, LoginRequest as o, signupRequestSchema as p, TokenSource as r, SignupRequest as s, ApiError as t, WithdrawalBlockedDetails as u };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as AnonymousSession, c as TokenPair, d as signupRequestSchema, f as tokenPairSchema, i as buildQuery, l as anonymousSessionSchema, n as Query, o as LoginRequest, r as TokenSource, s as SignupRequest, t as ApiError, u as loginRequestSchema } from "./http-DWaRhLfG.mjs";
+import { a as AnonymousSession, c as TokenPair, d as anonymousSessionSchema, f as loginRequestSchema, g as withdrawalBlockedDetailsSchema, h as withdrawRequestSchema, i as buildQuery, l as WithdrawRequest, m as tokenPairSchema, n as Query, o as LoginRequest, p as signupRequestSchema, r as TokenSource, s as SignupRequest, t as ApiError, u as WithdrawalBlockedDetails } from "./http-CxqZxTfE.mjs";
 import { z } from "zod";
 //#region src/analytics-ids.d.ts
 /**
@@ -701,6 +701,8 @@ export declare function createStorefrontClient(options: StorefrontClientOptions)
       expiresIn: number;
     }>;
     logout: () => Promise<void>;
+    /** 구매자 탈퇴 — 로그인 상태(accessToken)에서 비밀번호로 본인 확인. 성공하면 토큰은 모두 무효 */
+    withdraw: (body: WithdrawRequest) => Promise<void>;
   };
   catalog: {
     listCategories: () => Promise<CategoryNode[]>;
@@ -1483,4 +1485,4 @@ export declare const deliveryTrackingSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type DeliveryTracking = z.infer<typeof deliveryTrackingSchema>;
 //#endregion
-export { AnonymousSession, ApiError, LoginRequest, type Query, type SessionStorage, SignupRequest, type StorefrontClient, type StorefrontClientOptions, type StorefrontSession, type StorefrontSessionOptions, TokenPair, type TokenSource, anonymousSessionSchema, buildQuery, loginRequestSchema, signupRequestSchema, tokenPairSchema };
+export { AnonymousSession, ApiError, LoginRequest, type Query, type SessionStorage, SignupRequest, type StorefrontClient, type StorefrontClientOptions, type StorefrontSession, type StorefrontSessionOptions, TokenPair, type TokenSource, WithdrawRequest, WithdrawalBlockedDetails, anonymousSessionSchema, buildQuery, loginRequestSchema, signupRequestSchema, tokenPairSchema, withdrawRequestSchema, withdrawalBlockedDetailsSchema };

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { a as ANALYTICS_VISITOR_HEADER, c as analyticsClientEventSchema, i as ANALYTICS_VISITOR_COOKIE, l as analyticsIdSchema, n as ANALYTICS_SESSION_COOKIE, o as analyticsBatchSchema, r as ANALYTICS_SESSION_HEADER, s as analyticsClientEventNameSchema, t as ANALYTICS_MAX_BATCH_BYTES, u as analyticsServerEventNameSchema } from "./analytics-CgD70OqH.mjs";
 import { t as analyticsIdsFromCookie } from "./analytics-ids-COElZiI3.mjs";
-import { $ as signupRequestSchema, A as PAYMENT_STATUS_VALUES, B as requestPaymentRequestSchema, C as createClaimRequestSchema, D as orderItemStatusSchema, E as claimStatusSchema, F as guestInfoSchema, G as productFacetsSchema, H as categoryNodeSchema, I as paymentMethodSchema, J as cartItemSchema, K as productSortSchema, L as paymentParamsSchema, M as confirmPaymentRequestSchema, N as confirmPaymentResultSchema, O as pageInfoSchema, P as createCheckoutRequestSchema, Q as loginRequestSchema, R as paymentStatusSchema, S as claimTypeSchema, T as myClaimSchema, U as productCardSchema, V as shippingAddressInputSchema, W as productDetailSchema, X as updateCartItemRequestSchema, Y as cartSchema, Z as anonymousSessionSchema, _ as publicInquirySchema, a as reviewSummarySchema, b as customerInquirySchema, c as deliveryTrackingSchema, d as orderShippingAddressSchema, et as tokenPairSchema, f as memberAddressRequestSchema, g as createInquiryRequestSchema, h as updateProfileRequestSchema, i as publicReviewSchema, it as unwrapData, j as checkoutSessionSchema, k as pageSchema, l as myOrderItemSchema, m as memberSchema, n as createReviewRequestSchema, nt as buildQuery, o as updateReviewRequestSchema, p as memberAddressSchema, q as addCartItemRequestSchema, r as createReviewResultSchema, rt as toApiError, s as writableReviewSchema, t as createStorefrontClient, tt as ApiError, u as myOrderSchema, v as createCustomerInquiryRequestSchema, w as createClaimResultSchema, x as claimReasonSchema, y as customerInquiryCategorySchema, z as pgParamsSchema } from "./client-Xb-2tNKT.mjs";
+import { $ as signupRequestSchema, A as PAYMENT_STATUS_VALUES, B as requestPaymentRequestSchema, C as createClaimRequestSchema, D as orderItemStatusSchema, E as claimStatusSchema, F as guestInfoSchema, G as productFacetsSchema, H as categoryNodeSchema, I as paymentMethodSchema, J as cartItemSchema, K as productSortSchema, L as paymentParamsSchema, M as confirmPaymentRequestSchema, N as confirmPaymentResultSchema, O as pageInfoSchema, P as createCheckoutRequestSchema, Q as loginRequestSchema, R as paymentStatusSchema, S as claimTypeSchema, T as myClaimSchema, U as productCardSchema, V as shippingAddressInputSchema, W as productDetailSchema, X as updateCartItemRequestSchema, Y as cartSchema, Z as anonymousSessionSchema, _ as publicInquirySchema, a as reviewSummarySchema, at as toApiError, b as customerInquirySchema, c as deliveryTrackingSchema, d as orderShippingAddressSchema, et as tokenPairSchema, f as memberAddressRequestSchema, g as createInquiryRequestSchema, h as updateProfileRequestSchema, i as publicReviewSchema, it as buildQuery, j as checkoutSessionSchema, k as pageSchema, l as myOrderItemSchema, m as memberSchema, n as createReviewRequestSchema, nt as withdrawalBlockedDetailsSchema, o as updateReviewRequestSchema, ot as unwrapData, p as memberAddressSchema, q as addCartItemRequestSchema, r as createReviewResultSchema, rt as ApiError, s as writableReviewSchema, t as createStorefrontClient, tt as withdrawRequestSchema, u as myOrderSchema, v as createCustomerInquiryRequestSchema, w as createClaimResultSchema, x as claimReasonSchema, y as customerInquiryCategorySchema, z as pgParamsSchema } from "./client-DHISrvXq.mjs";
 //#region src/session.ts
 /** 세션 키 상수 — SDK가 소유한다. store-sdk와 겹치지 않는 별도 네임스페이스. */
 const STOREFRONT_SESSION_KEYS = {
@@ -124,4 +124,4 @@ function createStorefrontSession(options) {
 	};
 }
 //#endregion
-export { ANALYTICS_MAX_BATCH_BYTES, ANALYTICS_SESSION_COOKIE, ANALYTICS_SESSION_HEADER, ANALYTICS_VISITOR_COOKIE, ANALYTICS_VISITOR_HEADER, ApiError, PAYMENT_STATUS_VALUES, STOREFRONT_SESSION_KEYS, addCartItemRequestSchema, analyticsBatchSchema, analyticsClientEventNameSchema, analyticsClientEventSchema, analyticsIdSchema, analyticsIdsFromCookie, analyticsServerEventNameSchema, anonymousSessionSchema, buildQuery, cartItemSchema, cartSchema, categoryNodeSchema, checkoutSessionSchema, claimReasonSchema, claimStatusSchema, claimTypeSchema, confirmPaymentRequestSchema, confirmPaymentResultSchema, createCheckoutRequestSchema, createClaimRequestSchema, createClaimResultSchema, createCustomerInquiryRequestSchema, createInquiryRequestSchema, createReviewRequestSchema, createReviewResultSchema, createStorefrontClient, createStorefrontSession, customerInquiryCategorySchema, customerInquirySchema, deliveryTrackingSchema, guestInfoSchema, loginRequestSchema, memberAddressRequestSchema, memberAddressSchema, memberSchema, myClaimSchema, myOrderItemSchema, myOrderSchema, orderItemStatusSchema, orderShippingAddressSchema, pageInfoSchema, pageSchema, paymentMethodSchema, paymentParamsSchema, paymentStatusSchema, pgParamsSchema, productCardSchema, productDetailSchema, productFacetsSchema, productSortSchema, publicInquirySchema, publicReviewSchema, requestPaymentRequestSchema, reviewSummarySchema, shippingAddressInputSchema, signupRequestSchema, tokenPairSchema, updateCartItemRequestSchema, updateProfileRequestSchema, updateReviewRequestSchema, writableReviewSchema };
+export { ANALYTICS_MAX_BATCH_BYTES, ANALYTICS_SESSION_COOKIE, ANALYTICS_SESSION_HEADER, ANALYTICS_VISITOR_COOKIE, ANALYTICS_VISITOR_HEADER, ApiError, PAYMENT_STATUS_VALUES, STOREFRONT_SESSION_KEYS, addCartItemRequestSchema, analyticsBatchSchema, analyticsClientEventNameSchema, analyticsClientEventSchema, analyticsIdSchema, analyticsIdsFromCookie, analyticsServerEventNameSchema, anonymousSessionSchema, buildQuery, cartItemSchema, cartSchema, categoryNodeSchema, checkoutSessionSchema, claimReasonSchema, claimStatusSchema, claimTypeSchema, confirmPaymentRequestSchema, confirmPaymentResultSchema, createCheckoutRequestSchema, createClaimRequestSchema, createClaimResultSchema, createCustomerInquiryRequestSchema, createInquiryRequestSchema, createReviewRequestSchema, createReviewResultSchema, createStorefrontClient, createStorefrontSession, customerInquiryCategorySchema, customerInquirySchema, deliveryTrackingSchema, guestInfoSchema, loginRequestSchema, memberAddressRequestSchema, memberAddressSchema, memberSchema, myClaimSchema, myOrderItemSchema, myOrderSchema, orderItemStatusSchema, orderShippingAddressSchema, pageInfoSchema, pageSchema, paymentMethodSchema, paymentParamsSchema, paymentStatusSchema, pgParamsSchema, productCardSchema, productDetailSchema, productFacetsSchema, productSortSchema, publicInquirySchema, publicReviewSchema, requestPaymentRequestSchema, reviewSummarySchema, shippingAddressInputSchema, signupRequestSchema, tokenPairSchema, updateCartItemRequestSchema, updateProfileRequestSchema, updateReviewRequestSchema, withdrawRequestSchema, withdrawalBlockedDetailsSchema, writableReviewSchema };

package/package.json

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

package/src/auth/index.ts

@@ -1,10 +1,23 @@
 import { createStorefrontClient } from "../client";
 import { ApiError } from "../http";
-import type { AnonymousSession, LoginRequest, SignupRequest, TokenPair } from "../schemas/auth";
+import type {
+  AnonymousSession,
+  LoginRequest,
+  SignupRequest,
+  TokenPair,
+  WithdrawRequest,
+} from "../schemas/auth";
 
 /** 실패는 모두 이 클래스다 — 메인 엔트리의 `ApiError`와 같은 클래스라 어느 쪽으로 `instanceof`해도 된다 */
 export { ApiError } from "../http";
-export type { AnonymousSession, LoginRequest, SignupRequest, TokenPair } from "../schemas/auth";
+export type {
+  AnonymousSession,
+  LoginRequest,
+  SignupRequest,
+  TokenPair,
+  WithdrawalBlockedDetails,
+  WithdrawRequest,
+} from "../schemas/auth";
 
 export interface StorefrontAuthOptions {
   /** 예: https://api.sayren.app/storefront/v1 */
@@ -68,6 +81,14 @@ export function createStorefrontAuth(options: StorefrontAuthOptions) {
         throw error;
       }
     },
+    /**
+     * 구매자 탈퇴 — 계정·배송지·위시리스트·장바구니·적립금을 지우고 토큰을 모두 무효로 만든다. 되돌릴 수 없다.
+     * 주문·리뷰·문의 기록은 스토어가 보관한다. 진행 중인 주문이나 처리 중인 클레임이 있으면
+     * 409 `WITHDRAWAL_BLOCKED`(`error.details`: `WithdrawalBlockedDetails`)다. 앱은 성공 후 보관한 토큰을 지운다.
+     */
+    withdraw(accessToken: string, body: WithdrawRequest): Promise<void> {
+      return client(accessToken).auth.withdraw(body);
+    },
   };
 }
 

package/src/client.ts

@@ -7,6 +7,8 @@ import {
   loginRequestSchema,
   signupRequestSchema,
   tokenPairSchema,
+  type WithdrawRequest,
+  withdrawRequestSchema,
 } from "./schemas/auth";
 import {
   type AddCartItemRequest,
@@ -181,6 +183,9 @@ export function createStorefrontClient(options: StorefrontClientOptions) {
       refresh: (refreshToken: string) =>
         http.request("POST", "/auth/token/refresh", tokenPairSchema, { body: { refreshToken } }),
       logout: () => http.requestVoid("POST", "/auth/logout"),
+      /** 구매자 탈퇴 — 로그인 상태(accessToken)에서 비밀번호로 본인 확인. 성공하면 토큰은 모두 무효 */
+      withdraw: (body: WithdrawRequest) =>
+        http.requestVoid("POST", "/auth/withdraw", { body: withdrawRequestSchema.parse(body) }),
     },
 
     catalog: {

package/src/schemas/auth.ts

@@ -54,3 +54,26 @@ export const anonymousSessionSchema = z.object({
 });
 
 export type AnonymousSession = z.infer<typeof anonymousSessionSchema>;
+
+/**
+ * 구매자 탈퇴 — `POST /auth/withdraw`. 본인 확인으로 비밀번호를 다시 받는다.
+ * 진행 중인 주문(결제 대기~배송 중)·클레임·결제가 있으면 409 `WITHDRAWAL_BLOCKED`, 비밀번호가 틀리면
+ * 403 `PASSWORD_MISMATCH`다(로그인과 같은 5회 잠금).
+ */
+export const withdrawRequestSchema = z.object({
+  password: z.string().min(1),
+});
+
+export type WithdrawRequest = z.infer<typeof withdrawRequestSchema>;
+
+/** `WITHDRAWAL_BLOCKED`의 `error.details` — 탈퇴를 막는 항목 수 */
+export const withdrawalBlockedDetailsSchema = z.object({
+  /** 결제 대기~배송 중인 주문 상품 */
+  inProgressOrderItems: z.number().int(),
+  /** 처리 중인 취소·반품·교환 */
+  openClaims: z.number().int(),
+  /** 승인 중이거나 결제창이 열려 있을 수 있는 결제(결제창은 만료되면 풀린다) */
+  pendingPayments: z.number().int(),
+});
+
+export type WithdrawalBlockedDetails = z.infer<typeof withdrawalBlockedDetailsSchema>;