@ecmaos/coreutils 0.3.1 → 0.4.2

package/dist/commands/mount.js

@@ -0,0 +1,1136 @@
+// TODO: Dropbox and S3 are WIP
+import path from 'path';
+import chalk from 'chalk';
+import { Fetch, InMemory, resolveMountConfig, SingleBuffer } from '@zenfs/core';
+import { IndexedDB, WebStorage, WebAccess, /* XML */ } from '@zenfs/dom';
+import { Iso, Zip } from '@zenfs/archives';
+import { Dropbox, /* S3Bucket, */ GoogleDrive } from '@zenfs/cloud';
+import { TerminalCommand } from '../shared/terminal-command.js';
+import { writelnStdout, writelnStderr } from '../shared/helpers.js';
+/**
+ * Parse a single fstab line
+ * @param line - The line to parse
+ * @returns Parsed entry or null if line is empty/comment
+ */
+function parseFstabLine(line) {
+    const trimmed = line.trim();
+    // Skip empty lines and comments
+    if (trimmed === '' || trimmed.startsWith('#')) {
+        return null;
+    }
+    // Split by whitespace (space or tab)
+    // Format: source target type [options]
+    const parts = trimmed.split(/\s+/);
+    if (parts.length < 3) {
+        // Need at least source, target, and type
+        return null;
+    }
+    const source = parts[0] || '';
+    const target = parts[1] || '';
+    const type = parts[2] || '';
+    const options = parts.slice(3).join(' ') || undefined;
+    // Validate required fields
+    if (!target || !type) {
+        return null;
+    }
+    return {
+        source: source || '',
+        target,
+        type,
+        options
+    };
+}
+/**
+ * Parse a complete fstab file
+ * @param content - The fstab file content
+ * @returns Array of parsed fstab entries
+ */
+function parseFstabFile(content) {
+    const lines = content.split('\n');
+    const entries = [];
+    for (const line of lines) {
+        if (!line)
+            continue;
+        const parsed = parseFstabLine(line);
+        if (parsed) {
+            entries.push(parsed);
+        }
+    }
+    return entries;
+}
+function printUsage(process, terminal) {
+    const usage = `Usage: mount [OPTIONS] [SOURCE] TARGET
+       mount [-a|--all]
+       mount [-l|--list]
+
+Mount a filesystem.
+
+Options:
+  -t, --type TYPE     filesystem type (fetch, indexeddb, webstorage, webaccess, memory, singlebuffer, zip, iso, googledrive)
+  -o, --options OPTS   mount options (comma-separated key=value pairs)
+  -a, --all           mount all filesystems listed in /etc/fstab
+  -l, --list          list all mounted filesystems
+  --help              display this help and exit
+
+Filesystem types:
+  fetch         mount a remote filesystem via HTTP fetch
+  indexeddb     mount an IndexedDB-backed filesystem
+  webstorage    mount a WebStorage-backed filesystem (localStorage or sessionStorage)
+  webaccess     mount a filesystem using the File System Access API
+  memory        mount an in-memory filesystem
+  singlebuffer  mount a filesystem backed by a single buffer
+  zip           mount a readonly filesystem from a zip archive (requires SOURCE file or URL)
+  iso           mount a readonly filesystem from an ISO image (requires SOURCE file or URL)
+  googledrive   mount a Google Drive filesystem (requires apiKey via -o apiKey, optionally clientId for OAuth)
+
+Mount options:
+  baseUrl=URL        base URL for fetch operations (fetch type)
+  size=BYTES         buffer size in bytes for singlebuffer type (default: 1048576)
+  storage=TYPE       storage type for webstorage (localStorage or sessionStorage, default: localStorage)
+  apiKey=KEY         Google API key (googledrive type, required)
+  clientId=ID        Google OAuth client ID (googledrive type, optional)
+  scope=SCOPE        OAuth scope (googledrive type, default: https://www.googleapis.com/auth/drive)
+  cacheTTL=SECONDS   cache TTL in seconds for cloud backends (optional)
+
+Examples:
+  mount -l                                    list all mounted filesystems
+  mount -t memory /mnt/tmp                    mount memory filesystem at /mnt/tmp
+  mount -t indexeddb mydb /mnt/db             mount IndexedDB store 'mydb' at /mnt/db
+  mount -t webstorage /mnt/storage            mount WebStorage filesystem using localStorage
+  mount -t webstorage /mnt/storage -o storage=sessionStorage
+  mount -t webaccess /mnt/access              mount File System Access API filesystem
+  mount -t fetch /api /mnt/api                mount fetch filesystem at /mnt/api
+  mount -t fetch /api /mnt/api -o baseUrl=https://example.com
+  mount -t singlebuffer /mnt/buf              mount singlebuffer filesystem at /mnt/buf
+  mount -t singlebuffer /mnt/buf -o size=2097152
+  mount -t zip https://example.com/archive.zip /mnt/zip
+  mount -t zip /tmp/archive.zip /mnt/zip
+  mount -t iso https://example.com/image.iso /mnt/iso
+  mount -t iso /tmp/image.iso /mnt/iso
+  mount -t googledrive /mnt/gdrive -o apiKey=YOUR_API_KEY # readonly/public
+  mount -t googledrive /mnt/gdrive -o clientId=YOUR_CLIENT_ID # rw/private`;
+    writelnStderr(process, terminal, usage);
+}
+export function createCommand(kernel, shell, terminal) {
+    return new TerminalCommand({
+        command: 'mount',
+        description: 'Mount a filesystem',
+        kernel,
+        shell,
+        terminal,
+        run: async (pid, argv) => {
+            const process = kernel.processes.get(pid);
+            if (argv.length > 0 && (argv[0] === '--help' || argv[0] === '-h')) {
+                printUsage(process, terminal);
+                return 0;
+            }
+            let listMode = false;
+            let allMode = false;
+            let type;
+            let options;
+            const positionalArgs = [];
+            for (let i = 0; i < argv.length; i++) {
+                const arg = argv[i];
+                if (arg === '-l' || arg === '--list') {
+                    listMode = true;
+                }
+                else if (arg === '-a' || arg === '--all') {
+                    allMode = true;
+                }
+                else if (arg === '-t' || arg === '--type') {
+                    if (i + 1 < argv.length) {
+                        type = argv[i + 1];
+                        i++;
+                    }
+                    else {
+                        await writelnStderr(process, terminal, chalk.red('mount: option requires an argument -- \'t\''));
+                        return 1;
+                    }
+                }
+                else if (arg === '-o' || arg === '--options') {
+                    if (i + 1 < argv.length) {
+                        options = argv[i + 1];
+                        i++;
+                    }
+                    else {
+                        await writelnStderr(process, terminal, chalk.red('mount: option requires an argument -- \'o\''));
+                        return 1;
+                    }
+                }
+                else if (arg && !arg.startsWith('-')) {
+                    positionalArgs.push(arg);
+                }
+            }
+            if (listMode || (argv.length === 0 && !allMode)) {
+                const mountList = Array.from(kernel.filesystem.mounts.entries());
+                if (mountList.length === 0) {
+                    await writelnStdout(process, terminal, 'No filesystems mounted.');
+                    return 0;
+                }
+                const mountRows = mountList.map(([target, mount]) => {
+                    const mountObj = mount;
+                    const store = mountObj.store;
+                    const backendName = store?.constructor?.name || mountObj.constructor?.name || 'Unknown';
+                    const metadata = mountObj.metadata?.();
+                    const name = metadata?.name || backendName;
+                    return {
+                        target: chalk.blue(target),
+                        name: chalk.gray(name)
+                    };
+                });
+                for (const row of mountRows) {
+                    await writelnStdout(process, terminal, `${row.target.padEnd(30)} ${row.name}`);
+                }
+                return 0;
+            }
+            if (allMode) {
+                try {
+                    const fstabPath = '/etc/fstab';
+                    if (!(await shell.context.fs.promises.exists(fstabPath))) {
+                        await writelnStderr(process, terminal, chalk.yellow(`mount: ${fstabPath} not found`));
+                        return 1;
+                    }
+                    const content = await shell.context.fs.promises.readFile(fstabPath, 'utf-8');
+                    const entries = parseFstabFile(content);
+                    if (entries.length === 0) {
+                        await writelnStdout(process, terminal, 'No entries found in /etc/fstab');
+                        return 0;
+                    }
+                    await writelnStdout(process, terminal, `Mounting ${entries.length} filesystem(s) from /etc/fstab...`);
+                    let successCount = 0;
+                    let failCount = 0;
+                    for (const entry of entries) {
+                        try {
+                            const entryType = entry.type;
+                            const entrySource = entry.source || '';
+                            const entryTarget = path.resolve('/', entry.target);
+                            const entryOptions = entry.options;
+                            // Validate entry
+                            if (!entryType) {
+                                await writelnStderr(process, terminal, chalk.yellow(`mount: skipping entry for ${entryTarget}: missing type`));
+                                failCount++;
+                                continue;
+                            }
+                            if (!entryTarget) {
+                                await writelnStderr(process, terminal, chalk.yellow(`mount: skipping entry: missing target`));
+                                failCount++;
+                                continue;
+                            }
+                            // Check if filesystem type doesn't require source but one is provided
+                            const noSourceTypes = ['memory', 'singlebuffer', 'webstorage', 'webaccess', 'xml', 'dropbox', 'googledrive'];
+                            if (entrySource && noSourceTypes.includes(entryType.toLowerCase())) {
+                                await writelnStderr(process, terminal, chalk.yellow(`mount: ${entryType} filesystem does not require a source, ignoring source for ${entryTarget}`));
+                            }
+                            // Check if filesystem type requires source but none is provided
+                            const requiresSourceTypes = ['zip', 'iso', 'fetch', 'indexeddb'];
+                            if (!entrySource && requiresSourceTypes.includes(entryType.toLowerCase())) {
+                                await writelnStderr(process, terminal, chalk.yellow(`mount: skipping ${entryTarget}: ${entryType} filesystem requires a source`));
+                                failCount++;
+                                continue;
+                            }
+                            // Create target directory if needed
+                            const parentDir = path.dirname(entryTarget);
+                            if (parentDir !== entryTarget && !(await shell.context.fs.promises.exists(parentDir))) {
+                                await shell.context.fs.promises.mkdir(parentDir, { recursive: true });
+                            }
+                            if (!(await shell.context.fs.promises.exists(entryTarget))) {
+                                await shell.context.fs.promises.mkdir(entryTarget, { recursive: true });
+                            }
+                            // Parse mount options
+                            const mountOptions = entryOptions?.split(',').reduce((acc, option) => {
+                                const [key, value] = option.split('=');
+                                if (key && value) {
+                                    acc[key.trim()] = value.trim();
+                                }
+                                return acc;
+                            }, {}) || {};
+                            // Perform the mount based on type
+                            switch (entryType.toLowerCase()) {
+                                case 'fetch': {
+                                    let fetchBaseUrl = mountOptions.baseUrl || '';
+                                    let indexUrl;
+                                    if (entrySource && /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(entrySource)) {
+                                        indexUrl = entrySource;
+                                    }
+                                    else {
+                                        if (!fetchBaseUrl) {
+                                            throw new Error('fetch filesystem requires either a full URL as source or baseUrl option');
+                                        }
+                                        fetchBaseUrl = new URL(fetchBaseUrl).toString();
+                                        indexUrl = new URL(entrySource || 'index.json', fetchBaseUrl).toString();
+                                    }
+                                    await kernel.filesystem.fsSync.mount(entryTarget, await resolveMountConfig({
+                                        backend: Fetch,
+                                        index: indexUrl,
+                                        baseUrl: fetchBaseUrl,
+                                        disableAsyncCache: true,
+                                    }));
+                                    break;
+                                }
+                                case 'indexeddb':
+                                    await kernel.filesystem.fsSync.mount(entryTarget, await resolveMountConfig({
+                                        backend: IndexedDB,
+                                        storeName: entrySource || entryTarget
+                                    }));
+                                    break;
+                                case 'webstorage': {
+                                    const storageType = mountOptions.storage?.toLowerCase() || 'localstorage';
+                                    let storage;
+                                    if (storageType === 'sessionstorage') {
+                                        if (typeof sessionStorage === 'undefined') {
+                                            throw new Error('sessionStorage is not available in this environment');
+                                        }
+                                        storage = sessionStorage;
+                                    }
+                                    else if (storageType === 'localstorage') {
+                                        if (typeof localStorage === 'undefined') {
+                                            throw new Error('localStorage is not available in this environment');
+                                        }
+                                        storage = localStorage;
+                                    }
+                                    else {
+                                        throw new Error(`invalid storage type '${storageType}'. Use 'localStorage' or 'sessionStorage'`);
+                                    }
+                                    await kernel.filesystem.fsSync.mount(entryTarget, await resolveMountConfig({
+                                        backend: WebStorage,
+                                        storage
+                                    }));
+                                    break;
+                                }
+                                case 'webaccess': {
+                                    if (typeof window === 'undefined') {
+                                        throw new Error('File System Access API is not available in this environment');
+                                    }
+                                    const win = window;
+                                    if (!win.showDirectoryPicker) {
+                                        throw new Error('File System Access API is not available in this environment');
+                                    }
+                                    // For fstab, we can't interactively pick a directory, so skip
+                                    await writelnStderr(process, terminal, chalk.yellow(`mount: skipping ${entryTarget}: webaccess requires interactive directory selection`));
+                                    failCount++;
+                                    continue;
+                                }
+                                case 'memory':
+                                    await kernel.filesystem.fsSync.mount(entryTarget, await resolveMountConfig({
+                                        backend: InMemory
+                                    }));
+                                    break;
+                                case 'singlebuffer': {
+                                    const bufferSize = mountOptions.size
+                                        ? parseInt(mountOptions.size, 10)
+                                        : 1048576;
+                                    if (isNaN(bufferSize) || bufferSize <= 0) {
+                                        throw new Error('invalid buffer size for singlebuffer type');
+                                    }
+                                    let buffer;
+                                    try {
+                                        buffer = new SharedArrayBuffer(bufferSize);
+                                    }
+                                    catch {
+                                        buffer = new ArrayBuffer(bufferSize);
+                                    }
+                                    await kernel.filesystem.fsSync.mount(entryTarget, await resolveMountConfig({
+                                        backend: SingleBuffer,
+                                        buffer
+                                    }));
+                                    break;
+                                }
+                                case 'zip': {
+                                    if (!entrySource) {
+                                        throw new Error('zip filesystem requires a source file or URL');
+                                    }
+                                    let arrayBuffer;
+                                    if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(entrySource)) {
+                                        const response = await fetch(entrySource);
+                                        if (!response.ok) {
+                                            throw new Error(`failed to fetch archive: ${response.status} ${response.statusText}`);
+                                        }
+                                        arrayBuffer = await response.arrayBuffer();
+                                    }
+                                    else {
+                                        const sourcePath = path.resolve('/', entrySource);
+                                        if (!(await shell.context.fs.promises.exists(sourcePath))) {
+                                            throw new Error(`archive file not found: ${sourcePath}`);
+                                        }
+                                        const fileData = await shell.context.fs.promises.readFile(sourcePath);
+                                        arrayBuffer = new Uint8Array(fileData).buffer;
+                                    }
+                                    await kernel.filesystem.fsSync.mount(entryTarget, await resolveMountConfig({
+                                        backend: Zip,
+                                        data: arrayBuffer
+                                    }));
+                                    break;
+                                }
+                                case 'iso': {
+                                    if (!entrySource) {
+                                        throw new Error('iso filesystem requires a source file or URL');
+                                    }
+                                    let uint8Array;
+                                    if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(entrySource)) {
+                                        const response = await fetch(entrySource);
+                                        if (!response.ok) {
+                                            throw new Error(`failed to fetch ISO image: ${response.status} ${response.statusText}`);
+                                        }
+                                        const arrayBuffer = await response.arrayBuffer();
+                                        uint8Array = new Uint8Array(arrayBuffer);
+                                    }
+                                    else {
+                                        const sourcePath = path.resolve('/', entrySource);
+                                        if (!(await shell.context.fs.promises.exists(sourcePath))) {
+                                            throw new Error(`ISO image file not found: ${sourcePath}`);
+                                        }
+                                        uint8Array = await shell.context.fs.promises.readFile(sourcePath);
+                                    }
+                                    await kernel.filesystem.fsSync.mount(entryTarget, await resolveMountConfig({
+                                        backend: Iso,
+                                        data: uint8Array
+                                    }));
+                                    break;
+                                }
+                                case 'dropbox': {
+                                    if (!mountOptions.client) {
+                                        throw new Error('dropbox filesystem requires client configuration');
+                                    }
+                                    let clientConfig;
+                                    try {
+                                        clientConfig = JSON.parse(mountOptions.client);
+                                    }
+                                    catch {
+                                        throw new Error('invalid JSON in client option');
+                                    }
+                                    if (!clientConfig.accessToken) {
+                                        throw new Error('client configuration must include accessToken');
+                                    }
+                                    const dropboxModule = await import('dropbox');
+                                    const DropboxClient = dropboxModule.Dropbox;
+                                    const client = new DropboxClient(clientConfig);
+                                    const cacheTTL = mountOptions.cacheTTL ? parseInt(mountOptions.cacheTTL, 10) : undefined;
+                                    await kernel.filesystem.fsSync.mount(entryTarget, await resolveMountConfig({
+                                        backend: Dropbox,
+                                        client,
+                                        ...(cacheTTL && !isNaN(cacheTTL) ? { cacheTTL } : {})
+                                    }));
+                                    break;
+                                }
+                                case 'googledrive': {
+                                    if (typeof window === 'undefined') {
+                                        throw new Error('Google Drive API requires a browser environment');
+                                    }
+                                    if (!mountOptions.apiKey) {
+                                        throw new Error('googledrive filesystem requires apiKey option');
+                                    }
+                                    // Google Drive mounting is complex and requires interactive auth
+                                    // For fstab, we'll skip it with a warning
+                                    await writelnStderr(process, terminal, chalk.yellow(`mount: skipping ${entryTarget}: googledrive requires interactive authentication`));
+                                    failCount++;
+                                    continue;
+                                }
+                                default:
+                                    throw new Error(`unknown filesystem type '${entryType}'`);
+                            }
+                            const successMessage = entrySource
+                                ? chalk.green(`Mounted ${entryType} filesystem from ${entrySource} to ${entryTarget}`)
+                                : chalk.green(`Mounted ${entryType} filesystem at ${entryTarget}`);
+                            await writelnStdout(process, terminal, successMessage);
+                            successCount++;
+                        }
+                        catch (error) {
+                            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+                            await writelnStderr(process, terminal, chalk.red(`mount: failed to mount ${entry.target}: ${errorMessage}`));
+                            failCount++;
+                        }
+                    }
+                    await writelnStdout(process, terminal, `\nMount summary: ${successCount} succeeded, ${failCount} failed`);
+                    return failCount > 0 ? 1 : 0;
+                }
+                catch (error) {
+                    await writelnStderr(process, terminal, chalk.red(`mount: failed to process /etc/fstab: ${error instanceof Error ? error.message : 'Unknown error'}`));
+                    return 1;
+                }
+            }
+            if (positionalArgs.length === 0) {
+                await writelnStderr(process, terminal, chalk.red('mount: missing target argument'));
+                await writelnStderr(process, terminal, 'Try \'mount --help\' for more information.');
+                return 1;
+            }
+            if (positionalArgs.length > 2) {
+                await writelnStderr(process, terminal, chalk.red('mount: too many arguments'));
+                await writelnStderr(process, terminal, 'Try \'mount --help\' for more information.');
+                return 1;
+            }
+            if (!type) {
+                await writelnStderr(process, terminal, chalk.red('mount: filesystem type must be specified'));
+                await writelnStderr(process, terminal, 'Try \'mount --help\' for more information.');
+                return 1;
+            }
+            const source = positionalArgs.length === 2 ? positionalArgs[0] : '';
+            const targetArg = positionalArgs[positionalArgs.length - 1];
+            if (!targetArg) {
+                await writelnStderr(process, terminal, chalk.red('mount: missing target argument'));
+                return 1;
+            }
+            const target = path.resolve(shell.cwd, targetArg);
+            if (positionalArgs.length === 2 && (type.toLowerCase() === 'memory' || type.toLowerCase() === 'singlebuffer' || type.toLowerCase() === 'webstorage' || type.toLowerCase() === 'webaccess' || type.toLowerCase() === 'xml' || type.toLowerCase() === 'dropbox' /* || type.toLowerCase() === 's3' */ || type.toLowerCase() === 'googledrive')) {
+                await writelnStderr(process, terminal, chalk.yellow(`mount: ${type.toLowerCase()} filesystem does not require a source`));
+                await writelnStderr(process, terminal, `Usage: mount -t ${type.toLowerCase()} TARGET`);
+                return 1;
+            }
+            if (positionalArgs.length === 1 && (type.toLowerCase() === 'zip' || type.toLowerCase() === 'iso')) {
+                await writelnStderr(process, terminal, chalk.red(`mount: ${type.toLowerCase()} filesystem requires a source file or URL`));
+                await writelnStderr(process, terminal, `Usage: mount -t ${type.toLowerCase()} SOURCE TARGET`);
+                return 1;
+            }
+            try {
+                const parentDir = path.dirname(target);
+                if (parentDir !== target && !(await shell.context.fs.promises.exists(parentDir))) {
+                    await shell.context.fs.promises.mkdir(parentDir, { recursive: true });
+                }
+                if (!(await shell.context.fs.promises.exists(target))) {
+                    await shell.context.fs.promises.mkdir(target, { recursive: true });
+                }
+                const mountOptions = options?.split(',').reduce((acc, option) => {
+                    const [key, value] = option.split('=');
+                    if (key && value) {
+                        acc[key.trim()] = value.trim();
+                    }
+                    return acc;
+                }, {}) || {};
+                switch (type.toLowerCase()) {
+                    case 'fetch': {
+                        let fetchBaseUrl = new URL(mountOptions.baseUrl || '').toString();
+                        let indexUrl;
+                        if (source && /^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(source)) {
+                            indexUrl = source;
+                        }
+                        else {
+                            indexUrl = new URL(source || 'index.json', fetchBaseUrl).toString();
+                        }
+                        await kernel.filesystem.fsSync.mount(target, await resolveMountConfig({
+                            backend: Fetch,
+                            index: indexUrl,
+                            baseUrl: fetchBaseUrl,
+                            disableAsyncCache: true,
+                        }));
+                        break;
+                    }
+                    case 'indexeddb':
+                        await kernel.filesystem.fsSync.mount(target, await resolveMountConfig({
+                            backend: IndexedDB,
+                            storeName: source || target
+                        }));
+                        break;
+                    case 'webstorage': {
+                        const storageType = mountOptions.storage?.toLowerCase() || 'localstorage';
+                        let storage;
+                        if (storageType === 'sessionstorage') {
+                            if (typeof sessionStorage === 'undefined') {
+                                await writelnStderr(process, terminal, chalk.red('mount: sessionStorage is not available in this environment'));
+                                return 1;
+                            }
+                            storage = sessionStorage;
+                        }
+                        else if (storageType === 'localstorage') {
+                            if (typeof localStorage === 'undefined') {
+                                await writelnStderr(process, terminal, chalk.red('mount: localStorage is not available in this environment'));
+                                return 1;
+                            }
+                            storage = localStorage;
+                        }
+                        else {
+                            await writelnStderr(process, terminal, chalk.red(`mount: invalid storage type '${storageType}'. Use 'localStorage' or 'sessionStorage'`));
+                            return 1;
+                        }
+                        await kernel.filesystem.fsSync.mount(target, await resolveMountConfig({
+                            backend: WebStorage,
+                            storage
+                        }));
+                        break;
+                    }
+                    case 'webaccess': {
+                        if (typeof window === 'undefined') {
+                            await writelnStderr(process, terminal, chalk.red('mount: File System Access API is not available in this environment'));
+                            return 1;
+                        }
+                        const win = window;
+                        if (!win.showDirectoryPicker) {
+                            await writelnStderr(process, terminal, chalk.red('mount: File System Access API is not available in this environment'));
+                            return 1;
+                        }
+                        try {
+                            const directoryHandle = await win.showDirectoryPicker();
+                            await kernel.filesystem.fsSync.mount(target, await resolveMountConfig({
+                                backend: WebAccess,
+                                handle: directoryHandle
+                            }));
+                        }
+                        catch (error) {
+                            if (error instanceof Error && error.name === 'AbortError') {
+                                await writelnStderr(process, terminal, chalk.yellow('mount: directory selection cancelled'));
+                                return 1;
+                            }
+                            throw error;
+                        }
+                        break;
+                    }
+                    // TODO: Some more work needs to be done with the XML backend
+                    // case 'xml': {
+                    //   if (typeof document === 'undefined') {
+                    //     await writelnStderr(process, terminal, chalk.red('mount: XML backend requires DOM APIs (document) which are not available in this environment'))
+                    //     return 1
+                    //   }
+                    //   let root: Element | undefined
+                    //   if (mountOptions.root) {
+                    //     const rootSelector = mountOptions.root
+                    //     const element = document.querySelector(rootSelector)
+                    //     if (!element) {
+                    //       await writelnStderr(process, terminal, chalk.yellow(`mount: root element '${rootSelector}' not found, creating new element`))
+                    //       root = new DOMParser().parseFromString('<fs></fs>', 'application/xml').documentElement
+                    //       root.setAttribute('id', 'xmlfs-' + Math.random().toString(36).substring(2, 15))
+                    //       root.setAttribute('style', 'display: none')
+                    //     } else {
+                    //       root = element as Element
+                    //     }
+                    //   } else {
+                    //     root = new DOMParser().parseFromString('<fs></fs>', 'application/xml').documentElement
+                    //     root.setAttribute('id', 'xmlfs-' + Math.random().toString(36).substring(2, 15))
+                    //     root.setAttribute('style', 'display: none')
+                    //   }
+                    //   if (!root) throw new Error('Failed to create root element')
+                    //   const rootNode = document.createElement('file')
+                    //   rootNode.setAttribute('paths', JSON.stringify(['/']))
+                    //   rootNode.setAttribute('nlink', '1')
+                    //   rootNode.setAttribute('mode', (constants.S_IFDIR | 0o777).toString(16))
+                    //   rootNode.setAttribute('uid', (0).toString(16))
+                    //   rootNode.setAttribute('gid', (0).toString(16))
+                    //   rootNode.textContent = '[]'
+                    //   root.appendChild(rootNode)
+                    //   try {
+                    //     const config = {
+                    //       backend: XML,
+                    //       root
+                    //     } as { backend: typeof XML; root: Element }
+                    //     document.body.appendChild(root)
+                    //     const mountConfig = await resolveMountConfig(config)
+                    //     await kernel.filesystem.fsSync.mount(target, mountConfig)
+                    //   } catch (error) {
+                    //     const errorMessage = error instanceof Error ? error.message : String(error)
+                    //     await writelnStderr(process, terminal, chalk.red(`mount: failed to mount XML filesystem: ${errorMessage}`))
+                    //     if (error instanceof Error && error.stack) {
+                    //       await writelnStderr(process, terminal, chalk.gray(`Stack: ${error.stack}`))
+                    //     }
+                    //     return 1
+                    //   }
+                    //   break
+                    // }
+                    case 'memory':
+                        await kernel.filesystem.fsSync.mount(target, await resolveMountConfig({
+                            backend: InMemory
+                        }));
+                        break;
+                    case 'singlebuffer': {
+                        const bufferSize = mountOptions.size
+                            ? parseInt(mountOptions.size, 10)
+                            : 1048576;
+                        if (isNaN(bufferSize) || bufferSize <= 0) {
+                            await writelnStderr(process, terminal, chalk.red('mount: invalid buffer size for singlebuffer type'));
+                            return 1;
+                        }
+                        let buffer;
+                        try {
+                            buffer = new SharedArrayBuffer(bufferSize);
+                        }
+                        catch {
+                            buffer = new ArrayBuffer(bufferSize);
+                        }
+                        await kernel.filesystem.fsSync.mount(target, await resolveMountConfig({
+                            backend: SingleBuffer,
+                            buffer
+                        }));
+                        break;
+                    }
+                    case 'zip': {
+                        if (!source) {
+                            await writelnStderr(process, terminal, chalk.red('mount: zip filesystem requires a source file or URL'));
+                            return 1;
+                        }
+                        let arrayBuffer;
+                        if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(source)) {
+                            await writelnStdout(process, terminal, chalk.gray(`Fetching archive from ${source}...`));
+                            const response = await fetch(source);
+                            if (!response.ok) {
+                                await writelnStderr(process, terminal, chalk.red(`mount: failed to fetch archive: ${response.status} ${response.statusText}`));
+                                return 1;
+                            }
+                            arrayBuffer = await response.arrayBuffer();
+                        }
+                        else {
+                            const sourcePath = path.resolve(shell.cwd, source);
+                            if (!(await shell.context.fs.promises.exists(sourcePath))) {
+                                await writelnStderr(process, terminal, chalk.red(`mount: archive file not found: ${sourcePath}`));
+                                return 1;
+                            }
+                            await writelnStdout(process, terminal, chalk.gray(`Reading archive from ${sourcePath}...`));
+                            const fileData = await shell.context.fs.promises.readFile(sourcePath);
+                            arrayBuffer = new Uint8Array(fileData).buffer;
+                        }
+                        await kernel.filesystem.fsSync.mount(target, await resolveMountConfig({
+                            backend: Zip,
+                            data: arrayBuffer
+                        }));
+                        break;
+                    }
+                    case 'iso': {
+                        if (!source) {
+                            await writelnStderr(process, terminal, chalk.red('mount: iso filesystem requires a source file or URL'));
+                            return 1;
+                        }
+                        let uint8Array;
+                        if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(source)) {
+                            await writelnStdout(process, terminal, chalk.gray(`Fetching ISO image from ${source}...`));
+                            const response = await fetch(source);
+                            if (!response.ok) {
+                                await writelnStderr(process, terminal, chalk.red(`mount: failed to fetch ISO image: ${response.status} ${response.statusText}`));
+                                return 1;
+                            }
+                            const arrayBuffer = await response.arrayBuffer();
+                            uint8Array = new Uint8Array(arrayBuffer);
+                        }
+                        else {
+                            const sourcePath = path.resolve(shell.cwd, source);
+                            if (!(await shell.context.fs.promises.exists(sourcePath))) {
+                                await writelnStderr(process, terminal, chalk.red(`mount: ISO image file not found: ${sourcePath}`));
+                                return 1;
+                            }
+                            await writelnStdout(process, terminal, chalk.gray(`Reading ISO image from ${sourcePath}...`));
+                            uint8Array = await shell.context.fs.promises.readFile(sourcePath);
+                        }
+                        await kernel.filesystem.fsSync.mount(target, await resolveMountConfig({
+                            backend: Iso,
+                            data: uint8Array
+                        }));
+                        break;
+                    }
+                    case 'dropbox': {
+                        if (!mountOptions.client) {
+                            await writelnStderr(process, terminal, chalk.red('mount: dropbox filesystem requires client configuration'));
+                            await writelnStderr(process, terminal, 'Usage: mount -t dropbox TARGET -o client=\'{"accessToken":"..."}\'');
+                            return 1;
+                        }
+                        try {
+                            let clientConfig;
+                            try {
+                                clientConfig = JSON.parse(mountOptions.client);
+                            }
+                            catch {
+                                await writelnStderr(process, terminal, chalk.red('mount: invalid JSON in client option'));
+                                return 1;
+                            }
+                            if (!clientConfig.accessToken) {
+                                await writelnStderr(process, terminal, chalk.red('mount: client configuration must include accessToken'));
+                                return 1;
+                            }
+                            const dropboxModule = await import('dropbox');
+                            const DropboxClient = dropboxModule.Dropbox;
+                            const client = new DropboxClient(clientConfig);
+                            const cacheTTL = mountOptions.cacheTTL ? parseInt(mountOptions.cacheTTL, 10) : undefined;
+                            await kernel.filesystem.fsSync.mount(target, await resolveMountConfig({
+                                backend: Dropbox,
+                                client,
+                                ...(cacheTTL && !isNaN(cacheTTL) ? { cacheTTL } : {})
+                            }));
+                        }
+                        catch (error) {
+                            await writelnStderr(process, terminal, chalk.red(`mount: failed to mount dropbox filesystem: ${error instanceof Error ? error.message : 'Unknown error'}`));
+                            return 1;
+                        }
+                        break;
+                    }
+                    /* case 's3': {
+                      if (!mountOptions.bucket) {
+                        await writelnStderr(process, terminal, chalk.red('mount: s3 filesystem requires bucket option'))
+                        await writelnStderr(process, terminal, 'Usage: mount -t s3 TARGET -o bucket=my-bucket')
+                        return 1
+                      }
+          
+                      try {
+                        // Start with default config
+                        let clientConfigRaw: { region?: string; credentials?: { accessKeyId?: string; secretAccessKey?: string; sessionToken?: string }; [key: string]: unknown } = {}
+          
+                        // Parse client config if provided
+                        if (mountOptions.client) {
+                          try {
+                            clientConfigRaw = JSON.parse(mountOptions.client)
+                          } catch {
+                            await writelnStderr(process, terminal, chalk.red('mount: invalid JSON in client option'))
+                            return 1
+                          }
+                        }
+          
+                        // Set region: use from config, then env var, then default
+                        if (!clientConfigRaw.region) {
+                          clientConfigRaw.region = shell.env.get('AWS_DEFAULT_REGION') || 'us-east-1'
+                        }
+          
+                        // Use environment variables as defaults if credentials not provided
+                        if (!clientConfigRaw.credentials) {
+                          const accessKeyId = shell.env.get('AWS_ACCESS_KEY_ID')
+                          const secretAccessKey = shell.env.get('AWS_SECRET_ACCESS_KEY')
+                          const sessionToken = shell.env.get('AWS_SESSION_TOKEN')
+          
+                          if (accessKeyId && secretAccessKey) {
+                            clientConfigRaw.credentials = {
+                              accessKeyId,
+                              secretAccessKey,
+                              ...(sessionToken ? { sessionToken } : {})
+                            }
+                          }
+                        } else {
+                          // Validate credentials if provided
+                          if (!clientConfigRaw.credentials.accessKeyId || !clientConfigRaw.credentials.secretAccessKey) {
+                            await writelnStderr(process, terminal, chalk.yellow('mount: credentials object should include both accessKeyId and secretAccessKey'))
+                            await writelnStderr(process, terminal, 'Note: If credentials are not provided, AWS SDK will use default credential chain (env vars, IAM role, etc.)')
+                          }
+                        }
+          
+                        // Configure for browser environment if needed
+                        if (typeof window !== 'undefined') {
+                          // Ensure we're using fetch for browser requests
+                          if (!clientConfigRaw.requestHandler) {
+                            // The AWS SDK v3 uses fetch by default in browsers, but we can explicitly set it
+                            // This helps ensure CORS is handled properly
+                            clientConfigRaw.requestHandler = undefined // Let SDK use default browser fetch
+                          }
+                        }
+          
+                        const s3Module = await import('@aws-sdk/client-s3')
+                        const S3Client = s3Module.S3
+                        const client = new S3Client(clientConfigRaw as never)
+                        const bucketName = mountOptions.bucket
+                        const prefix = mountOptions.prefix
+                        const cacheTTL = mountOptions.cacheTTL ? parseInt(mountOptions.cacheTTL, 10) : undefined
+          
+                        try {
+                          await kernel.filesystem.fsSync.mount(
+                            target,
+                            await resolveMountConfig({
+                              backend: S3Bucket,
+                              client,
+                              bucketName,
+                              ...(prefix ? { prefix } : {}),
+                              ...(cacheTTL && !isNaN(cacheTTL) ? { cacheTTL } : {})
+                            })
+                          )
+                        } catch (mountError) {
+                          const errorMessage = mountError instanceof Error ? mountError.message : String(mountError)
+                          // Provide helpful guidance for common S3 errors
+                          await writelnStderr(process, terminal, chalk.red(`mount: failed to mount s3 filesystem: ${errorMessage}`))
+                          await writelnStderr(process, terminal, chalk.yellow('\nS3 CORS configuration may be required:'))
+                          await writelnStderr(process, terminal, 'For browser access, your S3 bucket needs CORS configuration:')
+                          await writelnStderr(process, terminal, '  {')
+                          await writelnStderr(process, terminal, '    "CORSRules": [{')
+                          await writelnStderr(process, terminal, '      "AllowedOrigins": ["*"],')
+                          await writelnStderr(process, terminal, '      "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],')
+                          await writelnStderr(process, terminal, '      "AllowedHeaders": ["*"],')
+                          await writelnStderr(process, terminal, '      "ExposeHeaders": ["ETag"],')
+                          await writelnStderr(process, terminal, '      "MaxAgeSeconds": 3000')
+                          await writelnStderr(process, terminal, '    }]')
+                          await writelnStderr(process, terminal, '  }')
+                          await writelnStderr(process, terminal, chalk.gray('\nAlso ensure your bucket policy allows the required operations.'))
+                          throw mountError
+                        }
+                      } catch (error) {
+                        await writelnStderr(process, terminal, chalk.red(`mount: failed to mount s3 filesystem: ${error instanceof Error ? error.message : 'Unknown error'}`))
+                        if (error instanceof Error && error.stack) {
+                          await writelnStderr(process, terminal, chalk.gray(error.stack))
+                        }
+                        return 1
+                      }
+                      break
+                    } */
+                    case 'googledrive': {
+                        try {
+                            if (typeof window === 'undefined') {
+                                await writelnStderr(process, terminal, chalk.red('mount: Google Drive API requires a browser environment'));
+                                return 1;
+                            }
+                            // if (!mountOptions.apiKey) {
+                            //   await writelnStderr(process, terminal, chalk.red('mount: googledrive filesystem requires apiKey option'))
+                            //   await writelnStderr(process, terminal, 'Usage: mount -t googledrive TARGET -o apiKey=YOUR_API_KEY')
+                            //   return 1
+                            // }
+                            const win = window;
+                            // Load Google Identity Services library if not already loaded
+                            if (!win.google?.accounts) {
+                                await writelnStdout(process, terminal, chalk.gray('Loading Google Identity Services library...'));
+                                await new Promise((resolve, reject) => {
+                                    const script = document.createElement('script');
+                                    script.src = 'https://accounts.google.com/gsi/client';
+                                    script.async = true;
+                                    script.defer = true;
+                                    script.onload = () => resolve();
+                                    script.onerror = () => reject(new Error('Failed to load Google Identity Services script'));
+                                    document.head.appendChild(script);
+                                });
+                            }
+                            // Wait for google.accounts to be available
+                            let attempts = 0;
+                            while (!win.google?.accounts && attempts < 50) {
+                                await new Promise(resolve => setTimeout(resolve, 100));
+                                attempts++;
+                            }
+                            if (!win.google?.accounts) {
+                                await writelnStderr(process, terminal, chalk.red('mount: Failed to load Google Identity Services library'));
+                                return 1;
+                            }
+                            // Load Google API script if not already loaded
+                            if (!win.gapi) {
+                                await writelnStdout(process, terminal, chalk.gray('Loading Google API client library...'));
+                                await new Promise((resolve, reject) => {
+                                    const script = document.createElement('script');
+                                    script.src = 'https://apis.google.com/js/api.js';
+                                    script.onload = () => resolve();
+                                    script.onerror = () => reject(new Error('Failed to load Google API script'));
+                                    document.head.appendChild(script);
+                                });
+                            }
+                            // Wait for gapi to be available
+                            attempts = 0;
+                            while (!win.gapi && attempts < 50) {
+                                await new Promise(resolve => setTimeout(resolve, 100));
+                                attempts++;
+                            }
+                            if (!win.gapi) {
+                                await writelnStderr(process, terminal, chalk.red('mount: Failed to load Google API client library'));
+                                return 1;
+                            }
+                            if (!win.gapi.client || !win.gapi.client.drive) {
+                                await writelnStdout(process, terminal, chalk.gray('Initializing Google API client...'));
+                                const initConfig = {
+                                    apiKey: mountOptions.apiKey,
+                                    discoveryDocs: ['https://www.googleapis.com/discovery/v1/apis/drive/v3/rest']
+                                };
+                                // Load the client module
+                                await new Promise((resolve, reject) => {
+                                    if (!win.gapi?.load) {
+                                        reject(new Error('gapi.load is not available'));
+                                        return;
+                                    }
+                                    win.gapi.load('client', () => {
+                                        if (!win.gapi?.client?.init) {
+                                            reject(new Error('gapi.client.init is not available'));
+                                            return;
+                                        }
+                                        win.gapi.client.init(initConfig)
+                                            .then(() => {
+                                            setTimeout(() => {
+                                                if (win.gapi?.client?.drive) {
+                                                    resolve();
+                                                }
+                                                else {
+                                                    reject(new Error('API discovery response missing required fields. The Drive API discovery document may have failed to load. This could be due to: network issues, invalid API key, or the Drive API not being enabled in your Google Cloud project.'));
+                                                }
+                                            }, 1000);
+                                        })
+                                            .catch((error) => {
+                                            const err = error;
+                                            let errorMessage = 'Unknown error';
+                                            errorMessage = JSON.stringify({
+                                                error: err.error,
+                                                details: err.details
+                                            }, null, 2);
+                                            const lowerError = err.error?.toLowerCase();
+                                            if (lowerError?.includes('discovery') || lowerError?.includes('API') || lowerError?.includes('required fields')) {
+                                                reject(new Error(`API discovery failed: ${errorMessage}. This could be due to: network issues, invalid API key, or the Drive API not being enabled in your Google Cloud project.`));
+                                            }
+                                            else {
+                                                reject(new Error(err.error || err.details || 'Unknown error'));
+                                            }
+                                        });
+                                    });
+                                });
+                                // Verify Drive API is loaded
+                                if (!win.gapi?.client?.drive) {
+                                    // Try one more time with a longer wait
+                                    await new Promise((resolve, reject) => {
+                                        let attempts = 0;
+                                        const checkDrive = () => {
+                                            if (win.gapi?.client?.drive) {
+                                                resolve();
+                                            }
+                                            else if (attempts < 10) {
+                                                attempts++;
+                                                setTimeout(checkDrive, 200);
+                                            }
+                                            else {
+                                                reject(new Error('Failed to load Drive API. The discovery document may have failed to load. Check the browser console for network errors (502 Bad Gateway suggests a network issue).'));
+                                            }
+                                        };
+                                        checkDrive();
+                                    });
+                                }
+                            }
+                            if (!win.gapi?.client?.drive) {
+                                await writelnStderr(process, terminal, chalk.red('mount: Google Drive API is not available'));
+                                await writelnStderr(process, terminal, chalk.yellow('Troubleshooting steps:'));
+                                await writelnStderr(process, terminal, '  1. Check the browser console for network errors (502 Bad Gateway suggests a network/server issue)');
+                                await writelnStderr(process, terminal, '  2. Verify your API key is valid and has the Drive API enabled');
+                                await writelnStderr(process, terminal, '  3. Ensure the Drive API is enabled in your Google Cloud project');
+                                await writelnStderr(process, terminal, '  4. Check if there are any API key restrictions (HTTP referrers, IP addresses, etc.)');
+                                await writelnStderr(process, terminal, '  5. Try refreshing the page and mounting again');
+                                return 1;
+                            }
+                            // Handle OAuth authentication if clientId is provided
+                            if (mountOptions.clientId) {
+                                await writelnStdout(process, terminal, chalk.gray('Checking authentication status...'));
+                                const driveScope = mountOptions.scope || 'https://www.googleapis.com/auth/drive';
+                                // Check if user is already authenticated
+                                try {
+                                    const client = win.gapi?.client;
+                                    if (client?.request) {
+                                        await client.request({
+                                            path: 'https://www.googleapis.com/drive/v3/about?fields=user'
+                                        });
+                                    }
+                                }
+                                catch (error) {
+                                    // User needs to authenticate using Google Identity Services
+                                    await writelnStdout(process, terminal, chalk.gray('Authentication required. Please sign in to Google...'));
+                                    try {
+                                        if (!win.google?.accounts?.oauth2) {
+                                            throw new Error('Google Identity Services OAuth2 is not available');
+                                        }
+                                        await new Promise((resolve, reject) => {
+                                            const tokenClient = win.google?.accounts?.oauth2?.initTokenClient({
+                                                client_id: mountOptions.clientId,
+                                                scope: driveScope,
+                                                callback: (response) => {
+                                                    if (response.access_token && win.gapi?.client?.setToken) {
+                                                        win.gapi.client.setToken({ access_token: response.access_token });
+                                                        resolve();
+                                                    }
+                                                    else {
+                                                        reject(new Error('Failed to obtain access token'));
+                                                    }
+                                                },
+                                            });
+                                            tokenClient?.requestAccessToken();
+                                        });
+                                    }
+                                    catch (authError) {
+                                        const authErrMsg = authError instanceof Error ? authError.message : String(authError);
+                                        if (authErrMsg.toLowerCase().includes('popup') || authErrMsg.toLowerCase().includes('blocked')) {
+                                            throw new Error(`OAuth authentication failed: ${authErrMsg}. Please allow popups for this site.`);
+                                        }
+                                        else if (authErrMsg.toLowerCase().includes('origin') || authErrMsg.toLowerCase().includes('authorized')) {
+                                            throw new Error(`OAuth authentication failed: ${authErrMsg}. Your origin may not be authorized in Google Cloud Console. Add your current origin to the OAuth client's authorized JavaScript origins.`);
+                                        }
+                                        throw authError;
+                                    }
+                                }
+                            }
+                            const drive = win.gapi.client.drive;
+                            const cacheTTL = mountOptions.cacheTTL ? parseInt(mountOptions.cacheTTL) : undefined;
+                            await kernel.filesystem.fsSync.mount(target, await resolveMountConfig({
+                                backend: GoogleDrive,
+                                drive: drive,
+                                disableAsyncCache: true,
+                                ...(cacheTTL && !isNaN(cacheTTL) ? { cacheTTL } : {})
+                            }));
+                        }
+                        catch (error) {
+                            let errorMessage = 'Unknown error';
+                            if (error instanceof Error) {
+                                errorMessage = error.message || error.toString();
+                            }
+                            else if (typeof error === 'string') {
+                                errorMessage = error;
+                            }
+                            else if (error && typeof error === 'object') {
+                                // Try to extract error message from object
+                                const err = error;
+                                errorMessage =
+                                    (typeof err.message === 'string' ? err.message : '') ||
+                                        (typeof err.error === 'string' ? err.error : '') ||
+                                        (typeof err.details === 'string' ? err.details : '') ||
+                                        (typeof err.reason === 'string' ? err.reason : '') ||
+                                        (err.toString && typeof err.toString === 'function' ? err.toString() : '') ||
+                                        JSON.stringify(error);
+                            }
+                            else {
+                                errorMessage = String(error);
+                            }
+                            await writelnStderr(process, terminal, chalk.red(`mount: failed to mount googledrive filesystem: ${errorMessage}`));
+                            // Provide specific guidance for common errors
+                            const lowerMessage = errorMessage.toLowerCase();
+                            if (lowerMessage.includes('popup') || lowerMessage.includes('blocked')) {
+                                await writelnStderr(process, terminal, chalk.yellow('\nOAuth popup was blocked. Common causes:'));
+                                await writelnStderr(process, terminal, '  • Browser popup blocker is enabled');
+                                await writelnStderr(process, terminal, '  • Browser security restrictions');
+                                await writelnStderr(process, terminal, chalk.gray('\nTo fix this:'));
+                                await writelnStderr(process, terminal, '  1. Allow popups for this site in your browser settings');
+                                await writelnStderr(process, terminal, '  2. Try the mount command again');
+                            }
+                            else if (lowerMessage.includes('origin') || lowerMessage.includes('authorized')) {
+                                await writelnStderr(process, terminal, chalk.yellow('\nOAuth authentication failed. Common causes:'));
+                                await writelnStderr(process, terminal, '  • Your domain/origin is not authorized in Google Cloud Console');
+                                await writelnStderr(process, terminal, '  • Invalid or incorrect OAuth client ID');
+                                await writelnStderr(process, terminal, chalk.gray('\nTo fix this:'));
+                                await writelnStderr(process, terminal, '  1. Go to Google Cloud Console > APIs & Services > Credentials');
+                                await writelnStderr(process, terminal, '  2. Find your OAuth 2.0 Client ID');
+                                await writelnStderr(process, terminal, '  3. Add your current origin to "Authorized JavaScript origins"');
+                                await writelnStderr(process, terminal, '     (e.g., http://localhost:30443 or your domain)');
+                                await writelnStderr(process, terminal, '  4. If you only need read-only access, try mounting without clientId:');
+                                await writelnStderr(process, terminal, '     mount -t googledrive /mnt/gdrive -o apiKey=YOUR_API_KEY');
+                            }
+                            else if (lowerMessage.includes('discovery') || lowerMessage.includes('api discovery') || lowerMessage.includes('required fields')) {
+                                await writelnStderr(process, terminal, chalk.yellow('\nThe Drive API discovery document failed to load. Common causes:'));
+                                await writelnStderr(process, terminal, '  • Network connectivity issues (check for 502 Bad Gateway in console)');
+                                await writelnStderr(process, terminal, '  • Invalid or restricted API key');
+                                await writelnStderr(process, terminal, '  • Drive API not enabled in Google Cloud project');
+                                await writelnStderr(process, terminal, '  • CORS or browser security restrictions');
+                                await writelnStderr(process, terminal, chalk.gray('\nCheck the browser console for detailed network error messages.'));
+                            }
+                            else if (lowerMessage.includes('network') || lowerMessage.includes('fetch') || lowerMessage.includes('502') || lowerMessage.includes('bad gateway')) {
+                                await writelnStderr(process, terminal, chalk.yellow('\nNetwork error detected. This may be a temporary issue with Google\'s servers.'));
+                                await writelnStderr(process, terminal, '  • Wait a few moments and try again');
+                                await writelnStderr(process, terminal, '  • Check your internet connection');
+                                await writelnStderr(process, terminal, '  • Verify the API key is correct');
+                            }
+                            // Show full error details if it's an object (for debugging)
+                            if (error && typeof error === 'object' && !(error instanceof Error)) {
+                                try {
+                                    const errorStr = JSON.stringify(error, null, 2);
+                                    if (errorStr !== '{}' && errorStr.length < 500) {
+                                        await writelnStderr(process, terminal, chalk.gray(`\nError details:\n${errorStr}`));
+                                    }
+                                }
+                                catch {
+                                    // Ignore JSON stringify errors
+                                }
+                            }
+                            if (error instanceof Error && error.stack && !lowerMessage.includes('discovery') && !lowerMessage.includes('network')) {
+                                await writelnStderr(process, terminal, chalk.gray(`\nStack trace:\n${error.stack}`));
+                            }
+                            return 1;
+                        }
+                        break;
+                    }
+                    default:
+                        await writelnStderr(process, terminal, chalk.red(`mount: unknown filesystem type '${type}'`));
+                        await writelnStderr(process, terminal, 'Supported types: fetch, indexeddb, webstorage, webaccess, memory, singlebuffer, zip, iso, dropbox, s3, googledrive');
+                        return 1;
+                }
+                const successMessage = source
+                    ? chalk.green(`Mounted ${type} filesystem from ${source} to ${target}`)
+                    : chalk.green(`Mounted ${type} filesystem at ${target}`);
+                await writelnStdout(process, terminal, successMessage);
+                return 0;
+            }
+            catch (error) {
+                await writelnStderr(process, terminal, chalk.red(`mount: failed to mount filesystem: ${error instanceof Error ? error.message : 'Unknown error'}`));
+                return 1;
+            }
+        }
+    });
+}
+//# sourceMappingURL=mount.js.map