@sayren/store-sdk 0.40.0 → 0.42.0

package/src/schemas/ai.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { storefrontSlugSchema } from "./storefront-hosting";
+import { strictRequest } from "./strict";
 
 /**
  * 상점 플랫폼 AI 채팅(이슈 #124) — 대화·메시지·실행과 실행 이벤트 스트림의 계약.
@@ -96,9 +97,15 @@ export const aiActivitySchema = z.enum([
 ]);
 export type AiActivity = z.infer<typeof aiActivitySchema>;
 
+/** 바뀐 줄 미리보기 한 줄의 최대 길이 — 서버가 이 길이로 자르고 화면은 이보다 긴 줄을 앞부분으로 비교한다 */
+export const AI_TOOL_CHANGE_LINE_MAX = 300;
+/** 바뀐 줄 범위(`lines`) 개수 상한 */
+export const AI_TOOL_CHANGE_RANGES_MAX = 200;
+
 /**
  * 도구가 바꾼 파일 하나(2026-10-13, AI 상점 도우미 작업 공간의 수정 중인 코드) — 서버가 도구 입력으로 계산한다.
- * `edit`는 바꾼 부분의 줄 비교, `write`는 새로 쓴 내용(이전 내용을 모르므로 모두 추가로 센다). `preview`는 바뀐 줄 앞부분 12줄까지다
+ * `edit`는 바꾼 부분의 줄 비교, `write`는 새로 쓴 내용(이전 내용을 모르므로 모두 추가로 센다). `preview`는 바뀐 줄 앞부분 12줄까지다.
+ * `lines`는 바꾼 뒤 파일에서 추가된 줄의 범위(1부터, 양끝 포함)다 — `edit`가 성공한 뒤에만 실행기가 채운다(옛 기록·`write`에는 없다)
  */
 export const aiToolChangeSchema = z.object({
   path: z.string().max(300),
@@ -106,8 +113,17 @@ export const aiToolChangeSchema = z.object({
   added: z.number().int().min(0),
   removed: z.number().int().min(0),
   preview: z
-    .array(z.object({ kind: z.enum(["added", "removed"]), text: z.string().max(300) }))
+    .array(
+      z.object({
+        kind: z.enum(["added", "removed"]),
+        text: z.string().max(AI_TOOL_CHANGE_LINE_MAX),
+      }),
+    )
     .max(12),
+  lines: z
+    .array(z.tuple([z.number().int().min(1), z.number().int().min(1)]))
+    .max(AI_TOOL_CHANGE_RANGES_MAX)
+    .optional(),
 });
 export type AiToolChange = z.infer<typeof aiToolChangeSchema>;
 
@@ -127,28 +143,49 @@ export const aiAgentPhaseSchema = z.enum(AI_AGENT_PHASES);
 export type AiAgentPhase = z.infer<typeof aiAgentPhaseSchema>;
 
 /**
- * AI 상점 도우미의 작업 메모 폴더(2026-10-14) — 회차마다 읽는 숨은 규칙(`rules.md`)과 디자인 계획(`design.md`). 셀러 화면(타임라인·코드 탭·변경 기록)에
- * 보이지 않는다. 편집 Sandbox가 점(.)으로 시작하는 경로를 받지 않아 작업 트리의 `src` 아래에 둔다(앱이 import하지 않는 문서라 빌드에 들어가지 않는다)
+ * AI 상점 도우미의 작업 메모 폴더(2026-10-14) — 회차마다 읽는 숨은 규칙(`rules.md`)과 디자인 계획(`design.md`). 편집 Sandbox가 점(.)으로 시작하는
+ * 경로를 받지 않아 작업 트리의 `src` 아래에 둔다(앱이 import하지 않는 문서라 빌드에 들어가지 않는다). 숨은 규칙은 셀러 화면(타임라인·코드 탭·변경 기록)에
+ * 보이지 않는다. 디자인 계획은 2026-10-24부터 셀러 문서(작업 공간 문서 탭의 「디자인 가이드라인」)라 숨기지 않는다(`AI_DESIGN_GUIDE_PATH`)
  */
 export const AI_AGENT_NOTES_DIR = "src/site/agent";
+/** 디자인 가이드라인(디자인 계획) — 작업 메모 폴더에 있지만 셀러가 읽는 문서다 */
+export const AI_DESIGN_GUIDE_PATH = `${AI_AGENT_NOTES_DIR}/design.md`;
+/** 사이트맵 — 에이전트가 쓰는 화면 구성 문서(`{version:1,pages:[…]}`) */
+export const AI_SITEMAP_PATH = "src/site/sitemap.json";
+
+/** 작업 공간 문서 탭의 문서 파일인가(사이트맵·디자인 가이드라인) — 앱 코드가 아니라서 코드 탭·미리보기 점검·코드 변경 판정에서 뺀다 */
+export function isAiWorkspaceDocPath(path: string): boolean {
+  return path === AI_SITEMAP_PATH || path === AI_DESIGN_GUIDE_PATH;
+}
+
+/** 「이어서 진행」 버튼(실패한 실행 잇기)이 보내는 선택 값 — 선택지 답처럼 같은 할 일 목록을 잇는다 */
+export const AI_RUN_RESUME_CHOICE = "run:resume";
 
 /**
  * 에이전트의 할 일 목록(2026-10-14, Claude Code의 TaskCreate·TaskUpdate·TaskList와 같다) — 에이전트가 패널 도구로 할 일을 만들고 상태를 바꾼다.
- * 이벤트·조각은 그 시점의 목록 전체이고 작업 공간 왼쪽 패널이 마지막 목록을 체크리스트로 그린다. 진행중은 한 번에 하나다
+ * 이벤트·조각은 그 시점의 목록 전체이고 작업 공간 로드맵 탭이 마지막 목록을 칸반으로 그린다. 진행중은 한 번에 하나다.
+ * 목록은 셀러 요청 하나(사이클)의 일이다 — 새 요청이면 빈 목록에서 시작하고 선택지 답이면 잇는다(2026-10-24). 개수 상한은 없다
+ * (옛 30개 상한은 대화 전체에 할 일이 쌓여 넘쳤다 — 크기는 사이클 범위가, 폭주는 턴 예산이 막는다).
+ * `blocked`는 같은 문제를 거듭 고쳐도 남아 멈춘 일이고 `note`가 그 사유다(이어 가기 리마인더가 남은 일로 세지 않는다)
  */
-export const AI_TODO_STATUSES = ["pending", "in_progress", "completed"] as const;
+export const AI_TODO_STATUSES = ["pending", "in_progress", "completed", "blocked"] as const;
 export const aiTodoSchema = z.object({
-  /** 할 일 번호(대화 안에서 1부터) — 옛 조각에는 없다 */
+  /** 할 일 번호(사이클 안에서 1부터) — 옛 조각에는 없다 */
   id: z.string().max(10).optional(),
   content: z.string().min(1).max(200),
   status: z.enum(AI_TODO_STATUSES),
   /** 이 할 일이 속한 작업 단계 — 진행중이 되면 실행기가 단계를 알린다(2026-10-14, 모델이 단계 알림을 빠뜨렸다) */
   phase: aiAgentPhaseSchema.optional(),
+  /** 막힌 사유(`blocked`일 때만) */
+  note: z.string().max(300).optional(),
 });
 export type AiTodo = z.infer<typeof aiTodoSchema>;
+/** @deprecated 할 일 개수 상한은 없앴다(2026-10-24). 공개 export라 값만 남긴다 */
 export const AI_TODOS_MAX = 30;
 
+/** 셀러에게 보이지 않는 작업 메모인가 — 작업 메모 폴더에서 디자인 가이드라인을 뺀 나머지다 */
 export function isAiAgentNotesPath(path: string): boolean {
+  if (path === AI_DESIGN_GUIDE_PATH) return false;
   return path === AI_AGENT_NOTES_DIR || path.startsWith(`${AI_AGENT_NOTES_DIR}/`);
 }
 
@@ -260,7 +297,12 @@ export const AI_DESIGN_CONFIRM_APPROVE = "design:approve";
  * - `todos`: 에이전트의 할 일 목록 전체(작업 공간의 체크리스트)
  */
 export const aiMessagePartSchema = z.discriminatedUnion("type", [
-  z.object({ type: z.literal("text"), text: z.string() }),
+  z.object({
+    type: z.literal("text"),
+    text: z.string(),
+    /** 셀러가 선택지 버튼으로 보낸 답의 값(사용자 메시지만) — 할 일 목록(사이클)을 잇는 기준(`isAiChoiceAnswer`) */
+    choice: z.string().max(200).optional(),
+  }),
   z.object({
     type: z.literal("tool"),
     toolCallId: z.string(),
@@ -302,7 +344,7 @@ export const aiMessagePartSchema = z.discriminatedUnion("type", [
   z.object({ type: z.literal("reasoning"), text: z.string() }),
   z.object({ type: z.literal("phase"), phase: aiAgentPhaseSchema }),
   /** 에이전트의 할 일 목록 — 그 시점의 목록 전체다(가장 최근 것이 지금 목록) */
-  z.object({ type: z.literal("todos"), todos: z.array(aiTodoSchema).max(AI_TODOS_MAX) }),
+  z.object({ type: z.literal("todos"), todos: z.array(aiTodoSchema) }),
 ]);
 export type AiMessagePart = z.infer<typeof aiMessagePartSchema>;
 
@@ -347,12 +389,14 @@ export const storeSetupBriefSchema = z.object({
 });
 export type StoreSetupBrief = z.infer<typeof storeSetupBriefSchema>;
 
-export const createAiConversationRequestSchema = z.object({
-  /** 웹사이트에서 남긴 초안(#124 M2) — 연결한 사용자만 쓴다. 주면 첫 메시지로 실행을 시작한다 */
-  draftId: z.string().max(64).optional(),
-  /** 질문 화면의 답 — `draftId`와 함께만 쓴다. 초안 앞에 붙어 첫 메시지가 된다 */
-  brief: storeSetupBriefSchema.optional(),
-});
+export const createAiConversationRequestSchema = strictRequest(
+  z.object({
+    /** 웹사이트에서 남긴 초안(#124 M2) — 연결한 사용자만 쓴다. 주면 첫 메시지로 실행을 시작한다 */
+    draftId: z.string().max(64).optional(),
+    /** 질문 화면의 답 — `draftId`와 함께만 쓴다. 초안 앞에 붙어 첫 메시지가 된다 */
+    brief: storeSetupBriefSchema.optional(),
+  }),
+);
 export type CreateAiConversationRequest = z.infer<typeof createAiConversationRequestSchema>;
 
 export const createAiConversationResponseSchema = z.object({
@@ -362,20 +406,22 @@ export const createAiConversationResponseSchema = z.object({
 });
 export type CreateAiConversationResponse = z.infer<typeof createAiConversationResponseSchema>;
 
-export const sendAiMessageRequestSchema = z
-  .object({
-    text: z.string().trim().max(AI_MESSAGE_MAX_CHARS),
-    attachments: z.array(aiAttachmentSchema).max(AI_MESSAGE_MAX_ATTACHMENTS).default([]),
-    /** 선택지 버튼으로 보낸 답이면 그 값(화면 표시는 `text`) */
-    choice: z.string().max(200).optional(),
-    /** 편집 미리보기에서 고른 요소(#65) — 모델은 이 요소를 기준으로 고친다 */
-    selection: aiPreviewSelectionSchema.optional(),
-    /** 디자인 탭에서 고른 아트보드(2026-10-14) — 모델은 그 아트보드를 기준으로 고친다 */
-    designSelection: aiDesignSelectionSchema.optional(),
-  })
-  .refine((body) => body.text.length > 0 || body.attachments.length > 0, {
-    message: "내용이나 첨부가 있어야 합니다",
-  });
+export const sendAiMessageRequestSchema = strictRequest(
+  z
+    .object({
+      text: z.string().trim().max(AI_MESSAGE_MAX_CHARS),
+      attachments: z.array(aiAttachmentSchema).max(AI_MESSAGE_MAX_ATTACHMENTS).default([]),
+      /** 선택지 버튼으로 보낸 답이면 그 값(화면 표시는 `text`) */
+      choice: z.string().max(200).optional(),
+      /** 편집 미리보기에서 고른 요소(#65) — 모델은 이 요소를 기준으로 고친다 */
+      selection: aiPreviewSelectionSchema.optional(),
+      /** 디자인 탭에서 고른 아트보드(2026-10-14) — 모델은 그 아트보드를 기준으로 고친다 */
+      designSelection: aiDesignSelectionSchema.optional(),
+    })
+    .refine((body) => body.text.length > 0 || body.attachments.length > 0, {
+      message: "내용이나 첨부가 있어야 합니다",
+    }),
+);
 export type SendAiMessageRequest = z.input<typeof sendAiMessageRequestSchema>;
 
 export const sendAiMessageResponseSchema = aiStreamAccessSchema.extend({
@@ -506,7 +552,7 @@ export const aiStreamEventSchema = z.discriminatedUnion("type", [
   z.object({
     type: z.literal("todos"),
     messageId: z.string(),
-    todos: z.array(aiTodoSchema).max(AI_TODOS_MAX),
+    todos: z.array(aiTodoSchema),
   }),
   z.object({
     type: z.literal("tool_start"),
@@ -527,6 +573,8 @@ export const aiStreamEventSchema = z.discriminatedUnion("type", [
     toolCallId: z.string(),
     status: z.enum(["ok", "error", "unknown"]),
     summary: z.string().nullable(),
+    /** 결과로 확정한 변경(바뀐 줄 범위 포함) — 있으면 `tool_start`의 `changes`를 바꾼다 */
+    changes: z.array(aiToolChangeSchema).max(10).optional(),
   }),
   z.object({
     type: z.literal("choices"),
@@ -579,18 +627,20 @@ export const STORE_DRAFT_ATTACHMENT_MAX_BYTES = 10 * 1024 * 1024;
 /** 연결하지 않은 초안을 지우기까지 */
 export const STORE_DRAFT_RETENTION_DAYS = 7;
 
-export const createStoreDraftRequestSchema = z.object({
-  text: z.string().trim().min(1).max(AI_MESSAGE_MAX_CHARS),
-  attachments: z
-    .array(
-      z.object({
-        filename: z.string().trim().min(1).max(200),
-        size: z.number().int().positive().max(STORE_DRAFT_ATTACHMENT_MAX_BYTES),
-      }),
-    )
-    .max(STORE_DRAFT_MAX_ATTACHMENTS)
-    .default([]),
-});
+export const createStoreDraftRequestSchema = strictRequest(
+  z.object({
+    text: z.string().trim().min(1).max(AI_MESSAGE_MAX_CHARS),
+    attachments: z
+      .array(
+        z.object({
+          filename: z.string().trim().min(1).max(200),
+          size: z.number().int().positive().max(STORE_DRAFT_ATTACHMENT_MAX_BYTES),
+        }),
+      )
+      .max(STORE_DRAFT_MAX_ATTACHMENTS)
+      .default([]),
+  }),
+);
 export type CreateStoreDraftRequest = z.input<typeof createStoreDraftRequestSchema>;
 
 export const createStoreDraftResponseSchema = z.object({
@@ -622,3 +672,12 @@ export const storeDraftPreviewSchema = z.object({
   used: z.boolean(),
 });
 export type StoreDraftPreview = z.infer<typeof storeDraftPreviewSchema>;
+
+/**
+ * 셀러 메시지가 선택지에서 고른 답인가(조각에 `choice`가 있다) — 할 일 목록은 셀러 요청 하나(사이클)의 일이고, 고른 답(선택지·만들기 확인·계획 승인·발행 확인·
+ * 「이어서 진행」)은 같은 사이클을 잇고 새로 쓴 글은 새 사이클이다(2026-10-24). api(`currentCycleRows`)와 상점 플랫폼(로드맵)이 이 판정 하나를 쓴다.
+ * 직전 답에 선택지가 있었는지로 가르면 선택지를 무시하고 새 요청을 쓴 경우도 옛 사이클에 묶였다
+ */
+export function isAiChoiceAnswer(parts: readonly { type: string; choice?: string }[]): boolean {
+  return parts.some((part) => part.type === "text" && Boolean(part.choice));
+}

package/src/schemas/apps.ts

@@ -8,6 +8,7 @@ import {
   appSettingFieldSchema,
 } from "./app-manifest";
 import { webhookDeliveryErrorCodeSchema, webhookDeliveryStatusSchema } from "./misc";
+import { strictRequest } from "./strict";
 
 /**
  * 설치 앱 관리 API 계약 (이슈 #22) — `/v1/apps/installations/**`(상점이 설치한 앱), `/v1/app/installation`(설치 토큰 자기 조회).
@@ -183,21 +184,23 @@ export type AppInstallationActivity = z.infer<typeof appInstallationActivitySche
  * - `{ result }`: accounts 설치 동의 결과(1회용 JWT). 개발자 포털 [내 상점에 설치]가 이 길로 온다
  * - `{ appId, settings }`: 상점 플랫폼 앱 목록 › 설치 화면에서 동의하고 설정까지 채워 바로 설치한다
  */
-export const appInstallRequestSchema = z.union([
-  z.object({
-    result: z
-      .string()
-      .min(1)
-      .describe("accounts가 발급한 설치 결과 JWT(`typ: sayren-install+jwt`)"),
-  }),
-  z.object({
-    appId: z.string().min(1),
-    settings: z
-      .record(z.string(), settingsValueSchema)
-      .default({})
-      .describe("설치와 함께 저장할 설정. 비밀 필드도 여기서 넣는다"),
-  }),
-]);
+export const appInstallRequestSchema = strictRequest(
+  z.union([
+    z.object({
+      result: z
+        .string()
+        .min(1)
+        .describe("accounts가 발급한 설치 결과 JWT(`typ: sayren-install+jwt`)"),
+    }),
+    z.object({
+      appId: z.string().min(1),
+      settings: z
+        .record(z.string(), settingsValueSchema)
+        .default({})
+        .describe("설치와 함께 저장할 설정. 비밀 필드도 여기서 넣는다"),
+    }),
+  ]),
+);
 export type AppInstallRequest = z.infer<typeof appInstallRequestSchema>;
 
 /** 앱 목록 정보 — 현재 버전이 올린 아이콘·README(없으면 매니페스트 `iconUrl`) */

package/src/schemas/audit.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { strictRequest } from "./strict";
 
 /**
  * 감사 로그와 승인 요청 — `/v1/audit-logs`, `/v1/approval-requests` (이슈 #36).
@@ -261,7 +262,9 @@ export const approvalPageSchema = z.object({
 });
 export type ApprovalPage = z.infer<typeof approvalPageSchema>;
 
-export const approvalDecisionRequestSchema = z.object({
-  note: z.string().trim().max(500).optional().describe("승인·거절 메모 (최대 500자)"),
-});
+export const approvalDecisionRequestSchema = strictRequest(
+  z.object({
+    note: z.string().trim().max(500).optional().describe("승인·거절 메모 (최대 500자)"),
+  }),
+);
 export type ApprovalDecisionRequest = z.infer<typeof approvalDecisionRequestSchema>;

package/src/schemas/category.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { strictRequest } from "./strict";
 
 export const categoryProductSortSchema = z.enum([
   "RECENT",
@@ -70,40 +71,44 @@ export const categoryAttributeSchema = z.object({
 
 export type CategoryAttribute = z.infer<typeof categoryAttributeSchema>;
 
-export const categoryCreateRequestSchema = z.object({
-  name: z.string().min(1).max(100),
-  parentId: z.string().nullable().optional(),
-  sortOrder: z.number().int().optional(),
-  visible: z.boolean().optional(),
-  showPc: z.boolean().optional(),
-  showMobile: z.boolean().optional(),
-  productSort: categoryProductSortSchema.optional(),
-  metaTitle: z.string().max(100).nullable().optional(),
-  metaDescription: z.string().max(300).nullable().optional(),
-  metaKeywords: z.string().max(200).nullable().optional(),
-});
+export const categoryCreateRequestSchema = strictRequest(
+  z.object({
+    name: z.string().min(1).max(100),
+    parentId: z.string().nullable().optional(),
+    sortOrder: z.number().int().optional(),
+    visible: z.boolean().optional(),
+    showPc: z.boolean().optional(),
+    showMobile: z.boolean().optional(),
+    productSort: categoryProductSortSchema.optional(),
+    metaTitle: z.string().max(100).nullable().optional(),
+    metaDescription: z.string().max(300).nullable().optional(),
+    metaKeywords: z.string().max(200).nullable().optional(),
+  }),
+);
 
 export type CategoryCreateRequest = z.infer<typeof categoryCreateRequestSchema>;
 
-export const categoryPatchRequestSchema = z.object({
-  name: z.string().min(1).max(100).optional(),
-  parentId: z.string().nullable().optional(),
-  sortOrder: z.number().int().optional(),
-  visible: z.boolean().optional(),
-  showPc: z.boolean().optional(),
-  showMobile: z.boolean().optional(),
-  productSort: categoryProductSortSchema.optional(),
-  metaTitle: z.string().max(100).nullable().optional(),
-  metaDescription: z.string().max(300).nullable().optional(),
-  metaKeywords: z.string().max(200).nullable().optional(),
-  flowId: z
-    .string()
-    .nullable()
-    .optional()
-    .describe(
-      "주문 흐름(이슈 #115) — 게시한 흐름 id, null이면 기본 흐름. 맨 아래 카테고리에만 지정한다(400 `CATEGORY_NOT_LEAF`). 게시하지 않은 흐름은 409 `FLOW_NOT_PUBLISHED`",
-    ),
-});
+export const categoryPatchRequestSchema = strictRequest(
+  z.object({
+    name: z.string().min(1).max(100).optional(),
+    parentId: z.string().nullable().optional(),
+    sortOrder: z.number().int().optional(),
+    visible: z.boolean().optional(),
+    showPc: z.boolean().optional(),
+    showMobile: z.boolean().optional(),
+    productSort: categoryProductSortSchema.optional(),
+    metaTitle: z.string().max(100).nullable().optional(),
+    metaDescription: z.string().max(300).nullable().optional(),
+    metaKeywords: z.string().max(200).nullable().optional(),
+    flowId: z
+      .string()
+      .nullable()
+      .optional()
+      .describe(
+        "주문 흐름(이슈 #115) — 게시한 흐름 id, null이면 기본 흐름. 맨 아래 카테고리에만 지정한다(400 `CATEGORY_NOT_LEAF`). 게시하지 않은 흐름은 409 `FLOW_NOT_PUBLISHED`",
+      ),
+  }),
+);
 
 export type CategoryPatchRequest = z.infer<typeof categoryPatchRequestSchema>;
 

package/src/schemas/claim.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { commerceNumberField } from "./commerce-number";
 import { type PageParams, pageQueryShape } from "./common";
+import { strictRequest } from "./strict";
 
 export const claimTypeSchema = z.enum(["CANCEL", "RETURN", "EXCHANGE"]);
 
@@ -164,17 +165,19 @@ export const claimHoldResultSchema = z.object({ claimId: z.string(), holdExpires
 
 export type ClaimHoldResult = z.infer<typeof claimHoldResultSchema>;
 
-export const rejectClaimRequestSchema = z.object({
-  reason: z.enum([
-    "USED_PRODUCT",
-    "MISSING_COMPONENT",
-    "PERIOD_EXPIRED",
-    "BUYER_FAULT_DAMAGE",
-    "ETC",
-  ]),
-  detail: z.string().min(10).max(1000),
-  evidenceImages: z.array(z.url()).max(5).optional(),
-});
+export const rejectClaimRequestSchema = strictRequest(
+  z.object({
+    reason: z.enum([
+      "USED_PRODUCT",
+      "MISSING_COMPONENT",
+      "PERIOD_EXPIRED",
+      "BUYER_FAULT_DAMAGE",
+      "ETC",
+    ]),
+    detail: z.string().min(10).max(1000),
+    evidenceImages: z.array(z.url()).max(5).optional(),
+  }),
+);
 
 export type RejectClaimRequest = z.infer<typeof rejectClaimRequestSchema>;
 

package/src/schemas/collection.ts

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { type PageParams, pageQueryShape, pageSchema } from "./common";
 import { productImageUrlSchema } from "./product";
+import { strictRequest } from "./strict";
 
 /**
  * 컬렉션 (이슈 #83) — 상품을 어디에 보여 줄지 정하는 묶음이다. 카테고리는 상품이 무엇인지를 정하고 상품당 하나지만, 컬렉션은
@@ -432,33 +433,35 @@ const periodRefine = (
  * 직접 선택(`MANUAL`)은 `productIds`가 처음 담을 상품과 순서다. 조건 자동(`AUTOMATIC`)은 `rules`가 있어야 하고 `productIds`를 받지 않는다.
  * `productSort`를 생략하면 직접 선택은 `MANUAL`, 조건 자동은 `LATEST`(판매량 상위 조건이 있으면 `BEST_SELLING`)다. 조건 자동은 `MANUAL`을 쓸 수 없다.
  */
-export const collectionCreateRequestSchema = z
-  .object({
-    title: z.string().trim().min(1).max(MAX_COLLECTION_TITLE).describe("제목"),
-    slug: slugField.optional(),
-    type: z
-      .enum(COLLECTION_TYPES)
-      .default("MANUAL")
-      .describe("유형. `MANUAL`(직접 선택)·`AUTOMATIC`(조건 자동). 만든 뒤 바꿀 수 없다"),
-    rules: collectionRulesSchema
-      .optional()
-      .describe("조건 자동 컬렉션의 조건(AND). 조건 자동이면 필수, 직접 선택이면 줄 수 없다"),
-    description: commonFields.description.default(""),
-    imageUrl: commonFields.imageUrl.optional(),
-    productSort: commonFields.productSort
-      .optional()
-      .describe(
-        "스토어프론트 상품 기본 정렬. 생략하면 직접 선택은 `MANUAL`, 조건 자동은 `LATEST`(판매량 상위 조건이 있으면 `BEST_SELLING`)다. 조건 자동은 `MANUAL`을 쓸 수 없다",
-      ),
-    visible: commonFields.visible.default(true),
-    startsAt: commonFields.startsAt,
-    endsAt: commonFields.endsAt,
-    sortOrder: commonFields.sortOrder.optional().describe("목록 순서. 생략하면 맨 뒤"),
-    metaTitle: commonFields.metaTitle.optional(),
-    metaDescription: commonFields.metaDescription.optional(),
-    productIds: productIdsField.optional(),
-  })
-  .superRefine(periodRefine);
+export const collectionCreateRequestSchema = strictRequest(
+  z
+    .object({
+      title: z.string().trim().min(1).max(MAX_COLLECTION_TITLE).describe("제목"),
+      slug: slugField.optional(),
+      type: z
+        .enum(COLLECTION_TYPES)
+        .default("MANUAL")
+        .describe("유형. `MANUAL`(직접 선택)·`AUTOMATIC`(조건 자동). 만든 뒤 바꿀 수 없다"),
+      rules: collectionRulesSchema
+        .optional()
+        .describe("조건 자동 컬렉션의 조건(AND). 조건 자동이면 필수, 직접 선택이면 줄 수 없다"),
+      description: commonFields.description.default(""),
+      imageUrl: commonFields.imageUrl.optional(),
+      productSort: commonFields.productSort
+        .optional()
+        .describe(
+          "스토어프론트 상품 기본 정렬. 생략하면 직접 선택은 `MANUAL`, 조건 자동은 `LATEST`(판매량 상위 조건이 있으면 `BEST_SELLING`)다. 조건 자동은 `MANUAL`을 쓸 수 없다",
+        ),
+      visible: commonFields.visible.default(true),
+      startsAt: commonFields.startsAt,
+      endsAt: commonFields.endsAt,
+      sortOrder: commonFields.sortOrder.optional().describe("목록 순서. 생략하면 맨 뒤"),
+      metaTitle: commonFields.metaTitle.optional(),
+      metaDescription: commonFields.metaDescription.optional(),
+      productIds: productIdsField.optional(),
+    })
+    .superRefine(periodRefine),
+);
 
 export type CollectionCreateRequest = z.infer<typeof collectionCreateRequestSchema>;
 export type CollectionCreateRequestInput = z.input<typeof collectionCreateRequestSchema>;
@@ -467,45 +470,51 @@ export type CollectionCreateRequestInput = z.input<typeof collectionCreateReques
  * `PATCH /v1/collections/{collectionId}` — 준 항목만 바뀐다. `type`을 주면 400 `COLLECTION_TYPE_IMMUTABLE`이다.
  * `revision`을 주면 그 번호일 때만 바뀌고, 그 사이 다른 수정이 있었으면 409 `COLLECTION_CHANGED`다.
  */
-export const collectionPatchRequestSchema = z
-  .object({
-    title: z.string().trim().min(1).max(MAX_COLLECTION_TITLE).optional(),
-    slug: slugField.optional(),
-    type: z.string().optional().describe("바꿀 수 없다. 주면 400 `COLLECTION_TYPE_IMMUTABLE`"),
-    rules: collectionRulesSchema
-      .optional()
-      .describe(
-        "조건 자동 컬렉션의 조건을 통째로 바꾼다. 직접 선택 컬렉션에 주면 400 `COLLECTION_RULES_NOT_ALLOWED`",
-      ),
-    description: commonFields.description.optional(),
-    imageUrl: commonFields.imageUrl.optional(),
-    productSort: commonFields.productSort.optional(),
-    visible: commonFields.visible.optional(),
-    startsAt: commonFields.startsAt,
-    endsAt: commonFields.endsAt,
-    sortOrder: commonFields.sortOrder.optional(),
-    metaTitle: commonFields.metaTitle.optional(),
-    metaDescription: commonFields.metaDescription.optional(),
-    revision: z.number().int().min(0).optional().describe("읽은 수정 번호"),
-  })
-  .superRefine(periodRefine);
+export const collectionPatchRequestSchema = strictRequest(
+  z
+    .object({
+      title: z.string().trim().min(1).max(MAX_COLLECTION_TITLE).optional(),
+      slug: slugField.optional(),
+      type: z.string().optional().describe("바꿀 수 없다. 주면 400 `COLLECTION_TYPE_IMMUTABLE`"),
+      rules: collectionRulesSchema
+        .optional()
+        .describe(
+          "조건 자동 컬렉션의 조건을 통째로 바꾼다. 직접 선택 컬렉션에 주면 400 `COLLECTION_RULES_NOT_ALLOWED`",
+        ),
+      description: commonFields.description.optional(),
+      imageUrl: commonFields.imageUrl.optional(),
+      productSort: commonFields.productSort.optional(),
+      visible: commonFields.visible.optional(),
+      startsAt: commonFields.startsAt,
+      endsAt: commonFields.endsAt,
+      sortOrder: commonFields.sortOrder.optional(),
+      metaTitle: commonFields.metaTitle.optional(),
+      metaDescription: commonFields.metaDescription.optional(),
+      revision: z.number().int().min(0).optional().describe("읽은 수정 번호"),
+    })
+    .superRefine(periodRefine),
+);
 
 export type CollectionPatchRequest = z.infer<typeof collectionPatchRequestSchema>;
 
 /** `PUT /v1/collections/{collectionId}/products` — 담긴 상품을 통째로 바꾼다(순서 포함) */
-export const collectionProductsReplaceRequestSchema = z.object({
-  productIds: productIdsField,
-  revision: z.number().int().min(0).optional().describe("읽은 수정 번호"),
-});
+export const collectionProductsReplaceRequestSchema = strictRequest(
+  z.object({
+    productIds: productIdsField,
+    revision: z.number().int().min(0).optional().describe("읽은 수정 번호"),
+  }),
+);
 
 export type CollectionProductsReplaceRequest = z.infer<
   typeof collectionProductsReplaceRequestSchema
 >;
 
 /** `POST /v1/collections/{collectionId}/products` — 뒤에 붙인다. 이미 담긴 상품은 그 자리에 둔다 */
-export const collectionProductsAddRequestSchema = z.object({
-  productIds: z.array(z.string().min(1)).min(1).max(MAX_COLLECTION_PRODUCTS_PER_ADD),
-});
+export const collectionProductsAddRequestSchema = strictRequest(
+  z.object({
+    productIds: z.array(z.string().min(1)).min(1).max(MAX_COLLECTION_PRODUCTS_PER_ADD),
+  }),
+);
 
 export type CollectionProductsAddRequest = z.infer<typeof collectionProductsAddRequestSchema>;
 
@@ -562,14 +571,16 @@ export const collectionProductListQuerySchema = z.object({
 });
 
 /** `POST /v1/collections/preview` — 저장하지 않고 조건으로 나오는 상품을 본다 */
-export const collectionPreviewRequestSchema = z.object({
-  rules: collectionRulesSchema,
-  productSort: collectionProductSortRequestSchema
-    .optional()
-    .describe(
-      "미리보기 순서. 생략하면 `LATEST`(판매량 상위 조건이 있으면 `BEST_SELLING`)이고, `MANUAL`이면 `LATEST`다",
-    ),
-});
+export const collectionPreviewRequestSchema = strictRequest(
+  z.object({
+    rules: collectionRulesSchema,
+    productSort: collectionProductSortRequestSchema
+      .optional()
+      .describe(
+        "미리보기 순서. 생략하면 `LATEST`(판매량 상위 조건이 있으면 `BEST_SELLING`)이고, `MANUAL`이면 `LATEST`다",
+      ),
+  }),
+);
 
 export type CollectionPreviewRequest = z.infer<typeof collectionPreviewRequestSchema>;