@sayren/store-sdk 0.37.2 → 0.39.0

package/dist/index.mjs

@@ -1237,7 +1237,7 @@ const remoteAreaSchema = z.enum([
 * 도로명주소·건물관리번호 단위 판정은 후속 과제다.
 *
 * 범위는 **닫힌 구간**(`from` ≤ zip ≤ `to`)이고 겹치지 않는다. 앞에서부터 처음 맞는 항목을 쓴다.
-* 순서는 상점 플랫폼 「추가 배송비 지역」 표의 행 순서이기도 하다(`remoteAreaGroups`). 제주를 먼저 두고
+* 순서는 docs `guides/shipping-fees.mdx` 「제주·도서산간 추가 배송비」 표의 행 순서이기도 하다. 제주를 먼저 두고
 * 도서산간은 우편번호 오름차순으로 둔다.
 */
 const REMOTE_AREA_ZIP_RANGES = [
@@ -2026,6 +2026,7 @@ const storefrontVersionSchema = z.object({
 	createdVia: z.string().nullable().optional().describe("만든 경로 (`CONSOLE` 상점 플랫폼 · `AI` AI 에이전트(MCP) · `CLI` `sayren` CLI · `API` 관리 API · `SYSTEM` 자동 · `GIT` 연결한 저장소 push). 늘어날 수 있다"),
 	gitRef: z.string().nullable().optional().describe("연결한 저장소의 push로 만든 버전의 브랜치. 그 밖은 null"),
 	commitSha: z.string().nullable().optional().describe("이 버전 소스를 담은 저장소 커밋(Git 원천 사이트). 저장소에 없는 버전은 null"),
+	excludedPaths: z.array(z.string()).nullable().optional().describe("저장소 push로 만든 버전에서 경로 규칙 밖이라 빼고 배포한 파일(`.env`·서버 코드 등, 앞 20개). README·`.github/` 같은 저장소 관리 파일은 싣지 않는다. 없으면 null"),
 	mainChanged: z.boolean().optional().describe("이 버전을 만든 뒤 운영 브랜치가 바뀌어 발행할 수 없다(발행하면 409 `STOREFRONT_MAIN_CHANGED`). 최신 운영 브랜치를 합친 버전을 만든다. 버전 목록에만 싣는다"),
 	buildCanceled: z.boolean().optional().describe("같은 브랜치의 새 push가 이 버전의 빌드를 끊었다(`status`는 `FAILED`, 빌드 `errorCode` `BUILD_CANCELED`). 버전 목록에만 싣는다"),
 	createdAt: z.string().describe("만든 시각 (ISO 8601)"),
@@ -2456,12 +2457,13 @@ const storefrontEditSessionStatusSchema = z.enum(["STARTING", "RUNNING"]).descri
 const STOREFRONT_EDIT_START_STAGES = [
 	"CONTAINER",
 	"RESTORE",
+	"INSTALL",
 	"DEV_SERVER"
 ];
 const storefrontEditSessionSchema = z.object({
 	sessionId: z.string(),
 	status: storefrontEditSessionStatusSchema,
-	startStage: z.string().nullable().describe("`STARTING`일 때 지금 단계 (`CONTAINER` 컨테이너 기동 · `RESTORE` 작업 트리 복원 · `DEV_SERVER` 개발 서버 기동). 늘어날 수 있다. `RUNNING`이면 null"),
+	startStage: z.string().nullable().describe("`STARTING`일 때 지금 단계 (`CONTAINER` 컨테이너 기동 · `RESTORE` 작업 트리 복원 · `INSTALL` 의존성 설치(`pnpm-lock.yaml`이 템플릿과 다를 때만) · `DEV_SERVER` 개발 서버 기동). 늘어날 수 있다. `RUNNING`이면 null"),
 	startedAt: z.string().describe("연 시각 (ISO 8601)"),
 	lastEditedAt: z.string().nullable().describe("이 편집 환경에서 마지막으로 파일을 바꾼 시각. 없으면 null"),
 	lastActiveAt: z.string().describe("마지막 활동 시각 (파일 도구·검사·미리보기)"),
@@ -2473,6 +2475,24 @@ const storefrontEditSessionSchema = z.object({
 * `GET /v1/storefront/site/editing/logs?lines=` — 편집 환경 dev 서버 로그의 끝부분(2026-10-14). 컴파일 오류·HMR 실패를 바로 읽는다.
 * 편집 환경이 켜져 있지 않으면 409 `EDIT_SESSION_REQUIRED`
 */
+/** `POST /v1/storefront/site/editing/git/merge` — 켜진 편집 환경 작업 트리에 운영 브랜치 최신 커밋을 합친다(#138, Git 원천 사이트) */
+const storefrontGitMergeRequestSchema = z.object({ action: z.enum([
+	"merge",
+	"continue",
+	"abort"
+]).default("merge").describe("`merge` 최신 운영 브랜치를 합친다 · `continue` 충돌 표시를 고친 뒤 합치기를 끝낸다 · `abort` 합치기를 취소하고 합치기 전으로 돌린다") });
+const storefrontGitMergeSchema = z.object({
+	status: z.enum([
+		"MERGED",
+		"UP_TO_DATE",
+		"CONFLICT",
+		"COMMITTED",
+		"ABORTED"
+	]).describe("`MERGED` 합쳤다 · `UP_TO_DATE` 이미 최신이다 · `CONFLICT` 충돌 — `conflicts`의 파일에서 충돌 표시(`<<<<<<<`·`>>>>>>>`)를 고친 뒤 `continue` · `COMMITTED` 충돌을 고쳐 합치기를 끝냈다 · `ABORTED` 취소했다"),
+	conflicts: z.array(z.string()).describe("충돌한 파일(`CONFLICT`일 때). 그 밖은 빈 배열"),
+	mainChanged: z.boolean().describe("합친 뒤에도 발행 전 작업이 지금 운영 브랜치 위가 아니다(충돌·취소면 true). false면 버전을 만들어 발행할 수 있다"),
+	dependenciesChanged: z.boolean().optional().describe("합친 운영 브랜치가 `package.json`·`pnpm-lock.yaml`을 바꿔 의존성을 다시 검사하고 편집 환경을 다시 띄웠다(`STARTING`, 설치가 실패하면 편집 상태 `lastFailure`)")
+});
 const storefrontDevLogsSchema = z.object({
 	stdout: z.string(),
 	stderr: z.string(),
@@ -2485,6 +2505,16 @@ const storefrontDevLogsSchema = z.object({
 	})).default([]).describe("편집 미리보기를 연 브라우저의 오류·경고(window 오류, 처리되지 않은 Promise 거부, console.error·warn) 최근 100건. 미리보기를 열어 둔 동안만 모인다"),
 	at: z.string()
 });
+/**
+* 편집 환경 시작 실패(#125) — 작업 트리 `pnpm-lock.yaml`이 템플릿과 다르면 편집 환경은 빌드와 같은 의존성 정책으로 설치한 뒤 개발 서버를
+* 띄운다. 설치가 실패하면 미리보기 대신 이 원인이 남는다
+*/
+const storefrontEditFailureSchema = z.object({
+	code: z.string().describe("실패 코드 (`INSTALL_FAILED` 설치 실패 · `INSTALL_TOO_LARGE` 설치 크기 상한 초과 · `DEPENDENCIES_CHANGED` 검사 뒤 의존성 파일이 바뀜 · `DEPENDENCIES_UNCHECKED` 의존성 검사 없음 · `START_TIMEOUT`·`CAPACITY_EXHAUSTED`·`CONTAINER_ERROR`·`RESTART_FAILED` 등, 늘어날 수 있다)"),
+	message: z.string().describe("사용자용 안내"),
+	logTail: z.string().nullable().describe("설치 출력 끝부분(레지스트리가 거절한 요청 포함). 설치 단계 실패가 아니면 null"),
+	failedAt: z.string().nullable().describe("닫힌 시각 (ISO 8601)")
+});
 const storefrontEditingSchema = z.object({
 	enabled: z.boolean().describe("편집을 쓸 수 있는가 (Sandbox 설정)"),
 	session: storefrontEditSessionSchema.nullable().describe("열린 편집 환경. 잠들었거나 닫았으면 null"),
@@ -2496,7 +2526,8 @@ const storefrontEditingSchema = z.object({
 	workingTree: z.object({
 		modified: z.boolean().describe("템플릿에서 한 번이라도 고쳤는가 (사이트 `sourceMode`가 `CUSTOM`)"),
 		lastEditedAt: z.string().nullable().describe("마지막으로 파일을 바꾼 시각")
-	})
+	}),
+	lastFailure: storefrontEditFailureSchema.nullable().optional().describe("편집 환경이 꺼져 있고 마지막 편집 환경이 시작하지 못하고(또는 다시 띄우지 못하고) 닫혔으면 그 원인. 다시 켜면 사라진다. 없으면 null")
 });
 const storefrontFileEntrySchema = z.object({
 	path: z.string(),
@@ -2845,7 +2876,12 @@ const storefrontGitStatusSchema = z.object({
 	autoPromotePaused: z.boolean().describe("되돌린 상태 — 저장소 push는 빌드만 하고 운영을 바꾸지 않는다. 버전을 발행하면 다시 켜진다"),
 	publishPending: z.boolean().describe("발행한 버전을 운영 브랜치에 올리는 중"),
 	publishErrorCode: z.string().nullable().describe("마지막 발행을 운영 브랜치에 올리지 못한 이유(브랜치 보호 등). 운영과 저장소가 다를 수 있다"),
-	archivedWorkRef: z.string().nullable().describe("셀러 저장소를 연결할 때 보관한 발행 전 작업 트리(연결 전 편집). 없으면 null")
+	archivedWorkRef: z.string().nullable().describe("셀러 저장소를 연결할 때 보관한 발행 전 작업 트리(연결 전 편집). 없으면 null"),
+	lastDisconnect: z.object({
+		reason: z.string().describe("`APP_UNINSTALLED` GitHub App 설치 삭제·정지 · `REPO_ACCESS_REMOVED` 설치에서 저장소 제외 · `STORE_TRANSFERRED` 상점 양도"),
+		repository: z.string().nullable().describe("연결이 끊긴 셀러 저장소(`owner/name`). 상점 양도면 이전 소유자의 저장소라 null"),
+		at: z.string().describe("끊긴 시각 (ISO 8601)")
+	}).nullish().describe("셀러 저장소 연결이 셀러의 해제 없이 끊겨 sayren 저장소로 돌아왔으면 그 까닭. 다시 연결하면 null")
 });
 const storefrontGitRepositorySchema = z.object({
 	repoId: z.number().int().describe("GitHub 저장소 id"),
@@ -5197,7 +5233,6 @@ const orderFulfilledWebhookEventDataSchema = z.object({
 	orderItemId: z.string().describe("제공한 주문상품 ID"),
 	status: orderItemStatusSchema.describe("이벤트 발생 시점의 주문 대표 상태"),
 	fulfillmentSnapshot: orderItemFulfillmentSnapshotResponseSchema.describe("제공한 주문상품의 주문 시점 이행 스냅샷(주문상품 응답의 `fulfillmentSnapshot`과 같다, 이슈 #57)"),
-	fulfillment: z.object({ mode: z.string() }).optional().describe("**Deprecated** — 항상 `{ mode: \"MANUAL\" }`이다. 자동 제공을 없앴고(이슈 #48) store-sdk 0.19 이하 호환으로만 싣는다. 게시된 연동이 store-sdk 0.20 이상으로 넘어간 뒤 다음 릴리스에서 뺀다"),
 	fulfilledAt: z.string().describe("제공 시각 (ISO 8601). 주문상품의 `deliveredAt`과 같다"),
 	currency: z.string().optional().describe("주문 통화(ISO 4217, 이슈 #130). 이 이벤트의 금액은 모두 이 통화의 최소 단위다. 외화 주문이 생기면 이 값을 확인한다. 이 필드가 없는 이전 이벤트는 KRW다"),
 	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았다")
@@ -7427,13 +7462,103 @@ const flowIssueSchema = z.object({
 	code: z.string(),
 	message: z.string(),
 	nodeId: z.string().optional(),
-	edgeId: z.string().optional()
+	edgeId: z.string().optional(),
+	pointer: z.string().optional().describe("위치(JSON Pointer) — 그래프 문서 안(`/nodes/3/config/buttons/0/key`). 조작 오류(`OP_*`)는 그 조작 안 위치"),
+	opIndex: z.number().int().optional().describe("조작 묶음에서 몇 번째 조작(0부터)에서 났는가"),
+	hint: z.string().optional().describe("고치는 법·후보(가능한 값·비슷한 이름)"),
+	expected: z.unknown().optional().describe("그 위치의 설정 형식(JSON Schema 조각)")
 });
 const commerceFlowCheckSchema = z.object({
 	publishable: z.boolean().describe("게시를 막는 오류(실행 불가·공개 계약·한도)가 없다"),
 	blocking: z.array(flowIssueSchema),
 	warnings: z.array(flowIssueSchema).describe("업무 논리 경고 — 게시를 막지 않는다")
 });
+/** JSON Pointer(`/`로 시작) */
+const flowPointerSchema = z.string().regex(/^\//, "JSON Pointer(/로 시작)여야 합니다");
+const flowPointerSetSchema = z.record(flowPointerSchema, z.unknown()).describe("JSON Pointer → 값. 그 위치의 값을 통째로 바꾼다(합치지 않는다). 배열(버튼 등)은 배열 전체를 넣는다");
+const flowPointerUnsetSchema = z.array(flowPointerSchema).describe("지울 위치(JSON Pointer) 목록");
+/** 흐름 노드 id — 영문으로 시작, 영문·숫자·_·- */
+const flowNodeIdSchema = z.string().regex(/^[A-Za-z][A-Za-z0-9_-]*$/, "노드 id는 영문으로 시작하고 영문·숫자·_·-만 씁니다");
+/**
+* 조작 하나(#120) — 원천은 여기 하나다(api 본문 검증과 flow-spec `applyFlowOps`가 같은 스키마를 쓴다). 모르는 키는 400이다
+* (지우고 성공하면 잘못 쓴 조작이 아무 일도 하지 않은 채 통과한다)
+*/
+const flowDraftOperationSchema = z.discriminatedUnion("op", [
+	z.strictObject({
+		op: z.literal("addNode"),
+		id: flowNodeIdSchema.describe("새 노드 id(영문으로 시작, 영문·숫자·_·-)"),
+		type: z.string().min(1).describe("노드 종류(`GET /flow-node-types/{type}`)"),
+		config: z.record(z.string(), z.unknown()).optional().describe("노드 설정"),
+		position: z.strictObject({
+			x: z.number(),
+			y: z.number()
+		}).optional().describe("없으면 서버가 앞 노드 오른쪽에 둔다")
+	}).describe("노드 더하기 — version·outputs는 서버가 채운다"),
+	z.strictObject({
+		op: z.literal("updateNode"),
+		id: z.string().min(1),
+		set: flowPointerSetSchema.optional().describe("`/config/…`·`/position` 아래만"),
+		unset: flowPointerUnsetSchema.optional()
+	}).describe("노드 고치기"),
+	z.strictObject({
+		op: z.literal("removeNode"),
+		id: z.string().min(1)
+	}).describe("노드 지우기 — 드나드는 연결선도 지운다. 시작 노드는 400(먼저 setStart)"),
+	z.strictObject({
+		op: z.literal("connect"),
+		id: z.string().min(1).optional().describe("연결선 id. 주면 같은 묶음의 updateEdge·disconnect가 가리킬 수 있다. 없으면 서버가 만든다"),
+		from: z.string().min(1).describe("`노드` 또는 `노드:출력`"),
+		to: z.string().min(1),
+		on: z.record(z.string(), z.unknown()).optional().describe("조건(트리거). 출력 연결선·즉시 노드에서는 두지 않는다"),
+		guard: z.string().optional().describe("조건식(CEL)"),
+		do: z.array(z.record(z.string(), z.unknown())).optional().describe("지날 때 실행할 블록")
+	}).describe("연결선 잇기"),
+	z.strictObject({
+		op: z.literal("updateEdge"),
+		id: z.string().min(1),
+		set: flowPointerSetSchema.optional().describe("`/from`·`/to`·`/on`·`/guard`·`/do` 아래만"),
+		unset: flowPointerUnsetSchema.optional()
+	}).describe("연결선 고치기"),
+	z.strictObject({
+		op: z.literal("disconnect"),
+		id: z.string().min(1)
+	}).describe("연결선 지우기"),
+	z.strictObject({
+		op: z.literal("setStart"),
+		id: z.string().min(1)
+	}).describe("시작 노드 바꾸기"),
+	z.strictObject({
+		op: z.literal("setDefinition"),
+		set: z.strictObject({
+			progression: z.enum(["ITEM", "ORDER_GROUP"]).optional(),
+			groupClaim: z.enum(["CONTINUE", "PAUSE"]).optional(),
+			fulfillmentMethods: z.array(z.enum([
+				"CARRIER",
+				"DIRECT",
+				"PICKUP",
+				"PROVIDED"
+			])).min(1).optional()
+		}).optional(),
+		unset: z.array(z.enum([
+			"progression",
+			"groupClaim",
+			"fulfillmentMethods"
+		])).optional()
+	}).describe("흐름 설정(진행 단위·묶음 클레임·이행 방식) 바꾸기")
+]);
+const applyFlowOperationsRequestSchema = z.object({ operations: z.array(flowDraftOperationSchema).min(1).describe("차례대로 적용한다. 묶음은 원자적이다 — 하나라도 형식이 틀리면 아무것도 바꾸지 않는다(400)") });
+const flowOperationsResultSchema = z.object({
+	revision: z.number().int().describe("저장 뒤 초안 revision — 다음 조작의 If-Match"),
+	changed: z.object({
+		nodes: z.array(z.string()).describe("더하거나 바꾼 노드"),
+		edges: z.array(z.string()).describe("더하거나 바꾼 연결선"),
+		removedNodes: z.array(z.string()),
+		removedEdges: z.array(z.string()).describe("지운 연결선(노드와 함께 지워진 것 포함)"),
+		removedActions: z.array(z.string()).describe("그래프에서 사라진 셀러·구매자 행동(`seller.action:CONFIRM_ORDER`). 셀러에게 확인받는다")
+	}),
+	issues: z.array(flowIssueSchema).describe("게시를 막는 문제. 저장은 됐다(초안은 미완성일 수 있다)"),
+	warnings: z.array(flowIssueSchema).describe("업무 논리 경고 — 게시를 막지 않는다")
+});
 const resolvedFlowSchema = z.object({
 	flowId: z.string(),
 	version: z.number().int(),
@@ -7530,6 +7655,48 @@ const replayFlowResultSchema = z.object({
 	divergedAt: z.number().int().nullable().describe("처음 갈라진 단계(steps 인덱스). 끝까지 같으면 null"),
 	unsupported: z.number().int().describe("재생할 수 없는 기록(상태 직접 이동·버전 옮기기·엔진 밖 취소) 수 — 그 앞까지만 돌린다")
 });
+const flowDraftRevisionSchema = z.number().int().describe("초안 revision — 조작의 If-Match 값. 초안이 없으면 게시 버전을 0으로 보여 준다(첫 쓰기가 초안을 연다)");
+const flowDraftNodesSchema = z.object({
+	revision: flowDraftRevisionSchema,
+	start: z.string().describe("시작 노드 id"),
+	nodes: z.array(z.object({
+		id: z.string(),
+		type: z.string(),
+		label: z.string().nullable().describe("셀러용 이름(`config.label.seller`). 없으면 null"),
+		kind: z.string().nullable().describe("start · state · wait · end · transient · call · fork · join (늘어날 수 있다). 모르는 종류면 null"),
+		outputs: z.array(z.string()).describe("출력 이름 — 연결선은 `노드:출력`으로 가리킨다. 없으면 `노드`로 가리킨다")
+	}))
+});
+const flowDraftNodeSchema = z.object({
+	revision: flowDraftRevisionSchema,
+	node: z.object({
+		id: z.string(),
+		type: z.string(),
+		version: z.number().int(),
+		config: z.record(z.string(), z.unknown()),
+		outputs: z.array(z.string()).optional(),
+		position: z.object({
+			x: z.number(),
+			y: z.number()
+		}).optional()
+	}).describe("노드 하나(설정 전체)"),
+	kind: z.string().nullable(),
+	outputs: z.array(z.string()).describe("설정에서 계산한 출력"),
+	start: z.boolean().describe("시작 노드인가"),
+	incoming: z.array(z.string()).describe("들어오는 연결선 id"),
+	outgoing: z.array(z.string()).describe("나가는 연결선 id")
+});
+const flowDraftEdgesSchema = z.object({
+	revision: flowDraftRevisionSchema,
+	edges: z.array(z.object({
+		id: z.string(),
+		from: z.string().describe("`노드` 또는 `노드:출력`"),
+		to: z.string(),
+		on: z.record(z.string(), z.unknown()).optional().describe("조건 — `type`: seller.action · buyer.action · event · timer · immediate"),
+		guard: z.string().optional().describe("조건식(CEL)"),
+		do: z.array(z.record(z.string(), z.unknown())).optional().describe("지날 때 실행할 블록")
+	}))
+});
 /** 노드·블록 종류 목록(#115) — 흐름을 API·AI로 짤 때 쓸 수 있는 종류와 설정 형식(JSON Schema) */
 const flowNodeTypesSchema = z.object({
 	nodes: z.array(z.object({
@@ -7560,6 +7727,67 @@ const flowNodeTypesSchema = z.object({
 		listed: z.boolean().describe("권한 표에 행으로 보인다")
 	})).optional().default([]).describe("노드 권한 표에 켤 수 있는 플랫폼 행동(#115) — 편집기는 이 목록으로 행을 그린다")
 });
+const flowAuthoringGuideSchema = z.object({
+	nodes: z.array(z.object({
+		type: z.string(),
+		name: z.string().describe("표시 이름"),
+		kind: z.string().describe("start · state · wait · end · transient · call · fork · join (늘어날 수 있다)"),
+		outputs: z.array(z.string()).nullable().describe("고정 출력. 설정에서 나오면 null"),
+		description: z.string()
+	})).describe("노드 종류 — 설정 형식은 `GET /flow-node-types/{type}`"),
+	blocks: z.array(z.object({
+		type: z.string(),
+		effect: z.string().describe("local · afterCommit · external"),
+		description: z.string()
+	})),
+	triggers: z.array(z.object({
+		type: z.string(),
+		format: z.string(),
+		description: z.string()
+	})).describe("연결선 조건(on) 형식"),
+	context: z.record(z.string(), z.string()).describe("식·안내문 틀이 읽을 수 있는 값 — 점 경로 → 타입(int·string·bool·timestamp·dyn …)"),
+	functions: z.array(z.object({
+		name: z.string(),
+		signature: z.string(),
+		doc: z.string()
+	})).describe("식 함수"),
+	templateFilters: z.array(z.string()).describe("안내문 틀 필터(`{{ 경로 | 필터 }}`)"),
+	rules: z.array(z.string()).describe("그래프 규칙"),
+	expressionExamples: z.array(z.object({
+		expr: z.string(),
+		description: z.string()
+	})),
+	operationExample: z.array(z.record(z.string(), z.unknown())).describe("조작 묶음 예시(`POST /commerce-flows/{flowId}/draft/operations`의 operations)")
+});
+const flowNodeTypeDetailSchema = z.object({
+	type: z.string(),
+	category: z.string().describe("node · block"),
+	version: z.number().int().describe("최신 버전 — 조작이 노드를 더할 때 이 버전을 쓴다"),
+	kind: z.string().nullable().describe("노드 성격(블록은 null)"),
+	effect: z.string().nullable().describe("블록 실행 성격(노드는 null)"),
+	outputs: z.array(z.string()).nullable().describe("고정 출력. 설정에서 나오면 null"),
+	name: z.string(),
+	description: z.string(),
+	configSchema: z.record(z.string(), z.unknown()).nullable().describe("설정 형식(JSON Schema). 공통 설정(이름·권한·입력 칸·식 참조)은 `$defs`. 옮길 수 없으면 null"),
+	example: z.record(z.string(), z.unknown()).describe("검사를 통과하는 예시 설정")
+});
+const flowEditSessionViewSchema = z.object({
+	revision: z.number().int().describe("지금 초안 revision(초안이 없으면 0)"),
+	session: z.object({
+		holder: z.object({
+			kind: z.string().describe("USER 사람 · AI_ASSISTANT AI 도우미 · AGENT 외부 에이전트 (늘어날 수 있다)"),
+			name: z.string().nullable()
+		}),
+		expiresAt: z.string().describe("이때까지 연장하지 않으면 풀린다(ISO 8601)"),
+		mine: z.boolean().describe("요청한 주체의 편집권인가")
+	}).nullable().describe("지금 편집권. 비어 있으면 null — 누구든 첫 쓰기가 잡는다"),
+	channel: z.object({
+		streamId: z.string(),
+		streamUrl: z.string(),
+		streamToken: z.string()
+	}).nullable().describe("흐름 채널 구독(SSE, `Authorization: Bearer streamToken`) — session·ops·saved·released 이벤트. 중계가 없는 환경이면 null")
+});
+const claimFlowEditSessionRequestSchema = z.object({ takeover: z.boolean().optional().describe("다른 주체가 잡고 있어도 넘겨받는다. 앞 주체의 저장하지 않은 수정은 사라지고, AI 도우미면 그 실행이 멈춘다") });
 //#endregion
 //#region src/schemas/promotion.ts
 /**
@@ -9314,8 +9542,7 @@ const shippingAddressSchema = z.object({
 const orderItemFulfillmentSchema = z.object({
 	status: z.string().describe("제공 상태. `FULFILLED`(제공함)·`REVOKED`(전량 취소·환불로 회수함). 값이 추가될 수 있어 문자열로 받는다"),
 	fulfilledAt: z.string().describe("제공 시각 (ISO 8601)"),
-	note: z.string().nullable().describe("셀러가 제공 처리 때 남긴 이용 안내. 없으면 null"),
-	mode: z.string().optional().describe("**Deprecated** — 항상 `MANUAL`이다. 자동 제공을 없앴고(이슈 #48) store-sdk 0.19 이하 호환으로만 싣는다. 게시된 연동이 store-sdk 0.20 이상으로 넘어간 뒤 다음 릴리스에서 뺀다")
+	note: z.string().nullable().describe("셀러가 제공 처리 때 남긴 이용 안내. 없으면 null")
 });
 const orderItemSchema = z.object({
 	orderItemId: z.string(),
@@ -10495,7 +10722,37 @@ function createStoreClient(options) {
 			/** `POST /commerce-flows/{id}/draft/replay` — 실제 주문상품의 실행 기록을 초안으로 다시 돌려 갈라지는 곳을 찾는다 */
 			replay: (flowId, body) => storeHttp.request("POST", path`/commerce-flows/${flowId}/draft/replay`, replayFlowResultSchema, { body: replayFlowRequestSchema.parse(body) }),
 			/** `GET /flow-node-types` — 쓸 수 있는 노드·블록 종류와 설정 형식(JSON Schema) */
-			nodeTypes: () => storeHttp.request("GET", "/flow-node-types", flowNodeTypesSchema)
+			nodeTypes: () => storeHttp.request("GET", "/flow-node-types", flowNodeTypesSchema),
+			/**
+			* `GET /flow-authoring-guide` — 흐름 작성 안내(#120): 노드·블록 목록, 연결선 조건 형식, 식 컨텍스트·함수, 규칙, 조작 예시.
+			* 순서: 안내 → `draftNodes`·`draftEdges` → 고칠 노드만 `draftNode` → 새로 쓸 종류만 `nodeType` → `applyOperations`
+			*/
+			authoringGuide: () => storeHttp.request("GET", "/flow-authoring-guide", flowAuthoringGuideSchema),
+			/** `GET /flow-node-types/{type}` — 노드·블록 종류 하나의 설정 형식(공통 설정은 `$defs`)과 예시. 없으면 404 `FLOW_NODE_TYPE_NOT_FOUND` */
+			nodeType: (type) => storeHttp.request("GET", path`/flow-node-types/${type}`, flowNodeTypeDetailSchema),
+			/** `GET /commerce-flows/{id}/draft/nodes` — 초안 노드 목록(설정 없음)과 `revision`. 초안이 없으면 게시 버전을 revision 0으로 */
+			draftNodes: (flowId) => storeHttp.request("GET", path`/commerce-flows/${flowId}/draft/nodes`, flowDraftNodesSchema),
+			/** `GET /commerce-flows/{id}/draft/nodes/{nodeId}` — 노드 하나의 설정 전체와 드나드는 연결선. 없으면 404 `FLOW_NODE_NOT_FOUND` */
+			draftNode: (flowId, nodeId) => storeHttp.request("GET", path`/commerce-flows/${flowId}/draft/nodes/${nodeId}`, flowDraftNodeSchema),
+			/** `GET /commerce-flows/{id}/draft/edges` — 초안 연결선 목록과 `revision` */
+			draftEdges: (flowId) => storeHttp.request("GET", path`/commerce-flows/${flowId}/draft/edges`, flowDraftEdgesSchema),
+			/** `GET /commerce-flows/{id}/draft/edit-session` — 편집권(누가 고치는 중인지)과 흐름 채널 구독 정보(#120) */
+			editSession: (flowId) => storeHttp.request("GET", path`/commerce-flows/${flowId}/draft/edit-session`, flowEditSessionViewSchema),
+			/**
+			* `POST /commerce-flows/{id}/draft/edit-session` — 편집 시작·연장, `takeover`면 가져오기. 다른 주체가 잡고 있으면 423 `FLOW_DRAFT_LOCKED`
+			*/
+			claimEditSession: (flowId, body = {}) => storeHttp.request("POST", path`/commerce-flows/${flowId}/draft/edit-session`, flowEditSessionViewSchema, { body: claimFlowEditSessionRequestSchema.parse(body) }),
+			/** `DELETE /commerce-flows/{id}/draft/edit-session` — 편집 끝내기(자기 편집권만 놓는다) */
+			releaseEditSession: (flowId) => storeHttp.requestVoid("DELETE", path`/commerce-flows/${flowId}/draft/edit-session`),
+			/**
+			* `POST /commerce-flows/{id}/draft/operations` — 조작 묶음을 `revision`(If-Match) 위에 적용해 초안을 저장한다(원자적).
+			* 결과의 `issues`는 저장은 됐지만 게시를 막는 문제다. 에러: 400 `FLOW_OPERATION_INVALID`(`details.issues[].opIndex`·`pointer`, 저장 안 함) ·
+			* 409 `FLOW_REVISION_CONFLICT`(`details.currentRevision`, 다시 읽는다)
+			*/
+			applyOperations: (flowId, operations, revision) => storeHttp.request("POST", path`/commerce-flows/${flowId}/draft/operations`, flowOperationsResultSchema, {
+				body: applyFlowOperationsRequestSchema.parse({ operations }),
+				headers: { "if-match": String(revision) }
+			})
 		},
 		carriers: { list: () => storeHttp.request("GET", "/carriers", z.array(carrierSchema)) },
 		claims: {
@@ -11456,4 +11713,4 @@ function createStoreSession(options) {
 	};
 }
 //#endregion
-export { AI_AGENT_NOTES_DIR, AI_AGENT_PHASES, AI_DESIGN_BOARDS_MAX, AI_DESIGN_BOARD_FILE_PATTERN, AI_DESIGN_BOARD_KINDS, AI_DESIGN_CANVAS_PATH, AI_DESIGN_CONFIRM_APPROVE, AI_DESIGN_DIR, AI_DESIGN_VIEWPORTS, AI_MESSAGE_MAX_ATTACHMENTS, AI_MESSAGE_MAX_CHARS, AI_RUN_ACTIVE_STATUSES, AI_RUN_FILE_CHANGES_RETENTION_DAYS, AI_SETUP_CONFIRM_APPROVE, AI_TODOS_MAX, AI_TODO_STATUSES, APPROVAL_ALREADY_DECIDED_CODE, APPROVAL_REQUIRED_CODE, APP_CAPABILITIES, APP_DEPLOY_KEY_PATTERN, APP_DEPLOY_KEY_PREFIX, APP_EVENTS_MAX, APP_EVENT_SCOPES, APP_EVENT_TYPES, APP_FLOW_EVENT_PATTERN, APP_FLOW_ITEMS_MAX, APP_FLOW_NOTIFICATION_PATTERN, APP_HANDLE_PATTERN, APP_HTTP_KEY_PATTERN, APP_ICON_CONTENT_TYPES, APP_ICON_MAX_BYTES, APP_ICON_MIN_PX, APP_LIFECYCLE_EVENT_TYPES, APP_NETWORK_DENIED_SUFFIXES, APP_NETWORK_HOSTS_MAX, APP_PUBLIC_HTTP_MAX, APP_README_MAX_BYTES, APP_RESERVED_HANDLES, APP_SCHEDULES_MAX, APP_SCHEDULE_INTERVALS, APP_SCHEDULE_NAME_PATTERN, APP_SECRETS_MAX, APP_SECRET_NAME_PATTERN, APP_SECRET_PATTERNS, APP_SERVER_BUNDLE_MAX_GZIP_BYTES, APP_SETTINGS_MAX_FIELDS, APP_SETTING_FIELD_TYPES, APP_SETTING_KEY_PATTERN, APP_STORAGE_KEY_PATTERN, APP_STORAGE_MAX_BYTES, APP_STORAGE_MAX_KEYS, APP_TOOL_NAME_PATTERN, APP_UI_MAX_BYTES, APP_UI_MAX_FILES, ApiError, ApprovalPendingError, BASE_CURRENCY, BRAND_BRIEF_MAX_REFERENCES, BUSINESS_INFO_MAX_LENGTH, BUSINESS_NUMBER_PATTERN, CASH_RECEIPT_STATUS_VALUES, CERTIFICATION_STATUSES, COLLECTION_BEST_SELLING_DAYS, COLLECTION_PREVIEW_SIZE, COLLECTION_PRODUCT_SORTS, COLLECTION_SALES_SORT_DEFAULT_DAYS, COLLECTION_SLUG_PATTERN, COLLECTION_TYPES, COUPON_CODE_PATTERN, COUPON_CONDITIONS_DEFAULTS, COUPON_TARGET_ALL, COUPON_TARGET_LIST_MAX, CURRENCIES, CURRENCY_CODES, CUSTOM_INPUT_FORBIDDEN_WORDS, CUSTOM_INPUT_TYPES, DEDICATED_EASY_PAY_PROVIDER, DEFAULT_STORE_LOCALE, FULFILLMENT_METHODS, FULFILLMENT_METHODS_BY_TYPE, FULFILLMENT_METHOD_RULES, FULFILLMENT_RULES, INSTALLABLE_SCOPES, InvalidPriceUnitError, KAKAOPAY_TEST_CID, KNOWN_WEBHOOK_EVENT_TYPES, KRW_MONEY_RULES, MAX_ADDON_GROUPS, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_CALENDAR_DAYS, MAX_CERTIFICATION_ITEMS, MAX_COLLECTIONS, MAX_COLLECTION_BEST_SELLING_TOP, MAX_COLLECTION_CREATED_WITHIN_DAYS, MAX_COLLECTION_DESCRIPTION, MAX_COLLECTION_PRODUCTS, MAX_COLLECTION_PRODUCTS_PER_ADD, MAX_COLLECTION_RULES, MAX_COLLECTION_RULE_CATEGORIES, MAX_COLLECTION_TITLE, MAX_CUSTOM_INPUTS, MAX_CUSTOM_INPUT_LENGTH, MAX_INFO_SECTION_TITLE, MAX_INVENTORY_OPERATION_LINES, MAX_NOTICE_VALUE_LENGTH, MAX_OPTION_GROUPS, MAX_PICKUP_LOCATIONS, MAX_PRODUCT_IMAGES, MAX_PRODUCT_INFO_SECTIONS, MAX_SAVED_OPTION_SETS, MAX_SAVED_OPTION_SET_NAME, MAX_STAY_NIGHTS, MAX_VALUES_PER_GROUP, MAX_VARIANTS, MCP_TELEMETRY_MAX_RESULTS, MIN_PAYMENT_AMOUNT, NON_INSTALLABLE_SCOPES, NO_COUPON_SETTLEMENT, NO_SHIPPING_BUNDLE_KEY, PAYMENT_ROUTING_EXCLUSION_CODES, PAYPAL_CURRENCIES, PLATFORM_CODE_SETS, POINT_ADJUSTMENT_MAX, POINT_EARN_RATE_BP_MAX, POINT_ENTRY_TYPES, POINT_EXPIRY_DAYS_MAX, POINT_EXPIRY_DAYS_MIN, POINT_LOT_SOURCES, POINT_POLICY_DEFAULTS, POINT_REVIEW_REWARD_MAX, POINT_USE_UNITS, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, REFUND_POLICY_DEFAULTS, REFUND_POLICY_DELIVERY_FEE_KEYS, REMOTE_AREA_ZIP_RANGES, RESERVED_STOREFRONT_SLUGS, RESERVED_STORE_CODES, SCOPE_DESCRIPTIONS, SHIPPING_POLICY_DEFAULTS, STARTER_SELLER_TASKS, STARTER_STAGES, STOREFRONT_BLOCKED_PATH_SEGMENTS, STOREFRONT_BUILD_STAGES, STOREFRONT_BUILD_TERMINAL_STATUSES, STOREFRONT_CHECK_TERMINAL_STATUSES, STOREFRONT_CLOSED_SITE_HOLD_DAYS, STOREFRONT_CUSTOM_DOMAIN_LIMIT_DEFAULT, STOREFRONT_DOMAIN_DNS_GRACE_DAYS, STOREFRONT_DOMAIN_DNS_WAIT_DAYS, STOREFRONT_DOMAIN_TXT_LABEL, STOREFRONT_EDIT_ACTIVITY_TIMEOUT_MINUTES, STOREFRONT_EDIT_CAPACITY, STOREFRONT_EDIT_IDLE_MINUTES, STOREFRONT_EDIT_PREVIEW_SUFFIX, STOREFRONT_EDIT_START_STAGES, STOREFRONT_FILE_BATCH_MAX, STOREFRONT_FILE_MAX_BYTES, STOREFRONT_PATH_SEGMENT_PATTERN, STOREFRONT_PLATFORM_DOMAINS, STOREFRONT_PUBLIC_SUFFIXES, STOREFRONT_SEARCH_REGEX_MAX_LENGTH, STOREFRONT_SHOWCASE_SLUG_PREFIX, STOREFRONT_SITE_CREATE_LIMIT, STOREFRONT_SLUG_CHANGE_LIMIT, STOREFRONT_SLUG_CHANGE_WINDOW_DAYS, STOREFRONT_SLUG_HOLD_DAYS, STOREFRONT_SLUG_PATTERN, STOREFRONT_SOURCE_BLOB_BATCH_MAX, STOREFRONT_SOURCE_PART_BYTES, STOREFRONT_WORKSPACE_MAX_BYTES, STOREFRONT_WORKSPACE_MAX_FILES, STORE_CODE_PATTERN, STORE_DRAFT_ATTACHMENT_MAX_BYTES, STORE_DRAFT_MAX_ATTACHMENTS, STORE_DRAFT_RETENTION_DAYS, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, STORE_SHOP_TYPES, TEMPLATE_STORE_LOCKED_BUSINESS_FIELDS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, UPLOAD_PURPOSE_LIMITS, VARIANT_COUNT_WARNING, VARIANT_STOCK_EXCLUSIVE_MESSAGE, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_FAILURE_REASONS, WEBHOOK_HEADERS, WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES, WEBHOOK_RESOURCE_TYPES, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, addStorefrontDomainRequestSchema, additionalCurrencyPriceSchema, additionalCurrencyPricesSchema, addonGroupRequestSchema, addonGroupSchema, addonValueRequestSchema, addonValueSchema, addressChangeRequestListSchema, addressTypeSchema, agentPolicyDecisionSchema, aiActivitySchema, aiAgentPhaseSchema, aiAttachmentSchema, aiChoiceOptionSchema, aiConversationFileChangesSchema, aiConversationSchema, aiConversationSummarySchema, aiDesignBoardSchema, aiDesignCanvasSchema, aiDesignConfirmBoardSchema, aiDesignSelectionSchema, aiFileChangeKindSchema, aiFocusAreaSchema, aiFocusSchema, aiMessagePartSchema, aiMessageSchema, aiPreviewSelectionSchema, aiRunChangesSchema, aiRunChangesStatusSchema, aiRunFileDiffSchema, aiRunRevertConflictDetailsSchema, aiRunRevertResultSchema, aiRunSchema, aiRunStatusSchema, aiSetupConfirmItemSchema, aiStreamAccessSchema, aiStreamEventSchema, aiStreamRecordSchema, aiTodoSchema, aiToolChangeSchema, allocateByWeight, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, appArtifactUploadSchema, appBuildSchema, appBuildStageSchema, appCapabilitiesOf, appDeployKeyCreateSchema, appDeployKeyCreatedSchema, appDeployKeySchema, appDevTokenSchema, appDistributionSchema, appEventTypeSchema, appFlowEventSchema, appFlowEventSummarySchema, appFlowNotificationSchema, appFlowNotificationSummarySchema, appFlowParamSchema, appFlowSummaryOf, appHandleSchema, appHttpKeyMatches, appIconProblem, appInstallRequestSchema, appInstallationActivitySchema, appInstallationAppSchema, appInstallationRunSchema, appInstallationSchema, appInstallationSelfSchema, appInstallationSettingsSchema, appInstallationSettingsUpdateSchema, appInstallationStatusSchema, appInvocationSchema, appListingReviewSchema, appListingReviewStatusSchema, appListingSchema, appManifestProblems, appManifestSchema, appManifestWidens, appNetworkHostProblem, appNetworkHostSchema, appReleaseResultSchema, appRuntimeSchema, appScheduleIntervalLabel, appScheduleListOf, appScheduleSummarySchema, appScopeSchema, appSecretSummarySchema, appSessionSchema, appSettingFieldSchema, appStatusSchema, appStorageEntrySchema, appStorageKeysSchema, appStorageListQuerySchema, appStoragePutSchema, appToolCallSchema, appToolInputSchema, appToolListOf, appToolResultSchema, appToolSchema, appToolSummarySchema, appVersionSchema, appVersionStatusSchema, appVisibilitySchema, approvalDecisionRequestSchema, approvalListQuerySchema, approvalPageSchema, approvalRequestSchema, approvalStatusSchema, approveClaimResultSchema, assertSaleUnit, auditActorSchema, auditActorTypeSchema, auditLogListQuerySchema, auditLogOutcomeSchema, auditLogPageSchema, auditLogSchema, auditLogSourceSchema, bestSellingRuleOf, brandBriefProductSourceSchema, brandBriefReferenceSchema, brandBriefSchema, brandBriefViewSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, businessInfoPatchShape, businessInfoResponseShape, businessNumberSchema, calendarDateSchema, calendarDaySchema, calendarQuerySchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, cashReceiptSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryLocalizationRequestSchema, categoryLocalizationSchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeStorefrontSlugRequestSchema, changeStorefrontTemplateRequestSchema, changeTypeSchema, claimCollectCompleteRequestSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimRedeliveryRequestSchema, claimReturnAddressSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, collectionCreateRequestSchema, collectionListQuerySchema, collectionLocalizationRequestSchema, collectionLocalizationSchema, collectionPageSchema, collectionPatchRequestSchema, collectionPreviewRequestSchema, collectionPreviewSchema, collectionProductListQuerySchema, collectionProductSchema, collectionProductSortRequestSchema, collectionProductsAddRequestSchema, collectionProductsReplaceRequestSchema, collectionRuleCategoryIds, collectionRuleSchema, collectionRuleViewSchema, collectionRulesPredicate, collectionRulesSchema, collectionSchema, collectionStateCountsSchema, collectionStateOf, collectionStateSchema, commerceFlowCheckSchema, commerceFlowSchema, commerceFlowSummarySchema, commerceFlowVersionViewSchema, commerceNumberField, compareBySales, connectStorefrontGitRequestSchema, consentActionSchema, consentKindSchema, consentSourceSchema, couponBenefitSchema, couponConditionsInputSchema, couponConditionsSchema, couponDiscountOf, couponIssueListQuerySchema, couponIssueMethodSchema, couponIssueSchema, couponIssueStatusSchema, couponKindSchema, couponListQuerySchema, couponRedemptionListQuerySchema, couponRedemptionSchema, couponRejectReasonSchema, couponRuleSchema, couponSchema, couponStatsSchema, couponStatusSchema, couponTargetInputSchema, couponTargetSchema, createAiConversationRequestSchema, createAiConversationResponseSchema, createCommerceFlowRequestSchema, createCouponRequestSchema, createMarketRequestSchema, createPkcePair, createStoreClient, createStoreDraftRequestSchema, createStoreDraftResponseSchema, createStoreSession, createStorefrontEditPreviewLinkRequestSchema, createStorefrontPreviewLinkRequestSchema, createStorefrontSiteRequestSchema, createStorefrontVersionRequestSchema, currencyCodeSchema, currencyRefundFeesSchema, currencyShippingPolicySchema, currencySpecOf, customInputLabelForbiddenWord, customInputRequestSchema, customInputSchema, customInputValueSchema, customerAddressSchema, customerConsentListQuerySchema, customerConsentSchema, customerConsentStateSchema, customerConsentsSchema, customerCouponSchema, customerDelegationRequestSchema, customerDelegationSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerPointsSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, defaultFulfillmentMethodOf, deleteStorefrontFileRequestSchema, deliveryBundleKeyOf, deliveryFeeWaiverSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, descendantCategoryIdsOf, describeScope, devStoreSchema, developerAppCreateSchema, developerAppSchema, developerInstallationSchema, developerOrgSchema, developerStoreSchema, disableStorefrontHostingRequestSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, floorToSaleUnit, flowActionRequestSchema, flowActionResultSchema, flowActionSchema, flowFieldValueSchema, flowInputFieldSchema, flowNodeTypesSchema, flowNotificationWebhookEventDataSchema, flowNotificationWebhookEventSchema, flowPresetDetailSchema, flowPresetSummarySchema, flowRunSchema, flowRunStepSchema, flowSecretNameSchema, flowSecretSchema, flowStateChangedWebhookEventDataSchema, flowStateChangedWebhookEventSchema, flowStateSchema, formatOrderNo, fromDecimalString, fulfillBulkRequestSchema, fulfillRequestSchema, fulfillmentMethodOf, fulfillmentMethodSchema, fulfillmentMethodsOf, fulfillmentRuleOf, fulfillmentTypeOf, fulfillmentTypeResponseSchema, fulfillmentTypeSchema, holdOrderItemRequestSchema, infoFieldSourceSchema, infoSchemaFieldSchema, infoSchemaSchema, infoSectionLocalizationRequestSchema, infoSectionLocalizationSchema, infoSectionRequestSchema, infoSectionSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, inventoryAdjustmentLineSchema, inventoryAdjustmentReasonSchema, inventoryAdjustmentRequestSchema, inventoryChangedWebhookEventDataSchema, inventoryChangedWebhookEventSchema, inventoryLevelListQuerySchema, inventoryLevelPageSchema, inventoryLevelSchema, inventoryLocationRequestSchema, inventoryLocationSchema, inventoryModeSchema, inventoryMovementKindSchema, inventoryMovementListQuerySchema, inventoryMovementPageSchema, inventoryMovementSchema, inventoryOperationResultSchema, inventoryTransferRequestSchema, invitationDeliveryStatusSchema, invitationListQuerySchema, invitationSchema, inviteMemberRequestSchema, isAiAgentNotesPath, isAiDesignPath, isCouponTargetLine, isCurrencyCode, isEditableStorefrontPath, isInstallableScope, isReservedStoreCode, isReservedStorefrontSlug, isSaleUnitPrice, isShowcaseStorefrontSlug, isStoreScope, isWebOrigin, issueCouponRequestSchema, issueCouponResultSchema, kakaoPayCredentialsInputSchema, linkStorefrontGitInstallationRequestSchema, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, localeCodeSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, marketSchema, maskedSecretSchema, matchesCollectionRules, mcpRuleResultSchema, mcpToolEventSchema, migrateFlowVersionRequestSchema, migrateFlowVersionResultSchema, minPaymentOf, minorToMajor, moneyRulesOf, moveFlowStateRequestSchema, moveStorefrontFileRequestSchema, myAccountSchema, myStoreSchema, naverPayCredentialsInputSchema, nightsOf, normalizeBusinessNumber, normalizeCouponCode, normalizeLocale, normalizeStorefrontHostname, normalizeStorefrontPath, oauthTokenResponseSchema, openFulfillmentUnion, optionGroupKindSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionSelectionSchema, optionSortSchema, optionValueRequestSchema, optionValueSchema, orderCanceledWebhookEventDataSchema, orderCanceledWebhookEventSchema, orderDiscountSchema, orderFlowActionResultSchema, orderFulfilledWebhookEventDataSchema, orderFulfilledWebhookEventSchema, orderItemFlowSchema, orderItemFulfillmentSchema, orderItemFulfillmentSnapshotResponseSchema, orderItemFulfillmentSnapshotSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, parseOrderNo, parseWebhookEvent, payPalCredentialsInputSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentFailureWarningSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, paymentStatusProviderSchema, paymentStatusSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderResponseSchema, pgProviderSchema, pgVerificationResultSchema, pickupLocationRequestSchema, pickupLocationSchema, pickupLocationSnapshotSchema, planCodeSchema, planEntitlementsSchema, planErrorDetailsSchema, platformCodeSchema, pointAdjustmentRequestSchema, pointAdjustmentResultSchema, pointEarnOf, pointEarnRateBpSchema, pointEarningEnabled, pointEntrySchema, pointExpiresAtOf, pointHistoryQuerySchema, pointLotSchema, pointPolicyNoticeSchema, pointPolicySchema, pointRestoreExpiresAtOf, pointUseOf, pointUsePolicySchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCertificationsRequestSchema, productCertificationsSchema, productCreateRequestSchema, productCurrencyPriceSchema, productCurrencyPricesSchema, productFulfillmentCreateSchema, productFulfillmentResponseSchema, productFulfillmentSchema, productFulfillmentUpdateSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, productLocalizationNeedsTranslation, productLocalizationRequestSchema, productLocalizationSchema, productNoticeRequestSchema, productNoticeSchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productRefundPolicyOverride, productRefundPolicyPatchSchema, productReplaceRequestSchema, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, proratedPaidRefundBase, proratedPointRefund, proratedRefundBase, publicPlanSchema, publicPlansSchema, publishStorefrontVersionRequestSchema, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, purchaseEarnPolicySchema, purchaseEarnRateOf, putBrandBriefRequestSchema, quoteDelivery, quotePricing, rankBestSelling, refreshUserToken, refundPolicyPatchSchema, refundPolicySchema, rejectClaimRequestSchema, remoteAreaLabelOf, remoteAreaOf, remoteAreaSchema, remoteSurchargeOf, replaceStorefrontSourceRequestSchema, replayFlowRequestSchema, replayFlowResultSchema, requiresCollection, requiresShipping, resolvePointPolicy, resolveRefundPolicy, resolveShippingPolicy, resolvedFlowSchema, responsePlanCodeSchema, responsePointEntryTypeSchema, reviewListQuerySchema, reviewReportResultSchema, reviewRewardPointOf, reviewRewardPolicySchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, rollbackStorefrontRequestSchema, runStorefrontCheckRequestSchema, salesReportCurrencySchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveFlowDraftRequestSchema, saveFlowSecretRequestSchema, saveLoginProviderRequestSchema, savedCustomInputRequestSchema, savedCustomInputSchema, savedOptionGroupRequestSchema, savedOptionGroupSchema, savedOptionSetCompositionSchema, savedOptionSetFromProductRequestSchema, savedOptionSetFromProductResultSchema, savedOptionSetListQuerySchema, savedOptionSetLocalizationRequestSchema, savedOptionSetLocalizationSchema, savedOptionSetRequestSchema, savedOptionSetSchema, savedOptionSetSortSchema, savedOptionValueRequestSchema, savedOptionValueSchema, scopeAccessSchema, scopesCoverEvent, searchStorefrontFilesRequestSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCancelPreviewSchema, sellerCustomerInquirySchema, sendAiMessageRequestSchema, sendAiMessageResponseSchema, setCalendarRequestSchema, setPlatformTestKeysRequestSchema, setStorefrontDeployApprovalRequestSchema, setStorefrontVisibilityRequestSchema, settleCouponShortfall, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, shippingCurrencyPriceSchema, shippingCurrencyPricesSchema, shippingPolicyPatchSchema, shippingPolicySchema, simulateFlowRequestSchema, simulateFlowResultSchema, simulationStepSchema, splitRefund, starterSellerTaskSchema, starterStageSchema, starterStatusSchema, starterStoreInfoFieldSchema, stayRangeSchema, staySnapshotSchema, storeAppDetailSchema, storeAppSchema, storeCodeSchema, storeDraftPreviewSchema, storeDraftSchema, storeIndustrySchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storePointPolicySchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeSetupBriefSchema, storeShopTypeSchema, storeSubscriptionSchema, storeTemplateSchema, storedAdditionalCurrencyPriceSchema, storedProductCurrencyPriceSchema, storedShippingCurrencyPriceSchema, storefrontBuildDependenciesSchema, storefrontBuildListQuerySchema, storefrontBuildSchema, storefrontBuildStatusSchema, storefrontCheckSchema, storefrontCheckStatusSchema, storefrontCustomDomainStatusSchema, storefrontCustomHostnameProblem, storefrontDependencyFindingSchema, storefrontDeploymentLogSchema, storefrontDeploymentSchema, storefrontDeploymentStepSchema, storefrontDevLogsSchema, storefrontDnsRecordSchema, storefrontDomainSchema, storefrontDomainTxtNameOf, storefrontEditPreviewLabelOf, storefrontEditPreviewSchema, storefrontEditSessionSchema, storefrontEditSessionStatusSchema, storefrontEditingSchema, storefrontFileConflictDetailsSchema, storefrontFileContentQuerySchema, storefrontFileContentSchema, storefrontFileDeleteResultSchema, storefrontFileEncodingSchema, storefrontFileEntrySchema, storefrontFileHashSchema, storefrontFileListQuerySchema, storefrontFileListSchema, storefrontFileMoveResultSchema, storefrontFilePathSchema, storefrontFileSearchResultSchema, storefrontFileWriteResultSchema, storefrontGitConnectStateSchema, storefrontGitRepositorySchema, storefrontGitStatusSchema, storefrontHostingSchema, storefrontPreviewLinkSchema, storefrontProvisioningSchema, storefrontRuleResultSchema, storefrontRuleSeveritySchema, storefrontSiteDomainSchema, storefrontSiteDomainsSchema, storefrontSiteSchema, storefrontSiteSnapshotSchema, storefrontSiteStatusSchema, storefrontSlugAvailabilityQuerySchema, storefrontSlugAvailabilitySchema, storefrontSlugSchema, storefrontSourceArchivePartSchema, storefrontSourceArchiveQuerySchema, storefrontSourceBlobsResultSchema, storefrontSourceModeSchema, storefrontSourceRefSchema, storefrontSourceReplacedSchema, storefrontSourceSchema, storefrontSuspensionSchema, storefrontTemplateSchema, storefrontVerifyReportSchema, storefrontVersionCreatedSchema, storefrontVersionPreviewLabelOf, storefrontVersionSchema, storefrontVersionStatusSchema, storefrontVisibilitySchema, subscriptionLimitsSchema, subscriptionStatusSchema, subscriptionUsageSchema, toDecimalString, toMinor, tossPaymentsCredentialsInputSchema, trackingStageResponseSchema, trackingUpdateResultSchema, unknownWebhookEventSchema, updateCouponRequestSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updateMarketRequestSchema, updateMemberRoleRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updatePointPolicyRequestSchema, updateStoreRequestSchema, updateStoreTemplateRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadStorefrontSourceBlobsRequestSchema, uploadTicketSchema, upsertKakaoPayProviderRequestSchema, upsertNaverPayProviderRequestSchema, upsertPayPalProviderRequestSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryDetailSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliveryResourceSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookFailureReasonSchema, webhookRedeliverFailedResultSchema, webhookRequestHeaderSchema, webhookRequestSchema, webhookResourceTypeSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema, writeDryRunResultSchema, writePreviewSchema, writeStorefrontFilesRequestSchema };
+export { AI_AGENT_NOTES_DIR, AI_AGENT_PHASES, AI_DESIGN_BOARDS_MAX, AI_DESIGN_BOARD_FILE_PATTERN, AI_DESIGN_BOARD_KINDS, AI_DESIGN_CANVAS_PATH, AI_DESIGN_CONFIRM_APPROVE, AI_DESIGN_DIR, AI_DESIGN_VIEWPORTS, AI_MESSAGE_MAX_ATTACHMENTS, AI_MESSAGE_MAX_CHARS, AI_RUN_ACTIVE_STATUSES, AI_RUN_FILE_CHANGES_RETENTION_DAYS, AI_SETUP_CONFIRM_APPROVE, AI_TODOS_MAX, AI_TODO_STATUSES, APPROVAL_ALREADY_DECIDED_CODE, APPROVAL_REQUIRED_CODE, APP_CAPABILITIES, APP_DEPLOY_KEY_PATTERN, APP_DEPLOY_KEY_PREFIX, APP_EVENTS_MAX, APP_EVENT_SCOPES, APP_EVENT_TYPES, APP_FLOW_EVENT_PATTERN, APP_FLOW_ITEMS_MAX, APP_FLOW_NOTIFICATION_PATTERN, APP_HANDLE_PATTERN, APP_HTTP_KEY_PATTERN, APP_ICON_CONTENT_TYPES, APP_ICON_MAX_BYTES, APP_ICON_MIN_PX, APP_LIFECYCLE_EVENT_TYPES, APP_NETWORK_DENIED_SUFFIXES, APP_NETWORK_HOSTS_MAX, APP_PUBLIC_HTTP_MAX, APP_README_MAX_BYTES, APP_RESERVED_HANDLES, APP_SCHEDULES_MAX, APP_SCHEDULE_INTERVALS, APP_SCHEDULE_NAME_PATTERN, APP_SECRETS_MAX, APP_SECRET_NAME_PATTERN, APP_SECRET_PATTERNS, APP_SERVER_BUNDLE_MAX_GZIP_BYTES, APP_SETTINGS_MAX_FIELDS, APP_SETTING_FIELD_TYPES, APP_SETTING_KEY_PATTERN, APP_STORAGE_KEY_PATTERN, APP_STORAGE_MAX_BYTES, APP_STORAGE_MAX_KEYS, APP_TOOL_NAME_PATTERN, APP_UI_MAX_BYTES, APP_UI_MAX_FILES, ApiError, ApprovalPendingError, BASE_CURRENCY, BRAND_BRIEF_MAX_REFERENCES, BUSINESS_INFO_MAX_LENGTH, BUSINESS_NUMBER_PATTERN, CASH_RECEIPT_STATUS_VALUES, CERTIFICATION_STATUSES, COLLECTION_BEST_SELLING_DAYS, COLLECTION_PREVIEW_SIZE, COLLECTION_PRODUCT_SORTS, COLLECTION_SALES_SORT_DEFAULT_DAYS, COLLECTION_SLUG_PATTERN, COLLECTION_TYPES, COUPON_CODE_PATTERN, COUPON_CONDITIONS_DEFAULTS, COUPON_TARGET_ALL, COUPON_TARGET_LIST_MAX, CURRENCIES, CURRENCY_CODES, CUSTOM_INPUT_FORBIDDEN_WORDS, CUSTOM_INPUT_TYPES, DEDICATED_EASY_PAY_PROVIDER, DEFAULT_STORE_LOCALE, FULFILLMENT_METHODS, FULFILLMENT_METHODS_BY_TYPE, FULFILLMENT_METHOD_RULES, FULFILLMENT_RULES, INSTALLABLE_SCOPES, InvalidPriceUnitError, KAKAOPAY_TEST_CID, KNOWN_WEBHOOK_EVENT_TYPES, KRW_MONEY_RULES, MAX_ADDON_GROUPS, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_CALENDAR_DAYS, MAX_CERTIFICATION_ITEMS, MAX_COLLECTIONS, MAX_COLLECTION_BEST_SELLING_TOP, MAX_COLLECTION_CREATED_WITHIN_DAYS, MAX_COLLECTION_DESCRIPTION, MAX_COLLECTION_PRODUCTS, MAX_COLLECTION_PRODUCTS_PER_ADD, MAX_COLLECTION_RULES, MAX_COLLECTION_RULE_CATEGORIES, MAX_COLLECTION_TITLE, MAX_CUSTOM_INPUTS, MAX_CUSTOM_INPUT_LENGTH, MAX_INFO_SECTION_TITLE, MAX_INVENTORY_OPERATION_LINES, MAX_NOTICE_VALUE_LENGTH, MAX_OPTION_GROUPS, MAX_PICKUP_LOCATIONS, MAX_PRODUCT_IMAGES, MAX_PRODUCT_INFO_SECTIONS, MAX_SAVED_OPTION_SETS, MAX_SAVED_OPTION_SET_NAME, MAX_STAY_NIGHTS, MAX_VALUES_PER_GROUP, MAX_VARIANTS, MCP_TELEMETRY_MAX_RESULTS, MIN_PAYMENT_AMOUNT, NON_INSTALLABLE_SCOPES, NO_COUPON_SETTLEMENT, NO_SHIPPING_BUNDLE_KEY, PAYMENT_ROUTING_EXCLUSION_CODES, PAYPAL_CURRENCIES, PLATFORM_CODE_SETS, POINT_ADJUSTMENT_MAX, POINT_EARN_RATE_BP_MAX, POINT_ENTRY_TYPES, POINT_EXPIRY_DAYS_MAX, POINT_EXPIRY_DAYS_MIN, POINT_LOT_SOURCES, POINT_POLICY_DEFAULTS, POINT_REVIEW_REWARD_MAX, POINT_USE_UNITS, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, REFUND_POLICY_DEFAULTS, REFUND_POLICY_DELIVERY_FEE_KEYS, REMOTE_AREA_ZIP_RANGES, RESERVED_STOREFRONT_SLUGS, RESERVED_STORE_CODES, SCOPE_DESCRIPTIONS, SHIPPING_POLICY_DEFAULTS, STARTER_SELLER_TASKS, STARTER_STAGES, STOREFRONT_BLOCKED_PATH_SEGMENTS, STOREFRONT_BUILD_STAGES, STOREFRONT_BUILD_TERMINAL_STATUSES, STOREFRONT_CHECK_TERMINAL_STATUSES, STOREFRONT_CLOSED_SITE_HOLD_DAYS, STOREFRONT_CUSTOM_DOMAIN_LIMIT_DEFAULT, STOREFRONT_DOMAIN_DNS_GRACE_DAYS, STOREFRONT_DOMAIN_DNS_WAIT_DAYS, STOREFRONT_DOMAIN_TXT_LABEL, STOREFRONT_EDIT_ACTIVITY_TIMEOUT_MINUTES, STOREFRONT_EDIT_CAPACITY, STOREFRONT_EDIT_IDLE_MINUTES, STOREFRONT_EDIT_PREVIEW_SUFFIX, STOREFRONT_EDIT_START_STAGES, STOREFRONT_FILE_BATCH_MAX, STOREFRONT_FILE_MAX_BYTES, STOREFRONT_PATH_SEGMENT_PATTERN, STOREFRONT_PLATFORM_DOMAINS, STOREFRONT_PUBLIC_SUFFIXES, STOREFRONT_SEARCH_REGEX_MAX_LENGTH, STOREFRONT_SHOWCASE_SLUG_PREFIX, STOREFRONT_SITE_CREATE_LIMIT, STOREFRONT_SLUG_CHANGE_LIMIT, STOREFRONT_SLUG_CHANGE_WINDOW_DAYS, STOREFRONT_SLUG_HOLD_DAYS, STOREFRONT_SLUG_PATTERN, STOREFRONT_SOURCE_BLOB_BATCH_MAX, STOREFRONT_SOURCE_PART_BYTES, STOREFRONT_WORKSPACE_MAX_BYTES, STOREFRONT_WORKSPACE_MAX_FILES, STORE_CODE_PATTERN, STORE_DRAFT_ATTACHMENT_MAX_BYTES, STORE_DRAFT_MAX_ATTACHMENTS, STORE_DRAFT_RETENTION_DAYS, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, STORE_SHOP_TYPES, TEMPLATE_STORE_LOCKED_BUSINESS_FIELDS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, UPLOAD_PURPOSE_LIMITS, VARIANT_COUNT_WARNING, VARIANT_STOCK_EXCLUSIVE_MESSAGE, WEBHOOK_DEFAULT_TOLERANCE_SEC, WEBHOOK_DELIVERY_ID_HEADER, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPE_HEADER, WEBHOOK_FAILURE_REASONS, WEBHOOK_HEADERS, WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES, WEBHOOK_RESOURCE_TYPES, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_USER_AGENT, addStorefrontDomainRequestSchema, additionalCurrencyPriceSchema, additionalCurrencyPricesSchema, addonGroupRequestSchema, addonGroupSchema, addonValueRequestSchema, addonValueSchema, addressChangeRequestListSchema, addressTypeSchema, agentPolicyDecisionSchema, aiActivitySchema, aiAgentPhaseSchema, aiAttachmentSchema, aiChoiceOptionSchema, aiConversationFileChangesSchema, aiConversationSchema, aiConversationSummarySchema, aiDesignBoardSchema, aiDesignCanvasSchema, aiDesignConfirmBoardSchema, aiDesignSelectionSchema, aiFileChangeKindSchema, aiFocusAreaSchema, aiFocusSchema, aiMessagePartSchema, aiMessageSchema, aiPreviewSelectionSchema, aiRunChangesSchema, aiRunChangesStatusSchema, aiRunFileDiffSchema, aiRunRevertConflictDetailsSchema, aiRunRevertResultSchema, aiRunSchema, aiRunStatusSchema, aiSetupConfirmItemSchema, aiStreamAccessSchema, aiStreamEventSchema, aiStreamRecordSchema, aiTodoSchema, aiToolChangeSchema, allocateByWeight, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, appArtifactUploadSchema, appBuildSchema, appBuildStageSchema, appCapabilitiesOf, appDeployKeyCreateSchema, appDeployKeyCreatedSchema, appDeployKeySchema, appDevTokenSchema, appDistributionSchema, appEventTypeSchema, appFlowEventSchema, appFlowEventSummarySchema, appFlowNotificationSchema, appFlowNotificationSummarySchema, appFlowParamSchema, appFlowSummaryOf, appHandleSchema, appHttpKeyMatches, appIconProblem, appInstallRequestSchema, appInstallationActivitySchema, appInstallationAppSchema, appInstallationRunSchema, appInstallationSchema, appInstallationSelfSchema, appInstallationSettingsSchema, appInstallationSettingsUpdateSchema, appInstallationStatusSchema, appInvocationSchema, appListingReviewSchema, appListingReviewStatusSchema, appListingSchema, appManifestProblems, appManifestSchema, appManifestWidens, appNetworkHostProblem, appNetworkHostSchema, appReleaseResultSchema, appRuntimeSchema, appScheduleIntervalLabel, appScheduleListOf, appScheduleSummarySchema, appScopeSchema, appSecretSummarySchema, appSessionSchema, appSettingFieldSchema, appStatusSchema, appStorageEntrySchema, appStorageKeysSchema, appStorageListQuerySchema, appStoragePutSchema, appToolCallSchema, appToolInputSchema, appToolListOf, appToolResultSchema, appToolSchema, appToolSummarySchema, appVersionSchema, appVersionStatusSchema, appVisibilitySchema, applyFlowOperationsRequestSchema, approvalDecisionRequestSchema, approvalListQuerySchema, approvalPageSchema, approvalRequestSchema, approvalStatusSchema, approveClaimResultSchema, assertSaleUnit, auditActorSchema, auditActorTypeSchema, auditLogListQuerySchema, auditLogOutcomeSchema, auditLogPageSchema, auditLogSchema, auditLogSourceSchema, bestSellingRuleOf, brandBriefProductSourceSchema, brandBriefReferenceSchema, brandBriefSchema, brandBriefViewSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, businessInfoPatchShape, businessInfoResponseShape, businessNumberSchema, calendarDateSchema, calendarDaySchema, calendarQuerySchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, cashReceiptSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryLocalizationRequestSchema, categoryLocalizationSchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeStorefrontSlugRequestSchema, changeStorefrontTemplateRequestSchema, changeTypeSchema, claimCollectCompleteRequestSchema, claimDetailSchema, claimFlowEditSessionRequestSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimRedeliveryRequestSchema, claimReturnAddressSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, collectionCreateRequestSchema, collectionListQuerySchema, collectionLocalizationRequestSchema, collectionLocalizationSchema, collectionPageSchema, collectionPatchRequestSchema, collectionPreviewRequestSchema, collectionPreviewSchema, collectionProductListQuerySchema, collectionProductSchema, collectionProductSortRequestSchema, collectionProductsAddRequestSchema, collectionProductsReplaceRequestSchema, collectionRuleCategoryIds, collectionRuleSchema, collectionRuleViewSchema, collectionRulesPredicate, collectionRulesSchema, collectionSchema, collectionStateCountsSchema, collectionStateOf, collectionStateSchema, commerceFlowCheckSchema, commerceFlowSchema, commerceFlowSummarySchema, commerceFlowVersionViewSchema, commerceNumberField, compareBySales, connectStorefrontGitRequestSchema, consentActionSchema, consentKindSchema, consentSourceSchema, couponBenefitSchema, couponConditionsInputSchema, couponConditionsSchema, couponDiscountOf, couponIssueListQuerySchema, couponIssueMethodSchema, couponIssueSchema, couponIssueStatusSchema, couponKindSchema, couponListQuerySchema, couponRedemptionListQuerySchema, couponRedemptionSchema, couponRejectReasonSchema, couponRuleSchema, couponSchema, couponStatsSchema, couponStatusSchema, couponTargetInputSchema, couponTargetSchema, createAiConversationRequestSchema, createAiConversationResponseSchema, createCommerceFlowRequestSchema, createCouponRequestSchema, createMarketRequestSchema, createPkcePair, createStoreClient, createStoreDraftRequestSchema, createStoreDraftResponseSchema, createStoreSession, createStorefrontEditPreviewLinkRequestSchema, createStorefrontPreviewLinkRequestSchema, createStorefrontSiteRequestSchema, createStorefrontVersionRequestSchema, currencyCodeSchema, currencyRefundFeesSchema, currencyShippingPolicySchema, currencySpecOf, customInputLabelForbiddenWord, customInputRequestSchema, customInputSchema, customInputValueSchema, customerAddressSchema, customerConsentListQuerySchema, customerConsentSchema, customerConsentStateSchema, customerConsentsSchema, customerCouponSchema, customerDelegationRequestSchema, customerDelegationSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerPointsSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, defaultFulfillmentMethodOf, deleteStorefrontFileRequestSchema, deliveryBundleKeyOf, deliveryFeeWaiverSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, descendantCategoryIdsOf, describeScope, devStoreSchema, developerAppCreateSchema, developerAppSchema, developerInstallationSchema, developerOrgSchema, developerStoreSchema, disableStorefrontHostingRequestSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, floorToSaleUnit, flowActionRequestSchema, flowActionResultSchema, flowActionSchema, flowAuthoringGuideSchema, flowDraftEdgesSchema, flowDraftNodeSchema, flowDraftNodesSchema, flowDraftOperationSchema, flowEditSessionViewSchema, flowFieldValueSchema, flowInputFieldSchema, flowIssueSchema, flowNodeIdSchema, flowNodeTypeDetailSchema, flowNodeTypesSchema, flowNotificationWebhookEventDataSchema, flowNotificationWebhookEventSchema, flowOperationsResultSchema, flowPresetDetailSchema, flowPresetSummarySchema, flowRunSchema, flowRunStepSchema, flowSecretNameSchema, flowSecretSchema, flowStateChangedWebhookEventDataSchema, flowStateChangedWebhookEventSchema, flowStateSchema, formatOrderNo, fromDecimalString, fulfillBulkRequestSchema, fulfillRequestSchema, fulfillmentMethodOf, fulfillmentMethodSchema, fulfillmentMethodsOf, fulfillmentRuleOf, fulfillmentTypeOf, fulfillmentTypeResponseSchema, fulfillmentTypeSchema, holdOrderItemRequestSchema, infoFieldSourceSchema, infoSchemaFieldSchema, infoSchemaSchema, infoSectionLocalizationRequestSchema, infoSectionLocalizationSchema, infoSectionRequestSchema, infoSectionSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, inventoryAdjustmentLineSchema, inventoryAdjustmentReasonSchema, inventoryAdjustmentRequestSchema, inventoryChangedWebhookEventDataSchema, inventoryChangedWebhookEventSchema, inventoryLevelListQuerySchema, inventoryLevelPageSchema, inventoryLevelSchema, inventoryLocationRequestSchema, inventoryLocationSchema, inventoryModeSchema, inventoryMovementKindSchema, inventoryMovementListQuerySchema, inventoryMovementPageSchema, inventoryMovementSchema, inventoryOperationResultSchema, inventoryTransferRequestSchema, invitationDeliveryStatusSchema, invitationListQuerySchema, invitationSchema, inviteMemberRequestSchema, isAiAgentNotesPath, isAiDesignPath, isCouponTargetLine, isCurrencyCode, isEditableStorefrontPath, isInstallableScope, isReservedStoreCode, isReservedStorefrontSlug, isSaleUnitPrice, isShowcaseStorefrontSlug, isStoreScope, isWebOrigin, issueCouponRequestSchema, issueCouponResultSchema, kakaoPayCredentialsInputSchema, linkStorefrontGitInstallationRequestSchema, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, localeCodeSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, marketSchema, maskedSecretSchema, matchesCollectionRules, mcpRuleResultSchema, mcpToolEventSchema, migrateFlowVersionRequestSchema, migrateFlowVersionResultSchema, minPaymentOf, minorToMajor, moneyRulesOf, moveFlowStateRequestSchema, moveStorefrontFileRequestSchema, myAccountSchema, myStoreSchema, naverPayCredentialsInputSchema, nightsOf, normalizeBusinessNumber, normalizeCouponCode, normalizeLocale, normalizeStorefrontHostname, normalizeStorefrontPath, oauthTokenResponseSchema, openFulfillmentUnion, optionGroupKindSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionSelectionSchema, optionSortSchema, optionValueRequestSchema, optionValueSchema, orderCanceledWebhookEventDataSchema, orderCanceledWebhookEventSchema, orderDiscountSchema, orderFlowActionResultSchema, orderFulfilledWebhookEventDataSchema, orderFulfilledWebhookEventSchema, orderItemFlowSchema, orderItemFulfillmentSchema, orderItemFulfillmentSnapshotResponseSchema, orderItemFulfillmentSnapshotSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, parseOrderNo, parseWebhookEvent, payPalCredentialsInputSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentFailureWarningSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, paymentStatusProviderSchema, paymentStatusSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderResponseSchema, pgProviderSchema, pgVerificationResultSchema, pickupLocationRequestSchema, pickupLocationSchema, pickupLocationSnapshotSchema, planCodeSchema, planEntitlementsSchema, planErrorDetailsSchema, platformCodeSchema, pointAdjustmentRequestSchema, pointAdjustmentResultSchema, pointEarnOf, pointEarnRateBpSchema, pointEarningEnabled, pointEntrySchema, pointExpiresAtOf, pointHistoryQuerySchema, pointLotSchema, pointPolicyNoticeSchema, pointPolicySchema, pointRestoreExpiresAtOf, pointUseOf, pointUsePolicySchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCertificationsRequestSchema, productCertificationsSchema, productCreateRequestSchema, productCurrencyPriceSchema, productCurrencyPricesSchema, productFulfillmentCreateSchema, productFulfillmentResponseSchema, productFulfillmentSchema, productFulfillmentUpdateSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, productLocalizationNeedsTranslation, productLocalizationRequestSchema, productLocalizationSchema, productNoticeRequestSchema, productNoticeSchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productRefundPolicyOverride, productRefundPolicyPatchSchema, productReplaceRequestSchema, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, proratedPaidRefundBase, proratedPointRefund, proratedRefundBase, publicPlanSchema, publicPlansSchema, publishStorefrontVersionRequestSchema, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, purchaseEarnPolicySchema, purchaseEarnRateOf, putBrandBriefRequestSchema, quoteDelivery, quotePricing, rankBestSelling, refreshUserToken, refundPolicyPatchSchema, refundPolicySchema, rejectClaimRequestSchema, remoteAreaLabelOf, remoteAreaOf, remoteAreaSchema, remoteSurchargeOf, replaceStorefrontSourceRequestSchema, replayFlowRequestSchema, replayFlowResultSchema, requiresCollection, requiresShipping, resolvePointPolicy, resolveRefundPolicy, resolveShippingPolicy, resolvedFlowSchema, responsePlanCodeSchema, responsePointEntryTypeSchema, reviewListQuerySchema, reviewReportResultSchema, reviewRewardPointOf, reviewRewardPolicySchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, rollbackStorefrontRequestSchema, runStorefrontCheckRequestSchema, salesReportCurrencySchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveFlowDraftRequestSchema, saveFlowSecretRequestSchema, saveLoginProviderRequestSchema, savedCustomInputRequestSchema, savedCustomInputSchema, savedOptionGroupRequestSchema, savedOptionGroupSchema, savedOptionSetCompositionSchema, savedOptionSetFromProductRequestSchema, savedOptionSetFromProductResultSchema, savedOptionSetListQuerySchema, savedOptionSetLocalizationRequestSchema, savedOptionSetLocalizationSchema, savedOptionSetRequestSchema, savedOptionSetSchema, savedOptionSetSortSchema, savedOptionValueRequestSchema, savedOptionValueSchema, scopeAccessSchema, scopesCoverEvent, searchStorefrontFilesRequestSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCancelPreviewSchema, sellerCustomerInquirySchema, sendAiMessageRequestSchema, sendAiMessageResponseSchema, setCalendarRequestSchema, setPlatformTestKeysRequestSchema, setStorefrontDeployApprovalRequestSchema, setStorefrontVisibilityRequestSchema, settleCouponShortfall, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, shippingCurrencyPriceSchema, shippingCurrencyPricesSchema, shippingPolicyPatchSchema, shippingPolicySchema, simulateFlowRequestSchema, simulateFlowResultSchema, simulationStepSchema, splitRefund, starterSellerTaskSchema, starterStageSchema, starterStatusSchema, starterStoreInfoFieldSchema, stayRangeSchema, staySnapshotSchema, storeAppDetailSchema, storeAppSchema, storeCodeSchema, storeDraftPreviewSchema, storeDraftSchema, storeIndustrySchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storePointPolicySchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeSetupBriefSchema, storeShopTypeSchema, storeSubscriptionSchema, storeTemplateSchema, storedAdditionalCurrencyPriceSchema, storedProductCurrencyPriceSchema, storedShippingCurrencyPriceSchema, storefrontBuildDependenciesSchema, storefrontBuildListQuerySchema, storefrontBuildSchema, storefrontBuildStatusSchema, storefrontCheckSchema, storefrontCheckStatusSchema, storefrontCustomDomainStatusSchema, storefrontCustomHostnameProblem, storefrontDependencyFindingSchema, storefrontDeploymentLogSchema, storefrontDeploymentSchema, storefrontDeploymentStepSchema, storefrontDevLogsSchema, storefrontDnsRecordSchema, storefrontDomainSchema, storefrontDomainTxtNameOf, storefrontEditFailureSchema, storefrontEditPreviewLabelOf, storefrontEditPreviewSchema, storefrontEditSessionSchema, storefrontEditSessionStatusSchema, storefrontEditingSchema, storefrontFileConflictDetailsSchema, storefrontFileContentQuerySchema, storefrontFileContentSchema, storefrontFileDeleteResultSchema, storefrontFileEncodingSchema, storefrontFileEntrySchema, storefrontFileHashSchema, storefrontFileListQuerySchema, storefrontFileListSchema, storefrontFileMoveResultSchema, storefrontFilePathSchema, storefrontFileSearchResultSchema, storefrontFileWriteResultSchema, storefrontGitConnectStateSchema, storefrontGitMergeRequestSchema, storefrontGitMergeSchema, storefrontGitRepositorySchema, storefrontGitStatusSchema, storefrontHostingSchema, storefrontPreviewLinkSchema, storefrontProvisioningSchema, storefrontRuleResultSchema, storefrontRuleSeveritySchema, storefrontSiteDomainSchema, storefrontSiteDomainsSchema, storefrontSiteSchema, storefrontSiteSnapshotSchema, storefrontSiteStatusSchema, storefrontSlugAvailabilityQuerySchema, storefrontSlugAvailabilitySchema, storefrontSlugSchema, storefrontSourceArchivePartSchema, storefrontSourceArchiveQuerySchema, storefrontSourceBlobsResultSchema, storefrontSourceModeSchema, storefrontSourceRefSchema, storefrontSourceReplacedSchema, storefrontSourceSchema, storefrontSuspensionSchema, storefrontTemplateSchema, storefrontVerifyReportSchema, storefrontVersionCreatedSchema, storefrontVersionPreviewLabelOf, storefrontVersionSchema, storefrontVersionStatusSchema, storefrontVisibilitySchema, subscriptionLimitsSchema, subscriptionStatusSchema, subscriptionUsageSchema, toDecimalString, toMinor, tossPaymentsCredentialsInputSchema, trackingStageResponseSchema, trackingUpdateResultSchema, unknownWebhookEventSchema, updateCouponRequestSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updateMarketRequestSchema, updateMemberRoleRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updatePointPolicyRequestSchema, updateStoreRequestSchema, updateStoreTemplateRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadStorefrontSourceBlobsRequestSchema, uploadTicketSchema, upsertKakaoPayProviderRequestSchema, upsertNaverPayProviderRequestSchema, upsertPayPalProviderRequestSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryDetailSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliveryResourceSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookFailureReasonSchema, webhookRedeliverFailedResultSchema, webhookRequestHeaderSchema, webhookRequestSchema, webhookResourceTypeSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema, writeDryRunResultSchema, writePreviewSchema, writeStorefrontFilesRequestSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/store-sdk",
-  "version": "0.37.2",
+  "version": "0.39.0",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "exports": {

package/src/client.ts

@@ -105,15 +105,26 @@ import {
   collectionSchema,
 } from "./schemas/collection";
 import {
+  applyFlowOperationsRequestSchema,
+  type ClaimFlowEditSessionRequest,
   type CreateCommerceFlowRequest,
+  claimFlowEditSessionRequestSchema,
   commerceFlowCheckSchema,
   commerceFlowSchema,
   commerceFlowSummarySchema,
   commerceFlowVersionViewSchema,
   createCommerceFlowRequestSchema,
+  type FlowDraftOperation,
   flowActionRequestSchema,
   flowActionResultSchema,
+  flowAuthoringGuideSchema,
+  flowDraftEdgesSchema,
+  flowDraftNodeSchema,
+  flowDraftNodesSchema,
+  flowEditSessionViewSchema,
+  flowNodeTypeDetailSchema,
   flowNodeTypesSchema,
+  flowOperationsResultSchema,
   flowPresetDetailSchema,
   flowPresetSummarySchema,
   flowRunSchema,
@@ -1205,6 +1216,63 @@ export function createStoreClient(options: StoreClientOptions) {
         ),
       /** `GET /flow-node-types` — 쓸 수 있는 노드·블록 종류와 설정 형식(JSON Schema) */
       nodeTypes: () => storeHttp.request("GET", "/flow-node-types", flowNodeTypesSchema),
+      /**
+       * `GET /flow-authoring-guide` — 흐름 작성 안내(#120): 노드·블록 목록, 연결선 조건 형식, 식 컨텍스트·함수, 규칙, 조작 예시.
+       * 순서: 안내 → `draftNodes`·`draftEdges` → 고칠 노드만 `draftNode` → 새로 쓸 종류만 `nodeType` → `applyOperations`
+       */
+      authoringGuide: () =>
+        storeHttp.request("GET", "/flow-authoring-guide", flowAuthoringGuideSchema),
+      /** `GET /flow-node-types/{type}` — 노드·블록 종류 하나의 설정 형식(공통 설정은 `$defs`)과 예시. 없으면 404 `FLOW_NODE_TYPE_NOT_FOUND` */
+      nodeType: (type: string) =>
+        storeHttp.request("GET", path`/flow-node-types/${type}`, flowNodeTypeDetailSchema),
+      /** `GET /commerce-flows/{id}/draft/nodes` — 초안 노드 목록(설정 없음)과 `revision`. 초안이 없으면 게시 버전을 revision 0으로 */
+      draftNodes: (flowId: string) =>
+        storeHttp.request("GET", path`/commerce-flows/${flowId}/draft/nodes`, flowDraftNodesSchema),
+      /** `GET /commerce-flows/{id}/draft/nodes/{nodeId}` — 노드 하나의 설정 전체와 드나드는 연결선. 없으면 404 `FLOW_NODE_NOT_FOUND` */
+      draftNode: (flowId: string, nodeId: string) =>
+        storeHttp.request(
+          "GET",
+          path`/commerce-flows/${flowId}/draft/nodes/${nodeId}`,
+          flowDraftNodeSchema,
+        ),
+      /** `GET /commerce-flows/{id}/draft/edges` — 초안 연결선 목록과 `revision` */
+      draftEdges: (flowId: string) =>
+        storeHttp.request("GET", path`/commerce-flows/${flowId}/draft/edges`, flowDraftEdgesSchema),
+      /** `GET /commerce-flows/{id}/draft/edit-session` — 편집권(누가 고치는 중인지)과 흐름 채널 구독 정보(#120) */
+      editSession: (flowId: string) =>
+        storeHttp.request(
+          "GET",
+          path`/commerce-flows/${flowId}/draft/edit-session`,
+          flowEditSessionViewSchema,
+        ),
+      /**
+       * `POST /commerce-flows/{id}/draft/edit-session` — 편집 시작·연장, `takeover`면 가져오기. 다른 주체가 잡고 있으면 423 `FLOW_DRAFT_LOCKED`
+       */
+      claimEditSession: (flowId: string, body: ClaimFlowEditSessionRequest = {}) =>
+        storeHttp.request(
+          "POST",
+          path`/commerce-flows/${flowId}/draft/edit-session`,
+          flowEditSessionViewSchema,
+          { body: claimFlowEditSessionRequestSchema.parse(body) },
+        ),
+      /** `DELETE /commerce-flows/{id}/draft/edit-session` — 편집 끝내기(자기 편집권만 놓는다) */
+      releaseEditSession: (flowId: string) =>
+        storeHttp.requestVoid("DELETE", path`/commerce-flows/${flowId}/draft/edit-session`),
+      /**
+       * `POST /commerce-flows/{id}/draft/operations` — 조작 묶음을 `revision`(If-Match) 위에 적용해 초안을 저장한다(원자적).
+       * 결과의 `issues`는 저장은 됐지만 게시를 막는 문제다. 에러: 400 `FLOW_OPERATION_INVALID`(`details.issues[].opIndex`·`pointer`, 저장 안 함) ·
+       * 409 `FLOW_REVISION_CONFLICT`(`details.currentRevision`, 다시 읽는다)
+       */
+      applyOperations: (flowId: string, operations: FlowDraftOperation[], revision: number) =>
+        storeHttp.request(
+          "POST",
+          path`/commerce-flows/${flowId}/draft/operations`,
+          flowOperationsResultSchema,
+          {
+            body: applyFlowOperationsRequestSchema.parse({ operations }),
+            headers: { "if-match": String(revision) },
+          },
+        ),
     },
 
     carriers: {