@ibm-aspera/sdk 0.2.29 → 0.2.30

package/dist/commonjs/models/aspera-sdk.model.d.ts

@@ -0,0 +1,245 @@
+import { CustomBrandingOptions, DataTransferResponse, AsperaSdkSpec, AsperaSdkTransfer, FileDialogOptions, FolderDialogOptions, InitOptions, InstallerInfoResponse, InstallerOptions, ModifyTransferOptions, ResumeTransferOptions, SafariExtensionEvent, TransferSpec, WebsocketEvent, InstallerUrlInfo } from './models';
+import { HttpGatewayInfo } from '../http-gateway/models';
+import * as ConnectTypes from '@ibm-aspera/connect-sdk-js/dist/esm/core/types';
+import { Connect, ConnectInstaller } from '@ibm-aspera/connect-sdk-js';
+declare class AsperaSdkGlobals {
+    /** The URL of the IBM Aspera HTTP server to use with the SDK */
+    asperaAppUrl: string;
+    /** The URL of the IBM Aspera Desktop HTTP server to use with the SDK */
+    rpcPort: number;
+    /** The default URL to check for latest Aspera installers */
+    installerUrl: string;
+    /** Aspera SDK info */
+    asperaSdkInfo: AsperaSdkClientInfo;
+    /** Indicate that the server has been verified as working */
+    asperaAppVerified: boolean;
+    /** The unique ID for the website */
+    appId: string;
+    /** Indicate if multiple session is supported */
+    supportMultipleUsers: boolean;
+    /** The session ID for the current user */
+    sessionId?: string;
+    /** Map of drop zones created by querySelector */
+    dropZonesCreated: Map<string, {
+        event: string;
+        callback: (event: any) => void;
+    }[]>;
+    /** HTTP Gateway URL after successful passing */
+    httpGatewayUrl?: string;
+    /** Indicate that the HTTP Gateway has been verified as working */
+    httpGatewayVerified: boolean;
+    /** HTTP Gateway info */
+    httpGatewayInfo?: HttpGatewayInfo;
+    /** Http Gateway IFRAME container */
+    httpGatewayIframeContainer?: HTMLDivElement;
+    /** Connect raw AW4 objects */
+    connectAW4?: {
+        Connect: typeof Connect;
+        ConnectInstaller: typeof ConnectInstaller;
+    };
+    /** Connect instance */
+    connect?: ConnectTypes.ConnectClientType;
+    /** Connect installer instance */
+    connectInstaller?: ConnectTypes.ConnectInstallerClientType;
+    /** Connect status */
+    connectStatus: ConnectTypes.ConnectStatusStrings;
+    backupLaunchMethod(url: string): void;
+    /**
+     * Launch the IBM Aspera App via protocol url. By default, a hidden IFRAME attempts to
+     * open the app but if that fails a fallback of opening a new window happens.
+     */
+    launch(): void;
+    get sdkResponseData(): AsperaSdkInfo;
+}
+export interface AsperaSdkClientInfo {
+    /** The version of IBM Aspera SDK */
+    version: string;
+    /** The public key corresponding to the SSH private key generated by IBM Aspera */
+    client_pubkey?: string;
+}
+export type AsperaSdkInfo = AsperaSdkClientInfo & {
+    verified: boolean;
+    httpGateway: {
+        verified: boolean;
+        url?: string;
+        info?: HttpGatewayInfo;
+    };
+    connect: {
+        active: boolean;
+        status: ConnectTypes.ConnectStatusStrings;
+    };
+};
+export interface TransferResponse {
+    transfers: AsperaSdkTransfer[];
+}
+export type ActivityMessageTypes = 'transferUpdated' | 'transferRemoved';
+export interface ActivityMessage {
+    type: ActivityMessageTypes;
+    data: unknown;
+}
+export declare class ActivityTracking {
+    /** Map of callbacks that receive transfer update events */
+    private activity_callbacks;
+    /** Map of callbacks that receive connection events */
+    private event_callbacks;
+    /** Keep track of the last WebSocket event **/
+    private lastWebSocketEvent;
+    /** Keep track of the last notified WebSocket event **/
+    private lastNotifiedWebSocketEvent;
+    /**
+     * Notify all consumers when a message is received from the websocket
+     *
+     * @param message the message received from the websocket
+     */
+    handleTransferActivity(message: ActivityMessage): void;
+    /**
+     * Handle and notify if needed when a connection webSocketEvent occurs. For example, when the SDK
+     * websocket connection to IBM Aspera App is closed or reconnected.
+     *
+     * @param webSocketEvent the event type.
+     */
+    handleWebSocketEvents(webSocketEvent: WebsocketEvent): void;
+    /**
+     * Notify all consumers when a connection webSocketEvent occurs.
+     *
+     * @param webSocketEvent the event type.
+     */
+    private notifyWebSocketEvent;
+    /** Trigger manual event for other event types. */
+    sendManualEventCallback(status: string): void;
+    /**
+     * Notify all consumers when the client changes status. For example, when
+     * IBM Aspera App is launched or closed.
+     *
+     * @param running whether the client is running or not.
+     */
+    handleClientEvents(running: boolean): void;
+    /**
+     * Notify all consumers when a Safari extension safariExtensionEvent occurs (enabled/disabled).
+     *
+     * @param safariExtensionEvent the event type.
+     */
+    handleSafariExtensionEvents(safariExtensionEvent: SafariExtensionEvent): void;
+    /**
+     * Set up the activity tracking with IBM Aspera.
+     *
+     * @returns a promise that resolves when the websocket connection is established.
+     * Currently, this promise does not reject.
+     */
+    setup(): Promise<unknown>;
+    /**
+     * Register a callback for getting transfers back to the consumer
+     *
+     * @param callback the function to call with the array of transfers
+     *
+     * @returns the ID of the callback index
+     */
+    setCallback(callback: (transfers: TransferResponse) => void): string;
+    /**
+     * Remove the callback (deregister) from the list of callbacks
+     *
+     * @param id the string of the callback to remove
+     */
+    removeCallback(id: string): void;
+    /**
+     * Register a callback for getting websocket events back to the consumer
+     *
+     * @param callback the function to call with the websocket event
+     *
+     * @returns the ID of the callback index
+     */
+    setWebSocketEventCallback(callback: (status: WebsocketEvent) => void): string;
+    /**
+     * Remove the callback (deregister) from the list of callbacks
+     *
+     * @param id the string of the callback to remove
+     */
+    removeWebSocketEventCallback(id: string): void;
+    private registerDesktopAppSession;
+}
+export declare class AsperaSdk {
+    /** Global information about IBM Aspera */
+    globals: AsperaSdkGlobals;
+    /** Activity tracking for watching transfers */
+    activityTracking: ActivityTracking;
+    /** HTTP Gateway file store. Key is the file name. */
+    httpGatewaySelectedFiles: Map<string, File>;
+    /** Function to initialize IBM Aspera */
+    init: (options: InitOptions) => Promise<any>;
+    /** Function to test the IBM Aspera status */
+    testConnection: () => Promise<any>;
+    /** Function to initiate a transfer */
+    startTransfer: (transferSpec: TransferSpec, AsperaSdkSpec: AsperaSdkSpec) => Promise<AsperaSdkTransfer>;
+    /** Function to launch IBM Aspera */
+    launch: () => void;
+    /** Register callback for the transfer activity monitor */
+    registerActivityCallback: (callback: (transfers: TransferResponse) => void) => string;
+    /** Deregister callback to remove it from the callbacks getting transfer data */
+    deregisterActivityCallback: (id: string) => void;
+    /** Register callback for connection status events from the app */
+    registerStatusCallback: (callback: (status: WebsocketEvent) => void) => string;
+    /** Deregister callback to remove it from the callbacks getting connection events */
+    deregisterStatusCallback: (id: string) => void;
+    /** Function to remove a transfer */
+    removeTransfer: (transferId: string) => Promise<any>;
+    /** Function to show the transfer's download directory in Finder or Windows Explorer */
+    showDirectory: (transferId: string) => Promise<any>;
+    /** Function to stop a transfer */
+    stopTransfer: (transferId: string) => Promise<any>;
+    /** Function to resume a transfer */
+    resumeTransfer: (transferId: string, options?: ResumeTransferOptions) => Promise<AsperaSdkTransfer>;
+    /** Function to get a list of all transfers */
+    getAllTransfers: () => Promise<AsperaSdkTransfer[]>;
+    /** Function to get information for a specific transfer */
+    getTransfer: (transferId: string) => Promise<AsperaSdkTransfer>;
+    /** Function to display a file dialog for the user to select files. */
+    showSelectFileDialog: (options?: FileDialogOptions) => Promise<DataTransferResponse>;
+    /** Function to display a folder dialog for the user to select folders. */
+    showSelectFolderDialog: (options?: FolderDialogOptions) => Promise<DataTransferResponse>;
+    /** Function to display the IBM Aspera preferences page */
+    showPreferences: () => Promise<any>;
+    /** Function to modify a running transfer */
+    modifyTransfer: (transferId: string, options: ModifyTransferOptions) => Promise<AsperaSdkTransfer>;
+    /** Function to set custom branding for IBM Aspera */
+    setBranding: (id: string, options: CustomBrandingOptions) => Promise<any>;
+    /** Create dropzone for drop events of files */
+    createDropzone: (callback: (data: {
+        event: any;
+        files: DataTransferResponse;
+    }) => void, elementSelector: string) => void;
+    /** Remove dropzone for drop events of files */
+    removeDropzone: (elementSelector: string) => void;
+    /** Function to get latest installer information */
+    getInstallerInfo: (options: InstallerOptions) => Promise<InstallerInfoResponse>;
+    /** Initialize drag and drop */
+    initDragDrop: () => Promise<any>;
+    /** Function to get information about the IBM Aspera instance */
+    getInfo: () => Promise<AsperaSdkInfo>;
+    /** Function to get whether IBM Aspera is running on Safari */
+    isSafari: () => boolean;
+    /** Function to get URLs for installer management. */
+    getInstallerUrls: () => InstallerUrlInfo;
+    /** Indicate if Safari Extension is enabled. If the extension is disabled during the lifecycle this will not update to disabled. */
+    SAFARI_EXTENSION_STATUS: SafariExtensionEvent;
+    /** Aspera HTTP Gateway calls. This normally is not needed by clients but expose just in case. */
+    httpGatewayCalls: unknown;
+    /** Store of HTTP Gateway transfers */
+    httpGatewayTransferStore: Map<string, AsperaSdkTransfer>;
+    /** HTTP Gateway in app threshold limit. This can be changed globally for the app. */
+    httpGatewayInBrowserDownloadThreshold: number;
+    /**
+     * Check if IBM Aspera is ready to be used and has been verified.
+     *
+     * @returns a boolean indicating if SDK can be used for requests
+     */
+    get isReady(): boolean;
+    /** Indicate that Connect is available. */
+    get useConnect(): boolean;
+    /** Indicate that HTTP Gateway is available. */
+    get httpGatewayIsReady(): boolean;
+    /** Indicates if internal calls should use Gateway */
+    get useHttpGateway(): boolean;
+    /** Indicates if old HTTP Gateway SDK should be used (v2 and lower) */
+    get useOldHttpGateway(): boolean;
+}
+export {};

package/dist/commonjs/models/aspera-sdk.model.js

@@ -0,0 +1,345 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsperaSdk = exports.ActivityTracking = void 0;
+var constants_1 = require("../constants/constants");
+var messages_1 = require("../constants/messages");
+var safari_client_1 = require("../helpers/client/safari-client");
+var client_1 = require("../helpers/client/client");
+var helpers_1 = require("../helpers/helpers");
+var ws_1 = require("../helpers/ws");
+var index_1 = require("../index");
+var AsperaSdkGlobals = /** @class */ (function () {
+    function AsperaSdkGlobals() {
+        /** The URL of the IBM Aspera HTTP server to use with the SDK */
+        this.asperaAppUrl = 'http://127.0.0.1';
+        /** The URL of the IBM Aspera Desktop HTTP server to use with the SDK */
+        this.rpcPort = 33024;
+        /** The default URL to check for latest Aspera installers */
+        this.installerUrl = constants_1.installerUrl;
+        /** Indicate that the server has been verified as working */
+        this.asperaAppVerified = false;
+        /** Indicate if multiple session is supported */
+        this.supportMultipleUsers = false;
+        /** Map of drop zones created by querySelector */
+        this.dropZonesCreated = new Map();
+        /** Indicate that the HTTP Gateway has been verified as working */
+        this.httpGatewayVerified = false;
+        /** Connect status */
+        this.connectStatus = 'WAITING';
+    }
+    AsperaSdkGlobals.prototype.backupLaunchMethod = function (url) {
+        window.alert(messages_1.messages.loadingProtocol);
+        window.location.href = url;
+    };
+    /**
+     * Launch the IBM Aspera App via protocol url. By default, a hidden IFRAME attempts to
+     * open the app but if that fails a fallback of opening a new window happens.
+     */
+    AsperaSdkGlobals.prototype.launch = function () {
+        var _this = this;
+        try {
+            var element = document.createElement('iframe');
+            element.src = constants_1.protocol;
+            element.onerror = function (error) {
+                (0, helpers_1.errorLog)(messages_1.messages.failedToGenerateIframe, error);
+                _this.backupLaunchMethod(constants_1.protocol);
+            };
+            element.setAttribute('style', constants_1.hiddenStyleList);
+            document.body.appendChild(element);
+        }
+        catch (error) {
+            (0, helpers_1.errorLog)(messages_1.messages.failedToGenerateIframe, error);
+            this.backupLaunchMethod(constants_1.protocol);
+        }
+    };
+    Object.defineProperty(AsperaSdkGlobals.prototype, "sdkResponseData", {
+        get: function () {
+            return __assign(__assign({ verified: this.asperaAppVerified }, this.asperaSdkInfo), { httpGateway: {
+                    verified: this.httpGatewayVerified,
+                    url: this.httpGatewayUrl,
+                    info: this.httpGatewayInfo,
+                }, connect: {
+                    active: this.connectStatus === 'RUNNING',
+                    status: this.connectStatus,
+                } });
+        },
+        enumerable: false,
+        configurable: true
+    });
+    return AsperaSdkGlobals;
+}());
+var ActivityTracking = /** @class */ (function () {
+    function ActivityTracking() {
+        /** Map of callbacks that receive transfer update events */
+        this.activity_callbacks = new Map();
+        /** Map of callbacks that receive connection events */
+        this.event_callbacks = new Map();
+        /** Keep track of the last WebSocket event **/
+        this.lastWebSocketEvent = 'CLOSED';
+        /** Keep track of the last notified WebSocket event **/
+        this.lastNotifiedWebSocketEvent = undefined;
+    }
+    /**
+     * Notify all consumers when a message is received from the websocket
+     *
+     * @param message the message received from the websocket
+     */
+    ActivityTracking.prototype.handleTransferActivity = function (message) {
+        if (message.type === 'transferUpdated' || message.type === 'transferRemoved') {
+            this.activity_callbacks.forEach(function (callback) {
+                if (typeof callback === 'function') {
+                    callback(message.data);
+                }
+            });
+        }
+    };
+    /**
+     * Handle and notify if needed when a connection webSocketEvent occurs. For example, when the SDK
+     * websocket connection to IBM Aspera App is closed or reconnected.
+     *
+     * @param webSocketEvent the event type.
+     */
+    ActivityTracking.prototype.handleWebSocketEvents = function (webSocketEvent) {
+        if (this.lastWebSocketEvent === webSocketEvent) {
+            return;
+        }
+        this.lastWebSocketEvent = webSocketEvent;
+        this.notifyWebSocketEvent(webSocketEvent);
+    };
+    /**
+     * Notify all consumers when a connection webSocketEvent occurs.
+     *
+     * @param webSocketEvent the event type.
+     */
+    ActivityTracking.prototype.notifyWebSocketEvent = function (webSocketEvent) {
+        if (this.lastNotifiedWebSocketEvent === webSocketEvent) {
+            return;
+        }
+        this.lastNotifiedWebSocketEvent = webSocketEvent;
+        this.event_callbacks.forEach(function (callback) {
+            if (typeof callback === 'function') {
+                callback(webSocketEvent);
+            }
+        });
+    };
+    /** Trigger manual event for other event types. */
+    ActivityTracking.prototype.sendManualEventCallback = function (status) {
+        this.event_callbacks.forEach(function (callback) {
+            if (typeof callback === 'function') {
+                callback(status);
+            }
+        });
+    };
+    /**
+     * Notify all consumers when the client changes status. For example, when
+     * IBM Aspera App is launched or closed.
+     *
+     * @param running whether the client is running or not.
+     */
+    ActivityTracking.prototype.handleClientEvents = function (running) {
+        var webSocketEvent;
+        if (!running) {
+            webSocketEvent = 'CLOSED';
+        }
+        else {
+            webSocketEvent = this.lastWebSocketEvent;
+        }
+        this.notifyWebSocketEvent(webSocketEvent);
+    };
+    /**
+     * Notify all consumers when a Safari extension safariExtensionEvent occurs (enabled/disabled).
+     *
+     * @param safariExtensionEvent the event type.
+     */
+    ActivityTracking.prototype.handleSafariExtensionEvents = function (safariExtensionEvent) {
+        index_1.asperaSdk.SAFARI_EXTENSION_STATUS = safariExtensionEvent;
+    };
+    /**
+     * Set up the activity tracking with IBM Aspera.
+     *
+     * @returns a promise that resolves when the websocket connection is established.
+     * Currently, this promise does not reject.
+     */
+    ActivityTracking.prototype.setup = function () {
+        var _this = this;
+        if (index_1.asperaSdk.globals.sessionId) {
+            this.registerDesktopAppSession();
+        }
+        var finalCall = function () {
+            if ((0, helpers_1.isSafari)()) {
+                return safari_client_1.safariClient.monitorTransferActivity();
+            }
+            return ws_1.websocketService.init()
+                .then(function () {
+                ws_1.websocketService.registerMessage('transfer_activity', function (data) { return _this.handleTransferActivity(data); });
+                ws_1.websocketService.registerEvent(function (status) { return _this.handleWebSocketEvents(status); });
+            });
+        };
+        if (index_1.asperaSdk.globals.supportMultipleUsers) {
+            var retryCount_1 = 0;
+            var makeVerifyCall_1 = function (incrementIt) {
+                if (incrementIt) {
+                    index_1.asperaSdk.globals.rpcPort = index_1.asperaSdk.globals.rpcPort + 1;
+                }
+                if (index_1.asperaSdk.globals.rpcPort > 33029) {
+                    retryCount_1++;
+                    index_1.asperaSdk.globals.rpcPort = 33024;
+                    return new Promise(function (resolve) { return setTimeout(resolve, retryCount_1 * 1050); }).then(function () { return makeVerifyCall_1(false); });
+                }
+                return client_1.client.request('verify_session', { app_id: index_1.asperaSdk.globals.appId, session_id: index_1.asperaSdk.globals.sessionId })
+                    .then(function (data) {
+                    if (data.result) {
+                        return finalCall();
+                    }
+                    return makeVerifyCall_1(true);
+                }).catch(function () {
+                    if (retryCount_1 > 5) {
+                        index_1.asperaSdk.globals.rpcPort = 33024;
+                        return Promise.reject('Unable to find port running for session');
+                    }
+                    return makeVerifyCall_1(true);
+                });
+            };
+            return makeVerifyCall_1(false);
+        }
+        else {
+            return finalCall();
+        }
+    };
+    /**
+     * Register a callback for getting transfers back to the consumer
+     *
+     * @param callback the function to call with the array of transfers
+     *
+     * @returns the ID of the callback index
+     */
+    ActivityTracking.prototype.setCallback = function (callback) {
+        if (typeof callback !== 'function') {
+            (0, helpers_1.errorLog)(messages_1.messages.callbackIsNotFunction);
+            return;
+        }
+        var id = "callback-".concat(this.activity_callbacks.size + 1);
+        this.activity_callbacks.set(id, callback);
+        return id;
+    };
+    /**
+     * Remove the callback (deregister) from the list of callbacks
+     *
+     * @param id the string of the callback to remove
+     */
+    ActivityTracking.prototype.removeCallback = function (id) {
+        this.activity_callbacks.delete(id);
+    };
+    /**
+     * Register a callback for getting websocket events back to the consumer
+     *
+     * @param callback the function to call with the websocket event
+     *
+     * @returns the ID of the callback index
+     */
+    ActivityTracking.prototype.setWebSocketEventCallback = function (callback) {
+        if (typeof callback !== 'function') {
+            (0, helpers_1.errorLog)(messages_1.messages.callbackIsNotFunction);
+            return;
+        }
+        var id = "callback-".concat(this.event_callbacks.size + 1);
+        this.event_callbacks.set(id, callback);
+        callback(this.lastWebSocketEvent);
+        return id;
+    };
+    /**
+     * Remove the callback (deregister) from the list of callbacks
+     *
+     * @param id the string of the callback to remove
+     */
+    ActivityTracking.prototype.removeWebSocketEventCallback = function (id) {
+        this.event_callbacks.delete(id);
+    };
+    ActivityTracking.prototype.registerDesktopAppSession = function () {
+        var iframe = document.createElement('iframe');
+        iframe.style.display = 'none';
+        iframe.src = "aspera://initialize?app_id=".concat(index_1.asperaSdk.globals.appId, "&session_id=").concat(index_1.asperaSdk.globals.sessionId);
+        document.body.appendChild(iframe);
+        setTimeout(function () {
+            document.body.removeChild(iframe);
+        }, 1000);
+    };
+    return ActivityTracking;
+}());
+exports.ActivityTracking = ActivityTracking;
+var AsperaSdk = /** @class */ (function () {
+    function AsperaSdk() {
+        /** Global information about IBM Aspera */
+        this.globals = new AsperaSdkGlobals();
+        /** Activity tracking for watching transfers */
+        this.activityTracking = new ActivityTracking();
+        /** HTTP Gateway file store. Key is the file name. */
+        this.httpGatewaySelectedFiles = new Map();
+        /** Indicate if Safari Extension is enabled. If the extension is disabled during the lifecycle this will not update to disabled. */
+        this.SAFARI_EXTENSION_STATUS = 'DISABLED';
+        /** Store of HTTP Gateway transfers */
+        this.httpGatewayTransferStore = new Map();
+        /** HTTP Gateway in app threshold limit. This can be changed globally for the app. */
+        this.httpGatewayInBrowserDownloadThreshold = 1000000000;
+    }
+    Object.defineProperty(AsperaSdk.prototype, "isReady", {
+        /**
+         * Check if IBM Aspera is ready to be used and has been verified.
+         *
+         * @returns a boolean indicating if SDK can be used for requests
+         */
+        get: function () {
+            return this.globals.asperaAppVerified && this.globals.appId !== '';
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AsperaSdk.prototype, "useConnect", {
+        /** Indicate that Connect is available. */
+        get: function () {
+            return this.globals.connectStatus === 'RUNNING';
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AsperaSdk.prototype, "httpGatewayIsReady", {
+        /** Indicate that HTTP Gateway is available. */
+        get: function () {
+            return !!this.globals.httpGatewayVerified;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AsperaSdk.prototype, "useHttpGateway", {
+        /** Indicates if internal calls should use Gateway */
+        get: function () {
+            return this.httpGatewayIsReady && !this.isReady && !this.useConnect;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(AsperaSdk.prototype, "useOldHttpGateway", {
+        /** Indicates if old HTTP Gateway SDK should be used (v2 and lower) */
+        get: function () {
+            if (!this.useHttpGateway) {
+                return false;
+            }
+            return Number(this.globals.httpGatewayInfo.version.split('.')[0] || 3) <= 2;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    return AsperaSdk;
+}());
+exports.AsperaSdk = AsperaSdk;