@sayren/store-sdk 0.30.8 → 0.30.9

package/dist/index.mjs

@@ -618,121 +618,174 @@ const apiLogSummarySchema = z.object({
 	serverErrors: z.number().int().min(0).describe("구간 내 연동 요청 중 5xx 응답 수")
 });
 //#endregion
-//#region src/schemas/auth.ts
-const storeRoleSchema = z.enum([
-	"OWNER",
-	"ADMIN",
-	"STAFF"
-]);
-const myStoreSchema = z.object({
-	storeId: z.string(),
-	storeName: z.string(),
-	storeCode: z.string(),
-	role: storeRoleSchema,
-	status: z.enum([
-		"ACTIVE",
-		"SUSPENDED",
-		"CLOSED"
-	])
-});
-const myAccountSchema = z.object({
-	userId: z.string(),
-	email: z.email(),
-	name: z.string(),
-	storeCount: z.number().int(),
-	createdAt: z.string()
-});
+//#region src/schemas/scope.ts
+/**
+* 상점 스코프 카탈로그 (auth-spec §7) — 형식 `{리소스}:{r|rw}`, rw는 r을 함의한다.
+*
+* 관리 API가 요구하는 스코프와 역할별 자동 부여 스코프의 **단일 원천**이다.
+* 서버(apps/api)가 이 상수를 그대로 가져다 역할→스코프를 산출하므로, 상점 플랫폼 권한 매트릭스와
+* 서버 인가가 갈라지지 않는다.
+*/
+const scopeAccessSchema = z.enum(["r", "rw"]).describe("접근 수준. `r`=읽기, `rw`=읽기+쓰기(r을 함의)");
+/** 리소스별로 부여 가능한 접근 수준. settlement·analytics·audit는 쓰기 API가 없어 `r`만 존재한다 */
+const STORE_SCOPE_RESOURCES = {
+	product: ["r", "rw"],
+	category: ["r", "rw"],
+	order: ["r", "rw"],
+	claim: ["r", "rw"],
+	inquiry: ["r", "rw"],
+	review: ["r", "rw"],
+	settlement: ["r"],
+	analytics: ["r"],
+	webhook: ["r", "rw"],
+	store: ["r", "rw"],
+	member: ["r", "rw"],
+	customer: ["r", "rw"],
+	audit: ["r"],
+	promotion: ["r", "rw"],
+	storefront: ["r", "rw"],
+	flow: ["r", "rw"]
+};
+const storeScopeResourceSchema = z.enum(Object.keys(STORE_SCOPE_RESOURCES)).describe("스코프 리소스");
+/** 카탈로그상 존재하는 스코프 문자열인가 (예: `settlement:rw`는 false) */
+function isStoreScope(scope) {
+	const [resource, access, ...rest] = scope.split(":");
+	if (rest.length > 0 || !resource || !access) return false;
+	return STORE_SCOPE_RESOURCES[resource]?.includes(access) ?? false;
+}
+/**
+* 역할별 자동 부여 스코프 (auth-spec §7).
+* 계정 토큰으로 상점을 호출할 때의 스코프는 그 상점에서의 역할로 이 표에서 결정된다.
+*/
+const STORE_ROLE_SCOPES = {
+	OWNER: [
+		"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"
+	],
+	ADMIN: [
+		"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"
+	],
+	STAFF: [
+		"product:rw",
+		"category:rw",
+		"order:rw",
+		"claim:rw",
+		"inquiry:rw",
+		"review:rw",
+		"customer:r",
+		"promotion:r",
+		"flow:r"
+	]
+};
 //#endregion
-//#region src/schemas/category.ts
-const categoryProductSortSchema = z.enum([
-	"RECENT",
-	"POPULAR",
-	"PRICE_LOW",
-	"PRICE_HIGH",
-	"NAME"
-]);
-const categorySchema = z.object({
-	categoryId: z.string(),
-	storeId: z.string(),
-	name: z.string(),
-	parentId: z.string().nullable(),
-	path: z.string(),
-	depth: z.number().int().min(1).max(4),
-	leaf: z.boolean(),
-	sortOrder: z.number().int(),
-	visible: z.boolean(),
-	showPc: z.boolean(),
-	showMobile: z.boolean(),
-	productSort: categoryProductSortSchema,
-	metaTitle: z.string().nullable(),
-	metaDescription: z.string().nullable(),
-	metaKeywords: z.string().nullable(),
-	flowId: z.string().nullable().optional().describe("주문 흐름(이슈 #115) — 맨 아래 카테고리에만 있다. 흐름을 지정하지 않은 상품이 쓴다. null이면 기본 흐름"),
-	createdAt: z.string(),
-	updatedAt: z.string()
-});
-const categoryTreeNodeSchema = categorySchema.extend({ children: z.lazy(() => z.array(categoryTreeNodeSchema)) });
-const categoryWithPathSchema = categorySchema.extend({
-	fullPath: z.string(),
-	ancestors: z.array(categorySchema),
-	childCount: z.number().int()
-});
-const categorySearchResultSchema = categorySchema.extend({
-	fullPath: z.string(),
-	ancestors: z.array(categorySchema)
-});
-const categoryAttributeSchema = z.object({
-	attributeId: z.string(),
-	name: z.string(),
-	required: z.boolean(),
-	inputType: z.enum([
-		"SELECT",
-		"MULTI_SELECT",
-		"TEXT",
-		"NUMBER"
-	]),
-	unit: z.string().nullable(),
-	allowedValues: z.array(z.string()).optional()
-});
-const categoryCreateRequestSchema = z.object({
-	name: z.string().min(1).max(100),
-	parentId: z.string().nullable().optional(),
-	sortOrder: z.number().int().optional(),
-	visible: z.boolean().optional(),
-	showPc: z.boolean().optional(),
-	showMobile: z.boolean().optional(),
-	productSort: categoryProductSortSchema.optional(),
-	metaTitle: z.string().max(100).nullable().optional(),
-	metaDescription: z.string().max(300).nullable().optional(),
-	metaKeywords: z.string().max(200).nullable().optional()
-});
-const categoryPatchRequestSchema = z.object({
-	name: z.string().min(1).max(100).optional(),
-	parentId: z.string().nullable().optional(),
-	sortOrder: z.number().int().optional(),
-	visible: z.boolean().optional(),
-	showPc: z.boolean().optional(),
-	showMobile: z.boolean().optional(),
-	productSort: categoryProductSortSchema.optional(),
-	metaTitle: z.string().max(100).nullable().optional(),
-	metaDescription: z.string().max(300).nullable().optional(),
-	metaKeywords: z.string().max(200).nullable().optional(),
-	flowId: z.string().nullable().optional().describe("주문 흐름(이슈 #115) — 게시한 흐름 id, null이면 기본 흐름. 맨 아래 카테고리에만 지정한다(400 `CATEGORY_NOT_LEAF`). 게시하지 않은 흐름은 409 `FLOW_NOT_PUBLISHED`")
-});
-const categoryDeleteStrategySchema = z.enum(["reparent", "cascade"]);
+//#region src/schemas/scope-descriptions.ts
 /**
-* `GET /v1/categories` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열). 응답 형태가 쿼리로 갈린다:
-* `q`가 있으면 검색 결과(`CategorySearchResult[]`), 아니면 `tree=true`일 때 트리(`CategoryTreeNode[]`),
-* 둘 다 아니면 목록(`Category[]`)이다.
+* 스코프를 사람이 읽는 문장 (이슈 #22) — 앱 설치 동의 화면(accounts), 상점 플랫폼 설치 앱 권한 표시, 유저 문서 스코프 레퍼런스가
+* 같은 문장을 쓴다. 읽기(`r`)와 쓰기(`rw`)를 따로 둔다 — 동의 화면은 쓰기를 강조한다.
 */
-const categoryListQuerySchema = z.object({
-	parentId: z.string().optional().describe("이 카테고리의 직계 자식만. 생략하면 최상위 카테고리. `flat=true`면 무시"),
-	flat: z.enum(["true", "false"]).optional().describe("`true`면 전체 카테고리를 깊이·순서대로 평탄화"),
-	tree: z.enum(["true", "false"]).optional().describe("`true`면 최상위부터 `children`을 채운 트리(`CategoryTreeNode[]`)를 돌려준다"),
-	q: z.string().optional().describe("이름 검색(포함, 대소문자 무시). 주면 `fullPath`·`ancestors`가 붙은 검색 결과를 돌려준다")
-});
-/** `DELETE /v1/categories/{categoryId}` 쿼리 — OpenAPI 문서용 형태 */
-const categoryDeleteQuerySchema = z.object({ strategy: categoryDeleteStrategySchema.optional().describe("하위 카테고리·연결 상품 처리 방식. 생략하면 둘 중 하나라도 있을 때 409 `CATEGORY_NOT_EMPTY`다. `reparent`는 직계 자식을 삭제할 카테고리의 부모로 옮기고, `cascade`는 서브트리를 삭제하고 연결 상품을 미분류로 둔다") });
+const SCOPE_DESCRIPTIONS = {
+	product: {
+		r: "상품 정보를 읽습니다",
+		rw: "상품을 만들고 수정합니다"
+	},
+	category: {
+		r: "카테고리를 읽습니다",
+		rw: "카테고리를 만들고 수정합니다"
+	},
+	order: {
+		r: "주문을 읽습니다",
+		rw: "주문 상태를 바꿉니다(발송·배송완료·취소 등)"
+	},
+	claim: {
+		r: "취소·반품·교환 요청을 읽습니다",
+		rw: "취소·반품·교환을 처리합니다"
+	},
+	inquiry: {
+		r: "상품 문의를 읽습니다",
+		rw: "상품 문의에 답합니다"
+	},
+	review: {
+		r: "리뷰를 읽습니다",
+		rw: "리뷰를 관리합니다"
+	},
+	settlement: {
+		r: "매출 리포트를 읽습니다",
+		rw: "매출 리포트를 읽습니다"
+	},
+	analytics: {
+		r: "방문·구매 분석 데이터를 읽습니다",
+		rw: "방문·구매 분석 데이터를 읽습니다"
+	},
+	webhook: {
+		r: "웹훅 설정을 읽습니다",
+		rw: "웹훅을 만들고 수정합니다"
+	},
+	store: {
+		r: "상점 정보를 읽습니다",
+		rw: "상점 설정을 수정합니다"
+	},
+	member: {
+		r: "구성원 목록을 읽습니다",
+		rw: "구성원을 초대하고 역할을 바꿉니다"
+	},
+	customer: {
+		r: "고객 정보(이름·연락처·주소)를 읽습니다",
+		rw: "고객 정보를 수정합니다"
+	},
+	audit: {
+		r: "감사 로그를 읽습니다",
+		rw: "감사 로그를 읽습니다"
+	},
+	promotion: {
+		r: "쿠폰·적립금 설정을 읽습니다",
+		rw: "쿠폰을 발급하고 적립금을 지급합니다"
+	},
+	storefront: {
+		r: "스토어프론트 설정을 읽습니다",
+		rw: "스토어프론트를 편집하고 발행합니다"
+	},
+	flow: {
+		r: "주문 흐름 설정을 읽습니다",
+		rw: "주문 흐름을 만들고 수정합니다"
+	}
+};
+/** `{resource}:{r|rw}` → 문장. 카탈로그에 없는 스코프는 null */
+function describeScope(scope) {
+	const [resource, access] = scope.split(":");
+	if (!resource || !(resource in STORE_SCOPE_RESOURCES)) return null;
+	const allowed = STORE_SCOPE_RESOURCES[resource];
+	if (access !== "r" && access !== "rw") return null;
+	if (!allowed.includes(access)) return null;
+	return SCOPE_DESCRIPTIONS[resource][access];
+}
 //#endregion
 //#region src/schemas/commerce-number.ts
 /**
@@ -2209,23 +2262,926 @@ const discountRequestSchema = z.object({
 	endAt: z.string().optional()
 });
 //#endregion
-//#region src/schemas/collection.ts
+//#region src/schemas/webhook-event.ts
+const envelopeFields = {
+	id: z.string().describe("이벤트 ID (`evt_…`, 테스트 전송은 `evt_test_…`). 중복 제거 키"),
+	createdAt: z.string().describe("이벤트 발생 일시 (ISO 8601)"),
+	storeId: z.string().describe("이벤트가 발생한 상점 ID"),
+	sequence: z.number().int().positive().optional().describe("리소스별 순번. 같은 주문·클레임·문의·리뷰·상품의 이벤트마다 1씩 커진다. 도착 순서는 보장하지 않으므로 같은 리소스의 이벤트는 이 값으로 정렬한다. 이 필드가 생기기 전의 이벤트와 테스트 전송에는 없다")
+};
+const orderWebhookEventDataSchema = z.object({
+	orderId: z.string().describe("주문 ID"),
+	orderNo: z.string().nullable().optional().default(null).describe("주문번호(이슈 #107) — 숫자 14자리. 이 필드가 없는 이전 이벤트와 번호 체계 이전 주문은 null로 읽는다"),
+	status: orderItemStatusSchema.describe("이벤트 발생 시점의 주문 대표 상태"),
+	testPayment: z.boolean().optional().default(false).describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았다. 이 필드가 없는 이전 이벤트는 false로 읽는다"),
+	couponDiscountAmount: z.number().int().optional().default(0).describe("주문이 받은 상품·주문 쿠폰 할인 합계 (원). 즉시할인(`discountAmount`)과 별개다. 쿠폰이 없거나 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
+	pointAmount: z.number().int().optional().default(0).describe("주문에 쓴 적립금 (원, #93). 적립금을 쓰지 않았거나 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
+	orderItemId: z.string().optional().describe("이벤트를 만든 주문상품 ID. 배송 없는 상품 제공으로 보내는 `ORDER.DELIVERED`에만 실린다. 택배 배송완료와 그 밖의 주문 이벤트에는 없다"),
+	fulfillmentSnapshot: orderItemFulfillmentSnapshotResponseSchema.optional().describe("이벤트를 만든 주문상품의 주문 시점 이행 스냅샷(주문상품 응답의 `fulfillmentSnapshot`과 같다, 이슈 #57). 배송 없는 상품의 제공 완료는 `ORDER.DELIVERED`로도 오고 `type`이 `MANUAL`이다. `orderItemId`가 있는 이벤트에만 실린다"),
+	itemOptions: z.array(z.object({
+		orderItemId: z.string(),
+		optionSelections: z.array(optionSelectionSchema),
+		customInputs: z.array(customInputValueSchema)
+	})).optional().describe("추가 선택·직접 입력이 있는 주문상품의 주문 시점 선택값(이슈 #59, 주문상품 응답의 `optionSelections`·`customInputs`와 같다). `ORDER.PAID`에만 실리고 그런 주문상품이 없으면 없다")
+});
 /**
-* 컬렉션 (이슈 #83) — 상품을 어디에 보여 줄지 정하는 묶음이다. 카테고리는 상품이 무엇인지를 정하고 상품당 하나지만, 컬렉션은
-* 다대다다. 이벤트·기획전은 기간이 있는 직접 선택 컬렉션이다. 권한은 카테고리와 같다(`category:r`·`category:rw`).
-*
-* 유형은 만들 때 정하고 바꿀 수 없다. 직접 선택(`MANUAL`)은 셀러가 상품을 담고 순서를 정하고, 조건 자동(`AUTOMATIC`)은 조건(`rules`)을
-* 모두 만족하는 판매 중 상품을 조회할 때마다 계산한다(결과를 저장하지 않는다). 응답의 `type`은 값이 늘 수 있어 문자열이다.
+* `ORDER.FULFILLED` — 배송 없는 주문상품(`MANUAL`)을 제공했다(이슈 #48). 셀러의 제공 처리
+* (`POST /v1/order-items/{orderItemId}/fulfill`)로 온다. 기존 구독자를 위해 같은 순간 `ORDER.DELIVERED`도 함께 보낸다.
 */
-/** 상점당 컬렉션 최대 개수 — 넘으면 409 `COLLECTION_LIMIT_EXCEEDED` */
-const MAX_COLLECTIONS = 200;
-/** 직접 선택 컬렉션 하나에 담는 상품 최대 개수 — 넘으면 409 `COLLECTION_PRODUCT_LIMIT_EXCEEDED` */
-const MAX_COLLECTION_PRODUCTS = 1e3;
-/** 상품 뒤에 붙이기(`POST /v1/collections/{id}/products`) 한 번에 보내는 상품 최대 개수 */
-const MAX_COLLECTION_PRODUCTS_PER_ADD = 500;
-/** 제목 최대 글자 수 */
-const MAX_COLLECTION_TITLE = 60;
-/** 설명 최대 글자 수 */
+const orderFulfilledWebhookEventDataSchema = z.object({
+	orderId: z.string().describe("주문 ID"),
+	orderNo: z.string().nullable().optional().default(null).describe("주문번호(이슈 #107) — 숫자 14자리. 이 필드가 없는 이전 이벤트와 번호 체계 이전 주문은 null로 읽는다"),
+	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`과 같다"),
+	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았다")
+});
+/**
+* `ORDER.CANCELED` — 셀러 직권취소(`POST /v1/order-items/{orderItemId}/cancel`)로 주문상품이 취소됐다.
+* 수량 단위 부분 취소도 이 이벤트다(`quantity` < 주문 수량이면 주문상품 상태가 그대로다).
+* 구매자가 신청한 취소·반품은 `CLAIM.*` 이벤트로 온다.
+*/
+const orderCanceledWebhookEventDataSchema = z.object({
+	orderId: z.string().describe("주문 ID"),
+	orderNo: z.string().nullable().optional().default(null).describe("주문번호(이슈 #107) — 숫자 14자리. 이 필드가 없는 이전 이벤트와 번호 체계 이전 주문은 null로 읽는다"),
+	orderItemId: z.string().describe("취소한 주문 상품 ID"),
+	status: orderItemStatusSchema.describe("취소 뒤 주문 대표 상태. 모든 주문 상품이 취소됐으면 `CANCELED`다"),
+	itemStatus: orderItemStatusSchema.describe("취소 뒤 주문 상품 상태. 전 수량이 취소됐으면 `CANCELED`, 일부만 취소했으면 원래 상태다"),
+	reason: z.string().describe("취소 사유 코드 — 판매자 취소 요청의 `reason`(`OUT_OF_STOCK`·`PRICE_ERROR`·`DELIVERY_IMPOSSIBLE`·`ETC`). 사유가 늘어날 수 있어 문자열이다. 모르는 값은 `ETC`처럼 다룬다"),
+	quantity: z.number().int().describe("이번에 취소한 수량"),
+	canceledQuantity: z.number().int().describe("취소 후 누적 취소 수량"),
+	refundAmount: z.number().int().describe("환불액 (원). 수량 비율 상품 실결제 금액(쿠폰 배분을 뺀 금액) + 배송비 환불 − 조건부 무료배송 미달 차감 + 되돌린 쿠폰 차감(`couponChargeRefundAmount`)이다. 결제사 환불 결과는 결제 내역(`GET /v1/payments/{paymentId}`)으로 확인한다"),
+	deliveryFeeRefundAmount: z.number().int().describe("환불액에 포함된 배송비 (원)"),
+	deliveryFeeChargeAmount: z.number().int().describe("환불액에서 뺀 배송비 (원) — 조건부 무료배송 기준 미달 차감"),
+	couponChargeAmount: z.number().int().optional().default(0).describe("환불액에서 뺀 쿠폰 조건 미달 차감 (원). 판매자 취소는 차감하지 않으므로 늘 0이다. 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
+	couponChargeRefundAmount: z.number().int().optional().default(0).describe("환불액에 더한 금액 (원) — 앞선 환불에서 뺀 쿠폰 조건 미달 차감을 되돌린 몫이다. 전량 취소면 누적 차감이 모두 되돌아간다. 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
+	pointRefundAmount: z.number().int().optional().default(0).describe("돌려준 적립금 (원, #93) — 결제에 쓴 적립금 중 이번 취소·반품 수량의 몫이다. 현금 환불(`refundAmount`)과 별개다. 차감은 현금에서 먼저 빼고 모자란 몫만 여기서 뺀다. 적립금을 쓰지 않은 주문과 이 필드가 없는 이전 응답·이벤트는 0으로 읽는다"),
+	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았다")
+});
+const claimWebhookEventDataSchema = z.object({
+	claimId: z.string().describe("클레임 ID"),
+	claimNo: z.string().nullable().optional().default(null).describe("클레임번호(이슈 #107) — `C` + YYMMDD + 숫자 8자리. 이 필드가 없는 이전 이벤트와 번호 체계 이전 클레임은 null로 읽는다"),
+	orderId: z.string().describe("주문 ID"),
+	orderItemId: z.string().describe("클레임 대상 주문 상품 ID"),
+	claimType: claimTypeSchema.describe("클레임 유형"),
+	status: claimStatusSchema.describe("이벤트 발생 시점의 클레임 상태"),
+	quantity: z.number().int().optional().default(0).describe("클레임 대상 수량. 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
+	refundAmount: z.number().int().nullable().optional().default(null).describe("환불액 (원). 배송비 환불을 포함하고 배송비 차감·추가 차감을 뺀 실제 금액이다. 환불이 확정되지 않은 접수 이벤트는 예상 환불액이고, 교환처럼 환불이 없으면 null이다"),
+	deliveryFeeRefundAmount: z.number().int().optional().default(0).describe("환불액에 포함된 배송비 (원). 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
+	deliveryFeeChargeAmount: z.number().int().optional().default(0).describe("환불액에서 뺀 배송비 (원) — 반품·교환 배송비와 조건부 무료배송 미달 차감의 합. 셀러가 승인에 넣은 추가 차감은 `deductAmount`로 따로 온다. 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
+	deductAmount: z.number().int().optional().default(0).describe("환불액에서 뺀 추가 차감 (원) — 셀러가 클레임 승인에 넣은 금액이다(상품 훼손 등). 배송비 차감과 별개이므로 `deliveryFeeChargeAmount`와 더해서 뺀다. 접수 이벤트와 이 필드가 없는 이전 이벤트는 0이다"),
+	couponChargeAmount: z.number().int().optional().default(0).describe("환불액에서 뺀 쿠폰 조건 미달 차감 (원) — 일부 취소·반품으로 남은 주문상품이 쿠폰 조건(최소 주문 금액 등)을 잃어 남은 주문상품이 받던 할인을 뺀 금액이다. 배송비 차감·추가 차감과 별개다. 접수 이벤트는 예상값이다. 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
+	couponChargeRefundAmount: z.number().int().optional().default(0).describe("환불액에 더한 금액 (원) — 앞선 환불에서 뺀 쿠폰 조건 미달 차감을 되돌린 몫이다. 접수 이벤트는 예상값이다. 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
+	pointRefundAmount: z.number().int().optional().default(0).describe("돌려준 적립금 (원, #93) — 결제에 쓴 적립금 중 이번 취소·반품 수량의 몫이다. 현금 환불(`refundAmount`)과 별개다. 차감은 현금에서 먼저 빼고 모자란 몫만 여기서 뺀다. 적립금을 쓰지 않은 주문과 이 필드가 없는 이전 응답·이벤트는 0으로 읽는다"),
+	testPayment: z.boolean().optional().default(false).describe("테스트 결제(샌드박스 결제) 주문의 클레임인가. 이 필드가 없는 이전 이벤트는 false로 읽는다")
+});
+const inquiryWebhookEventDataSchema = z.object({
+	inquiryId: z.string().describe("상품 문의 ID"),
+	productId: z.string().describe("상품 ID")
+});
+const reviewWebhookEventDataSchema = z.object({
+	reviewId: z.string().describe("리뷰 ID"),
+	productId: z.string().describe("상품 ID"),
+	rating: z.number().int().min(1).max(5).describe("별점 (1~5)")
+});
+const productOutOfStockWebhookEventDataSchema = z.object({
+	productId: z.string().describe("상품 ID"),
+	variantId: z.string().describe("재고가 0이 된 판매 단위(variant) ID. 주문 상품의 `optionId`와 같은 값 공간이다")
+});
+const orderWebhookEventSchema = z.object({
+	...envelopeFields,
+	type: z.enum([
+		"ORDER.PAID",
+		"ORDER.CONFIRMED",
+		"ORDER.DISPATCHED",
+		"ORDER.DELIVERED",
+		"ORDER.PURCHASE_DECIDED",
+		"ORDER.ADDRESS_CHANGE_REQUESTED"
+	]),
+	data: orderWebhookEventDataSchema
+});
+const orderFulfilledWebhookEventSchema = z.object({
+	...envelopeFields,
+	type: z.literal("ORDER.FULFILLED"),
+	data: orderFulfilledWebhookEventDataSchema
+});
+const orderCanceledWebhookEventSchema = z.object({
+	...envelopeFields,
+	type: z.literal("ORDER.CANCELED"),
+	data: orderCanceledWebhookEventDataSchema
+});
+const claimWebhookEventSchema = z.object({
+	...envelopeFields,
+	type: z.enum([
+		"CLAIM.CANCEL_REQUESTED",
+		"CLAIM.RETURN_REQUESTED",
+		"CLAIM.EXCHANGE_REQUESTED",
+		"CLAIM.COMPLETED"
+	]),
+	data: claimWebhookEventDataSchema
+});
+const inquiryWebhookEventSchema = z.object({
+	...envelopeFields,
+	type: z.literal("INQUIRY.CREATED"),
+	data: inquiryWebhookEventDataSchema
+});
+const reviewWebhookEventSchema = z.object({
+	...envelopeFields,
+	type: z.literal("REVIEW.CREATED"),
+	data: reviewWebhookEventDataSchema
+});
+const productOutOfStockWebhookEventSchema = z.object({
+	...envelopeFields,
+	type: z.literal("PRODUCT.OUT_OF_STOCK"),
+	data: productOutOfStockWebhookEventDataSchema
+});
+/**
+* 플로우 알림(이슈 #115) — 상점이 플로우에 둔 알림 블록(`core.notify`, 채널 `webhook`)이 보낸다. 구매자 알림(알림톡·메일)은 이 이벤트를 받아
+* 상점이 보낸다(플랫폼은 구매자에게 직접 보내지 않는다). 개인정보는 싣지 않는다
+*/
+const flowNotificationWebhookEventDataSchema = z.object({
+	orderId: z.string().describe("주문 ID"),
+	orderItemIds: z.array(z.string()).describe("이 알림의 주문상품(묶음 진행이면 여럿)"),
+	event: z.string().describe("상점이 블록에 둔 알림 이름(`custom.<이름>`)"),
+	flowId: z.string(),
+	flowVersion: z.number().int(),
+	state: z.string().describe("알림을 보낸 전이의 도착 상태 키")
+});
+const flowNotificationWebhookEventSchema = z.object({
+	...envelopeFields,
+	type: z.literal("ORDER.FLOW_NOTIFICATION"),
+	data: flowNotificationWebhookEventDataSchema
+});
+/**
+* 흐름 상태 변경(이슈 #115) — 주문상품의 흐름 상태(노드)가 바뀔 때마다 온다. 공개 상태(`ORDER.*`)가 같아도 상점 흐름의 단계가 바뀌면 온다
+* (시안 확인 → 제작중). 묶음 진행이면 `orderItemIds`가 여럿이다. 개인정보는 싣지 않는다
+*/
+const flowStateChangedWebhookEventDataSchema = z.object({
+	orderId: z.string().describe("주문 ID"),
+	orderItemIds: z.array(z.string()).describe("상태가 바뀐 주문상품(묶음 진행이면 여럿)"),
+	flowId: z.string(),
+	flowVersion: z.number().int(),
+	from: z.string().nullable().describe("이전 상태 키. 흐름이 막 시작했으면 null"),
+	to: z.string().describe("새 상태 키"),
+	label: z.string().describe("새 상태의 셀러용 이름"),
+	coreStatus: z.string().nullable().describe("새 상태의 공개 상태. 공개 상태를 바꾸지 않는 단계면 null"),
+	changedAt: z.string().describe("바뀐 시각")
+});
+const flowStateChangedWebhookEventSchema = z.object({
+	...envelopeFields,
+	type: z.literal("ORDER.FLOW_STATE_CHANGED"),
+	data: flowStateChangedWebhookEventDataSchema
+});
+/** 웹훅 요청 본문. `type`으로 판별하며 `data` 형태가 타입별로 다르다 */
+const webhookEventSchema = z.discriminatedUnion("type", [
+	orderWebhookEventSchema,
+	orderFulfilledWebhookEventSchema,
+	orderCanceledWebhookEventSchema,
+	claimWebhookEventSchema,
+	inquiryWebhookEventSchema,
+	reviewWebhookEventSchema,
+	productOutOfStockWebhookEventSchema,
+	flowNotificationWebhookEventSchema,
+	flowStateChangedWebhookEventSchema
+]).describe("웹훅 요청 본문 (얇은 이벤트). 개인정보를 싣지 않으며 `data`의 id로 관리 API를 조회한다");
+/**
+* 알려진 웹훅 이벤트 타입 — `webhookEventSchema`의 판별 값 목록(이 SDK 버전이 아는 것).
+* 서버는 새 타입을 구독한 엔드포인트에만 보내지만, 구독을 더 넓힌 수신자를 위해 `parseWebhookEvent`가 모르는 타입을 따로 받는다.
+*/
+const KNOWN_WEBHOOK_EVENT_TYPES = webhookEventSchema.options.flatMap((option) => {
+	const type = option.shape.type;
+	return "options" in type ? [...type.options] : [type.value];
+});
+/** 이 SDK 버전이 모르는 이벤트 — 봉투만 검증하고 `data`는 그대로 둔다 */
+const unknownWebhookEventSchema = z.object({
+	...envelopeFields,
+	type: z.string().min(1),
+	data: z.unknown()
+});
+/**
+* 웹훅 본문을 `type`으로 먼저 판별해 읽는다(이슈 #115 결정 25). 알려진 타입은 그 타입의 스키마로 엄격하게 읽고 틀리면 던진다 —
+* `z.union([known, unknown])`처럼 읽으면 알려진 타입의 파싱 실패가 `known: false`로 조용히 새어 수신자가 처리할 이벤트를 버린다.
+* 모르는 타입은 봉투만 검증해 `known: false`로 돌려준다(새 이벤트에 옛 SDK가 깨지지 않는다).
+*/
+function parseWebhookEvent(body) {
+	const type = body?.type;
+	if (typeof type === "string" && KNOWN_WEBHOOK_EVENT_TYPES.includes(type)) return {
+		known: true,
+		event: webhookEventSchema.parse(body)
+	};
+	return {
+		known: false,
+		event: unknownWebhookEventSchema.parse(body)
+	};
+}
+//#endregion
+//#region src/schemas/app-manifest.ts
+/**
+* 서드파티 앱 매니페스트 `sayren.app.json` (이슈 #22) — CLI(`sayren app`)·api(빌드 `VERIFY`·버전 판정·동의 화면 자료)·런타임이
+* 같은 원천을 쓴다. 매니페스트는 정적 JSON이고 빌드 없이 읽는다.
+*
+* 기능 하나는 **capability** 하나다(`APP_CAPABILITIES`). capability는 매니페스트 조각·동의 문단·넓어짐 판정(재동의 조건)을 한 곳에 둔다.
+* 새 기능(예약 작업·공개 HTTP·설치 저장소·외부 런타임)은 여기에 항목 하나를 더하고, 설치·버전·정지·감사·사용량 코드는 건드리지 않는다.
+* 모르는 키는 거부한다(`strictObject`) — 아직 없는 capability를 쓴 매니페스트는 빌드가 분명히 실패한다.
+*/
+/** 앱 handle — 전역 유일, 앱 도메인의 라벨(`{handle}.{앱 도메인}`). 상점 코드와 같은 형식, 3~40자 */
+const APP_HANDLE_PATTERN = /^[a-z0-9](?:[a-z0-9-]{1,38}[a-z0-9])$/;
+/** handle로 쓸 수 없는 라벨 — 플랫폼 호스트·혼동되는 이름 */
+const APP_RESERVED_HANDLES = /* @__PURE__ */ new Set([
+	"www",
+	"api",
+	"app",
+	"apps",
+	"admin",
+	"accounts",
+	"store",
+	"mcp",
+	"docs",
+	"sayren",
+	"preview",
+	"runner",
+	"static",
+	"cdn"
+]);
+const appHandleSchema = z.string().regex(APP_HANDLE_PATTERN, "앱 handle은 소문자·숫자·하이픈 3~40자입니다").refine((value) => !APP_RESERVED_HANDLES.has(value) && !value.endsWith("-preview"), { message: "쓸 수 없는 handle입니다" });
+/**
+* 설치 앱에 열지 않는 스코프 — 구성원(초대로 권한 상승), 상점 설정 전반(`storefrontOrigins`로 소셜 로그인 code 가로채기), 스토어 웹훅
+* (앱 구독으로 대체, 제거 뒤에도 남는 문제), 스토어프론트 편집·발행, 감사 로그. 커스텀 연동은 계정 액세스 토큰(#71)이 맡는다
+*/
+const NON_INSTALLABLE_SCOPES = /* @__PURE__ */ new Set([
+	"member:r",
+	"member:rw",
+	"store:rw",
+	"webhook:r",
+	"webhook:rw",
+	"storefront:r",
+	"storefront:rw",
+	"audit:r"
+]);
+/** 앱이 요청할 수 있는 스코프 — 카탈로그 전체에서 위를 뺀 것 */
+const INSTALLABLE_SCOPES = Object.entries(STORE_SCOPE_RESOURCES).flatMap(([resource, accesses]) => accesses.map((access) => `${resource}:${access}`)).filter((scope) => !NON_INSTALLABLE_SCOPES.has(scope));
+function isInstallableScope(scope) {
+	return isStoreScope(scope) && !NON_INSTALLABLE_SCOPES.has(scope);
+}
+const appScopeSchema = z.string().refine(isInstallableScope, { message: "앱이 요청할 수 없는 스코프입니다" });
+/**
+* 앱 생명주기 이벤트 — 웹훅 카탈로그 밖이고 앱 코드만 받는다. `APP.UNINSTALLED`·`APP.STORE_REDACT`는 설치가 끝난 뒤라 토큰 없이 온다
+* (`APP.STORE_REDACT`는 제거 48시간 뒤).
+*/
+const APP_LIFECYCLE_EVENT_TYPES = [
+	"APP.INSTALLED",
+	"APP.UNINSTALLED",
+	"APP.SETTINGS_UPDATED",
+	"APP.SCOPES_UPDATED",
+	"APP.STORE_REDACT",
+	"APP.CUSTOMER_REDACT"
+];
+/**
+* 이벤트를 받는 데 필요한 스코프 — 동의 스코프가 이것을 덮지 못하면 분배하지 않고, 매니페스트 `scopes`가 덮지 못하면 빌드가 실패한다.
+* 생명주기 이벤트는 스코프가 없다(null). 새 웹훅 이벤트를 더하면 이 표도 더해야 테스트가 통과한다
+*/
+const APP_EVENT_SCOPES = {
+	"ORDER.PAID": "order:r",
+	"ORDER.CONFIRMED": "order:r",
+	"ORDER.DISPATCHED": "order:r",
+	"ORDER.DELIVERED": "order:r",
+	"ORDER.PURCHASE_DECIDED": "order:r",
+	"ORDER.ADDRESS_CHANGE_REQUESTED": "order:r",
+	"ORDER.FULFILLED": "order:r",
+	"ORDER.CANCELED": "order:r",
+	"ORDER.FLOW_NOTIFICATION": "order:r",
+	"ORDER.FLOW_STATE_CHANGED": "order:r",
+	"CLAIM.CANCEL_REQUESTED": "claim:r",
+	"CLAIM.RETURN_REQUESTED": "claim:r",
+	"CLAIM.EXCHANGE_REQUESTED": "claim:r",
+	"CLAIM.COMPLETED": "claim:r",
+	"INQUIRY.CREATED": "inquiry:r",
+	"REVIEW.CREATED": "review:r",
+	"PRODUCT.OUT_OF_STOCK": "product:r",
+	"APP.INSTALLED": null,
+	"APP.UNINSTALLED": null,
+	"APP.SETTINGS_UPDATED": null,
+	"APP.SCOPES_UPDATED": null,
+	"APP.STORE_REDACT": null,
+	"APP.CUSTOMER_REDACT": null
+};
+const APP_EVENT_TYPES = [...KNOWN_WEBHOOK_EVENT_TYPES, ...APP_LIFECYCLE_EVENT_TYPES];
+const appEventTypeSchema = z.enum(APP_EVENT_TYPES);
+/** 동의 스코프가 이벤트를 받을 수 있는가 — `rw`는 `r`을 함의한다 */
+function scopesCoverEvent(scopes, event) {
+	const required = APP_EVENT_SCOPES[event];
+	if (required === null) return true;
+	const [resource] = required.split(":");
+	return scopes.includes(required) || scopes.includes(`${resource}:rw`);
+}
+/**
+* 외부 호출 호스트 — https·443·소문자 호스트명. 와일드카드는 한 단계(`*.example.com`)만. IP·`localhost`·sayren 플랫폼 호스트는
+* 받지 않는다(내부 호스트 차단은 outbound Worker가 다시 본다 — 여기는 매니페스트 형식). 253자 이하, 라벨 2개 이상
+*/
+const HOST_LABEL = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
+const TLD = /^(?:[a-z]{2,63}|xn--[a-z0-9-]{1,59})$/;
+const APP_NETWORK_DENIED_SUFFIXES = [
+	"sayren.app",
+	"sayren.co",
+	"avarlabs.com",
+	"localhost",
+	"local",
+	"internal"
+];
+function appNetworkHostProblem(raw) {
+	const host = raw.trim();
+	if (host !== raw || host !== host.toLowerCase()) return "호스트는 소문자이고 앞뒤 공백이 없어야 합니다";
+	if (host.length > 253) return "호스트가 너무 깁니다";
+	if (/^\d+\.\d+\.\d+\.\d+$/.test(host) || host.includes(":")) return "IP 주소는 쓸 수 없습니다";
+	const labels = host.split(".");
+	const named = labels[0] === "*" ? labels.slice(1) : labels;
+	if (named.length < 2) return "호스트는 라벨이 둘 이상이어야 합니다";
+	if (!named.every((label) => HOST_LABEL.test(label))) return "호스트 형식이 맞지 않습니다";
+	if (!TLD.test(named[named.length - 1])) return "최상위 도메인 형식이 맞지 않습니다";
+	const apex = named.join(".");
+	for (const suffix of APP_NETWORK_DENIED_SUFFIXES) if (apex === suffix || apex.endsWith(`.${suffix}`)) return "sayren 플랫폼·내부 호스트는 쓸 수 없습니다";
+	return null;
+}
+const appNetworkHostSchema = z.string().superRefine((value, ctx) => {
+	const problem = appNetworkHostProblem(value);
+	if (problem) ctx.addIssue({
+		code: "custom",
+		message: problem
+	});
+});
+/** 셀러가 콘솔에서 채우는 설정 필드 — 콘솔이 폼을 그릴 수 있는 네 형식만 */
+const APP_SETTING_FIELD_TYPES = [
+	"string",
+	"number",
+	"boolean",
+	"select"
+];
+const APP_SETTINGS_MAX_FIELDS = 30;
+const APP_SETTING_KEY_PATTERN = /^[a-zA-Z][a-zA-Z0-9_]{0,39}$/;
+const appSettingFieldSchema = z.strictObject({
+	type: z.enum(APP_SETTING_FIELD_TYPES),
+	label: z.string().trim().min(1).max(60),
+	description: z.string().trim().max(200).optional(),
+	required: z.boolean().optional(),
+	/** 비밀 값 — 암호화 저장, 응답에서 가린다, 에이전트·토큰으로 읽을 수 없다. `string`만 */
+	secret: z.boolean().optional(),
+	/** `select`의 선택지 */
+	options: z.array(z.strictObject({
+		value: z.string().min(1).max(60),
+		label: z.string().trim().min(1).max(60)
+	})).min(1).max(50).optional(),
+	default: z.union([
+		z.string(),
+		z.number(),
+		z.boolean()
+	]).optional()
+});
+const APP_SECRET_NAME_PATTERN = /^[A-Z][A-Z0-9_]{0,63}$/;
+const APP_SECRETS_MAX = 20;
+const APP_EVENTS_MAX = 50;
+const APP_NETWORK_HOSTS_MAX = 20;
+const appManifestSchema = z.strictObject({
+	handle: appHandleSchema,
+	name: z.string().trim().min(1).max(60),
+	description: z.string().trim().max(500).optional(),
+	/** https 이미지 주소. 동의 화면·상점 플랫폼 목록에 보인다 */
+	iconUrl: z.url().startsWith("https://").optional(),
+	supportEmail: z.email().optional(),
+	/** 실행 위치 — A1은 코드 업로드 앱만. 외부 런타임(`external`)은 A3에서 연다 */
+	runtime: z.literal("code").default("code"),
+	/** 설치 때 전체 동의하는 스코프 */
+	scopes: z.array(appScopeSchema).max(32).default([]),
+	network: z.strictObject({ hosts: z.array(appNetworkHostSchema).max(20) }).default({ hosts: [] }),
+	/** 이벤트 함수 구독 */
+	events: z.array(appEventTypeSchema).max(50).default([]),
+	ui: z.strictObject({ 
+	/** 상점 플랫폼 앱 화면(iframe) — 정적 SPA 진입 파일 */
+adminPage: z.strictObject({ entry: z.string().regex(/^ui\/[A-Za-z0-9._/-]+\.html$/) }) }).optional(),
+	settings: z.record(z.string().regex(APP_SETTING_KEY_PATTERN), appSettingFieldSchema).refine((fields) => Object.keys(fields).length <= 30, { message: `설정 필드는 30개까지입니다` }).default({}),
+	/** 개발자 비밀 값 이름 — 값은 CLI(`sayren app secret put`)로 따로 넣는다 */
+	secrets: z.array(z.string().regex(APP_SECRET_NAME_PATTERN)).max(20).default([])
+});
+/** 소스 안 비밀 값 형식(매뉴얼 「빌드」 `SECRET_IN_SOURCE`) — 번들에 들어가면 막는다. CLI `app verify`와 api 빌드 `BUNDLE`이 같은 표를 쓴다 */
+const APP_SECRET_PATTERNS = [
+	/sy_pat_[A-Za-z0-9]{8,}/,
+	/\b(?:test|live)_sk_[A-Za-z0-9]{8,}/,
+	/-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----/,
+	/\bsak_[a-z0-9]+_[0-9a-f]{32}\b/
+];
+/** 서버 번들 gzip 상한(3MiB)·화면 정적 파일 상한 — 매뉴얼 「빌드 › 한도」 */
+const APP_SERVER_BUNDLE_MAX_GZIP_BYTES = 3145728;
+const APP_UI_MAX_BYTES = 26214400;
+const APP_UI_MAX_FILES = 2e3;
+/** 스키마가 보지 못하는 필드 사이 규칙 — 빌드 `VERIFY`·CLI `app verify`가 같은 결과를 낸다. 비어 있으면 통과 */
+function appManifestProblems(manifest) {
+	const problems = [];
+	const unique = (values, path, label) => {
+		const seen = /* @__PURE__ */ new Set();
+		for (const value of values) {
+			if (seen.has(value)) problems.push({
+				path,
+				code: "DUPLICATE",
+				message: `${label}이 중복됐습니다: ${value}`
+			});
+			seen.add(value);
+		}
+	};
+	unique(manifest.scopes, "scopes", "스코프");
+	unique(manifest.events, "events", "이벤트");
+	unique(manifest.network.hosts, "network.hosts", "호스트");
+	unique(manifest.secrets, "secrets", "비밀 값 이름");
+	for (const event of manifest.events) if (!scopesCoverEvent(manifest.scopes, event)) problems.push({
+		path: `events.${event}`,
+		code: "EVENT_SCOPE_MISSING",
+		message: `${event} 이벤트를 받으려면 ${APP_EVENT_SCOPES[event]} 스코프가 필요합니다`
+	});
+	for (const [key, field] of Object.entries(manifest.settings)) {
+		if (field.type === "select" && !field.options) problems.push({
+			path: `settings.${key}`,
+			code: "SELECT_OPTIONS_REQUIRED",
+			message: "select 필드에는 options가 필요합니다"
+		});
+		if (field.secret && field.type !== "string") problems.push({
+			path: `settings.${key}`,
+			code: "SECRET_FIELD_TYPE",
+			message: "비밀 필드는 string만 됩니다"
+		});
+		if (field.default !== void 0) {
+			const expected = field.type === "select" ? "string" : field.type;
+			const matchesOption = field.type !== "select" || field.options?.some((o) => o.value === field.default);
+			if (typeof field.default !== expected || !matchesOption) problems.push({
+				path: `settings.${key}`,
+				code: "DEFAULT_TYPE_MISMATCH",
+				message: "default가 필드 형식과 맞지 않습니다"
+			});
+		}
+	}
+	return problems;
+}
+function appCapabilitiesOf(manifest) {
+	const sorted = (values) => [...new Set(values)].sort();
+	return {
+		scopes: sorted(manifest.scopes),
+		events: sorted(manifest.events),
+		networkHosts: sorted(manifest.network.hosts),
+		adminPage: Boolean(manifest.ui?.adminPage),
+		requiredSettings: Object.entries(manifest.settings).filter(([, field]) => field.required).map(([key]) => key).sort(),
+		secretSettings: Object.entries(manifest.settings).filter(([, field]) => field.secret).map(([key]) => key).sort()
+	};
+}
+const grew = (previous, next) => next.some((value) => !previous.includes(value));
+/** 스코프 집합이 넓어졌는가 — `r`→`rw`는 넓어짐, `rw`→`r`은 아님 */
+function scopesWiden(previous, next) {
+	return next.some((scope) => {
+		if (previous.includes(scope)) return false;
+		const [resource, access] = scope.split(":");
+		return !(access === "r" && previous.includes(`${resource}:rw`));
+	});
+}
+const APP_CAPABILITIES = [
+	{
+		key: "scopes",
+		title: "이 앱이 할 수 있는 일",
+		describe: (c) => c.scopes.map((scope) => describeScope(scope) ?? scope),
+		widens: (p, n) => scopesWiden(p.scopes, n.scopes)
+	},
+	{
+		key: "network",
+		title: "이 앱이 데이터를 보내는 곳",
+		describe: (c) => c.networkHosts,
+		widens: (p, n) => grew(p.networkHosts, n.networkHosts)
+	},
+	{
+		key: "events",
+		title: "이 앱이 받는 알림",
+		describe: (c) => c.events,
+		widens: (p, n) => grew(p.events, n.events)
+	},
+	{
+		key: "ui",
+		title: "상점 플랫폼 화면",
+		describe: (c) => c.adminPage ? ["상점 플랫폼에 이 앱의 화면을 더합니다"] : [],
+		widens: (p, n) => !p.adminPage && n.adminPage
+	}
+];
+/** 재동의가 필요한 capability 키 — 비어 있으면 release가 모든 설치에 곧바로 반영된다 */
+function appManifestWidens(previous, next) {
+	return APP_CAPABILITIES.filter((c) => c.widens(previous, next)).map((c) => c.key);
+}
+//#endregion
+//#region src/schemas/apps.ts
+/**
+* 설치 앱 관리 API 계약 (이슈 #22) — `/v1/apps/installations/**`(상점이 설치한 앱), `/v1/app/installation`(설치 토큰 자기 조회).
+* 개발자 API(`/platform/v1/developer/**`)는 플랫폼 플레인이라 여기 두지 않는다.
+*/
+/** 배포 범위 — `PRIVATE_OWN` 개발자 조직 구성원이 OWNER·ADMIN인 상점과 개발 상점(A1) · `PRIVATE_LINK` 설치 링크(A2) · `LISTED` 공개 목록(A3) */
+const appDistributionSchema = z.enum([
+	"PRIVATE_OWN",
+	"PRIVATE_LINK",
+	"LISTED"
+]);
+const appRuntimeSchema = z.enum(["CODE", "EXTERNAL"]);
+/** 앱 상태 — `SUSPENDED`는 운영자 정지(모든 설치 토큰·실행 거부, 설치 행은 그대로) */
+const appStatusSchema = z.enum([
+	"ACTIVE",
+	"SUSPENDED",
+	"DELETED"
+]);
+const appInstallationStatusSchema = z.enum([
+	"ACTIVE",
+	"UNINSTALLED",
+	"SUSPENDED"
+]);
+/** 설치 앱의 앱 정보 — 상점이 보는 범위만(개발자 비밀 값·소스·빌드는 없다) */
+const appInstallationAppSchema = z.object({
+	appId: z.string(),
+	handle: z.string().describe("앱 handle. 앱 화면 주소의 라벨"),
+	name: z.string(),
+	iconUrl: z.string().nullable(),
+	description: z.string().nullable(),
+	developerName: z.string().describe("개발자 조직 이름"),
+	supportEmail: z.string().nullable(),
+	distribution: appDistributionSchema,
+	runtime: appRuntimeSchema,
+	status: appStatusSchema
+});
+const settingsValueSchema = z.union([
+	z.string(),
+	z.number(),
+	z.boolean(),
+	z.null()
+]);
+/** 설치 설정 — 비밀 필드 값은 가려서 준다(앞 4자 + `…`). 비어 있는 필드는 null */
+const appInstallationSettingsSchema = z.object({
+	fields: z.record(z.string(), appSettingFieldSchema).describe("실행 버전 매니페스트의 설정 필드"),
+	values: z.record(z.string(), settingsValueSchema),
+	/** 필수 설정이 모두 채워졌는가 — 아니면 이벤트 함수를 부르지 않는다 */
+	configured: z.boolean(),
+	updatedAt: z.string().nullable()
+});
+/** 설정 저장 — 비밀 필드를 생략하면 현재 값을 유지한다. null은 비운다 */
+const appInstallationSettingsUpdateSchema = z.object({ values: z.record(z.string(), settingsValueSchema) });
+const appInstallationSchema = z.object({
+	installationId: z.string(),
+	storeId: z.string(),
+	app: appInstallationAppSchema,
+	status: appInstallationStatusSchema,
+	versionNumber: z.number().int().describe("실행 중인 앱 버전"),
+	pendingVersionNumber: z.number().int().nullable().describe("재동의가 필요한 새 버전. 없으면 null"),
+	grantedScopes: z.array(z.string()).describe("동의한 스코프"),
+	grantedNetworkHosts: z.array(z.string()).describe("동의한 외부 호출 호스트"),
+	events: z.array(appEventTypeSchema).describe("이 설치가 받는 이벤트"),
+	adminPage: z.boolean().describe("상점 플랫폼 앱 화면이 있는가"),
+	/** 설치 결과의 캐시가 아니라 실행 버전 매니페스트의 요약 */
+	settings: appInstallationSettingsSchema,
+	installedBy: z.object({
+		userId: z.string(),
+		name: z.string().nullable()
+	}).nullable(),
+	installedAt: z.string(),
+	uninstalledAt: z.string().nullable(),
+	updatedAt: z.string()
+});
+/** `POST /v1/apps/installations` — accounts 설치 동의 결과(1회용 JWT)를 낸다(상점 플랫폼 전용) */
+const appInstallRequestSchema = z.object({ result: z.string().min(1).describe("accounts가 발급한 설치 결과 JWT(`typ: sayren-install+jwt`)") });
+/** `POST /v1/apps/installations/{id}/session` — 앱 화면 iframe이 쓸 세션 토큰(5분) */
+const appSessionSchema = z.object({
+	token: z.string(),
+	expiresAt: z.string(),
+	appOrigin: z.url().describe("iframe 주소의 origin(`https://{handle}.{앱 도메인}`)")
+});
+/** `GET /v1/app/installation` — 설치 토큰으로 보는 자기 설치 */
+const appInstallationSelfSchema = z.object({
+	installationId: z.string(),
+	appId: z.string(),
+	storeId: z.string(),
+	storeName: z.string(),
+	versionNumber: z.number().int(),
+	grantedScopes: z.array(z.string()),
+	installedAt: z.string()
+});
+const developerOrgSchema = z.object({
+	orgId: z.string(),
+	name: z.string(),
+	role: z.enum(["OWNER", "MEMBER"])
+});
+const appVersionStatusSchema = z.enum([
+	"BUILDING",
+	"READY",
+	"FAILED",
+	"REVOKED"
+]);
+/** 빌드 단계(매뉴얼 「앱 버전과 배포 › 빌드」). 로컬 번들(A1)은 `DEPENDENCIES`·`VERIFY`·`BUNDLE`·`UPLOAD`를 서버가 돈다 */
+const appBuildStageSchema = z.enum([
+	"DEPENDENCIES",
+	"VERIFY",
+	"INSTALL",
+	"TYPECHECK",
+	"BUILD",
+	"BUNDLE",
+	"UPLOAD"
+]);
+const appBuildSchema = z.object({
+	buildId: z.string(),
+	status: z.enum([
+		"QUEUED",
+		"RUNNING",
+		"SUCCEEDED",
+		"FAILED",
+		"TIMED_OUT"
+	]),
+	stages: z.array(z.object({
+		stage: z.string(),
+		ok: z.boolean(),
+		durationMs: z.number()
+	})),
+	failureStage: z.string().nullable(),
+	errorCode: z.string().nullable(),
+	logTail: z.string().nullable(),
+	/** 의존성 검사 결과(거절·경고). 검사 전이면 null */
+	dependencies: z.object({
+		rejected: z.array(z.record(z.string(), z.unknown())),
+		warnings: z.array(z.record(z.string(), z.unknown()))
+	}).nullable(),
+	createdAt: z.string(),
+	finishedAt: z.string().nullable()
+});
+const appVersionSchema = z.object({
+	versionId: z.string(),
+	number: z.number().int(),
+	status: appVersionStatusSchema,
+	current: z.boolean().describe("앱의 현재 버전(release한 버전)인가"),
+	message: z.string().nullable(),
+	capabilities: z.object({
+		scopes: z.array(z.string()),
+		events: z.array(z.string()),
+		networkHosts: z.array(z.string()),
+		adminPage: z.boolean(),
+		requiredSettings: z.array(z.string()),
+		secretSettings: z.array(z.string())
+	}),
+	build: appBuildSchema.nullable(),
+	releasedAt: z.string().nullable(),
+	revokedAt: z.string().nullable(),
+	createdAt: z.string()
+});
+const developerAppSchema = z.object({
+	appId: z.string(),
+	orgId: z.string(),
+	handle: z.string(),
+	name: z.string(),
+	description: z.string().nullable(),
+	iconUrl: z.string().nullable(),
+	supportEmail: z.string().nullable(),
+	distribution: appDistributionSchema,
+	runtime: appRuntimeSchema,
+	status: appStatusSchema,
+	suspendedReason: z.string().nullable(),
+	currentVersionNumber: z.number().int().nullable(),
+	installations: z.object({
+		active: z.number().int(),
+		pendingReconsent: z.number().int()
+	}),
+	createdAt: z.string(),
+	updatedAt: z.string()
+});
+const developerAppCreateSchema = z.object({
+	handle: appHandleSchema,
+	name: z.string().trim().min(1).max(60),
+	description: z.string().trim().max(500).optional()
+});
+/** `PUT /platform/v1/developer/apps/{appId}/versions` — CLI `app deploy`가 올리는 번들 */
+const appArtifactUploadSchema = z.object({
+	manifest: z.unknown().describe("sayren.app.json 원문(JSON)"),
+	packageJson: z.string().max(262144),
+	lockfile: z.string().max(4194304).nullable(),
+	/** 서버 번들(ESM 한 파일) base64. gzip 3MB까지 */
+	server: z.string().min(1),
+	ui: z.array(z.object({
+		path: z.string().min(1).max(512),
+		content: z.string()
+	})).max(2e3).default([]),
+	message: z.string().trim().max(200).optional()
+});
+const appReleaseResultSchema = z.object({
+	version: appVersionSchema,
+	/** release가 곧바로 적용된 설치 수 */
+	applied: z.number().int(),
+	/** 넓어진 범위라 재동의를 기다리는 설치 수 */
+	pendingReconsent: z.number().int()
+});
+const appSecretSummarySchema = z.object({
+	name: z.string(),
+	updatedAt: z.string()
+});
+const devStoreSchema = z.object({
+	storeId: z.string(),
+	name: z.string(),
+	storeCode: z.string(),
+	status: z.enum([
+		"ACTIVE",
+		"SUSPENDED",
+		"CLOSED"
+	]),
+	createdAt: z.string()
+});
+/** 개발자가 보는 설치 한 줄 */
+const developerInstallationSchema = z.object({
+	installationId: z.string(),
+	storeId: z.string(),
+	storeName: z.string(),
+	status: appInstallationStatusSchema,
+	versionNumber: z.number().int().nullable(),
+	pendingVersionNumber: z.number().int().nullable(),
+	installedAt: z.string()
+});
+/** `POST /platform/v1/developer/apps/{appId}/dev-token` — `sayren app dev`가 쓰는 설치 토큰(1시간) */
+const appDevTokenSchema = z.object({
+	token: z.string(),
+	expiresAt: z.string(),
+	installationId: z.string(),
+	storeId: z.string()
+});
+/** 호출 기록 한 건(개발자 로그) */
+const appInvocationSchema = z.object({
+	invocationId: z.string(),
+	storeId: z.string(),
+	storeName: z.string().nullable(),
+	installationId: z.string(),
+	versionNumber: z.number().int().nullable(),
+	kind: z.enum([
+		"event",
+		"http",
+		"schedule"
+	]),
+	eventType: z.string().nullable(),
+	outcome: z.enum([
+		"OK",
+		"ERROR",
+		"LIMIT_EXCEEDED",
+		"REJECTED"
+	]),
+	errorMessage: z.string().nullable(),
+	cpuMs: z.number().nullable(),
+	durationMs: z.number(),
+	/** `console.*`·`ctx.log.*` 줄(최대 100줄, 줄마다 500자) */
+	logs: z.array(z.object({
+		level: z.string(),
+		message: z.string()
+	})),
+	createdAt: z.string()
+});
+/** 앱 배포 키(developer.sayren.app 「키 발행」) — 값은 만들 때 한 번만 보인다 */
+const appDeployKeySchema = z.object({
+	keyId: z.string(),
+	name: z.string(),
+	prefix: z.string().describe("값 앞 12자"),
+	createdAt: z.string(),
+	lastUsedAt: z.string().nullable()
+});
+const appDeployKeyCreatedSchema = appDeployKeySchema.extend({ 
+/** 전체 값 — 이때만 보인다 */
+value: z.string() });
+const appDeployKeyCreateSchema = z.object({ name: z.string().trim().min(1).max(60) });
+/** 배포 키 값 형식 — `sak_{appId 뒤}_{32 hex}` */
+const APP_DEPLOY_KEY_PATTERN = /^sak_[a-z0-9]{8,40}_[0-9a-f]{32}$/;
+const APP_DEPLOY_KEY_PREFIX = "sak_";
+//#endregion
+//#region src/schemas/auth.ts
+const storeRoleSchema = z.enum([
+	"OWNER",
+	"ADMIN",
+	"STAFF"
+]);
+const myStoreSchema = z.object({
+	storeId: z.string(),
+	storeName: z.string(),
+	storeCode: z.string(),
+	role: storeRoleSchema,
+	status: z.enum([
+		"ACTIVE",
+		"SUSPENDED",
+		"CLOSED"
+	])
+});
+const myAccountSchema = z.object({
+	userId: z.string(),
+	email: z.email(),
+	name: z.string(),
+	storeCount: z.number().int(),
+	createdAt: z.string()
+});
+//#endregion
+//#region src/schemas/category.ts
+const categoryProductSortSchema = z.enum([
+	"RECENT",
+	"POPULAR",
+	"PRICE_LOW",
+	"PRICE_HIGH",
+	"NAME"
+]);
+const categorySchema = z.object({
+	categoryId: z.string(),
+	storeId: z.string(),
+	name: z.string(),
+	parentId: z.string().nullable(),
+	path: z.string(),
+	depth: z.number().int().min(1).max(4),
+	leaf: z.boolean(),
+	sortOrder: z.number().int(),
+	visible: z.boolean(),
+	showPc: z.boolean(),
+	showMobile: z.boolean(),
+	productSort: categoryProductSortSchema,
+	metaTitle: z.string().nullable(),
+	metaDescription: z.string().nullable(),
+	metaKeywords: z.string().nullable(),
+	flowId: z.string().nullable().optional().describe("주문 흐름(이슈 #115) — 맨 아래 카테고리에만 있다. 흐름을 지정하지 않은 상품이 쓴다. null이면 기본 흐름"),
+	createdAt: z.string(),
+	updatedAt: z.string()
+});
+const categoryTreeNodeSchema = categorySchema.extend({ children: z.lazy(() => z.array(categoryTreeNodeSchema)) });
+const categoryWithPathSchema = categorySchema.extend({
+	fullPath: z.string(),
+	ancestors: z.array(categorySchema),
+	childCount: z.number().int()
+});
+const categorySearchResultSchema = categorySchema.extend({
+	fullPath: z.string(),
+	ancestors: z.array(categorySchema)
+});
+const categoryAttributeSchema = z.object({
+	attributeId: z.string(),
+	name: z.string(),
+	required: z.boolean(),
+	inputType: z.enum([
+		"SELECT",
+		"MULTI_SELECT",
+		"TEXT",
+		"NUMBER"
+	]),
+	unit: z.string().nullable(),
+	allowedValues: z.array(z.string()).optional()
+});
+const categoryCreateRequestSchema = z.object({
+	name: z.string().min(1).max(100),
+	parentId: z.string().nullable().optional(),
+	sortOrder: z.number().int().optional(),
+	visible: z.boolean().optional(),
+	showPc: z.boolean().optional(),
+	showMobile: z.boolean().optional(),
+	productSort: categoryProductSortSchema.optional(),
+	metaTitle: z.string().max(100).nullable().optional(),
+	metaDescription: z.string().max(300).nullable().optional(),
+	metaKeywords: z.string().max(200).nullable().optional()
+});
+const categoryPatchRequestSchema = z.object({
+	name: z.string().min(1).max(100).optional(),
+	parentId: z.string().nullable().optional(),
+	sortOrder: z.number().int().optional(),
+	visible: z.boolean().optional(),
+	showPc: z.boolean().optional(),
+	showMobile: z.boolean().optional(),
+	productSort: categoryProductSortSchema.optional(),
+	metaTitle: z.string().max(100).nullable().optional(),
+	metaDescription: z.string().max(300).nullable().optional(),
+	metaKeywords: z.string().max(200).nullable().optional(),
+	flowId: z.string().nullable().optional().describe("주문 흐름(이슈 #115) — 게시한 흐름 id, null이면 기본 흐름. 맨 아래 카테고리에만 지정한다(400 `CATEGORY_NOT_LEAF`). 게시하지 않은 흐름은 409 `FLOW_NOT_PUBLISHED`")
+});
+const categoryDeleteStrategySchema = z.enum(["reparent", "cascade"]);
+/**
+* `GET /v1/categories` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열). 응답 형태가 쿼리로 갈린다:
+* `q`가 있으면 검색 결과(`CategorySearchResult[]`), 아니면 `tree=true`일 때 트리(`CategoryTreeNode[]`),
+* 둘 다 아니면 목록(`Category[]`)이다.
+*/
+const categoryListQuerySchema = z.object({
+	parentId: z.string().optional().describe("이 카테고리의 직계 자식만. 생략하면 최상위 카테고리. `flat=true`면 무시"),
+	flat: z.enum(["true", "false"]).optional().describe("`true`면 전체 카테고리를 깊이·순서대로 평탄화"),
+	tree: z.enum(["true", "false"]).optional().describe("`true`면 최상위부터 `children`을 채운 트리(`CategoryTreeNode[]`)를 돌려준다"),
+	q: z.string().optional().describe("이름 검색(포함, 대소문자 무시). 주면 `fullPath`·`ancestors`가 붙은 검색 결과를 돌려준다")
+});
+/** `DELETE /v1/categories/{categoryId}` 쿼리 — OpenAPI 문서용 형태 */
+const categoryDeleteQuerySchema = z.object({ strategy: categoryDeleteStrategySchema.optional().describe("하위 카테고리·연결 상품 처리 방식. 생략하면 둘 중 하나라도 있을 때 409 `CATEGORY_NOT_EMPTY`다. `reparent`는 직계 자식을 삭제할 카테고리의 부모로 옮기고, `cascade`는 서브트리를 삭제하고 연결 상품을 미분류로 둔다") });
+//#endregion
+//#region src/schemas/collection.ts
+/**
+* 컬렉션 (이슈 #83) — 상품을 어디에 보여 줄지 정하는 묶음이다. 카테고리는 상품이 무엇인지를 정하고 상품당 하나지만, 컬렉션은
+* 다대다다. 이벤트·기획전은 기간이 있는 직접 선택 컬렉션이다. 권한은 카테고리와 같다(`category:r`·`category:rw`).
+*
+* 유형은 만들 때 정하고 바꿀 수 없다. 직접 선택(`MANUAL`)은 셀러가 상품을 담고 순서를 정하고, 조건 자동(`AUTOMATIC`)은 조건(`rules`)을
+* 모두 만족하는 판매 중 상품을 조회할 때마다 계산한다(결과를 저장하지 않는다). 응답의 `type`은 값이 늘 수 있어 문자열이다.
+*/
+/** 상점당 컬렉션 최대 개수 — 넘으면 409 `COLLECTION_LIMIT_EXCEEDED` */
+const MAX_COLLECTIONS = 200;
+/** 직접 선택 컬렉션 하나에 담는 상품 최대 개수 — 넘으면 409 `COLLECTION_PRODUCT_LIMIT_EXCEEDED` */
+const MAX_COLLECTION_PRODUCTS = 1e3;
+/** 상품 뒤에 붙이기(`POST /v1/collections/{id}/products`) 한 번에 보내는 상품 최대 개수 */
+const MAX_COLLECTION_PRODUCTS_PER_ADD = 500;
+/** 제목 최대 글자 수 */
+const MAX_COLLECTION_TITLE = 60;
+/** 설명 최대 글자 수 */
 const MAX_COLLECTION_DESCRIPTION = 500;
 /** 주소(slug) 형식 — 영문 소문자·숫자·하이픈, 첫 글자는 영문 소문자나 숫자, 64자까지 */
 const COLLECTION_SLUG_PATTERN = /^[a-z0-9][a-z0-9-]{0,63}$/;
@@ -4160,8 +5116,14 @@ const webhookDeliveryErrorCodeSchema = z.enum([
 	"CONNECTION_FAILED",
 	"BLOCKED_ADDRESS",
 	"NON_2XX",
-	"WEBHOOK_SUSPENDED"
-]).describe("전송 실패 사유. `TIMEOUT`=10초 안에 응답 없음, `CONNECTION_FAILED`=연결 실패(DNS·TLS 포함), `BLOCKED_ADDRESS`=사설·루프백 등 전송이 허용되지 않는 주소, `NON_2XX`=2xx가 아닌 응답(리다이렉트 포함), `WEBHOOK_SUSPENDED`=구독 정지로 대기 중인 전송이 종료됨");
+	"WEBHOOK_SUSPENDED",
+	"APP_ERROR",
+	"APP_LIMIT_EXCEEDED",
+	"APP_REJECTED",
+	"APP_UNCONFIGURED",
+	"APP_INACTIVE",
+	"APP_RUNNER_UNAVAILABLE"
+]).describe("전송 실패 사유. `TIMEOUT`=10초 안에 응답 없음, `CONNECTION_FAILED`=연결 실패(DNS·TLS 포함), `BLOCKED_ADDRESS`=사설·루프백 등 전송이 허용되지 않는 주소, `NON_2XX`=2xx가 아닌 응답(리다이렉트 포함), `WEBHOOK_SUSPENDED`=구독 정지로 대기 중인 전송이 종료됨. 설치 앱(#22): `APP_ERROR`=앱 코드 예외, `APP_LIMIT_EXCEEDED`=CPU·요청·시간 한도 초과, `APP_REJECTED`=앱·버전 정지 등으로 거부, `APP_UNCONFIGURED`=필수 설정이 비어 보내지 않음, `APP_INACTIVE`=설치가 제거됨, `APP_RUNNER_UNAVAILABLE`=실행 환경 호출 실패");
 /**
 * 실패 원인 분류의 **현재** 값. 응답 스키마(`webhookFailureReasonSchema`)는 문자열로 열려 있다 —
 * 서버가 값을 더해도 이전 SDK가 목록 파싱에 실패하지 않게 한다(택배 추적 `stage`와 같은 이유).
@@ -4423,8 +5385,10 @@ const liveGateConditionCodeSchema = z.enum([
 	"SANDBOX_PAYMENT",
 	"SANDBOX_REFUND",
 	"LIVE_CONNECTION",
-	"PLATFORM_LIVE_ENABLED"
-]).describe("라이브 개방 조건. `TEST_CONNECTION`=TEST 세트 연결 테스트 성공, `SANDBOX_PAYMENT`=현재 TEST 세트로 샌드박스 결제 1건 승인, `SANDBOX_REFUND`=그 샌드박스 결제의 환불 1건 성공, `LIVE_CONNECTION`=LIVE 세트 연결 테스트 성공, `PLATFORM_LIVE_ENABLED`=플랫폼이 실결제를 열어 둠");
+	"PLATFORM_LIVE_ENABLED",
+	"NOT_TEMPLATE_STORE",
+	"NOT_DEVELOPMENT_STORE"
+]).describe("라이브 개방 조건. `TEST_CONNECTION`=TEST 세트 연결 테스트 성공, `SANDBOX_PAYMENT`=현재 TEST 세트로 샌드박스 결제 1건 승인, `SANDBOX_REFUND`=그 샌드박스 결제의 환불 1건 성공, `LIVE_CONNECTION`=LIVE 세트 연결 테스트 성공, `PLATFORM_LIVE_ENABLED`=플랫폼이 실결제를 열어 둠, `NOT_TEMPLATE_STORE`=템플릿 상점이 아님(템플릿 상점에만 싣고 늘 미충족), `NOT_DEVELOPMENT_STORE`=앱 개발 상점이 아님(앱 개발 상점에만 싣고 늘 미충족)");
 const liveGateConditionSchema = z.object({
 	code: liveGateConditionCodeSchema,
 	met: z.boolean().describe("충족 여부"),
@@ -5886,6 +6850,8 @@ function storefrontEditPreviewLabelOf(siteId) {
 const storefrontSlugSchema = z.string().regex(STOREFRONT_SLUG_PATTERN, "소문자·숫자·하이픈 3~30자여야 하고 하이픈으로 시작하거나 끝날 수 없습니다").refine((slug) => !slug.includes("--"), "하이픈을 연달아 쓸 수 없습니다").refine((slug) => !isReservedStorefrontSlug(slug), "플랫폼이 쓰는 이름이라 쓸 수 없습니다").describe("주소 슬러그. `{slug}.{호스팅 도메인}`이 사이트 주소가 된다");
 /** 바꾼 슬러그를 다른 사이트가 가져가지 못하게 막는 기간(일). 보류 동안 옛 주소는 새 주소로 301한다 */
 const STOREFRONT_SLUG_HOLD_DAYS = 90;
+/** 닫은 사이트(호스팅 끄기·상점 폐쇄)의 주소 보류·보관 기간(일, 2026-10-07). 지나면 주소가 풀리고 사이트가 지워진다 */
+const STOREFRONT_CLOSED_SITE_HOLD_DAYS = 30;
 /** 슬러그 변경 한도 — 이 기간(일) 안에 */
 const STOREFRONT_SLUG_CHANGE_WINDOW_DAYS = 30;
 /** 슬러그 변경 한도 — 횟수(상점 단위. 끄고 다시 만들어도 이어서 센다) */
@@ -5902,7 +6868,40 @@ const storefrontTemplateSchema = z.object({
 	isDefault: z.boolean().describe("기본 템플릿인가 (상점 생성 시 자동 생성에 쓴다)"),
 	tags: z.array(z.string()).default([]).describe("템플릿 특징 태그 (예: `후기 강조`). 목록 카드에 보인다. 옛 서버 응답은 빈 배열로 읽는다"),
 	supportsCheckout: z.boolean().default(true).describe("주문을 받는 템플릿인가. false는 가격·문의 중심의 카탈로그형이다. 옛 서버 응답은 true로 읽는다"),
-	previewUrl: z.string().nullable().default(null).describe("공식 쇼케이스 사이트 주소. 연결된 쇼케이스가 공개 중일 때만 싣고 그 밖에는 null")
+	previewUrl: z.string().nullable().default(null).describe("미리보기 사이트 주소. 공식 템플릿은 연결된 쇼케이스, 템플릿 상점의 템플릿은 그 상점의 사이트가 공개 중일 때만 싣고 그 밖에는 null"),
+	source: z.enum(["CATALOG", "STORE"]).default("CATALOG").describe("`CATALOG` 공식 템플릿 · `STORE` 템플릿 상점의 템플릿(사이트를 만들 때 `copyContent`로 콘텐츠를 복사할 수 있다). 옛 서버 응답은 `CATALOG`로 읽는다")
+});
+/**
+* 템플릿 상점의 템플릿 정보 — 상점을 만들 때 템플릿 상점으로 고른 상점만 있다. 발행한 스토어프론트가 템플릿이 되고, 이 이름·소개·
+* 썸네일로 모든 셀러의 템플릿 목록에 보인다
+*/
+const storeTemplateSchema = z.object({
+	templateId: z.string().describe("템플릿 id. 다른 상점이 사이트를 만들 때 이 값을 쓴다"),
+	name: z.string().describe("템플릿 이름"),
+	description: z.string().describe("템플릿 소개"),
+	thumbnailUrl: z.string().nullable().describe("썸네일 이미지 주소. 없으면 null"),
+	status: z.enum([
+		"DRAFT",
+		"ACTIVE",
+		"RETIRED"
+	]).describe("`DRAFT` 아직 편집한 스토어프론트를 발행하지 않아 목록에 보이지 않음 · `ACTIVE` 목록에 보임 · `RETIRED` 상점을 닫아 내려감"),
+	version: z.string().nullable().describe("목록에 보이는 템플릿 버전. 발행한 스토어프론트 버전에서 정해진다. `DRAFT`면 null")
+});
+/**
+* 템플릿 상점의 고정 사업자 정보 필드 — 상점 수정에서 다른 값을 보내면 409 `TEMPLATE_STORE_BUSINESS_LOCKED`다(값은 플랫폼이 정한다)
+*/
+const TEMPLATE_STORE_LOCKED_BUSINESS_FIELDS = [
+	"businessName",
+	"representativeName",
+	"businessNumber",
+	"mailOrderSalesNumber",
+	"customerCenterPhone",
+	"customerCenterEmail"
+];
+const updateStoreTemplateRequestSchema = z.object({
+	name: z.string().trim().min(1).max(40).describe("템플릿 이름(1~40자)"),
+	description: z.string().trim().max(200).describe("템플릿 소개(200자까지)"),
+	thumbnailUrl: z.url({ protocol: /^https$/ }).max(2048).nullable().describe("썸네일 이미지 주소(https). 이미지 업로드(`POST /v1/uploads`)로 받은 주소를 쓴다. 없으면 null")
 });
 /**
 * 버전 상태 — 템플릿 버전(`source: TEMPLATE`)은 템플릿 산출물을 그대로 쓰므로 만들 때 곧바로 `READY`다. 편집 버전
@@ -5970,6 +6969,12 @@ const storefrontSuspensionSchema = z.object({
 	reason: z.string().nullable().describe("정지 사유. 운영자가 적은 안내이고 없으면 null"),
 	suspendedAt: z.string().nullable().describe("정지한 시각 (ISO 8601)")
 });
+/** 사이트 첫 화면 스냅샷 — 발행·되돌리기로 발행 버전이 바뀌면 반영된 뒤 다시 찍는다(데스크톱 1280×800) */
+const storefrontSiteSnapshotSchema = z.object({
+	url: z.string().describe("스냅샷 이미지 주소 (jpeg)"),
+	versionId: z.string().nullable().describe("스냅샷이 보여 주는 발행 버전"),
+	capturedAt: z.string().nullable().describe("찍은 시각 (ISO 8601)")
+});
 const storefrontSiteSchema = z.object({
 	siteId: z.string(),
 	slug: z.string().describe("주소 슬러그"),
@@ -5985,6 +6990,7 @@ const storefrontSiteSchema = z.object({
 	editPreview: storefrontEditPreviewSchema,
 	slugChangesRemaining: z.number().int().min(0).describe(`최근 30일 기준 남은 슬러그 변경 횟수`),
 	suspension: storefrontSuspensionSchema.nullable().optional().describe("정지 정보. `status`가 `SUSPENDED`일 때만 있고 그 밖은 null"),
+	snapshot: storefrontSiteSnapshotSchema.nullable().optional().describe("사이트 첫 화면 스냅샷. 발행한 버전이 반영되면 찍고, 아직 찍지 않았으면 null"),
 	createdAt: z.string(),
 	updatedAt: z.string()
 });
@@ -6031,7 +7037,7 @@ const storefrontDeploymentLogSchema = z.object({
 		"WARN",
 		"ERROR"
 	]),
-	code: z.string().describe("기록 종류 (`SITE_CREATED`·`ADDRESS_RESERVED`·`WAITING`·`SYNCING`·`VERSION_UPLOADED`·`SYNC_FAILED`·`RETRY_SCHEDULED`·`PUBLISHED`)"),
+	code: z.string().describe("기록 종류 (`SITE_CREATED`·`ADDRESS_RESERVED`·`WAITING`·`SYNCING`·`VERSION_UPLOADED`·`SYNC_FAILED`·`RETRY_SCHEDULED`·`PUBLISHED`, 템플릿 상점의 템플릿은 `BUILDING`·`BUILD_FAILED`·`CONTENT_COPYING`·`CONTENT_COPIED`·`CONTENT_COPY_FAILED`)"),
 	message: z.string().describe("사람이 읽는 문장")
 });
 const storefrontDeploymentSchema = z.object({
@@ -6052,7 +7058,8 @@ const storefrontDeploymentSchema = z.object({
 });
 const createStorefrontSiteRequestSchema = z.object({
 	templateId: z.string().min(1).max(64).describe("템플릿 id"),
-	slug: storefrontSlugSchema.optional().describe("주소 슬러그. 생략하면 상점 코드")
+	slug: storefrontSlugSchema.optional().describe("주소 슬러그. 생략하면 상점 코드"),
+	copyContent: z.boolean().optional().describe("템플릿 상점의 템플릿일 때만 — true면 템플릿 상점의 콘텐츠(레이아웃, 상품·카테고리·컬렉션·주문 흐름·배송·환불 정책)를 이 상점으로 복사한다. 쿠폰·적립금·리뷰는 복사하지 않는다. 생략하거나 false면 레이아웃 콘텐츠를 비우고 빌드한다")
 });
 /** @deprecated 템플릿 변경은 지원하지 않는다(항상 409 `TEMPLATE_CHANGE_NOT_SUPPORTED`). 호환을 위해 스키마만 남겼다 */
 const changeStorefrontTemplateRequestSchema = z.object({
@@ -7414,6 +8421,20 @@ get: (params) => storeHttp.request("GET", "/sales-report", salesReportSchema, {
 			*/
 			verify: (provider, body) => storeHttp.request("POST", path`/store/payment-providers/${pgProviderSchema.parse(provider)}/verify`, paymentProviderVerificationSchema, { body: verifyPaymentProviderRequestSchema.parse(body ?? {}) })
 		},
+		/** 설치 앱(#22, 매뉴얼 「앱 설치와 관리 › 관리 API」) — 설치·설정·제거·세션은 상점 플랫폼 OWNER·ADMIN만 */
+		apps: { installations: {
+			/** 설치 결과(accounts 동의 화면의 1회용 JWT)를 내 설치를 만든다 */
+			install: (result) => storeHttp.request("POST", "/apps/installations", appInstallationSchema, { body: appInstallRequestSchema.parse({ result }) }),
+			list: () => storeHttp.request("GET", "/apps/installations", z.array(appInstallationSchema)),
+			get: (installationId) => storeHttp.request("GET", path`/apps/installations/${installationId}`, appInstallationSchema),
+			/** 비밀 필드를 생략하면 현재 값을 유지한다. null은 비운다 */
+			updateSettings: (installationId, body) => storeHttp.request("PUT", path`/apps/installations/${installationId}/settings`, appInstallationSchema, { body: appInstallationSettingsUpdateSchema.parse(body) }),
+			remove: (installationId) => storeHttp.requestVoid("DELETE", path`/apps/installations/${installationId}`),
+			/** 앱 화면 iframe에 넘길 세션 토큰(5분) */
+			session: (installationId) => storeHttp.request("POST", path`/apps/installations/${installationId}/session`, appSessionSchema)
+		} },
+		/** 앱 설치 토큰 전용 — 자기 설치 */
+		app: { installation: () => storeHttp.request("GET", "/app/installation", appInstallationSelfSchema) },
 		webhooks: {
 			list: () => storeHttp.request("GET", "/webhooks", z.array(webhookSchema)),
 			/** 서명 시크릿 평문은 이 응답에서만 노출된다 */
@@ -7514,6 +8535,10 @@ list: (params) => storeHttp.request("GET", "/audit-logs", auditLogPageSchema, {
 		storefront: {
 			/** `GET /v1/storefront/templates` — 템플릿 카탈로그 */
 			listTemplates: () => storeHttp.request("GET", "/storefront/templates", z.array(storefrontTemplateSchema)),
+			/** `GET /v1/storefront/template` — 템플릿 상점의 템플릿 정보(#123). 템플릿 상점이 아니면 404 `TEMPLATE_STORE_NOT_FOUND` */
+			getStoreTemplate: () => storeHttp.request("GET", "/storefront/template", storeTemplateSchema),
+			/** `PUT /v1/storefront/template` — 템플릿 이름·소개·썸네일을 바꾼다(템플릿 상점만) */
+			updateStoreTemplate: (body) => storeHttp.request("PUT", "/storefront/template", storeTemplateSchema, { body: updateStoreTemplateRequestSchema.parse(body) }),
 			/** `GET /v1/storefront/site` — 스위치 상태와 현재 사이트(없으면 `site: null`) */
 			get: () => storeHttp.request("GET", "/storefront/site", storefrontHostingSchema),
 			/** `GET /v1/storefront/slug-availability?slug=` — 슬러그를 쓸 수 있는가 */
@@ -7755,116 +8780,148 @@ async function exchangeAuthorizationCode(options) {
 }
 /** refresh grant (rotation — 응답의 새 refresh_token으로 반드시 교체 저장할 것) */
 async function refreshUserToken(options) {
-	return tokenRequest(options.tokenUrl, {
-		grant_type: "refresh_token",
-		refresh_token: options.refreshToken,
-		client_id: options.clientId,
-		...options.resource ? { resource: options.resource } : {}
-	}, options.fetch);
-}
-const customerDelegationRequestSchema = z.object({
-	uid: z.string().regex(/^[A-Za-z0-9._:@|-]{1,128}$/).optional().describe("셀러 자체 인증의 사용자 id(1~128자, 영문·숫자·`._:@|-`). 처음 보는 id면 구매자를 만든다"),
-	email: z.email().max(254).optional().describe("uid가 없으면 이메일로 지목한다. uid와 함께 주면 처음 만들 때의 이메일이다"),
-	name: z.string().max(50).optional().describe("처음 만들 때의 이름"),
-	authenticatedAt: z.iso.datetime({ offset: true }).optional().describe("사용자가 셀러 서비스에서 실제로 로그인한 시각(uid 위임만). 주면 구매자 토큰의 인증 시각이 된다")
-}).refine((value) => Boolean(value.uid || value.email), {
-	message: "uid 또는 email이 필요합니다",
-	path: ["uid"]
-}).describe("구매자 위임 요청");
-const customerDelegationSchema = z.object({
-	accessToken: z.string().describe("구매자 액세스 토큰(스토어프론트 API Bearer)"),
-	tokenType: z.literal("Bearer"),
-	expiresIn: z.number().int().describe("수명(초)"),
-	memberId: z.string()
-}).describe("구매자 위임 결과");
-//#endregion
-//#region src/schemas/scope.ts
-/**
-* 상점 스코프 카탈로그 (auth-spec §7) — 형식 `{리소스}:{r|rw}`, rw는 r을 함의한다.
-*
-* 관리 API가 요구하는 스코프와 역할별 자동 부여 스코프의 **단일 원천**이다.
-* 서버(apps/api)가 이 상수를 그대로 가져다 역할→스코프를 산출하므로, 상점 플랫폼 권한 매트릭스와
-* 서버 인가가 갈라지지 않는다.
-*/
-const scopeAccessSchema = z.enum(["r", "rw"]).describe("접근 수준. `r`=읽기, `rw`=읽기+쓰기(r을 함의)");
-/** 리소스별로 부여 가능한 접근 수준. settlement·analytics·audit는 쓰기 API가 없어 `r`만 존재한다 */
-const STORE_SCOPE_RESOURCES = {
-	product: ["r", "rw"],
-	category: ["r", "rw"],
-	order: ["r", "rw"],
-	claim: ["r", "rw"],
-	inquiry: ["r", "rw"],
-	review: ["r", "rw"],
-	settlement: ["r"],
-	analytics: ["r"],
-	webhook: ["r", "rw"],
-	store: ["r", "rw"],
-	member: ["r", "rw"],
-	customer: ["r", "rw"],
-	audit: ["r"],
-	promotion: ["r", "rw"],
-	storefront: ["r", "rw"],
-	flow: ["r", "rw"]
-};
-const storeScopeResourceSchema = z.enum(Object.keys(STORE_SCOPE_RESOURCES)).describe("스코프 리소스");
-/** 카탈로그상 존재하는 스코프 문자열인가 (예: `settlement:rw`는 false) */
-function isStoreScope(scope) {
-	const [resource, access, ...rest] = scope.split(":");
-	if (rest.length > 0 || !resource || !access) return false;
-	return STORE_SCOPE_RESOURCES[resource]?.includes(access) ?? false;
-}
-/**
-* 역할별 자동 부여 스코프 (auth-spec §7).
-* 계정 토큰으로 상점을 호출할 때의 스코프는 그 상점에서의 역할로 이 표에서 결정된다.
-*/
-const STORE_ROLE_SCOPES = {
-	OWNER: [
-		"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"
-	],
-	ADMIN: [
-		"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"
-	],
-	STAFF: [
-		"product:rw",
-		"category:rw",
-		"order:rw",
-		"claim:rw",
-		"inquiry:rw",
-		"review:rw",
-		"customer:r",
-		"promotion:r",
-		"flow:r"
-	]
-};
+	return tokenRequest(options.tokenUrl, {
+		grant_type: "refresh_token",
+		refresh_token: options.refreshToken,
+		client_id: options.clientId,
+		...options.resource ? { resource: options.resource } : {}
+	}, options.fetch);
+}
+const customerDelegationRequestSchema = z.object({
+	uid: z.string().regex(/^[A-Za-z0-9._:@|-]{1,128}$/).optional().describe("셀러 자체 인증의 사용자 id(1~128자, 영문·숫자·`._:@|-`). 처음 보는 id면 구매자를 만든다"),
+	email: z.email().max(254).optional().describe("uid가 없으면 이메일로 지목한다. uid와 함께 주면 처음 만들 때의 이메일이다"),
+	name: z.string().max(50).optional().describe("처음 만들 때의 이름"),
+	authenticatedAt: z.iso.datetime({ offset: true }).optional().describe("사용자가 셀러 서비스에서 실제로 로그인한 시각(uid 위임만). 주면 구매자 토큰의 인증 시각이 된다")
+}).refine((value) => Boolean(value.uid || value.email), {
+	message: "uid 또는 email이 필요합니다",
+	path: ["uid"]
+}).describe("구매자 위임 요청");
+const customerDelegationSchema = z.object({
+	accessToken: z.string().describe("구매자 액세스 토큰(스토어프론트 API Bearer)"),
+	tokenType: z.literal("Bearer"),
+	expiresIn: z.number().int().describe("수명(초)"),
+	memberId: z.string()
+}).describe("구매자 위임 결과");
+//#endregion
+//#region src/schemas/starter.ts
+/**
+* 쇼핑몰 시작(starter, 이슈 #122) — 원격 MCP의 starter 절차가 쓰는 브랜드 브리프와 진행 상태.
+*
+* 공개 OpenAPI 문서에는 싣지 않는다(절차를 운영 테스트로 다듬는 동안 계약이 바뀔 수 있다). 소비자는 sayren MCP 도구다.
+*/
+/** 판매 품목 — 빠른 시작(#70) 답과 템플릿 카탈로그 `recommendFor`가 같은 코드를 쓴다 */
+const storeIndustrySchema = z.enum([
+	"FASHION",
+	"FOOD",
+	"DIGITAL",
+	"OTHER"
+]);
+/** 상품 자료 — 인터뷰의 「상품 자료」 답. 상품 등록 단계의 방법을 고른다 */
+const brandBriefProductSourceSchema = z.enum([
+	"SPREADSHEET",
+	"EXISTING_STORE",
+	"PHOTOS",
+	"NONE"
+]);
+const BRAND_BRIEF_MAX_REFERENCES = 5;
+function isHttpUrl(value) {
+	try {
+		const { protocol } = new URL(value);
+		return protocol === "https:" || protocol === "http:";
+	} catch {
+		return false;
+	}
+}
+/** 참고 사이트 — 이미지는 저장하지 않고 주소와 에이전트가 쓴 레이아웃 요약만 둔다 */
+const brandBriefReferenceSchema = z.object({
+	url: z.string().trim().max(2048).refine(isHttpUrl, { message: "http(s) 주소여야 합니다" }).describe("참고 사이트 주소"),
+	summary: z.string().trim().min(1).max(1e3).describe("레이아웃 특징 요약 (헤더 형태·홈 섹션 순서·상세 구성 등)")
+});
+/** 브랜드 브리프 — starter 인터뷰 결과. 이후 단계(화면 설정·상품·다듬기)의 판단 근거다 */
+const brandBriefSchema = z.object({
+	industry: storeIndustrySchema.nullable().describe("판매 품목"),
+	mood: z.string().trim().max(200).nullable().describe("쇼핑몰 분위기 (예: 깔끔한, 따뜻한)"),
+	pointColor: z.string().regex(/^#[0-9a-fA-F]{6}$/, "#RRGGBB 형식이어야 합니다").nullable().describe("대표 색 (`#RRGGBB`)"),
+	references: z.array(brandBriefReferenceSchema).max(5),
+	productSource: brandBriefProductSourceSchema.nullable().describe("상품 자료"),
+	notes: z.string().trim().max(4e3).nullable().describe("인터뷰 메모 (타깃 고객, 판매 방식, 셀러가 강조한 요구)")
+});
+/** `PUT /v1/storefront/brand-brief` — 브리프 전체를 바꾼다. 생략한 항목은 비운다 */
+const putBrandBriefRequestSchema = z.object({
+	industry: storeIndustrySchema.nullable().default(null),
+	mood: z.string().trim().max(200).nullable().default(null),
+	pointColor: z.string().regex(/^#[0-9a-fA-F]{6}$/, "#RRGGBB 형식이어야 합니다").nullable().default(null),
+	references: z.array(brandBriefReferenceSchema).max(5).default([]),
+	productSource: brandBriefProductSourceSchema.nullable().default(null),
+	notes: z.string().trim().max(4e3).nullable().default(null)
+});
+/** `GET·PUT /v1/storefront/brand-brief` 응답 — 저장한 적이 없으면 `brief`·`updatedAt`이 null이다 */
+const brandBriefViewSchema = z.object({
+	brief: brandBriefSchema.nullable(),
+	updatedAt: z.string().nullable()
+});
+/**
+* starter 단계 — 서버 상태로 계산한다(에이전트 보고가 아니다). 앞 단계가 끝나지 않았으면 그 단계다.
+* `POLISH`(다듬기·구조 감사·구매 여정 점검)부터는 로컬 검사와 셀러 확인이 판정하므로 서버는 더 나누지 않는다.
+*/
+const STARTER_STAGES = [
+	"INTERVIEW",
+	"SITE",
+	"STORE_INFO",
+	"PRODUCTS",
+	"SELLER_TASKS",
+	"POLISH"
+];
+const starterStageSchema = z.enum(STARTER_STAGES);
+/** 셀러가 상점 플랫폼에서 직접 하는 항목 — 결제는 연결 여부만 본다(테스트·라이브를 가리지 않는다) */
+const STARTER_SELLER_TASKS = [
+	"PAYMENT_CONNECTED",
+	"BUSINESS_INFO",
+	"SHIPPING_POLICY"
+];
+const starterSellerTaskSchema = z.enum(STARTER_SELLER_TASKS);
+/** 상점 기본 정보 항목 — 고객센터 번호만 필수이고 로고는 권장이다(셀러가 로고가 없다고 하면 만들지 않는다) */
+const starterStoreInfoFieldSchema = z.enum(["LOGO", "CUSTOMER_CENTER_PHONE"]);
+/** `GET /v1/storefront/starter` — starter 진행 상태 */
+const starterStatusSchema = z.object({
+	stage: starterStageSchema,
+	hostingEnabled: z.boolean().describe("새 호스팅 사이트를 만들 수 있는가"),
+	defaultSiteUrl: z.string().nullable().describe("사이트를 만들면 쓰는 기본 주소(`https://{상점 코드}.{호스팅 도메인}`). 사이트가 있으면 null"),
+	brief: z.object({
+		saved: z.boolean(),
+		updatedAt: z.string().nullable()
+	}),
+	site: z.object({
+		siteId: z.string(),
+		url: z.string(),
+		templateId: z.string(),
+		visibility: z.enum(["COMING_SOON", "PUBLIC"]),
+		status: z.string(),
+		synced: z.boolean().describe("발행 상태가 공개 주소에 반영됐는가"),
+		publishedVersion: z.object({
+			versionId: z.string(),
+			templateVersion: z.string(),
+			createdVia: z.string().nullable(),
+			publishedAt: z.string().nullable()
+		}).nullable()
+	}).nullable(),
+	storeInfo: z.object({
+		done: z.boolean().describe("필수 항목(고객센터 번호)이 모두 있는가"),
+		missing: z.array(starterStoreInfoFieldSchema).describe("비어 있는 필수 항목"),
+		suggested: z.array(starterStoreInfoFieldSchema).describe("비어 있지만 완료를 막지 않는 항목(로고). 셀러가 원할 때만 채운다")
+	}),
+	products: z.object({ realCount: z.number().int().min(0).describe("샘플이 아닌 판매 중 상품 수") }),
+	sellerTasks: z.array(z.object({
+		key: starterSellerTaskSchema,
+		done: z.boolean()
+	})),
+	checkout: z.object({
+		available: z.boolean(),
+		mode: z.enum(["TEST", "LIVE"]).nullable(),
+		reason: z.enum(["PAYMENT_NOT_CONFIGURED", "PAYMENT_NOT_LIVE"]).nullable()
+	}),
+	orders: z.object({ count: z.number().int().min(0).describe("주문 수 (결제 모드를 가리지 않는다)") })
+});
 //#endregion
 //#region src/schemas/telemetry.ts
 /**
@@ -7904,221 +8961,6 @@ const mcpToolEventSchema = z.object({
 	results: z.array(mcpRuleResultSchema).max(32).refine((results) => new Set(results.map((result) => result.ruleId)).size === results.length, { message: "같은 규칙 id를 두 번 실을 수 없습니다" }).describe("규칙별 통과·위반. 규칙 id는 중복될 수 없고 파일 경로와 위반 상세는 싣지 않는다")
 });
 //#endregion
-//#region src/schemas/webhook-event.ts
-const envelopeFields = {
-	id: z.string().describe("이벤트 ID (`evt_…`, 테스트 전송은 `evt_test_…`). 중복 제거 키"),
-	createdAt: z.string().describe("이벤트 발생 일시 (ISO 8601)"),
-	storeId: z.string().describe("이벤트가 발생한 상점 ID"),
-	sequence: z.number().int().positive().optional().describe("리소스별 순번. 같은 주문·클레임·문의·리뷰·상품의 이벤트마다 1씩 커진다. 도착 순서는 보장하지 않으므로 같은 리소스의 이벤트는 이 값으로 정렬한다. 이 필드가 생기기 전의 이벤트와 테스트 전송에는 없다")
-};
-const orderWebhookEventDataSchema = z.object({
-	orderId: z.string().describe("주문 ID"),
-	orderNo: z.string().nullable().optional().default(null).describe("주문번호(이슈 #107) — 숫자 14자리. 이 필드가 없는 이전 이벤트와 번호 체계 이전 주문은 null로 읽는다"),
-	status: orderItemStatusSchema.describe("이벤트 발생 시점의 주문 대표 상태"),
-	testPayment: z.boolean().optional().default(false).describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았다. 이 필드가 없는 이전 이벤트는 false로 읽는다"),
-	couponDiscountAmount: z.number().int().optional().default(0).describe("주문이 받은 상품·주문 쿠폰 할인 합계 (원). 즉시할인(`discountAmount`)과 별개다. 쿠폰이 없거나 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
-	pointAmount: z.number().int().optional().default(0).describe("주문에 쓴 적립금 (원, #93). 적립금을 쓰지 않았거나 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
-	orderItemId: z.string().optional().describe("이벤트를 만든 주문상품 ID. 배송 없는 상품 제공으로 보내는 `ORDER.DELIVERED`에만 실린다. 택배 배송완료와 그 밖의 주문 이벤트에는 없다"),
-	fulfillmentSnapshot: orderItemFulfillmentSnapshotResponseSchema.optional().describe("이벤트를 만든 주문상품의 주문 시점 이행 스냅샷(주문상품 응답의 `fulfillmentSnapshot`과 같다, 이슈 #57). 배송 없는 상품의 제공 완료는 `ORDER.DELIVERED`로도 오고 `type`이 `MANUAL`이다. `orderItemId`가 있는 이벤트에만 실린다"),
-	itemOptions: z.array(z.object({
-		orderItemId: z.string(),
-		optionSelections: z.array(optionSelectionSchema),
-		customInputs: z.array(customInputValueSchema)
-	})).optional().describe("추가 선택·직접 입력이 있는 주문상품의 주문 시점 선택값(이슈 #59, 주문상품 응답의 `optionSelections`·`customInputs`와 같다). `ORDER.PAID`에만 실리고 그런 주문상품이 없으면 없다")
-});
-/**
-* `ORDER.FULFILLED` — 배송 없는 주문상품(`MANUAL`)을 제공했다(이슈 #48). 셀러의 제공 처리
-* (`POST /v1/order-items/{orderItemId}/fulfill`)로 온다. 기존 구독자를 위해 같은 순간 `ORDER.DELIVERED`도 함께 보낸다.
-*/
-const orderFulfilledWebhookEventDataSchema = z.object({
-	orderId: z.string().describe("주문 ID"),
-	orderNo: z.string().nullable().optional().default(null).describe("주문번호(이슈 #107) — 숫자 14자리. 이 필드가 없는 이전 이벤트와 번호 체계 이전 주문은 null로 읽는다"),
-	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`과 같다"),
-	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았다")
-});
-/**
-* `ORDER.CANCELED` — 셀러 직권취소(`POST /v1/order-items/{orderItemId}/cancel`)로 주문상품이 취소됐다.
-* 수량 단위 부분 취소도 이 이벤트다(`quantity` < 주문 수량이면 주문상품 상태가 그대로다).
-* 구매자가 신청한 취소·반품은 `CLAIM.*` 이벤트로 온다.
-*/
-const orderCanceledWebhookEventDataSchema = z.object({
-	orderId: z.string().describe("주문 ID"),
-	orderNo: z.string().nullable().optional().default(null).describe("주문번호(이슈 #107) — 숫자 14자리. 이 필드가 없는 이전 이벤트와 번호 체계 이전 주문은 null로 읽는다"),
-	orderItemId: z.string().describe("취소한 주문 상품 ID"),
-	status: orderItemStatusSchema.describe("취소 뒤 주문 대표 상태. 모든 주문 상품이 취소됐으면 `CANCELED`다"),
-	itemStatus: orderItemStatusSchema.describe("취소 뒤 주문 상품 상태. 전 수량이 취소됐으면 `CANCELED`, 일부만 취소했으면 원래 상태다"),
-	reason: z.string().describe("취소 사유 코드 — 판매자 취소 요청의 `reason`(`OUT_OF_STOCK`·`PRICE_ERROR`·`DELIVERY_IMPOSSIBLE`·`ETC`). 사유가 늘어날 수 있어 문자열이다. 모르는 값은 `ETC`처럼 다룬다"),
-	quantity: z.number().int().describe("이번에 취소한 수량"),
-	canceledQuantity: z.number().int().describe("취소 후 누적 취소 수량"),
-	refundAmount: z.number().int().describe("환불액 (원). 수량 비율 상품 실결제 금액(쿠폰 배분을 뺀 금액) + 배송비 환불 − 조건부 무료배송 미달 차감 + 되돌린 쿠폰 차감(`couponChargeRefundAmount`)이다. 결제사 환불 결과는 결제 내역(`GET /v1/payments/{paymentId}`)으로 확인한다"),
-	deliveryFeeRefundAmount: z.number().int().describe("환불액에 포함된 배송비 (원)"),
-	deliveryFeeChargeAmount: z.number().int().describe("환불액에서 뺀 배송비 (원) — 조건부 무료배송 기준 미달 차감"),
-	couponChargeAmount: z.number().int().optional().default(0).describe("환불액에서 뺀 쿠폰 조건 미달 차감 (원). 판매자 취소는 차감하지 않으므로 늘 0이다. 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
-	couponChargeRefundAmount: z.number().int().optional().default(0).describe("환불액에 더한 금액 (원) — 앞선 환불에서 뺀 쿠폰 조건 미달 차감을 되돌린 몫이다. 전량 취소면 누적 차감이 모두 되돌아간다. 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
-	pointRefundAmount: z.number().int().optional().default(0).describe("돌려준 적립금 (원, #93) — 결제에 쓴 적립금 중 이번 취소·반품 수량의 몫이다. 현금 환불(`refundAmount`)과 별개다. 차감은 현금에서 먼저 빼고 모자란 몫만 여기서 뺀다. 적립금을 쓰지 않은 주문과 이 필드가 없는 이전 응답·이벤트는 0으로 읽는다"),
-	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았다")
-});
-const claimWebhookEventDataSchema = z.object({
-	claimId: z.string().describe("클레임 ID"),
-	claimNo: z.string().nullable().optional().default(null).describe("클레임번호(이슈 #107) — `C` + YYMMDD + 숫자 8자리. 이 필드가 없는 이전 이벤트와 번호 체계 이전 클레임은 null로 읽는다"),
-	orderId: z.string().describe("주문 ID"),
-	orderItemId: z.string().describe("클레임 대상 주문 상품 ID"),
-	claimType: claimTypeSchema.describe("클레임 유형"),
-	status: claimStatusSchema.describe("이벤트 발생 시점의 클레임 상태"),
-	quantity: z.number().int().optional().default(0).describe("클레임 대상 수량. 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
-	refundAmount: z.number().int().nullable().optional().default(null).describe("환불액 (원). 배송비 환불을 포함하고 배송비 차감·추가 차감을 뺀 실제 금액이다. 환불이 확정되지 않은 접수 이벤트는 예상 환불액이고, 교환처럼 환불이 없으면 null이다"),
-	deliveryFeeRefundAmount: z.number().int().optional().default(0).describe("환불액에 포함된 배송비 (원). 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
-	deliveryFeeChargeAmount: z.number().int().optional().default(0).describe("환불액에서 뺀 배송비 (원) — 반품·교환 배송비와 조건부 무료배송 미달 차감의 합. 셀러가 승인에 넣은 추가 차감은 `deductAmount`로 따로 온다. 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
-	deductAmount: z.number().int().optional().default(0).describe("환불액에서 뺀 추가 차감 (원) — 셀러가 클레임 승인에 넣은 금액이다(상품 훼손 등). 배송비 차감과 별개이므로 `deliveryFeeChargeAmount`와 더해서 뺀다. 접수 이벤트와 이 필드가 없는 이전 이벤트는 0이다"),
-	couponChargeAmount: z.number().int().optional().default(0).describe("환불액에서 뺀 쿠폰 조건 미달 차감 (원) — 일부 취소·반품으로 남은 주문상품이 쿠폰 조건(최소 주문 금액 등)을 잃어 남은 주문상품이 받던 할인을 뺀 금액이다. 배송비 차감·추가 차감과 별개다. 접수 이벤트는 예상값이다. 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
-	couponChargeRefundAmount: z.number().int().optional().default(0).describe("환불액에 더한 금액 (원) — 앞선 환불에서 뺀 쿠폰 조건 미달 차감을 되돌린 몫이다. 접수 이벤트는 예상값이다. 이 필드가 없는 이전 이벤트는 0으로 읽는다"),
-	pointRefundAmount: z.number().int().optional().default(0).describe("돌려준 적립금 (원, #93) — 결제에 쓴 적립금 중 이번 취소·반품 수량의 몫이다. 현금 환불(`refundAmount`)과 별개다. 차감은 현금에서 먼저 빼고 모자란 몫만 여기서 뺀다. 적립금을 쓰지 않은 주문과 이 필드가 없는 이전 응답·이벤트는 0으로 읽는다"),
-	testPayment: z.boolean().optional().default(false).describe("테스트 결제(샌드박스 결제) 주문의 클레임인가. 이 필드가 없는 이전 이벤트는 false로 읽는다")
-});
-const inquiryWebhookEventDataSchema = z.object({
-	inquiryId: z.string().describe("상품 문의 ID"),
-	productId: z.string().describe("상품 ID")
-});
-const reviewWebhookEventDataSchema = z.object({
-	reviewId: z.string().describe("리뷰 ID"),
-	productId: z.string().describe("상품 ID"),
-	rating: z.number().int().min(1).max(5).describe("별점 (1~5)")
-});
-const productOutOfStockWebhookEventDataSchema = z.object({
-	productId: z.string().describe("상품 ID"),
-	variantId: z.string().describe("재고가 0이 된 판매 단위(variant) ID. 주문 상품의 `optionId`와 같은 값 공간이다")
-});
-const orderWebhookEventSchema = z.object({
-	...envelopeFields,
-	type: z.enum([
-		"ORDER.PAID",
-		"ORDER.CONFIRMED",
-		"ORDER.DISPATCHED",
-		"ORDER.DELIVERED",
-		"ORDER.PURCHASE_DECIDED",
-		"ORDER.ADDRESS_CHANGE_REQUESTED"
-	]),
-	data: orderWebhookEventDataSchema
-});
-const orderFulfilledWebhookEventSchema = z.object({
-	...envelopeFields,
-	type: z.literal("ORDER.FULFILLED"),
-	data: orderFulfilledWebhookEventDataSchema
-});
-const orderCanceledWebhookEventSchema = z.object({
-	...envelopeFields,
-	type: z.literal("ORDER.CANCELED"),
-	data: orderCanceledWebhookEventDataSchema
-});
-const claimWebhookEventSchema = z.object({
-	...envelopeFields,
-	type: z.enum([
-		"CLAIM.CANCEL_REQUESTED",
-		"CLAIM.RETURN_REQUESTED",
-		"CLAIM.EXCHANGE_REQUESTED",
-		"CLAIM.COMPLETED"
-	]),
-	data: claimWebhookEventDataSchema
-});
-const inquiryWebhookEventSchema = z.object({
-	...envelopeFields,
-	type: z.literal("INQUIRY.CREATED"),
-	data: inquiryWebhookEventDataSchema
-});
-const reviewWebhookEventSchema = z.object({
-	...envelopeFields,
-	type: z.literal("REVIEW.CREATED"),
-	data: reviewWebhookEventDataSchema
-});
-const productOutOfStockWebhookEventSchema = z.object({
-	...envelopeFields,
-	type: z.literal("PRODUCT.OUT_OF_STOCK"),
-	data: productOutOfStockWebhookEventDataSchema
-});
-/**
-* 플로우 알림(이슈 #115) — 상점이 플로우에 둔 알림 블록(`core.notify`, 채널 `webhook`)이 보낸다. 구매자 알림(알림톡·메일)은 이 이벤트를 받아
-* 상점이 보낸다(플랫폼은 구매자에게 직접 보내지 않는다). 개인정보는 싣지 않는다
-*/
-const flowNotificationWebhookEventDataSchema = z.object({
-	orderId: z.string().describe("주문 ID"),
-	orderItemIds: z.array(z.string()).describe("이 알림의 주문상품(묶음 진행이면 여럿)"),
-	event: z.string().describe("상점이 블록에 둔 알림 이름(`custom.<이름>`)"),
-	flowId: z.string(),
-	flowVersion: z.number().int(),
-	state: z.string().describe("알림을 보낸 전이의 도착 상태 키")
-});
-const flowNotificationWebhookEventSchema = z.object({
-	...envelopeFields,
-	type: z.literal("ORDER.FLOW_NOTIFICATION"),
-	data: flowNotificationWebhookEventDataSchema
-});
-/**
-* 흐름 상태 변경(이슈 #115) — 주문상품의 흐름 상태(노드)가 바뀔 때마다 온다. 공개 상태(`ORDER.*`)가 같아도 상점 흐름의 단계가 바뀌면 온다
-* (시안 확인 → 제작중). 묶음 진행이면 `orderItemIds`가 여럿이다. 개인정보는 싣지 않는다
-*/
-const flowStateChangedWebhookEventDataSchema = z.object({
-	orderId: z.string().describe("주문 ID"),
-	orderItemIds: z.array(z.string()).describe("상태가 바뀐 주문상품(묶음 진행이면 여럿)"),
-	flowId: z.string(),
-	flowVersion: z.number().int(),
-	from: z.string().nullable().describe("이전 상태 키. 흐름이 막 시작했으면 null"),
-	to: z.string().describe("새 상태 키"),
-	label: z.string().describe("새 상태의 셀러용 이름"),
-	coreStatus: z.string().nullable().describe("새 상태의 공개 상태. 공개 상태를 바꾸지 않는 단계면 null"),
-	changedAt: z.string().describe("바뀐 시각")
-});
-const flowStateChangedWebhookEventSchema = z.object({
-	...envelopeFields,
-	type: z.literal("ORDER.FLOW_STATE_CHANGED"),
-	data: flowStateChangedWebhookEventDataSchema
-});
-/** 웹훅 요청 본문. `type`으로 판별하며 `data` 형태가 타입별로 다르다 */
-const webhookEventSchema = z.discriminatedUnion("type", [
-	orderWebhookEventSchema,
-	orderFulfilledWebhookEventSchema,
-	orderCanceledWebhookEventSchema,
-	claimWebhookEventSchema,
-	inquiryWebhookEventSchema,
-	reviewWebhookEventSchema,
-	productOutOfStockWebhookEventSchema,
-	flowNotificationWebhookEventSchema,
-	flowStateChangedWebhookEventSchema
-]).describe("웹훅 요청 본문 (얇은 이벤트). 개인정보를 싣지 않으며 `data`의 id로 관리 API를 조회한다");
-/**
-* 알려진 웹훅 이벤트 타입 — `webhookEventSchema`의 판별 값 목록(이 SDK 버전이 아는 것).
-* 서버는 새 타입을 구독한 엔드포인트에만 보내지만, 구독을 더 넓힌 수신자를 위해 `parseWebhookEvent`가 모르는 타입을 따로 받는다.
-*/
-const KNOWN_WEBHOOK_EVENT_TYPES = webhookEventSchema.options.flatMap((option) => {
-	const type = option.shape.type;
-	return "options" in type ? [...type.options] : [type.value];
-});
-/** 이 SDK 버전이 모르는 이벤트 — 봉투만 검증하고 `data`는 그대로 둔다 */
-const unknownWebhookEventSchema = z.object({
-	...envelopeFields,
-	type: z.string().min(1),
-	data: z.unknown()
-});
-/**
-* 웹훅 본문을 `type`으로 먼저 판별해 읽는다(이슈 #115 결정 25). 알려진 타입은 그 타입의 스키마로 엄격하게 읽고 틀리면 던진다 —
-* `z.union([known, unknown])`처럼 읽으면 알려진 타입의 파싱 실패가 `known: false`로 조용히 새어 수신자가 처리할 이벤트를 버린다.
-* 모르는 타입은 봉투만 검증해 `known: false`로 돌려준다(새 이벤트에 옛 SDK가 깨지지 않는다).
-*/
-function parseWebhookEvent(body) {
-	const type = body?.type;
-	if (typeof type === "string" && KNOWN_WEBHOOK_EVENT_TYPES.includes(type)) return {
-		known: true,
-		event: webhookEventSchema.parse(body)
-	};
-	return {
-		known: false,
-		event: unknownWebhookEventSchema.parse(body)
-	};
-}
-//#endregion
 //#region src/session.ts
 /**
 * 세션 키 상수 — SDK가 소유한다. 값은 apps/store의 기존 쿠키 이름(SESSION_COOKIE/REFRESH_COOKIE)과
@@ -8298,4 +9140,4 @@ function createStoreSession(options) {
 	};
 }
 //#endregion
-export { APPROVAL_ALREADY_DECIDED_CODE, APPROVAL_REQUIRED_CODE, ApiError, ApprovalPendingError, BUSINESS_INFO_MAX_LENGTH, BUSINESS_NUMBER_PATTERN, CASH_RECEIPT_STATUS_VALUES, 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, CUSTOM_INPUT_FORBIDDEN_WORDS, CUSTOM_INPUT_TYPES, FULFILLMENT_METHODS, FULFILLMENT_METHODS_BY_TYPE, FULFILLMENT_METHOD_RULES, FULFILLMENT_RULES, KNOWN_WEBHOOK_EVENT_TYPES, MAX_ADDON_GROUPS, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_CALENDAR_DAYS, 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_OPTION_GROUPS, MAX_PICKUP_LOCATIONS, MAX_PRODUCT_IMAGES, 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, NO_COUPON_SETTLEMENT, NO_SHIPPING_BUNDLE_KEY, PAYMENT_ROUTING_EXCLUSION_CODES, 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, SHIPPING_POLICY_DEFAULTS, STOREFRONT_BLOCKED_PATH_SEGMENTS, STOREFRONT_BUILD_STAGES, STOREFRONT_BUILD_TERMINAL_STATUSES, STOREFRONT_CHECK_TERMINAL_STATUSES, 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_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, 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, addonGroupRequestSchema, addonGroupSchema, addonValueRequestSchema, addonValueSchema, addressChangeRequestListSchema, addressTypeSchema, agentPolicyDecisionSchema, 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, approvalDecisionRequestSchema, approvalListQuerySchema, approvalPageSchema, approvalRequestSchema, approvalStatusSchema, approveClaimResultSchema, auditActorSchema, auditActorTypeSchema, auditLogListQuerySchema, auditLogOutcomeSchema, auditLogPageSchema, auditLogSchema, auditLogSourceSchema, bestSellingRuleOf, buildAuthorizeUrl, buildQuery, bulkResultSchema, businessInfoPatchShape, businessInfoResponseShape, businessNumberSchema, calendarDateSchema, calendarDaySchema, calendarQuerySchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, cashReceiptSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeStorefrontSlugRequestSchema, changeStorefrontTemplateRequestSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimReturnAddressSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, collectionCreateRequestSchema, collectionListQuerySchema, collectionPageSchema, collectionPatchRequestSchema, collectionPreviewRequestSchema, collectionPreviewSchema, collectionProductListQuerySchema, collectionProductSchema, collectionProductSortRequestSchema, collectionProductsAddRequestSchema, collectionProductsReplaceRequestSchema, collectionRuleCategoryIds, collectionRuleSchema, collectionRuleViewSchema, collectionRulesPredicate, collectionRulesSchema, collectionSchema, collectionStateCountsSchema, collectionStateOf, collectionStateSchema, commerceFlowCheckSchema, commerceFlowSchema, commerceFlowSummarySchema, commerceFlowVersionViewSchema, commerceNumberField, compareBySales, consentActionSchema, consentKindSchema, consentSourceSchema, couponBenefitSchema, couponConditionsInputSchema, couponConditionsSchema, couponDiscountOf, couponIssueListQuerySchema, couponIssueMethodSchema, couponIssueSchema, couponIssueStatusSchema, couponKindSchema, couponListQuerySchema, couponRedemptionListQuerySchema, couponRedemptionSchema, couponRejectReasonSchema, couponRuleSchema, couponSchema, couponStatsSchema, couponStatusSchema, couponTargetInputSchema, couponTargetSchema, createCommerceFlowRequestSchema, createCouponRequestSchema, createPkcePair, createStoreClient, createStoreSession, createStorefrontEditPreviewLinkRequestSchema, createStorefrontPreviewLinkRequestSchema, createStorefrontSiteRequestSchema, createStorefrontVersionRequestSchema, 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, disableStorefrontHostingRequestSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, flowActionRequestSchema, flowActionResultSchema, flowActionSchema, flowFieldValueSchema, flowInputFieldSchema, flowNodeTypesSchema, flowNotificationWebhookEventDataSchema, flowNotificationWebhookEventSchema, flowPresetDetailSchema, flowPresetSummarySchema, flowRunSchema, flowRunStepSchema, flowSecretNameSchema, flowSecretSchema, flowStateChangedWebhookEventDataSchema, flowStateChangedWebhookEventSchema, flowStateSchema, formatOrderNo, fulfillBulkRequestSchema, fulfillRequestSchema, fulfillmentMethodOf, fulfillmentMethodSchema, fulfillmentMethodsOf, fulfillmentRuleOf, fulfillmentTypeOf, fulfillmentTypeResponseSchema, fulfillmentTypeSchema, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, inventoryModeSchema, invitationDeliveryStatusSchema, invitationListQuerySchema, invitationSchema, inviteMemberRequestSchema, isCouponTargetLine, isEditableStorefrontPath, isReservedStoreCode, isReservedStorefrontSlug, isShowcaseStorefrontSlug, isStoreScope, isWebOrigin, issueCouponRequestSchema, issueCouponResultSchema, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, matchesCollectionRules, mcpRuleResultSchema, mcpToolEventSchema, migrateFlowVersionRequestSchema, migrateFlowVersionResultSchema, moveFlowStateRequestSchema, moveStorefrontFileRequestSchema, myAccountSchema, myStoreSchema, nightsOf, normalizeBusinessNumber, normalizeCouponCode, 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, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentFailureWarningSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, pickupLocationRequestSchema, pickupLocationSchema, pickupLocationSnapshotSchema, planCodeSchema, planEntitlementsSchema, planErrorDetailsSchema, pointAdjustmentRequestSchema, pointAdjustmentResultSchema, pointEarnOf, pointEarnRateBpSchema, pointEarningEnabled, pointEntrySchema, pointExpiresAtOf, pointHistoryQuerySchema, pointLotSchema, pointPolicyNoticeSchema, pointPolicySchema, pointRestoreExpiresAtOf, pointUseOf, pointUsePolicySchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productFulfillmentCreateSchema, productFulfillmentResponseSchema, productFulfillmentSchema, productFulfillmentUpdateSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productRefundPolicyOverride, productRefundPolicyPatchSchema, productReplaceRequestSchema, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, proratedPaidRefundBase, proratedPointRefund, proratedRefundBase, publicPlanSchema, publicPlansSchema, publishStorefrontVersionRequestSchema, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, purchaseEarnPolicySchema, purchaseEarnRateOf, 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, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveFlowDraftRequestSchema, saveFlowSecretRequestSchema, saveLoginProviderRequestSchema, savedCustomInputRequestSchema, savedCustomInputSchema, savedOptionGroupRequestSchema, savedOptionGroupSchema, savedOptionSetCompositionSchema, savedOptionSetFromProductRequestSchema, savedOptionSetFromProductResultSchema, savedOptionSetListQuerySchema, savedOptionSetRequestSchema, savedOptionSetSchema, savedOptionSetSortSchema, savedOptionValueRequestSchema, savedOptionValueSchema, scopeAccessSchema, searchStorefrontFilesRequestSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCancelPreviewSchema, sellerCustomerInquirySchema, setCalendarRequestSchema, setStorefrontVisibilityRequestSchema, settleCouponShortfall, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, shippingPolicyPatchSchema, shippingPolicySchema, simulateFlowRequestSchema, simulateFlowResultSchema, simulationStepSchema, splitRefund, stayRangeSchema, staySnapshotSchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storePointPolicySchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeSubscriptionSchema, storefrontBuildDependenciesSchema, storefrontBuildListQuerySchema, storefrontBuildSchema, storefrontBuildStatusSchema, storefrontCheckSchema, storefrontCheckStatusSchema, storefrontCustomDomainStatusSchema, storefrontCustomHostnameProblem, storefrontDependencyFindingSchema, storefrontDeploymentLogSchema, storefrontDeploymentSchema, storefrontDeploymentStepSchema, storefrontDnsRecordSchema, storefrontDomainSchema, storefrontDomainTxtNameOf, storefrontEditPreviewLabelOf, storefrontEditPreviewSchema, storefrontEditSessionSchema, storefrontEditSessionStatusSchema, storefrontEditingSchema, storefrontFileConflictDetailsSchema, storefrontFileContentQuerySchema, storefrontFileContentSchema, storefrontFileDeleteResultSchema, storefrontFileEncodingSchema, storefrontFileEntrySchema, storefrontFileHashSchema, storefrontFileListQuerySchema, storefrontFileListSchema, storefrontFileMoveResultSchema, storefrontFilePathSchema, storefrontFileSearchResultSchema, storefrontFileWriteResultSchema, storefrontHostingSchema, storefrontPreviewLinkSchema, storefrontProvisioningSchema, storefrontRuleResultSchema, storefrontRuleSeveritySchema, storefrontSiteDomainSchema, storefrontSiteDomainsSchema, storefrontSiteSchema, storefrontSiteStatusSchema, storefrontSlugAvailabilityQuerySchema, storefrontSlugAvailabilitySchema, storefrontSlugSchema, storefrontSourceArchivePartSchema, storefrontSourceArchiveQuerySchema, storefrontSourceBlobsResultSchema, storefrontSourceModeSchema, storefrontSourceRefSchema, storefrontSourceReplacedSchema, storefrontSourceSchema, storefrontSuspensionSchema, storefrontTemplateSchema, storefrontVerifyReportSchema, storefrontVersionCreatedSchema, storefrontVersionSchema, storefrontVersionStatusSchema, storefrontVisibilitySchema, subscriptionLimitsSchema, subscriptionStatusSchema, subscriptionUsageSchema, tossPaymentsCredentialsInputSchema, trackingStageResponseSchema, trackingUpdateResultSchema, unknownWebhookEventSchema, updateCouponRequestSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updateMemberRoleRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updatePointPolicyRequestSchema, updateStoreRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadStorefrontSourceBlobsRequestSchema, uploadTicketSchema, 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 { 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_HANDLE_PATTERN, APP_LIFECYCLE_EVENT_TYPES, APP_NETWORK_DENIED_SUFFIXES, APP_NETWORK_HOSTS_MAX, APP_RESERVED_HANDLES, 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_UI_MAX_BYTES, APP_UI_MAX_FILES, ApiError, ApprovalPendingError, BRAND_BRIEF_MAX_REFERENCES, BUSINESS_INFO_MAX_LENGTH, BUSINESS_NUMBER_PATTERN, CASH_RECEIPT_STATUS_VALUES, 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, CUSTOM_INPUT_FORBIDDEN_WORDS, CUSTOM_INPUT_TYPES, FULFILLMENT_METHODS, FULFILLMENT_METHODS_BY_TYPE, FULFILLMENT_METHOD_RULES, FULFILLMENT_RULES, INSTALLABLE_SCOPES, KNOWN_WEBHOOK_EVENT_TYPES, MAX_ADDON_GROUPS, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_CALENDAR_DAYS, 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_OPTION_GROUPS, MAX_PICKUP_LOCATIONS, MAX_PRODUCT_IMAGES, 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, 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_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, 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, addonGroupRequestSchema, addonGroupSchema, addonValueRequestSchema, addonValueSchema, addressChangeRequestListSchema, addressTypeSchema, agentPolicyDecisionSchema, 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, appHandleSchema, appInstallRequestSchema, appInstallationAppSchema, appInstallationSchema, appInstallationSelfSchema, appInstallationSettingsSchema, appInstallationSettingsUpdateSchema, appInstallationStatusSchema, appInvocationSchema, appManifestProblems, appManifestSchema, appManifestWidens, appNetworkHostProblem, appNetworkHostSchema, appReleaseResultSchema, appRuntimeSchema, appScopeSchema, appSecretSummarySchema, appSessionSchema, appSettingFieldSchema, appStatusSchema, appVersionSchema, appVersionStatusSchema, approvalDecisionRequestSchema, approvalListQuerySchema, approvalPageSchema, approvalRequestSchema, approvalStatusSchema, approveClaimResultSchema, 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, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeStorefrontSlugRequestSchema, changeStorefrontTemplateRequestSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimReturnAddressSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, collectionCreateRequestSchema, collectionListQuerySchema, collectionPageSchema, collectionPatchRequestSchema, collectionPreviewRequestSchema, collectionPreviewSchema, collectionProductListQuerySchema, collectionProductSchema, collectionProductSortRequestSchema, collectionProductsAddRequestSchema, collectionProductsReplaceRequestSchema, collectionRuleCategoryIds, collectionRuleSchema, collectionRuleViewSchema, collectionRulesPredicate, collectionRulesSchema, collectionSchema, collectionStateCountsSchema, collectionStateOf, collectionStateSchema, commerceFlowCheckSchema, commerceFlowSchema, commerceFlowSummarySchema, commerceFlowVersionViewSchema, commerceNumberField, compareBySales, consentActionSchema, consentKindSchema, consentSourceSchema, couponBenefitSchema, couponConditionsInputSchema, couponConditionsSchema, couponDiscountOf, couponIssueListQuerySchema, couponIssueMethodSchema, couponIssueSchema, couponIssueStatusSchema, couponKindSchema, couponListQuerySchema, couponRedemptionListQuerySchema, couponRedemptionSchema, couponRejectReasonSchema, couponRuleSchema, couponSchema, couponStatsSchema, couponStatusSchema, couponTargetInputSchema, couponTargetSchema, createCommerceFlowRequestSchema, createCouponRequestSchema, createPkcePair, createStoreClient, createStoreSession, createStorefrontEditPreviewLinkRequestSchema, createStorefrontPreviewLinkRequestSchema, createStorefrontSiteRequestSchema, createStorefrontVersionRequestSchema, 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, disableStorefrontHostingRequestSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, flowActionRequestSchema, flowActionResultSchema, flowActionSchema, flowFieldValueSchema, flowInputFieldSchema, flowNodeTypesSchema, flowNotificationWebhookEventDataSchema, flowNotificationWebhookEventSchema, flowPresetDetailSchema, flowPresetSummarySchema, flowRunSchema, flowRunStepSchema, flowSecretNameSchema, flowSecretSchema, flowStateChangedWebhookEventDataSchema, flowStateChangedWebhookEventSchema, flowStateSchema, formatOrderNo, fulfillBulkRequestSchema, fulfillRequestSchema, fulfillmentMethodOf, fulfillmentMethodSchema, fulfillmentMethodsOf, fulfillmentRuleOf, fulfillmentTypeOf, fulfillmentTypeResponseSchema, fulfillmentTypeSchema, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, inventoryModeSchema, invitationDeliveryStatusSchema, invitationListQuerySchema, invitationSchema, inviteMemberRequestSchema, isCouponTargetLine, isEditableStorefrontPath, isInstallableScope, isReservedStoreCode, isReservedStorefrontSlug, isShowcaseStorefrontSlug, isStoreScope, isWebOrigin, issueCouponRequestSchema, issueCouponResultSchema, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, matchesCollectionRules, mcpRuleResultSchema, mcpToolEventSchema, migrateFlowVersionRequestSchema, migrateFlowVersionResultSchema, moveFlowStateRequestSchema, moveStorefrontFileRequestSchema, myAccountSchema, myStoreSchema, nightsOf, normalizeBusinessNumber, normalizeCouponCode, 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, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentFailureWarningSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, pickupLocationRequestSchema, pickupLocationSchema, pickupLocationSnapshotSchema, planCodeSchema, planEntitlementsSchema, planErrorDetailsSchema, pointAdjustmentRequestSchema, pointAdjustmentResultSchema, pointEarnOf, pointEarnRateBpSchema, pointEarningEnabled, pointEntrySchema, pointExpiresAtOf, pointHistoryQuerySchema, pointLotSchema, pointPolicyNoticeSchema, pointPolicySchema, pointRestoreExpiresAtOf, pointUseOf, pointUsePolicySchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productFulfillmentCreateSchema, productFulfillmentResponseSchema, productFulfillmentSchema, productFulfillmentUpdateSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, 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, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveFlowDraftRequestSchema, saveFlowSecretRequestSchema, saveLoginProviderRequestSchema, savedCustomInputRequestSchema, savedCustomInputSchema, savedOptionGroupRequestSchema, savedOptionGroupSchema, savedOptionSetCompositionSchema, savedOptionSetFromProductRequestSchema, savedOptionSetFromProductResultSchema, savedOptionSetListQuerySchema, savedOptionSetRequestSchema, savedOptionSetSchema, savedOptionSetSortSchema, savedOptionValueRequestSchema, savedOptionValueSchema, scopeAccessSchema, scopesCoverEvent, searchStorefrontFilesRequestSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCancelPreviewSchema, sellerCustomerInquirySchema, setCalendarRequestSchema, setStorefrontVisibilityRequestSchema, settleCouponShortfall, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, shippingPolicyPatchSchema, shippingPolicySchema, simulateFlowRequestSchema, simulateFlowResultSchema, simulationStepSchema, splitRefund, starterSellerTaskSchema, starterStageSchema, starterStatusSchema, starterStoreInfoFieldSchema, stayRangeSchema, staySnapshotSchema, storeCodeSchema, storeIndustrySchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storePointPolicySchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeSubscriptionSchema, storeTemplateSchema, storefrontBuildDependenciesSchema, storefrontBuildListQuerySchema, storefrontBuildSchema, storefrontBuildStatusSchema, storefrontCheckSchema, storefrontCheckStatusSchema, storefrontCustomDomainStatusSchema, storefrontCustomHostnameProblem, storefrontDependencyFindingSchema, storefrontDeploymentLogSchema, storefrontDeploymentSchema, storefrontDeploymentStepSchema, storefrontDnsRecordSchema, storefrontDomainSchema, storefrontDomainTxtNameOf, storefrontEditPreviewLabelOf, storefrontEditPreviewSchema, storefrontEditSessionSchema, storefrontEditSessionStatusSchema, storefrontEditingSchema, storefrontFileConflictDetailsSchema, storefrontFileContentQuerySchema, storefrontFileContentSchema, storefrontFileDeleteResultSchema, storefrontFileEncodingSchema, storefrontFileEntrySchema, storefrontFileHashSchema, storefrontFileListQuerySchema, storefrontFileListSchema, storefrontFileMoveResultSchema, storefrontFilePathSchema, storefrontFileSearchResultSchema, storefrontFileWriteResultSchema, storefrontHostingSchema, storefrontPreviewLinkSchema, storefrontProvisioningSchema, storefrontRuleResultSchema, storefrontRuleSeveritySchema, storefrontSiteDomainSchema, storefrontSiteDomainsSchema, storefrontSiteSchema, storefrontSiteSnapshotSchema, storefrontSiteStatusSchema, storefrontSlugAvailabilityQuerySchema, storefrontSlugAvailabilitySchema, storefrontSlugSchema, storefrontSourceArchivePartSchema, storefrontSourceArchiveQuerySchema, storefrontSourceBlobsResultSchema, storefrontSourceModeSchema, storefrontSourceRefSchema, storefrontSourceReplacedSchema, storefrontSourceSchema, storefrontSuspensionSchema, storefrontTemplateSchema, storefrontVerifyReportSchema, storefrontVersionCreatedSchema, storefrontVersionSchema, storefrontVersionStatusSchema, storefrontVisibilitySchema, subscriptionLimitsSchema, subscriptionStatusSchema, subscriptionUsageSchema, tossPaymentsCredentialsInputSchema, trackingStageResponseSchema, trackingUpdateResultSchema, unknownWebhookEventSchema, updateCouponRequestSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updateMemberRoleRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updatePointPolicyRequestSchema, updateStoreRequestSchema, updateStoreTemplateRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadStorefrontSourceBlobsRequestSchema, uploadTicketSchema, 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 };