@jshookmcp/jshook 0.1.7 → 0.1.9

package/dist/tests/server/domains/encoding/format.test.js

@@ -0,0 +1,433 @@
+import { describe, it, expect } from 'vitest';
+import { EncodingToolHandlersFormat } from '../../../../src/server/domains/encoding/handlers.impl.core.runtime.format.js';
+class TestableFormat extends EncodingToolHandlersFormat {
+    constructor() {
+        super(null);
+    }
+    isMostlyPrintableText(text) {
+        return super.isMostlyPrintableText(text);
+    }
+    previewHex(buffer, maxBytes) {
+        return super.previewHex(buffer, maxBytes);
+    }
+    hexDump(buffer, bytesPerRow) {
+        return super.hexDump(buffer, bytesPerRow);
+    }
+    decodeHexString(value) {
+        return super.decodeHexString(value);
+    }
+    decodeBase64String(value) {
+        return super.decodeBase64String(value);
+    }
+    decodeBinaryAuto(value) {
+        return super.decodeBinaryAuto(value);
+    }
+    looksLikeHex(value) {
+        return super.looksLikeHex(value);
+    }
+    looksLikeBase64(value) {
+        return super.looksLikeBase64(value);
+    }
+    looksLikeUrlEncoded(value) {
+        return super.looksLikeUrlEncoded(value);
+    }
+    decodeUrl(value) {
+        return super.decodeUrl(value);
+    }
+    encodeUrlBytes(buffer) {
+        return super.encodeUrlBytes(buffer);
+    }
+    toSafeUtf8(buffer) {
+        return super.toSafeUtf8(buffer);
+    }
+    tryParseJson(text) {
+        return super.tryParseJson(text);
+    }
+    renderDecodedOutput(params) {
+        return super.renderDecodedOutput(params);
+    }
+    ok(payload) {
+        return super.ok(payload);
+    }
+    fail(tool, error) {
+        return super.fail(tool, error);
+    }
+}
+const format = new TestableFormat();
+describe('EncodingToolHandlersFormat (pure utility methods)', () => {
+    describe('isMostlyPrintableText', () => {
+        it('returns true for empty string', () => {
+            expect(format.isMostlyPrintableText('')).toBe(true);
+        });
+        it('returns true for all printable ASCII text', () => {
+            expect(format.isMostlyPrintableText('Hello, world!')).toBe(true);
+        });
+        it('treats tab/newline/carriage-return as printable', () => {
+            expect(format.isMostlyPrintableText('line1\nline2\tend\r')).toBe(true);
+        });
+        it('returns false when printable ratio is below 85%', () => {
+            const text = 'A'.repeat(16) + '\u0000'.repeat(4);
+            expect(format.isMostlyPrintableText(text)).toBe(false);
+        });
+        it('returns true exactly at the 85% boundary', () => {
+            const text = 'A'.repeat(17) + '\u0000'.repeat(3);
+            expect(format.isMostlyPrintableText(text)).toBe(true);
+        });
+        it('does not count non-ASCII unicode as printable', () => {
+            expect(format.isMostlyPrintableText('你好')).toBe(false);
+        });
+    });
+    describe('previewHex', () => {
+        it('returns empty string for empty buffer', () => {
+            expect(format.previewHex(Buffer.alloc(0), 16)).toBe('');
+        });
+        it('returns empty string when maxBytes is 0', () => {
+            expect(format.previewHex(Buffer.from([0x00, 0x01]), 0)).toBe('');
+        });
+        it('formats short buffer as two-digit lowercase hex bytes separated by spaces', () => {
+            expect(format.previewHex(Buffer.from([0x00, 0x01, 0xff]), 10)).toBe('00 01 ff');
+        });
+        it('truncates output at maxBytes', () => {
+            expect(format.previewHex(Buffer.from([0x00, 0x01, 0x02, 0x03, 0x04]), 3)).toBe('00 01 02');
+        });
+        it('does not add extra spaces for a single byte', () => {
+            expect(format.previewHex(Buffer.from([0xab]), 1)).toBe('ab');
+        });
+    });
+    describe('hexDump', () => {
+        it('returns empty string for empty buffer', () => {
+            expect(format.hexDump(Buffer.alloc(0))).toBe('');
+        });
+        it('dumps a single 16-byte row with correct offset, hex, and ASCII columns', () => {
+            const buffer = Buffer.from('0123456789abcdef', 'ascii');
+            const expected = '00000000  30 31 32 33 34 35 36 37 38 39 61 62 63 64 65 66  |0123456789abcdef|';
+            expect(format.hexDump(buffer)).toBe(expected);
+        });
+        it("renders non-printable bytes as '.' in ASCII column", () => {
+            const buffer = Buffer.from([0x41, 0x00, 0x42, 0x7f, 0x20, 0xff]);
+            const dump = format.hexDump(buffer);
+            expect(dump).toMatch(/^00000000  41 00 42 7f 20 ff\s+\|A\.B\. \.\|$/);
+        });
+        it('produces multiple rows when buffer exceeds bytesPerRow', () => {
+            const buffer = Buffer.from([...Array.from({ length: 20 }, (_, i) => i)]);
+            const dump = format.hexDump(buffer);
+            const lines = dump.split('\n');
+            expect(lines).toHaveLength(2);
+            expect(lines[0]).toContain('00000000');
+            expect(lines[0]).toContain('|................|');
+            expect(lines[1]).toContain('00000010');
+            expect(lines[1]).toContain('|....|');
+        });
+        it('supports custom bytesPerRow', () => {
+            const buffer = Buffer.from([...Array.from({ length: 9 }, (_, i) => i)]);
+            const dump = format.hexDump(buffer, 8);
+            const lines = dump.split('\n');
+            expect(lines).toHaveLength(2);
+            expect(lines[0]).toContain('00000000');
+            expect(lines[1]).toContain('00000008');
+        });
+        it('uses lowercase hex in the hex column', () => {
+            const dump = format.hexDump(Buffer.from([0xab]));
+            expect(dump).toContain('ab');
+        });
+        it('pads the hex column for short rows before the ASCII column', () => {
+            const dump = format.hexDump(Buffer.from('Hi', 'ascii'));
+            expect(dump).toMatch(/00000000  48 69\s{2,}\|Hi\|$/);
+        });
+        it('does not end with a trailing newline', () => {
+            const buffer = Buffer.from([...Array.from({ length: 32 }, (_, i) => i)]);
+            const dump = format.hexDump(buffer);
+            expect(dump.endsWith('\n')).toBe(false);
+        });
+    });
+    describe('decodeHexString', () => {
+        it('decodes a plain hex string', () => {
+            expect(format.decodeHexString('deadbeef')).toEqual(Buffer.from('deadbeef', 'hex'));
+        });
+        it('decodes uppercase hex string', () => {
+            expect(format.decodeHexString('DEADBEEF')).toEqual(Buffer.from('deadbeef', 'hex'));
+        });
+        it('decodes hex with 0x prefix', () => {
+            expect(format.decodeHexString('0xdeadbeef')).toEqual(Buffer.from('deadbeef', 'hex'));
+        });
+        it('decodes hex with 0X prefix and embedded spaces', () => {
+            expect(format.decodeHexString('0XDE AD BE EF')).toEqual(Buffer.from('deadbeef', 'hex'));
+        });
+        it('decodes colon-separated hex', () => {
+            expect(format.decodeHexString('de:ad:be:ef')).toEqual(Buffer.from('deadbeef', 'hex'));
+        });
+        it('decodes hex with mixed separators (spaces, hyphens, commas)', () => {
+            expect(format.decodeHexString('de-ad be,ef')).toEqual(Buffer.from('deadbeef', 'hex'));
+        });
+        it('returns empty buffer for empty string', () => {
+            expect(format.decodeHexString('')).toEqual(Buffer.alloc(0));
+        });
+        it('returns empty buffer for whitespace-only string', () => {
+            expect(format.decodeHexString('   \n\t  ')).toEqual(Buffer.alloc(0));
+        });
+        it('returns empty buffer for only 0x prefix', () => {
+            expect(format.decodeHexString('0x')).toEqual(Buffer.alloc(0));
+        });
+        it('throws on odd-length hex', () => {
+            expect(() => format.decodeHexString('abc')).toThrow('Invalid hex string');
+        });
+        it('throws on non-hex characters', () => {
+            expect(() => format.decodeHexString('0x0g')).toThrow('Invalid hex string');
+        });
+        it('throws when separators are not recognized (e.g., underscore)', () => {
+            expect(() => format.decodeHexString('aabb__ccdd')).toThrow('Invalid hex string');
+        });
+    });
+    describe('decodeBase64String', () => {
+        it('decodes valid base64', () => {
+            expect(format.decodeBase64String('aGVsbG8=')).toEqual(Buffer.from('hello', 'utf8'));
+        });
+        it('decodes base64 containing spaces', () => {
+            expect(format.decodeBase64String('aGVs bG8=')).toEqual(Buffer.from('hello', 'utf8'));
+        });
+        it('decodes base64 containing newlines and tabs', () => {
+            expect(format.decodeBase64String('aGVs\n\tbG8=')).toEqual(Buffer.from('hello', 'utf8'));
+        });
+        it('returns empty buffer for empty string', () => {
+            expect(format.decodeBase64String('')).toEqual(Buffer.alloc(0));
+        });
+        it('returns empty buffer for whitespace-only string', () => {
+            expect(format.decodeBase64String('   \n\t  ')).toEqual(Buffer.alloc(0));
+        });
+        it('throws on invalid characters', () => {
+            expect(() => format.decodeBase64String('aGVsbG8$')).toThrow('Invalid base64 string');
+        });
+        it('throws when length is not a multiple of 4', () => {
+            expect(() => format.decodeBase64String('aGVsbG8')).toThrow('Invalid base64 string');
+        });
+        it('throws on non-canonical base64 (roundtrip mismatch)', () => {
+            expect(() => format.decodeBase64String('Zm9=')).toThrow('Invalid base64 string');
+        });
+        it('throws on base64url-like alphabet characters', () => {
+            expect(() => format.decodeBase64String('-w==')).toThrow('Invalid base64 string');
+            expect(() => format.decodeBase64String('_w==')).toThrow('Invalid base64 string');
+        });
+    });
+    describe('decodeBinaryAuto', () => {
+        it('returns empty buffer for empty string', () => {
+            expect(format.decodeBinaryAuto('')).toEqual(Buffer.alloc(0));
+        });
+        it('returns empty buffer for whitespace-only string', () => {
+            expect(format.decodeBinaryAuto('   \n\t  ')).toEqual(Buffer.alloc(0));
+        });
+        it('auto-detects hex (0x prefix)', () => {
+            expect(format.decodeBinaryAuto('0x666f6f')).toEqual(Buffer.from('foo', 'utf8'));
+        });
+        it('auto-detects hex with separators', () => {
+            expect(format.decodeBinaryAuto('66 6f 6f')).toEqual(Buffer.from('foo', 'utf8'));
+        });
+        it('auto-detects base64', () => {
+            expect(format.decodeBinaryAuto('Zm9v')).toEqual(Buffer.from('foo', 'utf8'));
+        });
+        it('auto-detects base64 with whitespace', () => {
+            expect(format.decodeBinaryAuto('Zm 9v')).toEqual(Buffer.from('foo', 'utf8'));
+        });
+        it('falls back to utf8 for plain strings', () => {
+            expect(format.decodeBinaryAuto('hello')).toEqual(Buffer.from('hello', 'utf8'));
+        });
+        it('trims input before utf8 fallback', () => {
+            expect(format.decodeBinaryAuto('  hello  ')).toEqual(Buffer.from('hello', 'utf8'));
+        });
+        it('prefers hex over base64 when both could match', () => {
+            expect(format.decodeBinaryAuto('deadbeef')).toEqual(Buffer.from('deadbeef', 'hex'));
+        });
+        it('treats invalid base64 as utf8 (no throw)', () => {
+            expect(format.decodeBinaryAuto('Zm9=')).toEqual(Buffer.from('Zm9=', 'utf8'));
+        });
+    });
+    describe('looksLikeHex', () => {
+        it('returns true for a valid hex string', () => {
+            expect(format.looksLikeHex('deadbeef')).toBe(true);
+        });
+        it('returns true for uppercase hex', () => {
+            expect(format.looksLikeHex('DEADBEEF')).toBe(true);
+        });
+        it('returns true for 0x-prefixed hex', () => {
+            expect(format.looksLikeHex('0xdeadbeef')).toBe(true);
+        });
+        it('returns true for 0X-prefixed hex with separators', () => {
+            expect(format.looksLikeHex('0XDE AD')).toBe(true);
+        });
+        it('returns true for colon-separated hex', () => {
+            expect(format.looksLikeHex('de:ad:be:ef')).toBe(true);
+        });
+        it('returns true for mixed separators (spaces, hyphens, commas)', () => {
+            expect(format.looksLikeHex('de-ad be,ef')).toBe(true);
+        });
+        it('returns false for odd-length strings', () => {
+            expect(format.looksLikeHex('abc')).toBe(false);
+        });
+        it('returns false for non-hex characters', () => {
+            expect(format.looksLikeHex('0x0g')).toBe(false);
+        });
+        it('returns false for empty string', () => {
+            expect(format.looksLikeHex('')).toBe(false);
+        });
+        it('returns false for only prefix', () => {
+            expect(format.looksLikeHex('0x')).toBe(false);
+        });
+        it('returns false when separators are not recognized (e.g., underscore)', () => {
+            expect(format.looksLikeHex('aabb__ccdd')).toBe(false);
+        });
+    });
+    describe('looksLikeBase64', () => {
+        it('returns true for valid unpadded base64', () => {
+            expect(format.looksLikeBase64('Zm9v')).toBe(true);
+        });
+        it('returns true for valid padded base64', () => {
+            expect(format.looksLikeBase64('Zg==')).toBe(true);
+        });
+        it('returns true for base64 containing + and /', () => {
+            expect(format.looksLikeBase64('+w==')).toBe(true);
+            expect(format.looksLikeBase64('/w==')).toBe(true);
+        });
+        it('returns true for valid base64 with whitespace', () => {
+            expect(format.looksLikeBase64('Zm 9v\n')).toBe(true);
+        });
+        it('returns false for empty string', () => {
+            expect(format.looksLikeBase64('')).toBe(false);
+        });
+        it('returns false when length is not a multiple of 4', () => {
+            expect(format.looksLikeBase64('Zg=')).toBe(false);
+            expect(format.looksLikeBase64('Zm9vYg')).toBe(false);
+        });
+        it('returns false for invalid characters', () => {
+            expect(format.looksLikeBase64('Zm9v*')).toBe(false);
+            expect(format.looksLikeBase64('-w==')).toBe(false);
+            expect(format.looksLikeBase64('_w==')).toBe(false);
+        });
+        it('returns false for too much padding', () => {
+            expect(format.looksLikeBase64('Zg===')).toBe(false);
+        });
+        it('returns false for padding in the middle', () => {
+            expect(format.looksLikeBase64('Zg==Zg==')).toBe(false);
+        });
+        it('returns false when base64 decodes but fails canonical roundtrip', () => {
+            expect(format.looksLikeBase64('Zm9=')).toBe(false);
+        });
+    });
+    describe('looksLikeUrlEncoded', () => {
+        it('returns true when it contains %XX sequences', () => {
+            expect(format.looksLikeUrlEncoded('%7B%7D')).toBe(true);
+        });
+        it('returns true when it contains +', () => {
+            expect(format.looksLikeUrlEncoded('a+b')).toBe(true);
+        });
+        it('returns false for plain text', () => {
+            expect(format.looksLikeUrlEncoded('plain text')).toBe(false);
+        });
+        it('returns false for % not followed by two hex digits', () => {
+            expect(format.looksLikeUrlEncoded('100% sure')).toBe(false);
+            expect(format.looksLikeUrlEncoded('%zz')).toBe(false);
+        });
+        it('treats literal + as a signal even if not truly encoded', () => {
+            expect(format.looksLikeUrlEncoded('x+y+z')).toBe(true);
+        });
+    });
+    describe('decodeUrl', () => {
+        it('decodes %XX sequences', () => {
+            expect(format.decodeUrl('hello%20world')).toBe('hello world');
+        });
+        it('treats + as space', () => {
+            expect(format.decodeUrl('a+b')).toBe('a b');
+        });
+        it('does not treat %2B as space', () => {
+            expect(format.decodeUrl('a%2Bb')).toBe('a+b');
+        });
+        it('decodes UTF-8 percent-encoded sequences', () => {
+            expect(format.decodeUrl('%E4%BD%A0%E5%A5%BD')).toBe('你好');
+        });
+        it('decodes mixed reserved characters', () => {
+            expect(format.decodeUrl('x%2Fy%3Fz%3D1')).toBe('x/y?z=1');
+        });
+        it('returns empty string for empty input', () => {
+            expect(format.decodeUrl('')).toBe('');
+        });
+        it('decodes %25 back to %', () => {
+            expect(format.decodeUrl('100%25')).toBe('100%');
+        });
+    });
+    describe('encodeUrlBytes', () => {
+        it('passes through unreserved characters', () => {
+            const input = Buffer.from('AZaz09-._~', 'ascii');
+            expect(format.encodeUrlBytes(input)).toBe('AZaz09-._~');
+        });
+        it('encodes spaces as %20', () => {
+            expect(format.encodeUrlBytes(Buffer.from('a b', 'ascii'))).toBe('a%20b');
+        });
+        it('encodes reserved/special ASCII characters using %XX', () => {
+            expect(format.encodeUrlBytes(Buffer.from('/?:#[]@', 'ascii'))).toBe('%2F%3F%3A%23%5B%5D%40');
+        });
+        it('encodes % as %25', () => {
+            expect(format.encodeUrlBytes(Buffer.from('%', 'ascii'))).toBe('%25');
+        });
+        it('encodes + as %2B (not as +)', () => {
+            expect(format.encodeUrlBytes(Buffer.from('+', 'ascii'))).toBe('%2B');
+        });
+        it('encodes raw bytes outside ASCII using uppercase hex', () => {
+            expect(format.encodeUrlBytes(Buffer.from([0xff, 0xab, 0x00]))).toBe('%FF%AB%00');
+        });
+        it('encodes newline as %0A', () => {
+            expect(format.encodeUrlBytes(Buffer.from([0x0a]))).toBe('%0A');
+        });
+        it('percent-encodes UTF-8 bytes of non-ASCII text', () => {
+            expect(format.encodeUrlBytes(Buffer.from('你好', 'utf8'))).toBe('%E4%BD%A0%E5%A5%BD');
+        });
+        it('returns empty string for empty buffer', () => {
+            expect(format.encodeUrlBytes(Buffer.alloc(0))).toBe('');
+        });
+    });
+    describe('toSafeUtf8', () => {
+        it('returns empty string for empty buffer', () => {
+            expect(format.toSafeUtf8(Buffer.alloc(0))).toBe('');
+        });
+        it('returns utf8 text for valid ASCII', () => {
+            expect(format.toSafeUtf8(Buffer.from('hello', 'utf8'))).toBe('hello');
+        });
+        it('returns utf8 text for valid unicode', () => {
+            expect(format.toSafeUtf8(Buffer.from('你好', 'utf8'))).toBe('你好');
+        });
+        it('returns null when decoding introduces U+FFFD from invalid UTF-8', () => {
+            expect(format.toSafeUtf8(Buffer.from([0xc3, 0x28]))).toBeNull();
+        });
+        it('returns null when the resulting text contains the replacement character (U+FFFD)', () => {
+            expect(format.toSafeUtf8(Buffer.from('\uFFFD', 'utf8'))).toBeNull();
+        });
+        it('returns null when valid text contains U+FFFD anywhere', () => {
+            expect(format.toSafeUtf8(Buffer.from(`ok\uFFFD`, 'utf8'))).toBeNull();
+        });
+    });
+    describe('tryParseJson', () => {
+        it('parses valid object JSON', () => {
+            expect(format.tryParseJson('{"ok":true}')).toEqual({ ok: true });
+        });
+        it('parses valid array JSON', () => {
+            expect(format.tryParseJson('[1,2,3]')).toEqual([1, 2, 3]);
+        });
+        it('parses valid number JSON', () => {
+            expect(format.tryParseJson('123')).toBe(123);
+        });
+        it('parses valid string JSON', () => {
+            expect(format.tryParseJson('"str"')).toBe('str');
+        });
+        it('parses valid null JSON', () => {
+            expect(format.tryParseJson('null')).toBeNull();
+        });
+        it('returns null for invalid JSON', () => {
+            expect(format.tryParseJson('{')).toBeNull();
+            expect(format.tryParseJson('not json')).toBeNull();
+        });
+        it('returns null for JSON with trailing comma', () => {
+            expect(format.tryParseJson('{ "a": 1, }')).toBeNull();
+            expect(format.tryParseJson('[1,2,]')).toBeNull();
+        });
+        it('handles leading/trailing whitespace for valid JSON', () => {
+            expect(format.tryParseJson(' \n\t {"a":1} \n')).toEqual({ a: 1 });
+        });
+    });
+});

package/dist/tests/server/domains/encoding/handlers.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/domains/encoding/handlers.test.js

@@ -0,0 +1,56 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { EncodingToolHandlers } from '../../../../src/server/domains/encoding/handlers.js';
+function parseJson(response) {
+    return JSON.parse(response.content[0].text);
+}
+describe('EncodingToolHandlers', () => {
+    const collector = {
+        getActivePage: vi.fn(),
+    };
+    let handlers;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        handlers = new EncodingToolHandlers(collector);
+    });
+    it('returns error when binary_decode lacks data', async () => {
+        const body = parseJson(await handlers.handleBinaryDecode({ encoding: 'base64' }));
+        expect(body.success).toBe(false);
+        expect(body.tool).toBe('binary_decode');
+        expect(body.error).toContain('data is required');
+    });
+    it('returns error for invalid decode encoding', async () => {
+        const body = parseJson(await handlers.handleBinaryDecode({ data: 'aaa', encoding: 'bad' }));
+        expect(body.success).toBe(false);
+        expect(body.error).toContain('Invalid encoding');
+    });
+    it('decodes url input to json output', async () => {
+        const body = parseJson(await handlers.handleBinaryDecode({
+            data: '%7B%22ok%22%3Atrue%7D',
+            encoding: 'url',
+            outputFormat: 'json',
+        }));
+        expect(body.success).toBe(true);
+        expect(body.outputFormat).toBe('json');
+        expect(body.result).toEqual({ ok: true });
+    });
+    it('encodes utf8 to base64', async () => {
+        const body = parseJson(await handlers.handleBinaryEncode({
+            data: 'hello',
+            inputFormat: 'utf8',
+            outputEncoding: 'base64',
+        }));
+        expect(body.success).toBe(true);
+        expect(body.output).toBe(Buffer.from('hello', 'utf8').toString('base64'));
+    });
+    it('returns error for invalid entropy source', async () => {
+        const body = parseJson(await handlers.handleBinaryEntropyAnalysis({ source: 'oops' }));
+        expect(body.success).toBe(false);
+        expect(body.tool).toBe('binary_entropy_analysis');
+    });
+    it('returns error when protobuf raw decode has no data', async () => {
+        const body = parseJson(await handlers.handleProtobufDecodeRaw({}));
+        expect(body.success).toBe(false);
+        expect(body.tool).toBe('protobuf_decode_raw');
+        expect(body.error).toContain('data is required');
+    });
+});

package/dist/tests/server/domains/encoding/msgpack.test.d.ts

@@ -0,0 +1 @@
+export {};