@tossplace/pos-plugin-sdk 0.0.23 → 0.0.25

package/dist/sdk.d.ts

@@ -1,3 +1,12 @@
+/**
+ * @publicApi
+ */
+export declare type AlertTypes = {
+    open(params: {
+        message: string;
+    }): void;
+};
+
 declare type AllPaymentCreateDto = PluginCardDto | PluginCashDto | PluginExternalDto;
 
 declare const AvailableLanguageCodes: {
@@ -553,7 +562,8 @@ declare type PayCallback = (order: PluginOrder, price: PluginPrice, ui: Ui) => P
  * @publicApi
  */
 export declare interface Payment {
-    on: (event: 'cancel' | 'paid', callback: PaymentCallback) => void;
+    on(event: 'cancel' | 'paid', callback: PaymentCallback): void;
+    on(event: 'before-cancel', callback: PaymentBeforeCancelCallback): void;
     cancel: (order: {
         id: string;
     }, payment: {
@@ -565,6 +575,11 @@ export declare interface Payment {
     getPayment: (paymentId: PluginPayment['id']) => Promise<PluginPayment>;
 }
 
+declare type PaymentBeforeCancelCallback = (payload: {
+    order: PluginOrder;
+    payment: PluginPayment;
+}) => Promise<void>;
+
 declare type PaymentCallback = (paymentId: PluginPayment['id'], orderId: PluginOrder['id']) => void;
 
 /**
@@ -1154,6 +1169,9 @@ export declare interface PluginExternalPayment extends PluginPaymentBase {
     };
 }
 
+/**
+ * @publicApi
+ */
 declare interface PluginGetKdsOrderItemsPayload {
     states?: PluginKdsOrderItemState[];
     page: number;
@@ -1163,6 +1181,9 @@ declare interface PluginGetKdsOrderItemsPayload {
     itemIds?: number[];
 }
 
+/**
+ * @publicApi
+ */
 declare interface PluginGetKdsOrderItemsResult {
     contents: PluginKdsOrderItem[];
     last: boolean;
@@ -1198,11 +1219,12 @@ export declare type PluginHttpResponse = {
 
 declare class PluginImpl implements Plugin_2 {
     constructor();
-    private initializePlugin;
-    getPluginInfo(): Promise<{
+    getPluginInfo: () => Promise<{
         name: string;
         version: string;
     }>;
+    private initializePlugin;
+    private fetchPluginInfo;
 }
 
 /**
@@ -1211,6 +1233,9 @@ declare class PluginImpl implements Plugin_2 {
  */
 export declare type PluginInputs = TextInput | PasswordInput | RadioInput | CheckBoxInput | ToggleInput | SliderInput | NumberInput;
 
+/**
+ * @publicApi
+ */
 declare interface PluginKdsLineItem {
     title: string;
     diningOption: PluginOrderDiningOption;
@@ -1244,6 +1269,9 @@ declare interface PluginKdsLineItemOrderPrice {
 declare interface PluginKdsOrder extends Omit<PluginOrder, 'lineItems'> {
 }
 
+/**
+ * @publicApi
+ */
 declare interface PluginKdsOrderItem {
     id: string;
     state: PluginKdsOrderItemState;
@@ -1258,8 +1286,14 @@ declare interface PluginKdsOrderItem {
     updatedAt: string;
 }
 
+/**
+ * @publicApi
+ */
 declare type PluginKdsOrderItemState = 'REQUESTED' | 'OPENED' | 'COMPLETED' | 'CANCELLED';
 
+/**
+ * @publicApi
+ */
 declare type PluginKdsOrderRequestType = 'ADDED' | 'NEW' | 'CHANGED' | 'CANCELLED' | 'MERGED';
 
 declare type PluginLanguageCode = ValueOf<typeof AvailableLanguageCodes>;
@@ -1353,6 +1387,7 @@ export declare type PluginOrderDiningOption = 'HERE' | 'TOGO' | 'DELIVERY' | 'PI
  * @description order를 만들기 위한 dto
  */
 export declare type PluginOrderDto = {
+    orderKey?: string;
     memo?: string;
     numGuests?: number;
     discounts: PluginDiscount[];
@@ -1683,6 +1718,7 @@ declare type PopupType = Element_2['type'];
  * @publicApi
  */
 export declare type PosPluginSdk = {
+    alert: AlertTypes;
     table: Table;
     category: CategoryTypes;
     catalog: Catalog;
@@ -1862,7 +1898,34 @@ declare type TextInput = BaseInput & {
  * @publicApi
  */
 export declare type ToastTypes = {
+    /**
+     * @deprecated toast.error(), toast.warn(), toast.success() 를 사용하세요
+     */
     open(message: string): void;
+    error(params: {
+        message: string;
+        button?: {
+            text: string;
+            onClick: () => void;
+        };
+    }): void;
+    warn(params: {
+        message: string;
+        button?: {
+            text: string;
+            onClick: () => void;
+        };
+    }): void;
+    success(params: {
+        message: string;
+        button?: {
+            text: string;
+            onClick: () => void;
+        };
+    }): void;
+    /**
+     * @deprecated toast.warn(), toast.error(), toast.success() 의 button.onClick 을 사용하세요
+     */
     on(event: 'click', callback: () => void): () => void;
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tossplace/pos-plugin-sdk",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "description": "포스 플러그인 sdk",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",

package/types/index.d.ts

@@ -1,3 +1,12 @@
+/**
+ * @publicApi
+ */
+export declare type AlertTypes = {
+    open(params: {
+        message: string;
+    }): void;
+};
+
 declare type AllPaymentCreateDto = PluginCardDto | PluginCashDto | PluginExternalDto;
 
 declare const AvailableLanguageCodes: {
@@ -553,7 +562,8 @@ declare type PayCallback = (order: PluginOrder, price: PluginPrice, ui: Ui) => P
  * @publicApi
  */
 export declare interface Payment {
-    on: (event: 'cancel' | 'paid', callback: PaymentCallback) => void;
+    on(event: 'cancel' | 'paid', callback: PaymentCallback): void;
+    on(event: 'before-cancel', callback: PaymentBeforeCancelCallback): void;
     cancel: (order: {
         id: string;
     }, payment: {
@@ -565,6 +575,11 @@ export declare interface Payment {
     getPayment: (paymentId: PluginPayment['id']) => Promise<PluginPayment>;
 }
 
+declare type PaymentBeforeCancelCallback = (payload: {
+    order: PluginOrder;
+    payment: PluginPayment;
+}) => Promise<void>;
+
 declare type PaymentCallback = (paymentId: PluginPayment['id'], orderId: PluginOrder['id']) => void;
 
 /**
@@ -1154,6 +1169,9 @@ export declare interface PluginExternalPayment extends PluginPaymentBase {
     };
 }
 
+/**
+ * @publicApi
+ */
 declare interface PluginGetKdsOrderItemsPayload {
     states?: PluginKdsOrderItemState[];
     page: number;
@@ -1163,6 +1181,9 @@ declare interface PluginGetKdsOrderItemsPayload {
     itemIds?: number[];
 }
 
+/**
+ * @publicApi
+ */
 declare interface PluginGetKdsOrderItemsResult {
     contents: PluginKdsOrderItem[];
     last: boolean;
@@ -1198,11 +1219,12 @@ export declare type PluginHttpResponse = {
 
 declare class PluginImpl implements Plugin_2 {
     constructor();
-    private initializePlugin;
-    getPluginInfo(): Promise<{
+    getPluginInfo: () => Promise<{
         name: string;
         version: string;
     }>;
+    private initializePlugin;
+    private fetchPluginInfo;
 }
 
 /**
@@ -1211,6 +1233,9 @@ declare class PluginImpl implements Plugin_2 {
  */
 export declare type PluginInputs = TextInput | PasswordInput | RadioInput | CheckBoxInput | ToggleInput | SliderInput | NumberInput;
 
+/**
+ * @publicApi
+ */
 declare interface PluginKdsLineItem {
     title: string;
     diningOption: PluginOrderDiningOption;
@@ -1244,6 +1269,9 @@ declare interface PluginKdsLineItemOrderPrice {
 declare interface PluginKdsOrder extends Omit<PluginOrder, 'lineItems'> {
 }
 
+/**
+ * @publicApi
+ */
 declare interface PluginKdsOrderItem {
     id: string;
     state: PluginKdsOrderItemState;
@@ -1258,8 +1286,14 @@ declare interface PluginKdsOrderItem {
     updatedAt: string;
 }
 
+/**
+ * @publicApi
+ */
 declare type PluginKdsOrderItemState = 'REQUESTED' | 'OPENED' | 'COMPLETED' | 'CANCELLED';
 
+/**
+ * @publicApi
+ */
 declare type PluginKdsOrderRequestType = 'ADDED' | 'NEW' | 'CHANGED' | 'CANCELLED' | 'MERGED';
 
 declare type PluginLanguageCode = ValueOf<typeof AvailableLanguageCodes>;
@@ -1353,6 +1387,7 @@ export declare type PluginOrderDiningOption = 'HERE' | 'TOGO' | 'DELIVERY' | 'PI
  * @description order를 만들기 위한 dto
  */
 export declare type PluginOrderDto = {
+    orderKey?: string;
     memo?: string;
     numGuests?: number;
     discounts: PluginDiscount[];
@@ -1676,6 +1711,7 @@ declare type PopupType = Element_2['type'];
  * @publicApi
  */
 export declare type PosPluginSdk = {
+    alert: AlertTypes;
     table: Table;
     category: CategoryTypes;
     catalog: Catalog;
@@ -1855,7 +1891,34 @@ declare type TextInput = BaseInput & {
  * @publicApi
  */
 export declare type ToastTypes = {
+    /**
+     * @deprecated toast.error(), toast.warn(), toast.success() 를 사용하세요
+     */
     open(message: string): void;
+    error(params: {
+        message: string;
+        button?: {
+            text: string;
+            onClick: () => void;
+        };
+    }): void;
+    warn(params: {
+        message: string;
+        button?: {
+            text: string;
+            onClick: () => void;
+        };
+    }): void;
+    success(params: {
+        message: string;
+        button?: {
+            text: string;
+            onClick: () => void;
+        };
+    }): void;
+    /**
+     * @deprecated toast.warn(), toast.error(), toast.success() 의 button.onClick 을 사용하세요
+     */
     on(event: 'click', callback: () => void): () => void;
 };