@sayren/store-sdk 0.21.0 → 0.22.0

package/dist/index.d.mts

@@ -165,8 +165,8 @@ 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";
+  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   ALLOW: "ALLOW";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
@@ -190,8 +190,8 @@ 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";
+    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
     ALLOW: "ALLOW";
   }>;
   reason: z.ZodNullable<z.ZodString>;
@@ -6041,6 +6041,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 +6121,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>;
@@ -6225,6 +6236,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 +6316,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<{
@@ -6401,6 +6414,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;
 /** 활동이 없으면 편집 환경이 잠드는 시간(분). 작업 트리는 보존된다 */
@@ -6731,9 +6884,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 ["VERIFY", "RESTORE", "INSTALL", "TYPECHECK", "BUILD", "BUNDLE", "PACK", "UPLOAD"];
+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의 설치 훅은 거절, 의존성의 설치 스크립트는 경고) · `UNSUPPORTED_SOURCE`(레지스트리 밖 설치 경로) · `BUNDLED_DEPENDENCIES`(묶여
+ * 오는 의존성, 경고) · `INVALID_MANIFEST`(package.json·잠금 파일 형식), 늘어날 수 있다.
+ */
+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 +6996,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 +7038,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 +7062,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 +7125,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 +7168,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
 /**
@@ -10948,6 +11299,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           buildId: string | null;
           createdByType: string;
           createdAt: string;
+          createdVia?: string | null | undefined;
         } | null;
         provisioning: {
           status: "PENDING" | "FAILED" | "SYNCED";
@@ -11002,6 +11354,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         buildId: string | null;
         createdByType: string;
         createdAt: string;
+        createdVia?: string | null | undefined;
       } | null;
       provisioning: {
         status: "PENDING" | "FAILED" | "SYNCED";
@@ -11049,6 +11402,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 +11434,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 +11466,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 +11514,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 +11562,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 +11610,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 +11636,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 +11761,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         buildId: string | null;
         createdByType: string;
         createdAt: string;
+        createdVia?: string | null | undefined;
       } | null;
       provisioning: {
         status: "PENDING" | "FAILED" | "SYNCED";
@@ -11544,6 +11999,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         buildId: string | null;
         createdByType: string;
         createdAt: string;
+        createdVia?: string | null | undefined;
       };
       build: {
         buildId: string;
@@ -11594,6 +12050,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 +12131,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 +12209,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: {