openclaw/src/test-utils/fixture-suite.ts

// Loads fixture suites from disk for parametrized tests.
import fs from "node:fs/promises";
import os from "node:os";
import path from "node:path";

/** Creates a temp fixture root with deterministic per-case subdirectories. */
export function createFixtureSuite(rootPrefix: string) {
  let fixtureRoot = "";
  let fixtureCount = 0;

  return {
    async setup(): Promise<void> {
      // Canonicalize: macOS tmpdir sits behind a symlink (/var -> /private/var)
      // and production realpaths state/session paths, so symlinked roots break
      // path-equality assertions.
      fixtureRoot = await fs.realpath(await fs.mkdtemp(path.join(os.tmpdir(), rootPrefix)));
    },
    async cleanup(): Promise<void> {
      if (!fixtureRoot) {
        return;
      }
      await fs.rm(fixtureRoot, { recursive: true, force: true });
      fixtureRoot = "";
    },
    async createCaseDir(prefix: string): Promise<string> {
      if (!fixtureRoot) {
        throw new Error("Fixture suite not initialized");
      }
      const dir = path.join(fixtureRoot, `${prefix}-${fixtureCount++}`);
      await fs.mkdir(dir, { recursive: true });
      return dir;
    },
  };
}