@sayren/store-sdk 0.21.0 → 0.23.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/store-sdk",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "exports": {

package/src/client.ts

@@ -230,6 +230,8 @@ import {
   updateStoreRequestSchema,
 } from "./schemas/store";
 import {
+  type AddStorefrontDomainRequest,
+  addStorefrontDomainRequestSchema,
   type ChangeStorefrontSlugRequest,
   type ChangeStorefrontTemplateRequest,
   type CreateStorefrontEditPreviewLinkRequest,
@@ -250,8 +252,10 @@ import {
   moveStorefrontFileRequestSchema,
   type PublishStorefrontVersionRequest,
   publishStorefrontVersionRequestSchema,
+  type ReplaceStorefrontSourceRequest,
   type RollbackStorefrontRequest,
   type RunStorefrontCheckRequest,
+  replaceStorefrontSourceRequestSchema,
   rollbackStorefrontRequestSchema,
   runStorefrontCheckRequestSchema,
   type SearchStorefrontFilesRequest,
@@ -260,6 +264,7 @@ import {
   setStorefrontVisibilityRequestSchema,
   storefrontBuildSchema,
   storefrontCheckSchema,
+  storefrontDeploymentSchema,
   storefrontEditingSchema,
   storefrontFileContentSchema,
   storefrontFileDeleteResultSchema,
@@ -269,12 +274,21 @@ import {
   storefrontFileWriteResultSchema,
   storefrontHostingSchema,
   storefrontPreviewLinkSchema,
+  storefrontSiteDomainSchema,
+  storefrontSiteDomainsSchema,
   storefrontSiteSchema,
   storefrontSlugAvailabilitySchema,
+  storefrontSourceArchivePartSchema,
+  storefrontSourceArchiveQuerySchema,
+  storefrontSourceBlobsResultSchema,
+  storefrontSourceReplacedSchema,
+  storefrontSourceSchema,
   storefrontTemplateSchema,
   storefrontVerifyReportSchema,
   storefrontVersionCreatedSchema,
   storefrontVersionSchema,
+  type UploadStorefrontSourceBlobsRequest,
+  uploadStorefrontSourceBlobsRequestSchema,
   type WriteStorefrontFilesRequest,
   writeStorefrontFilesRequestSchema,
 } from "./schemas/storefront-hosting";
@@ -1345,12 +1359,27 @@ export function createStoreClient(options: StoreClientOptions) {
             query: { slug },
           },
         ),
-      /** `POST /v1/storefront/site` (201) — 템플릿으로 사이트를 만들고 v1을 발행한다. 공개 상태는 오픈 준비 중이다 */
+      /**
+       * `POST /v1/storefront/site` (201) — 템플릿으로 사이트를 만들고 v1을 발행한다. 공개 상태는 오픈 준비 중이다.
+       * 사이트를 만드는 유일한 경로다(스토어를 만들어도 사이트는 생기지 않는다). 템플릿은 여기서만 고른다
+       */
       create: (body: CreateStorefrontSiteRequest) =>
         storeHttp.request("POST", "/storefront/site", storefrontSiteSchema, {
           body: createStorefrontSiteRequestSchema.parse(body),
         }),
-      /** `POST /v1/storefront/site/template` — 템플릿을 바꾼다. 새 버전을 만들고 기본으로 곧바로 발행한다 */
+      /** `GET /v1/storefront/site/deployment` — 배포 진행(단계·기록). 만든 뒤 반영이 끝날 때까지 폴링한다 */
+      getDeployment: () =>
+        storeHttp.request("GET", "/storefront/site/deployment", storefrontDeploymentSchema),
+      /** `POST /v1/storefront/site/deployment/retry` (202) — 밀린 반영을 곧바로 다시 시도한다. 이미 반영됐으면 그대로다 */
+      retryDeployment: () =>
+        storeHttp.request("POST", "/storefront/site/deployment/retry", storefrontDeploymentSchema, {
+          body: {},
+        }),
+      /**
+       * `POST /v1/storefront/site/template`
+       * @deprecated 템플릿 변경은 지원하지 않는다. 서버가 항상 409 `TEMPLATE_CHANGE_NOT_SUPPORTED`로 답한다 — 템플릿은
+       * 사이트를 만들 때(`create`)만 고른다. 호환을 위해 메서드만 남겼다
+       */
       changeTemplate: (body: ChangeStorefrontTemplateRequest) =>
         storeHttp.request("POST", "/storefront/site/template", storefrontSiteSchema, {
           body: changeStorefrontTemplateRequestSchema.parse(body),
@@ -1389,6 +1418,34 @@ export function createStoreClient(options: StoreClientOptions) {
         storeHttp.request("POST", "/storefront/site/preview-link", storefrontPreviewLinkSchema, {
           body: createStorefrontPreviewLinkRequestSchema.parse(body),
         }),
+      /** `GET /v1/storefront/site/domains` — 주소 목록(기본 주소 + 내 도메인)과 DNS 안내 */
+      listDomains: () =>
+        storeHttp.request("GET", "/storefront/site/domains", storefrontSiteDomainsSchema),
+      /**
+       * `POST /v1/storefront/site/domains` (201) — 내 도메인을 추가한다. 응답의 `dnsRecords`를 DNS에 넣으면 서버가 소유를 확인하고
+       * 인증서를 발급한다
+       */
+      addDomain: (body: AddStorefrontDomainRequest) =>
+        storeHttp.request("POST", "/storefront/site/domains", storefrontSiteDomainSchema, {
+          body: addStorefrontDomainRequestSchema.parse(body),
+        }),
+      /** `POST /v1/storefront/site/domains/{domainId}/verify` — DNS를 곧바로 다시 확인한다(실패한 도메인은 처음부터 다시) */
+      verifyDomain: (domainId: string) =>
+        storeHttp.request(
+          "POST",
+          path`/storefront/site/domains/${domainId}/verify`,
+          storefrontSiteDomainSchema,
+        ),
+      /** `POST /v1/storefront/site/domains/{domainId}/primary` — 대표 주소로 지정한다. 다른 주소는 대표 주소로 301한다 */
+      setPrimaryDomain: (domainId: string) =>
+        storeHttp.request(
+          "POST",
+          path`/storefront/site/domains/${domainId}/primary`,
+          storefrontSiteDomainsSchema,
+        ),
+      /** `DELETE /v1/storefront/site/domains/{domainId}` — 내 도메인 연결을 해제한다(곧바로 끊긴다) */
+      removeDomain: (domainId: string) =>
+        storeHttp.requestVoid("DELETE", path`/storefront/site/domains/${domainId}`),
       /** `POST /v1/storefront/site/disable` — 호스팅을 끈다(사이트 `CLOSED`, 슬러그 90일 보류). 다시 만들 수 있다 */
       disable: (body: DisableStorefrontHostingRequest) =>
         storeHttp.request("POST", "/storefront/site/disable", storefrontSiteSchema, {
@@ -1495,6 +1552,35 @@ export function createStoreClient(options: StoreClientOptions) {
       /** `GET /v1/storefront/site/builds/{buildId}` — 빌드 상태·실패 단계·로그 꼬리·규칙 결과 */
       getBuild: (buildId: string) =>
         storeHttp.request("GET", path`/storefront/site/builds/${buildId}`, storefrontBuildSchema),
+
+      // ─── 소스 내려받기·올리기 (#60, `sayren` CLI) ───
+
+      /** `GET /v1/storefront/site/source` — 지금 작업 트리를 고정하고 압축 파일(tar.gz) 크기·조각 수를 알린다 */
+      getSource: () => storeHttp.request("GET", "/storefront/site/source", storefrontSourceSchema),
+      /** `GET /v1/storefront/site/source/archive?sourceRef=&part=` — 압축 파일 조각(base64, 4MiB까지) */
+      getSourceArchive: (params: { sourceRef: string; part?: number }) =>
+        storeHttp.request(
+          "GET",
+          "/storefront/site/source/archive",
+          storefrontSourceArchivePartSchema,
+          { query: storefrontSourceArchiveQuerySchema.parse(params) as Query },
+        ),
+      /** `POST /v1/storefront/site/source/blobs` — 파일 내용 올리기(해시 키). 작업 트리는 바뀌지 않는다 */
+      uploadSourceBlobs: (body: UploadStorefrontSourceBlobsRequest) =>
+        storeHttp.request(
+          "POST",
+          "/storefront/site/source/blobs",
+          storefrontSourceBlobsResultSchema,
+          { body: uploadStorefrontSourceBlobsRequestSchema.parse(body) },
+        ),
+      /**
+       * `PUT /v1/storefront/site/source` — 작업 트리 전체를 바꾼다. 409 `SOURCE_CHANGED`(내려받은 뒤 바뀜)·`EDIT_SESSION_OPEN`·
+       * `SOURCE_BLOBS_MISSING`(`details.hashes`를 올리고 다시)
+       */
+      replaceSource: (body: ReplaceStorefrontSourceRequest) =>
+        storeHttp.request("PUT", "/storefront/site/source", storefrontSourceReplacedSchema, {
+          body: replaceStorefrontSourceRequestSchema.parse(body),
+        }),
     },
 
     store: {