@ibm-aspera/sdk 0.16.0 → 0.19.1

package/dist/commonjs/app/core.js

@@ -11,14 +11,14 @@ var __assign = (this && this.__assign) || function () {
     return __assign.apply(this, arguments);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasCapability = exports.getCapabilities = exports.readDirectory = exports.getChecksum = exports.readChunkAsArrayBuffer = exports.readAsArrayBuffer = exports.getInfo = exports.removeDropzone = exports.createDropzone = exports.setBranding = exports.modifyTransfer = exports.showDirectory = exports.getFilesList = exports.getTransfer = exports.getAllTransfers = exports.showTransferMonitor = exports.showPreferencesPage = exports.showTransferManager = exports.showPreferences = exports.showAbout = exports.showSaveFileDialog = exports.showSelectFolderDialog = exports.showSelectFileDialog = exports.resumeTransfer = exports.stopTransfer = exports.removeTransfer = exports.deregisterStatusCallback = exports.registerStatusCallback = exports.deregisterActivityCallback = exports.registerActivityCallback = exports.startTransfer = exports.authenticate = exports.testSshPorts = exports.init = exports.initDragDrop = exports.testConnection = void 0;
+exports.hasCapability = exports.getCapabilities = exports.readDirectory = exports.getChecksum = exports.readChunkAsArrayBuffer = exports.readAsArrayBuffer = exports.getInfo = exports.removeDropzone = exports.createDropzone = exports.setBranding = exports.modifyTransfer = exports.showDirectory = exports.getFilesList = exports.getTransfer = exports.getAllTransfers = exports.showTransferMonitor = exports.showPreferencesPage = exports.showTransferManager = exports.showPreferences = exports.showAbout = exports.showSaveFileDialog = exports.showSelectFolderDialog = exports.showSelectFileDialog = exports.resumeTransfer = exports.stopTransfer = exports.removeTransfer = exports.deregisterStatusCallback = exports.registerStatusCallback = exports.deregisterActivityCallback = exports.registerActivityCallback = exports.startTransfer = exports.authenticate = exports.testSshPorts = exports.initSession = exports.init = exports.getStatus = exports.initDragDrop = exports.testConnection = void 0;
 var messages_1 = require("../constants/messages");
 var client_1 = require("../helpers/client/client");
 var helpers_1 = require("../helpers/helpers");
 var http_gateway_1 = require("../http-gateway");
 var core_1 = require("../http-gateway/core");
 var index_1 = require("../index");
-var connect_sdk_js_1 = require("@ibm-aspera/connect-sdk-js");
+var status_1 = require("./status");
 var core_2 = require("../connect/core");
 /**
  * Check if IBM Aspera for Desktop connection works. This function is called by init
@@ -27,8 +27,7 @@ var core_2 = require("../connect/core");
  * @returns a promise that resolves if server can connect or rejects if not
  */
 var testConnection = function () {
-    // FIXME: If force HTTP gateway is false this ends up preventing SDK from verifying IBM Aspera for desktop is running.
-    if (index_1.asperaSdk.useHttpGateway || index_1.asperaSdk.useConnect) {
+    if (index_1.asperaSdk.isReady || index_1.asperaSdk.useConnect) {
         return Promise.resolve(index_1.asperaSdk.globals.sdkResponseData);
     }
     return client_1.client.request('get_info')
@@ -40,12 +39,16 @@ var testConnection = function () {
 };
 exports.testConnection = testConnection;
 /**
- * RPC discovery used internally when initializing the SDK.
+ * RPC discovery used internally during IBM Aspera for desktop initialization to determine
+ * the supported RPC methods of the user's version of IBM Aspera for desktop.
+ *
+ * For convenience, this function will return an empty [] if the SDK is currently configured to use
+ * either HTTP Gateway or Connect transfer clients.
  *
  * @returns a promise that resolves if discovery is successful
  */
 var rpcDiscover = function () {
-    if (index_1.asperaSdk.useConnect || index_1.asperaSdk.useHttpGateway) {
+    if (index_1.asperaSdk.useHttpGateway || index_1.asperaSdk.useConnect) {
         return Promise.resolve({ methods: [] });
     }
     if (!index_1.asperaSdk.isReady) {
@@ -92,99 +95,222 @@ var initDragDrop = function (initCall) {
 };
 exports.initDragDrop = initDragDrop;
 /**
- * Initialize IBM Aspera client. If client cannot (reject/catch), then
- * client should attempt fixing server URL or trying again. If still fails disable UI elements.
- *
- * @param options initialization options:
- *
- * - `appId` the unique ID for the website. Transfers initiated during this session
- * will be associated with this ID. It is recommended to use a unique ID to keep transfer
- * information private from other websites.
+ * Get the current SDK lifecycle status synchronously.
  *
- * - `supportMultipleUsers` when enabled (defaults to false), the SDK will iterate over a port
- * range and generate a session id to determine the running instance of the desktop app for the
- * current user. This is needed when multiple users may be logged into the same machine
- * simultaneously, for example on a Windows Server.
- *
- * @returns a promise that resolves if IBM Aspera Desktop is running properly or
- * rejects if unable to connect
+ * @returns the current status, or undefined if no init has been called yet
  */
-var init = function (options) {
-    var _a, _b, _c;
-    var appId = (_a = options === null || options === void 0 ? void 0 : options.appId) !== null && _a !== void 0 ? _a : (0, helpers_1.randomUUID)();
-    index_1.asperaSdk.globals.appId = appId;
+var getStatus = function () {
+    return status_1.statusService.getStatus();
+};
+exports.getStatus = getStatus;
+var setupAppId = function (options) {
+    var _a;
+    index_1.asperaSdk.globals.appId = (_a = options === null || options === void 0 ? void 0 : options.appId) !== null && _a !== void 0 ? _a : (0, helpers_1.randomUUID)();
     if (options === null || options === void 0 ? void 0 : options.supportMultipleUsers) {
         index_1.asperaSdk.globals.supportMultipleUsers = true;
         index_1.asperaSdk.globals.sessionId = (0, helpers_1.randomUUID)();
     }
+};
+var connectDesktop = function () {
+    return index_1.asperaSdk.activityTracking.setup()
+        .then(function () { return (0, exports.testConnection)(); })
+        .then(function () { return rpcDiscover(); })
+        .then(function () { return (0, exports.initDragDrop)(true); })
+        .then(function () { return undefined; });
+};
+/**
+ * Initialize the SDK and connect to a transfer client. Returns a promise that resolves
+ * when the transfer client is ready, or rejects if it cannot be reached.
+ *
+ * By default, the SDK connects to IBM Aspera for desktop. Set `connectSettings.useConnect`
+ * to use IBM Aspera Connect instead. If `httpGatewaySettings` is provided, the gateway is
+ * set up first — when `forceGateway` is true it becomes the sole transport; when false it
+ * is set up as a supplementary transport and the primary client (Desktop or Connect) is
+ * still initialized afterward.
+ *
+ * Note that the promise behavior varies by transfer client. For Desktop, the promise
+ * remains pending until the application is detected. For Connect, the promise resolves
+ * immediately after initialization begins — use {@link registerStatusCallback} to track
+ * when Connect is actually ready. For a non-blocking alternative that provides consistent
+ * lifecycle status events across all transfer clients, see {@link initSession}.
+ *
+ * @param options - Initialization options. See {@link InitOptions}.
+ *
+ * @returns a promise that resolves with SDK metadata when the transfer client is ready
+ *
+ * @example
+ * init({ appId: 'my-app' })
+ *   .then(() => {
+ *     // Transfer client is ready — enable UI
+ *   })
+ *   .catch(error => {
+ *     // Could not connect — prompt user to install or launch
+ *   });
+ */
+var init = function (options) {
+    var _a;
+    setupAppId(options);
     var handleErrors = function (error) {
         (0, helpers_1.errorLog)(messages_1.messages.serverError, error);
         index_1.asperaSdk.globals.asperaAppVerified = false;
         throw (0, helpers_1.generateErrorBody)(messages_1.messages.serverError, error);
     };
-    var getConnectStartCalls = function () {
-        index_1.asperaSdk.globals.connect = new connect_sdk_js_1.Connect({
-            minVersion: options.connectSettings.minVersion || '3.10.1',
-            dragDropEnabled: options.connectSettings.dragDropEnabled,
-            connectMethod: options.connectSettings.method,
-        });
-        index_1.asperaSdk.globals.connectInstaller = new connect_sdk_js_1.ConnectInstaller({
-            sdkLocation: options.connectSettings.sdkLocation,
-            correlationId: options.connectSettings.correlationId,
-            style: 'carbon',
-            version: options.connectSettings.version,
-        });
-        index_1.asperaSdk.globals.connectAW4 = {
-            Connect: connect_sdk_js_1.Connect,
-            ConnectInstaller: connect_sdk_js_1.ConnectInstaller,
-        };
-        return (0, core_2.initConnect)(!options.connectSettings.hideIncludedInstaller);
-    };
     var getDesktopStartCalls = function () {
-        return index_1.asperaSdk.activityTracking.setup()
-            .then(function () { return (0, exports.testConnection)(); })
-            .then(function () { return rpcDiscover(); })
-            .then(function () { return (0, exports.initDragDrop)(true); })
+        return connectDesktop()
             .then(function () { return index_1.asperaSdk.globals.sdkResponseData; })
             .catch(handleErrors);
     };
-    if (((_b = options === null || options === void 0 ? void 0 : options.httpGatewaySettings) === null || _b === void 0 ? void 0 : _b.url) && !index_1.asperaSdk.globals.httpGatewayVerified) {
-        var finalHttpGatewayUrl = options.httpGatewaySettings.url.trim();
-        if (finalHttpGatewayUrl.indexOf('http') !== 0) {
-            finalHttpGatewayUrl = "https://".concat(finalHttpGatewayUrl);
-        }
-        if (finalHttpGatewayUrl.endsWith('/')) {
-            finalHttpGatewayUrl = finalHttpGatewayUrl.slice(0, -1);
-        }
-        index_1.asperaSdk.globals.httpGatewayUrl = finalHttpGatewayUrl;
-        return fetch("".concat(index_1.asperaSdk.globals.httpGatewayUrl, "/info"), { method: 'GET' }).then(function (response) {
-            return response.json().then(function (responseData) {
-                if (response.status >= 400) {
-                    throw Error(responseData);
-                }
-                return responseData;
-            });
-        }).then(function (response) {
-            return (0, http_gateway_1.initHttpGateway)(response);
-        }).then(function () {
-            var _a, _b;
+    var getTransferClientCalls = function () {
+        var _a;
+        return ((_a = options === null || options === void 0 ? void 0 : options.connectSettings) === null || _a === void 0 ? void 0 : _a.useConnect) ? (0, core_2.initConnect)(options.connectSettings) : getDesktopStartCalls();
+    };
+    if (((_a = options === null || options === void 0 ? void 0 : options.httpGatewaySettings) === null || _a === void 0 ? void 0 : _a.url) && !index_1.asperaSdk.globals.httpGatewayVerified) {
+        return (0, http_gateway_1.setupHttpGateway)(options.httpGatewaySettings.url).then(function () {
+            var _a;
             if ((_a = options === null || options === void 0 ? void 0 : options.httpGatewaySettings) === null || _a === void 0 ? void 0 : _a.forceGateway) {
                 return Promise.resolve(index_1.asperaSdk.globals.sdkResponseData);
             }
-            return ((_b = options === null || options === void 0 ? void 0 : options.connectSettings) === null || _b === void 0 ? void 0 : _b.useConnect) ? getConnectStartCalls() : getDesktopStartCalls();
+            return getTransferClientCalls();
         }).catch(function (error) {
-            var _a, _b;
-            // If HTTP Gateway fails log and move on to transfer client
+            var _a;
             (0, helpers_1.errorLog)(messages_1.messages.httpInitFail, error);
             if ((_a = options === null || options === void 0 ? void 0 : options.httpGatewaySettings) === null || _a === void 0 ? void 0 : _a.forceGateway) {
                 throw (0, helpers_1.generateErrorBody)(messages_1.messages.httpInitFail, error);
             }
-            return ((_b = options === null || options === void 0 ? void 0 : options.connectSettings) === null || _b === void 0 ? void 0 : _b.useConnect) ? getConnectStartCalls() : getDesktopStartCalls();
+            return getTransferClientCalls();
         });
     }
-    return ((_c = options === null || options === void 0 ? void 0 : options.connectSettings) === null || _c === void 0 ? void 0 : _c.useConnect) ? getConnectStartCalls() : getDesktopStartCalls();
+    return getTransferClientCalls();
 };
 exports.init = init;
+/**
+ * Initialize the SDK and begin detecting a transfer client. This function returns
+ * immediately — lifecycle status is communicated asynchronously via {@link registerStatusCallback}.
+ *
+ * The SDK supports three transfer clients. By default, IBM Aspera for desktop is used.
+ * Set `connectSettings.useConnect` to use IBM Aspera Connect instead. Desktop and Connect
+ * are mutually exclusive — one or the other is detected, not both.
+ *
+ * ## HTTP Gateway
+ *
+ * HTTP Gateway is a server-side component that enables browser-based transfers without
+ * a desktop application. It can be used in two modes:
+ *
+ * - **Sole transport** (`forceGateway: true`): HTTP Gateway is the only transport.
+ *   No Desktop or Connect detection occurs. Status transitions to `RUNNING` when the
+ *   gateway responds successfully, or `FAILED` if it does not.
+ *
+ * - **Supplementary transport** (`forceGateway: false`): HTTP Gateway is set up first
+ *   as an additional transport for browser-based uploads and downloads. The primary
+ *   transfer client (Desktop or Connect) is then detected separately. If HTTP Gateway
+ *   setup fails, the primary client is still detected. Features that require a desktop
+ *   application (native file dialogs, drag and drop, etc.) are only available when the
+ *   primary client is running.
+ *
+ * ## Status lifecycle
+ *
+ * Use {@link registerStatusCallback} to receive status updates. Use {@link getStatus} to
+ * read the current status synchronously at any time.
+ *
+ * **Desktop path**: `INITIALIZING` → `RUNNING` (app detected), `DEGRADED` (timeout but
+ * HTTP Gateway is available as a supplementary transport), or `FAILED` (timeout, no
+ * fallback). Detection continues in the background after `DEGRADED` or `FAILED` — if the
+ * user launches the app later, the status transitions to `RUNNING`.
+ *
+ * **Connect path**: `INITIALIZING` → `RUNNING`, `FAILED`, `OUTDATED`, or
+ * `EXTENSION_INSTALL` depending on the state of the Connect browser extension
+ * and application.
+ *
+ * **HTTP Gateway path** (`forceGateway: true`): `INITIALIZING` → `RUNNING` or `FAILED`.
+ *
+ * @param options - Initialization options. See {@link InitOptions}.
+ *
+ * @example
+ * // Detect IBM Aspera for desktop (default)
+ * initSession({ appId: 'my-app' });
+ *
+ * @example
+ * // Detect IBM Aspera for desktop with status handling
+ * registerStatusCallback(status => {
+ *   if (status === 'RUNNING') {
+ *     // Transfer client is ready — enable UI
+ *   } else if (status === 'FAILED') {
+ *     // Not detected — prompt user to install or launch
+ *   }
+ * });
+ *
+ * initSession({ appId: 'my-app' });
+ *
+ * @example
+ * // Use IBM Aspera Connect
+ * initSession({
+ *   appId: 'my-app',
+ *   connectSettings: {
+ *     useConnect: true,
+ *   },
+ * });
+ *
+ * @example
+ * // Use HTTP Gateway as the sole transport (no desktop app needed)
+ * initSession({
+ *   appId: 'my-app',
+ *   httpGatewaySettings: {
+ *     url: 'https://example.com/aspera/http-gwy',
+ *     forceGateway: true,
+ *   },
+ * });
+ *
+ * @example
+ * // HTTP Gateway as supplementary transport with Desktop as primary
+ * initSession({
+ *   appId: 'my-app',
+ *   httpGatewaySettings: {
+ *     url: 'https://example.com/aspera/http-gwy',
+ *     forceGateway: false,
+ *   },
+ * });
+ */
+var initSession = function (options) {
+    var _a, _b, _c;
+    setupAppId(options);
+    var retryInterval = (_a = options === null || options === void 0 ? void 0 : options.retryInterval) !== null && _a !== void 0 ? _a : 2000;
+    var retryTimeout = (_b = options === null || options === void 0 ? void 0 : options.retryTimeout) !== null && _b !== void 0 ? _b : 5000;
+    var startDesktopDetection = function () {
+        status_1.statusService.startPolling(connectDesktop, retryInterval, retryTimeout);
+    };
+    var startTransferClient = function () {
+        var _a;
+        if ((_a = options === null || options === void 0 ? void 0 : options.connectSettings) === null || _a === void 0 ? void 0 : _a.useConnect) {
+            (0, core_2.initConnect)(options.connectSettings);
+        }
+        else {
+            startDesktopDetection();
+        }
+    };
+    // HTTP Gateway path
+    if (((_c = options === null || options === void 0 ? void 0 : options.httpGatewaySettings) === null || _c === void 0 ? void 0 : _c.url) && !index_1.asperaSdk.globals.httpGatewayVerified) {
+        status_1.statusService.setStatus('INITIALIZING');
+        (0, http_gateway_1.setupHttpGateway)(options.httpGatewaySettings.url).then(function () {
+            var _a;
+            if ((_a = options === null || options === void 0 ? void 0 : options.httpGatewaySettings) === null || _a === void 0 ? void 0 : _a.forceGateway) {
+                status_1.statusService.setStatus('RUNNING');
+                return;
+            }
+            startTransferClient();
+        }).catch(function (error) {
+            var _a;
+            (0, helpers_1.errorLog)(messages_1.messages.httpInitFail, error);
+            if ((_a = options === null || options === void 0 ? void 0 : options.httpGatewaySettings) === null || _a === void 0 ? void 0 : _a.forceGateway) {
+                status_1.statusService.setStatus('FAILED');
+                return;
+            }
+            startTransferClient();
+        });
+        return;
+    }
+    startTransferClient();
+};
+exports.initSession = initSession;
 /**
  * Tests SSH port connectivity to a transfer server.
  *
@@ -319,18 +445,46 @@ var deregisterActivityCallback = function (id) {
 };
 exports.deregisterActivityCallback = deregisterActivityCallback;
 /**
- * Register a callback for getting updates about the connection status of IBM Aspera SDK.
+ * Register a callback for SDK lifecycle status changes. The callback fires immediately
+ * with the current status (if one exists) and again whenever the status changes.
  *
- * For example, to be notified of when the SDK loses connection with the application or connection
- * is re-established. This can be useful if you want to handle the case where the user quits IBM Aspera
- * after `init` has already been called, and want to prompt the user to relaunch the application.
+ * Status values:
  *
- * @param callback callback function to receive events
+ * - `INITIALIZING` — The SDK is detecting a transfer client.
+ * - `RUNNING` — A transfer client is ready. Full functionality is available.
+ * - `DEGRADED` — The primary transfer client (IBM Aspera for desktop) was not detected, but HTTP
+ *   Gateway is available as a fallback. This is only available if XXX...
+ * - `FAILED` — No transfer client could be reached. This could be because the user does
+ *    not have a transfer client installed, it is not running, or in the case of HTTP Gateway,
+ *    it was not reachable.
+ * - `DISCONNECTED` — The transfer client was previously running but lost connection. This is specific
+ *    to IBM Aspera for desktop. For example, if the user quits the app this status will trigger.
+ * - `OUTDATED` — (Connect only) The Connect installation needs updating.
+ * - `EXTENSION_INSTALL` — (Connect only) The browser extension needs to be installed.
+ *
+ * For IBM Aspera for desktop, detection continues in the background after `FAILED` or `DEGRADED`.
+ * If the user launches the application later, the status transitions to `RUNNING`.
+ *
+ * @param callback callback function to receive status events
  *
  * @returns ID representing the callback for deregistration purposes
+ *
+ * @example
+ * const id = registerStatusCallback(status => {
+ *   if (status === 'RUNNING') {
+ *     // Full functionality — enable all UI
+ *   } else if (status === 'DEGRADED') {
+ *     // Transfers work via HTTP Gateway
+ *   } else if (status === 'FAILED') {
+ *     // Nothing available — prompt user to install
+ *   }
+ * });
+ *
+ * // Later, to stop listening:
+ * deregisterStatusCallback(id);
  */
 var registerStatusCallback = function (callback) {
-    return index_1.asperaSdk.activityTracking.setWebSocketEventCallback(callback);
+    return status_1.statusService.registerCallback(callback);
 };
 exports.registerStatusCallback = registerStatusCallback;
 /**
@@ -339,7 +493,7 @@ exports.registerStatusCallback = registerStatusCallback;
  * @param id the ID returned by `registerStatusCallback`
  */
 var deregisterStatusCallback = function (id) {
-    index_1.asperaSdk.activityTracking.removeWebSocketEventCallback(id);
+    status_1.statusService.deregisterCallback(id);
 };
 exports.deregisterStatusCallback = deregisterStatusCallback;
 /**
@@ -1188,6 +1342,10 @@ var readDirectory = function (options) {
 };
 exports.readDirectory = readDirectory;
 var supportsMethod = function (method) {
+    // HTTP Gateway v2 specific overrides
+    if (index_1.asperaSdk.useOldHttpGateway && (method === 'read_as_array_buffer' || method === 'read_chunk_as_array_buffer')) {
+        return false;
+    }
     // We currently do not support calculating file checksums when using HTTP Gateway. In theory it should be possible
     // to calculate this directly in the browser similar to how `readAsArrayBuffer()` is implemented.
     // HTTP Gateway also does not support showing native transfer client UI (about, preferences, etc.).
@@ -1208,11 +1366,12 @@ var supportsMethod = function (method) {
  * Returns an object describing the high-level capabilities supported by the user's
  * transfer client (e.g. IBM Aspera for desktop, Connect, or HTTP Gateway).
  *
- * Use this for feature detection at a semantic level rather than checking individual RPC methods.
- * Capabitilies may depend on multiple underlying RPC methods and also may vary by transfer client.
+ * Use this for feature detection at a semantic level as capabilities may change depending on the
+ * transfer client.
  *
- * Some capabitilies may depend on newer versions of the transfer client. This function may be useful
- * if you want to conditionally perform certain actions rather than potentially getting an error.
+ * Rather than caching the return value of this function, it's recommended to call it on the fly as
+ * capabilities may change if your application supports multiple transfer clients. As a result, it's
+ * recommend to use the slightly more ergonomic {@link hasCapability}.
  *
  * @returns an object with boolean flags for each capability.
  *
@@ -1240,10 +1399,18 @@ var getCapabilities = function () {
 };
 exports.getCapabilities = getCapabilities;
 /**
- * Check if the SDK and underlying transfer client supports a specific capability.
+ * Check if the SDK and underlying transfer client supports a specific capability or feature.
  *
  * Capabilities depend on the transfer client being used (HTTP Gateway, Connect, or IBM Aspera for desktop).
- * Use this function to conditionally enable/disable features in your application.
+ *
+ * This function may be useful if you want to conditionally perform certain actions rather than
+ * potentially getting an error.
+ *
+ * For example, only IBM Aspera for desktop supports traversing a folder's contents. An application can
+ * check `hasCapability('readDirectory')` to optionally show a folder browser only when the feature is available.
+ * For example, when a user does not have IBM Aspera for desktop installed and is using HTTP Gateway, your
+ * application can disable this feature. Later, if that same user installs IBM Aspera for desktop, your application
+ * will show the feature as enabled without any additional changes.
  *
  * @param capability the capability to check.
  *
@@ -1253,7 +1420,7 @@ exports.getCapabilities = getCapabilities;
  * ```typescript
  * // Determine if your web application can render image previews for user selected files
  * if (asperaSdk.hasCapability('imagePreview')) {
- *   asperaSdk.readAsArrayBuffer(path);
+ *   const response = await asperaSdk.readAsArrayBuffer(path);
  * }
  * ```
  */

package/dist/commonjs/app/status.d.ts

@@ -0,0 +1,24 @@
+import { SdkStatus } from '../models/models';
+type StatusCallback = (status: SdkStatus) => void;
+declare class StatusService {
+    private currentStatus;
+    private callbacks;
+    private pollTimerId;
+    private failTimeoutId;
+    getStatus(): SdkStatus | undefined;
+    setStatus(status: SdkStatus): void;
+    registerCallback(cb: StatusCallback): string;
+    deregisterCallback(id: string): void;
+    /**
+     * Start Desktop detection polling loop.
+     *
+     * @param detectFn async function that resolves if Desktop is found, rejects if not
+     * @param interval ms between attempts
+     * @param failTimeout ms before transitioning to FAILED or DEGRADED
+     */
+    startPolling(detectFn: () => Promise<void>, interval: number, failTimeout: number): void;
+    stopPolling(): void;
+    reset(): void;
+}
+export declare const statusService: StatusService;
+export {};

package/dist/commonjs/app/status.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statusService = void 0;
+var helpers_1 = require("../helpers/helpers");
+var index_1 = require("../index");
+var StatusService = /** @class */ (function () {
+    function StatusService() {
+        this.currentStatus = undefined;
+        this.callbacks = new Map();
+        this.pollTimerId = null;
+        this.failTimeoutId = null;
+    }
+    StatusService.prototype.getStatus = function () {
+        return this.currentStatus;
+    };
+    StatusService.prototype.setStatus = function (status) {
+        // When Desktop disconnects, remap to DEGRADED if HTTP Gateway is available
+        if (status === 'DISCONNECTED' && index_1.asperaSdk.httpGatewayIsReady) {
+            status = 'DEGRADED';
+        }
+        if (this.currentStatus === status) {
+            return;
+        }
+        // Manage Desktop verification state based on status transitions
+        if (status === 'DISCONNECTED' || status === 'DEGRADED') {
+            index_1.asperaSdk.globals.asperaAppVerified = false;
+        }
+        else if (status === 'RUNNING' && (this.currentStatus === 'DISCONNECTED' || this.currentStatus === 'DEGRADED')) {
+            index_1.asperaSdk.globals.asperaAppVerified = true;
+        }
+        this.currentStatus = status;
+        this.callbacks.forEach(function (cb) { return cb(status); });
+    };
+    StatusService.prototype.registerCallback = function (cb) {
+        var id = "status-".concat((0, helpers_1.randomUUID)());
+        this.callbacks.set(id, cb);
+        if (this.currentStatus !== undefined) {
+            cb(this.currentStatus);
+        }
+        return id;
+    };
+    StatusService.prototype.deregisterCallback = function (id) {
+        this.callbacks.delete(id);
+    };
+    /**
+     * Start Desktop detection polling loop.
+     *
+     * @param detectFn async function that resolves if Desktop is found, rejects if not
+     * @param interval ms between attempts
+     * @param failTimeout ms before transitioning to FAILED or DEGRADED
+     */
+    StatusService.prototype.startPolling = function (detectFn, interval, failTimeout) {
+        var _this = this;
+        this.stopPolling();
+        this.setStatus('INITIALIZING');
+        this.failTimeoutId = setTimeout(function () {
+            if (_this.currentStatus !== 'RUNNING') {
+                if (index_1.asperaSdk.httpGatewayIsReady) {
+                    _this.setStatus('DEGRADED');
+                }
+                else {
+                    _this.setStatus('FAILED');
+                }
+            }
+        }, failTimeout);
+        var attempt = function () {
+            detectFn()
+                .then(function () {
+                _this.stopPolling();
+                _this.setStatus('RUNNING');
+            })
+                .catch(function () {
+                // Stay in current status (INITIALIZING or FAILED), poll continues
+            });
+        };
+        attempt();
+        this.pollTimerId = setInterval(attempt, interval);
+    };
+    StatusService.prototype.stopPolling = function () {
+        if (this.pollTimerId) {
+            clearInterval(this.pollTimerId);
+            this.pollTimerId = null;
+        }
+        if (this.failTimeoutId) {
+            clearTimeout(this.failTimeoutId);
+            this.failTimeoutId = null;
+        }
+    };
+    StatusService.prototype.reset = function () {
+        this.stopPolling();
+        this.currentStatus = undefined;
+        this.callbacks.clear();
+    };
+    return StatusService;
+}());
+exports.statusService = new StatusService();

package/dist/commonjs/connect/core.d.ts

@@ -1,4 +1,5 @@
 import * as ConnectTypes from '@ibm-aspera/connect-sdk-js/dist/esm/core/types';
+import { InitOptions } from '../models/models';
 /**
  * Connect Core Logic
  *
@@ -8,4 +9,4 @@ import * as ConnectTypes from '@ibm-aspera/connect-sdk-js/dist/esm/core/types';
  */
 export declare const handleTransfers: (transfers: ConnectTypes.TransferInfo[]) => void;
 export declare const connectInstallationFlow: () => void;
-export declare const initConnect: (useIncludedInstaller?: boolean) => Promise<unknown>;
+export declare const initConnect: (connectSettings: InitOptions["connectSettings"]) => Promise<unknown>;

package/dist/commonjs/connect/core.js

@@ -51,7 +51,22 @@ var connectInstallationFlow = function () {
     index_1.asperaSdk.globals.connect.addEventListener(index_1.asperaSdk.globals.connectAW4.Connect.EVENT.STATUS, handleInstallerEvent);
 };
 exports.connectInstallationFlow = connectInstallationFlow;
-var initConnect = function (useIncludedInstaller) {
+var initConnect = function (connectSettings) {
+    index_1.asperaSdk.globals.connect = new connect_sdk_js_1.Connect({
+        minVersion: connectSettings.minVersion || '3.10.1',
+        dragDropEnabled: connectSettings.dragDropEnabled,
+        connectMethod: connectSettings.method,
+    });
+    index_1.asperaSdk.globals.connectInstaller = new connect_sdk_js_1.ConnectInstaller({
+        sdkLocation: connectSettings.sdkLocation,
+        correlationId: connectSettings.correlationId,
+        style: 'carbon',
+        version: connectSettings.version,
+    });
+    index_1.asperaSdk.globals.connectAW4 = {
+        Connect: connect_sdk_js_1.Connect,
+        ConnectInstaller: connect_sdk_js_1.ConnectInstaller,
+    };
     index_1.asperaSdk.globals.connect.addEventListener(connect_sdk_js_1.Connect.EVENT.STATUS, function (eventType, eventStatus) {
         if (eventType === connect_sdk_js_1.Connect.EVENT.STATUS) {
             index_1.asperaSdk.globals.connectStatus = eventStatus;
@@ -65,7 +80,7 @@ var initConnect = function (useIncludedInstaller) {
         }
     });
     index_1.asperaSdk.globals.connect.initSession(index_1.asperaSdk.globals.appId);
-    if (useIncludedInstaller) {
+    if (!connectSettings.hideIncludedInstaller) {
         (0, exports.connectInstallationFlow)();
     }
     return Promise.resolve({ connectMode: true });

package/dist/commonjs/constants/messages.js

@@ -24,7 +24,7 @@ exports.messages = {
     showSelectFolderDialogFailed: 'Unable to show select folder dialog',
     showPreferencesFailed: 'Unable to show preferences',
     stopTransferFailed: 'Unable to stop transfer',
-    stopTransferFailedExternal: 'Unable to stop transfer. The download must be canceled from the browser\'s download manager',
+    stopTransferFailedExternal: 'Unable to stop transfer. The download must be cancelled from the browser\'s download manager',
     transferFailed: 'The transfer failed to initiate',
     unableToFindElementOnPage: 'Unable to find the element on the current page',
     unableToReadDropped: 'The dropped item could not be parsed. Please try selecting via the select file/folder option',
@@ -33,7 +33,7 @@ exports.messages = {
     websocketNotReady: 'The websocket is not ready. Run init first',
     httpNotAvailable: 'IBM Aspera HTTP Gateway is not available',
     httpInitFail: 'IBM Aspera HTTP Gateway could not be started',
-    filePickerCancel: 'User canceled the select file or folder dialog.',
+    filePickerCancel: 'User cancelled the select file or folder dialog.',
     fileNotAllowed: 'The specified path has not been allowed by the user.',
     httpNetworkFail: 'HTTP network encountered unknown error.',
     readAsArrayBufferFailed: 'Unable to read file as array buffer',

package/dist/commonjs/helpers/ws.d.ts

@@ -53,6 +53,11 @@ export declare class WebsocketService {
      */
     init(): Promise<unknown>;
     private connect;
+    /**
+     * Detach event handlers from the current socket so it cannot fire
+     * stale CLOSED/RECONNECT events after being replaced.
+     */
+    private detachSocket;
     private reconnect;
     private getWebSocketConnection;
     private notifyEvent;