@sayren/store-sdk 0.40.0 → 0.42.0

package/src/schemas/misc.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { type PageParams, pageQueryShape } from "./common";
+import { strictRequest } from "./strict";
 
 export const inquirySchema = z.object({
   inquiryId: z.string(),
@@ -435,9 +436,11 @@ export const webhookRedeliverFailedResultSchema = z.object({
 });
 export type WebhookRedeliverFailedResult = z.infer<typeof webhookRedeliverFailedResultSchema>;
 
-export const webhookTestRequestSchema = z.object({
-  eventType: eventTypeSchema.describe("샘플 페이로드로 보낼 이벤트 타입"),
-});
+export const webhookTestRequestSchema = strictRequest(
+  z.object({
+    eventType: eventTypeSchema.describe("샘플 페이로드로 보낼 이벤트 타입"),
+  }),
+);
 export type WebhookTestRequest = z.infer<typeof webhookTestRequestSchema>;
 
 /** 테스트 이벤트 발송 결과 (동기 반환). 재시도·정지 판정·전송 기록이 없다 */

package/src/schemas/order.ts

@@ -5,6 +5,7 @@ import { orderItemFulfillmentSnapshotResponseSchema } from "./fulfillment";
 import { cashReceiptSchema, easyPayProviderResponseSchema } from "./payment";
 import { customInputValueSchema, optionSelectionSchema } from "./product";
 import { staySnapshotSchema } from "./stay";
+import { strictRequest } from "./strict";
 
 export const orderSummarySchema = z.object({
   orderId: z.string(),
@@ -391,27 +392,29 @@ export const deliveryMethodSchema = z.enum(["COURIER", "DIRECT", "QUICK", "NOTHI
 
 export type DeliveryMethod = z.infer<typeof deliveryMethodSchema>;
 
-export const dispatchRequestSchema = z
-  .object({
-    deliveryMethod: deliveryMethodSchema,
-    carrierCode: z.string().optional(),
-    trackingNumber: z.string().optional(),
-    /**
-     * 발송 시각. ISO 8601이고 시간대(`Z` 또는 `+09:00`)를 포함해야 한다. 생략하면 현재 시각이다.
-     *
-     * 전에는 `z.string()`이라 아무 문자열이나 그대로 저장됐다. 이 값은 배송 정보 jsonb에 들어가
-     * 자동 배송완료·추적 동기화 잡의 대상 선별 조건이 된다 — 잘못된 한 행이 상점 구분 없이 도는
-     * 잡 전체를 멈출 수 있어 입력에서 좁혔다. 검증을 통과한 값도 저장 전에 UTC ISO로 정규화한다.
-     */
-    dispatchedAt: z.iso.datetime({ offset: true }).optional(),
-  })
-  .refine(
-    (value) =>
-      value.deliveryMethod === "DIRECT" || value.deliveryMethod === "NOTHING"
-        ? true
-        : !!value.carrierCode && !!value.trackingNumber,
-    { message: "COURIER/QUICK 발송은 carrierCode와 trackingNumber가 필수입니다" },
-  );
+export const dispatchRequestSchema = strictRequest(
+  z
+    .object({
+      deliveryMethod: deliveryMethodSchema,
+      carrierCode: z.string().optional(),
+      trackingNumber: z.string().optional(),
+      /**
+       * 발송 시각. ISO 8601이고 시간대(`Z` 또는 `+09:00`)를 포함해야 한다. 생략하면 현재 시각이다.
+       *
+       * 전에는 `z.string()`이라 아무 문자열이나 그대로 저장됐다. 이 값은 배송 정보 jsonb에 들어가
+       * 자동 배송완료·추적 동기화 잡의 대상 선별 조건이 된다 — 잘못된 한 행이 상점 구분 없이 도는
+       * 잡 전체를 멈출 수 있어 입력에서 좁혔다. 검증을 통과한 값도 저장 전에 UTC ISO로 정규화한다.
+       */
+      dispatchedAt: z.iso.datetime({ offset: true }).optional(),
+    })
+    .refine(
+      (value) =>
+        value.deliveryMethod === "DIRECT" || value.deliveryMethod === "NOTHING"
+          ? true
+          : !!value.carrierCode && !!value.trackingNumber,
+      { message: "COURIER/QUICK 발송은 carrierCode와 trackingNumber가 필수입니다" },
+    ),
+);
 
 export type DispatchRequest = z.infer<typeof dispatchRequestSchema>;
 
@@ -509,34 +512,38 @@ export const carrierSchema = z.object({
 
 export type Carrier = z.infer<typeof carrierSchema>;
 
-export const holdOrderItemRequestSchema = z.object({
-  reason: z.enum(["OUT_OF_STOCK", "CUSTOMER_REQUEST", "CUSTOMS", "ETC"]),
-  detail: z.string().max(500).optional(),
-  expectedDispatchDate: z.string(),
-});
+export const holdOrderItemRequestSchema = strictRequest(
+  z.object({
+    reason: z.enum(["OUT_OF_STOCK", "CUSTOMER_REQUEST", "CUSTOMS", "ETC"]),
+    detail: z.string().max(500).optional(),
+    expectedDispatchDate: z.string(),
+  }),
+);
 
 export type HoldOrderItemRequest = z.infer<typeof holdOrderItemRequestSchema>;
 
-export const cancelBySellerRequestSchema = z.object({
-  reason: z.enum(["OUT_OF_STOCK", "PRICE_ERROR", "DELIVERY_IMPOSSIBLE", "ETC"]),
-  detail: z.string().max(500).optional(),
-  quantity: z
-    .number()
-    .int()
-    .min(1)
-    .optional()
-    .describe(
-      "취소할 수량. 생략하면 남은 수량 전체다. 남은 수량보다 크면 400 `INVALID_QUANTITY`. " +
-        "일부만 취소하면 주문상품은 상태를 유지한 채 `canceledQuantity`가 늘고, 전 수량이 소진되면 `CANCELED`가 된다",
-    ),
-  holdRefund: z
-    .boolean()
-    .optional()
-    .describe(
-      "true면 주문만 취소하고 결제 환불은 대기로 남긴다(#115). 정산·재고·적립금 반환은 그대로 하고, PG 환불은 결제 상세의 " +
-        "`POST /v1/payments/refunds/{refundId}/process`로 따로 한다. 생략하면 취소와 함께 환불한다",
-    ),
-});
+export const cancelBySellerRequestSchema = strictRequest(
+  z.object({
+    reason: z.enum(["OUT_OF_STOCK", "PRICE_ERROR", "DELIVERY_IMPOSSIBLE", "ETC"]),
+    detail: z.string().max(500).optional(),
+    quantity: z
+      .number()
+      .int()
+      .min(1)
+      .optional()
+      .describe(
+        "취소할 수량. 생략하면 남은 수량 전체다. 남은 수량보다 크면 400 `INVALID_QUANTITY`. " +
+          "일부만 취소하면 주문상품은 상태를 유지한 채 `canceledQuantity`가 늘고, 전 수량이 소진되면 `CANCELED`가 된다",
+      ),
+    holdRefund: z
+      .boolean()
+      .optional()
+      .describe(
+        "true면 주문만 취소하고 결제 환불은 대기로 남긴다(#115). 정산·재고·적립금 반환은 그대로 하고, PG 환불은 결제 상세의 " +
+          "`POST /v1/payments/refunds/{refundId}/process`로 따로 한다. 생략하면 취소와 함께 환불한다",
+      ),
+  }),
+);
 
 export type CancelBySellerRequest = z.infer<typeof cancelBySellerRequestSchema>;
 
@@ -544,22 +551,26 @@ export type CancelBySellerRequest = z.infer<typeof cancelBySellerRequestSchema>;
  * 제공 처리 요청 (이슈 #48) — `POST /v1/order-items/{orderItemId}/fulfill`. 배송 없는 주문상품(`MANUAL`)을
  * 제공 완료(`DELIVERED`)로 바꾼다.
  */
-export const fulfillRequestSchema = z.object({
-  note: z
-    .string()
-    .trim()
-    .max(1000)
-    .optional()
-    .describe("구매자에게 보일 이용 안내(예: 예약 방법, 수령 장소). 주문 상세에 실린다"),
-});
+export const fulfillRequestSchema = strictRequest(
+  z.object({
+    note: z
+      .string()
+      .trim()
+      .max(1000)
+      .optional()
+      .describe("구매자에게 보일 이용 안내(예: 예약 방법, 수령 장소). 주문 상세에 실린다"),
+  }),
+);
 
 export type FulfillRequest = z.infer<typeof fulfillRequestSchema>;
 
 /** 제공 처리 일괄 요청 — `POST /v1/order-items/fulfill` */
-export const fulfillBulkRequestSchema = z.object({
-  orderItemIds: z.array(z.string()).min(1).max(100),
-  note: fulfillRequestSchema.shape.note,
-});
+export const fulfillBulkRequestSchema = strictRequest(
+  z.object({
+    orderItemIds: z.array(z.string()).min(1).max(100),
+    note: fulfillRequestSchema.shape.note,
+  }),
+);
 
 export type FulfillBulkRequest = z.infer<typeof fulfillBulkRequestSchema>;
 

package/src/schemas/payment.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { type PageParams, pageSchema } from "./common";
+import { strictRequest } from "./strict";
 
 /**
  * 상점 결제(PG) 설정과 매출 리포트 계약.
@@ -253,103 +254,119 @@ const upsertEnvironment = () =>
       "어느 세트로 결제할지는 이 값이 아니라 샌드박스 스위치(`sandboxMode`)가 정한다",
   );
 
-export const upsertTossPaymentsProviderRequestSchema = z.object({
-  environment: upsertEnvironment(),
-  credentials: tossPaymentsCredentialsInputSchema,
-});
+export const upsertTossPaymentsProviderRequestSchema = strictRequest(
+  z.object({
+    environment: upsertEnvironment(),
+    credentials: tossPaymentsCredentialsInputSchema,
+  }),
+);
 export type UpsertTossPaymentsProviderRequest = z.infer<
   typeof upsertTossPaymentsProviderRequestSchema
 >;
 
-export const upsertPortOneProviderRequestSchema = z.object({
-  environment: upsertEnvironment(),
-  credentials: portOneCredentialsInputSchema,
-});
+export const upsertPortOneProviderRequestSchema = strictRequest(
+  z.object({
+    environment: upsertEnvironment(),
+    credentials: portOneCredentialsInputSchema,
+  }),
+);
 export type UpsertPortOneProviderRequest = z.infer<typeof upsertPortOneProviderRequestSchema>;
 
-export const upsertKakaoPayProviderRequestSchema = z.object({
-  environment: upsertEnvironment(),
-  credentials: kakaoPayCredentialsInputSchema,
-});
+export const upsertKakaoPayProviderRequestSchema = strictRequest(
+  z.object({
+    environment: upsertEnvironment(),
+    credentials: kakaoPayCredentialsInputSchema,
+  }),
+);
 export type UpsertKakaoPayProviderRequest = z.infer<typeof upsertKakaoPayProviderRequestSchema>;
 
-export const upsertNaverPayProviderRequestSchema = z.object({
-  environment: upsertEnvironment(),
-  credentials: naverPayCredentialsInputSchema,
-});
+export const upsertNaverPayProviderRequestSchema = strictRequest(
+  z.object({
+    environment: upsertEnvironment(),
+    credentials: naverPayCredentialsInputSchema,
+  }),
+);
 export type UpsertNaverPayProviderRequest = z.infer<typeof upsertNaverPayProviderRequestSchema>;
 
-export const upsertPayPalProviderRequestSchema = z.object({
-  environment: upsertEnvironment(),
-  credentials: payPalCredentialsInputSchema,
-});
+export const upsertPayPalProviderRequestSchema = strictRequest(
+  z.object({
+    environment: upsertEnvironment(),
+    credentials: payPalCredentialsInputSchema,
+  }),
+);
 export type UpsertPayPalProviderRequest = z.infer<typeof upsertPayPalProviderRequestSchema>;
 
-export const updatePaymentProviderRequestSchema = z
-  .object({
-    enabled: z
-      .boolean()
-      .optional()
-      .describe(
-        "사용 여부. 켜려면 활성 환경(샌드박스면 TEST, 아니면 LIVE) 자격 증명이 모두 저장돼 있어야 한다(`PAYMENT_PROVIDER_INCOMPLETE`)",
-      ),
-    sandboxMode: z
-      .boolean()
-      .optional()
-      .describe(
-        "샌드박스 스위치. `true`면 새 결제에 TEST 세트를 쓴다(항상 허용). `false`(라이브 전환)는 라이브 개방 조건을 " +
-          "모두 충족해야 한다(`LIVE_GATE_NOT_MET`)",
-      ),
-    easyPayProviders: z
-      .array(easyPayProviderSchema)
-      .max(easyPayProviderSchema.options.length)
-      .optional()
-      .describe(
-        "이 PG로 받는 간편결제사 — 통째로 바꾼다. PG 계약(포트원은 채널)에 추가한 간편결제만 켠다. " +
-          "켠 간편결제사마다 스토어프론트 결제 옵션이 하나씩 생긴다(포트원은 간편결제를 받는 채널이 있어야 한다)",
-      ),
-  })
-  .refine(
-    (body) =>
-      body.enabled !== undefined ||
-      body.sandboxMode !== undefined ||
-      body.easyPayProviders !== undefined,
-    { message: "enabled·sandboxMode·easyPayProviders 중 하나는 보내야 합니다" },
-  );
+export const updatePaymentProviderRequestSchema = strictRequest(
+  z
+    .object({
+      enabled: z
+        .boolean()
+        .optional()
+        .describe(
+          "사용 여부. 켜려면 활성 환경(샌드박스면 TEST, 아니면 LIVE) 자격 증명이 모두 저장돼 있어야 한다(`PAYMENT_PROVIDER_INCOMPLETE`)",
+        ),
+      sandboxMode: z
+        .boolean()
+        .optional()
+        .describe(
+          "샌드박스 스위치. `true`면 새 결제에 TEST 세트를 쓴다(항상 허용). `false`(라이브 전환)는 라이브 개방 조건을 " +
+            "모두 충족해야 한다(`LIVE_GATE_NOT_MET`)",
+        ),
+      easyPayProviders: z
+        .array(easyPayProviderSchema)
+        .max(easyPayProviderSchema.options.length)
+        .optional()
+        .describe(
+          "이 PG로 받는 간편결제사 — 통째로 바꾼다. PG 계약(포트원은 채널)에 추가한 간편결제만 켠다. " +
+            "켠 간편결제사마다 스토어프론트 결제 옵션이 하나씩 생긴다(포트원은 간편결제를 받는 채널이 있어야 한다)",
+        ),
+    })
+    .refine(
+      (body) =>
+        body.enabled !== undefined ||
+        body.sandboxMode !== undefined ||
+        body.easyPayProviders !== undefined,
+      { message: "enabled·sandboxMode·easyPayProviders 중 하나는 보내야 합니다" },
+    ),
+);
 export type UpdatePaymentProviderRequest = z.infer<typeof updatePaymentProviderRequestSchema>;
 
-export const verifyPaymentProviderRequestSchema = z.object({
-  environment: pgEnvironmentSchema
-    .optional()
-    .describe("연결 테스트할 자격 증명 세트. 생략하면 활성 환경(샌드박스면 TEST, 아니면 LIVE)"),
-});
+export const verifyPaymentProviderRequestSchema = strictRequest(
+  z.object({
+    environment: pgEnvironmentSchema
+      .optional()
+      .describe("연결 테스트할 자격 증명 세트. 생략하면 활성 환경(샌드박스면 TEST, 아니면 LIVE)"),
+  }),
+);
 export type VerifyPaymentProviderRequest = z.infer<typeof verifyPaymentProviderRequestSchema>;
 
-export const updatePaymentSettingsRequestSchema = z
-  .object({
-    priority: z
-      .array(pgProviderSchema)
-      .min(1)
-      // PG 개수와 무관한 안전장치 — 거대한 배열이 파싱을 거치지 않게만 막는다. 실제 개수는 서버가 본다
-      .max(50)
-      .optional()
-      .describe(
-        "PG 우선순위(앞이 1순위) — 스토어프론트 결제 옵션 목록의 PG 순서다. 연결된 PG 수만큼 **모두 한 번씩** 나열한다" +
-          "(길이 상한 50은 안전장치다). 빠지거나 중복되거나 연결되지 않은 PG가 있으면 `INVALID_PRIORITY`",
-      ),
-    checkoutOrigins: z
-      .array(z.string().max(200))
-      .max(20)
-      .optional()
-      .describe(
-        "결제 도메인 — 통째로 바꾼다. 결제를 마친 구매자가 돌아올 스토어프론트 origin(`https://shop.example.com`, https·경로 없음). " +
-          "결제 시작의 `returnUrl`은 이 목록 안이어야 한다. 비어 있으면 실결제를 시작할 수 없다(테스트 결제는 localhost 허용). " +
-          "같은 도메인을 PG 가맹 정보에도 등록한다. 형식이 틀리면 `INVALID_CHECKOUT_ORIGIN`",
-      ),
-  })
-  .refine((body) => body.priority !== undefined || body.checkoutOrigins !== undefined, {
-    message: "priority 또는 checkoutOrigins 중 하나는 보내야 합니다",
-  });
+export const updatePaymentSettingsRequestSchema = strictRequest(
+  z
+    .object({
+      priority: z
+        .array(pgProviderSchema)
+        .min(1)
+        // PG 개수와 무관한 안전장치 — 거대한 배열이 파싱을 거치지 않게만 막는다. 실제 개수는 서버가 본다
+        .max(50)
+        .optional()
+        .describe(
+          "PG 우선순위(앞이 1순위) — 스토어프론트 결제 옵션 목록의 PG 순서다. 연결된 PG 수만큼 **모두 한 번씩** 나열한다" +
+            "(길이 상한 50은 안전장치다). 빠지거나 중복되거나 연결되지 않은 PG가 있으면 `INVALID_PRIORITY`",
+        ),
+      checkoutOrigins: z
+        .array(z.string().max(200))
+        .max(20)
+        .optional()
+        .describe(
+          "결제 도메인 — 통째로 바꾼다. 결제를 마친 구매자가 돌아올 스토어프론트 origin(`https://shop.example.com`, https·경로 없음). " +
+            "결제 시작의 `returnUrl`은 이 목록 안이어야 한다. 비어 있으면 실결제를 시작할 수 없다(테스트 결제는 localhost 허용). " +
+            "같은 도메인을 PG 가맹 정보에도 등록한다. 형식이 틀리면 `INVALID_CHECKOUT_ORIGIN`",
+        ),
+    })
+    .refine((body) => body.priority !== undefined || body.checkoutOrigins !== undefined, {
+      message: "priority 또는 checkoutOrigins 중 하나는 보내야 합니다",
+    }),
+);
 export type UpdatePaymentSettingsRequest = z.infer<typeof updatePaymentSettingsRequestSchema>;
 
 // ─── 조회 응답 ─────────────────────────────────────────────
@@ -513,7 +530,7 @@ export const paymentProviderSchema = z.object({
       "지금 새 결제의 후보가 아닌 사유. 후보면 null. 판정 원천은 서버 라우팅이다(상점 플랫폼이 다시 계산하지 않는다). " +
         "후보가 아닌 PG에는 항상 사유 코드를 붙인다(연결 안 된 PG 포함) — 모든 PG는 `candidates`에 있거나 이 값이 null이 아니다. 현재 값: " +
         "`NOT_CONNECTED`(연결 안 됨) · `DISABLED`(사용 중지) · `CREDENTIAL_MISSING`(활성 환경 자격 증명 없음) · " +
-        "`SANDBOX_IN_LIVE_STORE`(다른 PG가 라이브라 이 샌드박스 PG는 실구매자 결제에 쓰지 않음) · " +
+        "`SANDBOX_IN_LIVE_STORE`(더는 반환하지 않음 — PG는 각자 쓰인다) · " +
         "`PLATFORM_BLOCKED`(플랫폼이 실결제를 막음) · `MODE_MISMATCH`(라이브를 연 서버 모드와 현재 모드가 다름). " +
         "값이 추가될 수 있어 문자열로 받는다 — 모르는 값은 후보 아님으로 다룬다." +
         " 서버는 항상 싣는다. 이 필드가 없는 이전 서버 응답은 기본값(null)으로 읽는다",
@@ -958,13 +975,15 @@ export interface PaymentListParams extends PageParams {
 }
 
 /** 테스트모드 키 활성화 요청(2026-10-14) — `PUT /v1/store/payment-providers/{provider}/platform-test-keys` */
-export const setPlatformTestKeysRequestSchema = z.object({
-  enabled: z
-    .boolean()
-    .describe(
-      "`true`면 sayren 지정 테스트 키를 TEST 세트로 저장하고 PG를 켠다. `false`면 고정만 푼다(TEST 세트는 그대로)",
-    ),
-});
+export const setPlatformTestKeysRequestSchema = strictRequest(
+  z.object({
+    enabled: z
+      .boolean()
+      .describe(
+        "`true`면 sayren 지정 테스트 키를 TEST 세트로 저장하고 PG를 켠다. `false`면 고정만 푼다(TEST 세트는 그대로)",
+      ),
+  }),
+);
 export type SetPlatformTestKeysRequest = z.infer<typeof setPlatformTestKeysRequestSchema>;
 
 /** 결제 상태 PG 한 줄 — 비밀 값·공개 키 없이 연결·사용·환경·테스트모드 키만 */

package/src/schemas/points.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { strictRequest } from "./strict";
 
 /**
  * 적립금 (이슈 #93) — 상점 정책·원장 유형·순수 계산. 정책 해석은 `resolvePointPolicy`, 리뷰 적립 금액은
@@ -238,12 +239,14 @@ export type StorePointPolicy = z.infer<typeof storePointPolicySchema>;
  * `PUT /v1/store/point-policy` 본문 — 준 항목만 바꾼다(생략 = 저장된 값 유지). 리뷰 적립·구매 적립 중 하나라도 켜면 유효 기간이 있어야 한다
  * (본문이나 저장된 값, 없으면 400 `POINT_EXPIRY_REQUIRED`).
  */
-export const updatePointPolicyRequestSchema = z.object({
-  reviewReward: reviewRewardPolicySchema.optional(),
-  purchaseEarn: purchaseEarnPolicySchema.optional(),
-  use: pointUsePolicySchema.optional(),
-  expiryDays: expiryDays.optional(),
-});
+export const updatePointPolicyRequestSchema = strictRequest(
+  z.object({
+    reviewReward: reviewRewardPolicySchema.optional(),
+    purchaseEarn: purchaseEarnPolicySchema.optional(),
+    use: pointUsePolicySchema.optional(),
+    expiryDays: expiryDays.optional(),
+  }),
+);
 export type UpdatePointPolicyRequest = z.infer<typeof updatePointPolicyRequestSchema>;
 
 // ── 잔액·원장 조회와 셀러 조정 ─────────────────────────────
@@ -315,27 +318,29 @@ export const POINT_ADJUSTMENT_MAX = 10_000_000;
  * 지급의 소멸 시각은 `expiresAt`(생략하면 정책 유효 기간, 정책이 없으면 400 `POINT_EXPIRY_REQUIRED`), 차감은 소멸이 이른 적립금부터 뺀다
  * (잔액보다 많으면 409 `POINT_BALANCE_INSUFFICIENT`).
  */
-export const pointAdjustmentRequestSchema = z
-  .object({
-    amount: z
-      .number()
-      .int()
-      .min(-POINT_ADJUSTMENT_MAX)
-      .max(POINT_ADJUSTMENT_MAX)
-      .refine((value) => value !== 0, "0원은 조정할 수 없습니다")
-      .describe("지급은 양수, 차감은 음수(원)"),
-    reason: z.string().trim().min(1).max(200).describe("사유(필수). 구매자에게는 보이지 않는다"),
-    expiresAt: z.iso
-      .datetime({ offset: true })
-      .optional()
-      .describe(
-        "지급분의 소멸 시각. 생략하면 정책 유효 기간(`expiryDays`)으로 정한다. **정책 유효 기간이 없으면 지급에 필수다**(없으면 400 `POINT_EXPIRY_REQUIRED`). 차감에는 주지 않는다",
-      ),
-  })
-  .refine((value) => !(value.amount < 0 && value.expiresAt), {
-    message: "차감에는 소멸 시각을 줄 수 없습니다",
-    path: ["expiresAt"],
-  });
+export const pointAdjustmentRequestSchema = strictRequest(
+  z
+    .object({
+      amount: z
+        .number()
+        .int()
+        .min(-POINT_ADJUSTMENT_MAX)
+        .max(POINT_ADJUSTMENT_MAX)
+        .refine((value) => value !== 0, "0원은 조정할 수 없습니다")
+        .describe("지급은 양수, 차감은 음수(원)"),
+      reason: z.string().trim().min(1).max(200).describe("사유(필수). 구매자에게는 보이지 않는다"),
+      expiresAt: z.iso
+        .datetime({ offset: true })
+        .optional()
+        .describe(
+          "지급분의 소멸 시각. 생략하면 정책 유효 기간(`expiryDays`)으로 정한다. **정책 유효 기간이 없으면 지급에 필수다**(없으면 400 `POINT_EXPIRY_REQUIRED`). 차감에는 주지 않는다",
+        ),
+    })
+    .refine((value) => !(value.amount < 0 && value.expiresAt), {
+      message: "차감에는 소멸 시각을 줄 수 없습니다",
+      path: ["expiresAt"],
+    }),
+);
 export type PointAdjustmentRequest = z.infer<typeof pointAdjustmentRequestSchema>;
 
 export const pointAdjustmentResultSchema = z.object({

package/src/schemas/product-info.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { strictRequest } from "./strict";
 
 /**
  * 상품정보제공 고시·인증 정보·안내 섹션 (이슈 #135).
@@ -81,7 +82,7 @@ export type ProductNotice = z.infer<typeof productNoticeSchema>;
 
 export const MAX_NOTICE_VALUE_LENGTH = 1500;
 
-export const productNoticeRequestSchema = z.object({
+export const productNoticeRequestSchema = z.strictObject({
   schemaId: z.string().trim().min(1).max(50).describe("품목군 코드(`GET /v1/info-schemas`)"),
   version: z.number().int().positive().optional().describe("품목군 버전. 생략하면 현재 버전"),
   values: z
@@ -128,10 +129,10 @@ export const productCertificationsSchema = z.object({
 
 export type ProductCertifications = z.infer<typeof productCertificationsSchema>;
 
-export const productCertificationsRequestSchema = z.object({
+export const productCertificationsRequestSchema = z.strictObject({
   subjects: z
     .array(
-      z.object({
+      z.strictObject({
         subject: z.string().trim().min(1).max(50),
         status: z.enum(CERTIFICATION_STATUSES),
         exemption: z.string().trim().min(1).max(50).nullish(),
@@ -145,7 +146,7 @@ export const productCertificationsRequestSchema = z.object({
     ),
   items: z
     .array(
-      z.object({
+      z.strictObject({
         kind: z.string().trim().min(1).max(50),
         agency: z.string().trim().max(100).nullish(),
         number: z.string().trim().min(1).max(100),
@@ -180,11 +181,13 @@ export const infoSectionSchema = z.object({
 
 export type InfoSection = z.infer<typeof infoSectionSchema>;
 
-export const infoSectionRequestSchema = z.object({
-  title: z.string().trim().min(1).max(MAX_INFO_SECTION_TITLE),
-  body: z.string().default(""),
-  bodyJson: z.string().nullable().optional(),
-});
+export const infoSectionRequestSchema = strictRequest(
+  z.object({
+    title: z.string().trim().min(1).max(MAX_INFO_SECTION_TITLE),
+    body: z.string().default(""),
+    bodyJson: z.string().nullable().optional(),
+  }),
+);
 
 export type InfoSectionRequest = z.infer<typeof infoSectionRequestSchema>;
 export type InfoSectionRequestInput = z.input<typeof infoSectionRequestSchema>;