@sayren/store-sdk 0.30.10 → 0.30.11

package/dist/index.mjs

@@ -2806,221 +2806,544 @@ 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
+//#region src/schemas/misc.ts
+const inquirySchema = z.object({
+	inquiryId: z.string(),
+	productId: z.string(),
+	productName: z.string(),
+	orderItemId: z.string().nullable(),
+	category: z.enum([
+		"PRODUCT",
+		"DELIVERY",
+		"RETURN",
+		"EXCHANGE",
+		"ETC"
+	]),
+	content: z.string(),
+	secret: z.boolean(),
+	writerMaskedName: z.string(),
+	answered: z.boolean(),
+	answer: z.object({
+		content: z.string(),
+		answeredAt: z.string(),
+		modifiedCount: z.number().int().max(1)
+	}).nullable(),
+	createdAt: z.string()
 });
-const settingsValueSchema = z.union([
-	z.string(),
-	z.number(),
-	z.boolean(),
-	z.null()
+const customerInquiryCategorySchema = z.enum([
+	"DELIVERY",
+	"RETURN",
+	"EXCHANGE",
+	"PAYMENT",
+	"ETC"
 ]);
-/** 설치 설정 — 비밀 필드 값은 가려서 준다(앞 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()
+/** 셀러 뷰 1:1 문의 — 작성자 마스킹명 + 답변 수정횟수 포함 */
+const sellerCustomerInquirySchema = z.object({
+	inquiryId: z.string(),
+	memberMaskedName: z.string(),
+	category: customerInquiryCategorySchema,
+	title: z.string(),
+	content: z.string(),
+	orderItemId: z.string().nullable(),
+	answered: z.boolean(),
+	answer: z.object({
+		content: z.string(),
+		answeredAt: z.string(),
+		modifiedCount: z.number().int().max(1)
 	}).nullable(),
-	installedAt: z.string(),
-	uninstalledAt: z.string().nullable(),
-	updatedAt: z.string()
+	createdAt: z.string()
 });
-/**
-* `POST /v1/apps/installations`(상점 플랫폼 전용) — 둘 중 하나다.
-* - `{ result }`: accounts 설치 동의 결과(1회용 JWT). 개발자 포털 [내 상점에 설치]가 이 길로 온다
-* - `{ appId, settings }`: 상점 플랫폼 앱 목록 › 설치 화면에서 동의하고 설정까지 채워 바로 설치한다
-*/
-const appInstallRequestSchema = z.union([z.object({ result: z.string().min(1).describe("accounts가 발급한 설치 결과 JWT(`typ: sayren-install+jwt`)") }), z.object({
-	appId: z.string().min(1),
-	settings: z.record(z.string(), settingsValueSchema).default({}).describe("설치와 함께 저장할 설정. 비밀 필드도 여기서 넣는다")
-})]);
-/** 앱 목록 정보 — 현재 버전이 올린 아이콘·README(없으면 매니페스트 `iconUrl`) */
-const appListingSchema = z.object({
-	description: z.string().nullable(),
-	iconUrl: z.string().nullable().describe("아이콘 주소. 앱 폴더에서 올린 아이콘은 data URI, 매니페스트 `iconUrl`은 https 주소"),
-	readme: z.string().nullable().describe("README 마크다운 원문")
+const answeredQuery = z.enum(["true", "false"]).optional().describe("답변 여부 필터. `true`면 답변된 문의만, `false`면 미답변만, 생략하면 전부");
+/** `GET /v1/inquiries` 쿼리(상품 문의) — OpenAPI 문서용 형태(값은 쿼리 문자열). 최신순이다 */
+const inquiryListQuerySchema = z.object({
+	answered: answeredQuery,
+	productId: z.string().optional().describe("상품 id 필터"),
+	from: z.string().optional().describe("작성 시각 조회 시작 (ISO 8601, 포함)"),
+	...pageQueryShape()
 });
-/** `GET /v1/apps/catalog` — 이 상점에 설치할 수 있는 앱(A1: 내가 속한 개발자 조직의 앱) */
-const storeAppSchema = z.object({
-	appId: z.string(),
-	handle: z.string(),
-	name: z.string(),
-	description: z.string().nullable(),
-	iconUrl: z.string().nullable(),
-	developerName: z.string(),
-	versionNumber: z.number().int().describe("현재 버전"),
-	installationId: z.string().nullable().describe("이 상점에 설치돼 있으면 설치 id")
+/** `GET /v1/customer-inquiries` 쿼리(1:1 문의) — OpenAPI 문서용 형태(값은 쿼리 문자열). 최신순이다 */
+const customerInquiryListQuerySchema = z.object({
+	answered: answeredQuery,
+	category: customerInquiryCategorySchema.optional().describe("문의 유형 필터"),
+	from: z.string().optional().describe("작성 시각 조회 시작 (ISO 8601, 포함)"),
+	...pageQueryShape()
 });
-/** `GET /v1/apps/catalog/{appId}` — 앱 상세·설치 화면 */
-const storeAppDetailSchema = storeAppSchema.extend({
-	readme: z.string().nullable(),
-	supportEmail: z.string().nullable(),
-	scopes: z.array(z.string()).describe("설치 때 동의하는 스코프(Scope)"),
-	events: z.array(appEventTypeSchema).describe("받는 이벤트(Hook)"),
-	networkHosts: z.array(z.string()).describe("앱이 데이터를 보내는 외부 호스트"),
-	settings: z.record(z.string(), appSettingFieldSchema).describe("설치 때 채우는 설정 필드"),
-	updatedAt: z.string().nullable().describe("현재 버전을 release한 시각")
+const settlementStatusSchema = z.enum([
+	"SCHEDULED",
+	"PAID",
+	"HELD"
+]);
+const settlementSummarySchema = z.object({
+	settlementId: z.string(),
+	settlementDate: z.string(),
+	payoutDate: z.string().nullable(),
+	status: settlementStatusSchema,
+	totalPaymentAmount: z.number().int(),
+	totalCommission: z.number().int(),
+	totalDeliveryFee: z.number().int(),
+	adjustmentAmount: z.number().int(),
+	settlementAmount: z.number().int(),
+	itemCount: z.number().int()
 });
-/** `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}.{앱 도메인}`)")
+const settlementDetailSchema = z.object({
+	orderItemId: z.string(),
+	productName: z.string(),
+	settlementType: z.enum([
+		"SALE",
+		"REFUND_DEDUCTION",
+		"ADJUSTMENT"
+	]),
+	paymentAmount: z.number().int(),
+	salesCommission: z.number().int(),
+	paymentCommission: z.number().int(),
+	commissionRate: z.number(),
+	deliveryFee: z.number().int(),
+	settlementAmount: z.number().int(),
+	purchaseDecidedAt: z.string().nullable()
 });
-/** `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()
+/** `GET /v1/settlements/{settlementId}` 응답 — 정산 요약 + 상세 내역(`size`건까지) */
+const settlementWithDetailsSchema = settlementSummarySchema.extend({ details: z.array(settlementDetailSchema).optional() });
+/** `GET /v1/settlements` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열). 정산일 최신순이다 */
+const settlementListQuerySchema = z.object({
+	from: z.string().describe("정산일 조회 시작 (ISO 8601, 포함). 필수"),
+	to: z.string().optional().describe("정산일 조회 끝 (ISO 8601, 포함). 생략하면 from부터 31일. 기간은 최대 31일"),
+	status: settlementStatusSchema.optional().describe("정산 상태 필터"),
+	...pageQueryShape()
 });
-const developerOrgSchema = z.object({
-	orgId: z.string(),
-	name: z.string(),
-	role: z.enum(["OWNER", "MEMBER"])
+/** `GET /v1/settlements/{settlementId}` 쿼리 — `size`는 돌려줄 상세 내역 건수다(`page`는 무시) */
+const settlementDetailQuerySchema = z.object(pageQueryShape({
+	defaultSize: 100,
+	maxSize: 300
+}));
+const eventTypeSchema = z.enum([
+	"ORDER.PAID",
+	"ORDER.CONFIRMED",
+	"ORDER.DISPATCHED",
+	"ORDER.DELIVERED",
+	"ORDER.PURCHASE_DECIDED",
+	"ORDER.ADDRESS_CHANGE_REQUESTED",
+	"ORDER.CANCELED",
+	"ORDER.FULFILLED",
+	"CLAIM.CANCEL_REQUESTED",
+	"CLAIM.RETURN_REQUESTED",
+	"CLAIM.EXCHANGE_REQUESTED",
+	"CLAIM.COMPLETED",
+	"INQUIRY.CREATED",
+	"REVIEW.CREATED",
+	"PRODUCT.OUT_OF_STOCK",
+	"ORDER.FLOW_NOTIFICATION",
+	"ORDER.FLOW_STATE_CHANGED"
+]).describe("웹훅 이벤트 타입. `ORDER.ADDRESS_CHANGE_REQUESTED`는 현재 발송하지 않음(호환을 위해 값만 남았고, 구독해도 이벤트가 오지 않는다)");
+const webhookStatusSchema = z.enum(["ACTIVE", "SUSPENDED"]).describe("구독 상태. `ACTIVE`=발송 대상, `SUSPENDED`=24시간 이상 연속 전송 실패로 발송이 정지된 상태. 정지 중 발생한 이벤트는 적재하지 않는다. 재개(`POST /webhooks/{id}/resume`)하거나 구독을 수정하면 ACTIVE로 돌아간다");
+const webhookSchema = z.object({
+	webhookId: z.string(),
+	url: z.url(),
+	eventTypes: z.array(eventTypeSchema),
+	status: webhookStatusSchema,
+	secretPrefix: z.string().describe("서명 시크릿 앞부분(식별용, 서명 검증에 사용할 수 없음). 예: `whsec_1a2b`"),
+	suspendedAt: z.string().nullable().describe("발송이 정지된 일시 (ISO 8601). `ACTIVE`면 null"),
+	createdAt: z.string()
 });
-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 webhookCreatedSchema = webhookSchema.extend({ secret: z.string().describe("서명 시크릿 평문. 등록 응답에서만 노출되며 다시 조회할 수 없다") });
+/** 시크릿 교체 응답 */
+const webhookSecretRotatedSchema = z.object({
+	secret: z.string().describe("새 서명 시크릿 평문. 이 응답에서만 노출된다"),
+	oldSecretExpiresAt: z.string().describe("기존 시크릿의 병행 유효 종료 일시 (ISO 8601). 이때까지는 기존 시크릿 서명도 함께 붙는다")
 });
-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(),
-	listing: appListingSchema.nullable().optional().default(null).describe("이 버전이 올린 아이콘·설명·README"),
-	releasedAt: z.string().nullable(),
-	revokedAt: z.string().nullable(),
+const webhookDeliveryStatusSchema = z.enum([
+	"PENDING",
+	"PENDING_RETRY",
+	"SUCCESS",
+	"FAILED"
+]).describe("전송 상태. `PENDING`=첫 시도 전, `PENDING_RETRY`=실패 후 재시도 대기, `SUCCESS`=2xx 응답 수신, `FAILED`=재시도를 모두 소진했거나 구독 정지로 종료");
+const webhookDeliveryErrorCodeSchema = z.enum([
+	"TIMEOUT",
+	"CONNECTION_FAILED",
+	"BLOCKED_ADDRESS",
+	"NON_2XX",
+	"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`와 같은 이유).
+* 모르는 값은 `errorCode`로 판단한다.
+*/
+const WEBHOOK_FAILURE_REASONS = [
+	"DNS",
+	"TLS",
+	"TIMEOUT",
+	"CONNECTION",
+	"HTTP_4XX",
+	"HTTP_5XX",
+	"HTTP_OTHER",
+	"SSRF_BLOCKED",
+	"SUSPENDED"
+];
+const webhookFailureReasonSchema = z.string().describe("실패 원인 분류(진단용). 현재 값은 `DNS`=호스트 이름을 주소로 바꾸지 못함, `TLS`=인증서·핸드셰이크 실패, `TIMEOUT`=10초 안에 응답 없음, `CONNECTION`=연결 거부·끊김, `HTTP_4XX`·`HTTP_5XX`=그 대역의 응답, `HTTP_OTHER`=2xx·4xx·5xx가 아닌 응답(리다이렉트 등), `SSRF_BLOCKED`=사설·루프백 등 전송이 허용되지 않는 주소, `SUSPENDED`=구독 정지로 대기 중인 전송이 종료됨. `errorCode`보다 잘게 나눈 값이며 둘은 함께 쓸 수 있다. 값이 추가될 수 있으므로 모르는 값은 `errorCode`로 판단한다");
+/**
+* 대상 리소스 종류의 **현재** 값. 응답 스키마는 문자열로 열려 있다(새 이벤트가 새 리소스를 가리킬 수 있다).
+*/
+const WEBHOOK_RESOURCE_TYPES = [
+	"ORDER",
+	"CLAIM",
+	"PRODUCT",
+	"REVIEW",
+	"INQUIRY"
+];
+const webhookResourceTypeSchema = z.string().describe("이벤트가 가리키는 리소스 종류. 현재 값은 `ORDER`·`CLAIM`·`PRODUCT`·`REVIEW`·`INQUIRY`이고 값이 추가될 수 있다");
+/** 이벤트가 가리키는 대상 리소스 — 전송 기록을 주문·상품과 잇는 키 */
+const webhookDeliveryResourceSchema = z.object({
+	type: webhookResourceTypeSchema,
+	id: z.string().describe("리소스 ID. 전송 기록 조회의 `resourceId`, API 로그 조회의 `q`로 그대로 넣을 수 있다")
+});
+/** 발송 요청 헤더 한 줄 (값 마스킹) */
+const webhookRequestHeaderSchema = z.object({
+	name: z.string().describe("헤더 이름"),
+	value: z.string().nullable().describe("헤더 값. 서명(`Sayren-Signature`)처럼 비밀이 섞이는 헤더는 이름만 주고 값은 null이다")
+});
+/** 웹훅 전송 기록 한 건 (전송 기록 조회 항목) */
+const webhookDeliverySchema = z.object({
+	deliveryId: z.string().describe("전송 기록 ID. 수신 요청의 `Sayren-Delivery-Id` 헤더 값"),
+	eventId: z.string().describe("이벤트 ID. 재시도·재전송해도 같은 이벤트면 같은 값이다. 수신 측 중복 제거 키로 쓴다"),
+	eventType: eventTypeSchema,
+	url: z.string().describe("전송 시점의 대상 URL"),
+	status: webhookDeliveryStatusSchema,
+	responseStatusCode: z.number().int().nullable().describe("마지막 시도의 HTTP 응답 코드. 미시도·연결 실패·타임아웃·차단이면 null"),
+	responseTimeMs: z.number().int().nullable().describe("마지막 시도의 응답 시간(ms). 미시도·연결 실패면 null"),
+	responseBodyExcerpt: z.string().nullable().describe("마지막 시도의 응답 본문 앞부분(최대 4,096자). 응답이 없으면 null. 가린 뒤에 자른다. 키 이름에 `authorization`·`token`·`secret`·`password`·`key`·`signature`·`credential`·`cookie`가 **들어 있으면**(부분 일치, 대소문자 무시. 예: `apiKey`·`access_token`·`keyword`) 그 값을 `***`로 가린다. 값이 객체·배열이면 통째로 가린다. 평문 `Authorization: …` 같은 헤더 줄, `Bearer <토큰>`, 쿼리 형식 `access_token=…`, 끝에서 잘려 닫히지 않은 값도 가린다"),
+	errorCode: webhookDeliveryErrorCodeSchema.nullable().describe("마지막 시도의 실패 사유. 성공했거나 미시도면 null"),
+	failureReason: webhookFailureReasonSchema.nullable().describe("마지막 시도의 실패 원인 분류. 성공했거나 미시도면 null. `errorCode`를 더 잘게 나눈 진단 값이다"),
+	resource: webhookDeliveryResourceSchema.nullable().describe("이벤트가 가리키는 대상 리소스. 리소스를 특정할 수 없는 이벤트면 null. 이 값으로 전송 기록(`resourceId`)과 API 로그(`q`)를 오갈 수 있다"),
+	attemptCount: z.number().int().min(0).describe("지금까지 전송을 시작한 횟수. 최초 시도 1회 + 재시도 최대 4회. 전송 도중 장애로 결과를 기록하지 못한 시도도 센다"),
+	createdAt: z.string().describe("전송 기록이 적재된 일시 (ISO 8601)"),
+	attemptedAt: z.string().nullable().describe("마지막 시도 일시 (ISO 8601). 미시도면 null"),
+	nextAttemptAt: z.string().nullable().describe("다음 시도 예정 일시 (ISO 8601). `PENDING`·`PENDING_RETRY`일 때만 값이 있다"),
+	redeliveryOf: z.string().nullable().describe("수동 재전송으로 생긴 기록이면 원본 전송 기록 ID. 아니면 null"),
+	redeliveredAs: z.string().nullable().describe("이 기록을 원본으로 수동 재전송해 생긴 기록의 전송 기록 ID. 아직 재전송하지 않았으면 null. 재전송은 원본당 1회다")
+});
+/** 발송 본문 최대 노출 길이(바이트). 넘으면 잘라 주고 `payloadTruncated`가 true다 */
+const WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES = 16384;
+/** 웹훅 전송 기록 상세 — `GET /webhooks/{id}/deliveries/{deliveryId}`. 목록 항목 + 요청 본문·헤더 */
+const webhookDeliveryDetailSchema = webhookDeliverySchema.extend({
+	payload: z.string().describe(`수신 서버로 보낸 요청 본문 그대로(JSON 문자열). 서명은 이 문자열을 대상으로 계산한다. 최대 ${WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES / 1024}KB까지 주고 넘으면 잘라 준다`),
+	payloadTruncated: z.boolean().describe("본문이 길어서 잘렸으면 true. true면 `payload`는 유효한 JSON이 아니다"),
+	payloadMasked: z.boolean().describe("민감 키 마스킹(`responseBodyExcerpt`와 같은 키 이름 규칙)이 본문을 바꿨으면 true. true면 `payload`는 보낸 본문과 달라 서명을 맞춰 볼 수 없다. 이벤트 본문에는 보통 민감 키가 없어 false다"),
+	requestHeaders: z.array(webhookRequestHeaderSchema).describe("발송 요청에 실은 헤더. 값은 전송 시점 그대로이나 서명 헤더는 이름만 주고 값은 null이다. `Content-Length`는 실제로 보낸 본문(마스킹·자르기 전)의 바이트 수다. 매 시도가 같은 헤더 집합을 쓰고 서명·타임스탬프만 달라진다")
+});
+/** 전송 기록 조회 쿼리 — `GET /webhooks/{id}/deliveries` */
+const webhookDeliveryListQuerySchema = z.object({
+	status: webhookDeliveryStatusSchema.optional().describe("전송 상태 필터. 생략하면 전체"),
+	eventType: eventTypeSchema.optional().describe("이벤트 타입 필터. 생략하면 전체"),
+	resourceId: z.string().optional().describe("대상 리소스 ID 필터(정확히 일치). 주문·클레임·상품·리뷰·문의 id를 넣으면 그 리소스의 이벤트만 남는다. 같은 id로 API 로그를 `q`로 검색하면 그 리소스를 건드린 API 요청을 볼 수 있다"),
+	limit: z.coerce.number().int().min(1).max(100).optional().describe("최대 건수 (1~100, 기본 50). 최신 적재순으로 반환하며 보관 기간은 30일이다")
+});
+/** 실패 건 일괄 재전송 응답 — `POST /webhooks/{id}/deliveries/redeliver-failed` */
+const webhookRedeliverFailedResultSchema = z.object({ queued: z.number().int().min(0).describe("재전송 대기열에 올린 건수. 최근 72시간의 `FAILED` 중 아직 재전송되지 않은 건이 대상이며 최대 500건이다") });
+const webhookTestRequestSchema = z.object({ eventType: eventTypeSchema.describe("샘플 페이로드로 보낼 이벤트 타입") });
+/** 테스트 이벤트 발송 결과 (동기 반환). 재시도·정지 판정·전송 기록이 없다 */
+const webhookTestResultSchema = z.object({
+	responseStatusCode: z.number().int().nullable().describe("수신 서버의 HTTP 응답 코드. 연결 실패·타임아웃·차단이면 null"),
+	responseTimeMs: z.number().int().nullable().describe("응답 시간(ms). 연결 실패면 null"),
+	errorCode: webhookDeliveryErrorCodeSchema.nullable().describe("실패 사유. 2xx 응답이면 null"),
+	failureReason: webhookFailureReasonSchema.nullable().describe("실패 원인 분류. 2xx 응답이면 null"),
+	responseBodyExcerpt: z.string().nullable().describe("응답 본문 앞부분(최대 4,096자). 규칙은 전송 기록의 `responseBodyExcerpt`와 같다. 응답이 없으면 null"),
+	requestHeaders: z.array(webhookRequestHeaderSchema).describe("보낸 요청 헤더. 서명 헤더는 이름만 주고 값은 null이다"),
+	payload: z.string().describe("보낸 요청 본문 그대로(JSON 문자열). 샘플 이벤트다")
+});
+const webhookRequestSchema = z.object({
+	url: z.url().startsWith("https://", "웹훅 URL은 HTTPS만 허용됩니다"),
+	eventTypes: z.array(eventTypeSchema).min(1)
+});
+const reviewSchema = z.object({
+	reviewId: z.string(),
+	productId: z.string(),
+	productName: z.string(),
+	orderItemId: z.string(),
+	optionName: z.string().nullable(),
+	rating: z.number().int().min(1).max(5),
+	content: z.string(),
+	images: z.array(z.url()),
+	writerMaskedName: z.string(),
+	blinded: z.boolean(),
+	reply: z.object({
+		content: z.string(),
+		repliedAt: z.string(),
+		updatedAt: z.string().nullable()
+	}).nullable(),
 	createdAt: z.string()
 });
-const developerAppSchema = z.object({
+const reviewSortSchema = z.enum([
+	"createdAt.desc",
+	"createdAt.asc",
+	"rating.asc",
+	"rating.desc"
+]);
+/** `GET /v1/reviews` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
+const reviewListQuerySchema = z.object({
+	productId: z.string().optional().describe("상품 id 필터"),
+	rating: z.enum([
+		"1",
+		"2",
+		"3",
+		"4",
+		"5"
+	]).optional().describe("별점 필터 (일치)"),
+	replied: z.enum(["true", "false"]).optional().describe("답글 여부 필터. `true`면 답글 단 리뷰만, `false`면 답글 없는 리뷰만"),
+	hasImage: z.enum(["true", "false"]).optional().describe("`true`면 이미지가 있는 리뷰만"),
+	from: z.string().optional().describe("작성 시각 조회 시작 (ISO 8601, 포함)"),
+	sort: reviewSortSchema.optional().describe("정렬 (기본 createdAt.desc)"),
+	...pageQueryShape()
+});
+/** `POST /v1/reviews/{reviewId}/report` 응답(202) — 신고 접수 */
+const reviewReportResultSchema = z.object({
+	reviewId: z.string(),
+	status: z.literal("PENDING_REVIEW")
+});
+//#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(),
-	orgId: z.string(),
-	handle: z.string(),
+	handle: z.string().describe("앱 handle. 앱 화면 주소의 라벨"),
 	name: z.string(),
-	description: z.string().nullable(),
 	iconUrl: z.string().nullable(),
+	description: z.string().nullable(),
+	developerName: z.string().describe("개발자 조직 이름"),
 	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()
+	status: appStatusSchema
 });
-const developerAppCreateSchema = z.object({
-	handle: appHandleSchema,
-	name: z.string().trim().min(1).max(60),
-	description: z.string().trim().max(500).optional()
+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"),
+	pendingVersion: z.object({
+		number: z.number().int(),
+		scopes: z.array(z.string()),
+		networkHosts: z.array(z.string()),
+		events: z.array(appEventTypeSchema)
+	}).nullable().optional().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()
+});
+/** 실행 기록 한 줄 — 앱에 보낸 이벤트 하나의 전송 결과. 로그 본문은 개발자만 본다(매뉴얼 「앱 설치와 관리」) */
+const appInstallationRunSchema = z.object({
+	deliveryId: z.string(),
+	eventType: z.string().describe("이벤트 이름(`ORDER.PAID`·`APP.INSTALLED` 등)"),
+	status: webhookDeliveryStatusSchema,
+	errorCode: webhookDeliveryErrorCodeSchema.nullable(),
+	attemptCount: z.number().int(),
+	createdAt: z.string(),
+	attemptedAt: z.string().nullable(),
+	nextAttemptAt: z.string().nullable()
+});
+/** `GET /v1/apps/installations/{id}/activity` — 최근 이벤트 전송 결과(50건)와 최근 7일 관리 API 호출 수 */
+const appInstallationActivitySchema = z.object({
+	runs: z.array(appInstallationRunSchema),
+	apiCalls7d: z.number().int().describe("최근 7일 이 설치가 부른 관리 API 수")
+});
+/**
+* `POST /v1/apps/installations`(상점 플랫폼 전용) — 둘 중 하나다.
+* - `{ result }`: accounts 설치 동의 결과(1회용 JWT). 개발자 포털 [내 상점에 설치]가 이 길로 온다
+* - `{ appId, settings }`: 상점 플랫폼 앱 목록 › 설치 화면에서 동의하고 설정까지 채워 바로 설치한다
+*/
+const appInstallRequestSchema = z.union([z.object({ result: z.string().min(1).describe("accounts가 발급한 설치 결과 JWT(`typ: sayren-install+jwt`)") }), z.object({
+	appId: z.string().min(1),
+	settings: z.record(z.string(), settingsValueSchema).default({}).describe("설치와 함께 저장할 설정. 비밀 필드도 여기서 넣는다")
+})]);
+/** 앱 목록 정보 — 현재 버전이 올린 아이콘·README(없으면 매니페스트 `iconUrl`) */
+const appListingSchema = z.object({
+	description: z.string().nullable(),
+	iconUrl: z.string().nullable().describe("아이콘 주소. 앱 폴더에서 올린 아이콘은 data URI, 매니페스트 `iconUrl`은 https 주소"),
+	readme: z.string().nullable().describe("README 마크다운 원문")
+});
+/** `GET /v1/apps/catalog` — 이 상점에 설치할 수 있는 앱(A1: 내가 속한 개발자 조직의 앱) */
+const storeAppSchema = z.object({
+	appId: z.string(),
+	handle: z.string(),
+	name: z.string(),
+	description: z.string().nullable(),
+	iconUrl: z.string().nullable(),
+	developerName: z.string(),
+	versionNumber: z.number().int().describe("현재 버전"),
+	installationId: z.string().nullable().describe("이 상점에 설치돼 있으면 설치 id")
+});
+/** `GET /v1/apps/catalog/{appId}` — 앱 상세·설치 화면 */
+const storeAppDetailSchema = storeAppSchema.extend({
+	readme: z.string().nullable(),
+	supportEmail: z.string().nullable(),
+	scopes: z.array(z.string()).describe("설치 때 동의하는 스코프(Scope)"),
+	events: z.array(appEventTypeSchema).describe("받는 이벤트(Hook)"),
+	networkHosts: z.array(z.string()).describe("앱이 데이터를 보내는 외부 호스트"),
+	settings: z.record(z.string(), appSettingFieldSchema).describe("설치 때 채우는 설정 필드"),
+	updatedAt: z.string().nullable().describe("현재 버전을 release한 시각")
+});
+/** `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(),
+	listing: appListingSchema.nullable().optional().default(null).describe("이 버전이 올린 아이콘·설명·README"),
+	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({
@@ -4734,612 +5057,311 @@ const couponSchema = z.object({
 	perMemberIssueLimit: z.number().int().nullable(),
 	perMemberUseLimit: z.number().int().nullable(),
 	issuedCount: z.number().int().describe("발급 수 — 회수한 발급도 센다. 총 발급 한도(`totalIssueLimit`)가 이 값과 비교된다"),
-	reservedCount: z.number().int().describe("결제 중인 예약 수 — 결제가 끝나거나 만료되면 풀린다"),
-	usedCount: z.number().int().describe("사용 수 — 전량 취소로 복원되면 줄어든다"),
-	status: couponStatusSchema,
-	locked: z.boolean().describe("발급·사용이 시작돼 혜택·조건·대상·사용 시작일을 바꿀 수 없는가"),
-	lockedAt: z.string().nullable(),
-	createdAt: z.string(),
-	updatedAt: z.string()
-});
-/** `GET /v1/coupons` 쿼리 */
-const couponListQuerySchema = z.object({
-	status: couponStatusSchema.optional(),
-	kind: couponKindSchema.optional(),
-	issueMethod: couponIssueMethodSchema.optional(),
-	q: z.string().optional().describe("이름·코드 검색(포함)"),
-	...pageQueryShape()
-});
-/** 발급 쿠폰 상태 — 만료는 저장 상태가 아니라 조회 시각으로 판정한 값이다 */
-const couponIssueStatusSchema = z.string().describe("발급 쿠폰 상태. 현재 값은 `AVAILABLE`(사용 가능)·`RESERVED`(결제 중)·`USED`(사용함)·`REVOKED`(회수)·`EXPIRED`(유효 기간 지남)이고 값이 추가될 수 있어 문자열로 받는다");
-const couponIssueSchema = z.object({
-	issueId: z.string(),
-	couponId: z.string(),
-	customerId: z.string(),
-	customerName: z.string().nullable().describe("구매자 이름. 탈퇴한 구매자는 null"),
-	source: z.string().optional().describe("발급 경로(이슈 #110). 현재 값은 `MANUAL`(셀러 지급)·`DOWNLOAD`(구매자가 받음)·`SIGNUP`(회원가입 자동 지급)이고 값이 추가될 수 있다. 서버는 항상 싣는다"),
-	status: couponIssueStatusSchema,
-	validFrom: z.string(),
-	validUntil: z.string().nullable(),
-	usedOrderId: z.string().nullable(),
-	issuedAt: z.string(),
-	revokedAt: z.string().nullable()
-});
-const couponIssueListQuerySchema = z.object({
-	status: z.enum([
-		"AVAILABLE",
-		"RESERVED",
-		"USED",
-		"REVOKED"
-	]).optional(),
-	...pageQueryShape()
-});
-/** `POST /v1/coupons/{couponId}/issues` — 셀러 지급. 한 번에 1,000명까지 */
-const issueCouponRequestSchema = z.strictObject({ customerIds: z.array(z.string().min(1)).min(1).max(1e3).refine((ids) => new Set(ids).size === ids.length, "같은 구매자를 두 번 넣었습니다").describe("지급할 구매자 id(1~1,000명, 중복 불가)") });
-const issueCouponResultSchema = z.object({
-	issued: z.array(z.object({
-		customerId: z.string(),
-		issueId: z.string()
-	})),
-	failed: z.array(z.object({
-		customerId: z.string(),
-		code: z.string().describe("실패 사유. `CUSTOMER_NOT_FOUND`(이 상점 구매자가 아님)·`COUPON_LIMIT_REACHED`(1인 발급 한도)·`COUPON_EXHAUSTED`(총 발급 한도)"),
-		message: z.string()
-	}))
-});
-const couponRedemptionSchema = z.object({
-	redemptionId: z.string(),
-	couponId: z.string(),
-	issueId: z.string().nullable(),
-	customerId: z.string().nullable().describe("구매자 id. 비회원 주문은 null"),
-	orderId: z.string().nullable().describe("주문 id. 결제가 끝나기 전의 예약·해제는 null"),
-	status: z.string().describe("사용 기록 상태. 현재 값은 `RESERVED`(결제 중)·`USED`(사용함)·`RELEASED`(결제 실패·만료로 해제)·`RESTORED`(전량 취소로 복원)이고 값이 추가될 수 있어 문자열로 받는다"),
-	discountAmount: z.number().int(),
-	reservedAt: z.string(),
-	usedAt: z.string().nullable(),
-	releasedAt: z.string().nullable(),
-	restoredAt: z.string().nullable(),
-	restoreSkippedReason: z.string().nullable().describe("전량 취소에도 복원하지 않은 사유 — `EXPIRED`(유효 기간 지남)·`ENDED`(종료된 쿠폰)")
-});
-const couponRedemptionListQuerySchema = z.object({
-	status: z.enum([
-		"RESERVED",
-		"USED",
-		"RELEASED",
-		"RESTORED"
-	]).optional(),
-	...pageQueryShape()
-});
-const couponStatsSchema = z.object({
-	couponId: z.string(),
-	issuedCount: z.number().int(),
-	revokedCount: z.number().int(),
-	reservedCount: z.number().int(),
-	usedCount: z.number().int(),
-	restoredCount: z.number().int(),
-	releasedCount: z.number().int(),
-	discountTotal: z.number().int().describe("사용 중(`USED`)인 기록의 할인 합계 (원)"),
-	orderPaymentTotal: z.number().int().describe("이 쿠폰을 쓴(`USED`) 주문의 결제 금액 합계 (원). 부분 취소·반품 환불은 빼지 않은 결제 시점 금액이다")
-});
-/** `GET /v1/customers/{customerId}/coupons` 항목 — 발급 쿠폰 + 쿠폰 이름·혜택 */
-const customerCouponSchema = couponIssueSchema.extend({
-	couponName: z.string(),
-	kind: couponKindSchema,
-	benefit: couponBenefitSchema
-});
-//#endregion
-//#region src/schemas/customer.ts
-/** 구매자 목록 정렬 */
-const customerSortSchema = z.enum([
-	"joined_desc",
-	"joined_asc",
-	"total_paid_desc",
-	"order_count_desc",
-	"last_ordered_desc"
-]).describe("정렬. `joined_desc`(기본, 최근 가입순)·`joined_asc`·`total_paid_desc`(구매 금액순)·`order_count_desc`(주문 수순)·`last_ordered_desc`(최근 주문순)");
-/** `GET /v1/customers` 쿼리 */
-const customerListQuerySchema = z.object({
-	q: z.string().optional().describe("검색어 — 이름·이메일(포함). 숫자 4자리면 휴대폰 뒤 4자리로도 찾는다"),
-	joinedFrom: z.string().optional().describe("가입일 시작(YYYY-MM-DD, KST, 포함)"),
-	joinedTo: z.string().optional().describe("가입일 끝(YYYY-MM-DD, KST, 포함)"),
-	marketing: z.enum(["agreed", "declined"]).optional().describe("마케팅 수신 동의 필터. 생략하면 전체"),
-	sort: customerSortSchema.optional(),
-	...pageQueryShape()
-});
-/** 구매 통계 — 구매 금액은 취소된 주문 상품을 빼고, 완료된 반품은 수량 비율로 뺀 금액이다 */
-const customerStatsSchema = z.object({
-	orderCount: z.number().int().describe("주문 수(취소 포함)"),
-	totalPaid: z.number().int().describe("구매 금액(원) — 취소·완료된 반품 제외"),
-	lastOrderedAt: z.string().nullable().describe("최근 주문 시각")
-});
-/** 목록 행 — 휴대폰은 가운데를 가린다(`010-****-1234`) */
-const customerSummarySchema = z.object({
-	customerId: z.string(),
-	name: z.string(),
-	/** 소셜 가입에서 이메일을 받지 못했으면 null */
-	email: z.string().nullable(),
-	maskedPhone: z.string().nullable(),
-	joinedAt: z.string(),
-	point: z.number().int(),
-	marketingAgreed: z.boolean()
-}).extend(customerStatsSchema.shape);
-const customerAddressSchema = z.object({
-	addressId: z.string(),
-	alias: z.string(),
-	isDefault: z.boolean(),
-	receiverName: z.string(),
-	phone: z.string(),
-	zipCode: z.string(),
-	address1: z.string(),
-	address2: z.string().nullable()
-});
-/** 동의 종류 — 이용약관·개인정보 수집이용은 가입 필수, 마케팅 수신은 선택 */
-const consentKindSchema = z.enum([
-	"TERMS",
-	"PRIVACY",
-	"MARKETING"
-]);
-const consentActionSchema = z.enum(["AGREED", "WITHDRAWN"]);
-/**
-* 동의가 일어난 경로. 값이 추가될 수 있어 모르는 값은 그대로 보여 준다.
-* `SIGNUP` 비밀번호 가입 · `SOCIAL_SIGNUP` 소셜 가입 · `DELEGATED` 셀러 자체 회원 연동 ·
-* `RECONSENT` 약관 개정 재동의 · `MEMBER_UPDATE` 구매자가 직접 변경 · `SELLER` 셀러가 처리
-*/
-const consentSourceSchema = z.enum([
-	"SIGNUP",
-	"SOCIAL_SIGNUP",
-	"DELEGATED",
-	"RECONSENT",
-	"MEMBER_UPDATE",
-	"SELLER"
-]);
-/** 동의 이력 한 줄 — 추가만 되고 지워지지 않는다(구매자 탈퇴 시에만 함께 지워진다) */
-const customerConsentSchema = z.object({
-	consentId: z.string(),
-	kind: consentKindSchema,
-	/** 동의한 약관 버전. 마케팅은 버전이 없어 null */
-	version: z.string().nullable(),
-	/** 동의 시점의 약관 문서 주소. 상점이 주소를 정하지 않았거나 마케팅이면 null */
-	documentUrl: z.string().nullable(),
-	action: consentActionSchema,
-	source: consentSourceSchema,
-	occurredAt: z.string()
-});
-/** 종류별 현재 동의 상태 */
-const customerConsentStateSchema = z.object({
-	kind: consentKindSchema,
-	agreed: z.boolean(),
-	/** 동의한 약관 버전. 마케팅이거나 이력이 없으면 null */
-	agreedVersion: z.string().nullable(),
-	/** 상점의 현재 약관 버전. 마케팅은 null */
-	currentVersion: z.string().nullable(),
-	/** 상점이 정한 현재 약관 문서 주소. 정하지 않았거나 마케팅이면 null */
-	currentDocumentUrl: z.string().nullable(),
-	updatedAt: z.string().nullable(),
-	/** 약관이 개정돼 다시 받아야 하는가. 마케팅은 항상 false */
-	reconsentRequired: z.boolean()
-});
-const customerConsentsSchema = z.object({
-	terms: customerConsentStateSchema,
-	privacy: customerConsentStateSchema,
-	marketing: customerConsentStateSchema,
-	/** 필수 동의 중 하나라도 현재 버전이 아니면 true */
-	reconsentRequired: z.boolean()
-});
-/** `GET /v1/customers/{id}/consents` 쿼리 — 최근 순이다 */
-const customerConsentListQuerySchema = z.object({
-	kind: consentKindSchema.optional().describe("동의 종류 필터. 생략하면 전체"),
-	...pageQueryShape()
-});
-/** 구매자 상세 — 휴대폰 전체를 보여 준다 */
-const customerDetailSchema = z.object({
-	customerId: z.string(),
-	name: z.string(),
-	email: z.string().nullable(),
-	phone: z.string().nullable(),
-	joinedAt: z.string(),
-	point: z.number().int(),
-	marketingAgreed: z.boolean(),
-	loginMethods: z.array(z.object({
-		method: z.enum([
-			"password",
-			"kakao",
-			"naver",
-			"google"
-		]),
-		/** 소셜 연결 시각. 비밀번호는 가입 시각 */
-		linkedAt: z.string()
-	})).describe("로그인 방법 — 이메일·비밀번호(`password`)와 연결된 소셜 계정"),
-	consents: customerConsentsSchema.describe("약관·개인정보·마케팅 동의의 현재 상태. 이력은 `GET /v1/customers/{customerId}/consents`"),
-	addresses: z.array(customerAddressSchema),
-	stats: customerStatsSchema.extend({
-		canceledOrReturnedCount: z.number().int().describe("취소된 주문 상품 + 완료된 반품 수"),
-		reviewCount: z.number().int(),
-		inquiryCount: z.number().int().describe("상품 문의 + 1:1 문의")
-	})
-});
-/** 구매자의 주문 — 전체 기간 */
-const customerOrderSchema = z.object({
-	orderId: z.string(),
-	orderedAt: z.string(),
-	totalAmount: z.number().int().describe("결제 금액"),
-	testPayment: z.boolean(),
-	items: z.array(z.object({
-		orderItemId: z.string(),
-		productName: z.string(),
-		optionName: z.string().nullable(),
-		quantity: z.number().int(),
-		status: orderItemStatusSchema,
-		claimStatus: z.enum([
-			"CANCEL_REQUESTED",
-			"RETURN_REQUESTED",
-			"EXCHANGE_REQUESTED"
-		]).nullable()
-	}))
-});
-/** `POST /v1/customers/{id}/withdraw` 본문 */
-const withdrawCustomerRequestSchema = z.object({
-	reason: z.enum([
-		"BUYER_REQUEST",
-		"DORMANT",
-		"ABUSE",
-		"OTHER"
-	]).describe("처리 사유 — 구매자 요청·장기 미이용·부정 이용·기타. 감사 로그에 남는다"),
-	memo: z.string().max(200).optional().describe("사유 보충(선택)")
-});
-/** `WITHDRAWAL_BLOCKED`의 `error.details` — 탈퇴를 막는 항목 수(스토어프론트 탈퇴와 같다) */
-const customerWithdrawalBlockedDetailsSchema = z.object({
-	inProgressOrderItems: z.number().int(),
-	openClaims: z.number().int(),
-	pendingPayments: z.number().int()
-});
-//#endregion
-//#region src/schemas/login.ts
-/** 소셜 로그인 공급자 */
-const loginProviderSchema = z.enum([
-	"kakao",
-	"naver",
-	"google"
-]);
-/** 공급자 연결 상태 — 비밀 값은 앞 4자리만 */
-const loginProviderStatusSchema = z.object({
-	provider: loginProviderSchema,
-	connected: z.boolean(),
-	/** 스토어프론트에서 사용 중인지. 연결 안 됐으면 false */
-	enabled: z.boolean(),
-	clientIdPrefix: z.string().nullable().describe("클라이언트 ID(카카오 REST API 키) 앞 4자리"),
-	secretPrefix: z.string().nullable(),
-	lastTestedAt: z.string().nullable(),
-	lastTestOk: z.boolean().nullable(),
-	linkedMemberCount: z.number().int().describe("이 공급자로 연결된 구매자 수"),
-	/** 이 공급자로만 로그인하는 구매자 수 — 연결을 해제하면 로그인할 방법이 없어진다 */
-	onlyMethodMemberCount: z.number().int(),
-	callbackUrl: z.url().describe("공급자 개발자 콘솔에 등록할 리디렉트 URI")
-});
-/** `GET /v1/store/login-settings` */
-const loginSettingsSchema = z.object({
-	passwordLoginEnabled: z.boolean(),
-	/** 비밀번호로만 로그인하는 구매자 수 — 이메일·비밀번호를 끄면 이들은 로그인할 수 없다 */
-	passwordOnlyMemberCount: z.number().int(),
-	storefrontOrigins: z.array(z.string()),
-	providers: z.array(loginProviderStatusSchema)
-});
-/** `PATCH /v1/store/login-settings` */
-const updateLoginSettingsRequestSchema = z.object({ passwordLoginEnabled: z.boolean() });
-/** `PUT /v1/store/auth-providers/{provider}` — 저장 전에 연결 테스트를 한다 */
-const saveLoginProviderRequestSchema = z.object({
-	clientId: z.string().trim().min(1).max(200),
-	clientSecret: z.string().trim().min(1).max(500)
-});
-/** `PATCH /v1/store/auth-providers/{provider}` */
-const updateLoginProviderRequestSchema = z.object({ enabled: z.boolean() });
-/** 연결 테스트 결과 */
-const loginProviderTestSchema = z.object({
-	ok: z.boolean(),
-	/** 실패 이유 — `INVALID_CLIENT`(키가 틀림)·`PROVIDER_UNAVAILABLE`(공급자 응답 없음) */
-	code: z.enum(["INVALID_CLIENT", "PROVIDER_UNAVAILABLE"]).nullable(),
-	testedAt: z.string()
-});
-//#endregion
-//#region src/schemas/misc.ts
-const inquirySchema = z.object({
-	inquiryId: z.string(),
-	productId: z.string(),
-	productName: z.string(),
-	orderItemId: z.string().nullable(),
-	category: z.enum([
-		"PRODUCT",
-		"DELIVERY",
-		"RETURN",
-		"EXCHANGE",
-		"ETC"
-	]),
-	content: z.string(),
-	secret: z.boolean(),
-	writerMaskedName: z.string(),
-	answered: z.boolean(),
-	answer: z.object({
-		content: z.string(),
-		answeredAt: z.string(),
-		modifiedCount: z.number().int().max(1)
-	}).nullable(),
-	createdAt: z.string()
-});
-const customerInquiryCategorySchema = z.enum([
-	"DELIVERY",
-	"RETURN",
-	"EXCHANGE",
-	"PAYMENT",
-	"ETC"
-]);
-/** 셀러 뷰 1:1 문의 — 작성자 마스킹명 + 답변 수정횟수 포함 */
-const sellerCustomerInquirySchema = z.object({
-	inquiryId: z.string(),
-	memberMaskedName: z.string(),
-	category: customerInquiryCategorySchema,
-	title: z.string(),
-	content: z.string(),
-	orderItemId: z.string().nullable(),
-	answered: z.boolean(),
-	answer: z.object({
-		content: z.string(),
-		answeredAt: z.string(),
-		modifiedCount: z.number().int().max(1)
-	}).nullable(),
-	createdAt: z.string()
+	reservedCount: z.number().int().describe("결제 중인 예약 수 — 결제가 끝나거나 만료되면 풀린다"),
+	usedCount: z.number().int().describe("사용 수 — 전량 취소로 복원되면 줄어든다"),
+	status: couponStatusSchema,
+	locked: z.boolean().describe("발급·사용이 시작돼 혜택·조건·대상·사용 시작일을 바꿀 수 없는가"),
+	lockedAt: z.string().nullable(),
+	createdAt: z.string(),
+	updatedAt: z.string()
 });
-const answeredQuery = z.enum(["true", "false"]).optional().describe("답변 여부 필터. `true`면 답변된 문의만, `false`면 미답변만, 생략하면 전부");
-/** `GET /v1/inquiries` 쿼리(상품 문의) — OpenAPI 문서용 형태(값은 쿼리 문자열). 최신순이다 */
-const inquiryListQuerySchema = z.object({
-	answered: answeredQuery,
-	productId: z.string().optional().describe("상품 id 필터"),
-	from: z.string().optional().describe("작성 시각 조회 시작 (ISO 8601, 포함)"),
+/** `GET /v1/coupons` 쿼리 */
+const couponListQuerySchema = z.object({
+	status: couponStatusSchema.optional(),
+	kind: couponKindSchema.optional(),
+	issueMethod: couponIssueMethodSchema.optional(),
+	q: z.string().optional().describe("이름·코드 검색(포함)"),
 	...pageQueryShape()
 });
-/** `GET /v1/customer-inquiries` 쿼리(1:1 문의) — OpenAPI 문서용 형태(값은 쿼리 문자열). 최신순이다 */
-const customerInquiryListQuerySchema = z.object({
-	answered: answeredQuery,
-	category: customerInquiryCategorySchema.optional().describe("문의 유형 필터"),
-	from: z.string().optional().describe("작성 시각 조회 시작 (ISO 8601, 포함)"),
+/** 발급 쿠폰 상태 — 만료는 저장 상태가 아니라 조회 시각으로 판정한 값이다 */
+const couponIssueStatusSchema = z.string().describe("발급 쿠폰 상태. 현재 값은 `AVAILABLE`(사용 가능)·`RESERVED`(결제 중)·`USED`(사용함)·`REVOKED`(회수)·`EXPIRED`(유효 기간 지남)이고 값이 추가될 수 있어 문자열로 받는다");
+const couponIssueSchema = z.object({
+	issueId: z.string(),
+	couponId: z.string(),
+	customerId: z.string(),
+	customerName: z.string().nullable().describe("구매자 이름. 탈퇴한 구매자는 null"),
+	source: z.string().optional().describe("발급 경로(이슈 #110). 현재 값은 `MANUAL`(셀러 지급)·`DOWNLOAD`(구매자가 받음)·`SIGNUP`(회원가입 자동 지급)이고 값이 추가될 수 있다. 서버는 항상 싣는다"),
+	status: couponIssueStatusSchema,
+	validFrom: z.string(),
+	validUntil: z.string().nullable(),
+	usedOrderId: z.string().nullable(),
+	issuedAt: z.string(),
+	revokedAt: z.string().nullable()
+});
+const couponIssueListQuerySchema = z.object({
+	status: z.enum([
+		"AVAILABLE",
+		"RESERVED",
+		"USED",
+		"REVOKED"
+	]).optional(),
 	...pageQueryShape()
 });
-const settlementStatusSchema = z.enum([
-	"SCHEDULED",
-	"PAID",
-	"HELD"
-]);
-const settlementSummarySchema = z.object({
-	settlementId: z.string(),
-	settlementDate: z.string(),
-	payoutDate: z.string().nullable(),
-	status: settlementStatusSchema,
-	totalPaymentAmount: z.number().int(),
-	totalCommission: z.number().int(),
-	totalDeliveryFee: z.number().int(),
-	adjustmentAmount: z.number().int(),
-	settlementAmount: z.number().int(),
-	itemCount: z.number().int()
+/** `POST /v1/coupons/{couponId}/issues` — 셀러 지급. 한 번에 1,000명까지 */
+const issueCouponRequestSchema = z.strictObject({ customerIds: z.array(z.string().min(1)).min(1).max(1e3).refine((ids) => new Set(ids).size === ids.length, "같은 구매자를 두 번 넣었습니다").describe("지급할 구매자 id(1~1,000명, 중복 불가)") });
+const issueCouponResultSchema = z.object({
+	issued: z.array(z.object({
+		customerId: z.string(),
+		issueId: z.string()
+	})),
+	failed: z.array(z.object({
+		customerId: z.string(),
+		code: z.string().describe("실패 사유. `CUSTOMER_NOT_FOUND`(이 상점 구매자가 아님)·`COUPON_LIMIT_REACHED`(1인 발급 한도)·`COUPON_EXHAUSTED`(총 발급 한도)"),
+		message: z.string()
+	}))
 });
-const settlementDetailSchema = z.object({
-	orderItemId: z.string(),
-	productName: z.string(),
-	settlementType: z.enum([
-		"SALE",
-		"REFUND_DEDUCTION",
-		"ADJUSTMENT"
-	]),
-	paymentAmount: z.number().int(),
-	salesCommission: z.number().int(),
-	paymentCommission: z.number().int(),
-	commissionRate: z.number(),
-	deliveryFee: z.number().int(),
-	settlementAmount: z.number().int(),
-	purchaseDecidedAt: z.string().nullable()
+const couponRedemptionSchema = z.object({
+	redemptionId: z.string(),
+	couponId: z.string(),
+	issueId: z.string().nullable(),
+	customerId: z.string().nullable().describe("구매자 id. 비회원 주문은 null"),
+	orderId: z.string().nullable().describe("주문 id. 결제가 끝나기 전의 예약·해제는 null"),
+	status: z.string().describe("사용 기록 상태. 현재 값은 `RESERVED`(결제 중)·`USED`(사용함)·`RELEASED`(결제 실패·만료로 해제)·`RESTORED`(전량 취소로 복원)이고 값이 추가될 수 있어 문자열로 받는다"),
+	discountAmount: z.number().int(),
+	reservedAt: z.string(),
+	usedAt: z.string().nullable(),
+	releasedAt: z.string().nullable(),
+	restoredAt: z.string().nullable(),
+	restoreSkippedReason: z.string().nullable().describe("전량 취소에도 복원하지 않은 사유 — `EXPIRED`(유효 기간 지남)·`ENDED`(종료된 쿠폰)")
 });
-/** `GET /v1/settlements/{settlementId}` 응답 — 정산 요약 + 상세 내역(`size`건까지) */
-const settlementWithDetailsSchema = settlementSummarySchema.extend({ details: z.array(settlementDetailSchema).optional() });
-/** `GET /v1/settlements` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열). 정산일 최신순이다 */
-const settlementListQuerySchema = z.object({
-	from: z.string().describe("정산일 조회 시작 (ISO 8601, 포함). 필수"),
-	to: z.string().optional().describe("정산일 조회 끝 (ISO 8601, 포함). 생략하면 from부터 31일. 기간은 최대 31일"),
-	status: settlementStatusSchema.optional().describe("정산 상태 필터"),
+const couponRedemptionListQuerySchema = z.object({
+	status: z.enum([
+		"RESERVED",
+		"USED",
+		"RELEASED",
+		"RESTORED"
+	]).optional(),
 	...pageQueryShape()
 });
-/** `GET /v1/settlements/{settlementId}` 쿼리 — `size`는 돌려줄 상세 내역 건수다(`page`는 무시) */
-const settlementDetailQuerySchema = z.object(pageQueryShape({
-	defaultSize: 100,
-	maxSize: 300
-}));
-const eventTypeSchema = z.enum([
-	"ORDER.PAID",
-	"ORDER.CONFIRMED",
-	"ORDER.DISPATCHED",
-	"ORDER.DELIVERED",
-	"ORDER.PURCHASE_DECIDED",
-	"ORDER.ADDRESS_CHANGE_REQUESTED",
-	"ORDER.CANCELED",
-	"ORDER.FULFILLED",
-	"CLAIM.CANCEL_REQUESTED",
-	"CLAIM.RETURN_REQUESTED",
-	"CLAIM.EXCHANGE_REQUESTED",
-	"CLAIM.COMPLETED",
-	"INQUIRY.CREATED",
-	"REVIEW.CREATED",
-	"PRODUCT.OUT_OF_STOCK",
-	"ORDER.FLOW_NOTIFICATION",
-	"ORDER.FLOW_STATE_CHANGED"
-]).describe("웹훅 이벤트 타입. `ORDER.ADDRESS_CHANGE_REQUESTED`는 현재 발송하지 않음(호환을 위해 값만 남았고, 구독해도 이벤트가 오지 않는다)");
-const webhookStatusSchema = z.enum(["ACTIVE", "SUSPENDED"]).describe("구독 상태. `ACTIVE`=발송 대상, `SUSPENDED`=24시간 이상 연속 전송 실패로 발송이 정지된 상태. 정지 중 발생한 이벤트는 적재하지 않는다. 재개(`POST /webhooks/{id}/resume`)하거나 구독을 수정하면 ACTIVE로 돌아간다");
-const webhookSchema = z.object({
-	webhookId: z.string(),
-	url: z.url(),
-	eventTypes: z.array(eventTypeSchema),
-	status: webhookStatusSchema,
-	secretPrefix: z.string().describe("서명 시크릿 앞부분(식별용, 서명 검증에 사용할 수 없음). 예: `whsec_1a2b`"),
-	suspendedAt: z.string().nullable().describe("발송이 정지된 일시 (ISO 8601). `ACTIVE`면 null"),
-	createdAt: z.string()
+const couponStatsSchema = z.object({
+	couponId: z.string(),
+	issuedCount: z.number().int(),
+	revokedCount: z.number().int(),
+	reservedCount: z.number().int(),
+	usedCount: z.number().int(),
+	restoredCount: z.number().int(),
+	releasedCount: z.number().int(),
+	discountTotal: z.number().int().describe("사용 중(`USED`)인 기록의 할인 합계 (원)"),
+	orderPaymentTotal: z.number().int().describe("이 쿠폰을 쓴(`USED`) 주문의 결제 금액 합계 (원). 부분 취소·반품 환불은 빼지 않은 결제 시점 금액이다")
 });
-/** 등록 응답 — 서명 시크릿 평문은 이 응답에서만 노출된다 */
-const webhookCreatedSchema = webhookSchema.extend({ secret: z.string().describe("서명 시크릿 평문. 등록 응답에서만 노출되며 다시 조회할 수 없다") });
-/** 시크릿 교체 응답 */
-const webhookSecretRotatedSchema = z.object({
-	secret: z.string().describe("새 서명 시크릿 평문. 이 응답에서만 노출된다"),
-	oldSecretExpiresAt: z.string().describe("기존 시크릿의 병행 유효 종료 일시 (ISO 8601). 이때까지는 기존 시크릿 서명도 함께 붙는다")
+/** `GET /v1/customers/{customerId}/coupons` 항목 — 발급 쿠폰 + 쿠폰 이름·혜택 */
+const customerCouponSchema = couponIssueSchema.extend({
+	couponName: z.string(),
+	kind: couponKindSchema,
+	benefit: couponBenefitSchema
 });
-const webhookDeliveryStatusSchema = z.enum([
-	"PENDING",
-	"PENDING_RETRY",
-	"SUCCESS",
-	"FAILED"
-]).describe("전송 상태. `PENDING`=첫 시도 전, `PENDING_RETRY`=실패 후 재시도 대기, `SUCCESS`=2xx 응답 수신, `FAILED`=재시도를 모두 소진했거나 구독 정지로 종료");
-const webhookDeliveryErrorCodeSchema = z.enum([
-	"TIMEOUT",
-	"CONNECTION_FAILED",
-	"BLOCKED_ADDRESS",
-	"NON_2XX",
-	"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`와 같은 이유).
-* 모르는 값은 `errorCode`로 판단한다.
-*/
-const WEBHOOK_FAILURE_REASONS = [
-	"DNS",
-	"TLS",
-	"TIMEOUT",
-	"CONNECTION",
-	"HTTP_4XX",
-	"HTTP_5XX",
-	"HTTP_OTHER",
-	"SSRF_BLOCKED",
-	"SUSPENDED"
-];
-const webhookFailureReasonSchema = z.string().describe("실패 원인 분류(진단용). 현재 값은 `DNS`=호스트 이름을 주소로 바꾸지 못함, `TLS`=인증서·핸드셰이크 실패, `TIMEOUT`=10초 안에 응답 없음, `CONNECTION`=연결 거부·끊김, `HTTP_4XX`·`HTTP_5XX`=그 대역의 응답, `HTTP_OTHER`=2xx·4xx·5xx가 아닌 응답(리다이렉트 등), `SSRF_BLOCKED`=사설·루프백 등 전송이 허용되지 않는 주소, `SUSPENDED`=구독 정지로 대기 중인 전송이 종료됨. `errorCode`보다 잘게 나눈 값이며 둘은 함께 쓸 수 있다. 값이 추가될 수 있으므로 모르는 값은 `errorCode`로 판단한다");
+//#endregion
+//#region src/schemas/customer.ts
+/** 구매자 목록 정렬 */
+const customerSortSchema = z.enum([
+	"joined_desc",
+	"joined_asc",
+	"total_paid_desc",
+	"order_count_desc",
+	"last_ordered_desc"
+]).describe("정렬. `joined_desc`(기본, 최근 가입순)·`joined_asc`·`total_paid_desc`(구매 금액순)·`order_count_desc`(주문 수순)·`last_ordered_desc`(최근 주문순)");
+/** `GET /v1/customers` 쿼리 */
+const customerListQuerySchema = z.object({
+	q: z.string().optional().describe("검색어 — 이름·이메일(포함). 숫자 4자리면 휴대폰 뒤 4자리로도 찾는다"),
+	joinedFrom: z.string().optional().describe("가입일 시작(YYYY-MM-DD, KST, 포함)"),
+	joinedTo: z.string().optional().describe("가입일 끝(YYYY-MM-DD, KST, 포함)"),
+	marketing: z.enum(["agreed", "declined"]).optional().describe("마케팅 수신 동의 필터. 생략하면 전체"),
+	sort: customerSortSchema.optional(),
+	...pageQueryShape()
+});
+/** 구매 통계 — 구매 금액은 취소된 주문 상품을 빼고, 완료된 반품은 수량 비율로 뺀 금액이다 */
+const customerStatsSchema = z.object({
+	orderCount: z.number().int().describe("주문 수(취소 포함)"),
+	totalPaid: z.number().int().describe("구매 금액(원) — 취소·완료된 반품 제외"),
+	lastOrderedAt: z.string().nullable().describe("최근 주문 시각")
+});
+/** 목록 행 — 휴대폰은 가운데를 가린다(`010-****-1234`) */
+const customerSummarySchema = z.object({
+	customerId: z.string(),
+	name: z.string(),
+	/** 소셜 가입에서 이메일을 받지 못했으면 null */
+	email: z.string().nullable(),
+	maskedPhone: z.string().nullable(),
+	joinedAt: z.string(),
+	point: z.number().int(),
+	marketingAgreed: z.boolean()
+}).extend(customerStatsSchema.shape);
+const customerAddressSchema = z.object({
+	addressId: z.string(),
+	alias: z.string(),
+	isDefault: z.boolean(),
+	receiverName: z.string(),
+	phone: z.string(),
+	zipCode: z.string(),
+	address1: z.string(),
+	address2: z.string().nullable()
+});
+/** 동의 종류 — 이용약관·개인정보 수집이용은 가입 필수, 마케팅 수신은 선택 */
+const consentKindSchema = z.enum([
+	"TERMS",
+	"PRIVACY",
+	"MARKETING"
+]);
+const consentActionSchema = z.enum(["AGREED", "WITHDRAWN"]);
 /**
-* 대상 리소스 종류의 **현재** 값. 응답 스키마는 문자열로 열려 있다(새 이벤트가 새 리소스를 가리킬 수 있다).
+* 동의가 일어난 경로. 값이 추가될 수 있어 모르는 값은 그대로 보여 준다.
+* `SIGNUP` 비밀번호 가입 · `SOCIAL_SIGNUP` 소셜 가입 · `DELEGATED` 셀러 자체 회원 연동 ·
+* `RECONSENT` 약관 개정 재동의 · `MEMBER_UPDATE` 구매자가 직접 변경 · `SELLER` 셀러가 처리
 */
-const WEBHOOK_RESOURCE_TYPES = [
-	"ORDER",
-	"CLAIM",
-	"PRODUCT",
-	"REVIEW",
-	"INQUIRY"
-];
-const webhookResourceTypeSchema = z.string().describe("이벤트가 가리키는 리소스 종류. 현재 값은 `ORDER`·`CLAIM`·`PRODUCT`·`REVIEW`·`INQUIRY`이고 값이 추가될 수 있다");
-/** 이벤트가 가리키는 대상 리소스 — 전송 기록을 주문·상품과 잇는 키 */
-const webhookDeliveryResourceSchema = z.object({
-	type: webhookResourceTypeSchema,
-	id: z.string().describe("리소스 ID. 전송 기록 조회의 `resourceId`, API 로그 조회의 `q`로 그대로 넣을 수 있다")
+const consentSourceSchema = z.enum([
+	"SIGNUP",
+	"SOCIAL_SIGNUP",
+	"DELEGATED",
+	"RECONSENT",
+	"MEMBER_UPDATE",
+	"SELLER"
+]);
+/** 동의 이력 한 줄 — 추가만 되고 지워지지 않는다(구매자 탈퇴 시에만 함께 지워진다) */
+const customerConsentSchema = z.object({
+	consentId: z.string(),
+	kind: consentKindSchema,
+	/** 동의한 약관 버전. 마케팅은 버전이 없어 null */
+	version: z.string().nullable(),
+	/** 동의 시점의 약관 문서 주소. 상점이 주소를 정하지 않았거나 마케팅이면 null */
+	documentUrl: z.string().nullable(),
+	action: consentActionSchema,
+	source: consentSourceSchema,
+	occurredAt: z.string()
 });
-/** 발송 요청 헤더 한 줄 (값 마스킹) */
-const webhookRequestHeaderSchema = z.object({
-	name: z.string().describe("헤더 이름"),
-	value: z.string().nullable().describe("헤더 값. 서명(`Sayren-Signature`)처럼 비밀이 섞이는 헤더는 이름만 주고 값은 null이다")
+/** 종류별 현재 동의 상태 */
+const customerConsentStateSchema = z.object({
+	kind: consentKindSchema,
+	agreed: z.boolean(),
+	/** 동의한 약관 버전. 마케팅이거나 이력이 없으면 null */
+	agreedVersion: z.string().nullable(),
+	/** 상점의 현재 약관 버전. 마케팅은 null */
+	currentVersion: z.string().nullable(),
+	/** 상점이 정한 현재 약관 문서 주소. 정하지 않았거나 마케팅이면 null */
+	currentDocumentUrl: z.string().nullable(),
+	updatedAt: z.string().nullable(),
+	/** 약관이 개정돼 다시 받아야 하는가. 마케팅은 항상 false */
+	reconsentRequired: z.boolean()
 });
-/** 웹훅 전송 기록 한 건 (전송 기록 조회 항목) */
-const webhookDeliverySchema = z.object({
-	deliveryId: z.string().describe("전송 기록 ID. 수신 요청의 `Sayren-Delivery-Id` 헤더 값"),
-	eventId: z.string().describe("이벤트 ID. 재시도·재전송해도 같은 이벤트면 같은 값이다. 수신 측 중복 제거 키로 쓴다"),
-	eventType: eventTypeSchema,
-	url: z.string().describe("전송 시점의 대상 URL"),
-	status: webhookDeliveryStatusSchema,
-	responseStatusCode: z.number().int().nullable().describe("마지막 시도의 HTTP 응답 코드. 미시도·연결 실패·타임아웃·차단이면 null"),
-	responseTimeMs: z.number().int().nullable().describe("마지막 시도의 응답 시간(ms). 미시도·연결 실패면 null"),
-	responseBodyExcerpt: z.string().nullable().describe("마지막 시도의 응답 본문 앞부분(최대 4,096자). 응답이 없으면 null. 가린 뒤에 자른다. 키 이름에 `authorization`·`token`·`secret`·`password`·`key`·`signature`·`credential`·`cookie`가 **들어 있으면**(부분 일치, 대소문자 무시. 예: `apiKey`·`access_token`·`keyword`) 그 값을 `***`로 가린다. 값이 객체·배열이면 통째로 가린다. 평문 `Authorization: …` 같은 헤더 줄, `Bearer <토큰>`, 쿼리 형식 `access_token=…`, 끝에서 잘려 닫히지 않은 값도 가린다"),
-	errorCode: webhookDeliveryErrorCodeSchema.nullable().describe("마지막 시도의 실패 사유. 성공했거나 미시도면 null"),
-	failureReason: webhookFailureReasonSchema.nullable().describe("마지막 시도의 실패 원인 분류. 성공했거나 미시도면 null. `errorCode`를 더 잘게 나눈 진단 값이다"),
-	resource: webhookDeliveryResourceSchema.nullable().describe("이벤트가 가리키는 대상 리소스. 리소스를 특정할 수 없는 이벤트면 null. 이 값으로 전송 기록(`resourceId`)과 API 로그(`q`)를 오갈 수 있다"),
-	attemptCount: z.number().int().min(0).describe("지금까지 전송을 시작한 횟수. 최초 시도 1회 + 재시도 최대 4회. 전송 도중 장애로 결과를 기록하지 못한 시도도 센다"),
-	createdAt: z.string().describe("전송 기록이 적재된 일시 (ISO 8601)"),
-	attemptedAt: z.string().nullable().describe("마지막 시도 일시 (ISO 8601). 미시도면 null"),
-	nextAttemptAt: z.string().nullable().describe("다음 시도 예정 일시 (ISO 8601). `PENDING`·`PENDING_RETRY`일 때만 값이 있다"),
-	redeliveryOf: z.string().nullable().describe("수동 재전송으로 생긴 기록이면 원본 전송 기록 ID. 아니면 null"),
-	redeliveredAs: z.string().nullable().describe("이 기록을 원본으로 수동 재전송해 생긴 기록의 전송 기록 ID. 아직 재전송하지 않았으면 null. 재전송은 원본당 1회다")
+const customerConsentsSchema = z.object({
+	terms: customerConsentStateSchema,
+	privacy: customerConsentStateSchema,
+	marketing: customerConsentStateSchema,
+	/** 필수 동의 중 하나라도 현재 버전이 아니면 true */
+	reconsentRequired: z.boolean()
 });
-/** 발송 본문 최대 노출 길이(바이트). 넘으면 잘라 주고 `payloadTruncated`가 true다 */
-const WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES = 16384;
-/** 웹훅 전송 기록 상세 — `GET /webhooks/{id}/deliveries/{deliveryId}`. 목록 항목 + 요청 본문·헤더 */
-const webhookDeliveryDetailSchema = webhookDeliverySchema.extend({
-	payload: z.string().describe(`수신 서버로 보낸 요청 본문 그대로(JSON 문자열). 서명은 이 문자열을 대상으로 계산한다. 최대 ${WEBHOOK_PAYLOAD_EXCERPT_MAX_BYTES / 1024}KB까지 주고 넘으면 잘라 준다`),
-	payloadTruncated: z.boolean().describe("본문이 길어서 잘렸으면 true. true면 `payload`는 유효한 JSON이 아니다"),
-	payloadMasked: z.boolean().describe("민감 키 마스킹(`responseBodyExcerpt`와 같은 키 이름 규칙)이 본문을 바꿨으면 true. true면 `payload`는 보낸 본문과 달라 서명을 맞춰 볼 수 없다. 이벤트 본문에는 보통 민감 키가 없어 false다"),
-	requestHeaders: z.array(webhookRequestHeaderSchema).describe("발송 요청에 실은 헤더. 값은 전송 시점 그대로이나 서명 헤더는 이름만 주고 값은 null이다. `Content-Length`는 실제로 보낸 본문(마스킹·자르기 전)의 바이트 수다. 매 시도가 같은 헤더 집합을 쓰고 서명·타임스탬프만 달라진다")
+/** `GET /v1/customers/{id}/consents` 쿼리 — 최근 순이다 */
+const customerConsentListQuerySchema = z.object({
+	kind: consentKindSchema.optional().describe("동의 종류 필터. 생략하면 전체"),
+	...pageQueryShape()
 });
-/** 전송 기록 조회 쿼리 — `GET /webhooks/{id}/deliveries` */
-const webhookDeliveryListQuerySchema = z.object({
-	status: webhookDeliveryStatusSchema.optional().describe("전송 상태 필터. 생략하면 전체"),
-	eventType: eventTypeSchema.optional().describe("이벤트 타입 필터. 생략하면 전체"),
-	resourceId: z.string().optional().describe("대상 리소스 ID 필터(정확히 일치). 주문·클레임·상품·리뷰·문의 id를 넣으면 그 리소스의 이벤트만 남는다. 같은 id로 API 로그를 `q`로 검색하면 그 리소스를 건드린 API 요청을 볼 수 있다"),
-	limit: z.coerce.number().int().min(1).max(100).optional().describe("최대 건수 (1~100, 기본 50). 최신 적재순으로 반환하며 보관 기간은 30일이다")
+/** 구매자 상세 — 휴대폰 전체를 보여 준다 */
+const customerDetailSchema = z.object({
+	customerId: z.string(),
+	name: z.string(),
+	email: z.string().nullable(),
+	phone: z.string().nullable(),
+	joinedAt: z.string(),
+	point: z.number().int(),
+	marketingAgreed: z.boolean(),
+	loginMethods: z.array(z.object({
+		method: z.enum([
+			"password",
+			"kakao",
+			"naver",
+			"google"
+		]),
+		/** 소셜 연결 시각. 비밀번호는 가입 시각 */
+		linkedAt: z.string()
+	})).describe("로그인 방법 — 이메일·비밀번호(`password`)와 연결된 소셜 계정"),
+	consents: customerConsentsSchema.describe("약관·개인정보·마케팅 동의의 현재 상태. 이력은 `GET /v1/customers/{customerId}/consents`"),
+	addresses: z.array(customerAddressSchema),
+	stats: customerStatsSchema.extend({
+		canceledOrReturnedCount: z.number().int().describe("취소된 주문 상품 + 완료된 반품 수"),
+		reviewCount: z.number().int(),
+		inquiryCount: z.number().int().describe("상품 문의 + 1:1 문의")
+	})
 });
-/** 실패 건 일괄 재전송 응답 — `POST /webhooks/{id}/deliveries/redeliver-failed` */
-const webhookRedeliverFailedResultSchema = z.object({ queued: z.number().int().min(0).describe("재전송 대기열에 올린 건수. 최근 72시간의 `FAILED` 중 아직 재전송되지 않은 건이 대상이며 최대 500건이다") });
-const webhookTestRequestSchema = z.object({ eventType: eventTypeSchema.describe("샘플 페이로드로 보낼 이벤트 타입") });
-/** 테스트 이벤트 발송 결과 (동기 반환). 재시도·정지 판정·전송 기록이 없다 */
-const webhookTestResultSchema = z.object({
-	responseStatusCode: z.number().int().nullable().describe("수신 서버의 HTTP 응답 코드. 연결 실패·타임아웃·차단이면 null"),
-	responseTimeMs: z.number().int().nullable().describe("응답 시간(ms). 연결 실패면 null"),
-	errorCode: webhookDeliveryErrorCodeSchema.nullable().describe("실패 사유. 2xx 응답이면 null"),
-	failureReason: webhookFailureReasonSchema.nullable().describe("실패 원인 분류. 2xx 응답이면 null"),
-	responseBodyExcerpt: z.string().nullable().describe("응답 본문 앞부분(최대 4,096자). 규칙은 전송 기록의 `responseBodyExcerpt`와 같다. 응답이 없으면 null"),
-	requestHeaders: z.array(webhookRequestHeaderSchema).describe("보낸 요청 헤더. 서명 헤더는 이름만 주고 값은 null이다"),
-	payload: z.string().describe("보낸 요청 본문 그대로(JSON 문자열). 샘플 이벤트다")
+/** 구매자의 주문 — 전체 기간 */
+const customerOrderSchema = z.object({
+	orderId: z.string(),
+	orderedAt: z.string(),
+	totalAmount: z.number().int().describe("결제 금액"),
+	testPayment: z.boolean(),
+	items: z.array(z.object({
+		orderItemId: z.string(),
+		productName: z.string(),
+		optionName: z.string().nullable(),
+		quantity: z.number().int(),
+		status: orderItemStatusSchema,
+		claimStatus: z.enum([
+			"CANCEL_REQUESTED",
+			"RETURN_REQUESTED",
+			"EXCHANGE_REQUESTED"
+		]).nullable()
+	}))
 });
-const webhookRequestSchema = z.object({
-	url: z.url().startsWith("https://", "웹훅 URL은 HTTPS만 허용됩니다"),
-	eventTypes: z.array(eventTypeSchema).min(1)
+/** `POST /v1/customers/{id}/withdraw` 본문 */
+const withdrawCustomerRequestSchema = z.object({
+	reason: z.enum([
+		"BUYER_REQUEST",
+		"DORMANT",
+		"ABUSE",
+		"OTHER"
+	]).describe("처리 사유 — 구매자 요청·장기 미이용·부정 이용·기타. 감사 로그에 남는다"),
+	memo: z.string().max(200).optional().describe("사유 보충(선택)")
 });
-const reviewSchema = z.object({
-	reviewId: z.string(),
-	productId: z.string(),
-	productName: z.string(),
-	orderItemId: z.string(),
-	optionName: z.string().nullable(),
-	rating: z.number().int().min(1).max(5),
-	content: z.string(),
-	images: z.array(z.url()),
-	writerMaskedName: z.string(),
-	blinded: z.boolean(),
-	reply: z.object({
-		content: z.string(),
-		repliedAt: z.string(),
-		updatedAt: z.string().nullable()
-	}).nullable(),
-	createdAt: z.string()
+/** `WITHDRAWAL_BLOCKED`의 `error.details` — 탈퇴를 막는 항목 수(스토어프론트 탈퇴와 같다) */
+const customerWithdrawalBlockedDetailsSchema = z.object({
+	inProgressOrderItems: z.number().int(),
+	openClaims: z.number().int(),
+	pendingPayments: z.number().int()
 });
-const reviewSortSchema = z.enum([
-	"createdAt.desc",
-	"createdAt.asc",
-	"rating.asc",
-	"rating.desc"
+//#endregion
+//#region src/schemas/login.ts
+/** 소셜 로그인 공급자 */
+const loginProviderSchema = z.enum([
+	"kakao",
+	"naver",
+	"google"
 ]);
-/** `GET /v1/reviews` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열) */
-const reviewListQuerySchema = z.object({
-	productId: z.string().optional().describe("상품 id 필터"),
-	rating: z.enum([
-		"1",
-		"2",
-		"3",
-		"4",
-		"5"
-	]).optional().describe("별점 필터 (일치)"),
-	replied: z.enum(["true", "false"]).optional().describe("답글 여부 필터. `true`면 답글 단 리뷰만, `false`면 답글 없는 리뷰만"),
-	hasImage: z.enum(["true", "false"]).optional().describe("`true`면 이미지가 있는 리뷰만"),
-	from: z.string().optional().describe("작성 시각 조회 시작 (ISO 8601, 포함)"),
-	sort: reviewSortSchema.optional().describe("정렬 (기본 createdAt.desc)"),
-	...pageQueryShape()
+/** 공급자 연결 상태 — 비밀 값은 앞 4자리만 */
+const loginProviderStatusSchema = z.object({
+	provider: loginProviderSchema,
+	connected: z.boolean(),
+	/** 스토어프론트에서 사용 중인지. 연결 안 됐으면 false */
+	enabled: z.boolean(),
+	clientIdPrefix: z.string().nullable().describe("클라이언트 ID(카카오 REST API 키) 앞 4자리"),
+	secretPrefix: z.string().nullable(),
+	lastTestedAt: z.string().nullable(),
+	lastTestOk: z.boolean().nullable(),
+	linkedMemberCount: z.number().int().describe("이 공급자로 연결된 구매자 수"),
+	/** 이 공급자로만 로그인하는 구매자 수 — 연결을 해제하면 로그인할 방법이 없어진다 */
+	onlyMethodMemberCount: z.number().int(),
+	callbackUrl: z.url().describe("공급자 개발자 콘솔에 등록할 리디렉트 URI")
 });
-/** `POST /v1/reviews/{reviewId}/report` 응답(202) — 신고 접수 */
-const reviewReportResultSchema = z.object({
-	reviewId: z.string(),
-	status: z.literal("PENDING_REVIEW")
+/** `GET /v1/store/login-settings` */
+const loginSettingsSchema = z.object({
+	passwordLoginEnabled: z.boolean(),
+	/** 비밀번호로만 로그인하는 구매자 수 — 이메일·비밀번호를 끄면 이들은 로그인할 수 없다 */
+	passwordOnlyMemberCount: z.number().int(),
+	storefrontOrigins: z.array(z.string()),
+	providers: z.array(loginProviderStatusSchema)
+});
+/** `PATCH /v1/store/login-settings` */
+const updateLoginSettingsRequestSchema = z.object({ passwordLoginEnabled: z.boolean() });
+/** `PUT /v1/store/auth-providers/{provider}` — 저장 전에 연결 테스트를 한다 */
+const saveLoginProviderRequestSchema = z.object({
+	clientId: z.string().trim().min(1).max(200),
+	clientSecret: z.string().trim().min(1).max(500)
+});
+/** `PATCH /v1/store/auth-providers/{provider}` */
+const updateLoginProviderRequestSchema = z.object({ enabled: z.boolean() });
+/** 연결 테스트 결과 */
+const loginProviderTestSchema = z.object({
+	ok: z.boolean(),
+	/** 실패 이유 — `INVALID_CLIENT`(키가 틀림)·`PROVIDER_UNAVAILABLE`(공급자 응답 없음) */
+	code: z.enum(["INVALID_CLIENT", "PROVIDER_UNAVAILABLE"]).nullable(),
+	testedAt: z.string()
 });
 //#endregion
 //#region src/schemas/payment.ts
@@ -8519,6 +8541,10 @@ get: (params) => storeHttp.request("GET", "/sales-report", salesReportSchema, {
 				/** 비밀 필드를 생략하면 현재 값을 유지한다. 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}`),
+				/** 실행 기록 — 최근 이벤트 전송 결과와 최근 7일 관리 API 호출 수 */
+				activity: (installationId) => storeHttp.request("GET", path`/apps/installations/${installationId}/activity`, appInstallationActivitySchema),
+				/** 권한 업데이트 동의 — 넓어진 새 버전(`pendingVersion`)으로 옮긴다(상점 플랫폼 전용) */
+				consent: (installationId) => storeHttp.request("POST", path`/apps/installations/${installationId}/consent`, appInstallationSchema),
 				/** 앱 화면 iframe에 넘길 세션 토큰(5분) */
 				session: (installationId) => storeHttp.request("POST", path`/apps/installations/${installationId}/session`, appSessionSchema)
 			}
@@ -9230,4 +9256,4 @@ function createStoreSession(options) {
 	};
 }
 //#endregion
-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_ICON_CONTENT_TYPES, APP_ICON_MAX_BYTES, APP_ICON_MIN_PX, APP_LIFECYCLE_EVENT_TYPES, APP_NETWORK_DENIED_SUFFIXES, APP_NETWORK_HOSTS_MAX, APP_README_MAX_BYTES, 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, appIconProblem, appInstallRequestSchema, appInstallationAppSchema, appInstallationSchema, appInstallationSelfSchema, appInstallationSettingsSchema, appInstallationSettingsUpdateSchema, appInstallationStatusSchema, appInvocationSchema, appListingSchema, 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, storeAppDetailSchema, storeAppSchema, 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 };
+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_ICON_CONTENT_TYPES, APP_ICON_MAX_BYTES, APP_ICON_MIN_PX, APP_LIFECYCLE_EVENT_TYPES, APP_NETWORK_DENIED_SUFFIXES, APP_NETWORK_HOSTS_MAX, APP_README_MAX_BYTES, 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, appIconProblem, appInstallRequestSchema, appInstallationActivitySchema, appInstallationAppSchema, appInstallationRunSchema, appInstallationSchema, appInstallationSelfSchema, appInstallationSettingsSchema, appInstallationSettingsUpdateSchema, appInstallationStatusSchema, appInvocationSchema, appListingSchema, 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, storeAppDetailSchema, storeAppSchema, 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 };