@airtop/sdk 0.1.36 → 0.1.37-beta0

package/dist/serialization/types/FileEventMessageStatus.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileEventMessageStatus = void 0;
+const core = __importStar(require("../../core"));
+exports.FileEventMessageStatus = core.serialization.enum_(["available", "uploading", "upload_failed", "deleted"]);

package/dist/serialization/types/FilesResponse.d.ts

@@ -0,0 +1,18 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as serializers from "../index";
+import * as Airtop from "../../api/index";
+import * as core from "../../core";
+import { FilesWithPagination } from "./FilesWithPagination";
+import { Issue } from "./Issue";
+import { EnvelopeDefaultMeta } from "./EnvelopeDefaultMeta";
+export declare const FilesResponse: core.serialization.ObjectSchema<serializers.FilesResponse.Raw, Airtop.FilesResponse>;
+export declare namespace FilesResponse {
+    interface Raw {
+        data: FilesWithPagination.Raw;
+        errors?: Issue.Raw[] | null;
+        meta: EnvelopeDefaultMeta.Raw;
+        warnings?: Issue.Raw[] | null;
+    }
+}

package/dist/serialization/types/FilesResponse.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilesResponse = void 0;
+const core = __importStar(require("../../core"));
+const FilesWithPagination_1 = require("./FilesWithPagination");
+const Issue_1 = require("./Issue");
+const EnvelopeDefaultMeta_1 = require("./EnvelopeDefaultMeta");
+exports.FilesResponse = core.serialization.object({
+    data: FilesWithPagination_1.FilesWithPagination,
+    errors: core.serialization.list(Issue_1.Issue).optional(),
+    meta: EnvelopeDefaultMeta_1.EnvelopeDefaultMeta,
+    warnings: core.serialization.list(Issue_1.Issue).optional(),
+});

package/dist/serialization/types/FilesWithPagination.d.ts

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as serializers from "../index";
+import * as Airtop from "../../api/index";
+import * as core from "../../core";
+import { ExternalFile } from "./ExternalFile";
+import { Pagination } from "./Pagination";
+export declare const FilesWithPagination: core.serialization.ObjectSchema<serializers.FilesWithPagination.Raw, Airtop.FilesWithPagination>;
+export declare namespace FilesWithPagination {
+    interface Raw {
+        files?: ExternalFile.Raw[] | null;
+        pagination: Pagination.Raw;
+    }
+}

package/dist/serialization/types/FilesWithPagination.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilesWithPagination = void 0;
+const core = __importStar(require("../../core"));
+const ExternalFile_1 = require("./ExternalFile");
+const Pagination_1 = require("./Pagination");
+exports.FilesWithPagination = core.serialization.object({
+    files: core.serialization.list(ExternalFile_1.ExternalFile).optional(),
+    pagination: Pagination_1.Pagination,
+});

package/dist/serialization/types/GetFileV1.d.ts

@@ -0,0 +1,23 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as serializers from "../index";
+import * as Airtop from "../../api/index";
+import * as core from "../../core";
+import { GetFileV1FileType } from "./GetFileV1FileType";
+import { GetFileV1Status } from "./GetFileV1Status";
+export declare const GetFileV1: core.serialization.ObjectSchema<serializers.GetFileV1.Raw, Airtop.GetFileV1>;
+export declare namespace GetFileV1 {
+    interface Raw {
+        downloadUrl: string;
+        expiryTime?: string | null;
+        fileBytes: number;
+        fileName: string;
+        fileType: GetFileV1FileType.Raw;
+        id: string;
+        orgId: string;
+        sessionIds?: string[] | null;
+        status: GetFileV1Status.Raw;
+        uploadStartTime: string;
+    }
+}

package/dist/serialization/types/GetFileV1.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetFileV1 = void 0;
+const core = __importStar(require("../../core"));
+const GetFileV1FileType_1 = require("./GetFileV1FileType");
+const GetFileV1Status_1 = require("./GetFileV1Status");
+exports.GetFileV1 = core.serialization.object({
+    downloadUrl: core.serialization.string(),
+    expiryTime: core.serialization.date().optional(),
+    fileBytes: core.serialization.number(),
+    fileName: core.serialization.string(),
+    fileType: GetFileV1FileType_1.GetFileV1FileType,
+    id: core.serialization.string(),
+    orgId: core.serialization.string(),
+    sessionIds: core.serialization.list(core.serialization.string()).optional(),
+    status: GetFileV1Status_1.GetFileV1Status,
+    uploadStartTime: core.serialization.date(),
+});

package/dist/serialization/types/GetFileV1FileType.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as serializers from "../index";
+import * as Airtop from "../../api/index";
+import * as core from "../../core";
+export declare const GetFileV1FileType: core.serialization.Schema<serializers.GetFileV1FileType.Raw, Airtop.GetFileV1FileType>;
+export declare namespace GetFileV1FileType {
+    type Raw = "browser_download" | "screenshot" | "video" | "customer_upload";
+}

package/dist/serialization/types/GetFileV1FileType.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetFileV1FileType = void 0;
+const core = __importStar(require("../../core"));
+exports.GetFileV1FileType = core.serialization.enum_(["browser_download", "screenshot", "video", "customer_upload"]);

package/dist/serialization/types/GetFileV1Status.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as serializers from "../index";
+import * as Airtop from "../../api/index";
+import * as core from "../../core";
+export declare const GetFileV1Status: core.serialization.Schema<serializers.GetFileV1Status.Raw, Airtop.GetFileV1Status>;
+export declare namespace GetFileV1Status {
+    type Raw = "available" | "uploading" | "upload_failed" | "deleted";
+}

package/dist/serialization/types/GetFileV1Status.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetFileV1Status = void 0;
+const core = __importStar(require("../../core"));
+exports.GetFileV1Status = core.serialization.enum_(["available", "uploading", "upload_failed", "deleted"]);

package/dist/serialization/types/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./AiPromptResponse";
 export * from "./AiResponseEnvelope";
 export * from "./AsyncConfig";
+export * from "./AsyncOperatorPromptResponseEnvelope";
 export * from "./AsyncSessionAiResponseEnvelope";
 export * from "./AutomationOutput";
 export * from "./BrowserWaitNavigationConfigWaitUntil";
@@ -9,17 +10,30 @@ export * from "./ClickConfigClickType";
 export * from "./ClickConfig";
 export * from "./ClientProvidedResponseMetadata";
 export * from "./CreateAutomationRequestBodyConfiguration";
+export * from "./CreateFileV1FileType";
+export * from "./CreateFileV1Status";
+export * from "./CreateFileV1";
 export * from "./DeleteAutomationOutputWrapperBody";
+export * from "./EnvelopeCreateFileV1EnvelopeDefaultMeta";
 export * from "./EnvelopeDefaultMeta";
+export * from "./EnvelopeGetFileV1EnvelopeDefaultMeta";
 export * from "./ErrorBody";
 export * from "./ErrorDetail";
 export * from "./ErrorMessage";
 export * from "./ErrorModel";
+export * from "./ExternalFile";
 export * from "./ExternalSessionAiResponseMetadataStatus";
 export * from "./ExternalSessionAiResponseMetadata";
 export * from "./ExternalSessionAiResponseMetadataUsage";
 export * from "./ExternalSessionConfig";
 export * from "./ExternalSessionWithConnectionInfo";
+export * from "./FileEventMessageStatus";
+export * from "./FileEventMessage";
+export * from "./FilesResponse";
+export * from "./FilesWithPagination";
+export * from "./GetFileV1FileType";
+export * from "./GetFileV1Status";
+export * from "./GetFileV1";
 export * from "./IntervalMonitorConfig";
 export * from "./Issue";
 export * from "./ListAutomationsOutput";

package/dist/serialization/types/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./AiPromptResponse"), exports);
 __exportStar(require("./AiResponseEnvelope"), exports);
 __exportStar(require("./AsyncConfig"), exports);
+__exportStar(require("./AsyncOperatorPromptResponseEnvelope"), exports);
 __exportStar(require("./AsyncSessionAiResponseEnvelope"), exports);
 __exportStar(require("./AutomationOutput"), exports);
 __exportStar(require("./BrowserWaitNavigationConfigWaitUntil"), exports);
@@ -25,17 +26,30 @@ __exportStar(require("./ClickConfigClickType"), exports);
 __exportStar(require("./ClickConfig"), exports);
 __exportStar(require("./ClientProvidedResponseMetadata"), exports);
 __exportStar(require("./CreateAutomationRequestBodyConfiguration"), exports);
+__exportStar(require("./CreateFileV1FileType"), exports);
+__exportStar(require("./CreateFileV1Status"), exports);
+__exportStar(require("./CreateFileV1"), exports);
 __exportStar(require("./DeleteAutomationOutputWrapperBody"), exports);
+__exportStar(require("./EnvelopeCreateFileV1EnvelopeDefaultMeta"), exports);
 __exportStar(require("./EnvelopeDefaultMeta"), exports);
+__exportStar(require("./EnvelopeGetFileV1EnvelopeDefaultMeta"), exports);
 __exportStar(require("./ErrorBody"), exports);
 __exportStar(require("./ErrorDetail"), exports);
 __exportStar(require("./ErrorMessage"), exports);
 __exportStar(require("./ErrorModel"), exports);
+__exportStar(require("./ExternalFile"), exports);
 __exportStar(require("./ExternalSessionAiResponseMetadataStatus"), exports);
 __exportStar(require("./ExternalSessionAiResponseMetadata"), exports);
 __exportStar(require("./ExternalSessionAiResponseMetadataUsage"), exports);
 __exportStar(require("./ExternalSessionConfig"), exports);
 __exportStar(require("./ExternalSessionWithConnectionInfo"), exports);
+__exportStar(require("./FileEventMessageStatus"), exports);
+__exportStar(require("./FileEventMessage"), exports);
+__exportStar(require("./FilesResponse"), exports);
+__exportStar(require("./FilesWithPagination"), exports);
+__exportStar(require("./GetFileV1FileType"), exports);
+__exportStar(require("./GetFileV1Status"), exports);
+__exportStar(require("./GetFileV1"), exports);
 __exportStar(require("./IntervalMonitorConfig"), exports);
 __exportStar(require("./Issue"), exports);
 __exportStar(require("./ListAutomationsOutput"), exports);

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.36";
+export declare const SDK_VERSION = "0.1.37-beta0";

package/dist/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.1.36";
+exports.SDK_VERSION = "0.1.37-beta0";

package/dist/wrapper/AirtopClient.d.ts

@@ -3,6 +3,7 @@ import { type BatchOperateConfig, type BatchOperationInput, type BatchOperationR
 import { AirtopSessions } from './AirtopSessions';
 import { AirtopWindows } from './AirtopWindows';
 import { AirtopRequests } from './AirtopRequests';
+import { AirtopFiles } from './AirtopFiles';
 type AugmentedOptions = FernClient.Options & {
     debug?: boolean;
 };
@@ -13,6 +14,7 @@ export declare class AirtopClient {
     private _windows;
     private _sessions;
     private _requests;
+    private _files;
     constructor(_options: AugmentedOptions);
     setApiKey(apiKey: string): void;
     setEnvironment(environment: string): void;
@@ -21,6 +23,7 @@ export declare class AirtopClient {
     get requests(): AirtopRequests;
     get profiles(): import("../api/resources/profiles/client/Client").Profiles;
     get automations(): import("../api/resources/automations/client/Client").Automations;
+    get files(): AirtopFiles;
     log(message: string): void;
     warn(message: string): void;
     error(err: any): void;

package/dist/wrapper/AirtopClient.js

@@ -49,6 +49,7 @@ const utils_1 = require("../utils");
 const AirtopSessions_1 = require("./AirtopSessions");
 const AirtopWindows_1 = require("./AirtopWindows");
 const AirtopRequests_1 = require("./AirtopRequests");
+const AirtopFiles_1 = require("./AirtopFiles");
 const version_1 = require("../version");
 class AirtopClient {
     constructor(_options) {
@@ -89,6 +90,10 @@ class AirtopClient {
     get automations() {
         return this._client.automations;
     }
+    get files() {
+        var _a;
+        return ((_a = this._files) !== null && _a !== void 0 ? _a : (this._files = new AirtopFiles_1.AirtopFiles(this._options)));
+    }
     log(message) {
         if (this.debug) {
             console.log(message);

package/dist/wrapper/AirtopFiles.d.ts

@@ -0,0 +1,50 @@
+import type * as Airtop from '../api';
+import { Files as FilesClass, type Files as FilesNamespace } from '../api/resources/files/client/Client';
+export declare class AirtopFiles extends FilesClass {
+    readonly _options: FilesNamespace.Options;
+    constructor(_options: FilesNamespace.Options);
+    /**
+     * Uploads a file to Airtop by first creating a file entry and then uploading the contents
+     * If @options is not provided, the fileName will be calculated from the filePath.
+     * @options.fileType defaults to `customer_upload`
+     *
+     * @param filePath - Path to the local file to upload
+     * @param options - Optional API request configuration
+     * @returns The created file entry response
+     *
+     * @example
+     *     const result = await client.files.upload("/path/to/file.pdf")
+     */
+    upload(filePath: string, options?: Airtop.CreateFileRestInputV1): Promise<Airtop.EnvelopeGetFileV1EnvelopeDefaultMeta>;
+    /**
+     * Downloads a file from Airtop to a local path
+     *
+     * @param fileId - The ID of the file to download
+     * @param destinationPath - Local path where the file should be saved
+     * @param options - Optional API request configuration
+     * @param onProgress - Optional callback to monitor download progress
+     *
+     * @example
+     *     await client.files.download(
+     *       "123e4567-e89b-12d3-a456-426614174000",
+     *       "/path/to/save/file.pdf",
+     *       (downloaded, total) => {
+     *         const percent = Math.round((downloaded / total) * 100);
+     *         console.log(`Downloaded: ${downloaded} / ${total} bytes (${percent}%)`);
+     *       }
+     *     )
+     */
+    download(fileId: string, destinationPath: string, onProgress?: (downloadedBytes: number, totalBytes: number) => void, options?: FilesNamespace.RequestOptions): Promise<void>;
+    /**
+     * Waits for a file to become available for download
+     *
+     * @param fileId - The ID of the file to wait for
+     * @param options - Optional request configuration including timeout
+     * @returns The file entry once it becomes available
+     * @throws Error if the file doesn't become available within the timeout period
+     *
+     * @example
+     *     const fileEntry = await client.files.waitForDownloadAvailable("123e4567-e89b-12d3-a456-426614174000")
+     */
+    waitForDownloadAvailable(fileId: string, options?: FilesNamespace.RequestOptions): Promise<Airtop.EnvelopeGetFileV1EnvelopeDefaultMeta>;
+}