@sayren/store-sdk 0.41.0 → 0.42.0

package/src/schemas/product.ts

@@ -23,6 +23,7 @@ import {
 } from "./product-info";
 import { productRefundPolicyPatchSchema } from "./refund-policy";
 import { inventoryModeSchema } from "./stay";
+import { strictRequest } from "./strict";
 import { UPLOAD_PURPOSE_LIMITS, uploadExtensionOf } from "./upload";
 
 export const productStatusSchema = z.enum(["SALE", "SUSPENDED", "OUT_OF_STOCK", "CLOSED"]);
@@ -301,7 +302,7 @@ export function customInputLabelForbiddenWord(label: string): string | null {
 /** 옵션명·값 이름 — 앞뒤 공백을 지우고 빈 값은 받지 않는다 */
 const optionNameSchema = z.string().trim().min(1).max(50);
 
-export const addonValueRequestSchema = z.object({
+export const addonValueRequestSchema = z.strictObject({
   /** 전달 시 기존 값 행을 유지(UPDATE). 생략하면 신규 발급 */
   valueId: z.string().optional(),
   name: optionNameSchema,
@@ -312,7 +313,7 @@ export const addonValueRequestSchema = z.object({
 
 export type AddonValueRequest = z.infer<typeof addonValueRequestSchema>;
 
-export const addonGroupRequestSchema = z.object({
+export const addonGroupRequestSchema = z.strictObject({
   /** 전달 시 기존 옵션명 행을 유지(UPDATE). 조합 옵션명의 id는 줄 수 없다(방식을 바꾸려면 새 옵션명으로 보낸다) */
   groupId: z.string().optional(),
   name: optionNameSchema,
@@ -322,7 +323,7 @@ export const addonGroupRequestSchema = z.object({
 
 export type AddonGroupRequest = z.infer<typeof addonGroupRequestSchema>;
 
-export const customInputRequestSchema = z.object({
+export const customInputRequestSchema = z.strictObject({
   /** 전달 시 기존 항목 행을 유지(UPDATE). 생략하면 신규 발급 */
   inputId: z.string().optional(),
   label: z.string().trim().min(1).max(30),
@@ -545,7 +546,7 @@ export function productImageRejection(url: string): ProductImageRejection | null
  */
 const codeSchema = z.string().trim().min(1).max(64);
 
-export const optionValueRequestSchema = z.object({
+export const optionValueRequestSchema = z.strictObject({
   /** 전달 시 기존 값 행을 유지(UPDATE). 생략하면 신규 발급 */
   valueId: z.string().optional(),
   name: z.string().min(1).max(50),
@@ -553,7 +554,7 @@ export const optionValueRequestSchema = z.object({
 
 export type OptionValueRequest = z.infer<typeof optionValueRequestSchema>;
 
-export const optionGroupRequestSchema = z.object({
+export const optionGroupRequestSchema = z.strictObject({
   /** 전달 시 기존 축 행을 유지(UPDATE). 생략하면 신규 발급 */
   groupId: z.string().optional(),
   name: z.string().min(1).max(50),
@@ -562,7 +563,7 @@ export const optionGroupRequestSchema = z.object({
 
 export type OptionGroupRequest = z.infer<typeof optionGroupRequestSchema>;
 
-export const productVariantRequestSchema = z.object({
+export const productVariantRequestSchema = z.strictObject({
   /** 기존 variant 유지 시 전달. 생략하면 신규 생성 */
   variantId: z.string().optional(),
   /** optionGroups 순서대로 각 축에서 고른 값 이름. 서버가 이름 → valueId를 해석한다 */
@@ -593,7 +594,7 @@ export const productVariantRequestSchema = z.object({
 export type ProductVariantRequest = z.infer<typeof productVariantRequestSchema>;
 
 /** 축 × 값 → variant 전체 교체 요청 (PUT /products/{productId}/options) */
-export const optionModelRequestSchema = z.object({
+export const optionModelRequestSchema = z.strictObject({
   optionGroups: z.array(optionGroupRequestSchema).max(MAX_OPTION_GROUPS).default([]),
   variants: z.array(productVariantRequestSchema).min(1).max(MAX_VARIANTS),
   addonGroups: z
@@ -719,7 +720,7 @@ const productWriteShape = {
   images: productImagesRequestSchema
     .optional()
     .describe("상품 이미지 주소 목록. 첫 장이 대표 이미지(썸네일)다"),
-  attributes: z.array(z.object({ attributeId: z.string(), value: z.string() })).optional(),
+  attributes: z.array(z.strictObject({ attributeId: z.string(), value: z.string() })).optional(),
   refundPolicy: productRefundPolicyPatchSchema
     .nullish()
     .describe(
@@ -870,12 +871,14 @@ export const productListQuerySchema = z.object({
   ...pageQueryShape(),
 });
 
-export const discountRequestSchema = z.object({
-  discountType: z.enum(["RATE", "AMOUNT"]),
-  discountValue: z.number().int().min(1),
-  startAt: z.string().optional(),
-  endAt: z.string().optional(),
-});
+export const discountRequestSchema = strictRequest(
+  z.object({
+    discountType: z.enum(["RATE", "AMOUNT"]),
+    discountValue: z.number().int().min(1),
+    startAt: z.string().optional(),
+    endAt: z.string().optional(),
+  }),
+);
 
 export type DiscountRequest = z.infer<typeof discountRequestSchema>;
 

package/src/schemas/saved-option-set.ts

@@ -75,12 +75,12 @@ export const savedOptionSetSchema = z.object({
 
 export type SavedOptionSet = z.infer<typeof savedOptionSetSchema>;
 
-export const savedOptionValueRequestSchema = z.object({
+export const savedOptionValueRequestSchema = z.strictObject({
   name: nameSchema,
   additionalPrice: z.number().int().min(0).default(0),
 });
 
-export const savedOptionGroupRequestSchema = z.object({
+export const savedOptionGroupRequestSchema = z.strictObject({
   name: nameSchema,
   kind: optionGroupKindSchema,
   required: z
@@ -92,7 +92,7 @@ export const savedOptionGroupRequestSchema = z.object({
 
 export type SavedOptionGroupRequest = z.infer<typeof savedOptionGroupRequestSchema>;
 
-export const savedCustomInputRequestSchema = z.object({
+export const savedCustomInputRequestSchema = z.strictObject({
   label: z.string().trim().min(1).max(30),
   placeholder: z.string().trim().max(100).nullish(),
   maxLength: z.number().int().min(1).max(MAX_CUSTOM_INPUT_LENGTH),
@@ -107,7 +107,7 @@ export const savedCustomInputRequestSchema = z.object({
  * 저장 옵션 만들기·수정 본문. 조합 옵션명은 최대 `MAX_OPTION_GROUPS`개, 추가 선택은 최대 `MAX_ADDON_GROUPS`개이고
  * 옵션명과 직접 입력 항목이 모두 비면 400이다. 수정(PUT)은 통째로 바꾼다.
  */
-export const savedOptionSetRequestSchema = z.object({
+export const savedOptionSetRequestSchema = z.strictObject({
   name: z.string().trim().min(1).max(MAX_SAVED_OPTION_SET_NAME),
   optionSort: optionSortSchema.default("REGISTERED"),
   groups: z
@@ -126,7 +126,7 @@ export type SavedOptionSetRequestInput = z.input<typeof savedOptionSetRequestSch
  * 조합 추가금이 값별 추가금의 합으로 되돌려지면 값별로 저장하고, 조합마다 제각각이면 추가금을 빼고
  * 응답 `additionalPriceDropped: true`로 알린다. `replaceOptionSetId`를 주면 그 저장 옵션을 덮어쓴다(이름 중복의 덮어쓰기).
  */
-export const savedOptionSetFromProductRequestSchema = z.object({
+export const savedOptionSetFromProductRequestSchema = z.strictObject({
   productId: z.string(),
   name: z.string().trim().min(1).max(MAX_SAVED_OPTION_SET_NAME),
   includeOptions: z.boolean().default(true).describe("옵션명(조합·추가 선택)을 저장하는가"),

package/src/schemas/starter.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { strictRequest } from "./strict";
 
 /**
  * 쇼핑몰 시작(starter, 이슈 #122) — 원격 MCP의 starter 절차가 쓰는 브랜드 브리프와 진행 상태.
@@ -70,18 +71,20 @@ export const brandBriefSchema = z.object({
 export type BrandBrief = z.infer<typeof brandBriefSchema>;
 
 /** `PUT /v1/storefront/brand-brief` — 브리프 전체를 바꾼다. 생략한 항목은 비운다 */
-export const putBrandBriefRequestSchema = z.object({
-  industry: storeIndustrySchema.nullable().default(null),
-  mood: z.string().trim().max(200).nullable().default(null),
-  pointColor: z
-    .string()
-    .regex(/^#[0-9a-fA-F]{6}$/, "#RRGGBB 형식이어야 합니다")
-    .nullable()
-    .default(null),
-  references: z.array(brandBriefReferenceSchema).max(BRAND_BRIEF_MAX_REFERENCES).default([]),
-  productSource: brandBriefProductSourceSchema.nullable().default(null),
-  notes: z.string().trim().max(4000).nullable().default(null),
-});
+export const putBrandBriefRequestSchema = strictRequest(
+  z.object({
+    industry: storeIndustrySchema.nullable().default(null),
+    mood: z.string().trim().max(200).nullable().default(null),
+    pointColor: z
+      .string()
+      .regex(/^#[0-9a-fA-F]{6}$/, "#RRGGBB 형식이어야 합니다")
+      .nullable()
+      .default(null),
+    references: z.array(brandBriefReferenceSchema).max(BRAND_BRIEF_MAX_REFERENCES).default([]),
+    productSource: brandBriefProductSourceSchema.nullable().default(null),
+    notes: z.string().trim().max(4000).nullable().default(null),
+  }),
+);
 export type PutBrandBriefRequest = z.input<typeof putBrandBriefRequestSchema>;
 
 /** `GET·PUT /v1/storefront/brand-brief` 응답 — 저장한 적이 없으면 `brief`·`updatedAt`이 null이다 */

package/src/schemas/stay.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { strictRequest } from "./strict";
 
 /**
  * 날짜별 재고·가격(이슈 #118) — 숙박·회차처럼 날짜마다 재고와 가격이 다른 상품. 상품 `inventoryMode: "DATED"`이면 조합(객실) × 날짜
@@ -75,16 +76,18 @@ export const calendarQuerySchema = z.object({
  * 달력 설정 — 기간의 날짜마다 재고·가격을 덮어쓴다(없는 날은 만든다). `stock`·`price`는 준 것만 바꾸고, `price: null`은 조합 가격으로
  * 되돌린다. `daysOfWeek`(0=일~6=토)를 주면 그 요일만 바꾼다
  */
-export const setCalendarRequestSchema = z
-  .object({
-    variantIds: z.array(z.string()).min(1).max(50),
-    from: calendarDateSchema,
-    to: calendarDateSchema,
-    stock: z.number().int().min(0).max(100_000).optional(),
-    price: z.number().int().min(0).multipleOf(10).nullable().optional(),
-    daysOfWeek: z.array(z.number().int().min(0).max(6)).min(1).max(7).optional(),
-  })
-  .refine((value) => value.stock !== undefined || value.price !== undefined, {
-    message: "stock이나 price 중 하나는 있어야 합니다",
-  });
+export const setCalendarRequestSchema = strictRequest(
+  z
+    .object({
+      variantIds: z.array(z.string()).min(1).max(50),
+      from: calendarDateSchema,
+      to: calendarDateSchema,
+      stock: z.number().int().min(0).max(100_000).optional(),
+      price: z.number().int().min(0).multipleOf(10).nullable().optional(),
+      daysOfWeek: z.array(z.number().int().min(0).max(6)).min(1).max(7).optional(),
+    })
+    .refine((value) => value.stock !== undefined || value.price !== undefined, {
+      message: "stock이나 price 중 하나는 있어야 합니다",
+    }),
+);
 export type SetCalendarRequest = z.input<typeof setCalendarRequestSchema>;

package/src/schemas/store.ts

@@ -3,6 +3,7 @@ import { storeRoleSchema } from "./auth";
 import { localeCodeSchema } from "./locale";
 import { refundPolicyPatchSchema, refundPolicySchema } from "./refund-policy";
 import { shippingPolicyPatchSchema, shippingPolicySchema } from "./shipping-policy";
+import { strictRequest } from "./strict";
 
 /**
  * 상점 코드 규칙 — 스토어프론트 API가 테넌트를 가르는 값이다(`X-Store-Code` 헤더).
@@ -227,96 +228,98 @@ const autoConfirmDaysDescription =
   "그 날짜가 지나면 구매확정(`PURCHASE_DECIDED`)으로 바꾼다. 진행 중인 클레임이 있으면 건너뛴다. `0`이면 자동 구매확정을 하지 않는다";
 
 /** `PATCH /v1/store` 본문 — 바꿀 필드만 보낸다 */
-export const updateStoreRequestSchema = z
-  .object({
-    name: z.string().min(2).max(50).optional(),
-    logoUrl: z.url().optional(),
-    customerCenterPhone: z
-      .string()
-      .nullable()
-      .optional()
-      .describe("고객센터 전화번호. `null`을 주면 지운다"),
-    businessHours: z.string().max(100).optional(),
-    ...businessInfoPatchShape,
-    analyticsAllowedOrigins: z
-      .array(analyticsOriginSchema)
-      .max(MAX_ANALYTICS_ALLOWED_ORIGINS)
-      .optional()
-      .describe(
-        "@deprecated `storefrontOrigins`를 쓴다(같은 목록). 방문 분석 수집을 받을 스토어프론트 오리진(최대 20개). 비우면 모든 오리진에서 받는다. " +
-          "넣으면 목록에 없는 오리진의 수집 요청은 403 `ORIGIN_NOT_ALLOWED`이고, 페이지 URL이 목록 밖인 이벤트는 버린다",
-      ),
-    storefrontOrigins: z
-      .array(analyticsOriginSchema)
-      .max(MAX_ANALYTICS_ALLOWED_ORIGINS)
-      .optional()
-      .describe(
-        "스토어프론트 도메인(최대 20개) — 소셜 로그인 뒤 돌아갈 주소와 방문 분석 수집을 함께 제한한다. " +
-          "`analyticsAllowedOrigins`와 같은 목록이다(둘 다 주면 이 값이 이긴다)",
-      ),
-    guestCheckoutEnabled: z
-      .boolean()
-      .optional()
-      .describe(
-        "비회원 주문 허용. false(회원만)면 로그인하지 않은 구매자의 주문서 생성·결제 요청이 403 `GUEST_CHECKOUT_DISABLED`다. " +
-          "장바구니 담기와 이미 받은 비회원 주문의 조회·취소는 막지 않는다",
-      ),
-    testOrderReviewsAllowed: z
-      .boolean()
-      .optional()
-      .describe(
-        "테스트 결제(샌드박스) 주문의 리뷰 허용. 기본 false — 돈을 내지 않은 주문으로 구매 인증 리뷰가 쌓이지 않게 막는다",
-      ),
-    autoDeliverDays: z
-      .number()
-      .int()
-      .min(0)
-      .max(MAX_AUTO_TRANSITION_DAYS)
-      .optional()
-      .describe(autoDeliverDaysDescription),
-    autoConfirmDays: z
-      .number()
-      .int()
-      .min(0)
-      .max(MAX_AUTO_TRANSITION_DAYS)
-      .optional()
-      .describe(autoConfirmDaysDescription),
-    refundPolicy: refundPolicyPatchSchema
-      .optional()
-      .describe(
-        "상점 기본 환불 정책 — 준 항목만 바꾼다. 상품별 정책(`products.refundPolicy`)이 없는 상품에 적용된다",
-      ),
-    shippingPolicy: shippingPolicyPatchSchema
-      .optional()
-      .describe(
-        "상점 배송비 규칙 — 준 항목만 바꾼다. 기본 배송비, 전체 무료배송 기준액, 제주·도서산간 추가 배송비다. " +
-          "바꾼 값은 **새 주문서부터** 적용된다(이미 만든 주문서·주문의 배송비는 스냅샷이 원천이다)",
-      ),
-    termsVersion: policyVersionSchema
-      .optional()
-      .describe(
-        "이용약관 버전. 올리면 이 약관에 동의한 구매자에게 재동의를 요구한다(`GET /storefront/v1/me`의 `reconsentRequired`)",
-      ),
-    privacyVersion: policyVersionSchema
-      .optional()
-      .describe("개인정보 수집이용 동의 버전. 올리면 구매자에게 재동의를 요구한다"),
-    termsUrl: policyDocumentUrlSchema
-      .optional()
-      .describe(
-        "이용약관 문서 주소(https). 동의 시점의 값이 동의 이력에 복사된다. `null`을 주면 지운다",
-      ),
-    privacyUrl: policyDocumentUrlSchema
-      .optional()
-      .describe("개인정보 수집이용 동의 문서 주소(https). `null`을 주면 지운다"),
-    defaultLocale: localeCodeSchema
-      .optional()
-      .describe(
-        "상점 기본 언어(이슈 #134). 상품·카테고리 필드가 이 언어 값이고 번역이 없는 칸은 이 값으로 보인다. 바꿔도 저장된 값은 그대로다",
-      ),
-  })
-  .refine((value) => Object.values(value).some((v) => v !== undefined), {
-    message: "최소 1개 필드가 필요합니다",
-  });
+export const updateStoreRequestSchema = strictRequest(
+  z
+    .object({
+      name: z.string().min(2).max(50).optional(),
+      logoUrl: z.url().optional(),
+      customerCenterPhone: z
+        .string()
+        .nullable()
+        .optional()
+        .describe("고객센터 전화번호. `null`을 주면 지운다"),
+      businessHours: z.string().max(100).optional(),
+      ...businessInfoPatchShape,
+      analyticsAllowedOrigins: z
+        .array(analyticsOriginSchema)
+        .max(MAX_ANALYTICS_ALLOWED_ORIGINS)
+        .optional()
+        .describe(
+          "@deprecated `storefrontOrigins`를 쓴다(같은 목록). 방문 분석 수집을 받을 스토어프론트 오리진(최대 20개). 비우면 모든 오리진에서 받는다. " +
+            "넣으면 목록에 없는 오리진의 수집 요청은 403 `ORIGIN_NOT_ALLOWED`이고, 페이지 URL이 목록 밖인 이벤트는 버린다",
+        ),
+      storefrontOrigins: z
+        .array(analyticsOriginSchema)
+        .max(MAX_ANALYTICS_ALLOWED_ORIGINS)
+        .optional()
+        .describe(
+          "스토어프론트 도메인(최대 20개) — 소셜 로그인 뒤 돌아갈 주소와 방문 분석 수집을 함께 제한한다. " +
+            "`analyticsAllowedOrigins`와 같은 목록이다(둘 다 주면 이 값이 이긴다)",
+        ),
+      guestCheckoutEnabled: z
+        .boolean()
+        .optional()
+        .describe(
+          "비회원 주문 허용. false(회원만)면 로그인하지 않은 구매자의 주문서 생성·결제 요청이 403 `GUEST_CHECKOUT_DISABLED`다. " +
+            "장바구니 담기와 이미 받은 비회원 주문의 조회·취소는 막지 않는다",
+        ),
+      testOrderReviewsAllowed: z
+        .boolean()
+        .optional()
+        .describe(
+          "테스트 결제(샌드박스) 주문의 리뷰 허용. 기본 false — 돈을 내지 않은 주문으로 구매 인증 리뷰가 쌓이지 않게 막는다",
+        ),
+      autoDeliverDays: z
+        .number()
+        .int()
+        .min(0)
+        .max(MAX_AUTO_TRANSITION_DAYS)
+        .optional()
+        .describe(autoDeliverDaysDescription),
+      autoConfirmDays: z
+        .number()
+        .int()
+        .min(0)
+        .max(MAX_AUTO_TRANSITION_DAYS)
+        .optional()
+        .describe(autoConfirmDaysDescription),
+      refundPolicy: refundPolicyPatchSchema
+        .optional()
+        .describe(
+          "상점 기본 환불 정책 — 준 항목만 바꾼다. 상품별 정책(`products.refundPolicy`)이 없는 상품에 적용된다",
+        ),
+      shippingPolicy: shippingPolicyPatchSchema
+        .optional()
+        .describe(
+          "상점 배송비 규칙 — 준 항목만 바꾼다. 기본 배송비, 전체 무료배송 기준액, 제주·도서산간 추가 배송비다. " +
+            "바꾼 값은 **새 주문서부터** 적용된다(이미 만든 주문서·주문의 배송비는 스냅샷이 원천이다)",
+        ),
+      termsVersion: policyVersionSchema
+        .optional()
+        .describe(
+          "이용약관 버전. 올리면 이 약관에 동의한 구매자에게 재동의를 요구한다(`GET /storefront/v1/me`의 `reconsentRequired`)",
+        ),
+      privacyVersion: policyVersionSchema
+        .optional()
+        .describe("개인정보 수집이용 동의 버전. 올리면 구매자에게 재동의를 요구한다"),
+      termsUrl: policyDocumentUrlSchema
+        .optional()
+        .describe(
+          "이용약관 문서 주소(https). 동의 시점의 값이 동의 이력에 복사된다. `null`을 주면 지운다",
+        ),
+      privacyUrl: policyDocumentUrlSchema
+        .optional()
+        .describe("개인정보 수집이용 동의 문서 주소(https). `null`을 주면 지운다"),
+      defaultLocale: localeCodeSchema
+        .optional()
+        .describe(
+          "상점 기본 언어(이슈 #134). 상품·카테고리 필드가 이 언어 값이고 번역이 없는 칸은 이 값으로 보인다. 바꿔도 저장된 값은 그대로다",
+        ),
+    })
+    .refine((value) => Object.values(value).some((v) => v !== undefined), {
+      message: "최소 1개 필드가 필요합니다",
+    }),
+);
 export type UpdateStoreRequest = z.infer<typeof updateStoreRequestSchema>;
 
 export const storeSchema = z.object({
@@ -423,17 +426,21 @@ export const invitationSchema = z.object({
 export type Invitation = z.infer<typeof invitationSchema>;
 
 /** `POST /v1/store/invitations` 요청 — ADMIN 초대는 OWNER만 할 수 있다 */
-export const inviteMemberRequestSchema = z.object({
-  email: z.email(),
-  role: z.enum(["ADMIN", "STAFF"]),
-});
+export const inviteMemberRequestSchema = strictRequest(
+  z.object({
+    email: z.email(),
+    role: z.enum(["ADMIN", "STAFF"]),
+  }),
+);
 
 export type InviteMemberRequest = z.infer<typeof inviteMemberRequestSchema>;
 
 /** `PATCH /v1/store/members/{userId}` 요청 */
-export const updateMemberRoleRequestSchema = z.object({
-  role: z.enum(["ADMIN", "STAFF"]),
-});
+export const updateMemberRoleRequestSchema = strictRequest(
+  z.object({
+    role: z.enum(["ADMIN", "STAFF"]),
+  }),
+);
 
 export type UpdateMemberRoleRequest = z.infer<typeof updateMemberRoleRequestSchema>;
 
@@ -484,19 +491,23 @@ export const sellerAddressSchema = z.object({
 
 export type SellerAddress = z.infer<typeof sellerAddressSchema>;
 
-export const sellerAddressRequestSchema = z.object({
-  type: addressTypeSchema,
-  name: z.string().min(1).max(50),
-  contactName: z.string().min(1),
-  phone: z.string().regex(/^01[0-9]{8,9}$/),
-  zipCode: z.string().regex(/^[0-9]{5}$/),
-  address1: z.string().min(1),
-  address2: z.string().optional(),
-  inventoryLocationId: z
-    .string()
-    .min(1)
-    .optional()
-    .describe("재고 위치 ID. 등록에서 생략하면 기본 위치, 수정에서 생략하면 지금 연결을 유지한다"),
-});
+export const sellerAddressRequestSchema = strictRequest(
+  z.object({
+    type: addressTypeSchema,
+    name: z.string().min(1).max(50),
+    contactName: z.string().min(1),
+    phone: z.string().regex(/^01[0-9]{8,9}$/),
+    zipCode: z.string().regex(/^[0-9]{5}$/),
+    address1: z.string().min(1),
+    address2: z.string().optional(),
+    inventoryLocationId: z
+      .string()
+      .min(1)
+      .optional()
+      .describe(
+        "재고 위치 ID. 등록에서 생략하면 기본 위치, 수정에서 생략하면 지금 연결을 유지한다",
+      ),
+  }),
+);
 
 export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;