@sayren/store-sdk 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -16,6 +16,270 @@ type TokenSource = string | null | undefined | (() => string | null | undefined)
 type Query = Record<string, string | number | boolean | undefined>;
 export declare function buildQuery(query?: Query): string;
 //#endregion
+//#region src/schemas/analytics.d.ts
+export declare const analyticsRangeQuerySchema: z.ZodObject<{
+  from: z.ZodString;
+  to: z.ZodString;
+  includeTest: z.ZodOptional<z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>>;
+}, z.core.$strip>;
+export type AnalyticsRangeParams = z.infer<typeof analyticsRangeQuerySchema>;
+export declare const analyticsTotalsSchema: z.ZodObject<{
+  visitors: z.ZodNumber;
+  sessions: z.ZodNumber;
+  engagedSessions: z.ZodNumber;
+  pageViews: z.ZodNumber;
+  engagementSeconds: z.ZodNumber;
+  productViews: z.ZodNumber;
+  productViewSessions: z.ZodNumber;
+  addToCartSessions: z.ZodNumber;
+  beginCheckoutSessions: z.ZodNumber;
+  purchaseSessions: z.ZodNumber;
+  purchases: z.ZodNumber;
+  revenue: z.ZodNumber;
+  engagementRate: z.ZodNullable<z.ZodNumber>;
+  conversionRate: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type AnalyticsTotals = z.infer<typeof analyticsTotalsSchema>;
+export declare const analyticsFunnelStepSchema: z.ZodObject<{
+  step: z.ZodEnum<{
+    SESSION: "SESSION";
+    PRODUCT_VIEW: "PRODUCT_VIEW";
+    ADD_TO_CART: "ADD_TO_CART";
+    BEGIN_CHECKOUT: "BEGIN_CHECKOUT";
+    PURCHASE: "PURCHASE";
+  }>;
+  sessions: z.ZodNumber;
+  rateFromPrevious: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type AnalyticsFunnelStep = z.infer<typeof analyticsFunnelStepSchema>;
+export declare const analyticsOverviewSchema: z.ZodObject<{
+  summary: z.ZodObject<{
+    visitors: z.ZodNumber;
+    sessions: z.ZodNumber;
+    engagedSessions: z.ZodNumber;
+    pageViews: z.ZodNumber;
+    engagementSeconds: z.ZodNumber;
+    productViews: z.ZodNumber;
+    productViewSessions: z.ZodNumber;
+    addToCartSessions: z.ZodNumber;
+    beginCheckoutSessions: z.ZodNumber;
+    purchaseSessions: z.ZodNumber;
+    purchases: z.ZodNumber;
+    revenue: z.ZodNumber;
+    engagementRate: z.ZodNullable<z.ZodNumber>;
+    conversionRate: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>;
+  funnel: z.ZodArray<z.ZodObject<{
+    step: z.ZodEnum<{
+      SESSION: "SESSION";
+      PRODUCT_VIEW: "PRODUCT_VIEW";
+      ADD_TO_CART: "ADD_TO_CART";
+      BEGIN_CHECKOUT: "BEGIN_CHECKOUT";
+      PURCHASE: "PURCHASE";
+    }>;
+    sessions: z.ZodNumber;
+    rateFromPrevious: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>>;
+  rows: z.ZodArray<z.ZodObject<{
+    visitors: z.ZodNumber;
+    sessions: z.ZodNumber;
+    engagedSessions: z.ZodNumber;
+    pageViews: z.ZodNumber;
+    engagementSeconds: z.ZodNumber;
+    productViews: z.ZodNumber;
+    productViewSessions: z.ZodNumber;
+    addToCartSessions: z.ZodNumber;
+    beginCheckoutSessions: z.ZodNumber;
+    purchaseSessions: z.ZodNumber;
+    purchases: z.ZodNumber;
+    revenue: z.ZodNumber;
+    engagementRate: z.ZodNullable<z.ZodNumber>;
+    conversionRate: z.ZodNullable<z.ZodNumber>;
+    date: z.ZodString;
+  }, z.core.$strip>>;
+  from: z.ZodString;
+  to: z.ZodString;
+  timezone: z.ZodLiteral<"Asia/Seoul">;
+  currency: z.ZodLiteral<"KRW">;
+  includeTest: z.ZodBoolean;
+  lastComputedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type AnalyticsOverview = z.infer<typeof analyticsOverviewSchema>;
+export declare const analyticsProductSortSchema: z.ZodEnum<{
+  VIEWS: "VIEWS";
+  ADD_TO_CARTS: "ADD_TO_CARTS";
+  PURCHASES: "PURCHASES";
+  REVENUE: "REVENUE";
+  IMPRESSIONS: "IMPRESSIONS";
+}>;
+export type AnalyticsProductSort = z.infer<typeof analyticsProductSortSchema>;
+export declare const analyticsProductsQuerySchema: z.ZodObject<{
+  from: z.ZodString;
+  to: z.ZodString;
+  includeTest: z.ZodOptional<z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>>;
+  sort: z.ZodOptional<z.ZodEnum<{
+    VIEWS: "VIEWS";
+    ADD_TO_CARTS: "ADD_TO_CARTS";
+    PURCHASES: "PURCHASES";
+    REVENUE: "REVENUE";
+    IMPRESSIONS: "IMPRESSIONS";
+  }>>;
+  limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type AnalyticsProductsParams = z.infer<typeof analyticsProductsQuerySchema>;
+export declare const analyticsProductRowSchema: z.ZodObject<{
+  productId: z.ZodString;
+  productName: z.ZodNullable<z.ZodString>;
+  impressions: z.ZodNumber;
+  views: z.ZodNumber;
+  viewSessions: z.ZodNumber;
+  addToCarts: z.ZodNumber;
+  purchases: z.ZodNumber;
+  quantity: z.ZodNumber;
+  revenue: z.ZodNumber;
+  purchaseRate: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type AnalyticsProductRow = z.infer<typeof analyticsProductRowSchema>;
+export declare const analyticsProductsSchema: z.ZodObject<{
+  sort: z.ZodEnum<{
+    VIEWS: "VIEWS";
+    ADD_TO_CARTS: "ADD_TO_CARTS";
+    PURCHASES: "PURCHASES";
+    REVENUE: "REVENUE";
+    IMPRESSIONS: "IMPRESSIONS";
+  }>;
+  rows: z.ZodArray<z.ZodObject<{
+    productId: z.ZodString;
+    productName: z.ZodNullable<z.ZodString>;
+    impressions: z.ZodNumber;
+    views: z.ZodNumber;
+    viewSessions: z.ZodNumber;
+    addToCarts: z.ZodNumber;
+    purchases: z.ZodNumber;
+    quantity: z.ZodNumber;
+    revenue: z.ZodNumber;
+    purchaseRate: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>>;
+  from: z.ZodString;
+  to: z.ZodString;
+  timezone: z.ZodLiteral<"Asia/Seoul">;
+  currency: z.ZodLiteral<"KRW">;
+  includeTest: z.ZodBoolean;
+  lastComputedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type AnalyticsProducts = z.infer<typeof analyticsProductsSchema>;
+export declare const analyticsChannelSchema: z.ZodEnum<{
+  PAID: "PAID";
+  DIRECT: "DIRECT";
+  CAMPAIGN: "CAMPAIGN";
+  ORGANIC_SEARCH: "ORGANIC_SEARCH";
+  SOCIAL: "SOCIAL";
+  EMAIL: "EMAIL";
+  REFERRAL: "REFERRAL";
+  UNKNOWN: "UNKNOWN";
+}>;
+export type AnalyticsChannel = z.infer<typeof analyticsChannelSchema>;
+export declare const analyticsSourceGroupBySchema: z.ZodEnum<{
+  CHANNEL: "CHANNEL";
+  SOURCE: "SOURCE";
+  CAMPAIGN: "CAMPAIGN";
+  DEVICE: "DEVICE";
+}>;
+export type AnalyticsSourceGroupBy = z.infer<typeof analyticsSourceGroupBySchema>;
+export declare const analyticsSourcesQuerySchema: z.ZodObject<{
+  from: z.ZodString;
+  to: z.ZodString;
+  includeTest: z.ZodOptional<z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>>;
+  groupBy: z.ZodOptional<z.ZodEnum<{
+    CHANNEL: "CHANNEL";
+    SOURCE: "SOURCE";
+    CAMPAIGN: "CAMPAIGN";
+    DEVICE: "DEVICE";
+  }>>;
+}, z.core.$strip>;
+export type AnalyticsSourcesParams = z.infer<typeof analyticsSourcesQuerySchema>;
+export declare const analyticsSourceRowSchema: z.ZodObject<{
+  channel: z.ZodNullable<z.ZodEnum<{
+    PAID: "PAID";
+    DIRECT: "DIRECT";
+    CAMPAIGN: "CAMPAIGN";
+    ORGANIC_SEARCH: "ORGANIC_SEARCH";
+    SOCIAL: "SOCIAL";
+    EMAIL: "EMAIL";
+    REFERRAL: "REFERRAL";
+    UNKNOWN: "UNKNOWN";
+  }>>;
+  source: z.ZodNullable<z.ZodString>;
+  medium: z.ZodNullable<z.ZodString>;
+  campaign: z.ZodNullable<z.ZodString>;
+  device: z.ZodNullable<z.ZodEnum<{
+    unknown: "unknown";
+    desktop: "desktop";
+    mobile: "mobile";
+    tablet: "tablet";
+  }>>;
+  sessions: z.ZodNumber;
+  visitors: z.ZodNumber;
+  engagedSessions: z.ZodNumber;
+  purchaseSessions: z.ZodNumber;
+  purchases: z.ZodNumber;
+  revenue: z.ZodNumber;
+  conversionRate: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type AnalyticsSourceRow = z.infer<typeof analyticsSourceRowSchema>;
+export declare const analyticsSourcesSchema: z.ZodObject<{
+  groupBy: z.ZodEnum<{
+    CHANNEL: "CHANNEL";
+    SOURCE: "SOURCE";
+    CAMPAIGN: "CAMPAIGN";
+    DEVICE: "DEVICE";
+  }>;
+  rows: z.ZodArray<z.ZodObject<{
+    channel: z.ZodNullable<z.ZodEnum<{
+      PAID: "PAID";
+      DIRECT: "DIRECT";
+      CAMPAIGN: "CAMPAIGN";
+      ORGANIC_SEARCH: "ORGANIC_SEARCH";
+      SOCIAL: "SOCIAL";
+      EMAIL: "EMAIL";
+      REFERRAL: "REFERRAL";
+      UNKNOWN: "UNKNOWN";
+    }>>;
+    source: z.ZodNullable<z.ZodString>;
+    medium: z.ZodNullable<z.ZodString>;
+    campaign: z.ZodNullable<z.ZodString>;
+    device: z.ZodNullable<z.ZodEnum<{
+      unknown: "unknown";
+      desktop: "desktop";
+      mobile: "mobile";
+      tablet: "tablet";
+    }>>;
+    sessions: z.ZodNumber;
+    visitors: z.ZodNumber;
+    engagedSessions: z.ZodNumber;
+    purchaseSessions: z.ZodNumber;
+    purchases: z.ZodNumber;
+    revenue: z.ZodNumber;
+    conversionRate: z.ZodNullable<z.ZodNumber>;
+  }, z.core.$strip>>;
+  from: z.ZodString;
+  to: z.ZodString;
+  timezone: z.ZodLiteral<"Asia/Seoul">;
+  currency: z.ZodLiteral<"KRW">;
+  includeTest: z.ZodBoolean;
+  lastComputedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type AnalyticsSources = z.infer<typeof analyticsSourcesSchema>;
+//#endregion
 //#region src/schemas/api-client.d.ts
 /**
  * 앱(OAuth 클라이언트) 관리 — `/v1/store/api-clients` (auth-spec 부록 B-13).
@@ -543,6 +807,30 @@ export declare const categoryDeleteStrategySchema: z.ZodEnum<{
   cascade: "cascade";
 }>;
 export type CategoryDeleteStrategy = z.infer<typeof categoryDeleteStrategySchema>;
+/**
+ * `GET /v1/categories` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열). 응답 형태가 쿼리로 갈린다:
+ * `q`가 있으면 검색 결과(`CategorySearchResult[]`), 아니면 `tree=true`일 때 트리(`CategoryTreeNode[]`),
+ * 둘 다 아니면 목록(`Category[]`)이다.
+ */
+export declare const categoryListQuerySchema: z.ZodObject<{
+  parentId: z.ZodOptional<z.ZodString>;
+  flat: z.ZodOptional<z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>>;
+  tree: z.ZodOptional<z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>>;
+  q: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** `DELETE /v1/categories/{categoryId}` 쿼리 — OpenAPI 문서용 형태 */
+export declare const categoryDeleteQuerySchema: z.ZodObject<{
+  strategy: z.ZodOptional<z.ZodEnum<{
+    reparent: "reparent";
+    cascade: "cascade";
+  }>>;
+}, z.core.$strip>;
 //#endregion
 //#region src/schemas/common.d.ts
 export declare const pageInfoSchema: z.ZodObject<{
@@ -559,6 +847,17 @@ export declare function pageSchema<T extends z.ZodType>(item: T): z.ZodObject<{
   totalPages: z.ZodNumber;
   contents: z.ZodArray<T>;
 }, z.core.$strip>;
+/**
+ * 목록 쿼리의 `page`·`size` — OpenAPI 문서용 형태(값은 쿼리 문자열). 서버는 숫자가 아니거나 범위를 벗어난
+ * 값을 기본값·상한으로 보정한다.
+ */
+export declare function pageQueryShape(options?: {
+  defaultSize?: number;
+  maxSize?: number;
+}): {
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+};
 export interface PageParams {
   page?: number;
   size?: number;
@@ -686,6 +985,109 @@ export interface ClaimListParams extends PageParams {
   requestedFrom?: string;
   requestedTo?: string;
 }
+/** `GET /v1/claims` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
+export declare const claimListQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+  type: z.ZodOptional<z.ZodEnum<{
+    RETURN: "RETURN";
+    EXCHANGE: "EXCHANGE";
+    CANCEL: "CANCEL";
+  }>>;
+  status: z.ZodOptional<z.ZodEnum<{
+    REQUESTED: "REQUESTED";
+    HELD: "HELD";
+    COLLECTING: "COLLECTING";
+    COLLECTED: "COLLECTED";
+    REDELIVERING: "REDELIVERING";
+    APPROVED: "APPROVED";
+    REJECTED: "REJECTED";
+    COMPLETED: "COMPLETED";
+    WITHDRAWN: "WITHDRAWN";
+  }>>;
+  orderItemId: z.ZodOptional<z.ZodString>;
+  requestedFrom: z.ZodOptional<z.ZodString>;
+  requestedTo: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** `GET /v1/claims/{claimId}` 응답 — 클레임 + 상태 이력 */
+export declare const claimDetailSchema: z.ZodObject<{
+  claimId: z.ZodString;
+  type: z.ZodEnum<{
+    RETURN: "RETURN";
+    EXCHANGE: "EXCHANGE";
+    CANCEL: "CANCEL";
+  }>;
+  status: z.ZodEnum<{
+    REQUESTED: "REQUESTED";
+    HELD: "HELD";
+    COLLECTING: "COLLECTING";
+    COLLECTED: "COLLECTED";
+    REDELIVERING: "REDELIVERING";
+    APPROVED: "APPROVED";
+    REJECTED: "REJECTED";
+    COMPLETED: "COMPLETED";
+    WITHDRAWN: "WITHDRAWN";
+  }>;
+  orderId: z.ZodString;
+  orderItemId: z.ZodString;
+  productName: z.ZodString;
+  quantity: z.ZodNumber;
+  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.ZodNullable<z.ZodString>;
+  responsibility: z.ZodEnum<{
+    BUYER: "BUYER";
+    SELLER: "SELLER";
+  }>;
+  claimDeliveryFee: z.ZodNumber;
+  expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
+  exchangeOption: z.ZodNullable<z.ZodObject<{
+    optionId: z.ZodString;
+    optionName: z.ZodString;
+  }, z.core.$strip>>;
+  collect: z.ZodNullable<z.ZodObject<{
+    method: z.ZodEnum<{
+      SELLER_PICKUP: "SELLER_PICKUP";
+      BUYER_SEND: "BUYER_SEND";
+    }>;
+    carrierCode: z.ZodNullable<z.ZodString>;
+    trackingNumber: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  requestedAt: z.ZodString;
+  completedAt: z.ZodNullable<z.ZodString>;
+  histories: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    status: z.ZodEnum<{
+      REQUESTED: "REQUESTED";
+      HELD: "HELD";
+      COLLECTING: "COLLECTING";
+      COLLECTED: "COLLECTED";
+      REDELIVERING: "REDELIVERING";
+      APPROVED: "APPROVED";
+      REJECTED: "REJECTED";
+      COMPLETED: "COMPLETED";
+      WITHDRAWN: "WITHDRAWN";
+    }>;
+    actor: z.ZodEnum<{
+      BUYER: "BUYER";
+      SELLER: "SELLER";
+      SYSTEM: "SYSTEM";
+    }>;
+    occurredAt: z.ZodString;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ClaimDetail = z.infer<typeof claimDetailSchema>;
+/** `POST /v1/claims/{claimId}/hold` 응답 */
+export declare const claimHoldResultSchema: z.ZodObject<{
+  claimId: z.ZodString;
+  holdExpiresAt: z.ZodString;
+}, z.core.$strip>;
+export type ClaimHoldResult = z.infer<typeof claimHoldResultSchema>;
 export declare const rejectClaimRequestSchema: z.ZodObject<{
   reason: z.ZodEnum<{
     ETC: "ETC";
@@ -762,6 +1164,34 @@ export declare const sellerCustomerInquirySchema: z.ZodObject<{
   createdAt: z.ZodString;
 }, z.core.$strip>;
 export type SellerCustomerInquiry = z.infer<typeof sellerCustomerInquirySchema>;
+/** `GET /v1/inquiries` 쿼리(상품 문의) — OpenAPI 문서용 형태(값은 쿼리 문자열). 최신순이다 */
+export declare const inquiryListQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+  answered: z.ZodOptional<z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>>;
+  productId: z.ZodOptional<z.ZodString>;
+  from: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** `GET /v1/customer-inquiries` 쿼리(1:1 문의) — OpenAPI 문서용 형태(값은 쿼리 문자열). 최신순이다 */
+export declare const customerInquiryListQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+  answered: z.ZodOptional<z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>>;
+  category: z.ZodOptional<z.ZodEnum<{
+    ETC: "ETC";
+    DELIVERY: "DELIVERY";
+    RETURN: "RETURN";
+    EXCHANGE: "EXCHANGE";
+    PAYMENT: "PAYMENT";
+  }>>;
+  from: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export declare const settlementStatusSchema: z.ZodEnum<{
   PAID: "PAID";
   HELD: "HELD";
@@ -802,6 +1232,57 @@ export declare const settlementDetailSchema: z.ZodObject<{
   purchaseDecidedAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type SettlementDetail = z.infer<typeof settlementDetailSchema>;
+/** `GET /v1/settlements/{settlementId}` 응답 — 정산 요약 + 상세 내역(`size`건까지) */
+export declare const settlementWithDetailsSchema: z.ZodObject<{
+  settlementId: z.ZodString;
+  settlementDate: z.ZodString;
+  payoutDate: z.ZodNullable<z.ZodString>;
+  status: z.ZodEnum<{
+    PAID: "PAID";
+    HELD: "HELD";
+    SCHEDULED: "SCHEDULED";
+  }>;
+  totalPaymentAmount: z.ZodNumber;
+  totalCommission: z.ZodNumber;
+  totalDeliveryFee: z.ZodNumber;
+  adjustmentAmount: z.ZodNumber;
+  settlementAmount: z.ZodNumber;
+  itemCount: z.ZodNumber;
+  details: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    orderItemId: z.ZodString;
+    productName: z.ZodString;
+    settlementType: z.ZodEnum<{
+      SALE: "SALE";
+      REFUND_DEDUCTION: "REFUND_DEDUCTION";
+      ADJUSTMENT: "ADJUSTMENT";
+    }>;
+    paymentAmount: z.ZodNumber;
+    salesCommission: z.ZodNumber;
+    paymentCommission: z.ZodNumber;
+    commissionRate: z.ZodNumber;
+    deliveryFee: z.ZodNumber;
+    settlementAmount: z.ZodNumber;
+    purchaseDecidedAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type SettlementWithDetails = z.infer<typeof settlementWithDetailsSchema>;
+/** `GET /v1/settlements` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열). 정산일 최신순이다 */
+export declare const settlementListQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+  from: z.ZodString;
+  to: z.ZodOptional<z.ZodString>;
+  status: z.ZodOptional<z.ZodEnum<{
+    PAID: "PAID";
+    HELD: "HELD";
+    SCHEDULED: "SCHEDULED";
+  }>>;
+}, z.core.$strip>;
+/** `GET /v1/settlements/{settlementId}` 쿼리 — `size`는 돌려줄 상세 내역 건수다(`page`는 무시) */
+export declare const settlementDetailQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export interface SettlementListParams extends PageParams {
   from: string;
   to?: string;
@@ -1034,14 +1515,55 @@ export declare const reviewSchema: z.ZodObject<{
   createdAt: z.ZodString;
 }, z.core.$strip>;
 export type Review = z.infer<typeof reviewSchema>;
+export declare const reviewSortSchema: z.ZodEnum<{
+  "createdAt.desc": "createdAt.desc";
+  "createdAt.asc": "createdAt.asc";
+  "rating.asc": "rating.asc";
+  "rating.desc": "rating.desc";
+}>;
+export type ReviewSort = z.infer<typeof reviewSortSchema>;
 export interface ReviewListParams extends PageParams {
   productId?: string;
   rating?: number;
   replied?: boolean;
   hasImage?: boolean;
   from?: string;
-  sort?: "createdAt.desc" | "createdAt.asc" | "rating.asc" | "rating.desc";
+  sort?: ReviewSort;
 }
+/** `GET /v1/reviews` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
+export declare const reviewListQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+  productId: z.ZodOptional<z.ZodString>;
+  rating: z.ZodOptional<z.ZodEnum<{
+    1: "1";
+    2: "2";
+    3: "3";
+    4: "4";
+    5: "5";
+  }>>;
+  replied: z.ZodOptional<z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>>;
+  hasImage: z.ZodOptional<z.ZodEnum<{
+    true: "true";
+    false: "false";
+  }>>;
+  from: z.ZodOptional<z.ZodString>;
+  sort: z.ZodOptional<z.ZodEnum<{
+    "createdAt.desc": "createdAt.desc";
+    "createdAt.asc": "createdAt.asc";
+    "rating.asc": "rating.asc";
+    "rating.desc": "rating.desc";
+  }>>;
+}, z.core.$strip>;
+/** `POST /v1/reviews/{reviewId}/report` 응답(202) — 신고 접수 */
+export declare const reviewReportResultSchema: z.ZodObject<{
+  reviewId: z.ZodString;
+  status: z.ZodLiteral<"PENDING_REVIEW">;
+}, z.core.$strip>;
+export type ReviewReportResult = z.infer<typeof reviewReportResultSchema>;
 //#endregion
 //#region src/schemas/order.d.ts
 export declare const orderSummarySchema: z.ZodObject<{
@@ -1394,6 +1916,40 @@ export declare const deliveryInfoSchema: z.ZodObject<{
   deliveredAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type DeliveryInfo = z.infer<typeof deliveryInfoSchema>;
+/** `GET /v1/order-items/{orderItemId}/delivery` 응답 — 배송 정보 + 배송 추적 이벤트 */
+export declare const deliveryStatusSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  deliveryMethod: z.ZodEnum<{
+    COURIER: "COURIER";
+    DIRECT: "DIRECT";
+    QUICK: "QUICK";
+    NOTHING: "NOTHING";
+  }>;
+  carrierCode: z.ZodNullable<z.ZodString>;
+  carrierName: z.ZodNullable<z.ZodString>;
+  trackingNumber: z.ZodNullable<z.ZodString>;
+  trackingUrl: z.ZodNullable<z.ZodURL>;
+  status: z.ZodEnum<{
+    DISPATCHED: "DISPATCHED";
+    DELIVERING: "DELIVERING";
+    DELIVERED: "DELIVERED";
+  }>;
+  dispatchedAt: z.ZodString;
+  deliveredAt: z.ZodNullable<z.ZodString>;
+  trackingEvents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    status: z.ZodString;
+    location: z.ZodString;
+    occurredAt: z.ZodString;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type DeliveryStatus = z.infer<typeof deliveryStatusSchema>;
+/** `PUT /v1/order-items/{orderItemId}/dispatch/tracking` 응답 — 바뀐 송장 */
+export declare const trackingUpdateResultSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  carrierCode: z.ZodString;
+  trackingNumber: z.ZodString;
+}, z.core.$strip>;
+export type TrackingUpdateResult = z.infer<typeof trackingUpdateResultSchema>;
 export declare const carrierSchema: z.ZodObject<{
   carrierCode: z.ZodString;
   name: z.ZodString;
@@ -1421,6 +1977,37 @@ export declare const cancelBySellerRequestSchema: z.ZodObject<{
   detail: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type CancelBySellerRequest = z.infer<typeof cancelBySellerRequestSchema>;
+/** `POST /v1/order-items/{orderItemId}/cancel` 응답 — 셀러 직권취소 환불 결과 */
+export declare const cancelBySellerResultSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  refundAmount: z.ZodNumber;
+  refundedAt: z.ZodString;
+}, z.core.$strip>;
+export type CancelBySellerResult = z.infer<typeof cancelBySellerResultSchema>;
+/** `PUT /v1/order-items/{orderItemId}/memo` 응답 — 빈 문자열로 저장하면 메모가 지워져 `null`이다 */
+export declare const orderItemMemoResultSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  sellerMemo: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type OrderItemMemoResult = z.infer<typeof orderItemMemoResultSchema>;
+/** `POST /v1/order-items/{orderItemId}/purchase-decision/request` 응답 */
+export declare const purchaseDecisionRequestResultSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  requestedAt: z.ZodString;
+}, z.core.$strip>;
+export type PurchaseDecisionRequestResult = z.infer<typeof purchaseDecisionRequestResultSchema>;
+/** `POST /v1/order-items/{orderItemId}/purchase-decision/extend` 응답 — 연장은 최대 2회 */
+export declare const purchaseDecisionExtendResultSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  autoDecisionDate: z.ZodString;
+  extendCount: z.ZodNumber;
+}, z.core.$strip>;
+export type PurchaseDecisionExtendResult = z.infer<typeof purchaseDecisionExtendResultSchema>;
+/**
+ * `GET /v1/orders/{orderId}/address-change-requests` 응답 — 배송지 변경 요청 플로우는 아직 제공하지 않아
+ * 현재는 항상 빈 배열이다
+ */
+export declare const addressChangeRequestListSchema: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 //#endregion
 //#region src/schemas/payment.d.ts
 /**
@@ -2652,7 +3239,14 @@ export declare const productPatchRequestSchema: z.ZodObject<{
   deliveryFee: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
-export type ProductSort = "createdAt.desc" | "createdAt.asc" | "salePrice.asc" | "salePrice.desc" | "updatedAt.desc";
+export declare const productSortSchema: z.ZodEnum<{
+  "createdAt.desc": "createdAt.desc";
+  "createdAt.asc": "createdAt.asc";
+  "salePrice.asc": "salePrice.asc";
+  "salePrice.desc": "salePrice.desc";
+  "updatedAt.desc": "updatedAt.desc";
+}>;
+export type ProductSort = z.infer<typeof productSortSchema>;
 export interface ProductListParams extends PageParams {
   status?: ProductStatus;
   categoryId?: string;
@@ -2660,6 +3254,36 @@ export interface ProductListParams extends PageParams {
   sellerCode?: string;
   sort?: ProductSort;
 }
+/** `GET /v1/products` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
+export declare const productListQuerySchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodString>;
+  size: z.ZodOptional<z.ZodString>;
+  status: z.ZodOptional<z.ZodEnum<{
+    SALE: "SALE";
+    SUSPENDED: "SUSPENDED";
+    OUT_OF_STOCK: "OUT_OF_STOCK";
+    CLOSED: "CLOSED";
+  }>>;
+  categoryId: z.ZodOptional<z.ZodString>;
+  keyword: z.ZodOptional<z.ZodString>;
+  sellerCode: z.ZodOptional<z.ZodString>;
+  sort: z.ZodOptional<z.ZodEnum<{
+    "createdAt.desc": "createdAt.desc";
+    "createdAt.asc": "createdAt.asc";
+    "salePrice.asc": "salePrice.asc";
+    "salePrice.desc": "salePrice.desc";
+    "updatedAt.desc": "updatedAt.desc";
+  }>>;
+}, z.core.$strip>;
+/** `POST /v1/product-images` 응답 — 업로드된 이미지의 CDN 주소 */
+export declare const productImageUploadResultSchema: z.ZodObject<{
+  images: z.ZodArray<z.ZodObject<{
+    url: z.ZodURL;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ProductImageUploadResult = z.infer<typeof productImageUploadResultSchema>;
 export declare const discountSchema: z.ZodObject<{
   productId: z.ZodString;
   discountType: z.ZodEnum<{
@@ -2744,11 +3368,36 @@ export declare const invitationSchema: z.ZodObject<{
   createdAt: z.ZodString;
 }, z.core.$strip>;
 export type Invitation = z.infer<typeof invitationSchema>;
+/** `GET /v1/store/invitations` 쿼리 — OpenAPI 문서용 형태 */
+export declare const invitationListQuerySchema: z.ZodObject<{
+  status: z.ZodOptional<z.ZodEnum<{
+    PENDING: "PENDING";
+    CANCELED: "CANCELED";
+    ACCEPTED: "ACCEPTED";
+    EXPIRED: "EXPIRED";
+  }>>;
+}, z.core.$strip>;
+/** `PATCH /v1/store/members/{userId}` 응답 — 바뀐 역할 */
+export declare const storeMemberRoleUpdatedSchema: z.ZodObject<{
+  userId: z.ZodString;
+  role: z.ZodEnum<{
+    ADMIN: "ADMIN";
+    STAFF: "STAFF";
+  }>;
+}, z.core.$strip>;
+export type StoreMemberRoleUpdated = z.infer<typeof storeMemberRoleUpdatedSchema>;
 export declare const addressTypeSchema: z.ZodEnum<{
   RETURN: "RETURN";
   SHIPPING: "SHIPPING";
 }>;
 export type AddressType = z.infer<typeof addressTypeSchema>;
+/** `GET /v1/seller-addresses` 쿼리 — OpenAPI 문서용 형태. 기본 주소 우선, 그다음 등록순이다 */
+export declare const sellerAddressListQuerySchema: z.ZodObject<{
+  type: z.ZodOptional<z.ZodEnum<{
+    RETURN: "RETURN";
+    SHIPPING: "SHIPPING";
+  }>>;
+}, z.core.$strip>;
 export declare const sellerAddressSchema: z.ZodObject<{
   addressId: z.ZodString;
   type: z.ZodEnum<{
@@ -3933,6 +4582,106 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
     }>;
   };
+  /**
+   * 방문 분석 — 스코프 `analytics:r`. 스토어프런트가 `@sayren/storefront-sdk`로 수집한 이벤트를 Asia/Seoul 날짜별로
+   * 집계한 값이다. 집계는 주기적으로 갱신되고 응답 `lastComputedAt`이 마지막 집계 시각이다. 봇 세션은 빠진다.
+   * 기간은 양끝 포함 최대 92일이고, 테스트 결제 구매는 `includeTest: "true"`일 때만 포함한다.
+   */
+  analytics: {
+    /** `GET /v1/analytics/overview` — 합계·세션 퍼널·날짜별 값 */
+    overview: (params: AnalyticsRangeParams) => Promise<{
+      summary: {
+        visitors: number;
+        sessions: number;
+        engagedSessions: number;
+        pageViews: number;
+        engagementSeconds: number;
+        productViews: number;
+        productViewSessions: number;
+        addToCartSessions: number;
+        beginCheckoutSessions: number;
+        purchaseSessions: number;
+        purchases: number;
+        revenue: number;
+        engagementRate: number | null;
+        conversionRate: number | null;
+      };
+      funnel: {
+        step: "SESSION" | "PRODUCT_VIEW" | "ADD_TO_CART" | "BEGIN_CHECKOUT" | "PURCHASE";
+        sessions: number;
+        rateFromPrevious: number | null;
+      }[];
+      rows: {
+        visitors: number;
+        sessions: number;
+        engagedSessions: number;
+        pageViews: number;
+        engagementSeconds: number;
+        productViews: number;
+        productViewSessions: number;
+        addToCartSessions: number;
+        beginCheckoutSessions: number;
+        purchaseSessions: number;
+        purchases: number;
+        revenue: number;
+        engagementRate: number | null;
+        conversionRate: number | null;
+        date: string;
+      }[];
+      from: string;
+      to: string;
+      timezone: "Asia/Seoul";
+      currency: "KRW";
+      includeTest: boolean;
+      lastComputedAt: string | null;
+    }>;
+    /** `GET /v1/analytics/products` — 상품별 노출·조회·장바구니·구매 */
+    products: (params: AnalyticsProductsParams) => Promise<{
+      sort: "VIEWS" | "ADD_TO_CARTS" | "PURCHASES" | "REVENUE" | "IMPRESSIONS";
+      rows: {
+        productId: string;
+        productName: string | null;
+        impressions: number;
+        views: number;
+        viewSessions: number;
+        addToCarts: number;
+        purchases: number;
+        quantity: number;
+        revenue: number;
+        purchaseRate: number | null;
+      }[];
+      from: string;
+      to: string;
+      timezone: "Asia/Seoul";
+      currency: "KRW";
+      includeTest: boolean;
+      lastComputedAt: string | null;
+    }>;
+    /** `GET /v1/analytics/sources` — 채널·소스·캠페인·기기별 세션과 구매 */
+    sources: (params: AnalyticsSourcesParams) => Promise<{
+      groupBy: "CHANNEL" | "SOURCE" | "CAMPAIGN" | "DEVICE";
+      rows: {
+        channel: "PAID" | "DIRECT" | "CAMPAIGN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | "UNKNOWN" | null;
+        source: string | null;
+        medium: string | null;
+        campaign: string | null;
+        device: "unknown" | "desktop" | "mobile" | "tablet" | null;
+        sessions: number;
+        visitors: number;
+        engagedSessions: number;
+        purchaseSessions: number;
+        purchases: number;
+        revenue: number;
+        conversionRate: number | null;
+      }[];
+      from: string;
+      to: string;
+      timezone: "Asia/Seoul";
+      currency: "KRW";
+      includeTest: boolean;
+      lastComputedAt: string | null;
+    }>;
+  };
   /**
    * 결제 내역 — 스코프 `settlement:r`. 결제 건(세션) 단위이고 주문 목록과 다르다. 주문이 만들어지지 않은
    * 결제(카드 거절·결제창 이탈·승인 결과 확인 중)도 그대로 나온다.
@@ -5053,7 +5802,7 @@ export declare const scopeAccessSchema: z.ZodEnum<{
   rw: "rw";
 }>;
 export type ScopeAccess = z.infer<typeof scopeAccessSchema>;
-/** 리소스별로 부여 가능한 접근 수준. settlement는 쓰기 API가 없어 `r`만 존재한다 */
+/** 리소스별로 부여 가능한 접근 수준. settlement·analytics는 쓰기 API가 없어 `r`만 존재한다 */
 export declare const STORE_SCOPE_RESOURCES: {
   readonly product: readonly ["r", "rw"];
   readonly category: readonly ["r", "rw"];
@@ -5062,6 +5811,7 @@ export declare const STORE_SCOPE_RESOURCES: {
   readonly inquiry: readonly ["r", "rw"];
   readonly review: readonly ["r", "rw"];
   readonly settlement: readonly ["r"];
+  readonly analytics: readonly ["r"];
   readonly webhook: readonly ["r", "rw"];
   readonly store: readonly ["r", "rw"];
   readonly member: readonly ["r", "rw"];
@@ -5075,6 +5825,7 @@ export declare const storeScopeResourceSchema: z.ZodEnum<{
   inquiry: "inquiry";
   review: "review";
   settlement: "settlement";
+  analytics: "analytics";
   webhook: "webhook";
   store: "store";
   member: "member";
@@ -5087,8 +5838,8 @@ export declare function isStoreScope(scope: string): boolean;
  * 발급 시 지정한 스코프만 갖는다(발급자 보유 스코프 이내).
  */
 export declare const STORE_ROLE_SCOPES: {
-  readonly OWNER: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "settlement:r", "webhook:rw", "store:rw", "member:rw"];
-  readonly ADMIN: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "webhook:rw", "store:rw", "member:rw"];
+  readonly OWNER: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "settlement:r", "analytics:r", "webhook:rw", "store:rw", "member:rw"];
+  readonly ADMIN: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "analytics:r", "webhook:rw", "store:rw", "member:rw"];
   readonly STAFF: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw"];
 };
 //#endregion