@sayren/store-sdk 0.36.0 → 0.37.1

package/src/client.ts

@@ -280,6 +280,7 @@ import {
   type VerifyPaymentProviderRequest,
   verifyPaymentProviderRequestSchema,
 } from "./schemas/payment";
+import { publicPlansSchema } from "./schemas/plans";
 import {
   customerPointsSchema,
   type PointAdjustmentRequest,
@@ -369,12 +370,14 @@ import {
   addStorefrontDomainRequestSchema,
   type ChangeStorefrontSlugRequest,
   type ChangeStorefrontTemplateRequest,
+  type ConnectStorefrontGitRequest,
   type CreateStorefrontEditPreviewLinkRequest,
   type CreateStorefrontPreviewLinkRequest,
   type CreateStorefrontSiteRequest,
   type CreateStorefrontVersionRequest,
   changeStorefrontSlugRequestSchema,
   changeStorefrontTemplateRequestSchema,
+  connectStorefrontGitRequestSchema,
   createStorefrontEditPreviewLinkRequestSchema,
   createStorefrontPreviewLinkRequestSchema,
   createStorefrontSiteRequestSchema,
@@ -383,6 +386,8 @@ import {
   type DisableStorefrontHostingRequest,
   deleteStorefrontFileRequestSchema,
   disableStorefrontHostingRequestSchema,
+  type LinkStorefrontGitInstallationRequest,
+  linkStorefrontGitInstallationRequestSchema,
   type MoveStorefrontFileRequest,
   moveStorefrontFileRequestSchema,
   type PublishStorefrontVersionRequest,
@@ -394,8 +399,10 @@ import {
   rollbackStorefrontRequestSchema,
   runStorefrontCheckRequestSchema,
   type SearchStorefrontFilesRequest,
+  type SetStorefrontDeployApprovalRequest,
   type SetStorefrontVisibilityRequest,
   searchStorefrontFilesRequestSchema,
+  setStorefrontDeployApprovalRequestSchema,
   setStorefrontVisibilityRequestSchema,
   storefrontBuildSchema,
   storefrontCheckSchema,
@@ -407,6 +414,9 @@ import {
   storefrontFileMoveResultSchema,
   storefrontFileSearchResultSchema,
   storefrontFileWriteResultSchema,
+  storefrontGitConnectStateSchema,
+  storefrontGitRepositorySchema,
+  storefrontGitStatusSchema,
   storefrontHostingSchema,
   storefrontPreviewLinkSchema,
   storefrontSiteDomainSchema,
@@ -430,7 +440,7 @@ import {
   type WriteStorefrontFilesRequest,
   writeStorefrontFilesRequestSchema,
 } from "./schemas/storefront-hosting";
-import { publicPlansSchema, storeSubscriptionSchema } from "./schemas/subscription";
+import { storeSubscriptionSchema } from "./schemas/subscription";
 import {
   type UploadPurpose,
   type UploadRequest,
@@ -2327,6 +2337,43 @@ export function createStoreClient(options: StoreClientOptions) {
         storeHttp.request("PUT", "/storefront/site/source", storefrontSourceReplacedSchema, {
           body: replaceStorefrontSourceRequestSchema.parse(body),
         }),
+      /** `PUT /v1/storefront/site/deploy-approval` — 승인 없이 배포(상점 플랫폼 OWNER·ADMIN 전용) */
+      setDeployApproval: (body: SetStorefrontDeployApprovalRequest) =>
+        storeHttp.request("PUT", "/storefront/site/deploy-approval", storefrontSiteSchema, {
+          body: setStorefrontDeployApprovalRequestSchema.parse(body),
+        }),
+      /** `GET /v1/storefront/site/git` — Git 원천(발행 소스를 둔 저장소)과 상태(#138) */
+      getGit: () => storeHttp.request("GET", "/storefront/site/git", storefrontGitStatusSchema),
+      /** `POST /v1/storefront/site/git/installations/state` — GitHub 설치 화면에 싣는 1회용 state(상점 플랫폼 전용) */
+      createGitConnectState: () =>
+        storeHttp.request(
+          "POST",
+          "/storefront/site/git/installations/state",
+          storefrontGitConnectStateSchema,
+        ),
+      /** `POST /v1/storefront/site/git/installations` — GitHub App 설치 확인(상점 플랫폼 전용) → 그 설치의 저장소 */
+      linkGitInstallation: (body: LinkStorefrontGitInstallationRequest) =>
+        storeHttp.request(
+          "POST",
+          "/storefront/site/git/installations",
+          z.array(storefrontGitRepositorySchema),
+          { body: linkStorefrontGitInstallationRequestSchema.parse(body) },
+        ),
+      /** `GET /v1/storefront/site/git/installations/{installationId}/repositories` — 확인한 설치의 저장소(상점 플랫폼 전용) */
+      listGitRepositories: (installationId: number) =>
+        storeHttp.request(
+          "GET",
+          `/storefront/site/git/installations/${encodeURIComponent(String(installationId))}/repositories`,
+          z.array(storefrontGitRepositorySchema),
+        ),
+      /** `POST /v1/storefront/site/git/connect` — 셀러 GitHub 저장소 연결(상점 플랫폼 전용) */
+      connectGit: (body: ConnectStorefrontGitRequest) =>
+        storeHttp.request("POST", "/storefront/site/git/connect", storefrontGitStatusSchema, {
+          body: connectStorefrontGitRequestSchema.parse(body),
+        }),
+      /** `POST /v1/storefront/site/git/disconnect` — 연결 해제(sayren 저장소로 되돌림, 상점 플랫폼 전용) */
+      disconnectGit: () =>
+        storeHttp.request("POST", "/storefront/site/git/disconnect", storefrontGitStatusSchema),
     },
 
     subscription: {

package/src/index.ts

@@ -42,6 +42,7 @@ export * from "./schemas/market";
 export * from "./schemas/misc";
 export * from "./schemas/order";
 export * from "./schemas/payment";
+export * from "./schemas/plans";
 export * from "./schemas/points";
 export * from "./schemas/product";
 export * from "./schemas/product-info";

package/src/schemas/plans.ts

@@ -0,0 +1,104 @@
+import { z } from "zod";
+import { responsePlanCodeSchema } from "./subscription";
+
+/**
+ * 요금제 비교표 — `GET /v1/public/plans`(인증 없음). 요금제마다 가격과 기능 키 값을 준다. 값은 서버가 관리하고(사내 어드민 게시) 언제든
+ * 바뀔 수 있으니 코드에 요금제 수치를 두지 않는다. 상점 하나의 구독·사용량은 `subscription.ts`다
+ */
+
+const limitOrContract = (description: string) =>
+  z.number().int().nullable().describe(`${description}. null이면 계약(엔터프라이즈)·한도 없음`);
+
+/**
+ * 요금제 기능 키 값 — 요금제 비교표·상점 플랫폼 요금제 화면이 쓴다. 키는 서버 판정의 기능 키와 같다(추가만 한다). 상위 요금제는 하위 요금제
+ * 기능을 모두 포함한다
+ */
+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"),
+    "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.ai_credits_monthly": limitOrContract(
+      "AI 상점 도우미 월 크레딧(1 크레딧 = 모델 원가 $0.01, 이월 없음)",
+    ),
+    "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>;

package/src/schemas/storefront-hosting.ts

@@ -46,7 +46,8 @@ import { RESERVED_STORE_CODES } from "./store";
  * - 502 `STOREFRONT_SANDBOX_UNAVAILABLE` — 편집 Sandbox 호출이 실패했다. 잠시 뒤 다시 한다
  *
  * 소스 내려받기·올리기(#60, `/v1/storefront/site/source/**`, `sayren` CLI):
- * - 409 `SOURCE_CHANGED` — 작업 트리가 내려받은 뒤(`expectedBaseRef`) 바뀌었다(상점 플랫폼·AI 편집). `error.details.currentRef`
+ * - 409 `SOURCE_CHANGED` — 작업 트리가 내려받은 뒤(`expectedBaseRef`) 바뀌었고 같은 파일을 서로 다르게 고쳤다(상점 플랫폼·AI 편집). 겹치지 않으면 서버가
+ *   3-way 병합한다(응답 `merged`). `error.details.currentRef`·`conflicts`(충돌 파일)
  * - 409 `EDIT_SESSION_OPEN` — 편집 환경이 열려 있다. `endEditSession: true`로 끄고 진행할 수 있다
  * - 409 `SOURCE_BLOBS_MISSING` — 올리지 않은 파일 내용이 있다(`error.details.hashes`). `POST source/blobs`로 올리고 다시 한다
  * - 409 `DEPENDENCY_REJECTED` — 쓸 수 없는 npm 의존성이다(`error.details.rejected: [{ name, version, reason, detail }]`)
@@ -272,7 +273,23 @@ export const storefrontVersionSchema = z.object({
     .nullable()
     .optional()
     .describe(
-      "만든 경로 (`CONSOLE` 상점 플랫폼 · `AI` AI 에이전트(MCP) · `CLI` `sayren` CLI · `API` 관리 API · `SYSTEM` 자동). 늘어날 수 있다",
+      "만든 경로 (`CONSOLE` 상점 플랫폼 · `AI` AI 에이전트(MCP) · `CLI` `sayren` CLI · `API` 관리 API · `SYSTEM` 자동 · `GIT` 연결한 저장소 push). 늘어날 수 있다",
+    ),
+  gitRef: z
+    .string()
+    .nullable()
+    .optional()
+    .describe("연결한 저장소의 push로 만든 버전의 브랜치. 그 밖은 null"),
+  commitSha: z
+    .string()
+    .nullable()
+    .optional()
+    .describe("이 버전 소스를 담은 저장소 커밋(Git 원천 사이트). 저장소에 없는 버전은 null"),
+  mainChanged: z
+    .boolean()
+    .optional()
+    .describe(
+      "이 버전을 만든 뒤 운영 브랜치가 바뀌어 발행할 수 없다(발행하면 409 `STOREFRONT_MAIN_CHANGED`). 최신 운영 브랜치를 합친 버전을 만든다. 버전 목록에만 싣는다",
     ),
   createdAt: z.string().describe("만든 시각 (ISO 8601)"),
   previewable: z
@@ -362,6 +379,12 @@ export type StorefrontSiteSnapshot = z.infer<typeof storefrontSiteSnapshotSchema
 
 export const storefrontSiteSchema = z.object({
   siteId: z.string(),
+  deployWithoutApproval: z
+    .boolean()
+    .optional()
+    .describe(
+      "승인 없이 배포 — 켜져 있으면 AI 에이전트의 발행·되돌리기가 승인 없이 실행된다. 상점 플랫폼에서 OWNER·ADMIN만 바꾼다",
+    ),
   slug: z.string().describe("주소 슬러그"),
   hostname: z.string().describe("대표 호스트 이름"),
   url: z.string().describe("대표 주소 (`https://{hostname}`)"),
@@ -1475,7 +1498,7 @@ export const replaceStorefrontSourceRequestSchema = z.object({
   expectedBaseRef: storefrontSourceRefSchema
     .optional()
     .describe(
-      "내려받은 작업 트리. 지금 작업 트리가 이 값일 때만 바꾼다. 생략하면 조건 없이 덮어쓴다",
+      "내려받은 작업 트리. 그 뒤 작업 트리가 바뀌었으면 이 트리를 기준으로 3-way 병합하고, 같은 곳을 고쳤으면 409 `SOURCE_CHANGED`다. 생략하면 조건 없이 덮어쓴다",
     ),
   files: z
     .array(
@@ -1510,15 +1533,135 @@ export const replaceStorefrontSourceRequestSchema = z.object({
 export type ReplaceStorefrontSourceRequest = z.infer<typeof replaceStorefrontSourceRequestSchema>;
 
 export const storefrontSourceReplacedSchema = z.object({
-  sourceRef: storefrontSourceRefSchema.describe("새 작업 트리 — 다음 올리기의 `expectedBaseRef`"),
+  sourceRef: storefrontSourceRefSchema.describe(
+    "새 작업 트리(버전 만들기의 `expectedSourceRef`). 다음 올리기의 기준은 `uploadedRef`다",
+  ),
   previousRef: z.string().describe("바꾸기 전 작업 트리"),
   treeSha256: z.string(),
   files: z.number().int().min(0),
   bytes: z.number().int().min(0),
   changed: z.boolean().describe("내용이 바뀌었는가 (같은 트리를 다시 올리면 false)"),
+  merged: z
+    .boolean()
+    .optional()
+    .describe(
+      "내려받은 뒤 바뀐 작업 트리와 3-way 병합해 결과가 올린 목록과 다른가(서버 쪽 변경이 함께 남는다). 같은 곳을 고쳤으면 409 `SOURCE_CHANGED`(`details.conflicts` 충돌 파일)",
+    ),
+  uploadedRef: storefrontSourceRefSchema
+    .optional()
+    .describe(
+      "올린 목록 그대로의 트리 — 다음 올리기의 `expectedBaseRef`(클라이언트가 가진 트리). 병합하지 않았으면 `sourceRef`와 같다",
+    ),
   endedEditSession: z.boolean().describe("열린 편집 환경을 끄고 진행했는가"),
   dependencyWarnings: z
     .array(storefrontDependencyFindingSchema)
     .describe("배포를 막지 않는 의존성 경고 (보안 권고 등)"),
 });
 export type StorefrontSourceReplaced = z.infer<typeof storefrontSourceReplacedSchema>;
+
+// ─── Git 원천 (#138 G5) ───────────────────────────────────
+
+/**
+ * `GET /v1/storefront/site/git` — 사이트의 Git 원천. 발행한 소스는 GitHub 저장소 main에 있다(사내 저장소 또는 셀러가 연결한 저장소).
+ * 연결 전이면 필드가 null이다
+ */
+export const storefrontGitStatusSchema = z.object({
+  provider: z.enum(["GITHUB"]).nullable().describe("Git 원천이 켜져 있으면 `GITHUB`, 아니면 null"),
+  owner: z
+    .enum(["SAYREN", "SELLER"])
+    .nullable()
+    .describe("`SAYREN` sayren이 관리하는 저장소 · `SELLER` 셀러가 연결한 저장소"),
+  repository: z
+    .string()
+    .nullable()
+    .describe("연결한 셀러 저장소(`owner/name`). sayren 저장소면 null"),
+  productionBranch: z.string().nullable().describe("운영 배포 브랜치"),
+  rootDirectory: z.string().nullable().describe("저장소 안 사이트 루트(빈 문자열 = 저장소 루트)"),
+  connectedAt: z.string().nullable().describe("원천이 켜진 시각 (ISO 8601)"),
+  headCommitSha: z.string().nullable().describe("운영 브랜치의 마지막 커밋"),
+  mainChanged: z
+    .boolean()
+    .describe(
+      "발행 전 작업이 지금 운영 브랜치 위가 아니다 — 발행하려면 최신 운영 브랜치를 합친 버전을 만든다(아니면 409 `STOREFRONT_MAIN_CHANGED`)",
+    ),
+  autoPromotePaused: z
+    .boolean()
+    .describe(
+      "되돌린 상태 — 저장소 push는 빌드만 하고 운영을 바꾸지 않는다. 버전을 발행하면 다시 켜진다",
+    ),
+  publishPending: z.boolean().describe("발행한 버전을 운영 브랜치에 올리는 중"),
+  publishErrorCode: z
+    .string()
+    .nullable()
+    .describe(
+      "마지막 발행을 운영 브랜치에 올리지 못한 이유(브랜치 보호 등). 운영과 저장소가 다를 수 있다",
+    ),
+  archivedWorkRef: z
+    .string()
+    .nullable()
+    .describe("셀러 저장소를 연결할 때 보관한 발행 전 작업 트리(연결 전 편집). 없으면 null"),
+});
+export type StorefrontGitStatus = z.infer<typeof storefrontGitStatusSchema>;
+
+export const storefrontGitRepositorySchema = z.object({
+  repoId: z.number().int().describe("GitHub 저장소 id"),
+  fullName: z.string().describe("`owner/name`"),
+  defaultBranch: z.string(),
+});
+export type StorefrontGitRepository = z.infer<typeof storefrontGitRepositorySchema>;
+
+/** `POST /v1/storefront/site/git/installations` — GitHub App 설치 화면에서 돌아온 값(`installation_id`·`code`) */
+export const linkStorefrontGitInstallationRequestSchema = z.object({
+  installationId: z.number().int().positive(),
+  code: z
+    .string()
+    .min(1)
+    .max(200)
+    .describe("설치 화면이 돌려준 GitHub 사용자 인증 코드(한 번만 쓴다)"),
+  state: z
+    .string()
+    .min(1)
+    .max(200)
+    .describe(
+      "설치 화면으로 보내기 전에 받은 연결 state(`POST …/git/installations/state`, 한 번만 쓴다)",
+    ),
+});
+
+/** `POST /v1/storefront/site/git/installations/state` — GitHub 설치 화면에 싣는 1회용 state(이 상점·사용자, 10분) */
+export const storefrontGitConnectStateSchema = z.object({
+  state: z.string(),
+  expiresAt: z.string(),
+});
+export type StorefrontGitConnectState = z.infer<typeof storefrontGitConnectStateSchema>;
+export type LinkStorefrontGitInstallationRequest = z.infer<
+  typeof linkStorefrontGitInstallationRequestSchema
+>;
+
+/** `POST /v1/storefront/site/git/connect` */
+export const connectStorefrontGitRequestSchema = z.object({
+  installationId: z.number().int().positive(),
+  repoId: z.number().int().positive(),
+  productionBranch: z
+    .string()
+    .min(1)
+    .max(200)
+    .regex(/^[A-Za-z0-9._-]+(\/[A-Za-z0-9._-]+)*$/)
+    .optional()
+    .describe("운영 배포 브랜치(생략하면 저장소 기본 브랜치)"),
+  rootDirectory: z
+    .string()
+    .max(200)
+    .regex(/^$|^[A-Za-z0-9._-]+(\/[A-Za-z0-9._-]+)*$/)
+    .refine((v) => !v.split("/").some((seg) => seg === "." || seg === ".."), "상대 경로만")
+    .optional()
+    .describe("저장소 안 사이트 루트(생략하면 저장소 루트)"),
+});
+export type ConnectStorefrontGitRequest = z.infer<typeof connectStorefrontGitRequestSchema>;
+
+/** `PUT /v1/storefront/site/deploy-approval` — 승인 없이 배포(#138) */
+export const setStorefrontDeployApprovalRequestSchema = z.object({
+  deployWithoutApproval: z.boolean(),
+});
+export type SetStorefrontDeployApprovalRequest = z.infer<
+  typeof setStorefrontDeployApprovalRequestSchema
+>;

package/src/schemas/subscription.ts

@@ -47,6 +47,9 @@ export const subscriptionLimitsSchema = z.object({
   storefrontPreviewHoursMonthly: limit("스토어프론트 편집 미리보기 월 시간"),
   storefrontBuildMinutesMonthly: limit("스토어프론트 빌드 월 분"),
   adminApiRequestsMonthly: limit("관리 API 요청 월 포함량(넘으면 속도만 낮춘다, 주문 처리 제외)"),
+  publicApps: limit("공개 앱(앱 스토어에 게시된 앱) 설치 수").optional(),
+  privateApps: limit("비공개 앱(이 상점 전용 앱) 설치 수(0이면 설치할 수 없다)").optional(),
+  aiCreditsMonthly: limit("AI 상점 도우미 월 크레딧").optional(),
 });
 export type SubscriptionLimits = z.infer<typeof subscriptionLimitsSchema>;
 
@@ -65,6 +68,8 @@ export const subscriptionUsageSchema = z.object({
   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>;
 
@@ -89,6 +94,10 @@ export const storeSubscriptionSchema = z.object({
   features: z.object({
     adminApi: z.boolean().describe("관리 API(개인 액세스 토큰·외부 앱 토큰 호출)를 쓸 수 있다"),
     analytics: z.boolean().describe("애널리틱스 조회를 쓸 수 있다"),
+    members: z
+      .boolean()
+      .optional()
+      .describe("소유자 외 구성원이 상점에 접근할 수 있다(false면 소유자만, 구성원 목록은 남는다)"),
     storeClone: z.boolean().describe("더 쓰지 않는다 — 상점 복제 기능을 없애 항상 false"),
     removeBadge: z.boolean().describe("더 쓰지 않는다 — 배지 키를 없애 항상 false"),
   }),
@@ -107,6 +116,31 @@ export const storeSubscriptionSchema = z.object({
       resetsAt: z.string().describe("한도가 초기화되는 시각(ISO 8601)"),
     })
     .describe("MCP 읽기 한도 요약"),
+  aiCredits: z
+    .object({
+      monthly: z.number().int().nullable().describe("요금제 월 크레딧. null이면 한도 없음"),
+      granted: z.number().int().describe("이번 기간에 쓸 수 있는 추가 지급 크레딧"),
+      used: z.number().int().describe("이번 기간 사용한 크레딧"),
+      monthlyUsed: z.number().int().optional().describe("이번 기간 월 크레딧에서 쓴 양"),
+      purchased: z
+        .number()
+        .int()
+        .optional()
+        .describe("남은 구매 크레딧 — 구매일부터 1년, 월 크레딧이 초기화돼도 남는다"),
+      complimentary: z.number().int().optional().describe("남은 무상 지급 크레딧(이벤트·보상)"),
+      remaining: z
+        .number()
+        .int()
+        .nullable()
+        .describe("남은 크레딧(월 + 구매 + 무상). null이면 한도 없음"),
+      resetsAt: z
+        .string()
+        .describe("월 크레딧이 초기화되는 시각(ISO 8601). 월 크레딧은 이월하지 않는다"),
+    })
+    .optional()
+    .describe(
+      "AI 상점 도우미 크레딧 — 1 크레딧은 모델 원가 $0.01. 남은 크레딧이 없으면 새 실행을 만들 수 없다",
+    ),
   salesFeePercent: z.literal(0).describe("판매 수수료(%). 모든 요금제 0이다"),
 });
 export type StoreSubscription = z.infer<typeof storeSubscriptionSchema>;
@@ -133,90 +167,3 @@ export const planErrorDetailsSchema = z
   })
   .loose();
 export type PlanErrorDetails = z.infer<typeof planErrorDetailsSchema>;
-
-const limitOrContract = (description: string) =>
-  z.number().int().nullable().describe(`${description}. null이면 계약(엔터프라이즈)·한도 없음`);
-
-/**
- * 요금제 기능 키 값 — 요금제 비교표·상점 플랫폼 요금제 화면이 쓴다. 키는 서버 판정의 기능 키와 같다(추가만 한다). 상위 요금제는 하위 요금제
- * 기능을 모두 포함한다
- */
-export const planEntitlementsSchema = z
-  .object({
-    "features.admin_api": z
-      .boolean()
-      .describe(
-        "관리 API(개인 액세스 토큰·외부 앱 토큰 호출). 상점 플랫폼·CLI·MCP는 모든 요금제에서 쓴다",
-      ),
-    "features.analytics": z.boolean().describe("애널리틱스 화면·조회 API"),
-    "limits.ai_reads_monthly": limitOrContract("MCP 읽기 월 한도"),
-    "limits.ai_actions_monthly": limitOrContract(
-      "MCP 쓰기(AI 작업) 월 한도 — 주문 처리는 막지 않는다",
-    ),
-    "limits.custom_domains": limitOrContract("내 도메인 수"),
-    "limits.webhooks": 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>;