@sayren/store-sdk 0.47.0 → 0.49.0

package/dist/server.mjs

@@ -1,4 +1,4 @@
-import { a as WEBHOOK_HEADERS, i as WEBHOOK_EVENT_TYPE_HEADER, n as WEBHOOK_DELIVERY_ID_HEADER, o as WEBHOOK_SIGNATURE_HEADER, r as WEBHOOK_EVENT_ID_HEADER, s as WEBHOOK_USER_AGENT, t as WEBHOOK_DEFAULT_TOLERANCE_SEC } from "./webhook-headers-CTez3xDY.mjs";
+import { a as WEBHOOK_HEADERS, i as WEBHOOK_EVENT_TYPE_HEADER, n as WEBHOOK_DELIVERY_ID_HEADER, o as WEBHOOK_SIGNATURE_HEADER, r as WEBHOOK_EVENT_ID_HEADER, s as WEBHOOK_USER_AGENT, t as WEBHOOK_DEFAULT_TOLERANCE_SEC } from "./webhook-headers-COVjv1yo.mjs";
 //#region src/member-delegation.ts
 /** 위임 실패 — `error`는 api 오류 코드(엔벨로프 `error.code`, 없으면 `http_{status}`) */
 var MemberDelegationError = class extends Error {

package/dist/{webhook-headers-CTez3xDY.mjs → webhook-headers-COVjv1yo.mjs}

@@ -1,4 +1,4 @@
-import * as z from "zod";
+import * as z$1 from "zod";
 //#region src/schemas/strict.ts
 /**
 * 관리 API 요청 본문을 모르는 키까지 거르는 스키마로 바꾼다(이슈 #193, 2026-10-24). `z.object`는 모르는 키를 조용히 버려서
@@ -18,8 +18,8 @@ function strictOf(schema, seen) {
 			...def,
 			...patch
 		});
-		const meta = z.globalRegistry.get(schema);
-		if (meta) z.globalRegistry.add(next, meta);
+		const meta = z$1.globalRegistry.get(schema);
+		if (meta) z$1.globalRegistry.add(next, meta);
 		return next;
 	};
 	let next;
@@ -27,7 +27,7 @@ function strictOf(schema, seen) {
 		case "object":
 			next = clone({
 				shape: Object.fromEntries(Object.entries(def.shape).map(([key, value]) => [key, strictOf(value, seen)])),
-				catchall: def.catchall ?? z.never()
+				catchall: def.catchall ?? z$1.never()
 			});
 			break;
 		case "array":
@@ -84,107 +84,107 @@ function strictOf(schema, seen) {
 * 관리 API 쓰기(`/v1/**`의 GET 외 요청)는 모두 요청 단위 기록(`source: REQUEST`) 한 줄을 남긴다. 환불·직권취소 같은
 * 도메인 동작은 그 안에서 변경 전후를 담은 기록(`source: DOMAIN`)을 따로 남기고 `requestId`로 요청 기록과 이어진다.
 */
-const auditActorTypeSchema = z.enum([
+const auditActorTypeSchema = z$1.enum([
 	"USER",
 	"AGENT",
 	"APP",
 	"TOKEN",
 	"SYSTEM"
 ]).describe("행위자 유형. `USER`=상점 플랫폼 사용자, `AGENT`=AI 에이전트(MCP·에이전트용 API 토큰), `APP`=앱(OAuth 클라이언트·M2M), `TOKEN`=API 토큰, `SYSTEM`=자동화(주기 잡)");
-const auditActorSchema = z.object({
+const auditActorSchema = z$1.object({
 	type: auditActorTypeSchema,
-	id: z.string().describe("행위자 ID. `USER`=userId, `TOKEN`·`AGENT`(API 토큰)=`pat:{tokenId}`, `APP`=`client:{clientId}`, `SYSTEM`=`system`. 사람이 앱에 위임한 호출은 `APP`이고 위임한 사람은 `metadata.onBehalfOf`에 있다"),
-	name: z.string().nullable().describe("기록 시점의 표시 이름. 알 수 없으면 null")
+	id: z$1.string().describe("행위자 ID. `USER`=userId, `TOKEN`·`AGENT`(API 토큰)=`pat:{tokenId}`, `APP`=`client:{clientId}`, `SYSTEM`=`system`. 사람이 앱에 위임한 호출은 `APP`이고 위임한 사람은 `metadata.onBehalfOf`에 있다"),
+	name: z$1.string().nullable().describe("기록 시점의 표시 이름. 알 수 없으면 null")
 });
-const auditLogSourceSchema = z.enum(["REQUEST", "DOMAIN"]).describe("기록 단위. `REQUEST`=관리 API 쓰기 요청 한 건, `DOMAIN`=환불·취소 같은 도메인 동작의 상세");
-const auditLogOutcomeSchema = z.enum([
+const auditLogSourceSchema = z$1.enum(["REQUEST", "DOMAIN"]).describe("기록 단위. `REQUEST`=관리 API 쓰기 요청 한 건, `DOMAIN`=환불·취소 같은 도메인 동작의 상세");
+const auditLogOutcomeSchema = z$1.enum([
 	"SUCCEEDED",
 	"FAILED",
 	"PENDING_APPROVAL",
 	"DENIED",
 	"DRY_RUN"
 ]).describe("요청 결과. `PENDING_APPROVAL`=승인 대기로 보류(202), `DENIED`=에이전트 정책으로 거부(403 `AGENT_OPERATION_DENIED`), `DRY_RUN`=드라이런(`x-sayren-dry-run: 1`)이라 실행하지 않음");
-const auditLogSchema = z.object({
-	auditId: z.string().describe("감사 로그 ID"),
-	occurredAt: z.string().describe("기록 일시 (ISO 8601)"),
+const auditLogSchema = z$1.object({
+	auditId: z$1.string().describe("감사 로그 ID"),
+	occurredAt: z$1.string().describe("기록 일시 (ISO 8601)"),
 	source: auditLogSourceSchema,
-	action: z.string().describe("동작. `REQUEST`는 오퍼레이션 ID(OpenAPI `operationId`, 예: `ProductsController_patch`), `DOMAIN`은 도메인 코드(예: `ORDER_ITEM_CANCELED_BY_SELLER`)"),
+	action: z$1.string().describe("동작. `REQUEST`는 오퍼레이션 ID(OpenAPI `operationId`, 예: `ProductsController_patch`), `DOMAIN`은 도메인 코드(예: `ORDER_ITEM_CANCELED_BY_SELLER`)"),
 	actor: auditActorSchema,
-	actorRole: z.string().nullable().describe("요청 시점의 상점 역할. 역할이 없는 토큰·자동화는 null"),
-	target: z.object({
-		type: z.string().describe("대상 리소스 유형 (예: `products`, `order-items`, `claim`)"),
-		id: z.string().nullable().describe("대상 리소스 ID. 목록 대상 요청처럼 하나로 정할 수 없으면 null")
+	actorRole: z$1.string().nullable().describe("요청 시점의 상점 역할. 역할이 없는 토큰·자동화는 null"),
+	target: z$1.object({
+		type: z$1.string().describe("대상 리소스 유형 (예: `products`, `order-items`, `claim`)"),
+		id: z$1.string().nullable().describe("대상 리소스 ID. 목록 대상 요청처럼 하나로 정할 수 없으면 null")
 	}),
-	requestId: z.string().nullable().describe("요청 ID. 같은 요청에서 나온 `REQUEST`·`DOMAIN` 기록이 같은 값을 가진다. 자동화는 null"),
-	method: z.string().nullable().describe("HTTP 메서드 (`REQUEST`만)"),
-	path: z.string().nullable().describe("요청 경로와 쿼리 (`REQUEST`만). 민감한 쿼리 값은 `***`로 가린다"),
-	statusCode: z.number().int().nullable().describe("응답 HTTP 상태 코드 (`REQUEST`만)"),
+	requestId: z$1.string().nullable().describe("요청 ID. 같은 요청에서 나온 `REQUEST`·`DOMAIN` 기록이 같은 값을 가진다. 자동화는 null"),
+	method: z$1.string().nullable().describe("HTTP 메서드 (`REQUEST`만)"),
+	path: z$1.string().nullable().describe("요청 경로와 쿼리 (`REQUEST`만). 민감한 쿼리 값은 `***`로 가린다"),
+	statusCode: z$1.number().int().nullable().describe("응답 HTTP 상태 코드 (`REQUEST`만)"),
 	outcome: auditLogOutcomeSchema.nullable().describe("요청 결과 (`REQUEST`만)"),
-	errorCode: z.string().nullable().describe("에러 응답의 `error.code` (실패한 요청만)"),
-	traceId: z.string().nullable().describe("추적 ID. 에러 응답의 `error.traceId`와 같다"),
-	idempotencyKey: z.string().nullable().describe("요청의 멱등키"),
-	approvalId: z.string().nullable().describe("승인 요청 ID. 승인 대기로 보류된 요청과 승인 뒤 실행된 요청에 실린다"),
-	metadata: z.record(z.string(), z.unknown()).describe("부가 정보. 도메인 기록은 변경 전후 값·사유를, 승인 실행 기록은 승인자(`approvedBy`)를 싣는다")
+	errorCode: z$1.string().nullable().describe("에러 응답의 `error.code` (실패한 요청만)"),
+	traceId: z$1.string().nullable().describe("추적 ID. 에러 응답의 `error.traceId`와 같다"),
+	idempotencyKey: z$1.string().nullable().describe("요청의 멱등키"),
+	approvalId: z$1.string().nullable().describe("승인 요청 ID. 승인 대기로 보류된 요청과 승인 뒤 실행된 요청에 실린다"),
+	metadata: z$1.record(z$1.string(), z$1.unknown()).describe("부가 정보. 도메인 기록은 변경 전후 값·사유를, 승인 실행 기록은 승인자(`approvedBy`)를 싣는다")
 });
 /** 쉼표 구분 목록 쿼리 → 배열 */
 function commaList(item) {
-	return z.union([z.string(), z.array(z.string())]).transform((value) => (Array.isArray(value) ? value : [value]).flatMap((part) => part.split(",")).map((part) => part.trim()).filter((part) => part.length > 0)).pipe(z.array(item).min(1));
+	return z$1.union([z$1.string(), z$1.array(z$1.string())]).transform((value) => (Array.isArray(value) ? value : [value]).flatMap((part) => part.split(",")).map((part) => part.trim()).filter((part) => part.length > 0)).pipe(z$1.array(item).min(1));
 }
 /** 감사 로그 조회 쿼리 — `GET /audit-logs` */
-const auditLogListQuerySchema = z.object({
-	from: z.string().optional().describe("조회 시작 일시 (ISO 8601, 포함)"),
-	to: z.string().optional().describe("조회 종료 일시 (ISO 8601, 미포함)"),
+const auditLogListQuerySchema = z$1.object({
+	from: z$1.string().optional().describe("조회 시작 일시 (ISO 8601, 포함)"),
+	to: z$1.string().optional().describe("조회 종료 일시 (ISO 8601, 미포함)"),
 	actorType: commaList(auditActorTypeSchema).optional().describe("행위자 유형 필터. 여러 개는 쉼표로 구분한다 (예: `AGENT,APP`)"),
-	actorId: z.string().optional().describe("행위자 ID 필터 (정확히 일치)"),
-	action: z.string().optional().describe("동작 필터 (정확히 일치)"),
-	targetType: z.string().optional().describe("대상 유형 필터 (정확히 일치)"),
-	targetId: z.string().optional().describe("대상 ID 필터 (정확히 일치)"),
+	actorId: z$1.string().optional().describe("행위자 ID 필터 (정확히 일치)"),
+	action: z$1.string().optional().describe("동작 필터 (정확히 일치)"),
+	targetType: z$1.string().optional().describe("대상 유형 필터 (정확히 일치)"),
+	targetId: z$1.string().optional().describe("대상 ID 필터 (정확히 일치)"),
 	source: auditLogSourceSchema.optional(),
 	outcome: auditLogOutcomeSchema.optional(),
-	requestId: z.string().optional().describe("요청 ID 필터 — 한 요청의 요청·도메인 기록을 함께 본다"),
-	approvalId: z.string().optional().describe("승인 요청 ID 필터"),
-	cursor: z.string().optional().describe("이전 응답의 `nextCursor`. 생략하면 가장 최신부터"),
-	limit: z.coerce.number().int().min(1).max(100).optional().describe("최대 건수 (1~100, 기본 50)")
+	requestId: z$1.string().optional().describe("요청 ID 필터 — 한 요청의 요청·도메인 기록을 함께 본다"),
+	approvalId: z$1.string().optional().describe("승인 요청 ID 필터"),
+	cursor: z$1.string().optional().describe("이전 응답의 `nextCursor`. 생략하면 가장 최신부터"),
+	limit: z$1.coerce.number().int().min(1).max(100).optional().describe("최대 건수 (1~100, 기본 50)")
 });
-const auditLogPageSchema = z.object({
-	items: z.array(auditLogSchema),
-	nextCursor: z.string().nullable().describe("다음 페이지 커서. 마지막 페이지면 null")
+const auditLogPageSchema = z$1.object({
+	items: z$1.array(auditLogSchema),
+	nextCursor: z$1.string().nullable().describe("다음 페이지 커서. 마지막 페이지면 null")
 });
-const agentPolicyDecisionSchema = z.enum([
+const agentPolicyDecisionSchema = z$1.enum([
 	"ALLOW",
 	"APPROVAL_REQUIRED",
 	"DENIED"
 ]).describe("에이전트 쓰기 판정. `ALLOW`=바로 실행, `APPROVAL_REQUIRED`=상점 플랫폼 승인 뒤 실행, `DENIED`=에이전트는 실행할 수 없음");
-const previewValueSchema = z.union([
-	z.string(),
-	z.number(),
-	z.boolean(),
-	z.null()
+const previewValueSchema = z$1.union([
+	z$1.string(),
+	z$1.number(),
+	z$1.boolean(),
+	z$1.null()
 ]);
-const writePreviewSchema = z.object({
-	operationId: z.string().describe("오퍼레이션 ID"),
-	method: z.string(),
-	path: z.string(),
-	target: z.object({
-		type: z.string(),
-		id: z.string().nullable()
+const writePreviewSchema = z$1.object({
+	operationId: z$1.string().describe("오퍼레이션 ID"),
+	method: z$1.string(),
+	path: z$1.string(),
+	target: z$1.object({
+		type: z$1.string(),
+		id: z$1.string().nullable()
 	}),
-	targetName: z.string().nullable().optional().describe("대상 이름(상품명·쿠폰명·흐름 이름·구매자 이름 등). 읽을 수 없으면 null"),
-	changes: z.array(z.object({
-		field: z.string().describe("바뀌는 필드"),
-		before: z.unknown().describe("현재 값. 새로 만드는 요청이거나 읽을 수 없으면 null"),
-		after: z.unknown().describe("요청이 넣을 값")
+	targetName: z$1.string().nullable().optional().describe("대상 이름(상품명·쿠폰명·흐름 이름·구매자 이름 등). 읽을 수 없으면 null"),
+	changes: z$1.array(z$1.object({
+		field: z$1.string().describe("바뀌는 필드"),
+		before: z$1.unknown().describe("현재 값. 새로 만드는 요청이거나 읽을 수 없으면 null"),
+		after: z$1.unknown().describe("요청이 넣을 값")
 	})).describe("값이 달라지는 필드. 서버가 현재 값과 비교할 수 있는 오퍼레이션만 채운다"),
-	facts: z.record(z.string(), previewValueSchema).describe("영향 요약 (예: 취소 수량·주문상품 금액·예상 환불액). 오퍼레이션마다 다르다")
+	facts: z$1.record(z$1.string(), previewValueSchema).describe("영향 요약 (예: 취소 수량·주문상품 금액·예상 환불액). 오퍼레이션마다 다르다")
 });
 /** `x-sayren-dry-run: 1`을 실은 쓰기 요청의 응답(200) — 실행하지 않고 판정과 영향만 돌려준다 */
-const writeDryRunResultSchema = z.object({
-	dryRun: z.literal(true),
+const writeDryRunResultSchema = z$1.object({
+	dryRun: z$1.literal(true),
 	decision: agentPolicyDecisionSchema,
-	reason: z.string().nullable().describe("승인 필요·거부 사유. `ALLOW`면 null"),
+	reason: z$1.string().nullable().describe("승인 필요·거부 사유. `ALLOW`면 null"),
 	preview: writePreviewSchema
 });
-const approvalStatusSchema = z.enum([
+const approvalStatusSchema = z$1.enum([
 	"PENDING",
 	"EXECUTING",
 	"SUCCEEDED",
@@ -193,82 +193,82 @@ const approvalStatusSchema = z.enum([
 	"REJECTED",
 	"EXPIRED"
 ]).describe("승인 요청 상태. `PENDING` 승인 대기 → 승인하면 `EXECUTING`(원 요청 실행 중) → `SUCCEEDED`·`FAILED`(원 요청의 응답 기준), 거절하면 `REJECTED`, 기한이 지나면 `EXPIRED`. 실행 응답을 받지 못했으면(타임아웃·서버 종료) `UNKNOWN`이다 — 서버가 감사 로그로 결과를 확정하면 `SUCCEEDED`·`FAILED`로 바뀌고, 확정하지 못하면 `UNKNOWN`에 남는다. `UNKNOWN`은 다시 실행하지 않는다(이미 실행됐을 수 있다)");
-const approvalRequestSchema = z.object({
-	approvalId: z.string().describe("승인 요청 ID"),
+const approvalRequestSchema = z$1.object({
+	approvalId: z$1.string().describe("승인 요청 ID"),
 	status: approvalStatusSchema,
-	operationId: z.string().describe("보류된 오퍼레이션 ID"),
-	operationName: z.string().nullable().optional().describe("작업 이름(예: 흐름 게시, 구매자 적립금 지급·차감). API 문서의 요약과 같다. 모르면 null"),
-	method: z.string().describe("HTTP 메서드"),
-	path: z.string().describe("요청 경로와 쿼리"),
-	body: z.unknown().describe("요청 본문. 승인하면 이 본문 그대로 실행한다. 없으면 null"),
-	idempotencyKey: z.string().nullable().describe("원 요청의 멱등키"),
-	reason: z.string().describe("승인이 필요한 이유"),
+	operationId: z$1.string().describe("보류된 오퍼레이션 ID"),
+	operationName: z$1.string().nullable().optional().describe("작업 이름(예: 흐름 게시, 구매자 적립금 지급·차감). API 문서의 요약과 같다. 모르면 null"),
+	method: z$1.string().describe("HTTP 메서드"),
+	path: z$1.string().describe("요청 경로와 쿼리"),
+	body: z$1.unknown().describe("요청 본문. 승인하면 이 본문 그대로 실행한다. 없으면 null"),
+	idempotencyKey: z$1.string().nullable().describe("원 요청의 멱등키"),
+	reason: z$1.string().describe("승인이 필요한 이유"),
 	actor: auditActorSchema.describe("요청한 행위자"),
 	preview: writePreviewSchema.nullable().describe("요청 시점에 서버가 계산한 영향 미리보기"),
-	createdAt: z.string().describe("요청 일시 (ISO 8601)"),
-	expiresAt: z.string().describe("승인 기한 (ISO 8601). 지나면 `EXPIRED`가 된다"),
-	decidedAt: z.string().nullable().describe("승인·거절 일시"),
-	decidedBy: z.object({
-		id: z.string(),
-		name: z.string().nullable()
+	createdAt: z$1.string().describe("요청 일시 (ISO 8601)"),
+	expiresAt: z$1.string().describe("승인 기한 (ISO 8601). 지나면 `EXPIRED`가 된다"),
+	decidedAt: z$1.string().nullable().describe("승인·거절 일시"),
+	decidedBy: z$1.object({
+		id: z$1.string(),
+		name: z$1.string().nullable()
 	}).nullable().describe("승인·거절한 상점 플랫폼 사용자"),
-	decisionNote: z.string().nullable().describe("승인·거절 메모"),
-	executedAt: z.string().nullable().describe("원 요청 실행을 마친 일시"),
-	result: z.object({
-		statusCode: z.number().int().describe("원 요청의 응답 상태 코드"),
-		data: z.unknown().describe("성공 응답의 `data` (큰 응답은 잘린다)"),
-		error: z.object({
-			code: z.string(),
-			message: z.string()
+	decisionNote: z$1.string().nullable().describe("승인·거절 메모"),
+	executedAt: z$1.string().nullable().describe("원 요청 실행을 마친 일시"),
+	result: z$1.object({
+		statusCode: z$1.number().int().describe("원 요청의 응답 상태 코드"),
+		data: z$1.unknown().describe("성공 응답의 `data` (큰 응답은 잘린다)"),
+		error: z$1.object({
+			code: z$1.string(),
+			message: z$1.string()
 		}).nullable().describe("실패 응답의 `error` 요약")
 	}).nullable().describe("실행 결과. `SUCCEEDED`·`FAILED`·`UNKNOWN`에서 값이 있다. 감사 로그로 확정한 결과는 `data`가 null이다"),
-	approvalUrl: z.string().nullable().describe("상점 플랫폼의 승인 화면 주소. 이 배포의 상점 플랫폼 주소를 알 수 없으면 null")
+	approvalUrl: z$1.string().nullable().describe("상점 플랫폼의 승인 화면 주소. 이 배포의 상점 플랫폼 주소를 알 수 없으면 null")
 });
-const approvalListQuerySchema = z.object({
+const approvalListQuerySchema = z$1.object({
 	status: commaList(approvalStatusSchema).optional().describe("상태 필터. 여러 개는 쉼표로 구분한다 (예: `PENDING,EXECUTING`)"),
-	cursor: z.string().optional().describe("이전 응답의 `nextCursor`. 생략하면 가장 최신부터"),
-	limit: z.coerce.number().int().min(1).max(100).optional().describe("최대 건수 (1~100, 기본 50)")
+	cursor: z$1.string().optional().describe("이전 응답의 `nextCursor`. 생략하면 가장 최신부터"),
+	limit: z$1.coerce.number().int().min(1).max(100).optional().describe("최대 건수 (1~100, 기본 50)")
 });
-const approvalPageSchema = z.object({
-	items: z.array(approvalRequestSchema),
-	nextCursor: z.string().nullable().describe("다음 페이지 커서. 마지막 페이지면 null")
+const approvalPageSchema = z$1.object({
+	items: z$1.array(approvalRequestSchema),
+	nextCursor: z$1.string().nullable().describe("다음 페이지 커서. 마지막 페이지면 null")
 });
-const approvalDecisionRequestSchema = strictRequest(z.object({ note: z.string().trim().max(500).optional().describe("승인·거절 메모 (최대 500자)") }));
+const approvalDecisionRequestSchema = strictRequest(z$1.object({ note: z$1.string().trim().max(500).optional().describe("승인·거절 메모 (최대 500자)") }));
 //#endregion
 //#region src/http.ts
 /** 표준 엔벨로프의 $.error 상세 */
-const errorDetailSchema = z.object({
-	code: z.string(),
-	message: z.string(),
-	traceId: z.string().optional(),
+const errorDetailSchema = z$1.object({
+	code: z$1.string(),
+	message: z$1.string(),
+	traceId: z$1.string().optional(),
 	/**
 	* 이 에러 코드를 설명하는 문서 URL(선택). 서버가 코드별 매핑을 가진 코드에만 실린다 —
 	* 없으면 필드가 아예 없으므로 소비측은 있을 때만 쓴다
 	*/
-	docs: z.url().optional().catch(void 0),
+	docs: z$1.url().optional().catch(void 0),
 	/**
 	* 에러 코드별 보조 데이터(선택). 예: 관리 API `LIVE_GATE_NOT_MET`의
 	* `{ conditions: LiveGateCondition[] }`. 형태는 에러 코드마다 다르므로 소비측이 코드별 스키마로 다시 파싱한다
 	*/
-	details: z.record(z.string(), z.unknown()).optional().catch(void 0)
+	details: z$1.record(z$1.string(), z$1.unknown()).optional().catch(void 0)
 });
 /** 표준 응답 엔벨로프 — $.meta / $.data / $.error */
-const envelopeSchema = z.object({
-	meta: z.object({
-		status: z.number(),
-		code: z.string(),
-		message: z.string(),
-		isSuccess: z.boolean()
+const envelopeSchema = z$1.object({
+	meta: z$1.object({
+		status: z$1.number(),
+		code: z$1.string(),
+		message: z$1.string(),
+		isSuccess: z$1.boolean()
 	}),
-	data: z.unknown().optional(),
+	data: z$1.unknown().optional(),
 	/** 구형 필드 — data로 개명되기 전 응답과의 전환기 호환 */
-	content: z.unknown().optional(),
+	content: z$1.unknown().optional(),
 	error: errorDetailSchema.nullable()
 });
 /** OAuth 프로토콜 표면의 평면 에러 (RFC 6749 §5.2, RFC 7591 §3.2.2) */
-const oauthErrorSchema = z.object({
-	error: z.string(),
-	error_description: z.string().optional()
+const oauthErrorSchema = z$1.object({
+	error: z$1.string(),
+	error_description: z$1.string().optional()
 });
 /** 표준 엔벨로프면 $.data(구형 $.content)를, 아니면(평면 응답) 본문 전체를 반환 */
 function unwrapData(json) {

package/package.json

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

package/src/client.ts

@@ -270,7 +270,9 @@ import {
   orderSchema,
   orderSummarySchema,
   purchaseDecisionExtendResultSchema,
+  type ShippingOrderItemListParams,
   sellerCancelPreviewSchema,
+  shippingOrderItemSchema,
 } from "./schemas/order";
 import {
   cashReceiptSchema,
@@ -342,6 +344,13 @@ import {
   variantStockRequestSchema,
   variantStockSchema,
 } from "./schemas/product";
+import {
+  type ProductImportItemInput,
+  type ProductLookupRequest,
+  productImportItemsRequestSchema,
+  productImportSchema,
+  productLookupRequestSchema,
+} from "./schemas/product-import";
 import {
   type InfoSectionLocalizationRequest,
   type InfoSectionRequestInput,
@@ -672,6 +681,26 @@ export function createStoreClient(options: StoreClientOptions) {
           body: { productIds, status: productStatusSchema.parse(status) },
           headers: idempotency(idempotencyKey),
         }),
+      /**
+       * 상품 일괄 반영(이슈 #211, 상점 플랫폼 전용) — 작업 만들기 → 항목 붙이기(여러 번) → 시작(202) → 조회.
+       * 항목 하나라도 실패하면 아무것도 반영하지 않는다
+       */
+      imports: {
+        create: () => storeHttp.request("POST", "/product-imports", productImportSchema),
+        addItems: (importId: string, items: ProductImportItemInput[]) =>
+          storeHttp.request("POST", path`/product-imports/${importId}/items`, productImportSchema, {
+            body: productImportItemsRequestSchema.parse({ items }),
+          }),
+        start: (importId: string) =>
+          storeHttp.request("POST", path`/product-imports/${importId}/start`, productImportSchema),
+        get: (importId: string) =>
+          storeHttp.request("GET", path`/product-imports/${importId}`, productImportSchema),
+        /** 상품 상세 묶음 조회(id·상품번호 합 100개) — 상점 플랫폼 전용. 이 상점에 없는 값은 빠진다 */
+        lookup: (body: ProductLookupRequest) =>
+          storeHttp.request("POST", "/product-imports/products", z.array(productSchema), {
+            body: productLookupRequestSchema.parse(body),
+          }),
+      },
       /** 옵션 축(그룹) × 값 → variant 모델 조회 */
       getOptionModel: (productId: string) =>
         storeHttp.request("GET", path`/products/${productId}/options`, optionModelSchema),
@@ -1005,6 +1034,15 @@ export function createStoreClient(options: StoreClientOptions) {
         storeHttp.request("GET", "/order-items", pageSchema(orderItemSchema), {
           query: params as unknown as Query,
         }),
+      /** `GET /v1/order-items/shipping` — 배송지가 필요한 주문상품을 주문번호·배송지·발송 정보와 함께, 주문 시각 최신순으로(#208). 스코프 `order:r` */
+      listShipping: (params: ShippingOrderItemListParams) =>
+        storeHttp.request("GET", "/order-items/shipping", pageSchema(shippingOrderItemSchema), {
+          query: {
+            ...params,
+            status: Array.isArray(params.status) ? params.status.join(",") : params.status,
+            orderItemNos: params.orderItemNos?.join(","),
+          } as Query,
+        }),
       confirm: (orderItemId: string, idempotencyKey?: string) =>
         storeHttp.requestVoid("POST", path`/order-items/${orderItemId}/confirm`, {
           headers: idempotency(idempotencyKey),

package/src/index.ts

@@ -32,7 +32,10 @@ export * from "./schemas/collection";
 export * from "./schemas/commerce-flow";
 export * from "./schemas/commerce-number";
 export * from "./schemas/common";
+export * from "./schemas/condition-tree";
 export * from "./schemas/coupon";
+export * from "./schemas/coupon-rules";
+export * from "./schemas/coupon-selection";
 export * from "./schemas/currency";
 export * from "./schemas/currency-prices";
 export * from "./schemas/customer";
@@ -48,6 +51,7 @@ export * from "./schemas/payment";
 export * from "./schemas/plans";
 export * from "./schemas/points";
 export * from "./schemas/product";
+export * from "./schemas/product-import";
 export * from "./schemas/product-info";
 export * from "./schemas/product-localization";
 export * from "./schemas/promotion";