@sayren/store-sdk 0.30.10 → 0.30.11

package/package.json

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

package/src/client.ts

@@ -23,6 +23,7 @@ import {
 import { type ApiLogListOptions, apiLogPageSchema, apiLogSummarySchema } from "./schemas/api-log";
 import {
   type AppInstallationSettingsUpdate,
+  appInstallationActivitySchema,
   appInstallationSchema,
   appInstallationSelfSchema,
   appInstallationSettingsUpdateSchema,
@@ -1469,6 +1470,20 @@ export function createStoreClient(options: StoreClientOptions) {
           ),
         remove: (installationId: string) =>
           storeHttp.requestVoid("DELETE", path`/apps/installations/${installationId}`),
+        /** 실행 기록 — 최근 이벤트 전송 결과와 최근 7일 관리 API 호출 수 */
+        activity: (installationId: string) =>
+          storeHttp.request(
+            "GET",
+            path`/apps/installations/${installationId}/activity`,
+            appInstallationActivitySchema,
+          ),
+        /** 권한 업데이트 동의 — 넓어진 새 버전(`pendingVersion`)으로 옮긴다(상점 플랫폼 전용) */
+        consent: (installationId: string) =>
+          storeHttp.request(
+            "POST",
+            path`/apps/installations/${installationId}/consent`,
+            appInstallationSchema,
+          ),
         /** 앱 화면 iframe에 넘길 세션 토큰(5분) */
         session: (installationId: string) =>
           storeHttp.request(

package/src/schemas/apps.ts

@@ -7,6 +7,7 @@ import {
   appHandleSchema,
   appSettingFieldSchema,
 } from "./app-manifest";
+import { webhookDeliveryErrorCodeSchema, webhookDeliveryStatusSchema } from "./misc";
 
 /**
  * 설치 앱 관리 API 계약 (이슈 #22) — `/v1/apps/installations/**`(상점이 설치한 앱), `/v1/app/installation`(설치 토큰 자기 조회).
@@ -71,6 +72,16 @@ export const appInstallationSchema = z.object({
     .int()
     .nullable()
     .describe("재동의가 필요한 새 버전. 없으면 null"),
+  pendingVersion: z
+    .object({
+      number: z.number().int(),
+      scopes: z.array(z.string()),
+      networkHosts: z.array(z.string()),
+      events: z.array(appEventTypeSchema),
+    })
+    .nullable()
+    .optional()
+    .describe("재동의가 필요한 새 버전이 요청하는 권한·외부 호스트·이벤트(전체). 없으면 null"),
   grantedScopes: z.array(z.string()).describe("동의한 스코프"),
   grantedNetworkHosts: z.array(z.string()).describe("동의한 외부 호출 호스트"),
   events: z.array(appEventTypeSchema).describe("이 설치가 받는 이벤트"),
@@ -84,6 +95,26 @@ export const appInstallationSchema = z.object({
 });
 export type AppInstallation = z.infer<typeof appInstallationSchema>;
 
+/** 실행 기록 한 줄 — 앱에 보낸 이벤트 하나의 전송 결과. 로그 본문은 개발자만 본다(매뉴얼 「앱 설치와 관리」) */
+export const appInstallationRunSchema = z.object({
+  deliveryId: z.string(),
+  eventType: z.string().describe("이벤트 이름(`ORDER.PAID`·`APP.INSTALLED` 등)"),
+  status: webhookDeliveryStatusSchema,
+  errorCode: webhookDeliveryErrorCodeSchema.nullable(),
+  attemptCount: z.number().int(),
+  createdAt: z.string(),
+  attemptedAt: z.string().nullable(),
+  nextAttemptAt: z.string().nullable(),
+});
+export type AppInstallationRun = z.infer<typeof appInstallationRunSchema>;
+
+/** `GET /v1/apps/installations/{id}/activity` — 최근 이벤트 전송 결과(50건)와 최근 7일 관리 API 호출 수 */
+export const appInstallationActivitySchema = z.object({
+  runs: z.array(appInstallationRunSchema),
+  apiCalls7d: z.number().int().describe("최근 7일 이 설치가 부른 관리 API 수"),
+});
+export type AppInstallationActivity = z.infer<typeof appInstallationActivitySchema>;
+
 /**
  * `POST /v1/apps/installations`(상점 플랫폼 전용) — 둘 중 하나다.
  * - `{ result }`: accounts 설치 동의 결과(1회용 JWT). 개발자 포털 [내 상점에 설치]가 이 길로 온다