session-viewer-plugin 0.1.2 → 0.1.4

package/server/dist/api/cloudApi.js

@@ -1,267 +0,0 @@
-import express from 'express';
-import { Readable } from 'node:stream';
-import { CloudStorageError } from '../services/cloudError.js';
-import { listCloudFiles, listAllCloudFiles, downloadCloudFile, getCloudFileDownloadToken, deleteCloudFile, getCloudFileMetadata, updateCloudFileMetadata, cloudFileExists, renameCloudFile, } from '../services/cloudStorage.js';
-// 模糊查询返回上限与文件夹单次删除上限（桶内对象量级 1 万以内）
-const SEARCH_RESULT_LIMIT = 500;
-const FOLDER_DELETE_LIMIT = 5000;
-function sendCloudError(res, err, fallback) {
-    if (err instanceof CloudStorageError) {
-        console.error(`Cloud storage error: ${err.message}`);
-        res.status(err.status).json({ error: err.message });
-        return;
-    }
-    console.error(fallback + ':', err);
-    res.status(500).json({ error: fallback });
-}
-function requireKey(req) {
-    const key = typeof req.query.key === 'string' ? req.query.key.trim() : '';
-    return key || null;
-}
-export const cloudApi = express.Router();
-cloudApi.get('/cloud/files', async (req, res) => {
-    try {
-        const prefix = typeof req.query.prefix === 'string' ? req.query.prefix : '';
-        const marker = typeof req.query.marker === 'string' ? req.query.marker : undefined;
-        const delimiterRaw = String(req.query.delimiter ?? '');
-        const delimiter = delimiterRaw !== '' && delimiterRaw !== '0' && delimiterRaw !== 'false';
-        const limitRaw = Number(req.query.limit);
-        const limit = Number.isFinite(limitRaw)
-            ? Math.min(Math.max(Math.trunc(limitRaw), 1), 1000)
-            : 100;
-        const result = await listCloudFiles({ prefix, marker, limit, delimiter });
-        console.log(`GET /api/cloud/files, prefix: '${prefix}', delimiter: ${delimiter}, limit: ${limit}, returning ${result.folders.length} folders, ${result.files.length} files`);
-        res.json(result);
-    }
-    catch (err) {
-        sendCloudError(res, err, 'Failed to list cloud files');
-    }
-});
-cloudApi.get('/cloud/file/download', async (req, res) => {
-    const key = requireKey(req);
-    if (!key) {
-        res.status(400).json({ error: 'Missing required query param: key' });
-        return;
-    }
-    try {
-        const dl = await downloadCloudFile(key);
-        res.setHeader('Content-Type', dl.contentType);
-        if (dl.contentLength)
-            res.setHeader('Content-Length', dl.contentLength);
-        res.setHeader('Content-Disposition', `attachment; filename="${encodeURIComponent(dl.filename)}"; filename*=UTF-8''${encodeURIComponent(dl.filename)}`);
-        if (dl.body) {
-            const stream = Readable.fromWeb(dl.body);
-            stream.pipe(res);
-        }
-        else {
-            res.end();
-        }
-    }
-    catch (err) {
-        sendCloudError(res, err, 'Failed to download cloud file');
-    }
-});
-// ─── 下载令牌（AGC 官方 ?token=create，公网免鉴权下载 URL）────
-cloudApi.get('/cloud/file/token', async (req, res) => {
-    const key = requireKey(req);
-    if (!key) {
-        res.status(400).json({ error: 'Missing required query param: key' });
-        return;
-    }
-    try {
-        const result = await getCloudFileDownloadToken(key);
-        console.log(`GET /api/cloud/file/token, key: ${key}, token: ${result.token}`);
-        res.json(result);
-    }
-    catch (err) {
-        sendCloudError(res, err, 'Failed to create cloud file token');
-    }
-});
-cloudApi.delete('/cloud/file', async (req, res) => {
-    const key = requireKey(req);
-    if (!key) {
-        res.status(400).json({ error: 'Missing required query param: key' });
-        return;
-    }
-    try {
-        await deleteCloudFile(key);
-        console.log(`DELETE /api/cloud/file, key: ${key}, deleted`);
-        res.json({ deleted: true, key });
-    }
-    catch (err) {
-        sendCloudError(res, err, 'Failed to delete cloud file');
-    }
-});
-// ─── 模糊查询（AGC 无模糊 API：服务端全量拉取 + 内存 contains 匹配）─────────
-cloudApi.get('/cloud/search', async (req, res) => {
-    const query = typeof req.query.query === 'string' ? req.query.query.trim() : '';
-    const prefix = typeof req.query.prefix === 'string' ? req.query.prefix.trim() : '';
-    if (!query) {
-        res.status(400).json({ error: 'Missing required query param: query' });
-        return;
-    }
-    try {
-        const all = await listAllCloudFiles(prefix);
-        const q = query.toLowerCase();
-        const hits = all.filter((f) => f.name.toLowerCase().includes(q));
-        const truncated = hits.length > SEARCH_RESULT_LIMIT;
-        const files = truncated ? hits.slice(0, SEARCH_RESULT_LIMIT) : hits;
-        console.log(`GET /api/cloud/search, query: '${query}', prefix: '${prefix}', scanned ${all.length}, hits ${hits.length}`);
-        res.json({ total: hits.length, truncated, scanned: all.length, files });
-    }
-    catch (err) {
-        sendCloudError(res, err, 'Failed to search cloud files');
-    }
-});
-// ─── 文件夹（前缀）预估与递归删除 ──────────────────────────────
-// 合法文件夹前缀：非空、以 / 结尾、不含 ..，避免误删整桶或越权
-function requireFolderPrefix(req) {
-    const prefix = typeof req.query.prefix === 'string' ? req.query.prefix.trim() : '';
-    if (!prefix || !prefix.endsWith('/') || prefix.includes('..'))
-        return null;
-    return prefix;
-}
-cloudApi.get('/cloud/folder/count', async (req, res) => {
-    const prefix = requireFolderPrefix(req);
-    if (!prefix) {
-        res.status(400).json({ error: 'prefix 必须非空且以 / 结尾' });
-        return;
-    }
-    try {
-        const files = await listAllCloudFiles(prefix);
-        res.json({ count: files.length });
-    }
-    catch (err) {
-        sendCloudError(res, err, 'Failed to count cloud folder');
-    }
-});
-cloudApi.delete('/cloud/folder', async (req, res) => {
-    const prefix = requireFolderPrefix(req);
-    if (!prefix) {
-        res.status(400).json({ error: 'prefix 必须非空且以 / 结尾' });
-        return;
-    }
-    try {
-        const files = await listAllCloudFiles(prefix, 5);
-        if (files.length === 0) {
-            res.json({ deleted: 0, failed: 0, errors: [] });
-            return;
-        }
-        if (files.length > FOLDER_DELETE_LIMIT) {
-            res.status(400).json({
-                error: `该前缀下共 ${files.length} 个对象，超过单次删除上限 ${FOLDER_DELETE_LIMIT}，请缩小范围`,
-            });
-            return;
-        }
-        // 小并发逐个删除（AGC 无批量删除接口；并发过大会触发限流）
-        const failed = [];
-        const queue = files.map((f) => f.name);
-        let deleted = 0;
-        async function worker() {
-            for (;;) {
-                const key = queue.shift();
-                if (key === undefined)
-                    return;
-                try {
-                    await deleteCloudFile(key);
-                    deleted++;
-                }
-                catch {
-                    failed.push(key);
-                }
-            }
-        }
-        await Promise.all(Array.from({ length: Math.min(5, files.length) }, worker));
-        console.log(`DELETE /api/cloud/folder, prefix: ${prefix}, deleted ${deleted}, failed ${failed.length}`);
-        res.json({ deleted, failed: failed.length, errors: failed.slice(0, 10) });
-    }
-    catch (err) {
-        sendCloudError(res, err, 'Failed to delete cloud folder');
-    }
-});
-cloudApi.put('/cloud/file/rename', async (req, res) => {
-    const key = requireKey(req);
-    if (!key) {
-        res.status(400).json({ error: 'Missing required query param: key' });
-        return;
-    }
-    const name = typeof req.body?.name === 'string' ? req.body.name.trim() : '';
-    if (!name) {
-        res.status(400).json({ error: 'Missing required body field: name' });
-        return;
-    }
-    if (name.includes('/')) {
-        res.status(400).json({ error: '文件名不能包含 "/"' });
-        return;
-    }
-    const dir = key.includes('/') ? key.slice(0, key.lastIndexOf('/') + 1) : '';
-    const newKey = `${dir}${name}`;
-    if (newKey === key) {
-        res.status(400).json({ error: '新文件名与原文件名相同' });
-        return;
-    }
-    if (await cloudFileExists(newKey)) {
-        res.status(409).json({ error: `目标文件已存在:${newKey}` });
-        return;
-    }
-    try {
-        await renameCloudFile(key, newKey);
-        console.log(`PUT /api/cloud/file/rename, ${key} -> ${newKey}`);
-        res.json({ renamed: true, key: newKey });
-    }
-    catch (err) {
-        sendCloudError(res, err, 'Failed to rename cloud file');
-    }
-});
-cloudApi.get('/cloud/file/metadata', async (req, res) => {
-    const key = requireKey(req);
-    if (!key) {
-        res.status(400).json({ error: 'Missing required query param: key' });
-        return;
-    }
-    try {
-        const metadata = await getCloudFileMetadata(key);
-        res.json(metadata);
-    }
-    catch (err) {
-        sendCloudError(res, err, 'Failed to get cloud file metadata');
-    }
-});
-cloudApi.put('/cloud/file/metadata', async (req, res) => {
-    const key = requireKey(req);
-    if (!key) {
-        res.status(400).json({ error: 'Missing required query param: key' });
-        return;
-    }
-    try {
-        const body = (req.body ?? {});
-        const update = {};
-        const stringFields = [
-            'contentType',
-            'contentDisposition',
-            'contentEncoding',
-            'cacheControl',
-            'contentLanguage',
-        ];
-        for (const field of stringFields) {
-            const v = body[field];
-            if (typeof v === 'string' && v.trim())
-                update[field] = v.trim();
-        }
-        if (body.customMetadata && typeof body.customMetadata === 'object' && !Array.isArray(body.customMetadata)) {
-            const meta = {};
-            for (const [k, v] of Object.entries(body.customMetadata)) {
-                if (k.trim())
-                    meta[k.trim()] = String(v ?? '');
-            }
-            if (Object.keys(meta).length)
-                update.customMetadata = meta;
-        }
-        const metadata = await updateCloudFileMetadata(key, update);
-        console.log(`PUT /api/cloud/file/metadata, key: ${key}, updated fields:`, Object.keys(update));
-        res.json(metadata);
-    }
-    catch (err) {
-        sendCloudError(res, err, 'Failed to update cloud file metadata');
-    }
-});

package/server/dist/services/agcCredentials.js

@@ -1,117 +0,0 @@
-// AGC（华为云存储）凭证解析：按「环境变量 > 包内默认文件」优先级提供当前生效凭证。
-// 环境变量支持两种形态：AGC_CREDENTIALS_FILE 指向凭证 JSON 文件、AGC_CREDENTIALS_JSON 为内联 JSON 字符串；
-// 包内默认文件为随包发布的 assets/agc-apiclient.json，环境变量未设置时兜底。
-// 凭证在进程生命周期内不变，解析结果进程内缓存。
-import fs from 'fs/promises';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { CloudStorageError } from './cloudError.js';
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-/** 包内默认凭证文件路径（随包发布，作为最低优先级兜底） */
-const BUNDLED_CREDENTIALS_FILE = path.join(__dirname, '..', 'assets', 'agc-apiclient.json');
-/** 凭证必填字段（缺任一即视为无效凭证） */
-const REQUIRED_FIELDS = [
-    'client_id',
-    'client_secret',
-    'project_id',
-    'bucket_name',
-];
-/** 已成功解析的凭证缓存（凭证进程内不变，无需失效机制） */
-let cached = null;
-/**
- * 校验凭证对象是否包含全部必填字段。
- * @param cred 待校验的凭证对象
- * @returns 缺失字段说明；校验通过返回 null
- */
-function validateCredentials(cred) {
-    const missing = REQUIRED_FIELDS.filter((field) => !String(cred[field] ?? '').trim());
-    return missing.length > 0 ? `缺少必填字段: ${missing.join(', ')}` : null;
-}
-/**
- * 读取并解析 JSON 凭证文件。
- * @param filePath 凭证文件绝对路径
- * @returns 解析后的凭证对象
- * @throws 文件不存在或内容不是合法 JSON 时抛错
- */
-async function readCredentialsFile(filePath) {
-    const raw = await fs.readFile(filePath, 'utf-8');
-    return JSON.parse(raw);
-}
-/**
- * 从环境变量读取凭证（文件路径或内联 JSON 二选一）。
- * @returns 凭证对象；未设置相关环境变量时返回 null
- */
-async function resolveFromEnv() {
-    const filePath = process.env.AGC_CREDENTIALS_FILE?.trim();
-    if (filePath) {
-        return readCredentialsFile(path.resolve(filePath));
-    }
-    const inlineJson = process.env.AGC_CREDENTIALS_JSON?.trim();
-    if (inlineJson) {
-        return JSON.parse(inlineJson);
-    }
-    return null;
-}
-/**
- * 补齐凭证可选字段默认值（region 缺省按 CN 站点处理）。
- * @param cred 原始凭证对象（应已通过必填校验）
- * @returns 字段完整的凭证对象
- */
-function normalizeCredentials(cred) {
-    return {
-        type: cred.type ?? '',
-        developer_id: cred.developer_id ?? '',
-        project_id: cred.project_id ?? '',
-        client_id: cred.client_id ?? '',
-        client_secret: cred.client_secret ?? '',
-        configuration_version: cred.configuration_version ?? '',
-        region: cred.region?.trim() || 'CN',
-        bucket_name: cred.bucket_name ?? '',
-    };
-}
-/**
- * 按优先级解析凭证：环境变量 > 包内默认文件。
- * 已设置的来源优先级最高，即使其内容无效也不再降级（避免静默使用错误配置）。
- * @returns 成功时返回凭证与来源；全部来源不可用时返回错误说明
- */
-async function resolveCredentialSources() {
-    try {
-        const envCred = await resolveFromEnv();
-        if (envCred) {
-            const invalid = validateCredentials(envCred);
-            if (invalid)
-                return { error: `环境变量凭证无效: ${invalid}` };
-            return { cred: normalizeCredentials(envCred), source: 'env' };
-        }
-    }
-    catch (err) {
-        return { error: `环境变量凭证读取失败: ${err.message}` };
-    }
-    try {
-        const bundledCred = await readCredentialsFile(BUNDLED_CREDENTIALS_FILE);
-        const invalid = validateCredentials(bundledCred);
-        if (invalid)
-            return { error: `包内默认凭证无效: ${invalid}` };
-        return { cred: normalizeCredentials(bundledCred), source: 'default' };
-    }
-    catch {
-        return {
-            error: '未配置 AGC 凭证：请设置 AGC_CREDENTIALS_FILE 或 AGC_CREDENTIALS_JSON 环境变量（发布包不含凭证文件，源码运行时可用 src/assets/agc-apiclient.json 兜底）',
-        };
-    }
-}
-/**
- * 获取当前生效的 AGC 凭证（结果进程内缓存）。
- * @returns 当前生效的凭证对象
- * @throws 所有来源均不可用时抛出 CloudStorageError（503）
- */
-export async function resolveAgcCredentials() {
-    if (cached)
-        return cached.cred;
-    const result = await resolveCredentialSources();
-    if ('error' in result) {
-        throw new CloudStorageError(result.error, 503);
-    }
-    cached = { cred: result.cred, source: result.source };
-    return result.cred;
-}

package/server/dist/services/cloudError.js

@@ -1,15 +0,0 @@
-// 云端存储统一错误类型：携带 HTTP 状态码，供 AGC 凭证解析与存储操作共用。
-export class CloudStorageError extends Error {
-    /** 期望返回给调用方的 HTTP 状态码 */
-    status;
-    /**
-     * 创建云端存储错误。
-     * @param message 错误描述
-     * @param status HTTP 状态码，默认 502（上游网关错误）
-     */
-    constructor(message, status = 502) {
-        super(message);
-        this.name = 'CloudStorageError';
-        this.status = status;
-    }
-}