@sayren/store-sdk 0.29.6 → 0.29.8

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<{
-  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   DENIED: "DENIED";
+  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   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<{
-    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
     DENIED: "DENIED";
+    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
     ALLOW: "ALLOW";
   }>;
   reason: z.ZodNullable<z.ZodString>;
@@ -2007,6 +2007,397 @@ export declare const collectionPreviewSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type CollectionPreview = z.infer<typeof collectionPreviewSchema>;
 //#endregion
+//#region src/schemas/commerce-flow.d.ts
+/**
+ * 커머스 플로우(이슈 #115) — 주문상품이 따르는 플로우의 지금 상태와 할 수 있는 행동. 공개 계약은 필드 추가로만 자란다.
+ * 행동 키·필드 키·꺼진 이유는 상점·앱이 늘리는 **열린 문자열**이다(모르는 값도 파싱한다). 공개 상태(`coreStatus`)만 닫힌 8개 값이다.
+ * 화면은 이 값만 그리고 상태 이름으로 분기하지 않는다 — 판정은 서버가 한다.
+ */
+export declare const flowInputFieldSchema: z.ZodObject<{
+  key: z.ZodString;
+  type: z.ZodString;
+  required: z.ZodBoolean;
+  label: z.ZodString;
+  maxLength: z.ZodOptional<z.ZodNumber>;
+  maxFiles: z.ZodOptional<z.ZodNumber>;
+  options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+}, z.core.$strip>;
+export type FlowInputField = z.infer<typeof flowInputFieldSchema>;
+export declare const flowActionSchema: z.ZodObject<{
+  key: z.ZodString;
+  label: z.ZodString;
+  mode: z.ZodEnum<{
+    REQUEST: "REQUEST";
+    INSTANT: "INSTANT";
+    VIEW: "VIEW";
+  }>;
+  enabled: z.ZodBoolean;
+  disabled: z.ZodOptional<z.ZodObject<{
+    reason: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  availableUntil: z.ZodOptional<z.ZodString>;
+  subflow: z.ZodOptional<z.ZodString>;
+  input: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    type: z.ZodString;
+    required: z.ZodBoolean;
+    label: z.ZodString;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+    maxFiles: z.ZodOptional<z.ZodNumber>;
+    options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+  }, z.core.$strip>>>;
+  partialQuantity: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"UNIT">]>>;
+}, z.core.$strip>;
+export type FlowAction = z.infer<typeof flowActionSchema>;
+/** 커스텀 필드 값 — 문자열(날짜·일시는 ISO 8601)·숫자·참거짓·null, 수량 단위 필드는 문자열 배열 */
+export declare const flowFieldValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodString>]>;
+export type FlowFieldValue = z.infer<typeof flowFieldValueSchema>;
+export declare const flowStateSchema: 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";
+    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>>;
+  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>;
+export type FlowState = z.infer<typeof flowStateSchema>;
+export declare const orderItemFlowSchema: z.ZodObject<{
+  orderItemId: z.ZodString;
+  flow: z.ZodObject<{
+    flowId: z.ZodString;
+    version: z.ZodNumber;
+  }, z.core.$strip>;
+  flowState: 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";
+      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>>;
+    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>;
+  actions: z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    mode: z.ZodEnum<{
+      REQUEST: "REQUEST";
+      INSTANT: "INSTANT";
+      VIEW: "VIEW";
+    }>;
+    enabled: z.ZodBoolean;
+    disabled: z.ZodOptional<z.ZodObject<{
+      reason: z.ZodString;
+      message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    availableUntil: z.ZodOptional<z.ZodString>;
+    subflow: z.ZodOptional<z.ZodString>;
+    input: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      key: z.ZodString;
+      type: z.ZodString;
+      required: z.ZodBoolean;
+      label: z.ZodString;
+      maxLength: z.ZodOptional<z.ZodNumber>;
+      maxFiles: z.ZodOptional<z.ZodNumber>;
+      options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    }, z.core.$strip>>>;
+    partialQuantity: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"UNIT">]>>;
+  }, z.core.$strip>>;
+  timers: z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    dueAt: z.ZodString;
+    paused: z.ZodBoolean;
+  }, z.core.$strip>>;
+  ended: z.ZodBoolean;
+}, z.core.$strip>;
+export type OrderItemFlow = z.infer<typeof orderItemFlowSchema>;
+export declare const flowActionRequestSchema: z.ZodObject<{
+  input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type FlowActionRequest = z.infer<typeof flowActionRequestSchema>;
+/**
+ * 행동 실행 결과. 지금은 동기 완료(COMPLETED)뿐이다. 외부 호출이 든 전이는 202와 함께 ACCEPTED(runId)가 온다(HTTP·앱 노드 단계에서 더한다).
+ * 동기 거절은 409(ACTION_NOT_AVAILABLE)다.
+ */
+export declare const flowActionResultSchema: z.ZodObject<{
+  status: z.ZodLiteral<"COMPLETED">;
+  flowState: 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";
+      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>>;
+    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>;
+  actions: z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    mode: z.ZodEnum<{
+      REQUEST: "REQUEST";
+      INSTANT: "INSTANT";
+      VIEW: "VIEW";
+    }>;
+    enabled: z.ZodBoolean;
+    disabled: z.ZodOptional<z.ZodObject<{
+      reason: z.ZodString;
+      message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    availableUntil: z.ZodOptional<z.ZodString>;
+    subflow: z.ZodOptional<z.ZodString>;
+    input: z.ZodOptional<z.ZodArray<z.ZodObject<{
+      key: z.ZodString;
+      type: z.ZodString;
+      required: z.ZodBoolean;
+      label: z.ZodString;
+      maxLength: z.ZodOptional<z.ZodNumber>;
+      maxFiles: z.ZodOptional<z.ZodNumber>;
+      options: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    }, z.core.$strip>>>;
+    partialQuantity: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"UNIT">]>>;
+  }, z.core.$strip>>;
+  affectedOrderItemIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type FlowActionResult = z.infer<typeof flowActionResultSchema>;
+export declare const flowPresetSummarySchema: z.ZodObject<{
+  key: z.ZodString;
+  presetVersion: z.ZodNumber;
+  name: z.ZodString;
+  description: z.ZodString;
+  availability: z.ZodEnum<{
+    AVAILABLE: "AVAILABLE";
+    BLOCKED: "BLOCKED";
+  }>;
+  dependsOn: z.ZodArray<z.ZodString>;
+  requires: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  variables: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type FlowPresetSummary = z.infer<typeof flowPresetSummarySchema>;
+export declare const commerceFlowSummarySchema: z.ZodObject<{
+  flowId: z.ZodString;
+  key: z.ZodString;
+  name: z.ZodString;
+  progression: z.ZodEnum<{
+    ITEM: "ITEM";
+    ORDER_GROUP: "ORDER_GROUP";
+  }>;
+  fulfillmentMethods: z.ZodArray<z.ZodString>;
+  presetKey: z.ZodNullable<z.ZodString>;
+  presetVersion: z.ZodNullable<z.ZodNumber>;
+  activeVersion: z.ZodNullable<z.ZodNumber>;
+  archivedAt: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodString;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type CommerceFlowSummary = z.infer<typeof commerceFlowSummarySchema>;
+export declare const commerceFlowVersionViewSchema: z.ZodObject<{
+  version: z.ZodNumber;
+  status: z.ZodEnum<{
+    ACTIVE: "ACTIVE";
+    DRAFT: "DRAFT";
+    LEGACY: "LEGACY";
+  }>;
+  revision: z.ZodNumber;
+  graph: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  definition: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  variables: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  publishedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const commerceFlowSchema: z.ZodObject<{
+  flowId: z.ZodString;
+  key: z.ZodString;
+  name: z.ZodString;
+  progression: z.ZodEnum<{
+    ITEM: "ITEM";
+    ORDER_GROUP: "ORDER_GROUP";
+  }>;
+  fulfillmentMethods: z.ZodArray<z.ZodString>;
+  presetKey: z.ZodNullable<z.ZodString>;
+  presetVersion: z.ZodNullable<z.ZodNumber>;
+  activeVersion: z.ZodNullable<z.ZodNumber>;
+  archivedAt: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodString;
+  updatedAt: z.ZodString;
+  draft: z.ZodNullable<z.ZodObject<{
+    version: z.ZodNumber;
+    status: z.ZodEnum<{
+      ACTIVE: "ACTIVE";
+      DRAFT: "DRAFT";
+      LEGACY: "LEGACY";
+    }>;
+    revision: z.ZodNumber;
+    graph: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    definition: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    variables: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    publishedAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  active: z.ZodNullable<z.ZodObject<{
+    version: z.ZodNumber;
+    status: z.ZodEnum<{
+      ACTIVE: "ACTIVE";
+      DRAFT: "DRAFT";
+      LEGACY: "LEGACY";
+    }>;
+    revision: z.ZodNumber;
+    graph: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    definition: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    variables: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    publishedAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  versions: z.ZodArray<z.ZodObject<{
+    version: z.ZodNumber;
+    status: z.ZodEnum<{
+      ACTIVE: "ACTIVE";
+      DRAFT: "DRAFT";
+      LEGACY: "LEGACY";
+    }>;
+    publishedAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CommerceFlow = z.infer<typeof commerceFlowSchema>;
+export declare const createCommerceFlowRequestSchema: z.ZodObject<{
+  key: z.ZodString;
+  name: z.ZodOptional<z.ZodString>;
+  presetKey: z.ZodOptional<z.ZodString>;
+  variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type CreateCommerceFlowRequest = z.infer<typeof createCommerceFlowRequestSchema>;
+export declare const saveFlowDraftRequestSchema: z.ZodObject<{
+  graph: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  definition: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  variables: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type SaveFlowDraftRequest = z.infer<typeof saveFlowDraftRequestSchema>;
+export declare const commerceFlowCheckSchema: z.ZodObject<{
+  publishable: z.ZodBoolean;
+  blocking: z.ZodArray<z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    nodeId: z.ZodOptional<z.ZodString>;
+    edgeId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+  warnings: z.ZodArray<z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    nodeId: z.ZodOptional<z.ZodString>;
+    edgeId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CommerceFlowCheck = z.infer<typeof commerceFlowCheckSchema>;
+export declare const flowAssignmentRuleSchema: z.ZodObject<{
+  ruleId: z.ZodString;
+  priority: z.ZodNumber;
+  condition: z.ZodString;
+  flowId: z.ZodString;
+}, z.core.$strip>;
+export type FlowAssignmentRule = z.infer<typeof flowAssignmentRuleSchema>;
+export declare const saveFlowAssignmentRulesRequestSchema: z.ZodObject<{
+  rules: z.ZodArray<z.ZodObject<{
+    condition: z.ZodString;
+    flowId: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SaveFlowAssignmentRulesRequest = z.infer<typeof saveFlowAssignmentRulesRequestSchema>;
+export declare const resolvedFlowSchema: z.ZodObject<{
+  flowId: z.ZodString;
+  version: z.ZodNumber;
+  source: z.ZodEnum<{
+    RULE: "RULE";
+    PLATFORM: "PLATFORM";
+  }>;
+  ruleId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ResolvedFlow = z.infer<typeof resolvedFlowSchema>;
+export declare const testFlowAssignmentRequestSchema: z.ZodObject<{
+  productId: z.ZodString;
+  orderAmount: z.ZodOptional<z.ZodNumber>;
+  paymentMethod: z.ZodOptional<z.ZodString>;
+  member: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TestFlowAssignmentRequest = z.infer<typeof testFlowAssignmentRequestSchema>;
+/** 시크릿 이름 — 플로우 변수 `secretRef`의 값이다 */
+export declare const flowSecretNameSchema: z.ZodString;
+/** HTTP 노드가 부를 셀러 API — 헤더 값은 응답에 싣지 않는다 */
+export declare const flowSecretSchema: z.ZodObject<{
+  name: z.ZodString;
+  url: z.ZodString;
+  headerNames: z.ZodArray<z.ZodString>;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type FlowSecret = z.infer<typeof flowSecretSchema>;
+export declare const saveFlowSecretRequestSchema: z.ZodObject<{
+  url: z.ZodURL;
+  headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type SaveFlowSecretRequest = z.input<typeof saveFlowSecretRequestSchema>;
+//#endregion
 //#region src/schemas/coupon.d.ts
 /**
  * 쿠폰 관리 API 계약 (이슈 #47) — `/v1/coupons/**`, 스코프 `promotion:r|rw`.
@@ -2022,10 +2413,15 @@ export declare const couponStatusSchema: z.ZodEnum<{
   ENDED: "ENDED";
 }>;
 export type CouponStatus = z.infer<typeof couponStatusSchema>;
-/** 지금 만들 수 있는 발급 방식 — 다운로드·가입 자동 지급은 뒤 단계다 */
+/**
+ * 발급 방식 — 코드 입력·셀러 지급·다운로드(구매자가 받기)·회원가입 자동 지급(이슈 #110).
+ * 응답(`couponSchema.issueMethod`)은 값이 늘 수 있어 문자열로 받는다. 이 enum은 요청 검증용이다.
+ */
 export declare const couponIssueMethodSchema: z.ZodEnum<{
   MANUAL: "MANUAL";
   CODE: "CODE";
+  DOWNLOAD: "DOWNLOAD";
+  SIGNUP: "SIGNUP";
 }>;
 export type CouponIssueMethod = z.infer<typeof couponIssueMethodSchema>;
 /** 코드 형식 — 영문·숫자·`-`·`_` 6~30자. 대소문자를 구분하지 않고 서버가 대문자로 저장한다 */
@@ -2078,6 +2474,8 @@ export declare const createCouponRequestSchema: z.ZodObject<{
   issueMethod: z.ZodEnum<{
     MANUAL: "MANUAL";
     CODE: "CODE";
+    DOWNLOAD: "DOWNLOAD";
+    SIGNUP: "SIGNUP";
   }>;
   code: z.ZodOptional<z.ZodString>;
   startsAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
@@ -2196,6 +2594,8 @@ export declare const couponListQuerySchema: z.ZodObject<{
   issueMethod: z.ZodOptional<z.ZodEnum<{
     MANUAL: "MANUAL";
     CODE: "CODE";
+    DOWNLOAD: "DOWNLOAD";
+    SIGNUP: "SIGNUP";
   }>>;
   q: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -2206,6 +2606,7 @@ export declare const couponIssueSchema: z.ZodObject<{
   couponId: z.ZodString;
   customerId: z.ZodString;
   customerName: z.ZodNullable<z.ZodString>;
+  source: z.ZodOptional<z.ZodString>;
   status: z.ZodString;
   validFrom: z.ZodString;
   validUntil: z.ZodNullable<z.ZodString>;
@@ -2284,6 +2685,7 @@ export declare const customerCouponSchema: z.ZodObject<{
   couponId: z.ZodString;
   customerId: z.ZodString;
   customerName: z.ZodNullable<z.ZodString>;
+  source: z.ZodOptional<z.ZodString>;
   status: z.ZodString;
   validFrom: z.ZodString;
   validUntil: z.ZodNullable<z.ZodString>;
@@ -2384,8 +2786,8 @@ export type ConsentAction = z.infer<typeof consentActionSchema>;
  * `RECONSENT` 약관 개정 재동의 · `MEMBER_UPDATE` 구매자가 직접 변경 · `SELLER` 셀러가 처리
  */
 export declare const consentSourceSchema: z.ZodEnum<{
-  SELLER: "SELLER";
   SIGNUP: "SIGNUP";
+  SELLER: "SELLER";
   SOCIAL_SIGNUP: "SOCIAL_SIGNUP";
   DELEGATED: "DELEGATED";
   RECONSENT: "RECONSENT";
@@ -2407,8 +2809,8 @@ export declare const customerConsentSchema: z.ZodObject<{
     AGREED: "AGREED";
   }>;
   source: z.ZodEnum<{
-    SELLER: "SELLER";
     SIGNUP: "SIGNUP";
+    SELLER: "SELLER";
     SOCIAL_SIGNUP: "SOCIAL_SIGNUP";
     DELEGATED: "DELEGATED";
     RECONSENT: "RECONSENT";
@@ -2611,7 +3013,341 @@ export declare const customerWithdrawalBlockedDetailsSchema: z.ZodObject<{
   openClaims: z.ZodNumber;
   pendingPayments: z.ZodNumber;
 }, z.core.$strip>;
-export type CustomerWithdrawalBlockedDetails = z.infer<typeof customerWithdrawalBlockedDetailsSchema>;
+export type CustomerWithdrawalBlockedDetails = z.infer<typeof customerWithdrawalBlockedDetailsSchema>;
+//#endregion
+//#region src/schemas/fulfillment.d.ts
+/**
+ * 상품 유형 (이슈 #48·#57) — 배송이 필요한 상품과 필요 없는 상품을 가르는 축이다.
+ *
+ * **상품 유형은 이행 방식 하나로 표현한다.** `fulfillment.type`이 배송 필요 여부, 이행 흐름, 클레임 규칙을 정한다.
+ * 코드 곳곳에서 유형 이름으로 분기하지 않고 이 파일의 판정 함수(`requiresShipping`·`fulfillmentRuleOf`)를 지난다.
+ *
+ * 주문상품 상태 enum은 바꾸지 않는다. 비실물의 **제공 완료는 `DELIVERED`를 재사용한다** — 새 상태를 더하면 기존 소비자의
+ * 상태 분기(배송완료 뒤 구매확정 대기, 반품 가능 판정)가 새 값을 모른다. 표시는 유형으로 가른다.
+ */
+/**
+ * 상품 유형.
+ * - `SHIPPING` 배송 상품. 택배로 발송하고 송장·배송 추적으로 배송완료가 된다
+ * - `MANUAL` 배송 없는 상품(비실물). 셀러가 제공 처리(`POST /v1/order-items/{orderItemId}/fulfill`)로 제공 완료를 기록한다
+ *
+ * 비실물의 세부 구분(파일 다운로드·코드 발급·이용권·방문 수령)은 2026-09-28에 제품에서 뺐다(이슈 #48 범위 축소).
+ * 이름은 이행 방식이다 — `SHIPPING`이 택배 발송이듯 `MANUAL`은 셀러가 직접 제공한다는 뜻이다.
+ */
+export declare const fulfillmentTypeSchema: z.ZodEnum<{
+  SHIPPING: "SHIPPING";
+  MANUAL: "MANUAL";
+}>;
+export type FulfillmentType = z.infer<typeof fulfillmentTypeSchema>;
+/**
+ * 응답 스키마용 유형 — 서버가 나중에 유형을 더해도 옛 SDK가 응답 파싱에서 깨지지 않게 문자열로 받는다.
+ * 요청은 `fulfillmentTypeSchema`(닫힌 enum)로 검증한다.
+ */
+export declare const fulfillmentTypeResponseSchema: z.ZodString;
+/** 유형 하나의 규칙 — 배송·클레임이 이 표를 읽는다 */
+export interface FulfillmentRule {
+  /** 택배 배송이 필요한가 — 배송비·배송지·발송 흐름의 대상인가 */
+  requiresShipping: boolean;
+  /** 반품에 수거가 필요한가 — 실물만 수거한다 */
+  requiresCollection: boolean;
+  /** 교환을 받는가 — 실물만 받는다 */
+  exchangeSupported: boolean;
+}
+/** 유형별 규칙표 — **유일한 원천이다.** */
+export declare const FULFILLMENT_RULES: Readonly<Record<FulfillmentType, FulfillmentRule>>;
+/**
+ * 저장된 값 → 유형. null·모르는 값은 `SHIPPING`이다 — 이 필드 이전의 상품·주문상품은 모두 배송 상품이었다.
+ */
+export declare function fulfillmentTypeOf(value: string | null | undefined): FulfillmentType;
+/** 유형의 규칙 — 모르는 값은 배송 상품 규칙이다 */
+export declare function fulfillmentRuleOf(type: string | null | undefined): FulfillmentRule;
+/**
+ * 이행 방식.
+ * - `CARRIER` 택배(송장·배송 추적)
+ * - `DIRECT` 직접 배달(배송지 있음, 송장 없음)
+ * - `PICKUP` 방문 수령(배송지·배송비 없음)
+ * - `PROVIDED` 제공 처리(배송 없는 상품)
+ */
+export declare const FULFILLMENT_METHODS: readonly ["CARRIER", "DIRECT", "PICKUP", "PROVIDED"];
+export declare const fulfillmentMethodSchema: z.ZodEnum<{
+  CARRIER: "CARRIER";
+  DIRECT: "DIRECT";
+  PICKUP: "PICKUP";
+  PROVIDED: "PROVIDED";
+}>;
+export type FulfillmentMethod = z.infer<typeof fulfillmentMethodSchema>;
+/** 방식 하나의 규칙 */
+export interface FulfillmentMethodRule {
+  /** 배송지를 받는가 — 배송비 묶음·배송지 필수 판정의 대상인가 */
+  requiresAddress: boolean;
+  /** 송장 등록·배송 추적으로 배송완료가 되는가 */
+  carrierTracking: boolean;
+  /** 구매자가 픽업 장소를 고르는가 */
+  pickupLocation: boolean;
+}
+/** 방식별 규칙표 — **유일한 원천이다.** */
+export declare const FULFILLMENT_METHOD_RULES: Readonly<Record<FulfillmentMethod, FulfillmentMethodRule>>;
+/** 유형별 허용 방식 — 첫 값이 유형 기본이다 */
+export declare const FULFILLMENT_METHODS_BY_TYPE: Readonly<Record<FulfillmentType, readonly FulfillmentMethod[]>>;
+/** 유형의 기본 방식 — 허용 방식을 두지 않은 상품·이 필드 이전 주문상품 */
+export declare function defaultFulfillmentMethodOf(type: string | null | undefined): FulfillmentMethod;
+/** 상품의 허용 방식 — 두지 않았으면 유형 기본 하나다 */
+export declare function fulfillmentMethodsOf(fulfillment: {
+  type: string;
+  methods?: readonly string[] | null;
+}): FulfillmentMethod[];
+/** 저장된 방식 → 방식. null·모르는 값은 유형 기본이다 */
+export declare function fulfillmentMethodOf(type: string | null | undefined, method: string | null | undefined): FulfillmentMethod;
+/**
+ * 택배 배송이 필요한가 — 배송비 묶음·배송지·발송 흐름의 판정은 이 함수 하나를 지난다.
+ * 방식을 주면 방식 규칙도 본다(배송 상품의 방문 수령은 배송이 없다). 방식을 모르면 유형 규칙만 본다.
+ */
+export declare function requiresShipping(type: string | null | undefined, method?: string | null): boolean;
+/** 반품에 수거가 필요한가 — 비실물 반품은 수거 등록·수거 완료 없이 승인한다 */
+export declare function requiresCollection(type: string | null | undefined): boolean;
+/**
+ * 배송이 없는 주문상품의 배송 묶음 키 (`order_items.delivery_bundle_key`).
+ *
+ * null로 두면 환불 정산이 #29 이전 주문의 레거시 폴백(「묶음 = 같은 상품」, 상품의 **현재** 배송비)을 탄다.
+ * 이 키를 만나면 배송비 환불·차감이 0이고 `orders.delivery_fee_settlements`에 항목을 만들지 않는다.
+ * 정책 지문 키(`b:…`)와 겹치지 않는다.
+ */
+export declare const NO_SHIPPING_BUNDLE_KEY = "none";
+/** 배송비 유형 — 무료·유료·조건부 무료 */
+export declare const deliveryTypeSchema: z.ZodEnum<{
+  FREE: "FREE";
+  PAID: "PAID";
+  CONDITIONAL_FREE: "CONDITIONAL_FREE";
+}>;
+export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
+/**
+ * 상품 이행 — 등록(POST). 배송 상품의 `shipping`을 생략하면 기본값(유료 배송·상점 기본 배송비·기본 출고지·반품지)이다.
+ */
+export declare const productFulfillmentCreateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodOptional<z.ZodObject<{
+    deliveryType: z.ZodDefault<z.ZodEnum<{
+      FREE: "FREE";
+      PAID: "PAID";
+      CONDITIONAL_FREE: "CONDITIONAL_FREE";
+    }>>;
+    deliveryFee: z.ZodOptional<z.ZodNumber>;
+    conditionalFreeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$strict>>;
+  methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    CARRIER: "CARRIER";
+    DIRECT: "DIRECT";
+    PICKUP: "PICKUP";
+    PROVIDED: "PROVIDED";
+  }>>>;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"MANUAL">;
+  methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    CARRIER: "CARRIER";
+    DIRECT: "DIRECT";
+    PICKUP: "PICKUP";
+    PROVIDED: "PROVIDED";
+  }>>>;
+}, z.core.$strict>], "type">;
+export type ProductFulfillmentCreate = z.infer<typeof productFulfillmentCreateSchema>;
+/** 등록 요청의 입력 모양 — 기본값이 채워지기 전(생략 가능한 필드가 optional) */
+export type ProductFulfillmentCreateInput = z.input<typeof productFulfillmentCreateSchema>;
+/**
+ * 상품 이행 — 수정(PUT·PATCH). 통째 교체이고 유형 키와 그 안의 필드가 **모두 필수**다. 서버는 현재 값과 병합하지 않는다.
+ * `fulfillment` 자체를 생략하면 이행을 바꾸지 않는다.
+ */
+export declare const productFulfillmentUpdateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    deliveryType: z.ZodEnum<{
+      FREE: "FREE";
+      PAID: "PAID";
+      CONDITIONAL_FREE: "CONDITIONAL_FREE";
+    }>;
+    deliveryFee: z.ZodNumber;
+    conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+    shippingAddressId: z.ZodNullable<z.ZodString>;
+    returnAddressId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strict>;
+  methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    CARRIER: "CARRIER";
+    DIRECT: "DIRECT";
+    PICKUP: "PICKUP";
+    PROVIDED: "PROVIDED";
+  }>>>;
+}, z.core.$strict>, z.ZodObject<{
+  type: z.ZodLiteral<"MANUAL">;
+  methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+    CARRIER: "CARRIER";
+    DIRECT: "DIRECT";
+    PICKUP: "PICKUP";
+    PROVIDED: "PROVIDED";
+  }>>>;
+}, z.core.$strict>], "type">;
+export type ProductFulfillmentUpdate = z.infer<typeof productFulfillmentUpdateSchema>;
+/**
+ * 저장된 상품 이행 — 알려진 유형의 닫힌 유니온. 서버의 상품 엔티티와 응답이 이 모양을 쓴다.
+ * 응답 파싱은 `productFulfillmentResponseSchema`(열린 유니온)를 쓴다.
+ */
+export declare const productFulfillmentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    deliveryType: z.ZodEnum<{
+      FREE: "FREE";
+      PAID: "PAID";
+      CONDITIONAL_FREE: "CONDITIONAL_FREE";
+    }>;
+    deliveryFee: z.ZodNumber;
+    conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+    shippingAddressId: z.ZodNullable<z.ZodString>;
+    returnAddressId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+  methods: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"MANUAL">;
+  methods: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>], "type">;
+export type ProductFulfillment = z.infer<typeof productFulfillmentSchema>;
+/** 유형 이름 → 그 유형의 저장된 이행 */
+export type ProductFulfillmentOf<T extends FulfillmentType> = Extract<ProductFulfillment, {
+  type: T;
+}>;
+/** 응답이 알려 주는 모르는 유형 — SDK가 아직 모르는 유형(서버가 나중에 더한 유형) */
+export interface UnknownFulfillment {
+  type: "OTHER";
+  /** 서버가 보낸 유형 이름 */
+  rawType: string;
+}
+/**
+ * 열린 응답 유니온 — 알려진 유형은 판별 유니온으로 검사하고, **모르는 유형만** `{ type: "OTHER", rawType }`로 읽는다.
+ *
+ * `type: z.string()` 가지를 그대로 두면 TS가 `type === "SHIPPING"`으로 좁혀도 문자열 가지가 남는다. `OTHER` 리터럴로 바꿔 좁히기를
+ * 지킨다. 알려진 유형의 모양이 틀린 응답은 폴백으로 숨기지 않고 파싱 오류로 둔다.
+ */
+export declare function openFulfillmentUnion<T extends z.ZodType>(known: T): z.ZodUnion<readonly [T, z.ZodPipe<z.ZodObject<{
+  type: z.ZodString;
+}, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+  [x: string]: unknown;
+  type: string;
+}>>]>;
+export declare const productFulfillmentResponseSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    deliveryType: z.ZodEnum<{
+      FREE: "FREE";
+      PAID: "PAID";
+      CONDITIONAL_FREE: "CONDITIONAL_FREE";
+    }>;
+    deliveryFee: z.ZodNumber;
+    conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
+    shippingAddressId: z.ZodNullable<z.ZodString>;
+    returnAddressId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+  methods: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"MANUAL">;
+  methods: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+  type: z.ZodString;
+}, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+  [x: string]: unknown;
+  type: string;
+}>>]>;
+export type ProductFulfillmentView = z.infer<typeof productFulfillmentResponseSchema>;
+/** 주문상품의 주문 시점 픽업 장소 — 장소를 고치거나 지워도 이 주문의 안내는 바뀌지 않는다 */
+export declare const pickupLocationSnapshotSchema: z.ZodObject<{
+  locationId: z.ZodString;
+  name: z.ZodString;
+  address: z.ZodString;
+  phone: z.ZodNullable<z.ZodString>;
+  hours: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type PickupLocationSnapshot = z.infer<typeof pickupLocationSnapshotSchema>;
+/**
+ * 주문상품의 주문 시점 이행 — 결제 확정이 주문서 줄에서 굳힌다. 상품의 현재 값이 아니다. 서버는 주문상품 컬럼
+ * (`fulfillment_type`·`delivery_bundle_key`)과 jsonb(`fulfillment_snapshot`)를 합쳐 이 모양을 만든다.
+ */
+export declare const orderItemFulfillmentSnapshotSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    bundleKey: z.ZodNullable<z.ZodString>;
+    returnAddressId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+  method: z.ZodOptional<z.ZodString>;
+  pickupLocation: z.ZodOptional<z.ZodObject<{
+    locationId: z.ZodString;
+    name: z.ZodString;
+    address: z.ZodString;
+    phone: z.ZodNullable<z.ZodString>;
+    hours: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"MANUAL">;
+  method: z.ZodOptional<z.ZodString>;
+  pickupLocation: z.ZodOptional<z.ZodObject<{
+    locationId: z.ZodString;
+    name: z.ZodString;
+    address: z.ZodString;
+    phone: z.ZodNullable<z.ZodString>;
+    hours: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>], "type">;
+export type OrderItemFulfillmentSnapshot = z.infer<typeof orderItemFulfillmentSnapshotSchema>;
+export declare const orderItemFulfillmentSnapshotResponseSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"SHIPPING">;
+  shipping: z.ZodObject<{
+    bundleKey: z.ZodNullable<z.ZodString>;
+    returnAddressId: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+  method: z.ZodOptional<z.ZodString>;
+  pickupLocation: z.ZodOptional<z.ZodObject<{
+    locationId: z.ZodString;
+    name: z.ZodString;
+    address: z.ZodString;
+    phone: z.ZodNullable<z.ZodString>;
+    hours: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+  type: z.ZodLiteral<"MANUAL">;
+  method: z.ZodOptional<z.ZodString>;
+  pickupLocation: z.ZodOptional<z.ZodObject<{
+    locationId: z.ZodString;
+    name: z.ZodString;
+    address: z.ZodString;
+    phone: z.ZodNullable<z.ZodString>;
+    hours: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
+  type: z.ZodString;
+}, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
+  [x: string]: unknown;
+  type: string;
+}>>]>;
+export type OrderItemFulfillmentSnapshotView = z.infer<typeof orderItemFulfillmentSnapshotResponseSchema>;
+/** 상점당 픽업 장소 상한 */
+export declare const MAX_PICKUP_LOCATIONS = 20;
+/** 방문 수령(`PICKUP`) 장소 — 상점 설정이다. 구매자가 주문서에서 고르고 주문상품에 주문 시점 값이 남는다 */
+export declare const pickupLocationSchema: z.ZodObject<{
+  locationId: z.ZodString;
+  name: z.ZodString;
+  address: z.ZodString;
+  phone: z.ZodNullable<z.ZodString>;
+  hours: z.ZodNullable<z.ZodString>;
+  usable: z.ZodBoolean;
+  sortOrder: z.ZodNumber;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+export type PickupLocation = z.infer<typeof pickupLocationSchema>;
+export declare const pickupLocationRequestSchema: z.ZodObject<{
+  name: z.ZodString;
+  address: z.ZodString;
+  phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  hours: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  usable: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export type PickupLocationRequest = z.infer<typeof pickupLocationRequestSchema>;
+export type PickupLocationRequestInput = z.input<typeof pickupLocationRequestSchema>;
 //#endregion
 //#region src/schemas/login.d.ts
 /** 소셜 로그인 공급자 */
@@ -2884,6 +3620,7 @@ export declare const eventTypeSchema: z.ZodEnum<{
   "INQUIRY.CREATED": "INQUIRY.CREATED";
   "REVIEW.CREATED": "REVIEW.CREATED";
   "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
+  "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
 }>;
 export type EventType = z.infer<typeof eventTypeSchema>;
 export declare const webhookStatusSchema: z.ZodEnum<{
@@ -2910,6 +3647,7 @@ export declare const webhookSchema: z.ZodObject<{
     "INQUIRY.CREATED": "INQUIRY.CREATED";
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
+    "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
   }>>;
   status: z.ZodEnum<{
     SUSPENDED: "SUSPENDED";
@@ -2940,6 +3678,7 @@ export declare const webhookCreatedSchema: z.ZodObject<{
     "INQUIRY.CREATED": "INQUIRY.CREATED";
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
+    "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
   }>>;
   status: z.ZodEnum<{
     SUSPENDED: "SUSPENDED";
@@ -3020,6 +3759,7 @@ export declare const webhookDeliverySchema: z.ZodObject<{
     "INQUIRY.CREATED": "INQUIRY.CREATED";
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
+    "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
   }>;
   url: z.ZodString;
   status: z.ZodEnum<{
@@ -3073,6 +3813,7 @@ export declare const webhookDeliveryDetailSchema: z.ZodObject<{
     "INQUIRY.CREATED": "INQUIRY.CREATED";
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
+    "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
   }>;
   url: z.ZodString;
   status: z.ZodEnum<{
@@ -3135,6 +3876,7 @@ export declare const webhookDeliveryListQuerySchema: z.ZodObject<{
     "INQUIRY.CREATED": "INQUIRY.CREATED";
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
+    "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
   }>>;
   resourceId: z.ZodOptional<z.ZodString>;
   limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
@@ -3162,6 +3904,7 @@ export declare const webhookTestRequestSchema: z.ZodObject<{
     "INQUIRY.CREATED": "INQUIRY.CREATED";
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
+    "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
   }>;
 }, z.core.$strip>;
 export type WebhookTestRequest = z.infer<typeof webhookTestRequestSchema>;
@@ -3203,6 +3946,7 @@ export declare const webhookRequestSchema: z.ZodObject<{
     "INQUIRY.CREATED": "INQUIRY.CREATED";
     "REVIEW.CREATED": "REVIEW.CREATED";
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
+    "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
   }>>;
 }, z.core.$strip>;
 export type WebhookRequest = z.infer<typeof webhookRequestSchema>;
@@ -3275,208 +4019,6 @@ export declare const reviewReportResultSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ReviewReportResult = z.infer<typeof reviewReportResultSchema>;
 //#endregion
-//#region src/schemas/fulfillment.d.ts
-/**
- * 상품 유형 (이슈 #48·#57) — 배송이 필요한 상품과 필요 없는 상품을 가르는 축이다.
- *
- * **상품 유형은 이행 방식 하나로 표현한다.** `fulfillment.type`이 배송 필요 여부, 이행 흐름, 클레임 규칙을 정한다.
- * 코드 곳곳에서 유형 이름으로 분기하지 않고 이 파일의 판정 함수(`requiresShipping`·`fulfillmentRuleOf`)를 지난다.
- *
- * 주문상품 상태 enum은 바꾸지 않는다. 비실물의 **제공 완료는 `DELIVERED`를 재사용한다** — 새 상태를 더하면 기존 소비자의
- * 상태 분기(배송완료 뒤 구매확정 대기, 반품 가능 판정)가 새 값을 모른다. 표시는 유형으로 가른다.
- */
-/**
- * 상품 유형.
- * - `SHIPPING` 배송 상품. 택배로 발송하고 송장·배송 추적으로 배송완료가 된다
- * - `MANUAL` 배송 없는 상품(비실물). 셀러가 제공 처리(`POST /v1/order-items/{orderItemId}/fulfill`)로 제공 완료를 기록한다
- *
- * 비실물의 세부 구분(파일 다운로드·코드 발급·이용권·방문 수령)은 2026-09-28에 제품에서 뺐다(이슈 #48 범위 축소).
- * 이름은 이행 방식이다 — `SHIPPING`이 택배 발송이듯 `MANUAL`은 셀러가 직접 제공한다는 뜻이다.
- */
-export declare const fulfillmentTypeSchema: z.ZodEnum<{
-  SHIPPING: "SHIPPING";
-  MANUAL: "MANUAL";
-}>;
-export type FulfillmentType = z.infer<typeof fulfillmentTypeSchema>;
-/**
- * 응답 스키마용 유형 — 서버가 나중에 유형을 더해도 옛 SDK가 응답 파싱에서 깨지지 않게 문자열로 받는다.
- * 요청은 `fulfillmentTypeSchema`(닫힌 enum)로 검증한다.
- */
-export declare const fulfillmentTypeResponseSchema: z.ZodString;
-/** 유형 하나의 규칙 — 배송·클레임이 이 표를 읽는다 */
-export interface FulfillmentRule {
-  /** 택배 배송이 필요한가 — 배송비·배송지·발송 흐름의 대상인가 */
-  requiresShipping: boolean;
-  /** 반품에 수거가 필요한가 — 실물만 수거한다 */
-  requiresCollection: boolean;
-  /** 교환을 받는가 — 실물만 받는다 */
-  exchangeSupported: boolean;
-}
-/** 유형별 규칙표 — **유일한 원천이다.** */
-export declare const FULFILLMENT_RULES: Readonly<Record<FulfillmentType, FulfillmentRule>>;
-/**
- * 저장된 값 → 유형. null·모르는 값은 `SHIPPING`이다 — 이 필드 이전의 상품·주문상품은 모두 배송 상품이었다.
- */
-export declare function fulfillmentTypeOf(value: string | null | undefined): FulfillmentType;
-/** 유형의 규칙 — 모르는 값은 배송 상품 규칙이다 */
-export declare function fulfillmentRuleOf(type: string | null | undefined): FulfillmentRule;
-/** 택배 배송이 필요한가 — 배송비 묶음·배송지·발송 흐름의 판정은 이 함수 하나를 지난다 */
-export declare function requiresShipping(type: string | null | undefined): boolean;
-/** 반품에 수거가 필요한가 — 비실물 반품은 수거 등록·수거 완료 없이 승인한다 */
-export declare function requiresCollection(type: string | null | undefined): boolean;
-/**
- * 배송이 없는 주문상품의 배송 묶음 키 (`order_items.delivery_bundle_key`).
- *
- * null로 두면 환불 정산이 #29 이전 주문의 레거시 폴백(「묶음 = 같은 상품」, 상품의 **현재** 배송비)을 탄다.
- * 이 키를 만나면 배송비 환불·차감이 0이고 `orders.delivery_fee_settlements`에 항목을 만들지 않는다.
- * 정책 지문 키(`b:…`)와 겹치지 않는다.
- */
-export declare const NO_SHIPPING_BUNDLE_KEY = "none";
-/** 배송비 유형 — 무료·유료·조건부 무료 */
-export declare const deliveryTypeSchema: z.ZodEnum<{
-  FREE: "FREE";
-  PAID: "PAID";
-  CONDITIONAL_FREE: "CONDITIONAL_FREE";
-}>;
-export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
-/**
- * 상품 이행 — 등록(POST). 배송 상품의 `shipping`을 생략하면 기본값(유료 배송·상점 기본 배송비·기본 출고지·반품지)이다.
- */
-export declare const productFulfillmentCreateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-  type: z.ZodLiteral<"SHIPPING">;
-  shipping: z.ZodOptional<z.ZodObject<{
-    deliveryType: z.ZodDefault<z.ZodEnum<{
-      FREE: "FREE";
-      PAID: "PAID";
-      CONDITIONAL_FREE: "CONDITIONAL_FREE";
-    }>>;
-    deliveryFee: z.ZodOptional<z.ZodNumber>;
-    conditionalFreeAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-  }, z.core.$strict>>;
-}, z.core.$strict>, z.ZodObject<{
-  type: z.ZodLiteral<"MANUAL">;
-}, z.core.$strict>], "type">;
-export type ProductFulfillmentCreate = z.infer<typeof productFulfillmentCreateSchema>;
-/** 등록 요청의 입력 모양 — 기본값이 채워지기 전(생략 가능한 필드가 optional) */
-export type ProductFulfillmentCreateInput = z.input<typeof productFulfillmentCreateSchema>;
-/**
- * 상품 이행 — 수정(PUT·PATCH). 통째 교체이고 유형 키와 그 안의 필드가 **모두 필수**다. 서버는 현재 값과 병합하지 않는다.
- * `fulfillment` 자체를 생략하면 이행을 바꾸지 않는다.
- */
-export declare const productFulfillmentUpdateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-  type: z.ZodLiteral<"SHIPPING">;
-  shipping: z.ZodObject<{
-    deliveryType: z.ZodEnum<{
-      FREE: "FREE";
-      PAID: "PAID";
-      CONDITIONAL_FREE: "CONDITIONAL_FREE";
-    }>;
-    deliveryFee: z.ZodNumber;
-    conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
-    shippingAddressId: z.ZodNullable<z.ZodString>;
-    returnAddressId: z.ZodNullable<z.ZodString>;
-  }, z.core.$strict>;
-}, z.core.$strict>, z.ZodObject<{
-  type: z.ZodLiteral<"MANUAL">;
-}, z.core.$strict>], "type">;
-export type ProductFulfillmentUpdate = z.infer<typeof productFulfillmentUpdateSchema>;
-/**
- * 저장된 상품 이행 — 알려진 유형의 닫힌 유니온. 서버의 상품 엔티티와 응답이 이 모양을 쓴다.
- * 응답 파싱은 `productFulfillmentResponseSchema`(열린 유니온)를 쓴다.
- */
-export declare const productFulfillmentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-  type: z.ZodLiteral<"SHIPPING">;
-  shipping: z.ZodObject<{
-    deliveryType: z.ZodEnum<{
-      FREE: "FREE";
-      PAID: "PAID";
-      CONDITIONAL_FREE: "CONDITIONAL_FREE";
-    }>;
-    deliveryFee: z.ZodNumber;
-    conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
-    shippingAddressId: z.ZodNullable<z.ZodString>;
-    returnAddressId: z.ZodNullable<z.ZodString>;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"MANUAL">;
-}, z.core.$strip>], "type">;
-export type ProductFulfillment = z.infer<typeof productFulfillmentSchema>;
-/** 유형 이름 → 그 유형의 저장된 이행 */
-export type ProductFulfillmentOf<T extends FulfillmentType> = Extract<ProductFulfillment, {
-  type: T;
-}>;
-/** 응답이 알려 주는 모르는 유형 — SDK가 아직 모르는 유형(서버가 나중에 더한 유형) */
-export interface UnknownFulfillment {
-  type: "OTHER";
-  /** 서버가 보낸 유형 이름 */
-  rawType: string;
-}
-/**
- * 열린 응답 유니온 — 알려진 유형은 판별 유니온으로 검사하고, **모르는 유형만** `{ type: "OTHER", rawType }`로 읽는다.
- *
- * `type: z.string()` 가지를 그대로 두면 TS가 `type === "SHIPPING"`으로 좁혀도 문자열 가지가 남는다. `OTHER` 리터럴로 바꿔 좁히기를
- * 지킨다. 알려진 유형의 모양이 틀린 응답은 폴백으로 숨기지 않고 파싱 오류로 둔다.
- */
-export declare function openFulfillmentUnion<T extends z.ZodType>(known: T): z.ZodUnion<readonly [T, z.ZodPipe<z.ZodObject<{
-  type: z.ZodString;
-}, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
-  [x: string]: unknown;
-  type: string;
-}>>]>;
-export declare const productFulfillmentResponseSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
-  type: z.ZodLiteral<"SHIPPING">;
-  shipping: z.ZodObject<{
-    deliveryType: z.ZodEnum<{
-      FREE: "FREE";
-      PAID: "PAID";
-      CONDITIONAL_FREE: "CONDITIONAL_FREE";
-    }>;
-    deliveryFee: z.ZodNumber;
-    conditionalFreeAmount: z.ZodNullable<z.ZodNumber>;
-    shippingAddressId: z.ZodNullable<z.ZodString>;
-    returnAddressId: z.ZodNullable<z.ZodString>;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"MANUAL">;
-}, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
-  type: z.ZodString;
-}, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
-  [x: string]: unknown;
-  type: string;
-}>>]>;
-export type ProductFulfillmentView = z.infer<typeof productFulfillmentResponseSchema>;
-/**
- * 주문상품의 주문 시점 이행 — 결제 확정이 주문서 줄에서 굳힌다. 상품의 현재 값이 아니다. 서버는 주문상품 컬럼
- * (`fulfillment_type`·`delivery_bundle_key`)과 jsonb(`fulfillment_snapshot`)를 합쳐 이 모양을 만든다.
- */
-export declare const orderItemFulfillmentSnapshotSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-  type: z.ZodLiteral<"SHIPPING">;
-  shipping: z.ZodObject<{
-    bundleKey: z.ZodNullable<z.ZodString>;
-    returnAddressId: z.ZodNullable<z.ZodString>;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"MANUAL">;
-}, z.core.$strip>], "type">;
-export type OrderItemFulfillmentSnapshot = z.infer<typeof orderItemFulfillmentSnapshotSchema>;
-export declare const orderItemFulfillmentSnapshotResponseSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
-  type: z.ZodLiteral<"SHIPPING">;
-  shipping: z.ZodObject<{
-    bundleKey: z.ZodNullable<z.ZodString>;
-    returnAddressId: z.ZodNullable<z.ZodString>;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"MANUAL">;
-}, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
-  type: z.ZodString;
-}, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
-  [x: string]: unknown;
-  type: string;
-}>>]>;
-export type OrderItemFulfillmentSnapshotView = z.infer<typeof orderItemFulfillmentSnapshotResponseSchema>;
-//#endregion
 //#region src/schemas/order.d.ts
 export declare const orderSummarySchema: z.ZodObject<{
   orderId: z.ZodString;
@@ -3548,7 +4090,17 @@ export declare const orderItemSchema: z.ZodObject<{
   customInputs: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
     label: z.ZodString;
     value: z.ZodString;
+    key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>>>;
+  stay: z.ZodOptional<z.ZodObject<{
+    checkIn: z.ZodString;
+    checkOut: z.ZodString;
+    nights: z.ZodArray<z.ZodObject<{
+      date: z.ZodString;
+      price: z.ZodNumber;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
   sellerCode: z.ZodNullable<z.ZodString>;
   fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
@@ -3556,8 +4108,24 @@ export declare const orderItemSchema: z.ZodObject<{
       bundleKey: z.ZodNullable<z.ZodString>;
       returnAddressId: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
+    method: z.ZodOptional<z.ZodString>;
+    pickupLocation: z.ZodOptional<z.ZodObject<{
+      locationId: z.ZodString;
+      name: z.ZodString;
+      address: z.ZodString;
+      phone: z.ZodNullable<z.ZodString>;
+      hours: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
   }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"MANUAL">;
+    method: z.ZodOptional<z.ZodString>;
+    pickupLocation: z.ZodOptional<z.ZodObject<{
+      locationId: z.ZodString;
+      name: z.ZodString;
+      address: z.ZodString;
+      phone: z.ZodNullable<z.ZodString>;
+      hours: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
   }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
     type: z.ZodString;
   }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -3711,7 +4279,17 @@ export declare const orderSchema: z.ZodObject<{
     customInputs: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
       label: z.ZodString;
       value: z.ZodString;
+      key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      type: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>>;
+    stay: z.ZodOptional<z.ZodObject<{
+      checkIn: z.ZodString;
+      checkOut: z.ZodString;
+      nights: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        price: z.ZodNumber;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
     sellerCode: z.ZodNullable<z.ZodString>;
     fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
       type: z.ZodLiteral<"SHIPPING">;
@@ -3719,8 +4297,24 @@ export declare const orderSchema: z.ZodObject<{
         bundleKey: z.ZodNullable<z.ZodString>;
         returnAddressId: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>;
+      method: z.ZodOptional<z.ZodString>;
+      pickupLocation: z.ZodOptional<z.ZodObject<{
+        locationId: z.ZodString;
+        name: z.ZodString;
+        address: z.ZodString;
+        phone: z.ZodNullable<z.ZodString>;
+        hours: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
       type: z.ZodLiteral<"MANUAL">;
+      method: z.ZodOptional<z.ZodString>;
+      pickupLocation: z.ZodOptional<z.ZodObject<{
+        locationId: z.ZodString;
+        name: z.ZodString;
+        address: z.ZodString;
+        phone: z.ZodNullable<z.ZodString>;
+        hours: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>;
     }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
       type: z.ZodString;
     }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -3830,7 +4424,17 @@ export declare const orderItemPageSchema: z.ZodObject<{
     customInputs: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
       label: z.ZodString;
       value: z.ZodString;
+      key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      type: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>>;
+    stay: z.ZodOptional<z.ZodObject<{
+      checkIn: z.ZodString;
+      checkOut: z.ZodString;
+      nights: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        price: z.ZodNumber;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
     sellerCode: z.ZodNullable<z.ZodString>;
     fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
       type: z.ZodLiteral<"SHIPPING">;
@@ -3838,8 +4442,24 @@ export declare const orderItemPageSchema: z.ZodObject<{
         bundleKey: z.ZodNullable<z.ZodString>;
         returnAddressId: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>;
+      method: z.ZodOptional<z.ZodString>;
+      pickupLocation: z.ZodOptional<z.ZodObject<{
+        locationId: z.ZodString;
+        name: z.ZodString;
+        address: z.ZodString;
+        phone: z.ZodNullable<z.ZodString>;
+        hours: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
       type: z.ZodLiteral<"MANUAL">;
+      method: z.ZodOptional<z.ZodString>;
+      pickupLocation: z.ZodOptional<z.ZodObject<{
+        locationId: z.ZodString;
+        name: z.ZodString;
+        address: z.ZodString;
+        phone: z.ZodNullable<z.ZodString>;
+        hours: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>;
     }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
       type: z.ZodString;
     }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -3959,16 +4579,16 @@ export interface OrderItemListParams extends PageParams {
   testPayment?: "true" | "false";
 }
 export declare const deliveryMethodSchema: z.ZodEnum<{
-  COURIER: "COURIER";
   DIRECT: "DIRECT";
+  COURIER: "COURIER";
   QUICK: "QUICK";
   NOTHING: "NOTHING";
 }>;
 export type DeliveryMethod = z.infer<typeof deliveryMethodSchema>;
 export declare const dispatchRequestSchema: z.ZodObject<{
   deliveryMethod: z.ZodEnum<{
-    COURIER: "COURIER";
     DIRECT: "DIRECT";
+    COURIER: "COURIER";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -3980,8 +4600,8 @@ export type DispatchRequest = z.infer<typeof dispatchRequestSchema>;
 export declare const deliveryInfoSchema: z.ZodObject<{
   orderItemId: z.ZodString;
   deliveryMethod: z.ZodEnum<{
-    COURIER: "COURIER";
     DIRECT: "DIRECT";
+    COURIER: "COURIER";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -4007,8 +4627,8 @@ export declare const trackingStageResponseSchema: z.ZodString;
 export declare const deliveryStatusSchema: z.ZodObject<{
   orderItemId: z.ZodString;
   deliveryMethod: z.ZodEnum<{
-    COURIER: "COURIER";
     DIRECT: "DIRECT";
+    COURIER: "COURIER";
     QUICK: "QUICK";
     NOTHING: "NOTHING";
   }>;
@@ -5532,6 +6152,7 @@ export declare const productVariantSchema: z.ZodObject<{
   weightGram: z.ZodNullable<z.ZodNumber>;
   sellerCode: z.ZodNullable<z.ZodString>;
   usable: z.ZodBoolean;
+  attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
   hasOrders: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type ProductVariant = z.infer<typeof productVariantSchema>;
@@ -5584,6 +6205,12 @@ export declare const addonGroupSchema: z.ZodObject<{
   }, z.core.$strip>>;
 }, z.core.$strip>;
 export type AddonGroup = z.infer<typeof addonGroupSchema>;
+/**
+ * 직접 입력 타입(이슈 #115 결정 24) — 값은 늘 문자열로 오가고 서버가 타입대로 검사·정규화한다.
+ * `number`는 정수, `select`는 `options` 중 하나, `date`는 `YYYY-MM-DD`, `datetime`은 오프셋 있는 ISO 8601이다.
+ * `image`는 구매자 업로드(`POST /storefront/v1/uploads/order-inputs`) 주소 목록이고 `maxLength`가 최대 장수(1~5)다
+ */
+export declare const CUSTOM_INPUT_TYPES: readonly ["text", "number", "select", "date", "datetime", "image"];
 /** 직접 입력 항목 — 예: 각인 문구 */
 export declare const customInputSchema: z.ZodObject<{
   inputId: z.ZodString;
@@ -5593,6 +6220,9 @@ export declare const customInputSchema: z.ZodObject<{
   required: z.ZodBoolean;
   usable: z.ZodBoolean;
   sortOrder: z.ZodNumber;
+  key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  type: z.ZodOptional<z.ZodString>;
+  options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 export type CustomInput = z.infer<typeof customInputSchema>;
 /**
@@ -5631,6 +6261,16 @@ export declare const customInputRequestSchema: z.ZodObject<{
   maxLength: z.ZodNumber;
   required: z.ZodDefault<z.ZodBoolean>;
   usable: z.ZodDefault<z.ZodBoolean>;
+  key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  type: z.ZodOptional<z.ZodEnum<{
+    number: "number";
+    date: "date";
+    text: "text";
+    select: "select";
+    datetime: "datetime";
+    image: "image";
+  }>>;
+  options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 export type CustomInputRequest = z.infer<typeof customInputRequestSchema>;
 /**
@@ -5648,6 +6288,8 @@ export type OptionSelection = z.infer<typeof optionSelectionSchema>;
 export declare const customInputValueSchema: z.ZodObject<{
   label: z.ZodString;
   value: z.ZodString;
+  key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  type: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type CustomInputValue = z.infer<typeof customInputValueSchema>;
 export declare const discountSchema: z.ZodObject<{
@@ -5712,6 +6354,7 @@ export declare const productSchema: z.ZodObject<{
     weightGram: z.ZodNullable<z.ZodNumber>;
     sellerCode: z.ZodNullable<z.ZodString>;
     usable: z.ZodBoolean;
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     hasOrders: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>>;
   addonGroups: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -5735,6 +6378,9 @@ export declare const productSchema: z.ZodObject<{
     required: z.ZodBoolean;
     usable: z.ZodBoolean;
     sortOrder: z.ZodNumber;
+    key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
   }, z.core.$strip>>>>;
   optionSort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
     REGISTERED: "REGISTERED";
@@ -5755,14 +6401,17 @@ export declare const productSchema: z.ZodObject<{
       shippingAddressId: z.ZodNullable<z.ZodString>;
       returnAddressId: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
+    methods: z.ZodOptional<z.ZodArray<z.ZodString>>;
   }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"MANUAL">;
+    methods: z.ZodOptional<z.ZodArray<z.ZodString>>;
   }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
     type: z.ZodString;
   }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
     [x: string]: unknown;
     type: string;
   }>>]>;
+  inventoryMode: z.ZodOptional<z.ZodString>;
   fulfillmentTypeLocked: z.ZodBoolean;
   refundPolicy: z.ZodNullable<z.ZodObject<{
     preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
@@ -5837,6 +6486,7 @@ export declare const productVariantRequestSchema: z.ZodObject<{
   weightGram: z.ZodOptional<z.ZodNumber>;
   sellerCode: z.ZodOptional<z.ZodString>;
   usable: z.ZodDefault<z.ZodBoolean>;
+  attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
 }, z.core.$strip>;
 export type ProductVariantRequest = z.infer<typeof productVariantRequestSchema>;
 /** 축 × 값 → variant 전체 교체 요청 (PUT /products/{productId}/options) */
@@ -5860,6 +6510,7 @@ export declare const optionModelRequestSchema: z.ZodObject<{
     weightGram: z.ZodOptional<z.ZodNumber>;
     sellerCode: z.ZodOptional<z.ZodString>;
     usable: z.ZodDefault<z.ZodBoolean>;
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
   }, z.core.$strip>>;
   addonGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
@@ -5879,6 +6530,16 @@ export declare const optionModelRequestSchema: z.ZodObject<{
     maxLength: z.ZodNumber;
     required: z.ZodDefault<z.ZodBoolean>;
     usable: z.ZodDefault<z.ZodBoolean>;
+    key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodEnum<{
+      number: "number";
+      date: "date";
+      text: "text";
+      select: "select";
+      datetime: "datetime";
+      image: "image";
+    }>>;
+    options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
   }, z.core.$strip>>>;
   optionSort: z.ZodOptional<z.ZodEnum<{
     REGISTERED: "REGISTERED";
@@ -5913,6 +6574,7 @@ export declare const optionModelSchema: z.ZodObject<{
     weightGram: z.ZodNullable<z.ZodNumber>;
     sellerCode: z.ZodNullable<z.ZodString>;
     usable: z.ZodBoolean;
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     hasOrders: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strip>>;
   addonGroups: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -5936,6 +6598,9 @@ export declare const optionModelSchema: z.ZodObject<{
     required: z.ZodBoolean;
     usable: z.ZodBoolean;
     sortOrder: z.ZodNumber;
+    key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
   }, z.core.$strip>>>>;
   optionSort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
     REGISTERED: "REGISTERED";
@@ -5979,10 +6644,26 @@ export declare const productCreateRequestSchema: z.ZodObject<{
       shippingAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
       returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strict>>;
+    methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      CARRIER: "CARRIER";
+      DIRECT: "DIRECT";
+      PICKUP: "PICKUP";
+      PROVIDED: "PROVIDED";
+    }>>>;
   }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"MANUAL">;
+    methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      CARRIER: "CARRIER";
+      DIRECT: "DIRECT";
+      PICKUP: "PICKUP";
+      PROVIDED: "PROVIDED";
+    }>>>;
   }, z.core.$strict>], "type">>;
   sourceOptionSetIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  inventoryMode: z.ZodOptional<z.ZodEnum<{
+    STANDARD: "STANDARD";
+    DATED: "DATED";
+  }>>;
   optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
@@ -6002,6 +6683,7 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     weightGram: z.ZodOptional<z.ZodNumber>;
     sellerCode: z.ZodOptional<z.ZodString>;
     usable: z.ZodDefault<z.ZodBoolean>;
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
   }, z.core.$strip>>;
   addonGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
@@ -6021,6 +6703,16 @@ export declare const productCreateRequestSchema: z.ZodObject<{
     maxLength: z.ZodNumber;
     required: z.ZodDefault<z.ZodBoolean>;
     usable: z.ZodDefault<z.ZodBoolean>;
+    key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodEnum<{
+      number: "number";
+      date: "date";
+      text: "text";
+      select: "select";
+      datetime: "datetime";
+      image: "image";
+    }>>;
+    options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
   }, z.core.$strip>>>;
   optionSort: z.ZodOptional<z.ZodEnum<{
     REGISTERED: "REGISTERED";
@@ -6065,10 +6757,26 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
       shippingAddressId: z.ZodNullable<z.ZodString>;
       returnAddressId: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
+    methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      CARRIER: "CARRIER";
+      DIRECT: "DIRECT";
+      PICKUP: "PICKUP";
+      PROVIDED: "PROVIDED";
+    }>>>;
   }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"MANUAL">;
+    methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      CARRIER: "CARRIER";
+      DIRECT: "DIRECT";
+      PICKUP: "PICKUP";
+      PROVIDED: "PROVIDED";
+    }>>>;
   }, z.core.$strict>], "type">>;
   sourceOptionSetIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  inventoryMode: z.ZodOptional<z.ZodEnum<{
+    STANDARD: "STANDARD";
+    DATED: "DATED";
+  }>>;
   optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
@@ -6088,6 +6796,7 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
     weightGram: z.ZodOptional<z.ZodNumber>;
     sellerCode: z.ZodOptional<z.ZodString>;
     usable: z.ZodDefault<z.ZodBoolean>;
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
   }, z.core.$strip>>;
   addonGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
@@ -6107,6 +6816,16 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
     maxLength: z.ZodNumber;
     required: z.ZodDefault<z.ZodBoolean>;
     usable: z.ZodDefault<z.ZodBoolean>;
+    key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodEnum<{
+      number: "number";
+      date: "date";
+      text: "text";
+      select: "select";
+      datetime: "datetime";
+      image: "image";
+    }>>;
+    options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
   }, z.core.$strip>>>;
   optionSort: z.ZodOptional<z.ZodEnum<{
     REGISTERED: "REGISTERED";
@@ -6159,8 +6878,20 @@ export declare const productPatchRequestSchema: z.ZodObject<{
       shippingAddressId: z.ZodNullable<z.ZodString>;
       returnAddressId: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>;
+    methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      CARRIER: "CARRIER";
+      DIRECT: "DIRECT";
+      PICKUP: "PICKUP";
+      PROVIDED: "PROVIDED";
+    }>>>;
   }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"MANUAL">;
+    methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+      CARRIER: "CARRIER";
+      DIRECT: "DIRECT";
+      PICKUP: "PICKUP";
+      PROVIDED: "PROVIDED";
+    }>>>;
   }, z.core.$strict>], "type">>;
   refundPolicy: z.ZodOptional<z.ZodNullable<z.ZodObject<{
     preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
@@ -6258,6 +6989,9 @@ export declare const savedCustomInputSchema: z.ZodObject<{
   placeholder: z.ZodNullable<z.ZodString>;
   maxLength: z.ZodNumber;
   required: z.ZodBoolean;
+  key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  type: z.ZodOptional<z.ZodString>;
+  options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 export type SavedCustomInput = z.infer<typeof savedCustomInputSchema>;
 export declare const savedOptionSetSchema: z.ZodObject<{
@@ -6283,6 +7017,9 @@ export declare const savedOptionSetSchema: z.ZodObject<{
     placeholder: z.ZodNullable<z.ZodString>;
     maxLength: z.ZodNumber;
     required: z.ZodBoolean;
+    key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
   }, z.core.$strip>>;
   importedProductCount: z.ZodNumber;
   createdAt: z.ZodString;
@@ -6311,6 +7048,16 @@ export declare const savedCustomInputRequestSchema: z.ZodObject<{
   placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   maxLength: z.ZodNumber;
   required: z.ZodDefault<z.ZodBoolean>;
+  key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  type: z.ZodOptional<z.ZodEnum<{
+    number: "number";
+    date: "date";
+    text: "text";
+    select: "select";
+    datetime: "datetime";
+    image: "image";
+  }>>;
+  options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 /**
  * 저장 옵션 만들기·수정 본문. 조합 옵션명은 최대 `MAX_OPTION_GROUPS`개, 추가 선택은 최대 `MAX_ADDON_GROUPS`개이고
@@ -6341,6 +7088,16 @@ export declare const savedOptionSetRequestSchema: z.ZodObject<{
     placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     maxLength: z.ZodNumber;
     required: z.ZodDefault<z.ZodBoolean>;
+    key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodOptional<z.ZodEnum<{
+      number: "number";
+      date: "date";
+      text: "text";
+      select: "select";
+      datetime: "datetime";
+      image: "image";
+    }>>;
+    options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
   }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type SavedOptionSetRequest = z.infer<typeof savedOptionSetRequestSchema>;
@@ -6384,6 +7141,9 @@ export declare const savedOptionSetFromProductResultSchema: z.ZodObject<{
       placeholder: z.ZodNullable<z.ZodString>;
       maxLength: z.ZodNumber;
       required: z.ZodBoolean;
+      key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      type: z.ZodOptional<z.ZodString>;
+      options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>>;
     importedProductCount: z.ZodNumber;
     createdAt: z.ZodString;
@@ -6426,6 +7186,67 @@ export declare const savedOptionSetListQuerySchema: z.ZodObject<{
   }>>;
 }, z.core.$strip>;
 //#endregion
+//#region src/schemas/stay.d.ts
+/**
+ * 날짜별 재고·가격(이슈 #118) — 숙박·회차처럼 날짜마다 재고와 가격이 다른 상품. 상품 `inventoryMode: "DATED"`이면 조합(객실) × 날짜
+ * 달력이 재고·가격의 원천이고, 주문서 줄은 기간(`stay`)을 받는다. 날짜는 한국 날짜 `YYYY-MM-DD`다.
+ */
+/** 한국 날짜 */
+export declare const calendarDateSchema: z.ZodString;
+/** 한 번에 받는 최대 박수 */
+export declare const MAX_STAY_NIGHTS = 30;
+/** 달력 한 번 조회·설정 최대 일수 */
+export declare const MAX_CALENDAR_DAYS = 400;
+export declare const inventoryModeSchema: z.ZodEnum<{
+  STANDARD: "STANDARD";
+  DATED: "DATED";
+}>;
+export type InventoryMode = z.infer<typeof inventoryModeSchema>;
+/** 숙박 기간 — 체크인 날부터 체크아웃 전날까지가 박이다 */
+export declare const stayRangeSchema: z.ZodObject<{
+  checkIn: z.ZodString;
+  checkOut: z.ZodString;
+}, z.core.$strip>;
+export type StayRange = z.infer<typeof stayRangeSchema>;
+/** 주문 시점 숙박 — 박마다 그때 가격 */
+export declare const staySnapshotSchema: z.ZodObject<{
+  checkIn: z.ZodString;
+  checkOut: z.ZodString;
+  nights: z.ZodArray<z.ZodObject<{
+    date: z.ZodString;
+    price: z.ZodNumber;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type StaySnapshot = z.infer<typeof staySnapshotSchema>;
+/** 체크인~체크아웃 전날 날짜 목록. 형식이 틀리거나 체크아웃이 체크인 이하면 빈 목록 */
+export declare function nightsOf(range: StayRange): string[];
+/** 관리 달력 한 칸 */
+export declare const calendarDaySchema: z.ZodObject<{
+  variantId: z.ZodString;
+  date: z.ZodString;
+  stock: z.ZodNumber;
+  price: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type CalendarDay = z.infer<typeof calendarDaySchema>;
+export declare const calendarQuerySchema: z.ZodObject<{
+  variantId: z.ZodOptional<z.ZodString>;
+  from: z.ZodString;
+  to: z.ZodString;
+}, z.core.$strip>;
+/**
+ * 달력 설정 — 기간의 날짜마다 재고·가격을 덮어쓴다(없는 날은 만든다). `stock`·`price`는 준 것만 바꾸고, `price: null`은 조합 가격으로
+ * 되돌린다. `daysOfWeek`(0=일~6=토)를 주면 그 요일만 바꾼다
+ */
+export declare const setCalendarRequestSchema: z.ZodObject<{
+  variantIds: z.ZodArray<z.ZodString>;
+  from: z.ZodString;
+  to: z.ZodString;
+  stock: z.ZodOptional<z.ZodNumber>;
+  price: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+  daysOfWeek: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+}, z.core.$strip>;
+export type SetCalendarRequest = z.input<typeof setCalendarRequestSchema>;
+//#endregion
 //#region src/schemas/store.d.ts
 /**
  * 상점 코드 규칙 — 스토어프론트 API가 테넌트를 가르는 값이다(`X-Store-Code` 헤더).
@@ -8069,10 +8890,12 @@ export type StorefrontSourceReplaced = z.infer<typeof storefrontSourceReplacedSc
  *
  * - `product-image`: 상품 목록·상세의 상품 이미지. 목록 썸네일로 쓰이므로 정지 이미지만 받는다.
  * - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
+ * - `flow-attachment`: 주문 흐름 행동의 첨부(시안 등, 이슈 #115). 구매자에게 보이므로 정지 이미지와 PDF만 받는다.
  */
 export declare const uploadPurposeSchema: z.ZodEnum<{
   "product-image": "product-image";
   description: "description";
+  "flow-attachment": "flow-attachment";
 }>;
 export type UploadPurpose = z.infer<typeof uploadPurposeSchema>;
 export interface UploadPurposeLimit {
@@ -8112,6 +8935,7 @@ export declare const uploadRequestSchema: z.ZodObject<{
   purpose: z.ZodDefault<z.ZodEnum<{
     "product-image": "product-image";
     description: "description";
+    "flow-attachment": "flow-attachment";
   }>>;
   size: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -8386,6 +9210,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        attributes?: Record<string, string> | undefined;
         hasOrders?: boolean | undefined;
       }[];
       addonGroups: {
@@ -8409,6 +9234,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         required: boolean;
         usable: boolean;
         sortOrder: number;
+        key?: string | null | undefined;
+        type?: string | undefined;
+        options?: string[] | null | undefined;
       }[];
       optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
@@ -8420,8 +9248,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
           shippingAddressId: string | null;
           returnAddressId: string | null;
         };
+        methods?: string[] | undefined;
       } | {
         type: "MANUAL";
+        methods?: string[] | undefined;
       };
       fulfillmentTypeLocked: boolean;
       refundPolicy: {
@@ -8441,6 +9271,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
+      inventoryMode?: string | undefined;
       discount?: {
         productId: string;
         discountType: "RATE" | "AMOUNT";
@@ -8486,6 +9317,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        attributes?: Record<string, string> | undefined;
         hasOrders?: boolean | undefined;
       }[];
       addonGroups: {
@@ -8509,6 +9341,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         required: boolean;
         usable: boolean;
         sortOrder: number;
+        key?: string | null | undefined;
+        type?: string | undefined;
+        options?: string[] | null | undefined;
       }[];
       optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
@@ -8520,8 +9355,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
           shippingAddressId: string | null;
           returnAddressId: string | null;
         };
+        methods?: string[] | undefined;
       } | {
         type: "MANUAL";
+        methods?: string[] | undefined;
       };
       fulfillmentTypeLocked: boolean;
       refundPolicy: {
@@ -8541,6 +9378,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
+      inventoryMode?: string | undefined;
       discount?: {
         productId: string;
         discountType: "RATE" | "AMOUNT";
@@ -8586,6 +9424,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        attributes?: Record<string, string> | undefined;
         hasOrders?: boolean | undefined;
       }[];
       addonGroups: {
@@ -8609,6 +9448,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         required: boolean;
         usable: boolean;
         sortOrder: number;
+        key?: string | null | undefined;
+        type?: string | undefined;
+        options?: string[] | null | undefined;
       }[];
       optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
       fulfillment: UnknownFulfillment | {
@@ -8620,8 +9462,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
           shippingAddressId: string | null;
           returnAddressId: string | null;
         };
+        methods?: string[] | undefined;
       } | {
         type: "MANUAL";
+        methods?: string[] | undefined;
       };
       fulfillmentTypeLocked: boolean;
       refundPolicy: {
@@ -8641,6 +9485,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
+      inventoryMode?: string | undefined;
       discount?: {
         productId: string;
         discountType: "RATE" | "AMOUNT";
@@ -8688,6 +9533,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        attributes?: Record<string, string> | undefined;
         hasOrders?: boolean | undefined;
       }[];
       addonGroups: {
@@ -8711,6 +9557,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         required: boolean;
         usable: boolean;
         sortOrder: number;
+        key?: string | null | undefined;
+        type?: string | undefined;
+        options?: string[] | null | undefined;
       }[];
       optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
     }>;
@@ -8742,6 +9591,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        attributes?: Record<string, string> | undefined;
         hasOrders?: boolean | undefined;
       }[];
       addonGroups: {
@@ -8765,6 +9615,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         required: boolean;
         usable: boolean;
         sortOrder: number;
+        key?: string | null | undefined;
+        type?: string | undefined;
+        options?: string[] | null | undefined;
       }[];
       optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
     }>;
@@ -8790,6 +9643,17 @@ export declare function createStoreClient(options: StoreClientOptions): {
       endAt: string | null;
     }>;
     removeDiscount: (productId: string) => Promise<void>;
+    /** 날짜별 재고 상품(`inventoryMode: "DATED"`, 이슈 #118)의 기간(포함) 달력. 없는 날은 싣지 않는다 */
+    getCalendar: (productId: string, query: z.input<typeof calendarQuerySchema>) => Promise<{
+      variantId: string;
+      date: string;
+      stock: number;
+      price: number | null;
+    }[]>;
+    /** 기간의 날짜마다 조합별 재고·가격을 덮어쓴다. `price: null`은 조합 가격으로 되돌린다 */
+    setCalendar: (productId: string, body: SetCalendarRequest) => Promise<{
+      updated: number;
+    }>;
   };
   /**
    * 저장 옵션 (이슈 #59) — 자주 쓰는 옵션 구성. 불러오기는 복사라 저장 옵션을 고쳐도 불러온 상품은 바뀌지 않는다.
@@ -8819,6 +9683,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
           placeholder: string | null;
           maxLength: number;
           required: boolean;
+          key?: string | null | undefined;
+          type?: string | undefined;
+          options?: string[] | null | undefined;
         }[];
         importedProductCount: number;
         createdAt: string;
@@ -8843,6 +9710,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         placeholder: string | null;
         maxLength: number;
         required: boolean;
+        key?: string | null | undefined;
+        type?: string | undefined;
+        options?: string[] | null | undefined;
       }[];
       importedProductCount: number;
       createdAt: string;
@@ -8867,6 +9737,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         placeholder: string | null;
         maxLength: number;
         required: boolean;
+        key?: string | null | undefined;
+        type?: string | undefined;
+        options?: string[] | null | undefined;
       }[];
       importedProductCount: number;
       createdAt: string;
@@ -8891,6 +9764,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         placeholder: string | null;
         maxLength: number;
         required: boolean;
+        key?: string | null | undefined;
+        type?: string | undefined;
+        options?: string[] | null | undefined;
       }[];
       importedProductCount: number;
       createdAt: string;
@@ -8917,6 +9793,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
           placeholder: string | null;
           maxLength: number;
           required: boolean;
+          key?: string | null | undefined;
+          type?: string | undefined;
+          options?: string[] | null | undefined;
         }[];
         importedProductCount: number;
         createdAt: string;
@@ -9486,6 +10365,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         customInputs: {
           label: string;
           value: string;
+          key?: string | null | undefined;
+          type?: string | undefined;
         }[];
         sellerCode: string | null;
         fulfillmentSnapshot: UnknownFulfillment | {
@@ -9494,8 +10375,24 @@ export declare function createStoreClient(options: StoreClientOptions): {
             bundleKey: string | null;
             returnAddressId: string | null;
           };
+          method?: string | undefined;
+          pickupLocation?: {
+            locationId: string;
+            name: string;
+            address: string;
+            phone: string | null;
+            hours: string | null;
+          } | undefined;
         } | {
           type: "MANUAL";
+          method?: string | undefined;
+          pickupLocation?: {
+            locationId: string;
+            name: string;
+            address: string;
+            phone: string | null;
+            hours: string | null;
+          } | undefined;
         };
         quantity: number;
         canceledQuantity: number;
@@ -9521,6 +10418,14 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastChangedAt: string;
         lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED";
         testPayment: boolean;
+        stay?: {
+          checkIn: string;
+          checkOut: string;
+          nights: {
+            date: string;
+            price: number;
+          }[];
+        } | undefined;
       }[];
     }>;
     /**
@@ -9573,6 +10478,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         customInputs: {
           label: string;
           value: string;
+          key?: string | null | undefined;
+          type?: string | undefined;
         }[];
         sellerCode: string | null;
         fulfillmentSnapshot: UnknownFulfillment | {
@@ -9581,8 +10488,24 @@ export declare function createStoreClient(options: StoreClientOptions): {
             bundleKey: string | null;
             returnAddressId: string | null;
           };
+          method?: string | undefined;
+          pickupLocation?: {
+            locationId: string;
+            name: string;
+            address: string;
+            phone: string | null;
+            hours: string | null;
+          } | undefined;
         } | {
           type: "MANUAL";
+          method?: string | undefined;
+          pickupLocation?: {
+            locationId: string;
+            name: string;
+            address: string;
+            phone: string | null;
+            hours: string | null;
+          } | undefined;
         };
         quantity: number;
         canceledQuantity: number;
@@ -9608,6 +10531,14 @@ export declare function createStoreClient(options: StoreClientOptions): {
         lastChangedAt: string;
         lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED";
         testPayment: boolean;
+        stay?: {
+          checkIn: string;
+          checkOut: string;
+          nights: {
+            date: string;
+            price: number;
+          }[];
+        } | undefined;
       }[];
     }>;
     confirm: (orderItemId: string, idempotencyKey?: string) => Promise<void>;
@@ -9644,7 +10575,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     dispatch: (orderItemId: string, body: DispatchRequest, idempotencyKey?: string) => Promise<{
       orderItemId: string;
-      deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
+      deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
       carrierCode: string | null;
       carrierName: string | null;
       trackingNumber: string | null;
@@ -9689,6 +10620,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       customInputs: {
         label: string;
         value: string;
+        key?: string | null | undefined;
+        type?: string | undefined;
       }[];
       sellerCode: string | null;
       fulfillmentSnapshot: UnknownFulfillment | {
@@ -9697,8 +10630,24 @@ export declare function createStoreClient(options: StoreClientOptions): {
           bundleKey: string | null;
           returnAddressId: string | null;
         };
+        method?: string | undefined;
+        pickupLocation?: {
+          locationId: string;
+          name: string;
+          address: string;
+          phone: string | null;
+          hours: string | null;
+        } | undefined;
       } | {
         type: "MANUAL";
+        method?: string | undefined;
+        pickupLocation?: {
+          locationId: string;
+          name: string;
+          address: string;
+          phone: string | null;
+          hours: string | null;
+        } | undefined;
       };
       quantity: number;
       canceledQuantity: number;
@@ -9724,6 +10673,14 @@ export declare function createStoreClient(options: StoreClientOptions): {
       lastChangedAt: string;
       lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED";
       testPayment: boolean;
+      stay?: {
+        checkIn: string;
+        checkOut: string;
+        nights: {
+          date: string;
+          price: number;
+        }[];
+      } | undefined;
     }>;
     /** 배송완료 일괄 처리 — 항목별 부분 성공이다 */
     markDeliveredBulk: (orderItemIds: string[], idempotencyKey?: string) => Promise<{
@@ -9759,6 +10716,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       customInputs: {
         label: string;
         value: string;
+        key?: string | null | undefined;
+        type?: string | undefined;
       }[];
       sellerCode: string | null;
       fulfillmentSnapshot: UnknownFulfillment | {
@@ -9767,8 +10726,24 @@ export declare function createStoreClient(options: StoreClientOptions): {
           bundleKey: string | null;
           returnAddressId: string | null;
         };
+        method?: string | undefined;
+        pickupLocation?: {
+          locationId: string;
+          name: string;
+          address: string;
+          phone: string | null;
+          hours: string | null;
+        } | undefined;
       } | {
         type: "MANUAL";
+        method?: string | undefined;
+        pickupLocation?: {
+          locationId: string;
+          name: string;
+          address: string;
+          phone: string | null;
+          hours: string | null;
+        } | undefined;
       };
       quantity: number;
       canceledQuantity: number;
@@ -9794,6 +10769,14 @@ export declare function createStoreClient(options: StoreClientOptions): {
       lastChangedAt: string;
       lastChangedType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED";
       testPayment: boolean;
+      stay?: {
+        checkIn: string;
+        checkOut: string;
+        nights: {
+          date: string;
+          price: number;
+        }[];
+      } | undefined;
     }>;
     /** 제공 처리 일괄 — 항목별 부분 성공이다 */
     fulfillBulk: (orderItemIds: string[], body?: FulfillRequest, idempotencyKey?: string) => Promise<{
@@ -9808,7 +10791,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     }>;
     getDelivery: (orderItemId: string) => Promise<{
       orderItemId: string;
-      deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
+      deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
       carrierCode: string | null;
       carrierName: string | null;
       trackingNumber: string | null;
@@ -9829,6 +10812,370 @@ export declare function createStoreClient(options: StoreClientOptions): {
         stage: string | null;
       }[] | undefined;
     }>;
+    /** `GET /order-items/{id}/flow` — 커머스 플로우의 지금 상태·할 수 있는 행동·타이머(#115). 스코프 `order:r` */
+    getFlow: (orderItemId: string) => Promise<{
+      orderItemId: string;
+      flow: {
+        flowId: string;
+        version: number;
+      };
+      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" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "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;
+      }[];
+      timers: {
+        key: string;
+        dueAt: string;
+        paused: boolean;
+      }[];
+      ended: boolean;
+    }>;
+    /**
+     * `POST /order-items/{id}/actions/{key}` — `getFlow().actions`에 켜진 행동을 실행한다(#115). 묶음 진행이면
+     * `affectedOrderItemIds`에 함께 움직인 주문상품이 온다. 에러: 409 `ACTION_NOT_AVAILABLE`
+     */
+    act: (orderItemId: string, key: string, input?: Record<string, unknown>, 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" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "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}/events/{key}` — 현장 단말·연동의 상점 사건(`custom.<이름>`)을 플로우에 넣는다(#115).
+     * 에러: 400 `FLOW_EVENT_KEY_INVALID`, 409 `FLOW_EVENT_NOT_ACCEPTED`
+     */
+    emitEvent: (orderItemId: string, key: `custom.${string}`, input?: Record<string, unknown>, 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" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "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[];
+    }>;
+  };
+  /**
+   * 커머스 플로우 (이슈 #115) — 프리셋 설치·초안 저장·검사·게시와 상품 할당 규칙. 조회 `flow:r`, 쓰기 `flow:rw`.
+   * 게시한 버전은 불변이고, 진행 중 주문은 결제 때 붙은 버전으로 끝까지 간다.
+   */
+  commerceFlows: {
+    presets: () => Promise<{
+      key: string;
+      presetVersion: number;
+      name: string;
+      description: string;
+      availability: "AVAILABLE" | "BLOCKED";
+      dependsOn: string[];
+      requires: Record<string, unknown>;
+      variables: Record<string, unknown>[];
+    }[]>;
+    list: () => Promise<{
+      flowId: string;
+      key: string;
+      name: string;
+      progression: "ITEM" | "ORDER_GROUP";
+      fulfillmentMethods: string[];
+      presetKey: string | null;
+      presetVersion: number | null;
+      activeVersion: number | null;
+      archivedAt: string | null;
+      createdAt: string;
+      updatedAt: string;
+    }[]>;
+    get: (flowId: string) => Promise<{
+      flowId: string;
+      key: string;
+      name: string;
+      progression: "ITEM" | "ORDER_GROUP";
+      fulfillmentMethods: string[];
+      presetKey: string | null;
+      presetVersion: number | null;
+      activeVersion: number | null;
+      archivedAt: string | null;
+      createdAt: string;
+      updatedAt: string;
+      draft: {
+        version: number;
+        status: "ACTIVE" | "DRAFT" | "LEGACY";
+        revision: number;
+        graph: Record<string, unknown>;
+        definition: Record<string, unknown>;
+        variables: Record<string, unknown>;
+        publishedAt: string | null;
+      } | null;
+      active: {
+        version: number;
+        status: "ACTIVE" | "DRAFT" | "LEGACY";
+        revision: number;
+        graph: Record<string, unknown>;
+        definition: Record<string, unknown>;
+        variables: Record<string, unknown>;
+        publishedAt: string | null;
+      } | null;
+      versions: {
+        version: number;
+        status: "ACTIVE" | "DRAFT" | "LEGACY";
+        publishedAt: string | null;
+      }[];
+    }>;
+    /** 프리셋 설치 또는 빈 플로우. 에러: 409 `FLOW_KEY_TAKEN`·`FLOW_PRESET_UNAVAILABLE` */
+    create: (body: CreateCommerceFlowRequest) => Promise<{
+      flowId: string;
+      key: string;
+      name: string;
+      progression: "ITEM" | "ORDER_GROUP";
+      fulfillmentMethods: string[];
+      presetKey: string | null;
+      presetVersion: number | null;
+      activeVersion: number | null;
+      archivedAt: string | null;
+      createdAt: string;
+      updatedAt: string;
+      draft: {
+        version: number;
+        status: "ACTIVE" | "DRAFT" | "LEGACY";
+        revision: number;
+        graph: Record<string, unknown>;
+        definition: Record<string, unknown>;
+        variables: Record<string, unknown>;
+        publishedAt: string | null;
+      } | null;
+      active: {
+        version: number;
+        status: "ACTIVE" | "DRAFT" | "LEGACY";
+        revision: number;
+        graph: Record<string, unknown>;
+        definition: Record<string, unknown>;
+        variables: Record<string, unknown>;
+        publishedAt: string | null;
+      } | null;
+      versions: {
+        version: number;
+        status: "ACTIVE" | "DRAFT" | "LEGACY";
+        publishedAt: string | null;
+      }[];
+    }>;
+    /** 초안 저장. `revision`을 주면 그 초안일 때만 저장한다(409 `FLOW_REVISION_CONFLICT`) */
+    saveDraft: (flowId: string, body: SaveFlowDraftRequest, revision?: number) => Promise<{
+      flowId: string;
+      key: string;
+      name: string;
+      progression: "ITEM" | "ORDER_GROUP";
+      fulfillmentMethods: string[];
+      presetKey: string | null;
+      presetVersion: number | null;
+      activeVersion: number | null;
+      archivedAt: string | null;
+      createdAt: string;
+      updatedAt: string;
+      draft: {
+        version: number;
+        status: "ACTIVE" | "DRAFT" | "LEGACY";
+        revision: number;
+        graph: Record<string, unknown>;
+        definition: Record<string, unknown>;
+        variables: Record<string, unknown>;
+        publishedAt: string | null;
+      } | null;
+      active: {
+        version: number;
+        status: "ACTIVE" | "DRAFT" | "LEGACY";
+        revision: number;
+        graph: Record<string, unknown>;
+        definition: Record<string, unknown>;
+        variables: Record<string, unknown>;
+        publishedAt: string | null;
+      } | null;
+      versions: {
+        version: number;
+        status: "ACTIVE" | "DRAFT" | "LEGACY";
+        publishedAt: string | null;
+      }[];
+    }>;
+    check: (flowId: string) => Promise<{
+      publishable: boolean;
+      blocking: {
+        code: string;
+        message: string;
+        nodeId?: string | undefined;
+        edgeId?: string | undefined;
+      }[];
+      warnings: {
+        code: string;
+        message: string;
+        nodeId?: string | undefined;
+        edgeId?: string | undefined;
+      }[];
+    }>;
+    /** 게시. 차단 오류가 있으면 409 `PUBLISH_BLOCKED`(`details.blocking`) */
+    publish: (flowId: string) => Promise<{
+      flowId: string;
+      key: string;
+      name: string;
+      progression: "ITEM" | "ORDER_GROUP";
+      fulfillmentMethods: string[];
+      presetKey: string | null;
+      presetVersion: number | null;
+      activeVersion: number | null;
+      archivedAt: string | null;
+      createdAt: string;
+      updatedAt: string;
+      draft: {
+        version: number;
+        status: "ACTIVE" | "DRAFT" | "LEGACY";
+        revision: number;
+        graph: Record<string, unknown>;
+        definition: Record<string, unknown>;
+        variables: Record<string, unknown>;
+        publishedAt: string | null;
+      } | null;
+      active: {
+        version: number;
+        status: "ACTIVE" | "DRAFT" | "LEGACY";
+        revision: number;
+        graph: Record<string, unknown>;
+        definition: Record<string, unknown>;
+        variables: Record<string, unknown>;
+        publishedAt: string | null;
+      } | null;
+      versions: {
+        version: number;
+        status: "ACTIVE" | "DRAFT" | "LEGACY";
+        publishedAt: string | null;
+      }[];
+    }>;
+    rules: () => Promise<{
+      ruleId: string;
+      priority: number;
+      condition: string;
+      flowId: string;
+    }[]>;
+    /** 할당 규칙 전체 교체(우선순위는 배열 순서). 에러: 400 `FLOW_ASSIGNMENT_CONDITION_INVALID`, 409 `FLOW_NOT_PUBLISHED` */
+    saveRules: (body: SaveFlowAssignmentRulesRequest) => Promise<{
+      ruleId: string;
+      priority: number;
+      condition: string;
+      flowId: string;
+    }[]>;
+    testRules: (body: TestFlowAssignmentRequest) => Promise<{
+      flowId: string;
+      version: number;
+      source: "RULE" | "PLATFORM";
+      ruleId?: string | undefined;
+    }>;
+    /** 이 상품에 지금 붙을 플로우 */
+    forProduct: (productId: string) => Promise<{
+      flowId: string;
+      version: number;
+      source: "RULE" | "PLATFORM";
+      ruleId?: string | undefined;
+    }>;
+    /** HTTP 노드 시크릿 목록(헤더 값 제외) */
+    secrets: () => Promise<{
+      name: string;
+      url: string;
+      headerNames: string[];
+      updatedAt: string;
+    }[]>;
+    /** 시크릿 저장(같은 이름이면 덮어쓴다). 상점 플랫폼 OWNER·ADMIN만. 에러: 400 `FLOW_SECRET_URL_INVALID` */
+    saveSecret: (name: string, body: SaveFlowSecretRequest) => Promise<{
+      name: string;
+      url: string;
+      headerNames: string[];
+      updatedAt: string;
+    }>;
+    removeSecret: (name: string) => Promise<void>;
   };
   carriers: {
     list: () => Promise<{
@@ -10325,7 +11672,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         version: string | null;
         documentUrl: string | null;
         action: "WITHDRAWN" | "AGREED";
-        source: "SELLER" | "SIGNUP" | "SOCIAL_SIGNUP" | "DELEGATED" | "RECONSENT" | "MEMBER_UPDATE";
+        source: "SIGNUP" | "SELLER" | "SOCIAL_SIGNUP" | "DELEGATED" | "RECONSENT" | "MEMBER_UPDATE";
         occurredAt: string;
       }[];
     }>;
@@ -10348,6 +11695,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: number;
         maxDiscountAmount: number | null;
       };
+      source?: string | undefined;
     }[]>;
     withdraw: (customerId: string, body: WithdrawCustomerRequest) => Promise<void>;
   };
@@ -10669,6 +12017,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         usedOrderId: string | null;
         issuedAt: string;
         revokedAt: string | null;
+        source?: string | undefined;
       }[];
     }>;
     redemptions: (couponId: string, params?: PageParams & {
@@ -10716,6 +12065,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       usedOrderId: string | null;
       issuedAt: string;
       revokedAt: string | null;
+      source?: string | undefined;
     }>;
   };
   customerInquiries: {
@@ -11909,7 +13259,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")[];
+      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")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -11919,7 +13269,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")[];
+      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")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -11929,7 +13279,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")[];
+      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")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -11939,7 +13289,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")[];
+      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")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -11954,7 +13304,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")[];
+      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")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -11964,7 +13314,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";
+      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";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -11991,7 +13341,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";
+      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";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -12026,7 +13376,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";
+      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";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -12404,6 +13754,40 @@ export declare function createStoreClient(options: StoreClientOptions): {
     remove: (addressId: string) => Promise<void>;
     setDefault: (addressId: string) => Promise<void>;
   };
+  /** 픽업 장소 (이슈 #115) — 방문 수령 주문의 수령 장소. 조회 `store:r`, 쓰기 `store:rw`(상점 플랫폼 OWNER·ADMIN) */
+  pickupLocations: {
+    list: () => Promise<{
+      locationId: string;
+      name: string;
+      address: string;
+      phone: string | null;
+      hours: string | null;
+      usable: boolean;
+      sortOrder: number;
+      createdAt: string;
+    }[]>;
+    create: (body: PickupLocationRequestInput) => Promise<{
+      locationId: string;
+      name: string;
+      address: string;
+      phone: string | null;
+      hours: string | null;
+      usable: boolean;
+      sortOrder: number;
+      createdAt: string;
+    }>;
+    update: (locationId: string, body: PickupLocationRequestInput) => Promise<{
+      locationId: string;
+      name: string;
+      address: string;
+      phone: string | null;
+      hours: string | null;
+      usable: boolean;
+      sortOrder: number;
+      createdAt: string;
+    }>;
+    remove: (locationId: string) => Promise<void>;
+  };
   /**
    * 스토어프론트 호스팅 (이슈 #53) — 조회 `storefront:r`, 쓰기 `storefront:rw`(OWNER·ADMIN).
    * 쓰기 응답은 바뀐 사이트다. Cloudflare 반영은 커밋 뒤라 `provisioning.status`가 잠시 `PENDING`일 수 있다.
@@ -14426,10 +15810,13 @@ export declare const STORE_SCOPE_RESOURCES: {
   readonly audit: readonly ["r"];
   readonly promotion: readonly ["r", "rw"];
   readonly storefront: readonly ["r", "rw"];
+  readonly flow: readonly ["r", "rw"];
 };
 export type StoreScopeResource = keyof typeof STORE_SCOPE_RESOURCES;
 export declare const storeScopeResourceSchema: z.ZodEnum<{
   category: "category";
+  member: "member";
+  flow: "flow";
   analytics: "analytics";
   product: "product";
   order: "order";
@@ -14439,7 +15826,6 @@ export declare const storeScopeResourceSchema: z.ZodEnum<{
   settlement: "settlement";
   webhook: "webhook";
   store: "store";
-  member: "member";
   customer: "customer";
   audit: "audit";
   promotion: "promotion";
@@ -14452,9 +15838,9 @@ export declare function isStoreScope(scope: string): boolean;
  * 계정 토큰으로 상점을 호출할 때의 스코프는 그 상점에서의 역할로 이 표에서 결정된다.
  */
 export declare const STORE_ROLE_SCOPES: {
-  readonly OWNER: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "settlement:r", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw", "storefront:rw"];
-  readonly ADMIN: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw", "storefront:rw"];
-  readonly STAFF: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "customer:r", "promotion:r"];
+  readonly OWNER: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "settlement:r", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw", "storefront:rw", "flow:rw"];
+  readonly ADMIN: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw", "storefront:rw", "flow:rw"];
+  readonly STAFF: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "customer:r", "promotion:r", "flow:r"];
 };
 //#endregion
 //#region src/schemas/shipping-policy.d.ts
@@ -14592,6 +15978,8 @@ export interface DeliveryFeeLine {
    * 유형을 바꿔도 결제 시작의 견적과 주문상품 스냅샷이 같은 유형을 보게 한다. 생략하면 상품 값을 쓴다.
    */
   fulfillmentType?: FulfillmentType | null;
+  /** 이 줄의 이행 방식(이슈 #115) — 배송지가 없는 방식(방문 수령)은 묶음을 만들지 않는다. 생략하면 유형 규칙만 본다 */
+  fulfillmentMethod?: string | null;
 }
 /**
  * 기본 배송비를 면제한 근거 — 면제하지 않았으면 null이다.
@@ -15042,8 +16430,24 @@ export declare const orderWebhookEventDataSchema: z.ZodObject<{
       bundleKey: z.ZodNullable<z.ZodString>;
       returnAddressId: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
+    method: z.ZodOptional<z.ZodString>;
+    pickupLocation: z.ZodOptional<z.ZodObject<{
+      locationId: z.ZodString;
+      name: z.ZodString;
+      address: z.ZodString;
+      phone: z.ZodNullable<z.ZodString>;
+      hours: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
   }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"MANUAL">;
+    method: z.ZodOptional<z.ZodString>;
+    pickupLocation: z.ZodOptional<z.ZodObject<{
+      locationId: z.ZodString;
+      name: z.ZodString;
+      address: z.ZodString;
+      phone: z.ZodNullable<z.ZodString>;
+      hours: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
   }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
     type: z.ZodString;
   }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -15061,6 +16465,8 @@ export declare const orderWebhookEventDataSchema: z.ZodObject<{
     customInputs: z.ZodArray<z.ZodObject<{
       label: z.ZodString;
       value: z.ZodString;
+      key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      type: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
   }, z.core.$strip>>>;
 }, z.core.$strip>;
@@ -15089,8 +16495,24 @@ export declare const orderFulfilledWebhookEventDataSchema: z.ZodObject<{
       bundleKey: z.ZodNullable<z.ZodString>;
       returnAddressId: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>;
+    method: z.ZodOptional<z.ZodString>;
+    pickupLocation: z.ZodOptional<z.ZodObject<{
+      locationId: z.ZodString;
+      name: z.ZodString;
+      address: z.ZodString;
+      phone: z.ZodNullable<z.ZodString>;
+      hours: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
   }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"MANUAL">;
+    method: z.ZodOptional<z.ZodString>;
+    pickupLocation: z.ZodOptional<z.ZodObject<{
+      locationId: z.ZodString;
+      name: z.ZodString;
+      address: z.ZodString;
+      phone: z.ZodNullable<z.ZodString>;
+      hours: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
   }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
     type: z.ZodString;
   }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -15225,8 +16647,24 @@ export declare const orderWebhookEventSchema: z.ZodObject<{
         bundleKey: z.ZodNullable<z.ZodString>;
         returnAddressId: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>;
+      method: z.ZodOptional<z.ZodString>;
+      pickupLocation: z.ZodOptional<z.ZodObject<{
+        locationId: z.ZodString;
+        name: z.ZodString;
+        address: z.ZodString;
+        phone: z.ZodNullable<z.ZodString>;
+        hours: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
       type: z.ZodLiteral<"MANUAL">;
+      method: z.ZodOptional<z.ZodString>;
+      pickupLocation: z.ZodOptional<z.ZodObject<{
+        locationId: z.ZodString;
+        name: z.ZodString;
+        address: z.ZodString;
+        phone: z.ZodNullable<z.ZodString>;
+        hours: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>;
     }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
       type: z.ZodString;
     }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -15244,6 +16682,8 @@ export declare const orderWebhookEventSchema: z.ZodObject<{
       customInputs: z.ZodArray<z.ZodObject<{
         label: z.ZodString;
         value: z.ZodString;
+        key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodOptional<z.ZodString>;
       }, z.core.$strip>>;
     }, z.core.$strip>>>;
   }, z.core.$strip>;
@@ -15274,8 +16714,24 @@ export declare const orderFulfilledWebhookEventSchema: z.ZodObject<{
         bundleKey: z.ZodNullable<z.ZodString>;
         returnAddressId: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>;
+      method: z.ZodOptional<z.ZodString>;
+      pickupLocation: z.ZodOptional<z.ZodObject<{
+        locationId: z.ZodString;
+        name: z.ZodString;
+        address: z.ZodString;
+        phone: z.ZodNullable<z.ZodString>;
+        hours: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
       type: z.ZodLiteral<"MANUAL">;
+      method: z.ZodOptional<z.ZodString>;
+      pickupLocation: z.ZodOptional<z.ZodObject<{
+        locationId: z.ZodString;
+        name: z.ZodString;
+        address: z.ZodString;
+        phone: z.ZodNullable<z.ZodString>;
+        hours: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>;
     }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
       type: z.ZodString;
     }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -15412,6 +16868,33 @@ export declare const productOutOfStockWebhookEventSchema: z.ZodObject<{
   storeId: z.ZodString;
   sequence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+/**
+ * 플로우 알림(이슈 #115) — 상점이 플로우에 둔 알림 블록(`core.notify`, 채널 `webhook`)이 보낸다. 구매자 알림(알림톡·메일)은 이 이벤트를 받아
+ * 상점이 보낸다(플랫폼은 구매자에게 직접 보내지 않는다). 개인정보는 싣지 않는다
+ */
+export declare const flowNotificationWebhookEventDataSchema: z.ZodObject<{
+  orderId: z.ZodString;
+  orderItemIds: z.ZodArray<z.ZodString>;
+  event: z.ZodString;
+  flowId: z.ZodString;
+  flowVersion: z.ZodNumber;
+  state: z.ZodString;
+}, z.core.$strip>;
+export declare const flowNotificationWebhookEventSchema: z.ZodObject<{
+  type: z.ZodLiteral<"ORDER.FLOW_NOTIFICATION">;
+  data: z.ZodObject<{
+    orderId: z.ZodString;
+    orderItemIds: z.ZodArray<z.ZodString>;
+    event: z.ZodString;
+    flowId: z.ZodString;
+    flowVersion: z.ZodNumber;
+    state: 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<{
@@ -15445,8 +16928,24 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         bundleKey: z.ZodNullable<z.ZodString>;
         returnAddressId: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>;
+      method: z.ZodOptional<z.ZodString>;
+      pickupLocation: z.ZodOptional<z.ZodObject<{
+        locationId: z.ZodString;
+        name: z.ZodString;
+        address: z.ZodString;
+        phone: z.ZodNullable<z.ZodString>;
+        hours: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
       type: z.ZodLiteral<"MANUAL">;
+      method: z.ZodOptional<z.ZodString>;
+      pickupLocation: z.ZodOptional<z.ZodObject<{
+        locationId: z.ZodString;
+        name: z.ZodString;
+        address: z.ZodString;
+        phone: z.ZodNullable<z.ZodString>;
+        hours: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>;
     }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
       type: z.ZodString;
     }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -15464,6 +16963,8 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       customInputs: z.ZodArray<z.ZodObject<{
         label: z.ZodString;
         value: z.ZodString;
+        key: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodOptional<z.ZodString>;
       }, z.core.$strip>>;
     }, z.core.$strip>>>;
   }, z.core.$strip>;
@@ -15493,8 +16994,24 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         bundleKey: z.ZodNullable<z.ZodString>;
         returnAddressId: z.ZodNullable<z.ZodString>;
       }, z.core.$strip>;
+      method: z.ZodOptional<z.ZodString>;
+      pickupLocation: z.ZodOptional<z.ZodObject<{
+        locationId: z.ZodString;
+        name: z.ZodString;
+        address: z.ZodString;
+        phone: z.ZodNullable<z.ZodString>;
+        hours: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
       type: z.ZodLiteral<"MANUAL">;
+      method: z.ZodOptional<z.ZodString>;
+      pickupLocation: z.ZodOptional<z.ZodObject<{
+        locationId: z.ZodString;
+        name: z.ZodString;
+        address: z.ZodString;
+        phone: z.ZodNullable<z.ZodString>;
+        hours: z.ZodNullable<z.ZodString>;
+      }, z.core.$strip>>;
     }, z.core.$strip>], "type">, z.ZodPipe<z.ZodObject<{
       type: z.ZodString;
     }, z.core.$loose>, z.ZodTransform<UnknownFulfillment, {
@@ -15625,6 +17142,20 @@ 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_NOTIFICATION">;
+  data: z.ZodObject<{
+    orderId: z.ZodString;
+    orderItemIds: z.ZodArray<z.ZodString>;
+    event: z.ZodString;
+    flowId: z.ZodString;
+    flowVersion: z.ZodNumber;
+    state: 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"];
@@ -15634,5 +17165,33 @@ export type WebhookEventOf<T extends WebhookEventType> = WebhookEvent extends (i
 } ? T extends U ? Omit<E, "type"> & {
   type: T;
 } : never : never : never;
+/**
+ * 알려진 웹훅 이벤트 타입 — `webhookEventSchema`의 판별 값 목록(이 SDK 버전이 아는 것).
+ * 서버는 새 타입을 구독한 엔드포인트에만 보내지만, 구독을 더 넓힌 수신자를 위해 `parseWebhookEvent`가 모르는 타입을 따로 받는다.
+ */
+export declare const KNOWN_WEBHOOK_EVENT_TYPES: readonly WebhookEventType[];
+/** 이 SDK 버전이 모르는 이벤트 — 봉투만 검증하고 `data`는 그대로 둔다 */
+export declare const unknownWebhookEventSchema: z.ZodObject<{
+  type: z.ZodString;
+  data: z.ZodUnknown;
+  id: z.ZodString;
+  createdAt: z.ZodString;
+  storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type UnknownWebhookEvent = z.infer<typeof unknownWebhookEventSchema>;
+export type ParsedWebhookEvent = {
+  known: true;
+  event: WebhookEvent;
+} | {
+  known: false;
+  event: UnknownWebhookEvent;
+};
+/**
+ * 웹훅 본문을 `type`으로 먼저 판별해 읽는다(이슈 #115 결정 25). 알려진 타입은 그 타입의 스키마로 엄격하게 읽고 틀리면 던진다 —
+ * `z.union([known, unknown])`처럼 읽으면 알려진 타입의 파싱 실패가 `known: false`로 조용히 새어 수신자가 처리할 이벤트를 버린다.
+ * 모르는 타입은 봉투만 검증해 `known: false`로 돌려준다(새 이벤트에 옛 SDK가 깨지지 않는다).
+ */
+export declare function parseWebhookEvent(body: unknown): ParsedWebhookEvent;
 //#endregion
 export { type AuthorizeOptions, type OAuthTokenResponse, type Query, type SessionStorage, type StoreAuthServer, type StoreClient, type StoreClientOptions, type StoreSession, type StoreSessionOptions, type TokenSource, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_HEADERS, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT };