@sayren/store-sdk 0.11.0 → 0.13.0

package/dist/index.d.mts

@@ -8,9 +8,13 @@ export declare class ApiError extends Error {
   readonly body?: unknown | undefined;
   /** 엔벨로프 `$.error.details` — 에러 코드별 보조 데이터. 없으면 undefined */
   readonly details?: Record<string, unknown> | undefined;
+  /** 엔벨로프 `$.error.docs` — 이 에러 코드를 설명하는 문서 URL. 매핑이 없으면 undefined */
+  readonly docs?: string | undefined;
   constructor(status: number, code: string, message: string, traceId?: string | undefined, body?: unknown | undefined,
   /** 엔벨로프 `$.error.details` — 에러 코드별 보조 데이터. 없으면 undefined */
-  details?: Record<string, unknown> | undefined);
+  details?: Record<string, unknown> | undefined,
+  /** 엔벨로프 `$.error.docs` — 이 에러 코드를 설명하는 문서 URL. 매핑이 없으면 undefined */
+  docs?: string | undefined);
 }
 type TokenSource = string | null | undefined | (() => string | null | undefined);
 type Query = Record<string, string | number | boolean | undefined>;
@@ -178,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>;
@@ -203,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";
   }>>;
@@ -241,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";
     }>>;
@@ -404,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>;
@@ -417,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;
@@ -518,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";
   }>>>;
@@ -619,6 +623,7 @@ export declare const apiLogListQuerySchema: z.ZodObject<{
     "5xx": "5xx";
   }>>;
   q: z.ZodOptional<z.ZodString>;
+  traceId: z.ZodOptional<z.ZodString>;
   cursor: z.ZodOptional<z.ZodString>;
   limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strip>;
@@ -1046,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
@@ -1062,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";
@@ -1069,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>;
@@ -1106,6 +1111,7 @@ export declare const claimSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
+    COMPLETED: "COMPLETED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
     COLLECTING: "COLLECTING";
@@ -1113,7 +1119,6 @@ export declare const claimSchema: z.ZodObject<{
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
     REJECTED: "REJECTED";
-    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderId: z.ZodString;
@@ -1193,6 +1198,7 @@ export declare const claimDetailSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
+    COMPLETED: "COMPLETED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
     COLLECTING: "COLLECTING";
@@ -1200,7 +1206,6 @@ export declare const claimDetailSchema: z.ZodObject<{
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
     REJECTED: "REJECTED";
-    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderId: z.ZodString;
@@ -1249,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";
@@ -1256,7 +1262,6 @@ export declare const claimDetailSchema: z.ZodObject<{
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
       REJECTED: "REJECTED";
-      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     actor: z.ZodEnum<{
@@ -1587,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>;
@@ -1864,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";
@@ -1888,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";
@@ -1916,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";
@@ -1956,6 +1961,34 @@ export declare const webhookDeliveryErrorCodeSchema: z.ZodEnum<{
   WEBHOOK_SUSPENDED: "WEBHOOK_SUSPENDED";
 }>;
 export type WebhookDeliveryErrorCode = z.infer<typeof webhookDeliveryErrorCodeSchema>;
+/**
+ * 실패 원인 분류의 **현재** 값. 응답 스키마(`webhookFailureReasonSchema`)는 문자열로 열려 있다 —
+ * 서버가 값을 더해도 이전 SDK가 목록 파싱에 실패하지 않게 한다(택배 추적 `stage`와 같은 이유).
+ * 모르는 값은 `errorCode`로 판단한다.
+ */
+export declare const WEBHOOK_FAILURE_REASONS: readonly ["DNS", "TLS", "TIMEOUT", "CONNECTION", "HTTP_4XX", "HTTP_5XX", "HTTP_OTHER", "SSRF_BLOCKED", "SUSPENDED"];
+/** 알려진 실패 원인. 응답에는 이 밖의 문자열이 올 수 있다 */
+export type WebhookFailureReason = (typeof WEBHOOK_FAILURE_REASONS)[number];
+export declare const webhookFailureReasonSchema: z.ZodString;
+/**
+ * 대상 리소스 종류의 **현재** 값. 응답 스키마는 문자열로 열려 있다(새 이벤트가 새 리소스를 가리킬 수 있다).
+ */
+export declare const WEBHOOK_RESOURCE_TYPES: readonly ["ORDER", "CLAIM", "PRODUCT", "REVIEW", "INQUIRY"];
+/** 알려진 리소스 종류. 응답에는 이 밖의 문자열이 올 수 있다 */
+export type WebhookResourceType = (typeof WEBHOOK_RESOURCE_TYPES)[number];
+export declare const webhookResourceTypeSchema: z.ZodString;
+/** 이벤트가 가리키는 대상 리소스 — 전송 기록을 주문·상품과 잇는 키 */
+export declare const webhookDeliveryResourceSchema: z.ZodObject<{
+  type: z.ZodString;
+  id: z.ZodString;
+}, z.core.$strip>;
+export type WebhookDeliveryResource = z.infer<typeof webhookDeliveryResourceSchema>;
+/** 발송 요청 헤더 한 줄 (값 마스킹) */
+export declare const webhookRequestHeaderSchema: z.ZodObject<{
+  name: z.ZodString;
+  value: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type WebhookRequestHeader = z.infer<typeof webhookRequestHeaderSchema>;
 /** 웹훅 전송 기록 한 건 (전송 기록 조회 항목) */
 export declare const webhookDeliverySchema: z.ZodObject<{
   deliveryId: z.ZodString;
@@ -1966,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";
@@ -1992,6 +2025,11 @@ export declare const webhookDeliverySchema: z.ZodObject<{
     NON_2XX: "NON_2XX";
     WEBHOOK_SUSPENDED: "WEBHOOK_SUSPENDED";
   }>>;
+  failureReason: z.ZodNullable<z.ZodString>;
+  resource: z.ZodNullable<z.ZodObject<{
+    type: z.ZodString;
+    id: z.ZodString;
+  }, z.core.$strip>>;
   attemptCount: z.ZodNumber;
   createdAt: z.ZodString;
   attemptedAt: z.ZodNullable<z.ZodString>;
@@ -2000,6 +2038,64 @@ export declare const webhookDeliverySchema: z.ZodObject<{
   redeliveredAs: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type WebhookDelivery = z.infer<typeof webhookDeliverySchema>;
+/** 발송 본문 최대 노출 길이(바이트). 넘으면 잘라 주고 `payloadTruncated`가 true다 */
+export declare const WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES: number;
+/** 웹훅 전송 기록 상세 — `GET /webhooks/{id}/deliveries/{deliveryId}`. 목록 항목 + 요청 본문·헤더 */
+export declare const webhookDeliveryDetailSchema: z.ZodObject<{
+  deliveryId: z.ZodString;
+  eventId: z.ZodString;
+  eventType: z.ZodEnum<{
+    "ORDER.PAID": "ORDER.PAID";
+    "ORDER.CONFIRMED": "ORDER.CONFIRMED";
+    "ORDER.DISPATCHED": "ORDER.DISPATCHED";
+    "ORDER.DELIVERED": "ORDER.DELIVERED";
+    "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
+    "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";
+  }>;
+  url: z.ZodString;
+  status: z.ZodEnum<{
+    PENDING: "PENDING";
+    PENDING_RETRY: "PENDING_RETRY";
+    SUCCESS: "SUCCESS";
+    FAILED: "FAILED";
+  }>;
+  responseStatusCode: z.ZodNullable<z.ZodNumber>;
+  responseTimeMs: z.ZodNullable<z.ZodNumber>;
+  responseBodyExcerpt: z.ZodNullable<z.ZodString>;
+  errorCode: z.ZodNullable<z.ZodEnum<{
+    TIMEOUT: "TIMEOUT";
+    CONNECTION_FAILED: "CONNECTION_FAILED";
+    BLOCKED_ADDRESS: "BLOCKED_ADDRESS";
+    NON_2XX: "NON_2XX";
+    WEBHOOK_SUSPENDED: "WEBHOOK_SUSPENDED";
+  }>>;
+  failureReason: z.ZodNullable<z.ZodString>;
+  resource: z.ZodNullable<z.ZodObject<{
+    type: z.ZodString;
+    id: z.ZodString;
+  }, z.core.$strip>>;
+  attemptCount: z.ZodNumber;
+  createdAt: z.ZodString;
+  attemptedAt: z.ZodNullable<z.ZodString>;
+  nextAttemptAt: z.ZodNullable<z.ZodString>;
+  redeliveryOf: z.ZodNullable<z.ZodString>;
+  redeliveredAs: z.ZodNullable<z.ZodString>;
+  payload: z.ZodString;
+  payloadTruncated: z.ZodBoolean;
+  payloadMasked: z.ZodBoolean;
+  requestHeaders: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    value: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WebhookDeliveryDetail = z.infer<typeof webhookDeliveryDetailSchema>;
 /** 전송 기록 조회 쿼리 — `GET /webhooks/{id}/deliveries` */
 export declare const webhookDeliveryListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodEnum<{
@@ -2008,6 +2104,22 @@ export declare const webhookDeliveryListQuerySchema: z.ZodObject<{
     SUCCESS: "SUCCESS";
     FAILED: "FAILED";
   }>>;
+  eventType: z.ZodOptional<z.ZodEnum<{
+    "ORDER.PAID": "ORDER.PAID";
+    "ORDER.CONFIRMED": "ORDER.CONFIRMED";
+    "ORDER.DISPATCHED": "ORDER.DISPATCHED";
+    "ORDER.DELIVERED": "ORDER.DELIVERED";
+    "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
+    "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";
+  }>>;
+  resourceId: z.ZodOptional<z.ZodString>;
   limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strip>;
 export type WebhookDeliveryListParams = z.infer<typeof webhookDeliveryListQuerySchema>;
@@ -2023,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";
@@ -2045,6 +2157,13 @@ export declare const webhookTestResultSchema: z.ZodObject<{
     NON_2XX: "NON_2XX";
     WEBHOOK_SUSPENDED: "WEBHOOK_SUSPENDED";
   }>>;
+  failureReason: z.ZodNullable<z.ZodString>;
+  responseBodyExcerpt: z.ZodNullable<z.ZodString>;
+  requestHeaders: z.ZodArray<z.ZodObject<{
+    name: z.ZodString;
+    value: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  payload: z.ZodString;
 }, z.core.$strip>;
 export type WebhookTestResult = z.infer<typeof webhookTestResultSchema>;
 export declare const webhookRequestSchema: z.ZodObject<{
@@ -2055,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";
@@ -2208,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>;
@@ -2317,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>>;
@@ -2402,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>>;
@@ -2453,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";
@@ -2480,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";
   }>;
@@ -2501,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";
   }>;
@@ -2528,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";
   }>;
@@ -3637,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>;
@@ -3653,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>;
@@ -3708,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>;
@@ -3752,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>;
@@ -3916,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>;
@@ -3959,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>>;
@@ -3989,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>;
@@ -4151,8 +4270,8 @@ export declare const invitationSchema: z.ZodObject<{
     STAFF: "STAFF";
   }>;
   status: z.ZodEnum<{
-    PENDING: "PENDING";
     CANCELED: "CANCELED";
+    PENDING: "PENDING";
     ACCEPTED: "ACCEPTED";
     EXPIRED: "EXPIRED";
   }>;
@@ -4164,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";
   }>>;
@@ -4577,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;
@@ -4590,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;
@@ -4629,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;
@@ -4648,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;
@@ -4687,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;
@@ -4706,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;
@@ -4745,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;
@@ -5095,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;
       }[];
     }>;
@@ -5154,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;
       }[];
     }>;
@@ -5189,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;
@@ -5239,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;
     }>;
     /** 배송완료 일괄 처리 — 항목별 부분 성공이다 */
@@ -5255,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;
@@ -5293,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;
@@ -5330,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;
@@ -5363,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;
@@ -5393,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;
@@ -5906,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;
@@ -6013,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;
@@ -6862,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;
@@ -6872,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;
@@ -6882,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;
@@ -6892,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;
@@ -6907,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;
@@ -6917,13 +7036,18 @@ 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;
       responseTimeMs: number | null;
       responseBodyExcerpt: string | null;
       errorCode: "TIMEOUT" | "CONNECTION_FAILED" | "BLOCKED_ADDRESS" | "NON_2XX" | "WEBHOOK_SUSPENDED" | null;
+      failureReason: string | null;
+      resource: {
+        type: string;
+        id: string;
+      } | null;
       attemptCount: number;
       createdAt: string;
       attemptedAt: string | null;
@@ -6931,6 +7055,40 @@ export declare function createStoreClient(options: StoreClientOptions): {
       redeliveryOf: string | null;
       redeliveredAs: string | null;
     }[]>;
+    /**
+     * 전송 기록 한 건의 상세. 목록 항목에 보낸 요청 본문(최대 16KB)과 요청 헤더가 더해진다.
+     * 실패 원인 분류(`failureReason`)·응답 본문(`responseBodyExcerpt`)으로 원인을 찾고,
+     * `resource.id`를 API 로그 조회의 `q`로 넘겨 같은 리소스의 API 요청과 맞춰 본다.
+     */
+    getDelivery: (webhookId: string, deliveryId: string) => Promise<{
+      deliveryId: string;
+      eventId: string;
+      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;
+      responseTimeMs: number | null;
+      responseBodyExcerpt: string | null;
+      errorCode: "TIMEOUT" | "CONNECTION_FAILED" | "BLOCKED_ADDRESS" | "NON_2XX" | "WEBHOOK_SUSPENDED" | null;
+      failureReason: string | null;
+      resource: {
+        type: string;
+        id: string;
+      } | null;
+      attemptCount: number;
+      createdAt: string;
+      attemptedAt: string | null;
+      nextAttemptAt: string | null;
+      redeliveryOf: string | null;
+      redeliveredAs: string | null;
+      payload: string;
+      payloadTruncated: boolean;
+      payloadMasked: boolean;
+      requestHeaders: {
+        name: string;
+        value: string | null;
+      }[];
+    }>;
     /**
      * FAILED 전송 기록 한 건을 같은 eventId로 다시 보낸다(202). 새로 적재된 기록을 돌려주며
      * `redeliveryOf`가 원본 deliveryId다. 원본이 FAILED가 아니면 409 `DELIVERY_NOT_FAILED`,
@@ -6940,13 +7098,18 @@ 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;
       responseTimeMs: number | null;
       responseBodyExcerpt: string | null;
       errorCode: "TIMEOUT" | "CONNECTION_FAILED" | "BLOCKED_ADDRESS" | "NON_2XX" | "WEBHOOK_SUSPENDED" | null;
+      failureReason: string | null;
+      resource: {
+        type: string;
+        id: string;
+      } | null;
       attemptCount: number;
       createdAt: string;
       attemptedAt: string | null;
@@ -6969,6 +7132,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
       responseStatusCode: number | null;
       responseTimeMs: number | null;
       errorCode: "TIMEOUT" | "CONNECTION_FAILED" | "BLOCKED_ADDRESS" | "NON_2XX" | "WEBHOOK_SUSPENDED" | null;
+      failureReason: string | null;
+      responseBodyExcerpt: string | null;
+      requestHeaders: {
+        name: string;
+        value: string | null;
+      }[];
+      payload: string;
     }>;
   };
   /** API 로그 (보관 7일, 콘솔 OWNER/ADMIN) */
@@ -7157,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;
@@ -7540,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;
@@ -7566,6 +7786,7 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
     CANCEL: "CANCEL";
   }>;
   status: z.ZodEnum<{
+    COMPLETED: "COMPLETED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
     COLLECTING: "COLLECTING";
@@ -7573,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>>;
@@ -7644,6 +7864,7 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
       CANCEL: "CANCEL";
     }>;
     status: z.ZodEnum<{
+      COMPLETED: "COMPLETED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
       COLLECTING: "COLLECTING";
@@ -7651,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>>;
@@ -7740,6 +7960,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       CANCEL: "CANCEL";
     }>;
     status: z.ZodEnum<{
+      COMPLETED: "COMPLETED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
       COLLECTING: "COLLECTING";
@@ -7747,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>>;