@sayren/store-sdk 0.28.0 → 0.28.1

package/src/schemas/subscription.ts

@@ -1,8 +1,8 @@
 import { z } from "zod";
 
 /**
- * 요금제·구독 — `GET /v1/store/subscription`(스코프 `store:r`). 구독 단위는 스토어다.
- * 결제 수단·청구 금액은 싣지 않는다. 요금제 변경은 셀러 콘솔에서만 한다.
+ * 요금제·구독 — `GET /v1/store/subscription`(스코프 `store:r`). 구독 단위는 상점이다.
+ * 결제 수단·청구 금액은 싣지 않는다. 요금제 변경은 상점 플랫폼에서만 한다.
  */
 
 /** 요금제 코드 — 이름(`plan.name`)이 바뀌어도 코드는 바뀌지 않는다. 값은 추가만 한다 */
@@ -58,7 +58,7 @@ export const subscriptionUsageSchema = z.object({
   adminApiRequests: z
     .number()
     .int()
-    .describe("이번 기간 관리 API 요청 수(API 토큰·앱·에이전트 호출, 셀러 콘솔 제외)"),
+    .describe("이번 기간 관리 API 요청 수(API 토큰·앱·에이전트 호출, 상점 플랫폼 제외)"),
   emails: z.number().int().describe("이번 기간 초대·양도 알림 메일 수(한도 없음, 표시만)"),
   storefrontPreviewMinutes: z.number().int().describe("이번 기간 편집 미리보기 분(끝난 세션)"),
   storefrontBuildMinutes: z.number().int().describe("이번 기간 빌드 분(끝난 빌드)"),
@@ -89,7 +89,7 @@ export const storeSubscriptionSchema = z.object({
   features: z.object({
     adminApi: z.boolean().describe("관리 API(개인 액세스 토큰·외부 앱 토큰 호출)를 쓸 수 있다"),
     analytics: z.boolean().describe("애널리틱스 조회를 쓸 수 있다"),
-    storeClone: z.boolean().describe("더 쓰지 않는다 — 스토어 복제 기능을 없애 항상 false"),
+    storeClone: z.boolean().describe("더 쓰지 않는다 — 상점 복제 기능을 없애 항상 false"),
     removeBadge: z.boolean().describe("더 쓰지 않는다 — 배지 키를 없애 항상 false"),
   }),
   usage: subscriptionUsageSchema,
@@ -123,12 +123,12 @@ export const planErrorDetailsSchema = z
     used: z.number().optional(),
     plan: responsePlanCodeSchema.optional(),
     resetsAt: z.string().optional().describe("월 한도가 초기화되는 시각(ISO 8601)"),
-    upgradeUrl: z.string().optional().describe("요금제 화면 주소(셀러 콘솔)"),
+    upgradeUrl: z.string().optional().describe("요금제 화면 주소(상점 플랫폼)"),
     reason: z
       .string()
       .optional()
       .describe(
-        "스토어 수 한도의 이유 — `OWNED_STORES`(소유 스토어 수). `FREE_STORES`는 더 쓰지 않는다",
+        "상점 수 한도의 이유 — `OWNED_STORES`(소유 상점 수). `FREE_STORES`는 더 쓰지 않는다",
       ),
   })
   .loose();
@@ -138,7 +138,7 @@ const limitOrContract = (description: string) =>
   z.number().int().nullable().describe(`${description}. null이면 계약(엔터프라이즈)·한도 없음`);
 
 /**
- * 요금제 기능 키 값 — 요금제 비교표·콘솔 요금제 화면이 쓴다. 키는 서버 판정의 기능 키와 같다(추가만 한다). 상위 요금제는 하위 요금제
+ * 요금제 기능 키 값 — 요금제 비교표·상점 플랫폼 요금제 화면이 쓴다. 키는 서버 판정의 기능 키와 같다(추가만 한다). 상위 요금제는 하위 요금제
  * 기능을 모두 포함한다
  */
 export const planEntitlementsSchema = z
@@ -146,7 +146,7 @@ export const planEntitlementsSchema = z
     "features.admin_api": z
       .boolean()
       .describe(
-        "관리 API(개인 액세스 토큰·외부 앱 토큰 호출). 셀러 콘솔·CLI·MCP는 모든 요금제에서 쓴다",
+        "관리 API(개인 액세스 토큰·외부 앱 토큰 호출). 상점 플랫폼·CLI·MCP는 모든 요금제에서 쓴다",
       ),
     "features.analytics": z.boolean().describe("애널리틱스 화면·조회 API"),
     "limits.ai_reads_monthly": limitOrContract("MCP 읽기 월 한도"),

package/src/schemas/telemetry.ts

@@ -8,7 +8,7 @@ import { z } from "zod";
  * 세는 것이다. 그 숫자가 규칙과 안내를 고치는 근거가 된다.
  *
  * **보내지 않는 것**: 파일 경로·소스 코드·위반 상세(`detail`)·토큰·사람 식별자. 규칙 id와 개수뿐이다.
- * 테넌트는 요청 토큰이 정한다(본문에 스토어 id가 없다). 옵트아웃은 클라이언트의 `SAYREN_TELEMETRY=0`이다.
+ * 테넌트는 요청 토큰이 정한다(본문에 상점 id가 없다). 옵트아웃은 클라이언트의 `SAYREN_TELEMETRY=0`이다.
  *
  * 알 수 없는 키는 저장하지 않고 버린다(`.strict()`를 쓰지 않는다) — 새 버전 클라이언트가 필드를
  * 하나 더 실었다고 계측 전체가 400으로 날아가면 그 버전의 숫자가 통째로 빈다.
@@ -64,7 +64,7 @@ export const mcpToolEventSchema = z.object({
   results: z
     .array(mcpRuleResultSchema)
     .max(MCP_TELEMETRY_MAX_RESULTS)
-    // 규칙 하나당 한 줄이다. 같은 id를 여러 줄로 실으면 집계가 한 스토어의 한 규칙을 몇 번 세야
+    // 규칙 하나당 한 줄이다. 같은 id를 여러 줄로 실으면 집계가 한 상점의 한 규칙을 몇 번 세야
     // 하는지 정할 수 없고, 상한만큼 같은 규칙을 반복해 보내는 것이 저장을 부풀리는 길이 된다.
     .refine((results) => new Set(results.map((result) => result.ruleId)).size === results.length, {
       message: "같은 규칙 id를 두 번 실을 수 없습니다",

package/src/schemas/upload.ts

@@ -52,7 +52,7 @@ export interface UploadRejection {
 
 /**
  * 용도 제한 위반 여부. 통과하면 `null`.
- * 서버가 던지는 오류와 콘솔이 먼저 띄우는 안내가 갈리지 않도록 한 함수로 판정한다.
+ * 서버가 던지는 오류와 상점 플랫폼이 먼저 띄우는 안내가 갈리지 않도록 한 함수로 판정한다.
  */
 export function uploadRejection(
   purpose: UploadPurpose,

package/src/schemas/webhook-event.ts

@@ -28,7 +28,7 @@ export {
 const envelopeFields = {
   id: z.string().describe("이벤트 ID (`evt_…`, 테스트 전송은 `evt_test_…`). 중복 제거 키"),
   createdAt: z.string().describe("이벤트 발생 일시 (ISO 8601)"),
-  storeId: z.string().describe("이벤트가 발생한 스토어 ID"),
+  storeId: z.string().describe("이벤트가 발생한 상점 ID"),
   sequence: z
     .number()
     .int()

package/src/session.ts

@@ -9,7 +9,7 @@ import {
 import { type MyAccount, myAccountSchema } from "./schemas/auth";
 
 /**
- * SDK 세션 매니저 — 콘솔(액세스 토큰)의 저장·무음 갱신·회전을 캡슐화한다.
+ * SDK 세션 매니저 — 상점 플랫폼(액세스 토큰)의 저장·무음 갱신·회전을 캡슐화한다.
  *
  * 저장 매체(쿠키/localStorage/…)와 그 속성(Max-Age·SameSite·Secure·Path)은 **어댑터(앱) 책임**이다.
  * SDK는 "무엇을 어떤 키로 저장할지"만 알고, "어떻게 저장할지"는 SessionStorage 어댑터에 위임한다.