@sayren/store-sdk 0.21.0 → 0.23.0

package/dist/index.d.mts

@@ -5515,9 +5515,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 {
@@ -5543,9 +5543,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<{
@@ -6003,11 +6003,12 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
 /**
  * 스토어프론트 호스팅 (이슈 #53, M1: 템플릿 발행) — 관리 API `/v1/storefront/**`의 계약이다.
  *
- * 셀러는 템플릿을 골라 사이트를 만들고 `{slug}.{호스팅 도메인}` 주소를 받는다. 발행은 버전 단위이고,
+ * 셀러는 템플릿을 골라 사이트를 만들고 `{slug}.{호스팅 도메인}` 주소를 받는다. 스토어를 만들어도 사이트는 생기지 않고
+ * `POST /v1/storefront/site`가 유일한 생성 경로다. 템플릿은 만들 때만 고르고 바꾸지 않는다. 발행은 버전 단위이고,
  * 되돌리기는 이전 버전을 다시 발행하는 것이다(재빌드 없음). 상태의 원천은 api DB이고 Cloudflare 쪽 반영
  * (라우팅 표·사이트 Worker)은 커밋 뒤 비동기다 — 반영 상태는 `provisioning`으로 본다.
  *
- * 스코프는 조회 `storefront:r`, 쓰기 `storefront:rw`(역할 OWNER·ADMIN)다. 에이전트(MCP)의 발행·되돌리기·템플릿 변경·
+ * 스코프는 조회 `storefront:r`, 쓰기 `storefront:rw`(역할 OWNER·ADMIN)다. 에이전트(MCP)의 발행·되돌리기·
  * 공개 전환·슬러그 변경·호스팅 끄기는 승인(`APPROVAL_REQUIRED`)이다 — 구매자가 보는 화면을 바꾸는 쓰기다.
  *
  * 오류 코드:
@@ -6022,6 +6023,7 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
  * - 409 `STORE_SUSPENDED` — 정지된 스토어에는 사이트를 만들 수 없다
  * - 409 `STOREFRONT_VERSION_NOT_READY` — 빌드가 끝나지 않았거나 실패한 버전은 발행할 수 없다
  * - 409 `STOREFRONT_NO_ROLLBACK_TARGET` — 되돌릴 이전 발행 버전이 없다
+ * - 409 `TEMPLATE_CHANGE_NOT_SUPPORTED` — 템플릿 변경(`POST /v1/storefront/site/template`, 폐기)은 항상 이 오류다
  * - 400 `STOREFRONT_SLUG_CONFIRM_MISMATCH` — 호스팅 끄기 확인 입력이 현재 슬러그와 다르다
  * - 503 `STOREFRONT_PREVIEW_NOT_CONFIGURED` — 미리보기 서명 키가 설정되지 않았다
  *
@@ -6041,6 +6043,16 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
  * - 409 `STOREFRONT_BUILD_IN_PROGRESS` — 이 사이트에 끝나지 않은 빌드가 있다(사이트당 하나)
  * - 404 `STOREFRONT_BUILD_NOT_FOUND`
  * - 502 `STOREFRONT_SANDBOX_UNAVAILABLE` — 편집 Sandbox 호출이 실패했다. 잠시 뒤 다시 한다
+ *
+ * 소스 내려받기·올리기(#60, `/v1/storefront/site/source/**`, `sayren` CLI):
+ * - 409 `SOURCE_CHANGED` — 작업 트리가 내려받은 뒤(`expectedBaseRef`) 바뀌었다(콘솔·AI 편집). `error.details.currentRef`
+ * - 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 }]`)
+ * - 413 `SOURCE_TOO_MANY_NEW_FILES` — 한 번에 새 내용이 800개를 넘는다(`error.details.max`). 나눠서 바꾼다
+ * - 400 `DEPENDENCY_FILES_MISMATCH` — `packageJson`·`lockfile` 내용이 목록의 해시와 다르거나 빠졌다
+ * - 400 `INVALID_SOURCE_REF` · `BLOB_HASH_MISMATCH` · `INVALID_FILE_PATH`(`.env*`·작업 트리 밖 경로)
+ * - 404 `STOREFRONT_SOURCE_NOT_FOUND` — 그 스냅샷이 없다
  */
 /**
  * 슬러그 형식 — 스토어 코드와 같은 DNS 라벨 규칙(소문자·숫자·하이픈 3~30자, 하이픈으로 시작·끝 불가)에
@@ -6111,6 +6123,7 @@ export declare const storefrontVersionSchema: z.ZodObject<{
   }>;
   buildId: z.ZodNullable<z.ZodString>;
   createdByType: z.ZodString;
+  createdVia: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   createdAt: z.ZodString;
 }, z.core.$strip>;
 export type StorefrontVersion = z.infer<typeof storefrontVersionSchema>;
@@ -6166,7 +6179,7 @@ export declare const storefrontEditPreviewSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type StorefrontEditPreview = z.infer<typeof storefrontEditPreviewSchema>;
 /**
- * 사이트 정지 — 운영 정책에 따라 플랫폼 운영자가 사이트를 정지한다. 정지 중에는 방문자에게 정지 안내가 보이고 발행·되돌리기·템플릿 변경·
+ * 사이트 정지 — 운영 정책에 따라 플랫폼 운영자가 사이트를 정지한다. 정지 중에는 방문자에게 정지 안내가 보이고 발행·되돌리기·
  * 공개 전환·슬러그 변경·끄기·편집이 409 `STOREFRONT_SITE_NOT_ACTIVE`다. 셀러가 풀 수 없다(고객센터로 문의한다).
  */
 export declare const storefrontSuspensionSchema: z.ZodObject<{
@@ -6225,6 +6238,7 @@ export declare const storefrontSiteSchema: z.ZodObject<{
     }>;
     buildId: z.ZodNullable<z.ZodString>;
     createdByType: z.ZodString;
+    createdVia: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodString;
   }, z.core.$strip>>;
   provisioning: z.ZodObject<{
@@ -6304,6 +6318,7 @@ export declare const storefrontHostingSchema: z.ZodObject<{
       }>;
       buildId: z.ZodNullable<z.ZodString>;
       createdByType: z.ZodString;
+      createdVia: z.ZodOptional<z.ZodNullable<z.ZodString>>;
       createdAt: z.ZodString;
     }, z.core.$strip>>;
     provisioning: z.ZodObject<{
@@ -6339,16 +6354,88 @@ export declare const storefrontSlugAvailabilitySchema: z.ZodObject<{
   }>>;
 }, z.core.$strip>;
 export type StorefrontSlugAvailability = z.infer<typeof storefrontSlugAvailabilitySchema>;
+/**
+ * 배포 진행 — 사이트의 지금 발행 상태가 공개 주소에 반영되기까지의 단계와 기록이다(콘솔의 스토어프론트 만들기 3단계가 폴링한다).
+ * 만들기(`POST /v1/storefront/site`)는 곧바로 201로 답하고 반영은 그 뒤에 비동기로 하므로, 끝났는지는 이 조회로 본다.
+ * 템플릿 사이트는 미리 빌드한 템플릿 산출물을 올리므로 빌드 단계가 없다. 기록은 사이트 상태에서 만든 요약이다.
+ */
+export declare const storefrontDeploymentStepSchema: z.ZodObject<{
+  key: z.ZodEnum<{
+    SITE: "SITE";
+    UPLOAD: "UPLOAD";
+    PUBLISH: "PUBLISH";
+  }>;
+  status: z.ZodEnum<{
+    PENDING: "PENDING";
+    FAILED: "FAILED";
+    RUNNING: "RUNNING";
+    DONE: "DONE";
+  }>;
+  finishedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type StorefrontDeploymentStep = z.infer<typeof storefrontDeploymentStepSchema>;
+export declare const storefrontDeploymentLogSchema: z.ZodObject<{
+  at: z.ZodNullable<z.ZodString>;
+  level: z.ZodEnum<{
+    INFO: "INFO";
+    WARN: "WARN";
+    ERROR: "ERROR";
+  }>;
+  code: z.ZodString;
+  message: z.ZodString;
+}, z.core.$strip>;
+export type StorefrontDeploymentLog = z.infer<typeof storefrontDeploymentLogSchema>;
+export declare const storefrontDeploymentSchema: z.ZodObject<{
+  siteId: z.ZodString;
+  status: z.ZodEnum<{
+    FAILED: "FAILED";
+    SUCCEEDED: "SUCCEEDED";
+    IN_PROGRESS: "IN_PROGRESS";
+  }>;
+  url: z.ZodString;
+  startedAt: z.ZodString;
+  finishedAt: z.ZodNullable<z.ZodString>;
+  steps: z.ZodArray<z.ZodObject<{
+    key: z.ZodEnum<{
+      SITE: "SITE";
+      UPLOAD: "UPLOAD";
+      PUBLISH: "PUBLISH";
+    }>;
+    status: z.ZodEnum<{
+      PENDING: "PENDING";
+      FAILED: "FAILED";
+      RUNNING: "RUNNING";
+      DONE: "DONE";
+    }>;
+    finishedAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  log: z.ZodArray<z.ZodObject<{
+    at: z.ZodNullable<z.ZodString>;
+    level: z.ZodEnum<{
+      INFO: "INFO";
+      WARN: "WARN";
+      ERROR: "ERROR";
+    }>;
+    code: z.ZodString;
+    message: z.ZodString;
+  }, z.core.$strip>>;
+  errorCode: z.ZodNullable<z.ZodString>;
+  attempts: z.ZodNumber;
+  nextAttemptAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type StorefrontDeployment = z.infer<typeof storefrontDeploymentSchema>;
 export declare const createStorefrontSiteRequestSchema: z.ZodObject<{
   templateId: z.ZodString;
   slug: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type CreateStorefrontSiteRequest = z.infer<typeof createStorefrontSiteRequestSchema>;
+/** @deprecated 템플릿 변경은 지원하지 않는다(항상 409 `TEMPLATE_CHANGE_NOT_SUPPORTED`). 호환을 위해 스키마만 남겼다 */
 export declare const changeStorefrontTemplateRequestSchema: z.ZodObject<{
   templateId: z.ZodString;
   publish: z.ZodOptional<z.ZodBoolean>;
   message: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
+/** @deprecated 템플릿 변경은 지원하지 않는다 */
 export type ChangeStorefrontTemplateRequest = z.infer<typeof changeStorefrontTemplateRequestSchema>;
 /**
  * 발행·되돌리기 — 발행은 사이트의 발행 포인터를 바꾸는 조건부 쓰기다. `expectedPublishedVersionId`를 주면
@@ -6401,6 +6488,146 @@ export declare const storefrontPreviewLinkSchema: z.ZodObject<{
   expiresAt: z.ZodString;
 }, z.core.$strip>;
 export type StorefrontPreviewLink = z.infer<typeof storefrontPreviewLinkSchema>;
+/**
+ * 연결할 수 없는 도메인 — 플랫폼이 쓰는 도메인과 그 하위(기본 주소는 슬러그로 바꾼다). 호스팅 도메인은 서버 설정이라
+ * `storefrontCustomHostnameProblem`의 인자로 따로 받는다.
+ */
+export declare const STOREFRONT_PLATFORM_DOMAINS: readonly string[];
+/**
+ * 공용 접미사 — 누구나 그 아래 이름을 받는 도메인이라 접미사 자체는 연결할 수 없다. Public Suffix List 전체가 아니라 자주 틀리는
+ * 것만 둔다(여기 없는 접미사도 TXT 소유 확인을 통과할 수 없어 연결되지 않는다 — 이 목록은 추가 단계에서 빨리 알려 주는 안내다).
+ */
+export declare const STOREFRONT_PUBLIC_SUFFIXES: readonly string[];
+/** 스토어당 연결할 수 있는 도메인 수 기본값 — 요금제(#44) 전의 상한이다. 실제 값은 `GET …/domains`의 `limit` */
+export declare const STOREFRONT_CUSTOM_DOMAIN_LIMIT_DEFAULT = 2;
+/** DNS를 넣을 때까지 기다리는 기간(일) — 지나면 `FAILED`(`DNS_NOT_CONFIGURED`) */
+export declare const STOREFRONT_DOMAIN_DNS_WAIT_DAYS = 7;
+/** 연결된 도메인의 DNS가 이 서비스를 가리키지 않아도 연결을 유지하는 기간(일) — 지나면 서버가 해제한다 */
+export declare const STOREFRONT_DOMAIN_DNS_GRACE_DAYS = 7;
+/** 소유 확인 TXT 레코드의 이름 앞부분 — `_sayren-verify.{도메인}` */
+export declare const STOREFRONT_DOMAIN_TXT_LABEL = "_sayren-verify";
+/**
+ * 도메인 정규화 — 앞뒤 공백·끝 점을 떼고 소문자로 바꾸며 국제화 도메인은 punycode(`xn--`)로 바꾼다. 스킴·경로·포트가 붙은 입력
+ * (`https://www.a.com/`)은 호스트만 남기지 않고 그대로 두어 형식 검사에서 떨어진다(서버는 사용자가 적은 도메인만 받는다).
+ * 변환할 수 없으면 입력을 소문자로만 바꿔 돌려준다(형식 검사가 거부한다).
+ */
+export declare function normalizeStorefrontHostname(input: string): string;
+export type StorefrontHostnameProblem = "FORMAT" | "IP_ADDRESS" | "SINGLE_LABEL" | "NON_PUBLIC_TLD" | "PLATFORM_DOMAIN" | "PUBLIC_SUFFIX" | "WILDCARD";
+/**
+ * 연결할 수 있는 도메인인가(정규화한 값 기준). 문제가 없으면 null이다. 규칙: 253자 이하, 라벨 2개 이상, 라벨은 소문자·숫자·하이픈
+ * 63자 이하(하이픈으로 시작·끝 불가), 최상위 도메인은 영문자이거나 punycode, IP 주소·와일드카드·공개 인터넷 밖 최상위 도메인·
+ * 플랫폼 도메인과 그 하위·공용 접미사 자체는 안 된다. 제어·디스패치 Worker가 형식 규칙의 복제본을 들고 있다(api
+ * `test/storefront-hosting-parity.spec.ts`가 대조한다).
+ */
+export declare function storefrontCustomHostnameProblem(hostname: string, hostingDomain?: string): StorefrontHostnameProblem | null;
+/** 소유 확인 TXT 레코드의 전체 이름 */
+export declare function storefrontDomainTxtNameOf(hostname: string): string;
+export declare const storefrontCustomDomainStatusSchema: z.ZodEnum<{
+  ACTIVE: "ACTIVE";
+  FAILED: "FAILED";
+  PENDING_DNS: "PENDING_DNS";
+  PENDING_VALIDATION: "PENDING_VALIDATION";
+}>;
+export type StorefrontCustomDomainStatus = z.infer<typeof storefrontCustomDomainStatusSchema>;
+export declare const storefrontDnsRecordSchema: z.ZodObject<{
+  type: z.ZodEnum<{
+    CNAME: "CNAME";
+    TXT: "TXT";
+  }>;
+  name: z.ZodString;
+  value: z.ZodString;
+  purpose: z.ZodEnum<{
+    ROUTING: "ROUTING";
+    OWNERSHIP: "OWNERSHIP";
+  }>;
+}, z.core.$strip>;
+export type StorefrontDnsRecord = z.infer<typeof storefrontDnsRecordSchema>;
+export declare const storefrontSiteDomainSchema: z.ZodObject<{
+  domainId: z.ZodString;
+  hostname: z.ZodString;
+  kind: z.ZodEnum<{
+    PLATFORM: "PLATFORM";
+    CUSTOM: "CUSTOM";
+  }>;
+  status: z.ZodEnum<{
+    ACTIVE: "ACTIVE";
+    FAILED: "FAILED";
+    PENDING_DNS: "PENDING_DNS";
+    PENDING_VALIDATION: "PENDING_VALIDATION";
+  }>;
+  isPrimary: z.ZodBoolean;
+  dnsRecords: z.ZodArray<z.ZodObject<{
+    type: z.ZodEnum<{
+      CNAME: "CNAME";
+      TXT: "TXT";
+    }>;
+    name: z.ZodString;
+    value: z.ZodString;
+    purpose: z.ZodEnum<{
+      ROUTING: "ROUTING";
+      OWNERSHIP: "OWNERSHIP";
+    }>;
+  }, z.core.$strip>>;
+  certificateStatus: z.ZodNullable<z.ZodEnum<{
+    ACTIVE: "ACTIVE";
+    PENDING: "PENDING";
+    FAILED: "FAILED";
+  }>>;
+  failureCode: z.ZodNullable<z.ZodString>;
+  verifiedAt: z.ZodNullable<z.ZodString>;
+  activatedAt: z.ZodNullable<z.ZodString>;
+  checkedAt: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+export type StorefrontSiteDomain = z.infer<typeof storefrontSiteDomainSchema>;
+/** `GET /v1/storefront/site/domains` — 사이트의 주소 목록(기본 주소 + 내 도메인)과 연결 설정 */
+export declare const storefrontSiteDomainsSchema: z.ZodObject<{
+  enabled: z.ZodBoolean;
+  limit: z.ZodNumber;
+  target: z.ZodString;
+  domains: z.ZodArray<z.ZodObject<{
+    domainId: z.ZodString;
+    hostname: z.ZodString;
+    kind: z.ZodEnum<{
+      PLATFORM: "PLATFORM";
+      CUSTOM: "CUSTOM";
+    }>;
+    status: z.ZodEnum<{
+      ACTIVE: "ACTIVE";
+      FAILED: "FAILED";
+      PENDING_DNS: "PENDING_DNS";
+      PENDING_VALIDATION: "PENDING_VALIDATION";
+    }>;
+    isPrimary: z.ZodBoolean;
+    dnsRecords: z.ZodArray<z.ZodObject<{
+      type: z.ZodEnum<{
+        CNAME: "CNAME";
+        TXT: "TXT";
+      }>;
+      name: z.ZodString;
+      value: z.ZodString;
+      purpose: z.ZodEnum<{
+        ROUTING: "ROUTING";
+        OWNERSHIP: "OWNERSHIP";
+      }>;
+    }, z.core.$strip>>;
+    certificateStatus: z.ZodNullable<z.ZodEnum<{
+      ACTIVE: "ACTIVE";
+      PENDING: "PENDING";
+      FAILED: "FAILED";
+    }>>;
+    failureCode: z.ZodNullable<z.ZodString>;
+    verifiedAt: z.ZodNullable<z.ZodString>;
+    activatedAt: z.ZodNullable<z.ZodString>;
+    checkedAt: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type StorefrontSiteDomains = z.infer<typeof storefrontSiteDomainsSchema>;
+export declare const addStorefrontDomainRequestSchema: z.ZodObject<{
+  hostname: z.ZodString;
+}, z.core.$strip>;
+export type AddStorefrontDomainRequest = z.infer<typeof addStorefrontDomainRequestSchema>;
 /** 플랫폼 전체 동시 편집 환경 상한 */
 export declare const STOREFRONT_EDIT_CAPACITY = 20;
 /** 활동이 없으면 편집 환경이 잠드는 시간(분). 작업 트리는 보존된다 */
@@ -6443,16 +6670,16 @@ export declare const storefrontFileEncodingSchema: z.ZodEnum<{
  * 90초). `RUNNING`이면 미리보기와 파일 쓰기가 바로 반영된다(HMR).
  */
 export declare const storefrontEditSessionStatusSchema: z.ZodEnum<{
-  STARTING: "STARTING";
   RUNNING: "RUNNING";
+  STARTING: "STARTING";
 }>;
 /** 편집 환경을 띄우는 단계 — 콘솔 진행 표시용이다. 값은 늘어날 수 있다 */
 export declare const STOREFRONT_EDIT_START_STAGES: readonly ["CONTAINER", "RESTORE", "DEV_SERVER"];
 export declare const storefrontEditSessionSchema: z.ZodObject<{
   sessionId: z.ZodString;
   status: z.ZodEnum<{
-    STARTING: "STARTING";
     RUNNING: "RUNNING";
+    STARTING: "STARTING";
   }>;
   startStage: z.ZodNullable<z.ZodString>;
   startedAt: z.ZodString;
@@ -6468,8 +6695,8 @@ export declare const storefrontEditingSchema: z.ZodObject<{
   session: z.ZodNullable<z.ZodObject<{
     sessionId: z.ZodString;
     status: z.ZodEnum<{
-      STARTING: "STARTING";
       RUNNING: "RUNNING";
+      STARTING: "STARTING";
     }>;
     startStage: z.ZodNullable<z.ZodString>;
     startedAt: z.ZodString;
@@ -6673,7 +6900,7 @@ export declare const storefrontRuleResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type StorefrontRuleResult = z.infer<typeof storefrontRuleResultSchema>;
 /**
- * 규칙 검증 보고서 — `@sayren/mcp`의 `verify_storefront`와 같은 모양이다(원천 `apps/mcp/src/verify.ts`). 위반마다
+ * 규칙 검증 보고서 — `@sayren/mcp`의 `verify_storefront`와 같은 모양이다(원천 `packages/mcp/src/verify.ts`). 위반마다
  * 고칠 자리(`file`·`line`)와 방법(`fix`·`example`)을 싣는다. `POST /v1/storefront/site/verify`(편집 환경이 잠들어 있어도
  * 된다)와 빌드의 `verify`가 이 모양이다.
  */
@@ -6731,9 +6958,58 @@ export type StorefrontBuildStatus = z.infer<typeof storefrontBuildStatusSchema>;
 export declare const STOREFRONT_BUILD_TERMINAL_STATUSES: readonly StorefrontBuildStatus[];
 /**
  * 빌드 단계 — 이 순서로 돈다. 첫 실패에서 멈추지만 규칙 검증(`VERIFY`)은 실패해도 타입 검사까지 이어서 해 한 번에 알려 준다.
- * `UPLOAD`는 사이트 버전 Worker 업로드다(성공하면 발행할 수 있다). 값은 늘어날 수 있다.
+ * `UPLOAD`는 사이트 버전 Worker 업로드다(성공하면 발행할 수 있다). `DEPENDENCIES`는 빌드 시작 전 의존성 검사(거절 목록·보안 권고)다.
+ * 값은 늘어날 수 있다.
+ */
+export declare const STOREFRONT_BUILD_STAGES: readonly ["DEPENDENCIES", "VERIFY", "RESTORE", "INSTALL", "TYPECHECK", "BUILD", "BUNDLE", "PACK", "UPLOAD"];
+/**
+ * 의존성 검사 결과 한 줄(#61) — 거절(`DEPENDENCY_REJECTED`의 `details.rejected`)·경고(빌드 `dependencies`, 소스 교체 `dependencyWarnings`)가
+ * 같은 모양이다. 대상 패키지와 사유. 셀러가 고칠 수 있게 버전·권고 id·거절 사유를 싣는다.
+ * `reason`: `DENYLISTED`(거절 목록) · `ADVISORY`(보안 권고) · `MALWARE`(악성 코드 권고, 패키지 전체) · `INSTALL_SCRIPT`(루트
+ * package.json의 설치 훅·의존성의 설치 스크립트, 경고) · `INSTALL_CONFIG`(설치 방식 필드, 경고) · `UNSUPPORTED_SOURCE`(레지스트리 밖 설치 경로) · `BUNDLED_DEPENDENCIES`(묶여
+ * 오는 의존성, 경고) · `INVALID_MANIFEST`(package.json·잠금 파일 형식), 늘어날 수 있다.
  */
-export declare const STOREFRONT_BUILD_STAGES: readonly ["VERIFY", "RESTORE", "INSTALL", "TYPECHECK", "BUILD", "BUNDLE", "PACK", "UPLOAD"];
+export declare const storefrontDependencyFindingSchema: z.ZodObject<{
+  name: z.ZodString;
+  version: z.ZodNullable<z.ZodString>;
+  reason: z.ZodString;
+  detail: z.ZodString;
+  advisory: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    id: z.ZodString;
+    url: z.ZodNullable<z.ZodString>;
+    severity: z.ZodString;
+    title: z.ZodString;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type StorefrontDependencyFinding = z.infer<typeof storefrontDependencyFindingSchema>;
+export declare const storefrontBuildDependenciesSchema: z.ZodObject<{
+  checkedPackages: z.ZodNumber;
+  rejected: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodNullable<z.ZodString>;
+    reason: z.ZodString;
+    detail: z.ZodString;
+    advisory: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      id: z.ZodString;
+      url: z.ZodNullable<z.ZodString>;
+      severity: z.ZodString;
+      title: z.ZodString;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>;
+  warnings: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodNullable<z.ZodString>;
+    reason: z.ZodString;
+    detail: z.ZodString;
+    advisory: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      id: z.ZodString;
+      url: z.ZodNullable<z.ZodString>;
+      severity: z.ZodString;
+      title: z.ZodString;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type StorefrontBuildDependencies = z.infer<typeof storefrontBuildDependenciesSchema>;
 export declare const storefrontBuildSchema: z.ZodObject<{
   buildId: z.ZodString;
   versionId: z.ZodString;
@@ -6794,6 +7070,33 @@ export declare const storefrontBuildSchema: z.ZodObject<{
     message: z.ZodString;
     nextSteps: z.ZodArray<z.ZodString>;
   }, z.core.$strip>>;
+  dependencies: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    checkedPackages: z.ZodNumber;
+    rejected: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      version: z.ZodNullable<z.ZodString>;
+      reason: z.ZodString;
+      detail: z.ZodString;
+      advisory: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodNullable<z.ZodString>;
+        severity: z.ZodString;
+        title: z.ZodString;
+      }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    warnings: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      version: z.ZodNullable<z.ZodString>;
+      reason: z.ZodString;
+      detail: z.ZodString;
+      advisory: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodNullable<z.ZodString>;
+        severity: z.ZodString;
+        title: z.ZodString;
+      }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>>;
   queuedAt: z.ZodString;
   startedAt: z.ZodNullable<z.ZodString>;
   finishedAt: z.ZodNullable<z.ZodString>;
@@ -6809,6 +7112,7 @@ export declare const storefrontBuildListQuerySchema: z.ZodObject<{
  */
 export declare const createStorefrontVersionRequestSchema: z.ZodObject<{
   message: z.ZodOptional<z.ZodString>;
+  expectedSourceRef: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type CreateStorefrontVersionRequest = z.infer<typeof createStorefrontVersionRequestSchema>;
 /** 버전 만들기 응답 (201) — 버전은 `BUILDING`, 빌드는 `QUEUED`로 시작한다. 결과는 `GET builds/{buildId}`로 본다 */
@@ -6832,6 +7136,7 @@ export declare const storefrontVersionCreatedSchema: z.ZodObject<{
     }>;
     buildId: z.ZodNullable<z.ZodString>;
     createdByType: z.ZodString;
+    createdVia: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodString;
   }, z.core.$strip>;
   build: z.ZodObject<{
@@ -6894,6 +7199,33 @@ export declare const storefrontVersionCreatedSchema: z.ZodObject<{
       message: z.ZodString;
       nextSteps: z.ZodArray<z.ZodString>;
     }, z.core.$strip>>;
+    dependencies: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      checkedPackages: z.ZodNumber;
+      rejected: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodNullable<z.ZodString>;
+        reason: z.ZodString;
+        detail: z.ZodString;
+        advisory: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+          id: z.ZodString;
+          url: z.ZodNullable<z.ZodString>;
+          severity: z.ZodString;
+          title: z.ZodString;
+        }, z.core.$strip>>>;
+      }, z.core.$strip>>;
+      warnings: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodNullable<z.ZodString>;
+        reason: z.ZodString;
+        detail: z.ZodString;
+        advisory: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+          id: z.ZodString;
+          url: z.ZodNullable<z.ZodString>;
+          severity: z.ZodString;
+          title: z.ZodString;
+        }, z.core.$strip>>>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>>;
     queuedAt: z.ZodString;
     startedAt: z.ZodNullable<z.ZodString>;
     finishedAt: z.ZodNullable<z.ZodString>;
@@ -6910,6 +7242,99 @@ export declare const createStorefrontEditPreviewLinkRequestSchema: z.ZodObject<{
   path: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type CreateStorefrontEditPreviewLinkRequest = CreateStorefrontPreviewLinkRequest;
+/** 압축 파일 조각 하나의 최대 크기(바이트) */
+export declare const STOREFRONT_SOURCE_PART_BYTES: number;
+/** 내용 올리기 한 번의 최대 파일 수 */
+export declare const STOREFRONT_SOURCE_BLOB_BATCH_MAX = 200;
+/** 작업 트리 파일 수 상한 */
+export declare const STOREFRONT_WORKSPACE_MAX_FILES = 2000;
+/** 작업 트리 스냅샷 키 — `sources/{siteId}/{sha256}.tgz` */
+export declare const storefrontSourceRefSchema: z.ZodString;
+/** `GET /v1/storefront/site/source` — 지금 작업 트리(편집 환경이 떠 있으면 지금 내용을 고정한다) */
+export declare const storefrontSourceSchema: z.ZodObject<{
+  siteId: z.ZodString;
+  storeId: z.ZodString;
+  storeCode: z.ZodString;
+  sourceRef: z.ZodString;
+  treeSha256: z.ZodString;
+  files: z.ZodNumber;
+  bytes: z.ZodNumber;
+  archive: z.ZodObject<{
+    format: z.ZodLiteral<"tar+gzip">;
+    bytes: z.ZodNumber;
+    sha256: z.ZodString;
+    parts: z.ZodNumber;
+    partBytes: z.ZodNumber;
+  }, z.core.$strip>;
+  editSessionOpen: z.ZodBoolean;
+}, z.core.$strip>;
+export type StorefrontSource = z.infer<typeof storefrontSourceSchema>;
+export declare const storefrontSourceArchiveQuerySchema: z.ZodObject<{
+  sourceRef: z.ZodString;
+  part: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+/** `GET /v1/storefront/site/source/archive` — 압축 파일 조각 */
+export declare const storefrontSourceArchivePartSchema: z.ZodObject<{
+  sourceRef: z.ZodString;
+  part: z.ZodNumber;
+  parts: z.ZodNumber;
+  offset: z.ZodNumber;
+  bytes: z.ZodNumber;
+  totalBytes: z.ZodNumber;
+  content: z.ZodString;
+}, z.core.$strip>;
+export type StorefrontSourceArchivePart = z.infer<typeof storefrontSourceArchivePartSchema>;
+/** `POST /v1/storefront/site/source/blobs` — 파일 내용 올리기(해시 키, 다시 올려도 안전하다). 작업 트리는 바뀌지 않는다 */
+export declare const uploadStorefrontSourceBlobsRequestSchema: z.ZodObject<{
+  blobs: z.ZodArray<z.ZodObject<{
+    hash: z.ZodString;
+    content: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type UploadStorefrontSourceBlobsRequest = z.infer<typeof uploadStorefrontSourceBlobsRequestSchema>;
+export declare const storefrontSourceBlobsResultSchema: z.ZodObject<{
+  stored: z.ZodNumber;
+  existing: z.ZodNumber;
+}, z.core.$strip>;
+export type StorefrontSourceBlobsResult = z.infer<typeof storefrontSourceBlobsResultSchema>;
+/**
+ * `PUT /v1/storefront/site/source` — 작업 트리 전체를 이 목록으로 바꾼다(없는 경로는 지운다). 전부 아니면 전무다.
+ * `package.json`·`pnpm-lock.yaml`도 바꿀 수 있고 의존성은 허용 목록 안이어야 한다. `.env*`·작업 트리 밖 경로는 받지 않는다.
+ */
+export declare const replaceStorefrontSourceRequestSchema: z.ZodObject<{
+  expectedBaseRef: z.ZodOptional<z.ZodString>;
+  files: z.ZodArray<z.ZodObject<{
+    path: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    hash: z.ZodString;
+    size: z.ZodNumber;
+  }, z.core.$strip>>;
+  endEditSession: z.ZodOptional<z.ZodBoolean>;
+  packageJson: z.ZodOptional<z.ZodString>;
+  lockfile: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ReplaceStorefrontSourceRequest = z.infer<typeof replaceStorefrontSourceRequestSchema>;
+export declare const storefrontSourceReplacedSchema: z.ZodObject<{
+  sourceRef: z.ZodString;
+  previousRef: z.ZodString;
+  treeSha256: z.ZodString;
+  files: z.ZodNumber;
+  bytes: z.ZodNumber;
+  changed: z.ZodBoolean;
+  endedEditSession: z.ZodBoolean;
+  dependencyWarnings: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodNullable<z.ZodString>;
+    reason: z.ZodString;
+    detail: z.ZodString;
+    advisory: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+      id: z.ZodString;
+      url: z.ZodNullable<z.ZodString>;
+      severity: z.ZodString;
+      title: z.ZodString;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type StorefrontSourceReplaced = z.infer<typeof storefrontSourceReplacedSchema>;
 //#endregion
 //#region src/schemas/upload.d.ts
 /**
@@ -7027,8 +7452,14 @@ interface StoreSession {
    * 회전이 실패(만료·재사용 폐기)하면 세션을 clear하고 false. (401 경로는 onUnauthorized→clear가 별도 처리.)
    */
   refresh(): Promise<boolean>;
-  /** 세션/리프레시 키를 지우고 구독자에게 통지한다 */
+  /** 세션/리프레시 키를 지우고 구독자에게 통지한다(서버의 토큰은 그대로다 — 로그아웃은 `logout()`) */
   clear(): void;
+  /**
+   * 로그아웃 — 서버에서 **refresh 토큰(패밀리째)과 access 토큰을 폐기**(`POST /oauth2/revoke`, RFC 7009)한 뒤 세션을 지운다.
+   * refresh를 폐기하지 않으면 쿠키만 지워도 서버의 refresh 패밀리가 절대 만료까지 살아 있어, 새어 나간 refresh 토큰으로
+   * 계속 새 userToken을 받을 수 있다. 폐기 요청 실패(네트워크·이미 무효)는 무시하고 세션은 항상 지운다.
+   */
+  logout(): Promise<void>;
   /** 변경 구독(useSyncExternalStore 소비용) — getToken을 스냅샷으로 쓴다. 해지 함수 반환 */
   subscribe(cb: () => void): () => void;
   /** 현재 userToken (getToken()과 동일 — 게터 형태 소비용) */
@@ -10948,6 +11379,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           buildId: string | null;
           createdByType: string;
           createdAt: string;
+          createdVia?: string | null | undefined;
         } | null;
         provisioning: {
           status: "PENDING" | "FAILED" | "SYNCED";
@@ -10972,7 +11404,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
       available: boolean;
       reason: "RESERVED" | "INVALID" | "TAKEN" | "CURRENT" | null;
     }>;
-    /** `POST /v1/storefront/site` (201) — 템플릿으로 사이트를 만들고 v1을 발행한다. 공개 상태는 오픈 준비 중이다 */
+    /**
+     * `POST /v1/storefront/site` (201) — 템플릿으로 사이트를 만들고 v1을 발행한다. 공개 상태는 오픈 준비 중이다.
+     * 사이트를 만드는 유일한 경로다(스토어를 만들어도 사이트는 생기지 않는다). 템플릿은 여기서만 고른다
+     */
     create: (body: CreateStorefrontSiteRequest) => Promise<{
       siteId: string;
       slug: string;
@@ -11002,6 +11437,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         buildId: string | null;
         createdByType: string;
         createdAt: string;
+        createdVia?: string | null | undefined;
       } | null;
       provisioning: {
         status: "PENDING" | "FAILED" | "SYNCED";
@@ -11019,7 +11455,55 @@ export declare function createStoreClient(options: StoreClientOptions): {
         suspendedAt: string | null;
       } | null | undefined;
     }>;
-    /** `POST /v1/storefront/site/template` — 템플릿을 바꾼다. 새 버전을 만들고 기본으로 곧바로 발행한다 */
+    /** `GET /v1/storefront/site/deployment` — 배포 진행(단계·기록). 만든 뒤 반영이 끝날 때까지 폴링한다 */
+    getDeployment: () => Promise<{
+      siteId: string;
+      status: "FAILED" | "SUCCEEDED" | "IN_PROGRESS";
+      url: string;
+      startedAt: string;
+      finishedAt: string | null;
+      steps: {
+        key: "SITE" | "UPLOAD" | "PUBLISH";
+        status: "PENDING" | "FAILED" | "RUNNING" | "DONE";
+        finishedAt: string | null;
+      }[];
+      log: {
+        at: string | null;
+        level: "INFO" | "WARN" | "ERROR";
+        code: string;
+        message: string;
+      }[];
+      errorCode: string | null;
+      attempts: number;
+      nextAttemptAt: string | null;
+    }>;
+    /** `POST /v1/storefront/site/deployment/retry` (202) — 밀린 반영을 곧바로 다시 시도한다. 이미 반영됐으면 그대로다 */
+    retryDeployment: () => Promise<{
+      siteId: string;
+      status: "FAILED" | "SUCCEEDED" | "IN_PROGRESS";
+      url: string;
+      startedAt: string;
+      finishedAt: string | null;
+      steps: {
+        key: "SITE" | "UPLOAD" | "PUBLISH";
+        status: "PENDING" | "FAILED" | "RUNNING" | "DONE";
+        finishedAt: string | null;
+      }[];
+      log: {
+        at: string | null;
+        level: "INFO" | "WARN" | "ERROR";
+        code: string;
+        message: string;
+      }[];
+      errorCode: string | null;
+      attempts: number;
+      nextAttemptAt: string | null;
+    }>;
+    /**
+     * `POST /v1/storefront/site/template`
+     * @deprecated 템플릿 변경은 지원하지 않는다. 서버가 항상 409 `TEMPLATE_CHANGE_NOT_SUPPORTED`로 답한다 — 템플릿은
+     * 사이트를 만들 때(`create`)만 고른다. 호환을 위해 메서드만 남겼다
+     */
     changeTemplate: (body: ChangeStorefrontTemplateRequest) => Promise<{
       siteId: string;
       slug: string;
@@ -11049,6 +11533,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         buildId: string | null;
         createdByType: string;
         createdAt: string;
+        createdVia?: string | null | undefined;
       } | null;
       provisioning: {
         status: "PENDING" | "FAILED" | "SYNCED";
@@ -11080,6 +11565,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       buildId: string | null;
       createdByType: string;
       createdAt: string;
+      createdVia?: string | null | undefined;
     }[]>;
     /** `POST /v1/storefront/site/versions/{versionId}/publish` — 그 버전을 발행한다(이미 발행돼 있으면 그대로 200) */
     publish: (versionId: string, body?: PublishStorefrontVersionRequest) => Promise<{
@@ -11111,6 +11597,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         buildId: string | null;
         createdByType: string;
         createdAt: string;
+        createdVia?: string | null | undefined;
       } | null;
       provisioning: {
         status: "PENDING" | "FAILED" | "SYNCED";
@@ -11158,6 +11645,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         buildId: string | null;
         createdByType: string;
         createdAt: string;
+        createdVia?: string | null | undefined;
       } | null;
       provisioning: {
         status: "PENDING" | "FAILED" | "SYNCED";
@@ -11205,6 +11693,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         buildId: string | null;
         createdByType: string;
         createdAt: string;
+        createdVia?: string | null | undefined;
       } | null;
       provisioning: {
         status: "PENDING" | "FAILED" | "SYNCED";
@@ -11252,6 +11741,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         buildId: string | null;
         createdByType: string;
         createdAt: string;
+        createdVia?: string | null | undefined;
       } | null;
       provisioning: {
         status: "PENDING" | "FAILED" | "SYNCED";
@@ -11277,6 +11767,101 @@ export declare function createStoreClient(options: StoreClientOptions): {
       url: string;
       expiresAt: string;
     }>;
+    /** `GET /v1/storefront/site/domains` — 주소 목록(기본 주소 + 내 도메인)과 DNS 안내 */
+    listDomains: () => Promise<{
+      enabled: boolean;
+      limit: number;
+      target: string;
+      domains: {
+        domainId: string;
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
+        isPrimary: boolean;
+        dnsRecords: {
+          type: "CNAME" | "TXT";
+          name: string;
+          value: string;
+          purpose: "ROUTING" | "OWNERSHIP";
+        }[];
+        certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
+        failureCode: string | null;
+        verifiedAt: string | null;
+        activatedAt: string | null;
+        checkedAt: string | null;
+        createdAt: string;
+      }[];
+    }>;
+    /**
+     * `POST /v1/storefront/site/domains` (201) — 내 도메인을 추가한다. 응답의 `dnsRecords`를 DNS에 넣으면 서버가 소유를 확인하고
+     * 인증서를 발급한다
+     */
+    addDomain: (body: AddStorefrontDomainRequest) => Promise<{
+      domainId: string;
+      hostname: string;
+      kind: "PLATFORM" | "CUSTOM";
+      status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
+      isPrimary: boolean;
+      dnsRecords: {
+        type: "CNAME" | "TXT";
+        name: string;
+        value: string;
+        purpose: "ROUTING" | "OWNERSHIP";
+      }[];
+      certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
+      failureCode: string | null;
+      verifiedAt: string | null;
+      activatedAt: string | null;
+      checkedAt: string | null;
+      createdAt: string;
+    }>;
+    /** `POST /v1/storefront/site/domains/{domainId}/verify` — DNS를 곧바로 다시 확인한다(실패한 도메인은 처음부터 다시) */
+    verifyDomain: (domainId: string) => Promise<{
+      domainId: string;
+      hostname: string;
+      kind: "PLATFORM" | "CUSTOM";
+      status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
+      isPrimary: boolean;
+      dnsRecords: {
+        type: "CNAME" | "TXT";
+        name: string;
+        value: string;
+        purpose: "ROUTING" | "OWNERSHIP";
+      }[];
+      certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
+      failureCode: string | null;
+      verifiedAt: string | null;
+      activatedAt: string | null;
+      checkedAt: string | null;
+      createdAt: string;
+    }>;
+    /** `POST /v1/storefront/site/domains/{domainId}/primary` — 대표 주소로 지정한다. 다른 주소는 대표 주소로 301한다 */
+    setPrimaryDomain: (domainId: string) => Promise<{
+      enabled: boolean;
+      limit: number;
+      target: string;
+      domains: {
+        domainId: string;
+        hostname: string;
+        kind: "PLATFORM" | "CUSTOM";
+        status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
+        isPrimary: boolean;
+        dnsRecords: {
+          type: "CNAME" | "TXT";
+          name: string;
+          value: string;
+          purpose: "ROUTING" | "OWNERSHIP";
+        }[];
+        certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
+        failureCode: string | null;
+        verifiedAt: string | null;
+        activatedAt: string | null;
+        checkedAt: string | null;
+        createdAt: string;
+      }[];
+    }>;
+    /** `DELETE /v1/storefront/site/domains/{domainId}` — 내 도메인 연결을 해제한다(곧바로 끊긴다) */
+    removeDomain: (domainId: string) => Promise<void>;
     /** `POST /v1/storefront/site/disable` — 호스팅을 끈다(사이트 `CLOSED`, 슬러그 90일 보류). 다시 만들 수 있다 */
     disable: (body: DisableStorefrontHostingRequest) => Promise<{
       siteId: string;
@@ -11307,6 +11892,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         buildId: string | null;
         createdByType: string;
         createdAt: string;
+        createdVia?: string | null | undefined;
       } | null;
       provisioning: {
         status: "PENDING" | "FAILED" | "SYNCED";
@@ -11329,7 +11915,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       enabled: boolean;
       session: {
         sessionId: string;
-        status: "STARTING" | "RUNNING";
+        status: "RUNNING" | "STARTING";
         startStage: string | null;
         startedAt: string;
         lastEditedAt: string | null;
@@ -11357,7 +11943,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       enabled: boolean;
       session: {
         sessionId: string;
-        status: "STARTING" | "RUNNING";
+        status: "RUNNING" | "STARTING";
         startStage: string | null;
         startedAt: string;
         lastEditedAt: string | null;
@@ -11382,7 +11968,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       enabled: boolean;
       session: {
         sessionId: string;
-        status: "STARTING" | "RUNNING";
+        status: "RUNNING" | "STARTING";
         startStage: string | null;
         startedAt: string;
         lastEditedAt: string | null;
@@ -11544,6 +12130,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         buildId: string | null;
         createdByType: string;
         createdAt: string;
+        createdVia?: string | null | undefined;
       };
       build: {
         buildId: string;
@@ -11594,6 +12181,33 @@ export declare function createStoreClient(options: StoreClientOptions): {
         startedAt: string | null;
         finishedAt: string | null;
         durationMs: number | null;
+        dependencies?: {
+          checkedPackages: number;
+          rejected: {
+            name: string;
+            version: string | null;
+            reason: string;
+            detail: string;
+            advisory?: {
+              id: string;
+              url: string | null;
+              severity: string;
+              title: string;
+            } | null | undefined;
+          }[];
+          warnings: {
+            name: string;
+            version: string | null;
+            reason: string;
+            detail: string;
+            advisory?: {
+              id: string;
+              url: string | null;
+              severity: string;
+              title: string;
+            } | null | undefined;
+          }[];
+        } | null | undefined;
       };
     }>;
     /** `GET /v1/storefront/site/builds?limit=` — 빌드 목록(최신 먼저) */
@@ -11648,6 +12262,33 @@ export declare function createStoreClient(options: StoreClientOptions): {
       startedAt: string | null;
       finishedAt: string | null;
       durationMs: number | null;
+      dependencies?: {
+        checkedPackages: number;
+        rejected: {
+          name: string;
+          version: string | null;
+          reason: string;
+          detail: string;
+          advisory?: {
+            id: string;
+            url: string | null;
+            severity: string;
+            title: string;
+          } | null | undefined;
+        }[];
+        warnings: {
+          name: string;
+          version: string | null;
+          reason: string;
+          detail: string;
+          advisory?: {
+            id: string;
+            url: string | null;
+            severity: string;
+            title: string;
+          } | null | undefined;
+        }[];
+      } | null | undefined;
     }[]>;
     /** `GET /v1/storefront/site/builds/{buildId}` — 빌드 상태·실패 단계·로그 꼬리·규칙 결과 */
     getBuild: (buildId: string) => Promise<{
@@ -11699,6 +12340,94 @@ export declare function createStoreClient(options: StoreClientOptions): {
       startedAt: string | null;
       finishedAt: string | null;
       durationMs: number | null;
+      dependencies?: {
+        checkedPackages: number;
+        rejected: {
+          name: string;
+          version: string | null;
+          reason: string;
+          detail: string;
+          advisory?: {
+            id: string;
+            url: string | null;
+            severity: string;
+            title: string;
+          } | null | undefined;
+        }[];
+        warnings: {
+          name: string;
+          version: string | null;
+          reason: string;
+          detail: string;
+          advisory?: {
+            id: string;
+            url: string | null;
+            severity: string;
+            title: string;
+          } | null | undefined;
+        }[];
+      } | null | undefined;
+    }>;
+    /** `GET /v1/storefront/site/source` — 지금 작업 트리를 고정하고 압축 파일(tar.gz) 크기·조각 수를 알린다 */
+    getSource: () => Promise<{
+      siteId: string;
+      storeId: string;
+      storeCode: string;
+      sourceRef: string;
+      treeSha256: string;
+      files: number;
+      bytes: number;
+      archive: {
+        format: "tar+gzip";
+        bytes: number;
+        sha256: string;
+        parts: number;
+        partBytes: number;
+      };
+      editSessionOpen: boolean;
+    }>;
+    /** `GET /v1/storefront/site/source/archive?sourceRef=&part=` — 압축 파일 조각(base64, 4MiB까지) */
+    getSourceArchive: (params: {
+      sourceRef: string;
+      part?: number;
+    }) => Promise<{
+      sourceRef: string;
+      part: number;
+      parts: number;
+      offset: number;
+      bytes: number;
+      totalBytes: number;
+      content: string;
+    }>;
+    /** `POST /v1/storefront/site/source/blobs` — 파일 내용 올리기(해시 키). 작업 트리는 바뀌지 않는다 */
+    uploadSourceBlobs: (body: UploadStorefrontSourceBlobsRequest) => Promise<{
+      stored: number;
+      existing: number;
+    }>;
+    /**
+     * `PUT /v1/storefront/site/source` — 작업 트리 전체를 바꾼다. 409 `SOURCE_CHANGED`(내려받은 뒤 바뀜)·`EDIT_SESSION_OPEN`·
+     * `SOURCE_BLOBS_MISSING`(`details.hashes`를 올리고 다시)
+     */
+    replaceSource: (body: ReplaceStorefrontSourceRequest) => Promise<{
+      sourceRef: string;
+      previousRef: string;
+      treeSha256: string;
+      files: number;
+      bytes: number;
+      changed: boolean;
+      endedEditSession: boolean;
+      dependencyWarnings: {
+        name: string;
+        version: string | null;
+        reason: string;
+        detail: string;
+        advisory?: {
+          id: string;
+          url: string | null;
+          severity: string;
+          title: string;
+        } | null | undefined;
+      }[];
     }>;
   };
   store: {