@shopfront/bridge 1.9.0 → 1.12.0

package/.idea/misc.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="JavaScriptSettings">
+    <option name="languageLevel" value="ES6" />
+  </component>
+  <component name="NodePackageJsonFileManager">
+    <packageJsonPaths />
+  </component>
+</project>

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/shopfront-embedded-bridge.iml" filepath="$PROJECT_DIR$/.idea/shopfront-embedded-bridge.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/php.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="PhpProjectSharedConfiguration" php_language_level="7.2" />
+</project>

package/.idea/shopfront-embedded-bridge.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

package/README.md

@@ -1,5 +1,6 @@
-#Shopfront Embedded Bridge
+# Shopfront Embedded Bridge
+
 This is the bridge library to use with the Shopfront Embedded API.
 
 For more information, check out the documentation on the 
-[Shopfront developer website](https://developer.onshopfront.com/documentation/Embedded/Introduction).
+[Shopfront developer website](https://developer.onshopfront.com/documentation/Embedded/Introduction).

package/lib/APIs/CurrentSale/Sale.d.ts

@@ -80,6 +80,12 @@ export declare class Sale {
      * @returns {string}
      */
     getOrderReference(): string;
+    /**
+     * Get the current meta data for the sale
+     *
+     * @returns {Record<string, unknown>}
+     */
+    getMetaData(): Record<string, unknown>;
     /**
      * Cancel the current sale in progress.
      *
@@ -162,6 +168,12 @@ export declare class Sale {
      * @returns {Promise<void>}
      */
     setOrderReference(reference: string): Promise<void>;
+    /**
+     * Set the meta data of the sale, this will override the previous meta data.
+     *
+     * @param metaData
+     */
+    setMetaData(metaData: Record<string, unknown>): Promise<void>;
     /**
      * Update a product's details, currently this only updates the top-level meta data
      * @param product

package/lib/APIs/CurrentSale/Sale.js

@@ -125,6 +125,14 @@ class Sale {
     getOrderReference() {
         return this.sale.orderReference;
     }
+    /**
+     * Get the current meta data for the sale
+     *
+     * @returns {Record<string, unknown>}
+     */
+    getMetaData() {
+        return this.sale.metaData;
+    }
     /**
      * Cancel the current sale in progress.
      *
@@ -257,6 +265,16 @@ class Sale {
             reference,
         }));
     }
+    /**
+     * Set the meta data of the sale, this will override the previous meta data.
+     *
+     * @param metaData
+     */
+    setMetaData(metaData) {
+        return this.sendSaleUpdate(new SaleUpdate_1.SaleUpdate("SALE_META_DATA", {
+            metaData,
+        }));
+    }
     /**
      * Update a product's details, currently this only updates the top-level meta data
      * @param product

package/lib/APIs/CurrentSale/SaleProduct.d.ts

@@ -73,7 +73,7 @@ export declare class SaleProduct {
      *
      * @returns {ShopfrontSaleProductType | undefined}
      */
-    getType(): "Normal" | "Voucher" | "Basket" | "Package" | "Component" | undefined;
+    getType(): ShopfrontSaleProductType | undefined;
     /**
      * Get the tax rate amount.
      * This is the rate of the tax rate (e.g. 10 is a tax rate of 10%).

package/lib/APIs/CurrentSale/SaleProduct.js

@@ -44,10 +44,9 @@ class SaleProduct {
      * @param {Array<number>} indexAddress
      */
     setInternal(data, indexAddress) {
-        var _a;
         this.name = data.name;
         this.type = data.type;
-        this.taxRateAmount = ((_a = data.tax) === null || _a === void 0 ? void 0 : _a.amount) || 0;
+        this.taxRateAmount = data.tax?.amount || 0;
         this.note = data.note;
         this.edited = data.edited;
         this.caseQuantity = data.caseQuantity;

package/lib/APIs/CurrentSale/ShopfrontSaleState.d.ts

@@ -48,5 +48,6 @@ export interface ShopfrontSaleState {
     orderReference: string;
     refundReason: string;
     priceSet: string | null;
+    metaData: Record<string, unknown>;
 }
 export {};

package/lib/APIs/CurrentSale/index.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
 }) : (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];

package/lib/APIs/InternalMessages/InternalMessageSource.d.ts

@@ -6,5 +6,5 @@ export declare class InternalMessageSource {
     protected method: InternalPageMessageMethod;
     protected url: string;
     constructor(application: Application, method: InternalPageMessageMethod, url: string);
-    send(message: any): void;
+    send(message: unknown): void;
 }

package/lib/Actions/BaseAction.d.ts

@@ -1,21 +1,26 @@
 import { EventEmitter } from "../Common/EventEmitter";
 import { Serializable, Serialized } from "../Common/Serializable";
+interface BaseActionConstructor<T> {
+    new (...args: Array<never>): BaseAction<T>;
+    new (serialized: Serialized<T>): BaseAction<T>;
+}
 export declare class BaseAction<T> extends EventEmitter {
     protected target: string;
     protected events: Array<{
-        callback: Function;
+        callback: (...args: Array<unknown>) => void;
         type: string;
         id: string;
     }>;
-    protected properties: Array<any>;
+    protected properties: Array<unknown>;
     static serializedRegistry: {
-        [id: string]: any;
+        [id: string]: BaseActionConstructor<unknown>;
     };
-    constructor(serialized: Serialized<T>, type: any);
+    constructor(serialized: Serialized<T>, type: BaseActionConstructor<T>);
     serialize(): Serialized<T>;
-    protected serializeProperties(properties: Array<any>): Array<any>;
+    protected serializeProperties(properties: Array<unknown>): Array<unknown>;
     static deserialize<T extends Serializable<T>>(serialized: Serialized<T>): T;
-    addEventListener(event: string, callback: Function): void;
-    removeEventListener(event: string, callback: Function): void;
-    handleRegistrarEvent(id: string, data: any): void;
+    addEventListener(event: string, callback: (...args: Array<unknown>) => void): void;
+    removeEventListener(event: string, callback: (...args: Array<unknown>) => void): void;
+    handleRegistrarEvent(id: string, data: unknown): void;
 }
+export {};

package/lib/Actions/BaseAction.js

@@ -44,17 +44,18 @@ let BaseAction = BaseAction_1 = class BaseAction extends EventEmitter_1.EventEmi
         const results = [];
         // Loop through current layer of properties
         for (let i = 0, l = properties.length; i < l; i++) {
-            if (Array.isArray(properties[i])) {
+            const property = properties[i];
+            if (Array.isArray(property)) {
                 // Prepare to recurse through next layer of properties
-                results.push(this.serializeProperties(properties[i]));
+                results.push(this.serializeProperties(property));
             }
-            else if (properties[i] instanceof BaseAction_1) {
+            else if (property instanceof BaseAction_1) {
                 // Serialize property
-                results.push(properties[i].serialize());
+                results.push(property.serialize());
             }
             else {
                 // Assume that the property is already serializable
-                results.push(properties[i]);
+                results.push(property);
             }
         }
         return results;
@@ -102,6 +103,6 @@ let BaseAction = BaseAction_1 = class BaseAction extends EventEmitter_1.EventEmi
 };
 BaseAction.serializedRegistry = {};
 BaseAction = BaseAction_1 = __decorate([
-    Static_1.staticImplements()
+    (0, Static_1.staticImplements)()
 ], BaseAction);
 exports.BaseAction = BaseAction;

package/lib/Actions/Button.js

@@ -19,7 +19,6 @@ class Button extends BaseAction_1.BaseAction {
         })(), Button);
         this.supportedEvents = ["click"];
         if (typeof icon === "undefined" && typeof label !== "string") {
-            label = label;
             this.label = label.properties[0];
             this.icon = label.properties[1];
         }

package/lib/Actions/Redirect.js

@@ -19,7 +19,6 @@ class InternalRedirect extends BaseAction_1.BaseAction {
         })(), InternalRedirect);
         this.supportedEvents = ["click"];
         if (typeof to !== "string") {
-            to = to;
             this.to = to.properties[0];
         }
         else {
@@ -47,7 +46,6 @@ class ExternalRedirect extends BaseAction_1.BaseAction {
             this.to = to;
         }
         else {
-            to = to;
             this.to = new URL(to.properties[0]);
         }
     }

package/lib/Actions/SaleKey.js

@@ -19,7 +19,6 @@ class SaleKey extends BaseAction_1.BaseAction {
         })(), SaleKey);
         this.supportedEvents = ["click"];
         if (typeof name === "undefined" && typeof id !== "string") {
-            id = id;
             this.id = id.properties[0];
             this.name = id.properties[1];
         }

package/lib/Actions/SaleUpdate.d.ts

@@ -26,11 +26,11 @@ export interface SaleUpdateChanges {
         cashout?: number;
         status?: ShopfrontSalePaymentStatus;
     };
-    SALE_CANCEL: {};
+    SALE_CANCEL: Record<string, never>;
     CUSTOMER_ADD: {
         id: string;
     };
-    CUSTOMER_REMOVE: {};
+    CUSTOMER_REMOVE: Record<string, never>;
     SALE_EXTERNAL_NOTE: {
         note: string;
         append?: boolean;
@@ -42,6 +42,9 @@ export interface SaleUpdateChanges {
     SALE_ORDER_REFERENCE: {
         reference: string;
     };
+    SALE_META_DATA: {
+        metaData: Record<string, unknown>;
+    };
     PRODUCT_UPDATE: {
         id: string;
         indexAddress: Array<number>;

package/lib/Actions/SaleUpdate.js

@@ -19,7 +19,6 @@ class SaleUpdate extends BaseAction_1.BaseAction {
         })(), SaleUpdate);
         this.supportedEvents = [];
         if (typeof data === "undefined" && typeof type !== "string") {
-            type = type;
             this.type = type.properties[0];
             this.data = type.properties[1];
         }

package/lib/Actions/Toast.d.ts

@@ -1,10 +1,9 @@
 import { BaseAction } from "./BaseAction";
 import { Serialized } from "../Common/Serializable";
-declare type ToastType = "success" | "error" | "information" | "warning";
+export declare type ToastType = "success" | "error" | "information" | "warning";
 export declare class Toast extends BaseAction<Toast> {
     protected supportedEvents: string[];
     protected type: ToastType;
     protected message: string;
     constructor(type: Serialized<Toast> | ToastType, message?: string);
 }
-export {};

package/lib/Application.d.ts

@@ -1,10 +1,12 @@
 import { Bridge } from "./Bridge";
-import { DirectShopfrontEvent, FromShopfront, FromShopfrontCallbacks, FromShopfrontInternal, RegisterChangedEvent } from "./ApplicationEvents";
+import { DirectShopfrontEvent, FromShopfront, FromShopfrontCallbacks, FromShopfrontInternal, RegisterChangedEvent, SoundEvents } from "./ApplicationEvents";
 import { Serializable } from "./Common/Serializable";
 import { BaseEmitableEvent } from "./EmitableEvents/BaseEmitableEvent";
 import { Sale } from "./APIs/CurrentSale";
+import { ShopfrontSaleState } from "./APIs/CurrentSale/ShopfrontSaleState";
 import { Database } from "./APIs/Database/Database";
 import { MaybePromise } from "./Utilities/MiscTypes";
+import { BaseEvent } from "./Events/BaseEvent";
 export declare class Application {
     protected bridge: Bridge;
     protected isReady: boolean;
@@ -13,7 +15,7 @@ export declare class Application {
     protected outlet: string | null;
     protected user: string | null;
     protected listeners: {
-        [key in keyof Omit<FromShopfront, "CALLBACK">]: Map<Function, FromShopfront[key]>;
+        [key in keyof Omit<FromShopfront, "CALLBACK">]: Map<(...args: Array<unknown>) => void, FromShopfront[key] & BaseEvent>;
     };
     protected directListeners: {
         [K in DirectShopfrontEvent]?: Set<(data: unknown) => void | Promise<void>>;
@@ -21,22 +23,26 @@ export declare class Application {
     database: Database;
     constructor(bridge: Bridge);
     destroy(): void;
-    protected handleEvent: (event: keyof FromShopfront | keyof FromShopfrontInternal, data: any, id: string) => void;
-    protected emit(event: keyof Omit<FromShopfront, "CALLBACK"> | DirectShopfrontEvent, data: any, id: string): MaybePromise<void>;
+    protected handleEvent: (event: keyof FromShopfront | keyof FromShopfrontInternal, data: Record<string, unknown>, id: string) => void;
+    protected emit(event: keyof Omit<FromShopfront, "CALLBACK"> | DirectShopfrontEvent, data: Record<string, unknown> | undefined, id: string): void | Promise<void>;
     addEventListener<E extends keyof FromShopfrontCallbacks>(event: E, callback: FromShopfrontCallbacks[E]): void;
     addEventListener<D>(event: DirectShopfrontEvent, callback: (event: D) => MaybePromise<void>): void;
-    removeEventListener(event: keyof Omit<FromShopfront, "CALLBACK"> | DirectShopfrontEvent, callback: (...args: Array<any>) => MaybePromise<any>): void;
-    send(item: BaseEmitableEvent<any>): void;
-    send(item: Serializable<any>): void;
+    removeEventListener(event: keyof Omit<FromShopfront, "CALLBACK"> | DirectShopfrontEvent, callback: (...args: Array<unknown>) => MaybePromise<void>): void;
+    send(item: BaseEmitableEvent<unknown>): void;
+    send(item: Serializable<unknown>): void;
     download(file: string): void;
     redirect(toLocation: string, externalRedirect?: boolean): void;
     load(): () => void;
     protected handleEventCallback(data: {
         id?: string;
-        data: any;
+        data: unknown;
     }): void;
     protected handleLocationChanged(data: RegisterChangedEvent): void;
     getAuthenticationKey(): string;
+    protected dataIsSaleEvent(data: Record<string, unknown>): data is {
+        requestId: string;
+        saleState: ShopfrontSaleState | false;
+    };
     /**
      * Get the current sale on the sell screen, if the current device is not a register
      * then this will return false.
@@ -44,6 +50,12 @@ export declare class Application {
      * @returns {Promise<Sale | boolean>}
      */
     getCurrentSale(): Promise<Sale | false>;
+    protected dataIsLocation(data: Record<string, unknown>): data is {
+        requestId: string;
+        register: string | null;
+        outlet: string | null;
+        user: string | null;
+    };
     /**
      * Get the location from Shopfront
      */
@@ -53,4 +65,42 @@ export declare class Application {
         user: string | null;
     }>;
     printReceipt(content: string): void;
+    protected dataIsAudioResponse(data: Record<string, unknown>): data is {
+        requestId: string;
+        success: boolean;
+        message?: string;
+    };
+    protected sendAudioRequest(type: SoundEvents, data?: unknown): Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    /**
+     * Requests permission from the user to be able to play audio
+     */
+    requestAudioPermission(): Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    /**
+     * Requests shopfront to preload audio so that it can be pre-cached before being played
+     * @param url
+     */
+    audioPreload(url: string): Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    /**
+     * Requests the sound to be played
+     * @param url
+     */
+    audioPlay(url: string): Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    protected dataIsOption<TValueType>(data: Record<string, unknown>): data is {
+        requestId: string;
+        option: string;
+        value: TValueType | undefined;
+    };
+    getOption<TValueType>(option: string, defaultValue: TValueType): Promise<TValueType>;
 }