egos-transfer 0.0.8

package/dist/entity.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferErrorCode = exports.REQUEST_TIMEOUT = exports.MessageType = exports.ShareApiList = exports.PeerApiList = exports.PeerShareRoutes = exports.PeerRoutes = exports.NetworkQuality = exports.TransferPriority = exports.PeerAction = exports.PeerScope = exports.MessageStatus = exports.TRANSFER_CONSTANTS = exports.FILE_CHUNK_SIZE = exports.READY_STATE = void 0;
+var READY_STATE;
+(function (READY_STATE) {
+    READY_STATE[READY_STATE["CONNECTING_STATE"] = 0] = "CONNECTING_STATE";
+    READY_STATE[READY_STATE["OPEN_STATE"] = 1] = "OPEN_STATE";
+    READY_STATE[READY_STATE["CLOSING_STATE"] = 2] = "CLOSING_STATE";
+    READY_STATE[READY_STATE["CLOSED_STATE"] = 3] = "CLOSED_STATE";
+})(READY_STATE || (exports.READY_STATE = READY_STATE = {}));
+exports.FILE_CHUNK_SIZE = 1024 * 1024 * 2;
+// Awesome: Enhanced file transfer constants
+exports.TRANSFER_CONSTANTS = {
+    DEFAULT_CHUNK_SIZE: 1024 * 1024 * 2, // 16KB
+    MAX_CHUNK_SIZE: 2 * 1024 * 1024, // 5MB
+    MIN_CHUNK_SIZE: 64 * 1024, // 64KB
+    MAX_CONCURRENT_CHUNKS: 5,
+    DEFAULT_RETRY_ATTEMPTS: 3,
+    HEARTBEAT_INTERVAL: 30000, // 30s
+    CONNECTION_TIMEOUT: 10000, // 10s
+    TRANSFER_TIMEOUT: 300000, // 5min
+};
+var MessageStatus;
+(function (MessageStatus) {
+    MessageStatus["INITIALIZE"] = "initialize";
+    MessageStatus["PROCESSING"] = "processing";
+    MessageStatus["DONE"] = "done";
+    MessageStatus["FAILED"] = "failed";
+    MessageStatus["PAUSED"] = "paused";
+    MessageStatus["CANCELLED"] = "cancelled";
+    MessageStatus["TIMEOUT"] = "timeout";
+    MessageStatus["QUEUED"] = "queued";
+    MessageStatus["RESUMING"] = "resuming";
+    MessageStatus["VERIFYING"] = "verifying";
+})(MessageStatus || (exports.MessageStatus = MessageStatus = {}));
+var PeerScope;
+(function (PeerScope) {
+    PeerScope["RESPONSE"] = "RESPONSE";
+    PeerScope["REQUEST"] = "REQUEST";
+})(PeerScope || (exports.PeerScope = PeerScope = {}));
+var PeerAction;
+(function (PeerAction) {
+    PeerAction["SEND"] = "send";
+    PeerAction["RECEIVE"] = "receive";
+    PeerAction["DOWNLOAD"] = "download";
+    PeerAction["UPLOAD"] = "upload";
+    PeerAction["UPLOAD_RECEIVE"] = "upload@receive";
+    PeerAction["SYNC"] = "sync";
+    PeerAction["BACKUP"] = "backup";
+})(PeerAction || (exports.PeerAction = PeerAction = {}));
+// Awesome: Enhanced transfer priorities
+var TransferPriority;
+(function (TransferPriority) {
+    TransferPriority[TransferPriority["LOW"] = 1] = "LOW";
+    TransferPriority[TransferPriority["NORMAL"] = 2] = "NORMAL";
+    TransferPriority[TransferPriority["HIGH"] = 3] = "HIGH";
+    TransferPriority[TransferPriority["URGENT"] = 4] = "URGENT";
+})(TransferPriority || (exports.TransferPriority = TransferPriority = {}));
+// Awesome: Network quality levels
+var NetworkQuality;
+(function (NetworkQuality) {
+    NetworkQuality["POOR"] = "poor";
+    NetworkQuality["FAIR"] = "fair";
+    NetworkQuality["GOOD"] = "good";
+    NetworkQuality["EXCELLENT"] = "excellent";
+})(NetworkQuality || (exports.NetworkQuality = NetworkQuality = {}));
+var PeerRoutes;
+(function (PeerRoutes) {
+    PeerRoutes["MESSAGE"] = "/messages";
+    PeerRoutes["FILES"] = "/files";
+    PeerRoutes["CONTENT"] = "/files/content";
+    PeerRoutes["FILE_TRANSFER_START"] = "/files/transfer/start";
+    PeerRoutes["FILE_TRANSFER_META"] = "/files/transfer/meta";
+    PeerRoutes["MULTIPART"] = "/files/transfer/multipart";
+    PeerRoutes["FILE_TRANSFER_CHUNK"] = "/files/transfer/chunk";
+    PeerRoutes["FILE_TRANSFER_PAUSE"] = "/files/transfer/pause";
+    PeerRoutes["FILE_TRANSFER_RESUME"] = "/files/transfer/resume";
+    PeerRoutes["FILE_TRANSFER_CANCEL"] = "/files/transfer/cancel";
+    PeerRoutes["FILE_TRANSFER_COMPLETE"] = "/files/transfer/complete";
+    PeerRoutes["FILE_TRANSFER_FAILURE"] = "/files/transfer/failure";
+    PeerRoutes["INTERNAL_API_TOKEN"] = "/device/auth";
+    PeerRoutes["HEARTBEAT"] = "/heartbeat";
+    PeerRoutes["DISCOVER"] = "/discover";
+    PeerRoutes["FILE_MESSAGE"] = "/files/messages";
+    PeerRoutes["FILE_PREVIEW"] = "/files/preview";
+    PeerRoutes["FILE_SHARE_PREVIEW"] = "/files/share/preview";
+    // Awesome: New enhanced routes
+    PeerRoutes["DELETE_FILES"] = "/files/delete";
+    PeerRoutes["DEVICE_DISCOVER"] = "/devices/discover";
+    PeerRoutes["TRANSFER_PROGRESS"] = "/transfer/progress";
+    PeerRoutes["TRANSFER_PAUSE"] = "/transfer/pause";
+    PeerRoutes["TRANSFER_RESUME"] = "/transfer/resume";
+    PeerRoutes["TRANSFER_CANCEL"] = "/transfer/cancel";
+    PeerRoutes["NETWORK_STATUS"] = "/network/status";
+    PeerRoutes["DEVICE_INFO"] = "/device/info";
+    PeerRoutes["BATCH_TRANSFER"] = "/files/batch/transfer";
+    PeerRoutes["TRANSFER_QUEUE"] = "/transfer/queue";
+    PeerRoutes["FILE_SYNC"] = "/files/sync";
+    PeerRoutes["BACKUP_STATUS"] = "/backup/status";
+})(PeerRoutes || (exports.PeerRoutes = PeerRoutes = {}));
+exports.PeerShareRoutes = {
+    sharePreview: '/shares/preview',
+    shareFileList: '/shares/files',
+    shareFileMeta: '/shares/files/meta',
+    shareFileChunk: '/shares/files/chunk',
+    shareFilePreview: '/shares/files/preview',
+    shareFileTransitStart: '/shares/files/transmit/start',
+    sharePasswordVerify: '/shares/password/verify',
+    shareUploadStart: '/shares/upload/start',
+    shareUploadChunk: '/shares/upload/chunk',
+    shareUploadedFiles: '/shares/uploaded/files',
+    shareUploadComplete: '/shares/upload/complete',
+    // Awesome: Enhanced share routes
+    shareBatchDownload: '/shares/batch/download',
+    shareProgress: '/shares/progress',
+    shareCancel: '/shares/cancel',
+};
+exports.PeerApiList = [
+    PeerRoutes.MESSAGE,
+    PeerRoutes.FILE_MESSAGE,
+    PeerRoutes.FILE_PREVIEW,
+    PeerRoutes.FILE_TRANSFER_CHUNK,
+    PeerRoutes.FILE_TRANSFER_META,
+    PeerRoutes.FILE_TRANSFER_PAUSE,
+    PeerRoutes.FILE_TRANSFER_RESUME,
+    PeerRoutes.FILE_TRANSFER_CANCEL,
+    PeerRoutes.FILE_TRANSFER_COMPLETE,
+    PeerRoutes.FILE_TRANSFER_FAILURE,
+];
+exports.ShareApiList = [
+    exports.PeerShareRoutes.sharePreview,
+    exports.PeerShareRoutes.shareFileList,
+    exports.PeerShareRoutes.shareFileMeta,
+    exports.PeerShareRoutes.shareFileChunk,
+    exports.PeerShareRoutes.shareFilePreview,
+    exports.PeerShareRoutes.sharePasswordVerify,
+    exports.PeerShareRoutes.shareBatchDownload,
+];
+var MessageType;
+(function (MessageType) {
+    MessageType["FILE"] = "file";
+    MessageType["TEXT"] = "text";
+    MessageType["REQUEST"] = "request";
+    // Awesome: New message types
+    MessageType["PROGRESS"] = "progress";
+    MessageType["STATUS"] = "status";
+    MessageType["COMMAND"] = "command";
+    MessageType["NOTIFICATION"] = "notification";
+    MessageType["HEARTBEAT"] = "heartbeat";
+    MessageType["ERROR"] = "error";
+})(MessageType || (exports.MessageType = MessageType = {}));
+exports.REQUEST_TIMEOUT = 18000;
+// Awesome: Enhanced error types
+var TransferErrorCode;
+(function (TransferErrorCode) {
+    TransferErrorCode["NETWORK_TIMEOUT"] = "NETWORK_TIMEOUT";
+    TransferErrorCode["INSUFFICIENT_SPACE"] = "INSUFFICIENT_SPACE";
+    TransferErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    TransferErrorCode["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    TransferErrorCode["CHECKSUM_MISMATCH"] = "CHECKSUM_MISMATCH";
+    TransferErrorCode["DEVICE_OFFLINE"] = "DEVICE_OFFLINE";
+    TransferErrorCode["QUOTA_EXCEEDED"] = "QUOTA_EXCEEDED";
+    TransferErrorCode["UNSUPPORTED_FORMAT"] = "UNSUPPORTED_FORMAT";
+})(TransferErrorCode || (exports.TransferErrorCode = TransferErrorCode = {}));

package/dist/file-transfer.d.ts

@@ -0,0 +1,81 @@
+import { MessageTaskEntity, MetaData, PeerRequestPayload, TransferPrepareData, TransferProgress } from './interfaces';
+export type TransferWroteOptions = {
+    transId: number | string;
+    data: Uint8Array;
+    position: number;
+    chunkNumber: number;
+    processed: (number | undefined)[];
+    totalChunk: number;
+    parent?: {
+        parentId: number | string;
+        path: string;
+    };
+};
+export interface TaskService {
+    registerTask: (data: Omit<MessageTaskEntity, 'id'>) => Promise<MessageTaskEntity>;
+    getTaskByTransId: (transId: string) => Promise<MessageTaskEntity | undefined>;
+    updateTask: (transId: number | string, changed: Partial<MessageTaskEntity>) => Promise<MessageTaskEntity | undefined>;
+    write: (data: TransferWroteOptions) => Promise<boolean>;
+    verifyFile: (transId: number | string) => Promise<boolean>;
+    complete(transId: string): Promise<boolean>;
+    getCacheFilename(meta: MetaData, transId?: string): Promise<string>;
+    updateTaskProcess(transId: string, processed: number[]): Promise<void>;
+    enqueue(transId: string): void;
+    onProgress?: (transId: string, progress: TransferProgress) => void;
+}
+type RequestFn = (peerId: string, payload: PeerRequestPayload) => Promise<any>;
+export declare class FileTransfer {
+    protected chunkSize: number;
+    protected taskService: TaskService;
+    protected peerRequest: RequestFn | undefined;
+    protected progressCallbacks: Map<string, (progress: TransferProgress) => void>;
+    protected transferStats: Map<string, {
+        startTime: number;
+        lastUpdate: number;
+        bytesTransferred: number;
+    }>;
+    protected maxRetries: number;
+    protected adaptiveConcurrency: boolean;
+    protected maxConcurrentChunks: number;
+    constructor(taskService: TaskService);
+    getTaskService(): TaskService;
+    setRequest(req: RequestFn): void;
+    request(peerId: string, payload: PeerRequestPayload): Promise<any>;
+    onTransferProgress(transId: string, callback: (progress: TransferProgress) => void): void;
+    offTransferProgress(transId: string): void;
+    getTransferProgress(transId: string): Promise<TransferProgress | null>;
+    private updateProgress;
+    private retryWithBackoff;
+    private getOptimalConcurrency;
+    registerTask(data: Omit<MessageTaskEntity, 'id'>): Promise<MessageTaskEntity>;
+    /**
+     * start pull remote file
+     * @param peerId
+     * @param message
+     * @returns
+     */
+    prepare(peerId: string, payload: TransferPrepareData, execute?: boolean): Promise<boolean>;
+    start(transId: string, retry?: number): any;
+    fetchFileChunk(task: MessageTaskEntity, payload: {
+        chunkIndex: number;
+        totalChunk: number;
+        transId: string;
+    }): Promise<any>;
+    getTask(transId: string): Promise<MessageTaskEntity>;
+    updateTask(transId: number | string, changed: Partial<MessageTaskEntity>): Promise<boolean>;
+    done(task: MessageTaskEntity): Promise<void>;
+    pauseTransfer(transId: string): Promise<boolean>;
+    resumeTransfer(transId: string): Promise<boolean>;
+    cancelTransfer(transId: string): Promise<boolean>;
+    getTransferStats(transId: string): {
+        startTime: number;
+        lastUpdate: number;
+        bytesTransferred: number;
+    };
+    setAdaptiveConcurrency(enabled: boolean, maxChunks?: number): void;
+    setRetrySettings(maxRetries: number): void;
+    getActiveTransfers(): Promise<string[]>;
+    formatSpeed(bytesPerSecond: number): string;
+    formatTimeRemaining(seconds: number): string;
+}
+export {};