@e2edev/e2e 0.6.1 → 0.8.0

package/dist/telemetry/environment.js

@@ -0,0 +1,96 @@
+/**
+ * The anonymous machine facts every event carries: platform, architecture,
+ * resource class, container, CI vendor, the coding agent driving the shell,
+ * and the runtime versions. Each field is a closed enumeration, a number, or
+ * a version string; none is a path, a hostname, a username, or a value read
+ * from the project.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import os from 'node:os';
+import { isCiMode } from '../config/resolve.js';
+import { envValue } from '../internal/env.js';
+import { detectPackageManager } from '../internal/package-manager.js';
+/** Environment variables a CI vendor sets, and the name we report for it. */
+const CI_VENDORS = [
+    ['GITHUB_ACTIONS', 'github-actions'],
+    ['GITLAB_CI', 'gitlab'],
+    ['CIRCLECI', 'circleci'],
+    ['BUILDKITE', 'buildkite'],
+    ['JENKINS_URL', 'jenkins'],
+    ['TRAVIS', 'travis'],
+    ['BITBUCKET_BUILD_NUMBER', 'bitbucket'],
+    ['TF_BUILD', 'azure-pipelines'],
+    ['TEAMCITY_VERSION', 'teamcity'],
+    ['CODEBUILD_BUILD_ID', 'aws-codebuild'],
+    ['VERCEL', 'vercel'],
+    ['NETLIFY', 'netlify'],
+    ['DRONE', 'drone'],
+    ['SEMAPHORE', 'semaphore'],
+    ['APPVEYOR', 'appveyor'],
+    ['WOODPECKER', 'woodpecker'],
+];
+/**
+ * Environment variables coding agents set in the shells they spawn. The
+ * markers are the ones `@vercel/detect-agent` checks; the value never matters,
+ * only that the variable is set.
+ */
+const CODING_AGENTS = [
+    ['CLAUDECODE', 'claude-code'],
+    ['CLAUDE_CODE', 'claude-code'],
+    ['CURSOR_AGENT', 'cursor'],
+    ['CURSOR_TRACE_ID', 'cursor'],
+    ['CODEX_SANDBOX', 'codex'],
+    ['CODEX_THREAD_ID', 'codex'],
+    ['CODEX_CI', 'codex'],
+    ['GEMINI_CLI', 'gemini-cli'],
+    ['COPILOT_GITHUB_TOKEN', 'copilot'],
+    ['COPILOT_MODEL', 'copilot'],
+    ['COPILOT_ALLOW_ALL', 'copilot'],
+    ['OPENCODE_CLIENT', 'opencode'],
+    ['AUGMENT_AGENT', 'augment'],
+    ['ANTIGRAVITY_AGENT', 'antigravity'],
+    ['REPL_ID', 'replit'],
+    ['AI_AGENT', 'other'],
+];
+/** The name paired with the first marker variable that is set. */
+function firstMarker(env, markers) {
+    return markers.find(([variable]) => envValue(env, variable) !== undefined)?.[1];
+}
+/** The first vendor whose marker is set; `unknown` when only `CI` is. */
+export function ciName(env) {
+    return firstMarker(env, CI_VENDORS) ?? (isCiMode(env) ? 'unknown' : null);
+}
+function inDocker() {
+    if (existsSync('/.dockerenv'))
+        return true;
+    try {
+        return readFileSync('/proc/1/cgroup', 'utf8').includes('docker');
+    }
+    catch {
+        return false;
+    }
+}
+function inWsl(env, release) {
+    return envValue(env, 'WSL_DISTRO_NAME') !== undefined || release.toLowerCase().includes('microsoft');
+}
+export function collectEnvironment(options) {
+    const { env } = options;
+    const release = os.release();
+    return {
+        os: os.platform(),
+        os_release: release,
+        arch: os.arch(),
+        cpu_count: os.cpus().length,
+        memory_gb: Math.round(os.totalmem() / 2 ** 30),
+        docker: inDocker(),
+        wsl: inWsl(env, release),
+        tty: process.stdout.isTTY === true,
+        ci: isCiMode(env),
+        ci_name: ciName(env),
+        coding_agent: firstMarker(env, CODING_AGENTS) ?? null,
+        node_version: process.versions.node,
+        package_manager: detectPackageManager(options.cwd, undefined, env),
+        e2e_version: options.version,
+    };
+}
+//# sourceMappingURL=environment.js.map

package/dist/telemetry/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/telemetry/environment.ts"],"names":[],"mappings":"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"}

package/dist/telemetry/events.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The events e2e sends, built from facts the CLI already holds. Every
+ * property is a count, a duration, a version, or a short token. The builders
+ * copy no title, file, URL, instruction, message, or stack out of the report.
+ * The names a project declares for its engines, platforms, and model pass
+ * through when they are plain tokens, so a homegrown engine counts as itself;
+ * a name shaped like a path, a URL, or a sentence folds to `other`, and an
+ * error code that is not an upper-case token, the shape of every runner
+ * code, folds to `OTHER`. The unit tests hold the payload to that promise.
+ */
+import type { Report1Document } from '../report/build.ts';
+import type { JsonValue } from '../types.ts';
+export interface TelemetryEvent {
+    readonly name: string;
+    readonly properties: Readonly<Record<string, JsonValue>>;
+    /** When the event happened, RFC 3339; the flush time when absent. */
+    readonly at?: string;
+}
+/** One per CLI invocation: which command, with which flags. */
+export declare const EVENT_CLI_SESSION = "e2e_cli_session";
+/** One per `e2e run`, from the report the run wrote. */
+export declare const EVENT_RUN_COMPLETED = "e2e_run_completed";
+export declare function cliSessionEvent(command: string, flags: readonly string[]): TelemetryEvent;
+export declare function runCompletedEvent(report: Report1Document, flags: readonly string[]): TelemetryEvent;
+//# sourceMappingURL=events.d.ts.map

package/dist/telemetry/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/telemetry/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAA2B,MAAM,oBAAoB,CAAC;AAEnF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACzD,qEAAqE;IACrE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AACnD,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AAavD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CAEzF;AAiDD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CA8CnG"}

package/dist/telemetry/events.js

@@ -0,0 +1,107 @@
+/**
+ * The events e2e sends, built from facts the CLI already holds. Every
+ * property is a count, a duration, a version, or a short token. The builders
+ * copy no title, file, URL, instruction, message, or stack out of the report.
+ * The names a project declares for its engines, platforms, and model pass
+ * through when they are plain tokens, so a homegrown engine counts as itself;
+ * a name shaped like a path, a URL, or a sentence folds to `other`, and an
+ * error code that is not an upper-case token, the shape of every runner
+ * code, folds to `OTHER`. The unit tests hold the payload to that promise.
+ */
+import { STEP_KINDS } from '../run/steps.js';
+/** One per CLI invocation: which command, with which flags. */
+export const EVENT_CLI_SESSION = 'e2e_cli_session';
+/** One per `e2e run`, from the report the run wrote. */
+export const EVENT_RUN_COMPLETED = 'e2e_run_completed';
+const SEMVER = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/u;
+/**
+ * The shape of a name worth sending as it is: an engine name, a platform, or
+ * a public model id is a short token. A path, a URL, a sentence, or a
+ * fine-tuned or routed model id is not, and folds to `other`.
+ */
+const PLAIN_TOKEN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/u;
+/** The shape of every runner error code. A code shaped otherwise is a project's own and folds to `OTHER`. */
+const ERROR_CODE = /^[A-Z][A-Z0-9_]{2,63}$/u;
+const MAX_ERROR_CODES = 20;
+export function cliSessionEvent(command, flags) {
+    return { name: EVENT_CLI_SESSION, properties: { command, flags: [...flags] } };
+}
+function plainToken(value) {
+    return PLAIN_TOKEN.test(value) ? value : 'other';
+}
+/** `playwright@0.6.1`, and a project's own engine the same way; a name that is not a plain token is `other` alone. */
+function engineLabel(engine) {
+    const name = plainToken(engine.name);
+    if (name === 'other')
+        return name;
+    return `${name}@${SEMVER.test(engine.version) ? engine.version : 'unversioned'}`;
+}
+function unique(values) {
+    return [...new Set(values)].toSorted();
+}
+/** Every scope the run recorded, across plain results and serial groups. */
+function* scopes(report) {
+    for (const result of report.run.results)
+        yield* result.attempts;
+    for (const group of report.run.serialGroups) {
+        for (const attempt of group.attempts) {
+            yield attempt;
+            yield* attempt.members;
+        }
+    }
+}
+/** The scope's own errors, then its steps'. */
+function errorsOf(scope) {
+    return [
+        ...(scope.error === undefined ? [] : [scope.error]),
+        ...scope.secondaryErrors,
+        ...(scope.steps ?? []).flatMap((step) => (step.error === undefined ? [] : [step.error])),
+    ];
+}
+function durationMs(startedAt, finishedAt) {
+    const duration = Date.parse(finishedAt) - Date.parse(startedAt);
+    return Number.isFinite(duration) ? Math.max(0, duration) : null;
+}
+export function runCompletedEvent(report, flags) {
+    const { run } = report;
+    const recorded = [...scopes(report)];
+    const steps = recorded.flatMap((scope) => scope.steps ?? []);
+    const models = steps.flatMap((step) => (step.model === undefined ? [] : [step.model]));
+    const first = models[0];
+    const codes = unique([...run.errors, ...recorded.flatMap(errorsOf)].map((error) => (ERROR_CODE.test(error.code) ? error.code : 'OTHER')));
+    return {
+        name: EVENT_RUN_COMPLETED,
+        at: run.finishedAt,
+        properties: {
+            status: run.status,
+            exit_code: run.exitCode,
+            duration_ms: durationMs(run.startedAt, run.finishedAt),
+            flags: [...flags],
+            tests_discovered: run.summary.discovered,
+            tests_selected: run.summary.selected,
+            tests_executed: run.summary.executed,
+            tests_passed: run.summary.passed,
+            tests_failed: run.summary.failed,
+            tests_flaky: run.summary.flaky,
+            tests_skipped: run.summary.skipped,
+            targets: run.targets.length,
+            platforms: unique(run.targets.map((target) => plainToken(target.platform))),
+            engines: unique(run.targets.map((target) => engineLabel(target.engine))),
+            steps_total: steps.length,
+            ...Object.fromEntries(STEP_KINDS.map((kind) => [`steps_${kind}`, steps.filter((step) => step.kind === kind).length])),
+            agent_steps_replayed: steps.filter((step) => step.cache?.mode === 'self-finalized').length,
+            agent_steps_partial: steps.filter((step) => step.cache?.mode === 'agent-concluded').length,
+            agent_steps_missed: steps.filter((step) => step.cache?.mode === 'missed').length,
+            agent_steps_vision: steps.filter((step) => step.visionInput === true).length,
+            model_provider: first?.provider ?? null,
+            model_id: first === undefined ? null : plainToken(first.model),
+            model_calls: models.reduce((total, model) => total + model.calls, 0),
+            model_tokens: run.usage.modelTokens,
+            estimated_cost_usd: run.usage.estimatedCostUsd ?? null,
+            artifact_bytes: run.usage.artifactBytes,
+            errors: run.errors.length,
+            error_codes: codes.slice(0, MAX_ERROR_CODES),
+        },
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/telemetry/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/telemetry/events.ts"],"names":[],"mappings":"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"}

package/dist/telemetry/posthog.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Transport: one POST of every event a CLI invocation produced to PostHog's
+ * batch endpoint. The key is the project's public, write-only ingestion key,
+ * the kind websites embed in their pages; it can add events and nothing else.
+ *
+ * The request is bounded and quiet. It aborts when the caller's signal does,
+ * never retries, and swallows every failure: telemetry that is lost is
+ * telemetry, telemetry that delays or fails a command is a bug.
+ */
+import type { JsonValue } from '../types.ts';
+/** The PostHog Cloud EU ingestion host. */
+export declare const POSTHOG_HOST = "https://eu.i.posthog.com";
+/** The e2e project's ingestion key: public and write-only, like the key posthog-js embeds in a page. */
+export declare const POSTHOG_PROJECT_KEY = "phc_rT8hpREuSj5bRGPHP6KLKNuf4kfwhP4FEf6ahHHV2ZgH";
+/** One item of the batch, exactly as PostHog receives it; `distinct_id` is a property. */
+export interface PostHogEvent {
+    readonly event: string;
+    /** RFC 3339. */
+    readonly timestamp: string;
+    readonly properties: Readonly<Record<string, JsonValue>> & {
+        readonly distinct_id: string;
+    };
+}
+export interface PostBatchOptions {
+    /** Aborts the request: the caller's one deadline for everything telemetry does after the command. */
+    readonly signal: AbortSignal;
+    readonly fetch: typeof fetch;
+}
+/** Sends the batch; resolves to whether PostHog accepted it. */
+export declare function postBatch(events: readonly PostHogEvent[], options: PostBatchOptions): Promise<boolean>;
+//# sourceMappingURL=posthog.d.ts.map

package/dist/telemetry/posthog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog.d.ts","sourceRoot":"","sources":["../../src/telemetry/posthog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,2CAA2C;AAC3C,eAAO,MAAM,YAAY,6BAA6B,CAAC;AAEvD,wGAAwG;AACxG,eAAO,MAAM,mBAAmB,qDAAqD,CAAC;AAEtF,0FAA0F;AAC1F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gBAAgB;IAChB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAAG;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7F;AAED,MAAM,WAAW,gBAAgB;IAC/B,qGAAqG;IACrG,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;CAC9B;AAED,gEAAgE;AAChE,wBAAsB,SAAS,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAY5G"}

package/dist/telemetry/posthog.js

@@ -0,0 +1,29 @@
+/**
+ * Transport: one POST of every event a CLI invocation produced to PostHog's
+ * batch endpoint. The key is the project's public, write-only ingestion key,
+ * the kind websites embed in their pages; it can add events and nothing else.
+ *
+ * The request is bounded and quiet. It aborts when the caller's signal does,
+ * never retries, and swallows every failure: telemetry that is lost is
+ * telemetry, telemetry that delays or fails a command is a bug.
+ */
+/** The PostHog Cloud EU ingestion host. */
+export const POSTHOG_HOST = 'https://eu.i.posthog.com';
+/** The e2e project's ingestion key: public and write-only, like the key posthog-js embeds in a page. */
+export const POSTHOG_PROJECT_KEY = 'phc_rT8hpREuSj5bRGPHP6KLKNuf4kfwhP4FEf6ahHHV2ZgH';
+/** Sends the batch; resolves to whether PostHog accepted it. */
+export async function postBatch(events, options) {
+    try {
+        const response = await options.fetch(`${POSTHOG_HOST}/batch/`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ api_key: POSTHOG_PROJECT_KEY, batch: events }),
+            signal: options.signal,
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=posthog.js.map

package/dist/telemetry/posthog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog.js","sourceRoot":"","sources":["../../src/telemetry/posthog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEvD,wGAAwG;AACxG,MAAM,CAAC,MAAM,mBAAmB,GAAG,kDAAkD,CAAC;AAgBtF,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAA+B,EAAE,OAAyB;IACxF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,SAAS,EAAE;YAC7D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YACrE,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/telemetry/project.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The anonymous project id. Feature counts need to tell "one project run
+ * many times" from "many projects", and a per-machine id cannot: the same
+ * repository on two laptops would count twice, and one laptop with ten
+ * projects would count once.
+ *
+ * Inside a git repository the id is the SHA-256 of the repository's root
+ * commit, which every clone shares and no one can produce without the
+ * repository itself; a commit hash carries no name, path, or remote. A
+ * shallow clone has no root to offer: its boundary commits pose as roots and
+ * move with every fetch, so it is treated like a directory outside git.
+ * There, the project root path is hashed together with the machine's local
+ * salt, so the id is stable on that machine and unrecoverable anywhere else.
+ * In CI there is no salt, so a runner without a full history has no id: its
+ * working directory is not a project.
+ */
+export declare function anonymousProjectId(projectRoot: string, salt: string | undefined): Promise<string | undefined>;
+//# sourceMappingURL=project.d.ts.map

package/dist/telemetry/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/telemetry/project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAkCH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAK7B"}

package/dist/telemetry/project.js

@@ -0,0 +1,55 @@
+/**
+ * The anonymous project id. Feature counts need to tell "one project run
+ * many times" from "many projects", and a per-machine id cannot: the same
+ * repository on two laptops would count twice, and one laptop with ten
+ * projects would count once.
+ *
+ * Inside a git repository the id is the SHA-256 of the repository's root
+ * commit, which every clone shares and no one can produce without the
+ * repository itself; a commit hash carries no name, path, or remote. A
+ * shallow clone has no root to offer: its boundary commits pose as roots and
+ * move with every fetch, so it is treated like a directory outside git.
+ * There, the project root path is hashed together with the machine's local
+ * salt, so the id is stable on that machine and unrecoverable anywhere else.
+ * In CI there is no salt, so a runner without a full history has no id: its
+ * working directory is not a project.
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { sha256Hex } from '../internal/ids.js';
+const execFileAsync = promisify(execFile);
+const COMMIT_HASH = /^[a-f0-9]{40,64}$/u;
+/** One git command's stdout; undefined when git is missing, slow, or refuses. */
+async function git(cwd, args) {
+    try {
+        const { stdout } = await execFileAsync('git', args, { cwd, timeout: 1_000, windowsHide: true, encoding: 'utf8' });
+        return stdout;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** The lexically first root commit reachable from HEAD; undefined outside git and in a shallow clone. */
+async function rootCommit(cwd) {
+    const [shallow, roots] = await Promise.all([
+        git(cwd, ['rev-parse', '--is-shallow-repository']),
+        git(cwd, ['rev-list', '--max-parents=0', 'HEAD']),
+    ]);
+    // Only an explicit `false` counts: a git too old for the flag echoes it back instead.
+    if (shallow?.trim() !== 'false' || roots === undefined)
+        return undefined;
+    return roots
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => COMMIT_HASH.test(line))
+        .toSorted()[0];
+}
+export async function anonymousProjectId(projectRoot, salt) {
+    const commit = await rootCommit(projectRoot);
+    if (commit !== undefined)
+        return sha256Hex(`git\n${commit}`);
+    if (salt === undefined)
+        return undefined;
+    return sha256Hex(`path\n${salt}\n${projectRoot}`);
+}
+//# sourceMappingURL=project.js.map

package/dist/telemetry/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/telemetry/project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEzC,iFAAiF;AACjF,KAAK,UAAU,GAAG,CAAC,GAAW,EAAE,IAAuB;IACrD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAClH,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,yGAAyG;AACzG,KAAK,UAAU,UAAU,CAAC,GAAW;IACnC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACzC,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC;QAClD,GAAG,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,MAAM,CAAC,CAAC;KAClD,CAAC,CAAC;IACH,sFAAsF;IACtF,IAAI,OAAO,EAAE,IAAI,EAAE,KAAK,OAAO,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzE,OAAO,KAAK;SACT,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACxC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,IAAwB;IAExB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;IAC7C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC,QAAQ,MAAM,EAAE,CAAC,CAAC;IAC7D,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,SAAS,CAAC,SAAS,IAAI,KAAK,WAAW,EAAE,CAAC,CAAC;AACpD,CAAC"}

package/dist/telemetry/store.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The user-level telemetry preferences: `~/.config/e2e/telemetry.json`
+ * (`$XDG_CONFIG_HOME/e2e` when set, `%APPDATA%\e2e` on Windows). The file
+ * holds the opt-out, the random id every event from this machine is
+ * attributed to, the salt that keeps a hashed path unrecoverable, and which
+ * notice was shown when. Nothing in it names the person or the machine: the
+ * id and the salt are random bytes, generated here and never derived.
+ *
+ * The store fails closed. `open` completes the file in one write when the id
+ * or the salt is missing, and when that write cannot happen there is no
+ * store: telemetry treats the absence as an opt-out rather than sending
+ * events it could neither attribute nor de-duplicate. After `open`, only the
+ * user's own choice and the notice mark write, so an ordinary command never
+ * rewrites the file while another process may be saving a choice to it.
+ */
+/** The preferences file inside a config directory. */
+export declare function preferencesPath(directory: string): string;
+/** Where the preferences live for this platform and environment. */
+export declare function telemetryConfigDir(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): string;
+export declare class TelemetryStore {
+    /** The preferences file, for messages that tell the user where a choice was saved. */
+    readonly path: string;
+    private preferences;
+    private constructor();
+    /**
+     * Opens the store in `directory`. A complete file is only read, so a
+     * read-only preferences file keeps working. A missing file, a file that is
+     * not JSON, or one without an id or a salt is completed in one write that
+     * also creates the directory; a torn write must not turn into a permanent
+     * opt-in or opt-out either way. Returns undefined when that write fails,
+     * which the caller reads as off.
+     */
+    static open(directory: string): TelemetryStore | undefined;
+    /** The user's choice; unset means participating. */
+    get enabled(): boolean;
+    /** The random per-machine id every event from this machine is attributed to. */
+    get anonymousId(): string;
+    /** The local salt that keeps a hashed project path unrecoverable; never leaves the machine. */
+    get pathSalt(): string;
+    /** Saves the choice; false when the file could not be written and the choice stayed in memory. */
+    saveEnabled(value: boolean): boolean;
+    /**
+     * Re-reads the file, so a choice another process saved since `open` is
+     * seen before anything is sent. An unreadable file changes nothing.
+     */
+    reload(): void;
+    /** Whether this version of the notice has been shown. */
+    wasNotified(version: number): boolean;
+    /** Records that the notice was shown; a failed write only means it may show once more. */
+    markNotified(version: number, at: string): void;
+    private write;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/telemetry/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/telemetry/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAwBH,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAChC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,MAAM,CAOR;AA8BD,qBAAa,cAAc;IACzB,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,WAAW,CAAa;IAEhC,OAAO,eAGN;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAezD;IAED,oDAAoD;IACpD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,gFAAgF;IAChF,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,+FAA+F;IAC/F,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,kGAAkG;IAClG,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGnC;IAED;;;OAGG;IACH,MAAM,IAAI,IAAI,CAQb;IAED,yDAAyD;IACzD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEpC;IAED,0FAA0F;IAC1F,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAI9C;IAED,OAAO,CAAC,KAAK;CAQd"}

package/dist/telemetry/store.js

@@ -0,0 +1,153 @@
+/**
+ * The user-level telemetry preferences: `~/.config/e2e/telemetry.json`
+ * (`$XDG_CONFIG_HOME/e2e` when set, `%APPDATA%\e2e` on Windows). The file
+ * holds the opt-out, the random id every event from this machine is
+ * attributed to, the salt that keeps a hashed path unrecoverable, and which
+ * notice was shown when. Nothing in it names the person or the machine: the
+ * id and the salt are random bytes, generated here and never derived.
+ *
+ * The store fails closed. `open` completes the file in one write when the id
+ * or the salt is missing, and when that write cannot happen there is no
+ * store: telemetry treats the absence as an opt-out rather than sending
+ * events it could neither attribute nor de-duplicate. After `open`, only the
+ * user's own choice and the notice mark write, so an ordinary command never
+ * rewrites the file while another process may be saving a choice to it.
+ */
+import { randomBytes } from 'node:crypto';
+import { mkdirSync, readFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { writeFileAtomicSync } from '../internal/atomic-write.js';
+import { envValue } from '../internal/env.js';
+const FILE_NAME = 'telemetry.json';
+const HEX = /^[a-f0-9]{16,128}$/u;
+/** The preferences file inside a config directory. */
+export function preferencesPath(directory) {
+    return path.join(directory, FILE_NAME);
+}
+/** Where the preferences live for this platform and environment. */
+export function telemetryConfigDir(env = process.env, platform = process.platform) {
+    if (platform === 'win32') {
+        const appData = envValue(env, 'APPDATA') ?? path.join(os.homedir(), 'AppData', 'Roaming');
+        return path.join(appData, 'e2e');
+    }
+    const configHome = envValue(env, 'XDG_CONFIG_HOME') ?? path.join(os.homedir(), '.config');
+    return path.join(configHome, 'e2e');
+}
+/** Keeps only the fields this version knows, each with the type it expects. */
+function sanitize(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return {};
+    const raw = value;
+    const preferences = {};
+    if (typeof raw['enabled'] === 'boolean')
+        preferences.enabled = raw['enabled'];
+    if (typeof raw['anonymousId'] === 'string' && HEX.test(raw['anonymousId'])) {
+        preferences.anonymousId = raw['anonymousId'];
+    }
+    if (typeof raw['salt'] === 'string' && HEX.test(raw['salt']))
+        preferences.salt = raw['salt'];
+    if (typeof raw['notifiedAt'] === 'string')
+        preferences.notifiedAt = raw['notifiedAt'];
+    if (typeof raw['noticeVersion'] === 'number')
+        preferences.noticeVersion = raw['noticeVersion'];
+    return preferences;
+}
+/** The file's preferences, or undefined when it is missing or not JSON. */
+function readPreferences(filePath) {
+    try {
+        return sanitize(JSON.parse(readFileSync(filePath, 'utf8')));
+    }
+    catch {
+        return undefined;
+    }
+}
+function randomHex() {
+    return randomBytes(16).toString('hex');
+}
+export class TelemetryStore {
+    /** The preferences file, for messages that tell the user where a choice was saved. */
+    path;
+    preferences;
+    constructor(filePath, preferences) {
+        this.path = filePath;
+        this.preferences = preferences;
+    }
+    /**
+     * Opens the store in `directory`. A complete file is only read, so a
+     * read-only preferences file keeps working. A missing file, a file that is
+     * not JSON, or one without an id or a salt is completed in one write that
+     * also creates the directory; a torn write must not turn into a permanent
+     * opt-in or opt-out either way. Returns undefined when that write fails,
+     * which the caller reads as off.
+     */
+    static open(directory) {
+        const filePath = preferencesPath(directory);
+        const read = readPreferences(filePath);
+        const store = new TelemetryStore(filePath, {
+            ...read,
+            anonymousId: read?.anonymousId ?? randomHex(),
+            salt: read?.salt ?? randomHex(),
+        });
+        if (read !== undefined && read.anonymousId !== undefined && read.salt !== undefined)
+            return store;
+        try {
+            mkdirSync(directory, { recursive: true });
+        }
+        catch {
+            return undefined;
+        }
+        return store.write() ? store : undefined;
+    }
+    /** The user's choice; unset means participating. */
+    get enabled() {
+        return this.preferences.enabled !== false;
+    }
+    /** The random per-machine id every event from this machine is attributed to. */
+    get anonymousId() {
+        return this.preferences.anonymousId;
+    }
+    /** The local salt that keeps a hashed project path unrecoverable; never leaves the machine. */
+    get pathSalt() {
+        return this.preferences.salt;
+    }
+    /** Saves the choice; false when the file could not be written and the choice stayed in memory. */
+    saveEnabled(value) {
+        this.preferences.enabled = value;
+        return this.write();
+    }
+    /**
+     * Re-reads the file, so a choice another process saved since `open` is
+     * seen before anything is sent. An unreadable file changes nothing.
+     */
+    reload() {
+        const read = readPreferences(this.path);
+        if (read === undefined)
+            return;
+        this.preferences = {
+            ...read,
+            anonymousId: read.anonymousId ?? this.preferences.anonymousId,
+            salt: read.salt ?? this.preferences.salt,
+        };
+    }
+    /** Whether this version of the notice has been shown. */
+    wasNotified(version) {
+        return this.preferences.notifiedAt !== undefined && (this.preferences.noticeVersion ?? 0) >= version;
+    }
+    /** Records that the notice was shown; a failed write only means it may show once more. */
+    markNotified(version, at) {
+        this.preferences.notifiedAt = at;
+        this.preferences.noticeVersion = version;
+        this.write();
+    }
+    write() {
+        try {
+            writeFileAtomicSync(this.path, `${JSON.stringify(this.preferences, null, 2)}\n`, { mode: 0o600 });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/telemetry/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/telemetry/store.ts"],"names":[],"mappings":"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"}