@sayren/storefront-sdk 0.3.0 → 0.5.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 { it as ApiError, t as createStorefrontClient } from "../client-D-w3LIU2.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-D-w3LIU2.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({
@@ -627,6 +642,23 @@ const updateReviewRequestSchema = z.object({
 	images: z.array(z.url()).max(5).optional()
 }).refine((value) => Object.values(value).some((v) => v !== void 0), { message: "최소 1개 필드가 필요합니다" });
 //#endregion
+//#region src/schemas/store.ts
+/**
+* 스토어 공개 설정 — `GET /store`. 스토어프런트가 화면을 그릴 때 읽는 값만 담는다.
+*/
+const storefrontStoreSchema = z.object({
+	storeCode: z.string(),
+	name: z.string(),
+	logoUrl: z.string().nullable(),
+	customerCenterPhone: z.string().nullable(),
+	businessHours: z.string().nullable(),
+	/**
+	* 비회원 주문 허용. false면 로그인하지 않은 구매자의 주문서 생성·결제 요청이 403 `GUEST_CHECKOUT_DISABLED`다.
+	* 장바구니 담기는 된다 — 주문 버튼을 로그인 안내로 바꾸면 된다
+	*/
+	guestCheckout: z.boolean()
+});
+//#endregion
 //#region src/client.ts
 const productPageSchema = pageSchema(productCardSchema).extend({ facets: productFacetsSchema.optional() });
 const reviewPageSchema = pageSchema(publicReviewSchema).extend({ summary: reviewSummarySchema.optional() });
@@ -679,8 +711,13 @@ 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) })
 		},
+		store: { 
+		/** 스토어 공개 설정 — 이름·고객센터·비회원 주문 허용 여부 */
+get: () => http.request("GET", "/store", storefrontStoreSchema) },
 		catalog: {
 			listCategories: () => http.request("GET", "/categories", z.array(categoryNodeSchema)),
 			searchProducts: (params) => http.request("GET", "/products", productPageSchema, { query: params }),
@@ -773,4 +810,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 { loginRequestSchema as $, pageSchema as A, pgParamsSchema as B, claimTypeSchema as C, claimStatusSchema as D, myClaimSchema as E, createCheckoutRequestSchema as F, productDetailSchema as G, shippingAddressInputSchema as H, guestInfoSchema as I, addCartItemRequestSchema as J, productFacetsSchema as K, paymentMethodSchema as L, checkoutSessionSchema as M, confirmPaymentRequestSchema as N, orderItemStatusSchema as O, confirmPaymentResultSchema as P, anonymousSessionSchema as Q, paymentParamsSchema as R, claimReasonSchema as S, createClaimResultSchema as T, categoryNodeSchema as U, requestPaymentRequestSchema as V, productCardSchema as W, cartSchema as X, cartItemSchema as Y, updateCartItemRequestSchema as Z, createInquiryRequestSchema as _, publicReviewSchema as a, buildQuery as at, customerInquiryCategorySchema as b, writableReviewSchema as c, myOrderSchema as d, signupRequestSchema as et, orderShippingAddressSchema as f, updateProfileRequestSchema as g, memberSchema as h, createReviewResultSchema as i, ApiError as it, PAYMENT_STATUS_VALUES as j, pageInfoSchema as k, deliveryTrackingSchema as l, memberAddressSchema as m, storefrontStoreSchema as n, withdrawRequestSchema as nt, reviewSummarySchema as o, toApiError as ot, memberAddressRequestSchema as p, productSortSchema as q, createReviewRequestSchema as r, withdrawalBlockedDetailsSchema as rt, updateReviewRequestSchema as s, unwrapData as st, createStorefrontClient as t, tokenPairSchema as tt, myOrderItemSchema as u, publicInquirySchema as v, createClaimRequestSchema as w, customerInquirySchema as x, createCustomerInquiryRequestSchema as y, paymentStatusSchema 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,19 @@ export declare function createStorefrontClient(options: StorefrontClientOptions)
       expiresIn: number;
     }>;
     logout: () => Promise<void>;
+    /** 구매자 탈퇴 — 로그인 상태(accessToken)에서 비밀번호로 본인 확인. 성공하면 토큰은 모두 무효 */
+    withdraw: (body: WithdrawRequest) => Promise<void>;
+  };
+  store: {
+    /** 스토어 공개 설정 — 이름·고객센터·비회원 주문 허용 여부 */
+    get: () => Promise<{
+      storeCode: string;
+      name: string;
+      logoUrl: string | null;
+      customerCenterPhone: string | null;
+      businessHours: string | null;
+      guestCheckout: boolean;
+    }>;
   };
   catalog: {
     listCategories: () => Promise<CategoryNode[]>;
@@ -1483,4 +1496,18 @@ 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 };
+//#region src/schemas/store.d.ts
+/**
+ * 스토어 공개 설정 — `GET /store`. 스토어프런트가 화면을 그릴 때 읽는 값만 담는다.
+ */
+export declare const storefrontStoreSchema: z.ZodObject<{
+  storeCode: z.ZodString;
+  name: z.ZodString;
+  logoUrl: z.ZodNullable<z.ZodString>;
+  customerCenterPhone: z.ZodNullable<z.ZodString>;
+  businessHours: z.ZodNullable<z.ZodString>;
+  guestCheckout: z.ZodBoolean;
+}, z.core.$strip>;
+export type StorefrontStore = z.infer<typeof storefrontStoreSchema>;
+//#endregion
+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 loginRequestSchema, A as pageSchema, B as pgParamsSchema, C as claimTypeSchema, D as claimStatusSchema, E as myClaimSchema, F as createCheckoutRequestSchema, G as productDetailSchema, H as shippingAddressInputSchema, I as guestInfoSchema, J as addCartItemRequestSchema, K as productFacetsSchema, L as paymentMethodSchema, M as checkoutSessionSchema, N as confirmPaymentRequestSchema, O as orderItemStatusSchema, P as confirmPaymentResultSchema, Q as anonymousSessionSchema, R as paymentParamsSchema, S as claimReasonSchema, T as createClaimResultSchema, U as categoryNodeSchema, V as requestPaymentRequestSchema, W as productCardSchema, X as cartSchema, Y as cartItemSchema, Z as updateCartItemRequestSchema, _ as createInquiryRequestSchema, a as publicReviewSchema, at as buildQuery, b as customerInquiryCategorySchema, c as writableReviewSchema, d as myOrderSchema, et as signupRequestSchema, f as orderShippingAddressSchema, g as updateProfileRequestSchema, h as memberSchema, i as createReviewResultSchema, it as ApiError, j as PAYMENT_STATUS_VALUES, k as pageInfoSchema, l as deliveryTrackingSchema, m as memberAddressSchema, n as storefrontStoreSchema, nt as withdrawRequestSchema, o as reviewSummarySchema, ot as toApiError, p as memberAddressRequestSchema, q as productSortSchema, r as createReviewRequestSchema, rt as withdrawalBlockedDetailsSchema, s as updateReviewRequestSchema, st as unwrapData, t as createStorefrontClient, tt as tokenPairSchema, u as myOrderItemSchema, v as publicInquirySchema, w as createClaimRequestSchema, x as customerInquirySchema, y as createCustomerInquiryRequestSchema, z as paymentStatusSchema } from "./client-D-w3LIU2.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, storefrontStoreSchema, tokenPairSchema, updateCartItemRequestSchema, updateProfileRequestSchema, updateReviewRequestSchema, withdrawRequestSchema, withdrawalBlockedDetailsSchema, writableReviewSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/storefront-sdk",
-  "version": "0.3.0",
+  "version": "0.5.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,
@@ -71,6 +73,7 @@ import {
   updateReviewRequestSchema,
   writableReviewSchema,
 } from "./schemas/review";
+import { storefrontStoreSchema } from "./schemas/store";
 import type { StorefrontSession } from "./session";
 
 export interface StorefrontClientOptions {
@@ -181,6 +184,14 @@ 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) }),
+    },
+
+    store: {
+      /** 스토어 공개 설정 — 이름·고객센터·비회원 주문 허용 여부 */
+      get: () => http.request("GET", "/store", storefrontStoreSchema),
     },
 
     catalog: {

package/src/index.ts

@@ -15,6 +15,7 @@ export * from "./schemas/inquiry";
 export * from "./schemas/member";
 export * from "./schemas/order";
 export * from "./schemas/review";
+export * from "./schemas/store";
 export {
   createStorefrontSession,
   type SessionStorage,

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>;

package/src/schemas/store.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+
+/**
+ * 스토어 공개 설정 — `GET /store`. 스토어프런트가 화면을 그릴 때 읽는 값만 담는다.
+ */
+export const storefrontStoreSchema = z.object({
+  storeCode: z.string(),
+  name: z.string(),
+  logoUrl: z.string().nullable(),
+  customerCenterPhone: z.string().nullable(),
+  businessHours: z.string().nullable(),
+  /**
+   * 비회원 주문 허용. false면 로그인하지 않은 구매자의 주문서 생성·결제 요청이 403 `GUEST_CHECKOUT_DISABLED`다.
+   * 장바구니 담기는 된다 — 주문 버튼을 로그인 안내로 바꾸면 된다
+   */
+  guestCheckout: z.boolean(),
+});
+
+export type StorefrontStore = z.infer<typeof storefrontStoreSchema>;