fix: Stop logging cache warnings when the Tailwind class cache file is missing so repeated builds on Windows no longer show ENOENT errors.

Author: sonofmagic

.changeset/quiet-cache-enoent.md

@@ -0,0 +1,5 @@
+---
+'tailwindcss-patch': patch
+---
+
+Stop logging cache warnings when the Tailwind class cache file is missing so repeated builds on Windows no longer show ENOENT errors.

packages/tailwindcss-patch/src/cache/store.ts

@@ -2,6 +2,10 @@ import type { NormalizedCacheOptions } from '../options/types'
 import fs from 'fs-extra'
 import logger from '../logger'
 
+function isErrnoException(error: unknown): error is NodeJS.ErrnoException {
+  return error instanceof Error && typeof (error as NodeJS.ErrnoException).code === 'string'
+}
+
 export class CacheStore {
   constructor(private readonly options: NormalizedCacheOptions) {}
 
@@ -62,6 +66,10 @@ export class CacheStore {
       }
     }
     catch (error) {
+      if (isErrnoException(error) && error.code === 'ENOENT') {
+        return new Set()
+      }
+
       logger.warn('Unable to read Tailwind class cache, removing invalid file.', error)
       try {
         await fs.remove(this.options.path)
@@ -91,6 +99,10 @@ export class CacheStore {
       }
     }
     catch (error) {
+      if (isErrnoException(error) && error.code === 'ENOENT') {
+        return new Set()
+      }
+
       logger.warn('Unable to read Tailwind class cache, removing invalid file.', error)
       try {
         fs.removeSync(this.options.path)

packages/tailwindcss-patch/test/cache.store.test.ts

@@ -1,8 +1,9 @@
 import os from 'node:os'
 import fs from 'fs-extra'
 import path from 'pathe'
-import { afterEach, beforeEach, describe, expect, it } from 'vitest'
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 import { CacheStore } from '@/cache/store'
+import logger from '@/logger'
 
 let tempDir: string
 
@@ -74,4 +75,62 @@ describe('CacheStore', () => {
     expect(restored.size).toBe(1)
     expect(restored.has('foo')).toBe(true)
   })
+
+  it('ignores ENOENT errors while reading cache files', async () => {
+    const cachePath = path.join(tempDir, 'cache.json')
+    const store = new CacheStore({
+      enabled: true,
+      cwd: tempDir,
+      dir: tempDir,
+      file: 'cache.json',
+      path: cachePath,
+      strategy: 'merge',
+    })
+
+    const warnSpy = vi.spyOn(logger, 'warn')
+    const removeSpy = vi.spyOn(fs, 'remove')
+    const pathExistsSpy = vi.spyOn(fs, 'pathExists').mockResolvedValue(true)
+    const enoentError = Object.assign(new Error('missing'), { code: 'ENOENT' as NodeJS.ErrnoException['code'] })
+    const readSpy = vi.spyOn(fs, 'readJSON').mockRejectedValue(enoentError)
+
+    const restored = await store.read()
+    expect(restored.size).toBe(0)
+    expect(warnSpy).not.toHaveBeenCalled()
+    expect(removeSpy).not.toHaveBeenCalled()
+
+    warnSpy.mockRestore()
+    removeSpy.mockRestore()
+    pathExistsSpy.mockRestore()
+    readSpy.mockRestore()
+  })
+
+  it('ignores ENOENT errors while reading cache files synchronously', () => {
+    const cachePath = path.join(tempDir, 'cache.json')
+    const store = new CacheStore({
+      enabled: true,
+      cwd: tempDir,
+      dir: tempDir,
+      file: 'cache.json',
+      path: cachePath,
+      strategy: 'merge',
+    })
+
+    const warnSpy = vi.spyOn(logger, 'warn')
+    const removeSpy = vi.spyOn(fs, 'removeSync')
+    const pathExistsSpy = vi.spyOn(fs, 'pathExistsSync').mockReturnValue(true)
+    const enoentError = Object.assign(new Error('missing'), { code: 'ENOENT' as NodeJS.ErrnoException['code'] })
+    const readSpy = vi.spyOn(fs, 'readJSONSync').mockImplementation(() => {
+      throw enoentError
+    })
+
+    const restored = store.readSync()
+    expect(restored.size).toBe(0)
+    expect(warnSpy).not.toHaveBeenCalled()
+    expect(removeSpy).not.toHaveBeenCalled()
+
+    warnSpy.mockRestore()
+    removeSpy.mockRestore()
+    pathExistsSpy.mockRestore()
+    readSpy.mockRestore()
+  })
 })