@sayren/store-sdk 0.7.0 → 0.9.0

package/dist/index.d.mts

@@ -1050,6 +1050,7 @@ export declare const changeTypeSchema: z.ZodEnum<{
   "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
   "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
   "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
+  "CLAIM.COMPLETED": "CLAIM.COMPLETED";
 }>;
 export type ChangeType = z.infer<typeof changeTypeSchema>;
 //#endregion
@@ -2011,6 +2012,7 @@ export declare const orderItemSchema: z.ZodObject<{
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
+    "CLAIM.COMPLETED": "CLAIM.COMPLETED";
   }>;
   testPayment: z.ZodBoolean;
 }, z.core.$strip>;
@@ -2042,6 +2044,7 @@ export declare const orderSchema: z.ZodObject<{
       MIXED: "MIXED";
     }>;
     approvedMethod: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     productAmount: z.ZodNumber;
     deliveryFee: z.ZodNumber;
     discountAmount: z.ZodNumber;
@@ -2094,6 +2097,7 @@ export declare const orderSchema: z.ZodObject<{
       "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
       "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
       "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
+      "CLAIM.COMPLETED": "CLAIM.COMPLETED";
     }>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>>;
@@ -2176,6 +2180,7 @@ export declare const orderItemPageSchema: z.ZodObject<{
       "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
       "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
       "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
+      "CLAIM.COMPLETED": "CLAIM.COMPLETED";
     }>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>>;
@@ -2226,6 +2231,7 @@ export declare const orderItemListQuerySchema: z.ZodObject<{
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
+    "CLAIM.COMPLETED": "CLAIM.COMPLETED";
   }>>;
   testPayment: z.ZodOptional<z.ZodEnum<{
     true: "true";
@@ -2401,18 +2407,23 @@ export declare const pgPaymentMethodSchema: z.ZodEnum<{
   EASY_PAY: "EASY_PAY";
 }>;
 export type PgPaymentMethod = z.infer<typeof pgPaymentMethodSchema>;
-export declare const paymentRoutingModeSchema: z.ZodEnum<{
-  PRIORITY_DISPLAY: "PRIORITY_DISPLAY";
-  AUTO_FAILOVER: "AUTO_FAILOVER";
-}>;
-export type PaymentRoutingMode = z.infer<typeof paymentRoutingModeSchema>;
-export declare const effectivePaymentRoutingModeSchema: z.ZodEnum<{
-  PRIORITY_DISPLAY: "PRIORITY_DISPLAY";
-  AUTO_FAILOVER: "AUTO_FAILOVER";
-  NONE: "NONE";
-  SINGLE: "SINGLE";
+/**
+ * 간편결제사 — 결제 옵션(스토어프론트 `paymentOptions`)과 PG 설정의 `easyPayProviders`에 쓴다.
+ * `@sayren/storefront-sdk`의 `easyPayProviderSchema`와 같은 값이다(api 계약 테스트가 고정한다)
+ */
+export declare const easyPayProviderSchema: z.ZodEnum<{
+  NAVERPAY: "NAVERPAY";
+  KAKAOPAY: "KAKAOPAY";
+  TOSSPAY: "TOSSPAY";
+  PAYCO: "PAYCO";
 }>;
-export type EffectivePaymentRoutingMode = z.infer<typeof effectivePaymentRoutingModeSchema>;
+export type EasyPayProvider = z.infer<typeof easyPayProviderSchema>;
+/**
+ * 응답에 실리는 간편결제사 — 서버가 간편결제사를 추가해도 파싱이 깨지지 않게 문자열로 받는다
+ * (`pgProvider`·결제수단과 같은 방식). 요청(`easyPayProviders`)은 값을 골라 보내는 자리라 enum 그대로다.
+ * 현재 값은 `NAVERPAY`·`KAKAOPAY`·`TOSSPAY`·`PAYCO`이고 화면은 모르는 값을 원문 그대로 보여 준다.
+ */
+export declare const easyPayProviderResponseSchema: z.ZodString;
 export declare const pgEnvironmentSchema: z.ZodEnum<{
   TEST: "TEST";
   LIVE: "LIVE";
@@ -2512,6 +2523,12 @@ export type UpsertPortOneProviderRequest = z.infer<typeof upsertPortOneProviderR
 export declare const updatePaymentProviderRequestSchema: z.ZodObject<{
   enabled: z.ZodOptional<z.ZodBoolean>;
   sandboxMode: z.ZodOptional<z.ZodBoolean>;
+  easyPayProviders: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    NAVERPAY: "NAVERPAY";
+    KAKAOPAY: "KAKAOPAY";
+    TOSSPAY: "TOSSPAY";
+    PAYCO: "PAYCO";
+  }>>>;
 }, z.core.$strip>;
 export type UpdatePaymentProviderRequest = z.infer<typeof updatePaymentProviderRequestSchema>;
 export declare const verifyPaymentProviderRequestSchema: z.ZodObject<{
@@ -2522,14 +2539,11 @@ export declare const verifyPaymentProviderRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type VerifyPaymentProviderRequest = z.infer<typeof verifyPaymentProviderRequestSchema>;
 export declare const updatePaymentSettingsRequestSchema: z.ZodObject<{
-  routingMode: z.ZodEnum<{
-    PRIORITY_DISPLAY: "PRIORITY_DISPLAY";
-    AUTO_FAILOVER: "AUTO_FAILOVER";
-  }>;
-  priority: z.ZodArray<z.ZodEnum<{
+  priority: z.ZodOptional<z.ZodArray<z.ZodEnum<{
     tosspayments: "tosspayments";
     portone: "portone";
-  }>>;
+  }>>>;
+  checkoutOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type UpdatePaymentSettingsRequest = z.infer<typeof updatePaymentSettingsRequestSchema>;
 export declare const maskedSecretSchema: z.ZodObject<{
@@ -2768,6 +2782,7 @@ export declare const paymentProviderSchema: z.ZodObject<{
     }, z.core.$strip>>;
     openedAt: z.ZodNullable<z.ZodString>;
   }, z.core.$strip>;
+  easyPayProviders: z.ZodArray<z.ZodString>;
   retiredCredentialCount: z.ZodNumber;
   routingExclusion: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
 }, z.core.$strip>;
@@ -2779,16 +2794,7 @@ export type PaymentProvider = z.infer<typeof paymentProviderSchema>;
 export declare const PAYMENT_ROUTING_EXCLUSION_CODES: readonly ["NOT_CONNECTED", "DISABLED", "CREDENTIAL_MISSING", "SANDBOX_IN_LIVE_STORE", "PLATFORM_BLOCKED", "MODE_MISMATCH"];
 export type KnownPaymentRoutingExclusion = (typeof PAYMENT_ROUTING_EXCLUSION_CODES)[number];
 export declare const paymentSettingsSchema: z.ZodObject<{
-  routingMode: z.ZodEnum<{
-    PRIORITY_DISPLAY: "PRIORITY_DISPLAY";
-    AUTO_FAILOVER: "AUTO_FAILOVER";
-  }>;
-  effectiveRoutingMode: z.ZodEnum<{
-    PRIORITY_DISPLAY: "PRIORITY_DISPLAY";
-    AUTO_FAILOVER: "AUTO_FAILOVER";
-    NONE: "NONE";
-    SINGLE: "SINGLE";
-  }>;
+  checkoutOrigins: z.ZodArray<z.ZodString>;
   providers: z.ZodArray<z.ZodObject<{
     provider: z.ZodEnum<{
       tosspayments: "tosspayments";
@@ -2925,6 +2931,7 @@ export declare const paymentSettingsSchema: z.ZodObject<{
       }, z.core.$strip>>;
       openedAt: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
+    easyPayProviders: z.ZodArray<z.ZodString>;
     retiredCredentialCount: z.ZodNumber;
     routingExclusion: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   }, z.core.$strip>>;
@@ -3109,6 +3116,7 @@ export declare const paymentRecordSchema: z.ZodObject<{
     MOBILE: "MOBILE";
     EASY_PAY: "EASY_PAY";
   }>>;
+  easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   environment: z.ZodNullable<z.ZodEnum<{
     TEST: "TEST";
     LIVE: "LIVE";
@@ -3153,6 +3161,7 @@ export declare const paymentRecordPageSchema: z.ZodObject<{
       MOBILE: "MOBILE";
       EASY_PAY: "EASY_PAY";
     }>>;
+    easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     environment: z.ZodNullable<z.ZodEnum<{
       TEST: "TEST";
       LIVE: "LIVE";
@@ -3183,6 +3192,7 @@ export declare const paymentAttemptRecordSchema: z.ZodObject<{
     MOBILE: "MOBILE";
     EASY_PAY: "EASY_PAY";
   }>;
+  easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   approvedMethod: z.ZodNullable<z.ZodEnum<{
     CARD: "CARD";
     BANK_TRANSFER: "BANK_TRANSFER";
@@ -3190,6 +3200,7 @@ export declare const paymentAttemptRecordSchema: z.ZodObject<{
     MOBILE: "MOBILE";
     EASY_PAY: "EASY_PAY";
   }>>;
+  approvedEasyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   amount: z.ZodNumber;
   environment: z.ZodEnum<{
     TEST: "TEST";
@@ -3238,6 +3249,7 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
     MOBILE: "MOBILE";
     EASY_PAY: "EASY_PAY";
   }>>;
+  easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   environment: z.ZodNullable<z.ZodEnum<{
     TEST: "TEST";
     LIVE: "LIVE";
@@ -3267,6 +3279,7 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
       MOBILE: "MOBILE";
       EASY_PAY: "EASY_PAY";
     }>;
+    easyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     approvedMethod: z.ZodNullable<z.ZodEnum<{
       CARD: "CARD";
       BANK_TRANSFER: "BANK_TRANSFER";
@@ -3274,6 +3287,7 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
       MOBILE: "MOBILE";
       EASY_PAY: "EASY_PAY";
     }>>;
+    approvedEasyPayProvider: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     amount: z.ZodNumber;
     environment: z.ZodEnum<{
       TEST: "TEST";
@@ -3449,6 +3463,33 @@ export declare const productSchema: z.ZodObject<{
   createdAt: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type Product = z.infer<typeof productSchema>;
+/** 상품 하나에 등록할 수 있는 이미지 최대 장수 — 첫 장이 대표(썸네일)다 */
+export declare const MAX_PRODUCT_IMAGES = 10;
+/**
+ * 상품 이미지 주소의 와이어 형식 — URL이고 2048자 이하다.
+ *
+ * https·확장자 규칙은 여기서 강제하지 않고 `productImageRejection`이 판정한다. 서버가
+ * **새로 추가된 주소에만** 그 규칙을 적용해야 하기 때문이다(규칙이 생기기 전에 저장된
+ * 주소 하나로 상품 수정 전체가 막히면 셀러가 빠져나갈 길이 없다).
+ *
+ * 응답 스키마(`productSchema.images`)도 넓게 둔다. 과거에 저장된 주소를 파싱 오류로
+ * 만들면 상품 조회 자체가 막힌다.
+ */
+export declare const productImageUrlSchema: z.ZodURL;
+export interface ProductImageRejection {
+  code: "INVALID_IMAGE_URL" | "UNSUPPORTED_FILE_TYPE";
+  message: string;
+}
+/**
+ * 상품에 **새로 붙이는** 이미지 주소의 규칙. 통과하면 `null`.
+ *
+ * - https만 받는다. http는 https 스토어프론트에서 혼합 콘텐츠로 차단되고 `data:`·`javascript:`는
+ *   상세 화면에 박히는 주입 경로가 된다.
+ * - 호스트는 제한하지 않는다 — 셀러가 이미 쓰는 이미지 호스트를 그대로 붙일 수 있어야 한다.
+ * - 경로에 확장자가 있으면 상품 이미지 형식이어야 한다(svg·동영상 거부). **확장자가 없으면 통과시킨다**
+ *   — 외부 이미지 CDN은 확장자 없는 키를 쓰는 경우가 흔하고, 주소만으로는 실제 형식을 알 수 없다.
+ */
+export declare function productImageRejection(url: string): ProductImageRejection | null;
 /** 옵션 축(그룹) 최대 개수 — 스키마 상한의 단일 원천 */
 export declare const MAX_OPTION_GROUPS = 3;
 /** 축 하나가 가질 수 있는 값의 최대 개수 */
@@ -3646,15 +3687,6 @@ export declare const productListQuerySchema: z.ZodObject<{
     "updatedAt.desc": "updatedAt.desc";
   }>>;
 }, z.core.$strip>;
-/** `POST /v1/product-images` 응답 — 업로드된 이미지의 CDN 주소 */
-export declare const productImageUploadResultSchema: z.ZodObject<{
-  images: z.ZodArray<z.ZodObject<{
-    url: z.ZodURL;
-    width: z.ZodNumber;
-    height: z.ZodNumber;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-export type ProductImageUploadResult = z.infer<typeof productImageUploadResultSchema>;
 export declare const discountSchema: z.ZodObject<{
   productId: z.ZodString;
   discountType: z.ZodEnum<{
@@ -3697,6 +3729,8 @@ export declare function isWebOrigin(value: string): boolean;
 export declare const analyticsOriginSchema: z.ZodString;
 /** 허용 오리진 상한 */
 export declare const MAX_ANALYTICS_ALLOWED_ORIGINS = 20;
+/** 자동 배송완료·자동 구매확정 대기일 상한 */
+export declare const MAX_AUTO_TRANSITION_DAYS = 30;
 /** `PATCH /v1/store` 본문 — 바꿀 필드만 보낸다 */
 export declare const updateStoreRequestSchema: z.ZodObject<{
   name: z.ZodOptional<z.ZodString>;
@@ -3706,6 +3740,8 @@ export declare const updateStoreRequestSchema: z.ZodObject<{
   analyticsAllowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
   storefrontOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
   guestCheckoutEnabled: z.ZodOptional<z.ZodBoolean>;
+  autoDeliverDays: z.ZodOptional<z.ZodNumber>;
+  autoConfirmDays: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type UpdateStoreRequest = z.infer<typeof updateStoreRequestSchema>;
 export declare const storeSchema: z.ZodObject<{
@@ -3724,6 +3760,8 @@ export declare const storeSchema: z.ZodObject<{
   analyticsAllowedOrigins: z.ZodArray<z.ZodString>;
   storefrontOrigins: z.ZodArray<z.ZodString>;
   guestCheckoutEnabled: z.ZodBoolean;
+  autoDeliverDays: z.ZodNumber;
+  autoConfirmDays: z.ZodNumber;
   memberCount: z.ZodNumber;
   createdAt: z.ZodString;
 }, z.core.$strip>;
@@ -3820,6 +3858,42 @@ export declare const sellerAddressRequestSchema: z.ZodObject<{
 export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
 //#endregion
 //#region src/schemas/upload.d.ts
+/**
+ * 업로드 용도. 허용 확장자와 크기 상한이 용도별로 다르다.
+ *
+ * - `product-image`: 상품 목록·상세의 상품 이미지. 목록 썸네일로 쓰이므로 정지 이미지만 받는다.
+ * - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
+ */
+export declare const uploadPurposeSchema: z.ZodEnum<{
+  "product-image": "product-image";
+  description: "description";
+}>;
+export type UploadPurpose = z.infer<typeof uploadPurposeSchema>;
+export interface UploadPurposeLimit {
+  /** 소문자 확장자 목록 */
+  extensions: readonly string[];
+  maxBytes: number;
+}
+/**
+ * 용도별 업로드 제한 — 서버(`POST /v1/uploads`)와 클라이언트가 공유하는 단일 원천이다.
+ *
+ * 크기는 **요청이 스스로 신고한 값**으로만 검사한다. 바이트는 api를 거치지 않고 CDN으로
+ * 직접 PUT되므로 이 검사는 셀러가 올리기 전에 알게 하는 장치이고, 실제 상한은 CDN이 강제한다.
+ */
+export declare const UPLOAD_PURPOSE_LIMITS: Record<UploadPurpose, UploadPurposeLimit>;
+/** 파일명의 소문자 확장자. 확장자가 없으면 `""` */
+export declare function uploadExtensionOf(filename: string): string;
+export interface UploadRejection {
+  /** 400 형식 불일치 / 413 크기 초과 */
+  status: 400 | 413;
+  code: "UNSUPPORTED_FILE_TYPE" | "FILE_TOO_LARGE";
+  message: string;
+}
+/**
+ * 용도 제한 위반 여부. 통과하면 `null`.
+ * 서버가 던지는 오류와 콘솔이 먼저 띄우는 안내가 갈리지 않도록 한 함수로 판정한다.
+ */
+export declare function uploadRejection(purpose: UploadPurpose, filename: string, size?: number): UploadRejection | null;
 /**
  * 미디어 업로드 자리 발급 — `POST /v1/uploads`.
  *
@@ -3829,6 +3903,11 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
  */
 export declare const uploadRequestSchema: z.ZodObject<{
   filename: z.ZodString;
+  purpose: z.ZodDefault<z.ZodEnum<{
+    "product-image": "product-image";
+    description: "description";
+  }>>;
+  size: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type UploadRequest = z.infer<typeof uploadRequestSchema>;
 export declare const uploadTicketSchema: z.ZodObject<{
@@ -4114,6 +4193,16 @@ export declare function createStoreClient(options: StoreClientOptions): {
       url: string;
       uploadUrl: string;
     }>;
+    /**
+     * 자리 발급 + 바이트 PUT을 한 번에 — 끝나면 `url`이 공개 주소다.
+     *
+     * 용도 제한(확장자·크기)은 서버가 판정하지만, 같은 규칙으로 여기서 먼저 걸러
+     * 큰 파일을 CDN까지 보내고 나서 거절되는 왕복을 없앤다.
+     */
+    upload: (file: Blob, options?: {
+      purpose?: UploadPurpose;
+      filename?: string;
+    }) => Promise<UploadTicket>;
   };
   products: {
     list: (params?: ProductListParams) => Promise<{
@@ -4570,6 +4659,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       payment: {
         method: "CARD" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE" | "POINT" | "MIXED";
         approvedMethod: string | null;
+        easyPayProvider: string | null;
         productAmount: number;
         deliveryFee: number;
         discountAmount: number;
@@ -4599,7 +4689,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         sellerMemo: string | null;
         orderedAt: string;
         lastChangedAt: string;
-        lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED";
+        lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED";
         testPayment: boolean;
       }[];
     }>;
@@ -4633,7 +4723,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         sellerMemo: string | null;
         orderedAt: string;
         lastChangedAt: string;
-        lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED";
+        lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED";
         testPayment: boolean;
       }[];
     }>;
@@ -4686,6 +4776,46 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
     }>;
     updateTracking: (orderItemId: string, carrierCode: string, trackingNumber: string) => Promise<void>;
+    /**
+     * 배송완료 처리 — `DISPATCHED`·`DELIVERING`만 넘어간다. 응답의 `autoDecisionDate`가 자동 구매확정 예정일이다
+     * (스토어 설정 `autoConfirmDays`가 0이면 null).
+     */
+    markDelivered: (orderItemId: string, idempotencyKey?: string) => Promise<{
+      orderItemId: string;
+      orderId: string;
+      status: "PAID" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
+      claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
+      productId: string;
+      productName: string;
+      optionId: string | null;
+      optionName: string | null;
+      sellerCode: string | null;
+      quantity: number;
+      unitPrice: number;
+      discountAmount: number;
+      totalPrice: number;
+      hold: {
+        reason: string;
+        expectedDispatchDate: string;
+      } | null;
+      autoDecisionDate: string | null;
+      sellerMemo: string | null;
+      orderedAt: string;
+      lastChangedAt: string;
+      lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED";
+      testPayment: boolean;
+    }>;
+    /** 배송완료 일괄 처리 — 항목별 부분 성공이다 */
+    markDeliveredBulk: (orderItemIds: string[], idempotencyKey?: string) => Promise<{
+      succeeded: string[];
+      failed: {
+        code: string;
+        message: string;
+        id?: string | undefined;
+        productId?: string | undefined;
+        orderItemId?: string | undefined;
+      }[];
+    }>;
     getDelivery: (orderItemId: string) => Promise<{
       orderItemId: string;
       deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
@@ -5396,6 +5526,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         refundedAmount: number;
         provider: "tosspayments" | "portone" | null;
         method: "CARD" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE" | "EASY_PAY" | null;
+        easyPayProvider: string | null;
         environment: "TEST" | "LIVE" | null;
         testPayment: boolean;
         pgTransactionId: string | null;
@@ -5418,6 +5549,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       refundedAmount: number;
       provider: "tosspayments" | "portone" | null;
       method: "CARD" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE" | "EASY_PAY" | null;
+      easyPayProvider: string | null;
       environment: "TEST" | "LIVE" | null;
       testPayment: boolean;
       pgTransactionId: string | null;
@@ -5435,7 +5567,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         provider: "tosspayments" | "portone";
         status: string;
         method: "CARD" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE" | "EASY_PAY";
+        easyPayProvider: string | null;
         approvedMethod: "CARD" | "BANK_TRANSFER" | "VIRTUAL_ACCOUNT" | "MOBILE" | "EASY_PAY" | null;
+        approvedEasyPayProvider: string | null;
         amount: number;
         environment: "TEST" | "LIVE";
         pgTransactionId: string | null;
@@ -5465,8 +5599,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
   paymentSettings: {
     /** `GET /v1/store/payment-settings` — 라우팅 모드와 지원 PG 전부(연결된 것은 우선순위순) */
     get: () => Promise<{
-      routingMode: "PRIORITY_DISPLAY" | "AUTO_FAILOVER";
-      effectiveRoutingMode: "PRIORITY_DISPLAY" | "AUTO_FAILOVER" | "NONE" | "SINGLE";
+      checkoutOrigins: string[];
       providers: {
         provider: "tosspayments" | "portone";
         displayName: string;
@@ -5555,6 +5688,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           }[];
           openedAt: string | null;
         };
+        easyPayProviders: string[];
         retiredCredentialCount: number;
         routingExclusion: string | null;
       }[];
@@ -5566,8 +5700,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
      * (빠지거나 중복되면 400 `INVALID_PRIORITY`). 진행 중인 결제에는 적용되지 않는다.
      */
     update: (body: UpdatePaymentSettingsRequest) => Promise<{
-      routingMode: "PRIORITY_DISPLAY" | "AUTO_FAILOVER";
-      effectiveRoutingMode: "PRIORITY_DISPLAY" | "AUTO_FAILOVER" | "NONE" | "SINGLE";
+      checkoutOrigins: string[];
       providers: {
         provider: "tosspayments" | "portone";
         displayName: string;
@@ -5656,6 +5789,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           }[];
           openedAt: string | null;
         };
+        easyPayProviders: string[];
         retiredCredentialCount: number;
         routingExclusion: string | null;
       }[];
@@ -5761,6 +5895,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         }[];
         openedAt: string | null;
       };
+      easyPayProviders: string[];
       retiredCredentialCount: number;
       routingExclusion: string | null;
     }>;
@@ -5856,6 +5991,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         }[];
         openedAt: string | null;
       };
+      easyPayProviders: string[];
       retiredCredentialCount: number;
       routingExclusion: string | null;
     }>;
@@ -5961,6 +6097,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         }[];
         openedAt: string | null;
       };
+      easyPayProviders: string[];
       retiredCredentialCount: number;
       routingExclusion: string | null;
     }>;
@@ -6056,6 +6193,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         }[];
         openedAt: string | null;
       };
+      easyPayProviders: string[];
       retiredCredentialCount: number;
       routingExclusion: string | null;
     }>;
@@ -6160,6 +6298,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         }[];
         openedAt: string | null;
       };
+      easyPayProviders: string[];
       retiredCredentialCount: number;
       routingExclusion: string | null;
     }>;
@@ -6399,6 +6538,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       analyticsAllowedOrigins: string[];
       storefrontOrigins: string[];
       guestCheckoutEnabled: boolean;
+      autoDeliverDays: number;
+      autoConfirmDays: number;
       memberCount: number;
       createdAt: string;
     }>;
@@ -6418,6 +6559,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       analyticsAllowedOrigins: string[];
       storefrontOrigins: string[];
       guestCheckoutEnabled: boolean;
+      autoDeliverDays: number;
+      autoConfirmDays: number;
       memberCount: number;
       createdAt: string;
     }>;