907 lines
28 KiB
Dart
907 lines
28 KiB
Dart
import 'package:dio/dio.dart';
|
||
|
||
import 'api_service.dart';
|
||
import '../core/utils/file_utils.dart';
|
||
|
||
class ShareLinkCandidate {
|
||
final String id;
|
||
final String url;
|
||
final String? password;
|
||
|
||
const ShareLinkCandidate({
|
||
required this.id,
|
||
required this.url,
|
||
this.password,
|
||
});
|
||
}
|
||
|
||
class ShareLinkInfo {
|
||
final String id;
|
||
final String name;
|
||
final int visited;
|
||
final bool expired;
|
||
final bool unlocked;
|
||
final bool isPrivate;
|
||
final int sourceType;
|
||
final String? sourceUri;
|
||
final int size;
|
||
final String? url;
|
||
final String? ownerName;
|
||
final String? ownerId;
|
||
final String? ownerAvatar;
|
||
final String? contextHint;
|
||
final DateTime? createdAt;
|
||
final DateTime? expires;
|
||
|
||
const ShareLinkInfo({
|
||
required this.id,
|
||
required this.name,
|
||
required this.visited,
|
||
required this.expired,
|
||
required this.unlocked,
|
||
required this.isPrivate,
|
||
required this.sourceType,
|
||
this.sourceUri,
|
||
this.size = 0,
|
||
this.url,
|
||
this.ownerName,
|
||
this.ownerId,
|
||
this.ownerAvatar,
|
||
this.contextHint,
|
||
this.createdAt,
|
||
this.expires,
|
||
});
|
||
|
||
bool get isFolder => sourceType == 1;
|
||
bool get isFile => !isFolder;
|
||
|
||
factory ShareLinkInfo.fromJson(Map<String, dynamic> json) {
|
||
final owner = _asMap(json['owner']);
|
||
final source = _asMap(json['source']);
|
||
final file = _asMap(json['file']);
|
||
final object = _asMap(json['object']);
|
||
final entity = _asMap(json['entity']);
|
||
final rawSource = json['source'];
|
||
|
||
final ownerId = (owner?['id'] ??
|
||
json['owner_id'] ??
|
||
json['ownerId'] ??
|
||
source?['owner_id'] ??
|
||
file?['owner_id'])
|
||
?.toString();
|
||
|
||
final name = (json['name'] ??
|
||
file?['name'] ??
|
||
source?['name'] ??
|
||
object?['name'] ??
|
||
'分享文件')
|
||
.toString();
|
||
|
||
final parsedSourceUri = (json['source_uri'] ??
|
||
json['sourceUri'] ??
|
||
json['uri'] ??
|
||
json['path'] ??
|
||
(rawSource is String ? rawSource : null) ??
|
||
source?['uri'] ??
|
||
source?['source_uri'] ??
|
||
source?['path'] ??
|
||
source?['url'] ??
|
||
file?['uri'] ??
|
||
file?['source_uri'] ??
|
||
file?['path'] ??
|
||
object?['uri'] ??
|
||
object?['source_uri'] ??
|
||
object?['path'] ??
|
||
entity?['uri'] ??
|
||
entity?['source_uri'] ??
|
||
entity?['path'])
|
||
?.toString();
|
||
|
||
final resolvedSourceUri = _looksLikeCloudreveUri(parsedSourceUri)
|
||
? parsedSourceUri
|
||
: _fallbackSourceUri(ownerId: ownerId, name: name);
|
||
|
||
final size = _asInt(json['size'] ??
|
||
json['source_size'] ??
|
||
json['sourceSize'] ??
|
||
source?['size'] ??
|
||
file?['size'] ??
|
||
object?['size'] ??
|
||
entity?['size']);
|
||
|
||
return ShareLinkInfo(
|
||
id: json['id']?.toString() ?? '',
|
||
name: name,
|
||
size: size,
|
||
visited: _asInt(json['visited']),
|
||
expired: json['expired'] as bool? ?? false,
|
||
unlocked: json['unlocked'] as bool? ?? false,
|
||
isPrivate: json['is_private'] as bool? ?? false,
|
||
sourceType: _asInt(json['source_type'] ??
|
||
source?['type'] ??
|
||
file?['type'] ??
|
||
object?['type']),
|
||
sourceUri: resolvedSourceUri,
|
||
url: json['url']?.toString(),
|
||
ownerName: owner?['nickname']?.toString() ??
|
||
owner?['name']?.toString() ??
|
||
json['owner_name']?.toString(),
|
||
ownerId: ownerId,
|
||
ownerAvatar: owner?['avatar']?.toString(),
|
||
contextHint: json['context_hint']?.toString() ??
|
||
json['contextHint']?.toString() ??
|
||
json['context']?.toString(),
|
||
createdAt: _parseDate(json['created_at']),
|
||
expires: _parseDate(json['expires']),
|
||
);
|
||
}
|
||
|
||
static bool _looksLikeCloudreveUri(String? value) {
|
||
if (value == null || value.trim().isEmpty) return false;
|
||
return value.trim().startsWith('cloudreve://');
|
||
}
|
||
|
||
static String? _fallbackSourceUri({
|
||
required String? ownerId,
|
||
required String name,
|
||
}) {
|
||
// 不再用 owner@my 兜底。公开分享上下文不是当前账号的 my 文件系统，
|
||
// 用 owner@my 会导致 /file/url 返回 40081 或空 urls。
|
||
// 真正的兜底由 ShareLinkService.getShareInfo 根据分享 ID 构造
|
||
// cloudreve://<shareId>@share/ 完成。
|
||
return null;
|
||
}
|
||
|
||
static Map<String, dynamic>? _asMap(dynamic value) {
|
||
if (value is Map<String, dynamic>) return value;
|
||
if (value is Map) return Map<String, dynamic>.from(value);
|
||
return null;
|
||
}
|
||
|
||
static int _asInt(dynamic value) {
|
||
if (value is int) return value;
|
||
if (value is num) return value.toInt();
|
||
if (value is String) return int.tryParse(value) ?? 0;
|
||
return 0;
|
||
}
|
||
|
||
static DateTime? _parseDate(dynamic value) {
|
||
final text = value?.toString();
|
||
if (text == null || text.isEmpty) return null;
|
||
return DateTime.tryParse(text);
|
||
}
|
||
}
|
||
|
||
class ShareLinkFile {
|
||
final int type;
|
||
final String id;
|
||
final String name;
|
||
final int size;
|
||
final String path;
|
||
final DateTime? createdAt;
|
||
final DateTime? updatedAt;
|
||
final String? primaryEntity;
|
||
final String? capability;
|
||
final String? contextHint;
|
||
final Map<String, dynamic>? metadata;
|
||
|
||
const ShareLinkFile({
|
||
required this.type,
|
||
required this.id,
|
||
required this.name,
|
||
required this.size,
|
||
required this.path,
|
||
this.createdAt,
|
||
this.updatedAt,
|
||
this.primaryEntity,
|
||
this.capability,
|
||
this.contextHint,
|
||
this.metadata,
|
||
});
|
||
|
||
bool get isFolder => type == 1;
|
||
bool get isFile => !isFolder;
|
||
|
||
factory ShareLinkFile.fromJson(Map<String, dynamic> json) {
|
||
return ShareLinkFile(
|
||
type: _asInt(json['type']),
|
||
id: json['id']?.toString() ?? '',
|
||
name: json['name']?.toString() ?? '未命名文件',
|
||
size: _asInt(json['size']),
|
||
path: json['path']?.toString() ?? '',
|
||
createdAt: _parseDate(json['created_at']),
|
||
updatedAt: _parseDate(json['updated_at']),
|
||
primaryEntity: json['primary_entity']?.toString() ??
|
||
json['entity']?.toString(),
|
||
capability: json['capability']?.toString(),
|
||
contextHint: json['context_hint']?.toString(),
|
||
metadata: _asMap(json['metadata']),
|
||
);
|
||
}
|
||
|
||
static int _asInt(dynamic value) {
|
||
if (value is int) return value;
|
||
if (value is num) return value.toInt();
|
||
if (value is String) return int.tryParse(value) ?? 0;
|
||
return 0;
|
||
}
|
||
|
||
static DateTime? _parseDate(dynamic value) {
|
||
final text = value?.toString();
|
||
if (text == null || text.isEmpty) return null;
|
||
return DateTime.tryParse(text);
|
||
}
|
||
|
||
static Map<String, dynamic>? _asMap(dynamic value) {
|
||
if (value is Map<String, dynamic>) return value;
|
||
if (value is Map) return Map<String, dynamic>.from(value);
|
||
return null;
|
||
}
|
||
}
|
||
|
||
class ShareLinkFileListResult {
|
||
final List<ShareLinkFile> files;
|
||
final ShareLinkFile? parent;
|
||
final String? contextHint;
|
||
final bool hasMore;
|
||
final String? nextPageToken;
|
||
|
||
const ShareLinkFileListResult({
|
||
required this.files,
|
||
this.parent,
|
||
this.contextHint,
|
||
this.hasMore = false,
|
||
this.nextPageToken,
|
||
});
|
||
|
||
factory ShareLinkFileListResult.fromJson(Map<String, dynamic> json) {
|
||
final rawFiles = json['files'];
|
||
final rawParent = json['parent'];
|
||
final pagination = ShareLinkService._asMap(json['pagination']);
|
||
|
||
return ShareLinkFileListResult(
|
||
files: rawFiles is List
|
||
? rawFiles
|
||
.whereType<Map>()
|
||
.map((item) => ShareLinkFile.fromJson(Map<String, dynamic>.from(item)))
|
||
.toList()
|
||
: const [],
|
||
parent: rawParent is Map
|
||
? ShareLinkFile.fromJson(Map<String, dynamic>.from(rawParent))
|
||
: null,
|
||
contextHint: json['context_hint']?.toString(),
|
||
hasMore: pagination?['next_token'] != null,
|
||
nextPageToken: pagination?['next_token']?.toString(),
|
||
);
|
||
}
|
||
}
|
||
|
||
class ShareDownloadUrlResult {
|
||
final String url;
|
||
final DateTime? expires;
|
||
|
||
const ShareDownloadUrlResult({
|
||
required this.url,
|
||
this.expires,
|
||
});
|
||
}
|
||
|
||
class ShareLinkService {
|
||
ShareLinkService._();
|
||
|
||
static final ShareLinkService instance = ShareLinkService._();
|
||
|
||
/// 兼容当前站点固定域名，也兼容用户自定义 Cloudreve 域名的 /s/{id}/{password?} 分享链接。
|
||
static final RegExp _shareLinkRegExp = RegExp(
|
||
r'https?://[^\s]+?/s/([A-Za-z0-9_-]+)(?:/([A-Za-z0-9_-]+))?',
|
||
caseSensitive: false,
|
||
);
|
||
|
||
ShareLinkCandidate? parseShareLink(String? text) {
|
||
if (text == null || text.trim().isEmpty) return null;
|
||
|
||
final match = _shareLinkRegExp.firstMatch(text.trim());
|
||
if (match == null) return null;
|
||
|
||
final id = match.group(1);
|
||
if (id == null || id.isEmpty) return null;
|
||
|
||
final password = match.group(2);
|
||
final url = match.group(0)!;
|
||
|
||
return ShareLinkCandidate(
|
||
id: id,
|
||
url: url,
|
||
password: password == null || password.isEmpty ? null : password,
|
||
);
|
||
}
|
||
|
||
Future<ShareLinkInfo> getShareInfo(
|
||
ShareLinkCandidate candidate, {
|
||
String? password,
|
||
}) async {
|
||
final resolvedPassword = password ?? candidate.password;
|
||
final query = <String, dynamic>{
|
||
'count_views': true,
|
||
'owner_extended': true,
|
||
if (resolvedPassword != null && resolvedPassword.isNotEmpty)
|
||
'password': resolvedPassword,
|
||
};
|
||
|
||
final response = await ApiService.instance.dio.get<Map<String, dynamic>>(
|
||
'/share/info/${candidate.id}',
|
||
queryParameters: query,
|
||
options: Options(
|
||
extra: const {'noAuth': true},
|
||
headers: const {
|
||
'X-Cr-Context-Hint': 'share',
|
||
},
|
||
),
|
||
);
|
||
|
||
final body = response.data ?? <String, dynamic>{};
|
||
final data = _asMap(body['data']) ?? body;
|
||
final headerContext = _headerValue(response.headers, 'X-Cr-Context-Hint');
|
||
final sourceType = ShareLinkInfo._asInt(data['source_type']);
|
||
|
||
// 公开分享页面访问文件时，必须使用 Cloudreve 官方 share 文件系统 URI，
|
||
// 即 cloudreve://{shareId}[:password]@share[/...]。
|
||
// /share/info 返回的 source_uri 往往是所有者 my 文件系统里的真实路径，
|
||
// 匿名/noAuth 场景拿它直接请求 /file/url 会被服务端按普通文件解析，
|
||
// 进而返回 40081 Entity not exist。
|
||
final accessUri = shareRootUri(
|
||
shareId: candidate.id,
|
||
password: resolvedPassword,
|
||
trailingSlash: sourceType != 0,
|
||
);
|
||
|
||
return ShareLinkInfo.fromJson(<String, dynamic>{
|
||
...data,
|
||
'source_uri': accessUri,
|
||
if ((data['context_hint'] == null || data['context_hint'].toString().isEmpty) &&
|
||
headerContext != null &&
|
||
headerContext.isNotEmpty)
|
||
'context_hint': headerContext,
|
||
});
|
||
}
|
||
|
||
String? ownerAvatarUrl(ShareLinkInfo info) {
|
||
final ownerId = info.ownerId;
|
||
if (ownerId == null || ownerId.isEmpty) return null;
|
||
|
||
final avatar = info.ownerAvatar;
|
||
if (avatar != null && avatar.startsWith(RegExp(r'https?://'))) {
|
||
return avatar;
|
||
}
|
||
|
||
final base = ApiService.instance.dio.options.baseUrl.replaceFirst(RegExp(r'/+$'), '');
|
||
return '$base/user/avatar/${Uri.encodeComponent(ownerId)}';
|
||
}
|
||
|
||
/// 按分享的 source_uri 读取目录文件。
|
||
///
|
||
/// Cloudreve V4 的 /file 接口支持 JWT Optional，并通过 X-Cr-Context-Hint
|
||
/// 绑定分享上下文。首次读取时用 `share`，服务端返回 context_hint 后，后续下载
|
||
/// 和进入子目录都继续携带该 context_hint。
|
||
Future<ShareLinkFileListResult> listSharedFiles({
|
||
required String uri,
|
||
String? contextHint,
|
||
int page = 0,
|
||
int pageSize = 100,
|
||
String? nextPageToken,
|
||
}) async {
|
||
final response = await ApiService.instance.dio.get<Map<String, dynamic>>(
|
||
'/file',
|
||
queryParameters: <String, dynamic>{
|
||
'uri': uri,
|
||
'page': page,
|
||
'page_size': pageSize,
|
||
if (nextPageToken != null && nextPageToken.isNotEmpty)
|
||
'next_page_token': nextPageToken,
|
||
},
|
||
options: Options(
|
||
extra: const {'noAuth': true},
|
||
headers: <String, dynamic>{
|
||
'X-Cr-Context-Hint': _firstContextHint(contextHint),
|
||
},
|
||
),
|
||
);
|
||
|
||
final body = response.data ?? <String, dynamic>{};
|
||
final data = _asMap(body['data']) ?? body;
|
||
final headerContext = _headerValue(response.headers, 'X-Cr-Context-Hint');
|
||
return ShareLinkFileListResult.fromJson(<String, dynamic>{
|
||
...data,
|
||
if ((data['context_hint'] == null || data['context_hint'].toString().isEmpty) &&
|
||
headerContext != null &&
|
||
headerContext.isNotEmpty)
|
||
'context_hint': headerContext,
|
||
});
|
||
}
|
||
|
||
/// 读取分享上下文中文件详情，主要用于拿到 primary_entity。
|
||
Future<ShareLinkFile> getSharedFileInfo({
|
||
required String uri,
|
||
String? contextHint,
|
||
String? shareId,
|
||
String? password,
|
||
}) async {
|
||
Object? lastError;
|
||
|
||
for (final hint in _contextHintCandidates(contextHint, shareId: shareId)) {
|
||
try {
|
||
final response = await ApiService.instance.dio.get<Map<String, dynamic>>(
|
||
'/file/info',
|
||
queryParameters: <String, dynamic>{
|
||
'uri': uri,
|
||
'extended': true,
|
||
},
|
||
options: Options(
|
||
extra: const {'noAuth': true},
|
||
headers: <String, dynamic>{
|
||
'X-Cr-Context-Hint': hint,
|
||
},
|
||
),
|
||
);
|
||
|
||
final body = response.data ?? <String, dynamic>{};
|
||
final data = _asMap(body['data']) ?? body;
|
||
final headerContext = _headerValue(response.headers, 'X-Cr-Context-Hint');
|
||
return ShareLinkFile.fromJson(<String, dynamic>{
|
||
...data,
|
||
'context_hint': data['context_hint'] ?? headerContext ?? hint,
|
||
});
|
||
} catch (e) {
|
||
lastError = e;
|
||
}
|
||
}
|
||
|
||
throw lastError ?? Exception('文件详情读取失败');
|
||
}
|
||
|
||
ShareLinkFile fileFromShareInfo(ShareLinkInfo info) {
|
||
final sourceUri = info.sourceUri ??
|
||
ShareLinkInfo._fallbackSourceUri(
|
||
ownerId: info.ownerId,
|
||
name: info.name,
|
||
) ??
|
||
'';
|
||
return ShareLinkFile(
|
||
type: info.sourceType,
|
||
id: info.id,
|
||
name: info.name,
|
||
size: info.size,
|
||
path: sourceUri,
|
||
createdAt: info.createdAt,
|
||
updatedAt: info.createdAt,
|
||
contextHint: info.contextHint,
|
||
);
|
||
}
|
||
|
||
/// 获取分享上下文中的下载 URL。
|
||
///
|
||
/// 按 Cloudreve V4 官方 `/file/url` 方式创建临时下载链接：
|
||
/// body 只提交 `uris`，文件夹批量下载时提交 `archive: true`；
|
||
/// 分享访问走 JWT Optional，因此这里使用 noAuth，避免当前登录用户的
|
||
/// Authorization 影响分享上下文。
|
||
Future<ShareDownloadUrlResult> createShareDownloadUrl({
|
||
required String uri,
|
||
String? contextHint,
|
||
String? shareId,
|
||
String? password,
|
||
String? entity,
|
||
String? fileName,
|
||
bool archive = false,
|
||
}) async {
|
||
Object? lastError;
|
||
|
||
// Cloudreve V4 官方接口：POST /file/url
|
||
// Header: X-Cr-Context-Hint
|
||
// Body: { "uris": [...], "archive": true? }
|
||
//
|
||
// 分享下载必须不带当前账号 token；否则服务端可能按当前账号解析 URI，
|
||
// 出现 Entity not exist (40081)。
|
||
for (final candidateUri in _uriCandidates(
|
||
uri,
|
||
shareId: shareId,
|
||
password: password,
|
||
fileName: fileName,
|
||
)) {
|
||
for (final hint in _contextHintCandidates(contextHint, shareId: shareId)) {
|
||
try {
|
||
return await _createShareDownloadUrlOnce(
|
||
uri: candidateUri,
|
||
contextHint: hint,
|
||
archive: archive,
|
||
);
|
||
} catch (e) {
|
||
lastError = e;
|
||
}
|
||
}
|
||
}
|
||
|
||
throw lastError ?? Exception('服务端没有返回可用的下载链接');
|
||
}
|
||
|
||
Future<ShareDownloadUrlResult> _createShareDownloadUrlOnce({
|
||
required String uri,
|
||
required String contextHint,
|
||
bool archive = false,
|
||
}) async {
|
||
final body = <String, dynamic>{
|
||
'uris': <String>[uri],
|
||
'download': true,
|
||
if (archive) 'archive': true,
|
||
};
|
||
|
||
final response = await ApiService.instance.dio.post<Map<String, dynamic>>(
|
||
'/file/url',
|
||
data: body,
|
||
options: Options(
|
||
extra: const {'noAuth': true},
|
||
headers: <String, dynamic>{
|
||
'Content-Type': 'application/json',
|
||
'X-Cr-Context-Hint': contextHint,
|
||
},
|
||
),
|
||
);
|
||
|
||
final raw = response.data ?? <String, dynamic>{};
|
||
final data = _asMap(raw['data']) ?? raw;
|
||
final url = _extractDownloadUrl(data) ?? _extractDownloadUrl(raw);
|
||
if (url != null && url.isNotEmpty) {
|
||
return ShareDownloadUrlResult(
|
||
url: url,
|
||
expires: ShareLinkInfo._parseDate(data['expires'] ?? raw['expires']),
|
||
);
|
||
}
|
||
|
||
throw Exception('服务端没有返回可用的下载链接');
|
||
}
|
||
|
||
/// 将分享文件转存到当前用户网盘。
|
||
///
|
||
/// Cloudreve V4 使用 /file/move，同一接口可移动/复制文件；传入 copy=true
|
||
/// 时即为转存/复制到目标目录。
|
||
Future<void> saveSharedFiles({
|
||
required List<String> uris,
|
||
required String destination,
|
||
String? contextHint,
|
||
String? shareId,
|
||
String? password,
|
||
String? fileName,
|
||
}) async {
|
||
final dst = FileUtils.toCloudreveUri(destination);
|
||
Object? lastError;
|
||
|
||
final uriCandidateSets = uris
|
||
.map((uri) => _uriCandidates(
|
||
uri,
|
||
shareId: shareId,
|
||
password: password,
|
||
// 单文件分享的 source_uri 是 cloudreve://{id}@share 根。
|
||
// /file/move 不允许复制 share 根目录，因此需要优先尝试
|
||
// cloudreve://{id}@share/{fileName}，并过滤掉根 URI。
|
||
fileName: uris.length == 1 ? fileName : null,
|
||
includeRootFallback: false,
|
||
)
|
||
.where((candidate) => !isShareRootUri(candidate, shareId: shareId))
|
||
.toList())
|
||
.where((candidates) => candidates.isNotEmpty)
|
||
.toList();
|
||
|
||
if (uriCandidateSets.isEmpty) {
|
||
throw Exception('不能直接转存分享根目录，请选择具体文件或进入目录后再转存');
|
||
}
|
||
|
||
for (final hint in _contextHintCandidates(contextHint, shareId: shareId)) {
|
||
for (final candidateUris in _cartesianUriCandidates(uriCandidateSets)) {
|
||
if (candidateUris.isEmpty) continue;
|
||
try {
|
||
await ApiService.instance.post<void>(
|
||
'/file/move',
|
||
data: <String, dynamic>{
|
||
'uris': candidateUris,
|
||
'dst': dst,
|
||
'copy': true,
|
||
},
|
||
headers: <String, dynamic>{
|
||
'Content-Type': 'application/json',
|
||
'X-Cr-Context-Hint': hint,
|
||
},
|
||
);
|
||
return;
|
||
} catch (e) {
|
||
lastError = e;
|
||
}
|
||
}
|
||
}
|
||
|
||
throw lastError ?? Exception('转存失败');
|
||
}
|
||
|
||
static List<String> _uriCandidates(
|
||
String uri, {
|
||
String? shareId,
|
||
String? password,
|
||
String? fileName,
|
||
bool includeRootFallback = true,
|
||
}) {
|
||
final values = <String>[];
|
||
|
||
void add(String? value) {
|
||
final text = value?.trim();
|
||
if (text != null && text.isNotEmpty && !values.contains(text)) {
|
||
values.add(text);
|
||
}
|
||
}
|
||
|
||
final shareUriCandidates = _shareScopedUriCandidates(
|
||
uri,
|
||
shareId: shareId,
|
||
password: password,
|
||
);
|
||
|
||
// 官方页面进入的是 cloudreve://{shareId}@share 文件系统；
|
||
// 如果 /file 返回了 cloudreve://my/... 或 owner@my/...，
|
||
// 转存/下载时也要先折算成 share 文件系统里的相对路径。
|
||
for (final item in shareUriCandidates) {
|
||
add(item);
|
||
}
|
||
|
||
final name = fileName?.trim();
|
||
final id = shareId?.trim();
|
||
if (id != null && id.isNotEmpty && name != null && name.isNotEmpty) {
|
||
final root = shareRootUri(
|
||
shareId: id,
|
||
password: password,
|
||
trailingSlash: false,
|
||
);
|
||
add('$root/${Uri.encodeComponent(name)}');
|
||
add('$root/${_encodeCloudrevePath(name)}');
|
||
}
|
||
|
||
add(_withSharePassword(uri, shareId: shareId, password: password));
|
||
add(uri);
|
||
|
||
if (uri.startsWith('cloudreve://')) {
|
||
final withPassword = _withSharePassword(uri, shareId: shareId, password: password);
|
||
if (withPassword != uri) add(withPassword);
|
||
|
||
final slash = uri.indexOf('/', 'cloudreve://'.length);
|
||
if (slash > 0) {
|
||
final prefix = uri.substring(0, slash + 1);
|
||
final path = slash < uri.length - 1 ? uri.substring(slash + 1) : '';
|
||
if (path.isNotEmpty) {
|
||
final encodedPath = _encodeCloudrevePath(path);
|
||
add(_withSharePassword('$prefix$encodedPath', shareId: shareId, password: password));
|
||
add('$prefix$encodedPath');
|
||
}
|
||
if (!uri.endsWith('/')) {
|
||
add(_withSharePassword('$uri/', shareId: shareId, password: password));
|
||
add('$uri/');
|
||
}
|
||
}
|
||
}
|
||
|
||
if (includeRootFallback && shareId != null && shareId.trim().isNotEmpty) {
|
||
add(shareRootUri(shareId: shareId, password: password, trailingSlash: true));
|
||
add(shareRootUri(shareId: shareId, password: password, trailingSlash: false));
|
||
}
|
||
|
||
return values;
|
||
}
|
||
|
||
static List<String> _shareScopedUriCandidates(
|
||
String uri, {
|
||
String? shareId,
|
||
String? password,
|
||
}) {
|
||
final id = shareId?.trim();
|
||
if (id == null || id.isEmpty || !uri.startsWith('cloudreve://')) {
|
||
return const <String>[];
|
||
}
|
||
|
||
final values = <String>[];
|
||
void add(String? value) {
|
||
final text = value?.trim();
|
||
if (text != null && text.isNotEmpty && !values.contains(text)) {
|
||
values.add(text);
|
||
}
|
||
}
|
||
|
||
final authorityStart = 'cloudreve://'.length;
|
||
final slash = uri.indexOf('/', authorityStart);
|
||
final authority = slash >= 0 ? uri.substring(authorityStart, slash) : uri.substring(authorityStart);
|
||
final rawPath = slash >= 0 && slash < uri.length - 1 ? uri.substring(slash + 1) : '';
|
||
final decodedPath = rawPath
|
||
.split('/')
|
||
.where((segment) => segment.isNotEmpty)
|
||
.map((segment) => Uri.decodeComponent(segment))
|
||
.join('/');
|
||
|
||
final isShareAuthority = authority.endsWith('@share');
|
||
if (isShareAuthority) {
|
||
add(_withSharePassword(uri, shareId: id, password: password));
|
||
add(uri);
|
||
return values;
|
||
}
|
||
|
||
if (decodedPath.isEmpty) return values;
|
||
|
||
final pathParts = decodedPath.split('/').where((e) => e.isNotEmpty).toList();
|
||
final root = shareRootUri(shareId: id, password: password, trailingSlash: false);
|
||
|
||
// 完整路径候选：cloudreve://id@share/folder/file.ext
|
||
add('$root/${_encodeCloudrevePath(decodedPath)}');
|
||
|
||
// 单文件分享或列表返回 owner 的 my 路径时，官方 share 根目录下通常就是文件本身，
|
||
// 因此还要尝试 basename 候选：cloudreve://id@share/file.ext
|
||
if (pathParts.isNotEmpty) {
|
||
add('$root/${Uri.encodeComponent(pathParts.last)}');
|
||
}
|
||
|
||
// 如果原 path 形如 Folder/Sub/File，分享根可能是 Folder，子项在 share 中应为 Sub/File。
|
||
if (pathParts.length > 1) {
|
||
final withoutFirst = pathParts.skip(1).join('/');
|
||
add('$root/${_encodeCloudrevePath(withoutFirst)}');
|
||
}
|
||
|
||
return values;
|
||
}
|
||
|
||
static String _encodeCloudrevePath(String path) {
|
||
return path
|
||
.split('/')
|
||
.where((segment) => segment.isNotEmpty)
|
||
.map((segment) => Uri.encodeComponent(Uri.decodeComponent(segment)))
|
||
.join('/');
|
||
}
|
||
|
||
static String _withSharePassword(String uri, {String? shareId, String? password}) {
|
||
final pw = password?.trim();
|
||
final id = shareId?.trim();
|
||
if (pw == null || pw.isEmpty || id == null || id.isEmpty) return uri;
|
||
if (!uri.startsWith('cloudreve://')) return uri;
|
||
|
||
final authorityStart = 'cloudreve://'.length;
|
||
final slash = uri.indexOf('/', authorityStart);
|
||
final authority = slash >= 0 ? uri.substring(authorityStart, slash) : uri.substring(authorityStart);
|
||
final rest = slash >= 0 ? uri.substring(slash) : '';
|
||
if (!authority.endsWith('@share')) return uri;
|
||
if (authority.contains(':')) return uri;
|
||
|
||
final encodedId = Uri.encodeComponent(id);
|
||
final encodedPw = Uri.encodeComponent(pw);
|
||
if (authority != '$encodedId@share' && authority != '$id@share') return uri;
|
||
return 'cloudreve://$encodedId:$encodedPw@share$rest';
|
||
}
|
||
|
||
static String shareRootUri({
|
||
required String shareId,
|
||
String? password,
|
||
bool trailingSlash = true,
|
||
}) {
|
||
final id = Uri.encodeComponent(shareId.trim());
|
||
final pw = password?.trim();
|
||
final userInfo = pw == null || pw.isEmpty
|
||
? id
|
||
: '$id:${Uri.encodeComponent(pw)}';
|
||
return 'cloudreve://$userInfo@share${trailingSlash ? '/' : ''}';
|
||
}
|
||
|
||
static bool isShareRootUri(String uri, {String? shareId}) {
|
||
final text = uri.trim();
|
||
const prefix = 'cloudreve://';
|
||
if (!text.startsWith(prefix)) return false;
|
||
|
||
final authorityStart = prefix.length;
|
||
final slash = text.indexOf('/', authorityStart);
|
||
final authority = slash >= 0
|
||
? text.substring(authorityStart, slash)
|
||
: text.substring(authorityStart);
|
||
if (!authority.endsWith('@share')) return false;
|
||
|
||
final path = slash >= 0 ? text.substring(slash) : '';
|
||
if (path.isNotEmpty && path != '/') return false;
|
||
|
||
final expectedId = shareId?.trim();
|
||
if (expectedId == null || expectedId.isEmpty) return true;
|
||
|
||
final userInfo = authority.substring(0, authority.length - '@share'.length);
|
||
final rawId = userInfo.split(':').first;
|
||
return Uri.decodeComponent(rawId) == expectedId || rawId == expectedId;
|
||
}
|
||
|
||
|
||
static String? _extractDownloadUrl(Map<String, dynamic> data) {
|
||
final direct = data['url'] ??
|
||
data['download_url'] ??
|
||
data['downloadUrl'] ??
|
||
data['src'] ??
|
||
data['href'];
|
||
if (direct is String && direct.trim().isNotEmpty) return direct.trim();
|
||
|
||
final rawUrls = data['urls'];
|
||
if (rawUrls is String && rawUrls.trim().isNotEmpty) return rawUrls.trim();
|
||
if (rawUrls is List) {
|
||
for (final item in rawUrls) {
|
||
if (item is String && item.trim().isNotEmpty) return item.trim();
|
||
final map = _asMap(item);
|
||
if (map == null) continue;
|
||
final url = _extractDownloadUrl(map);
|
||
if (url != null && url.isNotEmpty) return url;
|
||
}
|
||
}
|
||
if (rawUrls is Map) {
|
||
for (final item in rawUrls.values) {
|
||
if (item is String && item.trim().isNotEmpty) return item.trim();
|
||
final map = _asMap(item);
|
||
if (map == null) continue;
|
||
final url = _extractDownloadUrl(map);
|
||
if (url != null && url.isNotEmpty) return url;
|
||
}
|
||
}
|
||
return null;
|
||
}
|
||
|
||
static List<List<String>> _cartesianUriCandidates(List<List<String>> sets) {
|
||
if (sets.isEmpty) return const [[]];
|
||
|
||
var result = <List<String>>[const []];
|
||
for (final set in sets) {
|
||
final next = <List<String>>[];
|
||
for (final prefix in result) {
|
||
for (final item in set) {
|
||
next.add(<String>[...prefix, item]);
|
||
}
|
||
}
|
||
result = next;
|
||
}
|
||
return result;
|
||
}
|
||
|
||
static String _firstContextHint(String? contextHint) {
|
||
final value = contextHint?.trim();
|
||
return value == null || value.isEmpty ? 'share' : value;
|
||
}
|
||
|
||
static List<String> _contextHintCandidates(String? contextHint, {String? shareId}) {
|
||
final values = <String>[];
|
||
void add(String? value) {
|
||
final text = value?.trim();
|
||
if (text != null && text.isNotEmpty && !values.contains(text)) {
|
||
values.add(text);
|
||
}
|
||
}
|
||
|
||
add(contextHint);
|
||
add(shareId);
|
||
if (shareId != null && shareId.trim().isNotEmpty) {
|
||
add('share:${shareId.trim()}');
|
||
add('share_${shareId.trim()}');
|
||
}
|
||
add('share');
|
||
return values;
|
||
}
|
||
|
||
static String? _headerValue(Headers headers, String name) {
|
||
final direct = headers.value(name) ?? headers.value(name.toLowerCase());
|
||
if (direct != null && direct.isNotEmpty) return direct;
|
||
|
||
final lower = name.toLowerCase();
|
||
for (final entry in headers.map.entries) {
|
||
if (entry.key.toLowerCase() == lower && entry.value.isNotEmpty) {
|
||
return entry.value.first;
|
||
}
|
||
}
|
||
return null;
|
||
}
|
||
|
||
static Map<String, dynamic>? _asMap(dynamic value) {
|
||
if (value is Map<String, dynamic>) return value;
|
||
if (value is Map) return Map<String, dynamic>.from(value);
|
||
return null;
|
||
}
|
||
}
|