Files
X 61b247f90c feat(quark): add Quark Drive adapter (#858)
* feat(quark): add Quark Drive adapter (ls, mkdir, mv, rename, rm, save, share-tree)

Browser-based adapter for Quark Cloud Drive (pan.quark.cn) using cookie
strategy. Supports file browsing, folder management, and saving shared
files with task polling for async operations.

* fix(quark): address review feedback on adapter correctness and docs

- ls: fix depth off-by-one (default 0 now lists target folder only)
- save/mv: report success only after pollTask confirms completion; throw on timeout
- save/mv: reject combining --to and --to-fid instead of silently preferring --to-fid
- utils: check content-type before calling r.json() to handle non-JSON responses gracefully
- tests: add quark graceful auth-failure E2E cases for all 7 commands
- docs: add Browser Bridge extension to prerequisites; fix mkdir --parent example; expand command table with positional args; add Notes section explaining stoken flow

* fix(quark): map auth failures and cover utils

* fix(quark): reuse auth mapping for share-tree

---------

Co-authored-by: xzy <xzy@mbp-m5.local>
Co-authored-by: jackwener <jakevingoo@gmail.com>
2026-04-08 00:28:59 +08:00

63 lines
2.1 KiB
TypeScript

import { ArgumentError, CommandExecutionError } from '@jackwener/opencli/errors';
import { cli, Strategy } from '@jackwener/opencli/registry';
import type { IPage } from '@jackwener/opencli/types';
import { DRIVE_API, apiPost, findFolder, pollTask } from './utils.js';
interface MoveResult {
status: string;
count: number;
destination: string;
task_id: string;
completed: boolean;
}
cli({
site: 'quark',
name: 'mv',
description: 'Move files to a folder in your Quark Drive',
domain: 'pan.quark.cn',
strategy: Strategy.COOKIE,
defaultFormat: 'json',
timeoutSeconds: 120,
args: [
{ name: 'fids', required: true, positional: true, help: 'File IDs to move (comma-separated)' },
{ name: 'to', default: '', help: 'Destination folder path (required unless --to-fid is set)' },
{ name: 'to-fid', default: '', help: 'Destination folder ID (overrides --to)' },
],
func: async (page: IPage, kwargs: Record<string, unknown>): Promise<MoveResult> => {
const to = kwargs.to as string;
const toFid = kwargs['to-fid'] as string;
const fids = kwargs.fids as string;
const fidList = [...new Set(fids.split(',').map(id => id.trim()).filter(Boolean))];
if (fidList.length === 0) throw new ArgumentError('No fids provided');
if (!to && !toFid) throw new ArgumentError('Either --to or --to-fid is required');
if (to && toFid) throw new ArgumentError('Cannot use both --to and --to-fid');
const targetFid = toFid || await findFolder(page, to);
const data = await apiPost<{ task_id: string }>(page, `${DRIVE_API}/move?pr=ucpro&fr=pc`, {
filelist: fidList,
to_pdir_fid: targetFid,
});
const result: MoveResult = {
status: 'pending',
count: fidList.length,
destination: to || toFid,
task_id: data.task_id,
completed: false,
};
if (data.task_id) {
const completed = await pollTask(page, data.task_id);
result.completed = completed;
result.status = completed ? 'ok' : 'error';
if (!completed) throw new CommandExecutionError('quark: Move task timed out');
} else {
result.status = 'ok';
result.completed = true;
}
return result;
},
});