@sayren/store-sdk 0.19.0 → 0.21.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/store-sdk",
-  "version": "0.19.0",
+  "version": "0.21.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,
@@ -219,6 +203,15 @@ import {
   variantStockRequestSchema,
   variantStockSchema,
 } from "./schemas/product";
+import {
+  type SavedOptionSetFromProductRequestInput,
+  type SavedOptionSetListParams,
+  type SavedOptionSetRequestInput,
+  savedOptionSetFromProductRequestSchema,
+  savedOptionSetFromProductResultSchema,
+  savedOptionSetRequestSchema,
+  savedOptionSetSchema,
+} from "./schemas/saved-option-set";
 import {
   type AddressType,
   type Invitation,
@@ -239,26 +232,51 @@ import {
 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,
@@ -497,7 +515,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) {
@@ -560,75 +578,38 @@ 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) =>
+    /**
+     * 저장 옵션 (이슈 #59) — 자주 쓰는 옵션 구성. 불러오기는 복사라 저장 옵션을 고쳐도 불러온 상품은 바뀌지 않는다.
+     * 권한은 상품과 같다(`product:r`·`product:rw`).
+     */
+    savedOptionSets: {
+      list: (params?: SavedOptionSetListParams) =>
+        storeHttp.request("GET", "/saved-option-sets", pageSchema(savedOptionSetSchema), {
+          query: params as Query,
+        }),
+      get: (optionSetId: string) =>
+        storeHttp.request("GET", path`/saved-option-sets/${optionSetId}`, savedOptionSetSchema),
+      /** 이름이 겹치면 409 `OPTION_SET_NAME_TAKEN`, 스토어당 200개를 넘으면 409 `OPTION_SET_LIMIT_EXCEEDED` */
+      create: (body: SavedOptionSetRequestInput) =>
+        storeHttp.request("POST", "/saved-option-sets", savedOptionSetSchema, {
+          body: savedOptionSetRequestSchema.parse(body),
+        }),
+      /** 통째로 바꾼다. 불러온 상품은 바뀌지 않는다 */
+      update: (optionSetId: string, body: SavedOptionSetRequestInput) =>
+        storeHttp.request("PUT", path`/saved-option-sets/${optionSetId}`, savedOptionSetSchema, {
+          body: savedOptionSetRequestSchema.parse(body),
+        }),
+      remove: (optionSetId: string) =>
+        storeHttp.requestVoid("DELETE", path`/saved-option-sets/${optionSetId}`),
+      /** 상품의 현재 옵션을 저장 옵션으로 만든다(또는 `replaceOptionSetId`를 덮어쓴다) */
+      saveFromProduct: (body: SavedOptionSetFromProductRequestInput) =>
         storeHttp.request(
           "POST",
-          path`/fulfillment-codes/${codeId}/reveal`,
-          fulfillmentCodeRevealSchema,
+          "/saved-option-sets/from-product",
+          savedOptionSetFromProductResultSchema,
+          { body: savedOptionSetFromProductRequestSchema.parse(body) },
         ),
     },
 
@@ -756,17 +737,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) =>
@@ -1423,6 +1394,107 @@ export function createStoreClient(options: StoreClientOptions) {
         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: {

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";
@@ -37,6 +35,7 @@ export * from "./schemas/payment";
 export * from "./schemas/product";
 export * from "./schemas/promotion";
 export * from "./schemas/refund-policy";
+export * from "./schemas/saved-option-set";
 export * from "./schemas/scope";
 export * from "./schemas/shipping-policy";
 export * from "./schemas/store";

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(),