fwdcast 1.0.0

package/dist/scanner.js

@@ -0,0 +1,138 @@
+"use strict";
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanDirectory = scanDirectory;
+exports.calculateScanResult = calculateScanResult;
+exports.scanDirectoryShallow = scanDirectoryShallow;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * Recursively scans a directory and returns all entries.
+ * Symlinks are skipped.
+ *
+ * @param dirPath - The directory path to scan
+ * @param basePath - The base path for calculating relative paths (defaults to dirPath)
+ * @returns Array of DirectoryEntry objects
+ */
+async function scanDirectory(dirPath, basePath) {
+    const resolvedPath = path.resolve(dirPath);
+    const resolvedBase = basePath ? path.resolve(basePath) : resolvedPath;
+    const entries = [];
+    const items = await fs.readdir(resolvedPath, { withFileTypes: true });
+    for (const item of items) {
+        const absolutePath = path.join(resolvedPath, item.name);
+        // Skip symlinks as per requirements
+        if (item.isSymbolicLink()) {
+            continue;
+        }
+        const stat = await fs.stat(absolutePath);
+        const relativePath = path.relative(resolvedBase, absolutePath);
+        const entry = {
+            name: item.name,
+            relativePath,
+            absolutePath,
+            isDirectory: item.isDirectory(),
+            size: item.isDirectory() ? 0 : stat.size,
+            modifiedAt: stat.mtime,
+        };
+        entries.push(entry);
+        // Recursively scan subdirectories
+        if (item.isDirectory()) {
+            const subEntries = await scanDirectory(absolutePath, resolvedBase);
+            entries.push(...subEntries);
+        }
+    }
+    return entries;
+}
+/**
+ * Calculates the total size and counts from directory entries.
+ *
+ * @param entries - Array of DirectoryEntry objects
+ * @returns ScanResult with entries, totalSize, fileCount, and directoryCount
+ */
+function calculateScanResult(entries) {
+    let totalSize = 0;
+    let fileCount = 0;
+    let directoryCount = 0;
+    for (const entry of entries) {
+        if (entry.isDirectory) {
+            directoryCount++;
+        }
+        else {
+            fileCount++;
+            totalSize += entry.size;
+        }
+    }
+    return {
+        entries,
+        totalSize,
+        fileCount,
+        directoryCount,
+    };
+}
+/**
+ * Scans only the immediate children of a directory (non-recursive).
+ * Used for dynamic directory listings.
+ *
+ * @param dirPath - The directory path to scan
+ * @param basePath - The base path for calculating relative paths
+ * @returns Array of DirectoryEntry objects for immediate children only
+ */
+async function scanDirectoryShallow(dirPath, basePath) {
+    const resolvedPath = path.resolve(dirPath);
+    const resolvedBase = path.resolve(basePath);
+    const entries = [];
+    const items = await fs.readdir(resolvedPath, { withFileTypes: true });
+    for (const item of items) {
+        const absolutePath = path.join(resolvedPath, item.name);
+        // Skip symlinks as per requirements
+        if (item.isSymbolicLink()) {
+            continue;
+        }
+        const stat = await fs.stat(absolutePath);
+        const relativePath = path.relative(resolvedBase, absolutePath);
+        const entry = {
+            name: item.name,
+            relativePath,
+            absolutePath,
+            isDirectory: item.isDirectory(),
+            size: item.isDirectory() ? 0 : stat.size,
+            modifiedAt: stat.mtime,
+        };
+        entries.push(entry);
+    }
+    return entries;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

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

package/dist/tunnel-client.d.ts

@@ -0,0 +1,143 @@
+/**
+ * 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
+ */
+import { DirectoryEntry } from './scanner';
+/**
+ * Configuration for the tunnel client
+ */
+export interface TunnelClientConfig {
+    relayUrl: string;
+    basePath: string;
+    entries: DirectoryEntry[];
+    expiresAt: number;
+    onUrl?: (url: string) => void;
+    onExpired?: () => void;
+    onDisconnect?: () => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Result of a successful registration
+ */
+export interface RegistrationResult {
+    sessionId: string;
+    url: string;
+}
+/**
+ * TunnelClient manages the WebSocket connection to the relay server
+ * and handles incoming requests by serving files or directory listings.
+ */
+export declare class TunnelClient {
+    private ws;
+    private config;
+    private connected;
+    private sessionId;
+    private registrationPromise;
+    constructor(config: TunnelClientConfig);
+    /**
+     * Connect to the relay server and register the session.
+     * Returns the public URL for the shared directory.
+     *
+     * Requirements: 1.5, 1.6, 5.1
+     */
+    connect(): Promise<RegistrationResult>;
+    /**
+     * Disconnect from the relay server
+     */
+    disconnect(): void;
+    /**
+     * Check if the client is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Send the register message to the relay server
+     * Requirements: 5.1
+     */
+    private sendRegisterMessage;
+    /**
+     * Handle incoming WebSocket messages
+     */
+    private handleMessage;
+    /**
+     * Handle registration response from relay
+     * Requirements: 1.6
+     */
+    private handleRegistered;
+    /**
+     * Handle incoming request from relay
+     * Routes to file server or directory listing
+     *
+     * Requirements: 3.1, 3.2, 5.3, 5.4, 5.5
+     */
+    private handleRequest;
+    /**
+     * Handle session expired message
+     */
+    private handleExpired;
+    /**
+     * Serve a ZIP download of a directory
+     */
+    private serveZipDownload;
+    /**
+     * 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.
+     */
+    private serveDirectoryListing;
+    /**
+     * Stream a file to the relay
+     * Requirements: 3.6
+     */
+    private serveFile;
+    /**
+     * Stream file contents in chunks
+     * Requirements: 3.6, 5.4, 5.5
+     */
+    private streamFile;
+    /**
+     * Send an error response
+     */
+    private sendErrorResponse;
+    /**
+     * Send a response message
+     * Requirements: 5.3
+     */
+    sendResponse(id: string, status: number, headers: Record<string, string>): void;
+    /**
+     * Send a data message with base64 encoded chunk
+     * Requirements: 5.4
+     */
+    sendData(id: string, chunk: Buffer): void;
+    /**
+     * Send an end message
+     * Requirements: 5.5
+     */
+    sendEnd(id: string): void;
+    /**
+     * Send a message through the WebSocket
+     */
+    private send;
+    /**
+     * Normalize a request path
+     */
+    private normalizePath;
+    /**
+     * Get the content type for a file based on its extension
+     */
+    private getContentType;
+}
+/**
+ * Create and connect a tunnel client
+ * Convenience function for simple usage
+ */
+export declare function createTunnelClient(config: TunnelClientConfig): Promise<{
+    client: TunnelClient;
+    result: RegistrationResult;
+}>;
+//# sourceMappingURL=tunnel-client.d.ts.map

package/dist/tunnel-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-client.d.ts","sourceRoot":"","sources":["../src/tunnel-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyBH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAOD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,mBAAmB,CAGX;gBAEJ,MAAM,EAAE,kBAAkB;IAItC;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,kBAAkB,CAAC;IA6C5C;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;;;;OAKG;YACW,aAAa;IA6C3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;YACW,gBAAgB;IA4C9B;;;;;;OAMG;YACW,qBAAqB;IA2BnC;;;OAGG;YACW,SAAS;IAwBvB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAwBlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;;OAGG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAK/E;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKzC;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKzB;;OAEG;IACH,OAAO,CAAC,IAAI;IAMZ;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,OAAO,CAAC,cAAc;CAIvB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAI/D"}