@sayren/store-sdk 0.35.0 → 0.37.0

package/dist/index.d.mts

@@ -165,9 +165,9 @@ export declare const auditLogPageSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
 export declare const agentPolicyDecisionSchema: z.ZodEnum<{
+  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   DENIED: "DENIED";
   ALLOW: "ALLOW";
-  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
 export declare const writePreviewSchema: z.ZodObject<{
@@ -191,9 +191,9 @@ export type WritePreview = z.infer<typeof writePreviewSchema>;
 export declare const writeDryRunResultSchema: z.ZodObject<{
   dryRun: z.ZodLiteral<true>;
   decision: z.ZodEnum<{
+    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
     DENIED: "DENIED";
     ALLOW: "ALLOW";
-    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   }>;
   reason: z.ZodNullable<z.ZodString>;
   preview: z.ZodObject<{
@@ -495,10 +495,10 @@ export type AiRun = z.infer<typeof aiRunSchema>;
  * AI가 지금 하는 일의 종류 — 도구 이름·operationId·파일 경로로 서버가 정한다(상점 만들기 진행 화면이 아이콘·문구를 고른다). 정하지 못한 도구는 없다
  */
 export declare const aiActivitySchema: z.ZodEnum<{
-  check: "check";
   code: "code";
-  version: "version";
   status: "status";
+  check: "check";
+  version: "version";
   shipping: "shipping";
   category: "category";
   brief: "brief";
@@ -721,16 +721,16 @@ export declare const aiMessagePartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   name: z.ZodString;
   label: z.ZodString;
   status: z.ZodEnum<{
-    error: "error";
     unknown: "unknown";
+    error: "error";
     ok: "ok";
   }>;
   summary: z.ZodNullable<z.ZodString>;
   activity: z.ZodOptional<z.ZodEnum<{
-    check: "check";
     code: "code";
-    version: "version";
     status: "status";
+    check: "check";
+    version: "version";
     shipping: "shipping";
     category: "category";
     brief: "brief";
@@ -873,16 +873,16 @@ export declare const aiMessageSchema: z.ZodObject<{
     name: z.ZodString;
     label: z.ZodString;
     status: z.ZodEnum<{
-      error: "error";
       unknown: "unknown";
+      error: "error";
       ok: "ok";
     }>;
     summary: z.ZodNullable<z.ZodString>;
     activity: z.ZodOptional<z.ZodEnum<{
-      check: "check";
       code: "code";
-      version: "version";
       status: "status";
+      check: "check";
+      version: "version";
       shipping: "shipping";
       category: "category";
       brief: "brief";
@@ -1040,16 +1040,16 @@ export declare const aiConversationSchema: z.ZodObject<{
       name: z.ZodString;
       label: z.ZodString;
       status: z.ZodEnum<{
-        error: "error";
         unknown: "unknown";
+        error: "error";
         ok: "ok";
       }>;
       summary: z.ZodNullable<z.ZodString>;
       activity: z.ZodOptional<z.ZodEnum<{
-        check: "check";
         code: "code";
-        version: "version";
         status: "status";
+        check: "check";
+        version: "version";
         shipping: "shipping";
         category: "category";
         brief: "brief";
@@ -1311,6 +1311,7 @@ export declare const aiFocusAreaSchema: z.ZodEnum<{
   addresses: "addresses";
   orders: "orders";
   webhooks: "webhooks";
+  members: "members";
   categories: "categories";
   collections: "collections";
   option_sets: "option_sets";
@@ -1323,7 +1324,6 @@ export declare const aiFocusAreaSchema: z.ZodEnum<{
   store_settings: "store_settings";
   payments: "payments";
   login: "login";
-  members: "members";
   order_flows: "order_flows";
   storefront: "storefront";
 }>;
@@ -1335,6 +1335,7 @@ export declare const aiFocusSchema: z.ZodObject<{
     addresses: "addresses";
     orders: "orders";
     webhooks: "webhooks";
+    members: "members";
     categories: "categories";
     collections: "collections";
     option_sets: "option_sets";
@@ -1347,7 +1348,6 @@ export declare const aiFocusSchema: z.ZodObject<{
     store_settings: "store_settings";
     payments: "payments";
     login: "login";
-    members: "members";
     order_flows: "order_flows";
     storefront: "storefront";
   }>;
@@ -1518,6 +1518,7 @@ export declare const aiStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       addresses: "addresses";
       orders: "orders";
       webhooks: "webhooks";
+      members: "members";
       categories: "categories";
       collections: "collections";
       option_sets: "option_sets";
@@ -1530,17 +1531,16 @@ export declare const aiStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       store_settings: "store_settings";
       payments: "payments";
       login: "login";
-      members: "members";
       order_flows: "order_flows";
       storefront: "storefront";
     }>;
     id: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
   activity: z.ZodOptional<z.ZodEnum<{
-    check: "check";
     code: "code";
-    version: "version";
     status: "status";
+    check: "check";
+    version: "version";
     shipping: "shipping";
     category: "category";
     brief: "brief";
@@ -1576,8 +1576,8 @@ export declare const aiStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   messageId: z.ZodString;
   toolCallId: z.ZodString;
   status: z.ZodEnum<{
-    error: "error";
     unknown: "unknown";
+    error: "error";
     ok: "ok";
   }>;
   summary: z.ZodNullable<z.ZodString>;
@@ -1640,16 +1640,16 @@ export declare const aiStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       name: z.ZodString;
       label: z.ZodString;
       status: z.ZodEnum<{
-        error: "error";
         unknown: "unknown";
+        error: "error";
         ok: "ok";
       }>;
       summary: z.ZodNullable<z.ZodString>;
       activity: z.ZodOptional<z.ZodEnum<{
-        check: "check";
         code: "code";
-        version: "version";
         status: "status";
+        check: "check";
+        version: "version";
         shipping: "shipping";
         category: "category";
         brief: "brief";
@@ -1850,6 +1850,7 @@ export declare const aiStreamRecordSchema: z.ZodObject<{
         addresses: "addresses";
         orders: "orders";
         webhooks: "webhooks";
+        members: "members";
         categories: "categories";
         collections: "collections";
         option_sets: "option_sets";
@@ -1862,17 +1863,16 @@ export declare const aiStreamRecordSchema: z.ZodObject<{
         store_settings: "store_settings";
         payments: "payments";
         login: "login";
-        members: "members";
         order_flows: "order_flows";
         storefront: "storefront";
       }>;
       id: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     activity: z.ZodOptional<z.ZodEnum<{
-      check: "check";
       code: "code";
-      version: "version";
       status: "status";
+      check: "check";
+      version: "version";
       shipping: "shipping";
       category: "category";
       brief: "brief";
@@ -1908,8 +1908,8 @@ export declare const aiStreamRecordSchema: z.ZodObject<{
     messageId: z.ZodString;
     toolCallId: z.ZodString;
     status: z.ZodEnum<{
-      error: "error";
       unknown: "unknown";
+      error: "error";
       ok: "ok";
     }>;
     summary: z.ZodNullable<z.ZodString>;
@@ -1972,16 +1972,16 @@ export declare const aiStreamRecordSchema: z.ZodObject<{
         name: z.ZodString;
         label: z.ZodString;
         status: z.ZodEnum<{
-          error: "error";
           unknown: "unknown";
+          error: "error";
           ok: "ok";
         }>;
         summary: z.ZodNullable<z.ZodString>;
         activity: z.ZodOptional<z.ZodEnum<{
-          check: "check";
           code: "code";
-          version: "version";
           status: "status";
+          check: "check";
+          version: "version";
           shipping: "shipping";
           category: "category";
           brief: "brief";
@@ -6449,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
 /**
@@ -11392,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>;
 /** 옵션 축(그룹)이 가지는 값 하나 — 예: 축 "색상"의 값 "블랙" */
@@ -11637,9 +11662,6 @@ 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;
   status: z.ZodEnum<{
     SALE: "SALE";
     SUSPENDED: "SUSPENDED";
@@ -11647,10 +11669,13 @@ export declare const productSchema: z.ZodObject<{
     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>>;
@@ -12697,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 {
@@ -12728,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<{
@@ -12884,10 +12909,29 @@ 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이다.
+ * 조회 응답 — 지금 상품의 옵션명·값·직접 입력 항목, 셀러가 적은 고시 칸을 모두 싣고 번역하지 않은 칸은 null이다.
  * `optionGroups`는 조합 옵션, `addonGroups`는 추가 선택이다(상품 응답과 같은 구분)
  */
 export declare const productLocalizationSchema: z.ZodObject<{
@@ -12917,6 +12961,11 @@ export declare const productLocalizationSchema: z.ZodObject<{
     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>;
@@ -12951,8 +13000,22 @@ export declare const productLocalizationRequestSchema: z.ZodObject<{
     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
 /**
@@ -13186,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
 /**
@@ -13674,7 +13780,8 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
  * - 502 `STOREFRONT_SANDBOX_UNAVAILABLE` — 편집 Sandbox 호출이 실패했다. 잠시 뒤 다시 한다
  *
  * 소스 내려받기·올리기(#60, `/v1/storefront/site/source/**`, `sayren` CLI):
- * - 409 `SOURCE_CHANGED` — 작업 트리가 내려받은 뒤(`expectedBaseRef`) 바뀌었다(상점 플랫폼·AI 편집). `error.details.currentRef`
+ * - 409 `SOURCE_CHANGED` — 작업 트리가 내려받은 뒤(`expectedBaseRef`) 바뀌었고 같은 파일을 서로 다르게 고쳤다(상점 플랫폼·AI 편집). 겹치지 않으면 서버가
+ *   3-way 병합한다(응답 `merged`). `error.details.currentRef`·`conflicts`(충돌 파일)
  * - 409 `EDIT_SESSION_OPEN` — 편집 환경이 열려 있다. `endEditSession: true`로 끄고 진행할 수 있다
  * - 409 `SOURCE_BLOBS_MISSING` — 올리지 않은 파일 내용이 있다(`error.details.hashes`). `POST source/blobs`로 올리고 다시 한다
  * - 409 `DEPENDENCY_REJECTED` — 쓸 수 없는 npm 의존성이다(`error.details.rejected: [{ name, version, reason, detail }]`)
@@ -13800,6 +13907,8 @@ export declare const storefrontVersionSchema: z.ZodObject<{
   buildId: z.ZodNullable<z.ZodString>;
   createdByType: z.ZodString;
   createdVia: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  gitRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  commitSha: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   createdAt: z.ZodString;
   previewable: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -13873,6 +13982,7 @@ export declare const storefrontSiteSnapshotSchema: z.ZodObject<{
 export type StorefrontSiteSnapshot = z.infer<typeof storefrontSiteSnapshotSchema>;
 export declare const storefrontSiteSchema: z.ZodObject<{
   siteId: z.ZodString;
+  deployWithoutApproval: z.ZodOptional<z.ZodBoolean>;
   slug: z.ZodString;
   hostname: z.ZodString;
   url: z.ZodString;
@@ -13923,6 +14033,8 @@ export declare const storefrontSiteSchema: z.ZodObject<{
     buildId: z.ZodNullable<z.ZodString>;
     createdByType: z.ZodString;
     createdVia: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    gitRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    commitSha: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodString;
     previewable: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>>;
@@ -13959,6 +14071,7 @@ export declare const storefrontHostingSchema: z.ZodObject<{
   editingEnabled: z.ZodBoolean;
   site: z.ZodNullable<z.ZodObject<{
     siteId: z.ZodString;
+    deployWithoutApproval: z.ZodOptional<z.ZodBoolean>;
     slug: z.ZodString;
     hostname: z.ZodString;
     url: z.ZodString;
@@ -14009,6 +14122,8 @@ export declare const storefrontHostingSchema: z.ZodObject<{
       buildId: z.ZodNullable<z.ZodString>;
       createdByType: z.ZodString;
       createdVia: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      gitRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      commitSha: z.ZodOptional<z.ZodNullable<z.ZodString>>;
       createdAt: z.ZodString;
       previewable: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
@@ -14856,6 +14971,8 @@ export declare const storefrontVersionCreatedSchema: z.ZodObject<{
     buildId: z.ZodNullable<z.ZodString>;
     createdByType: z.ZodString;
     createdVia: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    gitRef: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    commitSha: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodString;
     previewable: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>;
@@ -15040,6 +15157,8 @@ export declare const storefrontSourceReplacedSchema: z.ZodObject<{
   files: z.ZodNumber;
   bytes: z.ZodNumber;
   changed: z.ZodBoolean;
+  merged: z.ZodOptional<z.ZodBoolean>;
+  uploadedRef: z.ZodOptional<z.ZodString>;
   endedEditSession: z.ZodBoolean;
   dependencyWarnings: z.ZodArray<z.ZodObject<{
     name: z.ZodString;
@@ -15055,6 +15174,62 @@ export declare const storefrontSourceReplacedSchema: z.ZodObject<{
   }, z.core.$strip>>;
 }, z.core.$strip>;
 export type StorefrontSourceReplaced = z.infer<typeof storefrontSourceReplacedSchema>;
+/**
+ * `GET /v1/storefront/site/git` — 사이트의 Git 원천. 발행한 소스는 GitHub 저장소 main에 있다(사내 저장소 또는 셀러가 연결한 저장소).
+ * 연결 전이면 필드가 null이다
+ */
+export declare const storefrontGitStatusSchema: z.ZodObject<{
+  provider: z.ZodNullable<z.ZodEnum<{
+    GITHUB: "GITHUB";
+  }>>;
+  owner: z.ZodNullable<z.ZodEnum<{
+    SELLER: "SELLER";
+    SAYREN: "SAYREN";
+  }>>;
+  repository: z.ZodNullable<z.ZodString>;
+  productionBranch: z.ZodNullable<z.ZodString>;
+  rootDirectory: z.ZodNullable<z.ZodString>;
+  connectedAt: z.ZodNullable<z.ZodString>;
+  headCommitSha: z.ZodNullable<z.ZodString>;
+  mainChanged: z.ZodBoolean;
+  autoPromotePaused: z.ZodBoolean;
+  publishPending: z.ZodBoolean;
+  publishErrorCode: z.ZodNullable<z.ZodString>;
+  archivedWorkRef: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type StorefrontGitStatus = z.infer<typeof storefrontGitStatusSchema>;
+export declare const storefrontGitRepositorySchema: z.ZodObject<{
+  repoId: z.ZodNumber;
+  fullName: z.ZodString;
+  defaultBranch: z.ZodString;
+}, z.core.$strip>;
+export type StorefrontGitRepository = z.infer<typeof storefrontGitRepositorySchema>;
+/** `POST /v1/storefront/site/git/installations` — GitHub App 설치 화면에서 돌아온 값(`installation_id`·`code`) */
+export declare const linkStorefrontGitInstallationRequestSchema: z.ZodObject<{
+  installationId: z.ZodNumber;
+  code: z.ZodString;
+  state: z.ZodString;
+}, z.core.$strip>;
+/** `POST /v1/storefront/site/git/installations/state` — GitHub 설치 화면에 싣는 1회용 state(이 상점·사용자, 10분) */
+export declare const storefrontGitConnectStateSchema: z.ZodObject<{
+  state: z.ZodString;
+  expiresAt: z.ZodString;
+}, z.core.$strip>;
+export type StorefrontGitConnectState = z.infer<typeof storefrontGitConnectStateSchema>;
+export type LinkStorefrontGitInstallationRequest = z.infer<typeof linkStorefrontGitInstallationRequestSchema>;
+/** `POST /v1/storefront/site/git/connect` */
+export declare const connectStorefrontGitRequestSchema: z.ZodObject<{
+  installationId: z.ZodNumber;
+  repoId: z.ZodNumber;
+  productionBranch: z.ZodOptional<z.ZodString>;
+  rootDirectory: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ConnectStorefrontGitRequest = z.infer<typeof connectStorefrontGitRequestSchema>;
+/** `PUT /v1/storefront/site/deploy-approval` — 승인 없이 배포(#138) */
+export declare const setStorefrontDeployApprovalRequestSchema: z.ZodObject<{
+  deployWithoutApproval: z.ZodBoolean;
+}, z.core.$strip>;
+export type SetStorefrontDeployApprovalRequest = z.infer<typeof setStorefrontDeployApprovalRequestSchema>;
 //#endregion
 //#region src/schemas/upload.d.ts
 /**
@@ -15347,18 +15522,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;
+      name: string;
       stockQuantity: number;
       categoryId: string | null;
+      productId: string;
+      productNo: number | null;
+      discountedPrice: number | null;
       hasOptions: boolean;
       updatedAt: string;
       sample: boolean;
@@ -15500,14 +15679,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;
+      name: string;
       stockQuantity: number;
       categoryId: string | null;
+      productId: string;
+      productNo: number | null;
+      discountedPrice: number | null;
       hasOptions: boolean;
       updatedAt: string;
       sample: boolean;
@@ -15649,14 +15828,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;
+      name: string;
       stockQuantity: number;
       categoryId: string | null;
+      productId: string;
+      productNo: number | null;
+      discountedPrice: number | null;
       hasOptions: boolean;
       updatedAt: string;
       sample: boolean;
@@ -15828,6 +16007,11 @@ export declare function createStoreClient(options: StoreClientOptions): {
           label: string | null;
           placeholder: string | null;
         }[];
+        notice: {
+          key: string;
+          label: string;
+          value: string | null;
+        }[];
         updatedAt: string;
       }[]>;
       put: (productId: string, locale: string, body: ProductLocalizationRequest) => Promise<{
@@ -15857,6 +16041,11 @@ export declare function createStoreClient(options: StoreClientOptions): {
           label: string | null;
           placeholder: string | null;
         }[];
+        notice: {
+          key: string;
+          label: string;
+          value: string | null;
+        }[];
         updatedAt: string;
       }>;
       remove: (productId: string, locale: string) => Promise<void>;
@@ -16182,6 +16371,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`)다
@@ -16260,6 +16487,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`).
@@ -16569,6 +16814,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?: {
@@ -22285,9 +22550,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
           toolCallId: string;
           name: string;
           label: string;
-          status: "error" | "unknown" | "ok";
+          status: "unknown" | "error" | "ok";
           summary: string | null;
-          activity?: "check" | "code" | "version" | "status" | "shipping" | "category" | "brief" | "files" | "preview" | "template" | "site" | "info" | "upload" | "design" | "product" | "verify" | undefined;
+          activity?: "code" | "status" | "check" | "version" | "shipping" | "category" | "brief" | "files" | "preview" | "template" | "site" | "info" | "upload" | "design" | "product" | "verify" | undefined;
           target?: string | undefined;
           changes?: {
             path: string;
@@ -22511,6 +22776,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
           createdByType: string;
           createdAt: string;
           createdVia?: string | null | undefined;
+          gitRef?: string | null | undefined;
+          commitSha?: string | null | undefined;
           previewable?: boolean | undefined;
         } | null;
         provisioning: {
@@ -22524,6 +22791,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         slugChangesRemaining: number;
         createdAt: string;
         updatedAt: string;
+        deployWithoutApproval?: boolean | undefined;
         suspension?: {
           reason: string | null;
           suspendedAt: string | null;
@@ -22575,6 +22843,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        gitRef?: string | null | undefined;
+        commitSha?: string | null | undefined;
         previewable?: boolean | undefined;
       } | null;
       provisioning: {
@@ -22588,6 +22858,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      deployWithoutApproval?: boolean | undefined;
       suspension?: {
         reason: string | null;
         suspendedAt: string | null;
@@ -22677,6 +22948,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        gitRef?: string | null | undefined;
+        commitSha?: string | null | undefined;
         previewable?: boolean | undefined;
       } | null;
       provisioning: {
@@ -22690,6 +22963,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      deployWithoutApproval?: boolean | undefined;
       suspension?: {
         reason: string | null;
         suspendedAt: string | null;
@@ -22715,6 +22989,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       createdByType: string;
       createdAt: string;
       createdVia?: string | null | undefined;
+      gitRef?: string | null | undefined;
+      commitSha?: string | null | undefined;
       previewable?: boolean | undefined;
     }[]>;
     /** `POST /v1/storefront/site/versions/{versionId}/publish` — 그 버전을 발행한다(이미 발행돼 있으면 그대로 200) */
@@ -22748,6 +23024,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        gitRef?: string | null | undefined;
+        commitSha?: string | null | undefined;
         previewable?: boolean | undefined;
       } | null;
       provisioning: {
@@ -22761,6 +23039,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      deployWithoutApproval?: boolean | undefined;
       suspension?: {
         reason: string | null;
         suspendedAt: string | null;
@@ -22802,6 +23081,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        gitRef?: string | null | undefined;
+        commitSha?: string | null | undefined;
         previewable?: boolean | undefined;
       } | null;
       provisioning: {
@@ -22815,6 +23096,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      deployWithoutApproval?: boolean | undefined;
       suspension?: {
         reason: string | null;
         suspendedAt: string | null;
@@ -22856,6 +23138,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        gitRef?: string | null | undefined;
+        commitSha?: string | null | undefined;
         previewable?: boolean | undefined;
       } | null;
       provisioning: {
@@ -22869,6 +23153,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      deployWithoutApproval?: boolean | undefined;
       suspension?: {
         reason: string | null;
         suspendedAt: string | null;
@@ -22910,6 +23195,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        gitRef?: string | null | undefined;
+        commitSha?: string | null | undefined;
         previewable?: boolean | undefined;
       } | null;
       provisioning: {
@@ -22923,6 +23210,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      deployWithoutApproval?: boolean | undefined;
       suspension?: {
         reason: string | null;
         suspendedAt: string | null;
@@ -23112,6 +23400,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        gitRef?: string | null | undefined;
+        commitSha?: string | null | undefined;
         previewable?: boolean | undefined;
       } | null;
       provisioning: {
@@ -23125,6 +23415,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       slugChangesRemaining: number;
       createdAt: string;
       updatedAt: string;
+      deployWithoutApproval?: boolean | undefined;
       suspension?: {
         reason: string | null;
         suspendedAt: string | null;
@@ -23357,6 +23648,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         createdByType: string;
         createdAt: string;
         createdVia?: string | null | undefined;
+        gitRef?: string | null | undefined;
+        commitSha?: string | null | undefined;
         previewable?: boolean | undefined;
       };
       build: {
@@ -23655,46 +23948,171 @@ export declare function createStoreClient(options: StoreClientOptions): {
           title: string;
         } | null | undefined;
       }[];
+      merged?: boolean | undefined;
+      uploadedRef?: string | undefined;
     }>;
-  };
-  subscription: {
-    /**
-     * `GET /v1/store/subscription` — 스코프 `store:r`. 현재 요금제·상태·사용량 기간·한도·이번 기간 사용량.
-     * 결제 수단·청구 금액은 싣지 않는다. 요금제 변경은 상점 플랫폼에서만 한다
-     */
-    get: () => Promise<{
-      plan: {
-        code: string;
-        name: string;
-      };
-      status: "ACTIVE" | "CANCELED" | "INCOMPLETE" | "PAST_DUE";
-      interval: "MONTH" | null;
-      cancelAtPeriodEnd: boolean;
-      period: {
-        start: string;
-        end: string;
-      };
-      limits: {
-        liveOrdersMonthly: number | null;
-        seatsIncluded: number | null;
-        aiActionsMonthly: number | null;
-        aiReadsMonthly: number | null;
-        customDomains: number | null;
-        webhooks: number | null;
-        socialProviders: number | null;
-        emailsMonthly: number | null;
-        storefrontRequestsMonthly: number | null;
-        apiLogRetentionDays: number | null;
-        auditLogRetentionDays: number | null;
-        storefrontPreviewHoursMonthly: number | null;
+    /** `PUT /v1/storefront/site/deploy-approval` — 승인 없이 배포(상점 플랫폼 OWNER·ADMIN 전용) */
+    setDeployApproval: (body: SetStorefrontDeployApprovalRequest) => Promise<{
+      siteId: string;
+      slug: string;
+      hostname: string;
+      url: string;
+      domains: {
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "HELD";
+        isPrimary: boolean;
+        holdUntil: string | null;
+      }[];
+      templateId: string;
+      sourceMode: "CUSTOM" | "MANAGED";
+      status: "SUSPENDED" | "CLOSED" | "ACTIVE";
+      visibility: "COMING_SOON" | "PUBLIC";
+      publishedVersion: {
+        versionId: string;
+        number: number;
+        templateId: string;
+        templateVersion: string;
+        status: "FAILED" | "BUILDING" | "READY";
+        published: boolean;
+        publishedAt: string | null;
+        message: string | null;
+        source: "TEMPLATE" | "EDIT";
+        buildId: string | null;
+        createdByType: string;
+        createdAt: string;
+        createdVia?: string | null | undefined;
+        gitRef?: string | null | undefined;
+        commitSha?: string | null | undefined;
+        previewable?: boolean | undefined;
+      } | null;
+      provisioning: {
+        status: "PENDING" | "FAILED" | "SYNCED";
+        lastErrorCode: string | null;
+        syncedAt: string | null;
+      };
+      editPreview: {
+        hostname: string | null;
+      };
+      slugChangesRemaining: number;
+      createdAt: string;
+      updatedAt: string;
+      deployWithoutApproval?: boolean | undefined;
+      suspension?: {
+        reason: string | null;
+        suspendedAt: string | null;
+      } | null | undefined;
+      snapshot?: {
+        url: string;
+        versionId: string | null;
+        capturedAt: string | null;
+      } | null | undefined;
+    }>;
+    /** `GET /v1/storefront/site/git` — Git 원천(발행 소스를 둔 저장소)과 상태(#138) */
+    getGit: () => Promise<{
+      provider: "GITHUB" | null;
+      owner: "SELLER" | "SAYREN" | null;
+      repository: string | null;
+      productionBranch: string | null;
+      rootDirectory: string | null;
+      connectedAt: string | null;
+      headCommitSha: string | null;
+      mainChanged: boolean;
+      autoPromotePaused: boolean;
+      publishPending: boolean;
+      publishErrorCode: string | null;
+      archivedWorkRef: string | null;
+    }>;
+    /** `POST /v1/storefront/site/git/installations/state` — GitHub 설치 화면에 싣는 1회용 state(상점 플랫폼 전용) */
+    createGitConnectState: () => Promise<{
+      state: string;
+      expiresAt: string;
+    }>;
+    /** `POST /v1/storefront/site/git/installations` — GitHub App 설치 확인(상점 플랫폼 전용) → 그 설치의 저장소 */
+    linkGitInstallation: (body: LinkStorefrontGitInstallationRequest) => Promise<{
+      repoId: number;
+      fullName: string;
+      defaultBranch: string;
+    }[]>;
+    /** `GET /v1/storefront/site/git/installations/{installationId}/repositories` — 확인한 설치의 저장소(상점 플랫폼 전용) */
+    listGitRepositories: (installationId: number) => Promise<{
+      repoId: number;
+      fullName: string;
+      defaultBranch: string;
+    }[]>;
+    /** `POST /v1/storefront/site/git/connect` — 셀러 GitHub 저장소 연결(상점 플랫폼 전용) */
+    connectGit: (body: ConnectStorefrontGitRequest) => Promise<{
+      provider: "GITHUB" | null;
+      owner: "SELLER" | "SAYREN" | null;
+      repository: string | null;
+      productionBranch: string | null;
+      rootDirectory: string | null;
+      connectedAt: string | null;
+      headCommitSha: string | null;
+      mainChanged: boolean;
+      autoPromotePaused: boolean;
+      publishPending: boolean;
+      publishErrorCode: string | null;
+      archivedWorkRef: string | null;
+    }>;
+    /** `POST /v1/storefront/site/git/disconnect` — 연결 해제(sayren 저장소로 되돌림, 상점 플랫폼 전용) */
+    disconnectGit: () => Promise<{
+      provider: "GITHUB" | null;
+      owner: "SELLER" | "SAYREN" | null;
+      repository: string | null;
+      productionBranch: string | null;
+      rootDirectory: string | null;
+      connectedAt: string | null;
+      headCommitSha: string | null;
+      mainChanged: boolean;
+      autoPromotePaused: boolean;
+      publishPending: boolean;
+      publishErrorCode: string | null;
+      archivedWorkRef: string | null;
+    }>;
+  };
+  subscription: {
+    /**
+     * `GET /v1/store/subscription` — 스코프 `store:r`. 현재 요금제·상태·사용량 기간·한도·이번 기간 사용량.
+     * 결제 수단·청구 금액은 싣지 않는다. 요금제 변경은 상점 플랫폼에서만 한다
+     */
+    get: () => Promise<{
+      plan: {
+        code: string;
+        name: string;
+      };
+      status: "ACTIVE" | "CANCELED" | "INCOMPLETE" | "PAST_DUE";
+      interval: "MONTH" | null;
+      cancelAtPeriodEnd: boolean;
+      period: {
+        start: string;
+        end: string;
+      };
+      limits: {
+        liveOrdersMonthly: number | null;
+        seatsIncluded: number | null;
+        aiActionsMonthly: number | null;
+        aiReadsMonthly: number | null;
+        customDomains: number | null;
+        webhooks: number | null;
+        socialProviders: number | null;
+        emailsMonthly: number | null;
+        storefrontRequestsMonthly: number | null;
+        apiLogRetentionDays: number | null;
+        auditLogRetentionDays: number | null;
+        storefrontPreviewHoursMonthly: number | null;
         storefrontBuildMinutesMonthly: number | null;
         adminApiRequestsMonthly: number | null;
+        publicApps?: number | null | undefined;
+        privateApps?: number | null | undefined;
+        aiCreditsMonthly?: number | null | undefined;
       };
       features: {
         adminApi: boolean;
         analytics: boolean;
         storeClone: boolean;
         removeBadge: boolean;
+        members?: boolean | undefined;
       };
       usage: {
         liveOrders: number;
@@ -23708,6 +24126,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         seats: number;
         customDomains: number;
         webhooks: number;
+        publicApps?: number | undefined;
+        privateApps?: number | undefined;
       };
       aiActions: {
         limit: number | null;
@@ -23720,6 +24140,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
         resetsAt: string;
       };
       salesFeePercent: 0;
+      aiCredits?: {
+        monthly: number | null;
+        granted: number;
+        used: number;
+        remaining: number | null;
+        resetsAt: string;
+        monthlyUsed?: number | undefined;
+        purchased?: number | undefined;
+        complimentary?: number | undefined;
+      } | undefined;
     }>;
   };
   plans: {
@@ -23744,12 +24174,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
           };
         };
         entitlements: {
+          "features.members": boolean;
           "features.admin_api": boolean;
           "features.analytics": boolean;
           "limits.ai_reads_monthly": number | null;
           "limits.ai_actions_monthly": number | null;
           "limits.custom_domains": number | null;
           "limits.webhooks": number | null;
+          "limits.public_apps": number | null;
+          "limits.private_apps": number | null;
+          "limits.ai_credits_monthly": number | null;
           "limits.storefront_preview_hours_monthly": number | null;
           "limits.storefront_build_minutes_monthly": number | null;
           "limits.storefront_requests_monthly": number | null;
@@ -24468,6 +24902,159 @@ export declare function normalizeLocale(value: string | null | undefined): strin
 export declare const DEFAULT_STORE_LOCALE = "ko";
 export declare const localeCodeSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
 //#endregion
+//#region src/schemas/plans.d.ts
+/**
+ * 요금제 기능 키 값 — 요금제 비교표·상점 플랫폼 요금제 화면이 쓴다. 키는 서버 판정의 기능 키와 같다(추가만 한다). 상위 요금제는 하위 요금제
+ * 기능을 모두 포함한다
+ */
+export declare const planEntitlementsSchema: z.ZodObject<{
+  "features.members": z.ZodBoolean;
+  "features.admin_api": z.ZodBoolean;
+  "features.analytics": z.ZodBoolean;
+  "limits.ai_reads_monthly": z.ZodNullable<z.ZodNumber>;
+  "limits.ai_actions_monthly": z.ZodNullable<z.ZodNumber>;
+  "limits.custom_domains": z.ZodNullable<z.ZodNumber>;
+  "limits.webhooks": z.ZodNullable<z.ZodNumber>;
+  "limits.public_apps": z.ZodNullable<z.ZodNumber>;
+  "limits.private_apps": z.ZodNullable<z.ZodNumber>;
+  "limits.ai_credits_monthly": z.ZodNullable<z.ZodNumber>;
+  "limits.storefront_preview_hours_monthly": z.ZodNullable<z.ZodNumber>;
+  "limits.storefront_build_minutes_monthly": z.ZodNullable<z.ZodNumber>;
+  "limits.storefront_requests_monthly": z.ZodNullable<z.ZodNumber>;
+  "limits.admin_api_requests_monthly": z.ZodNullable<z.ZodNumber>;
+  "rate_limit.admin_api": z.ZodNullable<z.ZodNumber>;
+  "storefront.cpu_ms": z.ZodNumber;
+  "storefront.subrequests": z.ZodNumber;
+  "storefront.rate_limit_per_minute": z.ZodNumber;
+  "seats.included": z.ZodNullable<z.ZodNumber>;
+  "retention.analytics_days": z.ZodNumber;
+  "retention.api_logs_days": z.ZodNullable<z.ZodNumber>;
+  "retention.audit_days": z.ZodNullable<z.ZodNumber>;
+  "support.tier": z.ZodUnion<readonly [z.ZodEnum<{
+    EMAIL: "EMAIL";
+    COMMUNITY: "COMMUNITY";
+    EMAIL_PRIORITY: "EMAIL_PRIORITY";
+    DEDICATED: "DEDICATED";
+    SLA: "SLA";
+  }>, z.ZodString]>;
+}, z.core.$strip>;
+export type PlanEntitlementValues = z.infer<typeof planEntitlementsSchema>;
+/** 공개 요금제 한 줄 — `GET /v1/public/plans` */
+export declare const publicPlanSchema: z.ZodObject<{
+  code: z.ZodUnion<readonly [z.ZodEnum<{
+    FREE: "FREE";
+    BASIC: "BASIC";
+    BETA: "BETA";
+    PRO: "PRO";
+    BUSINESS: "BUSINESS";
+    ENTERPRISE: "ENTERPRISE";
+    PREMIUM: "PREMIUM";
+  }>, z.ZodString]>;
+  name: z.ZodString;
+  version: z.ZodNumber;
+  sort: z.ZodNumber;
+  purchasable: z.ZodBoolean;
+  prices: z.ZodObject<{
+    currency: z.ZodLiteral<"KRW">;
+    monthly: z.ZodNullable<z.ZodNumber>;
+    startingAt: z.ZodBoolean;
+    vatIncluded: z.ZodObject<{
+      monthly: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+  }, z.core.$strip>;
+  entitlements: z.ZodObject<{
+    "features.members": z.ZodBoolean;
+    "features.admin_api": z.ZodBoolean;
+    "features.analytics": z.ZodBoolean;
+    "limits.ai_reads_monthly": z.ZodNullable<z.ZodNumber>;
+    "limits.ai_actions_monthly": z.ZodNullable<z.ZodNumber>;
+    "limits.custom_domains": z.ZodNullable<z.ZodNumber>;
+    "limits.webhooks": z.ZodNullable<z.ZodNumber>;
+    "limits.public_apps": z.ZodNullable<z.ZodNumber>;
+    "limits.private_apps": z.ZodNullable<z.ZodNumber>;
+    "limits.ai_credits_monthly": z.ZodNullable<z.ZodNumber>;
+    "limits.storefront_preview_hours_monthly": z.ZodNullable<z.ZodNumber>;
+    "limits.storefront_build_minutes_monthly": z.ZodNullable<z.ZodNumber>;
+    "limits.storefront_requests_monthly": z.ZodNullable<z.ZodNumber>;
+    "limits.admin_api_requests_monthly": z.ZodNullable<z.ZodNumber>;
+    "rate_limit.admin_api": z.ZodNullable<z.ZodNumber>;
+    "storefront.cpu_ms": z.ZodNumber;
+    "storefront.subrequests": z.ZodNumber;
+    "storefront.rate_limit_per_minute": z.ZodNumber;
+    "seats.included": z.ZodNullable<z.ZodNumber>;
+    "retention.analytics_days": z.ZodNumber;
+    "retention.api_logs_days": z.ZodNullable<z.ZodNumber>;
+    "retention.audit_days": z.ZodNullable<z.ZodNumber>;
+    "support.tier": z.ZodUnion<readonly [z.ZodEnum<{
+      EMAIL: "EMAIL";
+      COMMUNITY: "COMMUNITY";
+      EMAIL_PRIORITY: "EMAIL_PRIORITY";
+      DEDICATED: "DEDICATED";
+      SLA: "SLA";
+    }>, z.ZodString]>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+export type PublicPlan = z.infer<typeof publicPlanSchema>;
+/** 요금제 비교표 — `GET /v1/public/plans`(인증 없음, 캐시 가능). 값은 서버가 관리하고 언제든 바뀔 수 있다 */
+export declare const publicPlansSchema: z.ZodObject<{
+  vatPercent: z.ZodNumber;
+  plans: z.ZodArray<z.ZodObject<{
+    code: z.ZodUnion<readonly [z.ZodEnum<{
+      FREE: "FREE";
+      BASIC: "BASIC";
+      BETA: "BETA";
+      PRO: "PRO";
+      BUSINESS: "BUSINESS";
+      ENTERPRISE: "ENTERPRISE";
+      PREMIUM: "PREMIUM";
+    }>, z.ZodString]>;
+    name: z.ZodString;
+    version: z.ZodNumber;
+    sort: z.ZodNumber;
+    purchasable: z.ZodBoolean;
+    prices: z.ZodObject<{
+      currency: z.ZodLiteral<"KRW">;
+      monthly: z.ZodNullable<z.ZodNumber>;
+      startingAt: z.ZodBoolean;
+      vatIncluded: z.ZodObject<{
+        monthly: z.ZodNullable<z.ZodNumber>;
+      }, z.core.$strip>;
+    }, z.core.$strip>;
+    entitlements: z.ZodObject<{
+      "features.members": z.ZodBoolean;
+      "features.admin_api": z.ZodBoolean;
+      "features.analytics": z.ZodBoolean;
+      "limits.ai_reads_monthly": z.ZodNullable<z.ZodNumber>;
+      "limits.ai_actions_monthly": z.ZodNullable<z.ZodNumber>;
+      "limits.custom_domains": z.ZodNullable<z.ZodNumber>;
+      "limits.webhooks": z.ZodNullable<z.ZodNumber>;
+      "limits.public_apps": z.ZodNullable<z.ZodNumber>;
+      "limits.private_apps": z.ZodNullable<z.ZodNumber>;
+      "limits.ai_credits_monthly": z.ZodNullable<z.ZodNumber>;
+      "limits.storefront_preview_hours_monthly": z.ZodNullable<z.ZodNumber>;
+      "limits.storefront_build_minutes_monthly": z.ZodNullable<z.ZodNumber>;
+      "limits.storefront_requests_monthly": z.ZodNullable<z.ZodNumber>;
+      "limits.admin_api_requests_monthly": z.ZodNullable<z.ZodNumber>;
+      "rate_limit.admin_api": z.ZodNullable<z.ZodNumber>;
+      "storefront.cpu_ms": z.ZodNumber;
+      "storefront.subrequests": z.ZodNumber;
+      "storefront.rate_limit_per_minute": z.ZodNumber;
+      "seats.included": z.ZodNullable<z.ZodNumber>;
+      "retention.analytics_days": z.ZodNumber;
+      "retention.api_logs_days": z.ZodNullable<z.ZodNumber>;
+      "retention.audit_days": z.ZodNullable<z.ZodNumber>;
+      "support.tier": z.ZodUnion<readonly [z.ZodEnum<{
+        EMAIL: "EMAIL";
+        COMMUNITY: "COMMUNITY";
+        EMAIL_PRIORITY: "EMAIL_PRIORITY";
+        DEDICATED: "DEDICATED";
+        SLA: "SLA";
+      }>, z.ZodString]>;
+    }, z.core.$strip>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PublicPlans = z.infer<typeof publicPlansSchema>;
+//#endregion
 //#region src/schemas/promotion.d.ts
 /** 쿠폰 종류 */
 export declare const couponKindSchema: z.ZodEnum<{
@@ -25606,6 +26193,9 @@ export declare const subscriptionLimitsSchema: z.ZodObject<{
   storefrontPreviewHoursMonthly: z.ZodNullable<z.ZodNumber>;
   storefrontBuildMinutesMonthly: z.ZodNullable<z.ZodNumber>;
   adminApiRequestsMonthly: z.ZodNullable<z.ZodNumber>;
+  publicApps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  privateApps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  aiCreditsMonthly: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 export type SubscriptionLimits = z.infer<typeof subscriptionLimitsSchema>;
 export declare const subscriptionUsageSchema: z.ZodObject<{
@@ -25620,6 +26210,8 @@ export declare const subscriptionUsageSchema: z.ZodObject<{
   seats: z.ZodNumber;
   customDomains: z.ZodNumber;
   webhooks: z.ZodNumber;
+  publicApps: z.ZodOptional<z.ZodNumber>;
+  privateApps: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type SubscriptionUsage = z.infer<typeof subscriptionUsageSchema>;
 export declare const storeSubscriptionSchema: z.ZodObject<{
@@ -25664,10 +26256,14 @@ export declare const storeSubscriptionSchema: z.ZodObject<{
     storefrontPreviewHoursMonthly: z.ZodNullable<z.ZodNumber>;
     storefrontBuildMinutesMonthly: z.ZodNullable<z.ZodNumber>;
     adminApiRequestsMonthly: z.ZodNullable<z.ZodNumber>;
+    publicApps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    privateApps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    aiCreditsMonthly: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
   }, z.core.$strip>;
   features: z.ZodObject<{
     adminApi: z.ZodBoolean;
     analytics: z.ZodBoolean;
+    members: z.ZodOptional<z.ZodBoolean>;
     storeClone: z.ZodBoolean;
     removeBadge: z.ZodBoolean;
   }, z.core.$strip>;
@@ -25683,6 +26279,8 @@ export declare const storeSubscriptionSchema: z.ZodObject<{
     seats: z.ZodNumber;
     customDomains: z.ZodNumber;
     webhooks: z.ZodNumber;
+    publicApps: z.ZodOptional<z.ZodNumber>;
+    privateApps: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>;
   aiActions: z.ZodObject<{
     limit: z.ZodNullable<z.ZodNumber>;
@@ -25694,6 +26292,16 @@ export declare const storeSubscriptionSchema: z.ZodObject<{
     used: z.ZodNumber;
     resetsAt: z.ZodString;
   }, z.core.$strip>;
+  aiCredits: z.ZodOptional<z.ZodObject<{
+    monthly: z.ZodNullable<z.ZodNumber>;
+    granted: z.ZodNumber;
+    used: z.ZodNumber;
+    monthlyUsed: z.ZodOptional<z.ZodNumber>;
+    purchased: z.ZodOptional<z.ZodNumber>;
+    complimentary: z.ZodOptional<z.ZodNumber>;
+    remaining: z.ZodNullable<z.ZodNumber>;
+    resetsAt: z.ZodString;
+  }, z.core.$strip>>;
   salesFeePercent: z.ZodLiteral<0>;
 }, z.core.$strip>;
 export type StoreSubscription = z.infer<typeof storeSubscriptionSchema>;
@@ -25720,145 +26328,6 @@ export declare const planErrorDetailsSchema: z.ZodObject<{
   reason: z.ZodOptional<z.ZodString>;
 }, z.core.$loose>;
 export type PlanErrorDetails = z.infer<typeof planErrorDetailsSchema>;
-/**
- * 요금제 기능 키 값 — 요금제 비교표·상점 플랫폼 요금제 화면이 쓴다. 키는 서버 판정의 기능 키와 같다(추가만 한다). 상위 요금제는 하위 요금제
- * 기능을 모두 포함한다
- */
-export declare const planEntitlementsSchema: z.ZodObject<{
-  "features.admin_api": z.ZodBoolean;
-  "features.analytics": z.ZodBoolean;
-  "limits.ai_reads_monthly": z.ZodNullable<z.ZodNumber>;
-  "limits.ai_actions_monthly": z.ZodNullable<z.ZodNumber>;
-  "limits.custom_domains": z.ZodNullable<z.ZodNumber>;
-  "limits.webhooks": z.ZodNullable<z.ZodNumber>;
-  "limits.storefront_preview_hours_monthly": z.ZodNullable<z.ZodNumber>;
-  "limits.storefront_build_minutes_monthly": z.ZodNullable<z.ZodNumber>;
-  "limits.storefront_requests_monthly": z.ZodNullable<z.ZodNumber>;
-  "limits.admin_api_requests_monthly": z.ZodNullable<z.ZodNumber>;
-  "rate_limit.admin_api": z.ZodNullable<z.ZodNumber>;
-  "storefront.cpu_ms": z.ZodNumber;
-  "storefront.subrequests": z.ZodNumber;
-  "storefront.rate_limit_per_minute": z.ZodNumber;
-  "seats.included": z.ZodNullable<z.ZodNumber>;
-  "retention.analytics_days": z.ZodNumber;
-  "retention.api_logs_days": z.ZodNullable<z.ZodNumber>;
-  "retention.audit_days": z.ZodNullable<z.ZodNumber>;
-  "support.tier": z.ZodUnion<readonly [z.ZodEnum<{
-    EMAIL: "EMAIL";
-    COMMUNITY: "COMMUNITY";
-    EMAIL_PRIORITY: "EMAIL_PRIORITY";
-    DEDICATED: "DEDICATED";
-    SLA: "SLA";
-  }>, z.ZodString]>;
-}, z.core.$strip>;
-export type PlanEntitlementValues = z.infer<typeof planEntitlementsSchema>;
-/** 공개 요금제 한 줄 — `GET /v1/public/plans` */
-export declare const publicPlanSchema: z.ZodObject<{
-  code: z.ZodUnion<readonly [z.ZodEnum<{
-    FREE: "FREE";
-    BASIC: "BASIC";
-    BETA: "BETA";
-    PRO: "PRO";
-    BUSINESS: "BUSINESS";
-    ENTERPRISE: "ENTERPRISE";
-    PREMIUM: "PREMIUM";
-  }>, z.ZodString]>;
-  name: z.ZodString;
-  version: z.ZodNumber;
-  sort: z.ZodNumber;
-  purchasable: z.ZodBoolean;
-  prices: z.ZodObject<{
-    currency: z.ZodLiteral<"KRW">;
-    monthly: z.ZodNullable<z.ZodNumber>;
-    startingAt: z.ZodBoolean;
-    vatIncluded: z.ZodObject<{
-      monthly: z.ZodNullable<z.ZodNumber>;
-    }, z.core.$strip>;
-  }, z.core.$strip>;
-  entitlements: z.ZodObject<{
-    "features.admin_api": z.ZodBoolean;
-    "features.analytics": z.ZodBoolean;
-    "limits.ai_reads_monthly": z.ZodNullable<z.ZodNumber>;
-    "limits.ai_actions_monthly": z.ZodNullable<z.ZodNumber>;
-    "limits.custom_domains": z.ZodNullable<z.ZodNumber>;
-    "limits.webhooks": z.ZodNullable<z.ZodNumber>;
-    "limits.storefront_preview_hours_monthly": z.ZodNullable<z.ZodNumber>;
-    "limits.storefront_build_minutes_monthly": z.ZodNullable<z.ZodNumber>;
-    "limits.storefront_requests_monthly": z.ZodNullable<z.ZodNumber>;
-    "limits.admin_api_requests_monthly": z.ZodNullable<z.ZodNumber>;
-    "rate_limit.admin_api": z.ZodNullable<z.ZodNumber>;
-    "storefront.cpu_ms": z.ZodNumber;
-    "storefront.subrequests": z.ZodNumber;
-    "storefront.rate_limit_per_minute": z.ZodNumber;
-    "seats.included": z.ZodNullable<z.ZodNumber>;
-    "retention.analytics_days": z.ZodNumber;
-    "retention.api_logs_days": z.ZodNullable<z.ZodNumber>;
-    "retention.audit_days": z.ZodNullable<z.ZodNumber>;
-    "support.tier": z.ZodUnion<readonly [z.ZodEnum<{
-      EMAIL: "EMAIL";
-      COMMUNITY: "COMMUNITY";
-      EMAIL_PRIORITY: "EMAIL_PRIORITY";
-      DEDICATED: "DEDICATED";
-      SLA: "SLA";
-    }>, z.ZodString]>;
-  }, z.core.$strip>;
-}, z.core.$strip>;
-export type PublicPlan = z.infer<typeof publicPlanSchema>;
-/** 요금제 비교표 — `GET /v1/public/plans`(인증 없음, 캐시 가능). 값은 서버가 관리하고 언제든 바뀔 수 있다 */
-export declare const publicPlansSchema: z.ZodObject<{
-  vatPercent: z.ZodNumber;
-  plans: z.ZodArray<z.ZodObject<{
-    code: z.ZodUnion<readonly [z.ZodEnum<{
-      FREE: "FREE";
-      BASIC: "BASIC";
-      BETA: "BETA";
-      PRO: "PRO";
-      BUSINESS: "BUSINESS";
-      ENTERPRISE: "ENTERPRISE";
-      PREMIUM: "PREMIUM";
-    }>, z.ZodString]>;
-    name: z.ZodString;
-    version: z.ZodNumber;
-    sort: z.ZodNumber;
-    purchasable: z.ZodBoolean;
-    prices: z.ZodObject<{
-      currency: z.ZodLiteral<"KRW">;
-      monthly: z.ZodNullable<z.ZodNumber>;
-      startingAt: z.ZodBoolean;
-      vatIncluded: z.ZodObject<{
-        monthly: z.ZodNullable<z.ZodNumber>;
-      }, z.core.$strip>;
-    }, z.core.$strip>;
-    entitlements: z.ZodObject<{
-      "features.admin_api": z.ZodBoolean;
-      "features.analytics": z.ZodBoolean;
-      "limits.ai_reads_monthly": z.ZodNullable<z.ZodNumber>;
-      "limits.ai_actions_monthly": z.ZodNullable<z.ZodNumber>;
-      "limits.custom_domains": z.ZodNullable<z.ZodNumber>;
-      "limits.webhooks": z.ZodNullable<z.ZodNumber>;
-      "limits.storefront_preview_hours_monthly": z.ZodNullable<z.ZodNumber>;
-      "limits.storefront_build_minutes_monthly": z.ZodNullable<z.ZodNumber>;
-      "limits.storefront_requests_monthly": z.ZodNullable<z.ZodNumber>;
-      "limits.admin_api_requests_monthly": z.ZodNullable<z.ZodNumber>;
-      "rate_limit.admin_api": z.ZodNullable<z.ZodNumber>;
-      "storefront.cpu_ms": z.ZodNumber;
-      "storefront.subrequests": z.ZodNumber;
-      "storefront.rate_limit_per_minute": z.ZodNumber;
-      "seats.included": z.ZodNullable<z.ZodNumber>;
-      "retention.analytics_days": z.ZodNumber;
-      "retention.api_logs_days": z.ZodNullable<z.ZodNumber>;
-      "retention.audit_days": z.ZodNullable<z.ZodNumber>;
-      "support.tier": z.ZodUnion<readonly [z.ZodEnum<{
-        EMAIL: "EMAIL";
-        COMMUNITY: "COMMUNITY";
-        EMAIL_PRIORITY: "EMAIL_PRIORITY";
-        DEDICATED: "DEDICATED";
-        SLA: "SLA";
-      }>, z.ZodString]>;
-    }, z.core.$strip>;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-export type PublicPlans = z.infer<typeof publicPlansSchema>;
 //#endregion
 //#region src/schemas/telemetry.d.ts
 /**