@sayren/store-sdk 0.12.0 → 0.13.0

package/dist/index.d.mts

@@ -182,20 +182,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";
   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>;
@@ -207,21 +207,21 @@ 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";
     ORGANIC_SEARCH: "ORGANIC_SEARCH";
     SOCIAL: "SOCIAL";
+    PAID: "PAID";
     EMAIL: "EMAIL";
+    CAMPAIGN: "CAMPAIGN";
     REFERRAL: "REFERRAL";
     UNKNOWN: "UNKNOWN";
   }>>;
@@ -245,19 +245,19 @@ 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";
       ORGANIC_SEARCH: "ORGANIC_SEARCH";
       SOCIAL: "SOCIAL";
+      PAID: "PAID";
       EMAIL: "EMAIL";
+      CAMPAIGN: "CAMPAIGN";
       REFERRAL: "REFERRAL";
       UNKNOWN: "UNKNOWN";
     }>>;
@@ -408,12 +408,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>;
@@ -421,12 +421,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;
@@ -522,8 +522,8 @@ export declare const oauthClientRegistrationRequestSchema: z.ZodObject<{
   }>>;
   redirect_uris: z.ZodOptional<z.ZodArray<z.ZodString>>;
   grant_types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-    authorization_code: "authorization_code";
     refresh_token: "refresh_token";
+    authorization_code: "authorization_code";
     client_credentials: "client_credentials";
     "urn:ietf:params:oauth:grant-type:token-exchange": "urn:ietf:params:oauth:grant-type:token-exchange";
   }>>>;
@@ -1051,11 +1051,11 @@ export declare const changeTypeSchema: z.ZodEnum<{
   "ORDER.DISPATCHED": "ORDER.DISPATCHED";
   "ORDER.DELIVERED": "ORDER.DELIVERED";
   "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
-  "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
   "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
   "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
   "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
   "CLAIM.COMPLETED": "CLAIM.COMPLETED";
+  "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
 }>;
 export type ChangeType = z.infer<typeof changeTypeSchema>;
 //#endregion
@@ -1067,6 +1067,7 @@ export declare const claimTypeSchema: z.ZodEnum<{
 }>;
 export type ClaimType = z.infer<typeof claimTypeSchema>;
 export declare const claimStatusSchema: z.ZodEnum<{
+  COMPLETED: "COMPLETED";
   REQUESTED: "REQUESTED";
   HELD: "HELD";
   COLLECTING: "COLLECTING";
@@ -1074,7 +1075,6 @@ export declare const claimStatusSchema: z.ZodEnum<{
   REDELIVERING: "REDELIVERING";
   APPROVED: "APPROVED";
   REJECTED: "REJECTED";
-  COMPLETED: "COMPLETED";
   WITHDRAWN: "WITHDRAWN";
 }>;
 export type ClaimStatus = z.infer<typeof claimStatusSchema>;
@@ -1111,6 +1111,7 @@ export declare const claimSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
+    COMPLETED: "COMPLETED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
     COLLECTING: "COLLECTING";
@@ -1118,7 +1119,6 @@ export declare const claimSchema: z.ZodObject<{
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
     REJECTED: "REJECTED";
-    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderId: z.ZodString;
@@ -1198,6 +1198,7 @@ export declare const claimDetailSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
+    COMPLETED: "COMPLETED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
     COLLECTING: "COLLECTING";
@@ -1205,7 +1206,6 @@ export declare const claimDetailSchema: z.ZodObject<{
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
     REJECTED: "REJECTED";
-    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderId: z.ZodString;
@@ -1254,6 +1254,7 @@ export declare const claimDetailSchema: z.ZodObject<{
   }, z.core.$strip>>;
   histories: z.ZodOptional<z.ZodArray<z.ZodObject<{
     status: z.ZodEnum<{
+      COMPLETED: "COMPLETED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
       COLLECTING: "COLLECTING";
@@ -1261,7 +1262,6 @@ export declare const claimDetailSchema: z.ZodObject<{
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
       REJECTED: "REJECTED";
-      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     actor: z.ZodEnum<{
@@ -1592,10 +1592,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>;
@@ -1869,11 +1869,11 @@ export declare const eventTypeSchema: z.ZodEnum<{
   "ORDER.DISPATCHED": "ORDER.DISPATCHED";
   "ORDER.DELIVERED": "ORDER.DELIVERED";
   "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
-  "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
   "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
   "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
   "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
   "CLAIM.COMPLETED": "CLAIM.COMPLETED";
+  "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
   "INQUIRY.CREATED": "INQUIRY.CREATED";
   "REVIEW.CREATED": "REVIEW.CREATED";
   "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
@@ -1893,11 +1893,11 @@ export declare const webhookSchema: z.ZodObject<{
     "ORDER.DISPATCHED": "ORDER.DISPATCHED";
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
-    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
     "CLAIM.COMPLETED": "CLAIM.COMPLETED";
+    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "INQUIRY.CREATED": "INQUIRY.CREATED";
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
@@ -1921,11 +1921,11 @@ export declare const webhookCreatedSchema: z.ZodObject<{
     "ORDER.DISPATCHED": "ORDER.DISPATCHED";
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
-    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
     "CLAIM.COMPLETED": "CLAIM.COMPLETED";
+    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "INQUIRY.CREATED": "INQUIRY.CREATED";
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
@@ -1999,11 +1999,11 @@ export declare const webhookDeliverySchema: z.ZodObject<{
     "ORDER.DISPATCHED": "ORDER.DISPATCHED";
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
-    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
     "CLAIM.COMPLETED": "CLAIM.COMPLETED";
+    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "INQUIRY.CREATED": "INQUIRY.CREATED";
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
@@ -2050,11 +2050,11 @@ export declare const webhookDeliveryDetailSchema: z.ZodObject<{
     "ORDER.DISPATCHED": "ORDER.DISPATCHED";
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
-    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
     "CLAIM.COMPLETED": "CLAIM.COMPLETED";
+    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "INQUIRY.CREATED": "INQUIRY.CREATED";
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
@@ -2110,11 +2110,11 @@ export declare const webhookDeliveryListQuerySchema: z.ZodObject<{
     "ORDER.DISPATCHED": "ORDER.DISPATCHED";
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
-    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
     "CLAIM.COMPLETED": "CLAIM.COMPLETED";
+    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "INQUIRY.CREATED": "INQUIRY.CREATED";
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
@@ -2135,11 +2135,11 @@ export declare const webhookTestRequestSchema: z.ZodObject<{
     "ORDER.DISPATCHED": "ORDER.DISPATCHED";
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
-    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
     "CLAIM.COMPLETED": "CLAIM.COMPLETED";
+    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "INQUIRY.CREATED": "INQUIRY.CREATED";
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
@@ -2174,11 +2174,11 @@ export declare const webhookRequestSchema: z.ZodObject<{
     "ORDER.DISPATCHED": "ORDER.DISPATCHED";
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
-    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
     "CLAIM.COMPLETED": "CLAIM.COMPLETED";
+    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "INQUIRY.CREATED": "INQUIRY.CREATED";
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
@@ -2327,11 +2327,11 @@ export declare const orderItemSchema: z.ZodObject<{
     "ORDER.DISPATCHED": "ORDER.DISPATCHED";
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
-    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
     "CLAIM.COMPLETED": "CLAIM.COMPLETED";
+    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
   }>;
   testPayment: z.ZodBoolean;
 }, z.core.$strip>;
@@ -2436,11 +2436,11 @@ export declare const orderSchema: z.ZodObject<{
       "ORDER.DISPATCHED": "ORDER.DISPATCHED";
       "ORDER.DELIVERED": "ORDER.DELIVERED";
       "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
-      "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
       "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
       "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
       "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
       "CLAIM.COMPLETED": "CLAIM.COMPLETED";
+      "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     }>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>>;
@@ -2521,11 +2521,11 @@ export declare const orderItemPageSchema: z.ZodObject<{
       "ORDER.DISPATCHED": "ORDER.DISPATCHED";
       "ORDER.DELIVERED": "ORDER.DELIVERED";
       "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
-      "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
       "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
       "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
       "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
       "CLAIM.COMPLETED": "CLAIM.COMPLETED";
+      "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     }>;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>>;
@@ -2572,11 +2572,11 @@ export declare const orderItemListQuerySchema: z.ZodObject<{
     "ORDER.DISPATCHED": "ORDER.DISPATCHED";
     "ORDER.DELIVERED": "ORDER.DELIVERED";
     "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
-    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
     "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
     "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
     "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
     "CLAIM.COMPLETED": "CLAIM.COMPLETED";
+    "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
   }>>;
   testPayment: z.ZodOptional<z.ZodEnum<{
     true: "true";
@@ -2599,16 +2599,16 @@ export interface OrderItemListParams extends PageParams {
   testPayment?: "true" | "false";
 }
 export declare const deliveryMethodSchema: z.ZodEnum<{
-  COURIER: "COURIER";
   DIRECT: "DIRECT";
+  COURIER: "COURIER";
   QUICK: "QUICK";
   NOTHING: "NOTHING";
 }>;
 export type DeliveryMethod = z.infer<typeof deliveryMethodSchema>;
 export declare const dispatchRequestSchema: z.ZodObject<{
   deliveryMethod: z.ZodEnum<{
-    COURIER: "COURIER";
     DIRECT: "DIRECT";
+    COURIER: "COURIER";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -2620,8 +2620,8 @@ export type DispatchRequest = z.infer<typeof dispatchRequestSchema>;
 export declare const deliveryInfoSchema: z.ZodObject<{
   orderItemId: z.ZodString;
   deliveryMethod: z.ZodEnum<{
-    COURIER: "COURIER";
     DIRECT: "DIRECT";
+    COURIER: "COURIER";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -2647,8 +2647,8 @@ export declare const trackingStageResponseSchema: z.ZodString;
 export declare const deliveryStatusSchema: z.ZodObject<{
   orderItemId: z.ZodString;
   deliveryMethod: z.ZodEnum<{
-    COURIER: "COURIER";
     DIRECT: "DIRECT";
+    COURIER: "COURIER";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -3756,15 +3756,15 @@ export interface PaymentListParams extends PageParams {
 //#endregion
 //#region src/schemas/product.d.ts
 export declare const productStatusSchema: z.ZodEnum<{
-  SALE: "SALE";
   SUSPENDED: "SUSPENDED";
-  OUT_OF_STOCK: "OUT_OF_STOCK";
   CLOSED: "CLOSED";
+  SALE: "SALE";
+  OUT_OF_STOCK: "OUT_OF_STOCK";
 }>;
 export type ProductStatus = z.infer<typeof productStatusSchema>;
 export declare const deliveryTypeSchema: z.ZodEnum<{
-  FREE: "FREE";
   PAID: "PAID";
+  FREE: "FREE";
   CONDITIONAL_FREE: "CONDITIONAL_FREE";
 }>;
 export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
@@ -3772,10 +3772,10 @@ export declare const productSummarySchema: z.ZodObject<{
   productId: z.ZodString;
   name: z.ZodString;
   status: z.ZodEnum<{
-    SALE: "SALE";
     SUSPENDED: "SUSPENDED";
-    OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
+    SALE: "SALE";
+    OUT_OF_STOCK: "OUT_OF_STOCK";
   }>;
   salePrice: z.ZodNumber;
   discountedPrice: z.ZodNullable<z.ZodNumber>;
@@ -3827,10 +3827,10 @@ export declare const productSchema: z.ZodObject<{
   productId: z.ZodString;
   name: z.ZodString;
   status: z.ZodEnum<{
-    SALE: "SALE";
     SUSPENDED: "SUSPENDED";
-    OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
+    SALE: "SALE";
+    OUT_OF_STOCK: "OUT_OF_STOCK";
   }>;
   salePrice: z.ZodNumber;
   discountedPrice: z.ZodNullable<z.ZodNumber>;
@@ -3871,8 +3871,8 @@ export declare const productSchema: z.ZodObject<{
     usable: z.ZodBoolean;
   }, z.core.$strip>>;
   deliveryType: z.ZodOptional<z.ZodEnum<{
-    FREE: "FREE";
     PAID: "PAID";
+    FREE: "FREE";
     CONDITIONAL_FREE: "CONDITIONAL_FREE";
   }>>;
   deliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -4035,8 +4035,8 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     value: z.ZodString;
   }, z.core.$strip>>>;
   deliveryType: z.ZodDefault<z.ZodEnum<{
-    FREE: "FREE";
     PAID: "PAID";
+    FREE: "FREE";
     CONDITIONAL_FREE: "CONDITIONAL_FREE";
   }>>;
   deliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -4078,10 +4078,10 @@ export declare const productPatchRequestSchema: z.ZodObject<{
   name: z.ZodOptional<z.ZodString>;
   salePrice: z.ZodOptional<z.ZodNumber>;
   status: z.ZodOptional<z.ZodEnum<{
-    SALE: "SALE";
     SUSPENDED: "SUSPENDED";
-    OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
+    SALE: "SALE";
+    OUT_OF_STOCK: "OUT_OF_STOCK";
   }>>;
   deliveryFee: z.ZodOptional<z.ZodNumber>;
   shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -4108,10 +4108,10 @@ export declare const productListQuerySchema: z.ZodObject<{
   page: z.ZodOptional<z.ZodString>;
   size: z.ZodOptional<z.ZodString>;
   status: z.ZodOptional<z.ZodEnum<{
-    SALE: "SALE";
     SUSPENDED: "SUSPENDED";
-    OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
+    SALE: "SALE";
+    OUT_OF_STOCK: "OUT_OF_STOCK";
   }>>;
   categoryId: z.ZodOptional<z.ZodString>;
   keyword: z.ZodOptional<z.ZodString>;
@@ -4270,8 +4270,8 @@ export declare const invitationSchema: z.ZodObject<{
     STAFF: "STAFF";
   }>;
   status: z.ZodEnum<{
-    PENDING: "PENDING";
     CANCELED: "CANCELED";
+    PENDING: "PENDING";
     ACCEPTED: "ACCEPTED";
     EXPIRED: "EXPIRED";
   }>;
@@ -4283,8 +4283,8 @@ export type Invitation = z.infer<typeof invitationSchema>;
 /** `GET /v1/store/invitations` 쿼리 — OpenAPI 문서용 형태 */
 export declare const invitationListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodEnum<{
-    PENDING: "PENDING";
     CANCELED: "CANCELED";
+    PENDING: "PENDING";
     ACCEPTED: "ACCEPTED";
     EXPIRED: "EXPIRED";
   }>>;
@@ -4696,7 +4696,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       contents: {
         productId: string;
         name: string;
-        status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+        status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
         salePrice: number;
         discountedPrice: number | null;
         stockQuantity: number;
@@ -4709,7 +4709,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (productId: string) => Promise<{
       productId: string;
       name: string;
-      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+      status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
       salePrice: number;
       discountedPrice: number | null;
       stockQuantity: number;
@@ -4748,7 +4748,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
-      deliveryType?: "FREE" | "PAID" | "CONDITIONAL_FREE" | undefined;
+      deliveryType?: "PAID" | "FREE" | "CONDITIONAL_FREE" | undefined;
       deliveryFee?: number | undefined;
       conditionalFreeAmount?: number | null | undefined;
       returnFee?: number | undefined;
@@ -4767,7 +4767,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     create: (body: ProductCreateRequest, idempotencyKey?: string) => Promise<{
       productId: string;
       name: string;
-      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+      status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
       salePrice: number;
       discountedPrice: number | null;
       stockQuantity: number;
@@ -4806,7 +4806,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
-      deliveryType?: "FREE" | "PAID" | "CONDITIONAL_FREE" | undefined;
+      deliveryType?: "PAID" | "FREE" | "CONDITIONAL_FREE" | undefined;
       deliveryFee?: number | undefined;
       conditionalFreeAmount?: number | null | undefined;
       returnFee?: number | undefined;
@@ -4825,7 +4825,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     update: (productId: string, body: ProductCreateRequest) => Promise<{
       productId: string;
       name: string;
-      status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
+      status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
       salePrice: number;
       discountedPrice: number | null;
       stockQuantity: number;
@@ -4864,7 +4864,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
-      deliveryType?: "FREE" | "PAID" | "CONDITIONAL_FREE" | undefined;
+      deliveryType?: "PAID" | "FREE" | "CONDITIONAL_FREE" | undefined;
       deliveryFee?: number | undefined;
       conditionalFreeAmount?: number | null | undefined;
       returnFee?: number | undefined;
@@ -5214,7 +5214,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" | "CLAIM.COMPLETED";
+        lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "ORDER.ADDRESS_CHANGE_REQUESTED";
         testPayment: boolean;
       }[];
     }>;
@@ -5273,7 +5273,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" | "CLAIM.COMPLETED";
+        lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "ORDER.ADDRESS_CHANGE_REQUESTED";
         testPayment: boolean;
       }[];
     }>;
@@ -5308,7 +5308,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     dispatch: (orderItemId: string, body: DispatchRequest, idempotencyKey?: string) => Promise<{
       orderItemId: string;
-      deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
+      deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
       carrierCode: string | null;
       carrierName: string | null;
       trackingNumber: string | null;
@@ -5358,7 +5358,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" | "CLAIM.COMPLETED";
+      lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "ORDER.ADDRESS_CHANGE_REQUESTED";
       testPayment: boolean;
     }>;
     /** 배송완료 일괄 처리 — 항목별 부분 성공이다 */
@@ -5374,7 +5374,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     getDelivery: (orderItemId: string) => Promise<{
       orderItemId: string;
-      deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
+      deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
       carrierCode: string | null;
       carrierName: string | null;
       trackingNumber: string | null;
@@ -5412,7 +5412,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       contents: {
         claimId: string;
         type: "RETURN" | "EXCHANGE" | "CANCEL";
-        status: "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "REJECTED" | "COMPLETED" | "WITHDRAWN";
+        status: "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "REJECTED" | "WITHDRAWN";
         orderId: string;
         orderItemId: string;
         productName: string;
@@ -5449,7 +5449,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (claimId: string) => Promise<{
       claimId: string;
       type: "RETURN" | "EXCHANGE" | "CANCEL";
-      status: "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "REJECTED" | "COMPLETED" | "WITHDRAWN";
+      status: "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "REJECTED" | "WITHDRAWN";
       orderId: string;
       orderItemId: string;
       productName: string;
@@ -5482,7 +5482,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         address2: string | null;
       } | null;
       histories?: {
-        status: "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "REJECTED" | "COMPLETED" | "WITHDRAWN";
+        status: "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "REJECTED" | "WITHDRAWN";
         actor: "BUYER" | "SELLER" | "SYSTEM";
         occurredAt: string;
       }[] | undefined;
@@ -5512,7 +5512,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     completeExchange: (claimId: string) => Promise<{
       claimId: string;
       type: "RETURN" | "EXCHANGE" | "CANCEL";
-      status: "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "REJECTED" | "COMPLETED" | "WITHDRAWN";
+      status: "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "REJECTED" | "WITHDRAWN";
       orderId: string;
       orderItemId: string;
       productName: string;
@@ -6025,9 +6025,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     /** `GET /v1/analytics/sources` — 채널·소스·캠페인·기기별 세션과 구매 */
     sources: (params: AnalyticsSourcesParams) => Promise<{
-      groupBy: "CHANNEL" | "SOURCE" | "CAMPAIGN" | "DEVICE";
+      groupBy: "CAMPAIGN" | "CHANNEL" | "SOURCE" | "DEVICE";
       rows: {
-        channel: "PAID" | "DIRECT" | "CAMPAIGN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | "UNKNOWN" | null;
+        channel: "DIRECT" | "ORGANIC_SEARCH" | "SOCIAL" | "PAID" | "EMAIL" | "CAMPAIGN" | "REFERRAL" | "UNKNOWN" | null;
         source: string | null;
         medium: string | null;
         campaign: string | null;
@@ -6132,7 +6132,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     checkout: (params: AnalyticsRangeParams) => Promise<{
       sessions: number;
       outcomes: {
-        outcome: "OTHER" | "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "IN_PROGRESS";
+        outcome: "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "OTHER" | "IN_PROGRESS";
         sessions: number;
       }[];
       from: string;
@@ -6981,7 +6981,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     list: () => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("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" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
       status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -6991,7 +6991,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     create: (body: WebhookRequest) => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("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" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
       status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -7001,7 +7001,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (webhookId: string) => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("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" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
       status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -7011,7 +7011,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     update: (webhookId: string, body: WebhookRequest) => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("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" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
       status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -7026,7 +7026,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     resume: (webhookId: string) => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("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" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
       status: "ACTIVE" | "SUSPENDED";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -7036,7 +7036,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     listDeliveries: (webhookId: string, params?: WebhookDeliveryListParams) => Promise<{
       deliveryId: string;
       eventId: string;
-      eventType: "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" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
+      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -7063,7 +7063,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     getDelivery: (webhookId: string, deliveryId: string) => Promise<{
       deliveryId: string;
       eventId: string;
-      eventType: "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" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
+      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -7098,7 +7098,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     redeliver: (webhookId: string, deliveryId: string) => Promise<{
       deliveryId: string;
       eventId: string;
-      eventType: "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" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
+      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -7327,7 +7327,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       invitationId: string;
       email: string;
       role: "ADMIN" | "STAFF";
-      status: "PENDING" | "CANCELED" | "ACCEPTED" | "EXPIRED";
+      status: "CANCELED" | "PENDING" | "ACCEPTED" | "EXPIRED";
       invitedBy: string;
       expiresAt: string;
       createdAt: string;
@@ -7710,6 +7710,56 @@ export interface DeliveryQuoteInput {
  */
 export declare function quoteDelivery(input: DeliveryQuoteInput): DeliveryQuote;
 //#endregion
+//#region src/schemas/telemetry.d.ts
+/**
+ * MCP 도구 호출 계측 (`POST /v1/telemetry/mcp`, 이슈 #34).
+ *
+ * `@sayren/mcp`가 `verify_storefront` 같은 도구를 돌린 뒤 결과 요약을 보낸다. 목적은 하나다 —
+ * AI가 만든 스토어프론트가 **처음에** 규칙을 통과하는지, 통과하지 못하면 어떤 규칙에서 막히는지를
+ * 세는 것이다. 그 숫자가 규칙과 안내를 고치는 근거가 된다.
+ *
+ * **보내지 않는 것**: 파일 경로·소스 코드·위반 상세(`detail`)·토큰·사람 식별자. 규칙 id와 개수뿐이다.
+ * 테넌트는 요청 토큰이 정한다(본문에 스토어 id가 없다). 옵트아웃은 클라이언트의 `SAYREN_TELEMETRY=0`이다.
+ *
+ * 알 수 없는 키는 저장하지 않고 버린다(`.strict()`를 쓰지 않는다) — 새 버전 클라이언트가 필드를
+ * 하나 더 실었다고 계측 전체가 400으로 날아가면 그 버전의 숫자가 통째로 빈다.
+ */
+/** 규칙 하나의 검사 결과. `ruleId`는 늘어나므로 enum이 아니라 형식만 좁힌다 */
+export declare const mcpRuleResultSchema: z.ZodObject<{
+  ruleId: z.ZodString;
+  status: z.ZodEnum<{
+    pass: "pass";
+    violation: "violation";
+  }>;
+  count: z.ZodNumber;
+}, z.core.$strip>;
+export type McpRuleResult = z.infer<typeof mcpRuleResultSchema>;
+/**
+ * 한 번에 실을 수 있는 규칙 결과 수 — 규칙 수(현재 16개)의 두 배까지다.
+ *
+ * 규칙 수 수준으로 좁게 둔다. 이 배열이 그대로 `mcp_tool_events.results` jsonb가 되므로 상한이
+ * 넉넉하면 한 행의 크기가 그만큼 커지고, 집계가 그 jsonb를 펼친다.
+ */
+export declare const MCP_TELEMETRY_MAX_RESULTS = 32;
+export declare const mcpToolEventSchema: z.ZodObject<{
+  tool: z.ZodString;
+  clientVersion: z.ZodOptional<z.ZodString>;
+  sessionId: z.ZodString;
+  attempt: z.ZodNumber;
+  durationMs: z.ZodOptional<z.ZodNumber>;
+  ok: z.ZodBoolean;
+  checkedFiles: z.ZodNumber;
+  results: z.ZodArray<z.ZodObject<{
+    ruleId: z.ZodString;
+    status: z.ZodEnum<{
+      pass: "pass";
+      violation: "violation";
+    }>;
+    count: z.ZodNumber;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type McpToolEvent = z.infer<typeof mcpToolEventSchema>;
+//#endregion
 //#region src/schemas/webhook-event.d.ts
 export declare const orderWebhookEventDataSchema: z.ZodObject<{
   orderId: z.ZodString;
@@ -7736,6 +7786,7 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
+    COMPLETED: "COMPLETED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
     COLLECTING: "COLLECTING";
@@ -7743,7 +7794,6 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
     REJECTED: "REJECTED";
-    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -7814,6 +7864,7 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
       CANCEL: "CANCEL";
     }>;
     status: z.ZodEnum<{
+      COMPLETED: "COMPLETED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
       COLLECTING: "COLLECTING";
@@ -7821,7 +7872,6 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
       REJECTED: "REJECTED";
-      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -7910,6 +7960,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       CANCEL: "CANCEL";
     }>;
     status: z.ZodEnum<{
+      COMPLETED: "COMPLETED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
       COLLECTING: "COLLECTING";
@@ -7917,7 +7968,6 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
       REJECTED: "REJECTED";
-      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;

package/dist/index.mjs

@@ -3668,6 +3668,44 @@ const STORE_ROLE_SCOPES = {
 	]
 };
 //#endregion
+//#region src/schemas/telemetry.ts
+/**
+* MCP 도구 호출 계측 (`POST /v1/telemetry/mcp`, 이슈 #34).
+*
+* `@sayren/mcp`가 `verify_storefront` 같은 도구를 돌린 뒤 결과 요약을 보낸다. 목적은 하나다 —
+* AI가 만든 스토어프론트가 **처음에** 규칙을 통과하는지, 통과하지 못하면 어떤 규칙에서 막히는지를
+* 세는 것이다. 그 숫자가 규칙과 안내를 고치는 근거가 된다.
+*
+* **보내지 않는 것**: 파일 경로·소스 코드·위반 상세(`detail`)·토큰·사람 식별자. 규칙 id와 개수뿐이다.
+* 테넌트는 요청 토큰이 정한다(본문에 스토어 id가 없다). 옵트아웃은 클라이언트의 `SAYREN_TELEMETRY=0`이다.
+*
+* 알 수 없는 키는 저장하지 않고 버린다(`.strict()`를 쓰지 않는다) — 새 버전 클라이언트가 필드를
+* 하나 더 실었다고 계측 전체가 400으로 날아가면 그 버전의 숫자가 통째로 빈다.
+*/
+/** 규칙 하나의 검사 결과. `ruleId`는 늘어나므로 enum이 아니라 형식만 좁힌다 */
+const mcpRuleResultSchema = z.object({
+	ruleId: z.string().min(1).max(64).regex(/^[a-z0-9][a-z0-9-]*$/, "규칙 id는 소문자·숫자·하이픈입니다").describe("검사한 규칙 id (예: `payment-popup-prepare`)"),
+	status: z.enum(["pass", "violation"]).describe("통과했는가"),
+	count: z.number().int().min(0).max(1e4).describe("이 규칙으로 잡힌 위반 수. 통과면 0")
+});
+/**
+* 한 번에 실을 수 있는 규칙 결과 수 — 규칙 수(현재 16개)의 두 배까지다.
+*
+* 규칙 수 수준으로 좁게 둔다. 이 배열이 그대로 `mcp_tool_events.results` jsonb가 되므로 상한이
+* 넉넉하면 한 행의 크기가 그만큼 커지고, 집계가 그 jsonb를 펼친다.
+*/
+const MCP_TELEMETRY_MAX_RESULTS = 32;
+const mcpToolEventSchema = z.object({
+	tool: z.string().regex(/^[a-z][a-z0-9_]{0,39}$/, "도구 이름 형식이 올바르지 않습니다").describe("도구 이름 (예: `verify_storefront`). CLI가 부른 검사는 `create`"),
+	clientVersion: z.string().max(40).regex(/^[\w.+-]+$/, "버전 형식이 올바르지 않습니다").optional().describe("`@sayren/mcp` 버전. 버전별로 첫 통과율이 나아졌는지 본다"),
+	sessionId: z.string().min(8).max(64).regex(/^[A-Za-z0-9_-]+$/, "세션 id 형식이 올바르지 않습니다").describe("클라이언트 프로세스당 랜덤 값. 사람·기기를 식별하지 않는다"),
+	attempt: z.number().int().min(1).max(1e3).describe("이 세션 안에서 같은 도구를 부른 순번(1부터)"),
+	durationMs: z.number().int().min(0).max(36e5).optional().describe("도구 실행 시간(ms)"),
+	ok: z.boolean().describe("위반이 없었는가"),
+	checkedFiles: z.number().int().min(0).max(1e5).describe("검사한 소스 파일 수"),
+	results: z.array(mcpRuleResultSchema).max(32).refine((results) => new Set(results.map((result) => result.ruleId)).size === results.length, { message: "같은 규칙 id를 두 번 실을 수 없습니다" }).describe("규칙별 통과·위반. 규칙 id는 중복될 수 없고 파일 경로와 위반 상세는 싣지 않는다")
+});
+//#endregion
 //#region src/schemas/webhook-event.ts
 const envelopeFields = {
 	id: z.string().describe("이벤트 ID (`evt_…`, 테스트 전송은 `evt_test_…`). 중복 제거 키"),
@@ -3900,4 +3938,4 @@ function createStoreSession(options) {
 	};
 }
 //#endregion
-export { ApiError, CASH_RECEIPT_STATUS_VALUES, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_OPTION_GROUPS, MAX_PRODUCT_IMAGES, MAX_VALUES_PER_GROUP, MAX_VARIANTS, PAYMENT_ROUTING_EXCLUSION_CODES, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, REFUND_POLICY_DEFAULTS, REMOTE_AREA_ZIP_RANGES, RESERVED_STORE_CODES, SHIPPING_POLICY_DEFAULTS, STORE_CODE_PATTERN, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, UPLOAD_PURPOSE_LIMITS, VARIANT_STOCK_EXCLUSIVE_MESSAGE, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_FAILURE_REASONS, WEBHOOK_HEADERS, WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES, WEBHOOK_RESOURCE_TYPES, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, addressChangeRequestListSchema, addressTypeSchema, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiClientListQuerySchema, apiClientSchema, apiClientSecretRotatedSchema, apiClientStatusSchema, apiClientTypeSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, apiTokenCreateRequestSchema, apiTokenCreatedSchema, apiTokenSchema, approveClaimResultSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, cashReceiptSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimReturnAddressSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, clientCredentialsTokenResponseSchema, consentActionSchema, consentKindSchema, consentSourceSchema, createPkcePair, createStoreClient, createStoreSession, customerAddressSchema, customerConsentListQuerySchema, customerConsentSchema, customerConsentStateSchema, customerConsentsSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deliveryBundleKeyOf, deliveryFeeWaiverSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationListQuerySchema, invitationSchema, isReservedStoreCode, isStoreScope, isWebOrigin, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, myAccountSchema, myStoreSchema, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionValueRequestSchema, optionValueSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productRefundPolicyOverride, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, proratedRefundBase, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, quoteDelivery, refreshUserToken, refundPolicyPatchSchema, refundPolicySchema, rejectClaimRequestSchema, remoteAreaLabelOf, remoteAreaOf, remoteAreaSchema, remoteSurchargeOf, resolveRefundPolicy, resolveShippingPolicy, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, scopeAccessSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, shippingPolicyPatchSchema, shippingPolicySchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, tossPaymentsCredentialsInputSchema, trackingStageResponseSchema, trackingUpdateResultSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryDetailSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliveryResourceSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookFailureReasonSchema, webhookRedeliverFailedResultSchema, webhookRequestHeaderSchema, webhookRequestSchema, webhookResourceTypeSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema };
+export { ApiError, CASH_RECEIPT_STATUS_VALUES, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_OPTION_GROUPS, MAX_PRODUCT_IMAGES, MAX_VALUES_PER_GROUP, MAX_VARIANTS, MCP_TELEMETRY_MAX_RESULTS, PAYMENT_ROUTING_EXCLUSION_CODES, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, REFUND_POLICY_DEFAULTS, REMOTE_AREA_ZIP_RANGES, RESERVED_STORE_CODES, SHIPPING_POLICY_DEFAULTS, STORE_CODE_PATTERN, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, UPLOAD_PURPOSE_LIMITS, VARIANT_STOCK_EXCLUSIVE_MESSAGE, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_FAILURE_REASONS, WEBHOOK_HEADERS, WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES, WEBHOOK_RESOURCE_TYPES, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, addressChangeRequestListSchema, addressTypeSchema, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiClientListQuerySchema, apiClientSchema, apiClientSecretRotatedSchema, apiClientStatusSchema, apiClientTypeSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, apiTokenCreateRequestSchema, apiTokenCreatedSchema, apiTokenSchema, approveClaimResultSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, cashReceiptSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimReturnAddressSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, clientCredentialsTokenResponseSchema, consentActionSchema, consentKindSchema, consentSourceSchema, createPkcePair, createStoreClient, createStoreSession, customerAddressSchema, customerConsentListQuerySchema, customerConsentSchema, customerConsentStateSchema, customerConsentsSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deliveryBundleKeyOf, deliveryFeeWaiverSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationListQuerySchema, invitationSchema, isReservedStoreCode, isStoreScope, isWebOrigin, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, mcpRuleResultSchema, mcpToolEventSchema, myAccountSchema, myStoreSchema, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionValueRequestSchema, optionValueSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productRefundPolicyOverride, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, proratedRefundBase, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, quoteDelivery, refreshUserToken, refundPolicyPatchSchema, refundPolicySchema, rejectClaimRequestSchema, remoteAreaLabelOf, remoteAreaOf, remoteAreaSchema, remoteSurchargeOf, resolveRefundPolicy, resolveShippingPolicy, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, scopeAccessSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, shippingPolicyPatchSchema, shippingPolicySchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, tossPaymentsCredentialsInputSchema, trackingStageResponseSchema, trackingUpdateResultSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryDetailSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliveryResourceSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookFailureReasonSchema, webhookRedeliverFailedResultSchema, webhookRequestHeaderSchema, webhookRequestSchema, webhookResourceTypeSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema };

package/package.json

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

package/src/index.ts

@@ -28,6 +28,7 @@ export * from "./schemas/refund-policy";
 export * from "./schemas/scope";
 export * from "./schemas/shipping-policy";
 export * from "./schemas/store";
+export * from "./schemas/telemetry";
 export * from "./schemas/upload";
 export * from "./schemas/webhook-event";
 export {

package/src/schemas/telemetry.ts

@@ -0,0 +1,74 @@
+import { z } from "zod";
+
+/**
+ * MCP 도구 호출 계측 (`POST /v1/telemetry/mcp`, 이슈 #34).
+ *
+ * `@sayren/mcp`가 `verify_storefront` 같은 도구를 돌린 뒤 결과 요약을 보낸다. 목적은 하나다 —
+ * AI가 만든 스토어프론트가 **처음에** 규칙을 통과하는지, 통과하지 못하면 어떤 규칙에서 막히는지를
+ * 세는 것이다. 그 숫자가 규칙과 안내를 고치는 근거가 된다.
+ *
+ * **보내지 않는 것**: 파일 경로·소스 코드·위반 상세(`detail`)·토큰·사람 식별자. 규칙 id와 개수뿐이다.
+ * 테넌트는 요청 토큰이 정한다(본문에 스토어 id가 없다). 옵트아웃은 클라이언트의 `SAYREN_TELEMETRY=0`이다.
+ *
+ * 알 수 없는 키는 저장하지 않고 버린다(`.strict()`를 쓰지 않는다) — 새 버전 클라이언트가 필드를
+ * 하나 더 실었다고 계측 전체가 400으로 날아가면 그 버전의 숫자가 통째로 빈다.
+ */
+
+/** 규칙 하나의 검사 결과. `ruleId`는 늘어나므로 enum이 아니라 형식만 좁힌다 */
+export const mcpRuleResultSchema = z.object({
+  ruleId: z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^[a-z0-9][a-z0-9-]*$/, "규칙 id는 소문자·숫자·하이픈입니다")
+    .describe("검사한 규칙 id (예: `payment-popup-prepare`)"),
+  status: z.enum(["pass", "violation"]).describe("통과했는가"),
+  count: z.number().int().min(0).max(10_000).describe("이 규칙으로 잡힌 위반 수. 통과면 0"),
+});
+export type McpRuleResult = z.infer<typeof mcpRuleResultSchema>;
+
+/**
+ * 한 번에 실을 수 있는 규칙 결과 수 — 규칙 수(현재 16개)의 두 배까지다.
+ *
+ * 규칙 수 수준으로 좁게 둔다. 이 배열이 그대로 `mcp_tool_events.results` jsonb가 되므로 상한이
+ * 넉넉하면 한 행의 크기가 그만큼 커지고, 집계가 그 jsonb를 펼친다.
+ */
+export const MCP_TELEMETRY_MAX_RESULTS = 32;
+
+export const mcpToolEventSchema = z.object({
+  tool: z
+    .string()
+    .regex(/^[a-z][a-z0-9_]{0,39}$/, "도구 이름 형식이 올바르지 않습니다")
+    .describe("도구 이름 (예: `verify_storefront`). CLI가 부른 검사는 `create`"),
+  clientVersion: z
+    .string()
+    .max(40)
+    .regex(/^[\w.+-]+$/, "버전 형식이 올바르지 않습니다")
+    .optional()
+    .describe("`@sayren/mcp` 버전. 버전별로 첫 통과율이 나아졌는지 본다"),
+  sessionId: z
+    .string()
+    .min(8)
+    .max(64)
+    .regex(/^[A-Za-z0-9_-]+$/, "세션 id 형식이 올바르지 않습니다")
+    .describe("클라이언트 프로세스당 랜덤 값. 사람·기기를 식별하지 않는다"),
+  attempt: z
+    .number()
+    .int()
+    .min(1)
+    .max(1_000)
+    .describe("이 세션 안에서 같은 도구를 부른 순번(1부터)"),
+  durationMs: z.number().int().min(0).max(3_600_000).optional().describe("도구 실행 시간(ms)"),
+  ok: z.boolean().describe("위반이 없었는가"),
+  checkedFiles: z.number().int().min(0).max(100_000).describe("검사한 소스 파일 수"),
+  results: z
+    .array(mcpRuleResultSchema)
+    .max(MCP_TELEMETRY_MAX_RESULTS)
+    // 규칙 하나당 한 줄이다. 같은 id를 여러 줄로 실으면 집계가 한 스토어의 한 규칙을 몇 번 세야
+    // 하는지 정할 수 없고, 상한만큼 같은 규칙을 반복해 보내는 것이 저장을 부풀리는 길이 된다.
+    .refine((results) => new Set(results.map((result) => result.ruleId)).size === results.length, {
+      message: "같은 규칙 id를 두 번 실을 수 없습니다",
+    })
+    .describe("규칙별 통과·위반. 규칙 id는 중복될 수 없고 파일 경로와 위반 상세는 싣지 않는다"),
+});
+export type McpToolEvent = z.infer<typeof mcpToolEventSchema>;