@sayren/store-sdk 0.31.0 → 0.32.0

package/dist/index.d.mts

@@ -3041,6 +3041,7 @@ export declare const pickupLocationSchema: z.ZodObject<{
   hours: z.ZodNullable<z.ZodString>;
   usable: z.ZodBoolean;
   sortOrder: z.ZodNumber;
+  inventoryLocationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   createdAt: z.ZodString;
 }, z.core.$strip>;
 export type PickupLocation = z.infer<typeof pickupLocationSchema>;
@@ -3050,6 +3051,7 @@ export declare const pickupLocationRequestSchema: z.ZodObject<{
   phone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   hours: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   usable: z.ZodDefault<z.ZodBoolean>;
+  inventoryLocationId: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type PickupLocationRequest = z.infer<typeof pickupLocationRequestSchema>;
 export type PickupLocationRequestInput = z.input<typeof pickupLocationRequestSchema>;
@@ -3261,8 +3263,32 @@ export type ReviewWebhookEventData = z.infer<typeof reviewWebhookEventDataSchema
 export declare const productOutOfStockWebhookEventDataSchema: z.ZodObject<{
   productId: z.ZodString;
   variantId: z.ZodString;
+  inventoryLocationId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ProductOutOfStockWebhookEventData = z.infer<typeof productOutOfStockWebhookEventDataSchema>;
+/**
+ * 위치별 재고 변화(이슈 #132) — 재고 변동 내역 한 행마다 한 건이다. 같은 위치·조합의 순서는 `levelVersion`(빈 번호 없음)으로 맞추고,
+ * 상점 전체 순서는 `movementSeq`(재고 변동 내역 조회의 `after` 커서와 같은 값)다. 자기가 한 조정의 반향은 `actorType`·`actorId`·`operationId`로 거른다.
+ * 출고 대기·실재고(상태 전이) 변화는 이벤트를 내지 않는다 — 필요하면 위치별 재고 조회를 다시 읽는다
+ */
+export declare const inventoryChangedWebhookEventDataSchema: z.ZodObject<{
+  productId: z.ZodString;
+  variantId: z.ZodString;
+  inventoryLocationId: z.ZodString;
+  available: z.ZodNumber;
+  delta: z.ZodNumber;
+  kind: z.ZodString;
+  reason: z.ZodNullable<z.ZodString>;
+  levelVersion: z.ZodNumber;
+  movementSeq: z.ZodNumber;
+  actorType: z.ZodString;
+  actorId: z.ZodNullable<z.ZodString>;
+  refType: z.ZodNullable<z.ZodString>;
+  refId: z.ZodNullable<z.ZodString>;
+  operationId: z.ZodNullable<z.ZodString>;
+  occurredAt: z.ZodString;
+}, z.core.$strip>;
+export type InventoryChangedWebhookEventData = z.infer<typeof inventoryChangedWebhookEventDataSchema>;
 export declare const orderWebhookEventSchema: z.ZodObject<{
   type: z.ZodEnum<{
     "ORDER.PAID": "ORDER.PAID";
@@ -3510,6 +3536,31 @@ export declare const productOutOfStockWebhookEventSchema: z.ZodObject<{
   data: z.ZodObject<{
     productId: z.ZodString;
     variantId: z.ZodString;
+    inventoryLocationId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  id: z.ZodString;
+  createdAt: z.ZodString;
+  storeId: z.ZodString;
+  sequence: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const inventoryChangedWebhookEventSchema: z.ZodObject<{
+  type: z.ZodLiteral<"INVENTORY.CHANGED">;
+  data: z.ZodObject<{
+    productId: z.ZodString;
+    variantId: z.ZodString;
+    inventoryLocationId: z.ZodString;
+    available: z.ZodNumber;
+    delta: z.ZodNumber;
+    kind: z.ZodString;
+    reason: z.ZodNullable<z.ZodString>;
+    levelVersion: z.ZodNumber;
+    movementSeq: z.ZodNumber;
+    actorType: z.ZodString;
+    actorId: z.ZodNullable<z.ZodString>;
+    refType: z.ZodNullable<z.ZodString>;
+    refId: z.ZodNullable<z.ZodString>;
+    operationId: z.ZodNullable<z.ZodString>;
+    occurredAt: z.ZodString;
   }, z.core.$strip>;
   id: z.ZodString;
   createdAt: z.ZodString;
@@ -3818,6 +3869,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   data: z.ZodObject<{
     productId: z.ZodString;
     variantId: z.ZodString;
+    inventoryLocationId: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
   id: z.ZodString;
   createdAt: z.ZodString;
@@ -3854,6 +3906,29 @@ 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<"INVENTORY.CHANGED">;
+  data: z.ZodObject<{
+    productId: z.ZodString;
+    variantId: z.ZodString;
+    inventoryLocationId: z.ZodString;
+    available: z.ZodNumber;
+    delta: z.ZodNumber;
+    kind: z.ZodString;
+    reason: z.ZodNullable<z.ZodString>;
+    levelVersion: z.ZodNumber;
+    movementSeq: z.ZodNumber;
+    actorType: z.ZodString;
+    actorId: z.ZodNullable<z.ZodString>;
+    refType: z.ZodNullable<z.ZodString>;
+    refId: z.ZodNullable<z.ZodString>;
+    operationId: z.ZodNullable<z.ZodString>;
+    occurredAt: 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"];
@@ -3983,6 +4058,7 @@ export declare const appEventTypeSchema: z.ZodEnum<{
   "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
   "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
   "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
+  "INVENTORY.CHANGED": "INVENTORY.CHANGED";
   "APP.INSTALLED": "APP.INSTALLED";
   "APP.UNINSTALLED": "APP.UNINSTALLED";
   "APP.SETTINGS_UPDATED": "APP.SETTINGS_UPDATED";
@@ -4158,6 +4234,7 @@ export declare const appManifestSchema: z.ZodObject<{
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
     "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
+    "INVENTORY.CHANGED": "INVENTORY.CHANGED";
     "APP.INSTALLED": "APP.INSTALLED";
     "APP.UNINSTALLED": "APP.UNINSTALLED";
     "APP.SETTINGS_UPDATED": "APP.SETTINGS_UPDATED";
@@ -4490,6 +4567,7 @@ export declare const appInstallationSchema: z.ZodObject<{
       "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
       "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
       "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
+      "INVENTORY.CHANGED": "INVENTORY.CHANGED";
       "APP.INSTALLED": "APP.INSTALLED";
       "APP.UNINSTALLED": "APP.UNINSTALLED";
       "APP.SETTINGS_UPDATED": "APP.SETTINGS_UPDATED";
@@ -4536,6 +4614,7 @@ export declare const appInstallationSchema: z.ZodObject<{
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
     "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
+    "INVENTORY.CHANGED": "INVENTORY.CHANGED";
     "APP.INSTALLED": "APP.INSTALLED";
     "APP.UNINSTALLED": "APP.UNINSTALLED";
     "APP.SETTINGS_UPDATED": "APP.SETTINGS_UPDATED";
@@ -4744,6 +4823,7 @@ export declare const storeAppDetailSchema: z.ZodObject<{
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
     "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
+    "INVENTORY.CHANGED": "INVENTORY.CHANGED";
     "APP.INSTALLED": "APP.INSTALLED";
     "APP.UNINSTALLED": "APP.UNINSTALLED";
     "APP.SETTINGS_UPDATED": "APP.SETTINGS_UPDATED";
@@ -7630,6 +7710,220 @@ export declare const customerWithdrawalBlockedDetailsSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type CustomerWithdrawalBlockedDetails = z.infer<typeof customerWithdrawalBlockedDetailsSchema>;
 //#endregion
+//#region src/schemas/inventory.d.ts
+/**
+ * 위치별 재고 (이슈 #132) — 재고 위치(창고·상설 매장·팝업 매장)마다 조합의 가용 재고를 따로 센다. 출고지·반품지·픽업 장소가 위치를
+ * 가리키고, 배송 주문은 출고지 위치에서, 방문 수령 주문은 그 매장 위치에서 뺀다. 위치를 하나만 쓰는 상점은 기본 위치 하나다.
+ *
+ * - 가용 재고(`available`)는 지금 팔 수 있는 수량이다(팔린 미출고분이 이미 빠진 수). 저장하는 값이다.
+ * - 출고 대기(`pendingFulfillment`)는 그 위치에 할당됐고 아직 출고 전(주문상품 `PAID`·`CONFIRMED`)인 수량이다.
+ * - 실재고(`onHand`)는 가용 재고 + 출고 대기다. 위치에 실제로 있어야 하는 수량이다.
+ * - 상품·옵션 API의 `stockQuantity`는 그 상품 기준 위치의 가용 재고다(이름·뜻 유지).
+ */
+/** 재고 조정 사유 — `COUNT`는 실사 줄(`counted`)이 쓴다 */
+export declare const inventoryAdjustmentReasonSchema: z.ZodEnum<{
+  COUNT: "COUNT";
+  RECEIVED: "RECEIVED";
+  DAMAGED: "DAMAGED";
+  LOST: "LOST";
+  FOUND: "FOUND";
+  RETURN_RESTOCK: "RETURN_RESTOCK";
+  CORRECTION: "CORRECTION";
+}>;
+export type InventoryAdjustmentReason = z.infer<typeof inventoryAdjustmentReasonSchema>;
+export declare const inventoryLocationSchema: z.ZodObject<{
+  inventoryLocationId: z.ZodString;
+  name: z.ZodString;
+  isDefault: z.ZodBoolean;
+  sortOrder: z.ZodNumber;
+  createdAt: z.ZodString;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type InventoryLocation = z.infer<typeof inventoryLocationSchema>;
+export declare const inventoryLocationRequestSchema: z.ZodObject<{
+  name: z.ZodString;
+  sortOrder: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type InventoryLocationRequest = z.infer<typeof inventoryLocationRequestSchema>;
+export declare const inventoryLevelSchema: z.ZodObject<{
+  productId: z.ZodString;
+  variantId: z.ZodString;
+  inventoryLocationId: z.ZodString;
+  available: z.ZodNumber;
+  pendingFulfillment: z.ZodNumber;
+  onHand: z.ZodNumber;
+  version: z.ZodNumber;
+  updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type InventoryLevel = z.infer<typeof inventoryLevelSchema>;
+export declare const inventoryLevelListQuerySchema: z.ZodObject<{
+  inventoryLocationId: z.ZodOptional<z.ZodString>;
+  productId: z.ZodOptional<z.ZodString>;
+  variantId: z.ZodOptional<z.ZodString>;
+  cursor: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type InventoryLevelListQuery = z.infer<typeof inventoryLevelListQuerySchema>;
+export declare const inventoryLevelPageSchema: z.ZodObject<{
+  contents: z.ZodArray<z.ZodObject<{
+    productId: z.ZodString;
+    variantId: z.ZodString;
+    inventoryLocationId: z.ZodString;
+    available: z.ZodNumber;
+    pendingFulfillment: z.ZodNumber;
+    onHand: z.ZodNumber;
+    version: z.ZodNumber;
+    updatedAt: z.ZodString;
+  }, z.core.$strip>>;
+  nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type InventoryLevelPage = z.infer<typeof inventoryLevelPageSchema>;
+export declare const inventoryMovementKindSchema: z.ZodEnum<{
+  SALE: "SALE";
+  OPENING: "OPENING";
+  RESTORE: "RESTORE";
+  REVERT: "REVERT";
+  EXCHANGE_OUT: "EXCHANGE_OUT";
+  ADJUST: "ADJUST";
+  COUNT: "COUNT";
+  TRANSFER_OUT: "TRANSFER_OUT";
+  TRANSFER_IN: "TRANSFER_IN";
+  REMOVED: "REMOVED";
+}>;
+export type InventoryMovementKind = z.infer<typeof inventoryMovementKindSchema>;
+export declare const inventoryMovementSchema: z.ZodObject<{
+  movementId: z.ZodString;
+  seq: z.ZodNumber;
+  productId: z.ZodString;
+  variantId: z.ZodString;
+  inventoryLocationId: z.ZodString;
+  kind: z.ZodString;
+  delta: z.ZodNumber;
+  available: z.ZodNumber;
+  levelVersion: z.ZodNumber;
+  reason: z.ZodNullable<z.ZodString>;
+  note: z.ZodNullable<z.ZodString>;
+  refType: z.ZodNullable<z.ZodString>;
+  refId: z.ZodNullable<z.ZodString>;
+  operationId: z.ZodNullable<z.ZodString>;
+  actorType: z.ZodString;
+  actorId: z.ZodNullable<z.ZodString>;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+export type InventoryMovement = z.infer<typeof inventoryMovementSchema>;
+export declare const inventoryMovementListQuerySchema: z.ZodObject<{
+  inventoryLocationId: z.ZodOptional<z.ZodString>;
+  productId: z.ZodOptional<z.ZodString>;
+  variantId: z.ZodOptional<z.ZodString>;
+  kind: z.ZodOptional<z.ZodEnum<{
+    SALE: "SALE";
+    OPENING: "OPENING";
+    RESTORE: "RESTORE";
+    REVERT: "REVERT";
+    EXCHANGE_OUT: "EXCHANGE_OUT";
+    ADJUST: "ADJUST";
+    COUNT: "COUNT";
+    TRANSFER_OUT: "TRANSFER_OUT";
+    TRANSFER_IN: "TRANSFER_IN";
+    REMOVED: "REMOVED";
+  }>>;
+  after: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+  from: z.ZodOptional<z.ZodString>;
+  to: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type InventoryMovementListQuery = z.infer<typeof inventoryMovementListQuerySchema>;
+export declare const inventoryMovementPageSchema: z.ZodObject<{
+  contents: z.ZodArray<z.ZodObject<{
+    movementId: z.ZodString;
+    seq: z.ZodNumber;
+    productId: z.ZodString;
+    variantId: z.ZodString;
+    inventoryLocationId: z.ZodString;
+    kind: z.ZodString;
+    delta: z.ZodNumber;
+    available: z.ZodNumber;
+    levelVersion: z.ZodNumber;
+    reason: z.ZodNullable<z.ZodString>;
+    note: z.ZodNullable<z.ZodString>;
+    refType: z.ZodNullable<z.ZodString>;
+    refId: z.ZodNullable<z.ZodString>;
+    operationId: z.ZodNullable<z.ZodString>;
+    actorType: z.ZodString;
+    actorId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+  }, z.core.$strip>>;
+  nextAfter: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type InventoryMovementPage = z.infer<typeof inventoryMovementPageSchema>;
+/** 한 요청의 줄 상한 — 30초 타임아웃·바인드 한도 */
+export declare const MAX_INVENTORY_OPERATION_LINES = 200;
+export declare const inventoryAdjustmentLineSchema: z.ZodObject<{
+  variantId: z.ZodString;
+  inventoryLocationId: z.ZodOptional<z.ZodString>;
+  delta: z.ZodOptional<z.ZodNumber>;
+  counted: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const inventoryAdjustmentRequestSchema: z.ZodObject<{
+  lines: z.ZodArray<z.ZodObject<{
+    variantId: z.ZodString;
+    inventoryLocationId: z.ZodOptional<z.ZodString>;
+    delta: z.ZodOptional<z.ZodNumber>;
+    counted: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>>;
+  reason: z.ZodOptional<z.ZodEnum<{
+    COUNT: "COUNT";
+    RECEIVED: "RECEIVED";
+    DAMAGED: "DAMAGED";
+    LOST: "LOST";
+    FOUND: "FOUND";
+    RETURN_RESTOCK: "RETURN_RESTOCK";
+    CORRECTION: "CORRECTION";
+  }>>;
+  note: z.ZodOptional<z.ZodString>;
+  reference: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type InventoryAdjustmentRequest = z.infer<typeof inventoryAdjustmentRequestSchema>;
+export declare const inventoryTransferRequestSchema: z.ZodObject<{
+  fromInventoryLocationId: z.ZodString;
+  toInventoryLocationId: z.ZodString;
+  lines: z.ZodArray<z.ZodObject<{
+    variantId: z.ZodString;
+    quantity: z.ZodNumber;
+  }, z.core.$strict>>;
+  note: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type InventoryTransferRequest = z.infer<typeof inventoryTransferRequestSchema>;
+export declare const inventoryOperationResultSchema: z.ZodObject<{
+  operationId: z.ZodString;
+  kind: z.ZodEnum<{
+    ADJUSTMENT: "ADJUSTMENT";
+    TRANSFER: "TRANSFER";
+  }>;
+  lines: z.ZodArray<z.ZodObject<{
+    variantId: z.ZodString;
+    inventoryLocationId: z.ZodString;
+    delta: z.ZodNumber;
+    available: z.ZodNumber;
+  }, z.core.$strip>>;
+  createdAt: z.ZodString;
+}, z.core.$strip>;
+export type InventoryOperationResult = z.infer<typeof inventoryOperationResultSchema>;
+/** 수거 완료의 재입고 지정(Q3) — 생략하면 조합은 할당 순서(교환 → 판매), 위치는 반품지에 연결된 위치 → 할당 위치다 */
+export declare const claimCollectCompleteRequestSchema: z.ZodObject<{
+  restock: z.ZodOptional<z.ZodObject<{
+    optionId: z.ZodOptional<z.ZodString>;
+    inventoryLocationId: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ClaimCollectCompleteRequest = z.infer<typeof claimCollectCompleteRequestSchema>;
+export declare const claimRedeliveryRequestSchema: z.ZodObject<{
+  carrierCode: z.ZodString;
+  trackingNumber: z.ZodString;
+  inventoryLocationId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ClaimRedeliveryRequest = z.infer<typeof claimRedeliveryRequestSchema>;
+//#endregion
 //#region src/schemas/login.d.ts
 /** 소셜 로그인 공급자 */
 export declare const loginProviderSchema: z.ZodEnum<{
@@ -7903,6 +8197,7 @@ export declare const eventTypeSchema: z.ZodEnum<{
   "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
   "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
   "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
+  "INVENTORY.CHANGED": "INVENTORY.CHANGED";
 }>;
 export type EventType = z.infer<typeof eventTypeSchema>;
 export declare const webhookStatusSchema: z.ZodEnum<{
@@ -7931,6 +8226,7 @@ export declare const webhookSchema: z.ZodObject<{
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
     "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
+    "INVENTORY.CHANGED": "INVENTORY.CHANGED";
   }>>;
   status: z.ZodEnum<{
     SUSPENDED: "SUSPENDED";
@@ -7963,6 +8259,7 @@ export declare const webhookCreatedSchema: z.ZodObject<{
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
     "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
+    "INVENTORY.CHANGED": "INVENTORY.CHANGED";
   }>>;
   status: z.ZodEnum<{
     SUSPENDED: "SUSPENDED";
@@ -8051,6 +8348,7 @@ export declare const webhookDeliverySchema: z.ZodObject<{
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
     "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
+    "INVENTORY.CHANGED": "INVENTORY.CHANGED";
   }>;
   url: z.ZodString;
   status: z.ZodEnum<{
@@ -8112,6 +8410,7 @@ export declare const webhookDeliveryDetailSchema: z.ZodObject<{
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
     "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
+    "INVENTORY.CHANGED": "INVENTORY.CHANGED";
   }>;
   url: z.ZodString;
   status: z.ZodEnum<{
@@ -8182,6 +8481,7 @@ export declare const webhookDeliveryListQuerySchema: z.ZodObject<{
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
     "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
+    "INVENTORY.CHANGED": "INVENTORY.CHANGED";
   }>>;
   resourceId: z.ZodOptional<z.ZodString>;
   limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
@@ -8211,6 +8511,7 @@ export declare const webhookTestRequestSchema: z.ZodObject<{
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
     "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
+    "INVENTORY.CHANGED": "INVENTORY.CHANGED";
   }>;
 }, z.core.$strip>;
 export type WebhookTestRequest = z.infer<typeof webhookTestRequestSchema>;
@@ -8260,6 +8561,7 @@ export declare const webhookRequestSchema: z.ZodObject<{
     "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
     "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
     "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
+    "INVENTORY.CHANGED": "INVENTORY.CHANGED";
   }>>;
 }, z.core.$strip>;
 export type WebhookRequest = z.infer<typeof webhookRequestSchema>;
@@ -10644,6 +10946,8 @@ export declare const updatePointPolicyRequestSchema: z.ZodObject<{
 export type UpdatePointPolicyRequest = z.infer<typeof updatePointPolicyRequestSchema>;
 /** 응답의 원장 유형 — 값이 추가될 수 있어 문자열로 받는다 */
 export declare const responsePointEntryTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
+  OPENING: "OPENING";
+  ADJUST: "ADJUST";
   EARN_REVIEW: "EARN_REVIEW";
   REVOKE_REVIEW: "REVOKE_REVIEW";
   EARN_PURCHASE: "EARN_PURCHASE";
@@ -10651,14 +10955,14 @@ export declare const responsePointEntryTypeSchema: z.ZodUnion<readonly [z.ZodEnu
   USE_RELEASE: "USE_RELEASE";
   REFUND_RESTORE: "REFUND_RESTORE";
   EXPIRE: "EXPIRE";
-  ADJUST: "ADJUST";
-  OPENING: "OPENING";
 }>, z.ZodString]>;
 /** 원장 항목 — 셀러 조회용(사유·행위자 포함) */
 export declare const pointEntrySchema: z.ZodObject<{
   entryId: z.ZodString;
   memberId: z.ZodString;
   type: z.ZodUnion<readonly [z.ZodEnum<{
+    OPENING: "OPENING";
+    ADJUST: "ADJUST";
     EARN_REVIEW: "EARN_REVIEW";
     REVOKE_REVIEW: "REVOKE_REVIEW";
     EARN_PURCHASE: "EARN_PURCHASE";
@@ -10666,8 +10970,6 @@ export declare const pointEntrySchema: z.ZodObject<{
     USE_RELEASE: "USE_RELEASE";
     REFUND_RESTORE: "REFUND_RESTORE";
     EXPIRE: "EXPIRE";
-    ADJUST: "ADJUST";
-    OPENING: "OPENING";
   }>, z.ZodString]>;
   amount: z.ZodNumber;
   balanceAfter: z.ZodNumber;
@@ -10682,9 +10984,9 @@ export type PointEntry = z.infer<typeof pointEntrySchema>;
 export declare const pointLotSchema: z.ZodObject<{
   lotId: z.ZodString;
   source: z.ZodUnion<readonly [z.ZodEnum<{
-    REFUND_RESTORE: "REFUND_RESTORE";
-    ADJUST: "ADJUST";
     OPENING: "OPENING";
+    ADJUST: "ADJUST";
+    REFUND_RESTORE: "REFUND_RESTORE";
     REVIEW: "REVIEW";
     PURCHASE: "PURCHASE";
   }>, z.ZodString]>;
@@ -10701,9 +11003,9 @@ export declare const customerPointsSchema: z.ZodObject<{
   lots: z.ZodArray<z.ZodObject<{
     lotId: z.ZodString;
     source: z.ZodUnion<readonly [z.ZodEnum<{
-      REFUND_RESTORE: "REFUND_RESTORE";
-      ADJUST: "ADJUST";
       OPENING: "OPENING";
+      ADJUST: "ADJUST";
+      REFUND_RESTORE: "REFUND_RESTORE";
       REVIEW: "REVIEW";
       PURCHASE: "PURCHASE";
     }>, z.ZodString]>;
@@ -10742,6 +11044,8 @@ export declare const pointAdjustmentResultSchema: z.ZodObject<{
     entryId: z.ZodString;
     memberId: z.ZodString;
     type: z.ZodUnion<readonly [z.ZodEnum<{
+      OPENING: "OPENING";
+      ADJUST: "ADJUST";
       EARN_REVIEW: "EARN_REVIEW";
       REVOKE_REVIEW: "REVOKE_REVIEW";
       EARN_PURCHASE: "EARN_PURCHASE";
@@ -10749,8 +11053,6 @@ export declare const pointAdjustmentResultSchema: z.ZodObject<{
       USE_RELEASE: "USE_RELEASE";
       REFUND_RESTORE: "REFUND_RESTORE";
       EXPIRE: "EXPIRE";
-      ADJUST: "ADJUST";
-      OPENING: "OPENING";
     }>, z.ZodString]>;
     amount: z.ZodNumber;
     balanceAfter: z.ZodNumber;
@@ -11613,9 +11915,9 @@ export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
 export declare const productSortSchema: z.ZodEnum<{
   "createdAt.desc": "createdAt.desc";
   "createdAt.asc": "createdAt.asc";
-  "updatedAt.desc": "updatedAt.desc";
   "salePrice.asc": "salePrice.asc";
   "salePrice.desc": "salePrice.desc";
+  "updatedAt.desc": "updatedAt.desc";
 }>;
 export type ProductSort = z.infer<typeof productSortSchema>;
 export interface ProductListParams extends PageParams {
@@ -11644,9 +11946,9 @@ export declare const productListQuerySchema: z.ZodObject<{
   sort: z.ZodOptional<z.ZodEnum<{
     "createdAt.desc": "createdAt.desc";
     "createdAt.asc": "createdAt.asc";
-    "updatedAt.desc": "updatedAt.desc";
     "salePrice.asc": "salePrice.asc";
     "salePrice.desc": "salePrice.desc";
+    "updatedAt.desc": "updatedAt.desc";
   }>>;
 }, z.core.$strip>;
 export declare const discountRequestSchema: z.ZodObject<{
@@ -12229,6 +12531,7 @@ export declare const sellerAddressSchema: z.ZodObject<{
   zipCode: z.ZodString;
   address1: z.ZodString;
   address2: z.ZodOptional<z.ZodString>;
+  inventoryLocationId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   createdAt: z.ZodString;
 }, z.core.$strip>;
 export type SellerAddress = z.infer<typeof sellerAddressSchema>;
@@ -12243,6 +12546,7 @@ export declare const sellerAddressRequestSchema: z.ZodObject<{
   zipCode: z.ZodString;
   address1: z.ZodString;
   address2: z.ZodOptional<z.ZodString>;
+  inventoryLocationId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
 //#endregion
@@ -16428,8 +16732,12 @@ export declare function createStoreClient(options: StoreClientOptions): {
       collectMethod: "SELLER_PICKUP" | "BUYER_SEND";
       carrierCode?: string;
     }) => Promise<void>;
-    completeCollect: (claimId: string) => Promise<void>;
-    registerRedelivery: (claimId: string, carrierCode: string, trackingNumber: string) => Promise<void>;
+    /** 수거 완료 — `restock`(이슈 #132)으로 돌아온 조합·재입고 위치를 지정한다. 생략하면 할당 순서·반품지 위치다 */
+    completeCollect: (claimId: string, body?: ClaimCollectCompleteRequest) => Promise<void>;
+    /** 교환 재배송 — `inventoryLocationId`(이슈 #132)로 교환품을 보낼 위치를 지정한다. 생략하면 그 상품의 기준 위치다 */
+    registerRedelivery: (claimId: string, carrierCode: string, trackingNumber: string, options?: {
+      inventoryLocationId?: string;
+    }) => Promise<void>;
     hold: (claimId: string, reason: string) => Promise<{
       claimId: string;
       holdExpiresAt: string;
@@ -19045,7 +19353,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         readme: string | null;
         supportEmail: string | null;
         scopes: string[];
-        events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+        events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
         networkHosts: string[];
         publicHttp: string[];
         schedules: {
@@ -19099,7 +19407,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         pendingVersionNumber: number | null;
         grantedScopes: string[];
         grantedNetworkHosts: string[];
-        events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+        events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
         adminPage: boolean;
         publicHttp: string[];
         schedules: {
@@ -19153,7 +19461,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           number: number;
           scopes: string[];
           networkHosts: string[];
-          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
           publicHttp: string[];
           schedules: {
             name: string;
@@ -19186,7 +19494,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         pendingVersionNumber: number | null;
         grantedScopes: string[];
         grantedNetworkHosts: string[];
-        events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+        events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
         adminPage: boolean;
         publicHttp: string[];
         schedules: {
@@ -19240,7 +19548,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           number: number;
           scopes: string[];
           networkHosts: string[];
-          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
           publicHttp: string[];
           schedules: {
             name: string;
@@ -19273,7 +19581,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         pendingVersionNumber: number | null;
         grantedScopes: string[];
         grantedNetworkHosts: string[];
-        events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+        events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
         adminPage: boolean;
         publicHttp: string[];
         schedules: {
@@ -19327,7 +19635,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           number: number;
           scopes: string[];
           networkHosts: string[];
-          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
           publicHttp: string[];
           schedules: {
             name: string;
@@ -19361,7 +19669,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         pendingVersionNumber: number | null;
         grantedScopes: string[];
         grantedNetworkHosts: string[];
-        events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+        events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
         adminPage: boolean;
         publicHttp: string[];
         schedules: {
@@ -19415,7 +19723,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           number: number;
           scopes: string[];
           networkHosts: string[];
-          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
           publicHttp: string[];
           schedules: {
             name: string;
@@ -19464,7 +19772,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         pendingVersionNumber: number | null;
         grantedScopes: string[];
         grantedNetworkHosts: string[];
-        events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+        events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
         adminPage: boolean;
         publicHttp: string[];
         schedules: {
@@ -19518,7 +19826,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           number: number;
           scopes: string[];
           networkHosts: string[];
-          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
           publicHttp: string[];
           schedules: {
             name: string;
@@ -19574,7 +19882,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     list: () => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -19584,7 +19892,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     create: (body: WebhookRequest) => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -19594,7 +19902,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     get: (webhookId: string) => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -19604,7 +19912,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     update: (webhookId: string, body: WebhookRequest) => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -19619,7 +19927,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     resume: (webhookId: string) => Promise<{
       webhookId: string;
       url: string;
-      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED")[];
+      eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED")[];
       status: "SUSPENDED" | "ACTIVE";
       secretPrefix: string;
       suspendedAt: string | null;
@@ -19629,7 +19937,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     listDeliveries: (webhookId: string, params?: WebhookDeliveryListParams) => Promise<{
       deliveryId: string;
       eventId: string;
-      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED";
+      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -19656,7 +19964,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     getDelivery: (webhookId: string, deliveryId: string) => Promise<{
       deliveryId: string;
       eventId: string;
-      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED";
+      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -19691,7 +19999,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     redeliver: (webhookId: string, deliveryId: string) => Promise<{
       deliveryId: string;
       eventId: string;
-      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED";
+      eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "INVENTORY.CHANGED";
       url: string;
       status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
       responseStatusCode: number | null;
@@ -20071,6 +20379,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       address1: string;
       createdAt: string;
       address2?: string | undefined;
+      inventoryLocationId?: string | null | undefined;
     }[]>;
     create: (body: SellerAddressRequest) => Promise<void>;
     update: (addressId: string, body: SellerAddressRequest) => Promise<void>;
@@ -20078,6 +20387,98 @@ export declare function createStoreClient(options: StoreClientOptions): {
     setDefault: (addressId: string) => Promise<void>;
   };
   /** 픽업 장소 (이슈 #115) — 방문 수령 주문의 수령 장소. 조회 `store:r`, 쓰기 `store:rw`(상점 플랫폼 OWNER·ADMIN) */
+  /**
+   * 위치별 재고 (이슈 #132) — 재고 위치·위치별 가용 재고·재고 조정·실사·이동·변동 내역. 위치 쓰기는 상점 설정 표면(상점 플랫폼 OWNER·ADMIN)이고
+   * 조회는 `inventory:r`, 조정·이동은 `inventory:rw`다. 같은 `idempotencyKey`로 다시 보내면 첫 결과를 돌려준다(다른 본문이면 409)
+   */
+  inventory: {
+    locations: {
+      list: () => Promise<{
+        inventoryLocationId: string;
+        name: string;
+        isDefault: boolean;
+        sortOrder: number;
+        createdAt: string;
+        updatedAt: string;
+      }[]>;
+      create: (body: InventoryLocationRequest) => Promise<{
+        inventoryLocationId: string;
+        name: string;
+        isDefault: boolean;
+        sortOrder: number;
+        createdAt: string;
+        updatedAt: string;
+      }>;
+      update: (inventoryLocationId: string, body: InventoryLocationRequest) => Promise<{
+        inventoryLocationId: string;
+        name: string;
+        isDefault: boolean;
+        sortOrder: number;
+        createdAt: string;
+        updatedAt: string;
+      }>;
+      remove: (inventoryLocationId: string) => Promise<void>;
+    };
+    /** 커서 페이지네이션 — 다음 페이지는 응답의 `nextCursor`를 `cursor`로 넘긴다 */
+    levels: (params?: InventoryLevelListQuery) => Promise<{
+      contents: {
+        productId: string;
+        variantId: string;
+        inventoryLocationId: string;
+        available: number;
+        pendingFulfillment: number;
+        onHand: number;
+        version: number;
+        updatedAt: string;
+      }[];
+      nextCursor: string | null;
+    }>;
+    /** 순번 오름차순 — 다음 쪽은 `nextAfter`를 `after`로 넘긴다 */
+    movements: (params?: InventoryMovementListQuery) => Promise<{
+      contents: {
+        movementId: string;
+        seq: number;
+        productId: string;
+        variantId: string;
+        inventoryLocationId: string;
+        kind: string;
+        delta: number;
+        available: number;
+        levelVersion: number;
+        reason: string | null;
+        note: string | null;
+        refType: string | null;
+        refId: string | null;
+        operationId: string | null;
+        actorType: string;
+        actorId: string | null;
+        createdAt: string;
+      }[];
+      nextAfter: number | null;
+    }>;
+    adjust: (body: InventoryAdjustmentRequest, idempotencyKey?: string) => Promise<{
+      operationId: string;
+      kind: "ADJUSTMENT" | "TRANSFER";
+      lines: {
+        variantId: string;
+        inventoryLocationId: string;
+        delta: number;
+        available: number;
+      }[];
+      createdAt: string;
+    }>;
+    transfer: (body: InventoryTransferRequest, idempotencyKey?: string) => Promise<{
+      operationId: string;
+      kind: "ADJUSTMENT" | "TRANSFER";
+      lines: {
+        variantId: string;
+        inventoryLocationId: string;
+        delta: number;
+        available: number;
+      }[];
+      createdAt: string;
+    }>;
+  };
   pickupLocations: {
     list: () => Promise<{
       locationId: string;
@@ -20088,6 +20489,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       usable: boolean;
       sortOrder: number;
       createdAt: string;
+      inventoryLocationId?: string | null | undefined;
     }[]>;
     create: (body: PickupLocationRequestInput) => Promise<{
       locationId: string;
@@ -20098,6 +20500,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       usable: boolean;
       sortOrder: number;
       createdAt: string;
+      inventoryLocationId?: string | null | undefined;
     }>;
     update: (locationId: string, body: PickupLocationRequestInput) => Promise<{
       locationId: string;
@@ -20108,6 +20511,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       usable: boolean;
       sortOrder: number;
       createdAt: string;
+      inventoryLocationId?: string | null | undefined;
     }>;
     remove: (locationId: string) => Promise<void>;
   };
@@ -22447,6 +22851,7 @@ export declare const STORE_SCOPE_RESOURCES: {
   readonly promotion: readonly ["r", "rw"];
   readonly storefront: readonly ["r", "rw"];
   readonly flow: readonly ["r", "rw"];
+  readonly inventory: readonly ["r", "rw"];
 };
 export type StoreScopeResource = keyof typeof STORE_SCOPE_RESOURCES;
 export declare const storeScopeResourceSchema: z.ZodEnum<{
@@ -22466,6 +22871,7 @@ export declare const storeScopeResourceSchema: z.ZodEnum<{
   customer: "customer";
   audit: "audit";
   promotion: "promotion";
+  inventory: "inventory";
 }>;
 /** 카탈로그상 존재하는 스코프 문자열인가 (예: `settlement:rw`는 false) */
 export declare function isStoreScope(scope: string): boolean;
@@ -22474,9 +22880,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", "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"];
+  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", "inventory: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", "inventory:rw"];
+  readonly STAFF: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "customer:r", "promotion:r", "flow:r", "inventory:rw"];
 };
 //#endregion
 //#region src/schemas/scope-descriptions.d.ts