@hibanacloud/core 0.3.15

package/dist/src/utils/systemEncoding.js

@@ -0,0 +1,149 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { execSync } from 'node:child_process';
+import os from 'node:os';
+import { detect as chardetDetect } from 'chardet';
+// Cache for system encoding to avoid repeated detection
+// Use undefined to indicate "not yet checked" vs null meaning "checked but failed"
+let cachedSystemEncoding = undefined;
+/**
+ * Reset the encoding cache - useful for testing
+ */
+export function resetEncodingCache() {
+    cachedSystemEncoding = undefined;
+}
+/**
+ * Returns the system encoding, caching the result to avoid repeated system calls.
+ * If system encoding detection fails, falls back to detecting from the provided buffer.
+ * Note: Only the system encoding is cached - buffer-based detection runs for each buffer
+ * since different buffers may have different encodings.
+ * @param buffer A buffer to use for detecting encoding if system detection fails.
+ */
+export function getCachedEncodingForBuffer(buffer) {
+    // Cache system encoding detection since it's system-wide
+    if (cachedSystemEncoding === undefined) {
+        cachedSystemEncoding = getSystemEncoding();
+    }
+    // If we have a cached system encoding, use it
+    if (cachedSystemEncoding) {
+        return cachedSystemEncoding;
+    }
+    // Otherwise, detect from this specific buffer (don't cache this result)
+    return detectEncodingFromBuffer(buffer) || 'utf-8';
+}
+/**
+ * Detects the system encoding based on the platform.
+ * For Windows, it uses the 'chcp' command to get the current code page.
+ * For Unix-like systems, it checks environment variables like LC_ALL, LC_CTYPE, and LANG.
+ * If those are not set, it tries to run 'locale charmap' to get the encoding.
+ * If detection fails, it returns null.
+ * @returns The system encoding as a string, or null if detection fails.
+ */
+export function getSystemEncoding() {
+    // Windows
+    if (os.platform() === 'win32') {
+        try {
+            const output = execSync('chcp', { encoding: 'utf8' });
+            const match = output.match(/:\s*(\d+)/);
+            if (match) {
+                const codePage = parseInt(match[1], 10);
+                if (!isNaN(codePage)) {
+                    return windowsCodePageToEncoding(codePage);
+                }
+            }
+            // Only warn if we can't parse the output format, not if windowsCodePageToEncoding fails
+            throw new Error(`Unable to parse Windows code page from 'chcp' output "${output.trim()}". `);
+        }
+        catch (error) {
+            console.warn(`Failed to get Windows code page using 'chcp' command: ${error instanceof Error ? error.message : String(error)}. ` +
+                `Will attempt to detect encoding from command output instead.`);
+        }
+        return null;
+    }
+    // Unix-like
+    // Use environment variables LC_ALL, LC_CTYPE, and LANG to determine the
+    // system encoding. However, these environment variables might not always
+    // be set or accurate. Handle cases where none of these variables are set.
+    const env = process.env;
+    let locale = env['LC_ALL'] || env['LC_CTYPE'] || env['LANG'] || '';
+    // Fallback to querying the system directly when environment variables are missing
+    if (!locale) {
+        try {
+            locale = execSync('locale charmap', { encoding: 'utf8' })
+                .toString()
+                .trim();
+        }
+        catch (_e) {
+            console.warn('Failed to get locale charmap.');
+            return null;
+        }
+    }
+    const match = locale.match(/\.(.+)/); // e.g., "en_US.UTF-8"
+    if (match && match[1]) {
+        return match[1].toLowerCase();
+    }
+    // Handle cases where locale charmap returns just the encoding name (e.g., "UTF-8")
+    if (locale && !locale.includes('.')) {
+        return locale.toLowerCase();
+    }
+    return null;
+}
+/**
+ * Converts a Windows code page number to a corresponding encoding name.
+ * @param cp The Windows code page number (e.g., 437, 850, etc.)
+ * @returns The corresponding encoding name as a string, or null if no mapping exists.
+ */
+export function windowsCodePageToEncoding(cp) {
+    // Most common mappings; extend as needed
+    const map = {
+        437: 'cp437',
+        850: 'cp850',
+        852: 'cp852',
+        866: 'cp866',
+        874: 'windows-874',
+        932: 'shift_jis',
+        936: 'gb2312',
+        949: 'euc-kr',
+        950: 'big5',
+        1200: 'utf-16le',
+        1201: 'utf-16be',
+        1250: 'windows-1250',
+        1251: 'windows-1251',
+        1252: 'windows-1252',
+        1253: 'windows-1253',
+        1254: 'windows-1254',
+        1255: 'windows-1255',
+        1256: 'windows-1256',
+        1257: 'windows-1257',
+        1258: 'windows-1258',
+        65001: 'utf-8',
+    };
+    if (map[cp]) {
+        return map[cp];
+    }
+    console.warn(`Unable to determine encoding for windows code page ${cp}.`);
+    return null; // Return null if no mapping found
+}
+/**
+ * Attempts to detect encoding from a buffer using chardet.
+ * This is useful when system encoding detection fails.
+ * Returns the detected encoding in lowercase, or null if detection fails.
+ * @param buffer The buffer to analyze for encoding.
+ * @return The detected encoding as a lowercase string, or null if detection fails.
+ */
+export function detectEncodingFromBuffer(buffer) {
+    try {
+        const detected = chardetDetect(buffer);
+        if (detected && typeof detected === 'string') {
+            return detected.toLowerCase();
+        }
+    }
+    catch (error) {
+        console.warn('Failed to detect encoding with chardet:', error);
+    }
+    return null;
+}
+//# sourceMappingURL=systemEncoding.js.map

package/dist/src/utils/systemEncoding.js.map

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

package/dist/src/utils/systemEncoding.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/utils/systemEncoding.test.js

@@ -0,0 +1,368 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { vi, describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { execSync } from 'node:child_process';
+import * as os from 'node:os';
+import { detect as chardetDetect } from 'chardet';
+// Mock dependencies
+vi.mock('child_process');
+vi.mock('os');
+vi.mock('chardet');
+// Import the functions we want to test after refactoring
+import { getCachedEncodingForBuffer, getSystemEncoding, windowsCodePageToEncoding, detectEncodingFromBuffer, resetEncodingCache, } from './systemEncoding.js';
+describe('Shell Command Processor - Encoding Functions', () => {
+    let consoleWarnSpy;
+    let mockedExecSync;
+    let mockedOsPlatform;
+    let mockedChardetDetect;
+    beforeEach(() => {
+        consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        mockedExecSync = vi.mocked(execSync);
+        mockedOsPlatform = vi.mocked(os.platform);
+        mockedChardetDetect = vi.mocked(chardetDetect);
+        // Reset the encoding cache before each test
+        resetEncodingCache();
+        // Clear environment variables that might affect tests
+        delete process.env['LC_ALL'];
+        delete process.env['LC_CTYPE'];
+        delete process.env['LANG'];
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        resetEncodingCache();
+    });
+    describe('windowsCodePageToEncoding', () => {
+        it('should map common Windows code pages correctly', () => {
+            expect(windowsCodePageToEncoding(437)).toBe('cp437');
+            expect(windowsCodePageToEncoding(850)).toBe('cp850');
+            expect(windowsCodePageToEncoding(65001)).toBe('utf-8');
+            expect(windowsCodePageToEncoding(1252)).toBe('windows-1252');
+            expect(windowsCodePageToEncoding(932)).toBe('shift_jis');
+            expect(windowsCodePageToEncoding(936)).toBe('gb2312');
+            expect(windowsCodePageToEncoding(949)).toBe('euc-kr');
+            expect(windowsCodePageToEncoding(950)).toBe('big5');
+            expect(windowsCodePageToEncoding(1200)).toBe('utf-16le');
+            expect(windowsCodePageToEncoding(1201)).toBe('utf-16be');
+        });
+        it('should return null for unmapped code pages and warn', () => {
+            expect(windowsCodePageToEncoding(99999)).toBe(null);
+            expect(consoleWarnSpy).toHaveBeenCalledWith('Unable to determine encoding for windows code page 99999.');
+        });
+        it('should handle all Windows-specific code pages', () => {
+            expect(windowsCodePageToEncoding(874)).toBe('windows-874');
+            expect(windowsCodePageToEncoding(1250)).toBe('windows-1250');
+            expect(windowsCodePageToEncoding(1251)).toBe('windows-1251');
+            expect(windowsCodePageToEncoding(1253)).toBe('windows-1253');
+            expect(windowsCodePageToEncoding(1254)).toBe('windows-1254');
+            expect(windowsCodePageToEncoding(1255)).toBe('windows-1255');
+            expect(windowsCodePageToEncoding(1256)).toBe('windows-1256');
+            expect(windowsCodePageToEncoding(1257)).toBe('windows-1257');
+            expect(windowsCodePageToEncoding(1258)).toBe('windows-1258');
+        });
+    });
+    describe('detectEncodingFromBuffer', () => {
+        it('should detect encoding using chardet successfully', () => {
+            const buffer = Buffer.from('test content', 'utf8');
+            mockedChardetDetect.mockReturnValue('UTF-8');
+            const result = detectEncodingFromBuffer(buffer);
+            expect(result).toBe('utf-8');
+            expect(mockedChardetDetect).toHaveBeenCalledWith(buffer);
+        });
+        it('should handle chardet returning mixed case encoding', () => {
+            const buffer = Buffer.from('test content', 'utf8');
+            mockedChardetDetect.mockReturnValue('ISO-8859-1');
+            const result = detectEncodingFromBuffer(buffer);
+            expect(result).toBe('iso-8859-1');
+        });
+        it('should return null when chardet fails', () => {
+            const buffer = Buffer.from('test content', 'utf8');
+            mockedChardetDetect.mockImplementation(() => {
+                throw new Error('Detection failed');
+            });
+            const result = detectEncodingFromBuffer(buffer);
+            expect(result).toBe(null);
+            expect(consoleWarnSpy).toHaveBeenCalledWith('Failed to detect encoding with chardet:', expect.any(Error));
+        });
+        it('should return null when chardet returns null', () => {
+            const buffer = Buffer.from('test content', 'utf8');
+            mockedChardetDetect.mockReturnValue(null);
+            const result = detectEncodingFromBuffer(buffer);
+            expect(result).toBe(null);
+        });
+        it('should return null when chardet returns non-string', () => {
+            const buffer = Buffer.from('test content', 'utf8');
+            mockedChardetDetect.mockReturnValue([
+                'utf-8',
+                'iso-8859-1',
+            ]);
+            const result = detectEncodingFromBuffer(buffer);
+            expect(result).toBe(null);
+        });
+    });
+    describe('getSystemEncoding - Windows', () => {
+        beforeEach(() => {
+            mockedOsPlatform.mockReturnValue('win32');
+        });
+        it('should parse Windows chcp output correctly', () => {
+            mockedExecSync.mockReturnValue('Active code page: 65001');
+            const result = getSystemEncoding();
+            expect(result).toBe('utf-8');
+            expect(mockedExecSync).toHaveBeenCalledWith('chcp', { encoding: 'utf8' });
+        });
+        it('should handle different chcp output formats', () => {
+            mockedExecSync.mockReturnValue('Current code page: 1252');
+            const result = getSystemEncoding();
+            expect(result).toBe('windows-1252');
+        });
+        it('should handle chcp output with extra whitespace', () => {
+            mockedExecSync.mockReturnValue('Active code page:   437   ');
+            const result = getSystemEncoding();
+            expect(result).toBe('cp437');
+        });
+        it('should return null when chcp command fails', () => {
+            mockedExecSync.mockImplementation(() => {
+                throw new Error('Command failed');
+            });
+            const result = getSystemEncoding();
+            expect(result).toBe(null);
+            expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Failed to get Windows code page using 'chcp' command"));
+        });
+        it('should return null when chcp output cannot be parsed', () => {
+            mockedExecSync.mockReturnValue('Unexpected output format');
+            const result = getSystemEncoding();
+            expect(result).toBe(null);
+            expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Failed to get Windows code page using 'chcp' command"));
+        });
+        it('should return null when code page is not a number', () => {
+            mockedExecSync.mockReturnValue('Active code page: abc');
+            const result = getSystemEncoding();
+            expect(result).toBe(null);
+            expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining("Failed to get Windows code page using 'chcp' command"));
+        });
+        it('should return null when code page maps to null', () => {
+            mockedExecSync.mockReturnValue('Active code page: 99999');
+            const result = getSystemEncoding();
+            expect(result).toBe(null);
+            // Should warn about unknown code page from windowsCodePageToEncoding
+            expect(consoleWarnSpy).toHaveBeenCalledWith('Unable to determine encoding for windows code page 99999.');
+        });
+    });
+    describe('getSystemEncoding - Unix-like', () => {
+        beforeEach(() => {
+            mockedOsPlatform.mockReturnValue('linux');
+        });
+        it('should parse locale from LC_ALL environment variable', () => {
+            process.env['LC_ALL'] = 'en_US.UTF-8';
+            const result = getSystemEncoding();
+            expect(result).toBe('utf-8');
+        });
+        it('should parse locale from LC_CTYPE when LC_ALL is not set', () => {
+            process.env['LC_CTYPE'] = 'fr_FR.ISO-8859-1';
+            const result = getSystemEncoding();
+            expect(result).toBe('iso-8859-1');
+        });
+        it('should parse locale from LANG when LC_ALL and LC_CTYPE are not set', () => {
+            process.env['LANG'] = 'de_DE.UTF-8';
+            const result = getSystemEncoding();
+            expect(result).toBe('utf-8');
+        });
+        it('should handle locale charmap command when environment variables are empty', () => {
+            mockedExecSync.mockReturnValue('UTF-8\n');
+            const result = getSystemEncoding();
+            expect(result).toBe('utf-8');
+            expect(mockedExecSync).toHaveBeenCalledWith('locale charmap', {
+                encoding: 'utf8',
+            });
+        });
+        it('should handle locale charmap with mixed case', () => {
+            mockedExecSync.mockReturnValue('ISO-8859-1\n');
+            const result = getSystemEncoding();
+            expect(result).toBe('iso-8859-1');
+        });
+        it('should return null when locale charmap fails', () => {
+            mockedExecSync.mockImplementation(() => {
+                throw new Error('Command failed');
+            });
+            const result = getSystemEncoding();
+            expect(result).toBe(null);
+            expect(consoleWarnSpy).toHaveBeenCalledWith('Failed to get locale charmap.');
+        });
+        it('should handle locale without encoding (no dot)', () => {
+            process.env['LANG'] = 'C';
+            const result = getSystemEncoding();
+            expect(result).toBe('c');
+        });
+        it('should handle empty locale environment variables', () => {
+            process.env['LC_ALL'] = '';
+            process.env['LC_CTYPE'] = '';
+            process.env['LANG'] = '';
+            mockedExecSync.mockReturnValue('UTF-8');
+            const result = getSystemEncoding();
+            expect(result).toBe('utf-8');
+        });
+        it('should return locale as-is when locale format has no dot', () => {
+            process.env['LANG'] = 'invalid_format';
+            const result = getSystemEncoding();
+            expect(result).toBe('invalid_format');
+        });
+        it('should prioritize LC_ALL over other environment variables', () => {
+            process.env['LC_ALL'] = 'en_US.UTF-8';
+            process.env['LC_CTYPE'] = 'fr_FR.ISO-8859-1';
+            process.env['LANG'] = 'de_DE.CP1252';
+            const result = getSystemEncoding();
+            expect(result).toBe('utf-8');
+        });
+        it('should prioritize LC_CTYPE over LANG', () => {
+            process.env['LC_CTYPE'] = 'fr_FR.ISO-8859-1';
+            process.env['LANG'] = 'de_DE.CP1252';
+            const result = getSystemEncoding();
+            expect(result).toBe('iso-8859-1');
+        });
+    });
+    describe('getEncodingForBuffer', () => {
+        beforeEach(() => {
+            mockedOsPlatform.mockReturnValue('linux');
+        });
+        it('should use cached system encoding on subsequent calls', () => {
+            process.env['LANG'] = 'en_US.UTF-8';
+            const buffer = Buffer.from('test');
+            // First call
+            const result1 = getCachedEncodingForBuffer(buffer);
+            expect(result1).toBe('utf-8');
+            // Change environment (should not affect cached result)
+            process.env['LANG'] = 'fr_FR.ISO-8859-1';
+            // Second call should use cached value
+            const result2 = getCachedEncodingForBuffer(buffer);
+            expect(result2).toBe('utf-8');
+        });
+        it('should fall back to buffer detection when system encoding fails', () => {
+            // No environment variables set
+            mockedExecSync.mockImplementation(() => {
+                throw new Error('locale command failed');
+            });
+            const buffer = Buffer.from('test');
+            mockedChardetDetect.mockReturnValue('ISO-8859-1');
+            const result = getCachedEncodingForBuffer(buffer);
+            expect(result).toBe('iso-8859-1');
+            expect(mockedChardetDetect).toHaveBeenCalledWith(buffer);
+        });
+        it('should fall back to utf-8 when both system and buffer detection fail', () => {
+            // System encoding fails
+            mockedExecSync.mockImplementation(() => {
+                throw new Error('locale command failed');
+            });
+            // Buffer detection fails
+            mockedChardetDetect.mockImplementation(() => {
+                throw new Error('chardet failed');
+            });
+            const buffer = Buffer.from('test');
+            const result = getCachedEncodingForBuffer(buffer);
+            expect(result).toBe('utf-8');
+        });
+        it('should not cache buffer detection results', () => {
+            // System encoding fails initially
+            mockedExecSync.mockImplementation(() => {
+                throw new Error('locale command failed');
+            });
+            const buffer1 = Buffer.from('test1');
+            const buffer2 = Buffer.from('test2');
+            mockedChardetDetect
+                .mockReturnValueOnce('ISO-8859-1')
+                .mockReturnValueOnce('UTF-16');
+            const result1 = getCachedEncodingForBuffer(buffer1);
+            const result2 = getCachedEncodingForBuffer(buffer2);
+            expect(result1).toBe('iso-8859-1');
+            expect(result2).toBe('utf-16');
+            expect(mockedChardetDetect).toHaveBeenCalledTimes(2);
+        });
+        it('should handle Windows system encoding', () => {
+            mockedOsPlatform.mockReturnValue('win32');
+            mockedExecSync.mockReturnValue('Active code page: 1252');
+            const buffer = Buffer.from('test');
+            const result = getCachedEncodingForBuffer(buffer);
+            expect(result).toBe('windows-1252');
+        });
+        it('should cache null system encoding result', () => {
+            // Reset the cache specifically for this test
+            resetEncodingCache();
+            // Ensure we're on Unix-like for this test
+            mockedOsPlatform.mockReturnValue('linux');
+            // System encoding detection returns null
+            mockedExecSync.mockImplementation(() => {
+                throw new Error('locale command failed');
+            });
+            const buffer1 = Buffer.from('test1');
+            const buffer2 = Buffer.from('test2');
+            mockedChardetDetect
+                .mockReturnValueOnce('ISO-8859-1')
+                .mockReturnValueOnce('UTF-16');
+            // Clear any previous calls from beforeEach setup or previous tests
+            mockedExecSync.mockClear();
+            const result1 = getCachedEncodingForBuffer(buffer1);
+            const result2 = getCachedEncodingForBuffer(buffer2);
+            // Should call execSync only once due to caching (null result is cached)
+            expect(mockedExecSync).toHaveBeenCalledTimes(1);
+            expect(result1).toBe('iso-8859-1');
+            expect(result2).toBe('utf-16');
+            // Call a third time to verify cache is still used
+            const buffer3 = Buffer.from('test3');
+            mockedChardetDetect.mockReturnValueOnce('UTF-32');
+            const result3 = getCachedEncodingForBuffer(buffer3);
+            // Still should be only one call to execSync
+            expect(mockedExecSync).toHaveBeenCalledTimes(1);
+            expect(result3).toBe('utf-32');
+        });
+    });
+    describe('Cross-platform behavior', () => {
+        it('should work correctly on macOS', () => {
+            mockedOsPlatform.mockReturnValue('darwin');
+            process.env['LANG'] = 'en_US.UTF-8';
+            const result = getSystemEncoding();
+            expect(result).toBe('utf-8');
+        });
+        it('should work correctly on other Unix-like systems', () => {
+            mockedOsPlatform.mockReturnValue('freebsd');
+            process.env['LANG'] = 'en_US.UTF-8';
+            const result = getSystemEncoding();
+            expect(result).toBe('utf-8');
+        });
+        it('should handle unknown platforms as Unix-like', () => {
+            mockedOsPlatform.mockReturnValue('unknown');
+            process.env['LANG'] = 'en_US.UTF-8';
+            const result = getSystemEncoding();
+            expect(result).toBe('utf-8');
+        });
+    });
+    describe('Edge cases and error handling', () => {
+        it('should handle empty buffer gracefully', () => {
+            mockedOsPlatform.mockReturnValue('linux');
+            process.env['LANG'] = 'en_US.UTF-8';
+            const buffer = Buffer.alloc(0);
+            const result = getCachedEncodingForBuffer(buffer);
+            expect(result).toBe('utf-8');
+        });
+        it('should handle very large buffers', () => {
+            mockedOsPlatform.mockReturnValue('linux');
+            process.env['LANG'] = 'en_US.UTF-8';
+            const buffer = Buffer.alloc(1024 * 1024, 'a');
+            const result = getCachedEncodingForBuffer(buffer);
+            expect(result).toBe('utf-8');
+        });
+        it('should handle Unicode content', () => {
+            mockedOsPlatform.mockReturnValue('linux');
+            const unicodeText = '你好世界 🌍 ñoño';
+            // System encoding fails
+            mockedExecSync.mockImplementation(() => {
+                throw new Error('locale command failed');
+            });
+            mockedChardetDetect.mockReturnValue('UTF-8');
+            const buffer = Buffer.from(unicodeText, 'utf8');
+            const result = getCachedEncodingForBuffer(buffer);
+            expect(result).toBe('utf-8');
+        });
+    });
+});
+//# sourceMappingURL=systemEncoding.test.js.map

package/dist/src/utils/systemEncoding.test.js.map

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

package/dist/src/utils/terminalSerializer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Terminal } from '@xterm/headless';
+export interface AnsiToken {
+    text: string;
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    dim: boolean;
+    inverse: boolean;
+    fg: string;
+    bg: string;
+}
+export type AnsiLine = AnsiToken[];
+export type AnsiOutput = AnsiLine[];
+export declare const enum ColorMode {
+    DEFAULT = 0,
+    PALETTE = 1,
+    RGB = 2
+}
+export declare function serializeTerminalToObject(terminal: Terminal): AnsiOutput;
+export declare function convertColorToHex(color: number, colorMode: ColorMode, defaultColor: string): string;