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

package/dist/lib/log.mjs

@@ -0,0 +1,113 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { getAnonymizerLogPath } from "./paths.mjs";
+const MAX_LOG_BYTES = 1024 * 1024;
+const MAX_ROTATED = 3;
+/**
+ * Create the log directory if it does not yet exist.
+ *
+ * @param path - Absolute path to the log file whose parent directory to create.
+ */
+function ensureLogDir(path) {
+    const dir = dirname(path);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Rotate the log file when it exceeds 1 MiB.
+ *
+ * @param path - Absolute path to the log file to rotate.
+ */
+function rotateIfNeeded(path) {
+    if (!existsSync(path)) {
+        return;
+    }
+    const { size } = statSync(path);
+    if (size <= MAX_LOG_BYTES) {
+        return;
+    }
+    for (let index = MAX_ROTATED; index >= 1; index -= 1) {
+        const from = index === 1 ? path : `${path}.${index - 1}`;
+        const to = `${path}.${index}`;
+        if (existsSync(from)) {
+            if (existsSync(to)) {
+                unlinkSync(to);
+            }
+            renameSync(from, to);
+        }
+    }
+}
+/**
+ * Create a structured logger that appends JSON lines to the anonymizer log file,
+ * rotating when the file exceeds 1 MiB.
+ *
+ * @param cli - The CLI name to embed in every log entry.
+ * @param logPath - Path to the log file; defaults to the configured anonymizer log path.
+ * @returns An object with `info`, `error`, and `readLog` methods.
+ */
+export function createLogger(cli, logPath = getAnonymizerLogPath()) {
+    /**
+     * Append an entry to the log file, rotating first when needed.
+     *
+     * @param entry - The log entry to serialise.
+     * @param verbose - When true, also writes to stdout.
+     */
+    const write = (entry, verbose) => {
+        ensureLogDir(logPath);
+        rotateIfNeeded(logPath);
+        const line = `${JSON.stringify(entry)}\n`;
+        writeFileSync(logPath, line, { flag: 'a' });
+        if (verbose) {
+            process.stdout.write(line);
+        }
+    };
+    return {
+        /**
+         * Log an informational message.
+         *
+         * @param message - The message to log.
+         * @param extra - Optional extra data to attach to the log entry.
+         * @param verbose - When true, also writes to stdout.
+         */
+        info(message, extra, verbose = false) {
+            write({
+                ts: new Date().toISOString(),
+                cli,
+                level: 'info',
+                message,
+                // exactOptionalPropertyTypes: omit the key when undefined rather than
+                // assigning undefined to an optional property.
+                ...(extra === undefined ? {} : { extra }),
+            }, verbose);
+        },
+        /**
+         * Log an error message.
+         *
+         * @param message - The message to log.
+         * @param extra - Optional extra data to attach to the log entry.
+         * @param verbose - When true, also writes to stdout.
+         */
+        error(message, extra, verbose = false) {
+            write({
+                ts: new Date().toISOString(),
+                cli,
+                level: 'error',
+                message,
+                ...(extra === undefined ? {} : { extra }),
+            }, verbose);
+        },
+        /**
+         * Read the full contents of the log file.
+         *
+         * @returns The log file contents, or an empty string if the file does not exist.
+         */
+        readLog() {
+            if (!existsSync(logPath)) {
+                return '';
+            }
+            return readFileSync(logPath, 'utf8');
+        },
+    };
+}
+//# sourceMappingURL=log.mjs.map

package/dist/lib/log.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.mjs","sourceRoot":"","sources":["../../src/lib/log.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  renameSync,\n  statSync,\n  unlinkSync,\n  writeFileSync,\n} from 'node:fs';\nimport { dirname } from 'node:path';\n\nimport { getAnonymizerLogPath } from './paths';\n\n/** One structured log entry written to the anonymizer log file. */\nexport type LogEntry = {\n  /** ISO-8601 timestamp of when the entry was written. */\n  ts: string;\n  /** The CLI name that produced the entry. */\n  cli: string;\n  /** Severity level. */\n  level: 'info' | 'error';\n  /** Human-readable message. */\n  message: string;\n  /** Optional extra structured data to attach to the entry. */\n  extra?: Record<string, unknown>;\n};\n\n/** The type returned by `createLogger`. */\nexport type LoggerInstance = {\n  /** Log an informational message. */\n  info: (\n    message: string,\n    extra?: Record<string, unknown>,\n    verbose?: boolean,\n  ) => void;\n  /** Log an error message. */\n  error: (\n    message: string,\n    extra?: Record<string, unknown>,\n    verbose?: boolean,\n  ) => void;\n  /** Read the full contents of the log file. */\n  readLog: () => string;\n};\n\nconst MAX_LOG_BYTES = 1024 * 1024;\nconst MAX_ROTATED = 3;\n\n/**\n * Create the log directory if it does not yet exist.\n *\n * @param path - Absolute path to the log file whose parent directory to create.\n */\nfunction ensureLogDir(path: string): void {\n  const dir = dirname(path);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n}\n\n/**\n * Rotate the log file when it exceeds 1 MiB.\n *\n * @param path - Absolute path to the log file to rotate.\n */\nfunction rotateIfNeeded(path: string): void {\n  if (!existsSync(path)) {\n    return;\n  }\n  const { size } = statSync(path);\n  if (size <= MAX_LOG_BYTES) {\n    return;\n  }\n  for (let index = MAX_ROTATED; index >= 1; index -= 1) {\n    const from = index === 1 ? path : `${path}.${index - 1}`;\n    const to = `${path}.${index}`;\n    if (existsSync(from)) {\n      if (existsSync(to)) {\n        unlinkSync(to);\n      }\n      renameSync(from, to);\n    }\n  }\n}\n\n/**\n * Create a structured logger that appends JSON lines to the anonymizer log file,\n * rotating when the file exceeds 1 MiB.\n *\n * @param cli - The CLI name to embed in every log entry.\n * @param logPath - Path to the log file; defaults to the configured anonymizer log path.\n * @returns An object with `info`, `error`, and `readLog` methods.\n */\nexport function createLogger(\n  cli: string,\n  logPath = getAnonymizerLogPath(),\n): LoggerInstance {\n  /**\n   * Append an entry to the log file, rotating first when needed.\n   *\n   * @param entry - The log entry to serialise.\n   * @param verbose - When true, also writes to stdout.\n   */\n  const write = (entry: LogEntry, verbose: boolean): void => {\n    ensureLogDir(logPath);\n    rotateIfNeeded(logPath);\n    const line = `${JSON.stringify(entry)}\\n`;\n    writeFileSync(logPath, line, { flag: 'a' });\n    if (verbose) {\n      process.stdout.write(line);\n    }\n  };\n\n  return {\n    /**\n     * Log an informational message.\n     *\n     * @param message - The message to log.\n     * @param extra - Optional extra data to attach to the log entry.\n     * @param verbose - When true, also writes to stdout.\n     */\n    info(\n      message: string,\n      extra?: Record<string, unknown>,\n      verbose = false,\n    ): void {\n      write(\n        {\n          ts: new Date().toISOString(),\n          cli,\n          level: 'info',\n          message,\n          // exactOptionalPropertyTypes: omit the key when undefined rather than\n          // assigning undefined to an optional property.\n          ...(extra === undefined ? {} : { extra }),\n        },\n        verbose,\n      );\n    },\n    /**\n     * Log an error message.\n     *\n     * @param message - The message to log.\n     * @param extra - Optional extra data to attach to the log entry.\n     * @param verbose - When true, also writes to stdout.\n     */\n    error(\n      message: string,\n      extra?: Record<string, unknown>,\n      verbose = false,\n    ): void {\n      write(\n        {\n          ts: new Date().toISOString(),\n          cli,\n          level: 'error',\n          message,\n          ...(extra === undefined ? {} : { extra }),\n        },\n        verbose,\n      );\n    },\n    /**\n     * Read the full contents of the log file.\n     *\n     * @returns The log file contents, or an empty string if the file does not exist.\n     */\n    readLog(): string {\n      if (!existsSync(logPath)) {\n        return '';\n      }\n      return readFileSync(logPath, 'utf8');\n    },\n  };\n}\n"]}

package/dist/lib/paths.cjs

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENV_TOOL_USAGE_COLLECTION_DIR = exports.ENV_MIMIR_PASSWORD = exports.ENV_MIMIR_USERNAME = exports.ENV_MIMIR_URL = exports.ENV_ANONYMIZER_LOG_PATH = exports.ENV_TOOL_USAGE_COLLECTION_LOG_PATH = void 0;
+exports.isCollectionDisabled = isCollectionDisabled;
+exports.expandHomePath = expandHomePath;
+exports.getCollectionDir = getCollectionDir;
+exports.getEventsLogDir = getEventsLogDir;
+exports.getStatePath = getStatePath;
+exports.getAnonymizerLogPath = getAnonymizerLogPath;
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+exports.ENV_TOOL_USAGE_COLLECTION_LOG_PATH = 'TOOL_USAGE_COLLECTION_LOG_PATH';
+exports.ENV_ANONYMIZER_LOG_PATH = 'ANONYMIZER_LOG_PATH';
+exports.ENV_MIMIR_URL = 'MIMIR_URL';
+exports.ENV_MIMIR_USERNAME = 'MIMIR_USERNAME';
+exports.ENV_MIMIR_PASSWORD = 'MIMIR_PASSWORD';
+exports.ENV_TOOL_USAGE_COLLECTION_DIR = 'TOOL_USAGE_COLLECTION_DIR';
+const DEFAULT_COLLECTION_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), '.tool-usage-collection');
+const STATE_FILE_NAME = 'anonymizer-state.json';
+const DEFAULT_LOG_FILE_NAME = 'anonymizer.log';
+/**
+ * Returns true when telemetry collection is disabled (CI environment or explicit opt-out).
+ *
+ * @returns `true` when `CI` is set or `TOOL_USAGE_COLLECTION_OPT_IN` is `"false"`.
+ */
+function isCollectionDisabled() {
+    return (Boolean(process.env.CI) ||
+        process.env.TOOL_USAGE_COLLECTION_OPT_IN === 'false');
+}
+/**
+ * Expands a leading `~` or `~/` to the current user's home directory.
+ *
+ * @param path - A path that may start with `~`.
+ * @returns The path with `~` expanded to the home directory.
+ */
+function expandHomePath(path) {
+    if (path === '~') {
+        return (0, node_os_1.homedir)();
+    }
+    if (path.startsWith('~/')) {
+        return (0, node_path_1.join)((0, node_os_1.homedir)(), path.slice(2));
+    }
+    return path;
+}
+/**
+ * Base directory for anonymizer state and the default log file.
+ *
+ * @returns Absolute path to the collection directory.
+ */
+function getCollectionDir() {
+    const configured = process.env[exports.ENV_TOOL_USAGE_COLLECTION_DIR];
+    if (configured) {
+        return expandHomePath(configured);
+    }
+    return DEFAULT_COLLECTION_DIR;
+}
+/**
+ * Directory scanned for `*-events.log` source files.
+ * When `TOOL_USAGE_COLLECTION_LOG_PATH` points at a `.log` file, its parent dir is used.
+ *
+ * @returns Absolute path to the directory containing event log files.
+ */
+function getEventsLogDir() {
+    const configured = process.env[exports.ENV_TOOL_USAGE_COLLECTION_LOG_PATH];
+    if (!configured) {
+        return getCollectionDir();
+    }
+    const expanded = expandHomePath(configured);
+    return expanded.endsWith('.log') ? (0, node_path_1.dirname)(expanded) : expanded;
+}
+/**
+ * Absolute path to the anonymizer state JSON file.
+ *
+ * @returns Absolute path to the anonymizer state JSON file.
+ */
+function getStatePath() {
+    return (0, node_path_1.join)(getCollectionDir(), STATE_FILE_NAME);
+}
+/**
+ * Absolute path to the anonymizer log file.
+ *
+ * @returns Absolute path to the anonymizer log file.
+ */
+function getAnonymizerLogPath() {
+    const configured = process.env[exports.ENV_ANONYMIZER_LOG_PATH];
+    if (configured) {
+        return expandHomePath(configured);
+    }
+    return (0, node_path_1.join)(getCollectionDir(), DEFAULT_LOG_FILE_NAME);
+}
+//# sourceMappingURL=paths.cjs.map

package/dist/lib/paths.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.cjs","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":";;;AAsBA,oDAKC;AAQD,wCAQC;AAOD,4CAMC;AAQD,0CAOC;AAOD,oCAEC;AAOD,oDAMC;AA7FD,qCAAkC;AAClC,yCAA0C;AAE7B,QAAA,kCAAkC,GAC7C,gCAAgC,CAAC;AACtB,QAAA,uBAAuB,GAAG,qBAAqB,CAAC;AAChD,QAAA,aAAa,GAAG,WAAW,CAAC;AAC5B,QAAA,kBAAkB,GAAG,gBAAgB,CAAC;AACtC,QAAA,kBAAkB,GAAG,gBAAgB,CAAC;AAEtC,QAAA,6BAA6B,GAAG,2BAA2B,CAAC;AAEzE,MAAM,sBAAsB,GAAG,IAAA,gBAAI,EAAC,IAAA,iBAAO,GAAE,EAAE,wBAAwB,CAAC,CAAC;AAEzE,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAChD,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AAE/C;;;;GAIG;AACH,SAAgB,oBAAoB;IAClC,OAAO,CACL,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,OAAO,CACrD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,IAAY;IACzC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,OAAO,IAAA,iBAAO,GAAE,CAAC;IACnB,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAA,gBAAI,EAAC,IAAA,iBAAO,GAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB;IAC9B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,qCAA6B,CAAC,CAAC;IAC9D,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,cAAc,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe;IAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,0CAAkC,CAAC,CAAC;IACnE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,gBAAgB,EAAE,CAAC;IAC5B,CAAC;IACD,MAAM,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAA,mBAAO,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,SAAgB,YAAY;IAC1B,OAAO,IAAA,gBAAI,EAAC,gBAAgB,EAAE,EAAE,eAAe,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB;IAClC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,+BAAuB,CAAC,CAAC;IACxD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,cAAc,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAA,gBAAI,EAAC,gBAAgB,EAAE,EAAE,qBAAqB,CAAC,CAAC;AACzD,CAAC","sourcesContent":["import { homedir } from 'node:os';\nimport { dirname, join } from 'node:path';\n\nexport const ENV_TOOL_USAGE_COLLECTION_LOG_PATH =\n  'TOOL_USAGE_COLLECTION_LOG_PATH';\nexport const ENV_ANONYMIZER_LOG_PATH = 'ANONYMIZER_LOG_PATH';\nexport const ENV_MIMIR_URL = 'MIMIR_URL';\nexport const ENV_MIMIR_USERNAME = 'MIMIR_USERNAME';\nexport const ENV_MIMIR_PASSWORD = 'MIMIR_PASSWORD';\n\nexport const ENV_TOOL_USAGE_COLLECTION_DIR = 'TOOL_USAGE_COLLECTION_DIR';\n\nconst DEFAULT_COLLECTION_DIR = join(homedir(), '.tool-usage-collection');\n\nconst STATE_FILE_NAME = 'anonymizer-state.json';\nconst DEFAULT_LOG_FILE_NAME = 'anonymizer.log';\n\n/**\n * Returns true when telemetry collection is disabled (CI environment or explicit opt-out).\n *\n * @returns `true` when `CI` is set or `TOOL_USAGE_COLLECTION_OPT_IN` is `\"false\"`.\n */\nexport function isCollectionDisabled(): boolean {\n  return (\n    Boolean(process.env.CI) ||\n    process.env.TOOL_USAGE_COLLECTION_OPT_IN === 'false'\n  );\n}\n\n/**\n * Expands a leading `~` or `~/` to the current user's home directory.\n *\n * @param path - A path that may start with `~`.\n * @returns The path with `~` expanded to the home directory.\n */\nexport function expandHomePath(path: string): string {\n  if (path === '~') {\n    return homedir();\n  }\n  if (path.startsWith('~/')) {\n    return join(homedir(), path.slice(2));\n  }\n  return path;\n}\n\n/**\n * Base directory for anonymizer state and the default log file.\n *\n * @returns Absolute path to the collection directory.\n */\nexport function getCollectionDir(): string {\n  const configured = process.env[ENV_TOOL_USAGE_COLLECTION_DIR];\n  if (configured) {\n    return expandHomePath(configured);\n  }\n  return DEFAULT_COLLECTION_DIR;\n}\n\n/**\n * Directory scanned for `*-events.log` source files.\n * When `TOOL_USAGE_COLLECTION_LOG_PATH` points at a `.log` file, its parent dir is used.\n *\n * @returns Absolute path to the directory containing event log files.\n */\nexport function getEventsLogDir(): string {\n  const configured = process.env[ENV_TOOL_USAGE_COLLECTION_LOG_PATH];\n  if (!configured) {\n    return getCollectionDir();\n  }\n  const expanded = expandHomePath(configured);\n  return expanded.endsWith('.log') ? dirname(expanded) : expanded;\n}\n\n/**\n * Absolute path to the anonymizer state JSON file.\n *\n * @returns Absolute path to the anonymizer state JSON file.\n */\nexport function getStatePath(): string {\n  return join(getCollectionDir(), STATE_FILE_NAME);\n}\n\n/**\n * Absolute path to the anonymizer log file.\n *\n * @returns Absolute path to the anonymizer log file.\n */\nexport function getAnonymizerLogPath(): string {\n  const configured = process.env[ENV_ANONYMIZER_LOG_PATH];\n  if (configured) {\n    return expandHomePath(configured);\n  }\n  return join(getCollectionDir(), DEFAULT_LOG_FILE_NAME);\n}\n"]}

package/dist/lib/paths.d.cts

@@ -0,0 +1,45 @@
+export declare const ENV_TOOL_USAGE_COLLECTION_LOG_PATH = "TOOL_USAGE_COLLECTION_LOG_PATH";
+export declare const ENV_ANONYMIZER_LOG_PATH = "ANONYMIZER_LOG_PATH";
+export declare const ENV_MIMIR_URL = "MIMIR_URL";
+export declare const ENV_MIMIR_USERNAME = "MIMIR_USERNAME";
+export declare const ENV_MIMIR_PASSWORD = "MIMIR_PASSWORD";
+export declare const ENV_TOOL_USAGE_COLLECTION_DIR = "TOOL_USAGE_COLLECTION_DIR";
+/**
+ * Returns true when telemetry collection is disabled (CI environment or explicit opt-out).
+ *
+ * @returns `true` when `CI` is set or `TOOL_USAGE_COLLECTION_OPT_IN` is `"false"`.
+ */
+export declare function isCollectionDisabled(): boolean;
+/**
+ * Expands a leading `~` or `~/` to the current user's home directory.
+ *
+ * @param path - A path that may start with `~`.
+ * @returns The path with `~` expanded to the home directory.
+ */
+export declare function expandHomePath(path: string): string;
+/**
+ * Base directory for anonymizer state and the default log file.
+ *
+ * @returns Absolute path to the collection directory.
+ */
+export declare function getCollectionDir(): string;
+/**
+ * Directory scanned for `*-events.log` source files.
+ * When `TOOL_USAGE_COLLECTION_LOG_PATH` points at a `.log` file, its parent dir is used.
+ *
+ * @returns Absolute path to the directory containing event log files.
+ */
+export declare function getEventsLogDir(): string;
+/**
+ * Absolute path to the anonymizer state JSON file.
+ *
+ * @returns Absolute path to the anonymizer state JSON file.
+ */
+export declare function getStatePath(): string;
+/**
+ * Absolute path to the anonymizer log file.
+ *
+ * @returns Absolute path to the anonymizer log file.
+ */
+export declare function getAnonymizerLogPath(): string;
+//# sourceMappingURL=paths.d.cts.map

package/dist/lib/paths.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.cts","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kCAAkC,mCACb,CAAC;AACnC,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAC7D,eAAO,MAAM,aAAa,cAAc,CAAC;AACzC,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD,eAAO,MAAM,6BAA6B,8BAA8B,CAAC;AAOzE;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAK9C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAOxC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C"}

package/dist/lib/paths.d.mts

@@ -0,0 +1,45 @@
+export declare const ENV_TOOL_USAGE_COLLECTION_LOG_PATH = "TOOL_USAGE_COLLECTION_LOG_PATH";
+export declare const ENV_ANONYMIZER_LOG_PATH = "ANONYMIZER_LOG_PATH";
+export declare const ENV_MIMIR_URL = "MIMIR_URL";
+export declare const ENV_MIMIR_USERNAME = "MIMIR_USERNAME";
+export declare const ENV_MIMIR_PASSWORD = "MIMIR_PASSWORD";
+export declare const ENV_TOOL_USAGE_COLLECTION_DIR = "TOOL_USAGE_COLLECTION_DIR";
+/**
+ * Returns true when telemetry collection is disabled (CI environment or explicit opt-out).
+ *
+ * @returns `true` when `CI` is set or `TOOL_USAGE_COLLECTION_OPT_IN` is `"false"`.
+ */
+export declare function isCollectionDisabled(): boolean;
+/**
+ * Expands a leading `~` or `~/` to the current user's home directory.
+ *
+ * @param path - A path that may start with `~`.
+ * @returns The path with `~` expanded to the home directory.
+ */
+export declare function expandHomePath(path: string): string;
+/**
+ * Base directory for anonymizer state and the default log file.
+ *
+ * @returns Absolute path to the collection directory.
+ */
+export declare function getCollectionDir(): string;
+/**
+ * Directory scanned for `*-events.log` source files.
+ * When `TOOL_USAGE_COLLECTION_LOG_PATH` points at a `.log` file, its parent dir is used.
+ *
+ * @returns Absolute path to the directory containing event log files.
+ */
+export declare function getEventsLogDir(): string;
+/**
+ * Absolute path to the anonymizer state JSON file.
+ *
+ * @returns Absolute path to the anonymizer state JSON file.
+ */
+export declare function getStatePath(): string;
+/**
+ * Absolute path to the anonymizer log file.
+ *
+ * @returns Absolute path to the anonymizer log file.
+ */
+export declare function getAnonymizerLogPath(): string;
+//# sourceMappingURL=paths.d.mts.map

package/dist/lib/paths.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.mts","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kCAAkC,mCACb,CAAC;AACnC,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAC7D,eAAO,MAAM,aAAa,cAAc,CAAC;AACzC,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD,eAAO,MAAM,6BAA6B,8BAA8B,CAAC;AAOzE;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAK9C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAOxC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C"}

package/dist/lib/paths.mjs

@@ -0,0 +1,82 @@
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export const ENV_TOOL_USAGE_COLLECTION_LOG_PATH = 'TOOL_USAGE_COLLECTION_LOG_PATH';
+export const ENV_ANONYMIZER_LOG_PATH = 'ANONYMIZER_LOG_PATH';
+export const ENV_MIMIR_URL = 'MIMIR_URL';
+export const ENV_MIMIR_USERNAME = 'MIMIR_USERNAME';
+export const ENV_MIMIR_PASSWORD = 'MIMIR_PASSWORD';
+export const ENV_TOOL_USAGE_COLLECTION_DIR = 'TOOL_USAGE_COLLECTION_DIR';
+const DEFAULT_COLLECTION_DIR = join(homedir(), '.tool-usage-collection');
+const STATE_FILE_NAME = 'anonymizer-state.json';
+const DEFAULT_LOG_FILE_NAME = 'anonymizer.log';
+/**
+ * Returns true when telemetry collection is disabled (CI environment or explicit opt-out).
+ *
+ * @returns `true` when `CI` is set or `TOOL_USAGE_COLLECTION_OPT_IN` is `"false"`.
+ */
+export function isCollectionDisabled() {
+    return (Boolean(process.env.CI) ||
+        process.env.TOOL_USAGE_COLLECTION_OPT_IN === 'false');
+}
+/**
+ * Expands a leading `~` or `~/` to the current user's home directory.
+ *
+ * @param path - A path that may start with `~`.
+ * @returns The path with `~` expanded to the home directory.
+ */
+export function expandHomePath(path) {
+    if (path === '~') {
+        return homedir();
+    }
+    if (path.startsWith('~/')) {
+        return join(homedir(), path.slice(2));
+    }
+    return path;
+}
+/**
+ * Base directory for anonymizer state and the default log file.
+ *
+ * @returns Absolute path to the collection directory.
+ */
+export function getCollectionDir() {
+    const configured = process.env[ENV_TOOL_USAGE_COLLECTION_DIR];
+    if (configured) {
+        return expandHomePath(configured);
+    }
+    return DEFAULT_COLLECTION_DIR;
+}
+/**
+ * Directory scanned for `*-events.log` source files.
+ * When `TOOL_USAGE_COLLECTION_LOG_PATH` points at a `.log` file, its parent dir is used.
+ *
+ * @returns Absolute path to the directory containing event log files.
+ */
+export function getEventsLogDir() {
+    const configured = process.env[ENV_TOOL_USAGE_COLLECTION_LOG_PATH];
+    if (!configured) {
+        return getCollectionDir();
+    }
+    const expanded = expandHomePath(configured);
+    return expanded.endsWith('.log') ? dirname(expanded) : expanded;
+}
+/**
+ * Absolute path to the anonymizer state JSON file.
+ *
+ * @returns Absolute path to the anonymizer state JSON file.
+ */
+export function getStatePath() {
+    return join(getCollectionDir(), STATE_FILE_NAME);
+}
+/**
+ * Absolute path to the anonymizer log file.
+ *
+ * @returns Absolute path to the anonymizer log file.
+ */
+export function getAnonymizerLogPath() {
+    const configured = process.env[ENV_ANONYMIZER_LOG_PATH];
+    if (configured) {
+        return expandHomePath(configured);
+    }
+    return join(getCollectionDir(), DEFAULT_LOG_FILE_NAME);
+}
+//# sourceMappingURL=paths.mjs.map

package/dist/lib/paths.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.mjs","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,gBAAgB;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,kBAAkB;AAE1C,MAAM,CAAC,MAAM,kCAAkC,GAC7C,gCAAgC,CAAC;AACnC,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAC7D,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAEnD,MAAM,CAAC,MAAM,6BAA6B,GAAG,2BAA2B,CAAC;AAEzE,MAAM,sBAAsB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,wBAAwB,CAAC,CAAC;AAEzE,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAChD,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,CACL,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,OAAO,CACrD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;QACjB,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC9D,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,cAAc,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;IACnE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,gBAAgB,EAAE,CAAC;IAC5B,CAAC;IACD,MAAM,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,eAAe,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACxD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,cAAc,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC,gBAAgB,EAAE,EAAE,qBAAqB,CAAC,CAAC;AACzD,CAAC","sourcesContent":["import { homedir } from 'node:os';\nimport { dirname, join } from 'node:path';\n\nexport const ENV_TOOL_USAGE_COLLECTION_LOG_PATH =\n  'TOOL_USAGE_COLLECTION_LOG_PATH';\nexport const ENV_ANONYMIZER_LOG_PATH = 'ANONYMIZER_LOG_PATH';\nexport const ENV_MIMIR_URL = 'MIMIR_URL';\nexport const ENV_MIMIR_USERNAME = 'MIMIR_USERNAME';\nexport const ENV_MIMIR_PASSWORD = 'MIMIR_PASSWORD';\n\nexport const ENV_TOOL_USAGE_COLLECTION_DIR = 'TOOL_USAGE_COLLECTION_DIR';\n\nconst DEFAULT_COLLECTION_DIR = join(homedir(), '.tool-usage-collection');\n\nconst STATE_FILE_NAME = 'anonymizer-state.json';\nconst DEFAULT_LOG_FILE_NAME = 'anonymizer.log';\n\n/**\n * Returns true when telemetry collection is disabled (CI environment or explicit opt-out).\n *\n * @returns `true` when `CI` is set or `TOOL_USAGE_COLLECTION_OPT_IN` is `\"false\"`.\n */\nexport function isCollectionDisabled(): boolean {\n  return (\n    Boolean(process.env.CI) ||\n    process.env.TOOL_USAGE_COLLECTION_OPT_IN === 'false'\n  );\n}\n\n/**\n * Expands a leading `~` or `~/` to the current user's home directory.\n *\n * @param path - A path that may start with `~`.\n * @returns The path with `~` expanded to the home directory.\n */\nexport function expandHomePath(path: string): string {\n  if (path === '~') {\n    return homedir();\n  }\n  if (path.startsWith('~/')) {\n    return join(homedir(), path.slice(2));\n  }\n  return path;\n}\n\n/**\n * Base directory for anonymizer state and the default log file.\n *\n * @returns Absolute path to the collection directory.\n */\nexport function getCollectionDir(): string {\n  const configured = process.env[ENV_TOOL_USAGE_COLLECTION_DIR];\n  if (configured) {\n    return expandHomePath(configured);\n  }\n  return DEFAULT_COLLECTION_DIR;\n}\n\n/**\n * Directory scanned for `*-events.log` source files.\n * When `TOOL_USAGE_COLLECTION_LOG_PATH` points at a `.log` file, its parent dir is used.\n *\n * @returns Absolute path to the directory containing event log files.\n */\nexport function getEventsLogDir(): string {\n  const configured = process.env[ENV_TOOL_USAGE_COLLECTION_LOG_PATH];\n  if (!configured) {\n    return getCollectionDir();\n  }\n  const expanded = expandHomePath(configured);\n  return expanded.endsWith('.log') ? dirname(expanded) : expanded;\n}\n\n/**\n * Absolute path to the anonymizer state JSON file.\n *\n * @returns Absolute path to the anonymizer state JSON file.\n */\nexport function getStatePath(): string {\n  return join(getCollectionDir(), STATE_FILE_NAME);\n}\n\n/**\n * Absolute path to the anonymizer log file.\n *\n * @returns Absolute path to the anonymizer log file.\n */\nexport function getAnonymizerLogPath(): string {\n  const configured = process.env[ENV_ANONYMIZER_LOG_PATH];\n  if (configured) {\n    return expandHomePath(configured);\n  }\n  return join(getCollectionDir(), DEFAULT_LOG_FILE_NAME);\n}\n"]}

package/dist/lib/push.cjs

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PushError = void 0;
+exports.loadPushConfig = loadPushConfig;
+exports.pushBatch = pushBatch;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const paths_1 = require("./paths.cjs");
+/** Thrown when the remote-write endpoint returns a non-2xx response. */
+class PushError extends Error {
+    /**
+     * Create a `PushError`.
+     *
+     * @param status - HTTP status code returned by the endpoint.
+     * @param responseBody - Response body text returned by the endpoint.
+     */
+    constructor(status, responseBody) {
+        super(`Push failed with status ${status}`);
+        this.name = 'PushError';
+        this.status = status;
+        this.responseBody = responseBody;
+    }
+}
+exports.PushError = PushError;
+/**
+ * Parse the repo's `.js.env` (shell-sourceable: `export KEY="value"`, `#` comments).
+ * Handles the optional `export ` prefix and surrounding single/double quotes.
+ *
+ * @param contents - Shell-sourceable `.js.env` file contents.
+ * @returns A map of environment variable names to their string values.
+ */
+function parseEnvFile(contents) {
+    const entries = {};
+    for (const rawLine of contents.split('\n')) {
+        let line = rawLine.trim();
+        if (!line || line.startsWith('#')) {
+            continue;
+        }
+        if (line.startsWith('export ')) {
+            line = line.slice('export '.length).trim();
+        }
+        const eq = line.indexOf('=');
+        if (eq === -1) {
+            continue;
+        }
+        const key = line.slice(0, eq).trim();
+        let value = line.slice(eq + 1).trim();
+        if (value.length >= 2 &&
+            ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'")))) {
+            value = value.slice(1, -1);
+        }
+        entries[key] = value;
+    }
+    return entries;
+}
+/**
+ * Load push credentials from process env, falling back to the repo's `.js.env`.
+ *
+ * @param repoRoot - Absolute path to the repo root where `.js.env` may live.
+ * @returns The resolved push configuration.
+ */
+function loadPushConfig(repoRoot) {
+    // File values are the fallback; env takes precedence for every key.
+    const envPath = (0, node_path_1.join)(repoRoot, '.js.env');
+    const file = (0, node_fs_1.existsSync)(envPath)
+        ? parseEnvFile((0, node_fs_1.readFileSync)(envPath, 'utf8'))
+        : {};
+    const url = process.env[paths_1.ENV_MIMIR_URL] ?? file[paths_1.ENV_MIMIR_URL] ?? '';
+    const username = process.env[paths_1.ENV_MIMIR_USERNAME] ?? file[paths_1.ENV_MIMIR_USERNAME];
+    const password = process.env[paths_1.ENV_MIMIR_PASSWORD] ?? file[paths_1.ENV_MIMIR_PASSWORD];
+    return {
+        url,
+        ...(username !== undefined && { username }),
+        ...(password !== undefined && { password }),
+    };
+}
+/**
+ * POST a remote-write body to the configured Prometheus remote-write endpoint.
+ *
+ * @param body - Snappy-compressed protobuf `WriteRequest` bytes to push.
+ * @param options - Push configuration including URL, credentials, and optional fetch override.
+ */
+async function pushBatch(body, options) {
+    if (options.dryRun) {
+        options.logger.info('dry-run push body', { byteLength: body.byteLength });
+        return;
+    }
+    if (!options.url) {
+        throw new Error('Prometheus push URL is required');
+    }
+    // Basic auth is only needed for authenticated endpoints (e.g. dev). Prod uses Cloudflare WARP.
+    const authHeader = options.username && options.password
+        ? {
+            Authorization: `Basic ${Buffer.from(`${options.username}:${options.password}`).toString('base64')}`,
+        }
+        : {};
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const response = await fetchImpl(options.url, {
+        method: 'POST',
+        headers: {
+            ...authHeader,
+            'Content-Type': 'application/x-protobuf',
+            'X-Prometheus-Remote-Write-Version': '0.1.0',
+        },
+        body,
+    });
+    const responseBody = await response.text();
+    if (!response.ok) {
+        options.logger.error('push failed', {
+            status: response.status,
+            body: responseBody,
+        });
+        throw new PushError(response.status, responseBody);
+    }
+    // Mimir returns HTTP 200 even for partial rejections; warnings appear in the body.
+    options.logger.info('push complete', {
+        status: response.status,
+        ...(responseBody.trim() && { mimirWarning: responseBody.trim() }),
+    });
+}
+//# sourceMappingURL=push.cjs.map

package/dist/lib/push.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.cjs","sourceRoot":"","sources":["../../src/lib/push.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\n\nimport { ENV_MIMIR_URL, ENV_MIMIR_PASSWORD, ENV_MIMIR_USERNAME } from './paths';\n\n/** Prometheus remote-write endpoint coordinates. */\nexport type PushConfig = {\n  /** Full URL of the remote-write endpoint. */\n  url: string;\n  /** HTTP Basic auth username. Omit for unauthenticated endpoints (e.g. prod via Cloudflare WARP). */\n  username?: string;\n  /** HTTP Basic auth password. Omit for unauthenticated endpoints (e.g. prod via Cloudflare WARP). */\n  password?: string;\n};\n\n/** Minimal logger interface used by `pushBatch`. */\nexport type Logger = {\n  /** Log an informational message. */\n  info: (message: string, extra?: Record<string, unknown>) => void;\n  /** Log an error message. */\n  error: (message: string, extra?: Record<string, unknown>) => void;\n};\n\n/** Thrown when the remote-write endpoint returns a non-2xx response. */\nexport class PushError extends Error {\n  readonly status: number;\n\n  readonly responseBody: string;\n\n  /**\n   * Create a `PushError`.\n   *\n   * @param status - HTTP status code returned by the endpoint.\n   * @param responseBody - Response body text returned by the endpoint.\n   */\n  constructor(status: number, responseBody: string) {\n    super(`Push failed with status ${status}`);\n    this.name = 'PushError';\n    this.status = status;\n    this.responseBody = responseBody;\n  }\n}\n\n/**\n * Parse the repo's `.js.env` (shell-sourceable: `export KEY=\"value\"`, `#` comments).\n * Handles the optional `export ` prefix and surrounding single/double quotes.\n *\n * @param contents - Shell-sourceable `.js.env` file contents.\n * @returns A map of environment variable names to their string values.\n */\nfunction parseEnvFile(contents: string): Record<string, string> {\n  const entries: Record<string, string> = {};\n  for (const rawLine of contents.split('\\n')) {\n    let line = rawLine.trim();\n    if (!line || line.startsWith('#')) {\n      continue;\n    }\n    if (line.startsWith('export ')) {\n      line = line.slice('export '.length).trim();\n    }\n    const eq = line.indexOf('=');\n    if (eq === -1) {\n      continue;\n    }\n    const key = line.slice(0, eq).trim();\n    let value = line.slice(eq + 1).trim();\n    if (\n      value.length >= 2 &&\n      ((value.startsWith('\"') && value.endsWith('\"')) ||\n        (value.startsWith(\"'\") && value.endsWith(\"'\")))\n    ) {\n      value = value.slice(1, -1);\n    }\n    entries[key] = value;\n  }\n  return entries;\n}\n\n/**\n * Load push credentials from process env, falling back to the repo's `.js.env`.\n *\n * @param repoRoot - Absolute path to the repo root where `.js.env` may live.\n * @returns The resolved push configuration.\n */\nexport function loadPushConfig(repoRoot: string): PushConfig {\n  // File values are the fallback; env takes precedence for every key.\n  const envPath = join(repoRoot, '.js.env');\n  const file = existsSync(envPath)\n    ? parseEnvFile(readFileSync(envPath, 'utf8'))\n    : {};\n\n  const url = process.env[ENV_MIMIR_URL] ?? file[ENV_MIMIR_URL] ?? '';\n  const username = process.env[ENV_MIMIR_USERNAME] ?? file[ENV_MIMIR_USERNAME];\n  const password = process.env[ENV_MIMIR_PASSWORD] ?? file[ENV_MIMIR_PASSWORD];\n\n  return {\n    url,\n    ...(username !== undefined && { username }),\n    ...(password !== undefined && { password }),\n  };\n}\n\n/** Options for `pushBatch`. */\nexport type PushBatchOptions = {\n  /** Full URL of the remote-write endpoint. */\n  url: string;\n  /** HTTP Basic auth username. Omit for unauthenticated endpoints (e.g. prod via Cloudflare WARP). */\n  username?: string;\n  /** HTTP Basic auth password. Omit for unauthenticated endpoints (e.g. prod via Cloudflare WARP). */\n  password?: string;\n  /** When true, logs the body but does not POST. */\n  dryRun: boolean;\n  /** Logger instance for success and error messages. */\n  logger: Logger;\n  /** Fetch implementation; defaults to the global `fetch`. */\n  fetchImpl?: typeof fetch;\n};\n\n/**\n * POST a remote-write body to the configured Prometheus remote-write endpoint.\n *\n * @param body - Snappy-compressed protobuf `WriteRequest` bytes to push.\n * @param options - Push configuration including URL, credentials, and optional fetch override.\n */\nexport async function pushBatch(\n  body: Uint8Array,\n  options: PushBatchOptions,\n): Promise<void> {\n  if (options.dryRun) {\n    options.logger.info('dry-run push body', { byteLength: body.byteLength });\n    return;\n  }\n\n  if (!options.url) {\n    throw new Error('Prometheus push URL is required');\n  }\n\n  // Basic auth is only needed for authenticated endpoints (e.g. dev). Prod uses Cloudflare WARP.\n  const authHeader =\n    options.username && options.password\n      ? {\n          Authorization: `Basic ${Buffer.from(`${options.username}:${options.password}`).toString('base64')}`,\n        }\n      : {};\n\n  const fetchImpl = options.fetchImpl ?? fetch;\n  const response = await fetchImpl(options.url, {\n    method: 'POST',\n    headers: {\n      ...authHeader,\n      'Content-Type': 'application/x-protobuf',\n      'X-Prometheus-Remote-Write-Version': '0.1.0',\n    },\n    body,\n  });\n\n  const responseBody = await response.text();\n  if (!response.ok) {\n    options.logger.error('push failed', {\n      status: response.status,\n      body: responseBody,\n    });\n    throw new PushError(response.status, responseBody);\n  }\n  // Mimir returns HTTP 200 even for partial rejections; warnings appear in the body.\n  options.logger.info('push complete', {\n    status: response.status,\n    ...(responseBody.trim() && { mimirWarning: responseBody.trim() }),\n  });\n}\n"]}

package/dist/lib/push.d.cts

@@ -0,0 +1,58 @@
+/** Prometheus remote-write endpoint coordinates. */
+export type PushConfig = {
+    /** Full URL of the remote-write endpoint. */
+    url: string;
+    /** HTTP Basic auth username. Omit for unauthenticated endpoints (e.g. prod via Cloudflare WARP). */
+    username?: string;
+    /** HTTP Basic auth password. Omit for unauthenticated endpoints (e.g. prod via Cloudflare WARP). */
+    password?: string;
+};
+/** Minimal logger interface used by `pushBatch`. */
+export type Logger = {
+    /** Log an informational message. */
+    info: (message: string, extra?: Record<string, unknown>) => void;
+    /** Log an error message. */
+    error: (message: string, extra?: Record<string, unknown>) => void;
+};
+/** Thrown when the remote-write endpoint returns a non-2xx response. */
+export declare class PushError extends Error {
+    readonly status: number;
+    readonly responseBody: string;
+    /**
+     * Create a `PushError`.
+     *
+     * @param status - HTTP status code returned by the endpoint.
+     * @param responseBody - Response body text returned by the endpoint.
+     */
+    constructor(status: number, responseBody: string);
+}
+/**
+ * Load push credentials from process env, falling back to the repo's `.js.env`.
+ *
+ * @param repoRoot - Absolute path to the repo root where `.js.env` may live.
+ * @returns The resolved push configuration.
+ */
+export declare function loadPushConfig(repoRoot: string): PushConfig;
+/** Options for `pushBatch`. */
+export type PushBatchOptions = {
+    /** Full URL of the remote-write endpoint. */
+    url: string;
+    /** HTTP Basic auth username. Omit for unauthenticated endpoints (e.g. prod via Cloudflare WARP). */
+    username?: string;
+    /** HTTP Basic auth password. Omit for unauthenticated endpoints (e.g. prod via Cloudflare WARP). */
+    password?: string;
+    /** When true, logs the body but does not POST. */
+    dryRun: boolean;
+    /** Logger instance for success and error messages. */
+    logger: Logger;
+    /** Fetch implementation; defaults to the global `fetch`. */
+    fetchImpl?: typeof fetch;
+};
+/**
+ * POST a remote-write body to the configured Prometheus remote-write endpoint.
+ *
+ * @param body - Snappy-compressed protobuf `WriteRequest` bytes to push.
+ * @param options - Push configuration including URL, credentials, and optional fetch override.
+ */
+export declare function pushBatch(body: Uint8Array, options: PushBatchOptions): Promise<void>;
+//# sourceMappingURL=push.d.cts.map

package/dist/lib/push.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.cts","sourceRoot":"","sources":["../../src/lib/push.ts"],"names":[],"mappings":"AAKA,oDAAoD;AACpD,MAAM,MAAM,UAAU,GAAG;IACvB,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,MAAM,GAAG;IACnB,oCAAoC;IACpC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjE,4BAA4B;IAC5B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACnE,CAAC;AAEF,wEAAwE;AACxE,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;;;OAKG;gBACS,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAMjD;AAqCD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAgB3D;AAED,+BAA+B;AAC/B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,MAAM,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA0Cf"}