@sayren/store-sdk 0.29.5 → 0.29.7

package/dist/index.d.mts

@@ -165,9 +165,9 @@ 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";
   ALLOW: "ALLOW";
+  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
 export declare const writePreviewSchema: z.ZodObject<{
@@ -190,9 +190,9 @@ 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";
     ALLOW: "ALLOW";
+    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   }>;
   reason: z.ZodNullable<z.ZodString>;
   preview: z.ZodObject<{
@@ -213,11 +213,11 @@ export declare const writeDryRunResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type WriteDryRunResult = z.infer<typeof writeDryRunResultSchema>;
 export declare const approvalStatusSchema: z.ZodEnum<{
-  UNKNOWN: "UNKNOWN";
   PENDING: "PENDING";
   FAILED: "FAILED";
   SUCCEEDED: "SUCCEEDED";
   EXECUTING: "EXECUTING";
+  UNKNOWN: "UNKNOWN";
   REJECTED: "REJECTED";
   EXPIRED: "EXPIRED";
 }>;
@@ -225,11 +225,11 @@ export type ApprovalStatus = z.infer<typeof approvalStatusSchema>;
 export declare const approvalRequestSchema: z.ZodObject<{
   approvalId: z.ZodString;
   status: z.ZodEnum<{
-    UNKNOWN: "UNKNOWN";
     PENDING: "PENDING";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
     EXECUTING: "EXECUTING";
+    UNKNOWN: "UNKNOWN";
     REJECTED: "REJECTED";
     EXPIRED: "EXPIRED";
   }>;
@@ -287,11 +287,11 @@ export declare const approvalRequestSchema: z.ZodObject<{
 export type ApprovalRequest = z.infer<typeof approvalRequestSchema>;
 export declare const approvalListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodEnum<{
-    UNKNOWN: "UNKNOWN";
     PENDING: "PENDING";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
     EXECUTING: "EXECUTING";
+    UNKNOWN: "UNKNOWN";
     REJECTED: "REJECTED";
     EXPIRED: "EXPIRED";
   }>>>>;
@@ -306,11 +306,11 @@ export declare const approvalPageSchema: z.ZodObject<{
   items: z.ZodArray<z.ZodObject<{
     approvalId: z.ZodString;
     status: z.ZodEnum<{
-      UNKNOWN: "UNKNOWN";
       PENDING: "PENDING";
       FAILED: "FAILED";
       SUCCEEDED: "SUCCEEDED";
       EXECUTING: "EXECUTING";
+      UNKNOWN: "UNKNOWN";
       REJECTED: "REJECTED";
       EXPIRED: "EXPIRED";
     }>;
@@ -448,11 +448,11 @@ export declare const analyticsTotalsSchema: z.ZodObject<{
 export type AnalyticsTotals = z.infer<typeof analyticsTotalsSchema>;
 export declare const analyticsFunnelStepSchema: z.ZodObject<{
   step: z.ZodEnum<{
+    PURCHASE: "PURCHASE";
     SESSION: "SESSION";
     PRODUCT_VIEW: "PRODUCT_VIEW";
     ADD_TO_CART: "ADD_TO_CART";
     BEGIN_CHECKOUT: "BEGIN_CHECKOUT";
-    PURCHASE: "PURCHASE";
   }>;
   sessions: z.ZodNumber;
   rateFromPrevious: z.ZodNullable<z.ZodNumber>;
@@ -477,11 +477,11 @@ export declare const analyticsOverviewSchema: z.ZodObject<{
   }, z.core.$strip>;
   funnel: z.ZodArray<z.ZodObject<{
     step: z.ZodEnum<{
+      PURCHASE: "PURCHASE";
       SESSION: "SESSION";
       PRODUCT_VIEW: "PRODUCT_VIEW";
       ADD_TO_CART: "ADD_TO_CART";
       BEGIN_CHECKOUT: "BEGIN_CHECKOUT";
-      PURCHASE: "PURCHASE";
     }>;
     sessions: z.ZodNumber;
     rateFromPrevious: z.ZodNullable<z.ZodNumber>;
@@ -581,20 +581,20 @@ export declare const analyticsProductsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AnalyticsProducts = z.infer<typeof analyticsProductsSchema>;
 export declare const analyticsChannelSchema: z.ZodEnum<{
+  PAID: "PAID";
   DIRECT: "DIRECT";
+  CAMPAIGN: "CAMPAIGN";
+  UNKNOWN: "UNKNOWN";
   ORGANIC_SEARCH: "ORGANIC_SEARCH";
   SOCIAL: "SOCIAL";
-  PAID: "PAID";
   EMAIL: "EMAIL";
-  CAMPAIGN: "CAMPAIGN";
   REFERRAL: "REFERRAL";
-  UNKNOWN: "UNKNOWN";
 }>;
 export type AnalyticsChannel = z.infer<typeof analyticsChannelSchema>;
 export declare const analyticsSourceGroupBySchema: z.ZodEnum<{
-  CAMPAIGN: "CAMPAIGN";
   CHANNEL: "CHANNEL";
   SOURCE: "SOURCE";
+  CAMPAIGN: "CAMPAIGN";
   DEVICE: "DEVICE";
 }>;
 export type AnalyticsSourceGroupBy = z.infer<typeof analyticsSourceGroupBySchema>;
@@ -606,23 +606,23 @@ export declare const analyticsSourcesQuerySchema: z.ZodObject<{
     false: "false";
   }>>;
   groupBy: z.ZodOptional<z.ZodEnum<{
-    CAMPAIGN: "CAMPAIGN";
     CHANNEL: "CHANNEL";
     SOURCE: "SOURCE";
+    CAMPAIGN: "CAMPAIGN";
     DEVICE: "DEVICE";
   }>>;
 }, z.core.$strip>;
 export type AnalyticsSourcesParams = z.infer<typeof analyticsSourcesQuerySchema>;
 export declare const analyticsSourceRowSchema: z.ZodObject<{
   channel: z.ZodNullable<z.ZodEnum<{
+    PAID: "PAID";
     DIRECT: "DIRECT";
+    CAMPAIGN: "CAMPAIGN";
+    UNKNOWN: "UNKNOWN";
     ORGANIC_SEARCH: "ORGANIC_SEARCH";
     SOCIAL: "SOCIAL";
-    PAID: "PAID";
     EMAIL: "EMAIL";
-    CAMPAIGN: "CAMPAIGN";
     REFERRAL: "REFERRAL";
-    UNKNOWN: "UNKNOWN";
   }>>;
   source: z.ZodNullable<z.ZodString>;
   medium: z.ZodNullable<z.ZodString>;
@@ -644,21 +644,21 @@ export declare const analyticsSourceRowSchema: z.ZodObject<{
 export type AnalyticsSourceRow = z.infer<typeof analyticsSourceRowSchema>;
 export declare const analyticsSourcesSchema: z.ZodObject<{
   groupBy: z.ZodEnum<{
-    CAMPAIGN: "CAMPAIGN";
     CHANNEL: "CHANNEL";
     SOURCE: "SOURCE";
+    CAMPAIGN: "CAMPAIGN";
     DEVICE: "DEVICE";
   }>;
   rows: z.ZodArray<z.ZodObject<{
     channel: z.ZodNullable<z.ZodEnum<{
+      PAID: "PAID";
       DIRECT: "DIRECT";
+      CAMPAIGN: "CAMPAIGN";
+      UNKNOWN: "UNKNOWN";
       ORGANIC_SEARCH: "ORGANIC_SEARCH";
       SOCIAL: "SOCIAL";
-      PAID: "PAID";
       EMAIL: "EMAIL";
-      CAMPAIGN: "CAMPAIGN";
       REFERRAL: "REFERRAL";
-      UNKNOWN: "UNKNOWN";
     }>>;
     source: z.ZodNullable<z.ZodString>;
     medium: z.ZodNullable<z.ZodString>;
@@ -807,12 +807,12 @@ export declare const analyticsSearchSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AnalyticsSearch = z.infer<typeof analyticsSearchSchema>;
 export declare const analyticsCheckoutOutcomeSchema: z.ZodEnum<{
+  OTHER: "OTHER";
   COMPLETED: "COMPLETED";
   NOT_OPENED: "NOT_OPENED";
   USER_CANCELED: "USER_CANCELED";
   DECLINED: "DECLINED";
   PREPARE_FAILURE: "PREPARE_FAILURE";
-  OTHER: "OTHER";
   IN_PROGRESS: "IN_PROGRESS";
 }>;
 export type AnalyticsCheckoutOutcome = z.infer<typeof analyticsCheckoutOutcomeSchema>;
@@ -820,12 +820,12 @@ export declare const analyticsCheckoutSchema: z.ZodObject<{
   sessions: z.ZodNumber;
   outcomes: z.ZodArray<z.ZodObject<{
     outcome: z.ZodEnum<{
+      OTHER: "OTHER";
       COMPLETED: "COMPLETED";
       NOT_OPENED: "NOT_OPENED";
       USER_CANCELED: "USER_CANCELED";
       DECLINED: "DECLINED";
       PREPARE_FAILURE: "PREPARE_FAILURE";
-      OTHER: "OTHER";
       IN_PROGRESS: "IN_PROGRESS";
     }>;
     sessions: z.ZodNumber;
@@ -1264,7 +1264,6 @@ export declare const claimTypeSchema: z.ZodEnum<{
 }>;
 export type ClaimType = z.infer<typeof claimTypeSchema>;
 export declare const claimStatusSchema: z.ZodEnum<{
-  COMPLETED: "COMPLETED";
   REJECTED: "REJECTED";
   REQUESTED: "REQUESTED";
   HELD: "HELD";
@@ -1272,6 +1271,7 @@ export declare const claimStatusSchema: z.ZodEnum<{
   COLLECTED: "COLLECTED";
   REDELIVERING: "REDELIVERING";
   APPROVED: "APPROVED";
+  COMPLETED: "COMPLETED";
   WITHDRAWN: "WITHDRAWN";
 }>;
 export type ClaimStatus = z.infer<typeof claimStatusSchema>;
@@ -1302,13 +1302,13 @@ export declare const claimReturnAddressSchema: z.ZodObject<{
 export type ClaimReturnAddress = z.infer<typeof claimReturnAddressSchema>;
 export declare const claimSchema: z.ZodObject<{
   claimId: z.ZodString;
+  claimNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   type: z.ZodEnum<{
     RETURN: "RETURN";
     EXCHANGE: "EXCHANGE";
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
-    COMPLETED: "COMPLETED";
     REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
@@ -1316,6 +1316,7 @@ export declare const claimSchema: z.ZodObject<{
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
+    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderId: z.ZodString;
@@ -1391,13 +1392,13 @@ export declare const claimListQuerySchema: z.ZodObject<{
 /** `GET /v1/claims/{claimId}` 응답 — 클레임 + 상태 이력 */
 export declare const claimDetailSchema: z.ZodObject<{
   claimId: z.ZodString;
+  claimNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   type: z.ZodEnum<{
     RETURN: "RETURN";
     EXCHANGE: "EXCHANGE";
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
-    COMPLETED: "COMPLETED";
     REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
@@ -1405,6 +1406,7 @@ export declare const claimDetailSchema: z.ZodObject<{
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
+    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderId: z.ZodString;
@@ -1455,7 +1457,6 @@ export declare const claimDetailSchema: z.ZodObject<{
   }, z.core.$strip>>;
   histories: z.ZodOptional<z.ZodArray<z.ZodObject<{
     status: z.ZodEnum<{
-      COMPLETED: "COMPLETED";
       REJECTED: "REJECTED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
@@ -1463,6 +1464,7 @@ export declare const claimDetailSchema: z.ZodObject<{
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
+      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     actor: z.ZodEnum<{
@@ -2020,10 +2022,15 @@ export declare const couponStatusSchema: z.ZodEnum<{
   ENDED: "ENDED";
 }>;
 export type CouponStatus = z.infer<typeof couponStatusSchema>;
-/** 지금 만들 수 있는 발급 방식 — 다운로드·가입 자동 지급은 뒤 단계다 */
+/**
+ * 발급 방식 — 코드 입력·셀러 지급·다운로드(구매자가 받기)·회원가입 자동 지급(이슈 #110).
+ * 응답(`couponSchema.issueMethod`)은 값이 늘 수 있어 문자열로 받는다. 이 enum은 요청 검증용이다.
+ */
 export declare const couponIssueMethodSchema: z.ZodEnum<{
   MANUAL: "MANUAL";
   CODE: "CODE";
+  DOWNLOAD: "DOWNLOAD";
+  SIGNUP: "SIGNUP";
 }>;
 export type CouponIssueMethod = z.infer<typeof couponIssueMethodSchema>;
 /** 코드 형식 — 영문·숫자·`-`·`_` 6~30자. 대소문자를 구분하지 않고 서버가 대문자로 저장한다 */
@@ -2076,6 +2083,8 @@ export declare const createCouponRequestSchema: z.ZodObject<{
   issueMethod: z.ZodEnum<{
     MANUAL: "MANUAL";
     CODE: "CODE";
+    DOWNLOAD: "DOWNLOAD";
+    SIGNUP: "SIGNUP";
   }>;
   code: z.ZodOptional<z.ZodString>;
   startsAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
@@ -2194,6 +2203,8 @@ export declare const couponListQuerySchema: z.ZodObject<{
   issueMethod: z.ZodOptional<z.ZodEnum<{
     MANUAL: "MANUAL";
     CODE: "CODE";
+    DOWNLOAD: "DOWNLOAD";
+    SIGNUP: "SIGNUP";
   }>>;
   q: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -2204,6 +2215,7 @@ export declare const couponIssueSchema: z.ZodObject<{
   couponId: z.ZodString;
   customerId: z.ZodString;
   customerName: z.ZodNullable<z.ZodString>;
+  source: z.ZodOptional<z.ZodString>;
   status: z.ZodString;
   validFrom: z.ZodString;
   validUntil: z.ZodNullable<z.ZodString>;
@@ -2282,6 +2294,7 @@ export declare const customerCouponSchema: z.ZodObject<{
   couponId: z.ZodString;
   customerId: z.ZodString;
   customerName: z.ZodNullable<z.ZodString>;
+  source: z.ZodOptional<z.ZodString>;
   status: z.ZodString;
   validFrom: z.ZodString;
   validUntil: z.ZodNullable<z.ZodString>;
@@ -2382,8 +2395,8 @@ export type ConsentAction = z.infer<typeof consentActionSchema>;
  * `RECONSENT` 약관 개정 재동의 · `MEMBER_UPDATE` 구매자가 직접 변경 · `SELLER` 셀러가 처리
  */
 export declare const consentSourceSchema: z.ZodEnum<{
-  SELLER: "SELLER";
   SIGNUP: "SIGNUP";
+  SELLER: "SELLER";
   SOCIAL_SIGNUP: "SOCIAL_SIGNUP";
   DELEGATED: "DELEGATED";
   RECONSENT: "RECONSENT";
@@ -2405,8 +2418,8 @@ export declare const customerConsentSchema: z.ZodObject<{
     AGREED: "AGREED";
   }>;
   source: z.ZodEnum<{
-    SELLER: "SELLER";
     SIGNUP: "SIGNUP";
+    SELLER: "SELLER";
     SOCIAL_SIGNUP: "SOCIAL_SIGNUP";
     DELEGATED: "DELEGATED";
     RECONSENT: "RECONSENT";
@@ -2595,10 +2608,10 @@ export type CustomerOrder = z.infer<typeof customerOrderSchema>;
 /** `POST /v1/customers/{id}/withdraw` 본문 */
 export declare const withdrawCustomerRequestSchema: z.ZodObject<{
   reason: z.ZodEnum<{
-    OTHER: "OTHER";
     BUYER_REQUEST: "BUYER_REQUEST";
     DORMANT: "DORMANT";
     ABUSE: "ABUSE";
+    OTHER: "OTHER";
   }>;
   memo: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -3332,8 +3345,8 @@ export declare function requiresCollection(type: string | null | undefined): boo
 export declare const NO_SHIPPING_BUNDLE_KEY = "none";
 /** 배송비 유형 — 무료·유료·조건부 무료 */
 export declare const deliveryTypeSchema: z.ZodEnum<{
-  PAID: "PAID";
   FREE: "FREE";
+  PAID: "PAID";
   CONDITIONAL_FREE: "CONDITIONAL_FREE";
 }>;
 export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
@@ -3344,8 +3357,8 @@ export declare const productFulfillmentCreateSchema: z.ZodDiscriminatedUnion<[z.
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodOptional<z.ZodObject<{
     deliveryType: z.ZodDefault<z.ZodEnum<{
-      PAID: "PAID";
       FREE: "FREE";
+      PAID: "PAID";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>>;
     deliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -3367,8 +3380,8 @@ export declare const productFulfillmentUpdateSchema: z.ZodDiscriminatedUnion<[z.
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodObject<{
     deliveryType: z.ZodEnum<{
-      PAID: "PAID";
       FREE: "FREE";
+      PAID: "PAID";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>;
     deliveryFee: z.ZodNumber;
@@ -3388,8 +3401,8 @@ export declare const productFulfillmentSchema: z.ZodDiscriminatedUnion<[z.ZodObj
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodObject<{
     deliveryType: z.ZodEnum<{
-      PAID: "PAID";
       FREE: "FREE";
+      PAID: "PAID";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>;
     deliveryFee: z.ZodNumber;
@@ -3427,8 +3440,8 @@ export declare const productFulfillmentResponseSchema: z.ZodUnion<readonly [z.Zo
   type: z.ZodLiteral<"SHIPPING">;
   shipping: z.ZodObject<{
     deliveryType: z.ZodEnum<{
-      PAID: "PAID";
       FREE: "FREE";
+      PAID: "PAID";
       CONDITIONAL_FREE: "CONDITIONAL_FREE";
     }>;
     deliveryFee: z.ZodNumber;
@@ -3478,6 +3491,7 @@ export type OrderItemFulfillmentSnapshotView = z.infer<typeof orderItemFulfillme
 //#region src/schemas/order.d.ts
 export declare const orderSummarySchema: z.ZodObject<{
   orderId: z.ZodString;
+  orderNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   ordererName: z.ZodString;
   itemCount: z.ZodNumber;
   totalAmount: z.ZodNumber;
@@ -3515,6 +3529,7 @@ export declare const orderItemFulfillmentSchema: z.ZodObject<{
 export type OrderItemFulfillment = z.infer<typeof orderItemFulfillmentSchema>;
 export declare const orderItemSchema: z.ZodObject<{
   orderItemId: z.ZodString;
+  orderItemNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   orderId: z.ZodString;
   status: z.ZodEnum<{
     PAID: "PAID";
@@ -3608,6 +3623,7 @@ export declare const orderDiscountSchema: z.ZodObject<{
 export type OrderDiscount = z.infer<typeof orderDiscountSchema>;
 export declare const orderSchema: z.ZodObject<{
   orderId: z.ZodString;
+  orderNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   orderedAt: z.ZodString;
   orderer: z.ZodObject<{
     name: z.ZodString;
@@ -3676,6 +3692,7 @@ export declare const orderSchema: z.ZodObject<{
   testPayment: z.ZodBoolean;
   items: z.ZodArray<z.ZodObject<{
     orderItemId: z.ZodString;
+    orderItemNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     orderId: z.ZodString;
     status: z.ZodEnum<{
       PAID: "PAID";
@@ -3767,6 +3784,7 @@ export declare const orderSummaryPageSchema: z.ZodObject<{
   totalPages: z.ZodNumber;
   contents: z.ZodArray<z.ZodObject<{
     orderId: z.ZodString;
+    orderNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     ordererName: z.ZodString;
     itemCount: z.ZodNumber;
     totalAmount: z.ZodNumber;
@@ -3793,6 +3811,7 @@ export declare const orderItemPageSchema: z.ZodObject<{
   totalPages: z.ZodNumber;
   contents: z.ZodArray<z.ZodObject<{
     orderItemId: z.ZodString;
+    orderItemNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     orderId: z.ZodString;
     status: z.ZodEnum<{
       PAID: "PAID";
@@ -3878,13 +3897,13 @@ export declare const orderItemPageSchema: z.ZodObject<{
 export type OrderItemPage = z.infer<typeof orderItemPageSchema>;
 /**
  * `GET /v1/orders` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열). 검증 규칙은 서버가 적용한다:
- * `orderedFrom` 누락 400 `MISSING_PARAMETER`, 날짜 형식 오류 400 `INVALID_PARAMETER`, 31일 초과 400 `RANGE_TOO_WIDE`,
+ * `orderNo` 없이 `orderedFrom` 누락 400 `MISSING_PARAMETER`, 날짜·`orderNo` 형식 오류 400 `INVALID_PARAMETER`, 31일 초과 400 `RANGE_TOO_WIDE`,
  * `testPayment`가 `true`·`false`가 아니면 400 `INVALID_PARAMETER`
  */
 export declare const orderListQuerySchema: z.ZodObject<{
   size: z.ZodOptional<z.ZodString>;
   page: z.ZodOptional<z.ZodString>;
-  orderedFrom: z.ZodString;
+  orderedFrom: z.ZodOptional<z.ZodString>;
   orderedTo: z.ZodOptional<z.ZodString>;
   status: z.ZodOptional<z.ZodEnum<{
     PAID: "PAID";
@@ -3897,6 +3916,7 @@ export declare const orderListQuerySchema: z.ZodObject<{
     PURCHASE_DECIDED: "PURCHASE_DECIDED";
   }>>;
   keyword: z.ZodOptional<z.ZodString>;
+  orderNo: z.ZodOptional<z.ZodString>;
   fulfillmentType: z.ZodOptional<z.ZodString>;
   testPayment: z.ZodOptional<z.ZodEnum<{
     true: "true";
@@ -3930,7 +3950,10 @@ export declare const orderItemListQuerySchema: z.ZodObject<{
   }>>;
 }, z.core.$strip>;
 export interface OrderListParams extends PageParams {
-  orderedFrom: string;
+  /** 조회 시작 시각 — `orderNo`가 없으면 필수 */
+  orderedFrom?: string;
+  /** 주문번호 조회(이슈 #107) — 주면 기간 없이 그 주문만 찾는다 */
+  orderNo?: string;
   orderedTo?: string;
   status?: z.infer<typeof orderItemStatusSchema>;
   keyword?: string;
@@ -3947,16 +3970,16 @@ export interface OrderItemListParams extends PageParams {
   testPayment?: "true" | "false";
 }
 export declare const deliveryMethodSchema: z.ZodEnum<{
-  DIRECT: "DIRECT";
   COURIER: "COURIER";
+  DIRECT: "DIRECT";
   QUICK: "QUICK";
   NOTHING: "NOTHING";
 }>;
 export type DeliveryMethod = z.infer<typeof deliveryMethodSchema>;
 export declare const dispatchRequestSchema: z.ZodObject<{
   deliveryMethod: z.ZodEnum<{
-    DIRECT: "DIRECT";
     COURIER: "COURIER";
+    DIRECT: "DIRECT";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -3968,8 +3991,8 @@ export type DispatchRequest = z.infer<typeof dispatchRequestSchema>;
 export declare const deliveryInfoSchema: z.ZodObject<{
   orderItemId: z.ZodString;
   deliveryMethod: z.ZodEnum<{
-    DIRECT: "DIRECT";
     COURIER: "COURIER";
+    DIRECT: "DIRECT";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -3995,8 +4018,8 @@ export declare const trackingStageResponseSchema: z.ZodString;
 export declare const deliveryStatusSchema: z.ZodObject<{
   orderItemId: z.ZodString;
   deliveryMethod: z.ZodEnum<{
-    DIRECT: "DIRECT";
     COURIER: "COURIER";
+    DIRECT: "DIRECT";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -4909,6 +4932,7 @@ export declare const paymentRecordSchema: z.ZodObject<{
   testPayment: z.ZodBoolean;
   pgTransactionId: z.ZodNullable<z.ZodString>;
   attemptId: z.ZodNullable<z.ZodString>;
+  pgOrderId: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   attemptCount: z.ZodNumber;
   failCode: z.ZodNullable<z.ZodString>;
   failMessage: z.ZodNullable<z.ZodString>;
@@ -4955,6 +4979,7 @@ export declare const paymentRecordPageSchema: z.ZodObject<{
     testPayment: z.ZodBoolean;
     pgTransactionId: z.ZodNullable<z.ZodString>;
     attemptId: z.ZodNullable<z.ZodString>;
+    pgOrderId: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     attemptCount: z.ZodNumber;
     failCode: z.ZodNullable<z.ZodString>;
     failMessage: z.ZodNullable<z.ZodString>;
@@ -4966,6 +4991,7 @@ export declare const paymentRecordPageSchema: z.ZodObject<{
 export type PaymentRecordPage = z.infer<typeof paymentRecordPageSchema>;
 export declare const paymentAttemptRecordSchema: z.ZodObject<{
   attemptId: z.ZodString;
+  pgOrderId: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   sequence: z.ZodNumber;
   provider: z.ZodEnum<{
     tosspayments: "tosspayments";
@@ -5045,6 +5071,7 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
   testPayment: z.ZodBoolean;
   pgTransactionId: z.ZodNullable<z.ZodString>;
   attemptId: z.ZodNullable<z.ZodString>;
+  pgOrderId: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   attemptCount: z.ZodNumber;
   failCode: z.ZodNullable<z.ZodString>;
   failMessage: z.ZodNullable<z.ZodString>;
@@ -5055,6 +5082,7 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
   merchantId: z.ZodNullable<z.ZodString>;
   attempts: z.ZodArray<z.ZodObject<{
     attemptId: z.ZodString;
+    pgOrderId: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     sequence: z.ZodNumber;
     provider: z.ZodEnum<{
       tosspayments: "tosspayments";
@@ -5342,11 +5370,11 @@ export type PointEntry = z.infer<typeof pointEntrySchema>;
 export declare const pointLotSchema: z.ZodObject<{
   lotId: z.ZodString;
   source: z.ZodUnion<readonly [z.ZodEnum<{
-    PURCHASE: "PURCHASE";
     REFUND_RESTORE: "REFUND_RESTORE";
     ADJUST: "ADJUST";
     OPENING: "OPENING";
     REVIEW: "REVIEW";
+    PURCHASE: "PURCHASE";
   }>, z.ZodString]>;
   amount: z.ZodNumber;
   remaining: z.ZodNumber;
@@ -5361,11 +5389,11 @@ export declare const customerPointsSchema: z.ZodObject<{
   lots: z.ZodArray<z.ZodObject<{
     lotId: z.ZodString;
     source: z.ZodUnion<readonly [z.ZodEnum<{
-      PURCHASE: "PURCHASE";
       REFUND_RESTORE: "REFUND_RESTORE";
       ADJUST: "ADJUST";
       OPENING: "OPENING";
       REVIEW: "REVIEW";
+      PURCHASE: "PURCHASE";
     }>, z.ZodString]>;
     amount: z.ZodNumber;
     remaining: z.ZodNumber;
@@ -5458,6 +5486,7 @@ export declare const productStatusSchema: z.ZodEnum<{
 export type ProductStatus = z.infer<typeof productStatusSchema>;
 export declare const productSummarySchema: z.ZodObject<{
   productId: z.ZodString;
+  productNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
   name: z.ZodString;
   status: z.ZodEnum<{
     SALE: "SALE";
@@ -5503,6 +5532,7 @@ export type OptionGroup = z.infer<typeof optionGroupSchema>;
  */
 export declare const productVariantSchema: z.ZodObject<{
   variantId: z.ZodString;
+  variantNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   valueIds: z.ZodArray<z.ZodString>;
   name: z.ZodString;
   additionalPrice: z.ZodNumber;
@@ -5645,6 +5675,7 @@ export declare const discountSchema: z.ZodObject<{
 export type Discount = z.infer<typeof discountSchema>;
 export declare const productSchema: z.ZodObject<{
   productId: z.ZodString;
+  productNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
   name: z.ZodString;
   status: z.ZodEnum<{
     SALE: "SALE";
@@ -5681,6 +5712,7 @@ export declare const productSchema: z.ZodObject<{
   }, z.core.$strip>>;
   variants: z.ZodArray<z.ZodObject<{
     variantId: z.ZodString;
+    variantNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     valueIds: z.ZodArray<z.ZodString>;
     name: z.ZodString;
     additionalPrice: z.ZodNumber;
@@ -5725,8 +5757,8 @@ export declare const productSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodObject<{
       deliveryType: z.ZodEnum<{
-        PAID: "PAID";
         FREE: "FREE";
+        PAID: "PAID";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>;
       deliveryFee: z.ZodNumber;
@@ -5881,6 +5913,7 @@ export declare const optionModelSchema: z.ZodObject<{
   }, z.core.$strip>>;
   variants: z.ZodArray<z.ZodObject<{
     variantId: z.ZodString;
+    variantNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     valueIds: z.ZodArray<z.ZodString>;
     name: z.ZodString;
     additionalPrice: z.ZodNumber;
@@ -5948,8 +5981,8 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodOptional<z.ZodObject<{
       deliveryType: z.ZodDefault<z.ZodEnum<{
-        PAID: "PAID";
         FREE: "FREE";
+        PAID: "PAID";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>>;
       deliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -6034,8 +6067,8 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodObject<{
       deliveryType: z.ZodEnum<{
-        PAID: "PAID";
         FREE: "FREE";
+        PAID: "PAID";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>;
       deliveryFee: z.ZodNumber;
@@ -6128,8 +6161,8 @@ export declare const productPatchRequestSchema: z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
     shipping: z.ZodObject<{
       deliveryType: z.ZodEnum<{
-        PAID: "PAID";
         FREE: "FREE";
+        PAID: "PAID";
         CONDITIONAL_FREE: "CONDITIONAL_FREE";
       }>;
       deliveryFee: z.ZodNumber;
@@ -6163,6 +6196,8 @@ export interface ProductListParams extends PageParams {
   categoryId?: string;
   keyword?: string;
   sellerCode?: string;
+  /** 상품번호(이슈 #107, 상점 범위) — 그 상품만 */
+  productNo?: number;
   sort?: ProductSort;
 }
 /** `GET /v1/products` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
@@ -6178,6 +6213,7 @@ export declare const productListQuerySchema: z.ZodObject<{
   categoryId: z.ZodOptional<z.ZodString>;
   keyword: z.ZodOptional<z.ZodString>;
   sellerCode: z.ZodOptional<z.ZodString>;
+  productNo: z.ZodOptional<z.ZodString>;
   sort: z.ZodOptional<z.ZodEnum<{
     "createdAt.desc": "createdAt.desc";
     "createdAt.asc": "createdAt.asc";
@@ -7090,9 +7126,9 @@ export type StorefrontDeploymentLog = z.infer<typeof storefrontDeploymentLogSche
 export declare const storefrontDeploymentSchema: z.ZodObject<{
   siteId: z.ZodString;
   status: z.ZodEnum<{
-    IN_PROGRESS: "IN_PROGRESS";
     FAILED: "FAILED";
     SUCCEEDED: "SUCCEEDED";
+    IN_PROGRESS: "IN_PROGRESS";
   }>;
   url: z.ZodString;
   startedAt: z.ZodString;
@@ -7550,8 +7586,8 @@ export declare const runStorefrontCheckRequestSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type RunStorefrontCheckRequest = z.infer<typeof runStorefrontCheckRequestSchema>;
 export declare const storefrontCheckStatusSchema: z.ZodEnum<{
-  UNKNOWN: "UNKNOWN";
   FAILED: "FAILED";
+  UNKNOWN: "UNKNOWN";
   RUNNING: "RUNNING";
   QUEUED: "QUEUED";
   PASSED: "PASSED";
@@ -7564,8 +7600,8 @@ export declare const storefrontCheckSchema: z.ZodObject<{
   checkId: z.ZodString;
   check: z.ZodString;
   status: z.ZodEnum<{
-    UNKNOWN: "UNKNOWN";
     FAILED: "FAILED";
+    UNKNOWN: "UNKNOWN";
     RUNNING: "RUNNING";
     QUEUED: "QUEUED";
     PASSED: "PASSED";
@@ -8310,6 +8346,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       totalPages: number;
       contents: {
         productId: string;
+        productNo: number | null;
         name: string;
         status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
         salePrice: number;
@@ -8327,6 +8364,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     get: (productId: string) => Promise<{
       productId: string;
+      productNo: number | null;
       name: string;
       status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
       salePrice: number;
@@ -8348,6 +8386,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       variants: {
         variantId: string;
+        variantNo: string | null;
         valueIds: string[];
         name: string;
         additionalPrice: number;
@@ -8386,7 +8425,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
-          deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
           deliveryFee: number;
           conditionalFreeAmount: number | null;
           shippingAddressId: string | null;
@@ -8425,6 +8464,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     create: (body: ProductCreateRequestInput, idempotencyKey?: string) => Promise<{
       productId: string;
+      productNo: number | null;
       name: string;
       status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
       salePrice: number;
@@ -8446,6 +8486,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       variants: {
         variantId: string;
+        variantNo: string | null;
         valueIds: string[];
         name: string;
         additionalPrice: number;
@@ -8484,7 +8525,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
-          deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
           deliveryFee: number;
           conditionalFreeAmount: number | null;
           shippingAddressId: string | null;
@@ -8523,6 +8564,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     update: (productId: string, body: ProductReplaceRequestInput) => Promise<{
       productId: string;
+      productNo: number | null;
       name: string;
       status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
       salePrice: number;
@@ -8544,6 +8586,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       variants: {
         variantId: string;
+        variantNo: string | null;
         valueIds: string[];
         name: string;
         additionalPrice: number;
@@ -8582,7 +8625,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
-          deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
+          deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
           deliveryFee: number;
           conditionalFreeAmount: number | null;
           shippingAddressId: string | null;
@@ -8645,6 +8688,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       variants: {
         variantId: string;
+        variantNo: string | null;
         valueIds: string[];
         name: string;
         additionalPrice: number;
@@ -8698,6 +8742,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       variants: {
         variantId: string;
+        variantNo: string | null;
         valueIds: string[];
         name: string;
         additionalPrice: number;
@@ -8924,7 +8969,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           value: true;
         } | {
           field: "bestSelling";
-          days: 7 | 30 | 90;
+          days: 30 | 7 | 90;
           top: number;
         } | {
           [x: string]: unknown;
@@ -8974,7 +9019,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: true;
       } | {
         field: "bestSelling";
-        days: 7 | 30 | 90;
+        days: 30 | 7 | 90;
         top: number;
       } | {
         [x: string]: unknown;
@@ -9017,7 +9062,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: true;
       } | {
         field: "bestSelling";
-        days: 7 | 30 | 90;
+        days: 30 | 7 | 90;
         top: number;
       } | {
         [x: string]: unknown;
@@ -9059,7 +9104,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: true;
       } | {
         field: "bestSelling";
-        days: 7 | 30 | 90;
+        days: 30 | 7 | 90;
         top: number;
       } | {
         [x: string]: unknown;
@@ -9122,7 +9167,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: true;
       } | {
         field: "bestSelling";
-        days: 7 | 30 | 90;
+        days: 30 | 7 | 90;
         top: number;
       } | {
         [x: string]: unknown;
@@ -9165,7 +9210,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: true;
       } | {
         field: "bestSelling";
-        days: 7 | 30 | 90;
+        days: 30 | 7 | 90;
         top: number;
       } | {
         [x: string]: unknown;
@@ -9365,6 +9410,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       totalPages: number;
       contents: {
         orderId: string;
+        orderNo: string | null;
         ordererName: string;
         itemCount: number;
         totalAmount: number;
@@ -9375,6 +9421,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     get: (orderId: string) => Promise<{
       orderId: string;
+      orderNo: string | null;
       orderedAt: string;
       orderer: {
         name: string;
@@ -9433,6 +9480,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       testPayment: boolean;
       items: {
         orderItemId: string;
+        orderItemNo: string | null;
         orderId: string;
         status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
         claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
@@ -9519,6 +9567,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       totalPages: number;
       contents: {
         orderItemId: string;
+        orderItemNo: string | null;
         orderId: string;
         status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
         claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
@@ -9606,7 +9655,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     dispatch: (orderItemId: string, body: DispatchRequest, idempotencyKey?: string) => Promise<{
       orderItemId: string;
-      deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
+      deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
       carrierCode: string | null;
       carrierName: string | null;
       trackingNumber: string | null;
@@ -9634,6 +9683,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
      */
     markDelivered: (orderItemId: string, idempotencyKey?: string) => Promise<{
       orderItemId: string;
+      orderItemNo: string | null;
       orderId: string;
       status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
       claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
@@ -9703,6 +9753,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
      */
     fulfill: (orderItemId: string, body?: FulfillRequest, idempotencyKey?: string) => Promise<{
       orderItemId: string;
+      orderItemNo: string | null;
       orderId: string;
       status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
       claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
@@ -9768,7 +9819,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     getDelivery: (orderItemId: string) => Promise<{
       orderItemId: string;
-      deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
+      deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
       carrierCode: string | null;
       carrierName: string | null;
       trackingNumber: string | null;
@@ -9805,8 +9856,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
       totalPages: number;
       contents: {
         claimId: string;
+        claimNo: string | null;
         type: "RETURN" | "EXCHANGE" | "CANCEL";
-        status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+        status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
         orderId: string;
         orderItemId: string;
         productName: string;
@@ -9844,8 +9896,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     get: (claimId: string) => Promise<{
       claimId: string;
+      claimNo: string | null;
       type: "RETURN" | "EXCHANGE" | "CANCEL";
-      status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+      status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
       orderId: string;
       orderItemId: string;
       productName: string;
@@ -9880,7 +9933,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         address2: string | null;
       } | null;
       histories?: {
-        status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+        status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
         actor: "SYSTEM" | "BUYER" | "SELLER";
         occurredAt: string;
       }[] | undefined;
@@ -9912,8 +9965,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
     /** 교환 완료 — 재배송 중인 교환을 셀러가 명시적으로 끝낸다 */
     completeExchange: (claimId: string) => Promise<{
       claimId: string;
+      claimNo: string | null;
       type: "RETURN" | "EXCHANGE" | "CANCEL";
-      status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
+      status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
       orderId: string;
       orderItemId: string;
       productName: string;
@@ -10282,7 +10336,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         version: string | null;
         documentUrl: string | null;
         action: "WITHDRAWN" | "AGREED";
-        source: "SELLER" | "SIGNUP" | "SOCIAL_SIGNUP" | "DELEGATED" | "RECONSENT" | "MEMBER_UPDATE";
+        source: "SIGNUP" | "SELLER" | "SOCIAL_SIGNUP" | "DELEGATED" | "RECONSENT" | "MEMBER_UPDATE";
         occurredAt: string;
       }[];
     }>;
@@ -10305,6 +10359,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: number;
         maxDiscountAmount: number | null;
       };
+      source?: string | undefined;
     }[]>;
     withdraw: (customerId: string, body: WithdrawCustomerRequest) => Promise<void>;
   };
@@ -10626,6 +10681,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         usedOrderId: string | null;
         issuedAt: string;
         revokedAt: string | null;
+        source?: string | undefined;
       }[];
     }>;
     redemptions: (couponId: string, params?: PageParams & {
@@ -10673,6 +10729,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       usedOrderId: string | null;
       issuedAt: string;
       revokedAt: string | null;
+      source?: string | undefined;
     }>;
   };
   customerInquiries: {
@@ -10834,7 +10891,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         conversionRate: number | null;
       };
       funnel: {
-        step: "SESSION" | "PRODUCT_VIEW" | "ADD_TO_CART" | "BEGIN_CHECKOUT" | "PURCHASE";
+        step: "PURCHASE" | "SESSION" | "PRODUCT_VIEW" | "ADD_TO_CART" | "BEGIN_CHECKOUT";
         sessions: number;
         rateFromPrevious: number | null;
       }[];
@@ -10888,9 +10945,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     /** `GET /v1/analytics/sources` — 채널·소스·캠페인·기기별 세션과 구매 */
     sources: (params: AnalyticsSourcesParams) => Promise<{
-      groupBy: "CAMPAIGN" | "CHANNEL" | "SOURCE" | "DEVICE";
+      groupBy: "CHANNEL" | "SOURCE" | "CAMPAIGN" | "DEVICE";
       rows: {
-        channel: "DIRECT" | "ORGANIC_SEARCH" | "SOCIAL" | "PAID" | "EMAIL" | "CAMPAIGN" | "REFERRAL" | "UNKNOWN" | null;
+        channel: "PAID" | "DIRECT" | "CAMPAIGN" | "UNKNOWN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | null;
         source: string | null;
         medium: string | null;
         campaign: string | null;
@@ -10995,7 +11052,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     checkout: (params: AnalyticsRangeParams) => Promise<{
       sessions: number;
       outcomes: {
-        outcome: "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "OTHER" | "IN_PROGRESS";
+        outcome: "OTHER" | "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "IN_PROGRESS";
         sessions: number;
       }[];
       from: string;
@@ -11035,6 +11092,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         testPayment: boolean;
         pgTransactionId: string | null;
         attemptId: string | null;
+        pgOrderId: string | null;
         attemptCount: number;
         failCode: string | null;
         failMessage: string | null;
@@ -11059,6 +11117,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       testPayment: boolean;
       pgTransactionId: string | null;
       attemptId: string | null;
+      pgOrderId: string | null;
       attemptCount: number;
       failCode: string | null;
       failMessage: string | null;
@@ -11069,6 +11128,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       merchantId: string | null;
       attempts: {
         attemptId: string;
+        pgOrderId: string | null;
         sequence: number;
         provider: "tosspayments" | "portone";
         status: string;
@@ -12096,7 +12156,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     list: (params?: ApprovalListOptions) => Promise<{
       items: {
         approvalId: string;
-        status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
+        status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
         operationId: string;
         method: string;
         path: string;
@@ -12146,7 +12206,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     get: (approvalId: string) => Promise<{
       approvalId: string;
-      status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
+      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -12198,7 +12258,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
      */
     approve: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
+      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -12246,7 +12306,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     reject: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
       approvalId: string;
-      status: "UNKNOWN" | "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "REJECTED" | "EXPIRED";
+      status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
       operationId: string;
       method: string;
       path: string;
@@ -12490,7 +12550,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     /** `GET /v1/storefront/site/deployment` — 배포 진행(단계·기록). 만든 뒤 반영이 끝날 때까지 폴링한다 */
     getDeployment: () => Promise<{
       siteId: string;
-      status: "IN_PROGRESS" | "FAILED" | "SUCCEEDED";
+      status: "FAILED" | "SUCCEEDED" | "IN_PROGRESS";
       url: string;
       startedAt: string;
       finishedAt: string | null;
@@ -12512,7 +12572,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     /** `POST /v1/storefront/site/deployment/retry` (202) — 밀린 반영을 곧바로 다시 시도한다. 이미 반영됐으면 그대로다 */
     retryDeployment: () => Promise<{
       siteId: string;
-      status: "IN_PROGRESS" | "FAILED" | "SUCCEEDED";
+      status: "FAILED" | "SUCCEEDED" | "IN_PROGRESS";
       url: string;
       startedAt: string;
       finishedAt: string | null;
@@ -13087,7 +13147,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     runCheck: (body: RunStorefrontCheckRequest) => Promise<{
       checkId: string;
       check: string;
-      status: "UNKNOWN" | "FAILED" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
+      status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
       exitCode: number | null;
       durationMs: number | null;
       outputTail: string | null;
@@ -13101,7 +13161,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     getCheck: (checkId: string) => Promise<{
       checkId: string;
       check: string;
-      status: "UNKNOWN" | "FAILED" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
+      status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
       exitCode: number | null;
       durationMs: number | null;
       outputTail: string | null;
@@ -13850,6 +13910,22 @@ export declare function refreshUserToken(options: {
   fetch?: typeof globalThis.fetch;
 }): Promise<OAuthTokenResponse>;
 //#endregion
+//#region src/schemas/commerce-number.d.ts
+/**
+ * 국내 쇼핑몰 번호 체계(이슈 #107) — 공개 ID(`ord_…` 등)와 따로 싣는 숫자 번호의 표기·필드.
+ * 번호는 서버가 만들고 생성 후 바뀌지 않는다. 새 필드라 옛 서버 응답에는 없다 — 파싱은 null로 채운다.
+ */
+/**
+ * 번호 표기 — 숫자를 앞에서부터 4자리씩 하이픈으로 나눈다. 주문번호 `26100284731592` → `2610-0284-7315-92`,
+ * 상품주문번호 `2610028473159201` → `2610-0284-7315-9201`. 숫자만으로 된 값이 아니면(클레임번호 `C…`) 그대로, 없으면 빈 문자열이다.
+ * 화면 표기 전용이다 — API에 보낼 때는 원래 값을 쓴다(주문번호 조회는 하이픈도 받는다)
+ */
+export declare function formatOrderNo(no: string | null | undefined): string;
+/** 표기 하이픈·공백을 지운 숫자 번호. 숫자가 아닌 글자가 남거나 비면 null */
+export declare function parseOrderNo(value: string): string | null;
+/** 응답 번호 필드 — 서버는 항상 싣고, 번호 체계 이전 행(백필 전)·옛 서버 응답은 null이다 */
+export declare function commerceNumberField(description: string): z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+//#endregion
 //#region src/schemas/customer-delegation.d.ts
 export declare const customerDelegationRequestSchema: z.ZodObject<{
   uid: z.ZodOptional<z.ZodString>;
@@ -14959,6 +15035,7 @@ export type McpToolEvent = z.infer<typeof mcpToolEventSchema>;
 //#region src/schemas/webhook-event.d.ts
 export declare const orderWebhookEventDataSchema: z.ZodObject<{
   orderId: z.ZodString;
+  orderNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   status: z.ZodEnum<{
     PAID: "PAID";
     CANCELED: "CANCELED";
@@ -15008,6 +15085,7 @@ export type OrderWebhookEventData = z.infer<typeof orderWebhookEventDataSchema>;
  */
 export declare const orderFulfilledWebhookEventDataSchema: z.ZodObject<{
   orderId: z.ZodString;
+  orderNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   orderItemId: z.ZodString;
   status: z.ZodEnum<{
     PAID: "PAID";
@@ -15047,6 +15125,7 @@ export type OrderFulfilledWebhookEventData = z.infer<typeof orderFulfilledWebhoo
  */
 export declare const orderCanceledWebhookEventDataSchema: z.ZodObject<{
   orderId: z.ZodString;
+  orderNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   orderItemId: z.ZodString;
   status: z.ZodEnum<{
     PAID: "PAID";
@@ -15082,6 +15161,7 @@ export declare const orderCanceledWebhookEventDataSchema: z.ZodObject<{
 export type OrderCanceledWebhookEventData = z.infer<typeof orderCanceledWebhookEventDataSchema>;
 export declare const claimWebhookEventDataSchema: z.ZodObject<{
   claimId: z.ZodString;
+  claimNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   orderId: z.ZodString;
   orderItemId: z.ZodString;
   claimType: z.ZodEnum<{
@@ -15090,7 +15170,6 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
-    COMPLETED: "COMPLETED";
     REJECTED: "REJECTED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
@@ -15098,6 +15177,7 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
+    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -15138,6 +15218,7 @@ export declare const orderWebhookEventSchema: z.ZodObject<{
   }>;
   data: z.ZodObject<{
     orderId: z.ZodString;
+    orderNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     status: z.ZodEnum<{
       PAID: "PAID";
       CANCELED: "CANCELED";
@@ -15189,6 +15270,7 @@ export declare const orderFulfilledWebhookEventSchema: z.ZodObject<{
   type: z.ZodLiteral<"ORDER.FULFILLED">;
   data: z.ZodObject<{
     orderId: z.ZodString;
+    orderNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     orderItemId: z.ZodString;
     status: z.ZodEnum<{
       PAID: "PAID";
@@ -15229,6 +15311,7 @@ export declare const orderCanceledWebhookEventSchema: z.ZodObject<{
   type: z.ZodLiteral<"ORDER.CANCELED">;
   data: z.ZodObject<{
     orderId: z.ZodString;
+    orderNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     orderItemId: z.ZodString;
     status: z.ZodEnum<{
       PAID: "PAID";
@@ -15275,6 +15358,7 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
   }>;
   data: z.ZodObject<{
     claimId: z.ZodString;
+    claimNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     orderId: z.ZodString;
     orderItemId: z.ZodString;
     claimType: z.ZodEnum<{
@@ -15283,7 +15367,6 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
       CANCEL: "CANCEL";
     }>;
     status: z.ZodEnum<{
-      COMPLETED: "COMPLETED";
       REJECTED: "REJECTED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
@@ -15291,6 +15374,7 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
+      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -15354,6 +15438,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   }>;
   data: z.ZodObject<{
     orderId: z.ZodString;
+    orderNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     status: z.ZodEnum<{
       PAID: "PAID";
       CANCELED: "CANCELED";
@@ -15404,6 +15489,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   type: z.ZodLiteral<"ORDER.FULFILLED">;
   data: z.ZodObject<{
     orderId: z.ZodString;
+    orderNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     orderItemId: z.ZodString;
     status: z.ZodEnum<{
       PAID: "PAID";
@@ -15443,6 +15529,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   type: z.ZodLiteral<"ORDER.CANCELED">;
   data: z.ZodObject<{
     orderId: z.ZodString;
+    orderNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     orderItemId: z.ZodString;
     status: z.ZodEnum<{
       PAID: "PAID";
@@ -15488,6 +15575,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   }>;
   data: z.ZodObject<{
     claimId: z.ZodString;
+    claimNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     orderId: z.ZodString;
     orderItemId: z.ZodString;
     claimType: z.ZodEnum<{
@@ -15496,7 +15584,6 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       CANCEL: "CANCEL";
     }>;
     status: z.ZodEnum<{
-      COMPLETED: "COMPLETED";
       REJECTED: "REJECTED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
@@ -15504,6 +15591,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
+      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;