@ibm-aspera/sdk 0.19.0 → 0.20.0

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

@@ -1,5 +1,5 @@
 import { AsperaSdkInfo, TransferResponse } from '../models/aspera-sdk.model';
-import { CustomBrandingOptions, DataTransferResponse, DropzoneEventData, DropzoneOptions, AsperaSdkSpec, AsperaSdkTransfer, FileDialogOptions, FolderDialogOptions, SaveFileDialogOptions, InitOptions, ModifyTransferOptions, Pagination, PaginatedFilesResponse, ResumeTransferOptions, TransferSpec, ReadChunkAsArrayBufferResponse, ReadAsArrayBufferResponse, SdkCapabilities, SdkStatus, GetChecksumOptions, ChecksumFileResponse, ReadDirectoryOptions, ReadDirectoryResponse, ShowPreferencesPageOptions, TestSshPortsOptions } from '../models/models';
+import { CustomBrandingOptions, DataTransferResponse, DropzoneEventData, DropzoneOptions, AsperaSdkSpec, AsperaSdkTransfer, FileDialogOptions, FolderDialogOptions, SaveFileDialogOptions, InitOptions, ModifyTransferOptions, Pagination, PaginatedFilesResponse, ResumeTransferOptions, TransferSpec, ReadChunkAsArrayBufferResponse, ReadAsArrayBufferResponse, SdkCapabilities, SdkStatus, GetChecksumOptions, ChecksumFileResponse, ReadDirectoryOptions, ReadDirectoryResponse, ShowPreferencesPageOptions, TestSshPortsOptions, TransferClient } from '../models/models';
 /**
  * Check if IBM Aspera for Desktop connection works. This function is called by init
  * when initializing the SDK. This function can be used at any point for checking.
@@ -94,11 +94,7 @@ export declare const init: (options?: InitOptions) => Promise<any>;
  * @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
+ * // Use IBM Aspera for desktop (default)
  * registerStatusCallback(status => {
  *   if (status === 'RUNNING') {
  *     // Transfer client is ready — enable UI
@@ -118,8 +114,8 @@ export declare const init: (options?: InitOptions) => Promise<any>;
  *   },
  * });
  *
- * @example
- * // Use HTTP Gateway as the sole transport (no desktop app needed)
+ * * @example
+ * // Use HTTP Gateway only
  * initSession({
  *   appId: 'my-app',
  *   httpGatewaySettings: {
@@ -128,13 +124,33 @@ export declare const init: (options?: InitOptions) => Promise<any>;
  *   },
  * });
  *
+ * * @example
+ * // Use IBM Aspera for desktop with automatic fallback to IBM Aspera Connect
+ * initSession({
+ *   appId: 'my-app',
+ *   connectSettings: {
+ *     fallback: true,
+ *   },
+ * });
+ *
  * @example
- * // HTTP Gateway as supplementary transport with Desktop as primary
+ * // Use IBM Aspera for desktop with automatic fallback to HTTP Gateway
+ * initSession({
+ *   appId: 'my-app',
+ *   httpGatewaySettings: {
+ *     url: 'https://example.com/aspera/http-gwy',
+ *   },
+ * });
+ *
+ * * @example
+ * // Use IBM Aspera for desktop or IBM Aspera Connect with automatic fallback to HTTP Gateway
  * initSession({
  *   appId: 'my-app',
+ *   connectSettings: {
+ *     fallback: true,
+ *   },
  *   httpGatewaySettings: {
  *     url: 'https://example.com/aspera/http-gwy',
- *     forceGateway: false,
  *   },
  * });
  */
@@ -437,11 +453,12 @@ export declare const readDirectory: (options: ReadDirectoryOptions) => Promise<R
  * 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.
  *
@@ -455,10 +472,18 @@ export declare const readDirectory: (options: ReadDirectoryOptions) => Promise<R
  */
 export declare const getCapabilities: () => SdkCapabilities;
 /**
- * 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.
  *
@@ -468,8 +493,9 @@ export declare const getCapabilities: () => SdkCapabilities;
  * ```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);
  * }
  * ```
  */
 export declare const hasCapability: (capability: keyof SdkCapabilities) => boolean;
+export declare const currentTransferClient: () => TransferClient | undefined;

package/dist/commonjs/app/core.js

@@ -11,7 +11,7 @@ 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.initSession = exports.init = exports.getStatus = exports.initDragDrop = exports.testConnection = void 0;
+exports.currentTransferClient = 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");
@@ -19,7 +19,9 @@ var http_gateway_1 = require("../http-gateway");
 var core_1 = require("../http-gateway/core");
 var index_1 = require("../index");
 var status_1 = require("./status");
+var ws_1 = require("../helpers/ws");
 var core_2 = require("../connect/core");
+var connect_extension_1 = require("../helpers/connect-extension");
 /**
  * Check if IBM Aspera for Desktop connection works. This function is called by init
  * when initializing the SDK. This function can be used at any point for checking.
@@ -156,6 +158,24 @@ var init = function (options) {
         throw (0, helpers_1.generateErrorBody)(messages_1.messages.serverError, error);
     };
     var getDesktopStartCalls = function () {
+        var _a, _b, _c;
+        if (((_a = options === null || options === void 0 ? void 0 : options.connectSettings) === null || _a === void 0 ? void 0 : _a.fallback) && !((_b = options === null || options === void 0 ? void 0 : options.connectSettings) === null || _b === void 0 ? void 0 : _b.useConnect)) {
+            var timeout_1 = (_c = options === null || options === void 0 ? void 0 : options.retryTimeout) !== null && _c !== void 0 ? _c : 5000;
+            return (0, helpers_1.withTimeout)(connectDesktop(), timeout_1)
+                .then(function () { return index_1.asperaSdk.globals.sdkResponseData; })
+                .catch(function () {
+                ws_1.websocketService.disconnect();
+                return (0, connect_extension_1.detectConnectExtension)(timeout_1).then(function (found) {
+                    if (found) {
+                        return (0, core_2.initConnect)(__assign(__assign({}, options.connectSettings), { hideIncludedInstaller: true }));
+                    }
+                    else if (index_1.asperaSdk.httpGatewayIsReady) {
+                        return index_1.asperaSdk.globals.sdkResponseData;
+                    }
+                    throw (0, helpers_1.generateErrorBody)(messages_1.messages.serverError);
+                });
+            });
+        }
         return connectDesktop()
             .then(function () { return index_1.asperaSdk.globals.sdkResponseData; })
             .catch(handleErrors);
@@ -226,11 +246,7 @@ exports.init = init;
  * @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
+ * // Use IBM Aspera for desktop (default)
  * registerStatusCallback(status => {
  *   if (status === 'RUNNING') {
  *     // Transfer client is ready — enable UI
@@ -250,8 +266,8 @@ exports.init = init;
  *   },
  * });
  *
- * @example
- * // Use HTTP Gateway as the sole transport (no desktop app needed)
+ * * @example
+ * // Use HTTP Gateway only
  * initSession({
  *   appId: 'my-app',
  *   httpGatewaySettings: {
@@ -260,23 +276,76 @@ exports.init = init;
  *   },
  * });
  *
+ * * @example
+ * // Use IBM Aspera for desktop with automatic fallback to IBM Aspera Connect
+ * initSession({
+ *   appId: 'my-app',
+ *   connectSettings: {
+ *     fallback: true,
+ *   },
+ * });
+ *
  * @example
- * // HTTP Gateway as supplementary transport with Desktop as primary
+ * // Use IBM Aspera for desktop with automatic fallback to HTTP Gateway
+ * initSession({
+ *   appId: 'my-app',
+ *   httpGatewaySettings: {
+ *     url: 'https://example.com/aspera/http-gwy',
+ *   },
+ * });
+ *
+ * * @example
+ * // Use IBM Aspera for desktop or IBM Aspera Connect with automatic fallback to HTTP Gateway
  * initSession({
  *   appId: 'my-app',
+ *   connectSettings: {
+ *     fallback: true,
+ *   },
  *   httpGatewaySettings: {
  *     url: 'https://example.com/aspera/http-gwy',
- *     forceGateway: false,
  *   },
  * });
  */
 var initSession = function (options) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e;
     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 hasFallback = ((_c = options === null || options === void 0 ? void 0 : options.connectSettings) === null || _c === void 0 ? void 0 : _c.fallback) && !((_d = options === null || options === void 0 ? void 0 : options.connectSettings) === null || _d === void 0 ? void 0 : _d.useConnect);
     var startDesktopDetection = function () {
-        status_1.statusService.startPolling(connectDesktop, retryInterval, retryTimeout);
+        var onFallback = hasFallback
+            ? function () {
+                ws_1.websocketService.disconnect();
+                (0, connect_extension_1.detectConnectExtension)(retryTimeout).then(function (found) {
+                    if (found) {
+                        (0, core_2.initConnect)(__assign(__assign({}, options.connectSettings), { hideIncludedInstaller: true }));
+                        var callbackId_1 = status_1.statusService.registerCallback(function (status) {
+                            if (status === 'INITIALIZING') {
+                                return;
+                            }
+                            status_1.statusService.deregisterCallback(callbackId_1);
+                            if (status !== 'RUNNING') {
+                                index_1.asperaSdk.globals.connect.removeEventListener();
+                                index_1.asperaSdk.globals.connect.stop();
+                                // Explicitly set status to FAILED since we go back to desktop mode
+                                status_1.statusService.setStatus('FAILED');
+                                status_1.statusService.resumePolling(connectDesktop, retryInterval);
+                            }
+                        });
+                    }
+                    else {
+                        if (index_1.asperaSdk.httpGatewayIsReady) {
+                            status_1.statusService.setStatus('DEGRADED');
+                        }
+                        else {
+                            status_1.statusService.setStatus('FAILED');
+                        }
+                        status_1.statusService.resumePolling(connectDesktop, retryInterval);
+                    }
+                });
+            }
+            : undefined;
+        status_1.statusService.startPolling(connectDesktop, retryInterval, retryTimeout, onFallback);
     };
     var startTransferClient = function () {
         var _a;
@@ -288,7 +357,7 @@ var initSession = function (options) {
         }
     };
     // 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) {
+    if (((_e = options === null || options === void 0 ? void 0 : options.httpGatewaySettings) === null || _e === void 0 ? void 0 : _e.url) && !index_1.asperaSdk.globals.httpGatewayVerified) {
         status_1.statusService.setStatus('INITIALIZING');
         (0, http_gateway_1.setupHttpGateway)(options.httpGatewaySettings.url).then(function () {
             var _a;
@@ -333,9 +402,11 @@ var testSshPorts = function (options) {
     }
     var promiseInfo = (0, helpers_1.generatePromiseObjects)();
     var payload = {
-        remote_host: options.remote_host,
-        ssh_port: (_a = options.ssh_port) !== null && _a !== void 0 ? _a : 33001,
-        timeout_sec: (_b = options.timeout_sec) !== null && _b !== void 0 ? _b : 3,
+        request: {
+            remote_host: options.remote_host,
+            ssh_port: (_a = options.ssh_port) !== null && _a !== void 0 ? _a : 33001,
+            timeout_sec: (_b = options.timeout_sec) !== null && _b !== void 0 ? _b : 3,
+        }
     };
     client_1.client.request('test_ssh_ports', payload)
         .then(function (data) { return promiseInfo.resolver(data); })
@@ -400,9 +471,10 @@ var startTransfer = function (transferSpec, asperaSdkSpec) {
                 'Connect dialogs block all subsequent HTTP responses. ' +
                 'Set `allow_dialogs: false` explicitly to suppress this warning. ' +
                 'More info: https://github.com/IBM/aspera-sdk-js/issues/196');
-            asperaSdkSpec = __assign(__assign({}, asperaSdkSpec), { allow_dialogs: false });
+            asperaSdkSpec.allow_dialogs = false;
         }
         return index_1.asperaSdk.globals.connect.startTransferPromise(transferSpec, asperaSdkSpec).then(function (response) {
+            response.transfer_specs[0].transfer_client = 'connect';
             return response.transfer_specs[0];
         });
     }
@@ -416,7 +488,10 @@ var startTransfer = function (transferSpec, asperaSdkSpec) {
         app_id: index_1.asperaSdk.globals.appId,
     };
     client_1.client.request('start_transfer', payload)
-        .then(function (data) { return promiseInfo.resolver(data); })
+        .then(function (data) {
+        data.transfer_client = 'desktop';
+        promiseInfo.resolver(data);
+    })
         .catch(function (error) {
         (0, helpers_1.errorLog)(messages_1.messages.transferFailed, error);
         promiseInfo.rejecter((0, helpers_1.generateErrorBody)(messages_1.messages.transferFailed, error));
@@ -567,6 +642,7 @@ exports.stopTransfer = stopTransfer;
 var resumeTransfer = function (id, options) {
     if (index_1.asperaSdk.useConnect) {
         return index_1.asperaSdk.globals.connect.resumeTransfer(id, options).then(function (response) {
+            response.transfer_spec.transfer_client = 'connect';
             return response.transfer_spec;
         });
     }
@@ -579,7 +655,10 @@ var resumeTransfer = function (id, options) {
         transfer_spec: options,
     };
     client_1.client.request('resume_transfer', payload)
-        .then(function (data) { return promiseInfo.resolver(data); })
+        .then(function (data) {
+        data.transfer_client = 'desktop';
+        promiseInfo.resolver(data);
+    })
         .catch(function (error) {
         (0, helpers_1.errorLog)(messages_1.messages.resumeTransferFailed, error);
         promiseInfo.rejecter((0, helpers_1.generateErrorBody)(messages_1.messages.resumeTransferFailed, error));
@@ -852,6 +931,9 @@ var getAllTransfers = function () {
     else if (index_1.asperaSdk.useConnect) {
         index_1.asperaSdk.globals.connect.getAllTransfers({
             success: function (data) {
+                data.transfers.forEach(function (t) {
+                    t.transfer_client = 'connect';
+                });
                 promiseInfo.resolver(data.transfers);
             }, error: function (error) {
                 promiseInfo.rejecter(error);
@@ -866,7 +948,12 @@ var getAllTransfers = function () {
         app_id: index_1.asperaSdk.globals.appId,
     };
     client_1.client.request('get_all_transfers', payload)
-        .then(function (data) { return promiseInfo.resolver(data); })
+        .then(function (data) {
+        data.forEach(function (t) {
+            t.transfer_client = 'desktop';
+        });
+        promiseInfo.resolver(data);
+    })
         .catch(function (error) {
         (0, helpers_1.errorLog)(messages_1.messages.getAllTransfersFailed, error);
         promiseInfo.rejecter((0, helpers_1.generateErrorBody)(messages_1.messages.getAllTransfersFailed, error));
@@ -893,6 +980,7 @@ var getTransfer = function (id) {
     }
     else if (index_1.asperaSdk.useConnect) {
         return index_1.asperaSdk.globals.connect.getTransfer(id).then(function (response) {
+            response.transfer_info.transfer_client = 'connect';
             return response.transfer_info;
         });
     }
@@ -904,7 +992,10 @@ var getTransfer = function (id) {
         transfer_id: id,
     };
     client_1.client.request('get_transfer', payload)
-        .then(function (data) { return promiseInfo.resolver(data); })
+        .then(function (data) {
+        data.transfer_client = 'desktop';
+        promiseInfo.resolver(data);
+    })
         .catch(function (error) {
         (0, helpers_1.errorLog)(messages_1.messages.getTransferFailed, error);
         promiseInfo.rejecter((0, helpers_1.generateErrorBody)(messages_1.messages.getTransferFailed, error));
@@ -1342,6 +1433,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.).
@@ -1362,11 +1457,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.
  *
@@ -1394,10 +1490,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.
  *
@@ -1407,7 +1511,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);
  * }
  * ```
  */
@@ -1415,3 +1519,15 @@ var hasCapability = function (capability) {
     return !!(0, exports.getCapabilities)()[capability];
 };
 exports.hasCapability = hasCapability;
+var currentTransferClient = function () {
+    if (index_1.asperaSdk.useHttpGateway) {
+        return 'http-gateway';
+    }
+    else if (index_1.asperaSdk.useConnect) {
+        return 'connect';
+    }
+    else if (index_1.asperaSdk.isReady) {
+        return 'desktop';
+    }
+};
+exports.currentTransferClient = currentTransferClient;

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

@@ -15,8 +15,18 @@ declare class StatusService {
      * @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
+     * @param onFallback optional callback invoked on timeout instead of FAILED/DEGRADED (e.g. to start Connect)
      */
-    startPolling(detectFn: () => Promise<void>, interval: number, failTimeout: number): void;
+    startPolling(detectFn: () => Promise<void>, interval: number, failTimeout: number, onFallback?: () => void): void;
+    /**
+     * Resume Desktop detection polling without resetting status or setting a fail timeout.
+     * Used after a fallback decision (e.g. FAILED/DEGRADED) to continue detecting Desktop
+     * in the background so a late launch can still transition to RUNNING.
+     *
+     * @param detectFn async function that resolves if Desktop is found, rejects if not
+     * @param interval ms between attempts
+     */
+    resumePolling(detectFn: () => Promise<void>, interval: number): void;
     stopPolling(): void;
     reset(): void;
 }

package/dist/commonjs/app/status.js

@@ -14,8 +14,8 @@ var StatusService = /** @class */ (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) {
+        // When Desktop disconnects or transfer client fails, remap to DEGRADED if HTTP Gateway is available
+        if ((status === 'DISCONNECTED' || status === 'FAILED') && index_1.asperaSdk.httpGatewayIsReady) {
             status = 'DEGRADED';
         }
         if (this.currentStatus === status) {
@@ -48,14 +48,19 @@ var StatusService = /** @class */ (function () {
      * @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
+     * @param onFallback optional callback invoked on timeout instead of FAILED/DEGRADED (e.g. to start Connect)
      */
-    StatusService.prototype.startPolling = function (detectFn, interval, failTimeout) {
+    StatusService.prototype.startPolling = function (detectFn, interval, failTimeout, onFallback) {
         var _this = this;
         this.stopPolling();
         this.setStatus('INITIALIZING');
         this.failTimeoutId = setTimeout(function () {
             if (_this.currentStatus !== 'RUNNING') {
-                if (index_1.asperaSdk.httpGatewayIsReady) {
+                if (onFallback) {
+                    _this.stopPolling();
+                    onFallback();
+                }
+                else if (index_1.asperaSdk.httpGatewayIsReady) {
                     _this.setStatus('DEGRADED');
                 }
                 else {
@@ -76,6 +81,32 @@ var StatusService = /** @class */ (function () {
         attempt();
         this.pollTimerId = setInterval(attempt, interval);
     };
+    /**
+     * Resume Desktop detection polling without resetting status or setting a fail timeout.
+     * Used after a fallback decision (e.g. FAILED/DEGRADED) to continue detecting Desktop
+     * in the background so a late launch can still transition to RUNNING.
+     *
+     * @param detectFn async function that resolves if Desktop is found, rejects if not
+     * @param interval ms between attempts
+     */
+    StatusService.prototype.resumePolling = function (detectFn, interval) {
+        var _this = this;
+        if (this.pollTimerId) {
+            return;
+        }
+        var attempt = function () {
+            detectFn()
+                .then(function () {
+                _this.stopPolling();
+                _this.setStatus('RUNNING');
+            })
+                .catch(function () {
+                // Stay in current status, poll continues
+            });
+        };
+        attempt();
+        this.pollTimerId = setInterval(attempt, interval);
+    };
     StatusService.prototype.stopPolling = function () {
         if (this.pollTimerId) {
             clearInterval(this.pollTimerId);

package/dist/commonjs/connect/core.js

@@ -13,6 +13,9 @@ var installerFlowActivated = false;
  * You may not need to import anything from this file.
  */
 var handleTransfers = function (transfers) {
+    transfers.forEach(function (t) {
+        t.transfer_client = 'connect';
+    });
     index_1.asperaSdk.activityTracking.handleTransferActivity({
         type: 'transferUpdated',
         data: { transfers: transfers },

package/dist/commonjs/helpers/connect-extension.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Lightweight check for the Connect browser extension.
+ * Does NOT launch Connect — only checks if the extension is installed.
+ *
+ * Chrome/Firefox/Edge: dispatches AsperaConnectCheck, listens for window message
+ * Safari: dispatches AsperaConnectCheck, listens for document event
+ */
+export declare const detectConnectExtension: (timeoutMs: number) => Promise<boolean>;

package/dist/commonjs/helpers/connect-extension.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectConnectExtension = void 0;
+var helpers_1 = require("./helpers");
+/**
+ * Lightweight check for the Connect browser extension.
+ * Does NOT launch Connect — only checks if the extension is installed.
+ *
+ * Chrome/Firefox/Edge: dispatches AsperaConnectCheck, listens for window message
+ * Safari: dispatches AsperaConnectCheck, listens for document event
+ */
+var detectConnectExtension = function (timeoutMs) {
+    return new Promise(function (resolve) {
+        var resolved = false;
+        var timer = setTimeout(function () {
+            if (!resolved) {
+                resolved = true;
+                resolve(false);
+            }
+        }, timeoutMs);
+        if ((0, helpers_1.isSafari)()) {
+            var handler_1 = function () {
+                if (!resolved) {
+                    resolved = true;
+                    clearTimeout(timer);
+                    document.removeEventListener('AsperaConnectCheckResponse', handler_1);
+                    resolve(true);
+                }
+            };
+            document.addEventListener('AsperaConnectCheckResponse', handler_1);
+        }
+        else {
+            var handler_2 = function (evt) {
+                var _a;
+                if (!resolved &&
+                    typeof evt.data === 'object' &&
+                    ((_a = evt.data) === null || _a === void 0 ? void 0 : _a.type) === 'AsperaConnectCheckResponse') {
+                    resolved = true;
+                    clearTimeout(timer);
+                    window.removeEventListener('message', handler_2);
+                    resolve(true);
+                }
+            };
+            window.addEventListener('message', handler_2);
+        }
+        // Poll interval self-cleans via the resolved flag
+        var poll = setInterval(function () {
+            if (resolved) {
+                clearInterval(poll);
+                return;
+            }
+            document.dispatchEvent(new CustomEvent('AsperaConnectCheck'));
+        }, 200);
+        // Fire immediately
+        document.dispatchEvent(new CustomEvent('AsperaConnectCheck'));
+    });
+};
+exports.detectConnectExtension = detectConnectExtension;

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

@@ -91,6 +91,11 @@ export declare const safeJsonString: (json: unknown) => string;
  * @returns object or array from the JSON string. Or undefined
  */
 export declare const safeJsonParse: (json: string) => any | undefined;
+/**
+ * Race a promise against a timeout. Rejects with an Error('timeout') if the
+ * given milliseconds elapse before the promise settles.
+ */
+export declare const withTimeout: <T>(promise: Promise<T>, ms: number) => Promise<T>;
 declare const _default: {
     errorLog: (message: string, debugData?: any) => void;
     generateErrorBody: (message: string, debugData?: any) => ErrorResponse;
@@ -105,5 +110,6 @@ declare const _default: {
     getInstallerUrls: () => InstallerUrlInfo;
     safeJsonString: (json: unknown) => string;
     safeJsonParse: (json: string) => any | undefined;
+    withTimeout: <T>(promise: Promise<T>, ms: number) => Promise<T>;
 };
 export default _default;