@sayren/store-sdk 0.1.0 → 0.1.1

package/dist/index.d.mts

@@ -543,6 +543,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 +583,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 +721,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 +900,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 +968,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 +1251,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 +1652,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 +1713,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 +2975,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 +2990,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 +3104,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<{