@sayren/store-sdk 0.30.10 → 0.30.11

package/dist/index.d.mts

@@ -166,8 +166,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
 export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
 export declare const agentPolicyDecisionSchema: z.ZodEnum<{
   DENIED: "DENIED";
-  ALLOW: "ALLOW";
   APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+  ALLOW: "ALLOW";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
 export declare const writePreviewSchema: z.ZodObject<{
@@ -192,8 +192,8 @@ export declare const writeDryRunResultSchema: z.ZodObject<{
   dryRun: z.ZodLiteral<true>;
   decision: z.ZodEnum<{
     DENIED: "DENIED";
-    ALLOW: "ALLOW";
     APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
+    ALLOW: "ALLOW";
   }>;
   reason: z.ZodNullable<z.ZodString>;
   preview: z.ZodObject<{
@@ -2504,6 +2504,36 @@ export declare const appInstallationSchema: z.ZodObject<{
   }>;
   versionNumber: z.ZodNumber;
   pendingVersionNumber: z.ZodNullable<z.ZodNumber>;
+  pendingVersion: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+    number: z.ZodNumber;
+    scopes: z.ZodArray<z.ZodString>;
+    networkHosts: z.ZodArray<z.ZodString>;
+    events: z.ZodArray<z.ZodEnum<{
+      "ORDER.PAID": "ORDER.PAID";
+      "ORDER.CONFIRMED": "ORDER.CONFIRMED";
+      "ORDER.DISPATCHED": "ORDER.DISPATCHED";
+      "ORDER.DELIVERED": "ORDER.DELIVERED";
+      "ORDER.PURCHASE_DECIDED": "ORDER.PURCHASE_DECIDED";
+      "ORDER.ADDRESS_CHANGE_REQUESTED": "ORDER.ADDRESS_CHANGE_REQUESTED";
+      "ORDER.CANCELED": "ORDER.CANCELED";
+      "ORDER.FULFILLED": "ORDER.FULFILLED";
+      "CLAIM.CANCEL_REQUESTED": "CLAIM.CANCEL_REQUESTED";
+      "CLAIM.RETURN_REQUESTED": "CLAIM.RETURN_REQUESTED";
+      "CLAIM.EXCHANGE_REQUESTED": "CLAIM.EXCHANGE_REQUESTED";
+      "CLAIM.COMPLETED": "CLAIM.COMPLETED";
+      "INQUIRY.CREATED": "INQUIRY.CREATED";
+      "REVIEW.CREATED": "REVIEW.CREATED";
+      "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
+      "ORDER.FLOW_NOTIFICATION": "ORDER.FLOW_NOTIFICATION";
+      "ORDER.FLOW_STATE_CHANGED": "ORDER.FLOW_STATE_CHANGED";
+      "APP.INSTALLED": "APP.INSTALLED";
+      "APP.UNINSTALLED": "APP.UNINSTALLED";
+      "APP.SETTINGS_UPDATED": "APP.SETTINGS_UPDATED";
+      "APP.SCOPES_UPDATED": "APP.SCOPES_UPDATED";
+      "APP.STORE_REDACT": "APP.STORE_REDACT";
+      "APP.CUSTOMER_REDACT": "APP.CUSTOMER_REDACT";
+    }>>;
+  }, z.core.$strip>>>;
   grantedScopes: z.ZodArray<z.ZodString>;
   grantedNetworkHosts: z.ZodArray<z.ZodString>;
   events: z.ZodArray<z.ZodEnum<{
@@ -2563,6 +2593,67 @@ export declare const appInstallationSchema: z.ZodObject<{
   updatedAt: z.ZodString;
 }, z.core.$strip>;
 export type AppInstallation = z.infer<typeof appInstallationSchema>;
+/** 실행 기록 한 줄 — 앱에 보낸 이벤트 하나의 전송 결과. 로그 본문은 개발자만 본다(매뉴얼 「앱 설치와 관리」) */
+export declare const appInstallationRunSchema: z.ZodObject<{
+  deliveryId: z.ZodString;
+  eventType: z.ZodString;
+  status: z.ZodEnum<{
+    PENDING: "PENDING";
+    PENDING_RETRY: "PENDING_RETRY";
+    SUCCESS: "SUCCESS";
+    FAILED: "FAILED";
+  }>;
+  errorCode: z.ZodNullable<z.ZodEnum<{
+    TIMEOUT: "TIMEOUT";
+    CONNECTION_FAILED: "CONNECTION_FAILED";
+    BLOCKED_ADDRESS: "BLOCKED_ADDRESS";
+    NON_2XX: "NON_2XX";
+    WEBHOOK_SUSPENDED: "WEBHOOK_SUSPENDED";
+    APP_ERROR: "APP_ERROR";
+    APP_LIMIT_EXCEEDED: "APP_LIMIT_EXCEEDED";
+    APP_REJECTED: "APP_REJECTED";
+    APP_UNCONFIGURED: "APP_UNCONFIGURED";
+    APP_INACTIVE: "APP_INACTIVE";
+    APP_RUNNER_UNAVAILABLE: "APP_RUNNER_UNAVAILABLE";
+  }>>;
+  attemptCount: z.ZodNumber;
+  createdAt: z.ZodString;
+  attemptedAt: z.ZodNullable<z.ZodString>;
+  nextAttemptAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type AppInstallationRun = z.infer<typeof appInstallationRunSchema>;
+/** `GET /v1/apps/installations/{id}/activity` — 최근 이벤트 전송 결과(50건)와 최근 7일 관리 API 호출 수 */
+export declare const appInstallationActivitySchema: z.ZodObject<{
+  runs: z.ZodArray<z.ZodObject<{
+    deliveryId: z.ZodString;
+    eventType: z.ZodString;
+    status: z.ZodEnum<{
+      PENDING: "PENDING";
+      PENDING_RETRY: "PENDING_RETRY";
+      SUCCESS: "SUCCESS";
+      FAILED: "FAILED";
+    }>;
+    errorCode: z.ZodNullable<z.ZodEnum<{
+      TIMEOUT: "TIMEOUT";
+      CONNECTION_FAILED: "CONNECTION_FAILED";
+      BLOCKED_ADDRESS: "BLOCKED_ADDRESS";
+      NON_2XX: "NON_2XX";
+      WEBHOOK_SUSPENDED: "WEBHOOK_SUSPENDED";
+      APP_ERROR: "APP_ERROR";
+      APP_LIMIT_EXCEEDED: "APP_LIMIT_EXCEEDED";
+      APP_REJECTED: "APP_REJECTED";
+      APP_UNCONFIGURED: "APP_UNCONFIGURED";
+      APP_INACTIVE: "APP_INACTIVE";
+      APP_RUNNER_UNAVAILABLE: "APP_RUNNER_UNAVAILABLE";
+    }>>;
+    attemptCount: z.ZodNumber;
+    createdAt: z.ZodString;
+    attemptedAt: z.ZodNullable<z.ZodString>;
+    nextAttemptAt: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>>;
+  apiCalls7d: z.ZodNumber;
+}, z.core.$strip>;
+export type AppInstallationActivity = z.infer<typeof appInstallationActivitySchema>;
 /**
  * `POST /v1/apps/installations`(상점 플랫폼 전용) — 둘 중 하나다.
  * - `{ result }`: accounts 설치 동의 결과(1회용 JWT). 개발자 포털 [내 상점에 설치]가 이 길로 온다
@@ -9044,11 +9135,11 @@ export declare const productPatchRequestSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
 export declare const productSortSchema: z.ZodEnum<{
-  "updatedAt.desc": "updatedAt.desc";
   "createdAt.desc": "createdAt.desc";
   "createdAt.asc": "createdAt.asc";
   "salePrice.asc": "salePrice.asc";
   "salePrice.desc": "salePrice.desc";
+  "updatedAt.desc": "updatedAt.desc";
 }>;
 export type ProductSort = z.infer<typeof productSortSchema>;
 export interface ProductListParams extends PageParams {
@@ -9075,11 +9166,11 @@ export declare const productListQuerySchema: z.ZodObject<{
   sellerCode: z.ZodOptional<z.ZodString>;
   productNo: z.ZodOptional<z.ZodString>;
   sort: z.ZodOptional<z.ZodEnum<{
-    "updatedAt.desc": "updatedAt.desc";
     "createdAt.desc": "createdAt.desc";
     "createdAt.asc": "createdAt.asc";
     "salePrice.asc": "salePrice.asc";
     "salePrice.desc": "salePrice.desc";
+    "updatedAt.desc": "updatedAt.desc";
   }>>;
 }, z.core.$strip>;
 export declare const discountRequestSchema: z.ZodObject<{
@@ -15900,6 +15991,12 @@ export declare function createStoreClient(options: StoreClientOptions): {
         installedAt: string;
         uninstalledAt: string | null;
         updatedAt: string;
+        pendingVersion?: {
+          number: number;
+          scopes: string[];
+          networkHosts: string[];
+          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+        } | null | undefined;
       }>;
       list: () => Promise<{
         installationId: string;
@@ -15947,6 +16044,12 @@ export declare function createStoreClient(options: StoreClientOptions): {
         installedAt: string;
         uninstalledAt: string | null;
         updatedAt: string;
+        pendingVersion?: {
+          number: number;
+          scopes: string[];
+          networkHosts: string[];
+          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+        } | null | undefined;
       }[]>;
       get: (installationId: string) => Promise<{
         installationId: string;
@@ -15994,6 +16097,12 @@ export declare function createStoreClient(options: StoreClientOptions): {
         installedAt: string;
         uninstalledAt: string | null;
         updatedAt: string;
+        pendingVersion?: {
+          number: number;
+          scopes: string[];
+          networkHosts: string[];
+          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+        } | null | undefined;
       }>;
       /** 비밀 필드를 생략하면 현재 값을 유지한다. null은 비운다 */
       updateSettings: (installationId: string, body: AppInstallationSettingsUpdate) => Promise<{
@@ -16042,8 +16151,82 @@ export declare function createStoreClient(options: StoreClientOptions): {
         installedAt: string;
         uninstalledAt: string | null;
         updatedAt: string;
+        pendingVersion?: {
+          number: number;
+          scopes: string[];
+          networkHosts: string[];
+          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+        } | null | undefined;
       }>;
       remove: (installationId: string) => Promise<void>;
+      /** 실행 기록 — 최근 이벤트 전송 결과와 최근 7일 관리 API 호출 수 */
+      activity: (installationId: string) => Promise<{
+        runs: {
+          deliveryId: string;
+          eventType: string;
+          status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
+          errorCode: "TIMEOUT" | "CONNECTION_FAILED" | "BLOCKED_ADDRESS" | "NON_2XX" | "WEBHOOK_SUSPENDED" | "APP_ERROR" | "APP_LIMIT_EXCEEDED" | "APP_REJECTED" | "APP_UNCONFIGURED" | "APP_INACTIVE" | "APP_RUNNER_UNAVAILABLE" | null;
+          attemptCount: number;
+          createdAt: string;
+          attemptedAt: string | null;
+          nextAttemptAt: string | null;
+        }[];
+        apiCalls7d: number;
+      }>;
+      /** 권한 업데이트 동의 — 넓어진 새 버전(`pendingVersion`)으로 옮긴다(상점 플랫폼 전용) */
+      consent: (installationId: string) => Promise<{
+        installationId: string;
+        storeId: string;
+        app: {
+          appId: string;
+          handle: string;
+          name: string;
+          iconUrl: string | null;
+          description: string | null;
+          developerName: string;
+          supportEmail: string | null;
+          distribution: "PRIVATE_OWN" | "PRIVATE_LINK" | "LISTED";
+          runtime: "CODE" | "EXTERNAL";
+          status: "SUSPENDED" | "ACTIVE" | "DELETED";
+        };
+        status: "SUSPENDED" | "ACTIVE" | "UNINSTALLED";
+        versionNumber: number;
+        pendingVersionNumber: number | null;
+        grantedScopes: string[];
+        grantedNetworkHosts: string[];
+        events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+        adminPage: boolean;
+        settings: {
+          fields: Record<string, {
+            type: "string" | "number" | "boolean" | "select";
+            label: string;
+            description?: string | undefined;
+            required?: boolean | undefined;
+            secret?: boolean | undefined;
+            options?: {
+              value: string;
+              label: string;
+            }[] | undefined;
+            default?: string | number | boolean | undefined;
+          }>;
+          values: Record<string, string | number | boolean | null>;
+          configured: boolean;
+          updatedAt: string | null;
+        };
+        installedBy: {
+          userId: string;
+          name: string | null;
+        } | null;
+        installedAt: string;
+        uninstalledAt: string | null;
+        updatedAt: string;
+        pendingVersion?: {
+          number: number;
+          scopes: string[];
+          networkHosts: string[];
+          events: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED" | "APP.INSTALLED" | "APP.UNINSTALLED" | "APP.SETTINGS_UPDATED" | "APP.SCOPES_UPDATED" | "APP.STORE_REDACT" | "APP.CUSTOMER_REDACT")[];
+        } | null | undefined;
+      }>;
       /** 앱 화면 iframe에 넘길 세션 토큰(5분) */
       session: (installationId: string) => Promise<{
         token: string;