syncast-cli 0.1.0 → 0.1.2

package/dist/file-transfer.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 文件传输管理器
+ *
+ * 处理文件的分片传输（上传和下载）
+ */
+import { type ErrorCode } from "local-sync-protocol";
+export interface FileTransferEvents {
+    onChunk: (requestId: string, index: number, total: number, data: string) => void;
+    onComplete: (requestId: string, path: string) => void;
+    /** 文件保存成功（接收文件时） */
+    onFileSaved: (requestId: string, path: string) => void;
+    onError: (requestId: string, code: ErrorCode, message: string) => void;
+    /** 开始接收文件（用于通知 FileWatcher 忽略） */
+    onReceiveStart?: (relativePath: string) => void;
+    /** 接收完成（用于通知 FileWatcher 可以处理了） */
+    onReceiveEnd?: (relativePath: string) => void;
+}
+export declare class FileTransferManager {
+    private rootPath;
+    private events;
+    private pendingReceives;
+    private activeSends;
+    constructor(rootPath: string, events: FileTransferEvents);
+    /**
+     * 发送文件到前端（分片）
+     */
+    sendFile(requestId: string, relativePath: string): Promise<void>;
+    /**
+     * 准备接收文件
+     */
+    receiveFile(requestId: string, relativePath: string, totalChunks: number, fileSize: number): Promise<void>;
+    /**
+     * 处理接收到的分片
+     */
+    handleChunk(requestId: string, index: number, base64Data: string): Promise<void>;
+    /**
+     * 处理传输完成信号
+     */
+    handleTransferComplete(requestId: string): Promise<void>;
+    /**
+     * 组装分片并保存文件
+     */
+    private assembleAndSave;
+    /**
+     * 取消传输
+     */
+    cancelTransfer(requestId: string): Promise<void>;
+    /**
+     * 获取待处理的传输数量
+     */
+    getPendingCount(): number;
+}

package/dist/file-watcher.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 文件系统监听器
+ *
+ * 使用 chokidar 监听同步文件夹的变化，
+ * 过滤 config.json 和不支持的文件类型。
+ */
+import { type FileInfo, type FolderInfo, type FolderSnapshot } from "local-sync-protocol";
+export interface FileWatcherEvents {
+    onFileAdded: (file: FileInfo) => void;
+    onFilesAdded: (files: FileInfo[]) => void;
+    onFileRemoved: (path: string) => void;
+    onFolderAdded: (folder: FolderInfo) => void;
+    onFolderRemoved: (path: string) => void;
+}
+export declare class FileWatcher {
+    private rootPath;
+    private watcher;
+    private events;
+    private fileCollector;
+    private processingFiles;
+    constructor(rootPath: string, events: FileWatcherEvents);
+    /**
+     * 扫描文件夹，返回快照
+     */
+    scan(): Promise<FolderSnapshot>;
+    /**
+     * 递归扫描目录
+     */
+    private scanDirectory;
+    /**
+     * 获取文件信息
+     */
+    private getFileInfo;
+    /**
+     * 获取文件夹信息
+     */
+    private getFolderInfo;
+    /**
+     * 启动监听
+     */
+    start(): Promise<void>;
+    /**
+     * 停止监听
+     */
+    stop(): Promise<void>;
+    /**
+     * 处理文件新增
+     */
+    private handleFileAdd;
+    /**
+     * 处理文件删除
+     */
+    private handleFileRemove;
+    /**
+     * 处理文件夹新增
+     */
+    private handleDirAdd;
+    /**
+     * 处理文件夹删除
+     */
+    private handleDirRemove;
+    /**
+     * 写入 config.json 并设置隐藏属性
+     */
+    writeConfig(relativePath: string, assetId?: string, folderId?: string, originalFilename?: string, md5?: string): Promise<void>;
+    /**
+     * 设置文件隐藏属性
+     * macOS: 使用 chflags hidden
+     * Windows: 使用 attrib +h (如果需要支持)
+     */
+    private setHiddenAttribute;
+    /**
+     * 标记文件正在处理（防止重复）
+     */
+    markProcessing(relativePath: string): void;
+    /**
+     * 取消标记
+     */
+    unmarkProcessing(relativePath: string): void;
+}

package/dist/index.d.ts

@@ -1,13 +1,8 @@
 /**
  * Syncast CLI - Main library exports
  */
-export interface ServerOptions {
-    port?: number;
-    host?: string;
-}
-export interface Server {
-    start(): Promise<void>;
-    stop(): Promise<void>;
-}
-export declare function createServer(options?: ServerOptions): Promise<Server>;
+export { SyncServer, type SyncServerOptions, type SyncServerEvents } from "./ws-server.js";
+export { FileWatcher, type FileWatcherEvents } from "./file-watcher.js";
+export { FileTransferManager, type FileTransferEvents } from "./file-transfer.js";
+export { DEFAULT_PORT, DEFAULT_HOST, PROTOCOL_VERSION, type FileInfo, type FolderInfo, type FolderSnapshot, } from "local-sync-protocol";
 export { runCli } from "./cli.js";