上传与下载

// createUploadTask 为异步方法，返回 UploadTask
const task = await smh.createUploadTask({
    filePath: '/uploads/report.pdf',        // 远端保存路径
    localPath: '/local/path/report.pdf',    // 本地文件路径
});

// 监听进度
task.on('progress', ({ progress, speed, leftTime }) => {
    console.log(`进度: ${progress.toFixed(2)}%, 速度: ${speed} 字节/秒, 预计剩余: ${leftTime} 秒`);
});

// 开始上传并等待完成
task.start();
await task.wait();

console.log('上传完成:', task.file);

createUploadTask(options: CreateUploadTaskOptions): Promise<UploadTask>

const task = await smh.createUploadTask({
    filePath: '/uploads/large-video.mp4',
    localPath: '/local/path/large-video.mp4',
});

task.on('statechange', ({ state, error }) => {
    console.log('状态变化:', state, error || '');
});
task.on('partialcomplete', ({ partInfo }) => {
    console.log(`分片 ${partInfo.part_number} 上传完成`);
});

task.start();

// 5 秒后暂停
setTimeout(() => task.pause(), 5000);

try {
    await task.wait();
    console.log('上传完成');
} catch (e) {
    console.error('上传失败或已取消:', e.message);
}

const task = await smh.createUploadTask({
    filePath: '/uploads/existing-file.pdf',
    localPath: '/local/path/existing-file.pdf',
});

task.start();
await task.wait();

if (task.state === 'rapid_success') {
    console.log('秒传成功，文件已存在');
} else {
    console.log('上传完成');
}

// 首次上传（被中断）
const task = await smh.createUploadTask({
    filePath: '/uploads/large-video.mp4',
    localPath: '/local/path/large-video.mp4',
});
task.start();
// ... 中断时将 task.getCheckpoint() 持久化保存（如 fs.writeFileSync('/tmp/smh-checkpoint.json', JSON.stringify(task.getCheckpoint()))）

// 恢复上传（从本地文件读取持久化的 checkpoint）
import fs from 'fs';
const savedCheckpoint = JSON.parse(fs.readFileSync('/tmp/smh-checkpoint.json', 'utf-8'));
const resumeTask = await smh.createUploadTask({
    filePath: '/uploads/large-video.mp4',
    localPath: '/local/path/large-video.mp4',
    checkpoint: savedCheckpoint,
});
resumeTask.start();
await resumeTask.wait();

const task = await smh.createUploadTask({
    filePath: '/uploads/large-video.mp4',
    localPath: '/local/path/large-video.mp4',
});

task.start();

// 需要取消时调用 cancel()
setTimeout(() => task.cancel(), 5000);

try {
    await task.wait();
} catch (e) {
    console.log('上传已取消:', e.message);
}

const task = await smh.createDownloadTask({
    filePath: '/documents/report.pdf',          // 远端文件路径
    localPath: '/local/downloads/report.pdf',   // 本地保存路径
});

task.on('progress', ({ progress, speed, leftTime }) => {
    console.log(`下载进度: ${progress.toFixed(2)}%`);
});

task.start();
await task.wait();

console.log('下载完成:', task.file);

createDownloadTask(options: CreateDownloadTaskOptions): Promise<DownloadTask>

const task = await smh.createDownloadTask({
    filePath: '/videos/large-video.mp4',
    localPath: '/local/downloads/large-video.mp4',
    chunkSize: 5,     // 每个分片 5MB
    parallel: 3,      // 同时下载 3 个分片
});

task.on('partialcomplete', ({ partInfo }) => {
    console.log(`分片 ${partInfo.part_number} 下载完成`);
});

task.start();
await task.wait();
console.log('下载完成');