@mui/x-telemetry/esm/postinstall/storage.js

MUI X Telemetry.

import { randomBytes } from 'crypto';
import path from 'path';
import notifyAboutMuiXTelemetry from "./notify.js";
import getEnvironmentInfo from "./get-environment-info.js";

// This is the key that specifies when the user was informed about telemetry collection.
const TELEMETRY_KEY_NOTIFY_DATE = 'telemetry.notifiedAt';

// This is a quasi-persistent identifier used to dedupe recurring events. It's
// generated from random data and completely anonymous.
const TELEMETRY_KEY_ID = `telemetry.anonymousId`;
function getStorageDirectory(distDir) {
  const env = getEnvironmentInfo();
  const isLikelyEphemeral = env.isCI || env.isDocker;
  if (isLikelyEphemeral) {
    return path.join(distDir, 'cache');
  }
  return undefined;
}
export class TelemetryStorage {
  static async init({
    distDir
  }) {
    const storageDirectory = getStorageDirectory(distDir);
    let conf = null;
    try {
      // `conf` incorrectly throws a permission error during initialization
      // instead of waiting for first use. We need to handle it, otherwise the
      // process may crash.
      const {
        default: Conf
      } = await import('conf');
      conf = new Conf({
        projectName: 'mui-x',
        cwd: storageDirectory
      });
    } catch (_) {
      conf = null;
    }
    return new TelemetryStorage(conf);
  }
  constructor(conf) {
    this.conf = conf;
    this.notify = () => {
      if (!this.conf) {
        return;
      }

      // The end-user has already been notified about our telemetry integration. We
      // don't need to constantly annoy them about it.
      // We will re-inform users about the telemetry if significant changes are
      // ever made.
      if (this.conf.get(TELEMETRY_KEY_NOTIFY_DATE, '')) {
        return;
      }
      this.conf.set(TELEMETRY_KEY_NOTIFY_DATE, Date.now().toString());
      notifyAboutMuiXTelemetry();
    };
    this.notify();
  }
  get configPath() {
    return this.conf?.path;
  }
  get anonymousId() {
    const val = this.conf && this.conf.get(TELEMETRY_KEY_ID);
    if (val) {
      return val;
    }
    const generated = randomBytes(32).toString('hex');
    this.conf?.set(TELEMETRY_KEY_ID, generated);
    return generated;
  }
}