fwdcast 1.0.0

package/dist/index.js

@@ -0,0 +1,229 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * fwdcast CLI - Temporary file sharing tool
+ * Streams local files as a public website without uploading them
+ *
+ * Requirements: 1.1, 1.5, 1.6, 7.1, 7.2, 7.4
+ */
+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 });
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const scanner_1 = require("./scanner");
+const validator_1 = require("./validator");
+const tunnel_client_1 = require("./tunnel-client");
+/**
+ * Default relay server URL
+ */
+const DEFAULT_RELAY_URL = 'wss://fwdcast.publicvm.com/ws';
+/**
+ * Session duration in milliseconds (30 minutes)
+ */
+const SESSION_DURATION_MS = 30 * 60 * 1000;
+/**
+ * Maximum number of connection retry attempts
+ * Requirement: 7.4
+ */
+const MAX_RETRY_ATTEMPTS = 10;
+/**
+ * Delay between retry attempts in milliseconds
+ */
+const RETRY_DELAY_MS = 500;
+/**
+ * Sleep for a specified number of milliseconds
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Main CLI entry point
+ */
+async function main() {
+    const program = new commander_1.Command();
+    program
+        .name('fwdcast')
+        .description('Temporary file sharing - stream local files as a public website without uploading')
+        .version('1.0.0')
+        .argument('[path]', 'Directory to share (default: current directory)', '.')
+        .option('-r, --relay <url>', 'Custom relay server URL', DEFAULT_RELAY_URL)
+        .addHelpText('after', `
+Examples:
+  $ fwdcast                    Share current directory
+  $ fwdcast .                  Share current directory  
+  $ fwdcast ~/Downloads        Share Downloads folder
+  $ fwdcast ./project          Share a specific folder
+
+Limits:
+  • Max total size: 500 MB
+  • Max file size: 100 MB
+  • Session duration: 30 minutes
+  • Concurrent viewers: 3
+
+More info: https://github.com/vamsiy78/fwdcast
+`)
+        .action(async (dirPath, options) => {
+        await runShare(dirPath, options.relay);
+    });
+    await program.parseAsync(process.argv);
+}
+/**
+ * Run the file sharing process
+ *
+ * Requirements: 1.1, 1.5, 1.6, 7.1, 7.2
+ */
+async function runShare(dirPath, relayUrl) {
+    const absolutePath = path.resolve(dirPath);
+    console.log(`\nScanning directory: ${absolutePath}\n`);
+    // Step 1: Scan the directory (Requirement 1.1)
+    let entries;
+    try {
+        entries = await (0, scanner_1.scanDirectory)(absolutePath);
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            console.error(`Error: Directory not found: ${absolutePath}`);
+        }
+        else if (err.code === 'EACCES') {
+            console.error(`Error: Permission denied: ${absolutePath}`);
+        }
+        else {
+            console.error(`Error scanning directory: ${err.message}`);
+        }
+        process.exit(1);
+    }
+    // Step 2: Calculate scan result (Requirement 1.2)
+    const scanResult = (0, scanner_1.calculateScanResult)(entries);
+    console.log(`  Files: ${scanResult.fileCount}`);
+    console.log(`  Directories: ${scanResult.directoryCount}`);
+    console.log(`  Total size: ${(0, validator_1.formatSize)(scanResult.totalSize)}\n`);
+    // Step 3: Validate size limits (Requirements 1.3, 1.4)
+    const validation = (0, validator_1.validateScanResult)(scanResult);
+    if (!validation.valid) {
+        console.error('Error: Cannot share directory\n');
+        for (const error of validation.errors) {
+            if (error.type === 'total_size_exceeded') {
+                console.error(`  - Total size (${(0, validator_1.formatSize)(error.actualSize)}) exceeds the ${(0, validator_1.formatSize)(error.limit)} limit`);
+            }
+            else if (error.type === 'file_size_exceeded') {
+                console.error(`  - File "${error.file?.relativePath}" (${(0, validator_1.formatSize)(error.actualSize)}) exceeds the ${(0, validator_1.formatSize)(error.limit)} per-file limit`);
+            }
+            else {
+                console.error(`  - ${error.message}`);
+            }
+        }
+        console.error('\nTip: Remove large files or split your share into smaller directories.\n');
+        process.exit(1);
+    }
+    // Step 4: Connect to relay server with retry logic (Requirements 1.5, 7.4)
+    console.log(`Connecting to relay server...`);
+    const expiresAt = Date.now() + SESSION_DURATION_MS;
+    const config = {
+        relayUrl,
+        basePath: absolutePath,
+        entries,
+        expiresAt,
+        onUrl: (url) => {
+            console.log(`\nShare active. URL:\n`);
+            console.log(`  ${url}\n`);
+            console.log(`Session expires in 30 minutes.`);
+            console.log(`Press Ctrl+C to stop sharing.\n`);
+        },
+        onExpired: () => {
+            // Requirement 7.2
+            console.log('\nSession expired after 30 minutes.');
+            console.log('Files are no longer accessible.\n');
+            process.exit(0);
+        },
+        onDisconnect: () => {
+            // Requirement 7.1
+            console.log('\nDisconnected from relay server.');
+            console.log('Files are no longer accessible.\n');
+            process.exit(0);
+        },
+        onError: (error) => {
+            // Requirement 7.4
+            console.error(`\nConnection error: ${error.message}\n`);
+        },
+    };
+    let client = null;
+    let lastError = null;
+    // Retry connection up to MAX_RETRY_ATTEMPTS times (Requirement 7.4)
+    for (let attempt = 1; attempt <= MAX_RETRY_ATTEMPTS; attempt++) {
+        try {
+            client = new tunnel_client_1.TunnelClient(config);
+            await client.connect();
+            lastError = null;
+            break; // Connection successful
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt < MAX_RETRY_ATTEMPTS) {
+                console.log(`  Attempt ${attempt}/${MAX_RETRY_ATTEMPTS} failed: ${lastError.message}`);
+                console.log(`  Retrying...\n`);
+                await sleep(RETRY_DELAY_MS);
+            }
+        }
+    }
+    if (lastError) {
+        // Requirement 7.4 - All retries failed
+        console.error(`\nFailed to connect after ${MAX_RETRY_ATTEMPTS} attempts.`);
+        console.error(`Last error: ${lastError.message}`);
+        console.error(`\nPlease check:`);
+        console.error(`  - Your internet connection`);
+        console.error(`  - The relay server (${relayUrl}) is accessible`);
+        console.error(`  - No firewall is blocking WebSocket connections\n`);
+        process.exit(1);
+    }
+    // Handle graceful shutdown on Ctrl+C
+    const shutdown = () => {
+        console.log('\n\nStopping file share...');
+        if (client) {
+            client.disconnect();
+        }
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    // Keep the process running
+    await new Promise(() => { });
+}
+// Run the CLI
+main().catch((error) => {
+    console.error('Unexpected error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Tunnel Protocol Types and Validation
+ *
+ * Defines the WebSocket-based protocol for communication between
+ * the CLI and Relay Server.
+ *
+ * Requirements: 5.1, 5.2, 5.3, 5.4, 5.5
+ */
+/**
+ * CLI → Relay: Registration message
+ * Sent when CLI connects to register a new session
+ * Requirements: 5.1
+ */
+export interface RegisterMessage {
+    type: 'register';
+    path: string;
+    expiresAt: number;
+}
+/**
+ * Relay → CLI: Registration response
+ * Sent after successful session creation
+ * Requirements: 5.1
+ */
+export interface RegisteredMessage {
+    type: 'registered';
+    sessionId: string;
+    url: string;
+}
+/**
+ * Relay → CLI: Forward HTTP request
+ * Sent when a viewer requests a resource
+ * Requirements: 5.2
+ */
+export interface RequestMessage {
+    type: 'request';
+    id: string;
+    method: string;
+    path: string;
+}
+/**
+ * CLI → Relay: Response headers
+ * Sent to start the response for a request
+ * Requirements: 5.3
+ */
+export interface ResponseMessage {
+    type: 'response';
+    id: string;
+    status: number;
+    headers: Record<string, string>;
+}
+/**
+ * CLI → Relay: Response body chunk
+ * Sent for each chunk of response data
+ * Requirements: 5.4
+ */
+export interface DataMessage {
+    type: 'data';
+    id: string;
+    chunk: string;
+}
+/**
+ * CLI → Relay: Response complete
+ * Sent when response streaming is finished
+ * Requirements: 5.5
+ */
+export interface EndMessage {
+    type: 'end';
+    id: string;
+}
+/**
+ * Relay → CLI: Session expired
+ * Sent when the session has expired
+ */
+export interface ExpiredMessage {
+    type: 'expired';
+}
+/**
+ * Union type of all protocol messages
+ */
+export type ProtocolMessage = RegisterMessage | RegisteredMessage | RequestMessage | ResponseMessage | DataMessage | EndMessage | ExpiredMessage;
+/**
+ * Message type literals for type guards
+ */
+export type MessageType = ProtocolMessage['type'];
+export declare function isRegisterMessage(msg: unknown): msg is RegisterMessage;
+export declare function isRegisteredMessage(msg: unknown): msg is RegisteredMessage;
+export declare function isRequestMessage(msg: unknown): msg is RequestMessage;
+export declare function isResponseMessage(msg: unknown): msg is ResponseMessage;
+export declare function isDataMessage(msg: unknown): msg is DataMessage;
+export declare function isEndMessage(msg: unknown): msg is EndMessage;
+export declare function isExpiredMessage(msg: unknown): msg is ExpiredMessage;
+export declare function isProtocolMessage(msg: unknown): msg is ProtocolMessage;
+/**
+ * Serialize a protocol message to JSON string
+ */
+export declare function serializeMessage(msg: ProtocolMessage): string;
+/**
+ * Deserialize a JSON string to a protocol message
+ * Returns null if the message is invalid
+ */
+export declare function deserializeMessage(data: string): ProtocolMessage | null;
+export declare function createRegisterMessage(path: string, expiresAt: number): RegisterMessage;
+export declare function createRegisteredMessage(sessionId: string, url: string): RegisteredMessage;
+export declare function createRequestMessage(id: string, method: string, path: string): RequestMessage;
+export declare function createResponseMessage(id: string, status: number, headers: Record<string, string>): ResponseMessage;
+export declare function createDataMessage(id: string, chunk: string): DataMessage;
+export declare function createEndMessage(id: string): EndMessage;
+export declare function createExpiredMessage(): ExpiredMessage;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,eAAe,GACf,WAAW,GACX,UAAU,GACV,cAAc,CAAC;AAEnB;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAMlD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,eAAe,CAQtE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,iBAAiB,CAQ1E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CASpE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,eAAe,CAUtE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAQ9D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAO5D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAMpE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,eAAe,CAUtE;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAUvE;AAMD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CAEtF;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAEzF;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAE7F;AAED,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,eAAe,CAEjB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAExE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAEvD;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/dist/protocol.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * Tunnel Protocol Types and Validation
+ *
+ * Defines the WebSocket-based protocol for communication between
+ * the CLI and Relay Server.
+ *
+ * Requirements: 5.1, 5.2, 5.3, 5.4, 5.5
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRegisterMessage = isRegisterMessage;
+exports.isRegisteredMessage = isRegisteredMessage;
+exports.isRequestMessage = isRequestMessage;
+exports.isResponseMessage = isResponseMessage;
+exports.isDataMessage = isDataMessage;
+exports.isEndMessage = isEndMessage;
+exports.isExpiredMessage = isExpiredMessage;
+exports.isProtocolMessage = isProtocolMessage;
+exports.serializeMessage = serializeMessage;
+exports.deserializeMessage = deserializeMessage;
+exports.createRegisterMessage = createRegisterMessage;
+exports.createRegisteredMessage = createRegisteredMessage;
+exports.createRequestMessage = createRequestMessage;
+exports.createResponseMessage = createResponseMessage;
+exports.createDataMessage = createDataMessage;
+exports.createEndMessage = createEndMessage;
+exports.createExpiredMessage = createExpiredMessage;
+// ============================================================================
+// Type Guards
+// ============================================================================
+function isRegisterMessage(msg) {
+    return (typeof msg === 'object' &&
+        msg !== null &&
+        msg.type === 'register' &&
+        typeof msg.path === 'string' &&
+        typeof msg.expiresAt === 'number');
+}
+function isRegisteredMessage(msg) {
+    return (typeof msg === 'object' &&
+        msg !== null &&
+        msg.type === 'registered' &&
+        typeof msg.sessionId === 'string' &&
+        typeof msg.url === 'string');
+}
+function isRequestMessage(msg) {
+    return (typeof msg === 'object' &&
+        msg !== null &&
+        msg.type === 'request' &&
+        typeof msg.id === 'string' &&
+        typeof msg.method === 'string' &&
+        typeof msg.path === 'string');
+}
+function isResponseMessage(msg) {
+    return (typeof msg === 'object' &&
+        msg !== null &&
+        msg.type === 'response' &&
+        typeof msg.id === 'string' &&
+        typeof msg.status === 'number' &&
+        typeof msg.headers === 'object' &&
+        msg.headers !== null);
+}
+function isDataMessage(msg) {
+    return (typeof msg === 'object' &&
+        msg !== null &&
+        msg.type === 'data' &&
+        typeof msg.id === 'string' &&
+        typeof msg.chunk === 'string');
+}
+function isEndMessage(msg) {
+    return (typeof msg === 'object' &&
+        msg !== null &&
+        msg.type === 'end' &&
+        typeof msg.id === 'string');
+}
+function isExpiredMessage(msg) {
+    return (typeof msg === 'object' &&
+        msg !== null &&
+        msg.type === 'expired');
+}
+function isProtocolMessage(msg) {
+    return (isRegisterMessage(msg) ||
+        isRegisteredMessage(msg) ||
+        isRequestMessage(msg) ||
+        isResponseMessage(msg) ||
+        isDataMessage(msg) ||
+        isEndMessage(msg) ||
+        isExpiredMessage(msg));
+}
+// ============================================================================
+// Serialization / Deserialization
+// ============================================================================
+/**
+ * Serialize a protocol message to JSON string
+ */
+function serializeMessage(msg) {
+    return JSON.stringify(msg);
+}
+/**
+ * Deserialize a JSON string to a protocol message
+ * Returns null if the message is invalid
+ */
+function deserializeMessage(data) {
+    try {
+        const parsed = JSON.parse(data);
+        if (isProtocolMessage(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+// ============================================================================
+// Message Factories
+// ============================================================================
+function createRegisterMessage(path, expiresAt) {
+    return { type: 'register', path, expiresAt };
+}
+function createRegisteredMessage(sessionId, url) {
+    return { type: 'registered', sessionId, url };
+}
+function createRequestMessage(id, method, path) {
+    return { type: 'request', id, method, path };
+}
+function createResponseMessage(id, status, headers) {
+    return { type: 'response', id, status, headers };
+}
+function createDataMessage(id, chunk) {
+    return { type: 'data', id, chunk };
+}
+function createEndMessage(id) {
+    return { type: 'end', id };
+}
+function createExpiredMessage() {
+    return { type: 'expired' };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

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

package/dist/scanner.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Represents a single entry (file or directory) in a scanned directory
+ */
+export interface DirectoryEntry {
+    name: string;
+    relativePath: string;
+    absolutePath: string;
+    isDirectory: boolean;
+    size: number;
+    modifiedAt: Date;
+}
+/**
+ * Result of scanning a directory
+ */
+export interface ScanResult {
+    entries: DirectoryEntry[];
+    totalSize: number;
+    fileCount: number;
+    directoryCount: number;
+}
+/**
+ * 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
+ */
+export declare function scanDirectory(dirPath: string, basePath?: string): Promise<DirectoryEntry[]>;
+/**
+ * Calculates the total size and counts from directory entries.
+ *
+ * @param entries - Array of DirectoryEntry objects
+ * @returns ScanResult with entries, totalSize, fileCount, and directoryCount
+ */
+export declare function calculateScanResult(entries: DirectoryEntry[]): ScanResult;
+/**
+ * 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
+ */
+export declare function scanDirectoryShallow(dirPath: string, basePath: string): Promise<DirectoryEntry[]>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,EAAE,CAAC,CAqC3B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,UAAU,CAoBzE;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,cAAc,EAAE,CAAC,CA+B3B"}