@mountra/mountra-sdk 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -1,3 +1,202 @@
+interface FileSystemWritableFileStreamLike {
+    write(data: Uint8Array | Blob): Promise<void>;
+    seek(position: number): Promise<void>;
+    truncate(size: number): Promise<void>;
+    close(): Promise<void>;
+    abort?(): Promise<void>;
+}
+interface FileSystemFileHandleLike {
+    readonly kind?: "file";
+    readonly name?: string;
+    createWritable(options?: {
+        keepExistingData?: boolean;
+    }): Promise<FileSystemWritableFileStreamLike>;
+    isSameEntry?(other: FileSystemFileHandleLike): Promise<boolean>;
+    queryPermission?(descriptor?: {
+        mode?: "read" | "readwrite";
+    }): Promise<PermissionState>;
+    requestPermission?(descriptor?: {
+        mode?: "read" | "readwrite";
+    }): Promise<PermissionState>;
+}
+interface ExportFileOptions extends WorkspaceSelector {
+    path?: string;
+    ino?: number | string;
+    timeout?: number;
+    contentDisposition?: string;
+    downloadFilename?: string;
+    signal?: AbortSignal;
+}
+interface ExportFileChunk {
+    index: number;
+    offset: number;
+    size: number;
+    storageKey: string;
+    url: string;
+}
+interface ExportFileResponse {
+    path: string;
+    storageKey: string;
+    url: string;
+    timeout: number;
+    size: number;
+    contentType?: string;
+    chunkMethod?: string;
+    isFastPath?: boolean;
+    chunks?: ExportFileChunk[];
+}
+interface DownloadProgress {
+    phase: "downloading" | "retrying" | "completed";
+    downloadedBytes: number;
+    totalBytes: number;
+    downloadedChunks: number;
+    totalChunks: number;
+    currentChunkIndex?: number;
+    speedBytesPerSecond: number;
+    estimatedRemainingSeconds?: number;
+    elapsedMs: number;
+    retryCount: number;
+}
+interface DownloadFileOptions extends ExportFileOptions {
+    /** Prefer File System Access API when available. Defaults to true. */
+    preferFileSystemAccess?: boolean;
+    /** Continue a matching IndexedDB checkpoint when the selected file is the same entry. */
+    resume?: boolean;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    onProgress?: (progress: DownloadProgress) => void;
+    /** Use a previously selected file handle, primarily for resumeDownload. */
+    fileHandle?: FileSystemFileHandleLike;
+}
+interface DownloadResumeOptions {
+    signal?: AbortSignal;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    onProgress?: (progress: DownloadProgress) => void;
+}
+interface DownloadResult {
+    export: ExportFileResponse;
+    downloadKey: string;
+    downloadedBytes: number;
+    resumed: boolean;
+    fileHandle?: FileSystemFileHandleLike;
+    blob?: Blob;
+}
+interface DownloadCheckpointChunk {
+    index: number;
+    offset: number;
+    size: number;
+    storageKey: string;
+    downloadedBytes: number;
+    completed: boolean;
+}
+interface DownloadCheckpointRequest {
+    workspaceCuid?: string;
+    workspaceId?: number | string;
+    path?: string;
+    ino?: number | string;
+    timeout?: number;
+    contentDisposition?: string;
+    downloadFilename?: string;
+}
+interface DownloadCheckpoint {
+    version: 1;
+    key: string;
+    requestKey: string;
+    request: DownloadCheckpointRequest;
+    path: string;
+    size: number;
+    chunks: DownloadCheckpointChunk[];
+    fileHandle?: FileSystemFileHandleLike;
+    updatedAt: number;
+}
+interface DownloadCheckpointStore {
+    load(key: string): Promise<DownloadCheckpoint | null>;
+    save(key: string, checkpoint: DownloadCheckpoint): Promise<void>;
+    remove(key: string): Promise<void>;
+    list(): Promise<DownloadCheckpoint[]>;
+}
+declare class InMemoryDownloadCheckpointStore implements DownloadCheckpointStore {
+    private readonly records;
+    load(key: string): Promise<DownloadCheckpoint | null>;
+    save(key: string, checkpoint: DownloadCheckpoint): Promise<void>;
+    remove(key: string): Promise<void>;
+    list(): Promise<DownloadCheckpoint[]>;
+}
+declare class IndexedDBDownloadCheckpointStore implements DownloadCheckpointStore {
+    private readonly fallback;
+    private databasePromise?;
+    load(key: string): Promise<DownloadCheckpoint | null>;
+    save(key: string, checkpoint: DownloadCheckpoint): Promise<void>;
+    remove(key: string): Promise<void>;
+    list(): Promise<DownloadCheckpoint[]>;
+    private openDatabase;
+    private request;
+}
+declare class DownloadHttpError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+interface DownloadTransport {
+    readonly baseUrl: string;
+    readonly clientSelector: WorkspaceSelector;
+    readonly fetchImpl: typeof globalThis.fetch;
+    readonly checkpointStore: DownloadCheckpointStore;
+    requestJson(path: string, body: unknown, signal?: AbortSignal): Promise<unknown>;
+}
+declare class MountraDownloader {
+    private readonly transport;
+    constructor(transport: DownloadTransport);
+    exportFile(options: ExportFileOptions): Promise<ExportFileResponse>;
+    downloadFile(options: DownloadFileOptions): Promise<DownloadResult>;
+    downloadExport(exported: ExportFileResponse, options?: DownloadFileOptions): Promise<DownloadResult>;
+    resumeDownload(downloadKey: string, options?: DownloadResumeOptions): Promise<DownloadResult>;
+    listResumableDownloads(): Promise<DownloadCheckpoint[]>;
+    clearDownloadCheckpoint(downloadKey: string): Promise<void>;
+    private pickSaveFile;
+    private ensureWritePermission;
+    private downloadResolved;
+    private consumeResponse;
+    private consumeBytes;
+    private isSameFileHandle;
+}
+
+type MountraFileTarget = {
+    path: string;
+    ino?: never;
+} | {
+    path?: never;
+    ino: number | string;
+};
+/** A file identity accepted by `MountraClient.file()`. */
+type MountraFileLocator = WorkspaceSelector & Partial<{
+    wsid: WorkspaceId;
+}> & MountraFileTarget;
+type NormalizedMountraFileLocator = WorkspaceSelector & MountraFileTarget;
+/** Options for exporting an already identified Mountra file. */
+type MountraFileExportOptions = Omit<ExportFileOptions, "workspaceCuid" | "workspaceId" | "path" | "ino">;
+/** Options for downloading an already identified Mountra file. */
+type MountraFileDownloadOptions = Omit<DownloadFileOptions, "workspaceCuid" | "workspaceId" | "path" | "ino">;
+interface MountraFileResumeOptions extends DownloadResumeOptions {
+    /** Select a particular checkpoint; otherwise the newest matching one is used. */
+    downloadKey?: string;
+}
+/** A stable resource object for one file in one Mountra workspace. */
+declare class MountraFile {
+    private readonly client;
+    readonly locator: Readonly<NormalizedMountraFileLocator>;
+    constructor(client: MountraClient, locator: NormalizedMountraFileLocator);
+    get workspaceCuid(): string | undefined;
+    get workspaceId(): WorkspaceId | undefined;
+    /** `wsid` is the short alias used by the file-object API. */
+    get wsid(): WorkspaceId | undefined;
+    get path(): string | undefined;
+    get ino(): number | string | undefined;
+    export(options?: MountraFileExportOptions): Promise<ExportFileResponse>;
+    download(options?: MountraFileDownloadOptions): Promise<DownloadResult>;
+    resume(options?: MountraFileResumeOptions): Promise<DownloadResult>;
+}
+
 type ChunkMethod = "none" | "fix";
 type WorkspaceId = number | string;
 declare const JUMBO_CHUNK_THRESHOLD_BYTES: number;
@@ -24,6 +223,8 @@ interface MountraClientOptions extends WorkspaceSelector {
     jumboChunkCheckpointStore?: JumboChunkCheckpointStore;
     /** S3 Multipart part size. Defaults to 16 MiB. */
     jumboPartSize?: number;
+    /** IndexedDB-backed download checkpoint store. */
+    downloadCheckpointStore?: DownloadCheckpointStore;
 }
 interface UploadFileOptions extends WorkspaceSelector {
     path: string;
@@ -283,7 +484,16 @@ declare class MountraClient {
     private readonly jumboChunkUploader?;
     private readonly jumboChunkCheckpointStore;
     private readonly jumboPartSize;
+    private readonly downloader;
     constructor(options: MountraClientOptions);
+    exportFile(options: ExportFileOptions): Promise<ExportFileResponse>;
+    downloadFile(options: DownloadFileOptions): Promise<DownloadResult>;
+    downloadExport(exported: ExportFileResponse, options?: DownloadFileOptions): Promise<DownloadResult>;
+    resumeDownload(downloadKey: string, options?: DownloadResumeOptions): Promise<DownloadResult>;
+    listResumableDownloads(): Promise<DownloadCheckpoint[]>;
+    clearDownloadCheckpoint(downloadKey: string): Promise<void>;
+    /** Create a stable resource object for one file in this or another workspace. */
+    file(locator: MountraFileLocator): MountraFile;
     prepareUpload(file: Blob, options: UploadFileOptions): Promise<PreparedUpload>;
     uploadFile(file: Blob, options: UploadFileOptions): Promise<UploadResult>;
     /** Generic upload entry point. It selects PUT or S3 Multipart per chunk. */
@@ -306,4 +516,4 @@ declare class MountraClient {
 }
 declare function createMountraClient(options: MountraClientOptions): MountraClient;
 
-export { type AccessToken, type ChunkMethod, DEFAULT_S3_MULTIPART_PART_SIZE_BYTES, type FileChunk, type FinishUploadResponse, InMemoryJumboChunkCheckpointStore, JUMBO_CHUNK_THRESHOLD_BYTES, type JumboChunkCheckpoint, type JumboChunkCheckpointStore, type JumboChunkCompleteInput, type JumboChunkCreateInput, type JumboChunkUploadPartInput, type JumboChunkUploader, LocalStorageJumboChunkCheckpointStore, MAX_S3_MULTIPART_PARTS, MIN_S3_MULTIPART_PART_SIZE_BYTES, MountraApiError, MountraClient, type MountraClientOptions, type MountraProgress, MountraClient as MountraSDK, type PrepareUploadResponse, type PreparedUpload, type S3MultipartClient, type S3MultipartPart, S3MultipartUploader, type UploadFileOptions, type UploadResult, type UploadResumeOptions, type UploadSessionChunkContext, type UploadSessionContext, type UploadStatusChunk, type UploadStatusResponse, type UploadTarget, type WorkspaceId, type WorkspaceSelector, createMountraClient, isJumboChunk, sha256Hex, splitFileIntoChunks };
+export { type AccessToken, type ChunkMethod, DEFAULT_S3_MULTIPART_PART_SIZE_BYTES, type DownloadCheckpoint, type DownloadCheckpointChunk, type DownloadCheckpointRequest, type DownloadCheckpointStore, type DownloadFileOptions, DownloadHttpError, type DownloadProgress, type DownloadResult, type DownloadResumeOptions, type ExportFileChunk, type ExportFileOptions, type ExportFileResponse, type FileChunk, type FileSystemFileHandleLike, type FileSystemWritableFileStreamLike, type FinishUploadResponse, InMemoryDownloadCheckpointStore, InMemoryJumboChunkCheckpointStore, IndexedDBDownloadCheckpointStore, JUMBO_CHUNK_THRESHOLD_BYTES, type JumboChunkCheckpoint, type JumboChunkCheckpointStore, type JumboChunkCompleteInput, type JumboChunkCreateInput, type JumboChunkUploadPartInput, type JumboChunkUploader, LocalStorageJumboChunkCheckpointStore, MAX_S3_MULTIPART_PARTS, MIN_S3_MULTIPART_PART_SIZE_BYTES, MountraApiError, MountraClient, type MountraClientOptions, MountraDownloader, MountraFile, type MountraFileDownloadOptions, type MountraFileExportOptions, type MountraFileLocator, type MountraFileResumeOptions, type MountraProgress, MountraClient as MountraSDK, type NormalizedMountraFileLocator, type PrepareUploadResponse, type PreparedUpload, type S3MultipartClient, type S3MultipartPart, S3MultipartUploader, type UploadFileOptions, type UploadResult, type UploadResumeOptions, type UploadSessionChunkContext, type UploadSessionContext, type UploadStatusChunk, type UploadStatusResponse, type UploadTarget, type WorkspaceId, type WorkspaceSelector, createMountraClient, isJumboChunk, sha256Hex, splitFileIntoChunks };

package/dist/index.d.ts

@@ -1,3 +1,202 @@
+interface FileSystemWritableFileStreamLike {
+    write(data: Uint8Array | Blob): Promise<void>;
+    seek(position: number): Promise<void>;
+    truncate(size: number): Promise<void>;
+    close(): Promise<void>;
+    abort?(): Promise<void>;
+}
+interface FileSystemFileHandleLike {
+    readonly kind?: "file";
+    readonly name?: string;
+    createWritable(options?: {
+        keepExistingData?: boolean;
+    }): Promise<FileSystemWritableFileStreamLike>;
+    isSameEntry?(other: FileSystemFileHandleLike): Promise<boolean>;
+    queryPermission?(descriptor?: {
+        mode?: "read" | "readwrite";
+    }): Promise<PermissionState>;
+    requestPermission?(descriptor?: {
+        mode?: "read" | "readwrite";
+    }): Promise<PermissionState>;
+}
+interface ExportFileOptions extends WorkspaceSelector {
+    path?: string;
+    ino?: number | string;
+    timeout?: number;
+    contentDisposition?: string;
+    downloadFilename?: string;
+    signal?: AbortSignal;
+}
+interface ExportFileChunk {
+    index: number;
+    offset: number;
+    size: number;
+    storageKey: string;
+    url: string;
+}
+interface ExportFileResponse {
+    path: string;
+    storageKey: string;
+    url: string;
+    timeout: number;
+    size: number;
+    contentType?: string;
+    chunkMethod?: string;
+    isFastPath?: boolean;
+    chunks?: ExportFileChunk[];
+}
+interface DownloadProgress {
+    phase: "downloading" | "retrying" | "completed";
+    downloadedBytes: number;
+    totalBytes: number;
+    downloadedChunks: number;
+    totalChunks: number;
+    currentChunkIndex?: number;
+    speedBytesPerSecond: number;
+    estimatedRemainingSeconds?: number;
+    elapsedMs: number;
+    retryCount: number;
+}
+interface DownloadFileOptions extends ExportFileOptions {
+    /** Prefer File System Access API when available. Defaults to true. */
+    preferFileSystemAccess?: boolean;
+    /** Continue a matching IndexedDB checkpoint when the selected file is the same entry. */
+    resume?: boolean;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    onProgress?: (progress: DownloadProgress) => void;
+    /** Use a previously selected file handle, primarily for resumeDownload. */
+    fileHandle?: FileSystemFileHandleLike;
+}
+interface DownloadResumeOptions {
+    signal?: AbortSignal;
+    maxRetries?: number;
+    retryDelayMs?: number;
+    onProgress?: (progress: DownloadProgress) => void;
+}
+interface DownloadResult {
+    export: ExportFileResponse;
+    downloadKey: string;
+    downloadedBytes: number;
+    resumed: boolean;
+    fileHandle?: FileSystemFileHandleLike;
+    blob?: Blob;
+}
+interface DownloadCheckpointChunk {
+    index: number;
+    offset: number;
+    size: number;
+    storageKey: string;
+    downloadedBytes: number;
+    completed: boolean;
+}
+interface DownloadCheckpointRequest {
+    workspaceCuid?: string;
+    workspaceId?: number | string;
+    path?: string;
+    ino?: number | string;
+    timeout?: number;
+    contentDisposition?: string;
+    downloadFilename?: string;
+}
+interface DownloadCheckpoint {
+    version: 1;
+    key: string;
+    requestKey: string;
+    request: DownloadCheckpointRequest;
+    path: string;
+    size: number;
+    chunks: DownloadCheckpointChunk[];
+    fileHandle?: FileSystemFileHandleLike;
+    updatedAt: number;
+}
+interface DownloadCheckpointStore {
+    load(key: string): Promise<DownloadCheckpoint | null>;
+    save(key: string, checkpoint: DownloadCheckpoint): Promise<void>;
+    remove(key: string): Promise<void>;
+    list(): Promise<DownloadCheckpoint[]>;
+}
+declare class InMemoryDownloadCheckpointStore implements DownloadCheckpointStore {
+    private readonly records;
+    load(key: string): Promise<DownloadCheckpoint | null>;
+    save(key: string, checkpoint: DownloadCheckpoint): Promise<void>;
+    remove(key: string): Promise<void>;
+    list(): Promise<DownloadCheckpoint[]>;
+}
+declare class IndexedDBDownloadCheckpointStore implements DownloadCheckpointStore {
+    private readonly fallback;
+    private databasePromise?;
+    load(key: string): Promise<DownloadCheckpoint | null>;
+    save(key: string, checkpoint: DownloadCheckpoint): Promise<void>;
+    remove(key: string): Promise<void>;
+    list(): Promise<DownloadCheckpoint[]>;
+    private openDatabase;
+    private request;
+}
+declare class DownloadHttpError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+interface DownloadTransport {
+    readonly baseUrl: string;
+    readonly clientSelector: WorkspaceSelector;
+    readonly fetchImpl: typeof globalThis.fetch;
+    readonly checkpointStore: DownloadCheckpointStore;
+    requestJson(path: string, body: unknown, signal?: AbortSignal): Promise<unknown>;
+}
+declare class MountraDownloader {
+    private readonly transport;
+    constructor(transport: DownloadTransport);
+    exportFile(options: ExportFileOptions): Promise<ExportFileResponse>;
+    downloadFile(options: DownloadFileOptions): Promise<DownloadResult>;
+    downloadExport(exported: ExportFileResponse, options?: DownloadFileOptions): Promise<DownloadResult>;
+    resumeDownload(downloadKey: string, options?: DownloadResumeOptions): Promise<DownloadResult>;
+    listResumableDownloads(): Promise<DownloadCheckpoint[]>;
+    clearDownloadCheckpoint(downloadKey: string): Promise<void>;
+    private pickSaveFile;
+    private ensureWritePermission;
+    private downloadResolved;
+    private consumeResponse;
+    private consumeBytes;
+    private isSameFileHandle;
+}
+
+type MountraFileTarget = {
+    path: string;
+    ino?: never;
+} | {
+    path?: never;
+    ino: number | string;
+};
+/** A file identity accepted by `MountraClient.file()`. */
+type MountraFileLocator = WorkspaceSelector & Partial<{
+    wsid: WorkspaceId;
+}> & MountraFileTarget;
+type NormalizedMountraFileLocator = WorkspaceSelector & MountraFileTarget;
+/** Options for exporting an already identified Mountra file. */
+type MountraFileExportOptions = Omit<ExportFileOptions, "workspaceCuid" | "workspaceId" | "path" | "ino">;
+/** Options for downloading an already identified Mountra file. */
+type MountraFileDownloadOptions = Omit<DownloadFileOptions, "workspaceCuid" | "workspaceId" | "path" | "ino">;
+interface MountraFileResumeOptions extends DownloadResumeOptions {
+    /** Select a particular checkpoint; otherwise the newest matching one is used. */
+    downloadKey?: string;
+}
+/** A stable resource object for one file in one Mountra workspace. */
+declare class MountraFile {
+    private readonly client;
+    readonly locator: Readonly<NormalizedMountraFileLocator>;
+    constructor(client: MountraClient, locator: NormalizedMountraFileLocator);
+    get workspaceCuid(): string | undefined;
+    get workspaceId(): WorkspaceId | undefined;
+    /** `wsid` is the short alias used by the file-object API. */
+    get wsid(): WorkspaceId | undefined;
+    get path(): string | undefined;
+    get ino(): number | string | undefined;
+    export(options?: MountraFileExportOptions): Promise<ExportFileResponse>;
+    download(options?: MountraFileDownloadOptions): Promise<DownloadResult>;
+    resume(options?: MountraFileResumeOptions): Promise<DownloadResult>;
+}
+
 type ChunkMethod = "none" | "fix";
 type WorkspaceId = number | string;
 declare const JUMBO_CHUNK_THRESHOLD_BYTES: number;
@@ -24,6 +223,8 @@ interface MountraClientOptions extends WorkspaceSelector {
     jumboChunkCheckpointStore?: JumboChunkCheckpointStore;
     /** S3 Multipart part size. Defaults to 16 MiB. */
     jumboPartSize?: number;
+    /** IndexedDB-backed download checkpoint store. */
+    downloadCheckpointStore?: DownloadCheckpointStore;
 }
 interface UploadFileOptions extends WorkspaceSelector {
     path: string;
@@ -283,7 +484,16 @@ declare class MountraClient {
     private readonly jumboChunkUploader?;
     private readonly jumboChunkCheckpointStore;
     private readonly jumboPartSize;
+    private readonly downloader;
     constructor(options: MountraClientOptions);
+    exportFile(options: ExportFileOptions): Promise<ExportFileResponse>;
+    downloadFile(options: DownloadFileOptions): Promise<DownloadResult>;
+    downloadExport(exported: ExportFileResponse, options?: DownloadFileOptions): Promise<DownloadResult>;
+    resumeDownload(downloadKey: string, options?: DownloadResumeOptions): Promise<DownloadResult>;
+    listResumableDownloads(): Promise<DownloadCheckpoint[]>;
+    clearDownloadCheckpoint(downloadKey: string): Promise<void>;
+    /** Create a stable resource object for one file in this or another workspace. */
+    file(locator: MountraFileLocator): MountraFile;
     prepareUpload(file: Blob, options: UploadFileOptions): Promise<PreparedUpload>;
     uploadFile(file: Blob, options: UploadFileOptions): Promise<UploadResult>;
     /** Generic upload entry point. It selects PUT or S3 Multipart per chunk. */
@@ -306,4 +516,4 @@ declare class MountraClient {
 }
 declare function createMountraClient(options: MountraClientOptions): MountraClient;
 
-export { type AccessToken, type ChunkMethod, DEFAULT_S3_MULTIPART_PART_SIZE_BYTES, type FileChunk, type FinishUploadResponse, InMemoryJumboChunkCheckpointStore, JUMBO_CHUNK_THRESHOLD_BYTES, type JumboChunkCheckpoint, type JumboChunkCheckpointStore, type JumboChunkCompleteInput, type JumboChunkCreateInput, type JumboChunkUploadPartInput, type JumboChunkUploader, LocalStorageJumboChunkCheckpointStore, MAX_S3_MULTIPART_PARTS, MIN_S3_MULTIPART_PART_SIZE_BYTES, MountraApiError, MountraClient, type MountraClientOptions, type MountraProgress, MountraClient as MountraSDK, type PrepareUploadResponse, type PreparedUpload, type S3MultipartClient, type S3MultipartPart, S3MultipartUploader, type UploadFileOptions, type UploadResult, type UploadResumeOptions, type UploadSessionChunkContext, type UploadSessionContext, type UploadStatusChunk, type UploadStatusResponse, type UploadTarget, type WorkspaceId, type WorkspaceSelector, createMountraClient, isJumboChunk, sha256Hex, splitFileIntoChunks };
+export { type AccessToken, type ChunkMethod, DEFAULT_S3_MULTIPART_PART_SIZE_BYTES, type DownloadCheckpoint, type DownloadCheckpointChunk, type DownloadCheckpointRequest, type DownloadCheckpointStore, type DownloadFileOptions, DownloadHttpError, type DownloadProgress, type DownloadResult, type DownloadResumeOptions, type ExportFileChunk, type ExportFileOptions, type ExportFileResponse, type FileChunk, type FileSystemFileHandleLike, type FileSystemWritableFileStreamLike, type FinishUploadResponse, InMemoryDownloadCheckpointStore, InMemoryJumboChunkCheckpointStore, IndexedDBDownloadCheckpointStore, JUMBO_CHUNK_THRESHOLD_BYTES, type JumboChunkCheckpoint, type JumboChunkCheckpointStore, type JumboChunkCompleteInput, type JumboChunkCreateInput, type JumboChunkUploadPartInput, type JumboChunkUploader, LocalStorageJumboChunkCheckpointStore, MAX_S3_MULTIPART_PARTS, MIN_S3_MULTIPART_PART_SIZE_BYTES, MountraApiError, MountraClient, type MountraClientOptions, MountraDownloader, MountraFile, type MountraFileDownloadOptions, type MountraFileExportOptions, type MountraFileLocator, type MountraFileResumeOptions, type MountraProgress, MountraClient as MountraSDK, type NormalizedMountraFileLocator, type PrepareUploadResponse, type PreparedUpload, type S3MultipartClient, type S3MultipartPart, S3MultipartUploader, type UploadFileOptions, type UploadResult, type UploadResumeOptions, type UploadSessionChunkContext, type UploadSessionContext, type UploadStatusChunk, type UploadStatusResponse, type UploadTarget, type WorkspaceId, type WorkspaceSelector, createMountraClient, isJumboChunk, sha256Hex, splitFileIntoChunks };