@sayren/store-sdk 0.18.0 → 0.20.0

package/package.json

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

package/src/client.ts

@@ -103,21 +103,6 @@ import {
   type WithdrawCustomerRequest,
   withdrawCustomerRequestSchema,
 } from "./schemas/customer";
-import {
-  type DigitalAssetAttachRequest,
-  digitalAssetAttachRequestSchema,
-  digitalAssetPreviewSchema,
-  digitalAssetSchema,
-} from "./schemas/digital-asset";
-import {
-  type FulfillmentCodeUploadRequest,
-  fulfillmentCodeBatchSchema,
-  type fulfillmentCodeListQuerySchema,
-  fulfillmentCodePageSchema,
-  fulfillmentCodeRevealSchema,
-  fulfillmentCodeSchema,
-  fulfillmentCodeUploadRequestSchema,
-} from "./schemas/fulfillment-code";
 import {
   type LoginProvider,
   loginProviderTestSchema,
@@ -160,7 +145,6 @@ import {
   dispatchRequestSchema,
   type FulfillRequest,
   fulfillBulkRequestSchema,
-  fulfillmentMailResendSchema,
   fulfillRequestSchema,
   type HoldOrderItemRequest,
   holdOrderItemRequestSchema,
@@ -236,6 +220,55 @@ import {
   updateMemberRoleRequestSchema,
   updateStoreRequestSchema,
 } from "./schemas/store";
+import {
+  type ChangeStorefrontSlugRequest,
+  type ChangeStorefrontTemplateRequest,
+  type CreateStorefrontEditPreviewLinkRequest,
+  type CreateStorefrontPreviewLinkRequest,
+  type CreateStorefrontSiteRequest,
+  type CreateStorefrontVersionRequest,
+  changeStorefrontSlugRequestSchema,
+  changeStorefrontTemplateRequestSchema,
+  createStorefrontEditPreviewLinkRequestSchema,
+  createStorefrontPreviewLinkRequestSchema,
+  createStorefrontSiteRequestSchema,
+  createStorefrontVersionRequestSchema,
+  type DeleteStorefrontFileRequest,
+  type DisableStorefrontHostingRequest,
+  deleteStorefrontFileRequestSchema,
+  disableStorefrontHostingRequestSchema,
+  type MoveStorefrontFileRequest,
+  moveStorefrontFileRequestSchema,
+  type PublishStorefrontVersionRequest,
+  publishStorefrontVersionRequestSchema,
+  type RollbackStorefrontRequest,
+  type RunStorefrontCheckRequest,
+  rollbackStorefrontRequestSchema,
+  runStorefrontCheckRequestSchema,
+  type SearchStorefrontFilesRequest,
+  type SetStorefrontVisibilityRequest,
+  searchStorefrontFilesRequestSchema,
+  setStorefrontVisibilityRequestSchema,
+  storefrontBuildSchema,
+  storefrontCheckSchema,
+  storefrontEditingSchema,
+  storefrontFileContentSchema,
+  storefrontFileDeleteResultSchema,
+  storefrontFileListSchema,
+  storefrontFileMoveResultSchema,
+  storefrontFileSearchResultSchema,
+  storefrontFileWriteResultSchema,
+  storefrontHostingSchema,
+  storefrontPreviewLinkSchema,
+  storefrontSiteSchema,
+  storefrontSlugAvailabilitySchema,
+  storefrontTemplateSchema,
+  storefrontVerifyReportSchema,
+  storefrontVersionCreatedSchema,
+  storefrontVersionSchema,
+  type WriteStorefrontFilesRequest,
+  writeStorefrontFilesRequestSchema,
+} from "./schemas/storefront-hosting";
 import {
   type UploadPurpose,
   type UploadRequest,
@@ -473,7 +506,7 @@ export function createStoreClient(options: StoreClientOptions) {
         const put = await fetchFn(ticket.uploadUrl, {
           method: "PUT",
           // 발급 응답의 헤더를 함께 싣는다 — 판매 파일(이슈 #48)은 비공개 헤더가 빠지면 공개 객체가 된다
-          headers: { ...ticket.headers, "content-type": file.type || "application/octet-stream" },
+          headers: { "content-type": file.type || "application/octet-stream" },
           body: file,
         });
         if (!put.ok) {
@@ -536,76 +569,6 @@ export function createStoreClient(options: StoreClientOptions) {
         }),
       removeDiscount: (productId: string) =>
         storeHttp.requestVoid("DELETE", path`/products/${productId}/discount`),
-      /**
-       * 코드 일괄 업로드 (이슈 #48) — 코드 발급·자동 제공 상품의 코드 풀에 올린다. `codes`와 `csv` 중 하나만 보낸다.
-       * 받은 코드 수만큼 재고가 는다. 에러: 409 `NOT_CODE_PRODUCT`·`CODE_POOL_NOT_USED`·`CODE_UPLOAD_CONFLICT`, 400 `TOO_MANY_CODES`
-       */
-      uploadCodes: (
-        productId: string,
-        body: FulfillmentCodeUploadRequest,
-        idempotencyKey?: string,
-      ) =>
-        storeHttp.request("POST", path`/products/${productId}/codes`, fulfillmentCodeBatchSchema, {
-          body: fulfillmentCodeUploadRequestSchema.parse(body),
-          headers: idempotency(idempotencyKey),
-        }),
-      /** 코드 목록 — 가린 값(`hint`)만 싣는다. `available`은 필터와 무관한 판매 가능 코드 수다 */
-      listCodes: (
-        productId: string,
-        params?: PageParams & Omit<z.input<typeof fulfillmentCodeListQuerySchema>, "page" | "size">,
-      ) =>
-        storeHttp.request("GET", path`/products/${productId}/codes`, fulfillmentCodePageSchema, {
-          query: params as Query,
-        }),
-      /** 판매 가능 코드 폐기 — 재고가 1 준다. 배정된 코드는 409 `CODE_NOT_AVAILABLE` */
-      voidCode: (productId: string, codeId: string) =>
-        storeHttp.request(
-          "POST",
-          path`/products/${productId}/codes/${codeId}/void`,
-          fulfillmentCodeSchema,
-        ),
-      /**
-       * 판매 파일 연결 (이슈 #48) — `uploads.create({ purpose: "digital-asset" })`로 받은 `key`에 파일을 올린 뒤 연결한다.
-       * 이후 주문부터 이 파일을 준다. 에러: 400 `INVALID_ASSET_KEY`, 409 `NOT_DOWNLOAD_PRODUCT`·`ASSET_ALREADY_ATTACHED`
-       */
-      attachDigitalAsset: (productId: string, body: DigitalAssetAttachRequest) =>
-        storeHttp.request("POST", path`/products/${productId}/digital-assets`, digitalAssetSchema, {
-          body: digitalAssetAttachRequestSchema.parse(body),
-        }),
-      /** 판매 파일 목록 — 해제한 파일도 싣는다. 객체 키·주소는 없다 */
-      listDigitalAssets: (productId: string) =>
-        storeHttp.request(
-          "GET",
-          path`/products/${productId}/digital-assets`,
-          z.array(digitalAssetSchema),
-        ),
-      /** 판매 파일 해제 — 새 주문에 주지 않는다. 이미 산 구매자는 계속 받는다 */
-      removeDigitalAsset: (productId: string, assetId: string) =>
-        storeHttp.request(
-          "DELETE",
-          path`/products/${productId}/digital-assets/${assetId}`,
-          digitalAssetSchema,
-        ),
-      /** 판매 파일 확인 주소 — 수명 300초의 서명 주소 */
-      previewDigitalAsset: (productId: string, assetId: string) =>
-        storeHttp.request(
-          "POST",
-          path`/products/${productId}/digital-assets/${assetId}/preview-url`,
-          digitalAssetPreviewSchema,
-        ),
-    },
-
-    fulfillmentCodes: {
-      /**
-       * 코드 평문 열람 — 콘솔에서 로그인한 OWNER·ADMIN만 된다(403 `INSUFFICIENT_ROLE`). 열람 기록과 감사 로그가 남는다.
-       * 평문은 화면에 보인 뒤 저장하지 않는다
-       */
-      reveal: (codeId: string) =>
-        storeHttp.request(
-          "POST",
-          path`/fulfillment-codes/${codeId}/reveal`,
-          fulfillmentCodeRevealSchema,
-        ),
     },
 
     categories: {
@@ -732,17 +695,7 @@ export function createStoreClient(options: StoreClientOptions) {
           headers: idempotency(idempotencyKey),
         }),
       /**
-       * 제공 안내 메일 재발송 (이슈 #48) — 제공된 주문상품의 안내 메일을 다시 보낸다. 주문상품당 하루 3회(429).
-       * 코드·파일 주소는 메일에 없다
-       */
-      resendFulfillmentMail: (orderItemId: string) =>
-        storeHttp.request(
-          "POST",
-          path`/order-items/${orderItemId}/fulfillment/mail`,
-          fulfillmentMailResendSchema,
-        ),
-      /**
-       * 제공 처리 (이슈 #48) — 수동 제공 비실물 주문상품(이용권·방문 수령)을 `PAID`·`CONFIRMED`에서 제공 완료(`DELIVERED`)로
+       * 제공 처리 (이슈 #48) — 배송 없는 주문상품(`MANUAL`)을 `PAID`·`CONFIRMED`에서 제공 완료(`DELIVERED`)로
        * 바꾼다. `note`는 구매자 주문 상세에 이용 안내로 실린다. 배송 상품은 409 `SHIPPING_REQUIRED`
        */
       fulfill: (orderItemId: string, body: FulfillRequest = {}, idempotencyKey?: string) =>
@@ -1329,6 +1282,179 @@ export function createStoreClient(options: StoreClientOptions) {
         storeHttp.requestVoid("POST", path`/seller-addresses/${addressId}/default`),
     },
 
+    /**
+     * 스토어프론트 호스팅 (이슈 #53) — 조회 `storefront:r`, 쓰기 `storefront:rw`(OWNER·ADMIN).
+     * 쓰기 응답은 바뀐 사이트다. Cloudflare 반영은 커밋 뒤라 `provisioning.status`가 잠시 `PENDING`일 수 있다.
+     * 에이전트 토큰의 발행·되돌리기·템플릿 변경·공개 전환·슬러그 변경·끄기는 승인 대기(`ApprovalPendingError`)다.
+     */
+    storefront: {
+      /** `GET /v1/storefront/templates` — 템플릿 카탈로그 */
+      listTemplates: () =>
+        storeHttp.request("GET", "/storefront/templates", z.array(storefrontTemplateSchema)),
+      /** `GET /v1/storefront/site` — 스위치 상태와 현재 사이트(없으면 `site: null`) */
+      get: () => storeHttp.request("GET", "/storefront/site", storefrontHostingSchema),
+      /** `GET /v1/storefront/slug-availability?slug=` — 슬러그를 쓸 수 있는가 */
+      checkSlug: (slug: string) =>
+        storeHttp.request(
+          "GET",
+          "/storefront/slug-availability",
+          storefrontSlugAvailabilitySchema,
+          {
+            query: { slug },
+          },
+        ),
+      /** `POST /v1/storefront/site` (201) — 템플릿으로 사이트를 만들고 v1을 발행한다. 공개 상태는 오픈 준비 중이다 */
+      create: (body: CreateStorefrontSiteRequest) =>
+        storeHttp.request("POST", "/storefront/site", storefrontSiteSchema, {
+          body: createStorefrontSiteRequestSchema.parse(body),
+        }),
+      /** `POST /v1/storefront/site/template` — 템플릿을 바꾼다. 새 버전을 만들고 기본으로 곧바로 발행한다 */
+      changeTemplate: (body: ChangeStorefrontTemplateRequest) =>
+        storeHttp.request("POST", "/storefront/site/template", storefrontSiteSchema, {
+          body: changeStorefrontTemplateRequestSchema.parse(body),
+        }),
+      /** `GET /v1/storefront/site/versions` — 버전 목록(최신 먼저) */
+      listVersions: () =>
+        storeHttp.request("GET", "/storefront/site/versions", z.array(storefrontVersionSchema)),
+      /** `POST /v1/storefront/site/versions/{versionId}/publish` — 그 버전을 발행한다(이미 발행돼 있으면 그대로 200) */
+      publish: (versionId: string, body: PublishStorefrontVersionRequest = {}) =>
+        storeHttp.request(
+          "POST",
+          path`/storefront/site/versions/${versionId}/publish`,
+          storefrontSiteSchema,
+          { body: publishStorefrontVersionRequestSchema.parse(body) },
+        ),
+      /** `POST /v1/storefront/site/rollback` — 이전 발행 버전으로 되돌린다(재빌드 없음) */
+      rollback: (body: RollbackStorefrontRequest = {}) =>
+        storeHttp.request("POST", "/storefront/site/rollback", storefrontSiteSchema, {
+          body: rollbackStorefrontRequestSchema.parse(body),
+        }),
+      /** `PUT /v1/storefront/site/slug` — 슬러그를 바꾼다. 옛 슬러그는 90일 보류되고 새 주소로 301한다 */
+      changeSlug: (body: ChangeStorefrontSlugRequest) =>
+        storeHttp.request("PUT", "/storefront/site/slug", storefrontSiteSchema, {
+          body: changeStorefrontSlugRequestSchema.parse(body),
+        }),
+      /** `PUT /v1/storefront/site/visibility` — 오픈 준비 중 ↔ 공개 */
+      setVisibility: (body: SetStorefrontVisibilityRequest) =>
+        storeHttp.request("PUT", "/storefront/site/visibility", storefrontSiteSchema, {
+          body: setStorefrontVisibilityRequestSchema.parse(body),
+        }),
+      /**
+       * `POST /v1/storefront/site/preview-link` — 오픈 준비 중인 사이트를 구성원이 볼 수 있는 5분짜리 링크.
+       * 콘솔에서 로그인한 OWNER·ADMIN만 받는다
+       */
+      createPreviewLink: (body: CreateStorefrontPreviewLinkRequest = {}) =>
+        storeHttp.request("POST", "/storefront/site/preview-link", storefrontPreviewLinkSchema, {
+          body: createStorefrontPreviewLinkRequestSchema.parse(body),
+        }),
+      /** `POST /v1/storefront/site/disable` — 호스팅을 끈다(사이트 `CLOSED`, 슬러그 90일 보류). 다시 만들 수 있다 */
+      disable: (body: DisableStorefrontHostingRequest) =>
+        storeHttp.request("POST", "/storefront/site/disable", storefrontSiteSchema, {
+          body: disableStorefrontHostingRequestSchema.parse(body),
+        }),
+
+      // ─── 편집 (M2b) — 조회 `storefront:r`, 쓰기 `storefront:rw`. 에이전트도 승인 없이 된다 ───
+
+      /** `GET /v1/storefront/site/editing` — 편집 환경 상태(열린 환경·동시 상한·미리보기 인증서) */
+      getEditing: () =>
+        storeHttp.request("GET", "/storefront/site/editing", storefrontEditingSchema),
+      /**
+       * `POST /v1/storefront/site/editing` — 편집 환경을 연다(이미 열려 있으면 그대로). 플랫폼 동시 상한에 걸리면 409
+       * `EDIT_CAPACITY_FULL`(`details.retryAfterSeconds`). 띄우는 데 보통 30초가 걸린다(`session.status: STARTING`)
+       */
+      startEditing: () =>
+        storeHttp.request("POST", "/storefront/site/editing", storefrontEditingSchema, {
+          body: {},
+        }),
+      /** `DELETE /v1/storefront/site/editing` — 편집 환경을 닫는다(작업 트리는 보존된다) */
+      stopEditing: () =>
+        storeHttp.request("DELETE", "/storefront/site/editing", storefrontEditingSchema),
+      /**
+       * `POST /v1/storefront/site/editing/preview-link` — 편집 미리보기(dev 서버) 5분짜리 링크.
+       * 콘솔에서 로그인한 OWNER·ADMIN만 받는다(에이전트 불가)
+       */
+      createEditPreviewLink: (body: CreateStorefrontEditPreviewLinkRequest = {}) =>
+        storeHttp.request(
+          "POST",
+          "/storefront/site/editing/preview-link",
+          storefrontPreviewLinkSchema,
+          { body: createStorefrontEditPreviewLinkRequestSchema.parse(body) },
+        ),
+      /** `GET /v1/storefront/site/files?prefix=` — 작업 트리 파일 목록 */
+      listFiles: (params: { prefix?: string } = {}) =>
+        storeHttp.request("GET", "/storefront/site/files", storefrontFileListSchema, {
+          query: params as Query,
+        }),
+      /** `GET /v1/storefront/site/files/content?path=` — 파일 하나 읽기 */
+      readFile: (filePath: string) =>
+        storeHttp.request("GET", "/storefront/site/files/content", storefrontFileContentSchema, {
+          query: { path: filePath },
+        }),
+      /**
+       * `POST /v1/storefront/site/files/batch` — 여러 파일 쓰기(해시 조건). 조건이 하나라도 어긋나면 아무것도 쓰지 않고 409
+       * `FILE_CHANGED`(`details.conflicts`). 편집 환경이 없으면 연다
+       */
+      writeFiles: (body: WriteStorefrontFilesRequest) =>
+        storeHttp.request("POST", "/storefront/site/files/batch", storefrontFileWriteResultSchema, {
+          body: writeStorefrontFilesRequestSchema.parse(body),
+        }),
+      /** `POST /v1/storefront/site/files/delete` */
+      deleteFile: (body: DeleteStorefrontFileRequest) =>
+        storeHttp.request(
+          "POST",
+          "/storefront/site/files/delete",
+          storefrontFileDeleteResultSchema,
+          {
+            body: deleteStorefrontFileRequestSchema.parse(body),
+          },
+        ),
+      /** `POST /v1/storefront/site/files/move` */
+      moveFile: (body: MoveStorefrontFileRequest) =>
+        storeHttp.request("POST", "/storefront/site/files/move", storefrontFileMoveResultSchema, {
+          body: moveStorefrontFileRequestSchema.parse(body),
+        }),
+      /** `POST /v1/storefront/site/files/search` — 내용 검색 */
+      searchFiles: (body: SearchStorefrontFilesRequest) =>
+        storeHttp.request(
+          "POST",
+          "/storefront/site/files/search",
+          storefrontFileSearchResultSchema,
+          { body: searchStorefrontFilesRequestSchema.parse(body) },
+        ),
+      /**
+       * `POST /v1/storefront/site/checks` (202) — 타입 검사·lint·test 하나를 시작한다. 결과는 `getCheck`로 끝날 때까지 조회한다
+       * (`STOREFRONT_CHECK_TERMINAL_STATUSES`)
+       */
+      runCheck: (body: RunStorefrontCheckRequest) =>
+        storeHttp.request("POST", "/storefront/site/checks", storefrontCheckSchema, {
+          body: runStorefrontCheckRequestSchema.parse(body),
+        }),
+      /** `GET /v1/storefront/site/checks/{checkId}` — 검사 상태·종료 코드·출력 꼬리 */
+      getCheck: (checkId: string) =>
+        storeHttp.request("GET", path`/storefront/site/checks/${checkId}`, storefrontCheckSchema),
+      /** `POST /v1/storefront/site/verify` — 작업 트리 규칙 검증(`verify_storefront`와 같은 보고서) */
+      verify: () =>
+        storeHttp.request("POST", "/storefront/site/verify", storefrontVerifyReportSchema, {
+          body: {},
+        }),
+      /**
+       * `POST /v1/storefront/site/versions` (201) — 지금 작업 트리로 버전을 만든다(빌드 시작). 버전은 `BUILDING`, 빌드가
+       * 끝나면 `READY` 또는 `FAILED`다
+       */
+      createVersion: (body: CreateStorefrontVersionRequest = {}) =>
+        storeHttp.request("POST", "/storefront/site/versions", storefrontVersionCreatedSchema, {
+          body: createStorefrontVersionRequestSchema.parse(body),
+        }),
+      /** `GET /v1/storefront/site/builds?limit=` — 빌드 목록(최신 먼저) */
+      listBuilds: (params: { limit?: number } = {}) =>
+        storeHttp.request("GET", "/storefront/site/builds", z.array(storefrontBuildSchema), {
+          query: params as Query,
+        }),
+      /** `GET /v1/storefront/site/builds/{buildId}` — 빌드 상태·실패 단계·로그 꼬리·규칙 결과 */
+      getBuild: (buildId: string) =>
+        storeHttp.request("GET", path`/storefront/site/builds/${buildId}`, storefrontBuildSchema),
+    },
+
     store: {
       get: () => storeHttp.request("GET", "/store", storeSchema),
       /**

package/src/index.ts

@@ -27,9 +27,7 @@ export * from "./schemas/claim";
 export * from "./schemas/common";
 export * from "./schemas/coupon";
 export * from "./schemas/customer";
-export * from "./schemas/digital-asset";
 export * from "./schemas/fulfillment";
-export * from "./schemas/fulfillment-code";
 export * from "./schemas/login";
 export * from "./schemas/misc";
 export * from "./schemas/order";
@@ -40,6 +38,7 @@ export * from "./schemas/refund-policy";
 export * from "./schemas/scope";
 export * from "./schemas/shipping-policy";
 export * from "./schemas/store";
+export * from "./schemas/storefront-hosting";
 export * from "./schemas/telemetry";
 export * from "./schemas/upload";
 export * from "./schemas/webhook-event";

package/src/schemas/claim.ts

@@ -90,7 +90,7 @@ export const claimSchema = z.object({
     .optional()
     .default("SHIPPING")
     .describe(
-      "클레임 대상 주문상품의 상품 유형(이슈 #48). 수거가 없는 비실물(`DOWNLOAD`·`CODE`·`SERVICE`) 반품은 수거 등록 없이 " +
+      "클레임 대상 주문상품의 상품 유형(이슈 #48). 배송 없는 상품(`MANUAL`) 반품은 수거 등록 없이 " +
         "접수·보류에서 바로 승인한다. 값이 추가될 수 있어 문자열로 받는다. 서버는 항상 싣는다",
     ),
   requestedAt: z.string(),