@sayren/store-sdk 0.1.0 → 0.1.1

package/src/schemas/common.ts

@@ -13,6 +13,18 @@ export function pageSchema<T extends z.ZodType>(item: T) {
   return pageInfoSchema.extend({ contents: z.array(item) });
 }
 
+/**
+ * 목록 쿼리의 `page`·`size` — OpenAPI 문서용 형태(값은 쿼리 문자열). 서버는 숫자가 아니거나 범위를 벗어난
+ * 값을 기본값·상한으로 보정한다.
+ */
+export function pageQueryShape(options: { defaultSize?: number; maxSize?: number } = {}) {
+  const { defaultSize = 20, maxSize = 100 } = options;
+  return {
+    page: z.string().optional().describe("페이지 번호 (1부터, 기본 1)"),
+    size: z.string().optional().describe(`페이지 크기 (기본 ${defaultSize}, 최대 ${maxSize})`),
+  };
+}
+
 export interface PageParams {
   page?: number;
   size?: number;

package/src/schemas/misc.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { PageParams } from "./common";
+import { type PageParams, pageQueryShape } from "./common";
 
 export const inquirySchema = z.object({
   inquiryId: z.string(),
@@ -54,6 +54,27 @@ export const sellerCustomerInquirySchema = z.object({
 
 export type SellerCustomerInquiry = z.infer<typeof sellerCustomerInquirySchema>;
 
+const answeredQuery = z
+  .enum(["true", "false"])
+  .optional()
+  .describe("답변 여부 필터. `true`면 답변된 문의만, `false`면 미답변만, 생략하면 전부");
+
+/** `GET /v1/inquiries` 쿼리(상품 문의) — OpenAPI 문서용 형태(값은 쿼리 문자열). 최신순이다 */
+export const inquiryListQuerySchema = z.object({
+  answered: answeredQuery,
+  productId: z.string().optional().describe("상품 id 필터"),
+  from: z.string().optional().describe("작성 시각 조회 시작 (ISO 8601, 포함)"),
+  ...pageQueryShape(),
+});
+
+/** `GET /v1/customer-inquiries` 쿼리(1:1 문의) — OpenAPI 문서용 형태(값은 쿼리 문자열). 최신순이다 */
+export const customerInquiryListQuerySchema = z.object({
+  answered: answeredQuery,
+  category: customerInquiryCategorySchema.optional().describe("문의 유형 필터"),
+  from: z.string().optional().describe("작성 시각 조회 시작 (ISO 8601, 포함)"),
+  ...pageQueryShape(),
+});
+
 export const settlementStatusSchema = z.enum(["SCHEDULED", "PAID", "HELD"]);
 
 export type SettlementStatus = z.infer<typeof settlementStatusSchema>;
@@ -88,6 +109,29 @@ export const settlementDetailSchema = z.object({
 
 export type SettlementDetail = z.infer<typeof settlementDetailSchema>;
 
+/** `GET /v1/settlements/{settlementId}` 응답 — 정산 요약 + 상세 내역(`size`건까지) */
+export const settlementWithDetailsSchema = settlementSummarySchema.extend({
+  details: z.array(settlementDetailSchema).optional(),
+});
+
+export type SettlementWithDetails = z.infer<typeof settlementWithDetailsSchema>;
+
+/** `GET /v1/settlements` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열). 정산일 최신순이다 */
+export const settlementListQuerySchema = z.object({
+  from: z.string().describe("정산일 조회 시작 (ISO 8601, 포함). 필수"),
+  to: z
+    .string()
+    .optional()
+    .describe("정산일 조회 끝 (ISO 8601, 포함). 생략하면 from부터 31일. 기간은 최대 31일"),
+  status: settlementStatusSchema.optional().describe("정산 상태 필터"),
+  ...pageQueryShape(),
+});
+
+/** `GET /v1/settlements/{settlementId}` 쿼리 — `size`는 돌려줄 상세 내역 건수다(`page`는 무시) */
+export const settlementDetailQuerySchema = z.object(
+  pageQueryShape({ defaultSize: 100, maxSize: 300 }),
+);
+
 export interface SettlementListParams extends PageParams {
   from: string;
   to?: string;
@@ -288,11 +332,42 @@ export const reviewSchema = z.object({
 
 export type Review = z.infer<typeof reviewSchema>;
 
+export const reviewSortSchema = z.enum([
+  "createdAt.desc",
+  "createdAt.asc",
+  "rating.asc",
+  "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 const reviewListQuerySchema = z.object({
+  productId: z.string().optional().describe("상품 id 필터"),
+  rating: z.enum(["1", "2", "3", "4", "5"]).optional().describe("별점 필터 (일치)"),
+  replied: z
+    .enum(["true", "false"])
+    .optional()
+    .describe("답글 여부 필터. `true`면 답글 단 리뷰만, `false`면 답글 없는 리뷰만"),
+  hasImage: z.enum(["true", "false"]).optional().describe("`true`면 이미지가 있는 리뷰만"),
+  from: z.string().optional().describe("작성 시각 조회 시작 (ISO 8601, 포함)"),
+  sort: reviewSortSchema.optional().describe("정렬 (기본 createdAt.desc)"),
+  ...pageQueryShape(),
+});
+
+/** `POST /v1/reviews/{reviewId}/report` 응답(202) — 신고 접수 */
+export const reviewReportResultSchema = z.object({
+  reviewId: z.string(),
+  status: z.literal("PENDING_REVIEW"),
+});
+
+export type ReviewReportResult = z.infer<typeof reviewReportResultSchema>;

package/src/schemas/order.ts

@@ -209,6 +209,24 @@ export const deliveryInfoSchema = z.object({
 
 export type DeliveryInfo = z.infer<typeof deliveryInfoSchema>;
 
+/** `GET /v1/order-items/{orderItemId}/delivery` 응답 — 배송 정보 + 배송 추적 이벤트 */
+export const deliveryStatusSchema = deliveryInfoSchema.extend({
+  trackingEvents: z
+    .array(z.object({ status: z.string(), location: z.string(), occurredAt: z.string() }))
+    .optional(),
+});
+
+export type DeliveryStatus = z.infer<typeof deliveryStatusSchema>;
+
+/** `PUT /v1/order-items/{orderItemId}/dispatch/tracking` 응답 — 바뀐 송장 */
+export const trackingUpdateResultSchema = z.object({
+  orderItemId: z.string(),
+  carrierCode: z.string(),
+  trackingNumber: z.string(),
+});
+
+export type TrackingUpdateResult = z.infer<typeof trackingUpdateResultSchema>;
+
 export const carrierSchema = z.object({
   carrierCode: z.string(),
   name: z.string(),
@@ -231,3 +249,45 @@ export const cancelBySellerRequestSchema = z.object({
 });
 
 export type CancelBySellerRequest = z.infer<typeof cancelBySellerRequestSchema>;
+
+/** `POST /v1/order-items/{orderItemId}/cancel` 응답 — 셀러 직권취소 환불 결과 */
+export const cancelBySellerResultSchema = z.object({
+  orderItemId: z.string(),
+  refundAmount: z.number().int(),
+  refundedAt: z.string(),
+});
+
+export type CancelBySellerResult = z.infer<typeof cancelBySellerResultSchema>;
+
+/** `PUT /v1/order-items/{orderItemId}/memo` 응답 — 빈 문자열로 저장하면 메모가 지워져 `null`이다 */
+export const orderItemMemoResultSchema = z.object({
+  orderItemId: z.string(),
+  sellerMemo: z.string().nullable(),
+});
+
+export type OrderItemMemoResult = z.infer<typeof orderItemMemoResultSchema>;
+
+/** `POST /v1/order-items/{orderItemId}/purchase-decision/request` 응답 */
+export const purchaseDecisionRequestResultSchema = z.object({
+  orderItemId: z.string(),
+  requestedAt: z.string(),
+});
+
+export type PurchaseDecisionRequestResult = z.infer<typeof purchaseDecisionRequestResultSchema>;
+
+/** `POST /v1/order-items/{orderItemId}/purchase-decision/extend` 응답 — 연장은 최대 2회 */
+export const purchaseDecisionExtendResultSchema = z.object({
+  orderItemId: z.string(),
+  autoDecisionDate: z.string(),
+  extendCount: z.number().int().max(2),
+});
+
+export type PurchaseDecisionExtendResult = z.infer<typeof purchaseDecisionExtendResultSchema>;
+
+/**
+ * `GET /v1/orders/{orderId}/address-change-requests` 응답 — 배송지 변경 요청 플로우는 아직 제공하지 않아
+ * 현재는 항상 빈 배열이다
+ */
+export const addressChangeRequestListSchema = z
+  .array(z.record(z.string(), z.unknown()))
+  .describe("배송지 변경 요청 목록 (현재 항상 빈 배열)");

package/src/schemas/product.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { PageParams } from "./common";
+import { type PageParams, pageQueryShape } from "./common";
 
 export const productStatusSchema = z.enum(["SALE", "SUSPENDED", "OUT_OF_STOCK", "CLOSED"]);
 
@@ -234,12 +234,15 @@ export const productPatchRequestSchema = z
 
 export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
 
-export type ProductSort =
-  | "createdAt.desc"
-  | "createdAt.asc"
-  | "salePrice.asc"
-  | "salePrice.desc"
-  | "updatedAt.desc";
+export const productSortSchema = z.enum([
+  "createdAt.desc",
+  "createdAt.asc",
+  "salePrice.asc",
+  "salePrice.desc",
+  "updatedAt.desc",
+]);
+
+export type ProductSort = z.infer<typeof productSortSchema>;
 
 export interface ProductListParams extends PageParams {
   status?: ProductStatus;
@@ -249,6 +252,26 @@ export interface ProductListParams extends PageParams {
   sort?: ProductSort;
 }
 
+/** `GET /v1/products` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
+export const productListQuerySchema = z.object({
+  status: productStatusSchema.optional().describe("판매 상태 필터"),
+  categoryId: z.string().optional().describe("카테고리 필터 — 하위 카테고리의 상품도 포함"),
+  keyword: z.string().optional().describe("상품명 검색 (포함)"),
+  sellerCode: z
+    .string()
+    .optional()
+    .describe("판매자 상품코드 — 이 코드가 붙은 variant를 가진 상품"),
+  sort: productSortSchema.optional().describe("정렬 (기본 createdAt.desc)"),
+  ...pageQueryShape(),
+});
+
+/** `POST /v1/product-images` 응답 — 업로드된 이미지의 CDN 주소 */
+export const productImageUploadResultSchema = z.object({
+  images: z.array(z.object({ url: z.url(), width: z.number().int(), height: z.number().int() })),
+});
+
+export type ProductImageUploadResult = z.infer<typeof productImageUploadResultSchema>;
+
 export const discountSchema = z.object({
   productId: z.string(),
   discountType: z.enum(["RATE", "AMOUNT"]),

package/src/schemas/store.ts

@@ -111,10 +111,28 @@ export const invitationSchema = z.object({
 
 export type Invitation = z.infer<typeof invitationSchema>;
 
+/** `GET /v1/store/invitations` 쿼리 — OpenAPI 문서용 형태 */
+export const invitationListQuerySchema = z.object({
+  status: invitationSchema.shape.status.optional().describe("초대 상태 필터"),
+});
+
+/** `PATCH /v1/store/members/{userId}` 응답 — 바뀐 역할 */
+export const storeMemberRoleUpdatedSchema = z.object({
+  userId: z.string(),
+  role: z.enum(["ADMIN", "STAFF"]),
+});
+
+export type StoreMemberRoleUpdated = z.infer<typeof storeMemberRoleUpdatedSchema>;
+
 export const addressTypeSchema = z.enum(["SHIPPING", "RETURN"]);
 
 export type AddressType = z.infer<typeof addressTypeSchema>;
 
+/** `GET /v1/seller-addresses` 쿼리 — OpenAPI 문서용 형태. 기본 주소 우선, 그다음 등록순이다 */
+export const sellerAddressListQuerySchema = z.object({
+  type: addressTypeSchema.optional().describe("주소 유형 필터"),
+});
+
 export const sellerAddressSchema = z.object({
   addressId: z.string(),
   type: addressTypeSchema,