@metamask-previews/tooling-insight 1.0.1-preview-898fae5

package/dist/run.cjs

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const allowlist_1 = require("./lib/allowlist.cjs");
+const csv_1 = require("./lib/csv.cjs");
+const exposition_1 = require("./lib/exposition.cjs");
+const fold_1 = require("./lib/fold.cjs");
+const log_1 = require("./lib/log.cjs");
+const paths_1 = require("./lib/paths.cjs");
+const push_1 = require("./lib/push.cjs");
+const remoteWrite_1 = require("./lib/remoteWrite.cjs");
+const state_1 = require("./lib/state.cjs");
+const TWENTY_FOUR_HOURS_MS = 24 * 60 * 60 * 1000;
+/**
+ * Parse the CLI flags from the argument list.
+ *
+ * @param args - The argument list to parse.
+ * @returns The parsed flag values.
+ */
+function parseFlags(args) {
+    const repoRootArg = args.find((arg) => arg.startsWith('--repo-root='));
+    return {
+        dryRun: args.includes('--dry-run'),
+        force: args.includes('--force'),
+        verbose: args.includes('--verbose'),
+        repoRoot: repoRootArg === undefined
+            ? null
+            : repoRootArg.slice('--repo-root='.length),
+    };
+}
+/**
+ * Returns true when no prior run exists or the last run was at least 24h ago.
+ *
+ * @param lastRunIso - ISO-8601 timestamp of the last run, or null.
+ * @param nowMs - Current timestamp in milliseconds.
+ * @returns True when a new run is due.
+ */
+function isDue(lastRunIso, nowMs) {
+    if (lastRunIso === null) {
+        return true;
+    }
+    const lastMs = Date.parse(lastRunIso);
+    if (Number.isNaN(lastMs)) {
+        return true;
+    }
+    return nowMs - lastMs >= TWENTY_FOUR_HOURS_MS;
+}
+/**
+ * Run the daily anonymizer: fold local CSV events into per-day anonymized
+ * counters and push them to the Prometheus remote-write endpoint.
+ *
+ * @param options - Optional overrides for args, repo root, git executor, and fetch.
+ */
+async function run(options = {}) {
+    const args = options.args ?? process.argv.slice(2);
+    const { dryRun, force, verbose, repoRoot: repoRootFlag } = parseFlags(args);
+    const logger = (0, log_1.createLogger)('anonymizer');
+    if ((0, paths_1.isCollectionDisabled)()) {
+        return;
+    }
+    try {
+        const state = (0, state_1.readState)();
+        if (!force && !isDue(state.last_run_at, Date.now())) {
+            logger.info('skipping — within 24h window', undefined, verbose);
+            return;
+        }
+        const repoRoot = repoRootFlag ?? options.repoRoot ?? (0, allowlist_1.findRepoRoot)(process.cwd());
+        // exactOptionalPropertyTypes: omit optional keys when undefined.
+        const allowlist = (0, allowlist_1.readAllowlist)({
+            repoRoot,
+            ...(options.execGit === undefined ? {} : { execGit: options.execGit }),
+        });
+        const todayUtc = (0, fold_1.todayUtcDay)();
+        const events = (0, csv_1.readAllEvents)({
+            /**
+             * Log malformed CSV rows for diagnostics without interrupting the run.
+             *
+             * @param line - The raw CSV row text that could not be parsed.
+             * @param reason - A description of why the row failed to parse.
+             */
+            onMalformedRow: (line, reason) => {
+                logger.error('malformed csv row skipped', { line, reason }, verbose);
+            },
+        });
+        const samples = (0, fold_1.fold)(events, allowlist, state.instance_uuid, state.last_pushed_day, todayUtc);
+        if (dryRun) {
+            // Inspect only: show human-readable text exposition; never push or advance state.
+            const textBody = (0, exposition_1.buildExpositionBody)(samples);
+            logger.info('dry-run body', { sampleCount: samples.length, body: textBody }, verbose);
+            return;
+        }
+        // Claim the 24h window up front so a second near-simultaneous spawn skips.
+        (0, state_1.markRunStart)(new Date().toISOString());
+        if (samples.length === 0) {
+            logger.info('nothing to push', undefined, verbose);
+            return;
+        }
+        const config = (0, push_1.loadPushConfig)(repoRoot);
+        // Encode as snappy-compressed protobuf WriteRequest for Mimir remote_write.
+        const body = (0, remoteWrite_1.encodeRemoteWrite)(samples);
+        await (0, push_1.pushBatch)(body, {
+            url: config.url,
+            // Spread optional credentials only when present — required by exactOptionalPropertyTypes.
+            ...(config.username !== undefined && { username: config.username }),
+            ...(config.password !== undefined && { password: config.password }),
+            dryRun: false,
+            ...(options.fetchImpl !== undefined && { fetchImpl: options.fetchImpl }),
+            logger: {
+                /**
+                 * Forward informational messages to the anonymizer logger with the current verbose flag.
+                 *
+                 * @param message - The message to log.
+                 * @param extra - Optional extra data to attach.
+                 * @returns void.
+                 */
+                info: (message, extra) => logger.info(message, extra, verbose),
+                /**
+                 * Forward error messages to the anonymizer logger with the current verbose flag.
+                 *
+                 * @param message - The message to log.
+                 * @param extra - Optional extra data to attach.
+                 * @returns void.
+                 */
+                error: (message, extra) => logger.error(message, extra, verbose),
+            },
+        });
+        // Only advance the cursor on a confirmed push; a failed push re-folds next run.
+        // maxDay is non-null here: we checked samples.length === 0 above, so the
+        // string type assertion is safe.
+        (0, state_1.markPushed)((0, fold_1.maxDay)(samples));
+        logger.info('publish complete', { latestDay: (0, fold_1.maxDay)(samples), sampleCount: samples.length }, verbose);
+    }
+    catch (error) {
+        logger.error('anonymizer failed', { error: error instanceof Error ? error.message : String(error) }, verbose);
+    }
+}
+//# sourceMappingURL=run.cjs.map

package/dist/run.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.cjs","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"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","sourcesContent":["import { findRepoRoot, readAllowlist } from './lib/allowlist';\nimport type { ExecGit } from './lib/allowlist';\nimport { readAllEvents } from './lib/csv';\nimport { buildExpositionBody } from './lib/exposition';\nimport { fold, maxDay, todayUtcDay } from './lib/fold';\nimport { createLogger } from './lib/log';\nimport { isCollectionDisabled } from './lib/paths';\nimport { loadPushConfig, pushBatch } from './lib/push';\nimport { encodeRemoteWrite } from './lib/remoteWrite';\nimport { markPushed, markRunStart, readState } from './lib/state';\n\nconst TWENTY_FOUR_HOURS_MS = 24 * 60 * 60 * 1000;\n\n/** Options for the `run` function. */\nexport type RunOptions = {\n  /** CLI argument list; defaults to `process.argv.slice(2)`. */\n  args?: string[];\n  /** Absolute path to the repo root; defaults to `findRepoRoot(process.cwd())`. */\n  repoRoot?: string;\n  /** Git executor; defaults to the real `execFileSync` wrapper. */\n  execGit?: ExecGit;\n  /** Fetch implementation; defaults to the global `fetch`. */\n  fetchImpl?: typeof fetch;\n};\n\n/** Parsed CLI flags. */\ntype Flags = {\n  /** Whether to run without pushing (inspect only). */\n  dryRun: boolean;\n  /** Whether to skip the 24h cadence check. */\n  force: boolean;\n  /** Whether to write log output to stdout. */\n  verbose: boolean;\n  /** Explicit repo root path from `--repo-root=<path>`; null when absent. */\n  repoRoot: string | null;\n};\n\n/**\n * Parse the CLI flags from the argument list.\n *\n * @param args - The argument list to parse.\n * @returns The parsed flag values.\n */\nfunction parseFlags(args: string[]): Flags {\n  const repoRootArg = args.find((arg) => arg.startsWith('--repo-root='));\n  return {\n    dryRun: args.includes('--dry-run'),\n    force: args.includes('--force'),\n    verbose: args.includes('--verbose'),\n    repoRoot:\n      repoRootArg === undefined\n        ? null\n        : repoRootArg.slice('--repo-root='.length),\n  };\n}\n\n/**\n * Returns true when no prior run exists or the last run was at least 24h ago.\n *\n * @param lastRunIso - ISO-8601 timestamp of the last run, or null.\n * @param nowMs - Current timestamp in milliseconds.\n * @returns True when a new run is due.\n */\nfunction isDue(lastRunIso: string | null, nowMs: number): boolean {\n  if (lastRunIso === null) {\n    return true;\n  }\n  const lastMs = Date.parse(lastRunIso);\n  if (Number.isNaN(lastMs)) {\n    return true;\n  }\n  return nowMs - lastMs >= TWENTY_FOUR_HOURS_MS;\n}\n\n/**\n * Run the daily anonymizer: fold local CSV events into per-day anonymized\n * counters and push them to the Prometheus remote-write endpoint.\n *\n * @param options - Optional overrides for args, repo root, git executor, and fetch.\n */\nexport async function run(options: RunOptions = {}): Promise<void> {\n  const args = options.args ?? process.argv.slice(2);\n  const { dryRun, force, verbose, repoRoot: repoRootFlag } = parseFlags(args);\n  const logger = createLogger('anonymizer');\n\n  if (isCollectionDisabled()) {\n    return;\n  }\n\n  try {\n    const state = readState();\n\n    if (!force && !isDue(state.last_run_at, Date.now())) {\n      logger.info('skipping — within 24h window', undefined, verbose);\n      return;\n    }\n\n    const repoRoot =\n      repoRootFlag ?? options.repoRoot ?? findRepoRoot(process.cwd());\n    // exactOptionalPropertyTypes: omit optional keys when undefined.\n    const allowlist = readAllowlist({\n      repoRoot,\n      ...(options.execGit === undefined ? {} : { execGit: options.execGit }),\n    });\n    const todayUtc = todayUtcDay();\n    const events = readAllEvents({\n      /**\n       * Log malformed CSV rows for diagnostics without interrupting the run.\n       *\n       * @param line - The raw CSV row text that could not be parsed.\n       * @param reason - A description of why the row failed to parse.\n       */\n      onMalformedRow: (line: string, reason: string) => {\n        logger.error('malformed csv row skipped', { line, reason }, verbose);\n      },\n    });\n    const samples = fold(\n      events,\n      allowlist,\n      state.instance_uuid,\n      state.last_pushed_day,\n      todayUtc,\n    );\n\n    if (dryRun) {\n      // Inspect only: show human-readable text exposition; never push or advance state.\n      const textBody = buildExpositionBody(samples);\n      logger.info(\n        'dry-run body',\n        { sampleCount: samples.length, body: textBody },\n        verbose,\n      );\n      return;\n    }\n\n    // Claim the 24h window up front so a second near-simultaneous spawn skips.\n    markRunStart(new Date().toISOString());\n\n    if (samples.length === 0) {\n      logger.info('nothing to push', undefined, verbose);\n      return;\n    }\n\n    const config = loadPushConfig(repoRoot);\n    // Encode as snappy-compressed protobuf WriteRequest for Mimir remote_write.\n    const body = encodeRemoteWrite(samples);\n    await pushBatch(body, {\n      url: config.url,\n      // Spread optional credentials only when present — required by exactOptionalPropertyTypes.\n      ...(config.username !== undefined && { username: config.username }),\n      ...(config.password !== undefined && { password: config.password }),\n      dryRun: false,\n      ...(options.fetchImpl !== undefined && { fetchImpl: options.fetchImpl }),\n      logger: {\n        /**\n         * Forward informational messages to the anonymizer logger with the current verbose flag.\n         *\n         * @param message - The message to log.\n         * @param extra - Optional extra data to attach.\n         * @returns void.\n         */\n        info: (message: string, extra?: Record<string, unknown>) =>\n          logger.info(message, extra, verbose),\n        /**\n         * Forward error messages to the anonymizer logger with the current verbose flag.\n         *\n         * @param message - The message to log.\n         * @param extra - Optional extra data to attach.\n         * @returns void.\n         */\n        error: (message: string, extra?: Record<string, unknown>) =>\n          logger.error(message, extra, verbose),\n      },\n    });\n\n    // Only advance the cursor on a confirmed push; a failed push re-folds next run.\n    // maxDay is non-null here: we checked samples.length === 0 above, so the\n    // string type assertion is safe.\n    markPushed(maxDay(samples) as string);\n    logger.info(\n      'publish complete',\n      { latestDay: maxDay(samples), sampleCount: samples.length },\n      verbose,\n    );\n  } catch (error) {\n    logger.error(\n      'anonymizer failed',\n      { error: error instanceof Error ? error.message : String(error) },\n      verbose,\n    );\n  }\n}\n"]}

package/dist/run.d.cts

@@ -0,0 +1,20 @@
+import type { ExecGit } from "./lib/allowlist.cjs";
+/** Options for the `run` function. */
+export type RunOptions = {
+    /** CLI argument list; defaults to `process.argv.slice(2)`. */
+    args?: string[];
+    /** Absolute path to the repo root; defaults to `findRepoRoot(process.cwd())`. */
+    repoRoot?: string;
+    /** Git executor; defaults to the real `execFileSync` wrapper. */
+    execGit?: ExecGit;
+    /** Fetch implementation; defaults to the global `fetch`. */
+    fetchImpl?: typeof fetch;
+};
+/**
+ * Run the daily anonymizer: fold local CSV events into per-day anonymized
+ * counters and push them to the Prometheus remote-write endpoint.
+ *
+ * @param options - Optional overrides for args, repo root, git executor, and fetch.
+ */
+export declare function run(options?: RunOptions): Promise<void>;
+//# sourceMappingURL=run.d.cts.map

package/dist/run.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.cts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,4BAAwB;AAY/C,sCAAsC;AACtC,MAAM,MAAM,UAAU,GAAG;IACvB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC;AAmDF;;;;;GAKG;AACH,wBAAsB,GAAG,CAAC,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA+GjE"}

package/dist/run.d.mts

@@ -0,0 +1,20 @@
+import type { ExecGit } from "./lib/allowlist.mjs";
+/** Options for the `run` function. */
+export type RunOptions = {
+    /** CLI argument list; defaults to `process.argv.slice(2)`. */
+    args?: string[];
+    /** Absolute path to the repo root; defaults to `findRepoRoot(process.cwd())`. */
+    repoRoot?: string;
+    /** Git executor; defaults to the real `execFileSync` wrapper. */
+    execGit?: ExecGit;
+    /** Fetch implementation; defaults to the global `fetch`. */
+    fetchImpl?: typeof fetch;
+};
+/**
+ * Run the daily anonymizer: fold local CSV events into per-day anonymized
+ * counters and push them to the Prometheus remote-write endpoint.
+ *
+ * @param options - Optional overrides for args, repo root, git executor, and fetch.
+ */
+export declare function run(options?: RunOptions): Promise<void>;
+//# sourceMappingURL=run.d.mts.map

package/dist/run.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.mts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,4BAAwB;AAY/C,sCAAsC;AACtC,MAAM,MAAM,UAAU,GAAG;IACvB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC;AAmDF;;;;;GAKG;AACH,wBAAsB,GAAG,CAAC,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA+GjE"}

package/dist/run.mjs

@@ -0,0 +1,134 @@
+import { findRepoRoot, readAllowlist } from "./lib/allowlist.mjs";
+import { readAllEvents } from "./lib/csv.mjs";
+import { buildExpositionBody } from "./lib/exposition.mjs";
+import { fold, maxDay, todayUtcDay } from "./lib/fold.mjs";
+import { createLogger } from "./lib/log.mjs";
+import { isCollectionDisabled } from "./lib/paths.mjs";
+import { loadPushConfig, pushBatch } from "./lib/push.mjs";
+import { encodeRemoteWrite } from "./lib/remoteWrite.mjs";
+import { markPushed, markRunStart, readState } from "./lib/state.mjs";
+const TWENTY_FOUR_HOURS_MS = 24 * 60 * 60 * 1000;
+/**
+ * Parse the CLI flags from the argument list.
+ *
+ * @param args - The argument list to parse.
+ * @returns The parsed flag values.
+ */
+function parseFlags(args) {
+    const repoRootArg = args.find((arg) => arg.startsWith('--repo-root='));
+    return {
+        dryRun: args.includes('--dry-run'),
+        force: args.includes('--force'),
+        verbose: args.includes('--verbose'),
+        repoRoot: repoRootArg === undefined
+            ? null
+            : repoRootArg.slice('--repo-root='.length),
+    };
+}
+/**
+ * Returns true when no prior run exists or the last run was at least 24h ago.
+ *
+ * @param lastRunIso - ISO-8601 timestamp of the last run, or null.
+ * @param nowMs - Current timestamp in milliseconds.
+ * @returns True when a new run is due.
+ */
+function isDue(lastRunIso, nowMs) {
+    if (lastRunIso === null) {
+        return true;
+    }
+    const lastMs = Date.parse(lastRunIso);
+    if (Number.isNaN(lastMs)) {
+        return true;
+    }
+    return nowMs - lastMs >= TWENTY_FOUR_HOURS_MS;
+}
+/**
+ * Run the daily anonymizer: fold local CSV events into per-day anonymized
+ * counters and push them to the Prometheus remote-write endpoint.
+ *
+ * @param options - Optional overrides for args, repo root, git executor, and fetch.
+ */
+export async function run(options = {}) {
+    const args = options.args ?? process.argv.slice(2);
+    const { dryRun, force, verbose, repoRoot: repoRootFlag } = parseFlags(args);
+    const logger = createLogger('anonymizer');
+    if (isCollectionDisabled()) {
+        return;
+    }
+    try {
+        const state = readState();
+        if (!force && !isDue(state.last_run_at, Date.now())) {
+            logger.info('skipping — within 24h window', undefined, verbose);
+            return;
+        }
+        const repoRoot = repoRootFlag ?? options.repoRoot ?? findRepoRoot(process.cwd());
+        // exactOptionalPropertyTypes: omit optional keys when undefined.
+        const allowlist = readAllowlist({
+            repoRoot,
+            ...(options.execGit === undefined ? {} : { execGit: options.execGit }),
+        });
+        const todayUtc = todayUtcDay();
+        const events = readAllEvents({
+            /**
+             * Log malformed CSV rows for diagnostics without interrupting the run.
+             *
+             * @param line - The raw CSV row text that could not be parsed.
+             * @param reason - A description of why the row failed to parse.
+             */
+            onMalformedRow: (line, reason) => {
+                logger.error('malformed csv row skipped', { line, reason }, verbose);
+            },
+        });
+        const samples = fold(events, allowlist, state.instance_uuid, state.last_pushed_day, todayUtc);
+        if (dryRun) {
+            // Inspect only: show human-readable text exposition; never push or advance state.
+            const textBody = buildExpositionBody(samples);
+            logger.info('dry-run body', { sampleCount: samples.length, body: textBody }, verbose);
+            return;
+        }
+        // Claim the 24h window up front so a second near-simultaneous spawn skips.
+        markRunStart(new Date().toISOString());
+        if (samples.length === 0) {
+            logger.info('nothing to push', undefined, verbose);
+            return;
+        }
+        const config = loadPushConfig(repoRoot);
+        // Encode as snappy-compressed protobuf WriteRequest for Mimir remote_write.
+        const body = encodeRemoteWrite(samples);
+        await pushBatch(body, {
+            url: config.url,
+            // Spread optional credentials only when present — required by exactOptionalPropertyTypes.
+            ...(config.username !== undefined && { username: config.username }),
+            ...(config.password !== undefined && { password: config.password }),
+            dryRun: false,
+            ...(options.fetchImpl !== undefined && { fetchImpl: options.fetchImpl }),
+            logger: {
+                /**
+                 * Forward informational messages to the anonymizer logger with the current verbose flag.
+                 *
+                 * @param message - The message to log.
+                 * @param extra - Optional extra data to attach.
+                 * @returns void.
+                 */
+                info: (message, extra) => logger.info(message, extra, verbose),
+                /**
+                 * Forward error messages to the anonymizer logger with the current verbose flag.
+                 *
+                 * @param message - The message to log.
+                 * @param extra - Optional extra data to attach.
+                 * @returns void.
+                 */
+                error: (message, extra) => logger.error(message, extra, verbose),
+            },
+        });
+        // Only advance the cursor on a confirmed push; a failed push re-folds next run.
+        // maxDay is non-null here: we checked samples.length === 0 above, so the
+        // string type assertion is safe.
+        markPushed(maxDay(samples));
+        logger.info('publish complete', { latestDay: maxDay(samples), sampleCount: samples.length }, verbose);
+    }
+    catch (error) {
+        logger.error('anonymizer failed', { error: error instanceof Error ? error.message : String(error) }, verbose);
+    }
+}
+//# sourceMappingURL=run.mjs.map

package/dist/run.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.mjs","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"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","sourcesContent":["import { findRepoRoot, readAllowlist } from './lib/allowlist';\nimport type { ExecGit } from './lib/allowlist';\nimport { readAllEvents } from './lib/csv';\nimport { buildExpositionBody } from './lib/exposition';\nimport { fold, maxDay, todayUtcDay } from './lib/fold';\nimport { createLogger } from './lib/log';\nimport { isCollectionDisabled } from './lib/paths';\nimport { loadPushConfig, pushBatch } from './lib/push';\nimport { encodeRemoteWrite } from './lib/remoteWrite';\nimport { markPushed, markRunStart, readState } from './lib/state';\n\nconst TWENTY_FOUR_HOURS_MS = 24 * 60 * 60 * 1000;\n\n/** Options for the `run` function. */\nexport type RunOptions = {\n  /** CLI argument list; defaults to `process.argv.slice(2)`. */\n  args?: string[];\n  /** Absolute path to the repo root; defaults to `findRepoRoot(process.cwd())`. */\n  repoRoot?: string;\n  /** Git executor; defaults to the real `execFileSync` wrapper. */\n  execGit?: ExecGit;\n  /** Fetch implementation; defaults to the global `fetch`. */\n  fetchImpl?: typeof fetch;\n};\n\n/** Parsed CLI flags. */\ntype Flags = {\n  /** Whether to run without pushing (inspect only). */\n  dryRun: boolean;\n  /** Whether to skip the 24h cadence check. */\n  force: boolean;\n  /** Whether to write log output to stdout. */\n  verbose: boolean;\n  /** Explicit repo root path from `--repo-root=<path>`; null when absent. */\n  repoRoot: string | null;\n};\n\n/**\n * Parse the CLI flags from the argument list.\n *\n * @param args - The argument list to parse.\n * @returns The parsed flag values.\n */\nfunction parseFlags(args: string[]): Flags {\n  const repoRootArg = args.find((arg) => arg.startsWith('--repo-root='));\n  return {\n    dryRun: args.includes('--dry-run'),\n    force: args.includes('--force'),\n    verbose: args.includes('--verbose'),\n    repoRoot:\n      repoRootArg === undefined\n        ? null\n        : repoRootArg.slice('--repo-root='.length),\n  };\n}\n\n/**\n * Returns true when no prior run exists or the last run was at least 24h ago.\n *\n * @param lastRunIso - ISO-8601 timestamp of the last run, or null.\n * @param nowMs - Current timestamp in milliseconds.\n * @returns True when a new run is due.\n */\nfunction isDue(lastRunIso: string | null, nowMs: number): boolean {\n  if (lastRunIso === null) {\n    return true;\n  }\n  const lastMs = Date.parse(lastRunIso);\n  if (Number.isNaN(lastMs)) {\n    return true;\n  }\n  return nowMs - lastMs >= TWENTY_FOUR_HOURS_MS;\n}\n\n/**\n * Run the daily anonymizer: fold local CSV events into per-day anonymized\n * counters and push them to the Prometheus remote-write endpoint.\n *\n * @param options - Optional overrides for args, repo root, git executor, and fetch.\n */\nexport async function run(options: RunOptions = {}): Promise<void> {\n  const args = options.args ?? process.argv.slice(2);\n  const { dryRun, force, verbose, repoRoot: repoRootFlag } = parseFlags(args);\n  const logger = createLogger('anonymizer');\n\n  if (isCollectionDisabled()) {\n    return;\n  }\n\n  try {\n    const state = readState();\n\n    if (!force && !isDue(state.last_run_at, Date.now())) {\n      logger.info('skipping — within 24h window', undefined, verbose);\n      return;\n    }\n\n    const repoRoot =\n      repoRootFlag ?? options.repoRoot ?? findRepoRoot(process.cwd());\n    // exactOptionalPropertyTypes: omit optional keys when undefined.\n    const allowlist = readAllowlist({\n      repoRoot,\n      ...(options.execGit === undefined ? {} : { execGit: options.execGit }),\n    });\n    const todayUtc = todayUtcDay();\n    const events = readAllEvents({\n      /**\n       * Log malformed CSV rows for diagnostics without interrupting the run.\n       *\n       * @param line - The raw CSV row text that could not be parsed.\n       * @param reason - A description of why the row failed to parse.\n       */\n      onMalformedRow: (line: string, reason: string) => {\n        logger.error('malformed csv row skipped', { line, reason }, verbose);\n      },\n    });\n    const samples = fold(\n      events,\n      allowlist,\n      state.instance_uuid,\n      state.last_pushed_day,\n      todayUtc,\n    );\n\n    if (dryRun) {\n      // Inspect only: show human-readable text exposition; never push or advance state.\n      const textBody = buildExpositionBody(samples);\n      logger.info(\n        'dry-run body',\n        { sampleCount: samples.length, body: textBody },\n        verbose,\n      );\n      return;\n    }\n\n    // Claim the 24h window up front so a second near-simultaneous spawn skips.\n    markRunStart(new Date().toISOString());\n\n    if (samples.length === 0) {\n      logger.info('nothing to push', undefined, verbose);\n      return;\n    }\n\n    const config = loadPushConfig(repoRoot);\n    // Encode as snappy-compressed protobuf WriteRequest for Mimir remote_write.\n    const body = encodeRemoteWrite(samples);\n    await pushBatch(body, {\n      url: config.url,\n      // Spread optional credentials only when present — required by exactOptionalPropertyTypes.\n      ...(config.username !== undefined && { username: config.username }),\n      ...(config.password !== undefined && { password: config.password }),\n      dryRun: false,\n      ...(options.fetchImpl !== undefined && { fetchImpl: options.fetchImpl }),\n      logger: {\n        /**\n         * Forward informational messages to the anonymizer logger with the current verbose flag.\n         *\n         * @param message - The message to log.\n         * @param extra - Optional extra data to attach.\n         * @returns void.\n         */\n        info: (message: string, extra?: Record<string, unknown>) =>\n          logger.info(message, extra, verbose),\n        /**\n         * Forward error messages to the anonymizer logger with the current verbose flag.\n         *\n         * @param message - The message to log.\n         * @param extra - Optional extra data to attach.\n         * @returns void.\n         */\n        error: (message: string, extra?: Record<string, unknown>) =>\n          logger.error(message, extra, verbose),\n      },\n    });\n\n    // Only advance the cursor on a confirmed push; a failed push re-folds next run.\n    // maxDay is non-null here: we checked samples.length === 0 above, so the\n    // string type assertion is safe.\n    markPushed(maxDay(samples) as string);\n    logger.info(\n      'publish complete',\n      { latestDay: maxDay(samples), sampleCount: samples.length },\n      verbose,\n    );\n  } catch (error) {\n    logger.error(\n      'anonymizer failed',\n      { error: error instanceof Error ? error.message : String(error) },\n      verbose,\n    );\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "@metamask-previews/tooling-insight",
+  "version": "1.0.1-preview-898fae5",
+  "description": "Daily anonymizer for MetaMask developer tooling usage metrics",
+  "homepage": "https://github.com/MetaMask/experimental-tooling-insight#readme",
+  "bugs": {
+    "url": "https://github.com/MetaMask/experimental-tooling-insight/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MetaMask/experimental-tooling-insight.git"
+  },
+  "bin": {
+    "metamask-daily-anonymizer": "./dist/daily-anonymizer.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "tag": "alpha"
+  },
+  "scripts": {
+    "build": "ts-bridge --project tsconfig.build.json --clean",
+    "lint": "yarn lint:eslint && yarn lint:constraints && yarn lint:misc --check && yarn lint:dependencies --check && yarn lint:changelog",
+    "lint:changelog": "auto-changelog validate --formatter oxfmt",
+    "lint:constraints": "yarn constraints",
+    "lint:dependencies": "depcheck && yarn dedupe --check",
+    "lint:dependencies:fix": "depcheck && yarn dedupe",
+    "lint:eslint": "eslint .",
+    "lint:fix": "yarn lint:eslint --fix && yarn lint:constraints --fix && yarn lint:misc --write && yarn lint:dependencies:fix && yarn lint:changelog --fix",
+    "lint:misc": "oxfmt --ignore-path .gitignore",
+    "prepack": "./scripts/prepack.sh",
+    "test": "vitest && attw --pack",
+    "test:watch": "vitest --watch"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.15.3",
+    "@lavamoat/allow-scripts": "^3.0.4",
+    "@lavamoat/preinstall-always-fail": "^2.0.0",
+    "@metamask/auto-changelog": "^6.1.0",
+    "@metamask/eslint-config": "^15.0.0",
+    "@metamask/eslint-config-nodejs": "^15.0.0",
+    "@metamask/eslint-config-typescript": "^15.0.0",
+    "@metamask/eslint-config-vitest": "^15.0.0",
+    "@ts-bridge/cli": "^0.6.3",
+    "@types/node": "^20",
+    "@typescript-eslint/utils": "^8.6.0",
+    "@vitest/coverage-istanbul": "^4.1.4",
+    "@vitest/eslint-plugin": "^1.1.4",
+    "@yarnpkg/types": "^4.0.0-rc.52",
+    "depcheck": "^1.4.3",
+    "eslint": "^9.11.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-import-resolver-typescript": "^3.6.3",
+    "eslint-plugin-import-x": "^4.3.0",
+    "eslint-plugin-jsdoc": "^50.2.4",
+    "eslint-plugin-n": "^17.10.3",
+    "eslint-plugin-prettier": "^5.2.1",
+    "eslint-plugin-promise": "^7.1.0",
+    "oxfmt": "^0.45.0",
+    "ts-node": "^10.7.0",
+    "typescript": "~5.7.3",
+    "typescript-eslint": "^8.48.1",
+    "vite": "^8.0.16",
+    "vitest": "^4.1.4"
+  },
+  "resolutions": {
+    "fflate": "0.8.2"
+  },
+  "engines": {
+    "node": "^20 || ^22 || >=24"
+  },
+  "packageManager": "yarn@4.16.0+sha256.ba05224324578801b9cc98170d64aa50b9a36733b440fb0942306da3fbbdc7d1",
+  "lavamoat": {
+    "allowScripts": {
+      "@lavamoat/preinstall-always-fail": false,
+      "eslint-plugin-import-x>unrs-resolver": false
+    }
+  }
+}