@sayren/store-sdk 0.30.0 → 0.30.1

package/dist/index.d.mts

@@ -165,8 +165,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
 export declare const agentPolicyDecisionSchema: z.ZodEnum<{
-  DENIED: "DENIED";
   APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+  DENIED: "DENIED";
   ALLOW: "ALLOW";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
@@ -190,8 +190,8 @@ export type WritePreview = z.infer<typeof writePreviewSchema>;
 export declare const writeDryRunResultSchema: z.ZodObject<{
   dryRun: z.ZodLiteral<true>;
   decision: z.ZodEnum<{
-    DENIED: "DENIED";
     APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+    DENIED: "DENIED";
     ALLOW: "ALLOW";
   }>;
   reason: 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<{
@@ -2074,13 +2074,13 @@ 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>;
@@ -2112,13 +2112,13 @@ 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>;
@@ -2160,8 +2160,91 @@ 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>>;
+    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,13 +2270,13 @@ 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>;
@@ -2325,9 +2408,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 +2484,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 +3839,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 +3867,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 +3899,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 +3981,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 +4036,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 +4100,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 +4129,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 +4172,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 +4262,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 +4416,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 +4627,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>>;
@@ -6895,9 +7166,9 @@ export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
 export declare const productSortSchema: z.ZodEnum<{
   "createdAt.desc": "createdAt.desc";
   "createdAt.asc": "createdAt.asc";
+  "updatedAt.desc": "updatedAt.desc";
   "salePrice.asc": "salePrice.asc";
   "salePrice.desc": "salePrice.desc";
-  "updatedAt.desc": "updatedAt.desc";
 }>;
 export type ProductSort = z.infer<typeof productSortSchema>;
 export interface ProductListParams extends PageParams {
@@ -6926,9 +7197,9 @@ export declare const productListQuerySchema: z.ZodObject<{
   sort: z.ZodOptional<z.ZodEnum<{
     "createdAt.desc": "createdAt.desc";
     "createdAt.asc": "createdAt.asc";
+    "updatedAt.desc": "updatedAt.desc";
     "salePrice.asc": "salePrice.asc";
     "salePrice.desc": "salePrice.desc";
-    "updatedAt.desc": "updatedAt.desc";
   }>>;
 }, z.core.$strip>;
 export declare const discountRequestSchema: z.ZodObject<{
@@ -10284,6 +10555,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 +10698,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 +10723,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,7 +11111,7 @@ 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;
@@ -10858,6 +11145,23 @@ 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;
+        progress?: boolean | undefined;
+      }[] | undefined;
     }>;
     /**
      * `POST /order-items/{id}/actions/{key}` — `getFlow().actions`에 켜진 행동을 실행한다(#115). 묶음 진행이면
@@ -10871,7 +11175,7 @@ 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;
@@ -10913,7 +11217,49 @@ 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;
+        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;
+          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;
@@ -10943,6 +11289,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 +11400,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 +11438,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 +11476,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 +11529,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         version: number;
         status: "ACTIVE" | "DRAFT" | "LEGACY";
         publishedAt: string | null;
+        inProgress?: number | undefined;
       }[];
     }>;
     /** 이 상품에 지금 붙을 플로우 */
@@ -11155,6 +11553,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 +11663,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 +11703,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 +11738,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 +11772,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 +13728,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 +13738,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 +13748,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 +13758,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 +13773,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 +13783,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 +13810,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 +13845,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 +17048,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 +17279,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 +17364,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 +17590,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 +17658,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"];