@sayren/store-sdk 0.41.0 → 0.43.0

package/src/schemas/commerce-flow.ts

@@ -1,6 +1,7 @@
-import { z } from "zod";
+import * as z from "zod";
 import { claimStatusSchema } from "./claim";
 import { orderItemStatusSchema } from "./common";
+import { strictRequest } from "./strict";
 
 /**
  * 커머스 플로우(이슈 #115) — 주문상품이 따르는 플로우의 지금 상태와 할 수 있는 행동. 공개 계약은 필드 추가로만 자란다.
@@ -146,10 +147,12 @@ export const orderItemFlowSchema = z.object({
 export type OrderItemFlow = z.infer<typeof orderItemFlowSchema>;
 
 /** 상태 직접 이동(#115) — 연결선을 지나지 않고 다른 상태로 옮긴다. 블록(재고·환불·송장)은 실행하지 않는다 */
-export const moveFlowStateRequestSchema = z.object({
-  to: z.string().min(1).describe("옮길 상태 키(`moveTargets[].key`)"),
-  reason: z.string().trim().max(200).optional().describe("옮긴 사유(실행 기록에 남는다)"),
-});
+export const moveFlowStateRequestSchema = strictRequest(
+  z.object({
+    to: z.string().min(1).describe("옮길 상태 키(`moveTargets[].key`)"),
+    reason: z.string().trim().max(200).optional().describe("옮긴 사유(실행 기록에 남는다)"),
+  }),
+);
 export type MoveFlowStateRequest = z.infer<typeof moveFlowStateRequestSchema>;
 
 export const flowRunStepSchema = z.object({
@@ -295,9 +298,11 @@ export type CommerceFlow = z.infer<typeof commerceFlowSchema>;
 export type CommerceFlowVersionView = z.infer<typeof commerceFlowVersionViewSchema>;
 
 /** 진행 중 주문을 활성 버전으로 옮기기(#115) — 한 번에 `limit`개까지. 남으면 다시 부른다 */
-export const migrateFlowVersionRequestSchema = z.object({
-  limit: z.number().int().min(1).max(500).optional().describe("한 번에 옮길 흐름 수(기본 100)"),
-});
+export const migrateFlowVersionRequestSchema = strictRequest(
+  z.object({
+    limit: z.number().int().min(1).max(500).optional().describe("한 번에 옮길 흐름 수(기본 100)"),
+  }),
+);
 export type MigrateFlowVersionRequest = z.infer<typeof migrateFlowVersionRequestSchema>;
 
 export const migrateFlowVersionResultSchema = z.object({
@@ -321,40 +326,44 @@ export const migrateFlowVersionResultSchema = z.object({
 });
 export type MigrateFlowVersionResult = z.infer<typeof migrateFlowVersionResultSchema>;
 
-export const createCommerceFlowRequestSchema = z.object({
-  key: z
-    .string()
-    .regex(/^[a-z][a-z0-9-]{1,48}$/)
-    .describe("상점 안 유일한 키(소문자·숫자·하이픈)"),
-  name: z.string().min(1).max(60).optional(),
-  presetKey: z.string().optional().describe("출발한 프리셋(출처로 남는다). 없으면 빈 플로우"),
-  graph: flowDocumentSchema
-    .optional()
-    .describe(
-      "편집기에서 고친 그래프(#115). 없으면 프리셋 그래프 그대로, 프리셋도 없으면 빈 흐름(결제 완료 노드 하나)이다",
-    ),
-  definition: flowDocumentSchema
-    .optional()
-    .describe(
-      "흐름 설정 `requires`(progression·groupClaim·fulfillmentMethods). 없으면 프리셋의 설정",
-    ),
-  variables: z
-    .record(z.string(), z.unknown())
-    .optional()
-    .describe("쓰지 않는다(무시). 값은 그래프의 노드 설정 안에 있다(#115)"),
-});
+export const createCommerceFlowRequestSchema = strictRequest(
+  z.object({
+    key: z
+      .string()
+      .regex(/^[a-z][a-z0-9-]{1,48}$/)
+      .describe("상점 안 유일한 키(소문자·숫자·하이픈)"),
+    name: z.string().min(1).max(60).optional(),
+    presetKey: z.string().optional().describe("출발한 프리셋(출처로 남는다). 없으면 빈 플로우"),
+    graph: flowDocumentSchema
+      .optional()
+      .describe(
+        "편집기에서 고친 그래프(#115). 없으면 프리셋 그래프 그대로, 프리셋도 없으면 빈 흐름(결제 완료 노드 하나)이다",
+      ),
+    definition: flowDocumentSchema
+      .optional()
+      .describe(
+        "흐름 설정 `requires`(progression·groupClaim·fulfillmentMethods). 없으면 프리셋의 설정",
+      ),
+    variables: z
+      .record(z.string(), z.unknown())
+      .optional()
+      .describe("쓰지 않는다(무시). 값은 그래프의 노드 설정 안에 있다(#115)"),
+  }),
+);
 export type CreateCommerceFlowRequest = z.infer<typeof createCommerceFlowRequestSchema>;
 
-export const saveFlowDraftRequestSchema = z.object({
-  graph: flowDocumentSchema,
-  definition: flowDocumentSchema
-    .optional()
-    .describe("흐름 설정 `requires`(progression·groupClaim·fulfillmentMethods)"),
-  variables: z
-    .record(z.string(), z.unknown())
-    .optional()
-    .describe("쓰지 않는다(무시). 값은 그래프의 노드 설정 안에 있다(#115)"),
-});
+export const saveFlowDraftRequestSchema = strictRequest(
+  z.object({
+    graph: flowDocumentSchema,
+    definition: flowDocumentSchema
+      .optional()
+      .describe("흐름 설정 `requires`(progression·groupClaim·fulfillmentMethods)"),
+    variables: z
+      .record(z.string(), z.unknown())
+      .optional()
+      .describe("쓰지 않는다(무시). 값은 그래프의 노드 설정 안에 있다(#115)"),
+  }),
+);
 export type SaveFlowDraftRequest = z.infer<typeof saveFlowDraftRequestSchema>;
 
 export const flowIssueSchema = z.object({
@@ -475,14 +484,16 @@ export const flowDraftOperationSchema = z.discriminatedUnion("op", [
 ]);
 export type FlowDraftOperation = z.infer<typeof flowDraftOperationSchema>;
 
-export const applyFlowOperationsRequestSchema = z.object({
-  operations: z
-    .array(flowDraftOperationSchema)
-    .min(1)
-    .describe(
-      "차례대로 적용한다. 묶음은 원자적이다 — 하나라도 형식이 틀리면 아무것도 바꾸지 않는다(400)",
-    ),
-});
+export const applyFlowOperationsRequestSchema = strictRequest(
+  z.object({
+    operations: z
+      .array(flowDraftOperationSchema)
+      .min(1)
+      .describe(
+        "차례대로 적용한다. 묶음은 원자적이다 — 하나라도 형식이 틀리면 아무것도 바꾸지 않는다(400)",
+      ),
+  }),
+);
 export type ApplyFlowOperationsRequest = z.infer<typeof applyFlowOperationsRequestSchema>;
 
 export const flowOperationsResultSchema = z.object({
@@ -533,17 +544,19 @@ export const flowSecretSchema = z.object({
 });
 export type FlowSecret = z.infer<typeof flowSecretSchema>;
 
-export const saveFlowSecretRequestSchema = z.object({
-  url: z
-    .url()
-    .refine((value) => value.startsWith("https://"), { message: "https 주소만 받습니다" })
-    .describe("요청 주소. https만, 사설·루프백 주소는 400 `FLOW_SECRET_URL_INVALID`"),
-  headers: z
-    .record(z.string().regex(/^[A-Za-z0-9-]{1,64}$/), z.string().max(2000))
-    .refine((value) => Object.keys(value).length <= 10, { message: "헤더는 10개까지입니다" })
-    .default({})
-    .describe("함께 보낼 헤더(인증 등). 값은 암호화해 두고 다시 보여 주지 않는다"),
-});
+export const saveFlowSecretRequestSchema = strictRequest(
+  z.object({
+    url: z
+      .url()
+      .refine((value) => value.startsWith("https://"), { message: "https 주소만 받습니다" })
+      .describe("요청 주소. https만, 사설·루프백 주소는 400 `FLOW_SECRET_URL_INVALID`"),
+    headers: z
+      .record(z.string().regex(/^[A-Za-z0-9-]{1,64}$/), z.string().max(2000))
+      .refine((value) => Object.keys(value).length <= 10, { message: "헤더는 10개까지입니다" })
+      .default({})
+      .describe("함께 보낼 헤더(인증 등). 값은 암호화해 두고 다시 보여 주지 않는다"),
+  }),
+);
 export type SaveFlowSecretRequest = z.input<typeof saveFlowSecretRequestSchema>;
 
 /**
@@ -584,22 +597,24 @@ const simulationEventSchema = z.object({
   key: z.string().optional().describe("행동·사건·타이머 키(start는 없음)"),
 });
 
-export const simulateFlowRequestSchema = z.object({
-  startAt: z.iso.datetime({ offset: true }).optional().describe("가상 시계 시작(기본: 지금)"),
-  context: z
-    .record(z.string(), z.unknown())
-    .optional()
-    .describe("식이 읽을 값(item·order·buyer·product). 비우면 견본 주문 값"),
-  steps: z
-    .array(
-      z.union([
-        z.object({ event: simulationEventSchema }),
-        z.object({ advance: z.string().regex(/^P/).describe("시간 경과(ISO 8601 기간)") }),
-      ]),
-    )
-    .min(1)
-    .max(100),
-});
+export const simulateFlowRequestSchema = strictRequest(
+  z.object({
+    startAt: z.iso.datetime({ offset: true }).optional().describe("가상 시계 시작(기본: 지금)"),
+    context: z
+      .record(z.string(), z.unknown())
+      .optional()
+      .describe("식이 읽을 값(item·order·buyer·product). 비우면 견본 주문 값"),
+    steps: z
+      .array(
+        z.union([
+          z.object({ event: simulationEventSchema }),
+          z.object({ advance: z.string().regex(/^P/).describe("시간 경과(ISO 8601 기간)") }),
+        ]),
+      )
+      .min(1)
+      .max(100),
+  }),
+);
 export type SimulateFlowRequest = z.infer<typeof simulateFlowRequestSchema>;
 
 export const simulationStepSchema = z.object({
@@ -628,9 +643,13 @@ export const simulateFlowResultSchema = z.object({
 });
 export type SimulateFlowResult = z.infer<typeof simulateFlowResultSchema>;
 
-export const replayFlowRequestSchema = z.object({
-  orderItemId: z.string().describe("재생할 주문상품 — 그 흐름의 실행 기록을 초안으로 다시 돌린다"),
-});
+export const replayFlowRequestSchema = strictRequest(
+  z.object({
+    orderItemId: z
+      .string()
+      .describe("재생할 주문상품 — 그 흐름의 실행 기록을 초안으로 다시 돌린다"),
+  }),
+);
 export type ReplayFlowRequest = z.infer<typeof replayFlowRequestSchema>;
 
 export const replayFlowResultSchema = z.object({
@@ -861,12 +880,14 @@ export const flowEditSessionViewSchema = z.object({
 });
 export type FlowEditSessionView = z.infer<typeof flowEditSessionViewSchema>;
 
-export const claimFlowEditSessionRequestSchema = z.object({
-  takeover: z
-    .boolean()
-    .optional()
-    .describe(
-      "다른 주체가 잡고 있어도 넘겨받는다. 앞 주체의 저장하지 않은 수정은 사라지고, AI 도우미면 그 실행이 멈춘다",
-    ),
-});
+export const claimFlowEditSessionRequestSchema = strictRequest(
+  z.object({
+    takeover: z
+      .boolean()
+      .optional()
+      .describe(
+        "다른 주체가 잡고 있어도 넘겨받는다. 앞 주체의 저장하지 않은 수정은 사라지고, AI 도우미면 그 실행이 멈춘다",
+      ),
+  }),
+);
 export type ClaimFlowEditSessionRequest = z.infer<typeof claimFlowEditSessionRequestSchema>;

package/src/schemas/commerce-number.ts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import * as z from "zod";
 
 /**
  * 국내 쇼핑몰 번호 체계(이슈 #107) — 공개 ID(`ord_…` 등)와 따로 싣는 숫자 번호의 표기·필드.

package/src/schemas/common.ts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import * as z from "zod";
 
 export const pageInfoSchema = z.object({
   page: z.number().int(),

package/src/schemas/coupon.ts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import * as z from "zod";
 import { pageQueryShape } from "./common";
 import { currencyCodeSchema } from "./currency";
 import {
@@ -9,6 +9,7 @@ import {
   couponKindSchema,
   couponTargetSchema,
 } from "./promotion";
+import { strictRequest } from "./strict";
 
 /**
  * 쿠폰 관리 API 계약 (이슈 #47) — `/v1/coupons/**`, 스코프 `promotion:r|rw`.
@@ -86,93 +87,100 @@ const couponTimeField = (description: string) =>
   z.iso.datetime({ offset: true }).nullable().optional().describe(description);
 
 /** `POST /v1/coupons` */
-export const createCouponRequestSchema = z
-  .strictObject({
-    name: z.string().trim().min(1).max(60).describe(descriptions.name),
+export const createCouponRequestSchema = strictRequest(
+  z
+    .strictObject({
+      name: z.string().trim().min(1).max(60).describe(descriptions.name),
+      description: z.string().max(300).nullable().optional().describe(descriptions.description),
+      kind: couponKindSchema,
+      benefit: couponBenefitSchema,
+      conditions: couponConditionsInputSchema
+        .optional()
+        .describe("사용 조건. 생략한 항목은 기본값(최소 금액 0, 회원 전용, 즉시할인과 중복 가능)"),
+      target: couponTargetInputSchema.optional().describe("대상 상품·카테고리. 생략하면 전 상품"),
+      issueMethod: couponIssueMethodSchema,
+      code: z.string().regex(COUPON_CODE_PATTERN).optional().describe(descriptions.code),
+      startsAt: couponTimeField(descriptions.startsAt),
+      endsAt: couponTimeField(descriptions.endsAt),
+      validDaysAfterIssue: z
+        .number()
+        .int()
+        .min(1)
+        .max(3650)
+        .nullable()
+        .optional()
+        .describe(descriptions.validDaysAfterIssue),
+      totalIssueLimit: limitField(descriptions.totalIssueLimit),
+      totalUseLimit: limitField(descriptions.totalUseLimit),
+      perMemberIssueLimit: limitField(descriptions.perMemberIssueLimit),
+      perMemberUseLimit: limitField(descriptions.perMemberUseLimit),
+      currency: currencyCodeSchema
+        .optional()
+        .describe(
+          "쿠폰 통화(이슈 #130). 정액·최대 할인액·최소 주문 금액이 이 통화 값이고 같은 통화 주문서에만 적용된다. 생략하면 기본 통화(KRW). 판매 통화여야 하고 만든 뒤에는 바꿀 수 없다",
+        ),
+    })
+    .superRefine((body, ctx) => {
+      const issue = (path: string, message: string) =>
+        ctx.addIssue({ code: "custom", path: [path], message });
+      if (body.issueMethod === "CODE" && !body.code)
+        issue("code", "코드 입력형 쿠폰은 코드가 필요합니다");
+      if (body.issueMethod !== "CODE" && body.code)
+        issue("code", "코드는 코드 입력형 쿠폰에만 둡니다");
+      if (body.issueMethod === "CODE" && body.validDaysAfterIssue != null) {
+        issue("validDaysAfterIssue", "발급 후 유효 일수는 셀러 지급 쿠폰에만 둡니다");
+      }
+      if (body.issueMethod === "CODE" && body.perMemberIssueLimit != null) {
+        issue("perMemberIssueLimit", "1인 발급 수 한도는 발급형 쿠폰에만 둡니다");
+      }
+      if (
+        body.issueMethod === "SIGNUP" &&
+        body.perMemberIssueLimit != null &&
+        body.perMemberIssueLimit !== 1
+      ) {
+        issue("perMemberIssueLimit", "회원가입 쿠폰은 1인 1장입니다");
+      }
+      if (body.issueMethod !== "CODE" && body.perMemberUseLimit != null) {
+        issue(
+          "perMemberUseLimit",
+          "발급형 쿠폰은 발급 한 장이 한 번 쓰입니다. 1인 발급 수 한도를 사용하십시오",
+        );
+      }
+      const memberOnly = body.conditions?.memberOnly ?? COUPON_CONDITIONS_DEFAULTS.memberOnly;
+      if (!memberOnly && (body.issueMethod !== "CODE" || body.perMemberUseLimit != null)) {
+        issue(
+          "conditions",
+          "비회원에게 여는 쿠폰은 코드 입력형이면서 1인 사용 한도가 없어야 합니다",
+        );
+      }
+      if (body.startsAt && body.endsAt && Date.parse(body.endsAt) <= Date.parse(body.startsAt)) {
+        issue("endsAt", "종료 시각은 시작 시각보다 뒤여야 합니다");
+      }
+    }),
+);
+export type CreateCouponRequest = z.infer<typeof createCouponRequestSchema>;
+
+/**
+ * `PATCH /v1/coupons/{couponId}` — 준 항목만 바뀐다. 발급·사용이 시작된 쿠폰(`locked`)은 이름·설명·종료일 연장·
+ * 한도 상향만 받고, 그 밖의 항목이 현재 값과 다르면 409 `COUPON_LOCKED`다. 종류·발급 방식은 바꿀 수 없다.
+ */
+export const updateCouponRequestSchema = strictRequest(
+  z.strictObject({
+    name: z.string().trim().min(1).max(60).optional().describe(descriptions.name),
     description: z.string().max(300).nullable().optional().describe(descriptions.description),
-    kind: couponKindSchema,
-    benefit: couponBenefitSchema,
-    conditions: couponConditionsInputSchema
-      .optional()
-      .describe("사용 조건. 생략한 항목은 기본값(최소 금액 0, 회원 전용, 즉시할인과 중복 가능)"),
-    target: couponTargetInputSchema.optional().describe("대상 상품·카테고리. 생략하면 전 상품"),
-    issueMethod: couponIssueMethodSchema,
+    benefit: couponBenefitSchema.optional(),
+    conditions: couponConditionsInputSchema.optional(),
+    target: couponTargetInputSchema.optional(),
     code: z.string().regex(COUPON_CODE_PATTERN).optional().describe(descriptions.code),
     startsAt: couponTimeField(descriptions.startsAt),
     endsAt: couponTimeField(descriptions.endsAt),
-    validDaysAfterIssue: z
-      .number()
-      .int()
-      .min(1)
-      .max(3650)
-      .nullable()
-      .optional()
-      .describe(descriptions.validDaysAfterIssue),
+    validDaysAfterIssue: z.number().int().min(1).max(3650).nullable().optional(),
     totalIssueLimit: limitField(descriptions.totalIssueLimit),
     totalUseLimit: limitField(descriptions.totalUseLimit),
     perMemberIssueLimit: limitField(descriptions.perMemberIssueLimit),
     perMemberUseLimit: limitField(descriptions.perMemberUseLimit),
-    currency: currencyCodeSchema
-      .optional()
-      .describe(
-        "쿠폰 통화(이슈 #130). 정액·최대 할인액·최소 주문 금액이 이 통화 값이고 같은 통화 주문서에만 적용된다. 생략하면 기본 통화(KRW). 판매 통화여야 하고 만든 뒤에는 바꿀 수 없다",
-      ),
-  })
-  .superRefine((body, ctx) => {
-    const issue = (path: string, message: string) =>
-      ctx.addIssue({ code: "custom", path: [path], message });
-    if (body.issueMethod === "CODE" && !body.code)
-      issue("code", "코드 입력형 쿠폰은 코드가 필요합니다");
-    if (body.issueMethod !== "CODE" && body.code)
-      issue("code", "코드는 코드 입력형 쿠폰에만 둡니다");
-    if (body.issueMethod === "CODE" && body.validDaysAfterIssue != null) {
-      issue("validDaysAfterIssue", "발급 후 유효 일수는 셀러 지급 쿠폰에만 둡니다");
-    }
-    if (body.issueMethod === "CODE" && body.perMemberIssueLimit != null) {
-      issue("perMemberIssueLimit", "1인 발급 수 한도는 발급형 쿠폰에만 둡니다");
-    }
-    if (
-      body.issueMethod === "SIGNUP" &&
-      body.perMemberIssueLimit != null &&
-      body.perMemberIssueLimit !== 1
-    ) {
-      issue("perMemberIssueLimit", "회원가입 쿠폰은 1인 1장입니다");
-    }
-    if (body.issueMethod !== "CODE" && body.perMemberUseLimit != null) {
-      issue(
-        "perMemberUseLimit",
-        "발급형 쿠폰은 발급 한 장이 한 번 쓰입니다. 1인 발급 수 한도를 사용하십시오",
-      );
-    }
-    const memberOnly = body.conditions?.memberOnly ?? COUPON_CONDITIONS_DEFAULTS.memberOnly;
-    if (!memberOnly && (body.issueMethod !== "CODE" || body.perMemberUseLimit != null)) {
-      issue("conditions", "비회원에게 여는 쿠폰은 코드 입력형이면서 1인 사용 한도가 없어야 합니다");
-    }
-    if (body.startsAt && body.endsAt && Date.parse(body.endsAt) <= Date.parse(body.startsAt)) {
-      issue("endsAt", "종료 시각은 시작 시각보다 뒤여야 합니다");
-    }
-  });
-export type CreateCouponRequest = z.infer<typeof createCouponRequestSchema>;
-
-/**
- * `PATCH /v1/coupons/{couponId}` — 준 항목만 바뀐다. 발급·사용이 시작된 쿠폰(`locked`)은 이름·설명·종료일 연장·
- * 한도 상향만 받고, 그 밖의 항목이 현재 값과 다르면 409 `COUPON_LOCKED`다. 종류·발급 방식은 바꿀 수 없다.
- */
-export const updateCouponRequestSchema = z.strictObject({
-  name: z.string().trim().min(1).max(60).optional().describe(descriptions.name),
-  description: z.string().max(300).nullable().optional().describe(descriptions.description),
-  benefit: couponBenefitSchema.optional(),
-  conditions: couponConditionsInputSchema.optional(),
-  target: couponTargetInputSchema.optional(),
-  code: z.string().regex(COUPON_CODE_PATTERN).optional().describe(descriptions.code),
-  startsAt: couponTimeField(descriptions.startsAt),
-  endsAt: couponTimeField(descriptions.endsAt),
-  validDaysAfterIssue: z.number().int().min(1).max(3650).nullable().optional(),
-  totalIssueLimit: limitField(descriptions.totalIssueLimit),
-  totalUseLimit: limitField(descriptions.totalUseLimit),
-  perMemberIssueLimit: limitField(descriptions.perMemberIssueLimit),
-  perMemberUseLimit: limitField(descriptions.perMemberUseLimit),
-});
+  }),
+);
 export type UpdateCouponRequest = z.infer<typeof updateCouponRequestSchema>;
 
 /** 쿠폰 응답 */

package/src/schemas/currency-prices.ts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import * as z from "zod";
 import { BASE_CURRENCY, currencyCodeSchema, isSaleUnitPrice } from "./currency";
 
 /**

package/src/schemas/currency.ts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import * as z from "zod";
 
 /**
  * 통화표와 금액 변환(이슈 #130). 숫자만 다룬다 — 사람이 읽는 문자열(「1,000원」·「$10.99」)은 각 앱의 `formatMoney`가 만든다.

package/src/schemas/customer-delegation.ts

@@ -1,4 +1,5 @@
-import { z } from "zod";
+import * as z from "zod";
+import { strictRequest } from "./strict";
 
 /**
  * 구매자 위임 REST(`POST /v1/customers/delegations`, #71) — 계정 토큰(또는 관리 API 토큰) + `X-Store-Id`로 부른다(`customer:rw`).
@@ -8,33 +9,35 @@ import { z } from "zod";
 
 const uidPattern = /^[A-Za-z0-9._:@|-]{1,128}$/;
 
-export const customerDelegationRequestSchema = z
-  .object({
-    uid: z
-      .string()
-      .regex(uidPattern)
-      .optional()
-      .describe(
-        "셀러 자체 인증의 사용자 id(1~128자, 영문·숫자·`._:@|-`). 처음 보는 id면 구매자를 만든다",
-      ),
-    email: z
-      .email()
-      .max(254)
-      .optional()
-      .describe("uid가 없으면 이메일로 지목한다. uid와 함께 주면 처음 만들 때의 이메일이다"),
-    name: z.string().max(50).optional().describe("처음 만들 때의 이름"),
-    authenticatedAt: z.iso
-      .datetime({ offset: true })
-      .optional()
-      .describe(
-        "사용자가 셀러 서비스에서 실제로 로그인한 시각(uid 위임만). 주면 구매자 토큰의 인증 시각이 된다",
-      ),
-  })
-  .refine((value) => Boolean(value.uid || value.email), {
-    message: "uid 또는 email이 필요합니다",
-    path: ["uid"],
-  })
-  .describe("구매자 위임 요청");
+export const customerDelegationRequestSchema = strictRequest(
+  z
+    .object({
+      uid: z
+        .string()
+        .regex(uidPattern)
+        .optional()
+        .describe(
+          "셀러 자체 인증의 사용자 id(1~128자, 영문·숫자·`._:@|-`). 처음 보는 id면 구매자를 만든다",
+        ),
+      email: z
+        .email()
+        .max(254)
+        .optional()
+        .describe("uid가 없으면 이메일로 지목한다. uid와 함께 주면 처음 만들 때의 이메일이다"),
+      name: z.string().max(50).optional().describe("처음 만들 때의 이름"),
+      authenticatedAt: z.iso
+        .datetime({ offset: true })
+        .optional()
+        .describe(
+          "사용자가 셀러 서비스에서 실제로 로그인한 시각(uid 위임만). 주면 구매자 토큰의 인증 시각이 된다",
+        ),
+    })
+    .refine((value) => Boolean(value.uid || value.email), {
+      message: "uid 또는 email이 필요합니다",
+      path: ["uid"],
+    })
+    .describe("구매자 위임 요청"),
+);
 export type CustomerDelegationRequest = z.infer<typeof customerDelegationRequestSchema>;
 
 export const customerDelegationSchema = z

package/src/schemas/customer.ts

@@ -1,5 +1,6 @@
-import { z } from "zod";
+import * as z from "zod";
 import { orderItemStatusSchema, pageQueryShape } from "./common";
+import { strictRequest } from "./strict";
 
 /** 구매자 목록 정렬 */
 export const customerSortSchema = z
@@ -198,12 +199,14 @@ export const customerOrderSchema = z.object({
 export type CustomerOrder = z.infer<typeof customerOrderSchema>;
 
 /** `POST /v1/customers/{id}/withdraw` 본문 */
-export const withdrawCustomerRequestSchema = z.object({
-  reason: z
-    .enum(["BUYER_REQUEST", "DORMANT", "ABUSE", "OTHER"])
-    .describe("처리 사유 — 구매자 요청·장기 미이용·부정 이용·기타. 감사 로그에 남는다"),
-  memo: z.string().max(200).optional().describe("사유 보충(선택)"),
-});
+export const withdrawCustomerRequestSchema = strictRequest(
+  z.object({
+    reason: z
+      .enum(["BUYER_REQUEST", "DORMANT", "ABUSE", "OTHER"])
+      .describe("처리 사유 — 구매자 요청·장기 미이용·부정 이용·기타. 감사 로그에 남는다"),
+    memo: z.string().max(200).optional().describe("사유 보충(선택)"),
+  }),
+);
 export type WithdrawCustomerRequest = z.infer<typeof withdrawCustomerRequestSchema>;
 
 /** `WITHDRAWAL_BLOCKED`의 `error.details` — 탈퇴를 막는 항목 수(스토어프론트 탈퇴와 같다) */

package/src/schemas/fulfillment.ts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import * as z from "zod";
 import { shippingCurrencyPricesSchema, storedShippingCurrencyPriceSchema } from "./currency-prices";
 
 /**

package/src/schemas/inventory.ts

@@ -1,4 +1,5 @@
-import { z } from "zod";
+import * as z from "zod";
+import { strictRequest } from "./strict";
 
 /**
  * 위치별 재고 (이슈 #132) — 재고 위치(창고·상설 매장·팝업 매장)마다 조합의 가용 재고를 따로 센다. 출고지·반품지·픽업 장소가 위치를
@@ -202,29 +203,33 @@ export const inventoryOperationResultSchema = z.object({
 export type InventoryOperationResult = z.infer<typeof inventoryOperationResultSchema>;
 
 /** 수거 완료의 재입고 지정(Q3) — 생략하면 조합은 할당 순서(교환 → 판매), 위치는 반품지에 연결된 위치 → 할당 위치다 */
-export const claimCollectCompleteRequestSchema = z.object({
-  restock: z
-    .object({
-      optionId: z
-        .string()
-        .min(1)
-        .optional()
-        .describe(
-          "돌아온 조합 — 그 주문상품의 할당 조합이어야 한다(아니면 400 `INVALID_RESTOCK_OPTION`)",
-        ),
-      inventoryLocationId: z.string().min(1).optional().describe("재입고할 재고 위치"),
-    })
-    .optional(),
-});
+export const claimCollectCompleteRequestSchema = strictRequest(
+  z.object({
+    restock: z
+      .object({
+        optionId: z
+          .string()
+          .min(1)
+          .optional()
+          .describe(
+            "돌아온 조합 — 그 주문상품의 할당 조합이어야 한다(아니면 400 `INVALID_RESTOCK_OPTION`)",
+          ),
+        inventoryLocationId: z.string().min(1).optional().describe("재입고할 재고 위치"),
+      })
+      .optional(),
+  }),
+);
 export type ClaimCollectCompleteRequest = z.infer<typeof claimCollectCompleteRequestSchema>;
 
-export const claimRedeliveryRequestSchema = z.object({
-  carrierCode: z.string().min(1),
-  trackingNumber: z.string().min(1),
-  inventoryLocationId: z
-    .string()
-    .min(1)
-    .optional()
-    .describe("교환품을 보낼 재고 위치. 생략하면 그 상품의 기준 위치"),
-});
+export const claimRedeliveryRequestSchema = strictRequest(
+  z.object({
+    carrierCode: z.string().min(1),
+    trackingNumber: z.string().min(1),
+    inventoryLocationId: z
+      .string()
+      .min(1)
+      .optional()
+      .describe("교환품을 보낼 재고 위치. 생략하면 그 상품의 기준 위치"),
+  }),
+);
 export type ClaimRedeliveryRequest = z.infer<typeof claimRedeliveryRequestSchema>;