fwdcast 1.0.0

package/dist/tunnel-client.js

@@ -0,0 +1,428 @@
+"use strict";
+/**
+ * Tunnel Client Module
+ *
+ * Handles WebSocket connection to the relay server, message handling,
+ * and file streaming for the fwdcast CLI.
+ *
+ * Requirements: 1.5, 1.6, 3.1, 3.2, 3.6, 5.1, 5.3, 5.4, 5.5
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TunnelClient = void 0;
+exports.createTunnelClient = createTunnelClient;
+const ws_1 = __importDefault(require("ws"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const mime_types_1 = require("mime-types");
+const archiver_1 = __importDefault(require("archiver"));
+const protocol_1 = require("./protocol");
+const scanner_1 = require("./scanner");
+const html_generator_1 = require("./html-generator");
+/**
+ * Chunk size for file streaming (64KB)
+ */
+const CHUNK_SIZE = 64 * 1024;
+/**
+ * TunnelClient manages the WebSocket connection to the relay server
+ * and handles incoming requests by serving files or directory listings.
+ */
+class TunnelClient {
+    ws = null;
+    config;
+    connected = false;
+    sessionId = null;
+    registrationPromise = null;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Connect to the relay server and register the session.
+     * Returns the public URL for the shared directory.
+     *
+     * Requirements: 1.5, 1.6, 5.1
+     */
+    async connect() {
+        return new Promise((resolve, reject) => {
+            this.registrationPromise = { resolve, reject };
+            try {
+                this.ws = new ws_1.default(this.config.relayUrl);
+                this.ws.on('open', () => {
+                    this.connected = true;
+                    this.sendRegisterMessage();
+                });
+                this.ws.on('message', (data) => {
+                    this.handleMessage(data);
+                });
+                this.ws.on('close', () => {
+                    this.connected = false;
+                    // Only call onDisconnect if we were successfully registered
+                    // (not during initial connection attempts)
+                    if (!this.registrationPromise && this.config.onDisconnect) {
+                        this.config.onDisconnect();
+                    }
+                    // If still trying to register, reject the promise
+                    if (this.registrationPromise) {
+                        this.registrationPromise.reject(new Error('Connection closed during registration'));
+                        this.registrationPromise = null;
+                    }
+                });
+                this.ws.on('error', (error) => {
+                    if (this.registrationPromise) {
+                        this.registrationPromise.reject(error);
+                        this.registrationPromise = null;
+                    }
+                    if (this.config.onError) {
+                        this.config.onError(error);
+                    }
+                });
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Disconnect from the relay server
+     */
+    disconnect() {
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+            this.connected = false;
+        }
+    }
+    /**
+     * Check if the client is connected
+     */
+    isConnected() {
+        return this.connected && this.ws !== null && this.ws.readyState === ws_1.default.OPEN;
+    }
+    /**
+     * Send the register message to the relay server
+     * Requirements: 5.1
+     */
+    sendRegisterMessage() {
+        const message = (0, protocol_1.createRegisterMessage)(this.config.basePath, this.config.expiresAt);
+        this.send(message);
+    }
+    /**
+     * Handle incoming WebSocket messages
+     */
+    handleMessage(data) {
+        const messageStr = data.toString();
+        const message = (0, protocol_1.deserializeMessage)(messageStr);
+        if (!message) {
+            console.error('Received invalid message:', messageStr);
+            return;
+        }
+        if ((0, protocol_1.isRegisteredMessage)(message)) {
+            this.handleRegistered(message);
+        }
+        else if ((0, protocol_1.isRequestMessage)(message)) {
+            this.handleRequest(message);
+        }
+        else if ((0, protocol_1.isExpiredMessage)(message)) {
+            this.handleExpired();
+        }
+    }
+    /**
+     * Handle registration response from relay
+     * Requirements: 1.6
+     */
+    handleRegistered(message) {
+        // Store session ID for use in directory listings
+        this.sessionId = message.sessionId;
+        const result = {
+            sessionId: message.sessionId,
+            url: message.url,
+        };
+        if (this.registrationPromise) {
+            this.registrationPromise.resolve(result);
+            this.registrationPromise = null;
+        }
+        if (this.config.onUrl) {
+            this.config.onUrl(message.url);
+        }
+    }
+    /**
+     * Handle incoming request from relay
+     * Routes to file server or directory listing
+     *
+     * Requirements: 3.1, 3.2, 5.3, 5.4, 5.5
+     */
+    async handleRequest(message) {
+        const { id, method, path: requestPath } = message;
+        // Normalize the request path
+        const normalizedPath = this.normalizePath(requestPath);
+        // Check for special ZIP download request
+        if (normalizedPath === '__download__.zip' || normalizedPath.endsWith('/__download__.zip')) {
+            const dirPath = normalizedPath.replace('/__download__.zip', '').replace('__download__.zip', '');
+            await this.serveZipDownload(id, dirPath);
+            return;
+        }
+        const absolutePath = path.join(this.config.basePath, normalizedPath);
+        // Security check: ensure the path is within the base directory
+        const resolvedBase = path.resolve(this.config.basePath);
+        const resolvedPath = path.resolve(absolutePath);
+        if (!resolvedPath.startsWith(resolvedBase)) {
+            this.sendErrorResponse(id, 403, 'Forbidden');
+            return;
+        }
+        try {
+            // Check if path exists
+            const stat = await fs.promises.stat(resolvedPath);
+            if (stat.isDirectory()) {
+                // Serve directory listing
+                await this.serveDirectoryListing(id, normalizedPath);
+            }
+            else {
+                // Serve file
+                await this.serveFile(id, resolvedPath, method);
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                this.sendErrorResponse(id, 404, 'Not Found');
+            }
+            else {
+                console.error('Error handling request:', error);
+                this.sendErrorResponse(id, 500, 'Internal Server Error');
+            }
+        }
+    }
+    /**
+     * Handle session expired message
+     */
+    handleExpired() {
+        if (this.config.onExpired) {
+            this.config.onExpired();
+        }
+        this.disconnect();
+    }
+    /**
+     * Serve a ZIP download of a directory
+     */
+    async serveZipDownload(requestId, dirPath) {
+        try {
+            const absoluteDirPath = dirPath
+                ? path.join(this.config.basePath, dirPath)
+                : this.config.basePath;
+            // Get directory name for the ZIP filename
+            const dirName = dirPath ? path.basename(dirPath) : 'files';
+            // Send response headers (chunked transfer since we don't know size)
+            this.sendResponse(requestId, 200, {
+                'Content-Type': 'application/zip',
+                'Content-Disposition': `attachment; filename="${dirName}.zip"`,
+                'Transfer-Encoding': 'chunked',
+            });
+            // Create archive
+            const archive = (0, archiver_1.default)('zip', { zlib: { level: 5 } });
+            // Collect chunks and send them
+            archive.on('data', (chunk) => {
+                this.sendData(requestId, chunk);
+            });
+            archive.on('end', () => {
+                this.sendEnd(requestId);
+            });
+            archive.on('error', (err) => {
+                console.error('Archive error:', err);
+                this.sendEnd(requestId);
+            });
+            // Add directory contents to archive
+            archive.directory(absoluteDirPath, false);
+            // Finalize the archive
+            await archive.finalize();
+        }
+        catch (error) {
+            console.error('Error creating ZIP:', error);
+            this.sendErrorResponse(requestId, 500, 'Failed to create ZIP');
+        }
+    }
+    /**
+     * Serve a directory listing as HTML
+     * Requirements: 3.5
+     *
+     * Dynamically scans the directory on each request to reflect
+     * any files added/removed since the session started.
+     */
+    async serveDirectoryListing(requestId, dirPath) {
+        try {
+            // Dynamically scan the directory for current contents
+            const absoluteDirPath = path.join(this.config.basePath, dirPath);
+            const children = await (0, scanner_1.scanDirectoryShallow)(absoluteDirPath, this.config.basePath);
+            // Generate HTML with session ID for correct links
+            const html = (0, html_generator_1.generateDirectoryHtml)(children, dirPath, this.sessionId || undefined);
+            const htmlBuffer = Buffer.from(html, 'utf-8');
+            // Send response headers
+            this.sendResponse(requestId, 200, {
+                'Content-Type': 'text/html; charset=utf-8',
+                'Content-Length': htmlBuffer.length.toString(),
+            });
+            // Send data
+            this.sendData(requestId, htmlBuffer);
+            // Send end
+            this.sendEnd(requestId);
+        }
+        catch (error) {
+            console.error('Error serving directory listing:', error);
+            this.sendErrorResponse(requestId, 500, 'Internal Server Error');
+        }
+    }
+    /**
+     * Stream a file to the relay
+     * Requirements: 3.6
+     */
+    async serveFile(requestId, filePath, method) {
+        const stat = await fs.promises.stat(filePath);
+        const contentType = this.getContentType(filePath);
+        // Send response headers
+        this.sendResponse(requestId, 200, {
+            'Content-Type': contentType,
+            'Content-Length': stat.size.toString(),
+        });
+        // For HEAD requests, don't send body
+        if (method === 'HEAD') {
+            this.sendEnd(requestId);
+            return;
+        }
+        // Stream file contents
+        await this.streamFile(requestId, filePath);
+    }
+    /**
+     * Stream file contents in chunks
+     * Requirements: 3.6, 5.4, 5.5
+     */
+    streamFile(requestId, filePath) {
+        return new Promise((resolve, reject) => {
+            const readStream = fs.createReadStream(filePath, {
+                highWaterMark: CHUNK_SIZE,
+            });
+            readStream.on('data', (chunk) => {
+                const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+                this.sendData(requestId, buffer);
+            });
+            readStream.on('end', () => {
+                this.sendEnd(requestId);
+                resolve();
+            });
+            readStream.on('error', (error) => {
+                console.error('Error streaming file:', error);
+                this.sendEnd(requestId);
+                reject(error);
+            });
+        });
+    }
+    /**
+     * Send an error response
+     */
+    sendErrorResponse(requestId, status, message) {
+        const html = `<!DOCTYPE html>
+<html>
+<head><title>${status} ${message}</title></head>
+<body><h1>${status} ${message}</h1></body>
+</html>`;
+        const htmlBuffer = Buffer.from(html, 'utf-8');
+        this.sendResponse(requestId, status, {
+            'Content-Type': 'text/html; charset=utf-8',
+            'Content-Length': htmlBuffer.length.toString(),
+        });
+        this.sendData(requestId, htmlBuffer);
+        this.sendEnd(requestId);
+    }
+    /**
+     * Send a response message
+     * Requirements: 5.3
+     */
+    sendResponse(id, status, headers) {
+        const message = (0, protocol_1.createResponseMessage)(id, status, headers);
+        this.send(message);
+    }
+    /**
+     * Send a data message with base64 encoded chunk
+     * Requirements: 5.4
+     */
+    sendData(id, chunk) {
+        const message = (0, protocol_1.createDataMessage)(id, chunk.toString('base64'));
+        this.send(message);
+    }
+    /**
+     * Send an end message
+     * Requirements: 5.5
+     */
+    sendEnd(id) {
+        const message = (0, protocol_1.createEndMessage)(id);
+        this.send(message);
+    }
+    /**
+     * Send a message through the WebSocket
+     */
+    send(message) {
+        if (this.ws && this.ws.readyState === ws_1.default.OPEN) {
+            this.ws.send((0, protocol_1.serializeMessage)(message));
+        }
+    }
+    /**
+     * Normalize a request path
+     */
+    normalizePath(requestPath) {
+        // Remove leading slash and decode URI components
+        let normalized = decodeURIComponent(requestPath).replace(/^\/+/, '');
+        // Remove trailing slash
+        normalized = normalized.replace(/\/+$/, '');
+        return normalized;
+    }
+    /**
+     * Get the content type for a file based on its extension
+     */
+    getContentType(filePath) {
+        const mimeType = (0, mime_types_1.lookup)(filePath);
+        return mimeType || 'application/octet-stream';
+    }
+}
+exports.TunnelClient = TunnelClient;
+/**
+ * Create and connect a tunnel client
+ * Convenience function for simple usage
+ */
+async function createTunnelClient(config) {
+    const client = new TunnelClient(config);
+    const result = await client.connect();
+    return { client, result };
+}
+//# sourceMappingURL=tunnel-client.js.map

package/dist/tunnel-client.js.map

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

package/dist/validator.d.ts

@@ -0,0 +1,53 @@
+import { DirectoryEntry, ScanResult } from './scanner';
+/**
+ * Default size limits for validation
+ */
+export declare const DEFAULT_MAX_TOTAL_SIZE: number;
+export declare const DEFAULT_MAX_FILE_SIZE: number;
+/**
+ * Validation error types
+ */
+export type ValidationErrorType = 'total_size_exceeded' | 'file_size_exceeded';
+/**
+ * Details about a validation error
+ */
+export interface ValidationError {
+    type: ValidationErrorType;
+    message: string;
+    /** The file that caused the error (for file_size_exceeded) */
+    file?: DirectoryEntry;
+    /** The actual size that exceeded the limit */
+    actualSize: number;
+    /** The limit that was exceeded */
+    limit: number;
+}
+/**
+ * Result of validating a scan result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+/**
+ * Options for validation
+ */
+export interface ValidationOptions {
+    maxTotalSize?: number;
+    maxFileSize?: number;
+}
+/**
+ * Validates a scan result against size limits.
+ *
+ * @param scanResult - The scan result to validate
+ * @param options - Optional size limits (defaults to 100MB total, 50MB per file)
+ * @returns ValidationResult indicating if the scan is valid and any errors
+ */
+export declare function validateScanResult(scanResult: ScanResult, options?: ValidationOptions): ValidationResult;
+/**
+ * Formats a size in bytes to a human-readable string.
+ *
+ * @param bytes - Size in bytes
+ * @returns Human-readable size string (e.g., "1.5 MB")
+ */
+export declare function formatSize(bytes: number): string;
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAAoB,CAAC;AACxD,eAAO,MAAM,qBAAqB,QAAmB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,GAAG,oBAAoB,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAgClB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQhD"}

package/dist/validator.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_MAX_FILE_SIZE = exports.DEFAULT_MAX_TOTAL_SIZE = void 0;
+exports.validateScanResult = validateScanResult;
+exports.formatSize = formatSize;
+/**
+ * Default size limits for validation
+ */
+exports.DEFAULT_MAX_TOTAL_SIZE = 100 * 1024 * 1024; // 100 MB
+exports.DEFAULT_MAX_FILE_SIZE = 50 * 1024 * 1024; // 50 MB
+/**
+ * Validates a scan result against size limits.
+ *
+ * @param scanResult - The scan result to validate
+ * @param options - Optional size limits (defaults to 100MB total, 50MB per file)
+ * @returns ValidationResult indicating if the scan is valid and any errors
+ */
+function validateScanResult(scanResult, options = {}) {
+    const maxTotalSize = options.maxTotalSize ?? exports.DEFAULT_MAX_TOTAL_SIZE;
+    const maxFileSize = options.maxFileSize ?? exports.DEFAULT_MAX_FILE_SIZE;
+    const errors = [];
+    // Check each file against the individual file size limit
+    for (const entry of scanResult.entries) {
+        if (!entry.isDirectory && entry.size > maxFileSize) {
+            errors.push({
+                type: 'file_size_exceeded',
+                message: `File "${entry.relativePath}" exceeds the ${formatSize(maxFileSize)} limit (${formatSize(entry.size)})`,
+                file: entry,
+                actualSize: entry.size,
+                limit: maxFileSize,
+            });
+        }
+    }
+    // Check total size against the total size limit
+    if (scanResult.totalSize > maxTotalSize) {
+        errors.push({
+            type: 'total_size_exceeded',
+            message: `Total directory size ${formatSize(scanResult.totalSize)} exceeds the ${formatSize(maxTotalSize)} limit`,
+            actualSize: scanResult.totalSize,
+            limit: maxTotalSize,
+        });
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Formats a size in bytes to a human-readable string.
+ *
+ * @param bytes - Size in bytes
+ * @returns Human-readable size string (e.g., "1.5 MB")
+ */
+function formatSize(bytes) {
+    if (bytes < 1024) {
+        return `${bytes} B`;
+    }
+    else if (bytes < 1024 * 1024) {
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    }
+    else {
+        return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":";;;AAkDA,gDAmCC;AAQD,gCAQC;AAnGD;;GAEG;AACU,QAAA,sBAAsB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,SAAS;AACrD,QAAA,qBAAqB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAG,QAAQ;AAqCjE;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAChC,UAAsB,EACtB,UAA6B,EAAE;IAE/B,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,8BAAsB,CAAC;IACpE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,6BAAqB,CAAC;IACjE,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,yDAAyD;IACzD,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,GAAG,WAAW,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,SAAS,KAAK,CAAC,YAAY,iBAAiB,UAAU,CAAC,WAAW,CAAC,WAAW,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;gBAChH,IAAI,EAAE,KAAK;gBACX,UAAU,EAAE,KAAK,CAAC,IAAI;gBACtB,KAAK,EAAE,WAAW;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,IAAI,UAAU,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,wBAAwB,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,gBAAgB,UAAU,CAAC,YAAY,CAAC,QAAQ;YACjH,UAAU,EAAE,UAAU,CAAC,SAAS;YAChC,KAAK,EAAE,YAAY;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,GAAG,IAAI,EAAE,CAAC;QACjB,OAAO,GAAG,KAAK,IAAI,CAAC;IACtB,CAAC;SAAM,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;QAC/B,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IACpD,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "fwdcast",
+  "version": "1.0.0",
+  "description": "Temporary file sharing - stream local files as a public website without uploading",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "fwdcast": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "scripts/**/*"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prebuild": "rm -rf dist",
+    "prepublishOnly": "npm run build",
+    "postinstall": "node scripts/postinstall.js || true",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "test": "vitest --run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "file-sharing",
+    "tunnel",
+    "temporary",
+    "streaming",
+    "share",
+    "local",
+    "websocket",
+    "cli",
+    "npx"
+  ],
+  "author": "vamsiy",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vamsiy78/fwdcast.git"
+  },
+  "homepage": "https://github.com/vamsiy78/fwdcast#readme",
+  "bugs": {
+    "url": "https://github.com/vamsiy78/fwdcast/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "archiver": "^7.0.1",
+    "commander": "^12.1.0",
+    "mime-types": "^3.0.2",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/archiver": "^7.0.0",
+    "@types/mime-types": "^3.0.1",
+    "@types/node": "^22.10.0",
+    "@types/ws": "^8.5.13",
+    "fast-check": "^3.23.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+// Only show message for global installs
+if (!process.env.npm_config_global) {
+  process.exit(0);
+}
+
+console.log(`
+┌─────────────────────────────────────────────────┐
+│                                                 │
+│   📡 fwdcast installed successfully!            │
+│                                                 │
+│   Quick start:                                  │
+│     fwdcast              Share current folder   │
+│     fwdcast ~/Downloads  Share specific folder  │
+│                                                 │
+│   Help:                                         │
+│     fwdcast --help                              │
+│                                                 │
+│   GitHub: github.com/vamsiy78/fwdcast           │
+│                                                 │
+└─────────────────────────────────────────────────┘
+`);