@sayren/storefront-sdk 0.7.0 → 0.9.0

package/dist/index-DvHOQm2-.d.mts

@@ -0,0 +1,1998 @@
+import { c as LinkIdentityRequest, d as SignupRequest, f as SocialProvider, l as LoginRequest, m as WithdrawRequest, o as IdpAuthorizeRequest, r as TokenSource, s as IdpTokenRequest } from "./http-BbFHVGBf.mjs";
+import { z } from "zod";
+//#region src/analytics-ids.d.ts
+/**
+ * 요청의 Cookie 헤더에서 방문자·세션 ID를 읽는다 — SSR 서버가 스토어프론트 API를 부를 때 쓴다.
+ * 브라우저 모듈(`@sayren/storefront-sdk/analytics`)이 셀러 도메인에 남긴 쿠키다. 형식이 틀린 값은 버린다.
+ *
+ * ```ts
+ * const ids = analyticsIdsFromCookie(request.headers.get("cookie"));
+ * createStorefrontClient({ baseUrl, storeCode, ...ids });
+ * ```
+ */
+declare function analyticsIdsFromCookie(cookieHeader: string | null | undefined): {
+  visitorId?: string;
+  sessionId?: string;
+};
+//#endregion
+//#region src/schemas/cart.d.ts
+declare const cartItemSchema: z.ZodObject<{
+  cartItemId: z.ZodString;
+  productId: z.ZodString;
+  productName: z.ZodString;
+  thumbnailUrl: z.ZodNullable<z.ZodURL>;
+  optionId: z.ZodNullable<z.ZodString>;
+  optionName: z.ZodNullable<z.ZodString>;
+  quantity: z.ZodNumber;
+  unitPrice: z.ZodNumber;
+  totalPrice: z.ZodNumber;
+  purchasable: z.ZodBoolean;
+  unpurchasableReason: z.ZodNullable<z.ZodEnum<{
+    SOLD_OUT: "SOLD_OUT";
+    SUSPENDED: "SUSPENDED";
+    CLOSED: "CLOSED";
+  }>>;
+}, z.core.$strip>;
+type CartItem = z.infer<typeof cartItemSchema>;
+declare const cartSchema: z.ZodObject<{
+  items: z.ZodArray<z.ZodObject<{
+    cartItemId: z.ZodString;
+    productId: z.ZodString;
+    productName: z.ZodString;
+    thumbnailUrl: z.ZodNullable<z.ZodURL>;
+    optionId: z.ZodNullable<z.ZodString>;
+    optionName: z.ZodNullable<z.ZodString>;
+    quantity: z.ZodNumber;
+    unitPrice: z.ZodNumber;
+    totalPrice: z.ZodNumber;
+    purchasable: z.ZodBoolean;
+    unpurchasableReason: z.ZodNullable<z.ZodEnum<{
+      SOLD_OUT: "SOLD_OUT";
+      SUSPENDED: "SUSPENDED";
+      CLOSED: "CLOSED";
+    }>>;
+  }, z.core.$strip>>;
+  summary: z.ZodObject<{
+    productAmount: z.ZodNumber;
+    deliveryFee: z.ZodNumber;
+    totalAmount: z.ZodNumber;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+type Cart = z.infer<typeof cartSchema>;
+declare const addCartItemRequestSchema: z.ZodObject<{
+  productId: z.ZodString;
+  optionId: z.ZodOptional<z.ZodString>;
+  quantity: z.ZodNumber;
+}, z.core.$strip>;
+type AddCartItemRequest = z.infer<typeof addCartItemRequestSchema>;
+declare const updateCartItemRequestSchema: z.ZodObject<{
+  quantity: z.ZodOptional<z.ZodNumber>;
+  optionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type UpdateCartItemRequest = z.infer<typeof updateCartItemRequestSchema>;
+//#endregion
+//#region src/schemas/common.d.ts
+declare const pageInfoSchema: z.ZodObject<{
+  page: z.ZodNumber;
+  size: z.ZodNumber;
+  totalElements: z.ZodNumber;
+  totalPages: z.ZodNumber;
+}, z.core.$strip>;
+type PageInfo = z.infer<typeof pageInfoSchema>;
+declare function pageSchema<T extends z.ZodType>(item: T): z.ZodObject<{
+  page: z.ZodNumber;
+  size: z.ZodNumber;
+  totalElements: z.ZodNumber;
+  totalPages: z.ZodNumber;
+  contents: z.ZodArray<T>;
+}, z.core.$strip>;
+interface PageParams {
+  page?: number;
+  size?: number;
+}
+declare const orderItemStatusSchema: z.ZodEnum<{
+  CANCELED: "CANCELED";
+  PAYMENT_WAITING: "PAYMENT_WAITING";
+  PAID: "PAID";
+  CONFIRMED: "CONFIRMED";
+  DISPATCHED: "DISPATCHED";
+  DELIVERING: "DELIVERING";
+  DELIVERED: "DELIVERED";
+  PURCHASE_DECIDED: "PURCHASE_DECIDED";
+}>;
+type OrderItemStatus = z.infer<typeof orderItemStatusSchema>;
+declare const claimStatusSchema: z.ZodEnum<{
+  COMPLETED: "COMPLETED";
+  REQUESTED: "REQUESTED";
+  HELD: "HELD";
+  COLLECTING: "COLLECTING";
+  COLLECTED: "COLLECTED";
+  REDELIVERING: "REDELIVERING";
+  APPROVED: "APPROVED";
+  REJECTED: "REJECTED";
+  WITHDRAWN: "WITHDRAWN";
+}>;
+type ClaimStatus = z.infer<typeof claimStatusSchema>;
+//#endregion
+//#region src/schemas/catalog.d.ts
+interface CategoryNode {
+  categoryId: string;
+  name: string;
+  depth: number;
+  children: CategoryNode[];
+}
+declare const categoryNodeSchema: z.ZodType<CategoryNode>;
+declare const productCardSchema: z.ZodObject<{
+  productId: z.ZodString;
+  name: z.ZodString;
+  thumbnailUrl: z.ZodNullable<z.ZodURL>;
+  salePrice: z.ZodNumber;
+  discountedPrice: z.ZodNullable<z.ZodNumber>;
+  discountRate: z.ZodNullable<z.ZodNumber>;
+  freeShipping: z.ZodBoolean;
+  averageRating: z.ZodNumber;
+  reviewCount: z.ZodNumber;
+  soldOut: z.ZodBoolean;
+}, z.core.$strip>;
+type ProductCard = z.infer<typeof productCardSchema>;
+declare const productDetailSchema: z.ZodObject<{
+  productId: z.ZodString;
+  name: z.ZodString;
+  thumbnailUrl: z.ZodNullable<z.ZodURL>;
+  salePrice: z.ZodNumber;
+  discountedPrice: z.ZodNullable<z.ZodNumber>;
+  discountRate: z.ZodNullable<z.ZodNumber>;
+  freeShipping: z.ZodBoolean;
+  averageRating: z.ZodNumber;
+  reviewCount: z.ZodNumber;
+  soldOut: z.ZodBoolean;
+  description: z.ZodString;
+  images: z.ZodArray<z.ZodURL>;
+  optionGroups: z.ZodArray<z.ZodObject<{
+    groupId: z.ZodString;
+    name: z.ZodString;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodString;
+      name: z.ZodString;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  variants: z.ZodArray<z.ZodObject<{
+    variantId: z.ZodString;
+    valueIds: z.ZodArray<z.ZodString>;
+    name: z.ZodString;
+    additionalPrice: z.ZodNumber;
+    soldOut: z.ZodBoolean;
+  }, z.core.$strip>>;
+  delivery: z.ZodObject<{
+    type: z.ZodEnum<{
+      PAID: "PAID";
+      FREE: "FREE";
+      CONDITIONAL_FREE: "CONDITIONAL_FREE";
+    }>;
+    fee: z.ZodNumber;
+    conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+    estimatedDays: z.ZodString;
+  }, z.core.$strip>;
+  returnPolicy: z.ZodObject<{
+    returnFee: z.ZodNumber;
+    exchangeFee: z.ZodNumber;
+    periodDays: z.ZodNumber;
+  }, z.core.$strip>;
+  categoryPath: z.ZodArray<z.ZodObject<{
+    categoryId: z.ZodString;
+    name: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type ProductDetail = z.infer<typeof productDetailSchema>;
+declare const productSortSchema: z.ZodEnum<{
+  latest: "latest";
+  ratingDesc: "ratingDesc";
+  reviewCount: "reviewCount";
+  recommend: "recommend";
+  priceAsc: "priceAsc";
+  priceDesc: "priceDesc";
+}>;
+type ProductSort = z.infer<typeof productSortSchema>;
+interface ProductSearchParams extends PageParams {
+  keyword?: string;
+  categoryId?: string;
+  minPrice?: number;
+  maxPrice?: number;
+  freeShipping?: boolean;
+  sort?: ProductSort;
+}
+declare const productFacetsSchema: z.ZodObject<{
+  categories: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    categoryId: z.ZodString;
+    name: z.ZodString;
+    count: z.ZodNumber;
+  }, z.core.$strip>>>;
+  priceRange: z.ZodOptional<z.ZodObject<{
+    min: z.ZodNumber;
+    max: z.ZodNumber;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type ProductFacets = z.infer<typeof productFacetsSchema>;
+/** `GET /products` 응답 — 상품 카드 페이지와 검색 패싯 */
+declare const productPageSchema: z.ZodObject<{
+  page: z.ZodNumber;
+  size: z.ZodNumber;
+  totalElements: z.ZodNumber;
+  totalPages: z.ZodNumber;
+  contents: z.ZodArray<z.ZodObject<{
+    productId: z.ZodString;
+    name: z.ZodString;
+    thumbnailUrl: z.ZodNullable<z.ZodURL>;
+    salePrice: z.ZodNumber;
+    discountedPrice: z.ZodNullable<z.ZodNumber>;
+    discountRate: z.ZodNullable<z.ZodNumber>;
+    freeShipping: z.ZodBoolean;
+    averageRating: z.ZodNumber;
+    reviewCount: z.ZodNumber;
+    soldOut: z.ZodBoolean;
+  }, z.core.$strip>>;
+  facets: z.ZodOptional<z.ZodObject<{
+    categories: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      categoryId: z.ZodString;
+      name: z.ZodString;
+      count: z.ZodNumber;
+    }, z.core.$strip>>>;
+    priceRange: z.ZodOptional<z.ZodObject<{
+      min: z.ZodNumber;
+      max: z.ZodNumber;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type ProductPage = z.infer<typeof productPageSchema>;
+//#endregion
+//#region src/schemas/checkout.d.ts
+declare const createCheckoutRequestSchema: z.ZodObject<{
+  cartItemIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  directItem: z.ZodOptional<z.ZodObject<{
+    productId: z.ZodString;
+    optionId: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodNumber;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type CreateCheckoutRequest = z.infer<typeof createCheckoutRequestSchema>;
+declare const checkoutSessionSchema: z.ZodObject<{
+  checkoutId: z.ZodString;
+  items: z.ZodArray<z.ZodObject<{
+    productId: z.ZodString;
+    productName: z.ZodString;
+    optionId: z.ZodNullable<z.ZodString>;
+    optionName: z.ZodNullable<z.ZodString>;
+    quantity: z.ZodNumber;
+    unitPrice: z.ZodNumber;
+    totalPrice: z.ZodNumber;
+  }, z.core.$strip>>;
+  amounts: z.ZodObject<{
+    productAmount: z.ZodNumber;
+    deliveryFee: z.ZodNumber;
+    totalAmount: z.ZodNumber;
+  }, z.core.$strip>;
+  expiresAt: z.ZodString;
+  paymentOptions: z.ZodLazy<z.ZodPreprocess<z.ZodArray<z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"CARD">;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"EASY_PAY">;
+    provider: z.ZodEnum<{
+      NAVERPAY: "NAVERPAY";
+      KAKAOPAY: "KAKAOPAY";
+      TOSSPAY: "TOSSPAY";
+      PAYCO: "PAYCO";
+    }>;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"BANK_TRANSFER">;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"VIRTUAL_ACCOUNT">;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"MOBILE">;
+  }, z.core.$strip>], "method">, z.ZodObject<{
+    label: z.ZodString;
+    pgName: z.ZodString;
+  }, z.core.$strip>>>, unknown>>;
+  testPayment: z.ZodBoolean;
+}, z.core.$strip>;
+type CheckoutSession = z.infer<typeof checkoutSessionSchema>;
+declare const paymentMethodSchema: z.ZodEnum<{
+  CARD: "CARD";
+  EASY_PAY: "EASY_PAY";
+  BANK_TRANSFER: "BANK_TRANSFER";
+  VIRTUAL_ACCOUNT: "VIRTUAL_ACCOUNT";
+  MOBILE: "MOBILE";
+}>;
+type PaymentMethod = z.infer<typeof paymentMethodSchema>;
+/** 결제를 처리하는 PG. 셀러가 직접 계약하고 콘솔 설정 › 결제에서 연결한다 */
+declare const pgProviderSchema: z.ZodEnum<{
+  tosspayments: "tosspayments";
+  portone: "portone";
+}>;
+type PgProvider = z.infer<typeof pgProviderSchema>;
+/** 간편결제사. 토스페이먼츠·포트원 모두 같은 코드를 쓴다 */
+declare const easyPayProviderSchema: z.ZodEnum<{
+  NAVERPAY: "NAVERPAY";
+  KAKAOPAY: "KAKAOPAY";
+  TOSSPAY: "TOSSPAY";
+  PAYCO: "PAYCO";
+}>;
+type EasyPayProvider = z.infer<typeof easyPayProviderSchema>;
+/**
+ * 응답에 실리는 간편결제사 — 서버가 간편결제사를 추가해도 파싱이 깨지지 않게 문자열로 받는다
+ * (`pgProvider`·결제 상태와 같은 방식). 요청과 결제 옵션은 값을 골라 보내는 자리라 enum 그대로다.
+ */
+declare const easyPayProviderResponseSchema: z.ZodString;
+/**
+ * 결제 옵션 — 어느 PG로 어떤 결제수단을 쓸지. `method`로 좁히면 필요한 필드가 타입으로 정해진다
+ * (`EASY_PAY`만 `provider`가 있다). 주문서의 `paymentOptions` 항목을 그대로 넘기거나 직접 써도 된다.
+ * 셀러가 켜지 않은 조합이면 서버가 409 `PAYMENT_OPTION_UNAVAILABLE`로 거절한다.
+ */
+declare const paymentOptionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"CARD">;
+}, z.core.$strip>, z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"EASY_PAY">;
+  provider: z.ZodEnum<{
+    NAVERPAY: "NAVERPAY";
+    KAKAOPAY: "KAKAOPAY";
+    TOSSPAY: "TOSSPAY";
+    PAYCO: "PAYCO";
+  }>;
+}, z.core.$strip>, z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"BANK_TRANSFER">;
+}, z.core.$strip>, z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"VIRTUAL_ACCOUNT">;
+}, z.core.$strip>, z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"MOBILE">;
+}, z.core.$strip>], "method">;
+type PaymentOption = z.infer<typeof paymentOptionSchema>;
+/** 주문서가 내려주는 결제 옵션 — 결제 옵션 + 표시 이름 */
+declare const availablePaymentOptionSchema: z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"CARD">;
+}, z.core.$strip>, z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"EASY_PAY">;
+  provider: z.ZodEnum<{
+    NAVERPAY: "NAVERPAY";
+    KAKAOPAY: "KAKAOPAY";
+    TOSSPAY: "TOSSPAY";
+    PAYCO: "PAYCO";
+  }>;
+}, z.core.$strip>, z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"BANK_TRANSFER">;
+}, z.core.$strip>, z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"VIRTUAL_ACCOUNT">;
+}, z.core.$strip>, z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"MOBILE">;
+}, z.core.$strip>], "method">, z.ZodObject<{
+  label: z.ZodString;
+  pgName: z.ZodString;
+}, z.core.$strip>>;
+type AvailablePaymentOption = z.infer<typeof availablePaymentOptionSchema>;
+/**
+ * 결제 옵션 목록 — 서버가 나중에 추가한 결제수단·PG를 이 SDK가 모르면 **그 항목만 빼고** 읽는다(목록 파싱은 깨지지 않는다).
+ *
+ * 모르는 항목을 버리는 일은 `preprocess`가 하고 항목 타입은 그대로 남는다 — OpenAPI 문서에 `items` 없는
+ * 배열로 나가지 않게 하기 위해서다(`z.array(z.unknown()).transform(...)`은 출력 타입을 표현하지 못한다).
+ */
+declare const paymentOptionListSchema: z.ZodPreprocess<z.ZodArray<z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"CARD">;
+}, z.core.$strip>, z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"EASY_PAY">;
+  provider: z.ZodEnum<{
+    NAVERPAY: "NAVERPAY";
+    KAKAOPAY: "KAKAOPAY";
+    TOSSPAY: "TOSSPAY";
+    PAYCO: "PAYCO";
+  }>;
+}, z.core.$strip>, z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"BANK_TRANSFER">;
+}, z.core.$strip>, z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"VIRTUAL_ACCOUNT">;
+}, z.core.$strip>, z.ZodObject<{
+  pg: z.ZodEnum<{
+    tosspayments: "tosspayments";
+    portone: "portone";
+  }>;
+  method: z.ZodLiteral<"MOBILE">;
+}, z.core.$strip>], "method">, z.ZodObject<{
+  label: z.ZodString;
+  pgName: z.ZodString;
+}, z.core.$strip>>>, unknown>;
+/** 결제 옵션을 화면 키로 — 라디오 value·React key. 예: `tosspayments:CARD`, `portone:EASY_PAY:NAVERPAY` */
+declare function paymentOptionKey(option: PaymentOption): string;
+declare const shippingAddressInputSchema: z.ZodObject<{
+  addressId: z.ZodOptional<z.ZodString>;
+  receiverName: z.ZodString;
+  phone: z.ZodString;
+  zipCode: z.ZodString;
+  address1: z.ZodString;
+  address2: z.ZodOptional<z.ZodString>;
+  deliveryMemo: z.ZodOptional<z.ZodString>;
+  entranceCode: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ShippingAddressInput = z.infer<typeof shippingAddressInputSchema>;
+declare const guestInfoSchema: z.ZodObject<{
+  name: z.ZodString;
+  phone: z.ZodString;
+  email: z.ZodEmail;
+  orderPassword: z.ZodString;
+}, z.core.$strip>;
+type GuestInfo = z.infer<typeof guestInfoSchema>;
+/**
+ * 결제 시작 — 배송지를 확정하고 고른 결제 옵션으로 결제 시도를 연다. 응답의 `payUrl`(결제 서비스)을 팝업(`mode=popup`)이나
+ * 전체 페이지로 열면 결제 서비스가 PG 결제창을 띄우고 승인까지 한다. 리다이렉트 결제가 끝나면 구매자는 `returnUrl`로 돌아온다.
+ * `returnUrl`의 도메인은 스토어 결제 도메인(콘솔 설정 › 결제)에 등록돼 있어야 한다(테스트 결제는 localhost 허용).
+ */
+declare const startPaymentRequestSchema: z.ZodObject<{
+  option: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"CARD">;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"EASY_PAY">;
+    provider: z.ZodEnum<{
+      NAVERPAY: "NAVERPAY";
+      KAKAOPAY: "KAKAOPAY";
+      TOSSPAY: "TOSSPAY";
+      PAYCO: "PAYCO";
+    }>;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"BANK_TRANSFER">;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"VIRTUAL_ACCOUNT">;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"MOBILE">;
+  }, z.core.$strip>], "method">;
+  returnUrl: z.ZodURL;
+  shippingAddress: z.ZodObject<{
+    addressId: z.ZodOptional<z.ZodString>;
+    receiverName: z.ZodString;
+    phone: z.ZodString;
+    zipCode: z.ZodString;
+    address1: z.ZodString;
+    address2: z.ZodOptional<z.ZodString>;
+    deliveryMemo: z.ZodOptional<z.ZodString>;
+    entranceCode: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  guest: z.ZodOptional<z.ZodObject<{
+    name: z.ZodString;
+    phone: z.ZodString;
+    email: z.ZodEmail;
+    orderPassword: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type StartPaymentRequest = z.infer<typeof startPaymentRequestSchema>;
+/** 같은 결제에서 다른 결제 옵션으로 다시 시도. `returnUrl`을 생략하면 결제 시작 때의 복귀 주소를 쓴다 */
+declare const retryPaymentRequestSchema: z.ZodObject<{
+  option: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"CARD">;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"EASY_PAY">;
+    provider: z.ZodEnum<{
+      NAVERPAY: "NAVERPAY";
+      KAKAOPAY: "KAKAOPAY";
+      TOSSPAY: "TOSSPAY";
+      PAYCO: "PAYCO";
+    }>;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"BANK_TRANSFER">;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"VIRTUAL_ACCOUNT">;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"MOBILE">;
+  }, z.core.$strip>], "method">;
+  returnUrl: z.ZodOptional<z.ZodURL>;
+}, z.core.$strip>;
+type RetryPaymentRequest = z.infer<typeof retryPaymentRequestSchema>;
+declare const paymentStartSchema: z.ZodObject<{
+  paymentId: z.ZodString;
+  attemptId: z.ZodString;
+  option: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"CARD">;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"EASY_PAY">;
+    provider: z.ZodEnum<{
+      NAVERPAY: "NAVERPAY";
+      KAKAOPAY: "KAKAOPAY";
+      TOSSPAY: "TOSSPAY";
+      PAYCO: "PAYCO";
+    }>;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"BANK_TRANSFER">;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"VIRTUAL_ACCOUNT">;
+  }, z.core.$strip>, z.ZodObject<{
+    pg: z.ZodEnum<{
+      tosspayments: "tosspayments";
+      portone: "portone";
+    }>;
+    method: z.ZodLiteral<"MOBILE">;
+  }, z.core.$strip>], "method">;
+  payUrl: z.ZodString;
+  expiresAt: z.ZodString;
+  testPayment: z.ZodBoolean;
+}, z.core.$strip>;
+type PaymentStart = z.infer<typeof paymentStartSchema>;
+/** 결제창에서 결제하지 못한 이유 */
+declare const paymentFailureCategorySchema: z.ZodEnum<{
+  PREPARE_FAILURE: "PREPARE_FAILURE";
+  DECLINED: "DECLINED";
+  USER_CANCELED: "USER_CANCELED";
+}>;
+type PaymentFailureCategory = z.infer<typeof paymentFailureCategorySchema>;
+/**
+ * 결제 상태 조회의 현재 상태 값 — 응답 스키마는 서버가 상태를 추가해도 파싱이 깨지지 않게 문자열로 받는다
+ * (`pgProvider`와 같은 방식). 화면 분기는 이 목록으로 하고 모르는 값은 확인 중으로 다룬다.
+ */
+declare const PAYMENT_STATUS_VALUES: readonly ["pending", "processing", "completed", "failed", "expired"];
+type KnownPaymentStatus = (typeof PAYMENT_STATUS_VALUES)[number];
+/** 결제 결과 구분 — 결제 서비스가 스토어프론트에 돌려주는 값과 같다 */
+declare const PAYMENT_RESULT_VALUES: readonly ["COMPLETED", "PROCESSING", "CANCELED", "FAILED", "EXPIRED", "PENDING"];
+type KnownPaymentResult = (typeof PAYMENT_RESULT_VALUES)[number];
+declare const paymentStatusSchema: z.ZodObject<{
+  paymentId: z.ZodString;
+  status: z.ZodString;
+  result: z.ZodString;
+  orderId: z.ZodNullable<z.ZodString>;
+  lastFailure: z.ZodNullable<z.ZodObject<{
+    attemptId: z.ZodString;
+    category: z.ZodString;
+    code: z.ZodNullable<z.ZodString>;
+    message: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  testPayment: z.ZodBoolean;
+  expiresAt: z.ZodString;
+}, z.core.$strip>;
+type PaymentStatus = z.infer<typeof paymentStatusSchema>;
+/**
+ * 결제 서비스가 팝업 opener에 보내는 메시지 — `type`으로 거르고 결과의 원천은 결제 상태 조회다.
+ * 안내 문구는 싣지 않는다. 화면 문구는 상태 조회의 `lastFailure`를 쓴다
+ */
+declare const paymentMessageSchema: z.ZodObject<{
+  type: z.ZodLiteral<"sayren:payment">;
+  paymentId: z.ZodString;
+  result: z.ZodString;
+  orderId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type PaymentMessage = z.infer<typeof paymentMessageSchema>;
+//#endregion
+//#region src/schemas/claim.d.ts
+declare const claimTypeSchema: z.ZodEnum<{
+  CANCEL: "CANCEL";
+  RETURN: "RETURN";
+  EXCHANGE: "EXCHANGE";
+}>;
+type ClaimType = z.infer<typeof claimTypeSchema>;
+declare const claimReasonSchema: z.ZodEnum<{
+  CHANGE_OF_MIND: "CHANGE_OF_MIND";
+  WRONG_ORDER: "WRONG_ORDER";
+  DEFECTIVE: "DEFECTIVE";
+  WRONG_DELIVERY: "WRONG_DELIVERY";
+  DIFFERENT_FROM_PAGE: "DIFFERENT_FROM_PAGE";
+  DELAY: "DELAY";
+}>;
+type ClaimReason = z.infer<typeof claimReasonSchema>;
+declare const createClaimRequestSchema: z.ZodObject<{
+  type: z.ZodEnum<{
+    CANCEL: "CANCEL";
+    RETURN: "RETURN";
+    EXCHANGE: "EXCHANGE";
+  }>;
+  reason: z.ZodEnum<{
+    CHANGE_OF_MIND: "CHANGE_OF_MIND";
+    WRONG_ORDER: "WRONG_ORDER";
+    DEFECTIVE: "DEFECTIVE";
+    WRONG_DELIVERY: "WRONG_DELIVERY";
+    DIFFERENT_FROM_PAGE: "DIFFERENT_FROM_PAGE";
+    DELAY: "DELAY";
+  }>;
+  reasonDetail: z.ZodOptional<z.ZodString>;
+  evidenceImages: z.ZodOptional<z.ZodArray<z.ZodURL>>;
+  exchangeOptionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type CreateClaimRequest = z.infer<typeof createClaimRequestSchema>;
+declare const createClaimResultSchema: z.ZodObject<{
+  claimId: z.ZodString;
+  status: z.ZodLiteral<"REQUESTED">;
+  expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
+  claimDeliveryFee: z.ZodNumber;
+}, z.core.$strip>;
+type CreateClaimResult = z.infer<typeof createClaimResultSchema>;
+declare const myClaimSchema: z.ZodObject<{
+  claimId: z.ZodString;
+  type: z.ZodEnum<{
+    CANCEL: "CANCEL";
+    RETURN: "RETURN";
+    EXCHANGE: "EXCHANGE";
+  }>;
+  status: z.ZodEnum<{
+    COMPLETED: "COMPLETED";
+    REQUESTED: "REQUESTED";
+    HELD: "HELD";
+    COLLECTING: "COLLECTING";
+    COLLECTED: "COLLECTED";
+    REDELIVERING: "REDELIVERING";
+    APPROVED: "APPROVED";
+    REJECTED: "REJECTED";
+    WITHDRAWN: "WITHDRAWN";
+  }>;
+  orderItemId: z.ZodString;
+  productName: z.ZodString;
+  reason: z.ZodString;
+  expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
+  rejectReason: z.ZodNullable<z.ZodString>;
+  requestedAt: z.ZodString;
+  completedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type MyClaim = z.infer<typeof myClaimSchema>;
+//#endregion
+//#region src/schemas/customer-inquiry.d.ts
+declare const customerInquiryCategorySchema: z.ZodEnum<{
+  RETURN: "RETURN";
+  EXCHANGE: "EXCHANGE";
+  DELIVERY: "DELIVERY";
+  PAYMENT: "PAYMENT";
+  ETC: "ETC";
+}>;
+type CustomerInquiryCategory = z.infer<typeof customerInquiryCategorySchema>;
+/** 구매자 본인 뷰 — 마스킹 없이 본인 데이터, 셀러 답변(수정횟수 제외) */
+declare const customerInquirySchema: z.ZodObject<{
+  inquiryId: z.ZodString;
+  category: z.ZodEnum<{
+    RETURN: "RETURN";
+    EXCHANGE: "EXCHANGE";
+    DELIVERY: "DELIVERY";
+    PAYMENT: "PAYMENT";
+    ETC: "ETC";
+  }>;
+  title: z.ZodString;
+  content: z.ZodString;
+  orderItemId: z.ZodNullable<z.ZodString>;
+  answered: z.ZodBoolean;
+  answer: z.ZodNullable<z.ZodObject<{
+    content: z.ZodString;
+    answeredAt: z.ZodString;
+  }, z.core.$strip>>;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+type CustomerInquiry = z.infer<typeof customerInquirySchema>;
+declare const createCustomerInquiryRequestSchema: z.ZodObject<{
+  category: z.ZodEnum<{
+    RETURN: "RETURN";
+    EXCHANGE: "EXCHANGE";
+    DELIVERY: "DELIVERY";
+    PAYMENT: "PAYMENT";
+    ETC: "ETC";
+  }>;
+  title: z.ZodString;
+  content: z.ZodString;
+  orderItemId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type CreateCustomerInquiryRequest = z.infer<typeof createCustomerInquiryRequestSchema>;
+//#endregion
+//#region src/schemas/inquiry.d.ts
+declare const publicInquirySchema: z.ZodObject<{
+  inquiryId: z.ZodString;
+  content: z.ZodNullable<z.ZodString>;
+  secret: z.ZodBoolean;
+  mine: z.ZodBoolean;
+  writerMaskedName: z.ZodString;
+  answer: z.ZodNullable<z.ZodObject<{
+    content: z.ZodNullable<z.ZodString>;
+    answeredAt: z.ZodString;
+  }, z.core.$strip>>;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+type PublicInquiry = z.infer<typeof publicInquirySchema>;
+declare const createInquiryRequestSchema: z.ZodObject<{
+  content: z.ZodString;
+  secret: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type CreateInquiryRequest = z.infer<typeof createInquiryRequestSchema>;
+/** `POST /products/{productId}/inquiries` 응답 */
+declare const createInquiryResultSchema: z.ZodObject<{
+  inquiryId: z.ZodString;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+type CreateInquiryResult = z.infer<typeof createInquiryResultSchema>;
+//#endregion
+//#region src/schemas/member.d.ts
+declare const memberSchema: z.ZodObject<{
+  memberId: z.ZodString;
+  email: z.ZodNullable<z.ZodEmail>;
+  name: z.ZodString;
+  phone: z.ZodNullable<z.ZodString>;
+  point: z.ZodNumber;
+  marketingAgreed: z.ZodBoolean;
+  joinedAt: z.ZodString;
+}, z.core.$strip>;
+type Member = z.infer<typeof memberSchema>;
+declare const updateProfileRequestSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  phone: z.ZodOptional<z.ZodString>;
+  marketingAgreed: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+type UpdateProfileRequest = z.infer<typeof updateProfileRequestSchema>;
+declare const memberAddressSchema: z.ZodObject<{
+  addressId: z.ZodString;
+  alias: z.ZodString;
+  isDefault: z.ZodBoolean;
+  receiverName: z.ZodString;
+  phone: z.ZodString;
+  zipCode: z.ZodString;
+  address1: z.ZodString;
+  address2: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type MemberAddress = z.infer<typeof memberAddressSchema>;
+declare const memberAddressRequestSchema: z.ZodObject<{
+  alias: z.ZodString;
+  receiverName: z.ZodString;
+  phone: z.ZodString;
+  zipCode: z.ZodString;
+  address1: z.ZodString;
+  address2: z.ZodOptional<z.ZodString>;
+  isDefault: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type MemberAddressRequest = z.infer<typeof memberAddressRequestSchema>;
+/** `POST /me/wishlist` 응답 — 이미 찜한 상품이어도 같은 응답이다 */
+declare const wishlistAddResultSchema: z.ZodObject<{
+  productId: z.ZodString;
+  wished: z.ZodLiteral<true>;
+}, z.core.$strip>;
+type WishlistAddResult = z.infer<typeof wishlistAddResultSchema>;
+//#endregion
+//#region src/schemas/review.d.ts
+declare const publicReviewSchema: z.ZodObject<{
+  reviewId: z.ZodString;
+  rating: z.ZodNumber;
+  content: z.ZodString;
+  images: z.ZodArray<z.ZodURL>;
+  optionName: z.ZodNullable<z.ZodString>;
+  writerMaskedName: z.ZodString;
+  sellerReply: z.ZodNullable<z.ZodObject<{
+    content: z.ZodString;
+    repliedAt: z.ZodString;
+  }, z.core.$strip>>;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+type PublicReview = z.infer<typeof publicReviewSchema>;
+declare const reviewSummarySchema: z.ZodObject<{
+  averageRating: z.ZodNumber;
+  totalCount: z.ZodNumber;
+  distribution: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, z.core.$strip>;
+type ReviewSummary = z.infer<typeof reviewSummarySchema>;
+declare const writableReviewSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  productId: z.ZodString;
+  productName: z.ZodString;
+  optionName: z.ZodNullable<z.ZodString>;
+  thumbnailUrl: z.ZodNullable<z.ZodURL>;
+  writableUntil: z.ZodString;
+}, z.core.$strip>;
+type WritableReview = z.infer<typeof writableReviewSchema>;
+declare const createReviewRequestSchema: z.ZodObject<{
+  rating: z.ZodNumber;
+  content: z.ZodString;
+  images: z.ZodOptional<z.ZodArray<z.ZodURL>>;
+}, z.core.$strip>;
+type CreateReviewRequest = z.infer<typeof createReviewRequestSchema>;
+declare const createReviewResultSchema: z.ZodObject<{
+  reviewId: z.ZodString;
+  rewardPoint: z.ZodNumber;
+}, z.core.$strip>;
+type CreateReviewResult = z.infer<typeof createReviewResultSchema>;
+declare const updateReviewRequestSchema: z.ZodObject<{
+  rating: z.ZodOptional<z.ZodNumber>;
+  content: z.ZodOptional<z.ZodString>;
+  images: z.ZodOptional<z.ZodArray<z.ZodURL>>;
+}, z.core.$strip>;
+type UpdateReviewRequest = z.infer<typeof updateReviewRequestSchema>;
+/** `GET /products/{productId}/reviews` 응답 — 리뷰 페이지와 평점 분포 */
+declare const reviewPageSchema: z.ZodObject<{
+  page: z.ZodNumber;
+  size: z.ZodNumber;
+  totalElements: z.ZodNumber;
+  totalPages: z.ZodNumber;
+  contents: z.ZodArray<z.ZodObject<{
+    reviewId: z.ZodString;
+    rating: z.ZodNumber;
+    content: z.ZodString;
+    images: z.ZodArray<z.ZodURL>;
+    optionName: z.ZodNullable<z.ZodString>;
+    writerMaskedName: z.ZodString;
+    sellerReply: z.ZodNullable<z.ZodObject<{
+      content: z.ZodString;
+      repliedAt: z.ZodString;
+    }, z.core.$strip>>;
+    createdAt: z.ZodString;
+  }, z.core.$strip>>;
+  summary: z.ZodOptional<z.ZodObject<{
+    averageRating: z.ZodNumber;
+    totalCount: z.ZodNumber;
+    distribution: z.ZodRecord<z.ZodString, z.ZodNumber>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type ReviewPage = z.infer<typeof reviewPageSchema>;
+/** `PUT /me/reviews/{reviewId}` 응답 */
+declare const updateReviewResultSchema: z.ZodObject<{
+  reviewId: z.ZodString;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+type UpdateReviewResult = z.infer<typeof updateReviewResultSchema>;
+//#endregion
+//#region src/session.d.ts
+/**
+ * SDK 세션 매니저 — 스토어프론트(회원, member) CREDENTIAL 로그인(email/password)의
+ * 저장·무음 갱신·회전을 캡슐화한다. store-sdk의 세션과 동형이지만 진입 메서드는
+ * `.login()`이다 (구매자는 oauth2 authorize 플로우를 타지 않는다 — `/auth/login` → tokenPair).
+ *
+ * 저장 매체(쿠키/localStorage/…)와 그 속성은 **어댑터(앱) 책임**이다. SDK는 "무엇을 어떤 키로
+ * 저장할지"만 알고, "어떻게 저장할지"는 SessionStorage 어댑터에 위임한다.
+ */
+interface SessionStorage {
+  get(key: string): string | null;
+  set(key: string, value: string): void;
+  remove(key: string): void;
+}
+/** 세션 키 상수 — SDK가 소유한다. store-sdk와 겹치지 않는 별도 네임스페이스. */
+declare const STOREFRONT_SESSION_KEYS: {
+  readonly accessToken: "sayren.storefront.accessToken";
+  readonly refreshToken: "sayren.storefront.refreshToken";
+};
+interface StorefrontSessionOptions {
+  /** 예: https://shop.api.example.com/storefront/v1 */
+  baseUrl: string;
+  /** 테넌트 스토어 코드 — X-Store-Code 헤더로 전송한다 */
+  storeCode?: string;
+  /** 저장 매체 어댑터 (앱 소유) */
+  storage: SessionStorage;
+  fetch?: typeof globalThis.fetch;
+}
+interface StorefrontSession {
+  /** POST /auth/login — 성공 시 accessToken/refreshToken 저장 + 구독자 통지 */
+  login(body: LoginRequest): Promise<void>;
+  /** POST /auth/signup — login과 동일하게 tokenPair를 저장한다 */
+  signup(body: SignupRequest): Promise<void>;
+  /**
+   * 무음 세션 갱신 — refreshToken으로 새 tokenPair를 받아 회전 저장한다.
+   * - 탭 내부: 동시 다발 호출을 single-flight로 합친다.
+   * - 탭 간: navigator.locks(있으면)로 회전을 직렬화하고, 락 진입 시 다른 탭이 이미
+   *   회전했으면(accessToken 변경) 내 refreshToken을 소비하지 않고 true를 반환한다.
+   * refreshToken이 없거나 실패(만료·재사용 폐기)하면 세션을 clear하고 false.
+   */
+  refresh(): Promise<boolean>;
+  /** 현재 accessToken (없으면 null) */
+  readonly accessToken: string | null;
+  /** 현재 refreshToken (없으면 null) */
+  readonly refreshToken: string | null;
+  /** GET /me — 토큰이 없으면 null, 있으면 Member */
+  userinfo(): Promise<Member | null>;
+  /** 세션 키를 지우고 best-effort로 /auth/logout을 호출한 뒤 구독자에게 통지한다 */
+  clear(): void;
+  /** 변경 구독(useSyncExternalStore 소비용) — 해지 함수 반환 */
+  subscribe(cb: () => void): () => void;
+}
+declare function createStorefrontSession(options: StorefrontSessionOptions): StorefrontSession;
+//#endregion
+//#region src/client.d.ts
+interface StorefrontClientOptions {
+  /** 예: https://demo.store.example.com/api/v1 */
+  baseUrl: string;
+  /**
+   * 테넌트 스토어 코드 — `X-Store-Code` 헤더로 전송한다. 공유 API 호스트로 접근할 때
+   * 서버가 Host 서브도메인을 추측하는 대신 명시적으로 테넌트를 지정한다(멀티테넌트 격리).
+   * 함수로 전달하면 매 요청마다 재평가.
+   */
+  storeCode?: TokenSource;
+  /** 회원 Access Token. 함수로 전달하면 매 요청마다 재평가 */
+  accessToken?: TokenSource;
+  /**
+   * accessToken의 별칭 옵션 — `{ auth: { accessToken } }` 형태로 전달할 수 있다.
+   * 우선순위: 명시적 `accessToken` 옵션 > `auth.accessToken` > `session.accessToken`.
+   */
+  auth?: {
+    accessToken?: string;
+  };
+  /** 비회원 장바구니 토큰 */
+  cartToken?: TokenSource;
+  /**
+   * 방문 분석 식별자 — 방문자·세션 ID(`sy_vid`·`sy_sid` 쿠키 값). 실으면 서버가 장바구니 담기·결제 시작·구매를
+   * 이 방문과 이어 기록한다. 브라우저는 `@sayren/storefront-sdk/analytics`의 `analytics.ids()`, SSR은
+   * `analyticsIdsFromCookie(request.headers.get("cookie"))`로 얻는다. 함수로 전달하면 매 요청마다 재평가.
+   */
+  visitorId?: TokenSource;
+  sessionId?: TokenSource;
+  /** 서버가 새 X-Cart-Token을 발급했을 때 호출 */
+  onCartToken?: (token: string) => void;
+  /**
+   * SDK 세션 매니저 — 전달하면 accessToken(Bearer)·401 refresh·복구불가 시 clear를
+   * 자동 배선한다. `accessToken`/`auth.accessToken`을 명시하면 그쪽이 우선한다(하위호환).
+   */
+  session?: StorefrontSession;
+  fetch?: typeof globalThis.fetch;
+}
+declare function createStorefrontClient(options: StorefrontClientOptions): {
+  /** 현재 세션 accessToken (session 미전달 시 null) */
+  readonly accessToken: string | null;
+  /** 현재 세션 refreshToken (session 미전달 시 null) */
+  readonly refreshToken: string | null;
+  /** session.userinfo() 위임 — session 미전달 시 에러 */
+  userinfo(): Promise<{
+    memberId: string;
+    email: string | null;
+    name: string;
+    phone: string | null;
+    point: number;
+    marketingAgreed: boolean;
+    joinedAt: string;
+  } | null>;
+  auth: {
+    /** 비회원 익명 세션 발급 — 응답의 cartToken을 `cartToken` 옵션(X-Cart-Token)으로 쓴다 */
+    anonymous: () => Promise<{
+      cartToken: string;
+      expiresAt: string;
+    }>;
+    signup: (body: SignupRequest) => Promise<{
+      accessToken: string;
+      refreshToken: string;
+      expiresIn: number;
+    }>;
+    login: (body: LoginRequest) => Promise<{
+      accessToken: string;
+      refreshToken: string;
+      expiresIn: number;
+    }>;
+    refresh: (refreshToken: string) => Promise<{
+      accessToken: string;
+      refreshToken: string;
+      expiresIn: number;
+    }>;
+    logout: () => Promise<void>;
+    /** 소셜 로그인 시작 — 공급자 로그인 주소를 받는다. PKCE·state는 `@sayren/storefront-sdk/auth`의 `idp()`가 만든다 */
+    idpAuthorize: (provider: SocialProvider, body: IdpAuthorizeRequest) => Promise<{
+      url: string;
+    }>;
+    /** 소셜 로그인 마무리 — 돌아온 1회용 code + codeVerifier를 구매자 토큰으로 바꾼다 */
+    idpToken: (body: IdpTokenRequest) => Promise<{
+      accessToken: string;
+      refreshToken: string;
+      expiresIn: number;
+    }>;
+    /** 구매자 탈퇴 — 로그인 상태(accessToken)에서 비밀번호로 본인 확인. 성공하면 토큰은 모두 무효 */
+    withdraw: (body: WithdrawRequest) => Promise<void>;
+    /** 로그인 수단 — 비밀번호 여부와 연결된 소셜 계정(로그인 필요) */
+    identities: () => Promise<{
+      hasPassword: boolean;
+      hasExternalAuth: boolean;
+      identities: {
+        provider: "kakao" | "naver" | "google";
+        email: string | null;
+        linkedAt: string;
+      }[];
+    }>;
+    /** 소셜 계정 연결 시작(로그인 필요) — 공급자 로그인 주소를 받는다. 본문은 `idpAuthorize`와 같다 */
+    linkIdentityAuthorize: (provider: SocialProvider, body: IdpAuthorizeRequest) => Promise<{
+      url: string;
+    }>;
+    /** 소셜 계정 연결 마무리 — 돌아온 code + codeVerifier로 이 구매자에 연결한다 */
+    linkIdentity: (provider: SocialProvider, body: LinkIdentityRequest) => Promise<{
+      hasPassword: boolean;
+      hasExternalAuth: boolean;
+      identities: {
+        provider: "kakao" | "naver" | "google";
+        email: string | null;
+        linkedAt: string;
+      }[];
+    }>;
+    /** 소셜 계정 연결 해제 — 마지막 로그인 수단이면 409 `LAST_LOGIN_METHOD` */
+    unlinkIdentity: (provider: SocialProvider) => Promise<{
+      hasPassword: boolean;
+      hasExternalAuth: boolean;
+      identities: {
+        provider: "kakao" | "naver" | "google";
+        email: string | null;
+        linkedAt: string;
+      }[];
+    }>;
+  };
+  store: {
+    /** 스토어 공개 설정 — 이름·고객센터·비회원 주문 허용 여부 */
+    get: () => Promise<{
+      storeCode: string;
+      name: string;
+      logoUrl: string | null;
+      customerCenterPhone: string | null;
+      businessHours: string | null;
+      guestCheckout: boolean;
+      loginMethods: ("password" | "kakao" | "naver" | "google")[];
+    }>;
+  };
+  catalog: {
+    listCategories: () => Promise<CategoryNode[]>;
+    searchProducts: (params?: ProductSearchParams) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        productId: string;
+        name: string;
+        thumbnailUrl: string | null;
+        salePrice: number;
+        discountedPrice: number | null;
+        discountRate: number | null;
+        freeShipping: boolean;
+        averageRating: number;
+        reviewCount: number;
+        soldOut: boolean;
+      }[];
+      facets?: {
+        categories?: {
+          categoryId: string;
+          name: string;
+          count: number;
+        }[] | undefined;
+        priceRange?: {
+          min: number;
+          max: number;
+        } | undefined;
+      } | undefined;
+    }>;
+    getProduct: (productId: string) => Promise<{
+      productId: string;
+      name: string;
+      thumbnailUrl: string | null;
+      salePrice: number;
+      discountedPrice: number | null;
+      discountRate: number | null;
+      freeShipping: boolean;
+      averageRating: number;
+      reviewCount: number;
+      soldOut: boolean;
+      description: string;
+      images: string[];
+      optionGroups: {
+        groupId: string;
+        name: string;
+        values: {
+          valueId: string;
+          name: string;
+        }[];
+      }[];
+      variants: {
+        variantId: string;
+        valueIds: string[];
+        name: string;
+        additionalPrice: number;
+        soldOut: boolean;
+      }[];
+      delivery: {
+        type: "PAID" | "FREE" | "CONDITIONAL_FREE";
+        fee: number;
+        conditionalFreeAmount: number | null;
+        estimatedDays: string;
+      };
+      returnPolicy: {
+        returnFee: number;
+        exchangeFee: number;
+        periodDays: number;
+      };
+      categoryPath: {
+        categoryId: string;
+        name: string;
+      }[];
+    }>;
+    listProductReviews: (productId: string, params?: PageParams & {
+      rating?: number;
+      hasImage?: boolean;
+      sort?: "latest" | "ratingDesc" | "ratingAsc" | "helpful";
+    }) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        reviewId: string;
+        rating: number;
+        content: string;
+        images: string[];
+        optionName: string | null;
+        writerMaskedName: string;
+        sellerReply: {
+          content: string;
+          repliedAt: string;
+        } | null;
+        createdAt: string;
+      }[];
+      summary?: {
+        averageRating: number;
+        totalCount: number;
+        distribution: Record<string, number>;
+      } | undefined;
+    }>;
+    listProductInquiries: (productId: string, params?: PageParams) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        inquiryId: string;
+        content: string | null;
+        secret: boolean;
+        mine: boolean;
+        writerMaskedName: string;
+        answer: {
+          content: string | null;
+          answeredAt: string;
+        } | null;
+        createdAt: string;
+      }[];
+    }>;
+    createInquiry: (productId: string, body: CreateInquiryRequest) => Promise<void>;
+  };
+  cart: {
+    get: () => Promise<{
+      items: {
+        cartItemId: string;
+        productId: string;
+        productName: string;
+        thumbnailUrl: string | null;
+        optionId: string | null;
+        optionName: string | null;
+        quantity: number;
+        unitPrice: number;
+        totalPrice: number;
+        purchasable: boolean;
+        unpurchasableReason: "SOLD_OUT" | "SUSPENDED" | "CLOSED" | null;
+      }[];
+      summary: {
+        productAmount: number;
+        deliveryFee: number;
+        totalAmount: number;
+      };
+    }>;
+    addItem: (body: AddCartItemRequest) => Promise<{
+      items: {
+        cartItemId: string;
+        productId: string;
+        productName: string;
+        thumbnailUrl: string | null;
+        optionId: string | null;
+        optionName: string | null;
+        quantity: number;
+        unitPrice: number;
+        totalPrice: number;
+        purchasable: boolean;
+        unpurchasableReason: "SOLD_OUT" | "SUSPENDED" | "CLOSED" | null;
+      }[];
+      summary: {
+        productAmount: number;
+        deliveryFee: number;
+        totalAmount: number;
+      };
+    }>;
+    updateItem: (cartItemId: string, body: UpdateCartItemRequest) => Promise<{
+      items: {
+        cartItemId: string;
+        productId: string;
+        productName: string;
+        thumbnailUrl: string | null;
+        optionId: string | null;
+        optionName: string | null;
+        quantity: number;
+        unitPrice: number;
+        totalPrice: number;
+        purchasable: boolean;
+        unpurchasableReason: "SOLD_OUT" | "SUSPENDED" | "CLOSED" | null;
+      }[];
+      summary: {
+        productAmount: number;
+        deliveryFee: number;
+        totalAmount: number;
+      };
+    }>;
+    removeItem: (cartItemId: string) => Promise<void>;
+  };
+  checkout: {
+    create: (body: CreateCheckoutRequest) => Promise<{
+      checkoutId: string;
+      items: {
+        productId: string;
+        productName: string;
+        optionId: string | null;
+        optionName: string | null;
+        quantity: number;
+        unitPrice: number;
+        totalPrice: number;
+      }[];
+      amounts: {
+        productAmount: number;
+        deliveryFee: number;
+        totalAmount: number;
+      };
+      expiresAt: string;
+      paymentOptions: (({
+        pg: "tosspayments" | "portone";
+        method: "CARD";
+      } | {
+        pg: "tosspayments" | "portone";
+        method: "EASY_PAY";
+        provider: "NAVERPAY" | "KAKAOPAY" | "TOSSPAY" | "PAYCO";
+      } | {
+        pg: "tosspayments" | "portone";
+        method: "BANK_TRANSFER";
+      } | {
+        pg: "tosspayments" | "portone";
+        method: "VIRTUAL_ACCOUNT";
+      } | {
+        pg: "tosspayments" | "portone";
+        method: "MOBILE";
+      }) & {
+        label: string;
+        pgName: string;
+      })[];
+      testPayment: boolean;
+    }>;
+    /**
+     * `POST /checkout/{checkoutId}/payment` — 결제 시작. 배송지와 결제 옵션(`paymentOptions` 항목 또는 직접 쓴 옵션)으로
+     * 결제 세션·첫 시도를 만들고 결제 서비스 주소(`payUrl`)를 돌려준다. 그 주소를 열어 결제를 진행하는 것은
+     * `@sayren/storefront-sdk/payments`의 `createPayments().start()`다 — 이 메서드는 값만 받는다.
+     *
+     * 에러(`ApiError.code`):
+     * - 409 `PAYMENT_OPTION_UNAVAILABLE`: 이 스토어에서 쓸 수 없는 옵션. `details.paymentOptions`에 지금 목록
+     * - 409 `PAYMENT_NOT_CONFIGURED`: 사용 중인 PG가 없다
+     * - 400 `RETURN_URL_NOT_ALLOWED`: `returnUrl`이 https가 아니거나(테스트 결제의 localhost는 예외),
+     *   스토어가 결제 도메인을 등록했는데 그 안이 아니다. 등록하지 않았으면 https 주소는 모두 받는다
+     * - 503 `PAYMENT_PROVIDER_UNAVAILABLE`: 고른 PG의 결제창을 준비하지 못했다(다른 옵션으로 다시 시도)
+     */
+    startPayment: (checkoutId: string, body: StartPaymentRequest) => Promise<{
+      paymentId: string;
+      attemptId: string;
+      option: {
+        pg: "tosspayments" | "portone";
+        method: "CARD";
+      } | {
+        pg: "tosspayments" | "portone";
+        method: "EASY_PAY";
+        provider: "NAVERPAY" | "KAKAOPAY" | "TOSSPAY" | "PAYCO";
+      } | {
+        pg: "tosspayments" | "portone";
+        method: "BANK_TRANSFER";
+      } | {
+        pg: "tosspayments" | "portone";
+        method: "VIRTUAL_ACCOUNT";
+      } | {
+        pg: "tosspayments" | "portone";
+        method: "MOBILE";
+      };
+      payUrl: string;
+      expiresAt: string;
+      testPayment: boolean;
+    }>;
+  };
+  payments: {
+    /**
+     * `GET /storefront/v1/payments/{paymentId}` — 결제 상태 조회. 복귀 화면에서 결과가 확인 중(`processing`)이면
+     * `expiresAt`까지 폴링한다. `completed`면 `orderId`로 완료 화면, `failed`·`expired`면 실패 안내다.
+     * TTL이 지난 `pending`은 `expired`로 보고된다. `testPayment`는 완료면 주문 플래그, 아니면 세션 환경이다.
+     *
+     * 에러: 404 `PAYMENT_NOT_FOUND`(없음·다른 스토어) · 410 `STORE_CLOSED` · 503 `STORE_SUSPENDED`
+     */
+    getStatus: (paymentId: string) => Promise<{
+      paymentId: string;
+      status: string;
+      result: string;
+      orderId: string | null;
+      lastFailure: {
+        attemptId: string;
+        category: string;
+        code: string | null;
+        message: string | null;
+      } | null;
+      testPayment: boolean;
+      expiresAt: string;
+    }>;
+    /**
+     * `POST /payments/{paymentId}/attempts` — 같은 결제에서 다른 결제 옵션으로 다시 시도한다. 새 시도의 결제창 값을
+     * 돌려준다. 승인 중이거나 결과 확인 중이면 409 `PAYMENT_IN_PROGRESS`다.
+     */
+    retry: (paymentId: string, body: RetryPaymentRequest) => Promise<{
+      paymentId: string;
+      attemptId: string;
+      option: {
+        pg: "tosspayments" | "portone";
+        method: "CARD";
+      } | {
+        pg: "tosspayments" | "portone";
+        method: "EASY_PAY";
+        provider: "NAVERPAY" | "KAKAOPAY" | "TOSSPAY" | "PAYCO";
+      } | {
+        pg: "tosspayments" | "portone";
+        method: "BANK_TRANSFER";
+      } | {
+        pg: "tosspayments" | "portone";
+        method: "VIRTUAL_ACCOUNT";
+      } | {
+        pg: "tosspayments" | "portone";
+        method: "MOBILE";
+      };
+      payUrl: string;
+      expiresAt: string;
+      testPayment: boolean;
+    }>;
+  };
+  myOrders: {
+    list: (params?: PageParams & {
+      status?: OrderItemStatus;
+      from?: string;
+    }) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        orderId: string;
+        orderedAt: string;
+        items: {
+          orderItemId: string;
+          productId: string;
+          productName: string;
+          thumbnailUrl: string | null;
+          optionName: string | null;
+          quantity: number;
+          totalPrice: number;
+          status: "CANCELED" | "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
+          claimStatus: string | null;
+          reviewWritten: boolean;
+          autoDecisionDate: string | null;
+        }[];
+        shippingAddress: {
+          receiverName: string;
+          phone: string;
+          zipCode: string;
+          address1: string;
+          address2?: string | null | undefined;
+          deliveryMemo?: string | null | undefined;
+          entranceCode?: string | null | undefined;
+        };
+        payment: {
+          method: "CARD" | "EASY_PAY" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE";
+          easyPayProvider: string | null;
+          totalAmount: number;
+          paidAt: string | null;
+          receiptUrl: string | null;
+        };
+        testPayment: boolean;
+      }[];
+    }>;
+    get: (orderId: string) => Promise<{
+      orderId: string;
+      orderedAt: string;
+      items: {
+        orderItemId: string;
+        productId: string;
+        productName: string;
+        thumbnailUrl: string | null;
+        optionName: string | null;
+        quantity: number;
+        totalPrice: number;
+        status: "CANCELED" | "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
+        claimStatus: string | null;
+        reviewWritten: boolean;
+        autoDecisionDate: string | null;
+      }[];
+      shippingAddress: {
+        receiverName: string;
+        phone: string;
+        zipCode: string;
+        address1: string;
+        address2?: string | null | undefined;
+        deliveryMemo?: string | null | undefined;
+        entranceCode?: string | null | undefined;
+      };
+      payment: {
+        method: "CARD" | "EASY_PAY" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE";
+        easyPayProvider: string | null;
+        totalAmount: number;
+        paidAt: string | null;
+        receiptUrl: string | null;
+      };
+      testPayment: boolean;
+    }>;
+    getGuestOrder: (orderId: string, body: {
+      phone: string;
+      orderPassword: string;
+    }) => Promise<{
+      orderId: string;
+      orderedAt: string;
+      items: {
+        orderItemId: string;
+        productId: string;
+        productName: string;
+        thumbnailUrl: string | null;
+        optionName: string | null;
+        quantity: number;
+        totalPrice: number;
+        status: "CANCELED" | "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
+        claimStatus: string | null;
+        reviewWritten: boolean;
+        autoDecisionDate: string | null;
+      }[];
+      shippingAddress: {
+        receiverName: string;
+        phone: string;
+        zipCode: string;
+        address1: string;
+        address2?: string | null | undefined;
+        deliveryMemo?: string | null | undefined;
+        entranceCode?: string | null | undefined;
+      };
+      payment: {
+        method: "CARD" | "EASY_PAY" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE";
+        easyPayProvider: string | null;
+        totalAmount: number;
+        paidAt: string | null;
+        receiptUrl: string | null;
+      };
+      testPayment: boolean;
+    }>;
+    getDelivery: (orderItemId: string) => Promise<{
+      carrierName: string;
+      trackingNumber: string;
+      trackingUrl: string;
+      status: "DISPATCHED" | "DELIVERING" | "DELIVERED";
+      trackingEvents: {
+        status: string;
+        location: string;
+        occurredAt: string;
+      }[];
+    }>;
+    decidePurchase: (orderItemId: string) => Promise<void>;
+  };
+  myClaims: {
+    create: (orderItemId: string, body: CreateClaimRequest) => Promise<{
+      claimId: string;
+      status: "REQUESTED";
+      expectedRefundAmount: number | null;
+      claimDeliveryFee: number;
+    }>;
+    list: (params?: PageParams & {
+      status?: ClaimStatus;
+    }) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        claimId: string;
+        type: "CANCEL" | "RETURN" | "EXCHANGE";
+        status: "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "REJECTED" | "WITHDRAWN";
+        orderItemId: string;
+        productName: string;
+        reason: string;
+        expectedRefundAmount: number | null;
+        rejectReason: string | null;
+        requestedAt: string;
+        completedAt: string | null;
+      }[];
+    }>;
+    withdraw: (claimId: string) => Promise<void>;
+  };
+  member: {
+    me: () => Promise<{
+      memberId: string;
+      email: string | null;
+      name: string;
+      phone: string | null;
+      point: number;
+      marketingAgreed: boolean;
+      joinedAt: string;
+    }>;
+    updateMe: (body: UpdateProfileRequest) => Promise<void>;
+    listAddresses: () => Promise<{
+      addressId: string;
+      alias: string;
+      isDefault: boolean;
+      receiverName: string;
+      phone: string;
+      zipCode: string;
+      address1: string;
+      address2: string | null;
+    }[]>;
+    createAddress: (body: MemberAddressRequest) => Promise<void>;
+    updateAddress: (addressId: string, body: MemberAddressRequest) => Promise<void>;
+    deleteAddress: (addressId: string) => Promise<void>;
+    listWishlist: (params?: PageParams) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        productId: string;
+        name: string;
+        thumbnailUrl: string | null;
+        salePrice: number;
+        discountedPrice: number | null;
+        discountRate: number | null;
+        freeShipping: boolean;
+        averageRating: number;
+        reviewCount: number;
+        soldOut: boolean;
+      }[];
+    }>;
+    addWishlist: (productId: string) => Promise<void>;
+    removeWishlist: (productId: string) => Promise<void>;
+  };
+  reviews: {
+    listWritable: () => Promise<{
+      orderItemId: string;
+      productId: string;
+      productName: string;
+      optionName: string | null;
+      thumbnailUrl: string | null;
+      writableUntil: string;
+    }[]>;
+    create: (orderItemId: string, body: CreateReviewRequest) => Promise<{
+      reviewId: string;
+      rewardPoint: number;
+    }>;
+    update: (reviewId: string, body: UpdateReviewRequest) => Promise<void>;
+    remove: (reviewId: string) => Promise<void>;
+  };
+  inquiries: {
+    listMine: (params?: PageParams & {
+      answered?: boolean;
+    }) => Promise<{
+      page: number;
+      size: number;
+      totalElements: number;
+      totalPages: number;
+      contents: {
+        inquiryId: string;
+        content: string | null;
+        secret: boolean;
+        mine: boolean;
+        writerMaskedName: string;
+        answer: {
+          content: string | null;
+          answeredAt: string;
+        } | null;
+        createdAt: string;
+      }[];
+    }>;
+  };
+  me: {
+    customerInquiries: {
+      create: (body: CreateCustomerInquiryRequest) => Promise<{
+        inquiryId: string;
+        category: "RETURN" | "EXCHANGE" | "DELIVERY" | "PAYMENT" | "ETC";
+        title: string;
+        content: string;
+        orderItemId: string | null;
+        answered: boolean;
+        answer: {
+          content: string;
+          answeredAt: string;
+        } | null;
+        createdAt: string;
+      }>;
+      list: (params?: PageParams & {
+        answered?: boolean;
+        category?: CustomerInquiryCategory;
+      }) => Promise<{
+        page: number;
+        size: number;
+        totalElements: number;
+        totalPages: number;
+        contents: {
+          inquiryId: string;
+          category: "RETURN" | "EXCHANGE" | "DELIVERY" | "PAYMENT" | "ETC";
+          title: string;
+          content: string;
+          orderItemId: string | null;
+          answered: boolean;
+          answer: {
+            content: string;
+            answeredAt: string;
+          } | null;
+          createdAt: string;
+        }[];
+      }>;
+      get: (inquiryId: string) => Promise<{
+        inquiryId: string;
+        category: "RETURN" | "EXCHANGE" | "DELIVERY" | "PAYMENT" | "ETC";
+        title: string;
+        content: string;
+        orderItemId: string | null;
+        answered: boolean;
+        answer: {
+          content: string;
+          answeredAt: string;
+        } | null;
+        createdAt: string;
+      }>;
+    };
+  };
+};
+type StorefrontClient = ReturnType<typeof createStorefrontClient>;
+//#endregion
+//#region src/schemas/analytics.d.ts
+/**
+ * 방문 분석 이벤트 계약 — 브라우저 모듈(`@sayren/storefront-sdk/analytics`)과 수집 엔드포인트
+ * (`POST /storefront/v1/events`)가 같은 스키마를 쓴다.
+ *
+ * 행동 이벤트(페이지뷰·상품 조회·목록 노출·검색·체류)는 브라우저가 보낸다. 거래 이벤트(장바구니·결제 시작·구매)는
+ * 스토어프론트 API가 요청을 처리하면서 서버에서 기록하므로 브라우저가 보내지 않는다 — 매출·전환은 조작이나
+ * 누락이 없는 서버 데이터로 계산한다.
+ */
+/** 방문자·세션 식별자 — SDK가 만드는 URL-safe 난수 */
+declare const analyticsIdSchema: z.ZodString;
+/** 방문자 ID 쿠키(1년) · 세션 ID 쿠키(30분 비활동) 이름. SSR 서버도 같은 이름으로 읽는다 */
+declare const ANALYTICS_VISITOR_COOKIE = "sy_vid";
+declare const ANALYTICS_SESSION_COOKIE = "sy_sid";
+/** 스토어프론트 API 요청에 실어 서버 거래 이벤트와 방문자·세션을 잇는 헤더 */
+declare const ANALYTICS_VISITOR_HEADER = "x-sayren-visitor";
+declare const ANALYTICS_SESSION_HEADER = "x-sayren-session";
+/** 브라우저가 보내는 이벤트 이름 */
+declare const analyticsClientEventNameSchema: z.ZodEnum<{
+  search: "search";
+  page_view: "page_view";
+  page_engagement: "page_engagement";
+  product_view: "product_view";
+  product_list_view: "product_list_view";
+}>;
+type AnalyticsClientEventName = z.infer<typeof analyticsClientEventNameSchema>;
+/** 서버가 기록하는 이벤트 이름 */
+declare const analyticsServerEventNameSchema: z.ZodEnum<{
+  add_to_cart: "add_to_cart";
+  remove_from_cart: "remove_from_cart";
+  begin_checkout: "begin_checkout";
+  purchase: "purchase";
+}>;
+type AnalyticsServerEventName = z.infer<typeof analyticsServerEventNameSchema>;
+type AnalyticsEventName = AnalyticsClientEventName | AnalyticsServerEventName;
+declare const analyticsClientEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  name: z.ZodLiteral<"page_view">;
+  referrer: z.ZodOptional<z.ZodURL>;
+  occurredAt: z.ZodISODateTime;
+  url: z.ZodURL;
+  pageViewId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  name: z.ZodLiteral<"page_engagement">;
+  visibleMs: z.ZodNumber;
+  occurredAt: z.ZodISODateTime;
+  url: z.ZodURL;
+  pageViewId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  name: z.ZodLiteral<"product_view">;
+  productId: z.ZodString;
+  variantId: z.ZodOptional<z.ZodString>;
+  occurredAt: z.ZodISODateTime;
+  url: z.ZodURL;
+  pageViewId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  name: z.ZodLiteral<"product_list_view">;
+  listId: z.ZodString;
+  productIds: z.ZodArray<z.ZodString>;
+  occurredAt: z.ZodISODateTime;
+  url: z.ZodURL;
+  pageViewId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  name: z.ZodLiteral<"search">;
+  query: z.ZodString;
+  resultCount: z.ZodNumber;
+  occurredAt: z.ZodISODateTime;
+  url: z.ZodURL;
+  pageViewId: z.ZodString;
+}, z.core.$strip>], "name">;
+type AnalyticsClientEvent = z.infer<typeof analyticsClientEventSchema>;
+/** 한 번에 보내는 배치 — sendBeacon이라 헤더를 못 실어 테넌트·식별자를 본문에 싣는다 */
+declare const analyticsBatchSchema: z.ZodObject<{
+  storeCode: z.ZodString;
+  visitorId: z.ZodString;
+  sessionId: z.ZodString;
+  events: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    name: z.ZodLiteral<"page_view">;
+    referrer: z.ZodOptional<z.ZodURL>;
+    occurredAt: z.ZodISODateTime;
+    url: z.ZodURL;
+    pageViewId: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    name: z.ZodLiteral<"page_engagement">;
+    visibleMs: z.ZodNumber;
+    occurredAt: z.ZodISODateTime;
+    url: z.ZodURL;
+    pageViewId: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    name: z.ZodLiteral<"product_view">;
+    productId: z.ZodString;
+    variantId: z.ZodOptional<z.ZodString>;
+    occurredAt: z.ZodISODateTime;
+    url: z.ZodURL;
+    pageViewId: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    name: z.ZodLiteral<"product_list_view">;
+    listId: z.ZodString;
+    productIds: z.ZodArray<z.ZodString>;
+    occurredAt: z.ZodISODateTime;
+    url: z.ZodURL;
+    pageViewId: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    name: z.ZodLiteral<"search">;
+    query: z.ZodString;
+    resultCount: z.ZodNumber;
+    occurredAt: z.ZodISODateTime;
+    url: z.ZodURL;
+    pageViewId: z.ZodString;
+  }, z.core.$strip>], "name">>;
+  context: z.ZodOptional<z.ZodObject<{
+    webdriver: z.ZodOptional<z.ZodBoolean>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type AnalyticsBatch = z.infer<typeof analyticsBatchSchema>;
+/** 배치 본문 상한(바이트) — 서버가 넘는 요청을 거부한다 */
+declare const ANALYTICS_MAX_BATCH_BYTES: number;
+//#endregion
+//#region src/schemas/order.d.ts
+declare const myOrderItemSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  productId: z.ZodString;
+  productName: z.ZodString;
+  thumbnailUrl: z.ZodNullable<z.ZodURL>;
+  optionName: z.ZodNullable<z.ZodString>;
+  quantity: z.ZodNumber;
+  totalPrice: z.ZodNumber;
+  status: z.ZodEnum<{
+    CANCELED: "CANCELED";
+    PAYMENT_WAITING: "PAYMENT_WAITING";
+    PAID: "PAID";
+    CONFIRMED: "CONFIRMED";
+    DISPATCHED: "DISPATCHED";
+    DELIVERING: "DELIVERING";
+    DELIVERED: "DELIVERED";
+    PURCHASE_DECIDED: "PURCHASE_DECIDED";
+  }>;
+  claimStatus: z.ZodNullable<z.ZodString>;
+  reviewWritten: z.ZodBoolean;
+  autoDecisionDate: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type MyOrderItem = z.infer<typeof myOrderItemSchema>;
+/**
+ * 주문 응답의 배송지 — 결제 요청 시 저장된 스냅샷. 요청 스키마(`shippingAddressInputSchema`)와 분리한 응답 스키마라
+ * 형식 검증(regex·길이)을 하지 않는다. 입력하지 않은 선택 필드는 null로 오거나 빠질 수 있다.
+ */
+declare const orderShippingAddressSchema: z.ZodObject<{
+  receiverName: z.ZodString;
+  phone: z.ZodString;
+  zipCode: z.ZodString;
+  address1: z.ZodString;
+  address2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  deliveryMemo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  entranceCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+type OrderShippingAddress = z.infer<typeof orderShippingAddressSchema>;
+declare const myOrderSchema: z.ZodObject<{
+  orderId: z.ZodString;
+  orderedAt: z.ZodString;
+  items: z.ZodArray<z.ZodObject<{
+    orderItemId: z.ZodString;
+    productId: z.ZodString;
+    productName: z.ZodString;
+    thumbnailUrl: z.ZodNullable<z.ZodURL>;
+    optionName: z.ZodNullable<z.ZodString>;
+    quantity: z.ZodNumber;
+    totalPrice: z.ZodNumber;
+    status: z.ZodEnum<{
+      CANCELED: "CANCELED";
+      PAYMENT_WAITING: "PAYMENT_WAITING";
+      PAID: "PAID";
+      CONFIRMED: "CONFIRMED";
+      DISPATCHED: "DISPATCHED";
+      DELIVERING: "DELIVERING";
+      DELIVERED: "DELIVERED";
+      PURCHASE_DECIDED: "PURCHASE_DECIDED";
+    }>;
+    claimStatus: z.ZodNullable<z.ZodString>;
+    reviewWritten: z.ZodBoolean;
+    autoDecisionDate: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  shippingAddress: z.ZodObject<{
+    receiverName: z.ZodString;
+    phone: z.ZodString;
+    zipCode: z.ZodString;
+    address1: z.ZodString;
+    address2: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    deliveryMemo: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    entranceCode: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strip>;
+  payment: z.ZodObject<{
+    method: z.ZodEnum<{
+      CARD: "CARD";
+      EASY_PAY: "EASY_PAY";
+      BANK_TRANSFER: "BANK_TRANSFER";
+      VIRTUAL_ACCOUNT: "VIRTUAL_ACCOUNT";
+      MOBILE: "MOBILE";
+    }>;
+    easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    totalAmount: z.ZodNumber;
+    paidAt: z.ZodNullable<z.ZodString>;
+    receiptUrl: z.ZodNullable<z.ZodURL>;
+  }, z.core.$strip>;
+  testPayment: z.ZodBoolean;
+}, z.core.$strip>;
+type MyOrder = z.infer<typeof myOrderSchema>;
+declare const deliveryTrackingSchema: z.ZodObject<{
+  carrierName: z.ZodString;
+  trackingNumber: z.ZodString;
+  trackingUrl: z.ZodURL;
+  status: z.ZodEnum<{
+    DISPATCHED: "DISPATCHED";
+    DELIVERING: "DELIVERING";
+    DELIVERED: "DELIVERED";
+  }>;
+  trackingEvents: z.ZodArray<z.ZodObject<{
+    status: z.ZodString;
+    location: z.ZodString;
+    occurredAt: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+type DeliveryTracking = z.infer<typeof deliveryTrackingSchema>;
+/** `POST /me/order-items/{orderItemId}/purchase-decision` 응답 */
+declare const purchaseDecisionResultSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  status: z.ZodLiteral<"PURCHASE_DECIDED">;
+  decidedAt: z.ZodString;
+}, z.core.$strip>;
+type PurchaseDecisionResult = z.infer<typeof purchaseDecisionResultSchema>;
+//#endregion
+//#region src/schemas/store.d.ts
+/**
+ * 스토어 공개 설정 — `GET /store`. 스토어프론트가 화면을 그릴 때 읽는 값만 담는다.
+ */
+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;
+  loginMethods: z.ZodArray<z.ZodEnum<{
+    password: "password";
+    kakao: "kakao";
+    naver: "naver";
+    google: "google";
+  }>>;
+}, z.core.$strip>;
+type StorefrontStore = z.infer<typeof storefrontStoreSchema>;
+//#endregion
+export { MemberAddress as $, easyPayProviderSchema as $t, createStorefrontClient as A, claimStatusSchema as An, AvailablePaymentOption as At, ReviewSummary as B, cartSchema as Bn, PaymentMessage as Bt, analyticsBatchSchema as C, productFacetsSchema as Cn, CreateClaimResult as Ct, analyticsServerEventNameSchema as D, OrderItemStatus as Dn, createClaimRequestSchema as Dt, analyticsIdSchema as E, ClaimStatus as En, claimTypeSchema as Et, createStorefrontSession as F, Cart as Fn, KnownPaymentResult as Ft, createReviewResultSchema as G, PgProvider as Gt, UpdateReviewResult as H, analyticsIdsFromCookie as Hn, PaymentOption as Ht, CreateReviewRequest as I, CartItem as In, KnownPaymentStatus as It, reviewSummarySchema as J, StartPaymentRequest as Jt, publicReviewSchema as K, RetryPaymentRequest as Kt, CreateReviewResult as L, UpdateCartItemRequest as Ln, PAYMENT_RESULT_VALUES as Lt, SessionStorage as M, pageInfoSchema as Mn, CreateCheckoutRequest as Mt, StorefrontSession as N, pageSchema as Nn, EasyPayProvider as Nt, StorefrontClient as O, PageInfo as On, createClaimResultSchema as Ot, StorefrontSessionOptions as P, AddCartItemRequest as Pn, GuestInfo as Pt, Member as Q, easyPayProviderResponseSchema as Qt, PublicReview as R, addCartItemRequestSchema as Rn, PAYMENT_STATUS_VALUES as Rt, AnalyticsServerEventName as S, productDetailSchema as Sn, CreateClaimRequest as St, analyticsClientEventSchema as T, productSortSchema as Tn, claimReasonSchema as Tt, WritableReview as U, PaymentStart as Ut, UpdateReviewRequest as V, updateCartItemRequestSchema as Vn, PaymentMethod as Vt, createReviewRequestSchema as W, PaymentStatus as Wt, updateReviewResultSchema as X, checkoutSessionSchema as Xt, updateReviewRequestSchema as Y, availablePaymentOptionSchema as Yt, writableReviewSchema as Z, createCheckoutRequestSchema as Zt, ANALYTICS_VISITOR_HEADER as _, ProductPage as _n, createCustomerInquiryRequestSchema as _t, MyOrderItem as a, paymentOptionListSchema as an, memberSchema as at, AnalyticsClientEventName as b, categoryNodeSchema as bn, ClaimReason as bt, deliveryTrackingSchema as c, paymentStatusSchema as cn, CreateInquiryRequest as ct, orderShippingAddressSchema as d, shippingAddressInputSchema as dn, createInquiryRequestSchema as dt, guestInfoSchema as en, MemberAddressRequest as et, purchaseDecisionResultSchema as f, startPaymentRequestSchema as fn, createInquiryResultSchema as ft, ANALYTICS_VISITOR_COOKIE as g, ProductFacets as gn, CustomerInquiryCategory as gt, ANALYTICS_SESSION_HEADER as h, ProductDetail as hn, CustomerInquiry as ht, MyOrder as i, paymentOptionKey as in, memberAddressSchema as it, STOREFRONT_SESSION_KEYS as j, orderItemStatusSchema as jn, CheckoutSession as jt, StorefrontClientOptions as k, PageParams as kn, myClaimSchema as kt, myOrderItemSchema as l, pgProviderSchema as ln, CreateInquiryResult as lt, ANALYTICS_SESSION_COOKIE as m, ProductCard as mn, CreateCustomerInquiryRequest as mt, storefrontStoreSchema as n, paymentMessageSchema as nn, WishlistAddResult as nt, OrderShippingAddress as o, paymentOptionSchema as on, updateProfileRequestSchema as ot, ANALYTICS_MAX_BATCH_BYTES as p, CategoryNode as pn, publicInquirySchema as pt, reviewPageSchema as q, ShippingAddressInput as qt, DeliveryTracking as r, paymentMethodSchema as rn, memberAddressRequestSchema as rt, PurchaseDecisionResult as s, paymentStartSchema as sn, wishlistAddResultSchema as st, StorefrontStore as t, paymentFailureCategorySchema as tn, UpdateProfileRequest as tt, myOrderSchema as u, retryPaymentRequestSchema as un, PublicInquiry as ut, AnalyticsBatch as v, ProductSearchParams as vn, customerInquiryCategorySchema as vt, analyticsClientEventNameSchema as w, productPageSchema as wn, MyClaim as wt, AnalyticsEventName as x, productCardSchema as xn, ClaimType as xt, AnalyticsClientEvent as y, ProductSort as yn, customerInquirySchema as yt, ReviewPage as z, cartItemSchema as zn, PaymentFailureCategory as zt };