@sayren/store-sdk 0.30.7 → 0.30.9

package/src/schemas/storefront-hosting.ts

@@ -130,6 +130,8 @@ export const storefrontSlugSchema = z
 
 /** 바꾼 슬러그를 다른 사이트가 가져가지 못하게 막는 기간(일). 보류 동안 옛 주소는 새 주소로 301한다 */
 export const STOREFRONT_SLUG_HOLD_DAYS = 90;
+/** 닫은 사이트(호스팅 끄기·상점 폐쇄)의 주소 보류·보관 기간(일, 2026-10-07). 지나면 주소가 풀리고 사이트가 지워진다 */
+export const STOREFRONT_CLOSED_SITE_HOLD_DAYS = 30;
 /** 슬러그 변경 한도 — 이 기간(일) 안에 */
 export const STOREFRONT_SLUG_CHANGE_WINDOW_DAYS = 30;
 /** 슬러그 변경 한도 — 횟수(상점 단위. 끄고 다시 만들어도 이어서 센다) */
@@ -163,10 +165,66 @@ export const storefrontTemplateSchema = z.object({
     .string()
     .nullable()
     .default(null)
-    .describe("공식 쇼케이스 사이트 주소. 연결된 쇼케이스가 공개 중일 때만 싣고 그 밖에는 null"),
+    .describe(
+      "미리보기 사이트 주소. 공식 템플릿은 연결된 쇼케이스, 템플릿 상점의 템플릿은 그 상점의 사이트가 공개 중일 때만 싣고 그 밖에는 null",
+    ),
+  source: z
+    .enum(["CATALOG", "STORE"])
+    .default("CATALOG")
+    .describe(
+      "`CATALOG` 공식 템플릿 · `STORE` 템플릿 상점의 템플릿(사이트를 만들 때 `copyContent`로 콘텐츠를 복사할 수 있다). 옛 서버 응답은 `CATALOG`로 읽는다",
+    ),
 });
 export type StorefrontTemplate = z.infer<typeof storefrontTemplateSchema>;
 
+// ─── 템플릿 상점 (#123) ────────────────────────────────────
+
+/**
+ * 템플릿 상점의 템플릿 정보 — 상점을 만들 때 템플릿 상점으로 고른 상점만 있다. 발행한 스토어프론트가 템플릿이 되고, 이 이름·소개·
+ * 썸네일로 모든 셀러의 템플릿 목록에 보인다
+ */
+export const storeTemplateSchema = z.object({
+  templateId: z.string().describe("템플릿 id. 다른 상점이 사이트를 만들 때 이 값을 쓴다"),
+  name: z.string().describe("템플릿 이름"),
+  description: z.string().describe("템플릿 소개"),
+  thumbnailUrl: z.string().nullable().describe("썸네일 이미지 주소. 없으면 null"),
+  status: z
+    .enum(["DRAFT", "ACTIVE", "RETIRED"])
+    .describe(
+      "`DRAFT` 아직 편집한 스토어프론트를 발행하지 않아 목록에 보이지 않음 · `ACTIVE` 목록에 보임 · `RETIRED` 상점을 닫아 내려감",
+    ),
+  version: z
+    .string()
+    .nullable()
+    .describe("목록에 보이는 템플릿 버전. 발행한 스토어프론트 버전에서 정해진다. `DRAFT`면 null"),
+});
+export type StoreTemplate = z.infer<typeof storeTemplateSchema>;
+
+/**
+ * 템플릿 상점의 고정 사업자 정보 필드 — 상점 수정에서 다른 값을 보내면 409 `TEMPLATE_STORE_BUSINESS_LOCKED`다(값은 플랫폼이 정한다)
+ */
+export const TEMPLATE_STORE_LOCKED_BUSINESS_FIELDS = [
+  "businessName",
+  "representativeName",
+  "businessNumber",
+  "mailOrderSalesNumber",
+  "customerCenterPhone",
+  "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 type UpdateStoreTemplateRequest = z.infer<typeof updateStoreTemplateRequestSchema>;
+
 // ─── 버전 ─────────────────────────────────────────────────
 
 /**
@@ -281,6 +339,14 @@ export const storefrontSuspensionSchema = z.object({
 });
 export type StorefrontSuspension = z.infer<typeof storefrontSuspensionSchema>;
 
+/** 사이트 첫 화면 스냅샷 — 발행·되돌리기로 발행 버전이 바뀌면 반영된 뒤 다시 찍는다(데스크톱 1280×800) */
+export const storefrontSiteSnapshotSchema = z.object({
+  url: z.string().describe("스냅샷 이미지 주소 (jpeg)"),
+  versionId: z.string().nullable().describe("스냅샷이 보여 주는 발행 버전"),
+  capturedAt: z.string().nullable().describe("찍은 시각 (ISO 8601)"),
+});
+export type StorefrontSiteSnapshot = z.infer<typeof storefrontSiteSnapshotSchema>;
+
 export const storefrontSiteSchema = z.object({
   siteId: z.string(),
   slug: z.string().describe("주소 슬러그"),
@@ -303,6 +369,10 @@ export const storefrontSiteSchema = z.object({
     .nullable()
     .optional()
     .describe("정지 정보. `status`가 `SUSPENDED`일 때만 있고 그 밖은 null"),
+  snapshot: storefrontSiteSnapshotSchema
+    .nullable()
+    .optional()
+    .describe("사이트 첫 화면 스냅샷. 발행한 버전이 반영되면 찍고, 아직 찍지 않았으면 null"),
   createdAt: z.string(),
   updatedAt: z.string(),
 });
@@ -351,7 +421,7 @@ export const storefrontDeploymentLogSchema = z.object({
   code: z
     .string()
     .describe(
-      "기록 종류 (`SITE_CREATED`·`ADDRESS_RESERVED`·`WAITING`·`SYNCING`·`VERSION_UPLOADED`·`SYNC_FAILED`·`RETRY_SCHEDULED`·`PUBLISHED`)",
+      "기록 종류 (`SITE_CREATED`·`ADDRESS_RESERVED`·`WAITING`·`SYNCING`·`VERSION_UPLOADED`·`SYNC_FAILED`·`RETRY_SCHEDULED`·`PUBLISHED`, 템플릿 상점의 템플릿은 `BUILDING`·`BUILD_FAILED`·`CONTENT_COPYING`·`CONTENT_COPIED`·`CONTENT_COPY_FAILED`)",
     ),
   message: z.string().describe("사람이 읽는 문장"),
 });
@@ -380,6 +450,12 @@ 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 type CreateStorefrontSiteRequest = z.infer<typeof createStorefrontSiteRequestSchema>;