@sayren/store-sdk 0.30.11 → 0.30.12

package/src/schemas/apps.ts

@@ -29,6 +29,10 @@ export const appInstallationStatusSchema = z.enum(["ACTIVE", "UNINSTALLED", "SUS
 export type AppInstallationStatus = z.infer<typeof appInstallationStatusSchema>;
 
 /** 설치 앱의 앱 정보 — 상점이 보는 범위만(개발자 비밀 값·소스·빌드는 없다) */
+/** 상점이 보는 앱 공개 범위 — 개발 중(개발자 조직) · 이 상점 전용 · 공개 */
+export const appVisibilitySchema = z.enum(["DEVELOPMENT", "PRIVATE", "PUBLIC"]);
+export type AppVisibility = z.infer<typeof appVisibilitySchema>;
+
 export const appInstallationAppSchema = z.object({
   appId: z.string(),
   handle: z.string().describe("앱 handle. 앱 화면 주소의 라벨"),
@@ -61,6 +65,22 @@ export const appInstallationSettingsUpdateSchema = z.object({
 });
 export type AppInstallationSettingsUpdate = z.infer<typeof appInstallationSettingsUpdateSchema>;
 
+/** 예약 작업 한 줄 — 매니페스트 `schedules`의 이름과 간격 */
+export const appScheduleSummarySchema = z.object({
+  name: z.string(),
+  every: z.enum(["15m", "30m", "1h", "3h", "6h", "12h", "1d"]),
+});
+export type AppScheduleSummary = z.infer<typeof appScheduleSummarySchema>;
+
+const publicHttpField = z
+  .array(z.string())
+  .default([])
+  .describe("외부에서 부를 수 있는 HTTP 핸들러(`GET /track/:id`)");
+const schedulesField = z
+  .array(appScheduleSummarySchema)
+  .default([])
+  .describe("주기적으로 실행되는 작업");
+
 export const appInstallationSchema = z.object({
   installationId: z.string(),
   storeId: z.string(),
@@ -78,6 +98,8 @@ export const appInstallationSchema = z.object({
       scopes: z.array(z.string()),
       networkHosts: z.array(z.string()),
       events: z.array(appEventTypeSchema),
+      publicHttp: publicHttpField,
+      schedules: schedulesField,
     })
     .nullable()
     .optional()
@@ -86,6 +108,8 @@ export const appInstallationSchema = z.object({
   grantedNetworkHosts: z.array(z.string()).describe("동의한 외부 호출 호스트"),
   events: z.array(appEventTypeSchema).describe("이 설치가 받는 이벤트"),
   adminPage: z.boolean().describe("상점 플랫폼 앱 화면이 있는가"),
+  publicHttp: publicHttpField,
+  schedules: schedulesField,
   /** 설치 결과의 캐시가 아니라 실행 버전 매니페스트의 요약 */
   settings: appInstallationSettingsSchema,
   installedBy: z.object({ userId: z.string(), name: z.string().nullable() }).nullable(),
@@ -158,6 +182,9 @@ export const storeAppSchema = z.object({
   developerName: z.string(),
   versionNumber: z.number().int().describe("현재 버전"),
   installationId: z.string().nullable().describe("이 상점에 설치돼 있으면 설치 id"),
+  visibility: appVisibilitySchema
+    .default("DEVELOPMENT")
+    .describe("공개 범위 — 개발 중(심사 전) · 이 상점 전용 · 공개(심사 통과)"),
 });
 export type StoreApp = z.infer<typeof storeAppSchema>;
 
@@ -168,6 +195,8 @@ export const storeAppDetailSchema = storeAppSchema.extend({
   scopes: z.array(z.string()).describe("설치 때 동의하는 스코프(Scope)"),
   events: z.array(appEventTypeSchema).describe("받는 이벤트(Hook)"),
   networkHosts: z.array(z.string()).describe("앱이 데이터를 보내는 외부 호스트"),
+  publicHttp: publicHttpField,
+  schedules: schedulesField,
   settings: z.record(z.string(), appSettingFieldSchema).describe("설치 때 채우는 설정 필드"),
   updatedAt: z.string().nullable().describe("현재 버전을 release한 시각"),
 });
@@ -193,6 +222,33 @@ export const appInstallationSelfSchema = z.object({
 });
 export type AppInstallationSelf = z.infer<typeof appInstallationSelfSchema>;
 
+/** 설치 저장소(`ctx.storage`, 매뉴얼 「앱 코드 › 저장소」) — 설치 토큰 전용 */
+export const APP_STORAGE_KEY_PATTERN = /^[A-Za-z0-9._:-]{1,200}$/;
+export const APP_STORAGE_MAX_KEYS = 1_000;
+/** 설치당 전체 크기(키 + JSON 값, UTF-8 바이트) */
+export const APP_STORAGE_MAX_BYTES = 1024 * 1024;
+
+export const appStorageEntrySchema = z.object({
+  key: z.string(),
+  value: z.unknown().describe("저장한 JSON 값"),
+  updatedAt: z.string(),
+});
+export type AppStorageEntry = z.infer<typeof appStorageEntrySchema>;
+
+export const appStorageKeysSchema = z.object({
+  keys: z.array(z.string()).describe("키 목록(이름순)"),
+});
+export type AppStorageKeys = z.infer<typeof appStorageKeysSchema>;
+
+export const appStoragePutSchema = z.object({
+  value: z.unknown().refine((value) => value !== undefined, { message: "value가 필요합니다" }),
+});
+export type AppStoragePut = z.infer<typeof appStoragePutSchema>;
+
+export const appStorageListQuerySchema = z.object({
+  prefix: z.string().max(200).optional(),
+});
+
 export type { AppCapabilities };
 
 // ─── 개발자 API (플랫폼 플레인 `/platform/v1/developer/**`, 공개 문서 제외 — CLI·상점 플랫폼 개발자 화면이 쓴다) ───
@@ -249,6 +305,8 @@ export const appVersionSchema = z.object({
     events: z.array(z.string()),
     networkHosts: z.array(z.string()),
     adminPage: z.boolean(),
+    publicHttp: z.array(z.string()).optional(),
+    schedules: z.record(z.string(), z.string()).optional(),
     requiredSettings: z.array(z.string()),
     secretSettings: z.array(z.string()),
   }),
@@ -264,6 +322,19 @@ export const appVersionSchema = z.object({
 });
 export type AppVersion = z.infer<typeof appVersionSchema>;
 
+/** 앱 공개 심사(#22, 매뉴얼 「앱 공개 범위」) — 개발자가 신청하고 운영자가 승인·반려한다 */
+export const appListingReviewStatusSchema = z.enum(["PENDING", "APPROVED", "REJECTED"]);
+export type AppListingReviewStatus = z.infer<typeof appListingReviewStatusSchema>;
+export const appListingReviewSchema = z.object({
+  reviewId: z.string(),
+  status: appListingReviewStatusSchema,
+  versionNumber: z.number().int().describe("신청 때 현재 버전"),
+  reason: z.string().nullable().describe("반려 사유"),
+  requestedAt: z.string(),
+  reviewedAt: z.string().nullable(),
+});
+export type AppListingReview = z.infer<typeof appListingReviewSchema>;
+
 export const developerAppSchema = z.object({
   appId: z.string(),
   orgId: z.string(),
@@ -277,6 +348,15 @@ export const developerAppSchema = z.object({
   status: appStatusSchema,
   suspendedReason: z.string().nullable(),
   currentVersionNumber: z.number().int().nullable(),
+  privateStoreId: z
+    .string()
+    .nullable()
+    .default(null)
+    .describe("비공개 앱이 묶인 상점. 개발 중·퍼블릭 앱은 null"),
+  listingReview: appListingReviewSchema
+    .nullable()
+    .default(null)
+    .describe("마지막 공개 신청. 없으면 null"),
   installations: z.object({
     active: z.number().int(),
     pendingReconsent: z.number().int(),
@@ -290,6 +370,8 @@ export const developerAppCreateSchema = z.object({
   handle: appHandleSchema,
   name: z.string().trim().min(1).max(60),
   description: z.string().trim().max(500).optional(),
+  /** 비공개 앱 — 이 상점 하나에만 설치된다. 만드는 사람이 그 상점의 OWNER·ADMIN이어야 한다 */
+  privateStoreId: z.string().min(1).optional(),
 });
 export type DeveloperAppCreate = z.infer<typeof developerAppCreateSchema>;
 
@@ -345,6 +427,15 @@ export const devStoreSchema = z.object({
 });
 export type DevStore = z.infer<typeof devStoreSchema>;
 
+/** `GET /platform/v1/developer/stores` — 비공개 앱을 묶을 수 있는 상점(내가 소유자·관리자, 운영 중) */
+export const developerStoreSchema = z.object({
+  storeId: z.string(),
+  name: z.string(),
+  role: z.enum(["OWNER", "ADMIN"]),
+  development: z.boolean().describe("개발 상점인가"),
+});
+export type DeveloperStore = z.infer<typeof developerStoreSchema>;
+
 /** 개발자가 보는 설치 한 줄 */
 export const developerInstallationSchema = z.object({
   installationId: z.string(),