@sayren/store-sdk 0.66.0 → 0.68.0

package/dist/index.d.mts

@@ -9311,6 +9311,7 @@ export declare const customerDetailSchema: z$1.ZodObject<{
   joinedAt: z$1.ZodString;
   point: z$1.ZodNumber;
   marketingAgreed: z$1.ZodBoolean;
+  lockedUntil: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>>;
   loginMethods: z$1.ZodArray<z$1.ZodObject<{
     method: z$1.ZodEnum<{
       kakao: "kakao";
@@ -16796,6 +16797,7 @@ export declare const updateStoreRequestSchema: z$1.ZodObject<{
   privacyOfficerEmail: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodEmail>>;
   name: z$1.ZodOptional<z$1.ZodString>;
   logoUrl: z$1.ZodOptional<z$1.ZodURL>;
+  iconUrl: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodURL>>;
   customerCenterPhone: z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>;
   businessHours: z$1.ZodOptional<z$1.ZodString>;
 }, z$1.core.$strip>;
@@ -16889,6 +16891,7 @@ export declare const storeSchema: z$1.ZodObject<{
     ACTIVE: "ACTIVE";
   }>;
   logoUrl: z$1.ZodNullable<z$1.ZodURL>;
+  iconUrl: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodNullable<z$1.ZodString>>>;
   businessNumber: z$1.ZodNullable<z$1.ZodString>;
   customerCenterPhone: z$1.ZodNullable<z$1.ZodString>;
 }, z$1.core.$strip>;
@@ -18580,12 +18583,14 @@ export type SetStorefrontDeployApprovalRequest = z$1.infer<typeof setStorefrontD
  * - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
  * - `flow-attachment`: 주문 흐름 행동의 첨부(시안 등, 이슈 #115). 구매자에게 보이므로 정지 이미지와 PDF만 받는다.
  * - `ai-attachment`: 상점 플랫폼 AI 채팅에 붙이는 자료(이슈 #124). 모델이 읽는 정지 이미지와 PDF만 받는다.
+ * - `store-icon`: 상점 아이콘(정사각, 이슈 #400). 메일에도 실리므로 메일 클라이언트가 그리는 PNG·JPG만 받는다.
  */
 export declare const uploadPurposeSchema: z$1.ZodEnum<{
   description: "description";
   "product-image": "product-image";
   "flow-attachment": "flow-attachment";
   "ai-attachment": "ai-attachment";
+  "store-icon": "store-icon";
 }>;
 export type UploadPurpose = z$1.infer<typeof uploadPurposeSchema>;
 export interface UploadPurposeLimit {
@@ -18627,6 +18632,7 @@ export declare const uploadRequestSchema: z$1.ZodObject<{
     "product-image": "product-image";
     "flow-attachment": "flow-attachment";
     "ai-attachment": "ai-attachment";
+    "store-icon": "store-icon";
   }>>;
   size: z$1.ZodOptional<z$1.ZodNumber>;
 }, z$1.core.$strip>;
@@ -22766,6 +22772,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       joinedAt: string;
       point: number;
       marketingAgreed: boolean;
+      lockedUntil: string | null;
       loginMethods: {
         method: "kakao" | "naver" | "google" | "password";
         linkedAt: string;
@@ -22860,6 +22867,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       joinedAt: string;
       point: number;
       marketingAgreed: boolean;
+      lockedUntil: string | null;
       loginMethods: {
         method: "kakao" | "naver" | "google" | "password";
         linkedAt: string;
@@ -23004,6 +23012,103 @@ export declare function createStoreClient(options: StoreClientOptions): {
       };
       source?: string | undefined;
     }[]>;
+    /** 비밀번호 재설정 메일 보내기(#400) — 구매자가 메일 링크에서 새 비밀번호를 정한다. 상점 플랫폼 OWNER·ADMIN */
+    sendPasswordReset: (customerId: string) => Promise<void>;
+    /** 로그인 잠금 해제 — 비밀번호 연속 실패 잠금과 실패 횟수를 지운다(멱등). 상점 플랫폼 OWNER·ADMIN */
+    unlock: (customerId: string) => Promise<{
+      customerId: string;
+      name: string;
+      email: string | null;
+      phone: string | null;
+      joinedAt: string;
+      point: number;
+      marketingAgreed: boolean;
+      lockedUntil: string | null;
+      loginMethods: {
+        method: "kakao" | "naver" | "google" | "password";
+        linkedAt: string;
+      }[];
+      consents: {
+        terms: {
+          kind: "TERMS" | "PRIVACY" | "MARKETING";
+          agreed: boolean;
+          agreedVersion: string | null;
+          currentVersion: string | null;
+          currentDocumentUrl: string | null;
+          updatedAt: string | null;
+          reconsentRequired: boolean;
+        };
+        privacy: {
+          kind: "TERMS" | "PRIVACY" | "MARKETING";
+          agreed: boolean;
+          agreedVersion: string | null;
+          currentVersion: string | null;
+          currentDocumentUrl: string | null;
+          updatedAt: string | null;
+          reconsentRequired: boolean;
+        };
+        marketing: {
+          kind: "TERMS" | "PRIVACY" | "MARKETING";
+          agreed: boolean;
+          agreedVersion: string | null;
+          currentVersion: string | null;
+          currentDocumentUrl: string | null;
+          updatedAt: string | null;
+          reconsentRequired: boolean;
+        };
+        reconsentRequired: boolean;
+      };
+      addresses: {
+        addressId: string;
+        alias: string;
+        isDefault: boolean;
+        receiverName: string;
+        phone: string;
+        zipCode: string;
+        address1: string;
+        address2: string | null;
+        countryCode: string;
+        city: string | null;
+        region: string | null;
+      }[];
+      stats: {
+        orderCount: number;
+        totalPaid: number;
+        lastOrderedAt: string | null;
+        canceledOrReturnedCount: number;
+        reviewCount: number;
+        inquiryCount: number;
+      };
+      userinfo?: {
+        sub: string;
+        name?: string | undefined;
+        given_name?: string | undefined;
+        family_name?: string | undefined;
+        middle_name?: string | undefined;
+        nickname?: string | undefined;
+        preferred_username?: string | undefined;
+        profile?: string | undefined;
+        picture?: string | undefined;
+        website?: string | undefined;
+        email?: string | undefined;
+        email_verified?: boolean | undefined;
+        gender?: string | undefined;
+        birthdate?: string | undefined;
+        zoneinfo?: string | undefined;
+        locale?: string | undefined;
+        phone_number?: string | undefined;
+        phone_number_verified?: boolean | undefined;
+        address?: {
+          formatted?: string | undefined;
+          street_address?: string | undefined;
+          locality?: string | undefined;
+          region?: string | undefined;
+          postal_code?: string | undefined;
+          country?: string | undefined;
+        } | undefined;
+        updated_at?: number | undefined;
+      } | undefined;
+    }>;
     withdraw: (customerId: string, body: WithdrawCustomerRequest) => Promise<void>;
   };
   /** 쿠폰 (이슈 #47) — 조회 `promotion:r`, 쓰기 `promotion:rw` */
@@ -29141,6 +29246,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       storefrontUrl: string | null;
       status: "SUSPENDED" | "CLOSED" | "ACTIVE";
       logoUrl: string | null;
+      iconUrl: string | null;
       businessNumber: string | null;
       customerCenterPhone: string | null;
     }>;
@@ -29199,6 +29305,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       storefrontUrl: string | null;
       status: "SUSPENDED" | "CLOSED" | "ACTIVE";
       logoUrl: string | null;
+      iconUrl: string | null;
       businessNumber: string | null;
       customerCenterPhone: string | null;
     }>;

package/dist/index.mjs

@@ -1365,6 +1365,7 @@ const autoConfirmDaysDescription = "배송완료 후 자동 구매확정까지
 const updateStoreRequestSchema = strictRequest(z$1.object({
 	name: z$1.string().min(2).max(50).optional(),
 	logoUrl: z$1.url().optional(),
+	iconUrl: z$1.url().nullable().optional().describe("상점 아이콘(정사각, https) — 구매자 비밀번호 재설정 메일·화면에 보인다. `null`을 주면 지운다(상점 이름 첫 글자로 보인다)"),
 	customerCenterPhone: z$1.string().nullable().optional().describe("고객센터 전화번호. `null`을 주면 지운다"),
 	businessHours: z$1.string().max(100).optional(),
 	...businessInfoPatchShape,
@@ -1393,6 +1394,7 @@ const storeSchema = z$1.object({
 		"CLOSED"
 	]),
 	logoUrl: z$1.url().nullable(),
+	iconUrl: z$1.string().nullable().optional().default(null).describe("상점 아이콘(정사각). 없으면 null. 서버는 항상 싣는다"),
 	businessNumber: z$1.string().nullable().describe("사업자등록번호(숫자 10자리). 없으면 null"),
 	customerCenterPhone: z$1.string().nullable(),
 	...businessInfoResponseShape,
@@ -4407,12 +4409,14 @@ const setCalendarRequestSchema = strictRequest(z$1.object({
 * - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
 * - `flow-attachment`: 주문 흐름 행동의 첨부(시안 등, 이슈 #115). 구매자에게 보이므로 정지 이미지와 PDF만 받는다.
 * - `ai-attachment`: 상점 플랫폼 AI 채팅에 붙이는 자료(이슈 #124). 모델이 읽는 정지 이미지와 PDF만 받는다.
+* - `store-icon`: 상점 아이콘(정사각, 이슈 #400). 메일에도 실리므로 메일 클라이언트가 그리는 PNG·JPG만 받는다.
 */
 const uploadPurposeSchema = z$1.enum([
 	"product-image",
 	"description",
 	"flow-attachment",
-	"ai-attachment"
+	"ai-attachment",
+	"store-icon"
 ]);
 const MB = 1048576;
 /**
@@ -4470,6 +4474,14 @@ const UPLOAD_PURPOSE_LIMITS = {
 			"pdf"
 		],
 		maxBytes: 10 * MB
+	},
+	"store-icon": {
+		extensions: [
+			"jpg",
+			"jpeg",
+			"png"
+		],
+		maxBytes: 5 * MB
 	}
 };
 /** 파일명의 소문자 확장자. 확장자가 없으면 `""` */
@@ -10327,6 +10339,7 @@ const customerDetailSchema = z$1.object({
 	joinedAt: z$1.string(),
 	point: z$1.number().int(),
 	marketingAgreed: z$1.boolean(),
+	lockedUntil: z$1.string().nullable().optional().default(null).describe("로그인 잠금이 풀리는 시각(ISO 8601). 비밀번호를 5회 연속 틀리면 10분 잠긴다. 잠겨 있지 않으면 null. `POST /v1/customers/{customerId}/unlock`으로 바로 풀 수 있다. 서버는 항상 싣는다"),
 	loginMethods: z$1.array(z$1.object({
 		method: z$1.enum([
 			"password",
@@ -11069,7 +11082,7 @@ const paymentRecordSchema = z$1.object({
 	status: paymentRecordStatusSchema,
 	amount: z$1.number().int().describe("결제 금액"),
 	refundedAmount: z$1.number().int().describe("환불 완료 금액 합계. 실패한 환불은 빼고 센다"),
-	heldRefundAmount: z$1.number().int().optional().default(0).describe("환불 대기 금액 합계(#115) — 주문만 취소하고 아직 환불하지 않은 몫. 결제 상세에서 환불 처리한다"),
+	heldRefundAmount: z$1.number().int().optional().default(0).describe("환불 대기 금액 합계(#115) — 주문만 취소하고 아직 환불하지 않은 몫(`HELD`)과 다시 요청할 수 있는 실패 환불(`FAILED`, 결제 잔액 안의 것). 결제 상세에서 환불 처리한다"),
 	provider: pgProviderResponseSchema.nullable().describe("승인한 PG. 승인 전에 끝났으면 마지막 시도의 PG"),
 	method: pgPaymentMethodSchema.nullable().describe("실제 결제수단. 모르면 요청 수단"),
 	easyPayProvider: easyPayProviderResponseSchema.nullable().optional().default(null).describe("간편결제사. `method`가 `EASY_PAY`일 때만 값이 있고, PG가 알려 주지 않았으면 요청한 간편결제사다. 그 밖의 결제수단과 간편결제 이전 결제는 null. 서버는 항상 싣는다. 현재 값은 `NAVERPAY`·`KAKAOPAY`·`TOSSPAY`·`PAYCO`이고 값이 추가될 수 있어 문자열로 받는다"),
@@ -11133,7 +11146,7 @@ const paymentListQuerySchema = z$1.object({
 	method: z$1.string().optional().describe("실제 결제수단 필터"),
 	keyword: z$1.string().optional().describe("결제 id·주문 id·PG 거래 id·시도 id·PG 주문번호(일치), 구매자명(포함)"),
 	includeTest: z$1.string().optional().describe("테스트 결제 포함 여부 (`true`·`false`. 기본 false — 실결제만)"),
-	refundHeld: z$1.string().optional().describe("`true`면 환불 대기가 있는 결제만(#115)"),
+	refundHeld: z$1.string().optional().describe("`true`면 환불 대기(`heldRefundAmount` > 0)가 있는 결제만(#115). 다시 요청할 수 있는 실패 환불도 포함한다"),
 	page: z$1.string().optional().describe("페이지 번호 (1부터)"),
 	size: z$1.string().optional().describe("페이지 크기 (기본 20, 최대 100)")
 });
@@ -12651,6 +12664,10 @@ listHistory: (params) => storeHttp.request("GET", "/points/history", pageSchema(
 			consents: (customerId, params) => storeHttp.request("GET", path`/customers/${customerId}/consents`, pageSchema(customerConsentSchema), { query: params }),
 			/** 보유 쿠폰 (이슈 #47) — 최근 지급 순, 최대 500장 */
 			coupons: (customerId) => storeHttp.request("GET", path`/customers/${customerId}/coupons`, z$1.array(customerCouponSchema)),
+			/** 비밀번호 재설정 메일 보내기(#400) — 구매자가 메일 링크에서 새 비밀번호를 정한다. 상점 플랫폼 OWNER·ADMIN */
+			sendPasswordReset: (customerId) => storeHttp.requestVoid("POST", path`/customers/${customerId}/password-reset`),
+			/** 로그인 잠금 해제 — 비밀번호 연속 실패 잠금과 실패 횟수를 지운다(멱등). 상점 플랫폼 OWNER·ADMIN */
+			unlock: (customerId) => storeHttp.request("POST", path`/customers/${customerId}/unlock`, customerDetailSchema),
 			withdraw: (customerId, body) => storeHttp.requestVoid("POST", path`/customers/${customerId}/withdraw`, { body: withdrawCustomerRequestSchema.parse(body) })
 		},
 		/** 쿠폰 (이슈 #47) — 조회 `promotion:r`, 쓰기 `promotion:rw` */

package/package.json

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

package/src/client.ts

@@ -1603,6 +1603,12 @@ export function createStoreClient(options: StoreClientOptions) {
           path`/customers/${customerId}/coupons`,
           z.array(customerCouponSchema),
         ),
+      /** 비밀번호 재설정 메일 보내기(#400) — 구매자가 메일 링크에서 새 비밀번호를 정한다. 상점 플랫폼 OWNER·ADMIN */
+      sendPasswordReset: (customerId: string) =>
+        storeHttp.requestVoid("POST", path`/customers/${customerId}/password-reset`),
+      /** 로그인 잠금 해제 — 비밀번호 연속 실패 잠금과 실패 횟수를 지운다(멱등). 상점 플랫폼 OWNER·ADMIN */
+      unlock: (customerId: string) =>
+        storeHttp.request("POST", path`/customers/${customerId}/unlock`, customerDetailSchema),
       withdraw: (customerId: string, body: WithdrawCustomerRequest) =>
         storeHttp.requestVoid("POST", path`/customers/${customerId}/withdraw`, {
           body: withdrawCustomerRequestSchema.parse(body),

package/src/schemas/customer.ts

@@ -236,6 +236,15 @@ export const customerDetailSchema = z.object({
   joinedAt: z.string(),
   point: z.number().int(),
   marketingAgreed: z.boolean(),
+  lockedUntil: z
+    .string()
+    .nullable()
+    .optional()
+    .default(null)
+    .describe(
+      "로그인 잠금이 풀리는 시각(ISO 8601). 비밀번호를 5회 연속 틀리면 10분 잠긴다. 잠겨 있지 않으면 null. " +
+        "`POST /v1/customers/{customerId}/unlock`으로 바로 풀 수 있다. 서버는 항상 싣는다",
+    ),
   loginMethods: z
     .array(
       z.object({

package/src/schemas/payment.ts

@@ -813,7 +813,7 @@ export const paymentRecordSchema = z.object({
     .optional()
     .default(0)
     .describe(
-      "환불 대기 금액 합계(#115) — 주문만 취소하고 아직 환불하지 않은 몫. 결제 상세에서 환불 처리한다",
+      "환불 대기 금액 합계(#115) — 주문만 취소하고 아직 환불하지 않은 몫(`HELD`)과 다시 요청할 수 있는 실패 환불(`FAILED`, 결제 잔액 안의 것). 결제 상세에서 환불 처리한다",
     ),
   provider: pgProviderResponseSchema
     .nullable()
@@ -974,7 +974,12 @@ export const paymentListQuerySchema = z.object({
     .string()
     .optional()
     .describe("테스트 결제 포함 여부 (`true`·`false`. 기본 false — 실결제만)"),
-  refundHeld: z.string().optional().describe("`true`면 환불 대기가 있는 결제만(#115)"),
+  refundHeld: z
+    .string()
+    .optional()
+    .describe(
+      "`true`면 환불 대기(`heldRefundAmount` > 0)가 있는 결제만(#115). 다시 요청할 수 있는 실패 환불도 포함한다",
+    ),
   page: z.string().optional().describe("페이지 번호 (1부터)"),
   size: z.string().optional().describe("페이지 크기 (기본 20, 최대 100)"),
 });

package/src/schemas/store.ts

@@ -233,6 +233,13 @@ export const updateStoreRequestSchema = strictRequest(
     .object({
       name: z.string().min(2).max(50).optional(),
       logoUrl: z.url().optional(),
+      iconUrl: z
+        .url()
+        .nullable()
+        .optional()
+        .describe(
+          "상점 아이콘(정사각, https) — 구매자 비밀번호 재설정 메일·화면에 보인다. `null`을 주면 지운다(상점 이름 첫 글자로 보인다)",
+        ),
       customerCenterPhone: z
         .string()
         .nullable()
@@ -332,6 +339,12 @@ export const storeSchema = z.object({
     .describe("스토어프론트 호스팅 사이트의 대표 주소. 사이트가 없으면 null"),
   status: z.enum(["ACTIVE", "SUSPENDED", "CLOSED"]),
   logoUrl: z.url().nullable(),
+  iconUrl: z
+    .string()
+    .nullable()
+    .optional()
+    .default(null)
+    .describe("상점 아이콘(정사각). 없으면 null. 서버는 항상 싣는다"),
   businessNumber: z.string().nullable().describe("사업자등록번호(숫자 10자리). 없으면 null"),
   customerCenterPhone: z.string().nullable(),
   ...businessInfoResponseShape,

package/src/schemas/upload.ts

@@ -8,12 +8,14 @@ import { strictRequest } from "./strict";
  * - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
  * - `flow-attachment`: 주문 흐름 행동의 첨부(시안 등, 이슈 #115). 구매자에게 보이므로 정지 이미지와 PDF만 받는다.
  * - `ai-attachment`: 상점 플랫폼 AI 채팅에 붙이는 자료(이슈 #124). 모델이 읽는 정지 이미지와 PDF만 받는다.
+ * - `store-icon`: 상점 아이콘(정사각, 이슈 #400). 메일에도 실리므로 메일 클라이언트가 그리는 PNG·JPG만 받는다.
  */
 export const uploadPurposeSchema = z.enum([
   "product-image",
   "description",
   "flow-attachment",
   "ai-attachment",
+  "store-icon",
 ]);
 
 export type UploadPurpose = z.infer<typeof uploadPurposeSchema>;
@@ -51,6 +53,10 @@ export const UPLOAD_PURPOSE_LIMITS: Record<UploadPurpose, UploadPurposeLimit> =
     extensions: ["jpg", "jpeg", "png", "webp", "gif", "pdf"],
     maxBytes: 10 * MB,
   },
+  "store-icon": {
+    extensions: ["jpg", "jpeg", "png"],
+    maxBytes: 5 * MB,
+  },
 };
 
 /** 파일명의 소문자 확장자. 확장자가 없으면 `""` */