@sayren/store-sdk 0.14.0 → 0.14.1

package/dist/index.d.mts

@@ -165,8 +165,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
 export declare const agentPolicyDecisionSchema: z.ZodEnum<{
-  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   DENIED: "DENIED";
+  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   ALLOW: "ALLOW";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
@@ -190,8 +190,8 @@ export type WritePreview = z.infer<typeof writePreviewSchema>;
 export declare const writeDryRunResultSchema: z.ZodObject<{
   dryRun: z.ZodLiteral<true>;
   decision: z.ZodEnum<{
-    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
     DENIED: "DENIED";
+    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
     ALLOW: "ALLOW";
   }>;
   reason: z.ZodNullable<z.ZodString>;
@@ -3207,7 +3207,7 @@ export declare const TOSS_WIDGET_CLIENT_KEY_PATTERN: RegExp;
 /** 토스페이먼츠 결제위젯 시크릿 키 접두사. {@link TOSS_WIDGET_CLIENT_KEY_PATTERN} 참고 */
 export declare const TOSS_WIDGET_SECRET_KEY_PATTERN: RegExp;
 /** 결제위젯 키를 거부할 때의 필드 메시지 */
-export declare const TOSS_WIDGET_KEY_MESSAGE = "결제위젯 키가 아니라 API 개별 연동 키를 입력해주세요";
+export declare const TOSS_WIDGET_KEY_MESSAGE = "결제위젯 키가 아니라 API 개별 연동 키를 입력해주십시오";
 export declare const tossPaymentsCredentialsInputSchema: z.ZodObject<{
   clientKey: z.ZodString;
   secretKey: z.ZodOptional<z.ZodString>;

package/dist/index.mjs

@@ -1577,7 +1577,7 @@ const TOSS_WIDGET_CLIENT_KEY_PATTERN = /^(test|live)_gck_/;
 /** 토스페이먼츠 결제위젯 시크릿 키 접두사. {@link TOSS_WIDGET_CLIENT_KEY_PATTERN} 참고 */
 const TOSS_WIDGET_SECRET_KEY_PATTERN = /^(test|live)_gsk_/;
 /** 결제위젯 키를 거부할 때의 필드 메시지 */
-const TOSS_WIDGET_KEY_MESSAGE = "결제위젯 키가 아니라 API 개별 연동 키를 입력해주세요";
+const TOSS_WIDGET_KEY_MESSAGE = "결제위젯 키가 아니라 API 개별 연동 키를 입력해주십시오";
 const tossPaymentsCredentialsInputSchema = z.object({
 	clientKey: z.string().trim().min(8).max(200).describe("클라이언트 키 (`test_ck_…`/`live_ck_…`). 공개 값 — 결제창에서 쓰인다"),
 	secretKey: secretInput().optional().describe("시크릿 키 (`test_sk_…`/`live_sk_…`). 비밀 값. 최초 연결 시 필수, 수정 시 생략하면 기존 값을 유지한다"),
@@ -1624,12 +1624,12 @@ const updatePaymentProviderRequestSchema = z.object({
 	enabled: z.boolean().optional().describe("사용 여부. 켜려면 활성 환경(샌드박스면 TEST, 아니면 LIVE) 자격 증명이 모두 저장돼 있어야 한다(`PAYMENT_PROVIDER_INCOMPLETE`)"),
 	sandboxMode: z.boolean().optional().describe("샌드박스 스위치. `true`면 새 결제에 TEST 세트를 쓴다(항상 허용). `false`(라이브 전환)는 라이브 개방 조건을 모두 충족해야 한다(`LIVE_GATE_NOT_MET`)"),
 	easyPayProviders: z.array(easyPayProviderSchema).max(easyPayProviderSchema.options.length).optional().describe("이 PG로 받는 간편결제사 — 통째로 바꾼다. PG 계약(포트원은 채널)에 추가한 간편결제만 켠다. 켠 간편결제사마다 스토어프론트 결제 옵션이 하나씩 생긴다(포트원은 간편결제를 받는 채널이 있어야 한다)")
-}).refine((body) => body.enabled !== void 0 || body.sandboxMode !== void 0 || body.easyPayProviders !== void 0, { message: "enabled·sandboxMode·easyPayProviders 중 하나는 보내야 해요" });
+}).refine((body) => body.enabled !== void 0 || body.sandboxMode !== void 0 || body.easyPayProviders !== void 0, { message: "enabled·sandboxMode·easyPayProviders 중 하나는 보내야 합니다" });
 const verifyPaymentProviderRequestSchema = z.object({ environment: pgEnvironmentSchema.optional().describe("연결 테스트할 자격 증명 세트. 생략하면 활성 환경(샌드박스면 TEST, 아니면 LIVE)") });
 const updatePaymentSettingsRequestSchema = z.object({
 	priority: z.array(pgProviderSchema).min(1).max(50).optional().describe("PG 우선순위(앞이 1순위) — 스토어프론트 결제 옵션 목록의 PG 순서다. 연결된 PG 수만큼 **모두 한 번씩** 나열한다(길이 상한 50은 안전장치다). 빠지거나 중복되거나 연결되지 않은 PG가 있으면 `INVALID_PRIORITY`"),
 	checkoutOrigins: z.array(z.string().max(200)).max(20).optional().describe("결제 도메인 — 통째로 바꾼다. 결제를 마친 구매자가 돌아올 스토어프론트 origin(`https://shop.example.com`, https·경로 없음). 결제 시작의 `returnUrl`은 이 목록 안이어야 한다. 비어 있으면 실결제를 시작할 수 없다(테스트 결제는 localhost 허용). 같은 도메인을 PG 가맹 정보에도 등록한다. 형식이 틀리면 `INVALID_CHECKOUT_ORIGIN`")
-}).refine((body) => body.priority !== void 0 || body.checkoutOrigins !== void 0, { message: "priority 또는 checkoutOrigins 중 하나는 보내야 해요" });
+}).refine((body) => body.priority !== void 0 || body.checkoutOrigins !== void 0, { message: "priority 또는 checkoutOrigins 중 하나는 보내야 합니다" });
 const maskedSecretSchema = z.object({
 	field: z.string().describe("비밀 필드 이름 (`secretKey`·`apiSecret`·`webhookSecret`)"),
 	configured: z.boolean().describe("값이 저장돼 있는가"),
@@ -1888,7 +1888,7 @@ const orderSummarySchema = z.object({
 	totalAmount: z.number().int(),
 	representativeStatus: orderItemStatusSchema,
 	orderedAt: z.string(),
-	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았어요. 상품을 발송하지 않도록 주의하세요")
+	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았습니다. 상품을 발송하지 않도록 주의하십시오")
 });
 const shippingAddressSchema = z.object({
 	receiverName: z.string(),
@@ -1928,7 +1928,7 @@ const orderItemSchema = z.object({
 	orderedAt: z.string(),
 	lastChangedAt: z.string(),
 	lastChangedType: changeTypeSchema,
-	testPayment: z.boolean().describe("소속 주문이 테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았어요")
+	testPayment: z.boolean().describe("소속 주문이 테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았습니다")
 });
 const orderSchema = z.object({
 	orderId: z.string(),
@@ -1957,14 +1957,14 @@ const orderSchema = z.object({
 		paidAt: z.string().nullable(),
 		cashReceipt: cashReceiptSchema.nullable().optional().default(null).describe("현금영수증. 구매자가 계좌이체·가상계좌 결제에서 신청했을 때만 있고 그 밖에는 null. 서버는 항상 싣는다")
 	}),
-	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았어요. 상품을 발송하지 않도록 주의하세요"),
+	testPayment: z.boolean().describe("테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았습니다. 상품을 발송하지 않도록 주의하십시오"),
 	items: z.array(orderItemSchema)
 });
 /** 주문 목록 응답 — `GET /v1/orders` */
 const orderSummaryPageSchema = pageSchema(orderSummarySchema);
 /** 주문상품 변경 목록 응답 — `GET /v1/order-items` */
 const orderItemPageSchema = pageSchema(orderItemSchema);
-const testPaymentQuery = z.enum(["true", "false"]).optional().describe("테스트 결제(샌드박스 결제) 필터. `true`면 테스트 결제만, `false`면 실결제만, 생략하면 전부예요");
+const testPaymentQuery = z.enum(["true", "false"]).optional().describe("테스트 결제(샌드박스 결제) 필터. `true`면 테스트 결제만, `false`면 실결제만, 생략하면 전부입니다");
 const pageQuery = { page: z.string().optional().describe("페이지 번호 (1부터, 기본 1)") };
 /**
 * `GET /v1/orders` 쿼리 — OpenAPI 문서용 형태(값은 쿼리 문자열). 검증 규칙은 서버가 적용한다:
@@ -2524,7 +2524,7 @@ const ADDRESS_DESCRIPTIONS = {
 };
 const productCreateRequestSchema = z.object({
 	name: z.string().min(1).max(100),
-	categoryId: z.string().min(1, "카테고리를 선택해주세요"),
+	categoryId: z.string().min(1, "카테고리를 선택해주십시오"),
 	salePrice: z.number().int().min(10).multipleOf(10, "판매가는 10원 단위여야 합니다 (INVALID_PRICE_UNIT)").describe("판매가. 원(KRW) 단위 정수, 최소 10원, 10원 단위"),
 	originalPrice: z.number().int().optional().describe("정가(할인 전 표시 가격). 원 단위"),
 	description: z.string().optional(),
@@ -3080,7 +3080,7 @@ const RESERVED_STORE_CODES = [
 function isReservedStoreCode(code) {
 	return RESERVED_STORE_CODES.includes(code.toLowerCase());
 }
-const storeCodeSchema = z.string().regex(STORE_CODE_PATTERN, "소문자·숫자·하이픈 3~30자여야 하고 하이픈으로 시작하거나 끝날 수 없어요").refine((code) => !isReservedStoreCode(code), "플랫폼이 쓰는 이름이라 스토어 코드로 쓸 수 없어요");
+const storeCodeSchema = z.string().regex(STORE_CODE_PATTERN, "소문자·숫자·하이픈 3~30자여야 하고 하이픈으로 시작하거나 끝날 수 없습니다").refine((code) => !isReservedStoreCode(code), "플랫폼이 쓰는 이름이라 스토어 코드로 쓸 수 없습니다");
 /** `https://shop.example.com`처럼 경로·쿼리 없는 http(s) 오리진인가 */
 function isWebOrigin(value) {
 	try {
@@ -3091,7 +3091,7 @@ function isWebOrigin(value) {
 	}
 }
 /** 방문 분석을 보낼 수 있는 스토어프론트 오리진 — 스킴·호스트(·포트)만. 서버가 소문자·끝 슬래시 제거로 정규화한다 */
-const analyticsOriginSchema = z.string().trim().max(255).refine(isWebOrigin, "https://shop.example.com 형식(경로 없이)으로 입력해 주세요").describe("스토어프론트 오리진. 예: `https://shop.example.com`");
+const analyticsOriginSchema = z.string().trim().max(255).refine(isWebOrigin, "https://shop.example.com 형식(경로 없이)으로 입력해 주십시오").describe("스토어프론트 오리진. 예: `https://shop.example.com`");
 /** 허용 오리진 상한 */
 const MAX_ANALYTICS_ALLOWED_ORIGINS = 20;
 /** 자동 배송완료·자동 구매확정 대기일 상한 */
@@ -3105,7 +3105,7 @@ const policyVersionSchema = z.string().trim().min(1).max(20).describe("약관
 * 약관 문서 주소 — 구매자에게 보여 주는 약관 본문의 주소다. 동의 시점 값이 이력 행에 복사되므로
 * 나중에 주소를 바꿔도 "무엇에 동의했는지"가 남는다. `null`로 지울 수 있다.
 */
-const policyDocumentUrlSchema = z.url().max(500).refine((value) => value.startsWith("https://"), "https 주소만 쓸 수 있어요").nullable();
+const policyDocumentUrlSchema = z.url().max(500).refine((value) => value.startsWith("https://"), "https 주소만 쓸 수 있습니다").nullable();
 const autoDeliverDaysDescription = "발송 후 자동 배송완료까지의 일수(0~30, 기본 7). 발송(`DISPATCHED`)·배송중(`DELIVERING`) 주문상품을 이 기간이 지나면 배송완료(`DELIVERED`)로 바꾼다. `0`이면 자동 배송완료를 하지 않는다";
 const autoConfirmDaysDescription = "배송완료 후 자동 구매확정까지의 일수(0~30, 기본 7). 배송완료 시점에 구매확정 예정일(`autoDecisionDate`)을 이 값으로 잡고, 그 날짜가 지나면 구매확정(`PURCHASE_DECIDED`)으로 바꾼다. 진행 중인 클레임이 있으면 건너뛴다. `0`이면 자동 구매확정을 하지 않는다";
 /** `PATCH /v1/store` 본문 — 바꿀 필드만 보낸다 */
@@ -4130,9 +4130,9 @@ function createStoreSession(options) {
 	async function handleCallback(code, state) {
 		const raw = storage.get(STORE_SESSION_KEYS.pkce);
 		storage.remove(STORE_SESSION_KEYS.pkce);
-		if (!raw) throw new Error("로그인 세션이 만료되었습니다. 다시 시도해주세요");
+		if (!raw) throw new Error("로그인 세션이 만료되었습니다. 다시 시도해주십시오");
 		const saved = JSON.parse(raw);
-		if (saved.state !== state) throw new Error("state가 일치하지 않습니다. 다시 시도해주세요");
+		if (saved.state !== state) throw new Error("state가 일치하지 않습니다. 다시 시도해주십시오");
 		const tokens = await exchangeAuthorizationCode({
 			baseUrl,
 			clientId,

package/package.json

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

package/src/schemas/order.ts

@@ -12,7 +12,7 @@ export const orderSummarySchema = z.object({
   testPayment: z
     .boolean()
     .describe(
-      "테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았어요. 상품을 발송하지 않도록 주의하세요",
+      "테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았습니다. 상품을 발송하지 않도록 주의하십시오",
     ),
 });
 
@@ -61,7 +61,7 @@ export const orderItemSchema = z.object({
   testPayment: z
     .boolean()
     .describe(
-      "소속 주문이 테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았어요",
+      "소속 주문이 테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았습니다",
     ),
 });
 
@@ -118,7 +118,7 @@ export const orderSchema = z.object({
   testPayment: z
     .boolean()
     .describe(
-      "테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았어요. 상품을 발송하지 않도록 주의하세요",
+      "테스트 결제(샌드박스 결제) 주문인가. true면 실제로 돈이 오가지 않았습니다. 상품을 발송하지 않도록 주의하십시오",
     ),
   items: z.array(orderItemSchema),
 });
@@ -137,7 +137,7 @@ const testPaymentQuery = z
   .enum(["true", "false"])
   .optional()
   .describe(
-    "테스트 결제(샌드박스 결제) 필터. `true`면 테스트 결제만, `false`면 실결제만, 생략하면 전부예요",
+    "테스트 결제(샌드박스 결제) 필터. `true`면 테스트 결제만, `false`면 실결제만, 생략하면 전부입니다",
   );
 
 const pageQuery = {

package/src/schemas/payment.ts

@@ -59,7 +59,7 @@ export const TOSS_WIDGET_CLIENT_KEY_PATTERN = /^(test|live)_gck_/;
 /** 토스페이먼츠 결제위젯 시크릿 키 접두사. {@link TOSS_WIDGET_CLIENT_KEY_PATTERN} 참고 */
 export const TOSS_WIDGET_SECRET_KEY_PATTERN = /^(test|live)_gsk_/;
 /** 결제위젯 키를 거부할 때의 필드 메시지 */
-export const TOSS_WIDGET_KEY_MESSAGE = "결제위젯 키가 아니라 API 개별 연동 키를 입력해주세요";
+export const TOSS_WIDGET_KEY_MESSAGE = "결제위젯 키가 아니라 API 개별 연동 키를 입력해주십시오";
 
 export const tossPaymentsCredentialsInputSchema = z
   .object({
@@ -187,7 +187,7 @@ export const updatePaymentProviderRequestSchema = z
       body.enabled !== undefined ||
       body.sandboxMode !== undefined ||
       body.easyPayProviders !== undefined,
-    { message: "enabled·sandboxMode·easyPayProviders 중 하나는 보내야 해요" },
+    { message: "enabled·sandboxMode·easyPayProviders 중 하나는 보내야 합니다" },
   );
 export type UpdatePaymentProviderRequest = z.infer<typeof updatePaymentProviderRequestSchema>;
 
@@ -221,7 +221,7 @@ export const updatePaymentSettingsRequestSchema = z
       ),
   })
   .refine((body) => body.priority !== undefined || body.checkoutOrigins !== undefined, {
-    message: "priority 또는 checkoutOrigins 중 하나는 보내야 해요",
+    message: "priority 또는 checkoutOrigins 중 하나는 보내야 합니다",
   });
 export type UpdatePaymentSettingsRequest = z.infer<typeof updatePaymentSettingsRequestSchema>;
 

package/src/schemas/product.ts

@@ -284,7 +284,7 @@ const ADDRESS_DESCRIPTIONS = {
 export const productCreateRequestSchema = z
   .object({
     name: z.string().min(1).max(100),
-    categoryId: z.string().min(1, "카테고리를 선택해주세요"),
+    categoryId: z.string().min(1, "카테고리를 선택해주십시오"),
     salePrice: z
       .number()
       .int()

package/src/schemas/store.ts

@@ -68,11 +68,11 @@ export const storeCodeSchema = z
   .string()
   .regex(
     STORE_CODE_PATTERN,
-    "소문자·숫자·하이픈 3~30자여야 하고 하이픈으로 시작하거나 끝날 수 없어요",
+    "소문자·숫자·하이픈 3~30자여야 하고 하이픈으로 시작하거나 끝날 수 없습니다",
   )
   .refine(
     (code) => !isReservedStoreCode(code),
-    "플랫폼이 쓰는 이름이라 스토어 코드로 쓸 수 없어요",
+    "플랫폼이 쓰는 이름이라 스토어 코드로 쓸 수 없습니다",
   );
 
 /** `https://shop.example.com`처럼 경로·쿼리 없는 http(s) 오리진인가 */
@@ -98,7 +98,7 @@ export const analyticsOriginSchema = z
   .string()
   .trim()
   .max(255)
-  .refine(isWebOrigin, "https://shop.example.com 형식(경로 없이)으로 입력해 주세요")
+  .refine(isWebOrigin, "https://shop.example.com 형식(경로 없이)으로 입력해 주십시오")
   .describe("스토어프론트 오리진. 예: `https://shop.example.com`");
 
 /** 허용 오리진 상한 */
@@ -125,7 +125,7 @@ export const policyVersionSchema = z
 export const policyDocumentUrlSchema = z
   .url()
   .max(500)
-  .refine((value) => value.startsWith("https://"), "https 주소만 쓸 수 있어요")
+  .refine((value) => value.startsWith("https://"), "https 주소만 쓸 수 있습니다")
   .nullable();
 
 const autoDeliverDaysDescription =

package/src/session.ts

@@ -203,10 +203,10 @@ export function createStoreSession(options: StoreSessionOptions): StoreSession {
   async function handleCallback(code: string, state: string): Promise<void> {
     const raw = storage.get(STORE_SESSION_KEYS.pkce);
     storage.remove(STORE_SESSION_KEYS.pkce); // 1회용
-    if (!raw) throw new Error("로그인 세션이 만료되었습니다. 다시 시도해주세요");
+    if (!raw) throw new Error("로그인 세션이 만료되었습니다. 다시 시도해주십시오");
     const saved = JSON.parse(raw) as PkceBlob;
     if (saved.state !== state) {
-      throw new Error("state가 일치하지 않습니다. 다시 시도해주세요");
+      throw new Error("state가 일치하지 않습니다. 다시 시도해주십시오");
     }
     const tokens = await exchangeAuthorizationCode({
       baseUrl,