awesome-cordova-plugins/src/plugins/3dtouch.ts

import {Plugin, Cordova} from './plugin';
import {Observable} from 'rxjs/Observable';
declare var window: any;
/**
 * @name 3DTouch
 * @description
 * @usage
 * Please do refer to the original plugin's repo for detailed usage. The usage example here might not be sufficient.
 * ```
 * import {ThreeDeeTouch} from 'ionic-native';
 *
 * // import for type completion on variables
 * import {ThreeDeeTouchQuickAction, ThreeDeeTouchForceTouch} from 'ionic-native';
 * ...
 *
 * ThreeDeeTouch.isAvailable().then(isAvailable => console.log("3D Touch available? " + isAvailable)):
 *
 * ThreeDeeTouch.watchForceTouches()
 *   .subscribe(
 *     (data: ThreeDeeTouchForceTouch) => {
 *       console.log("Force touch %" + data.force);
 *       console.log("Force touch timestamp: " + data.timestamp);
 *       console.log("Force touch x: " + data.x);
 *       console.log("Force touch y: " + data.y);
 *     }
 *   );
 *
 *
 * let actions: Array<ThreeDeeTouchQuickAction> = [
 *   {
 *     type: 'checkin',
 *     title: 'Check in',
 *     subtitle: 'Quickly check in',
 *     iconType: 'Compose'
 *   },
 *   {
 *     type: 'share',
 *     title: 'Share',
 *     subtitle: 'Share like you care',
 *     iconType: 'Share'
 *   },
 *   {
 *     type: 'search',
 *     title: 'Search',
 *     iconType: 'Search'
 *   },
 *   {
 *     title: 'Show favorites',
 *     iconTemplate: 'HeartTemplate'
 *   }
 * ];
 * ThreeDeeTouch.configureQuickActions(actions);
 *
 * ThreeDeeTouchForceTouch.onHomeIconPressed().subscribe(
 *  (payload) => {
 *    // returns an object that is the button you presed
 *    console.log(`Pressed the ${payload.title} button`)
 *    console.log(payload.type)
 *
 *  }
 * )
 * ```
 */
@Plugin({
    plugin: 'cordova-plugin-3dtouch',
    pluginRef: 'ThreeDeeTouch',
    repo: 'https://github.com/EddyVerbruggen/cordova-plugin-3dtouch',
    platforms: ['iOS']
})
export class ThreeDeeTouch {

    /**
     * You need an iPhone 6S or some future tech to use the features of this plugin, so you can check at runtime if the user's device is supported.
     * @returns {Promise<boolean>} returns a promise that resolves with a boolean that indicates whether the plugin is available or not
     */
    @Cordova()
    static isAvailable(): Promise<boolean> {return; }

    /**
     * You can get a notification when the user force touches the webview. The plugin defines a Force Touch when at least 75% of the maximum force is applied to the screen. Your app will receive the x and y coordinates, so you have to figure out which UI element was touched.
     * @returns {Observable<ThreeDeeTouchForceTouch>} Returns an observable that sends a `ThreeDeeTouchForceTouch` object
     */
    @Cordova({
        observable: true
    })
    static watchForceTouches(): Observable<ThreeDeeTouchForceTouch> {return; }

    /**
     * setup the 3D-touch actions, takes an array of objects with the following
     * @param {string} type (optional) A type that can be used `onHomeIconPressed` callback
     * @param {string} title Title for your action
     * @param {string} subtitle (optional) A short description for your action
     * @param {string} iconType (optional) Choose between Prohibit, Contact, Home, MarkLocation, Favorite, Love, Cloud, Invitation, Confirmation, Mail, Message, Date, Time, CapturePhoto, CaptureVideo, Task, TaskCompleted, Alarm, Bookmark, Shuffle, Audio, Update
     */
    @Cordova({
        sync: true
    })
    static configureQuickActions(quickActions: Array<ThreeDeeTouchQuickAction>): void {}

    /**
     * When a home icon is pressed, your app launches and this JS callback is invoked.
     * @returns {Observable<any>} returns an observable that notifies you when he user presses on the home screen icon
     */
    static onHomeIconPressed(): Observable<any> {
      return new Observable(observer => {
        if (window.ThreeDeeTouch && window.ThreeDeeTouch.onHomeIconPressed) window.ThreeDeeTouch.onHomeIconPressed = observer.next.bind(observer);
        else {
          observer.error('3dTouch plugin is not available.');
          observer.complete();
        }
      });
    }

    /**
     * Enable Link Preview.
     * UIWebView and WKWebView (the webviews powering Cordova apps) don't allow the fancy new link preview feature of iOS9.
     */
    @Cordova({
        sync: true
    })
    static enableLinkPreview(): void {}

    /**
     * Disabled the link preview feature, if enabled.
     */
    @Cordova({
        sync: true
    })
    static disableLinkPreview(): void {}
}
export interface ThreeDeeTouchQuickAction {
    type?: string;
    title: string;
    subtitle?: string;
    iconType?: string;
}
export interface ThreeDeeTouchForceTouch {
    force: number;
    timestamp: number;
    x: number;
    y: number;
}