@sayren/store-sdk 0.40.0 → 0.42.0

package/src/schemas/storefront-hosting.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { RESERVED_STORE_CODES } from "./store";
+import { strictRequest } from "./strict";
 
 /**
  * 스토어프론트 호스팅 (이슈 #53, M1: 템플릿 발행) — 관리 API `/v1/storefront/**`의 계약이다.
@@ -219,17 +220,19 @@ export const TEMPLATE_STORE_LOCKED_BUSINESS_FIELDS = [
   "customerCenterEmail",
 ] as const;
 
-export const updateStoreTemplateRequestSchema = z.object({
-  name: z.string().trim().min(1).max(40).describe("템플릿 이름(1~40자)"),
-  description: z.string().trim().max(200).describe("템플릿 소개(200자까지)"),
-  thumbnailUrl: z
-    .url({ protocol: /^https$/ })
-    .max(2048)
-    .nullable()
-    .describe(
-      "썸네일 이미지 주소(https). 이미지 업로드(`POST /v1/uploads`)로 받은 주소를 쓴다. 없으면 null",
-    ),
-});
+export const updateStoreTemplateRequestSchema = strictRequest(
+  z.object({
+    name: z.string().trim().min(1).max(40).describe("템플릿 이름(1~40자)"),
+    description: z.string().trim().max(200).describe("템플릿 소개(200자까지)"),
+    thumbnailUrl: z
+      .url({ protocol: /^https$/ })
+      .max(2048)
+      .nullable()
+      .describe(
+        "썸네일 이미지 주소(https). 이미지 업로드(`POST /v1/uploads`)로 받은 주소를 쓴다. 없으면 null",
+      ),
+  }),
+);
 export type UpdateStoreTemplateRequest = z.infer<typeof updateStoreTemplateRequestSchema>;
 
 // ─── 버전 ─────────────────────────────────────────────────
@@ -493,16 +496,18 @@ export type StorefrontDeployment = z.infer<typeof storefrontDeploymentSchema>;
 
 // ─── 요청 ─────────────────────────────────────────────────
 
-export const createStorefrontSiteRequestSchema = z.object({
-  templateId: z.string().min(1).max(64).describe("템플릿 id"),
-  slug: storefrontSlugSchema.optional().describe("주소 슬러그. 생략하면 상점 코드"),
-  copyContent: z
-    .boolean()
-    .optional()
-    .describe(
-      "템플릿 상점의 템플릿일 때만 — true면 템플릿 상점의 콘텐츠(레이아웃, 상품·카테고리·컬렉션·주문 흐름·배송·환불 정책)를 이 상점으로 복사한다. 쿠폰·적립금·리뷰는 복사하지 않는다. 생략하거나 false면 레이아웃 콘텐츠를 비우고 빌드한다",
-    ),
-});
+export const createStorefrontSiteRequestSchema = strictRequest(
+  z.object({
+    templateId: z.string().min(1).max(64).describe("템플릿 id"),
+    slug: storefrontSlugSchema.optional().describe("주소 슬러그. 생략하면 상점 코드"),
+    copyContent: z
+      .boolean()
+      .optional()
+      .describe(
+        "템플릿 상점의 템플릿일 때만 — true면 템플릿 상점의 콘텐츠(레이아웃, 상품·카테고리·컬렉션·주문 흐름·배송·환불 정책)를 이 상점으로 복사한다. 쿠폰·적립금·리뷰는 복사하지 않는다. 생략하거나 false면 레이아웃 콘텐츠를 비우고 빌드한다",
+      ),
+  }),
+);
 export type CreateStorefrontSiteRequest = z.infer<typeof createStorefrontSiteRequestSchema>;
 
 /** @deprecated 템플릿 변경은 지원하지 않는다(항상 409 `TEMPLATE_CHANGE_NOT_SUPPORTED`). 호환을 위해 스키마만 남겼다 */
@@ -522,42 +527,55 @@ export type ChangeStorefrontTemplateRequest = z.infer<typeof changeStorefrontTem
  * 지금 발행 버전이 그 값일 때만 바꾼다(화면을 본 뒤 다른 사람이 바꿨으면 409 `STOREFRONT_SITE_CHANGED`).
  * 이미 그 버전이 발행돼 있으면 아무것도 바꾸지 않고 200이다(같은 요청의 재실행이 안전하다).
  */
-export const publishStorefrontVersionRequestSchema = z.object({
-  expectedPublishedVersionId: z
-    .string()
-    .nullable()
-    .optional()
-    .describe("화면에서 본 발행 버전 id (발행 전이었으면 null). 생략하면 확인하지 않는다"),
-});
+export const publishStorefrontVersionRequestSchema = strictRequest(
+  z.object({
+    expectedPublishedVersionId: z
+      .string()
+      .nullable()
+      .optional()
+      .describe("화면에서 본 발행 버전 id (발행 전이었으면 null). 생략하면 확인하지 않는다"),
+  }),
+);
 export type PublishStorefrontVersionRequest = z.infer<typeof publishStorefrontVersionRequestSchema>;
 
-export const rollbackStorefrontRequestSchema = z.object({
-  versionId: z.string().optional().describe("되돌릴 버전. 생략하면 지금 버전 직전에 발행했던 버전"),
-  expectedPublishedVersionId: z.string().nullable().optional(),
-});
+export const rollbackStorefrontRequestSchema = strictRequest(
+  z.object({
+    versionId: z
+      .string()
+      .optional()
+      .describe("되돌릴 버전. 생략하면 지금 버전 직전에 발행했던 버전"),
+    expectedPublishedVersionId: z.string().nullable().optional(),
+  }),
+);
 export type RollbackStorefrontRequest = z.infer<typeof rollbackStorefrontRequestSchema>;
 
-export const changeStorefrontSlugRequestSchema = z.object({
-  slug: storefrontSlugSchema,
-});
+export const changeStorefrontSlugRequestSchema = strictRequest(
+  z.object({
+    slug: storefrontSlugSchema,
+  }),
+);
 export type ChangeStorefrontSlugRequest = z.infer<typeof changeStorefrontSlugRequestSchema>;
 
-export const setStorefrontVisibilityRequestSchema = z.object({
-  visibility: storefrontVisibilitySchema,
-  expectedVisibility: storefrontVisibilitySchema
-    .optional()
-    .describe("화면에서 본 공개 상태. 주면 지금 값이 같을 때만 바꾼다"),
-});
+export const setStorefrontVisibilityRequestSchema = strictRequest(
+  z.object({
+    visibility: storefrontVisibilitySchema,
+    expectedVisibility: storefrontVisibilitySchema
+      .optional()
+      .describe("화면에서 본 공개 상태. 주면 지금 값이 같을 때만 바꾼다"),
+  }),
+);
 export type SetStorefrontVisibilityRequest = z.infer<typeof setStorefrontVisibilityRequestSchema>;
 
 /** 호스팅 끄기 — 사이트를 닫고(`CLOSED`) 슬러그를 보류한다. 확인 입력은 받지 않는다(2026-10-22) */
-export const disableStorefrontHostingRequestSchema = z.object({
-  confirmSlug: z
-    .string()
-    .max(200)
-    .optional()
-    .describe("쓰지 않는다 — 보내도 무시한다(옛 확인 입력)"),
-});
+export const disableStorefrontHostingRequestSchema = strictRequest(
+  z.object({
+    confirmSlug: z
+      .string()
+      .max(200)
+      .optional()
+      .describe("쓰지 않는다 — 보내도 무시한다(옛 확인 입력)"),
+  }),
+);
 export type DisableStorefrontHostingRequest = z.infer<typeof disableStorefrontHostingRequestSchema>;
 
 export const storefrontSlugAvailabilityQuerySchema = z.object({
@@ -569,16 +587,18 @@ export const storefrontSlugAvailabilityQuerySchema = z.object({
  * (오픈 준비 중이어도 실제 화면), 링크를 5분 안에 열면 그 브라우저에 그 주소 전용 12시간 쿠키가 생긴다. 사이트 주소는 오픈 전이면
  * 누구에게나 「오픈 준비 중」이다. 미리보기 주소에 쿠키 없이 들어오면 상점 플랫폼 로그인과 OWNER·ADMIN 확인을 거친다.
  */
-export const createStorefrontPreviewLinkRequestSchema = z.object({
-  path: z.string().max(512).optional().describe("열 경로 (`/`로 시작). 생략하면 `/`"),
-  versionId: z
-    .string()
-    .max(64)
-    .optional()
-    .describe(
-      "볼 버전. 생략하면 발행 버전이다. 보관 기간이 지난 버전(`previewable: false`)은 409 `STOREFRONT_VERSION_NOT_PREVIEWABLE`",
-    ),
-});
+export const createStorefrontPreviewLinkRequestSchema = strictRequest(
+  z.object({
+    path: z.string().max(512).optional().describe("열 경로 (`/`로 시작). 생략하면 `/`"),
+    versionId: z
+      .string()
+      .max(64)
+      .optional()
+      .describe(
+        "볼 버전. 생략하면 발행 버전이다. 보관 기간이 지난 버전(`previewable: false`)은 409 `STOREFRONT_VERSION_NOT_PREVIEWABLE`",
+      ),
+  }),
+);
 export type CreateStorefrontPreviewLinkRequest = z.infer<
   typeof createStorefrontPreviewLinkRequestSchema
 >;
@@ -840,13 +860,15 @@ export const storefrontSiteDomainsSchema = z.object({
 });
 export type StorefrontSiteDomains = z.infer<typeof storefrontSiteDomainsSchema>;
 
-export const addStorefrontDomainRequestSchema = z.object({
-  hostname: z
-    .string()
-    .min(1)
-    .max(300)
-    .describe("연결할 도메인 (예: `shop.brand.com`). 서버가 소문자·punycode로 정규화한다"),
-});
+export const addStorefrontDomainRequestSchema = strictRequest(
+  z.object({
+    hostname: z
+      .string()
+      .min(1)
+      .max(300)
+      .describe("연결할 도메인 (예: `shop.brand.com`). 서버가 소문자·punycode로 정규화한다"),
+  }),
+);
 export type AddStorefrontDomainRequest = z.infer<typeof addStorefrontDomainRequestSchema>;
 
 // ─── 편집 (M2b) ───────────────────────────────────────────
@@ -990,14 +1012,16 @@ export type StorefrontEditSession = z.infer<typeof storefrontEditSessionSchema>;
  * 편집 환경이 켜져 있지 않으면 409 `EDIT_SESSION_REQUIRED`
  */
 /** `POST /v1/storefront/site/editing/git/merge` — 켜진 편집 환경 작업 트리에 운영 브랜치 최신 커밋을 합친다(#138, Git 원천 사이트) */
-export const storefrontGitMergeRequestSchema = z.object({
-  action: z
-    .enum(["merge", "continue", "abort"])
-    .default("merge")
-    .describe(
-      "`merge` 최신 운영 브랜치를 합친다 · `continue` 충돌 표시를 고친 뒤 합치기를 끝낸다 · `abort` 합치기를 취소하고 합치기 전으로 돌린다",
-    ),
-});
+export const storefrontGitMergeRequestSchema = strictRequest(
+  z.object({
+    action: z
+      .enum(["merge", "continue", "abort"])
+      .default("merge")
+      .describe(
+        "`merge` 최신 운영 브랜치를 합친다 · `continue` 충돌 표시를 고친 뒤 합치기를 끝낸다 · `abort` 합치기를 취소하고 합치기 전으로 돌린다",
+      ),
+  }),
+);
 export type StorefrontGitMergeRequest = z.input<typeof storefrontGitMergeRequestSchema>;
 
 export const storefrontGitMergeSchema = z.object({
@@ -1134,25 +1158,27 @@ export type StorefrontFileContent = z.infer<typeof storefrontFileContentSchema>;
  * 해시가 같아야 한다. 조건을 **모두** 확인한 뒤 쓰고, 하나라도 어긋나면 아무것도 쓰지 않는다(409 `FILE_CHANGED`,
  * `error.details.conflicts`).
  */
-export const writeStorefrontFilesRequestSchema = z.object({
-  files: z
-    .array(
-      z.object({
-        path: storefrontFilePathSchema,
-        content: z.string().describe("내용 (`encoding`에 따라 텍스트 또는 base64)"),
-        encoding: storefrontFileEncodingSchema.optional().describe("기본 `utf8`"),
-        expectedHash: storefrontFileHashSchema
-          .nullable()
-          .optional()
-          .describe("쓰기 조건. 생략 = 조건 없음 · null = 새 파일 · 값 = 지금 해시가 같을 때만"),
+export const writeStorefrontFilesRequestSchema = strictRequest(
+  z.object({
+    files: z
+      .array(
+        z.object({
+          path: storefrontFilePathSchema,
+          content: z.string().describe("내용 (`encoding`에 따라 텍스트 또는 base64)"),
+          encoding: storefrontFileEncodingSchema.optional().describe("기본 `utf8`"),
+          expectedHash: storefrontFileHashSchema
+            .nullable()
+            .optional()
+            .describe("쓰기 조건. 생략 = 조건 없음 · null = 새 파일 · 값 = 지금 해시가 같을 때만"),
+        }),
+      )
+      .min(1)
+      .max(STOREFRONT_FILE_BATCH_MAX)
+      .refine((files) => new Set(files.map((file) => file.path)).size === files.length, {
+        message: "같은 경로를 두 번 실을 수 없습니다",
       }),
-    )
-    .min(1)
-    .max(STOREFRONT_FILE_BATCH_MAX)
-    .refine((files) => new Set(files.map((file) => file.path)).size === files.length, {
-      message: "같은 경로를 두 번 실을 수 없습니다",
-    }),
-});
+  }),
+);
 export type WriteStorefrontFilesRequest = z.infer<typeof writeStorefrontFilesRequestSchema>;
 
 export const storefrontFileWriteResultSchema = z.object({
@@ -1172,10 +1198,12 @@ export const storefrontFileConflictDetailsSchema = z.object({
 export type StorefrontFileConflictDetails = z.infer<typeof storefrontFileConflictDetailsSchema>;
 
 /** `POST /v1/storefront/site/files/delete` — 없는 파일이면 `deleted: false`(조건을 주면 409 `FILE_CHANGED`) */
-export const deleteStorefrontFileRequestSchema = z.object({
-  path: storefrontFilePathSchema,
-  expectedHash: storefrontFileHashSchema.optional().describe("주면 지금 해시가 같을 때만 지운다"),
-});
+export const deleteStorefrontFileRequestSchema = strictRequest(
+  z.object({
+    path: storefrontFilePathSchema,
+    expectedHash: storefrontFileHashSchema.optional().describe("주면 지금 해시가 같을 때만 지운다"),
+  }),
+);
 export type DeleteStorefrontFileRequest = z.infer<typeof deleteStorefrontFileRequestSchema>;
 
 export const storefrontFileDeleteResultSchema = z.object({
@@ -1185,15 +1213,19 @@ export const storefrontFileDeleteResultSchema = z.object({
 export type StorefrontFileDeleteResult = z.infer<typeof storefrontFileDeleteResultSchema>;
 
 /** `POST /v1/storefront/site/files/move` — 이름 바꾸기·옮기기 */
-export const moveStorefrontFileRequestSchema = z.object({
-  from: storefrontFilePathSchema,
-  to: storefrontFilePathSchema,
-  expectedHash: storefrontFileHashSchema.optional().describe("주면 `from`의 지금 해시가 같을 때만"),
-  overwrite: z
-    .boolean()
-    .optional()
-    .describe("`to`에 파일이 있으면 덮는가 (기본 false → 409 `FILE_EXISTS`)"),
-});
+export const moveStorefrontFileRequestSchema = strictRequest(
+  z.object({
+    from: storefrontFilePathSchema,
+    to: storefrontFilePathSchema,
+    expectedHash: storefrontFileHashSchema
+      .optional()
+      .describe("주면 `from`의 지금 해시가 같을 때만"),
+    overwrite: z
+      .boolean()
+      .optional()
+      .describe("`to`에 파일이 있으면 덮는가 (기본 false → 409 `FILE_EXISTS`)"),
+  }),
+);
 export type MoveStorefrontFileRequest = z.infer<typeof moveStorefrontFileRequestSchema>;
 
 export const storefrontFileMoveResultSchema = z.object({
@@ -1208,23 +1240,25 @@ export type StorefrontFileMoveResult = z.infer<typeof storefrontFileMoveResultSc
 /** 정규식 검색의 패턴 길이 상한 — 편집 Sandbox가 실행 비용을 막으려고 더 좁게 받는다(sandbox-api §4.6) */
 export const STOREFRONT_SEARCH_REGEX_MAX_LENGTH = 100;
 
-export const searchStorefrontFilesRequestSchema = z
-  .object({
-    query: z.string().min(1).max(200),
-    regex: z
-      .boolean()
-      .optional()
-      .describe(
-        "`query`를 정규식으로 본다 (기본 false = 글자 그대로). 정규식은 100자까지이고 중첩 수량자(`(a+)+`)·반복되는 선택(`(a|b)+`)·역참조·뒤 보기, 가변 수량자(`*`·`+`·`?`·`{n,m}`, 넓은 범위는 2로 센다) 차수 4 초과는 400 `INVALID_REQUEST`다. 차수가 클수록 긴 줄은 건너뛰고 비용이 크면 `truncated`로 끊는다",
-      ),
-    caseSensitive: z.boolean().optional().describe("대소문자를 가리는가 (기본 false)"),
-    pathPrefix: z.string().max(256).optional(),
-    maxResults: z.number().int().min(1).max(200).optional().describe("기본 50"),
-  })
-  .refine((body) => !body.regex || body.query.length <= STOREFRONT_SEARCH_REGEX_MAX_LENGTH, {
-    message: `정규식은 ${STOREFRONT_SEARCH_REGEX_MAX_LENGTH}자까지입니다`,
-    path: ["query"],
-  });
+export const searchStorefrontFilesRequestSchema = strictRequest(
+  z
+    .object({
+      query: z.string().min(1).max(200),
+      regex: z
+        .boolean()
+        .optional()
+        .describe(
+          "`query`를 정규식으로 본다 (기본 false = 글자 그대로). 정규식은 100자까지이고 중첩 수량자(`(a+)+`)·반복되는 선택(`(a|b)+`)·역참조·뒤 보기, 가변 수량자(`*`·`+`·`?`·`{n,m}`, 넓은 범위는 2로 센다) 차수 4 초과는 400 `INVALID_REQUEST`다. 차수가 클수록 긴 줄은 건너뛰고 비용이 크면 `truncated`로 끊는다",
+        ),
+      caseSensitive: z.boolean().optional().describe("대소문자를 가리는가 (기본 false)"),
+      pathPrefix: z.string().max(256).optional(),
+      maxResults: z.number().int().min(1).max(200).optional().describe("기본 50"),
+    })
+    .refine((body) => !body.regex || body.query.length <= STOREFRONT_SEARCH_REGEX_MAX_LENGTH, {
+      message: `정규식은 ${STOREFRONT_SEARCH_REGEX_MAX_LENGTH}자까지입니다`,
+      path: ["query"],
+    }),
+);
 export type SearchStorefrontFilesRequest = z.infer<typeof searchStorefrontFilesRequestSchema>;
 
 export const storefrontFileSearchResultSchema = z.object({
@@ -1248,9 +1282,11 @@ export type StorefrontFileSearchResult = z.infer<typeof storefrontFileSearchResu
  * `GET /v1/storefront/site/checks/{checkId}`로 조회한다(권장 2~3초 간격). 사이트당 끝나지 않은 검사는 하나다 — 같은 종류가 돌고
  * 있으면 그 검사를 다시 돌려주고, 다른 종류면 409 `CHECK_RUNNING`(`error.details.checkId`)이다. 출력은 꼬리만 준다.
  */
-export const runStorefrontCheckRequestSchema = z.object({
-  check: z.enum(["typecheck", "lint", "test"]),
-});
+export const runStorefrontCheckRequestSchema = strictRequest(
+  z.object({
+    check: z.enum(["typecheck", "lint", "test"]),
+  }),
+);
 export type RunStorefrontCheckRequest = z.infer<typeof runStorefrontCheckRequestSchema>;
 
 export const storefrontCheckStatusSchema = z
@@ -1456,16 +1492,18 @@ export const storefrontBuildListQuerySchema = z.object({
  * `POST /v1/storefront/site/versions` — 지금 작업 트리를 고정해 버전을 만든다(빌드 시작). 사이트당 끝나지 않은 빌드는
  * 하나다(409 `STOREFRONT_BUILD_IN_PROGRESS`). 편집 환경이 없어도 된다.
  */
-export const createStorefrontVersionRequestSchema = z.object({
-  message: z.string().max(200).optional().describe("버전 메모 (에이전트는 바꾼 내용 요약)"),
-  expectedSourceRef: z
-    .string()
-    .max(200)
-    .optional()
-    .describe(
-      "고정할 작업 트리 (`PUT /v1/storefront/site/source`의 `sourceRef`). 주면 지금 작업 트리가 이 값일 때만 버전을 만든다(다르면 409 `SOURCE_CHANGED`)",
-    ),
-});
+export const createStorefrontVersionRequestSchema = strictRequest(
+  z.object({
+    message: z.string().max(200).optional().describe("버전 메모 (에이전트는 바꾼 내용 요약)"),
+    expectedSourceRef: z
+      .string()
+      .max(200)
+      .optional()
+      .describe(
+        "고정할 작업 트리 (`PUT /v1/storefront/site/source`의 `sourceRef`). 주면 지금 작업 트리가 이 값일 때만 버전을 만든다(다르면 409 `SOURCE_CHANGED`)",
+      ),
+  }),
+);
 export type CreateStorefrontVersionRequest = z.infer<typeof createStorefrontVersionRequestSchema>;
 
 /** 버전 만들기 응답 (201) — 버전은 `BUILDING`, 빌드는 `QUEUED`로 시작한다. 결과는 `GET builds/{buildId}`로 본다 */
@@ -1480,9 +1518,11 @@ export type StorefrontVersionCreated = z.infer<typeof storefrontVersionCreatedSc
  * 받는다(PAT·에이전트 불가). 5분 안에 열면 그 브라우저에 미리보기 호스트 전용 쿠키(12시간)가 생긴다. 편집 환경이
  * 없으면 409 `EDIT_SESSION_REQUIRED`다(편집 환경이 `STARTING`이면 링크는 주고, 미리보기 화면이 기동 대기를 보여 준다).
  */
-export const createStorefrontEditPreviewLinkRequestSchema = z.object({
-  path: z.string().max(512).optional().describe("열 경로 (`/`로 시작). 생략하면 `/`"),
-});
+export const createStorefrontEditPreviewLinkRequestSchema = strictRequest(
+  z.object({
+    path: z.string().max(512).optional().describe("열 경로 (`/`로 시작). 생략하면 `/`"),
+  }),
+);
 export type CreateStorefrontEditPreviewLinkRequest = z.infer<
   typeof createStorefrontEditPreviewLinkRequestSchema
 >;
@@ -1549,17 +1589,19 @@ export const storefrontSourceArchivePartSchema = z.object({
 export type StorefrontSourceArchivePart = z.infer<typeof storefrontSourceArchivePartSchema>;
 
 /** `POST /v1/storefront/site/source/blobs` — 파일 내용 올리기(해시 키, 다시 올려도 안전하다). 작업 트리는 바뀌지 않는다 */
-export const uploadStorefrontSourceBlobsRequestSchema = z.object({
-  blobs: z
-    .array(
-      z.object({
-        hash: storefrontFileHashSchema,
-        content: z.string().describe("파일 내용 (base64, 1MiB까지)"),
-      }),
-    )
-    .min(1)
-    .max(STOREFRONT_SOURCE_BLOB_BATCH_MAX),
-});
+export const uploadStorefrontSourceBlobsRequestSchema = strictRequest(
+  z.object({
+    blobs: z
+      .array(
+        z.object({
+          hash: storefrontFileHashSchema,
+          content: z.string().describe("파일 내용 (base64, 1MiB까지)"),
+        }),
+      )
+      .min(1)
+      .max(STOREFRONT_SOURCE_BLOB_BATCH_MAX),
+  }),
+);
 export type UploadStorefrontSourceBlobsRequest = z.infer<
   typeof uploadStorefrontSourceBlobsRequestSchema
 >;
@@ -1574,42 +1616,46 @@ export type StorefrontSourceBlobsResult = z.infer<typeof storefrontSourceBlobsRe
  * `PUT /v1/storefront/site/source` — 작업 트리 전체를 이 목록으로 바꾼다(없는 경로는 지운다). 전부 아니면 전무다.
  * `package.json`·`pnpm-lock.yaml`도 바꿀 수 있고 의존성은 허용 목록 안이어야 한다. `.env*`·작업 트리 밖 경로는 받지 않는다.
  */
-export const replaceStorefrontSourceRequestSchema = z.object({
-  expectedBaseRef: storefrontSourceRefSchema
-    .optional()
-    .describe(
-      "내려받은 작업 트리. 그 뒤 작업 트리가 바뀌었으면 이 트리를 기준으로 3-way 병합하고, 같은 곳을 고쳤으면 409 `SOURCE_CHANGED`다. 생략하면 조건 없이 덮어쓴다",
-    ),
-  files: z
-    .array(
-      z.object({
-        path: storefrontFilePathSchema,
-        hash: storefrontFileHashSchema,
-        size: z.number().int().min(0).max(STOREFRONT_FILE_MAX_BYTES),
+export const replaceStorefrontSourceRequestSchema = strictRequest(
+  z.object({
+    expectedBaseRef: storefrontSourceRefSchema
+      .optional()
+      .describe(
+        "내려받은 작업 트리. 그 뒤 작업 트리가 바뀌었으면 이 트리를 기준으로 3-way 병합하고, 같은 곳을 고쳤으면 409 `SOURCE_CHANGED`다. 생략하면 조건 없이 덮어쓴다",
+      ),
+    files: z
+      .array(
+        z.object({
+          path: storefrontFilePathSchema,
+          hash: storefrontFileHashSchema,
+          size: z.number().int().min(0).max(STOREFRONT_FILE_MAX_BYTES),
+        }),
+      )
+      .min(1)
+      .max(STOREFRONT_WORKSPACE_MAX_FILES)
+      .refine((files) => new Set(files.map((file) => file.path)).size === files.length, {
+        message: "같은 경로를 두 번 실을 수 없습니다",
       }),
-    )
-    .min(1)
-    .max(STOREFRONT_WORKSPACE_MAX_FILES)
-    .refine((files) => new Set(files.map((file) => file.path)).size === files.length, {
-      message: "같은 경로를 두 번 실을 수 없습니다",
-    }),
-  endEditSession: z
-    .boolean()
-    .optional()
-    .describe("열린 편집 환경을 끄고 진행한다 (기본 false — 열려 있으면 409 `EDIT_SESSION_OPEN`)"),
-  packageJson: z
-    .string()
-    .max(STOREFRONT_FILE_MAX_BYTES)
-    .optional()
-    .describe(
-      "`files`에 `package.json`이 있으면 그 내용(utf8). 서버가 의존성을 판정한다. 해시가 목록과 다르면 400 `DEPENDENCY_FILES_MISMATCH`",
-    ),
-  lockfile: z
-    .string()
-    .max(STOREFRONT_FILE_MAX_BYTES)
-    .optional()
-    .describe("`files`에 `pnpm-lock.yaml`이 있으면 그 내용(utf8)"),
-});
+    endEditSession: z
+      .boolean()
+      .optional()
+      .describe(
+        "열린 편집 환경을 끄고 진행한다 (기본 false — 열려 있으면 409 `EDIT_SESSION_OPEN`)",
+      ),
+    packageJson: z
+      .string()
+      .max(STOREFRONT_FILE_MAX_BYTES)
+      .optional()
+      .describe(
+        "`files`에 `package.json`이 있으면 그 내용(utf8). 서버가 의존성을 판정한다. 해시가 목록과 다르면 400 `DEPENDENCY_FILES_MISMATCH`",
+      ),
+    lockfile: z
+      .string()
+      .max(STOREFRONT_FILE_MAX_BYTES)
+      .optional()
+      .describe("`files`에 `pnpm-lock.yaml`이 있으면 그 내용(utf8)"),
+  }),
+);
 export type ReplaceStorefrontSourceRequest = z.infer<typeof replaceStorefrontSourceRequestSchema>;
 
 export const storefrontSourceReplacedSchema = z.object({
@@ -1708,21 +1754,23 @@ export const storefrontGitRepositorySchema = z.object({
 export type StorefrontGitRepository = z.infer<typeof storefrontGitRepositorySchema>;
 
 /** `POST /v1/storefront/site/git/installations` — GitHub App 설치 화면에서 돌아온 값(`installation_id`·`code`) */
-export const linkStorefrontGitInstallationRequestSchema = z.object({
-  installationId: z.number().int().positive(),
-  code: z
-    .string()
-    .min(1)
-    .max(200)
-    .describe("설치 화면이 돌려준 GitHub 사용자 인증 코드(한 번만 쓴다)"),
-  state: z
-    .string()
-    .min(1)
-    .max(200)
-    .describe(
-      "설치 화면으로 보내기 전에 받은 연결 state(`POST …/git/installations/state`, 한 번만 쓴다)",
-    ),
-});
+export const linkStorefrontGitInstallationRequestSchema = strictRequest(
+  z.object({
+    installationId: z.number().int().positive(),
+    code: z
+      .string()
+      .min(1)
+      .max(200)
+      .describe("설치 화면이 돌려준 GitHub 사용자 인증 코드(한 번만 쓴다)"),
+    state: z
+      .string()
+      .min(1)
+      .max(200)
+      .describe(
+        "설치 화면으로 보내기 전에 받은 연결 state(`POST …/git/installations/state`, 한 번만 쓴다)",
+      ),
+  }),
+);
 
 /** `POST /v1/storefront/site/git/installations/state` — GitHub 설치 화면에 싣는 1회용 state(이 상점·사용자, 10분) */
 export const storefrontGitConnectStateSchema = z.object({
@@ -1735,30 +1783,34 @@ export type LinkStorefrontGitInstallationRequest = z.infer<
 >;
 
 /** `POST /v1/storefront/site/git/connect` */
-export const connectStorefrontGitRequestSchema = z.object({
-  installationId: z.number().int().positive(),
-  repoId: z.number().int().positive(),
-  productionBranch: z
-    .string()
-    .min(1)
-    .max(200)
-    .regex(/^[A-Za-z0-9._-]+(\/[A-Za-z0-9._-]+)*$/)
-    .optional()
-    .describe("운영 배포 브랜치(생략하면 저장소 기본 브랜치)"),
-  rootDirectory: z
-    .string()
-    .max(200)
-    .regex(/^$|^[A-Za-z0-9._-]+(\/[A-Za-z0-9._-]+)*$/)
-    .refine((v) => !v.split("/").some((seg) => seg === "." || seg === ".."), "상대 경로만")
-    .optional()
-    .describe("저장소 안 사이트 루트(생략하면 저장소 루트)"),
-});
+export const connectStorefrontGitRequestSchema = strictRequest(
+  z.object({
+    installationId: z.number().int().positive(),
+    repoId: z.number().int().positive(),
+    productionBranch: z
+      .string()
+      .min(1)
+      .max(200)
+      .regex(/^[A-Za-z0-9._-]+(\/[A-Za-z0-9._-]+)*$/)
+      .optional()
+      .describe("운영 배포 브랜치(생략하면 저장소 기본 브랜치)"),
+    rootDirectory: z
+      .string()
+      .max(200)
+      .regex(/^$|^[A-Za-z0-9._-]+(\/[A-Za-z0-9._-]+)*$/)
+      .refine((v) => !v.split("/").some((seg) => seg === "." || seg === ".."), "상대 경로만")
+      .optional()
+      .describe("저장소 안 사이트 루트(생략하면 저장소 루트)"),
+  }),
+);
 export type ConnectStorefrontGitRequest = z.infer<typeof connectStorefrontGitRequestSchema>;
 
 /** `PUT /v1/storefront/site/deploy-approval` — 승인 없이 배포(#138) */
-export const setStorefrontDeployApprovalRequestSchema = z.object({
-  deployWithoutApproval: z.boolean(),
-});
+export const setStorefrontDeployApprovalRequestSchema = strictRequest(
+  z.object({
+    deployWithoutApproval: z.boolean(),
+  }),
+);
 export type SetStorefrontDeployApprovalRequest = z.infer<
   typeof setStorefrontDeployApprovalRequestSchema
 >;