@tossplace/pos-plugin-sdk 0.0.5 → 0.0.7

package/types/index.d.ts

@@ -1,19 +1,19 @@
-declare type AllPaymentCreateDto = PluginCardDto | PluginCashDto | PluginExternalDto;
-
-declare type AllPopupElements = BarcodeElements;
-
-declare type AllPopupResponse = BarcodeResponse;
+import { WebView } from '@tossplace-nexus/pos-webview';
 
-/**
- * @publicApi
- */
-declare type AllPopupType = AllPopupElements['type'];
+declare type AllPaymentCreateDto = PluginCardDto | PluginCashDto | PluginExternalDto;
 
 declare const AvailableLanguageCodes: {
     readonly Korean: "ko-KR";
     readonly English: "en-US";
 };
 
+declare interface Barcode {
+    send(barcode: string): Promise<void>;
+    on(event: 'scan', callback: (barcode: string) => void): void;
+    useBarcodeScan(): void;
+    unUseBarcodeScan(): void;
+}
+
 /**
  */
 declare type BarcodeElements = {
@@ -37,12 +37,12 @@ declare type BarcodeResponse = {
 };
 
 declare type BaseInput = {
+    id: string;
     label: string;
     required: boolean;
-    id: string;
 };
 
-declare type CancelCallback = (order: PluginOrder, payment: PluginPayment) => Promise<PluginCancelledPaymentDto | undefined>;
+declare type CancelCallback = (order: PluginOrder, payment: PluginPayment, ui: Ui) => Promise<PluginCancelledPaymentDto | undefined>;
 
 /**
  * @schema
@@ -61,7 +61,10 @@ export declare type CashReceipt = {
     cardNumber: string;
 };
 
-declare interface CashReceiptTypes {
+/**
+ * @publicApi
+ */
+export declare interface CashReceiptTypes {
     add: (receipt: CashReceipt) => Promise<void>;
 }
 
@@ -69,10 +72,18 @@ declare interface CashReceiptTypes {
  * @publicApi
  */
 export declare interface Catalog {
+    getCatalog: (catalogId: number) => Promise<PluginCatalogItem>;
     getCatalogs: () => Promise<PluginCatalogItem[]>;
-    on: (event: 'sold-out' | 'on-sale' | 'update' | 'add' | 'delete', callback: (menu: PluginCatalogItem) => void) => void;
+    on(event: 'update' | 'add' | 'delete', callback: CatalogEventCallback): void;
+    /**
+     * @deprecated 다음 버전에서 제거 예정입니다
+     */
+    on(event: 'sold-out' | 'on-sale', callback: CatalogEventCallback): void;
+    on(event: 'sold-out' | 'on-sale' | 'update' | 'add' | 'delete', callback: CatalogEventCallback): void;
 }
 
+declare type CatalogEventCallback = (catalog: PluginCatalogItem) => void;
+
 /**
  * @publicApi
  */
@@ -83,10 +94,12 @@ export declare type CatalogItemOptionChoiceState = 'ON_SALE' | 'SOLD_OUT';
  */
 export declare interface CategoryTypes {
     getCategories: () => Promise<PluginCatalogCategory[]>;
+    getCategory: (categoryId: number) => Promise<PluginCatalogCategory>;
     on: (event: 'update' | 'add' | 'delete', callback: (category: PluginCatalogCategory) => void) => void;
 }
 
 /**
+ * @publicApi
  * @return 선택된 values id의 배열 string[]
  * @example ['option1', 'option2']
  */
@@ -99,7 +112,22 @@ declare type CheckBoxInput = Omit<BaseInput, 'placeholder'> & {
     values: InputValue[];
 };
 
-declare type DeliveryOrder = Order & {
+/**
+ * @publicApi
+ */
+declare type CtaInput = {
+    type: 'cta';
+    id: string;
+    text: string;
+    ctaType: 'primary' | 'danger' | 'dark';
+};
+
+/**
+ * @publicApi
+ */
+export declare type DeliveryConnectionStatusErrorCode = 'NOT_RUNNING' | 'NOT_LOGGED_IN' | 'UNKNOWN' | 'BAEMIN_NOT_SELECTED_PROGRAM';
+
+declare type DeliveryOrder = Order_2 & {
     type: 'DELIVERY';
     /**
      * 배달 주체
@@ -122,8 +150,85 @@ declare type DeliveryOrder = Order & {
  */
 declare type DeliveryStatus = 'NEW' | 'ACCEPTED' | 'REJECTED' | 'PARTIALLY_CANCELLED' | 'CANCELLED' | 'RIDER_ASSIGNED' | 'RIDER_ARRIVE_SOON' | 'RIDER_PICKUP_COMPLETED' | 'DONE';
 
+/**
+ * @publicApi
+ */
+export declare interface Device {
+    getDeviceInfo(): Promise<DeviceInfo>;
+}
+
+/**
+ * @publicApi
+ */
+export declare type DeviceInfo = {
+    name: string;
+    version: string;
+    platform: Platform;
+    arch: string;
+    /**
+     * 포스 고유번호
+     */
+    serialNumber: string;
+    /**
+     * os 버전을 가져옵니다.
+     * https://www.electronjs.org/docs/latest/api/process#processgetsystemversion
+     * Windows와 macos에서만 지원됩니다
+     */
+    osVersion?: string;
+    businessType: {
+        business: {
+            type: 'CAFE' | 'RESTAURANT';
+        };
+        operation: {
+            payment: {
+                type: 'PAY_FIRST' | 'PAY_LATER';
+            };
+            table: {
+                enabled: boolean;
+            };
+            booking: {
+                enabled: boolean;
+            };
+        };
+    } | {
+        business: {
+            type: 'RETAIL' | 'SERVICE';
+        };
+        operation: {
+            payment: {
+                type: 'PAY_FIRST';
+            };
+            table: {
+                enabled: false;
+            };
+            booking: {
+                enabled: boolean;
+            };
+        };
+    };
+};
+
 declare type Digit = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
 
+/**
+ * @publicApi
+ */
+export declare interface DraftOrder {
+    clear(): Promise<void>;
+    get(): Promise<PluginDraftOrder>;
+    addLineItem(lineItem: PluginDraftOrderItemDto): Promise<PluginDraftOrder>;
+    deleteLineItem(itemKey: string): Promise<PluginDraftOrder>;
+    updateItemQuantity(itemKey: string, quantity: number): Promise<PluginDraftOrder>;
+    updateItemOptionChoice(itemKey: string, choices: PluginCatalogItemOptionChoice[]): Promise<PluginDraftOrder>;
+    updateItemMemo(itemKey: string, memo: string): Promise<PluginDraftOrder>;
+    updateIgnorePrint(ignorePrint: boolean): Promise<PluginDraftOrder>;
+    deleteDiscount(indexOfDiscount: number): Promise<PluginDraftOrder>;
+    deleteItemDiscount(itemKey: string, indexOfDiscount: number): Promise<PluginDraftOrder>;
+    startPayment(): Promise<void>;
+}
+
+declare type Element_2 = BarcodeElements | InputElements;
+
 /**
  * @publicApi
  */
@@ -179,7 +284,10 @@ declare type FFIFunctionParam = {
  */
 declare type FFIFunctionReturn = 'void' | 'str' | 'int' | 'bool' | 'wchar *' | 'void *';
 
-declare interface FFITypes {
+/**
+ * @publicApi
+ */
+export declare interface FFITypes {
     download: (downloadInfo: FFIDownloadInfo) => Promise<{
         platform: keyof FFIDownloadInfo;
     }>;
@@ -193,14 +301,9 @@ declare interface FFITypes {
     addCallbackErrorHandler: (filePath: string, handler: (error: Error) => void) => void;
 }
 
-declare function getPluginInfo(): Promise<{
-    name: string;
-    version: string;
-}>;
-
 declare function getValues<T extends Record<string, number | string | string[] | boolean | undefined>>(): Promise<T>;
 
-declare type HereOrder = Order & {
+declare type HereOrder = Order_2 & {
     type: 'HERE';
     memo: {
         store?: string;
@@ -233,6 +336,35 @@ export declare interface HttpTypes {
     patch: (url: string, payload: any, headers?: [string, string][]) => Promise<PluginHttpResponse>;
 }
 
+declare type InputElements = {
+    type: 'input';
+    inputs: PluginInputs[];
+    title: string;
+    description?: string;
+    cta: {
+        cancel?: CtaInput;
+        submit: CtaInput;
+    };
+};
+
+declare type InputResponse = {
+    type: 'input';
+    complete: true;
+    data: {
+        inputs: Record<string, string | number | boolean | string[]>;
+        result: 'SUCCESS';
+    } | {
+        result: 'CANCELLED';
+    };
+} | {
+    type: 'input';
+    complete: false;
+    errorMessage: string;
+};
+
+/**
+ * @publicApi
+ */
 declare type InputValue = {
     id: string;
     label: string;
@@ -247,19 +379,91 @@ declare type Languages = Record<PluginLanguageCode, string>;
  */
 export declare interface MenuOption {
     getOptions: () => Promise<PluginCatalogItemOption[]>;
-    on: (event: 'sold-out' | 'on-sale' | 'update' | 'add' | 'delete', callback: (option: PluginCatalogItemOption) => void) => void;
+    getOption: (optionId: number) => Promise<PluginCatalogItemOption>;
+    /**
+     * @deprecated 다음 버전에서 제거 예정입니다
+     */
+    on(event: 'sold-out' | 'on-sale', callback: (option: PluginCatalogItemOption) => void): void;
+    on(event: 'update' | 'add' | 'delete', callback: (option: PluginCatalogItemOption) => void): void;
+    on(event: 'sold-out' | 'on-sale' | 'update' | 'add' | 'delete', callback: (option: PluginCatalogItemOption) => void): void;
 }
 
 /**
  * @publicApi
  */
-export declare interface MerchantTypes {
+export declare interface Merchant {
     getMerchant: () => Promise<TossMerchant>;
 }
 
-declare function on(event: 'close', callback: () => Promise<void>): void;
+/**
+ * @publicApi
+ */
+export declare interface Navigation {
+    navigate(page: 'plugin-tab', packageName?: string): void;
+    navigate(page: 'business-type-setting'): void;
+    /**
+     * 포스에서 페이지를 이동합니다.
+     * @param page business-type-setting 업종유형 변경, plugin-tab 플러그인 탭 이동
+     * @param packageName 이동할 탭의 이름, 없는 경우 첫번째 플러그인 탭으로 이동합니다
+     */
+    navigate(page: 'business-type-setting' | 'plugin-tab', packageName?: string): void;
+}
 
-declare type Order = {
+/**
+ * @publicApi
+ */
+export declare class NavigationImpl implements Navigation {
+    navigate(page: 'plugin-tab', packageName?: string): void;
+    navigate(page: 'business-type-setting'): void;
+}
+
+/**
+ * @publicApi
+ * @return number
+ */
+declare type NumberInput = BaseInput & {
+    type: 'number';
+    default: number;
+    placeholder?: string;
+    suffix?: string;
+    /**
+     * @see https://deus.toss.im/projects/1057/pages/o58sjnCS@1?node=jIulZjBg%401
+     * @description candidates는 선택지를 제공하는 기능으로, candidates중 유저가 하나를 선택하면 textField가 자동으로 value로 채워짐
+     */
+    candidates?: {
+        text: string;
+        value: number;
+    }[];
+};
+
+/**
+ * @publicApi
+ */
+export declare interface Order {
+    getOrder: (id: string) => Promise<PluginOrder>;
+    /**
+     * @param start yyyy-MM-dd
+     * @param end yyyy-MM-dd
+     * @description createdAt 기준으로 주문을 조회합니다
+     */
+    getOrders: (range: {
+        start: string;
+        end: string;
+    }) => Promise<PluginOrder[]>;
+    /**
+     * @deprecated
+     */
+    on(event: 'cancel', callback: (order: PluginOrder) => void): void;
+    cancel: (id: string) => Promise<void>;
+    add: (order: PluginOrderDto) => Promise<PluginOrder>;
+    /**
+     * 새로 추가 된 메뉴만 order에 넣으세요
+     */
+    addMenu: (orderId: string, order: PluginOrderDto) => Promise<PluginOrder>;
+    complete: (id: string) => Promise<PluginOrder>;
+}
+
+declare type Order_2 = {
     /**
      * 포스(사장님)에게 보여줄 주문유형
      * @example 가게배달, 장보기/쇼핑, 픽업, 배민1 등등
@@ -305,23 +509,6 @@ declare type OrderItemType = 'ITEM' | 'DELIVERY_FEE' | 'PREPAID_CARD' | 'MULTI_U
 
 /**
  * @publicApi
- */
-export declare interface OrderTypes {
-    getOrder: (id: string) => Promise<PluginOrder>;
-    /**
-     * 토스 포스에서 카드결제를 취소하면 무조건 카드리딩해야함 그래서 on cancel은 늘 환불까지 된 상태임
-     */
-    on: (event: 'cancel', callback: (order: PluginOrder) => void) => void;
-    cancel: (id: string) => Promise<void>;
-    add: (order: PluginOrderDto) => Promise<PluginOrder>;
-    /**
-     * 새로 추가 된 메뉴만 order에 넣으세요
-     */
-    addMenu: (orderId: string, order: PluginOrderDto) => Promise<PluginOrder>;
-    complete: (id: string) => Promise<PluginOrder>;
-}
-
-/**
  * @return string
  */
 declare type PasswordInput = BaseInput & {
@@ -330,7 +517,25 @@ declare type PasswordInput = BaseInput & {
     placeholder?: string;
 };
 
-declare type PayCallback = (order: PluginOrder, price: PluginPrice) => Promise<PaymentMethodResponse | undefined>;
+declare type PayCallback = (order: PluginOrder, price: PluginPrice, ui: Ui) => Promise<PaymentMethodResponse | undefined>;
+
+/**
+ * @publicApi
+ */
+export declare interface Payment {
+    on: (event: 'cancel' | 'paid', callback: PaymentCallback) => void;
+    cancel: (order: {
+        id: string;
+    }, payment: {
+        id: string;
+    }) => Promise<void>;
+    add: (order: {
+        id: string;
+    }, paymentDto: PluginPaymentDto) => Promise<PluginPaymentOf<'CARD'> | PluginPaymentOf<'CASH'> | PluginPaymentOf<'EXTERNAL'>>;
+    getPayment: (paymentId: PluginPayment['id']) => Promise<PluginPayment>;
+}
+
+declare type PaymentCallback = (payment: PluginPayment) => void;
 
 /**
  * @publicApi
@@ -346,7 +551,10 @@ export declare type PaymentMethodResponse = {
     paymentKey: string;
 };
 
-declare type PaymentMethodType = {
+/**
+ * @publicApi
+ */
+export declare type PaymentMethodType = {
     add: (payload: {
         data: {
             /**
@@ -366,19 +574,7 @@ declare type PaymentMethodType = {
     }) => void;
 };
 
-declare interface PaymentTypes {
-    on: (event: 'cancel', callback: (payload: PluginPaymentOf<'CASH'> | PluginPaymentOf<'CARD'> | PluginPaymentOf<'EXTERNAL'>) => void) => void;
-    cancel: (order: {
-        id: string;
-    }, payment: {
-        id: string;
-    }) => Promise<void>;
-    add: (order: {
-        id: string;
-    }, paymentDto: PluginPaymentDto) => Promise<PluginPaymentOf<'CARD'> | PluginPaymentOf<'CASH'> | PluginPaymentOf<'EXTERNAL'>>;
-}
-
-declare type PickupOrder = Order & {
+declare type PickupOrder = Order_2 & {
     type: 'PICKUP';
     memo: {
         store?: string;
@@ -387,10 +583,65 @@ declare type PickupOrder = Order & {
     status: StoreStatus;
 };
 
-declare const plugin: {
-    on: typeof on;
-    getPluginInfo: typeof getPluginInfo;
-};
+/**
+ * @publicApi
+ */
+declare type Platform = 'macos' | 'windows' | 'android' | 'ios' | 'unknown';
+
+/**
+ * @publicApi
+ */
+export declare const plugin: PluginImpl;
+
+/**
+ * @publicApi
+ */
+declare interface Plugin_2 {
+    on(event: 'close', callback: () => Promise<void>): void;
+    getPluginInfo(): Promise<{
+        name: string;
+        version: string;
+    }>;
+}
+export { Plugin_2 as Plugin }
+
+/**
+ * @publicApi
+ */
+declare interface PluginAccountTransferPayment extends PluginPaymentBase {
+    sourceType: 'ACCOUNT_TRANSFER';
+    /** 계좌이체 정보 */
+    accountTransfer: {
+        /** 은행코드 */
+        bankCode: number;
+        /** 계좌번호 */
+        accountNumber: string;
+    };
+}
+
+/**
+ * @publicApi
+ */
+declare interface PluginBarcodePayment extends PluginPaymentBase {
+    sourceType: 'BARCODE';
+    externalDetails: {
+        installmentMonth: PluginPaymentInstallment;
+        /**
+         * 발급사명
+         * @example 토스페이, 네이버체크, 카카오페이머니, ...
+         */
+        source: string;
+        /**
+         * 간편결제 구분자
+         * @example KKF, SG2, ZRP, ...
+         */
+        sourceId: string;
+        sourceType?: PluginPaymentExternalSourceType;
+        /** 매입사명 */
+        cardBrand?: string;
+        cardNo?: string;
+    };
+}
 
 /**
  * @publicApi
@@ -490,6 +741,10 @@ export declare interface PluginCatalogItem {
      * @description 토스 포스에 등록된 메뉴의 고유 아이디
      */
     id: number;
+    /**
+     * 플러그인에서 생성하면 토스포스 서버에 저장되어 항상 같이 내려옴
+     */
+    code?: string;
     /**
      * @description 포스 내에서 보여주는 타이틀
      * @description 사장님께만 보입니다
@@ -517,7 +772,7 @@ export declare interface PluginCatalogItem {
      * @description 메뉴에 달린 벳지입니다
      */
     labels: PluginCatalogItemLabel[];
-    imageUrl: string | null;
+    imageUrl?: string;
     /**
      * @description 상품의 가격정보
      */
@@ -526,6 +781,13 @@ export declare interface PluginCatalogItem {
      * @description 상품에서 사용가능한 옵션 리스트
      */
     options: PluginCatalogItemOption[];
+    /** POS에서 상품 표시시 색상 정보 */
+    color?: string;
+    /** 제조 및 유통 정보 */
+    provenance?: {
+        /** 제조사 */
+        displayProvenance: string;
+    };
 }
 
 /**
@@ -541,14 +803,20 @@ export declare interface PluginCatalogItemDto {
     description?: string;
     descriptionI18n?: PluginLanguagePack;
     categoryId: number;
-    price: PluginCatalogItemPrice;
+    price: PluginCatalogItemPriceDto;
     labels: PluginCatalogItemLabel[];
-    imageUrl: string | null;
+    imageUrl?: string;
     /**
      * @description 옵션을 먼저 만들고 id를 넣어달라
      */
     options: Pick<PluginCatalogItemOption, 'id'>[];
-    kioskTitle?: string;
+    /** POS에서 상품 표시시 색상 정보 */
+    color?: string;
+    /** 제조 및 유통 정보 */
+    provenance?: {
+        /** 제조사 */
+        displayProvenance: string;
+    };
 }
 
 /**
@@ -602,7 +870,6 @@ export declare interface PluginCatalogItemOptionChoice {
  * @publicApi
  */
 export declare interface PluginCatalogItemPrice {
-    id: number;
     /** 상품 가격명 */
     title: string;
     /** 기본 가격 여부 */
@@ -613,9 +880,9 @@ export declare interface PluginCatalogItemPrice {
      * 재고 관리 코드
      * @see https://en.wikipedia.org/wiki/Stock_keeping_unit
      */
-    sku: string | null;
+    sku?: string;
     /** 상품 가격의 바코드 정보 */
-    barcode: string | null;
+    barcode?: string;
     /** 가격 유형 */
     priceType: PluginCatalogItemPriceType;
     /** 가격의 기본 개수 */
@@ -629,10 +896,30 @@ export declare interface PluginCatalogItemPrice {
     /** 재고 관리여부 */
     isStockable: boolean;
     /** 현재 남아있는 재고 수 */
-    stockQuantity: {
+    stockQuantity?: {
         remainQuantity: number;
         lastChangeDateTime: string;
-    } | null;
+    };
+}
+
+/**
+ * @publicApi
+ */
+export declare interface PluginCatalogItemPriceDto {
+    /** 상품 가격명 */
+    title: string;
+    /** 상품 가격의 바코드 정보 */
+    barcode?: string;
+    /** 가격 유형 */
+    priceType: PluginCatalogItemPriceType;
+    /** 가격의 기본 개수 */
+    priceUnit: number;
+    /**
+     * 부가가치세(VAT)가 포함된 가격
+     */
+    priceValue: number;
+    /** 비과세 여부 */
+    isTaxFree: boolean;
 }
 
 /**
@@ -659,6 +946,34 @@ export declare type PluginDelivery<T extends 'PICKUP' | 'HERE' | 'DELIVERY'> = E
     type: T;
 }>;
 
+/**
+ * @publicApi
+ * */
+export declare interface PluginDeliveryDiscount extends PluginDiscount {
+    discountBy: 'OWNER' | 'PLATFORM';
+}
+
+/**
+ * @publicApi
+ * @description order를 만들기 위한 dto
+ */
+export declare type PluginDeliveryOrderDto = Omit<PluginOrderDto, 'lineItems' | 'discounts'> & {
+    cancelled: boolean;
+    delivery: PluginDelivery<'DELIVERY' | 'PICKUP' | 'HERE'>;
+    discounts: Array<PluginDeliveryDiscount>;
+    lineItems: Array<Omit<PluginOrderItem, 'id' | 'orderId' | 'item' | 'optionChoices' | 'discounts'> & {
+        item: {
+            title: string;
+            type: 'ITEM' | 'DELIVERY_FEE';
+        };
+        optionChoices: Array<{
+            title: string;
+            priceValue: number;
+        }>;
+        discounts?: Array<PluginDeliveryDiscount>;
+    }>;
+};
+
 /**
  * @publicApi
  * 할인 정보
@@ -676,6 +991,107 @@ export declare interface PluginDiscount {
     titleI18n?: PluginLanguagePack;
 }
 
+/**
+ * @publicApi
+ */
+export declare interface PluginDraftOrder {
+    /**
+     * 주문ID
+     * 서버 주문을 클라이언트 주문으로 변경했을 때 값이 존재
+     */
+    id?: string;
+    /** 주문 항목 목록 */
+    lineItems: Array<PluginDraftOrderItem>;
+    /** 주문 요청사항 */
+    memo?: string;
+    /** 주문에 적용된 할인 목록 */
+    discounts: PluginDiscount[];
+    price: PluginDraftOrderPrice;
+    /**
+     * 이 주문에 대해 프린트 출력을 무시할지 여부
+     * 이 옵션이 켜져 있는 경우 다른 포스에서도 프린트 출력이 무시됩니다.
+     * 기본값은 false입니다.
+     */
+    ignorePrint: boolean;
+    /** 해당 주문의 테이블 인원 수 */
+    numGuests?: number;
+}
+
+/**
+ * @publicApi
+ */
+export declare interface PluginDraftOrderItem {
+    /**
+     * 넣지 않으면 자동으로 생성됨
+     */
+    key: string;
+    /** 상품 정보 */
+    item: Pick<PluginCatalogItem, 'id' | 'title' | 'category' | 'options' | 'code'> & {
+        type: OrderItemType;
+    };
+    /** 상품 가격 정보 */
+    itemPrice: Pick<PluginCatalogItemPrice, 'isTaxFree' | 'priceType' | 'priceUnit' | 'priceValue' | 'sku' | 'title'>;
+    /** 적용된 할인 목록 */
+    discount: PluginDiscount[];
+    /** 요청사항 */
+    memo: string;
+    /** 선택된 옵션 정보 */
+    optionChoices: PluginCatalogItemOptionChoice[];
+    /** 수량 */
+    quantity: number;
+    /** 식사 유형 */
+    diningOption: PluginOrderDiningOption;
+    /**
+     * 서버에서 생성된 lineItemId
+     */
+    lineItemId?: string;
+    metadata?: {
+        /**
+         * true : 유저가 메모 수정 불가
+         */
+        disableMemoEdit?: boolean;
+        /**
+         * true : 유저가 옵션 수정 불가
+         */
+        disableOptionEdit?: boolean;
+        /**
+         * true : 유저가 수량 변경 불가
+         */
+        disableQuantityEdit?: boolean;
+    };
+}
+
+/**
+ * @publicApi
+ * @desription key는 넣으면 할당되고 없으면 포스에서 자동생성
+ */
+declare type PluginDraftOrderItemDto = PluginDraftOrderItem & {
+    key?: string;
+    itemPrice: Pick<PluginCatalogItemPrice, 'isTaxFree' | 'priceType' | 'priceUnit' | 'priceValue' | 'sku' | 'title'>;
+};
+
+declare interface PluginDraftOrderPrice {
+    /** (-)할인 금액 */
+    orderDiscountValue: number;
+    /**
+     * 원주문 금액
+     * Σ OrderItem.orderPrice.orderListPriceValue
+     */
+    orderListPriceValue: number;
+    /**
+     * 주문 금액 = 원주문금액 + 할인 금액 + 보증금 + 봉사료
+     *
+     * @see 보증금: DraftOrder.bookingFee
+     */
+    orderPriceValue: number;
+    /** 봉사료 */
+    orderTipValue: number;
+}
+
+/**
+ * 밴을 통하지 않으면 바코드결제라고 해도 externalPayment로 처리해주세요
+ * 취소를 플러그인에서 따로 처리해야하면 externalPayment로 처리해주세요
+ */
 declare interface PluginExternalDto extends PluginPaymentDtoBase {
     sourceType: 'EXTERNAL';
 }
@@ -721,18 +1137,23 @@ export declare type PluginHttpResponse = {
     code: number;
 };
 
-/**
- * @publicApi
- * @see https://deus.toss.im/projects/1057/pages/8gKjmG0l@1
- */
-export declare type PluginInputs<T extends PluginInputType = any> = Extract<TextInput | PasswordInput | RadioInput | CheckBoxInput | ToggleInput | SliderInput, {
-    type: T;
-}>;
+declare class PluginImpl implements Plugin_2 {
+    private readonly webview;
+    private pluginCallbacks;
+    constructor(webview: WebView);
+    private initializePlugin;
+    on(event: 'close', callback: () => Promise<void>): void;
+    getPluginInfo(): Promise<{
+        name: string;
+        version: string;
+    }>;
+}
 
 /**
  * @publicApi
+ * @see https://deus.toss.im/projects/1057/pages/8gKjmG0l@1
  */
-declare type PluginInputType = PluginInputs['type'];
+export declare type PluginInputs = TextInput | PasswordInput | RadioInput | CheckBoxInput | ToggleInput | SliderInput | NumberInput;
 
 declare type PluginLanguageCode = ValueOf<typeof AvailableLanguageCodes>;
 
@@ -744,6 +1165,26 @@ export declare interface PluginLanguagePack {
     languages: Partial<Languages>;
 }
 
+/**
+ * @publicApi
+ */
+export declare interface PluginMessenger {
+    broadcast<T = any>(message: T): void;
+    on<T = any>(event: 'message', callback: (message: T) => void): void;
+}
+
+/**
+ * @publicApi
+ */
+export declare const pluginMessenger: PluginMessengerImpl;
+
+declare class PluginMessengerImpl implements PluginMessenger {
+    private readonly webview;
+    constructor(webview: WebView);
+    broadcast<T = any>(message: T): void;
+    on<T = any>(event: 'message', callback: (message: T) => void): void;
+}
+
 /**
  * @publicApi
  * @description pluginOrder orderDto를 서버에 저장 후 가공해서 내려 준 값
@@ -769,11 +1210,17 @@ export declare interface PluginOrder {
     paymentPrice: PluginOrderPaymentPrice;
     requestedInfo?: PluginOrderRequestInfo;
     source: string;
+    /** 해당 주문의 테이블 인원 수 */
+    numGuests?: number;
     memo?: string;
     /**
+     * @description 주문시각
      * 해당값이 있다면 createdAt 대신 사용해주세요.
      */
     openedAt?: string;
+    /**
+     * @description 생성시각
+     */
     createdAt: string;
     updatedAt?: string;
     cancelledAt?: string;
@@ -827,14 +1274,14 @@ export declare interface PluginOrderItem {
     id: string;
     orderId: string;
     diningOption: PluginOrderDiningOption;
-    item: Pick<PluginCatalogItem, 'id' | 'title' | 'category'> & {
+    item: Pick<PluginCatalogItem, 'id' | 'title' | 'category' | 'code'> & {
         type: OrderItemType;
     };
     quantity: {
         value: number;
     };
     /**
-     * @description 실제 고객이 결제하는 금액에 대한 정보입니다.
+     * @description 실제 고객이 결제하는 금액에 대한 정보입니다. (할인 적용 금액)
      */
     chargePrice: {
         value: number;
@@ -898,7 +1345,7 @@ export declare type PluginOrderState = 'REQUESTED' | 'OPENED' | 'COMPLETED' | 'C
 /**
  * @publicApi
  */
-export declare type PluginPayment = (PluginCardPayment | PluginCashPayment | PluginExternalPayment) & {
+export declare type PluginPayment = (PluginCardPayment | PluginCashPayment | PluginExternalPayment | PluginAccountTransferPayment | PluginBarcodePayment) & {
     paymentKey: string;
 };
 
@@ -957,11 +1404,23 @@ export declare type PluginPaymentDto<S extends PluginPaymentSourceType = PluginP
     sourceType: S;
 }>;
 
-declare type PluginPaymentDtoBase = Pick<PluginPayment, 
+declare interface PluginPaymentDtoBase extends Pick<PluginPayment, 
 /**
 * orderId 그냥 열어두면 이상한 값 넣을가봐 걱정... 방어코드 필요
 */
-'orderId' | 'sourceType' | 'amountMoney' | 'taxMoney' | 'approvedNo' | 'approvedAt' | 'paymentKey' | 'supplyMoney' | 'tipMoney' | 'taxExemptMoney'>;
+'orderId' | 'sourceType' | 'amountMoney' | 'taxMoney' | 'approvedNo' | 'approvedAt' | 'paymentKey' | 'supplyMoney' | 'tipMoney' | 'taxExemptMoney'> {
+    /**
+     * default: true
+     * false로 설정 시, 결제 등록 후 자동으로 주문이 완료되지 않습니다.
+     * 테이블의 주문인 경우 autocomplete를 false로 설정하면, 테이블이 비워지지 않습니다
+     */
+    autocomplete?: boolean;
+}
+
+/**
+ * @publicApi
+ */
+declare type PluginPaymentExternalSourceType = 'CARD' | 'BANK_TRANSFER' | 'OTHER_GIFT_CARD' | 'POINT' | 'COUPON' | 'OTHER';
 
 /**
  * @publicApi
@@ -985,7 +1444,7 @@ export declare type PluginPaymentOf<S extends PluginPaymentSourceType> = Extract
  * BARCODE: 바코드/QR을 사용하는 간편결제
  * EXTERNAL: 기타결제(쿠폰, 외상 등)
  */
-export declare type PluginPaymentSourceType = 'CARD' | 'CASH' | 'EXTERNAL';
+export declare type PluginPaymentSourceType = 'CARD' | 'CASH' | 'EXTERNAL' | 'BARCODE' | 'ACCOUNT_TRANSFER';
 
 /**
  * @publicApi
@@ -1008,6 +1467,8 @@ export declare type PluginPrice = {
     taxExemptMoney: number;
 };
 
+/* Excluded from this release type: PluginServerOnHttpRequest */
+
 /**
  * @publicApi
  */
@@ -1017,6 +1478,8 @@ export declare interface PluginTable {
     hallId: number;
     /** 테이블명 */
     title: string;
+    /** 인원수 */
+    capacity?: number;
     group?: PluginTableGroup;
 }
 
@@ -1031,22 +1494,26 @@ export declare interface PluginTableGroup {
     tableIds: number[];
 }
 
-declare type PluginTypes = typeof plugin;
-
 /**
  * @publicApi
  */
-export declare type PopupActionResponse<T extends AllPopupType> = Extract<AllPopupResponse, {
+export declare type PopupActionResponse<T extends PopupType> = Extract<Response_2, {
     type: T;
-}>;
+    complete: true;
+}>['data'];
 
 /**
  * @publicApi
  */
-export declare type PopupElements<T extends AllPopupType> = Extract<AllPopupElements, {
+export declare type PopupElement<T extends PopupType> = Extract<Element_2, {
     type: T;
 }>;
 
+/**
+ * @publicApi
+ */
+declare type PopupType = Element_2['type'];
+
 /**
  * @publicApi
  */
@@ -1057,17 +1524,21 @@ export declare type PosPluginSdk = {
     option: MenuOption;
     storage: StorageTypes;
     cashReceipt: CashReceiptTypes;
-    order: OrderTypes;
-    payment: PaymentTypes;
+    order: Order;
+    payment: Payment;
     http: HttpTypes;
     toast: ToastTypes;
-    merchant: MerchantTypes;
-    ui: UiType;
+    device: Device;
+    merchant: Merchant;
     paymentMethod: PaymentMethodType;
     websocket: WebsocketTypes;
     ffi: FFITypes;
-    plugin: PluginTypes;
+    barcode: Barcode;
+    plugin: Plugin_2;
+    pluginMessenger: PluginMessenger;
     setting: SettingTypes;
+    draftOrder: DraftOrder;
+    navigation: Navigation;
 };
 
 /**
@@ -1084,6 +1555,15 @@ export declare class PosPluginSdkError extends Error {
 }
 
 /**
+ * @publicApi
+ */
+export declare class PosPluginSdkRateLimitError extends PosPluginSdkError {
+    constructor(message: string);
+    static isPosPluginSdkRateLimitError(error: unknown): error is PosPluginSdkRateLimitError;
+}
+
+/**
+ * @publicApi
  * @return string values.id
  */
 declare type RadioInput = Omit<BaseInput, 'placeholder'> & {
@@ -1095,6 +1575,8 @@ declare type RadioInput = Omit<BaseInput, 'placeholder'> & {
     values: InputValue[];
 };
 
+declare type Response_2 = BarcodeResponse | InputResponse;
+
 declare function setInputs(inputs: Array<PluginInputs>): void;
 
 declare const setting: {
@@ -1102,9 +1584,13 @@ declare const setting: {
     getValues: typeof getValues;
 };
 
-declare type SettingTypes = typeof setting;
+/**
+ * @publicApi
+ */
+export declare type SettingTypes = typeof setting;
 
 /**
+ * @publicApi
  * @return number 0 25 50 75 100
  */
 declare type SliderInput = Omit<BaseInput, 'placeholder'> & {
@@ -1133,34 +1619,52 @@ declare type StoreStatus = 'NEW' | 'ACCEPTED' | 'REJECTED' | 'PARTIALLY_CANCELLE
 */
 | 'DONE';
 
-declare interface Table {
-    getTables: () => Promise<{
-        table: PluginTable;
-        order?: PluginOrder;
-    }[]>;
+/**
+ * @publicApi
+ */
+export declare interface Table {
+    getTables: () => Promise<PluginTable[]>;
+    getTable: (tableId: number) => Promise<PluginTable>;
+    /**
+     * @deprecated 다음버전에서 제거 예정. order.on 사용 권장
+     */
     on(event: 'order-update' | 'order-add', callback: (order: PluginOrder) => void): void;
     on(event: 'clear' | 'add' | 'delete' | 'update', callback: (table: PluginTable) => void): void;
-    on(event: 'swap' | 'move' | 'merge', callback: (before: PluginTable, after: PluginTable) => void): void;
-    clearTable: (payload: {
+    on(event: 'move', callback: (before: PluginTable, after: PluginTable) => void): void;
+    clearTable: ({ table, order }: {
         table: PluginTable;
         order?: PluginOrder;
     }) => Promise<void>;
 }
 
 /**
+ * @publicApi
  * @return string
  */
 declare type TextInput = BaseInput & {
     type: 'text';
     default: string;
     placeholder?: string;
+    suffix?: string;
+    /**
+     * @see https://deus.toss.im/projects/1057/pages/o58sjnCS@1?node=jIulZjBg%401
+     * @description candidates는 선택지를 제공하는 기능으로, candidates중 유저가 하나를 선택하면 textField가 자동으로 value로 채워짐
+     */
+    candidates?: {
+        text: string;
+        value: string;
+    }[];
 };
 
-declare type ToastTypes = {
+/**
+ * @publicApi
+ */
+export declare type ToastTypes = {
     open(message: string): void;
 };
 
 /**
+ * @publicApi
  * @return boolean
  */
 declare type ToggleInput = Omit<BaseInput, 'placeholder'> & {
@@ -1176,17 +1680,32 @@ export declare type TossMerchant = {
     name: string;
     id: number;
     businessNumber: string;
-    serialNumber: string;
     franchise?: {
         id: string;
         name: string;
     };
 };
 
-declare type UiType = {
-    openPopup<T extends AllPopupType>(message: PopupElements<T>): Promise<PopupActionResponse<T>>;
+/**
+ * @publicApi
+ */
+export declare type Ui = {
+    openBarcode(message: Omit<PopupElement<'barcode'>, 'type'>): Promise<PopupActionResponse<'barcode'>>;
+    openInputModal(message: Omit<PopupElement<'input'>, 'type'>): Promise<PopupActionResponse<'input'>>;
 };
 
+/**
+ * @publicApi
+ */
+export declare const ui: UiImpl;
+
+declare class UiImpl implements Ui {
+    openBarcode(data: {
+        productName: string;
+    }): Promise<PopupActionResponse<'barcode'>>;
+    openInputModal(data: Omit<PopupElement<'input'>, 'type'>): Promise<PopupActionResponse<'input'>>;
+}
+
 declare type ValueOf<ObjectType, ValueType extends keyof ObjectType = keyof ObjectType> = ObjectType[ValueType];
 
 /**
@@ -1194,7 +1713,10 @@ declare type ValueOf<ObjectType, ValueType extends keyof ObjectType = keyof Obje
  */
 export declare type VanType = 'NICE' | 'KIS' | 'SMARTRO' | 'KOVAN';
 
-declare class Websocket {
+/**
+ * @publicApi
+ */
+export declare class Websocket {
     private readonly url;
     private readonly headers;
     private readonly options?;
@@ -1221,7 +1743,10 @@ declare class Websocket {
     onOpen(callback: () => void): void;
 }
 
-declare type WebsocketTypes = {
+/**
+ * @publicApi
+ */
+export declare type WebsocketTypes = {
     create: (url: string, headers: Record<string, string>, options?: {
         rejectUnauthorized?: boolean;
         followRedirects?: boolean;