tempDirectories.ts

import fs from "node:fs";
import path from "node:path";
import { onExit } from "signal-exit";

/**
 * A short-lived directory. Automatically removed when the process exits, but
 * can be removed earlier by calling `remove()`.
 */
export interface EphemeralDirectory {
  path: string;
  remove(): void;
}

/**
 * Gets a temporary directory in the project's `.trigger` folder with the
 * specified prefix. We create temporary directories in `.trigger` as opposed
 * to the OS's temporary directory to avoid issues with different drive letters
 * on Windows. For example, when `esbuild` outputs a file to a different drive
 * than the input sources, the generated source maps are incorrect.
 */
export function getTmpDir(
  projectRoot: string | undefined,
  prefix: string,
  keep: boolean = false
): EphemeralDirectory {
  projectRoot ??= process.cwd();
  const tmpRoot = path.join(projectRoot, ".trigger", "tmp");
  fs.mkdirSync(tmpRoot, { recursive: true });

  const tmpPrefix = path.join(tmpRoot, `${prefix}-`);
  const tmpDir = fs.realpathSync(fs.mkdtempSync(tmpPrefix));

  const removeDir = () => {
    try {
      return fs.rmSync(tmpDir, { recursive: true, force: true });
    } catch (e) {
      // This sometimes fails on Windows with EBUSY
    }
  };
  const removeExitListener = keep || process.env.KEEP_TMP_DIRS ? () => {} : onExit(removeDir);

  return {
    path: tmpDir,
    remove() {
      removeExitListener();
      removeDir();
    },
  };
}

export function clearTmpDirs(projectRoot: string | undefined) {
  projectRoot ??= process.cwd();
  const tmpRoot = path.join(projectRoot, ".trigger", "tmp");

  try {
    fs.rmSync(tmpRoot, { recursive: true, force: true });
  } catch (e) {
    // This sometimes fails on Windows with EBUSY
  }
}

/**
 * Gets the shared store directory for content-addressable build outputs.
 * This directory persists across rebuilds and is used to deduplicate
 * identical chunk files between build versions.
 * Automatically cleaned up when the process exits.
 */
export function getStoreDir(projectRoot: string | undefined, keep: boolean = false): string {
  projectRoot ??= process.cwd();
  const storeDir = path.join(projectRoot, ".trigger", "tmp", "store");
  fs.mkdirSync(storeDir, { recursive: true });

  // Register exit handler to clean up the store directory
  if (!keep && !process.env.KEEP_TMP_DIRS) {
    onExit(() => {
      try {
        fs.rmSync(storeDir, { recursive: true, force: true });
      } catch (e) {
        // This sometimes fails on Windows with EBUSY
      }
    });
  }

  return storeDir;
}