@tevm/bundler-cache/src/readArtifacts.spec.ts

Cache for tevm bundler

import { beforeEach, describe, expect, it, vi } from 'vitest'
import { readArtifacts } from './readArtifacts.js'
import type { FileAccessObject } from './types.js'
import * as versionModule from './version.js'

// Mock the path modules
vi.mock('./getArtifactsPath.js', () => ({
	getArtifactsPath: vi.fn((entryModuleId, _item) => {
		const dir = `/mock/cwd/.tevm/${entryModuleId}`
		const path = `${dir}/artifacts.json`
		return { dir, path }
	}),
}))

vi.mock('./getMetadataPath.js', () => ({
	getMetadataPath: vi.fn((entryModuleId) => {
		const dir = `/mock/cwd/.tevm/${entryModuleId}`
		const path = `${dir}/metadata.json`
		return { dir, path }
	}),
}))

describe('readArtifacts', () => {
	const mockCwd = '/mock/cwd'
	const mockCacheDir = '.tevm'
	const mockEntryModuleId = 'contracts/MyContract.sol'

	const mockFs: FileAccessObject = {
		writeFileSync: vi.fn(),
		writeFile: vi.fn(),
		readFile: vi.fn(),
		readFileSync: vi.fn(),
		exists: vi.fn(),
		existsSync: vi.fn(),
		statSync: vi.fn(),
		stat: vi.fn(),
		mkdirSync: vi.fn(),
		mkdir: vi.fn(),
	}

	const mockArtifacts = {
		abi: [{ name: 'function', type: 'function' }],
		bytecode: '0x1234',
		deployedBytecode: '0x5678',
		solcInput: {
			sources: {
				'/mock/cwd/contracts/MyContract.sol': { content: 'contract MyContract {}' },
			},
		},
	}

	const mockMetadata = {
		version: '1.x.x',
		files: {
			'/mock/cwd/contracts/MyContract.sol': 123456789,
		},
	}

	beforeEach(() => {
		vi.resetAllMocks()
		vi.spyOn(versionModule, 'version', 'get').mockReturnValue('1.x.x')
		mockFs.exists.mockImplementation(() => Promise.resolve(true))
		mockFs.readFile.mockImplementation((path) => {
			if (path.includes('metadata.json')) {
				return Promise.resolve(JSON.stringify(mockMetadata))
			}
			if (path.includes('artifacts.json')) {
				return Promise.resolve(JSON.stringify(mockArtifacts))
			}
			return Promise.resolve('')
		})
		mockFs.stat.mockImplementation(() => Promise.resolve({ mtimeMs: 123456789 }))
	})

	it('should return undefined if artifacts path does not exist', async () => {
		mockFs.exists.mockImplementation((path) => {
			if (path.includes('artifacts.json')) {
				return Promise.resolve(false)
			}
			return Promise.resolve(true)
		})

		const result = await readArtifacts(mockCacheDir, mockFs, mockCwd, mockEntryModuleId)

		expect(result).toBeUndefined()
	})

	it('should return undefined if metadata path does not exist', async () => {
		mockFs.exists.mockImplementation((path) => {
			if (path.includes('metadata.json')) {
				return Promise.resolve(false)
			}
			return Promise.resolve(true)
		})

		const result = await readArtifacts(mockCacheDir, mockFs, mockCwd, mockEntryModuleId)

		expect(result).toBeUndefined()
	})

	it('should return undefined if package version has changed', async () => {
		vi.spyOn(versionModule, 'version', 'get').mockReturnValue('2.x.x')

		const result = await readArtifacts(mockCacheDir, mockFs, mockCwd, mockEntryModuleId)

		expect(result).toBeUndefined()
	})

	it('should return undefined if file timestamps have changed', async () => {
		mockFs.stat.mockImplementation(() => Promise.resolve({ mtimeMs: 987654321 }))

		const result = await readArtifacts(mockCacheDir, mockFs, mockCwd, mockEntryModuleId)

		expect(result).toBeUndefined()
	})

	it('should return parsed artifacts if everything is valid', async () => {
		const result = await readArtifacts(mockCacheDir, mockFs, mockCwd, mockEntryModuleId)

		expect(result).toEqual(mockArtifacts)
		expect(mockFs.readFile).toHaveBeenCalledWith('/mock/cwd/.tevm/contracts/MyContract.sol/artifacts.json', 'utf8')
	})

	it('should throw an error if artifacts file contains invalid JSON', async () => {
		mockFs.readFile.mockImplementation((path) => {
			if (path.includes('metadata.json')) {
				return Promise.resolve(JSON.stringify(mockMetadata))
			}
			if (path.includes('artifacts.json')) {
				return Promise.resolve('invalid json')
			}
			return Promise.resolve('')
		})

		await expect(readArtifacts(mockCacheDir, mockFs, mockCwd, mockEntryModuleId)).rejects.toThrow(
			`Cache miss for ${mockEntryModuleId} because it isn't valid json`,
		)
	})
})