@sayren/store-sdk 0.67.0 → 0.69.0

package/src/schemas/subscription.ts

@@ -1,8 +1,7 @@
 import * as z from "zod";
 
 /**
- * 요금제·구독 — `GET /v1/store/subscription`(스코프 `store:r`). 구독 단위는 상점이다.
- * 결제 수단·청구 금액은 싣지 않는다. 요금제 변경은 상점 플랫폼에서만 한다.
+ * 요금제 코드와 요금제 오류의 `error.details`. 요금제 비교표·구독 조회는 공개 계약이 아니다(0.69.0에서 뺐다).
  */
 
 /** 요금제 코드 — 이름(`plan.name`)이 바뀌어도 코드는 바뀌지 않는다. 값은 추가만 한다 */
@@ -22,107 +21,6 @@ export const responsePlanCodeSchema = z
   .describe(planCodeSchema.description ?? "요금제 코드");
 export type ResponsePlanCode = PlanCode | (string & {});
 
-export const subscriptionStatusSchema = z
-  .enum(["ACTIVE", "PAST_DUE", "CANCELED", "INCOMPLETE"])
-  .describe(
-    "구독 상태. `ACTIVE`=이용 중, `PAST_DUE`=결제 실패 후 유예 중, `CANCELED`=해지됨, `INCOMPLETE`=첫 결제 대기",
-  );
-export type SubscriptionStatus = z.infer<typeof subscriptionStatusSchema>;
-
-const limit = (description: string) =>
-  z.number().int().nullable().describe(`${description}. null이면 한도 없음`);
-
-export const subscriptionLimitsSchema = z.object({
-  liveOrdersMonthly: limit("더 쓰지 않는다 — 라이브 주문 수로 요금제를 나누지 않아 항상 null"),
-  seatsIncluded: limit("구성원 석 — 구성원은 모든 요금제에서 무료·무제한이라 null"),
-  aiActionsMonthly: limit("MCP(에이전트) 쓰기(AI 작업) 월 한도"),
-  aiReadsMonthly: limit("MCP(에이전트) 읽기 월 한도"),
-  customDomains: limit("내 도메인 수"),
-  webhooks: limit("웹훅 구독 수(0이면 쓸 수 없다)"),
-  socialProviders: limit("더 쓰지 않는다 — 소셜 로그인 공급자 수로 요금제를 나누지 않아 항상 null"),
-  emailsMonthly: limit("더 쓰지 않는다 — 메일 한도가 없어 항상 null"),
-  storefrontRequestsMonthly: limit("스토어프론트 월 트래픽(요청 수, 넘어도 막지 않고 안내만)"),
-  apiLogRetentionDays: limit("API 로그 보관 일수(0이면 API 로그 없음)"),
-  auditLogRetentionDays: limit("감사 로그 보관 일수"),
-  storefrontPreviewHoursMonthly: limit("스토어프론트 편집 미리보기 월 시간"),
-  storefrontBuildMinutesMonthly: limit("스토어프론트 빌드 월 분"),
-  adminApiRequestsMonthly: limit("관리 API 요청 월 포함량(넘으면 속도만 낮춘다, 주문 처리 제외)"),
-  publicApps: limit("공개 앱(앱 스토어에 게시된 앱) 설치 수").optional(),
-  privateApps: limit("비공개 앱(이 상점 전용 앱) 설치 수(0이면 설치할 수 없다)").optional(),
-});
-export type SubscriptionLimits = z.infer<typeof subscriptionLimitsSchema>;
-
-export const subscriptionUsageSchema = z.object({
-  liveOrders: z.number().int().describe("이번 기간 라이브 주문 수(테스트 결제 주문 제외)"),
-  aiActions: z.number().int().describe("이번 기간 MCP(에이전트) 쓰기(AI 작업) 수"),
-  aiReads: z.number().int().describe("이번 기간 MCP(에이전트) 읽기 수"),
-  storefrontRequests: z.number().int().describe("이번 기간 스토어프론트 요청 수"),
-  adminApiRequests: z
-    .number()
-    .int()
-    .describe("이번 기간 관리 API 요청 수(API 토큰·앱·에이전트 호출, 상점 플랫폼 제외)"),
-  emails: z.number().int().describe("이번 기간 초대·양도 알림 메일 수(한도 없음, 표시만)"),
-  storefrontPreviewMinutes: z.number().int().describe("이번 기간 편집 미리보기 분(끝난 세션)"),
-  storefrontBuildMinutes: z.number().int().describe("이번 기간 빌드 분(끝난 빌드)"),
-  seats: z.number().int().describe("현재 석 수 — 구성원(OWNER 포함) + 대기 중 초대"),
-  customDomains: z.number().int().describe("현재 내 도메인 수(해제한 도메인 제외)"),
-  webhooks: z.number().int().describe("현재 웹훅 구독 수"),
-  publicApps: z.number().int().optional().describe("현재 설치한 공개 앱 수"),
-  privateApps: z.number().int().optional().describe("현재 설치한 비공개 앱 수"),
-});
-export type SubscriptionUsage = z.infer<typeof subscriptionUsageSchema>;
-
-export const storeSubscriptionSchema = z.object({
-  plan: z.object({
-    code: responsePlanCodeSchema,
-    name: z.string().describe("요금제 표시 이름(예: 프로)"),
-  }),
-  status: subscriptionStatusSchema,
-  interval: z
-    .enum(["MONTH"])
-    .nullable()
-    .describe("결제 주기. `MONTH`=월간. 요금을 내지 않는 요금제(베타·무료)는 null"),
-  cancelAtPeriodEnd: z.boolean().describe("기간 끝에 해지 예정인가"),
-  period: z
-    .object({
-      start: z.string().describe("사용량 기간 시작(ISO 8601)"),
-      end: z.string().describe("사용량 기간 끝(ISO 8601, 이 시각에 사용량이 초기화된다)"),
-    })
-    .describe("사용량을 세는 기간. 요금을 내지 않는 요금제는 한국 시간 달력 월이다"),
-  limits: subscriptionLimitsSchema,
-  features: z.object({
-    adminApi: z.boolean().describe("관리 API(개인 액세스 토큰·외부 앱 토큰 호출)를 쓸 수 있다"),
-    analytics: z.boolean().describe("애널리틱스 조회를 쓸 수 있다"),
-    members: z
-      .boolean()
-      .optional()
-      .describe("소유자 외 구성원이 상점에 접근할 수 있다(false면 소유자만, 구성원 목록은 남는다)"),
-    aiAssistant: z
-      .boolean()
-      .optional()
-      .describe("AI 상점 도우미를 쓸 수 있다(false면 새 실행을 시작할 수 없다)"),
-    storeClone: z.boolean().describe("더 쓰지 않는다 — 상점 복제 기능을 없애 항상 false"),
-    removeBadge: z.boolean().describe("더 쓰지 않는다 — 배지 키를 없애 항상 false"),
-  }),
-  usage: subscriptionUsageSchema,
-  aiActions: z
-    .object({
-      limit: z.number().int().nullable(),
-      used: z.number().int(),
-      resetsAt: z.string().describe("한도가 초기화되는 시각(ISO 8601)"),
-    })
-    .describe("AI 작업(MCP 쓰기) 한도 요약 — 에이전트가 남은 작업 수를 판단할 때 쓴다"),
-  aiReads: z
-    .object({
-      limit: z.number().int().nullable(),
-      used: z.number().int(),
-      resetsAt: z.string().describe("한도가 초기화되는 시각(ISO 8601)"),
-    })
-    .describe("MCP 읽기 한도 요약"),
-  salesFeePercent: z.literal(0).describe("판매 수수료(%). 모든 요금제 0이다"),
-});
-export type StoreSubscription = z.infer<typeof storeSubscriptionSchema>;
-
 /**
  * 요금제 한도 오류의 `error.details` — 기존 오류 코드(`STORE_LIMIT_EXCEEDED`·`STOREFRONT_DOMAIN_LIMIT`·`WEBHOOK_LIMIT_EXCEEDED` 등)와
  * 요금제 오류(`PLAN_LIMIT_EXCEEDED`·`PLAN_AI_ACTIONS_EXCEEDED`·`PLAN_AI_READS_EXCEEDED`·`PLAN_FEATURE_REQUIRED`·`PLAN_API_QUOTA_EXCEEDED`)가 같은 형식을 싣는다.

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,
+  },
 };
 
 /** 파일명의 소문자 확장자. 확장자가 없으면 `""` */

package/src/schemas/plans.ts

@@ -1,105 +0,0 @@
-import * as z from "zod";
-import { responsePlanCodeSchema } from "./subscription";
-
-/**
- * 요금제 비교표 — `GET /v1/public/plans`(인증 없음). 요금제마다 가격과 기능 키 값을 준다. 값은 서버가 관리하고(사내 어드민 게시) 언제든
- * 바뀔 수 있으니 코드에 요금제 수치를 두지 않는다. 상점 하나의 구독·사용량은 `subscription.ts`다
- */
-
-const limitOrContract = (description: string) =>
-  z.number().int().nullable().describe(`${description}. null이면 계약(엔터프라이즈)·한도 없음`);
-
-/**
- * 요금제 기능 키 값 — 요금제 비교표·상점 플랫폼 요금제 화면이 쓴다. 키는 서버 판정의 기능 키와 같다(추가만 한다 — 예외는 0.53에서 지운
- * `limits.ai_credits_monthly`). 상위 요금제는 하위 요금제 기능을 모두 포함한다
- */
-export const planEntitlementsSchema = z
-  .object({
-    "features.members": z
-      .boolean()
-      .describe("소유자 외 구성원(관리자·직원)의 초대와 상점 접근. false면 소유자만 쓴다"),
-    "features.admin_api": z
-      .boolean()
-      .describe(
-        "관리 API(개인 액세스 토큰·외부 앱 토큰 호출). 상점 플랫폼·CLI·MCP는 모든 요금제에서 쓴다",
-      ),
-    "features.analytics": z.boolean().describe("애널리틱스 화면·조회 API"),
-    "features.ai_assistant": z
-      .boolean()
-      .optional()
-      .describe("AI 상점 도우미. false면 새 실행을 시작할 수 없다(403 `PLAN_FEATURE_REQUIRED`)"),
-    "limits.ai_reads_monthly": limitOrContract("MCP 읽기 월 한도"),
-    "limits.ai_actions_monthly": limitOrContract(
-      "MCP 쓰기(AI 작업) 월 한도 — 주문 처리는 막지 않는다",
-    ),
-    "limits.custom_domains": limitOrContract("내 도메인 수"),
-    "limits.webhooks": limitOrContract("웹훅 구독 수(0이면 쓸 수 없다)"),
-    "limits.public_apps": limitOrContract("공개 앱(앱 스토어 게시 앱) 설치 수"),
-    "limits.private_apps": limitOrContract(
-      "비공개 앱(이 상점 전용 앱) 설치 수(0이면 설치할 수 없다)",
-    ),
-    "limits.storefront_preview_hours_monthly": limitOrContract("편집 환경 시간(월, 시간)"),
-    "limits.storefront_build_minutes_monthly": limitOrContract("빌드 시간(월, 분)"),
-    "limits.storefront_requests_monthly": limitOrContract(
-      "스토어프론트 월 트래픽(요청 수) — 넘어도 막지 않고 안내만 한다",
-    ),
-    "limits.admin_api_requests_monthly": limitOrContract(
-      "관리 API 월 요청 — 넘으면 속도만 낮춘다(주문 처리 제외)",
-    ),
-    "rate_limit.admin_api": z
-      .number()
-      .nullable()
-      .describe("관리 API 분당 속도 배수(기본 분당 600 × 배수)"),
-    "storefront.cpu_ms": z.number().int().describe("스토어프론트 사이트 요청당 CPU 상한(ms)"),
-    "storefront.subrequests": z
-      .number()
-      .int()
-      .describe("스토어프론트 사이트 요청당 하위 요청 상한"),
-    "storefront.rate_limit_per_minute": z
-      .number()
-      .int()
-      .describe("스토어프론트 남용 방지 요청 속도 상한(사이트당 분당)"),
-    "seats.included": limitOrContract(
-      "포함 구성원 석 — 구성원은 모든 요금제에서 무료·무제한이라 null",
-    ),
-    "retention.analytics_days": z.number().int().describe("애널리틱스 보관 일수"),
-    "retention.api_logs_days": limitOrContract("API 로그 보관 일수(0이면 API 로그 없음)"),
-    "retention.audit_days": limitOrContract("감사 로그 보관 일수"),
-    "support.tier": z
-      .union([z.enum(["COMMUNITY", "EMAIL", "EMAIL_PRIORITY", "DEDICATED", "SLA"]), z.string()])
-      .describe(
-        "지원 등급(`COMMUNITY`·`EMAIL`·`EMAIL_PRIORITY`·`DEDICATED`·`SLA`, 새 등급이 더해질 수 있다)",
-      ),
-  })
-  .describe("요금제 기능 키 값");
-export type PlanEntitlementValues = z.infer<typeof planEntitlementsSchema>;
-
-/** 공개 요금제 한 줄 — `GET /v1/public/plans` */
-export const publicPlanSchema = z.object({
-  code: responsePlanCodeSchema,
-  name: z.string().describe("표시 이름(Free·Pro·프리미엄·엔터프라이즈)"),
-  version: z.number().int().describe("요금제 버전 — 값이 바뀌면 새 버전이 게시된다"),
-  sort: z.number().int(),
-  purchasable: z
-    .boolean()
-    .describe("셀프 결제로 고를 수 있는가(Free·엔터프라이즈는 아니다 — 엔터프라이즈는 계약)"),
-  prices: z.object({
-    currency: z.literal("KRW"),
-    monthly: z.number().int().nullable().describe("월 가격(공급가, 부가세 별도)"),
-    startingAt: z.boolean().describe("「부터」 가격(엔터프라이즈 계약)"),
-    vatIncluded: z
-      .object({
-        monthly: z.number().int().nullable(),
-      })
-      .describe("표시 가격(부가세 포함) — 요금제 비교표는 이 값을 보인다"),
-  }),
-  entitlements: planEntitlementsSchema,
-});
-export type PublicPlan = z.infer<typeof publicPlanSchema>;
-
-/** 요금제 비교표 — `GET /v1/public/plans`(인증 없음, 캐시 가능). 값은 서버가 관리하고 언제든 바뀔 수 있다 */
-export const publicPlansSchema = z.object({
-  vatPercent: z.number().int().describe("부가세율(%)"),
-  plans: z.array(publicPlanSchema).describe("공개 요금제의 지금 버전 — 정렬 순"),
-});
-export type PublicPlans = z.infer<typeof publicPlansSchema>;