@ibm-aspera/sdk 0.19.1 → 0.20.0

package/dist/commonjs/http-gateway/core.js

@@ -4,7 +4,7 @@ exports.httpGatewayReadChunkAsArrayBuffer = exports.httpGatewayReadAsArrayBuffer
 var messages_1 = require("../constants/messages");
 var helpers_1 = require("../helpers/helpers");
 var index_1 = require("../index");
-var http_gateway_sdk_js_1 = require("@ibm-aspera/http-gateway-sdk-js");
+var v2_1 = require("./v2");
 // Maximum file size for generating image previews for files. 50MiB matches the limits in both Connect and IBM Aspera for desktop.
 var MAX_FILE_SIZE = 50 * 1024 * 1024;
 /**
@@ -45,17 +45,14 @@ var initHttpGateway = function (response) {
     index_1.asperaSdk.globals.httpGatewayRoutePrefix = majorVersion >= 3 ? '/v3' : '';
     if (index_1.asperaSdk.useOldHttpGateway) {
         // Watch for old HTTP Gateway transfers in case used.
-        (0, http_gateway_sdk_js_1.registerActivityCallback)(function (oldHttpTransfers) {
+        (0, v2_1.registerActivityCallback)(function (oldHttpTransfers) {
             oldHttpTransfers.transfers.forEach(function (oldHttpTransfer) {
                 var transfer = oldHttpTransfer;
-                // The HTTP Gateway v2 SDK uses "canceled" but we standardize on "cancelled"
-                if (transfer.status === 'canceled') {
-                    transfer.status = 'cancelled';
-                }
+                transfer.transfer_client = 'http-gateway';
                 (0, exports.sendTransferUpdate)(transfer);
             });
         });
-        return (0, http_gateway_sdk_js_1.initHttpGateway)(index_1.asperaSdk.globals.httpGatewayUrl).then(function () { });
+        return (0, v2_1.initHttpGateway)(index_1.asperaSdk.globals.httpGatewayUrl).then(function () { });
     }
     var iframeContainer = document.createElement('div');
     iframeContainer.id = 'aspera-http-gateway-iframes';
@@ -107,7 +104,7 @@ exports.setupHttpGateway = setupHttpGateway;
  */
 var httpStopTransfer = function (id) {
     if (index_1.asperaSdk.useOldHttpGateway) {
-        (0, http_gateway_sdk_js_1.cancelTransfer)(id);
+        (0, v2_1.cancelTransfer)(id);
         return Promise.resolve();
     }
     var transfer = index_1.asperaSdk.httpGatewayTransferStore.get(id);
@@ -135,7 +132,7 @@ exports.httpStopTransfer = httpStopTransfer;
  */
 var httpRemoveTransfer = function (id) {
     if (index_1.asperaSdk.useOldHttpGateway) {
-        (0, http_gateway_sdk_js_1.removeTransfer)(id);
+        (0, v2_1.removeTransfer)(id);
         return Promise.resolve({ removed: true });
     }
     /* Cancel the transfer before removing it.
@@ -159,7 +156,7 @@ exports.httpRemoveTransfer = httpRemoveTransfer;
  */
 var httpGetAllTransfers = function () {
     if (index_1.asperaSdk.useOldHttpGateway) {
-        return (0, http_gateway_sdk_js_1.getAllTransfers)().transfers;
+        return (0, v2_1.getAllTransfers)().transfers;
     }
     return Array.from(index_1.asperaSdk.httpGatewayTransferStore.values());
 };
@@ -171,7 +168,7 @@ exports.httpGetAllTransfers = httpGetAllTransfers;
  */
 var httpGetTransfer = function (id) {
     if (index_1.asperaSdk.useOldHttpGateway) {
-        return (0, http_gateway_sdk_js_1.getTransferById)(id);
+        return (0, v2_1.getTransferById)(id);
     }
     return index_1.asperaSdk.httpGatewayTransferStore.get(id);
 };
@@ -251,7 +248,7 @@ exports.handleHttpGatewayDrop = handleHttpGatewayDrop;
  */
 var httpGatewaySelectFileFolderDialog = function (options, folder) {
     if (index_1.asperaSdk.useOldHttpGateway) {
-        return (folder ? (0, http_gateway_sdk_js_1.getFoldersForUploadPromise)((options === null || options === void 0 ? void 0 : options.http_gateway_v2_transfer_id) || '') : (0, http_gateway_sdk_js_1.getFilesForUploadPromise)((options === null || options === void 0 ? void 0 : options.http_gateway_v2_transfer_id) || ''));
+        return (folder ? (0, v2_1.getFoldersForUploadPromise)((options === null || options === void 0 ? void 0 : options.http_gateway_v2_transfer_id) || '') : (0, v2_1.getFilesForUploadPromise)((options === null || options === void 0 ? void 0 : options.http_gateway_v2_transfer_id) || ''));
     }
     var _a = (0, helpers_1.generatePromiseObjects)(), promise = _a.promise, rejecter = _a.rejecter, resolver = _a.resolver;
     var element = (0, exports.createHtmlInputElement)();
@@ -315,6 +312,7 @@ var getSdkTransfer = function (transferSpec) {
         percentage: 0,
         title: '',
         remaining_usec: 0,
+        transfer_client: 'http-gateway',
         httpGatewayTransfer: true,
         httpDownloadExternalHandle: false,
     };

package/dist/commonjs/http-gateway/download.js

@@ -5,7 +5,7 @@ var index_1 = require("../index");
 var helpers_1 = require("../helpers/helpers");
 var messages_1 = require("../constants/messages");
 var core_1 = require("./core");
-var http_gateway_sdk_js_1 = require("@ibm-aspera/http-gateway-sdk-js");
+var v2_1 = require("./v2");
 /**
  * HTTP Gateway Download Logic for presigned flow
  * Presigned flow is when used files are too large or unknown file size
@@ -173,7 +173,7 @@ var httpDownload = function (transferSpec, asperaSdkSpec) {
         return (0, helpers_1.throwError)(messages_1.messages.serverNotVerified, { type: 'download' });
     }
     if (index_1.asperaSdk.useOldHttpGateway) {
-        return (0, http_gateway_sdk_js_1.download)(transferSpec);
+        return (0, v2_1.download)(transferSpec);
     }
     if (transferSpec.tags &&
         transferSpec.tags.aspera &&

package/dist/commonjs/http-gateway/upload.js

@@ -5,7 +5,7 @@ var index_1 = require("../index");
 var helpers_1 = require("../helpers/helpers");
 var messages_1 = require("../constants/messages");
 var core_1 = require("./core");
-var http_gateway_sdk_js_1 = require("@ibm-aspera/http-gateway-sdk-js");
+var v2_1 = require("./v2");
 /**
  * HTTP Gateway Upload Logic
  *
@@ -23,7 +23,7 @@ var httpUpload = function (transferSpec, asperaSdkSpec) {
         return (0, helpers_1.throwError)(messages_1.messages.serverNotVerified, { type: 'upload' });
     }
     if (index_1.asperaSdk.useOldHttpGateway) {
-        return (0, http_gateway_sdk_js_1.upload)(transferSpec, (asperaSdkSpec === null || asperaSdkSpec === void 0 ? void 0 : asperaSdkSpec.http_gateway_v2_transfer_id) || '');
+        return (0, v2_1.upload)(transferSpec, (asperaSdkSpec === null || asperaSdkSpec === void 0 ? void 0 : asperaSdkSpec.http_gateway_v2_transfer_id) || '');
     }
     var promiseInfo = (0, helpers_1.generatePromiseObjects)();
     var request = new XMLHttpRequest();

package/dist/commonjs/http-gateway/v2/app/core.d.ts

@@ -0,0 +1,84 @@
+import { TransferResponse } from '../models/http-gateway-global.model';
+import { HttpTransfer } from '../models/models';
+/**
+ * Check if HTTP Gateway server connection works. This function is called by init
+ * when initializing the SDK.  This function can be used at any point for sanity checking.
+ *
+ * @returns promise that resolves if server can connect or rejects if server unable to connect
+ */
+export declare const testHttpGatewayConnection: () => Promise<any>;
+export declare const cleanupServerUrl: (serverUrl: string) => string;
+/**
+ * Initialize HTTP gateway client. If client cannot (reject/catch)
+ * client should attempt fixing server URL or trying again. If still fails disable UI elements.
+ * If supportMultipleServers is used the failure of the first test will not lock out the SDK.
+ *
+ * @param serverUrl URL indicating location of the HTTP server
+ * @param softwareMode indicate if the SDK should run in software mode instead of DOM mode
+ * @param supportMultipleServers indicates if the SDK should support multiple servers (not restricting to setup server)
+ *
+ * @returns a promise that resolves if HTTP Gateway is running properly or rejects if unable to load
+ */
+export declare const initHttpGateway: (serverUrl: string, softwareMode?: boolean, supportMultipleServers?: boolean) => Promise<any>;
+/**
+ * Register a callback event for getting transfer data
+ *
+ * @param callback callback function to receive transfers
+ *
+ * @returns ID representing the callback for deregistration purposes
+ */
+export declare const registerActivityCallback: (callback: (transfers: TransferResponse) => void) => string;
+/**
+ * Remove a callback from the transfer callback
+ * @param id the ID returned by `registerActivityCallback`
+ */
+export declare const deregisterActivityCallback: (id: string) => void;
+/**
+ * Returns the transfer requested based on the uuid of the transfer.
+ * NOTE: transferId from Node is not accepted as an ID.  It must be the ID used by the HTTP Gateway.
+ *
+ * @param id gateway based ID of the HTTP part of the transfer
+ *
+ * @returns an object containing the transfer (or undefined if not found) located at key `transfer_info`
+ */
+export declare const getTransferById: (id: string) => {
+    transfer_info: HttpTransfer;
+};
+/**
+ * Get transfer response object including all transfers
+ *
+ * @returns transfer data object with transfers array
+ */
+export declare const getAllTransfers: () => TransferResponse;
+/**
+ * Remove all transfers that are not active
+ */
+export declare const clearNonActiveTransfers: () => void;
+/**
+ * Removes a transfer from the transfers list in HTTP Gateway
+ * If an active transfer is removed it will continue to be uploaded/downloaded but progress will not be tracked
+ *
+ * @param id HTTP Gateway transfer uuid
+ */
+export declare const removeTransfer: (id: string) => void;
+/**
+ * Cancel a transfer from the transfers list in HTTP Gateway
+ *
+ * @param id HTTP Gateway transfer uuid
+ */
+export declare const cancelTransfer: (id: string) => void;
+declare const _default: {
+    initHttpGateway: (serverUrl: string, softwareMode?: boolean, supportMultipleServers?: boolean) => Promise<any>;
+    testHttpGatewayConnection: () => Promise<any>;
+    registerActivityCallback: (callback: (transfers: TransferResponse) => void) => string;
+    cleanupServerUrl: (serverUrl: string) => string;
+    deregisterActivityCallback: (id: string) => void;
+    getTransferById: (id: string) => {
+        transfer_info: HttpTransfer;
+    };
+    getAllTransfers: () => TransferResponse;
+    clearNonActiveTransfers: () => void;
+    removeTransfer: (id: string) => void;
+    cancelTransfer: (id: string) => void;
+};
+export default _default;

package/dist/commonjs/http-gateway/v2/app/core.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cancelTransfer = exports.removeTransfer = exports.clearNonActiveTransfers = exports.getAllTransfers = exports.getTransferById = exports.deregisterActivityCallback = exports.registerActivityCallback = exports.initHttpGateway = exports.cleanupServerUrl = exports.testHttpGatewayConnection = void 0;
+var index_1 = require("../index");
+var helpers_1 = require("../helpers/helpers");
+var messages_1 = require("../constants/messages");
+var http_1 = require("../helpers/http");
+/**
+ * Check if HTTP Gateway server connection works. This function is called by init
+ * when initializing the SDK.  This function can be used at any point for sanity checking.
+ *
+ * @returns promise that resolves if server can connect or rejects if server unable to connect
+ */
+var testHttpGatewayConnection = function () {
+    if (!index_1.asperaHttpGateway.globals.serverUrl && !index_1.asperaHttpGateway.globals.supportMultipleServers) {
+        (0, helpers_1.errorLog)(messages_1.messages.serverUrlNotSet);
+        return new Promise(function (resolve, reject) {
+            reject((0, helpers_1.generateErrorBody)(messages_1.messages.serverUrlNotSet));
+        });
+    }
+    var promiseInfo = (0, helpers_1.generatePromiseObjects)();
+    var backupServerData = {
+        endpoints: [
+            '/aspera/http-gwy/v1/info',
+            '/aspera/http-gwy/v1/upload',
+            '/aspera/http-gwy/v2/upload',
+            '/aspera/http-gwy/v1/download'
+        ],
+        name: 'IBM Aspera HTTP Gateway',
+        version: '2.3.0',
+        sdkVerificationFailed: true,
+    };
+    (0, http_1.apiGet)("".concat(index_1.asperaHttpGateway.globals.serverUrl || '', "/v1/info")).then(function (response) {
+        response.json().then(function (data) {
+            index_1.asperaHttpGateway.globals.serverInfo = data;
+            index_1.asperaHttpGateway.globals.serverVerified = true;
+            if (Number(index_1.asperaHttpGateway.globals.serverInfo.version.split('.')[0] || 0) >= 3) {
+                promiseInfo.rejecter((0, helpers_1.generateErrorBody)(messages_1.messages.versionNotsupported, data));
+                return;
+            }
+            console.warn(messages_1.messages.deprecationWarning);
+            promiseInfo.resolver(data);
+        });
+    }).catch(function (error) {
+        (0, helpers_1.errorLog)(messages_1.messages.serverError, error);
+        if (index_1.asperaHttpGateway.globals.supportMultipleServers) {
+            index_1.asperaHttpGateway.globals.serverInfo = backupServerData;
+            index_1.asperaHttpGateway.globals.serverVerified = true;
+            promiseInfo.resolver(backupServerData);
+        }
+        else {
+            index_1.asperaHttpGateway.globals.serverVerified = false;
+            promiseInfo.rejecter((0, helpers_1.generateErrorBody)(messages_1.messages.serverError, error));
+        }
+    });
+    return promiseInfo.promise;
+};
+exports.testHttpGatewayConnection = testHttpGatewayConnection;
+var cleanupServerUrl = function (serverUrl) {
+    if (typeof serverUrl !== 'string') {
+        return '';
+    }
+    if (serverUrl[serverUrl.length - 1] === '/') {
+        serverUrl = serverUrl.slice(0, -1);
+    }
+    return serverUrl.replace('/v1', '/').replace(/\/$/, '').replace(/\/$/, '');
+};
+exports.cleanupServerUrl = cleanupServerUrl;
+/**
+ * Initialize HTTP gateway client. If client cannot (reject/catch)
+ * client should attempt fixing server URL or trying again. If still fails disable UI elements.
+ * If supportMultipleServers is used the failure of the first test will not lock out the SDK.
+ *
+ * @param serverUrl URL indicating location of the HTTP server
+ * @param softwareMode indicate if the SDK should run in software mode instead of DOM mode
+ * @param supportMultipleServers indicates if the SDK should support multiple servers (not restricting to setup server)
+ *
+ * @returns a promise that resolves if HTTP Gateway is running properly or rejects if unable to load
+ */
+var initHttpGateway = function (serverUrl, softwareMode, supportMultipleServers) {
+    if (!(0, helpers_1.isValidUrl)(serverUrl)) {
+        return new Promise(function (resolve, reject) {
+            reject((0, helpers_1.generateErrorBody)(messages_1.messages.invalidServerUrl));
+        });
+    }
+    index_1.asperaHttpGateway.globals.setUpServer((0, exports.cleanupServerUrl)(serverUrl), softwareMode, supportMultipleServers);
+    return (0, exports.testHttpGatewayConnection)();
+};
+exports.initHttpGateway = initHttpGateway;
+/**
+ * Register a callback event for getting transfer data
+ *
+ * @param callback callback function to receive transfers
+ *
+ * @returns ID representing the callback for deregistration purposes
+ */
+var registerActivityCallback = function (callback) {
+    return index_1.asperaHttpGateway.activityTracking.setCallback(callback);
+};
+exports.registerActivityCallback = registerActivityCallback;
+/**
+ * Remove a callback from the transfer callback
+ * @param id the ID returned by `registerActivityCallback`
+ */
+var deregisterActivityCallback = function (id) {
+    index_1.asperaHttpGateway.activityTracking.removeCallback(id);
+};
+exports.deregisterActivityCallback = deregisterActivityCallback;
+/**
+ * Returns the transfer requested based on the uuid of the transfer.
+ * NOTE: transferId from Node is not accepted as an ID.  It must be the ID used by the HTTP Gateway.
+ *
+ * @param id gateway based ID of the HTTP part of the transfer
+ *
+ * @returns an object containing the transfer (or undefined if not found) located at key `transfer_info`
+ */
+var getTransferById = function (id) {
+    return { transfer_info: index_1.asperaHttpGateway.activityTracking.getTransferById(id) };
+};
+exports.getTransferById = getTransferById;
+/**
+ * Get transfer response object including all transfers
+ *
+ * @returns transfer data object with transfers array
+ */
+var getAllTransfers = function () {
+    return index_1.asperaHttpGateway.activityTracking.getAllTransfersResponse();
+};
+exports.getAllTransfers = getAllTransfers;
+/**
+ * Remove all transfers that are not active
+ */
+var clearNonActiveTransfers = function () {
+    index_1.asperaHttpGateway.activityTracking.clearNonActiveTransfers();
+};
+exports.clearNonActiveTransfers = clearNonActiveTransfers;
+/**
+ * Removes a transfer from the transfers list in HTTP Gateway
+ * If an active transfer is removed it will continue to be uploaded/downloaded but progress will not be tracked
+ *
+ * @param id HTTP Gateway transfer uuid
+ */
+var removeTransfer = function (id) {
+    index_1.asperaHttpGateway.activityTracking.removeTransfer(id);
+};
+exports.removeTransfer = removeTransfer;
+/**
+ * Cancel a transfer from the transfers list in HTTP Gateway
+ *
+ * @param id HTTP Gateway transfer uuid
+ */
+var cancelTransfer = function (id) {
+    var transfer = index_1.asperaHttpGateway.activityTracking.getTransferById(id);
+    if (transfer) {
+        transfer.status = 'cancelled';
+    }
+};
+exports.cancelTransfer = cancelTransfer;
+exports.default = {
+    initHttpGateway: exports.initHttpGateway,
+    testHttpGatewayConnection: exports.testHttpGatewayConnection,
+    registerActivityCallback: exports.registerActivityCallback,
+    cleanupServerUrl: exports.cleanupServerUrl,
+    deregisterActivityCallback: exports.deregisterActivityCallback,
+    getTransferById: exports.getTransferById,
+    getAllTransfers: exports.getAllTransfers,
+    clearNonActiveTransfers: exports.clearNonActiveTransfers,
+    removeTransfer: exports.removeTransfer,
+    cancelTransfer: exports.cancelTransfer
+};

package/dist/commonjs/http-gateway/v2/app/download.d.ts

@@ -0,0 +1,15 @@
+import { DownloadOptions, TransferSpec } from '../models/models';
+/**
+ * Start a HTTP Gateway download. Progress is not provided on downloads, browser handles download directly
+ * When in software mode the promise will return transfer_spec_id and the URL. The URL has not been used
+ * therefore a client can open it and start the download using software specific methods (like file reader).
+ *
+ * @param transferSpec standard Connect transferSpec for downloading
+ *
+ * @returns a promise that resolves if download is started successfully or rejects if error occurs
+ */
+export declare const download: (transferSpec: TransferSpec, options?: DownloadOptions) => Promise<any>;
+declare const _default: {
+    download: (transferSpec: TransferSpec, options?: DownloadOptions) => Promise<any>;
+};
+export default _default;

package/dist/commonjs/http-gateway/v2/app/download.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.download = void 0;
+var http_1 = require("../helpers/http");
+var index_1 = require("../index");
+var helpers_1 = require("../helpers/helpers");
+var messages_1 = require("../constants/messages");
+var core_1 = require("./core");
+/**
+ * Start a HTTP Gateway download. Progress is not provided on downloads, browser handles download directly
+ * When in software mode the promise will return transfer_spec_id and the URL. The URL has not been used
+ * therefore a client can open it and start the download using software specific methods (like file reader).
+ *
+ * @param transferSpec standard Connect transferSpec for downloading
+ *
+ * @returns a promise that resolves if download is started successfully or rejects if error occurs
+ */
+var download = function (transferSpec, options) {
+    if (options === void 0) { options = {}; }
+    if (!index_1.asperaHttpGateway.isReady) {
+        (0, helpers_1.errorLog)(messages_1.messages.serverNotVerified);
+        return new Promise(function (resolve, reject) {
+            reject((0, helpers_1.generateErrorBody)(messages_1.messages.serverNotVerified));
+        });
+    }
+    if (!(0, helpers_1.isValidTransferSpec)(transferSpec)) {
+        (0, helpers_1.errorLog)(messages_1.messages.notValidTransferSpec);
+        return new Promise(function (resolve, reject) {
+            reject((0, helpers_1.generateErrorBody)(messages_1.messages.notValidTransferSpec, { transferSpec: transferSpec }));
+        });
+    }
+    var promiseInfo = (0, helpers_1.generatePromiseObjects)();
+    if (typeof options.zipRequire === 'boolean') {
+        transferSpec.zip_required = options.zipRequire;
+    }
+    var payload = {
+        transfer_spec: transferSpec
+    };
+    var finalServerUrl = options.serverUrlOverride ? (0, core_1.cleanupServerUrl)(options.serverUrlOverride) : index_1.asperaHttpGateway.globals.serverUrl;
+    (0, http_1.apiPost)("".concat(finalServerUrl, "/v1/download"), payload).then(function (response) {
+        response.json().then(function (data) {
+            if (data.transfer_spec_id) {
+                var downloadUrl = "".concat(finalServerUrl, "/v1/download/").concat(data.transfer_spec_id);
+                if (index_1.asperaHttpGateway.globals.softwareMode || (options === null || options === void 0 ? void 0 : options.disableAutoDownload)) {
+                    promiseInfo.resolver({
+                        transfer_spec_id: data.transfer_spec_id,
+                        url: downloadUrl,
+                    });
+                    return;
+                }
+                index_1.asperaHttpGateway.globals.triggerDownloadFromUrl(downloadUrl);
+                promiseInfo.resolver();
+            }
+            else {
+                (0, helpers_1.errorLog)(messages_1.messages.failedToGetDownloadUrl, { response: data });
+                promiseInfo.rejecter((0, helpers_1.generateErrorBody)(messages_1.messages.failedToGetDownloadUrl, { response: data }));
+            }
+        });
+    }).catch(function (error) {
+        (0, helpers_1.errorLog)(messages_1.messages.downloadFailed, error);
+        promiseInfo.rejecter((0, helpers_1.generateErrorBody)(messages_1.messages.downloadFailed, error));
+    });
+    return promiseInfo.promise;
+};
+exports.download = download;
+exports.default = {
+    download: exports.download
+};

package/dist/commonjs/http-gateway/v2/app/upload.d.ts

@@ -0,0 +1,169 @@
+import { TransferSpec, DataTransferResponse, ConnectStyleFile, PromiseObject, TransferStatus, UploadOptions } from '../models/models';
+/**
+ * Used to update the transfer in the activity monitor for a specific transfer. If transfer not found it is ignored
+ *
+ * @param id the id of the transfer to update
+ * @param status the status of the transfer
+ * @param total the total bytes of the transfer
+ * @param current the amount of bytes transferred thus far
+ * @param error error body
+ * @param currentFile the current file being transferred
+ */
+export declare const updateTransferActivity: (id: string, status: TransferStatus, total?: number, current?: number, error?: any, currentFile?: File) => void;
+/**
+ * Slice a file and read it in with FileReader.  This uses the callback to send the read event.
+ * This function supports falling back to vendor prefix versions
+ * of the slice function for older Firefox and Webkit browsers.
+ *
+ * @param file the file to slice
+ * @param filePosition the start position of the file to slice
+ * @param chunksize the end position of the file to slice
+ * @param callback the callback to use for FileReader
+ * @param fileReader the FileReader to use for reading in data
+ */
+export declare const handleBlobSlicing: (file: File, filePosition: number, chunksize: number, callback: any, fileReader: FileReader) => void;
+/**
+ * Software mode version of `handleBlobSlicing` for dealing with Buffer instead of File API
+ *
+ * @param file the file to slice (data string is a FileSystem readFile in binary format)
+ * @param filePosition the start position of the file to slice
+ * @param chunksize the end position of the file to slice
+ * @param callback the callback to use for triggering event on slice
+ *
+ * @example
+ * ```javascript
+ * const fileInfo = fs.statSync(filePointer);
+ * const file = {
+ *    data: fs.readFileSync(filePointer, {encoding: 'binary'}),
+ *    size: fileInfo.size,
+ *    type: 'file',
+ *    lastModified: fileInfo.mtime.toISOString(),
+ *    name: filePointer,
+ *  }
+ * ```
+ */
+export declare const handleSoftwareModeSlicing: (file: {
+    name: string;
+    data: string;
+    type: string;
+    lastModified: string;
+}, filePosition: number, chunksize: number, callback: any) => void;
+/**
+ * Start sending chunked data through the opened websocket
+ *
+ * @param socket the WebSocket to use for data transfer
+ * @param transferSpec the transferSpec to send for the upload
+ * @param id the ID of the transfer for monitoring
+ * @param queue the array of functions to call for sending data
+ * @param fileReaderToUse the file reader to use for this transfer
+ */
+export declare const startSendingData: (socket: WebSocket, transferSpec: TransferSpec, files: File[], id: string, queue: (() => void)[], fileReaderToUse: FileReader) => void;
+/**
+ * Add file input to a form for getting files from the local computer
+ *
+ * @param form form to add new file input to
+ */
+export declare const addFilePickerToForm: (form: HTMLFormElement) => HTMLElement;
+/**
+ * Add file input to a form with folder support for getting folders from the local computer
+ *
+ * NOTE: this cannot stop files from being picked.
+ *
+ * @param form form to add new file input to
+ */
+export declare const addFolderPickerToForm: (form: HTMLFormElement) => HTMLElement;
+/**
+ * Request file picker for choosing files
+ *
+ * @param id the ID of the form to use (must be unique to each transfer grouping)
+ * @param callback the function to call once the files are added
+ */
+export declare const getFilesForUpload: (callback: (data: DataTransferResponse) => void, id: string) => void;
+/**
+ * Request file picker for choosing files and use promise.
+ * Uses `getFilesForUpload` logic wrapped in a Promise
+ *
+ * @param id the ID of the form to use (must be unique to each transfer grouping)
+ *
+ * @returns promise that resolves with the files (error state is never used)
+ */
+export declare const getFilesForUploadPromise: (id: string) => Promise<DataTransferResponse>;
+/**
+ * Request folder picker for choosing folders
+ * @remarks Feature not supported. Will be introduced in future release.
+ *
+ * @param id the ID of the form to use (must be unique to each transfer grouping)
+ * @param callback the function to call once the folders are added
+ */
+export declare const getFoldersForUpload: (callback: (data: DataTransferResponse) => void, id: string) => void;
+/**
+ * Request folder picker for choosing folders and use promise.
+ * Uses `getFoldersForUpload` logic wrapped in a Promise
+ * @remarks Feature not supported. Will be introduced in future release.
+ *
+ * @param id the ID of the form to use (must be unique to each transfer grouping)
+ *
+ * @returns promise that resolves with the folders/file list (error state is never used)
+ */
+export declare const getFoldersForUploadPromise: (id: string) => Promise<DataTransferResponse>;
+/**
+ * Start the Websockets and transfer
+ *
+ * @param id the ID to use for the transfer
+ * @param transferSpec the transferSpec of the transfer
+ * @param files the files to transfer
+ * @param promiseInfo the promise data to resolve for the transfer if needed
+ */
+export declare const startWebSocketTransfer: (id: string, transferSpec: TransferSpec, files: File[], promiseInfo?: PromiseObject, options?: UploadOptions) => void;
+/**
+ * Start a HTTP Gateway upload.
+ *
+ * @param transferSpec standard Connect transferSpec for uploading
+ * @param id the ID of the form group to use for files
+ * @param memoryFilesToLoad array of files from memory to use.  These will be used all the time and if transferSpec does not contain them an error will raise.
+ * @param options options for customizing the upload
+ *
+ * @returns a promise that resolves if upload is successful and rejects if upload cannot be started
+ */
+export declare const upload: (transferSpec: TransferSpec, id: string, memoryFilesToLoad?: File[], options?: UploadOptions) => Promise<any>;
+/**
+ * Create a dropzone linked to a form grouping.
+ * All drops are stored in same place to allow body drops.
+ *
+ * @param callback the function to call once the files are dropped
+ * @param elementSelector the selector of the element on the page that should watch for drop events
+ */
+export declare const createDropzone: (callback: (data: {
+    event: any;
+    files: {
+        dataTransfer: {
+            files: ConnectStyleFile[];
+        };
+    };
+}) => void, elementSelector: string) => void;
+/**
+ * Remove dropzone added by gateway.
+ *
+ * @param elementSelector the selector of the element on the page that should remove
+ */
+export declare const removeDropzone: (elementSelector: string) => void;
+declare const _default: {
+    upload: (transferSpec: TransferSpec, id: string, memoryFilesToLoad?: File[], options?: UploadOptions) => Promise<any>;
+    updateTransferActivity: (id: string, status: TransferStatus, total?: number, current?: number, error?: any, currentFile?: File) => void;
+    startSendingData: (socket: WebSocket, transferSpec: TransferSpec, files: File[], id: string, queue: (() => void)[], fileReaderToUse: FileReader) => void;
+    addFilePickerToForm: (form: HTMLFormElement) => HTMLElement;
+    createDropzone: (callback: (data: {
+        event: any;
+        files: {
+            dataTransfer: {
+                files: ConnectStyleFile[];
+            };
+        };
+    }) => void, elementSelector: string) => void;
+    removeDropzone: (elementSelector: string) => void;
+    getFilesForUploadPromise: (id: string) => Promise<DataTransferResponse>;
+    getFilesForUpload: (callback: (data: DataTransferResponse) => void, id: string) => void;
+    getFoldersForUploadPromise: (id: string) => Promise<DataTransferResponse>;
+    getFoldersForUpload: (callback: (data: DataTransferResponse) => void, id: string) => void;
+};
+export default _default;