目录或相簿

// 使用 marker/limit 分页查询（推荐）
const res = await smh.directory.listDirectory({
    libraryId: 'your-library-id',
    spaceId: 'your-space-id',
    filePath: '/images',
    byMarker: 1,
    limit: 20,
    orderBy: 'creationTime',
    orderByType: 'desc',
    filter: 'onlyFile',
    sortType: 'union',
    withInode: 0,
    withFavoriteStatus: 0,
    userId: 'xxx'
});

if (res.status === 200) {
    console.log('目录内容获取成功', res.data);
}

// 获取下一页：将上一次响应中的 nextMarker 作为 marker 传入
const res2 = await smh.directory.listDirectory({
    libraryId: 'your-library-id',
    spaceId: 'your-space-id',
    filePath: '/images',
    byMarker: 1,
    marker: res.data.nextMarker,
    limit: 20
});

{
  "path": ["foo", "bar"],
  "nextMarker": "eyJ0eXBlIjoiZmlsZSIsIm5hbWUiOiJCTVcwLjMyNTE0NTE4ODkzMDYxNjk1LmpwZyJ9",
  "contents": [
    {
      "name": "sub-dir1",
      "path": ["foo", "bar", "sub-dir1"],
      "inode": "xxxx",
      "type": "dir",
      "creationTime": "2020-09-22T07:43:01.000Z",
      "modificationTime": "2020-09-22T07:43:01.000Z",
      "eTag": "0",
      "isFavorite": true,
      "labels": ["动物", "大象", "亚洲象"]
    },
    {
      "name": "file1.jpg",
      "type": "file",
      "creationTime": "2020-09-22T07:44:45.000Z",
      "modificationTime": "2020-09-22T07:44:45.000Z",
      "versionId": 2,
      "contentType": "image/jpg",
      "size": "1048576",
      "eTag": "xxx",
      "isFavorite": false,
      "crc64": "xxx",
      "metaData": {
        "x-smh-meta-foo": "bar"
      },
      "fileType": "powerpoint",
      "previewByDoc": true,
      "previewByCI": true,
      "previewAsIcon": true,
      "category": "image",
      "labels": ["动物", "大象", "亚洲象"],
      "localCreationTime": "2020-09-22T07:44:45.000Z",
      "localModificationTime": "2020-09-22T07:44:45.000Z"
    }
  ]
}

// 使用 page/pageSize 分页查询（传统分页，不建议深翻）
const res = await smh.directory.listDirectoryByPage({
    libraryId: 'your-library-id',
    spaceId: 'your-space-id',
    filePath: '/documents',
    byPage: 1,
    page: 1,
    pageSize: 20,
    orderBy: 'name',
    orderByType: 'asc',
    filter: 'onlyFile',
    sortType: 'union',
    withInode: 1,
    withFavoriteStatus: 1,
    userId: 'xxx'
});

if (res.status === 200) {
    console.log('目录内容获取成功', res.data);
}

// 获取目录详情
const res = await smh.directory.infoFileOrDirectory({
    spaceId: 'your-space-id',
    filePath: '/documents',
    info: 1,
    withInode: 1,
    withFavoriteStatus: 1
});

if (res.status === 200) {
    console.log('详情获取成功', res.data);
}

const res = await smh.directory.checkDirectoryStatus({
    spaceId: 'your-space-id',
    filePath: '/documents',
    userId: 'xxx'
});

if (res.status === 200) {
    console.log('目录存在');
}

// 查询普通目录的统计数据
const res = await smh.directory.getDirectoryStats({
    spaceId: 'your-space-id',
    filePath: '/documents',
    stats: 1,
    statsType: 'normal',
    userId: 'xxx'
});

if (res.status === 200) {
    console.log('目录统计获取成功', res.data);
}

const res = await smh.directory.calibrateDirectoryStats({
    spaceId: 'your-space-id',
    filePath: '/documents',
    calibrate: 1,
    statsType: 'normal',
    userId: 'xxx'
});

if (res.status === 200) {
    console.log('修正任务已提交，任务ID:', res.data.taskId);
    // 通过任务管理接口轮询任务执行结果
}

const res = await smh.directory.createDirectory({
    spaceId: 'your-space-id',
    filePath: '/project-docs',
    conflictResolutionStrategy: 'rename',
    withInode: 1,
    createDirectoryRequest: {
        metaData: {
            'department': 'engineering',
            'project': 'sdk-v2',
        },
        labels: ['重要', '项目文档'],
        localCreationTime: '2024-01-15T10:30:00+08:00',
        localModificationTime: '2024-01-15T10:30:00+08:00',
    },
});

if (res.status === 201) {
    console.log('目录创建成功', res.data);
}

// 复制（目录内容较多）
const res = await smh.directory.copyDirectory({
    spaceId: 'your-space-id',
    filePath: '/dest/image.png',
    conflictResolutionStrategy: 'ask',
    userId: 'xxx',
    copyDirectoryRequest: {
        copyFrom: '/source/xxx'
    }
});

if (res.status === 202) {
    console.log('异步复制任务创建成功', res.data);
}

const res = await smh.directory.moveDirectory({
    spaceId: 'your-space-id',
    filePath: '/dest/image.png',
    conflictResolutionStrategy: 'ask',
    userId: 'xxx',
    moveDirectoryRequest: {
        from: '/source/image.png'
    }
});

if (res.status === 204) {
    console.log('目录移动成功');
}

// 移入回收站
const res = await smh.directory.deleteDirectory({
    spaceId: 'your-space-id',
    filePath: '/old-folder',
    permanent: 0,
    userId: 'xxx'
});

if (res.status === 200) {
    console.log('目录已移入回收站，回收站项目 ID:', res.data.recycledItemId);
} else if (res.status === 204) {
    console.log('目录已永久删除');
}

const res = await smh.directory.updateDirectoryLabels({
    spaceId: 'your-space-id',
    filePath: '/documents',
    update: 1,
    updateDirectoryLabelsRequest: {
        labels: ['tag1', 'tag2', 'important']
    }
});

if (res.status === 204) {
    console.log('目录标签更新成功');
}

// 更新文件标签和分类
const res = await smh.directory.updateFileLabels({
    spaceId: 'your-space-id',
    filePath: 'text.txt',
    update: 1,
    updateFileLabelsRequest: {
        labels: ['动物', '大象', '亚洲象'],
        category: 'image',
        localCreationTime: '2022-07-26T02:58:09Z',
        localModificationTime: '2022-07-26T02:58:09Z'
    }
});

if (res.status === 204) {
    console.log('文件标签更新成功');
}