fix(@angular/build): ensure parent directory exists in SQLite cache store

Previously, initializing DatabaseSync directly with a path in a nonexistent directory failed with an unable to open database file error. Unlike other storage backends, node:sqlite does not recursively create parent directory structures.

Parent directories for the cache database are now created recursively before opening the database file, preventing initialization errors when the cache directory does not yet exist.

Author: clydin

packages/angular/build/src/tools/esbuild/sqlite-cache-store.ts

@@ -6,6 +6,8 @@
  * found in the LICENSE file at https://angular.dev/license
  */
 
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
 import { DatabaseSync, StatementSync } from 'node:sqlite';
 import { deserialize, serialize } from 'node:v8';
 import { Cache, PersistentCacheStore } from './cache';
@@ -35,7 +37,17 @@ export class SqliteCacheStore implements PersistentCacheStore<unknown> {
 
   #ensureDb(): DatabaseSync {
     if (!this.#db) {
-      this.#db = new DatabaseSync(this.cachePath);
+      // Optimistically attempt to open the database file first to avoid directory creation
+      // syscalls on warm builds where the parent directory already exists.
+      try {
+        this.#db = new DatabaseSync(this.cachePath);
+      } catch {
+        if (this.cachePath !== ':memory:') {
+          mkdirSync(dirname(this.cachePath), { recursive: true });
+        }
+        this.#db = new DatabaseSync(this.cachePath);
+      }
+
       // Optimize SQLite for cache usage
       this.#db.exec('PRAGMA auto_vacuum = FULL;');
       this.#db.exec('PRAGMA journal_mode = WAL;');

packages/angular/build/src/tools/esbuild/sqlite-cache-store_spec.ts

@@ -220,6 +220,20 @@ describe('SqliteCacheStore', () => {
     }
   });
 
+  it('should create parent directories if they do not exist', async () => {
+    const nestedDir = join(tempDir, 'nested', 'deeply', 'cache');
+    const nestedCachePath = join(nestedDir, 'nested-cache.db');
+    const nestedStore = new SqliteCacheStore(nestedCachePath);
+
+    try {
+      await nestedStore.set('nested-key', 'nested-value');
+      const result = await nestedStore.get('nested-key');
+      expect(result).toBe('nested-value');
+    } finally {
+      nestedStore.close();
+    }
+  });
+
   describe('NG_BUILD_CACHE_STORE env variable option', () => {
     it('should force SQLite when NG_BUILD_CACHE_STORE=sqlite', () => {
       const code = `