@sayren/store-sdk 0.29.7 → 0.30.0

package/dist/index.d.mts

@@ -166,8 +166,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
 export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
 export declare const agentPolicyDecisionSchema: z.ZodEnum<{
   DENIED: "DENIED";
-  ALLOW: "ALLOW";
   APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+  ALLOW: "ALLOW";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
 export declare const writePreviewSchema: z.ZodObject<{
@@ -191,8 +191,8 @@ export declare const writeDryRunResultSchema: z.ZodObject<{
   dryRun: z.ZodLiteral<true>;
   decision: z.ZodEnum<{
     DENIED: "DENIED";
-    ALLOW: "ALLOW";
     APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+    ALLOW: "ALLOW";
   }>;
   reason: z.ZodNullable<z.ZodString>;
   preview: z.ZodObject<{
@@ -995,6 +995,7 @@ export declare const categorySchema: z.ZodObject<{
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
   metaKeywords: z.ZodNullable<z.ZodString>;
+  flowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
 }, z.core.$strip>;
@@ -1025,6 +1026,7 @@ export declare const categoryWithPathSchema: z.ZodObject<{
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
   metaKeywords: z.ZodNullable<z.ZodString>;
+  flowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
   fullPath: z.ZodString;
@@ -1050,6 +1052,7 @@ export declare const categoryWithPathSchema: z.ZodObject<{
     metaTitle: z.ZodNullable<z.ZodString>;
     metaDescription: z.ZodNullable<z.ZodString>;
     metaKeywords: z.ZodNullable<z.ZodString>;
+    flowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
@@ -1078,6 +1081,7 @@ export declare const categorySearchResultSchema: z.ZodObject<{
   metaTitle: z.ZodNullable<z.ZodString>;
   metaDescription: z.ZodNullable<z.ZodString>;
   metaKeywords: z.ZodNullable<z.ZodString>;
+  flowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   createdAt: z.ZodString;
   updatedAt: z.ZodString;
   fullPath: z.ZodString;
@@ -1103,6 +1107,7 @@ export declare const categorySearchResultSchema: z.ZodObject<{
     metaTitle: z.ZodNullable<z.ZodString>;
     metaDescription: z.ZodNullable<z.ZodString>;
     metaKeywords: z.ZodNullable<z.ZodString>;
+    flowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
   }, z.core.$strip>>;
@@ -1158,6 +1163,7 @@ export declare const categoryPatchRequestSchema: z.ZodObject<{
   metaTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   metaDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   metaKeywords: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  flowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type CategoryPatchRequest = z.infer<typeof categoryPatchRequestSchema>;
 export declare const categoryDeleteStrategySchema: z.ZodEnum<{
@@ -2007,6 +2013,376 @@ 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 resolvedFlowSchema: z.ZodObject<{
+  flowId: z.ZodString;
+  version: z.ZodNumber;
+  source: z.ZodEnum<{
+    PRODUCT: "PRODUCT";
+    CATEGORY: "CATEGORY";
+    PLATFORM: "PLATFORM";
+  }>;
+}, z.core.$strip>;
+export type ResolvedFlow = z.infer<typeof resolvedFlowSchema>;
+/** 시크릿 이름 — 플로우 변수 `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`.
@@ -2624,65 +3000,399 @@ export declare const customerWithdrawalBlockedDetailsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type CustomerWithdrawalBlockedDetails = z.infer<typeof customerWithdrawalBlockedDetailsSchema>;
 //#endregion
-//#region src/schemas/login.d.ts
-/** 소셜 로그인 공급자 */
-export declare const loginProviderSchema: z.ZodEnum<{
-  kakao: "kakao";
-  naver: "naver";
-  google: "google";
+//#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 LoginProvider = z.infer<typeof loginProviderSchema>;
-/** 공급자 연결 상태 — 비밀 값은 앞 4자리만 */
-export declare const loginProviderStatusSchema: z.ZodObject<{
-  provider: z.ZodEnum<{
-    kakao: "kakao";
-    naver: "naver";
-    google: "google";
-  }>;
-  connected: z.ZodBoolean;
-  enabled: z.ZodBoolean;
-  clientIdPrefix: z.ZodNullable<z.ZodString>;
-  secretPrefix: z.ZodNullable<z.ZodString>;
-  lastTestedAt: z.ZodNullable<z.ZodString>;
-  lastTestOk: z.ZodNullable<z.ZodBoolean>;
-  linkedMemberCount: z.ZodNumber;
-  onlyMethodMemberCount: z.ZodNumber;
-  callbackUrl: z.ZodURL;
-}, z.core.$strip>;
-export type LoginProviderStatus = z.infer<typeof loginProviderStatusSchema>;
-/** `GET /v1/store/login-settings` */
-export declare const loginSettingsSchema: z.ZodObject<{
-  passwordLoginEnabled: z.ZodBoolean;
-  passwordOnlyMemberCount: z.ZodNumber;
-  storefrontOrigins: z.ZodArray<z.ZodString>;
-  providers: z.ZodArray<z.ZodObject<{
-    provider: z.ZodEnum<{
-      kakao: "kakao";
-      naver: "naver";
-      google: "google";
-    }>;
-    connected: z.ZodBoolean;
-    enabled: z.ZodBoolean;
-    clientIdPrefix: z.ZodNullable<z.ZodString>;
-    secretPrefix: z.ZodNullable<z.ZodString>;
-    lastTestedAt: z.ZodNullable<z.ZodString>;
-    lastTestOk: z.ZodNullable<z.ZodBoolean>;
-    linkedMemberCount: z.ZodNumber;
-    onlyMethodMemberCount: z.ZodNumber;
-    callbackUrl: z.ZodURL;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-export type LoginSettings = z.infer<typeof loginSettingsSchema>;
-/** `PATCH /v1/store/login-settings` */
-export declare const updateLoginSettingsRequestSchema: z.ZodObject<{
-  passwordLoginEnabled: z.ZodBoolean;
-}, z.core.$strip>;
-export type UpdateLoginSettingsRequest = z.infer<typeof updateLoginSettingsRequestSchema>;
-/** `PUT /v1/store/auth-providers/{provider}` — 저장 전에 연결 테스트를 한다 */
-export declare const saveLoginProviderRequestSchema: z.ZodObject<{
-  clientId: z.ZodString;
-  clientSecret: z.ZodString;
-}, z.core.$strip>;
+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
+/** 소셜 로그인 공급자 */
+export declare const loginProviderSchema: z.ZodEnum<{
+  kakao: "kakao";
+  naver: "naver";
+  google: "google";
+}>;
+export type LoginProvider = z.infer<typeof loginProviderSchema>;
+/** 공급자 연결 상태 — 비밀 값은 앞 4자리만 */
+export declare const loginProviderStatusSchema: z.ZodObject<{
+  provider: z.ZodEnum<{
+    kakao: "kakao";
+    naver: "naver";
+    google: "google";
+  }>;
+  connected: z.ZodBoolean;
+  enabled: z.ZodBoolean;
+  clientIdPrefix: z.ZodNullable<z.ZodString>;
+  secretPrefix: z.ZodNullable<z.ZodString>;
+  lastTestedAt: z.ZodNullable<z.ZodString>;
+  lastTestOk: z.ZodNullable<z.ZodBoolean>;
+  linkedMemberCount: z.ZodNumber;
+  onlyMethodMemberCount: z.ZodNumber;
+  callbackUrl: z.ZodURL;
+}, z.core.$strip>;
+export type LoginProviderStatus = z.infer<typeof loginProviderStatusSchema>;
+/** `GET /v1/store/login-settings` */
+export declare const loginSettingsSchema: z.ZodObject<{
+  passwordLoginEnabled: z.ZodBoolean;
+  passwordOnlyMemberCount: z.ZodNumber;
+  storefrontOrigins: z.ZodArray<z.ZodString>;
+  providers: z.ZodArray<z.ZodObject<{
+    provider: z.ZodEnum<{
+      kakao: "kakao";
+      naver: "naver";
+      google: "google";
+    }>;
+    connected: z.ZodBoolean;
+    enabled: z.ZodBoolean;
+    clientIdPrefix: z.ZodNullable<z.ZodString>;
+    secretPrefix: z.ZodNullable<z.ZodString>;
+    lastTestedAt: z.ZodNullable<z.ZodString>;
+    lastTestOk: z.ZodNullable<z.ZodBoolean>;
+    linkedMemberCount: z.ZodNumber;
+    onlyMethodMemberCount: z.ZodNumber;
+    callbackUrl: z.ZodURL;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LoginSettings = z.infer<typeof loginSettingsSchema>;
+/** `PATCH /v1/store/login-settings` */
+export declare const updateLoginSettingsRequestSchema: z.ZodObject<{
+  passwordLoginEnabled: z.ZodBoolean;
+}, z.core.$strip>;
+export type UpdateLoginSettingsRequest = z.infer<typeof updateLoginSettingsRequestSchema>;
+/** `PUT /v1/store/auth-providers/{provider}` — 저장 전에 연결 테스트를 한다 */
+export declare const saveLoginProviderRequestSchema: z.ZodObject<{
+  clientId: z.ZodString;
+  clientSecret: z.ZodString;
+}, z.core.$strip>;
 export type SaveLoginProviderRequest = z.infer<typeof saveLoginProviderRequestSchema>;
 /** `PATCH /v1/store/auth-providers/{provider}` */
 export declare const updateLoginProviderRequestSchema: z.ZodObject<{
@@ -2895,6 +3605,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<{
@@ -2921,6 +3632,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";
@@ -2951,6 +3663,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";
@@ -3031,6 +3744,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<{
@@ -3084,6 +3798,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<{
@@ -3146,6 +3861,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>>;
@@ -3173,6 +3889,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>;
@@ -3214,6 +3931,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>;
@@ -3286,208 +4004,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;
@@ -3559,7 +4075,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">;
@@ -3567,8 +4093,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, {
@@ -3722,7 +4264,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">;
@@ -3730,8 +4282,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, {
@@ -3841,7 +4409,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">;
@@ -3849,8 +4427,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, {
@@ -3970,16 +4564,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";
   }>;
@@ -3991,8 +4585,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";
   }>;
@@ -4018,8 +4612,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";
   }>;
@@ -5543,6 +6137,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>;
@@ -5595,6 +6190,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;
@@ -5604,6 +6205,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>;
 /**
@@ -5642,6 +6246,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>;
 /**
@@ -5659,6 +6273,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<{
@@ -5723,6 +6339,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<{
@@ -5746,6 +6363,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";
@@ -5766,14 +6386,18 @@ 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>;
+  flowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   fulfillmentTypeLocked: z.ZodBoolean;
   refundPolicy: z.ZodNullable<z.ZodObject<{
     preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
@@ -5848,6 +6472,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) */
@@ -5871,6 +6496,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>;
@@ -5890,6 +6516,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";
@@ -5924,6 +6560,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<{
@@ -5947,6 +6584,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";
@@ -5990,10 +6630,27 @@ 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";
+  }>>;
+  flowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
@@ -6013,6 +6670,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>;
@@ -6032,6 +6690,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";
@@ -6076,10 +6744,27 @@ 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";
+  }>>;
+  flowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   optionGroups: z.ZodDefault<z.ZodArray<z.ZodObject<{
     groupId: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
@@ -6099,6 +6784,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>;
@@ -6118,6 +6804,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";
@@ -6156,6 +6852,7 @@ export declare const productPatchRequestSchema: z.ZodObject<{
     OUT_OF_STOCK: "OUT_OF_STOCK";
     CLOSED: "CLOSED";
   }>>;
+  flowId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   images: z.ZodOptional<z.ZodArray<z.ZodURL>>;
   fulfillment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"SHIPPING">;
@@ -6170,8 +6867,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>;
@@ -6269,6 +6978,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<{
@@ -6294,6 +7006,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;
@@ -6322,6 +7037,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`개이고
@@ -6352,6 +7077,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>;
@@ -6395,6 +7130,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;
@@ -6437,6 +7175,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` 헤더).
@@ -8080,10 +8879,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 {
@@ -8123,6 +8924,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>;
@@ -8397,6 +9199,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        attributes?: Record<string, string> | undefined;
         hasOrders?: boolean | undefined;
       }[];
       addonGroups: {
@@ -8420,6 +9223,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 | {
@@ -8431,8 +9237,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
           shippingAddressId: string | null;
           returnAddressId: string | null;
         };
+        methods?: string[] | undefined;
       } | {
         type: "MANUAL";
+        methods?: string[] | undefined;
       };
       fulfillmentTypeLocked: boolean;
       refundPolicy: {
@@ -8452,6 +9260,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
+      inventoryMode?: string | undefined;
+      flowId?: string | null | undefined;
       discount?: {
         productId: string;
         discountType: "RATE" | "AMOUNT";
@@ -8497,6 +9307,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        attributes?: Record<string, string> | undefined;
         hasOrders?: boolean | undefined;
       }[];
       addonGroups: {
@@ -8520,6 +9331,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 | {
@@ -8531,8 +9345,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
           shippingAddressId: string | null;
           returnAddressId: string | null;
         };
+        methods?: string[] | undefined;
       } | {
         type: "MANUAL";
+        methods?: string[] | undefined;
       };
       fulfillmentTypeLocked: boolean;
       refundPolicy: {
@@ -8552,6 +9368,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
+      inventoryMode?: string | undefined;
+      flowId?: string | null | undefined;
       discount?: {
         productId: string;
         discountType: "RATE" | "AMOUNT";
@@ -8597,6 +9415,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        attributes?: Record<string, string> | undefined;
         hasOrders?: boolean | undefined;
       }[];
       addonGroups: {
@@ -8620,6 +9439,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 | {
@@ -8631,8 +9453,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
           shippingAddressId: string | null;
           returnAddressId: string | null;
         };
+        methods?: string[] | undefined;
       } | {
         type: "MANUAL";
+        methods?: string[] | undefined;
       };
       fulfillmentTypeLocked: boolean;
       refundPolicy: {
@@ -8652,6 +9476,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         attributeId: string;
         value: string;
       }[] | undefined;
+      inventoryMode?: string | undefined;
+      flowId?: string | null | undefined;
       discount?: {
         productId: string;
         discountType: "RATE" | "AMOUNT";
@@ -8699,6 +9525,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        attributes?: Record<string, string> | undefined;
         hasOrders?: boolean | undefined;
       }[];
       addonGroups: {
@@ -8722,6 +9549,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";
     }>;
@@ -8753,6 +9583,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         weightGram: number | null;
         sellerCode: string | null;
         usable: boolean;
+        attributes?: Record<string, string> | undefined;
         hasOrders?: boolean | undefined;
       }[];
       addonGroups: {
@@ -8776,6 +9607,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";
     }>;
@@ -8801,6 +9635,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) — 자주 쓰는 옵션 구성. 불러오기는 복사라 저장 옵션을 고쳐도 불러온 상품은 바뀌지 않는다.
@@ -8830,6 +9675,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;
@@ -8854,6 +9702,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;
@@ -8878,6 +9729,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;
@@ -8902,6 +9756,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;
@@ -8928,6 +9785,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;
@@ -9267,6 +10127,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       metaKeywords: string | null;
       createdAt: string;
       updatedAt: string;
+      flowId?: string | null | undefined;
     }[]>;
     tree: () => Promise<CategoryTreeNode[]>;
     search: (q: string) => Promise<{
@@ -9306,7 +10167,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
         metaKeywords: string | null;
         createdAt: string;
         updatedAt: string;
+        flowId?: string | null | undefined;
       }[];
+      flowId?: string | null | undefined;
     }[]>;
     get: (categoryId: string) => Promise<{
       categoryId: string;
@@ -9345,8 +10208,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
         metaKeywords: string | null;
         createdAt: string;
         updatedAt: string;
+        flowId?: string | null | undefined;
       }[];
       childCount: number;
+      flowId?: string | null | undefined;
     }>;
     listAttributes: (categoryId: string) => Promise<{
       attributeId: string;
@@ -9374,6 +10239,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       metaKeywords: string | null;
       createdAt: string;
       updatedAt: string;
+      flowId?: string | null | undefined;
     }>;
     update: (categoryId: string, body: CategoryPatchRequest) => Promise<{
       categoryId: string;
@@ -9393,6 +10259,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       metaKeywords: string | null;
       createdAt: string;
       updatedAt: string;
+      flowId?: string | null | undefined;
     }>;
     remove: (categoryId: string, opts?: {
       strategy?: CategoryDeleteStrategy;
@@ -9497,6 +10364,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         customInputs: {
           label: string;
           value: string;
+          key?: string | null | undefined;
+          type?: string | undefined;
         }[];
         sellerCode: string | null;
         fulfillmentSnapshot: UnknownFulfillment | {
@@ -9505,8 +10374,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;
@@ -9532,6 +10417,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;
       }[];
     }>;
     /**
@@ -9584,6 +10477,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
         customInputs: {
           label: string;
           value: string;
+          key?: string | null | undefined;
+          type?: string | undefined;
         }[];
         sellerCode: string | null;
         fulfillmentSnapshot: UnknownFulfillment | {
@@ -9592,8 +10487,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;
@@ -9619,6 +10530,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>;
@@ -9655,7 +10574,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;
@@ -9700,6 +10619,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       customInputs: {
         label: string;
         value: string;
+        key?: string | null | undefined;
+        type?: string | undefined;
       }[];
       sellerCode: string | null;
       fulfillmentSnapshot: UnknownFulfillment | {
@@ -9708,8 +10629,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;
@@ -9735,6 +10672,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<{
@@ -9770,6 +10715,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
       customInputs: {
         label: string;
         value: string;
+        key?: string | null | undefined;
+        type?: string | undefined;
       }[];
       sellerCode: string | null;
       fulfillmentSnapshot: UnknownFulfillment | {
@@ -9778,8 +10725,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;
@@ -9805,6 +10768,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<{
@@ -9819,7 +10790,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;
@@ -9840,6 +10811,350 @@ 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;
+      }[];
+    }>;
+    /** 이 상품에 지금 붙을 플로우 */
+    forProduct: (productId: string) => Promise<{
+      flowId: string;
+      version: number;
+      source: "PRODUCT" | "CATEGORY" | "PLATFORM";
+    }>;
+    /** 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<{
@@ -11923,7 +13238,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;
@@ -11933,7 +13248,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;
@@ -11943,7 +13258,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;
@@ -11953,7 +13268,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;
@@ -11968,7 +13283,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;
@@ -11978,7 +13293,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;
@@ -12005,7 +13320,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;
@@ -12040,7 +13355,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;
@@ -12418,6 +13733,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`일 수 있다.
@@ -14440,10 +15789,12 @@ 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";
+  flow: "flow";
   analytics: "analytics";
   product: "product";
   order: "order";
@@ -14466,9 +15817,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
@@ -14606,6 +15957,8 @@ export interface DeliveryFeeLine {
    * 유형을 바꿔도 결제 시작의 견적과 주문상품 스냅샷이 같은 유형을 보게 한다. 생략하면 상품 값을 쓴다.
    */
   fulfillmentType?: FulfillmentType | null;
+  /** 이 줄의 이행 방식(이슈 #115) — 배송지가 없는 방식(방문 수령)은 묶음을 만들지 않는다. 생략하면 유형 규칙만 본다 */
+  fulfillmentMethod?: string | null;
 }
 /**
  * 기본 배송비를 면제한 근거 — 면제하지 않았으면 null이다.
@@ -15056,8 +16409,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, {
@@ -15075,6 +16444,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>;
@@ -15103,8 +16474,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, {
@@ -15239,8 +16626,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, {
@@ -15258,6 +16661,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>;
@@ -15288,8 +16693,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, {
@@ -15426,6 +16847,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<{
@@ -15459,8 +16907,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, {
@@ -15478,6 +16942,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>;
@@ -15507,8 +16973,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, {
@@ -15639,6 +17121,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"];
@@ -15648,5 +17144,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 };