@sayren/store-sdk 0.34.0 → 0.36.0

package/dist/index.d.mts

@@ -5610,6 +5610,27 @@ export declare const categoryDeleteQuerySchema: z.ZodObject<{
     cascade: "cascade";
   }>>;
 }, z.core.$strip>;
+/**
+ * 카테고리 번역 (이슈 #134) — 언어 하나의 이름·SEO. 카테고리 필드(`name`·`meta*`)는 상점 기본 언어 값이고 번역 레코드가 언어별 값이다.
+ * 비운 칸(null)은 스토어프론트가 기본 언어 값으로 대체한다(칸 단위 대체).
+ */
+export declare const categoryLocalizationSchema: z.ZodObject<{
+  locale: z.ZodString;
+  name: z.ZodNullable<z.ZodString>;
+  metaTitle: z.ZodNullable<z.ZodString>;
+  metaDescription: z.ZodNullable<z.ZodString>;
+  metaKeywords: z.ZodNullable<z.ZodString>;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type CategoryLocalization = z.infer<typeof categoryLocalizationSchema>;
+/** `PUT /v1/categories/{categoryId}/localizations/{locale}` 본문 — 레코드 전체를 바꾼다. 빠진 칸은 null(기본 언어 값으로 대체)이다 */
+export declare const categoryLocalizationRequestSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  metaTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  metaDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  metaKeywords: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type CategoryLocalizationRequest = z.infer<typeof categoryLocalizationRequestSchema>;
 //#endregion
 //#region src/schemas/common.d.ts
 export declare const pageInfoSchema: z.ZodObject<{
@@ -6428,6 +6449,27 @@ export declare const collectionPreviewSchema: z.ZodObject<{
   salesComputedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type CollectionPreview = z.infer<typeof collectionPreviewSchema>;
+/**
+ * 컬렉션 번역 (이슈 #134) — 언어 하나의 제목·설명·SEO. 컬렉션 필드는 상점 기본 언어 값이고 번역 레코드가 언어별 값이다.
+ * 비운 칸(null)은 스토어프론트가 기본 언어 값으로 대체한다(칸 단위 대체).
+ */
+export declare const collectionLocalizationSchema: z.ZodObject<{
+  locale: z.ZodString;
+  title: z.ZodNullable<z.ZodString>;
+  description: z.ZodNullable<z.ZodString>;
+  metaTitle: z.ZodNullable<z.ZodString>;
+  metaDescription: z.ZodNullable<z.ZodString>;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type CollectionLocalization = z.infer<typeof collectionLocalizationSchema>;
+/** `PUT /v1/collections/{collectionId}/localizations/{locale}` 본문 — 레코드 전체를 바꾼다. 빠진 칸은 null(기본 언어 값으로 대체)이다 */
+export declare const collectionLocalizationRequestSchema: z.ZodObject<{
+  title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  metaTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  metaDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type CollectionLocalizationRequest = z.infer<typeof collectionLocalizationRequestSchema>;
 //#endregion
 //#region src/schemas/commerce-flow.d.ts
 /**
@@ -8123,6 +8165,7 @@ export declare const marketSchema: z.ZodObject<{
   couponsEnabled: z.ZodBoolean;
   pointsEnabled: z.ZodBoolean;
   archivedAt: z.ZodNullable<z.ZodString>;
+  locales: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 export type Market = z.infer<typeof marketSchema>;
 export declare const createMarketRequestSchema: z.ZodObject<{
@@ -8149,6 +8192,7 @@ export declare const createMarketRequestSchema: z.ZodObject<{
   domains: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
   couponsEnabled: z.ZodOptional<z.ZodBoolean>;
   pointsEnabled: z.ZodOptional<z.ZodBoolean>;
+  locales: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
 }, z.core.$strict>;
 export type CreateMarketRequest = z.infer<typeof createMarketRequestSchema>;
 export type CreateMarketRequestInput = z.input<typeof createMarketRequestSchema>;
@@ -8158,6 +8202,7 @@ export declare const updateMarketRequestSchema: z.ZodObject<{
   domains: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
   couponsEnabled: z.ZodOptional<z.ZodBoolean>;
   pointsEnabled: z.ZodOptional<z.ZodBoolean>;
+  locales: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
 }, z.core.$strict>;
 export type UpdateMarketRequest = z.infer<typeof updateMarketRequestSchema>;
 export type UpdateMarketRequestInput = z.input<typeof updateMarketRequestSchema>;
@@ -9050,6 +9095,7 @@ export declare const orderSchema: z.ZodObject<{
   }, z.core.$strip>;
   currency: z.ZodOptional<z.ZodString>;
   testPayment: z.ZodBoolean;
+  locale: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   items: z.ZodArray<z.ZodObject<{
     orderItemId: z.ZodString;
     orderItemNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
@@ -9320,7 +9366,7 @@ export declare const orderItemPageSchema: z.ZodObject<{
 export type OrderItemPage = z.infer<typeof orderItemPageSchema>;
 /**
  * `GET /v1/orders` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열). 검증 규칙은 서버가 적용한다:
- * `orderNo` 없이 `orderedFrom` 누락 400 `MISSING_PARAMETER`, 날짜·`orderNo` 형식 오류 400 `INVALID_PARAMETER`, 31일 초과 400 `RANGE_TOO_WIDE`,
+ * `orderNo` 없이 `orderedFrom` 누락 400 `MISSING_PARAMETER`, 날짜·`orderNo` 형식 오류 400 `INVALID_PARAMETER`, 366일 초과 400 `RANGE_TOO_WIDE`,
  * `testPayment`가 `true`·`false`가 아니면 400 `INVALID_PARAMETER`
  */
 export declare const orderListQuerySchema: z.ZodObject<{
@@ -11367,6 +11413,10 @@ export declare const productSummarySchema: z.ZodObject<{
   }, z.core.$strip>;
   updatedAt: z.ZodString;
   sample: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+  localizations: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    locale: z.ZodString;
+    needsTranslation: z.ZodBoolean;
+  }, z.core.$strip>>>>;
 }, z.core.$strip>;
 export type ProductSummary = z.infer<typeof productSummarySchema>;
 /** 옵션 축(그룹)이 가지는 값 하나 — 예: 축 "색상"의 값 "블랙" */
@@ -11612,20 +11662,20 @@ export declare const discountSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type Discount = z.infer<typeof discountSchema>;
 export declare const productSchema: z.ZodObject<{
-  productId: z.ZodString;
-  productNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
-  name: z.ZodString;
+  salePrice: z.ZodNumber;
   status: z.ZodEnum<{
     SALE: "SALE";
     SUSPENDED: "SUSPENDED";
     OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
   }>;
-  salePrice: z.ZodNumber;
-  discountedPrice: z.ZodNullable<z.ZodNumber>;
+  name: z.ZodString;
   stockQuantity: z.ZodNumber;
   categoryId: z.ZodNullable<z.ZodString>;
+  productId: z.ZodString;
   thumbnailUrl: z.ZodOptional<z.ZodURL>;
+  productNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+  discountedPrice: z.ZodNullable<z.ZodNumber>;
   hasOptions: z.ZodBoolean;
   updatedAt: z.ZodString;
   sample: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -12672,9 +12722,9 @@ export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
 export declare const productSortSchema: z.ZodEnum<{
   "createdAt.desc": "createdAt.desc";
   "createdAt.asc": "createdAt.asc";
-  "updatedAt.desc": "updatedAt.desc";
   "salePrice.asc": "salePrice.asc";
   "salePrice.desc": "salePrice.desc";
+  "updatedAt.desc": "updatedAt.desc";
 }>;
 export type ProductSort = z.infer<typeof productSortSchema>;
 export interface ProductListParams extends PageParams {
@@ -12703,9 +12753,9 @@ export declare const productListQuerySchema: z.ZodObject<{
   sort: z.ZodOptional<z.ZodEnum<{
     "createdAt.desc": "createdAt.desc";
     "createdAt.asc": "createdAt.asc";
-    "updatedAt.desc": "updatedAt.desc";
     "salePrice.asc": "salePrice.asc";
     "salePrice.desc": "salePrice.desc";
+    "updatedAt.desc": "updatedAt.desc";
   }>>;
 }, z.core.$strip>;
 export declare const discountRequestSchema: z.ZodObject<{
@@ -12859,6 +12909,113 @@ export declare const infoSectionRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type InfoSectionRequest = z.infer<typeof infoSectionRequestSchema>;
 export type InfoSectionRequestInput = z.input<typeof infoSectionRequestSchema>;
+/**
+ * 안내 섹션 번역 (이슈 #134) — 언어 하나의 제목·본문. 섹션 필드는 상점 기본 언어 값이다. 비운 칸(null)은 스토어프론트가 기본 언어 값으로 대체한다.
+ * 섹션을 연결한 모든 상품이 같은 번역을 보인다.
+ */
+export declare const infoSectionLocalizationSchema: z.ZodObject<{
+  locale: z.ZodString;
+  title: z.ZodNullable<z.ZodString>;
+  body: z.ZodNullable<z.ZodString>;
+  bodyJson: z.ZodNullable<z.ZodString>;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type InfoSectionLocalization = z.infer<typeof infoSectionLocalizationSchema>;
+/** `PUT /v1/info-sections/{infoSectionId}/localizations/{locale}` 본문 — 레코드 전체를 바꾼다. 빠진 칸은 null이다 */
+export declare const infoSectionLocalizationRequestSchema: z.ZodObject<{
+  title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  body: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  bodyJson: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strict>;
+export type InfoSectionLocalizationRequest = z.infer<typeof infoSectionLocalizationRequestSchema>;
+//#endregion
+//#region src/schemas/product-localization.d.ts
+/**
+ * 조회 응답 — 지금 상품의 옵션명·값·직접 입력 항목, 셀러가 적은 고시 칸을 모두 싣고 번역하지 않은 칸은 null이다.
+ * `optionGroups`는 조합 옵션, `addonGroups`는 추가 선택이다(상품 응답과 같은 구분)
+ */
+export declare const productLocalizationSchema: z.ZodObject<{
+  locale: z.ZodString;
+  name: z.ZodNullable<z.ZodString>;
+  description: z.ZodNullable<z.ZodString>;
+  descriptionJson: z.ZodNullable<z.ZodString>;
+  images: z.ZodNullable<z.ZodArray<z.ZodString>>;
+  optionGroups: z.ZodArray<z.ZodObject<{
+    groupId: z.ZodString;
+    name: z.ZodNullable<z.ZodString>;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodString;
+      name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  addonGroups: z.ZodArray<z.ZodObject<{
+    groupId: z.ZodString;
+    name: z.ZodNullable<z.ZodString>;
+    values: z.ZodArray<z.ZodObject<{
+      valueId: z.ZodString;
+      name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  customInputs: z.ZodArray<z.ZodObject<{
+    inputId: z.ZodString;
+    label: z.ZodNullable<z.ZodString>;
+    placeholder: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  notice: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    value: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>>>;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type ProductLocalization = z.infer<typeof productLocalizationSchema>;
+/**
+ * `PUT /v1/products/{productId}/localizations/{locale}` 본문 — 레코드 전체를 바꾼다. 빠진 칸은 null(기본 언어 값으로 대체)이다.
+ * 옵션은 번역할 id만 보낸다. 상품에 없는 id는 400 `PRODUCT_LOCALIZATION_TARGET_NOT_FOUND`다.
+ * 번역한 옵션명·값 이름도 기본 언어와 같은 규칙(대소문자·앞뒤 공백 무시 유일)이고 겹치면 400 `INVALID_OPTION_MODEL`이다
+ */
+export declare const productLocalizationRequestSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  descriptionJson: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  images: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodURL>>>;
+  optionGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    groupId: z.ZodString;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    values: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      valueId: z.ZodString;
+      name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>>>;
+  addonGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    groupId: z.ZodString;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    values: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      valueId: z.ZodString;
+      name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>>>;
+  customInputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    inputId: z.ZodString;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strict>>>;
+  notice: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type ProductLocalizationRequest = z.infer<typeof productLocalizationRequestSchema>;
+/**
+ * 번역할 칸이 비었는가(이슈 #134, 2026-10-18 결정: 완성도 대신 「번역 필요」 표시만) — 상품명, 기본 언어에 본문이 있는 상세설명,
+ * 옵션명·값·직접 입력 항목명, 셀러가 적은 고시 칸. 이미지·입력 안내는 기본 언어 값을 그대로 써도 되는 칸이라 세지 않는다.
+ * 상점 플랫폼(상품 수정·목록)과 관리 목록 응답이 같은 함수다
+ */
+export declare function productLocalizationNeedsTranslation(localization: Pick<ProductLocalization, "name" | "description" | "optionGroups" | "addonGroups" | "customInputs"> & {
+  notice?: ProductLocalization["notice"];
+}, base: {
+  description?: string | null;
+}): boolean;
 //#endregion
 //#region src/schemas/saved-option-set.d.ts
 /**
@@ -13092,6 +13249,49 @@ export declare const savedOptionSetListQuerySchema: z.ZodObject<{
     "importedProductCount.desc": "importedProductCount.desc";
   }>>;
 }, z.core.$strip>;
+/**
+ * 저장 옵션 번역 (이슈 #134) — 저장 옵션에는 id가 없어 **기본 언어 이름이 키**다(`baseName`·`baseLabel`).
+ * 상품이 불러올 때 상품 번역으로 함께 복사하고(상품 저장 트랜잭션), 그 뒤로는 상품 번역이 원천이다 — 저장 옵션 번역을 고쳐도
+ * 이미 불러온 상품은 그대로다. 기본 언어 이름을 바꾸면 그 이름의 번역은 읽지 않는다.
+ */
+export declare const savedOptionSetLocalizationSchema: z.ZodObject<{
+  locale: z.ZodString;
+  groups: z.ZodArray<z.ZodObject<{
+    baseName: z.ZodString;
+    name: z.ZodNullable<z.ZodString>;
+    values: z.ZodArray<z.ZodObject<{
+      baseName: z.ZodString;
+      name: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  customInputs: z.ZodArray<z.ZodObject<{
+    baseLabel: z.ZodString;
+    label: z.ZodNullable<z.ZodString>;
+    placeholder: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type SavedOptionSetLocalization = z.infer<typeof savedOptionSetLocalizationSchema>;
+/**
+ * `PUT /v1/saved-option-sets/{optionSetId}/localizations/{locale}` 본문 — 레코드 전체를 바꾼다. 번역할 이름만 보낸다.
+ * 저장 옵션에 없는 기본 언어 이름은 400 `OPTION_SET_LOCALIZATION_TARGET_NOT_FOUND`, 번역 이름 중복은 상품과 같은 규칙으로 400 `INVALID_OPTION_MODEL`이다
+ */
+export declare const savedOptionSetLocalizationRequestSchema: z.ZodObject<{
+  groups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    baseName: z.ZodString;
+    name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    values: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      baseName: z.ZodString;
+      name: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>>>;
+  customInputs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    baseLabel: z.ZodString;
+    label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type SavedOptionSetLocalizationRequest = z.infer<typeof savedOptionSetLocalizationRequestSchema>;
 //#endregion
 //#region src/schemas/stay.d.ts
 /**
@@ -13292,6 +13492,7 @@ export declare const updateStoreRequestSchema: z.ZodObject<{
   privacyVersion: z.ZodOptional<z.ZodString>;
   termsUrl: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
   privacyUrl: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
+  defaultLocale: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
   businessName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   representativeName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   businessNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -13376,6 +13577,7 @@ export declare const storeSchema: z.ZodObject<{
   termsUrl: z.ZodNullable<z.ZodString>;
   privacyUrl: z.ZodNullable<z.ZodString>;
   memberCount: z.ZodNumber;
+  defaultLocale: z.ZodDefault<z.ZodOptional<z.ZodString>>;
   createdAt: z.ZodString;
   businessName: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   representativeName: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
@@ -15251,18 +15453,22 @@ export declare function createStoreClient(options: StoreClientOptions): {
         };
         updatedAt: string;
         sample: boolean;
+        localizations: {
+          locale: string;
+          needsTranslation: boolean;
+        }[];
         thumbnailUrl?: string | undefined;
       }[];
     }>;
     get: (productId: string) => Promise<{
-      productId: string;
-      productNo: number | null;
-      name: string;
-      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
       salePrice: number;
-      discountedPrice: number | null;
+      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+      name: string;
       stockQuantity: number;
       categoryId: string | null;
+      productId: string;
+      productNo: number | null;
+      discountedPrice: number | null;
       hasOptions: boolean;
       updatedAt: string;
       sample: boolean;
@@ -15404,14 +15610,14 @@ export declare function createStoreClient(options: StoreClientOptions): {
       createdAt?: string | undefined;
     }>;
     create: (body: ProductCreateRequestInput, idempotencyKey?: string) => Promise<{
-      productId: string;
-      productNo: number | null;
-      name: string;
-      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
       salePrice: number;
-      discountedPrice: number | null;
+      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+      name: string;
       stockQuantity: number;
       categoryId: string | null;
+      productId: string;
+      productNo: number | null;
+      discountedPrice: number | null;
       hasOptions: boolean;
       updatedAt: string;
       sample: boolean;
@@ -15553,14 +15759,14 @@ export declare function createStoreClient(options: StoreClientOptions): {
       createdAt?: string | undefined;
     }>;
     update: (productId: string, body: ProductReplaceRequestInput) => Promise<{
-      productId: string;
-      productNo: number | null;
-      name: string;
-      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
       salePrice: number;
-      discountedPrice: number | null;
+      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+      name: string;
       stockQuantity: number;
       categoryId: string | null;
+      productId: string;
+      productNo: number | null;
+      discountedPrice: number | null;
       hasOptions: boolean;
       updatedAt: string;
       sample: boolean;
@@ -15703,6 +15909,78 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     patch: (productId: string, body: ProductPatchRequest) => Promise<void>;
     remove: (productId: string) => Promise<void>;
+    /** 번역(이슈 #134) — 언어별 상품명·상세설명·이미지·옵션 이름 */
+    localizations: {
+      list: (productId: string) => Promise<{
+        locale: string;
+        name: string | null;
+        description: string | null;
+        descriptionJson: string | null;
+        images: string[] | null;
+        optionGroups: {
+          groupId: string;
+          name: string | null;
+          values: {
+            valueId: string;
+            name: string | null;
+          }[];
+        }[];
+        addonGroups: {
+          groupId: string;
+          name: string | null;
+          values: {
+            valueId: string;
+            name: string | null;
+          }[];
+        }[];
+        customInputs: {
+          inputId: string;
+          label: string | null;
+          placeholder: string | null;
+        }[];
+        notice: {
+          key: string;
+          label: string;
+          value: string | null;
+        }[];
+        updatedAt: string;
+      }[]>;
+      put: (productId: string, locale: string, body: ProductLocalizationRequest) => Promise<{
+        locale: string;
+        name: string | null;
+        description: string | null;
+        descriptionJson: string | null;
+        images: string[] | null;
+        optionGroups: {
+          groupId: string;
+          name: string | null;
+          values: {
+            valueId: string;
+            name: string | null;
+          }[];
+        }[];
+        addonGroups: {
+          groupId: string;
+          name: string | null;
+          values: {
+            valueId: string;
+            name: string | null;
+          }[];
+        }[];
+        customInputs: {
+          inputId: string;
+          label: string | null;
+          placeholder: string | null;
+        }[];
+        notice: {
+          key: string;
+          label: string;
+          value: string | null;
+        }[];
+        updatedAt: string;
+      }>;
+      remove: (productId: string, locale: string) => Promise<void>;
+    };
     bulkUpdateStatus: (productIds: string[], status: ProductStatus, idempotencyKey?: string) => Promise<{
       succeeded: string[];
       failed: {
@@ -16024,6 +16302,44 @@ export declare function createStoreClient(options: StoreClientOptions): {
       };
       additionalPriceDropped: boolean;
     }>;
+    /** 번역(이슈 #134) — 기본 언어 이름이 키다. 불러올 때 상품 번역으로 복사한다 */
+    localizations: {
+      list: (optionSetId: string) => Promise<{
+        locale: string;
+        groups: {
+          baseName: string;
+          name: string | null;
+          values: {
+            baseName: string;
+            name: string | null;
+          }[];
+        }[];
+        customInputs: {
+          baseLabel: string;
+          label: string | null;
+          placeholder: string | null;
+        }[];
+        updatedAt: string;
+      }[]>;
+      put: (optionSetId: string, locale: string, body: SavedOptionSetLocalizationRequest) => Promise<{
+        locale: string;
+        groups: {
+          baseName: string;
+          name: string | null;
+          values: {
+            baseName: string;
+            name: string | null;
+          }[];
+        }[];
+        customInputs: {
+          baseLabel: string;
+          label: string | null;
+          placeholder: string | null;
+        }[];
+        updatedAt: string;
+      }>;
+      remove: (optionSetId: string, locale: string) => Promise<void>;
+    };
   };
   /**
    * 상품정보제공 고시 품목군(이슈 #135) — 플랫폼 코드 표. 현재 버전만 싣는다. 권한은 상품 조회(`product:r`)다
@@ -16102,6 +16418,24 @@ export declare function createStoreClient(options: StoreClientOptions): {
       updatedAt: string;
     }>;
     remove: (infoSectionId: string) => Promise<void>;
+    /** 번역(이슈 #134) — 언어별 제목·본문 */
+    localizations: {
+      list: (infoSectionId: string) => Promise<{
+        locale: string;
+        title: string | null;
+        body: string | null;
+        bodyJson: string | null;
+        updatedAt: string;
+      }[]>;
+      put: (infoSectionId: string, locale: string, body: InfoSectionLocalizationRequest) => Promise<{
+        locale: string;
+        title: string | null;
+        body: string | null;
+        bodyJson: string | null;
+        updatedAt: string;
+      }>;
+      remove: (infoSectionId: string, locale: string) => Promise<void>;
+    };
   };
   /**
    * 컬렉션 (이슈 #83) — 상품을 어디에 보여 줄지 정하는 묶음(다대다). 권한은 카테고리와 같다(`category:r`·`category:rw`).
@@ -16411,6 +16745,26 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       salesComputedAt: string | null;
     }>;
+    /** 번역(이슈 #134) — 언어별 제목·설명·SEO */
+    localizations: {
+      list: (collectionId: string) => Promise<{
+        locale: string;
+        title: string | null;
+        description: string | null;
+        metaTitle: string | null;
+        metaDescription: string | null;
+        updatedAt: string;
+      }[]>;
+      put: (collectionId: string, locale: string, body: CollectionLocalizationRequest) => Promise<{
+        locale: string;
+        title: string | null;
+        description: string | null;
+        metaTitle: string | null;
+        metaDescription: string | null;
+        updatedAt: string;
+      }>;
+      remove: (collectionId: string, locale: string) => Promise<void>;
+    };
   };
   categories: {
     list: (params?: {
@@ -16571,6 +16925,26 @@ export declare function createStoreClient(options: StoreClientOptions): {
     remove: (categoryId: string, opts?: {
       strategy?: CategoryDeleteStrategy;
     }) => Promise<void>;
+    /** 번역(이슈 #134) — 언어별 이름·SEO */
+    localizations: {
+      list: (categoryId: string) => Promise<{
+        locale: string;
+        name: string | null;
+        metaTitle: string | null;
+        metaDescription: string | null;
+        metaKeywords: string | null;
+        updatedAt: string;
+      }[]>;
+      put: (categoryId: string, locale: string, body: CategoryLocalizationRequest) => Promise<{
+        locale: string;
+        name: string | null;
+        metaTitle: string | null;
+        metaDescription: string | null;
+        metaKeywords: string | null;
+        updatedAt: string;
+      }>;
+      remove: (categoryId: string, locale: string) => Promise<void>;
+    };
   };
   orders: {
     /**
@@ -16740,6 +17114,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       progressStatus?: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
       currency?: string | undefined;
+      locale?: string | null | undefined;
     }>;
     /**
      * `POST /v1/orders/{orderId}/cash-receipt/reissue` — 실패했거나 재시도 대기 중인 현금영수증을 지금 다시 발급·취소한다.
@@ -21987,6 +22362,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       couponsEnabled: boolean;
       pointsEnabled: boolean;
       archivedAt: string | null;
+      locales: string[];
     }[]>;
     get: (marketId: string) => Promise<{
       marketId: string;
@@ -21998,6 +22374,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       couponsEnabled: boolean;
       pointsEnabled: boolean;
       archivedAt: string | null;
+      locales: string[];
     }>;
     create: (body: CreateMarketRequestInput) => Promise<{
       marketId: string;
@@ -22009,6 +22386,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       couponsEnabled: boolean;
       pointsEnabled: boolean;
       archivedAt: string | null;
+      locales: string[];
     }>;
     update: (marketId: string, body: UpdateMarketRequestInput) => Promise<{
       marketId: string;
@@ -22020,6 +22398,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       couponsEnabled: boolean;
       pointsEnabled: boolean;
       archivedAt: string | null;
+      locales: string[];
     }>;
     archive: (marketId: string) => Promise<void>;
   };
@@ -23621,6 +24000,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       termsUrl: string | null;
       privacyUrl: string | null;
       memberCount: number;
+      defaultLocale: string;
       createdAt: string;
       businessName: string | null;
       representativeName: string | null;
@@ -23678,6 +24058,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       termsUrl: string | null;
       privacyUrl: string | null;
       memberCount: number;
+      defaultLocale: string;
       createdAt: string;
       businessName: string | null;
       representativeName: string | null;
@@ -24277,6 +24658,12 @@ export declare const customerDelegationSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type CustomerDelegation = z.infer<typeof customerDelegationSchema>;
 //#endregion
+//#region src/schemas/locale.d.ts
+export declare function normalizeLocale(value: string | null | undefined): string | null;
+/** 상점 기본 언어 — 옛 상점과 언어를 정하지 않은 상점의 값이다 */
+export declare const DEFAULT_STORE_LOCALE = "ko";
+export declare const localeCodeSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+//#endregion
 //#region src/schemas/promotion.d.ts
 /** 쿠폰 종류 */
 export declare const couponKindSchema: z.ZodEnum<{