@ibm-aspera/sdk 0.7.4 → 0.11.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, InitOptions, ModifyTransferOptions, Pagination, PaginatedFilesResponse, ResumeTransferOptions, TransferSpec, WebsocketEvent, ReadChunkAsArrayBufferResponse, ReadAsArrayBufferResponse, SdkCapabilities, GetChecksumOptions, ChecksumFileResponse } from '../models/models';
+import { CustomBrandingOptions, DataTransferResponse, DropzoneEventData, DropzoneOptions, AsperaSdkSpec, AsperaSdkTransfer, FileDialogOptions, FolderDialogOptions, InitOptions, ModifyTransferOptions, Pagination, PaginatedFilesResponse, ResumeTransferOptions, TransferSpec, WebsocketEvent, ReadChunkAsArrayBufferResponse, ReadAsArrayBufferResponse, SdkCapabilities, GetChecksumOptions, ChecksumFileResponse, ReadDirectoryOptions, ReadDirectoryResponse } 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.
@@ -116,12 +116,28 @@ export declare const showSelectFileDialog: (options?: FileDialogOptions) => Prom
  * @returns a promise that resolves with the selected folder(s) and rejects if user cancels dialog
  */
 export declare const showSelectFolderDialog: (options?: FolderDialogOptions) => Promise<DataTransferResponse>;
+/**
+ * Shows the about page of the transfer client.
+ *
+ * This is supported when using Connect or IBM Aspera for desktop, but not HTTP Gateway.
+ *
+ * @returns a promise that resolves when the about page is shown.
+ */
+export declare const showAbout: () => Promise<any>;
 /**
  * Opens the IBM Aspera preferences page.
  *
  * @returns a promise that resolves when the preferences page is opened.
  */
 export declare const showPreferences: () => Promise<any>;
+/**
+ * Opens the transfer manager UI of the native transfer client.
+ *
+ * Supported for Connect and IBM Aspera for desktop. Not supported for HTTP Gateway.
+ *
+ * @returns a promise that resolves when the transfer manager is opened.
+ */
+export declare const showTransferManager: () => Promise<any>;
 /**
  * Get all transfers associated with the current application.
  *
@@ -224,6 +240,16 @@ export declare const readChunkAsArrayBuffer: (path: string, offset: number, chun
  * @returns a promise that resolves with the checksum information
  */
 export declare const getChecksum: (options: GetChecksumOptions) => Promise<ChecksumFileResponse>;
+/**
+ * Read the contents of a directory, returning all entries as a flat list.
+ *
+ * This API is only supported when using IBM Aspera for desktop.
+ *
+ * @param options options including the directory path, optional recursion depth, and filters
+ *
+ * @returns a promise that resolves with the directory entries and total count
+ */
+export declare const readDirectory: (options: ReadDirectoryOptions) => Promise<ReadDirectoryResponse>;
 /**
  * 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).
@@ -245,3 +271,22 @@ export declare const getChecksum: (options: GetChecksumOptions) => Promise<Check
  * }
  */
 export declare const getCapabilities: () => SdkCapabilities;
+/**
+ * Check if the SDK and underlying transfer client supports a specific capability.
+ *
+ * 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.
+ *
+ * @param capability the capability to check.
+ *
+ * @returns `true` if the capability is supported, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * // Determine if your web application can render image previews for user selected files
+ * if (asperaSdk.hasCapability('imagePreview')) {
+ *   asperaSdk.readAsArrayBuffer(path);
+ * }
+ * ```
+ */
+export declare const hasCapability: (capability: keyof SdkCapabilities) => boolean;

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.getCapabilities = 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.showPreferences = exports.showSelectFolderDialog = exports.showSelectFileDialog = exports.resumeTransfer = exports.stopTransfer = exports.removeTransfer = exports.deregisterStatusCallback = exports.registerStatusCallback = exports.deregisterActivityCallback = exports.registerActivityCallback = exports.startTransfer = 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.showTransferManager = exports.showPreferences = exports.showAbout = exports.showSelectFolderDialog = exports.showSelectFileDialog = exports.resumeTransfer = exports.stopTransfer = exports.removeTransfer = exports.deregisterStatusCallback = exports.registerStatusCallback = exports.deregisterActivityCallback = exports.registerActivityCallback = exports.startTransfer = exports.init = 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");
@@ -435,6 +435,33 @@ var showSelectFolderDialog = function (options) {
     return promiseInfo.promise;
 };
 exports.showSelectFolderDialog = showSelectFolderDialog;
+/**
+ * Shows the about page of the transfer client.
+ *
+ * This is supported when using Connect or IBM Aspera for desktop, but not HTTP Gateway.
+ *
+ * @returns a promise that resolves when the about page is shown.
+ */
+var showAbout = function () {
+    if (index_1.asperaSdk.useHttpGateway) {
+        return (0, helpers_1.throwError)(messages_1.messages.showAboutNotSupported);
+    }
+    if (index_1.asperaSdk.useConnect) {
+        return index_1.asperaSdk.globals.connect.showAbout();
+    }
+    if (!index_1.asperaSdk.isReady) {
+        return (0, helpers_1.throwError)(messages_1.messages.serverNotVerified);
+    }
+    var promiseInfo = (0, helpers_1.generatePromiseObjects)();
+    client_1.client.request('show_about')
+        .then(function (data) { return promiseInfo.resolver(data); })
+        .catch(function (error) {
+        (0, helpers_1.errorLog)(messages_1.messages.showAboutFailed, error);
+        promiseInfo.rejecter((0, helpers_1.generateErrorBody)(messages_1.messages.showAboutFailed, error));
+    });
+    return promiseInfo.promise;
+};
+exports.showAbout = showAbout;
 /**
  * Opens the IBM Aspera preferences page.
  *
@@ -457,6 +484,33 @@ var showPreferences = function () {
     return promiseInfo.promise;
 };
 exports.showPreferences = showPreferences;
+/**
+ * Opens the transfer manager UI of the native transfer client.
+ *
+ * Supported for Connect and IBM Aspera for desktop. Not supported for HTTP Gateway.
+ *
+ * @returns a promise that resolves when the transfer manager is opened.
+ */
+var showTransferManager = function () {
+    if (index_1.asperaSdk.useHttpGateway) {
+        return (0, helpers_1.throwError)(messages_1.messages.showTransferManagerNotSupported);
+    }
+    if (index_1.asperaSdk.useConnect) {
+        return index_1.asperaSdk.globals.connect.showTransferManager();
+    }
+    if (!index_1.asperaSdk.isReady) {
+        return (0, helpers_1.throwError)(messages_1.messages.serverNotVerified);
+    }
+    var promiseInfo = (0, helpers_1.generatePromiseObjects)();
+    client_1.client.request('show_transfer_manager')
+        .then(function (data) { return promiseInfo.resolver(data); })
+        .catch(function (error) {
+        (0, helpers_1.errorLog)(messages_1.messages.showTransferManagerFailed, error);
+        promiseInfo.rejecter((0, helpers_1.generateErrorBody)(messages_1.messages.showTransferManagerFailed, error));
+    });
+    return promiseInfo.promise;
+};
+exports.showTransferManager = showTransferManager;
 /**
  * Get all transfers associated with the current application.
  *
@@ -922,10 +976,52 @@ var getChecksum = function (options) {
     return promiseInfo.promise;
 };
 exports.getChecksum = getChecksum;
+/**
+ * Read the contents of a directory, returning all entries as a flat list.
+ *
+ * This API is only supported when using IBM Aspera for desktop.
+ *
+ * @param options options including the directory path, optional recursion depth, and filters
+ *
+ * @returns a promise that resolves with the directory entries and total count
+ */
+var readDirectory = function (options) {
+    if (index_1.asperaSdk.useHttpGateway) {
+        return (0, helpers_1.throwError)(messages_1.messages.readDirectoryNotSupported);
+    }
+    if (index_1.asperaSdk.useConnect) {
+        return (0, helpers_1.throwError)(messages_1.messages.readDirectoryNotSupported);
+    }
+    if (!index_1.asperaSdk.isReady) {
+        return (0, helpers_1.throwError)(messages_1.messages.serverNotVerified);
+    }
+    var promiseInfo = (0, helpers_1.generatePromiseObjects)();
+    var payload = {
+        request: {
+            path: options.path,
+            depth: options.depth,
+            filters: options.filters,
+        },
+        app_id: index_1.asperaSdk.globals.appId,
+    };
+    client_1.client.request('read_directory', payload)
+        .then(function (data) { return promiseInfo.resolver(data); })
+        .catch(function (error) {
+        (0, helpers_1.errorLog)(messages_1.messages.readDirectoryFailed, error);
+        promiseInfo.rejecter((0, helpers_1.generateErrorBody)(messages_1.messages.readDirectoryFailed, error));
+    });
+    return promiseInfo.promise;
+};
+exports.readDirectory = readDirectory;
 var supportsMethod = function (method) {
     // We currently do not support calculating file checksums when using HTTP Gateway. In theory it should be possible
-    // to calculate this direclty in the browser similar to how `readAsArrayBuffer()` is implemented.
-    if (index_1.asperaSdk.useHttpGateway && method === 'get_checksum') {
+    // 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.).
+    if (index_1.asperaSdk.useHttpGateway && (method === 'get_checksum' || method === 'show_about' || method === 'open_preferences' || method === 'show_transfer_manager' || method === 'read_directory')) {
+        return false;
+    }
+    // Reading directory contents is only supported by the Desktop App (not Connect).
+    if (index_1.asperaSdk.useConnect && method === 'read_directory') {
         return false;
     }
     // HTTP Gateway and Connect do not have any RPC methods so fallback to true
@@ -958,6 +1054,32 @@ var getCapabilities = function () {
     return {
         imagePreview: supportsMethod('read_as_array_buffer') && supportsMethod('read_chunk_as_array_buffer'),
         fileChecksum: supportsMethod('get_checksum'),
+        showAbout: supportsMethod('show_about'),
+        showPreferences: supportsMethod('open_preferences'),
+        showTransferManager: supportsMethod('show_transfer_manager'),
+        readDirectory: supportsMethod('read_directory'),
     };
 };
 exports.getCapabilities = getCapabilities;
+/**
+ * Check if the SDK and underlying transfer client supports a specific capability.
+ *
+ * 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.
+ *
+ * @param capability the capability to check.
+ *
+ * @returns `true` if the capability is supported, `false` otherwise
+ *
+ * @example
+ * ```typescript
+ * // Determine if your web application can render image previews for user selected files
+ * if (asperaSdk.hasCapability('imagePreview')) {
+ *   asperaSdk.readAsArrayBuffer(path);
+ * }
+ * ```
+ */
+var hasCapability = function (capability) {
+    return !!(0, exports.getCapabilities)()[capability];
+};
+exports.hasCapability = hasCapability;

package/dist/commonjs/constants/messages.d.ts

@@ -39,4 +39,10 @@ export declare const messages: {
     getFilesListFailed: string;
     getChecksumFailed: string;
     getChecksumNotSupported: string;
+    showAboutFailed: string;
+    showAboutNotSupported: string;
+    readDirectoryFailed: string;
+    readDirectoryNotSupported: string;
+    showTransferManagerFailed: string;
+    showTransferManagerNotSupported: string;
 };

package/dist/commonjs/constants/messages.js

@@ -42,4 +42,10 @@ exports.messages = {
     getFilesListFailed: 'Unable to get files list for transfer',
     getChecksumFailed: 'Unable to get file checksum',
     getChecksumNotSupported: 'File checksum not supported for current transfer client',
+    showAboutFailed: 'Unable to show about page',
+    showAboutNotSupported: 'Show about is not supported for current transfer client',
+    readDirectoryFailed: 'Unable to read directory contents',
+    readDirectoryNotSupported: 'Read directory is not supported for current transfer client',
+    showTransferManagerFailed: 'Unable to show transfer manager',
+    showTransferManagerNotSupported: 'Show transfer manager is not supported for current transfer client',
 };

package/dist/commonjs/index.d.ts

@@ -1,11 +1,11 @@
 import { AsperaSdk } from './models/aspera-sdk.model';
-import { createDropzone, deregisterActivityCallback, deregisterStatusCallback, getAllTransfers, getCapabilities, getChecksum, getFilesList, getInfo, getTransfer, init, initDragDrop, modifyTransfer, readAsArrayBuffer, readChunkAsArrayBuffer, registerActivityCallback, registerStatusCallback, removeDropzone, removeTransfer, resumeTransfer, setBranding, showDirectory, showPreferences, showSelectFileDialog, showSelectFolderDialog, startTransfer, stopTransfer, testConnection } from './app/core';
+import { createDropzone, deregisterActivityCallback, deregisterStatusCallback, getAllTransfers, getCapabilities, getChecksum, getFilesList, getInfo, getTransfer, hasCapability, init, initDragDrop, modifyTransfer, readAsArrayBuffer, readChunkAsArrayBuffer, readDirectory, registerActivityCallback, registerStatusCallback, removeDropzone, removeTransfer, resumeTransfer, setBranding, showAbout, showDirectory, showPreferences, showSelectFileDialog, showSelectFolderDialog, showTransferManager, startTransfer, stopTransfer, testConnection } from './app/core';
 import { getInstallerInfo } from './app/installer';
 import { getInstallerUrls, isSafari } from './helpers/helpers';
 export declare const asperaSdk: AsperaSdk;
 declare const launch: () => void;
-export { isSafari, init, testConnection, startTransfer, launch, registerActivityCallback, deregisterActivityCallback, removeTransfer, showDirectory, stopTransfer, resumeTransfer, getAllTransfers, getTransfer, getFilesList, showSelectFileDialog, showSelectFolderDialog, showPreferences, modifyTransfer, createDropzone, removeDropzone, initDragDrop, getInstallerInfo, registerStatusCallback, deregisterStatusCallback, setBranding, getInfo, readAsArrayBuffer, readChunkAsArrayBuffer, getInstallerUrls, getCapabilities, getChecksum, };
-export type { AsperaSdkSpec, AsperaSdkTransfer, BrowserStyleFile, ChecksumFileResponse, CustomBrandingOptions, CustomTheme, CustomThemeItems, DataTransferResponse, DropzoneEventData, DropzoneEventType, DropzoneOptions, FileDialogOptions, FileError, FileFilter, FileStat, FileStatus, FolderDialogOptions, GetChecksumOptions, InitOptions, InstallerInfo, InstallerInfoResponse, InstallerOptions, InstallerUrlInfo, ModifyTransferOptions, OverwritePolicy, PaginatedFilesResponse, Pagination, Path, ReadAsArrayBufferResponse, ReadChunkAsArrayBufferResponse, ResumePolicy, ResumeTransferOptions, SafariExtensionEvent, SdkCapabilities, TransferSpec, TransferStatus, WebsocketEvent, } from './models/models';
+export { isSafari, init, testConnection, startTransfer, launch, registerActivityCallback, deregisterActivityCallback, removeTransfer, showAbout, showDirectory, stopTransfer, resumeTransfer, getAllTransfers, getTransfer, getFilesList, showSelectFileDialog, showSelectFolderDialog, showPreferences, showTransferManager, modifyTransfer, createDropzone, removeDropzone, initDragDrop, getInstallerInfo, registerStatusCallback, deregisterStatusCallback, setBranding, getInfo, readAsArrayBuffer, readChunkAsArrayBuffer, getInstallerUrls, getCapabilities, hasCapability, getChecksum, readDirectory, };
+export type { AsperaSdkSpec, AsperaSdkTransfer, BrowserStyleFile, ChecksumFileResponse, DirectoryEntry, DirectoryListFilters, CustomBrandingOptions, CustomTheme, CustomThemeItems, DataTransferResponse, DropzoneEventData, DropzoneEventType, EntryType, DropzoneOptions, FileDialogOptions, FileError, FileFilter, FileStat, FileStatus, FolderDialogOptions, GetChecksumOptions, InitOptions, InstallerInfo, InstallerInfoResponse, InstallerOptions, InstallerUrlInfo, ModifyTransferOptions, OverwritePolicy, PaginatedFilesResponse, Pagination, Path, ReadAsArrayBufferResponse, ReadChunkAsArrayBufferResponse, ReadDirectoryOptions, ReadDirectoryResponse, ResumePolicy, ResumeTransferOptions, SafariExtensionEvent, SdkCapabilities, TransferSpec, TransferStatus, WebsocketEvent, } from './models/models';
 export type { ActivityMessage, ActivityMessageTypes, AsperaSdkClientInfo, AsperaSdkInfo, TransferResponse, } from './models/aspera-sdk.model';
 export { AsperaSdk, AsperaSdkGlobals } from './models/aspera-sdk.model';
 export type { HttpGatewayInfo } from './http-gateway/models';

package/dist/commonjs/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AsperaSdkGlobals = exports.AsperaSdk = exports.getChecksum = exports.getCapabilities = exports.getInstallerUrls = exports.readChunkAsArrayBuffer = exports.readAsArrayBuffer = exports.getInfo = exports.setBranding = exports.deregisterStatusCallback = exports.registerStatusCallback = exports.getInstallerInfo = exports.initDragDrop = exports.removeDropzone = exports.createDropzone = exports.modifyTransfer = exports.showPreferences = exports.showSelectFolderDialog = exports.showSelectFileDialog = exports.getFilesList = exports.getTransfer = exports.getAllTransfers = exports.resumeTransfer = exports.stopTransfer = exports.showDirectory = exports.removeTransfer = exports.deregisterActivityCallback = exports.registerActivityCallback = exports.launch = exports.startTransfer = exports.testConnection = exports.init = exports.isSafari = exports.asperaSdk = void 0;
+exports.AsperaSdkGlobals = exports.AsperaSdk = exports.readDirectory = exports.getChecksum = exports.hasCapability = exports.getCapabilities = exports.getInstallerUrls = exports.readChunkAsArrayBuffer = exports.readAsArrayBuffer = exports.getInfo = exports.setBranding = exports.deregisterStatusCallback = exports.registerStatusCallback = exports.getInstallerInfo = exports.initDragDrop = exports.removeDropzone = exports.createDropzone = exports.modifyTransfer = exports.showTransferManager = exports.showPreferences = exports.showSelectFolderDialog = exports.showSelectFileDialog = exports.getFilesList = exports.getTransfer = exports.getAllTransfers = exports.resumeTransfer = exports.stopTransfer = exports.showDirectory = exports.showAbout = exports.removeTransfer = exports.deregisterActivityCallback = exports.registerActivityCallback = exports.launch = exports.startTransfer = exports.testConnection = exports.init = exports.isSafari = exports.asperaSdk = void 0;
 var aspera_sdk_model_1 = require("./models/aspera-sdk.model");
 var core_1 = require("./app/core");
 Object.defineProperty(exports, "createDropzone", { enumerable: true, get: function () { return core_1.createDropzone; } });
@@ -45,21 +45,25 @@ Object.defineProperty(exports, "getChecksum", { enumerable: true, get: function
 Object.defineProperty(exports, "getFilesList", { enumerable: true, get: function () { return core_1.getFilesList; } });
 Object.defineProperty(exports, "getInfo", { enumerable: true, get: function () { return core_1.getInfo; } });
 Object.defineProperty(exports, "getTransfer", { enumerable: true, get: function () { return core_1.getTransfer; } });
+Object.defineProperty(exports, "hasCapability", { enumerable: true, get: function () { return core_1.hasCapability; } });
 Object.defineProperty(exports, "init", { enumerable: true, get: function () { return core_1.init; } });
 Object.defineProperty(exports, "initDragDrop", { enumerable: true, get: function () { return core_1.initDragDrop; } });
 Object.defineProperty(exports, "modifyTransfer", { enumerable: true, get: function () { return core_1.modifyTransfer; } });
 Object.defineProperty(exports, "readAsArrayBuffer", { enumerable: true, get: function () { return core_1.readAsArrayBuffer; } });
 Object.defineProperty(exports, "readChunkAsArrayBuffer", { enumerable: true, get: function () { return core_1.readChunkAsArrayBuffer; } });
+Object.defineProperty(exports, "readDirectory", { enumerable: true, get: function () { return core_1.readDirectory; } });
 Object.defineProperty(exports, "registerActivityCallback", { enumerable: true, get: function () { return core_1.registerActivityCallback; } });
 Object.defineProperty(exports, "registerStatusCallback", { enumerable: true, get: function () { return core_1.registerStatusCallback; } });
 Object.defineProperty(exports, "removeDropzone", { enumerable: true, get: function () { return core_1.removeDropzone; } });
 Object.defineProperty(exports, "removeTransfer", { enumerable: true, get: function () { return core_1.removeTransfer; } });
 Object.defineProperty(exports, "resumeTransfer", { enumerable: true, get: function () { return core_1.resumeTransfer; } });
 Object.defineProperty(exports, "setBranding", { enumerable: true, get: function () { return core_1.setBranding; } });
+Object.defineProperty(exports, "showAbout", { enumerable: true, get: function () { return core_1.showAbout; } });
 Object.defineProperty(exports, "showDirectory", { enumerable: true, get: function () { return core_1.showDirectory; } });
 Object.defineProperty(exports, "showPreferences", { enumerable: true, get: function () { return core_1.showPreferences; } });
 Object.defineProperty(exports, "showSelectFileDialog", { enumerable: true, get: function () { return core_1.showSelectFileDialog; } });
 Object.defineProperty(exports, "showSelectFolderDialog", { enumerable: true, get: function () { return core_1.showSelectFolderDialog; } });
+Object.defineProperty(exports, "showTransferManager", { enumerable: true, get: function () { return core_1.showTransferManager; } });
 Object.defineProperty(exports, "startTransfer", { enumerable: true, get: function () { return core_1.startTransfer; } });
 Object.defineProperty(exports, "stopTransfer", { enumerable: true, get: function () { return core_1.stopTransfer; } });
 Object.defineProperty(exports, "testConnection", { enumerable: true, get: function () { return core_1.testConnection; } });
@@ -76,6 +80,7 @@ exports.asperaSdk.startTransfer = core_1.startTransfer;
 exports.asperaSdk.registerActivityCallback = core_1.registerActivityCallback;
 exports.asperaSdk.deregisterActivityCallback = core_1.deregisterActivityCallback;
 exports.asperaSdk.removeTransfer = core_1.removeTransfer;
+exports.asperaSdk.showAbout = core_1.showAbout;
 exports.asperaSdk.showDirectory = core_1.showDirectory;
 exports.asperaSdk.stopTransfer = core_1.stopTransfer;
 exports.asperaSdk.resumeTransfer = core_1.resumeTransfer;
@@ -85,6 +90,7 @@ exports.asperaSdk.getFilesList = core_1.getFilesList;
 exports.asperaSdk.showSelectFileDialog = core_1.showSelectFileDialog;
 exports.asperaSdk.showSelectFolderDialog = core_1.showSelectFolderDialog;
 exports.asperaSdk.showPreferences = core_1.showPreferences;
+exports.asperaSdk.showTransferManager = core_1.showTransferManager;
 exports.asperaSdk.modifyTransfer = core_1.modifyTransfer;
 exports.asperaSdk.createDropzone = core_1.createDropzone;
 exports.asperaSdk.removeDropzone = core_1.removeDropzone;
@@ -99,7 +105,9 @@ exports.asperaSdk.readChunkAsArrayBuffer = core_1.readChunkAsArrayBuffer;
 exports.asperaSdk.isSafari = helpers_1.isSafari;
 exports.asperaSdk.getInstallerUrls = helpers_1.getInstallerUrls;
 exports.asperaSdk.getCapabilities = core_1.getCapabilities;
+exports.asperaSdk.hasCapability = core_1.hasCapability;
 exports.asperaSdk.getChecksum = core_1.getChecksum;
+exports.asperaSdk.readDirectory = core_1.readDirectory;
 exports.asperaSdk.httpGatewayCalls = httpGatewayCalls;
 var launch = exports.asperaSdk.globals.launch;
 exports.launch = launch;

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

@@ -1,4 +1,4 @@
-import { CustomBrandingOptions, DataTransferResponse, DropzoneEventData, DropzoneEventType, DropzoneOptions, AsperaSdkSpec, AsperaSdkTransfer, FileDialogOptions, FolderDialogOptions, InitOptions, InstallerInfoResponse, InstallerOptions, ModifyTransferOptions, Pagination, PaginatedFilesResponse, ResumeTransferOptions, SafariExtensionEvent, TransferSpec, WebsocketEvent, InstallerUrlInfo, SdkCapabilities, GetChecksumOptions, ChecksumFileResponse } from './models';
+import { CustomBrandingOptions, DataTransferResponse, DropzoneEventData, DropzoneEventType, DropzoneOptions, AsperaSdkSpec, AsperaSdkTransfer, FileDialogOptions, FolderDialogOptions, InitOptions, InstallerInfoResponse, InstallerOptions, ModifyTransferOptions, Pagination, PaginatedFilesResponse, ResumeTransferOptions, SafariExtensionEvent, TransferSpec, WebsocketEvent, InstallerUrlInfo, SdkCapabilities, GetChecksumOptions, ChecksumFileResponse, ReadDirectoryOptions, ReadDirectoryResponse } from './models';
 import { HttpGatewayInfo } from '../http-gateway/models';
 import * as ConnectTypes from '@ibm-aspera/connect-sdk-js/dist/esm/core/types';
 import { Connect, ConnectInstaller } from '@ibm-aspera/connect-sdk-js';
@@ -201,8 +201,12 @@ export declare class AsperaSdk {
     showSelectFileDialog: (options?: FileDialogOptions) => Promise<DataTransferResponse>;
     /** Function to display a folder dialog for the user to select folders. */
     showSelectFolderDialog: (options?: FolderDialogOptions) => Promise<DataTransferResponse>;
+    /** Function to show the about page of the transfer client */
+    showAbout: () => Promise<any>;
     /** Function to display the IBM Aspera preferences page */
     showPreferences: () => Promise<any>;
+    /** Function to show the transfer manager UI */
+    showTransferManager: () => Promise<any>;
     /** Function to modify a running transfer */
     modifyTransfer: (transferId: string, options: ModifyTransferOptions) => Promise<AsperaSdkTransfer>;
     /** Function to set custom branding for IBM Aspera */
@@ -235,8 +239,12 @@ export declare class AsperaSdk {
     getInstallerUrls: () => InstallerUrlInfo;
     /** Function to get the SDK capabilities. */
     getCapabilities: () => SdkCapabilities;
+    /** Function to check whether the SDK supports the specified capability */
+    hasCapability: (capability: keyof SdkCapabilities) => boolean;
     /** Function to get a checksum for a file */
     getChecksum: (options: GetChecksumOptions) => Promise<ChecksumFileResponse>;
+    /** Function to read directory contents and return entries as a flat list */
+    readDirectory: (options: ReadDirectoryOptions) => Promise<ReadDirectoryResponse>;
     /** Indicate if Safari Extension is enabled. If the extension is disabled during the lifecycle this will not update to disabled. */
     SAFARI_EXTENSION_STATUS: SafariExtensionEvent;
     /** Aspera HTTP Gateway calls. This normally is not needed by clients but expose just in case. */

package/dist/commonjs/models/models.d.ts

@@ -165,6 +165,44 @@ export interface ChecksumFileResponse {
     /** The algorithm used */
     checksumMethod: 'md5' | 'sha1' | 'sha256' | 'sha512';
 }
+/** The type of a directory entry */
+export type EntryType = 'file' | 'directory';
+/** Filters to narrow directory listing results */
+export interface DirectoryListFilters {
+    /** Only return entries of this type. Omit to return all. */
+    type?: EntryType;
+    /** Glob pattern matched against the file name only (e.g., "*.pdf"). */
+    namePattern?: string;
+    /** Whether to include hidden files and directories in the results. */
+    hidden?: boolean;
+}
+/** Options for reading directory contents */
+export interface ReadDirectoryOptions {
+    /** Absolute path to the directory to enumerate. Must have been previously allowed via dialog selection or drag-drop. */
+    path: string;
+    /** Maximum recursion depth. 0 = direct children only (non-recursive). Omit for full recursive traversal. */
+    depth?: number;
+    /** Optional filters to narrow the results. */
+    filters?: DirectoryListFilters;
+}
+/** A single entry in a directory listing */
+export interface DirectoryEntry {
+    /** Path relative to the traversal root, using forward slashes on all platforms. */
+    relativePath: string;
+    /** The entry type: "file" or "directory". */
+    type: EntryType;
+    /** Size in bytes. 0 for directories. */
+    size: number;
+    /** Last modified timestamp in milliseconds since the UNIX epoch. */
+    lastModified: number;
+}
+/** Response from reading directory contents */
+export interface ReadDirectoryResponse {
+    /** The directory entries matching the request criteria. */
+    entries: DirectoryEntry[];
+    /** The total number of entries returned. If this equals the server maximum, results may have been truncated. */
+    totalCount: number;
+}
 export interface ModifyTransferOptions {
     /**
      * @deprecated Use `lock_min_rate_kbps` instead.
@@ -879,4 +917,32 @@ export interface SdkCapabilities {
      * Whether the SDK can calculate checksums of a file chunk.
      */
     fileChecksum: boolean;
+    /**
+     * Whether the transfer client supports showing the about page.
+     *
+     * This is supported when using Connect or IBM Aspera for desktop with the required RPC methods,
+     * but not HTTP Gateway.
+     */
+    showAbout: boolean;
+    /**
+     * Whether the transfer client supports showing the preferences page.
+     *
+     * This is supported when using Connect or IBM Aspera for desktop with the required RPC methods,
+     * but not HTTP Gateway.
+     */
+    showPreferences: boolean;
+    /**
+     * Whether the transfer client supports showing the transfer manager.
+     *
+     * This is supported when using Connect or IBM Aspera for desktop with the required RPC methods,
+     * but not HTTP Gateway.
+     */
+    showTransferManager: boolean;
+    /**
+     * Whether the SDK can read directory contents.
+     *
+     * This is supported when using IBM Aspera for desktop with the required RPC methods,
+     * but not Connect or HTTP Gateway.
+     */
+    readDirectory: boolean;
 }