@roj-ai/sdk 0.1.3 → 0.1.5

package/dist/core/image/image-processor.test.js

@@ -0,0 +1,171 @@
+import { describe, expect, it } from 'bun:test';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { Err, Ok } from '../../lib/utils/result.js';
+import { createNodeFileSystem } from '../../testing/node-platform.js';
+import { DefaultImageProcessor } from './image-processor.js';
+import { NoopImageResizer } from './noop-resizer.js';
+describe('DefaultImageProcessor', () => {
+    const tempDir = tmpdir();
+    function createProcessor(resizer, maxFileSizeBytes = 5 * 1024 * 1024) {
+        return new DefaultImageProcessor(resizer ?? new NoopImageResizer(), createNodeFileSystem(), { maxFileSizeBytes });
+    }
+    it('passes through string content unchanged', async () => {
+        const processor = createProcessor();
+        const result = await processor.resolveContent('hello world');
+        expect(result).toBe('hello world');
+    });
+    it('passes through non-image content items unchanged', async () => {
+        const processor = createProcessor();
+        const content = [
+            { type: 'text', text: 'some text' },
+        ];
+        const result = await processor.resolveContent(content);
+        expect(result).toEqual([{ type: 'text', text: 'some text' }]);
+    });
+    it('passes through non-file:// image URLs unchanged', async () => {
+        const processor = createProcessor();
+        const content = [
+            { type: 'image_url', imageUrl: { url: 'https://example.com/img.png' } },
+        ];
+        const result = await processor.resolveContent(content);
+        expect(result).toEqual([{ type: 'image_url', imageUrl: { url: 'https://example.com/img.png' } }]);
+    });
+    it('resolves file:// image to data URL with correct MIME from resizer', async () => {
+        // Create a small test file
+        const testPath = join(tempDir, `test-processor-${Date.now()}.png`);
+        await Bun.write(testPath, Buffer.from('fake-png-data'));
+        const resizer = {
+            async resize(filePath, _mimeType, _options) {
+                return { path: filePath, mimeType: 'image/jpeg' };
+            },
+        };
+        const processor = createProcessor(resizer);
+        const content = [
+            { type: 'image_url', imageUrl: { url: `file://${testPath}`, detail: 'auto' } },
+        ];
+        const result = await processor.resolveContent(content);
+        const item = result[0];
+        expect(item.type).toBe('image_url');
+        if (item.type === 'image_url') {
+            expect(item.imageUrl.url).toStartWith('data:image/jpeg;base64,');
+            expect(item.imageUrl.detail).toBe('auto');
+        }
+        await Bun.file(testPath).exists() && await import('node:fs/promises').then(fs => fs.unlink(testPath).catch(() => { }));
+    });
+    it('returns text placeholder when file exceeds size limit', async () => {
+        const testPath = join(tempDir, `test-large-${Date.now()}.jpg`);
+        // Write a file larger than the limit
+        await Bun.write(testPath, Buffer.alloc(100));
+        const processor = createProcessor(new NoopImageResizer(), 50); // 50 byte limit
+        const content = [
+            { type: 'image_url', imageUrl: { url: `file://${testPath}` } },
+        ];
+        const result = await processor.resolveContent(content);
+        const item = result[0];
+        expect(item.type).toBe('text');
+        if (item.type === 'text') {
+            expect(item.text).toContain('file too large');
+        }
+        await import('node:fs/promises').then(fs => fs.unlink(testPath).catch(() => { }));
+    });
+    it('returns text placeholder for unsupported format', async () => {
+        const testPath = join(tempDir, `test-${Date.now()}.xyz`);
+        await Bun.write(testPath, 'some data');
+        const processor = createProcessor();
+        const content = [
+            { type: 'image_url', imageUrl: { url: `file://${testPath}` } },
+        ];
+        const result = await processor.resolveContent(content);
+        const item = result[0];
+        expect(item.type).toBe('text');
+        if (item.type === 'text') {
+            expect(item.text).toContain('unsupported format');
+        }
+        await import('node:fs/promises').then(fs => fs.unlink(testPath).catch(() => { }));
+    });
+    it('returns text placeholder when file not found', async () => {
+        const processor = createProcessor();
+        const content = [
+            { type: 'image_url', imageUrl: { url: 'file:///nonexistent/path/image.png' } },
+        ];
+        const result = await processor.resolveContent(content);
+        const item = result[0];
+        expect(item.type).toBe('text');
+        if (item.type === 'text') {
+            expect(item.text).toContain('file not found');
+        }
+    });
+    it('resolves via FileStore when provided', async () => {
+        const testPath = join(tempDir, `test-store-${Date.now()}.png`);
+        await Bun.write(testPath, Buffer.from('fake-png-data'));
+        const fileStore = {
+            realPath: (path) => Ok(testPath),
+        };
+        const processor = createProcessor();
+        const content = [
+            { type: 'image_url', imageUrl: { url: 'file://workspace/image.png' } },
+        ];
+        const result = await processor.resolveContent(content, fileStore);
+        const item = result[0];
+        expect(item.type).toBe('image_url');
+        if (item.type === 'image_url') {
+            expect(item.imageUrl.url).toStartWith('data:image/png;base64,');
+        }
+        await import('node:fs/promises').then(fs => fs.unlink(testPath).catch(() => { }));
+    });
+    it('returns text placeholder when FileStore.realPath fails', async () => {
+        const fileStore = {
+            realPath: (_path) => Err('path outside sandbox'),
+        };
+        const processor = createProcessor();
+        const content = [
+            { type: 'image_url', imageUrl: { url: 'file://workspace/image.png' } },
+        ];
+        const result = await processor.resolveContent(content, fileStore);
+        const item = result[0];
+        expect(item.type).toBe('text');
+        if (item.type === 'text') {
+            expect(item.text).toContain('path outside sandbox');
+        }
+    });
+    it('passes maxFileSizeBytes to resizer', async () => {
+        const testPath = join(tempDir, `test-opts-${Date.now()}.png`);
+        await Bun.write(testPath, Buffer.from('fake-png-data'));
+        let receivedOptions;
+        const resizer = {
+            async resize(filePath, _mimeType, options) {
+                receivedOptions = options;
+                return { path: filePath, mimeType: 'image/png' };
+            },
+        };
+        const processor = createProcessor(resizer, 999);
+        const content = [
+            { type: 'image_url', imageUrl: { url: `file://${testPath}` } },
+        ];
+        await processor.resolveContent(content);
+        expect(receivedOptions).toEqual({ maxFileSizeBytes: 999 });
+        await import('node:fs/promises').then(fs => fs.unlink(testPath).catch(() => { }));
+    });
+    it('cleans up temp files from resizer', async () => {
+        const testPath = join(tempDir, `test-cleanup-${Date.now()}.png`);
+        const tempFile = join(tempDir, `test-temp-${Date.now()}.jpg`);
+        await Bun.write(testPath, Buffer.from('fake-png-data'));
+        await Bun.write(tempFile, Buffer.from('resized-data'));
+        const resizer = {
+            async resize(_filePath, _mimeType, _options) {
+                return { path: tempFile, mimeType: 'image/jpeg', tempFile };
+            },
+        };
+        const processor = createProcessor(resizer);
+        const content = [
+            { type: 'image_url', imageUrl: { url: `file://${testPath}` } },
+        ];
+        await processor.resolveContent(content);
+        // Temp file should be cleaned up
+        const exists = await Bun.file(tempFile).exists();
+        expect(exists).toBe(false);
+        await import('node:fs/promises').then(fs => fs.unlink(testPath).catch(() => { }));
+    });
+});
+//# sourceMappingURL=image-processor.test.js.map

package/dist/core/image/image-processor.test.js.map

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

package/dist/core/image/index.js

@@ -0,0 +1,4 @@
+export { DefaultImageProcessor } from './image-processor.js';
+export { NoopImageResizer } from './noop-resizer.js';
+export { VipsImageResizer } from './vips-resizer.js';
+//# sourceMappingURL=index.js.map

package/dist/core/image/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/image/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/core/image/noop-resizer.js

@@ -0,0 +1,6 @@
+export class NoopImageResizer {
+    async resize(filePath, mimeType, _options) {
+        return { path: filePath, mimeType };
+    }
+}
+//# sourceMappingURL=noop-resizer.js.map

package/dist/core/image/noop-resizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-resizer.js","sourceRoot":"","sources":["../../../src/core/image/noop-resizer.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,gBAAgB;IAC5B,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,QAAgB,EAAE,QAA6B;QAC7E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAA;IACpC,CAAC;CACD"}

package/dist/core/image/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/image/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/image/types.ts"],"names":[],"mappings":""}

package/dist/core/image/vips-resizer.js

@@ -0,0 +1,100 @@
+import { join } from 'node:path';
+export class VipsImageResizer {
+    fs;
+    process;
+    tmpDir;
+    maxDimension;
+    constructor(options) {
+        this.fs = options.fs;
+        this.process = options.process;
+        this.tmpDir = options.tmpDir;
+        this.maxDimension = options.maxDimension ?? 8000;
+    }
+    async resize(filePath, mimeType, options) {
+        try {
+            // Step 1: Dimension resize if needed
+            const result = await this.dimensionResize(filePath, mimeType);
+            // Step 2: If no size constraint, done
+            if (!options?.maxFileSizeBytes)
+                return result;
+            // Step 3: Check if result fits
+            const fileSize = (await this.fs.stat(result.path)).size;
+            if (fileSize <= options.maxFileSizeBytes)
+                return result;
+            // Step 4: Compress to fit — clean up dimension resize temp first
+            if (result.tempFile) {
+                await this.fs.unlink(result.tempFile).catch(() => { });
+            }
+            return await this.compressToFit(filePath, options.maxFileSizeBytes);
+        }
+        catch (e) {
+            console.warn('[image-resize] failed, using original image:', e instanceof Error ? e.message : e);
+            return { path: filePath, mimeType };
+        }
+    }
+    async getImageDimensions(filePath) {
+        const { stdout } = await this.process.execFile('vipsheader', ['-f', 'width', '-f', 'height', filePath], { timeout: 30_000 });
+        const lines = stdout.trim().split('\n');
+        if (lines.length < 2)
+            return null;
+        const width = parseInt(lines[0], 10);
+        const height = parseInt(lines[1], 10);
+        if (!Number.isFinite(width) || !Number.isFinite(height))
+            return null;
+        return { width, height };
+    }
+    async dimensionResize(filePath, mimeType) {
+        const dims = await this.getImageDimensions(filePath);
+        const needsResize = dims !== null && (dims.width > this.maxDimension || dims.height > this.maxDimension);
+        // JPEGs within dimension limits pass through unchanged
+        if (mimeType === 'image/jpeg' && !needsResize) {
+            return { path: filePath, mimeType };
+        }
+        // Always convert to JPEG (PNG→JPEG saves significant size for LLM context)
+        const id = `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+        const outputPath = join(this.tmpDir, `roj-resize-${id}.jpg`);
+        await this.process.execFile('vipsthumbnail', [
+            filePath,
+            '--size',
+            `${this.maxDimension}x${this.maxDimension}`,
+            '-o',
+            outputPath,
+        ], { timeout: 30_000 });
+        return { path: outputPath, mimeType: 'image/jpeg', tempFile: outputPath };
+    }
+    async compressToFit(filePath, maxFileSizeBytes) {
+        const halfDim = Math.floor(this.maxDimension / 2);
+        const attempts = [
+            { dimension: this.maxDimension, quality: 85 },
+            { dimension: this.maxDimension, quality: 70 },
+            { dimension: this.maxDimension, quality: 50 },
+            { dimension: this.maxDimension, quality: 30 },
+            { dimension: halfDim, quality: 70 },
+            { dimension: halfDim, quality: 50 },
+            { dimension: halfDim, quality: 30 },
+        ];
+        let lastResult;
+        for (const { dimension, quality } of attempts) {
+            const id = `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+            const outputPath = join(this.tmpDir, `roj-compress-${id}.jpg`);
+            await this.process.execFile('vipsthumbnail', [
+                filePath,
+                '--size',
+                `${dimension}x${dimension}`,
+                '-o',
+                `${outputPath}[Q=${quality}]`,
+            ], { timeout: 30_000 });
+            // Clean up previous attempt
+            if (lastResult?.tempFile) {
+                await this.fs.unlink(lastResult.tempFile).catch(() => { });
+            }
+            lastResult = { path: outputPath, mimeType: 'image/jpeg', tempFile: outputPath };
+            if ((await this.fs.stat(outputPath)).size <= maxFileSizeBytes) {
+                return lastResult;
+            }
+        }
+        // Return best effort (most compressed) — caller decides what to do
+        return lastResult;
+    }
+}
+//# sourceMappingURL=vips-resizer.js.map

package/dist/core/image/vips-resizer.js.map

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

package/dist/core/image/vips-resizer.test.js

@@ -0,0 +1,324 @@
+import { afterEach, describe, expect, it, mock, spyOn } from 'bun:test';
+import * as childProcess from 'node:child_process';
+let execFileImpl = () => { };
+mock.module('node:child_process', () => ({
+    ...childProcess,
+    execFile: (cmd, args, opts, cb) => execFileImpl(cmd, args, opts, cb),
+}));
+const { VipsImageResizer } = await import('./vips-resizer.js');
+const { createNodePlatform } = await import('../../testing/node-platform.js');
+// Test-scoped helper — routes through createNodePlatform so the module-level
+// node:child_process mock still intercepts execFile calls made by ProcessRunner.
+function createResizer(maxDimension) {
+    const platform = createNodePlatform();
+    return new VipsImageResizer({
+        fs: platform.fs,
+        process: platform.process,
+        tmpDir: platform.tmpDir,
+        maxDimension,
+    });
+}
+const warnSpy = spyOn(console, 'warn').mockImplementation(() => { });
+afterEach(() => {
+    warnSpy.mockClear();
+    execFileImpl = () => { };
+});
+describe('VipsImageResizer', () => {
+    const testJpegPath = '/tmp/test-image.jpg';
+    it('returns original path and mimeType when jpeg is within limits', async () => {
+        execFileImpl = (cmd, _args, _opts, cb) => {
+            if (cmd === 'vipsheader')
+                cb(null, '4000\n3000\n', '');
+        };
+        const resizer = createResizer();
+        const result = await resizer.resize(testJpegPath, 'image/jpeg');
+        expect(result).toEqual({ path: testJpegPath, mimeType: 'image/jpeg' });
+    });
+    it('returns original path when jpeg is exactly at dimension limit', async () => {
+        execFileImpl = (cmd, _args, _opts, cb) => {
+            if (cmd === 'vipsheader')
+                cb(null, '8000\n8000\n', '');
+        };
+        const resizer = createResizer();
+        const result = await resizer.resize(testJpegPath, 'image/jpeg');
+        expect(result).toEqual({ path: testJpegPath, mimeType: 'image/jpeg' });
+    });
+    it('converts png to jpeg even when within dimension limits', async () => {
+        execFileImpl = (cmd, _args, _opts, cb) => {
+            if (cmd === 'vipsheader')
+                cb(null, '4000\n3000\n', '');
+            else if (cmd === 'vipsthumbnail')
+                cb(null, '', '');
+        };
+        const resizer = createResizer();
+        const result = await resizer.resize('/tmp/test.png', 'image/png');
+        expect(result.path).toEndWith('.jpg');
+        expect(result.mimeType).toBe('image/jpeg');
+        expect(result.tempFile).toBeDefined();
+    });
+    it('calls vipsthumbnail and returns temp path when width exceeds limit', async () => {
+        let thumbnailArgs = [];
+        execFileImpl = (cmd, args, _opts, cb) => {
+            if (cmd === 'vipsheader')
+                cb(null, '10000\n5000\n', '');
+            else if (cmd === 'vipsthumbnail') {
+                thumbnailArgs = args;
+                cb(null, '', '');
+            }
+        };
+        const resizer = createResizer();
+        const result = await resizer.resize('/tmp/test.png', 'image/png');
+        expect(result.path).not.toBe('/tmp/test.png');
+        expect(result.tempFile).toBe(result.path);
+        expect(result.path).toContain('roj-resize-');
+        expect(result.path).toEndWith('.jpg');
+        expect(result.mimeType).toBe('image/jpeg');
+        expect(thumbnailArgs).toContain('--size');
+        expect(thumbnailArgs).toContain('8000x8000');
+        expect(thumbnailArgs).toContain('/tmp/test.png');
+    });
+    it('calls vipsthumbnail when height exceeds limit', async () => {
+        execFileImpl = (cmd, _args, _opts, cb) => {
+            if (cmd === 'vipsheader')
+                cb(null, '4000\n12000\n', '');
+            else if (cmd === 'vipsthumbnail')
+                cb(null, '', '');
+        };
+        const resizer = createResizer();
+        const result = await resizer.resize(testJpegPath, 'image/jpeg');
+        expect(result.tempFile).toBeDefined();
+        expect(result.path).toEndWith('.jpg');
+        expect(result.mimeType).toBe('image/jpeg');
+    });
+    it('converts webp to jpeg on resize', async () => {
+        execFileImpl = (cmd, _args, _opts, cb) => {
+            if (cmd === 'vipsheader')
+                cb(null, '9000\n9000\n', '');
+            else if (cmd === 'vipsthumbnail')
+                cb(null, '', '');
+        };
+        const resizer = createResizer();
+        const result = await resizer.resize('/tmp/test.webp', 'image/webp');
+        expect(result.path).toEndWith('.jpg');
+        expect(result.mimeType).toBe('image/jpeg');
+    });
+    it('converts gif to jpeg on resize', async () => {
+        execFileImpl = (cmd, _args, _opts, cb) => {
+            if (cmd === 'vipsheader')
+                cb(null, '9000\n9000\n', '');
+            else if (cmd === 'vipsthumbnail')
+                cb(null, '', '');
+        };
+        const resizer = createResizer();
+        const result = await resizer.resize('/tmp/test.gif', 'image/gif');
+        expect(result.path).toEndWith('.jpg');
+        expect(result.mimeType).toBe('image/jpeg');
+    });
+    it('converts png to jpeg on resize', async () => {
+        execFileImpl = (cmd, _args, _opts, cb) => {
+            if (cmd === 'vipsheader')
+                cb(null, '9000\n9000\n', '');
+            else if (cmd === 'vipsthumbnail')
+                cb(null, '', '');
+        };
+        const resizer = createResizer();
+        const result = await resizer.resize('/tmp/test.png', 'image/png');
+        expect(result.path).toEndWith('.jpg');
+        expect(result.mimeType).toBe('image/jpeg');
+    });
+    it('returns original path when vipsheader fails (graceful degradation)', async () => {
+        execFileImpl = (_cmd, _args, _opts, cb) => {
+            cb(new Error('vipsheader: command not found'), '', '');
+        };
+        const resizer = createResizer();
+        const result = await resizer.resize(testJpegPath, 'image/png');
+        expect(result).toEqual({ path: testJpegPath, mimeType: 'image/png' });
+        expect(warnSpy).toHaveBeenCalled();
+    });
+    it('returns original path when vipsthumbnail fails (graceful degradation)', async () => {
+        execFileImpl = (cmd, _args, _opts, cb) => {
+            if (cmd === 'vipsheader')
+                cb(null, '10000\n10000\n', '');
+            else if (cmd === 'vipsthumbnail')
+                cb(new Error('vipsthumbnail: command not found'), '', '');
+        };
+        const resizer = createResizer();
+        const result = await resizer.resize(testJpegPath, 'image/png');
+        expect(result).toEqual({ path: testJpegPath, mimeType: 'image/png' });
+        expect(warnSpy).toHaveBeenCalled();
+    });
+    it('returns original path when vipsheader returns unparseable output for jpeg', async () => {
+        execFileImpl = (cmd, _args, _opts, cb) => {
+            if (cmd === 'vipsheader')
+                cb(null, 'not-a-number\n', '');
+        };
+        const resizer = createResizer();
+        const result = await resizer.resize(testJpegPath, 'image/jpeg');
+        expect(result).toEqual({ path: testJpegPath, mimeType: 'image/jpeg' });
+    });
+    it('uses custom maxDimension', async () => {
+        let thumbnailArgs = [];
+        execFileImpl = (cmd, args, _opts, cb) => {
+            if (cmd === 'vipsheader')
+                cb(null, '5000\n5000\n', '');
+            else if (cmd === 'vipsthumbnail') {
+                thumbnailArgs = args;
+                cb(null, '', '');
+            }
+        };
+        const resizer = createResizer(4000);
+        const result = await resizer.resize(testJpegPath, 'image/jpeg');
+        expect(result.tempFile).toBeDefined();
+        expect(thumbnailArgs).toContain('4000x4000');
+    });
+    describe('compression (maxFileSizeBytes)', () => {
+        it('skips compression when file fits within limit', async () => {
+            const testPath = '/tmp/test-small.jpg';
+            // Write a small file for size check
+            await Bun.write(testPath, Buffer.alloc(100));
+            execFileImpl = (cmd, _args, _opts, cb) => {
+                if (cmd === 'vipsheader')
+                    cb(null, '4000\n3000\n', '');
+            };
+            const resizer = createResizer();
+            const result = await resizer.resize(testPath, 'image/jpeg', { maxFileSizeBytes: 1000 });
+            expect(result).toEqual({ path: testPath, mimeType: 'image/jpeg' });
+            await import('node:fs/promises').then(fs => fs.unlink(testPath).catch(() => { }));
+        });
+        it('tries compression with quality steps when file exceeds limit', async () => {
+            const testPath = '/tmp/test-large-compress.jpg';
+            await Bun.write(testPath, Buffer.alloc(2000));
+            const thumbnailCalls = [];
+            execFileImpl = (cmd, args, _opts, cb) => {
+                if (cmd === 'vipsheader') {
+                    cb(null, '4000\n3000\n', '');
+                }
+                else if (cmd === 'vipsthumbnail') {
+                    thumbnailCalls.push({ args });
+                    // Write a small file so it fits on first compression attempt
+                    const outputArg = args[args.indexOf('-o') + 1];
+                    const outputPath = outputArg.replace(/\[.*\]$/, '');
+                    Bun.write(outputPath, Buffer.alloc(50)).then(() => cb(null, '', ''));
+                }
+            };
+            const resizer = createResizer();
+            const result = await resizer.resize(testPath, 'image/jpeg', { maxFileSizeBytes: 100 });
+            expect(result.mimeType).toBe('image/jpeg');
+            expect(result.tempFile).toBeDefined();
+            expect(thumbnailCalls.length).toBe(1); // First quality step should succeed
+            // Check it used quality parameter
+            const outputArg = thumbnailCalls[0].args[thumbnailCalls[0].args.indexOf('-o') + 1];
+            expect(outputArg).toContain('[Q=85]');
+            if (result.tempFile) {
+                await import('node:fs/promises').then(fs => fs.unlink(result.tempFile).catch(() => { }));
+            }
+            await import('node:fs/promises').then(fs => fs.unlink(testPath).catch(() => { }));
+        });
+        it('tries progressively lower quality until file fits', async () => {
+            const testPath = '/tmp/test-progressive.jpg';
+            await Bun.write(testPath, Buffer.alloc(2000));
+            let compressionAttempts = 0;
+            execFileImpl = (cmd, args, _opts, cb) => {
+                if (cmd === 'vipsheader') {
+                    cb(null, '4000\n3000\n', '');
+                }
+                else if (cmd === 'vipsthumbnail') {
+                    compressionAttempts++;
+                    const outputArg = args[args.indexOf('-o') + 1];
+                    const outputPath = outputArg.replace(/\[.*\]$/, '');
+                    // First two attempts produce large files, third fits
+                    const size = compressionAttempts <= 2 ? 2000 : 50;
+                    Bun.write(outputPath, Buffer.alloc(size)).then(() => cb(null, '', ''));
+                }
+            };
+            const resizer = createResizer();
+            const result = await resizer.resize(testPath, 'image/jpeg', { maxFileSizeBytes: 100 });
+            expect(compressionAttempts).toBe(3); // Q=85, Q=70 failed, Q=50 succeeded
+            expect(result.mimeType).toBe('image/jpeg');
+            if (result.tempFile) {
+                await import('node:fs/promises').then(fs => fs.unlink(result.tempFile).catch(() => { }));
+            }
+            await import('node:fs/promises').then(fs => fs.unlink(testPath).catch(() => { }));
+        });
+        it('halves dimensions when quality reduction is insufficient', async () => {
+            const testPath = '/tmp/test-half-dim.jpg';
+            await Bun.write(testPath, Buffer.alloc(2000));
+            const dimensionArgs = [];
+            let compressionAttempts = 0;
+            execFileImpl = (cmd, args, _opts, cb) => {
+                if (cmd === 'vipsheader') {
+                    cb(null, '4000\n3000\n', '');
+                }
+                else if (cmd === 'vipsthumbnail') {
+                    compressionAttempts++;
+                    dimensionArgs.push(args[args.indexOf('--size') + 1]);
+                    const outputArg = args[args.indexOf('-o') + 1];
+                    const outputPath = outputArg.replace(/\[.*\]$/, '');
+                    // Only the last attempt (halved dimensions, Q=30) fits
+                    const size = compressionAttempts < 7 ? 2000 : 50;
+                    Bun.write(outputPath, Buffer.alloc(size)).then(() => cb(null, '', ''));
+                }
+            };
+            const resizer = createResizer();
+            const result = await resizer.resize(testPath, 'image/jpeg', { maxFileSizeBytes: 100 });
+            // 4 full-dim attempts + 3 half-dim attempts
+            expect(compressionAttempts).toBe(7);
+            // First 4 at full dimension, last 3 at half
+            expect(dimensionArgs[0]).toBe('8000x8000');
+            expect(dimensionArgs[4]).toBe('4000x4000');
+            expect(result.mimeType).toBe('image/jpeg');
+            if (result.tempFile) {
+                await import('node:fs/promises').then(fs => fs.unlink(result.tempFile).catch(() => { }));
+            }
+            await import('node:fs/promises').then(fs => fs.unlink(testPath).catch(() => { }));
+        });
+        it('returns best effort when nothing fits', async () => {
+            const testPath = '/tmp/test-nothing-fits.jpg';
+            await Bun.write(testPath, Buffer.alloc(2000));
+            execFileImpl = (cmd, args, _opts, cb) => {
+                if (cmd === 'vipsheader') {
+                    cb(null, '4000\n3000\n', '');
+                }
+                else if (cmd === 'vipsthumbnail') {
+                    const outputArg = args[args.indexOf('-o') + 1];
+                    const outputPath = outputArg.replace(/\[.*\]$/, '');
+                    // Always too large
+                    Bun.write(outputPath, Buffer.alloc(2000)).then(() => cb(null, '', ''));
+                }
+            };
+            const resizer = createResizer();
+            const result = await resizer.resize(testPath, 'image/jpeg', { maxFileSizeBytes: 100 });
+            // Returns the last attempt even though it doesn't fit
+            expect(result.mimeType).toBe('image/jpeg');
+            expect(result.tempFile).toBeDefined();
+            if (result.tempFile) {
+                await import('node:fs/promises').then(fs => fs.unlink(result.tempFile).catch(() => { }));
+            }
+            await import('node:fs/promises').then(fs => fs.unlink(testPath).catch(() => { }));
+        });
+        it('always outputs jpeg when compressing', async () => {
+            const testPath = '/tmp/test-png-compress.png';
+            await Bun.write(testPath, Buffer.alloc(2000));
+            execFileImpl = (cmd, args, _opts, cb) => {
+                if (cmd === 'vipsheader') {
+                    cb(null, '4000\n3000\n', '');
+                }
+                else if (cmd === 'vipsthumbnail') {
+                    const outputArg = args[args.indexOf('-o') + 1];
+                    const outputPath = outputArg.replace(/\[.*\]$/, '');
+                    Bun.write(outputPath, Buffer.alloc(50)).then(() => cb(null, '', ''));
+                }
+            };
+            const resizer = createResizer();
+            const result = await resizer.resize(testPath, 'image/png', { maxFileSizeBytes: 100 });
+            // Even though input was PNG, compression outputs JPEG
+            expect(result.mimeType).toBe('image/jpeg');
+            expect(result.path).toContain('.jpg');
+            if (result.tempFile) {
+                await import('node:fs/promises').then(fs => fs.unlink(result.tempFile).catch(() => { }));
+            }
+            await import('node:fs/promises').then(fs => fs.unlink(testPath).catch(() => { }));
+        });
+    });
+});
+//# sourceMappingURL=vips-resizer.test.js.map