@code-pushup/utils 0.107.0 → 0.108.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@code-pushup/utils",
-  "version": "0.107.0",
+  "version": "0.108.1",
   "description": "Low-level utilities (helper functions, etc.) used by Code PushUp CLI",
   "license": "MIT",
   "homepage": "https://github.com/code-pushup/cli/tree/main/packages/utils#readme",
@@ -27,7 +27,7 @@
     "node": ">=18.2.0"
   },
   "dependencies": {
-    "@code-pushup/models": "0.107.0",
+    "@code-pushup/models": "0.108.1",
     "ansis": "^3.3.0",
     "build-md": "^0.4.2",
     "bundle-require": "^5.1.0",

package/src/lib/create-runner-files.js

@@ -1,5 +1,6 @@
 import { writeFile } from 'node:fs/promises';
 import path from 'node:path';
+import { threadId } from 'node:worker_threads';
 import { ensureDirectoryExists, pluginWorkDir } from './file-system.js';
 /**
  * Function to create timestamp nested plugin runner files for config and output.
@@ -8,8 +9,10 @@ import { ensureDirectoryExists, pluginWorkDir } from './file-system.js';
  * @param configJSON - config of the plugin runner as JSON.
  */
 export async function createRunnerFiles(pluginSlug, configJSON) {
-    const timestamp = Date.now().toString();
-    const runnerWorkDir = path.join(pluginWorkDir(pluginSlug), timestamp);
+    // Use timestamp + process ID + threadId
+    // This prevents race conditions when running the same plugin for multiple projects in parallel
+    const uniqueId = `${(performance.timeOrigin + performance.now()) * 10}-${process.pid}-${threadId}`;
+    const runnerWorkDir = path.join(pluginWorkDir(pluginSlug), uniqueId);
     const runnerConfigPath = path.join(runnerWorkDir, 'plugin-config.json');
     const runnerOutputPath = path.join(runnerWorkDir, 'runner-output.json');
     await ensureDirectoryExists(path.dirname(runnerOutputPath));

package/src/lib/create-runner-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-runner-files.js","sourceRoot":"","sources":["../../../src/lib/create-runner-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,UAAkB;IAElB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IACxC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC;IACtE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC;IACxE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC;IAExE,MAAM,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC5D,MAAM,SAAS,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IAE9C,OAAO;QACL,gBAAgB;QAChB,gBAAgB;KACjB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"create-runner-files.js","sourceRoot":"","sources":["../../../src/lib/create-runner-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAExE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,UAAkB;IAElB,wCAAwC;IACxC,+FAA+F;IAC/F,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,GAAG,IAAI,QAAQ,EAAE,CAAC;IACnG,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC;IACxE,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC;IAExE,MAAM,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC5D,MAAM,SAAS,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IAE9C,OAAO;QACL,gBAAgB;QAChB,gBAAgB;KACjB,CAAC;AACJ,CAAC"}

package/src/lib/profiler/constants.d.ts

@@ -0,0 +1 @@
+export declare const PROFILER_ENABLED_ENV_VAR = "CP_PROFILING";

package/src/lib/profiler/constants.js

@@ -0,0 +1,2 @@
+export const PROFILER_ENABLED_ENV_VAR = 'CP_PROFILING';
+//# sourceMappingURL=constants.js.map

package/src/lib/profiler/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/lib/profiler/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,cAAc,CAAC"}

package/src/lib/profiler/profiler.d.ts

@@ -0,0 +1,134 @@
+import { type ActionTrackConfigs, type MeasureCtxOptions, type MeasureOptions } from '../user-timing-extensibility-api-utils.js';
+import type { ActionTrackEntryPayload, DevToolsColor, EntryMeta } from '../user-timing-extensibility-api.type.js';
+/**
+ * Configuration options for creating a Profiler instance.
+ *
+ * @template T - Record type defining available track names and their configurations
+ */
+type ProfilerMeasureOptions<T extends ActionTrackConfigs> = MeasureCtxOptions & {
+    /** Custom track configurations that will be merged with default settings */
+    tracks?: Record<keyof T, Partial<ActionTrackEntryPayload>>;
+    /** Whether profiling should be enabled (defaults to CP_PROFILING env var) */
+    enabled?: boolean;
+};
+/**
+ * Options for creating a performance marker.
+ */
+export type MarkerOptions = EntryMeta & {
+    color?: DevToolsColor;
+};
+/**
+ * Options for configuring a Profiler instance.
+ *
+ * This is an alias for ProfilerMeasureOptions for backward compatibility.
+ *
+ * @template T - Record type defining available track names and their configurations
+ *
+ * @property enabled - Whether profiling is enabled (defaults to CP_PROFILING env var)
+ * @property prefix - Prefix for all measurement names
+ * @property track - Default track name for measurements
+ * @property trackGroup - Default track group for organization
+ * @property color - Default color for track entries
+ * @property tracks - Custom track configurations merged with defaults
+ */
+export type ProfilerOptions<T extends ActionTrackConfigs = ActionTrackConfigs> = ProfilerMeasureOptions<T>;
+/**
+ * Performance profiler that creates structured timing measurements with Chrome DevTools Extensibility API payloads.
+ *
+ * This class provides high-level APIs for performance monitoring focused on Chrome DevTools Extensibility API data.
+ * It supports both synchronous and asynchronous operations with all having smart defaults for custom track data.
+ *
+ */
+export declare class Profiler<T extends ActionTrackConfigs> {
+    #private;
+    readonly tracks: Record<keyof T, ActionTrackEntryPayload> | undefined;
+    /**
+     * Creates a new Profiler instance with the specified configuration.
+     *
+     * @param options - Configuration options for the profiler
+     * @param options.tracks - Custom track configurations merged with defaults
+     * @param options.prefix - Prefix for all measurement names
+     * @param options.track - Default track name for measurements
+     * @param options.trackGroup - Default track group for organization
+     * @param options.color - Default color for track entries
+     * @param options.enabled - Whether profiling is enabled (defaults to CP_PROFILING env var)
+     *
+     */
+    constructor(options: ProfilerOptions<T>);
+    /**
+     * Sets enabled state for this profiler.
+     *
+     * Also sets the `CP_PROFILING` environment variable.
+     * This means any future {@link Profiler} instantiations (including child processes) will use the same enabled state.
+     *
+     * @param enabled - Whether profiling should be enabled
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Is profiling enabled?
+     *
+     * Profiling is enabled by {@link setEnabled} call or `CP_PROFILING` environment variable.
+     *
+     * @returns Whether profiling is currently enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Creates a performance mark including payload for a Chrome DevTools 'marker' item.
+     *
+     * Markers appear as vertical lines spanning all tracks and can include custom metadata
+     * for debugging and performance analysis. When profiling is disabled, this method
+     * returns immediately without creating any performance entries.
+     *
+     * @param name - Unique name for the marker
+     * @param opt - Metadata and styling for the marker
+     * @param opt.color - Color of the marker line (defaults to profiler default)
+     * @param opt.tooltipText - Text shown on hover
+     * @param opt.properties - Key-value pairs for detailed view show on click
+     *
+     * @example
+     * profiler.marker('user-action-start', {
+     *   color: 'primary',
+     *   tooltipText: 'User clicked save button',
+     *   properties: [
+     *     ['action', 'save'],
+     *     ['elementId', 'save-btn']
+     *   ]
+     * });
+     */
+    marker(name: string, opt?: MarkerOptions): void;
+    /**
+     * Measures the execution time of a synchronous operation.
+     *
+     * For asynchronous operations, use the {@link measureAsync} method.
+     *
+     * Creates performance start/end marks and a final measure.
+     * All entries have Chrome DevTools Extensibility API payload and are visualized under custom tracks.
+     * When profiling is disabled, executes the work function directly without overhead.
+     *
+     * @template R - The return type of the work function
+     * @param event - Name for this measurement event
+     * @param work - Function to execute and measure
+     * @param options - Measurement configuration overrides
+     * @returns The result of the work function
+     *
+     */
+    measure<R>(event: string, work: () => R, options?: MeasureOptions<R>): R;
+    /**
+     * Measures the execution time of an asynchronous operation.
+     *
+     * For synchronous operations, use the {@link measure} method.
+     *
+     * Creates performance start/end marks and a final measure.
+     * All entries have Chrome DevTools Extensibility API payload and are visualized under custom tracks.
+     * When profiling is disabled, executes and awaits the work function directly without overhead.
+     *
+     * @template R - The resolved type of the work promise
+     * @param event - Name for this measurement event
+     * @param work - Function returning a promise to execute and measure
+     * @param options - Measurement configuration overrides
+     * @returns Promise that resolves to the result of the work function
+     *
+     */
+    measureAsync<R>(event: string, work: () => Promise<R>, options?: MeasureOptions<R>): Promise<R>;
+}
+export {};

package/src/lib/profiler/profiler.js

@@ -0,0 +1,163 @@
+import process from 'node:process';
+import { isEnvVarEnabled } from '../env.js';
+import { asOptions, markerPayload, measureCtx, setupTracks, } from '../user-timing-extensibility-api-utils.js';
+import { PROFILER_ENABLED_ENV_VAR } from './constants.js';
+/**
+ * Performance profiler that creates structured timing measurements with Chrome DevTools Extensibility API payloads.
+ *
+ * This class provides high-level APIs for performance monitoring focused on Chrome DevTools Extensibility API data.
+ * It supports both synchronous and asynchronous operations with all having smart defaults for custom track data.
+ *
+ */
+export class Profiler {
+    #enabled;
+    #defaults;
+    tracks;
+    #ctxOf;
+    /**
+     * Creates a new Profiler instance with the specified configuration.
+     *
+     * @param options - Configuration options for the profiler
+     * @param options.tracks - Custom track configurations merged with defaults
+     * @param options.prefix - Prefix for all measurement names
+     * @param options.track - Default track name for measurements
+     * @param options.trackGroup - Default track group for organization
+     * @param options.color - Default color for track entries
+     * @param options.enabled - Whether profiling is enabled (defaults to CP_PROFILING env var)
+     *
+     */
+    constructor(options) {
+        const { tracks, prefix, enabled, ...defaults } = options;
+        const dataType = 'track-entry';
+        this.#enabled = enabled ?? isEnvVarEnabled(PROFILER_ENABLED_ENV_VAR);
+        this.#defaults = { ...defaults, dataType };
+        this.tracks = tracks
+            ? setupTracks({ ...defaults, dataType }, tracks)
+            : undefined;
+        this.#ctxOf = measureCtx({
+            ...defaults,
+            dataType,
+            prefix,
+        });
+    }
+    /**
+     * Sets enabled state for this profiler.
+     *
+     * Also sets the `CP_PROFILING` environment variable.
+     * This means any future {@link Profiler} instantiations (including child processes) will use the same enabled state.
+     *
+     * @param enabled - Whether profiling should be enabled
+     */
+    setEnabled(enabled) {
+        process.env[PROFILER_ENABLED_ENV_VAR] = `${enabled}`;
+        this.#enabled = enabled;
+    }
+    /**
+     * Is profiling enabled?
+     *
+     * Profiling is enabled by {@link setEnabled} call or `CP_PROFILING` environment variable.
+     *
+     * @returns Whether profiling is currently enabled
+     */
+    isEnabled() {
+        return this.#enabled;
+    }
+    /**
+     * Creates a performance mark including payload for a Chrome DevTools 'marker' item.
+     *
+     * Markers appear as vertical lines spanning all tracks and can include custom metadata
+     * for debugging and performance analysis. When profiling is disabled, this method
+     * returns immediately without creating any performance entries.
+     *
+     * @param name - Unique name for the marker
+     * @param opt - Metadata and styling for the marker
+     * @param opt.color - Color of the marker line (defaults to profiler default)
+     * @param opt.tooltipText - Text shown on hover
+     * @param opt.properties - Key-value pairs for detailed view show on click
+     *
+     * @example
+     * profiler.marker('user-action-start', {
+     *   color: 'primary',
+     *   tooltipText: 'User clicked save button',
+     *   properties: [
+     *     ['action', 'save'],
+     *     ['elementId', 'save-btn']
+     *   ]
+     * });
+     */
+    marker(name, opt) {
+        if (!this.#enabled) {
+            return;
+        }
+        performance.mark(name, asOptions(markerPayload({
+            // marker only takes default color, no TrackMeta
+            ...(this.#defaults.color ? { color: this.#defaults.color } : {}),
+            ...opt,
+        })));
+    }
+    /**
+     * Measures the execution time of a synchronous operation.
+     *
+     * For asynchronous operations, use the {@link measureAsync} method.
+     *
+     * Creates performance start/end marks and a final measure.
+     * All entries have Chrome DevTools Extensibility API payload and are visualized under custom tracks.
+     * When profiling is disabled, executes the work function directly without overhead.
+     *
+     * @template R - The return type of the work function
+     * @param event - Name for this measurement event
+     * @param work - Function to execute and measure
+     * @param options - Measurement configuration overrides
+     * @returns The result of the work function
+     *
+     */
+    measure(event, work, options) {
+        if (!this.#enabled) {
+            return work();
+        }
+        const { start, success, error } = this.#ctxOf(event, options);
+        start();
+        try {
+            const r = work();
+            success(r);
+            return r;
+        }
+        catch (error_) {
+            error(error_);
+            throw error_;
+        }
+    }
+    /**
+     * Measures the execution time of an asynchronous operation.
+     *
+     * For synchronous operations, use the {@link measure} method.
+     *
+     * Creates performance start/end marks and a final measure.
+     * All entries have Chrome DevTools Extensibility API payload and are visualized under custom tracks.
+     * When profiling is disabled, executes and awaits the work function directly without overhead.
+     *
+     * @template R - The resolved type of the work promise
+     * @param event - Name for this measurement event
+     * @param work - Function returning a promise to execute and measure
+     * @param options - Measurement configuration overrides
+     * @returns Promise that resolves to the result of the work function
+     *
+     */
+    async measureAsync(event, work, options) {
+        if (!this.#enabled) {
+            return await work();
+        }
+        const { start, success, error } = this.#ctxOf(event, options);
+        start();
+        try {
+            const r = await work();
+            success(r);
+            return r;
+        }
+        catch (error_) {
+            error(error_);
+            throw error_;
+        }
+    }
+}
+//# sourceMappingURL=profiler.js.map

package/src/lib/profiler/profiler.js.map

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

package/src/lib/user-timing-extensibility-api-utils.d.ts

@@ -195,6 +195,7 @@ export declare function mergeDevtoolsPayload<const P extends readonly [
 ]>(...parts: P): MergeResult<P> & {
     properties?: DevToolsProperties;
 };
+export type ActionTrackConfigs<T extends string = string> = Record<T, ActionTrackEntryPayload>;
 /**
  * Sets up tracks with default values merged into each track.
  * This helps to avoid repetition when defining multiple tracks with common properties.
@@ -209,19 +210,19 @@ export declare function setupTracks<const T extends Record<string, Partial<Actio
  * Options for customizing measurement behavior and callbacks.
  * Extends partial ActionTrackEntryPayload to allow overriding default track properties.
  */
-export type MeasureOptions = Partial<ActionTrackEntryPayload> & {
+export type MeasureOptions<T = unknown> = Partial<ActionTrackEntryPayload> & {
     /**
      * Callback invoked when measurement completes successfully.
      * @param result - The successful result value
      * @returns Additional DevTools properties to merge for success state
      */
-    success?: (result: unknown) => Partial<ActionTrackEntryPayload>;
+    success?: (result: T) => EntryMeta;
     /**
      * Callback invoked when measurement fails with an error.
      * @param error - The error that occurred
      * @returns Additional DevTools properties to merge for error state
      */
-    error?: (error: unknown) => Partial<ActionTrackEntryPayload>;
+    error?: (error: unknown) => EntryMeta;
 };
 /**
  * Configuration for creating a measurement context.
@@ -311,9 +312,9 @@ export type MeasureCtxOptions = ActionTrackEntryPayload & {
  * - `success(result?)`: Completes successful measurement with optional result metadata
  * - `error(error)`: Completes failed measurement with error metadata
  */
-export declare function measureCtx(cfg: MeasureCtxOptions): (event: string, opt?: MeasureOptions) => {
+export declare function measureCtx(cfg: MeasureCtxOptions): <T = unknown>(event: string, opt?: MeasureOptions<T>) => {
     start: () => import("perf_hooks").PerformanceMark;
-    success: (r: unknown) => void;
+    success: (r: T) => void;
     error: (err: unknown) => void;
 };
 export {};

package/src/lib/user-timing-extensibility-api-utils.js

@@ -191,7 +191,7 @@ export function setupTracks(defaults, tracks) {
  * @returns The mark options without dataType, tooltipText and properties.
  */
 function toMarkMeasureOpts(devtools) {
-    const { dataType: _, tooltipText: __, properties: ___, ...markDevtools } = devtools;
+    const { tooltipText: _, properties: __, ...markDevtools } = devtools;
     return { detail: { devtools: markDevtools } };
 }
 /**

package/src/lib/user-timing-extensibility-api-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-timing-extensibility-api-utils.js","sourceRoot":"","sources":["../../../src/lib/user-timing-extensibility-api-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"user-timing-extensibility-api-utils.js","sourceRoot":"","sources":["../../../src/lib/user-timing-extensibility-api-utils.ts"],"names":[],"mappings":"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"}