filepizza-client 0.1.0

package/README.md

@@ -0,0 +1,20 @@
+<div align="center">
+  <img src="public/images/api_button.png" alt="FilePizza client API" width="50%" /><h3>Client API for integrating the FilePizza Server into your apps</h3>
+</div>
+
+# FilePizza Client API
+
+The `filepizza-client` API provides bindings to [FilePizza server](https://github.com/TeXlyre/filepizza-server). FilePizza is a React library for browser-to-browser file transfer using WebRTC. It allows you to integrate peer-to-peer file sharing functionality into your web applications.
+
+## Features
+
+- Direct browser-to-browser file transfers (no server storage)
+- Password protection for transfers
+- Support for single and multiple file transfers
+- Progress tracking and event notifications
+
+## Installation
+
+```bash
+npm install filepizza-client
+```

package/dist/download-helper.d.ts

@@ -0,0 +1,7 @@
+export declare class DownloadHelper {
+    private static isNewChromiumBased;
+    static downloadFile(fileName: string, data: Blob | Uint8Array): Promise<void>;
+    private static downloadWithFileSystemAccessAPI;
+    private static downloadWithBlobUrl;
+    static streamToUint8Array(stream: ReadableStream<Uint8Array>): Promise<Uint8Array>;
+}

package/dist/download-helper.js

@@ -0,0 +1,75 @@
+// src/utils/download-helper.ts
+export class DownloadHelper {
+    static isNewChromiumBased() {
+        return 'showSaveFilePicker' in window;
+    }
+    static async downloadFile(fileName, data) {
+        const blob = data instanceof Blob ? data : new Blob([data]);
+        if (this.isNewChromiumBased()) {
+            await this.downloadWithFileSystemAccessAPI(fileName, blob);
+        }
+        else {
+            this.downloadWithBlobUrl(fileName, blob);
+        }
+    }
+    static async downloadWithFileSystemAccessAPI(fileName, blob) {
+        try {
+            // @ts-ignore - TypeScript may not recognize showSaveFilePicker
+            const fileHandle = await window.showSaveFilePicker({
+                suggestedName: fileName,
+                types: [{
+                        description: 'Files',
+                        accept: { '*/*': ['.bin'] },
+                    }],
+            });
+            const writable = await fileHandle.createWritable();
+            await writable.write(blob);
+            await writable.close();
+        }
+        catch (error) {
+            console.error('Error downloading with File System Access API:', error);
+            // Fall back to blob URL method if the user cancels or there's an error
+            if (error.name !== 'AbortError') {
+                this.downloadWithBlobUrl(fileName, blob);
+            }
+        }
+    }
+    static downloadWithBlobUrl(fileName, blob) {
+        const url = URL.createObjectURL(blob);
+        const a = document.createElement('a');
+        a.href = url;
+        a.download = fileName;
+        a.style.display = 'none';
+        document.body.appendChild(a);
+        a.click();
+        setTimeout(() => {
+            document.body.removeChild(a);
+            URL.revokeObjectURL(url);
+        }, 100);
+    }
+    static async streamToUint8Array(stream) {
+        const reader = stream.getReader();
+        const chunks = [];
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                chunks.push(value);
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+        // Combine chunks
+        const totalLength = chunks.reduce((total, chunk) => total + chunk.length, 0);
+        const combinedChunks = new Uint8Array(totalLength);
+        let offset = 0;
+        for (const chunk of chunks) {
+            combinedChunks.set(chunk, offset);
+            offset += chunk.length;
+        }
+        return combinedChunks;
+    }
+}
+//# sourceMappingURL=download-helper.js.map

package/dist/download-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-helper.js","sourceRoot":"","sources":["../src/download-helper.ts"],"names":[],"mappings":"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"}

package/dist/event-emitter.d.ts

@@ -0,0 +1,24 @@
+import { EventEmitter as EventEmitterInterface } from './types';
+export declare class EventEmitter implements EventEmitterInterface {
+    private events;
+    /**
+     * Register an event listener
+     */
+    on(event: string, listener: (...args: any[]) => void): this;
+    /**
+     * Remove an event listener
+     */
+    off(event: string, listener: (...args: any[]) => void): this;
+    /**
+     * Emit an event
+     */
+    emit(event: string, ...args: any[]): boolean;
+    /**
+     * Register a one-time event listener
+     */
+    once(event: string, listener: (...args: any[]) => void): this;
+    /**
+     * Remove all listeners for an event
+     */
+    removeAllListeners(event?: string): this;
+}

package/dist/event-emitter.js

@@ -0,0 +1,64 @@
+export class EventEmitter {
+    constructor() {
+        this.events = {};
+    }
+    /**
+     * Register an event listener
+     */
+    on(event, listener) {
+        if (!this.events[event]) {
+            this.events[event] = [];
+        }
+        this.events[event].push(listener);
+        return this;
+    }
+    /**
+     * Remove an event listener
+     */
+    off(event, listener) {
+        if (this.events[event]) {
+            this.events[event] = this.events[event].filter(l => l !== listener);
+        }
+        return this;
+    }
+    /**
+     * Emit an event
+     */
+    emit(event, ...args) {
+        if (!this.events[event]) {
+            return false;
+        }
+        this.events[event].forEach(listener => {
+            try {
+                listener(...args);
+            }
+            catch (error) {
+                console.error(`Error in event listener for ${event}:`, error);
+            }
+        });
+        return true;
+    }
+    /**
+     * Register a one-time event listener
+     */
+    once(event, listener) {
+        const onceListener = (...args) => {
+            this.off(event, onceListener);
+            listener(...args);
+        };
+        return this.on(event, onceListener);
+    }
+    /**
+     * Remove all listeners for an event
+     */
+    removeAllListeners(event) {
+        if (event) {
+            delete this.events[event];
+        }
+        else {
+            this.events = {};
+        }
+        return this;
+    }
+}
+//# sourceMappingURL=event-emitter.js.map

package/dist/event-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.js","sourceRoot":"","sources":["../src/event-emitter.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IAAzB;QACU,WAAM,GAAoD,EAAE,CAAA;IAkEtE,CAAC;IAhEC;;OAEG;IACH,EAAE,CAAC,KAAa,EAAE,QAAkC;QAClD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;QACzB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACjC,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAa,EAAE,QAAkC;QACnD,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAA;QACrE,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAa,EAAE,GAAG,IAAW;QAChC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,KAAK,CAAA;QACd,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YACpC,IAAI,CAAC;gBACH,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAA;YACnB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,+BAA+B,KAAK,GAAG,EAAE,KAAK,CAAC,CAAA;YAC/D,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAa,EAAE,QAAkC;QACpD,MAAM,YAAY,GAAG,CAAC,GAAG,IAAW,EAAE,EAAE;YACtC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;YAC7B,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAA;QACnB,CAAC,CAAA;QAED,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;IACrC,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,KAAc;QAC/B,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC3B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;QAClB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/filepizza-downloader.d.ts

@@ -0,0 +1,159 @@
+import { EventEmitter } from './event-emitter';
+import { FileInfo, ProgressInfo, ConnectionStatus, CompletedFile } from './types';
+/**
+ * FilePizza Downloader - connects to FilePizza uploads
+ */
+export declare class FilePizzaDownloader extends EventEmitter {
+    private peer?;
+    private connection?;
+    private filePizzaServerUrl;
+    private filesInfo;
+    private currentFileIndex;
+    private currentFileBytesReceived;
+    private totalBytesReceived;
+    private totalBytes;
+    private status;
+    private fileStreams;
+    private isPasswordRequired;
+    private isPasswordInvalid;
+    private errorMessage?;
+    private iceServers?;
+    private completedFiles;
+    /**
+     * Create a new FilePizza downloader
+     * @param options Configuration options
+     */
+    constructor(options?: {
+        filePizzaServerUrl?: string;
+    });
+    /**
+     * Initialize the downloader
+     */
+    initialize(): Promise<void>;
+    /**
+     * Connect to an uploader using a FilePizza URL or slug
+     */
+    connect(urlOrSlug: string): Promise<boolean>;
+    /**
+     * Submit password for protected download
+     */
+    submitPassword(password: string): void;
+    /**
+     * Start downloading the files
+     */
+    startDownload(): Promise<void>;
+    /**
+     * Pause the download
+     */
+    pauseDownload(): void;
+    /**
+     * Resume the download
+     */
+    resumeDownload(): void;
+    /**
+     * Cancel the download
+     */
+    /**
+     * Cancel the download
+     */
+    cancelDownload(): void;
+    /**
+     * Get file information
+     */
+    getFileInfo(): FileInfo[];
+    /**
+     * Get download status
+     */
+    getStatus(): {
+        status: ConnectionStatus;
+        isPasswordRequired: boolean;
+        isPasswordInvalid: boolean;
+        errorMessage?: string;
+    };
+    /**
+     * Get progress information
+     */
+    getProgress(): ProgressInfo;
+    /**
+     * Extract slug from URL or use directly
+     */
+    private extractSlug;
+    /**
+     * Extract uploader peer IDs from the FilePizza server when multiple uploaders are present
+     */
+    private extractUploaderPeerIDs;
+    /**
+     * Look up the uploader's peer ID from the FilePizza server
+     */
+    private lookupUploaderPeerID;
+    /**
+     * Connect to a specific uploader by ID
+     */
+    getAvailableUploaders(urlOrSlug: string): Promise<string[]>;
+    /**
+     * Connect to a specific uploader by ID
+     */
+    connectToUploader(uploaderId: string): Promise<boolean>;
+    /**
+     * Get ICE servers from the FilePizza server
+     */
+    private getIceServers;
+    /**
+     * Connect directly to a peer
+     */
+    private connectToPeer;
+    /**
+     * Handle incoming data from uploader
+     */
+    private handleData;
+    /**
+     * Handle password required message
+     */
+    private handlePasswordRequired;
+    /**
+     * Handle file info message
+     */
+    private handleInfo;
+    /**
+     * Handle error message
+     */
+    private handleError;
+    /**
+     * Handle report message (channel reported for violation)
+     */
+    private handleReport;
+    /**
+     * Handle chunk message
+     */
+    private handleChunk;
+    /**
+     * Initialize streams for all files
+     */
+    private initializeFileStreams;
+    /**
+     * Store a completed file
+     */
+    private storeCompletedFile;
+    /**
+     * Download a completed file
+     */
+    downloadFile(fileName: string): Promise<void>;
+    /**
+     * Get completed files
+     */
+    getCompletedFiles(): CompletedFile[];
+    /**
+     * Download all completed files
+     */
+    downloadAllFiles(): Promise<void>;
+    /**
+     * Request the next file
+     */
+    private requestNextFile;
+    private getBrowserName;
+    private getBrowserVersion;
+    private getOSName;
+    private getOSVersion;
+    private getMobileVendor;
+    private getMobileModel;
+}