@sayren/store-sdk 0.1.0 → 0.2.0

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/scope.ts

@@ -14,7 +14,7 @@ export const scopeAccessSchema = z
   .describe("접근 수준. `r`=읽기, `rw`=읽기+쓰기(r을 함의)");
 export type ScopeAccess = z.infer<typeof scopeAccessSchema>;
 
-/** 리소스별로 부여 가능한 접근 수준. settlement는 쓰기 API가 없어 `r`만 존재한다 */
+/** 리소스별로 부여 가능한 접근 수준. settlement·analytics는 쓰기 API가 없어 `r`만 존재한다 */
 export const STORE_SCOPE_RESOURCES = {
   product: ["r", "rw"],
   category: ["r", "rw"],
@@ -23,6 +23,7 @@ export const STORE_SCOPE_RESOURCES = {
   inquiry: ["r", "rw"],
   review: ["r", "rw"],
   settlement: ["r"],
+  analytics: ["r"],
   webhook: ["r", "rw"],
   store: ["r", "rw"],
   member: ["r", "rw"],
@@ -56,6 +57,7 @@ export const STORE_ROLE_SCOPES = {
     "inquiry:rw",
     "review:rw",
     "settlement:r",
+    "analytics:r",
     "webhook:rw",
     "store:rw",
     "member:rw",
@@ -67,6 +69,7 @@ export const STORE_ROLE_SCOPES = {
     "claim:rw",
     "inquiry:rw",
     "review:rw",
+    "analytics:r",
     "webhook:rw",
     "store:rw",
     "member:rw",

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,