@sayren/store-sdk 0.30.0 → 0.30.2

package/dist/index.d.mts

@@ -966,11 +966,11 @@ export type ApiLogSummary = z.infer<typeof apiLogSummarySchema>;
 //#endregion
 //#region src/schemas/category.d.ts
 export declare const categoryProductSortSchema: z.ZodEnum<{
-  NAME: "NAME";
   RECENT: "RECENT";
   POPULAR: "POPULAR";
   PRICE_LOW: "PRICE_LOW";
   PRICE_HIGH: "PRICE_HIGH";
+  NAME: "NAME";
 }>;
 export type CategoryProductSort = z.infer<typeof categoryProductSortSchema>;
 export declare const categorySchema: z.ZodObject<{
@@ -986,11 +986,11 @@ export declare const categorySchema: z.ZodObject<{
   showPc: z.ZodBoolean;
   showMobile: z.ZodBoolean;
   productSort: z.ZodEnum<{
-    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
+    NAME: "NAME";
   }>;
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
@@ -1017,11 +1017,11 @@ export declare const categoryWithPathSchema: z.ZodObject<{
   showPc: z.ZodBoolean;
   showMobile: z.ZodBoolean;
   productSort: z.ZodEnum<{
-    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
+    NAME: "NAME";
   }>;
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
@@ -1043,11 +1043,11 @@ export declare const categoryWithPathSchema: z.ZodObject<{
     showPc: z.ZodBoolean;
     showMobile: z.ZodBoolean;
     productSort: z.ZodEnum<{
-      NAME: "NAME";
       RECENT: "RECENT";
       POPULAR: "POPULAR";
       PRICE_LOW: "PRICE_LOW";
       PRICE_HIGH: "PRICE_HIGH";
+      NAME: "NAME";
     }>;
     metaTitle: z.ZodNullable<z.ZodString>;
     metaDescription: z.ZodNullable<z.ZodString>;
@@ -1072,11 +1072,11 @@ export declare const categorySearchResultSchema: z.ZodObject<{
   showPc: z.ZodBoolean;
   showMobile: z.ZodBoolean;
   productSort: z.ZodEnum<{
-    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
+    NAME: "NAME";
   }>;
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
@@ -1098,11 +1098,11 @@ export declare const categorySearchResultSchema: z.ZodObject<{
     showPc: z.ZodBoolean;
     showMobile: z.ZodBoolean;
     productSort: z.ZodEnum<{
-      NAME: "NAME";
       RECENT: "RECENT";
       POPULAR: "POPULAR";
       PRICE_LOW: "PRICE_LOW";
       PRICE_HIGH: "PRICE_HIGH";
+      NAME: "NAME";
     }>;
     metaTitle: z.ZodNullable<z.ZodString>;
     metaDescription: z.ZodNullable<z.ZodString>;
@@ -1135,11 +1135,11 @@ export declare const categoryCreateRequestSchema: z.ZodObject<{
   showPc: z.ZodOptional<z.ZodBoolean>;
   showMobile: z.ZodOptional<z.ZodBoolean>;
   productSort: z.ZodOptional<z.ZodEnum<{
-    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
+    NAME: "NAME";
   }>>;
   metaTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   metaDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1154,11 +1154,11 @@ export declare const categoryPatchRequestSchema: z.ZodObject<{
   showPc: z.ZodOptional<z.ZodBoolean>;
   showMobile: z.ZodOptional<z.ZodBoolean>;
   productSort: z.ZodOptional<z.ZodEnum<{
-    NAME: "NAME";
     RECENT: "RECENT";
     POPULAR: "POPULAR";
     PRICE_LOW: "PRICE_LOW";
     PRICE_HIGH: "PRICE_HIGH";
+    NAME: "NAME";
   }>>;
   metaTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   metaDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1271,13 +1271,13 @@ export declare const claimTypeSchema: z.ZodEnum<{
 export type ClaimType = z.infer<typeof claimTypeSchema>;
 export declare const claimStatusSchema: z.ZodEnum<{
   REJECTED: "REJECTED";
+  COMPLETED: "COMPLETED";
   REQUESTED: "REQUESTED";
   HELD: "HELD";
   COLLECTING: "COLLECTING";
   COLLECTED: "COLLECTED";
   REDELIVERING: "REDELIVERING";
   APPROVED: "APPROVED";
-  COMPLETED: "COMPLETED";
   WITHDRAWN: "WITHDRAWN";
 }>;
 export type ClaimStatus = z.infer<typeof claimStatusSchema>;
@@ -1316,13 +1316,13 @@ export declare const claimSchema: z.ZodObject<{
   }>;
   status: z.ZodEnum<{
     REJECTED: "REJECTED";
+    COMPLETED: "COMPLETED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
     COLLECTING: "COLLECTING";
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
-    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderId: z.ZodString;
@@ -1406,13 +1406,13 @@ export declare const claimDetailSchema: z.ZodObject<{
   }>;
   status: z.ZodEnum<{
     REJECTED: "REJECTED";
+    COMPLETED: "COMPLETED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
     COLLECTING: "COLLECTING";
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
-    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   orderId: z.ZodString;
@@ -1464,13 +1464,13 @@ export declare const claimDetailSchema: z.ZodObject<{
   histories: z.ZodOptional<z.ZodArray<z.ZodObject<{
     status: z.ZodEnum<{
       REJECTED: "REJECTED";
+      COMPLETED: "COMPLETED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
       COLLECTING: "COLLECTING";
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
-      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     actor: z.ZodEnum<{
@@ -2024,6 +2024,7 @@ export declare const flowInputFieldSchema: z.ZodObject<{
   type: z.ZodString;
   required: z.ZodBoolean;
   label: z.ZodString;
+  placeholder: z.ZodOptional<z.ZodString>;
   maxLength: z.ZodOptional<z.ZodNumber>;
   maxFiles: z.ZodOptional<z.ZodNumber>;
   options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
@@ -2049,6 +2050,7 @@ export declare const flowActionSchema: z.ZodObject<{
     type: z.ZodString;
     required: z.ZodBoolean;
     label: z.ZodString;
+    placeholder: z.ZodOptional<z.ZodString>;
     maxLength: z.ZodOptional<z.ZodNumber>;
     maxFiles: z.ZodOptional<z.ZodNumber>;
     options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
@@ -2074,19 +2076,28 @@ export declare const flowStateSchema: z.ZodObject<{
   }>>;
   claimStatus: z.ZodOptional<z.ZodEnum<{
     REJECTED: "REJECTED";
+    COMPLETED: "COMPLETED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
     COLLECTING: "COLLECTING";
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
-    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>>;
   message: z.ZodOptional<z.ZodString>;
   enteredAt: z.ZodString;
   deadlineAt: z.ZodOptional<z.ZodString>;
   attachments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  inputs: z.ZodOptional<z.ZodObject<{
+    by: z.ZodString;
+    values: z.ZodArray<z.ZodObject<{
+      key: z.ZodString;
+      label: z.ZodString;
+      type: z.ZodString;
+      value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
   progress: z.ZodOptional<z.ZodBoolean>;
   fields: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodString>]>>;
 }, z.core.$strip>;
@@ -2112,19 +2123,28 @@ export declare const orderItemFlowSchema: z.ZodObject<{
     }>>;
     claimStatus: z.ZodOptional<z.ZodEnum<{
       REJECTED: "REJECTED";
+      COMPLETED: "COMPLETED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
       COLLECTING: "COLLECTING";
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
-      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>>;
     message: z.ZodOptional<z.ZodString>;
     enteredAt: z.ZodString;
     deadlineAt: z.ZodOptional<z.ZodString>;
     attachments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    inputs: z.ZodOptional<z.ZodObject<{
+      by: z.ZodString;
+      values: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodString;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
     progress: z.ZodOptional<z.ZodBoolean>;
     fields: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodString>]>>;
   }, z.core.$strip>;
@@ -2148,6 +2168,7 @@ export declare const orderItemFlowSchema: z.ZodObject<{
       type: z.ZodString;
       required: z.ZodBoolean;
       label: z.ZodString;
+      placeholder: z.ZodOptional<z.ZodString>;
       maxLength: z.ZodOptional<z.ZodNumber>;
       maxFiles: z.ZodOptional<z.ZodNumber>;
       options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
@@ -2160,8 +2181,100 @@ export declare const orderItemFlowSchema: z.ZodObject<{
     paused: z.ZodBoolean;
   }, z.core.$strip>>;
   ended: z.ZodBoolean;
+  moveTargets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    coreStatus: z.ZodNullable<z.ZodEnum<{
+      PAID: "PAID";
+      CANCELED: "CANCELED";
+      PAYMENT_WAITING: "PAYMENT_WAITING";
+      CONFIRMED: "CONFIRMED";
+      DISPATCHED: "DISPATCHED";
+      DELIVERING: "DELIVERING";
+      DELIVERED: "DELIVERED";
+      PURCHASE_DECIDED: "PURCHASE_DECIDED";
+    }>>;
+  }, z.core.$strip>>>;
+  branches: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    coreStatus: z.ZodOptional<z.ZodEnum<{
+      PAID: "PAID";
+      CANCELED: "CANCELED";
+      PAYMENT_WAITING: "PAYMENT_WAITING";
+      CONFIRMED: "CONFIRMED";
+      DISPATCHED: "DISPATCHED";
+      DELIVERING: "DELIVERING";
+      DELIVERED: "DELIVERED";
+      PURCHASE_DECIDED: "PURCHASE_DECIDED";
+    }>>;
+    claimStatus: z.ZodOptional<z.ZodEnum<{
+      REJECTED: "REJECTED";
+      COMPLETED: "COMPLETED";
+      REQUESTED: "REQUESTED";
+      HELD: "HELD";
+      COLLECTING: "COLLECTING";
+      COLLECTED: "COLLECTED";
+      REDELIVERING: "REDELIVERING";
+      APPROVED: "APPROVED";
+      WITHDRAWN: "WITHDRAWN";
+    }>>;
+    message: z.ZodOptional<z.ZodString>;
+    enteredAt: z.ZodString;
+    deadlineAt: z.ZodOptional<z.ZodString>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    inputs: z.ZodOptional<z.ZodObject<{
+      by: z.ZodString;
+      values: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodString;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    progress: z.ZodOptional<z.ZodBoolean>;
+    fields: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodString>]>>;
+  }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type OrderItemFlow = z.infer<typeof orderItemFlowSchema>;
+/** 상태 직접 이동(#115) — 연결선을 지나지 않고 다른 상태로 옮긴다. 블록(재고·환불·송장)은 실행하지 않는다 */
+export declare const moveFlowStateRequestSchema: z.ZodObject<{
+  to: z.ZodString;
+  reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MoveFlowStateRequest = z.infer<typeof moveFlowStateRequestSchema>;
+export declare const flowRunStepSchema: z.ZodObject<{
+  step: z.ZodNumber;
+  block: z.ZodString;
+  edgeId: z.ZodString;
+  status: z.ZodString;
+  output: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  at: z.ZodString;
+}, z.core.$strip>;
+/** 흐름 실행 기록 — 사건 하나가 일으킨 전이(시작·행동·사건·시간·이동·취소) */
+export declare const flowRunSchema: z.ZodObject<{
+  runId: z.ZodString;
+  orderItemId: z.ZodOptional<z.ZodString>;
+  trigger: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  status: z.ZodString;
+  fromState: z.ZodNullable<z.ZodString>;
+  fromLabel: z.ZodNullable<z.ZodString>;
+  toState: z.ZodString;
+  toLabel: z.ZodString;
+  path: z.ZodArray<z.ZodString>;
+  error: z.ZodNullable<z.ZodUnknown>;
+  startedAt: z.ZodString;
+  finishedAt: z.ZodNullable<z.ZodString>;
+  steps: z.ZodArray<z.ZodObject<{
+    step: z.ZodNumber;
+    block: z.ZodString;
+    edgeId: z.ZodString;
+    status: z.ZodString;
+    output: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    at: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FlowRun = z.infer<typeof flowRunSchema>;
 export declare const flowActionRequestSchema: z.ZodObject<{
   input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
@@ -2187,19 +2300,28 @@ export declare const flowActionResultSchema: z.ZodObject<{
     }>>;
     claimStatus: z.ZodOptional<z.ZodEnum<{
       REJECTED: "REJECTED";
+      COMPLETED: "COMPLETED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
       COLLECTING: "COLLECTING";
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
-      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>>;
     message: z.ZodOptional<z.ZodString>;
     enteredAt: z.ZodString;
     deadlineAt: z.ZodOptional<z.ZodString>;
     attachments: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    inputs: z.ZodOptional<z.ZodObject<{
+      by: z.ZodString;
+      values: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodString;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
     progress: z.ZodOptional<z.ZodBoolean>;
     fields: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodString>]>>;
   }, z.core.$strip>;
@@ -2223,6 +2345,7 @@ export declare const flowActionResultSchema: z.ZodObject<{
       type: z.ZodString;
       required: z.ZodBoolean;
       label: z.ZodString;
+      placeholder: z.ZodOptional<z.ZodString>;
       maxLength: z.ZodOptional<z.ZodNumber>;
       maxFiles: z.ZodOptional<z.ZodNumber>;
       options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
@@ -2325,9 +2448,28 @@ export declare const commerceFlowSchema: z.ZodObject<{
       LEGACY: "LEGACY";
     }>;
     publishedAt: z.ZodNullable<z.ZodString>;
+    inProgress: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
 export type CommerceFlow = z.infer<typeof commerceFlowSchema>;
+export type CommerceFlowVersionView = z.infer<typeof commerceFlowVersionViewSchema>;
+/** 진행 중 주문을 활성 버전으로 옮기기(#115) — 한 번에 `limit`개까지. 남으면 다시 부른다 */
+export declare const migrateFlowVersionRequestSchema: z.ZodObject<{
+  limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type MigrateFlowVersionRequest = z.infer<typeof migrateFlowVersionRequestSchema>;
+export declare const migrateFlowVersionResultSchema: z.ZodObject<{
+  fromVersion: z.ZodNumber;
+  toVersion: z.ZodNumber;
+  migrated: z.ZodNumber;
+  skipped: z.ZodArray<z.ZodObject<{
+    orderItemIds: z.ZodArray<z.ZodString>;
+    state: z.ZodString;
+    reason: z.ZodString;
+  }, z.core.$strip>>;
+  remaining: z.ZodNumber;
+}, z.core.$strip>;
+export type MigrateFlowVersionResult = z.infer<typeof migrateFlowVersionResultSchema>;
 export declare const createCommerceFlowRequestSchema: z.ZodObject<{
   key: z.ZodString;
   name: z.ZodOptional<z.ZodString>;
@@ -2382,6 +2524,137 @@ export declare const saveFlowSecretRequestSchema: z.ZodObject<{
   headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>;
 export type SaveFlowSecretRequest = z.input<typeof saveFlowSecretRequestSchema>;
+/**
+ * 주문 전체 행동 결과(#115) — 같은 행동을 주문의 주문상품마다 실행한다. 한 주문상품의 실패가 다른 주문상품을 되돌리지 않는다(부분 실행).
+ * 묶음 진행이면 한 번 실행이 묶음의 주문상품을 함께 움직인다(COMPLETED로 함께 나온다). 그 행동이 없는 주문상품은 SKIPPED다
+ */
+export declare const orderFlowActionResultSchema: z.ZodObject<{
+  orderId: z.ZodString;
+  key: z.ZodString;
+  results: z.ZodArray<z.ZodObject<{
+    orderItemId: z.ZodString;
+    status: z.ZodEnum<{
+      FAILED: "FAILED";
+      COMPLETED: "COMPLETED";
+      SKIPPED: "SKIPPED";
+    }>;
+    reason: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type OrderFlowActionResult = z.infer<typeof orderFlowActionResultSchema>;
+export declare const simulateFlowRequestSchema: z.ZodObject<{
+  startAt: z.ZodOptional<z.ZodISODateTime>;
+  context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  steps: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+    event: z.ZodObject<{
+      type: z.ZodEnum<{
+        event: "event";
+        start: "start";
+        "seller.action": "seller.action";
+        "buyer.action": "buyer.action";
+        timer: "timer";
+      }>;
+      key: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    advance: z.ZodString;
+  }, z.core.$strip>]>>;
+}, z.core.$strip>;
+export type SimulateFlowRequest = z.infer<typeof simulateFlowRequestSchema>;
+export declare const simulationStepSchema: z.ZodObject<{
+  step: z.ZodNumber;
+  input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  at: z.ZodString;
+  node: z.ZodNullable<z.ZodString>;
+  label: z.ZodNullable<z.ZodString>;
+  coreStatus: z.ZodOptional<z.ZodString>;
+  ended: z.ZodBoolean;
+  path: z.ZodArray<z.ZodString>;
+  blocks: z.ZodArray<z.ZodString>;
+  timers: z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    dueAt: z.ZodString;
+  }, z.core.$strip>>;
+  leaves: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    node: z.ZodNullable<z.ZodString>;
+    kind: z.ZodString;
+  }, z.core.$strip>>>;
+  error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SimulationStep = z.infer<typeof simulationStepSchema>;
+export declare const simulateFlowResultSchema: z.ZodObject<{
+  compiled: z.ZodBoolean;
+  errors: z.ZodArray<z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    nodeId: z.ZodOptional<z.ZodString>;
+    edgeId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  trace: z.ZodArray<z.ZodObject<{
+    step: z.ZodNumber;
+    input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    at: z.ZodString;
+    node: z.ZodNullable<z.ZodString>;
+    label: z.ZodNullable<z.ZodString>;
+    coreStatus: z.ZodOptional<z.ZodString>;
+    ended: z.ZodBoolean;
+    path: z.ZodArray<z.ZodString>;
+    blocks: z.ZodArray<z.ZodString>;
+    timers: z.ZodArray<z.ZodObject<{
+      key: z.ZodString;
+      dueAt: z.ZodString;
+    }, z.core.$strip>>;
+    leaves: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      node: z.ZodNullable<z.ZodString>;
+      kind: z.ZodString;
+    }, z.core.$strip>>>;
+    error: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SimulateFlowResult = z.infer<typeof simulateFlowResultSchema>;
+export declare const replayFlowRequestSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+}, z.core.$strip>;
+export type ReplayFlowRequest = z.infer<typeof replayFlowRequestSchema>;
+export declare const replayFlowResultSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  compiled: z.ZodBoolean;
+  errors: z.ZodArray<z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    nodeId: z.ZodOptional<z.ZodString>;
+    edgeId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  steps: z.ZodArray<z.ZodObject<{
+    runId: z.ZodString;
+    trigger: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    recordedState: z.ZodString;
+    simulatedState: z.ZodNullable<z.ZodString>;
+    match: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  divergedAt: z.ZodNullable<z.ZodNumber>;
+  unsupported: z.ZodNumber;
+}, z.core.$strip>;
+export type ReplayFlowResult = z.infer<typeof replayFlowResultSchema>;
+/** 노드·블록 종류 목록(#115) — 흐름을 API·AI로 짤 때 쓸 수 있는 종류와 설정 형식(JSON Schema) */
+export declare const flowNodeTypesSchema: z.ZodObject<{
+  nodes: z.ZodArray<z.ZodObject<{
+    type: z.ZodString;
+    version: z.ZodNumber;
+    kind: z.ZodString;
+    outputs: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    configSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  }, z.core.$strip>>;
+  blocks: z.ZodArray<z.ZodObject<{
+    type: z.ZodString;
+    version: z.ZodNumber;
+    effect: z.ZodString;
+    configSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type FlowNodeTypes = z.infer<typeof flowNodeTypesSchema>;
 //#endregion
 //#region src/schemas/coupon.d.ts
 /**
@@ -3606,6 +3879,7 @@ export declare const eventTypeSchema: z.ZodEnum<{
   "REVIEW.CREATED": "REVIEW.CREATED";
   "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
   "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
+  "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
 }>;
 export type EventType = z.infer<typeof eventTypeSchema>;
 export declare const webhookStatusSchema: z.ZodEnum<{
@@ -3633,6 +3907,7 @@ export declare const webhookSchema: z.ZodObject<{
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
+    "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
   }>>;
   status: z.ZodEnum<{
     SUSPENDED: "SUSPENDED";
@@ -3664,6 +3939,7 @@ export declare const webhookCreatedSchema: z.ZodObject<{
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
+    "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
   }>>;
   status: z.ZodEnum<{
     SUSPENDED: "SUSPENDED";
@@ -3745,6 +4021,7 @@ export declare const webhookDeliverySchema: z.ZodObject<{
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
+    "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
   }>;
   url: z.ZodString;
   status: z.ZodEnum<{
@@ -3799,6 +4076,7 @@ export declare const webhookDeliveryDetailSchema: z.ZodObject<{
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
+    "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
   }>;
   url: z.ZodString;
   status: z.ZodEnum<{
@@ -3862,6 +4140,7 @@ export declare const webhookDeliveryListQuerySchema: z.ZodObject<{
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
+    "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
   }>>;
   resourceId: z.ZodOptional<z.ZodString>;
   limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
@@ -3890,6 +4169,7 @@ export declare const webhookTestRequestSchema: z.ZodObject<{
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
+    "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
   }>;
 }, z.core.$strip>;
 export type WebhookTestRequest = z.infer<typeof webhookTestRequestSchema>;
@@ -3932,6 +4212,7 @@ export declare const webhookRequestSchema: z.ZodObject<{
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
+    "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
   }>>;
 }, z.core.$strip>;
 export type WebhookRequest = z.infer<typeof webhookRequestSchema>;
@@ -4021,6 +4302,16 @@ export declare const orderSummarySchema: z.ZodObject<{
     DELIVERED: "DELIVERED";
     PURCHASE_DECIDED: "PURCHASE_DECIDED";
   }>;
+  progressStatus: z.ZodOptional<z.ZodEnum<{
+    PAID: "PAID";
+    CANCELED: "CANCELED";
+    PAYMENT_WAITING: "PAYMENT_WAITING";
+    CONFIRMED: "CONFIRMED";
+    DISPATCHED: "DISPATCHED";
+    DELIVERING: "DELIVERING";
+    DELIVERED: "DELIVERED";
+    PURCHASE_DECIDED: "PURCHASE_DECIDED";
+  }>>;
   orderedAt: z.ZodString;
   testPayment: z.ZodBoolean;
 }, z.core.$strip>;
@@ -4165,6 +4456,16 @@ export declare const orderDiscountSchema: z.ZodObject<{
 export type OrderDiscount = z.infer<typeof orderDiscountSchema>;
 export declare const orderSchema: z.ZodObject<{
   orderId: z.ZodString;
+  progressStatus: z.ZodOptional<z.ZodEnum<{
+    PAID: "PAID";
+    CANCELED: "CANCELED";
+    PAYMENT_WAITING: "PAYMENT_WAITING";
+    CONFIRMED: "CONFIRMED";
+    DISPATCHED: "DISPATCHED";
+    DELIVERING: "DELIVERING";
+    DELIVERED: "DELIVERED";
+    PURCHASE_DECIDED: "PURCHASE_DECIDED";
+  }>>;
   orderNo: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
   orderedAt: z.ZodString;
   orderer: z.ZodObject<{
@@ -4366,6 +4667,16 @@ export declare const orderSummaryPageSchema: z.ZodObject<{
       DELIVERED: "DELIVERED";
       PURCHASE_DECIDED: "PURCHASE_DECIDED";
     }>;
+    progressStatus: z.ZodOptional<z.ZodEnum<{
+      PAID: "PAID";
+      CANCELED: "CANCELED";
+      PAYMENT_WAITING: "PAYMENT_WAITING";
+      CONFIRMED: "CONFIRMED";
+      DISPATCHED: "DISPATCHED";
+      DELIVERING: "DELIVERING";
+      DELIVERED: "DELIVERED";
+      PURCHASE_DECIDED: "PURCHASE_DECIDED";
+    }>>;
     orderedAt: z.ZodString;
     testPayment: z.ZodBoolean;
   }, z.core.$strip>>;
@@ -6160,8 +6471,8 @@ export declare const VARIANT_COUNT_WARNING = 100;
  * 추가금순은 추가 선택 값이면 값의 추가금, 조합 값이면 그 값이 든 조합 추가금의 최솟값으로 비교하고 같으면 등록순이다.
  */
 export declare const optionSortSchema: z.ZodEnum<{
-  REGISTERED: "REGISTERED";
   NAME: "NAME";
+  REGISTERED: "REGISTERED";
   PRICE_ASC: "PRICE_ASC";
   PRICE_DESC: "PRICE_DESC";
 }>;
@@ -6368,8 +6679,8 @@ export declare const productSchema: z.ZodObject<{
     options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
   }, z.core.$strip>>>>;
   optionSort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-    REGISTERED: "REGISTERED";
     NAME: "NAME";
+    REGISTERED: "REGISTERED";
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
   }>>>;
@@ -6528,8 +6839,8 @@ export declare const optionModelRequestSchema: z.ZodObject<{
     options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
   }, z.core.$strip>>>;
   optionSort: z.ZodOptional<z.ZodEnum<{
-    REGISTERED: "REGISTERED";
     NAME: "NAME";
+    REGISTERED: "REGISTERED";
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
   }>>;
@@ -6589,8 +6900,8 @@ export declare const optionModelSchema: z.ZodObject<{
     options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
   }, z.core.$strip>>>>;
   optionSort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-    REGISTERED: "REGISTERED";
     NAME: "NAME";
+    REGISTERED: "REGISTERED";
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
   }>>>;
@@ -6702,8 +7013,8 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
   }, z.core.$strip>>>;
   optionSort: z.ZodOptional<z.ZodEnum<{
-    REGISTERED: "REGISTERED";
     NAME: "NAME";
+    REGISTERED: "REGISTERED";
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
   }>>;
@@ -6816,8 +7127,8 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
     options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
   }, z.core.$strip>>>;
   optionSort: z.ZodOptional<z.ZodEnum<{
-    REGISTERED: "REGISTERED";
     NAME: "NAME";
+    REGISTERED: "REGISTERED";
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
   }>>;
@@ -6893,11 +7204,11 @@ export declare const productPatchRequestSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
 export declare const productSortSchema: z.ZodEnum<{
+  "updatedAt.desc": "updatedAt.desc";
   "createdAt.desc": "createdAt.desc";
   "createdAt.asc": "createdAt.asc";
   "salePrice.asc": "salePrice.asc";
   "salePrice.desc": "salePrice.desc";
-  "updatedAt.desc": "updatedAt.desc";
 }>;
 export type ProductSort = z.infer<typeof productSortSchema>;
 export interface ProductListParams extends PageParams {
@@ -6924,11 +7235,11 @@ export declare const productListQuerySchema: z.ZodObject<{
   sellerCode: z.ZodOptional<z.ZodString>;
   productNo: z.ZodOptional<z.ZodString>;
   sort: z.ZodOptional<z.ZodEnum<{
+    "updatedAt.desc": "updatedAt.desc";
     "createdAt.desc": "createdAt.desc";
     "createdAt.asc": "createdAt.asc";
     "salePrice.asc": "salePrice.asc";
     "salePrice.desc": "salePrice.desc";
-    "updatedAt.desc": "updatedAt.desc";
   }>>;
 }, z.core.$strip>;
 export declare const discountRequestSchema: z.ZodObject<{
@@ -6987,8 +7298,8 @@ export declare const savedOptionSetSchema: z.ZodObject<{
   optionSetId: z.ZodString;
   name: z.ZodString;
   optionSort: z.ZodEnum<{
-    REGISTERED: "REGISTERED";
     NAME: "NAME";
+    REGISTERED: "REGISTERED";
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
   }>;
@@ -7055,8 +7366,8 @@ export declare const savedCustomInputRequestSchema: z.ZodObject<{
 export declare const savedOptionSetRequestSchema: z.ZodObject<{
   name: z.ZodString;
   optionSort: z.ZodDefault<z.ZodEnum<{
-    REGISTERED: "REGISTERED";
     NAME: "NAME";
+    REGISTERED: "REGISTERED";
     PRICE_ASC: "PRICE_ASC";
     PRICE_DESC: "PRICE_DESC";
   }>>;
@@ -7111,8 +7422,8 @@ export declare const savedOptionSetFromProductResultSchema: z.ZodObject<{
     optionSetId: z.ZodString;
     name: z.ZodString;
     optionSort: z.ZodEnum<{
-      REGISTERED: "REGISTERED";
       NAME: "NAME";
+      REGISTERED: "REGISTERED";
       PRICE_ASC: "PRICE_ASC";
       PRICE_DESC: "PRICE_DESC";
     }>;
@@ -9227,7 +9538,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         type?: string | undefined;
         options?: string[] | null | undefined;
       }[];
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
@@ -9335,7 +9646,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         type?: string | undefined;
         options?: string[] | null | undefined;
       }[];
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
@@ -9443,7 +9754,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         type?: string | undefined;
         options?: string[] | null | undefined;
       }[];
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
         type: "SHIPPING";
         shipping: {
@@ -9553,7 +9864,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         type?: string | undefined;
         options?: string[] | null | undefined;
       }[];
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
     }>;
     /**
      * 옵션 모델 전체 교체 — variants는 valueNames로 축 값을 지목한다.
@@ -9611,7 +9922,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         type?: string | undefined;
         options?: string[] | null | undefined;
       }[];
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
     }>;
     /** 재고 변경 — stockQuantity(절대값) 또는 adjustment(증감) 하나만 전달한다 */
     updateVariantStock: (productId: string, variantId: string, body: VariantStockRequest) => Promise<{
@@ -9660,7 +9971,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       contents: {
         optionSetId: string;
         name: string;
-        optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+        optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
         groups: {
           name: string;
           kind: string;
@@ -9687,7 +9998,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (optionSetId: string) => Promise<{
       optionSetId: string;
       name: string;
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
       groups: {
         name: string;
         kind: string;
@@ -9714,7 +10025,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     create: (body: SavedOptionSetRequestInput) => Promise<{
       optionSetId: string;
       name: string;
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
       groups: {
         name: string;
         kind: string;
@@ -9741,7 +10052,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     update: (optionSetId: string, body: SavedOptionSetRequestInput) => Promise<{
       optionSetId: string;
       name: string;
-      optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+      optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
       groups: {
         name: string;
         kind: string;
@@ -9770,7 +10081,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       optionSet: {
         optionSetId: string;
         name: string;
-        optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
+        optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
         groups: {
           name: string;
           kind: string;
@@ -10121,7 +10432,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
+      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -10142,7 +10453,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
+      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -10161,7 +10472,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         visible: boolean;
         showPc: boolean;
         showMobile: boolean;
-        productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
+        productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
         metaTitle: string | null;
         metaDescription: string | null;
         metaKeywords: string | null;
@@ -10183,7 +10494,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
+      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -10202,7 +10513,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         visible: boolean;
         showPc: boolean;
         showMobile: boolean;
-        productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
+        productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
         metaTitle: string | null;
         metaDescription: string | null;
         metaKeywords: string | null;
@@ -10233,7 +10544,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
+      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -10253,7 +10564,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       visible: boolean;
       showPc: boolean;
       showMobile: boolean;
-      productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
+      productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
       metaTitle: string | null;
       metaDescription: string | null;
       metaKeywords: string | null;
@@ -10284,6 +10595,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         representativeStatus: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
         orderedAt: string;
         testPayment: boolean;
+        progressStatus?: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
       }[];
     }>;
     get: (orderId: string) => Promise<{
@@ -10426,6 +10738,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           }[];
         } | undefined;
       }[];
+      progressStatus?: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
     }>;
     /**
      * `POST /v1/orders/{orderId}/cash-receipt/reissue` — 실패했거나 재시도 대기 중인 현금영수증을 지금 다시 발급·취소한다.
@@ -10450,6 +10763,20 @@ export declare function createStoreClient(options: StoreClientOptions): {
       requestedAt: string;
       updatedAt: string;
     }>;
+    /**
+     * `POST /orders/{id}/actions/{key}` — 주문 전체 행동(#115). 그 행동이 켜진 주문상품마다 실행하고 결과를 주문상품별로 준다(부분 실행).
+     * 켜진 주문상품이 하나도 없으면 409 `ACTION_NOT_AVAILABLE`
+     */
+    act: (orderId: string, key: string, input?: Record<string, unknown>, idempotencyKey?: string) => Promise<{
+      orderId: string;
+      key: string;
+      results: {
+        orderItemId: string;
+        status: "FAILED" | "COMPLETED" | "SKIPPED";
+        reason?: string | undefined;
+        message?: string | undefined;
+      }[];
+    }>;
   };
   orderItems: {
     /** `GET /v1/order-items`. `testPayment` 필터는 `orders.list`와 같다 */
@@ -10824,10 +11151,19 @@ export declare function createStoreClient(options: StoreClientOptions): {
         enteredAt: string;
         fields: Record<string, string | number | boolean | string[] | null>;
         coreStatus?: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
-        claimStatus?: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN" | undefined;
+        claimStatus?: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
         message?: string | undefined;
         deadlineAt?: string | undefined;
         attachments?: string[] | undefined;
+        inputs?: {
+          by: string;
+          values: {
+            key: string;
+            label: string;
+            type: string;
+            value: string | number | boolean | string[];
+          }[];
+        } | undefined;
         progress?: boolean | undefined;
       };
       actions: {
@@ -10846,6 +11182,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           type: string;
           required: boolean;
           label: string;
+          placeholder?: string | undefined;
           maxLength?: number | undefined;
           maxFiles?: number | undefined;
           options?: (string | number)[] | undefined;
@@ -10858,6 +11195,32 @@ export declare function createStoreClient(options: StoreClientOptions): {
         paused: boolean;
       }[];
       ended: boolean;
+      moveTargets?: {
+        key: string;
+        label: string;
+        coreStatus: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | null;
+      }[] | undefined;
+      branches?: {
+        key: string;
+        label: string;
+        enteredAt: string;
+        fields: Record<string, string | number | boolean | string[] | null>;
+        coreStatus?: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
+        claimStatus?: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
+        message?: string | undefined;
+        deadlineAt?: string | undefined;
+        attachments?: string[] | undefined;
+        inputs?: {
+          by: string;
+          values: {
+            key: string;
+            label: string;
+            type: string;
+            value: string | number | boolean | string[];
+          }[];
+        } | undefined;
+        progress?: boolean | undefined;
+      }[] | undefined;
     }>;
     /**
      * `POST /order-items/{id}/actions/{key}` — `getFlow().actions`에 켜진 행동을 실행한다(#115). 묶음 진행이면
@@ -10871,10 +11234,19 @@ export declare function createStoreClient(options: StoreClientOptions): {
         enteredAt: string;
         fields: Record<string, string | number | boolean | string[] | null>;
         coreStatus?: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
-        claimStatus?: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN" | undefined;
+        claimStatus?: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
         message?: string | undefined;
         deadlineAt?: string | undefined;
         attachments?: string[] | undefined;
+        inputs?: {
+          by: string;
+          values: {
+            key: string;
+            label: string;
+            type: string;
+            value: string | number | boolean | string[];
+          }[];
+        } | undefined;
         progress?: boolean | undefined;
       };
       actions: {
@@ -10893,6 +11265,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           type: string;
           required: boolean;
           label: string;
+          placeholder?: string | undefined;
           maxLength?: number | undefined;
           maxFiles?: number | undefined;
           options?: (string | number)[] | undefined;
@@ -10913,10 +11286,71 @@ export declare function createStoreClient(options: StoreClientOptions): {
         enteredAt: string;
         fields: Record<string, string | number | boolean | string[] | null>;
         coreStatus?: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
-        claimStatus?: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN" | undefined;
+        claimStatus?: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
+        message?: string | undefined;
+        deadlineAt?: string | undefined;
+        attachments?: string[] | undefined;
+        inputs?: {
+          by: string;
+          values: {
+            key: string;
+            label: string;
+            type: string;
+            value: string | number | boolean | string[];
+          }[];
+        } | undefined;
+        progress?: boolean | undefined;
+      };
+      actions: {
+        key: string;
+        label: string;
+        mode: "REQUEST" | "INSTANT" | "VIEW";
+        enabled: boolean;
+        disabled?: {
+          reason: string;
+          message?: string | undefined;
+        } | undefined;
+        availableUntil?: string | undefined;
+        subflow?: string | undefined;
+        input?: {
+          key: string;
+          type: string;
+          required: boolean;
+          label: string;
+          placeholder?: string | undefined;
+          maxLength?: number | undefined;
+          maxFiles?: number | undefined;
+          options?: (string | number)[] | undefined;
+        }[] | undefined;
+        partialQuantity?: boolean | "UNIT" | undefined;
+      }[];
+      affectedOrderItemIds: string[];
+    }>;
+    /**
+     * `POST /order-items/{id}/flow/move` — 상태 직접 이동(#115). 연결선을 지나지 않으므로 블록(재고·환불·송장)은 실행하지 않는다.
+     * 옮길 수 있는 상태는 `getFlow().moveTargets`. 에러: 409 `FLOW_MOVE_NOT_ALLOWED`
+     */
+    moveFlow: (orderItemId: string, body: MoveFlowStateRequest, idempotencyKey?: string) => Promise<{
+      status: "COMPLETED";
+      flowState: {
+        key: string;
+        label: string;
+        enteredAt: string;
+        fields: Record<string, string | number | boolean | string[] | null>;
+        coreStatus?: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
+        claimStatus?: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
         message?: string | undefined;
         deadlineAt?: string | undefined;
         attachments?: string[] | undefined;
+        inputs?: {
+          by: string;
+          values: {
+            key: string;
+            label: string;
+            type: string;
+            value: string | number | boolean | string[];
+          }[];
+        } | undefined;
         progress?: boolean | undefined;
       };
       actions: {
@@ -10935,6 +11369,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           type: string;
           required: boolean;
           label: string;
+          placeholder?: string | undefined;
           maxLength?: number | undefined;
           maxFiles?: number | undefined;
           options?: (string | number)[] | undefined;
@@ -10943,6 +11378,54 @@ export declare function createStoreClient(options: StoreClientOptions): {
       }[];
       affectedOrderItemIds: string[];
     }>;
+    /** `GET /order-items/{id}/flow/runs` — 흐름 실행 기록(최근 것부터 50개, #115). 스코프 `order:r` */
+    flowRuns: (orderItemId: string) => Promise<{
+      runId: string;
+      trigger: Record<string, unknown>;
+      status: string;
+      fromState: string | null;
+      fromLabel: string | null;
+      toState: string;
+      toLabel: string;
+      path: string[];
+      error: unknown;
+      startedAt: string;
+      finishedAt: string | null;
+      steps: {
+        step: number;
+        block: string;
+        edgeId: string;
+        status: string;
+        output: Record<string, unknown> | null;
+        at: string;
+      }[];
+      orderItemId?: string | undefined;
+    }[]>;
+  };
+  /** `GET /flow-runs/{runId}` — 흐름 실행 기록 하나와 실행한 블록(#115). 스코프 `order:r` */
+  flowRuns: {
+    get: (runId: string) => Promise<{
+      runId: string;
+      trigger: Record<string, unknown>;
+      status: string;
+      fromState: string | null;
+      fromLabel: string | null;
+      toState: string;
+      toLabel: string;
+      path: string[];
+      error: unknown;
+      startedAt: string;
+      finishedAt: string | null;
+      steps: {
+        step: number;
+        block: string;
+        edgeId: string;
+        status: string;
+        output: Record<string, unknown> | null;
+        at: string;
+      }[];
+      orderItemId?: string | undefined;
+    }>;
   };
   /**
    * 커머스 플로우 (이슈 #115) — 프리셋 설치·초안 저장·검사·게시와 상품 할당 규칙. 조회 `flow:r`, 쓰기 `flow:rw`.
@@ -11006,6 +11489,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         version: number;
         status: "ACTIVE" | "DRAFT" | "LEGACY";
         publishedAt: string | null;
+        inProgress?: number | undefined;
       }[];
     }>;
     /** 프리셋 설치 또는 빈 플로우. 에러: 409 `FLOW_KEY_TAKEN`·`FLOW_PRESET_UNAVAILABLE` */
@@ -11043,6 +11527,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         version: number;
         status: "ACTIVE" | "DRAFT" | "LEGACY";
         publishedAt: string | null;
+        inProgress?: number | undefined;
       }[];
     }>;
     /** 초안 저장. `revision`을 주면 그 초안일 때만 저장한다(409 `FLOW_REVISION_CONFLICT`) */
@@ -11080,6 +11565,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         version: number;
         status: "ACTIVE" | "DRAFT" | "LEGACY";
         publishedAt: string | null;
+        inProgress?: number | undefined;
       }[];
     }>;
     check: (flowId: string) => Promise<{
@@ -11132,6 +11618,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         version: number;
         status: "ACTIVE" | "DRAFT" | "LEGACY";
         publishedAt: string | null;
+        inProgress?: number | undefined;
       }[];
     }>;
     /** 이 상품에 지금 붙을 플로우 */
@@ -11155,6 +11642,98 @@ export declare function createStoreClient(options: StoreClientOptions): {
       updatedAt: string;
     }>;
     removeSecret: (name: string) => Promise<void>;
+    /** `GET /commerce-flows/{id}/versions/{n}` — 게시했던 버전 하나(그래프·정의). 옛 버전 보기용 */
+    getVersion: (flowId: string, version: number) => Promise<{
+      version: number;
+      status: "ACTIVE" | "DRAFT" | "LEGACY";
+      revision: number;
+      graph: Record<string, unknown>;
+      definition: Record<string, unknown>;
+      variables: Record<string, unknown>;
+      publishedAt: string | null;
+    }>;
+    /**
+     * `POST /commerce-flows/{id}/versions/{n}/migrate` — 버전 n을 따르는 진행 중 주문을 지금 게시 버전으로 옮긴다. 같은 상태가 새 버전에
+     * 있어야 하고, 진행 중 클레임·외부 API 대기는 건너뛴다(`skipped`). `remaining`이 0이 될 때까지 다시 부른다
+     */
+    migrateVersion: (flowId: string, version: number, body?: MigrateFlowVersionRequest) => Promise<{
+      fromVersion: number;
+      toVersion: number;
+      migrated: number;
+      skipped: {
+        orderItemIds: string[];
+        state: string;
+        reason: string;
+      }[];
+      remaining: number;
+    }>;
+    /** `POST /commerce-flows/{id}/draft/simulate` — 초안을 가상 시계로 돌려 단계별 결과를 본다(주문·돈·재고는 건드리지 않는다) */
+    simulate: (flowId: string, body: SimulateFlowRequest) => Promise<{
+      compiled: boolean;
+      errors: {
+        code: string;
+        message: string;
+        nodeId?: string | undefined;
+        edgeId?: string | undefined;
+      }[];
+      trace: {
+        step: number;
+        input: Record<string, unknown>;
+        at: string;
+        node: string | null;
+        label: string | null;
+        ended: boolean;
+        path: string[];
+        blocks: string[];
+        timers: {
+          key: string;
+          dueAt: string;
+        }[];
+        coreStatus?: string | undefined;
+        leaves?: {
+          node: string | null;
+          kind: string;
+        }[] | undefined;
+        error?: string | undefined;
+      }[];
+    }>;
+    /** `POST /commerce-flows/{id}/draft/replay` — 실제 주문상품의 실행 기록을 초안으로 다시 돌려 갈라지는 곳을 찾는다 */
+    replay: (flowId: string, body: ReplayFlowRequest) => Promise<{
+      orderItemId: string;
+      compiled: boolean;
+      errors: {
+        code: string;
+        message: string;
+        nodeId?: string | undefined;
+        edgeId?: string | undefined;
+      }[];
+      steps: {
+        runId: string;
+        trigger: Record<string, unknown>;
+        recordedState: string;
+        simulatedState: string | null;
+        match: boolean;
+        error?: string | undefined;
+      }[];
+      divergedAt: number | null;
+      unsupported: number;
+    }>;
+    /** `GET /flow-node-types` — 쓸 수 있는 노드·블록 종류와 설정 형식(JSON Schema) */
+    nodeTypes: () => Promise<{
+      nodes: {
+        type: string;
+        version: number;
+        kind: string;
+        outputs: string[] | null;
+        configSchema: Record<string, unknown>;
+      }[];
+      blocks: {
+        type: string;
+        version: number;
+        effect: string;
+        configSchema: Record<string, unknown>;
+      }[];
+    }>;
   };
   carriers: {
     list: () => Promise<{
@@ -11173,7 +11752,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         claimId: string;
         claimNo: string | null;
         type: "RETURN" | "EXCHANGE" | "CANCEL";
-        status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
+        status: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
         orderId: string;
         orderItemId: string;
         productName: string;
@@ -11213,7 +11792,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       claimId: string;
       claimNo: string | null;
       type: "RETURN" | "EXCHANGE" | "CANCEL";
-      status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
+      status: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
       orderId: string;
       orderItemId: string;
       productName: string;
@@ -11248,7 +11827,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         address2: string | null;
       } | null;
       histories?: {
-        status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
+        status: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
         actor: "SYSTEM" | "BUYER" | "SELLER";
         occurredAt: string;
       }[] | undefined;
@@ -11282,7 +11861,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       claimId: string;
       claimNo: string | null;
       type: "RETURN" | "EXCHANGE" | "CANCEL";
-      status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
+      status: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
       orderId: string;
       orderItemId: string;
       productName: string;
@@ -13238,7 +13817,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" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -13248,7 +13827,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" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -13258,7 +13837,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" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -13268,7 +13847,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" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -13283,7 +13862,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" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -13293,7 +13872,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" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION";
+      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -13320,7 +13899,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" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION";
+      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -13355,7 +13934,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" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION";
+      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -16558,13 +17137,13 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
   }>;
   status: z.ZodEnum<{
     REJECTED: "REJECTED";
+    COMPLETED: "COMPLETED";
     REQUESTED: "REQUESTED";
     HELD: "HELD";
     COLLECTING: "COLLECTING";
     COLLECTED: "COLLECTED";
     REDELIVERING: "REDELIVERING";
     APPROVED: "APPROVED";
-    COMPLETED: "COMPLETED";
     WITHDRAWN: "WITHDRAWN";
   }>;
   quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -16789,13 +17368,13 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
     }>;
     status: z.ZodEnum<{
       REJECTED: "REJECTED";
+      COMPLETED: "COMPLETED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
       COLLECTING: "COLLECTING";
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
-      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -16874,6 +17453,39 @@ export declare const flowNotificationWebhookEventSchema: z.ZodObject<{
   storeId: z.ZodString;
   sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+/**
+ * 흐름 상태 변경(이슈 #115) — 주문상품의 흐름 상태(노드)가 바뀔 때마다 온다. 공개 상태(`ORDER.*`)가 같아도 상점 흐름의 단계가 바뀌면 온다
+ * (시안 확인 → 제작중). 묶음 진행이면 `orderItemIds`가 여럿이다. 개인정보는 싣지 않는다
+ */
+export declare const flowStateChangedWebhookEventDataSchema: z.ZodObject<{
+  orderId: z.ZodString;
+  orderItemIds: z.ZodArray<z.ZodString>;
+  flowId: z.ZodString;
+  flowVersion: z.ZodNumber;
+  from: z.ZodNullable<z.ZodString>;
+  to: z.ZodString;
+  label: z.ZodString;
+  coreStatus: z.ZodNullable<z.ZodString>;
+  changedAt: z.ZodString;
+}, z.core.$strip>;
+export declare const flowStateChangedWebhookEventSchema: z.ZodObject<{
+  type: z.ZodLiteral<"ORDER.FLOW_STATE_CHANGED">;
+  data: z.ZodObject<{
+    orderId: z.ZodString;
+    orderItemIds: z.ZodArray<z.ZodString>;
+    flowId: z.ZodString;
+    flowVersion: z.ZodNumber;
+    from: z.ZodNullable<z.ZodString>;
+    to: z.ZodString;
+    label: z.ZodString;
+    coreStatus: z.ZodNullable<z.ZodString>;
+    changedAt: z.ZodString;
+  }, z.core.$strip>;
+  id: z.ZodString;
+  createdAt: z.ZodString;
+  storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
 /** 웹훅 요청 본문. `type`으로 판별하며 `data` 형태가 타입별로 다르다 */
 export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   type: z.ZodEnum<{
@@ -17067,13 +17679,13 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>;
     status: z.ZodEnum<{
       REJECTED: "REJECTED";
+      COMPLETED: "COMPLETED";
       REQUESTED: "REQUESTED";
       HELD: "HELD";
       COLLECTING: "COLLECTING";
       COLLECTED: "COLLECTED";
       REDELIVERING: "REDELIVERING";
       APPROVED: "APPROVED";
-      COMPLETED: "COMPLETED";
       WITHDRAWN: "WITHDRAWN";
     }>;
     quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -17135,6 +17747,23 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   createdAt: z.ZodString;
   storeId: z.ZodString;
   sequence: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"ORDER.FLOW_STATE_CHANGED">;
+  data: z.ZodObject<{
+    orderId: z.ZodString;
+    orderItemIds: z.ZodArray<z.ZodString>;
+    flowId: z.ZodString;
+    flowVersion: z.ZodNumber;
+    from: z.ZodNullable<z.ZodString>;
+    to: z.ZodString;
+    label: z.ZodString;
+    coreStatus: z.ZodNullable<z.ZodString>;
+    changedAt: z.ZodString;
+  }, z.core.$strip>;
+  id: z.ZodString;
+  createdAt: z.ZodString;
+  storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>], "type">;
 export type WebhookEvent = z.infer<typeof webhookEventSchema>;
 export type WebhookEventType = WebhookEvent["type"];