@sayren/store-sdk 0.14.1 → 0.15.0

package/dist/index.d.mts

@@ -1073,9 +1073,9 @@ export type ApiLogSummary = z.infer<typeof apiLogSummarySchema>;
 //#endregion
 //#region src/schemas/auth.d.ts
 export declare const storeRoleSchema: z.ZodEnum<{
-  OWNER: "OWNER";
   ADMIN: "ADMIN";
   STAFF: "STAFF";
+  OWNER: "OWNER";
 }>;
 export type StoreRole = z.infer<typeof storeRoleSchema>;
 export declare const userTokenResponseSchema: z.ZodObject<{
@@ -1099,9 +1099,9 @@ export declare const storeTokenResponseSchema: z.ZodObject<{
   expires_in: z.ZodNumber;
   storeId: z.ZodString;
   role: z.ZodEnum<{
-    OWNER: "OWNER";
     ADMIN: "ADMIN";
     STAFF: "STAFF";
+    OWNER: "OWNER";
   }>;
   scopes: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
@@ -1111,9 +1111,9 @@ export declare const myStoreSchema: z.ZodObject<{
   storeName: z.ZodString;
   storeCode: z.ZodString;
   role: z.ZodEnum<{
-    OWNER: "OWNER";
     ADMIN: "ADMIN";
     STAFF: "STAFF";
+    OWNER: "OWNER";
   }>;
   status: z.ZodEnum<{
     ACTIVE: "ACTIVE";
@@ -1438,13 +1438,13 @@ export declare const bulkResultSchema: z.ZodObject<{
 export type BulkResult = z.infer<typeof bulkResultSchema>;
 export declare const orderItemStatusSchema: z.ZodEnum<{
   PAID: "PAID";
+  CANCELED: "CANCELED";
   PAYMENT_WAITING: "PAYMENT_WAITING";
   CONFIRMED: "CONFIRMED";
   DISPATCHED: "DISPATCHED";
   DELIVERING: "DELIVERING";
   DELIVERED: "DELIVERED";
   PURCHASE_DECIDED: "PURCHASE_DECIDED";
-  CANCELED: "CANCELED";
 }>;
 export type OrderItemStatus = z.infer<typeof orderItemStatusSchema>;
 export declare const changeTypeSchema: z.ZodEnum<{
@@ -1975,13 +1975,13 @@ export declare const customerOrderSchema: z.ZodObject<{
     quantity: z.ZodNumber;
     status: z.ZodEnum<{
       PAID: "PAID";
+      CANCELED: "CANCELED";
       PAYMENT_WAITING: "PAYMENT_WAITING";
       CONFIRMED: "CONFIRMED";
       DISPATCHED: "DISPATCHED";
       DELIVERING: "DELIVERING";
       DELIVERED: "DELIVERED";
       PURCHASE_DECIDED: "PURCHASE_DECIDED";
-      CANCELED: "CANCELED";
     }>;
     claimStatus: z.ZodNullable<z.ZodEnum<{
       CANCEL_REQUESTED: "CANCEL_REQUESTED";
@@ -2664,13 +2664,13 @@ export declare const orderSummarySchema: z.ZodObject<{
   totalAmount: z.ZodNumber;
   representativeStatus: z.ZodEnum<{
     PAID: "PAID";
+    CANCELED: "CANCELED";
     PAYMENT_WAITING: "PAYMENT_WAITING";
     CONFIRMED: "CONFIRMED";
     DISPATCHED: "DISPATCHED";
     DELIVERING: "DELIVERING";
     DELIVERED: "DELIVERED";
     PURCHASE_DECIDED: "PURCHASE_DECIDED";
-    CANCELED: "CANCELED";
   }>;
   orderedAt: z.ZodString;
   testPayment: z.ZodBoolean;
@@ -2691,13 +2691,13 @@ export declare const orderItemSchema: z.ZodObject<{
   orderId: z.ZodString;
   status: z.ZodEnum<{
     PAID: "PAID";
+    CANCELED: "CANCELED";
     PAYMENT_WAITING: "PAYMENT_WAITING";
     CONFIRMED: "CONFIRMED";
     DISPATCHED: "DISPATCHED";
     DELIVERING: "DELIVERING";
     DELIVERED: "DELIVERED";
     PURCHASE_DECIDED: "PURCHASE_DECIDED";
-    CANCELED: "CANCELED";
   }>;
   claimStatus: z.ZodNullable<z.ZodEnum<{
     CANCEL_REQUESTED: "CANCEL_REQUESTED";
@@ -2800,13 +2800,13 @@ export declare const orderSchema: z.ZodObject<{
     orderId: z.ZodString;
     status: z.ZodEnum<{
       PAID: "PAID";
+      CANCELED: "CANCELED";
       PAYMENT_WAITING: "PAYMENT_WAITING";
       CONFIRMED: "CONFIRMED";
       DISPATCHED: "DISPATCHED";
       DELIVERING: "DELIVERING";
       DELIVERED: "DELIVERED";
       PURCHASE_DECIDED: "PURCHASE_DECIDED";
-      CANCELED: "CANCELED";
     }>;
     claimStatus: z.ZodNullable<z.ZodEnum<{
       CANCEL_REQUESTED: "CANCEL_REQUESTED";
@@ -2861,13 +2861,13 @@ export declare const orderSummaryPageSchema: z.ZodObject<{
     totalAmount: z.ZodNumber;
     representativeStatus: z.ZodEnum<{
       PAID: "PAID";
+      CANCELED: "CANCELED";
       PAYMENT_WAITING: "PAYMENT_WAITING";
       CONFIRMED: "CONFIRMED";
       DISPATCHED: "DISPATCHED";
       DELIVERING: "DELIVERING";
       DELIVERED: "DELIVERED";
       PURCHASE_DECIDED: "PURCHASE_DECIDED";
-      CANCELED: "CANCELED";
     }>;
     orderedAt: z.ZodString;
     testPayment: z.ZodBoolean;
@@ -2885,13 +2885,13 @@ export declare const orderItemPageSchema: z.ZodObject<{
     orderId: z.ZodString;
     status: z.ZodEnum<{
       PAID: "PAID";
+      CANCELED: "CANCELED";
       PAYMENT_WAITING: "PAYMENT_WAITING";
       CONFIRMED: "CONFIRMED";
       DISPATCHED: "DISPATCHED";
       DELIVERING: "DELIVERING";
       DELIVERED: "DELIVERED";
       PURCHASE_DECIDED: "PURCHASE_DECIDED";
-      CANCELED: "CANCELED";
     }>;
     claimStatus: z.ZodNullable<z.ZodEnum<{
       CANCEL_REQUESTED: "CANCEL_REQUESTED";
@@ -2945,13 +2945,13 @@ export declare const orderListQuerySchema: z.ZodObject<{
   orderedTo: z.ZodOptional<z.ZodString>;
   status: z.ZodOptional<z.ZodEnum<{
     PAID: "PAID";
+    CANCELED: "CANCELED";
     PAYMENT_WAITING: "PAYMENT_WAITING";
     CONFIRMED: "CONFIRMED";
     DISPATCHED: "DISPATCHED";
     DELIVERING: "DELIVERING";
     DELIVERED: "DELIVERED";
     PURCHASE_DECIDED: "PURCHASE_DECIDED";
-    CANCELED: "CANCELED";
   }>>;
   keyword: z.ZodOptional<z.ZodString>;
   testPayment: z.ZodOptional<z.ZodEnum<{
@@ -4656,14 +4656,25 @@ export declare const storeMemberSchema: z.ZodObject<{
   name: z.ZodString;
   email: z.ZodEmail;
   role: z.ZodEnum<{
-    OWNER: "OWNER";
     ADMIN: "ADMIN";
     STAFF: "STAFF";
+    OWNER: "OWNER";
   }>;
   joinedAt: z.ZodString;
   lastActiveAt: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type StoreMember = z.infer<typeof storeMemberSchema>;
+/**
+ * 초대 메일 발송 결과 — `SENDING`은 발송 요청 중(결과를 아직 적지 못함), `NOT_CONFIGURED`는 메일 발송이 설정되지 않아
+ * 보내지 않은 것이다. 발송 실패는 초대를 무효로 만들지 않는다 — 재발송으로 다시 보낸다
+ */
+export declare const invitationDeliveryStatusSchema: z.ZodEnum<{
+  FAILED: "FAILED";
+  SENDING: "SENDING";
+  SENT: "SENT";
+  NOT_CONFIGURED: "NOT_CONFIGURED";
+}>;
+export type InvitationDeliveryStatus = z.infer<typeof invitationDeliveryStatusSchema>;
 export declare const invitationSchema: z.ZodObject<{
   invitationId: z.ZodString;
   email: z.ZodEmail;
@@ -4674,21 +4685,48 @@ export declare const invitationSchema: z.ZodObject<{
   status: z.ZodEnum<{
     PENDING: "PENDING";
     EXPIRED: "EXPIRED";
-    CANCELED: "CANCELED";
     ACCEPTED: "ACCEPTED";
+    CANCELED: "CANCELED";
   }>;
   invitedBy: z.ZodString;
   expiresAt: z.ZodString;
   createdAt: z.ZodString;
+  deliveryStatus: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+    FAILED: "FAILED";
+    SENDING: "SENDING";
+    SENT: "SENT";
+    NOT_CONFIGURED: "NOT_CONFIGURED";
+  }>>>;
+  deliveryErrorCode: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  lastSentAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+  sendCount: z.ZodDefault<z.ZodNumber>;
+  acceptedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export type Invitation = z.infer<typeof invitationSchema>;
+/** `POST /v1/store/invitations` 요청 — ADMIN 초대는 OWNER만 할 수 있다 */
+export declare const inviteMemberRequestSchema: z.ZodObject<{
+  email: z.ZodEmail;
+  role: z.ZodEnum<{
+    ADMIN: "ADMIN";
+    STAFF: "STAFF";
+  }>;
+}, z.core.$strip>;
+export type InviteMemberRequest = z.infer<typeof inviteMemberRequestSchema>;
+/** `PATCH /v1/store/members/{userId}` 요청 */
+export declare const updateMemberRoleRequestSchema: z.ZodObject<{
+  role: z.ZodEnum<{
+    ADMIN: "ADMIN";
+    STAFF: "STAFF";
+  }>;
+}, z.core.$strip>;
+export type UpdateMemberRoleRequest = z.infer<typeof updateMemberRoleRequestSchema>;
 /** `GET /v1/store/invitations` 쿼리 — OpenAPI 문서용 형태 */
 export declare const invitationListQuerySchema: z.ZodObject<{
   status: z.ZodOptional<z.ZodEnum<{
     PENDING: "PENDING";
     EXPIRED: "EXPIRED";
-    CANCELED: "CANCELED";
     ACCEPTED: "ACCEPTED";
+    CANCELED: "CANCELED";
   }>>;
 }, z.core.$strip>;
 /** `PATCH /v1/store/members/{userId}` 응답 — 바뀐 역할 */
@@ -4942,7 +4980,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       storeId: string;
       storeName: string;
       storeCode: string;
-      role: "OWNER" | "ADMIN" | "STAFF";
+      role: "ADMIN" | "STAFF" | "OWNER";
       status: "ACTIVE" | "SUSPENDED" | "CLOSED";
     }[]>;
     /** RFC 7009 — token을 폐기한다 (public client는 client_id만 동반) */
@@ -5542,7 +5580,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         ordererName: string;
         itemCount: number;
         totalAmount: number;
-        representativeStatus: "PAID" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
+        representativeStatus: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
         orderedAt: string;
         testPayment: boolean;
       }[];
@@ -5597,7 +5635,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       items: {
         orderItemId: string;
         orderId: string;
-        status: "PAID" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
+        status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
         claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
         productId: string;
         productName: string;
@@ -5656,7 +5694,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       contents: {
         orderItemId: string;
         orderId: string;
-        status: "PAID" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
+        status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
         claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
         productId: string;
         productName: string;
@@ -5741,7 +5779,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
     markDelivered: (orderItemId: string, idempotencyKey?: string) => Promise<{
       orderItemId: string;
       orderId: string;
-      status: "PAID" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
+      status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
       claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
       productId: string;
       productName: string;
@@ -6191,7 +6229,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
           productName: string;
           optionName: string | null;
           quantity: number;
-          status: "PAID" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
+          status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
           claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
         }[];
       }[];
@@ -7961,19 +7999,68 @@ export declare function createStoreClient(options: StoreClientOptions): {
       userId: string;
       name: string;
       email: string;
-      role: "OWNER" | "ADMIN" | "STAFF";
+      role: "ADMIN" | "STAFF" | "OWNER";
       joinedAt: string;
       lastActiveAt: string | null;
     }[]>;
-    listInvitations: () => Promise<{
+    /** `PATCH /v1/store/members/{userId}` — 스코프 `member:rw`. OWNER는 바꿀 수 없고 ADMIN 지정·ADMIN 변경은 OWNER만 한다 */
+    updateMemberRole: (userId: string, body: UpdateMemberRoleRequest) => Promise<{
+      userId: string;
+      role: "ADMIN" | "STAFF";
+    }>;
+    /** `DELETE /v1/store/members/{userId}` (204) — OWNER는 내보낼 수 없고 ADMIN은 OWNER만 내보낸다 */
+    removeMember: (userId: string) => Promise<void>;
+    listInvitations: (params?: {
+      status?: Invitation["status"];
+    }) => Promise<{
       invitationId: string;
       email: string;
       role: "ADMIN" | "STAFF";
-      status: "PENDING" | "EXPIRED" | "CANCELED" | "ACCEPTED";
+      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
       invitedBy: string;
       expiresAt: string;
       createdAt: string;
+      deliveryStatus: "FAILED" | "SENDING" | "SENT" | "NOT_CONFIGURED" | null;
+      deliveryErrorCode: string | null;
+      lastSentAt: string | null;
+      sendCount: number;
+      acceptedAt: string | null;
     }[]>;
+    /**
+     * `POST /v1/store/invitations` (201) — 스코프 `member:rw`. 초대 메일을 보낸다. 발송 결과는 응답의
+     * `deliveryStatus`다(발송이 실패해도 초대는 만들어진다). 스토어·초대한 사람·받는 주소별 발송 한도가 있다(429, `details.limit`).
+     */
+    invite: (body: InviteMemberRequest) => Promise<{
+      invitationId: string;
+      email: string;
+      role: "ADMIN" | "STAFF";
+      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
+      invitedBy: string;
+      expiresAt: string;
+      createdAt: string;
+      deliveryStatus: "FAILED" | "SENDING" | "SENT" | "NOT_CONFIGURED" | null;
+      deliveryErrorCode: string | null;
+      lastSentAt: string | null;
+      sendCount: number;
+      acceptedAt: string | null;
+    }>;
+    /** `POST /v1/store/invitations/{invitationId}/resend` — 새 수락 링크로 다시 보낸다. 이전 링크는 무효가 되고 만료가 다시 7일이 된다 */
+    resendInvitation: (invitationId: string) => Promise<{
+      invitationId: string;
+      email: string;
+      role: "ADMIN" | "STAFF";
+      status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
+      invitedBy: string;
+      expiresAt: string;
+      createdAt: string;
+      deliveryStatus: "FAILED" | "SENDING" | "SENT" | "NOT_CONFIGURED" | null;
+      deliveryErrorCode: string | null;
+      lastSentAt: string | null;
+      sendCount: number;
+      acceptedAt: string | null;
+    }>;
+    /** `DELETE /v1/store/invitations/{invitationId}` (204) — 대기 중 초대를 취소한다 */
+    cancelInvitation: (invitationId: string) => Promise<void>;
   };
 };
 type StoreClient = ReturnType<typeof createStoreClient>;
@@ -8409,13 +8496,13 @@ export declare const orderWebhookEventDataSchema: z.ZodObject<{
   orderId: z.ZodString;
   status: z.ZodEnum<{
     PAID: "PAID";
+    CANCELED: "CANCELED";
     PAYMENT_WAITING: "PAYMENT_WAITING";
     CONFIRMED: "CONFIRMED";
     DISPATCHED: "DISPATCHED";
     DELIVERING: "DELIVERING";
     DELIVERED: "DELIVERED";
     PURCHASE_DECIDED: "PURCHASE_DECIDED";
-    CANCELED: "CANCELED";
   }>;
   testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, z.core.$strip>;
@@ -8477,13 +8564,13 @@ export declare const orderWebhookEventSchema: z.ZodObject<{
     orderId: z.ZodString;
     status: z.ZodEnum<{
       PAID: "PAID";
+      CANCELED: "CANCELED";
       PAYMENT_WAITING: "PAYMENT_WAITING";
       CONFIRMED: "CONFIRMED";
       DISPATCHED: "DISPATCHED";
       DELIVERING: "DELIVERING";
       DELIVERED: "DELIVERED";
       PURCHASE_DECIDED: "PURCHASE_DECIDED";
-      CANCELED: "CANCELED";
     }>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>;
@@ -8574,13 +8661,13 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     orderId: z.ZodString;
     status: z.ZodEnum<{
       PAID: "PAID";
+      CANCELED: "CANCELED";
       PAYMENT_WAITING: "PAYMENT_WAITING";
       CONFIRMED: "CONFIRMED";
       DISPATCHED: "DISPATCHED";
       DELIVERING: "DELIVERING";
       DELIVERED: "DELIVERED";
       PURCHASE_DECIDED: "PURCHASE_DECIDED";
-      CANCELED: "CANCELED";
     }>;
     testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
   }, z.core.$strip>;

package/dist/index.mjs

@@ -3163,10 +3163,21 @@ const storeMemberSchema = z.object({
 	joinedAt: z.string(),
 	lastActiveAt: z.string().nullable()
 });
+/**
+* 초대 메일 발송 결과 — `SENDING`은 발송 요청 중(결과를 아직 적지 못함), `NOT_CONFIGURED`는 메일 발송이 설정되지 않아
+* 보내지 않은 것이다. 발송 실패는 초대를 무효로 만들지 않는다 — 재발송으로 다시 보낸다
+*/
+const invitationDeliveryStatusSchema = z.enum([
+	"SENDING",
+	"SENT",
+	"FAILED",
+	"NOT_CONFIGURED"
+]);
 const invitationSchema = z.object({
 	invitationId: z.string(),
 	email: z.email(),
 	role: z.enum(["ADMIN", "STAFF"]),
+	/** 만료 시각이 지난 대기 초대는 `EXPIRED`로 보인다 */
 	status: z.enum([
 		"PENDING",
 		"ACCEPTED",
@@ -3175,8 +3186,25 @@ const invitationSchema = z.object({
 	]),
 	invitedBy: z.string(),
 	expiresAt: z.string(),
-	createdAt: z.string()
+	createdAt: z.string(),
+	/** 마지막 발송 결과. 발송 기록이 없는 옛 초대는 null */
+	deliveryStatus: invitationDeliveryStatusSchema.nullable().default(null),
+	/**
+	* 발송 실패 코드(`FAILED`일 때). `DELIVERY_UNKNOWN`은 발송 요청 뒤 결과를 적지 못한 경우다(받았는지 모른다 — 재발송한다)
+	*/
+	deliveryErrorCode: z.string().nullable().default(null),
+	lastSentAt: z.string().nullable().default(null),
+	/** 발송 요청 횟수(첫 발송 포함) */
+	sendCount: z.number().int().default(0),
+	acceptedAt: z.string().nullable().default(null)
+});
+/** `POST /v1/store/invitations` 요청 — ADMIN 초대는 OWNER만 할 수 있다 */
+const inviteMemberRequestSchema = z.object({
+	email: z.email(),
+	role: z.enum(["ADMIN", "STAFF"])
 });
+/** `PATCH /v1/store/members/{userId}` 요청 */
+const updateMemberRoleRequestSchema = z.object({ role: z.enum(["ADMIN", "STAFF"]) });
 /** `GET /v1/store/invitations` 쿼리 — OpenAPI 문서용 형태 */
 const invitationListQuerySchema = z.object({ status: invitationSchema.shape.status.optional().describe("초대 상태 필터") });
 /** `PATCH /v1/store/members/{userId}` 응답 — 바뀐 역할 */
@@ -3741,7 +3769,20 @@ list: (params) => storeHttp.request("GET", "/audit-logs", auditLogPageSchema, {
 			*/
 			update: (body) => storeHttp.request("PATCH", "/store", storeSchema, { body: updateStoreRequestSchema.parse(body) }),
 			listMembers: () => storeHttp.request("GET", "/store/members", z.array(storeMemberSchema)),
-			listInvitations: () => storeHttp.request("GET", "/store/invitations", z.array(invitationSchema))
+			/** `PATCH /v1/store/members/{userId}` — 스코프 `member:rw`. OWNER는 바꿀 수 없고 ADMIN 지정·ADMIN 변경은 OWNER만 한다 */
+			updateMemberRole: (userId, body) => storeHttp.request("PATCH", path`/store/members/${userId}`, storeMemberRoleUpdatedSchema, { body: updateMemberRoleRequestSchema.parse(body) }),
+			/** `DELETE /v1/store/members/{userId}` (204) — OWNER는 내보낼 수 없고 ADMIN은 OWNER만 내보낸다 */
+			removeMember: (userId) => storeHttp.requestVoid("DELETE", path`/store/members/${userId}`),
+			listInvitations: (params) => storeHttp.request("GET", "/store/invitations", z.array(invitationSchema), { query: params }),
+			/**
+			* `POST /v1/store/invitations` (201) — 스코프 `member:rw`. 초대 메일을 보낸다. 발송 결과는 응답의
+			* `deliveryStatus`다(발송이 실패해도 초대는 만들어진다). 스토어·초대한 사람·받는 주소별 발송 한도가 있다(429, `details.limit`).
+			*/
+			invite: (body) => storeHttp.request("POST", "/store/invitations", invitationSchema, { body: inviteMemberRequestSchema.parse(body) }),
+			/** `POST /v1/store/invitations/{invitationId}/resend` — 새 수락 링크로 다시 보낸다. 이전 링크는 무효가 되고 만료가 다시 7일이 된다 */
+			resendInvitation: (invitationId) => storeHttp.request("POST", path`/store/invitations/${invitationId}/resend`, invitationSchema),
+			/** `DELETE /v1/store/invitations/{invitationId}` (204) — 대기 중 초대를 취소한다 */
+			cancelInvitation: (invitationId) => storeHttp.requestVoid("DELETE", path`/store/invitations/${invitationId}`)
 		}
 	};
 }
@@ -4172,4 +4213,4 @@ function createStoreSession(options) {
 	};
 }
 //#endregion
-export { APPROVAL_ALREADY_DECIDED_CODE, APPROVAL_REQUIRED_CODE, ApiError, ApprovalPendingError, CASH_RECEIPT_STATUS_VALUES, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_OPTION_GROUPS, MAX_PRODUCT_IMAGES, MAX_VALUES_PER_GROUP, MAX_VARIANTS, MCP_TELEMETRY_MAX_RESULTS, PAYMENT_ROUTING_EXCLUSION_CODES, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, REFUND_POLICY_DEFAULTS, REMOTE_AREA_ZIP_RANGES, RESERVED_STORE_CODES, SHIPPING_POLICY_DEFAULTS, STORE_CODE_PATTERN, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, UPLOAD_PURPOSE_LIMITS, 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, addressChangeRequestListSchema, addressTypeSchema, agentPolicyDecisionSchema, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiClientListQuerySchema, apiClientSchema, apiClientSecretRotatedSchema, apiClientStatusSchema, apiClientTypeSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, apiTokenCreateRequestSchema, apiTokenCreatedSchema, apiTokenSchema, approvalDecisionRequestSchema, approvalListQuerySchema, approvalPageSchema, approvalRequestSchema, approvalStatusSchema, approveClaimResultSchema, auditActorSchema, auditActorTypeSchema, auditLogListQuerySchema, auditLogOutcomeSchema, auditLogPageSchema, auditLogSchema, auditLogSourceSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, cashReceiptSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimReturnAddressSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, clientCredentialsTokenResponseSchema, consentActionSchema, consentKindSchema, consentSourceSchema, createPkcePair, createStoreClient, createStoreSession, customerAddressSchema, customerConsentListQuerySchema, customerConsentSchema, customerConsentStateSchema, customerConsentsSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deliveryBundleKeyOf, deliveryFeeWaiverSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationListQuerySchema, invitationSchema, isReservedStoreCode, isStoreScope, isWebOrigin, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, mcpRuleResultSchema, mcpToolEventSchema, myAccountSchema, myStoreSchema, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionValueRequestSchema, optionValueSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productRefundPolicyOverride, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, proratedRefundBase, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, quoteDelivery, refreshUserToken, refundPolicyPatchSchema, refundPolicySchema, rejectClaimRequestSchema, remoteAreaLabelOf, remoteAreaOf, remoteAreaSchema, remoteSurchargeOf, resolveRefundPolicy, resolveShippingPolicy, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, scopeAccessSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, shippingPolicyPatchSchema, shippingPolicySchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, tossPaymentsCredentialsInputSchema, trackingStageResponseSchema, trackingUpdateResultSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryDetailSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliveryResourceSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookFailureReasonSchema, webhookRedeliverFailedResultSchema, webhookRequestHeaderSchema, webhookRequestSchema, webhookResourceTypeSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema, writeDryRunResultSchema, writePreviewSchema };
+export { APPROVAL_ALREADY_DECIDED_CODE, APPROVAL_REQUIRED_CODE, ApiError, ApprovalPendingError, CASH_RECEIPT_STATUS_VALUES, MAX_ANALYTICS_ALLOWED_ORIGINS, MAX_AUTO_TRANSITION_DAYS, MAX_OPTION_GROUPS, MAX_PRODUCT_IMAGES, MAX_VALUES_PER_GROUP, MAX_VARIANTS, MCP_TELEMETRY_MAX_RESULTS, PAYMENT_ROUTING_EXCLUSION_CODES, PORTONE_CHANNEL_NAME_MAX_LENGTH, PORTONE_MAX_CHANNELS, PORTONE_MIN_CHANNELS, REFUND_POLICY_DEFAULTS, REMOTE_AREA_ZIP_RANGES, RESERVED_STORE_CODES, SHIPPING_POLICY_DEFAULTS, STORE_CODE_PATTERN, STORE_ROLE_SCOPES, STORE_SCOPE_RESOURCES, STORE_SESSION_KEYS, TOSS_WIDGET_CLIENT_KEY_PATTERN, TOSS_WIDGET_KEY_MESSAGE, TOSS_WIDGET_SECRET_KEY_PATTERN, UPLOAD_PURPOSE_LIMITS, 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, addressChangeRequestListSchema, addressTypeSchema, agentPolicyDecisionSchema, analyticsChannelSchema, analyticsCheckoutOutcomeSchema, analyticsCheckoutSchema, analyticsDeviceRowSchema, analyticsDevicesSchema, analyticsFunnelStepSchema, analyticsOriginSchema, analyticsOverviewSchema, analyticsPagesQuerySchema, analyticsPagesSchema, analyticsProductRowSchema, analyticsProductSortSchema, analyticsProductsQuerySchema, analyticsProductsSchema, analyticsRangeQuerySchema, analyticsRealtimeSchema, analyticsSearchQuerySchema, analyticsSearchSchema, analyticsSourceGroupBySchema, analyticsSourceRowSchema, analyticsSourcesQuerySchema, analyticsSourcesSchema, analyticsTotalsSchema, apiClientListQuerySchema, apiClientSchema, apiClientSecretRotatedSchema, apiClientStatusSchema, apiClientTypeSchema, apiLogErrorSchema, apiLogListQuerySchema, apiLogPageSchema, apiLogPrincipalSchema, apiLogPrincipalTypeSchema, apiLogSchema, apiLogStatusFilterSchema, apiLogSummarySchema, apiTokenCreateRequestSchema, apiTokenCreatedSchema, apiTokenSchema, approvalDecisionRequestSchema, approvalListQuerySchema, approvalPageSchema, approvalRequestSchema, approvalStatusSchema, approveClaimResultSchema, auditActorSchema, auditActorTypeSchema, auditLogListQuerySchema, auditLogOutcomeSchema, auditLogPageSchema, auditLogSchema, auditLogSourceSchema, buildAuthorizeUrl, buildQuery, bulkResultSchema, cancelBySellerRequestSchema, cancelBySellerResultSchema, carrierSchema, cashReceiptSchema, categoryAttributeSchema, categoryCreateRequestSchema, categoryDeleteQuerySchema, categoryDeleteStrategySchema, categoryListQuerySchema, categoryPatchRequestSchema, categoryProductSortSchema, categorySchema, categorySearchResultSchema, categoryTreeNodeSchema, categoryWithPathSchema, changeTypeSchema, claimDetailSchema, claimHoldResultSchema, claimListQuerySchema, claimReasonSchema, claimReturnAddressSchema, claimSchema, claimStatusSchema, claimTypeSchema, claimWebhookEventDataSchema, claimWebhookEventSchema, clientCredentialsTokenResponseSchema, consentActionSchema, consentKindSchema, consentSourceSchema, createPkcePair, createStoreClient, createStoreSession, customerAddressSchema, customerConsentListQuerySchema, customerConsentSchema, customerConsentStateSchema, customerConsentsSchema, customerDetailSchema, customerInquiryCategorySchema, customerInquiryListQuerySchema, customerListQuerySchema, customerOrderSchema, customerSortSchema, customerStatsSchema, customerSummarySchema, customerWithdrawalBlockedDetailsSchema, deliveryBundleKeyOf, deliveryFeeWaiverSchema, deliveryInfoSchema, deliveryMethodSchema, deliveryStatusSchema, deliveryTypeSchema, discountRequestSchema, discountSchema, dispatchRequestSchema, easyPayProviderResponseSchema, easyPayProviderSchema, eventTypeSchema, exchangeAuthorizationCode, exchangeStoreTokenViaOAuth, holdOrderItemRequestSchema, inquiryListQuerySchema, inquirySchema, inquiryWebhookEventDataSchema, inquiryWebhookEventSchema, invitationDeliveryStatusSchema, invitationListQuerySchema, invitationSchema, inviteMemberRequestSchema, isReservedStoreCode, isStoreScope, isWebOrigin, liveGateConditionCodeSchema, liveGateConditionSchema, liveGateErrorDetailsSchema, liveGateSchema, loginProviderSchema, loginProviderStatusSchema, loginProviderTestSchema, loginSettingsSchema, maskedSecretSchema, mcpRuleResultSchema, mcpToolEventSchema, myAccountSchema, myStoreSchema, oauthClientRegistrationRequestSchema, oauthClientRegistrationResponseSchema, oauthTokenResponseSchema, optionGroupRequestSchema, optionGroupSchema, optionModelRequestSchema, optionModelSchema, optionValueRequestSchema, optionValueSchema, orderItemListQuerySchema, orderItemMemoResultSchema, orderItemPageSchema, orderItemSchema, orderItemStatusSchema, orderListQuerySchema, orderSchema, orderSummaryPageSchema, orderSummarySchema, orderWebhookEventDataSchema, orderWebhookEventSchema, pageInfoSchema, pageQueryShape, pageSchema, paymentAttemptRecordSchema, paymentAttemptStatusSchema, paymentCredentialSetSchema, paymentListQuerySchema, paymentProviderSchema, paymentProviderVerificationSchema, paymentRecordDetailSchema, paymentRecordPageSchema, paymentRecordSchema, paymentRecordStatusSchema, paymentRefundRecordSchema, paymentSettingsSchema, pgEnvironmentSchema, pgPaymentMethodSchema, pgProviderSchema, pgVerificationResultSchema, policyDocumentUrlSchema, policyVersionSchema, portOneChannelSchema, portOneCredentialsInputSchema, productCreateRequestSchema, productImageRejection, productImageUrlSchema, productListQuerySchema, productOutOfStockWebhookEventDataSchema, productOutOfStockWebhookEventSchema, productPatchRequestSchema, productRefundPolicyOverride, productSchema, productSortSchema, productStatusSchema, productSummarySchema, productVariantRequestSchema, productVariantSchema, proratedRefundBase, purchaseDecisionExtendResultSchema, purchaseDecisionRequestResultSchema, quoteDelivery, refreshUserToken, refundPolicyPatchSchema, refundPolicySchema, rejectClaimRequestSchema, remoteAreaLabelOf, remoteAreaOf, remoteAreaSchema, remoteSurchargeOf, resolveRefundPolicy, resolveShippingPolicy, reviewListQuerySchema, reviewReportResultSchema, reviewSchema, reviewSortSchema, reviewWebhookEventDataSchema, reviewWebhookEventSchema, salesReportGroupBySchema, salesReportQuerySchema, salesReportRowSchema, salesReportSchema, salesTotalsSchema, saveLoginProviderRequestSchema, scopeAccessSchema, sellerAddressListQuerySchema, sellerAddressRequestSchema, sellerAddressSchema, sellerCustomerInquirySchema, settlementDetailQuerySchema, settlementDetailSchema, settlementListQuerySchema, settlementStatusSchema, settlementSummarySchema, settlementWithDetailsSchema, shippingAddressSchema, shippingPolicyPatchSchema, shippingPolicySchema, storeCodeSchema, storeMemberRoleUpdatedSchema, storeMemberSchema, storeRoleSchema, storeSchema, storeScopeResourceSchema, storeTokenResponseSchema, tossPaymentsCredentialsInputSchema, trackingStageResponseSchema, trackingUpdateResultSchema, updateLoginProviderRequestSchema, updateLoginSettingsRequestSchema, updateMemberRoleRequestSchema, updatePaymentProviderRequestSchema, updatePaymentSettingsRequestSchema, updateStoreRequestSchema, uploadExtensionOf, uploadPurposeSchema, uploadRejection, uploadRequestSchema, uploadTicketSchema, upsertPortOneProviderRequestSchema, upsertTossPaymentsProviderRequestSchema, userTokenResponseSchema, variantStockRequestSchema, variantStockSchema, verifyPaymentProviderRequestSchema, webhookCreatedSchema, webhookDeliveryDetailSchema, webhookDeliveryErrorCodeSchema, webhookDeliveryListQuerySchema, webhookDeliveryResourceSchema, webhookDeliverySchema, webhookDeliveryStatusSchema, webhookEventSchema, webhookFailureReasonSchema, webhookRedeliverFailedResultSchema, webhookRequestHeaderSchema, webhookRequestSchema, webhookResourceTypeSchema, webhookSchema, webhookSecretRotatedSchema, webhookStatusSchema, webhookTestRequestSchema, webhookTestResultSchema, withdrawCustomerRequestSchema, writeDryRunResultSchema, writePreviewSchema };

package/package.json

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

package/src/client.ts

@@ -185,13 +185,19 @@ import {
 } from "./schemas/product";
 import {
   type AddressType,
+  type Invitation,
+  type InviteMemberRequest,
   invitationSchema,
+  inviteMemberRequestSchema,
   type SellerAddressRequest,
   sellerAddressRequestSchema,
   sellerAddressSchema,
+  storeMemberRoleUpdatedSchema,
   storeMemberSchema,
   storeSchema,
+  type UpdateMemberRoleRequest,
   type UpdateStoreRequest,
+  updateMemberRoleRequestSchema,
   updateStoreRequestSchema,
 } from "./schemas/store";
 import {
@@ -1145,8 +1151,36 @@ export function createStoreClient(options: StoreClientOptions) {
           body: updateStoreRequestSchema.parse(body),
         }),
       listMembers: () => storeHttp.request("GET", "/store/members", z.array(storeMemberSchema)),
-      listInvitations: () =>
-        storeHttp.request("GET", "/store/invitations", z.array(invitationSchema)),
+      /** `PATCH /v1/store/members/{userId}` — 스코프 `member:rw`. OWNER는 바꿀 수 없고 ADMIN 지정·ADMIN 변경은 OWNER만 한다 */
+      updateMemberRole: (userId: string, body: UpdateMemberRoleRequest) =>
+        storeHttp.request("PATCH", path`/store/members/${userId}`, storeMemberRoleUpdatedSchema, {
+          body: updateMemberRoleRequestSchema.parse(body),
+        }),
+      /** `DELETE /v1/store/members/{userId}` (204) — OWNER는 내보낼 수 없고 ADMIN은 OWNER만 내보낸다 */
+      removeMember: (userId: string) =>
+        storeHttp.requestVoid("DELETE", path`/store/members/${userId}`),
+      listInvitations: (params?: { status?: Invitation["status"] }) =>
+        storeHttp.request("GET", "/store/invitations", z.array(invitationSchema), {
+          query: params as Query,
+        }),
+      /**
+       * `POST /v1/store/invitations` (201) — 스코프 `member:rw`. 초대 메일을 보낸다. 발송 결과는 응답의
+       * `deliveryStatus`다(발송이 실패해도 초대는 만들어진다). 스토어·초대한 사람·받는 주소별 발송 한도가 있다(429, `details.limit`).
+       */
+      invite: (body: InviteMemberRequest) =>
+        storeHttp.request("POST", "/store/invitations", invitationSchema, {
+          body: inviteMemberRequestSchema.parse(body),
+        }),
+      /** `POST /v1/store/invitations/{invitationId}/resend` — 새 수락 링크로 다시 보낸다. 이전 링크는 무효가 되고 만료가 다시 7일이 된다 */
+      resendInvitation: (invitationId: string) =>
+        storeHttp.request(
+          "POST",
+          path`/store/invitations/${invitationId}/resend`,
+          invitationSchema,
+        ),
+      /** `DELETE /v1/store/invitations/{invitationId}` (204) — 대기 중 초대를 취소한다 */
+      cancelInvitation: (invitationId: string) =>
+        storeHttp.requestVoid("DELETE", path`/store/invitations/${invitationId}`),
     },
   };
 }

package/src/schemas/store.ts

@@ -268,18 +268,58 @@ export const storeMemberSchema = z.object({
 
 export type StoreMember = z.infer<typeof storeMemberSchema>;
 
+/**
+ * 초대 메일 발송 결과 — `SENDING`은 발송 요청 중(결과를 아직 적지 못함), `NOT_CONFIGURED`는 메일 발송이 설정되지 않아
+ * 보내지 않은 것이다. 발송 실패는 초대를 무효로 만들지 않는다 — 재발송으로 다시 보낸다
+ */
+export const invitationDeliveryStatusSchema = z.enum([
+  "SENDING",
+  "SENT",
+  "FAILED",
+  "NOT_CONFIGURED",
+]);
+
+export type InvitationDeliveryStatus = z.infer<typeof invitationDeliveryStatusSchema>;
+
 export const invitationSchema = z.object({
   invitationId: z.string(),
   email: z.email(),
   role: z.enum(["ADMIN", "STAFF"]),
+  /** 만료 시각이 지난 대기 초대는 `EXPIRED`로 보인다 */
   status: z.enum(["PENDING", "ACCEPTED", "EXPIRED", "CANCELED"]),
   invitedBy: z.string(),
   expiresAt: z.string(),
   createdAt: z.string(),
+  // 아래 필드는 이슈 #42에서 더했다. 옛 api 응답에는 없으므로 빠지면 기본값으로 읽는다(SDK가 api보다 먼저 올라가도 파싱된다)
+  /** 마지막 발송 결과. 발송 기록이 없는 옛 초대는 null */
+  deliveryStatus: invitationDeliveryStatusSchema.nullable().default(null),
+  /**
+   * 발송 실패 코드(`FAILED`일 때). `DELIVERY_UNKNOWN`은 발송 요청 뒤 결과를 적지 못한 경우다(받았는지 모른다 — 재발송한다)
+   */
+  deliveryErrorCode: z.string().nullable().default(null),
+  lastSentAt: z.string().nullable().default(null),
+  /** 발송 요청 횟수(첫 발송 포함) */
+  sendCount: z.number().int().default(0),
+  acceptedAt: z.string().nullable().default(null),
 });
 
 export type Invitation = z.infer<typeof invitationSchema>;
 
+/** `POST /v1/store/invitations` 요청 — ADMIN 초대는 OWNER만 할 수 있다 */
+export const inviteMemberRequestSchema = z.object({
+  email: z.email(),
+  role: z.enum(["ADMIN", "STAFF"]),
+});
+
+export type InviteMemberRequest = z.infer<typeof inviteMemberRequestSchema>;
+
+/** `PATCH /v1/store/members/{userId}` 요청 */
+export const updateMemberRoleRequestSchema = z.object({
+  role: z.enum(["ADMIN", "STAFF"]),
+});
+
+export type UpdateMemberRoleRequest = z.infer<typeof updateMemberRoleRequestSchema>;
+
 /** `GET /v1/store/invitations` 쿼리 — OpenAPI 문서용 형태 */
 export const invitationListQuerySchema = z.object({
   status: invitationSchema.shape.status.optional().describe("초대 상태 필터"),