@sayren/store-sdk 0.33.0 → 0.35.0

package/src/schemas/product.ts

@@ -14,6 +14,13 @@ import {
   productFulfillmentUpdateSchema,
 } from "./fulfillment";
 import { pointEarnRateBpSchema } from "./points";
+import {
+  MAX_PRODUCT_INFO_SECTIONS,
+  productCertificationsRequestSchema,
+  productCertificationsSchema,
+  productNoticeRequestSchema,
+  productNoticeSchema,
+} from "./product-info";
 import { productRefundPolicyPatchSchema } from "./refund-policy";
 import { inventoryModeSchema } from "./stay";
 import { UPLOAD_PURPOSE_LIMITS, uploadExtensionOf } from "./upload";
@@ -445,6 +452,19 @@ export const productSchema = productSummarySchema.extend({
     .describe(
       "설정된 즉시할인. GET /v1/products/{productId}/discount 응답과 같은 형태다. 할인이 없으면 null",
     ),
+  notice: productNoticeSchema
+    .nullable()
+    .optional()
+    .describe("상품정보제공 고시(이슈 #135). 없으면 null. 서버는 항상 싣는다"),
+  certifications: productCertificationsSchema
+    .nullable()
+    .optional()
+    .describe("인증 정보(이슈 #135). 없으면 null. 서버는 항상 싣는다"),
+  infoSectionIds: z
+    .array(z.string())
+    .optional()
+    .default([])
+    .describe("연결한 안내 섹션 id(이슈 #135). 배열 순서가 표시 순서다. 서버는 항상 싣는다"),
   createdAt: z.string().optional(),
 });
 
@@ -569,14 +589,14 @@ export const optionModelRequestSchema = z.object({
     .max(MAX_ADDON_GROUPS)
     .optional()
     .describe(
-      "추가 선택 옵션명 전체(이슈 #59). 주면 통째로 바꾸고, 생략하면 등록은 없음·수정은 현재 값을 그대로 둔다. 끄려면 빈 배열을 보낸다. 기능이 열리기 전에는 비어 있지 않은 값이 409 `OPTION_ADDONS_UNAVAILABLE`이다",
+      "추가 선택 옵션명 전체(이슈 #59). 주면 통째로 바꾸고, 생략하면 등록은 없음·수정은 현재 값을 그대로 둔다. 끄려면 빈 배열을 보낸다",
     ),
   customInputs: z
     .array(customInputRequestSchema)
     .max(MAX_CUSTOM_INPUTS)
     .optional()
     .describe(
-      "직접 입력 항목 전체(이슈 #59). 배열 순서가 표시 순서다. 주면 통째로 바꾸고, 생략하면 등록은 없음·수정은 현재 값을 그대로 둔다. 항목명에 개인정보성 단어(`CUSTOM_INPUT_FORBIDDEN_WORDS`)가 있으면 400 `CUSTOM_INPUT_LABEL_FORBIDDEN`, 기능이 열리기 전에는 비어 있지 않은 값이 409 `OPTION_ADDONS_UNAVAILABLE`이다",
+      "직접 입력 항목 전체(이슈 #59). 배열 순서가 표시 순서다. 주면 통째로 바꾸고, 생략하면 등록은 없음·수정은 현재 값을 그대로 둔다. 항목명에 개인정보성 단어(`CUSTOM_INPUT_FORBIDDEN_WORDS`)가 있으면 400 `CUSTOM_INPUT_LABEL_FORBIDDEN`이다",
     ),
   optionSort: optionSortSchema
     .optional()
@@ -694,6 +714,25 @@ const productWriteShape = {
       "상품별 환불 정책 — 준 항목만 상점 기본을 덮어쓴다. `null`이나 생략은 상점 기본을 그대로 쓴다는 뜻이다. " +
         "반품·교환 배송비(`returnDeliveryFee`·`exchangeDeliveryFee`)는 배송 상품에만 줄 수 있다(다른 유형은 400)",
     ),
+  notice: productNoticeRequestSchema
+    .nullable()
+    .optional()
+    .describe(
+      "상품정보제공 고시(이슈 #135). `null`은 지운다. 등록에서 생략하면 없음, 전체 수정(PUT)에서 생략하면 지금 값을 유지한다",
+    ),
+  certifications: productCertificationsRequestSchema
+    .nullable()
+    .optional()
+    .describe(
+      "인증 정보(이슈 #135). `null`은 지운다. 등록에서 생략하면 없음, 전체 수정(PUT)에서 생략하면 지금 값을 유지한다",
+    ),
+  infoSectionIds: z
+    .array(z.string().min(1))
+    .max(MAX_PRODUCT_INFO_SECTIONS)
+    .optional()
+    .describe(
+      "연결할 안내 섹션 id(이슈 #135). 배열 순서가 표시 순서다. 이 상점의 섹션이 아니면 400 `INFO_SECTION_NOT_FOUND`. 전체 수정(PUT)에서 생략하면 지금 연결을 유지한다",
+    ),
   ...optionModelRequestSchema.shape,
   sourceOptionSetIds: z
     .array(z.string())

package/src/schemas/store.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { storeRoleSchema } from "./auth";
+import { localeCodeSchema } from "./locale";
 import { refundPolicyPatchSchema, refundPolicySchema } from "./refund-policy";
 import { shippingPolicyPatchSchema, shippingPolicySchema } from "./shipping-policy";
 
@@ -307,6 +308,11 @@ export const updateStoreRequestSchema = z
     privacyUrl: policyDocumentUrlSchema
       .optional()
       .describe("개인정보 수집이용 동의 문서 주소(https). `null`을 주면 지운다"),
+    defaultLocale: localeCodeSchema
+      .optional()
+      .describe(
+        "상점 기본 언어(이슈 #134). 상품·카테고리 필드가 이 언어 값이고 번역이 없는 칸은 이 값으로 보인다. 바꿔도 저장된 값은 그대로다",
+      ),
   })
   .refine((value) => Object.values(value).some((v) => v !== undefined), {
     message: "최소 1개 필드가 필요합니다",
@@ -358,6 +364,11 @@ export const storeSchema = z.object({
     .describe("이용약관 문서 주소. 정하지 않았으면 null이고 동의 이력에도 주소가 남지 않는다"),
   privacyUrl: z.string().nullable().describe("개인정보 수집이용 동의 문서 주소"),
   memberCount: z.number().int(),
+  defaultLocale: z
+    .string()
+    .optional()
+    .default("ko")
+    .describe("상점 기본 언어(이슈 #134, BCP 47). 서버는 항상 싣는다"),
   createdAt: z.string(),
 });
 

package/src/schemas/storefront-hosting.ts

@@ -13,7 +13,6 @@ import { RESERVED_STORE_CODES } from "./store";
  * 공개 전환·슬러그 변경·호스팅 끄기는 승인(`APPROVAL_REQUIRED`)이다 — 구매자가 보는 화면을 바꾸는 쓰기다.
  *
  * 오류 코드:
- * - 403 `STOREFRONT_HOSTING_DISABLED` — 플랫폼 스위치가 꺼져 새 사이트를 만들 수 없다
  * - 404 `STOREFRONT_SITE_NOT_FOUND` · `STOREFRONT_TEMPLATE_NOT_FOUND` · `STOREFRONT_VERSION_NOT_FOUND`
  * - 409 `STOREFRONT_SITE_EXISTS` — 이미 사이트가 있다(상점당 1개)
  * - 409 `STOREFRONT_SLUG_TAKEN` — 다른 사이트가 쓰거나 보류 중인 슬러그다
@@ -30,7 +29,7 @@ import { RESERVED_STORE_CODES } from "./store";
  * - 503 `STOREFRONT_PREVIEW_NOT_CONFIGURED` — 미리보기 서명 키가 설정되지 않았다
  *
  * 편집(M2b, `/v1/storefront/site/editing`·`files/**`·`checks/**`·`verify`·`builds/**`, 버전 만들기):
- * - 403 `STOREFRONT_EDITING_DISABLED` — 플랫폼 편집 스위치가 꺼져 있다
+ * - 403 `STOREFRONT_EDITING_DISABLED` — 편집을 쓸 수 없어 셀러 템플릿으로 사이트를 만들 수 없다(사이트 만들기)
  * - 503 `STOREFRONT_EDITING_NOT_CONFIGURED` — 편집 Sandbox가 설정되지 않았다
  * - 409 `EDIT_CAPACITY_FULL` — 플랫폼 전체 동시 편집 상한에 걸렸다. `error.details.retryAfterSeconds` 뒤에 다시 한다
  * - 409 `EDIT_SESSION_REQUIRED` — 편집 미리보기 링크: 편집 환경이 없다
@@ -392,13 +391,11 @@ export const storefrontSiteSchema = z.object({
 });
 export type StorefrontSite = z.infer<typeof storefrontSiteSchema>;
 
-/** `GET /v1/storefront/site` — 스위치 상태와 현재 사이트(없으면 null. 끈 사이트는 싣지 않는다) */
+/** `GET /v1/storefront/site` — 호스팅 설정과 현재 사이트(없으면 null. 끈 사이트는 싣지 않는다) */
 export const storefrontHostingSchema = z.object({
-  enabled: z.boolean().describe("새 사이트를 만들 수 있는가 (플랫폼 스위치)"),
+  enabled: z.boolean().describe("새 사이트를 만들 수 있는가 (항상 true)"),
   domain: z.string().describe("호스팅 도메인 (예: `sayren.co`). 사이트 주소는 `{slug}.{domain}`"),
-  editingEnabled: z
-    .boolean()
-    .describe("파일 편집·버전 만들기를 쓸 수 있는가 (플랫폼 편집 스위치와 Sandbox 설정)"),
+  editingEnabled: z.boolean().describe("파일 편집·버전 만들기를 쓸 수 있는가 (Sandbox 설정)"),
   site: storefrontSiteSchema.nullable(),
 });
 export type StorefrontHosting = z.infer<typeof storefrontHostingSchema>;
@@ -574,7 +571,6 @@ export type StorefrontPreviewLink = z.infer<typeof storefrontPreviewLinkSchema>;
 // - 결제 복귀·방문 분석·소셜 로그인 허용 목록은 연결된(`ACTIVE`) 도메인을 자동으로 더한다.
 //
 // 오류 코드:
-// - 403 `STOREFRONT_CUSTOM_DOMAINS_DISABLED` — 플랫폼 스위치가 꺼져 도메인을 추가할 수 없다
 // - 400 `STOREFRONT_DOMAIN_INVALID` — 형식이 틀렸거나 연결할 수 없는 도메인이다(`error.details.reason`)
 // - 404 `STOREFRONT_DOMAIN_NOT_FOUND`
 // - 409 `STOREFRONT_DOMAIN_EXISTS` — 이 상점에 이미 추가한 도메인이다
@@ -798,7 +794,7 @@ export type StorefrontSiteDomain = z.infer<typeof storefrontSiteDomainSchema>;
 
 /** `GET /v1/storefront/site/domains` — 사이트의 주소 목록(기본 주소 + 내 도메인)과 연결 설정 */
 export const storefrontSiteDomainsSchema = z.object({
-  enabled: z.boolean().describe("내 도메인을 추가할 수 있는가 (플랫폼 스위치)"),
+  enabled: z.boolean().describe("내 도메인을 추가할 수 있는가 (항상 true)"),
   limit: z.number().int().min(0).describe("상점당 내 도메인 수 상한 (해제한 도메인은 세지 않는다)"),
   target: z.string().describe("CNAME 대상 (예: `sites.sayren.co`)"),
   domains: z.array(storefrontSiteDomainSchema).describe("대표 주소 먼저, 그다음 추가한 순서"),
@@ -971,7 +967,7 @@ export const storefrontDevLogsSchema = z.object({
 export type StorefrontDevLogs = z.infer<typeof storefrontDevLogsSchema>;
 
 export const storefrontEditingSchema = z.object({
-  enabled: z.boolean().describe("편집을 쓸 수 있는가 (플랫폼 스위치와 Sandbox 설정)"),
+  enabled: z.boolean().describe("편집을 쓸 수 있는가 (Sandbox 설정)"),
   session: storefrontEditSessionSchema
     .nullable()
     .describe("열린 편집 환경. 잠들었거나 닫았으면 null"),