@sayren/store-sdk 0.30.2 → 0.30.4

package/dist/index.mjs

@@ -92,6 +92,7 @@ const writePreviewSchema = z.object({
 		type: z.string(),
 		id: z.string().nullable()
 	}),
+	targetName: z.string().nullable().optional().describe("대상 이름(상품명·쿠폰명·흐름 이름·구매자 이름 등). 읽을 수 없으면 null"),
 	changes: z.array(z.object({
 		field: z.string().describe("바뀌는 필드"),
 		before: z.unknown().describe("현재 값. 새로 만드는 요청이거나 읽을 수 없으면 null"),
@@ -119,6 +120,7 @@ const approvalRequestSchema = z.object({
 	approvalId: z.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"),
@@ -1441,7 +1443,7 @@ const POINT_ADJUSTMENT_MAX = 1e7;
 const pointAdjustmentRequestSchema = z.object({
 	amount: z.number().int().min(-1e7).max(POINT_ADJUSTMENT_MAX).refine((value) => value !== 0, "0원은 조정할 수 없습니다").describe("지급은 양수, 차감은 음수(원)"),
 	reason: z.string().trim().min(1).max(200).describe("사유(필수). 구매자에게는 보이지 않는다"),
-	expiresAt: z.iso.datetime({ offset: true }).optional().describe("지급분의 소멸 시각. 생략하면 정책 유효 기간으로 정한다. 차감에는 주지 않는다")
+	expiresAt: z.iso.datetime({ offset: true }).optional().describe("지급분의 소멸 시각. 생략하면 정책 유효 기간(`expiryDays`)으로 정한다. **정책 유효 기간이 없으면 지급에 필수다**(없으면 400 `POINT_EXPIRY_REQUIRED`). 차감에는 주지 않는다")
 }).refine((value) => !(value.amount < 0 && value.expiresAt), {
 	message: "차감에는 소멸 시각을 줄 수 없습니다",
 	path: ["expiresAt"]
@@ -2598,7 +2600,18 @@ const flowInputFieldSchema = z.object({
 	placeholder: z.string().optional().describe("입력 안내"),
 	maxLength: z.number().int().optional(),
 	maxFiles: z.number().int().optional(),
-	options: z.array(z.union([z.string(), z.number()])).optional()
+	options: z.array(z.union([
+		z.string(),
+		z.number(),
+		z.object({
+			value: z.string(),
+			label: z.string()
+		}).describe("값과 보여 줄 이름")
+	])).optional().describe("고르는 형식의 선택지. 값만 있거나 값·이름 쌍이다(보낼 때는 값)"),
+	when: z.object({
+		key: z.string(),
+		in: z.array(z.string())
+	}).optional().describe("다른 칸(`key`)의 값이 `in` 중 하나일 때만 보이고 받는 칸. 없으면 늘 받는다")
 });
 const flowActionSchema = z.object({
 	key: z.string().describe("행동 키. 플랫폼 키(예: CONFIRM_ORDER)와 상점·앱이 정한 키가 섞인다"),
@@ -2635,6 +2648,7 @@ const flowStateSchema = z.object({
 	enteredAt: z.string().describe("이 상태에 들어온 시각(ISO 8601)"),
 	deadlineAt: z.string().optional().describe("가장 가까운 기한(ISO 8601)"),
 	attachments: z.array(z.string()).optional().describe("가장 최근 행동이 붙인 첨부 주소(시안 등, #115). 없으면 생략"),
+	earlierAttachments: z.array(z.string()).optional().describe("앞 상태에서 붙인 첨부(수정 요청 뒤의 이전 시안 등). 다음 첨부가 오면 바뀐다. 없으면 생략"),
 	inputs: z.object({
 		by: z.string().describe("적은 사람 — seller · buyer"),
 		values: z.array(z.object({
@@ -2730,8 +2744,8 @@ const commerceFlowSummarySchema = z.object({
 	flowId: z.string(),
 	key: z.string().describe("상점 안 유일한 키"),
 	name: z.string(),
-	progression: z.enum(["ITEM", "ORDER_GROUP"]),
-	fulfillmentMethods: z.array(z.string()),
+	progression: z.enum(["ITEM", "ORDER_GROUP"]).describe("진행 단위 — 지금 게시 버전의 값(초안 `definition.requires.progression`을 게시 때 고정한다). 주문상품은 주문 시점 버전의 값을 따른다"),
+	fulfillmentMethods: z.array(z.string()).describe("이행 방식 — 지금 게시 버전의 `definition.requires.fulfillmentMethods`"),
 	presetKey: z.string().nullable().describe("설치한 프리셋(설치 뒤 연결되지 않는다)"),
 	presetVersion: z.number().int().nullable(),
 	activeVersion: z.number().int().nullable().describe("게시된 버전. 새 주문이 따른다"),

package/package.json

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

package/src/schemas/audit.ts

@@ -155,6 +155,11 @@ export const writePreviewSchema = z.object({
   method: z.string(),
   path: z.string(),
   target: z.object({ type: z.string(), id: z.string().nullable() }),
+  targetName: z
+    .string()
+    .nullable()
+    .optional()
+    .describe("대상 이름(상품명·쿠폰명·흐름 이름·구매자 이름 등). 읽을 수 없으면 null"),
   changes: z
     .array(
       z.object({
@@ -195,6 +200,13 @@ export const approvalRequestSchema = z.object({
   approvalId: z.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"),

package/src/schemas/commerce-flow.ts

@@ -20,7 +20,20 @@ export const flowInputFieldSchema = z.object({
   placeholder: z.string().optional().describe("입력 안내"),
   maxLength: z.number().int().optional(),
   maxFiles: z.number().int().optional(),
-  options: z.array(z.union([z.string(), z.number()])).optional(),
+  options: z
+    .array(
+      z.union([
+        z.string(),
+        z.number(),
+        z.object({ value: z.string(), label: z.string() }).describe("값과 보여 줄 이름"),
+      ]),
+    )
+    .optional()
+    .describe("고르는 형식의 선택지. 값만 있거나 값·이름 쌍이다(보낼 때는 값)"),
+  when: z
+    .object({ key: z.string(), in: z.array(z.string()) })
+    .optional()
+    .describe("다른 칸(`key`)의 값이 `in` 중 하나일 때만 보이고 받는 칸. 없으면 늘 받는다"),
 });
 export type FlowInputField = z.infer<typeof flowInputFieldSchema>;
 
@@ -67,6 +80,12 @@ export const flowStateSchema = z.object({
     .array(z.string())
     .optional()
     .describe("가장 최근 행동이 붙인 첨부 주소(시안 등, #115). 없으면 생략"),
+  earlierAttachments: z
+    .array(z.string())
+    .optional()
+    .describe(
+      "앞 상태에서 붙인 첨부(수정 요청 뒤의 이전 시안 등). 다음 첨부가 오면 바뀐다. 없으면 생략",
+    ),
   inputs: z
     .object({
       by: z.string().describe("적은 사람 — seller · buyer"),
@@ -195,8 +214,14 @@ export const commerceFlowSummarySchema = z.object({
   flowId: z.string(),
   key: z.string().describe("상점 안 유일한 키"),
   name: z.string(),
-  progression: z.enum(["ITEM", "ORDER_GROUP"]),
-  fulfillmentMethods: z.array(z.string()),
+  progression: z
+    .enum(["ITEM", "ORDER_GROUP"])
+    .describe(
+      "진행 단위 — 지금 게시 버전의 값(초안 `definition.requires.progression`을 게시 때 고정한다). 주문상품은 주문 시점 버전의 값을 따른다",
+    ),
+  fulfillmentMethods: z
+    .array(z.string())
+    .describe("이행 방식 — 지금 게시 버전의 `definition.requires.fulfillmentMethods`"),
   presetKey: z.string().nullable().describe("설치한 프리셋(설치 뒤 연결되지 않는다)"),
   presetVersion: z.number().int().nullable(),
   activeVersion: z.number().int().nullable().describe("게시된 버전. 새 주문이 따른다"),

package/src/schemas/points.ts

@@ -331,7 +331,9 @@ export const pointAdjustmentRequestSchema = z
     expiresAt: z.iso
       .datetime({ offset: true })
       .optional()
-      .describe("지급분의 소멸 시각. 생략하면 정책 유효 기간으로 정한다. 차감에는 주지 않는다"),
+      .describe(
+        "지급분의 소멸 시각. 생략하면 정책 유효 기간(`expiryDays`)으로 정한다. **정책 유효 기간이 없으면 지급에 필수다**(없으면 400 `POINT_EXPIRY_REQUIRED`). 차감에는 주지 않는다",
+      ),
   })
   .refine((value) => !(value.amount < 0 && value.expiresAt), {
     message: "차감에는 소멸 시각을 줄 수 없습니다",