Files
scrap/node_modules/next/dist/esm/build/turborepo-access-trace/helpers.js
2024-09-24 03:52:46 +00:00

85 lines
3.0 KiB
JavaScript

import fs from "fs/promises";
import path from "path";
import { envProxy } from "./env";
import { tcpProxy } from "./tcp";
import { TurborepoAccessTraceResult } from "./result";
/**
* Trace access to the filesystem (TODO), environment variables, and TCP addresses and
* merge the results into the parent `TurborepoAccessTraceResult`.
*
* @param f the function to trace
* @param parent the `TurborepoAccessTraceResult` to merge the results into
* @returns the result of the function
*/ export function turborepoTraceAccess(f, parent) {
// If the trace file is not set, don't trace and instead just call the
// function.
if (!process.env.TURBOREPO_TRACE_FILE) return f();
// Otherwise, trace the function and merge the results into the parent. Using
// `then` instead of `await` here to avoid creating a new async context when
// tracing is disabled.
return withTurborepoTraceAccess(f).then(([result, proxy])=>{
parent.merge(proxy);
// Return the result of the function.
return result;
});
}
/**
* Write the access trace to the trace file.
*
* @param distDir the directory to write the trace file to
* @param traces an array of traces to merge and write to the trace file
*/ export async function writeTurborepoAccessTraceResult({ distDir, traces }) {
const configTraceFile = process.env.TURBOREPO_TRACE_FILE;
if (!configTraceFile || traces.length === 0) return;
// merge traces
const [accessTrace, ...otherTraces] = traces;
for (const trace of otherTraces){
accessTrace.merge(trace);
}
try {
// make sure the directory exists
await fs.mkdir(path.dirname(configTraceFile), {
recursive: true
});
await fs.writeFile(configTraceFile, JSON.stringify({
outputs: [
`${distDir}/**`,
`!${distDir}/cache/**`
],
accessed: accessTrace.toPublicTrace()
}));
} catch (err) {
// if we can't write this file, we should bail out here to avoid
// the possibility of incorrect turborepo cache hits.
throw new Error(`Failed to write turborepo access trace file`, {
cause: err
});
}
}
async function withTurborepoTraceAccess(f) {
const envVars = new Set([]);
// addresses is an array of objects, so a set is useless
const addresses = [];
// TODO: watch fsPaths (removed from this implementation for now)
const fsPaths = new Set();
// setup proxies
const restoreTCP = tcpProxy(addresses);
const restoreEnv = envProxy(envVars);
let functionResult;
// NOTE: we intentionally don't catch errors here so the calling function can handle them
try {
// call the wrapped function
functionResult = await f();
} finally{
// remove proxies
restoreTCP();
restoreEnv();
}
const traceResult = new TurborepoAccessTraceResult(envVars, addresses, fsPaths);
return [
functionResult,
traceResult
];
}
//# sourceMappingURL=helpers.js.map