checkly 0.0.0-canary.7166ed8

package/dist/services/check-parser/package-files/package-json-file.d.ts

@@ -0,0 +1,59 @@
+import { JsonSourceFile } from './json-source-file.js';
+import { FileMeta, SourceFile } from './source-file.js';
+import { ResolveResult } from './paths.js';
+type ConditionKey = 'node-addons' | 'node' | 'import' | 'require' | 'module-sync' | 'default' | (string & Record<never, never>);
+type ExportTarget = string | null | ExportTarget[] | {
+    [K in ConditionKey]?: ExportTarget;
+};
+type Exports = string | Record<string, ExportTarget>;
+type Imports = Record<string, ExportTarget>;
+type Schema = {
+    name?: string;
+    version?: string;
+    license?: string;
+    main?: string;
+    engines?: Record<string, string>;
+    exports?: Exports;
+    imports?: Imports;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    private?: boolean;
+    workspaces?: string[] | {
+        packages?: string[];
+        catalogs?: Record<string, unknown>;
+        nohoist?: string[];
+    };
+};
+export interface EngineSupportResult {
+    engine: string;
+    requirements?: string;
+    incompatible: boolean;
+}
+export declare class PackageJsonFile {
+    #private;
+    static FILENAME: string;
+    readonly id: number;
+    jsonFile: JsonSourceFile<Schema>;
+    basePath: string;
+    mainPaths: string[];
+    private constructor();
+    hasExports(): boolean;
+    resolveExportPath(exportPath: string, conditions: ConditionKey[]): ResolveResult;
+    get meta(): FileMeta;
+    get name(): string | undefined;
+    get version(): string | undefined;
+    get dependencies(): Record<string, string> | undefined;
+    get devDependencies(): Record<string, string> | undefined;
+    get engines(): Record<string, string> | undefined;
+    get workspaces(): string[] | undefined;
+    supportsEngine(engine: string, version: string): EngineSupportResult;
+    static make(filePath: string, data: Schema): PackageJsonFile;
+    static loadFromJsonSourceFile(jsonFile: JsonSourceFile<Schema>): Promise<PackageJsonFile | undefined>;
+    static loadFromSourceFile(sourceFile: SourceFile): Promise<PackageJsonFile | undefined>;
+    static loadFromFilePath(filePath: string): Promise<PackageJsonFile | undefined>;
+    static filePath(dirPath: string): string;
+    upsertDependencies(dependencies: Record<string, string>): boolean;
+    upsertDevDependencies(dependencies: Record<string, string>): boolean;
+    toJSON(): string;
+}
+export {};

package/dist/services/check-parser/package-files/package-json-file.js

@@ -0,0 +1,248 @@
+import path from 'node:path';
+import semver from 'semver';
+import { JsonSourceFile } from './json-source-file.js';
+import { FileMeta, SourceFile } from './source-file.js';
+import { PathResolver } from './paths.js';
+export class PackageJsonFile {
+    static FILENAME = 'package.json';
+    static #id = 0;
+    id = ++PackageJsonFile.#id;
+    jsonFile;
+    basePath;
+    mainPaths;
+    constructor(jsonFile) {
+        this.jsonFile = jsonFile;
+        this.basePath = jsonFile.meta.dirname;
+        const fallbackMainPath = path.resolve(this.basePath, 'index.js');
+        this.mainPaths = jsonFile.data.main !== undefined
+            ? [path.resolve(this.basePath, jsonFile.data.main), fallbackMainPath]
+            : [fallbackMainPath];
+    }
+    hasExports() {
+        return !!this.jsonFile.data.exports;
+    }
+    resolveExportPath(exportPath, conditions) {
+        const resolver = PathResolver.createFromPaths(this.basePath, this.#resolveExports(this.jsonFile.data.exports ?? {}, conditions));
+        // Normalize the export path to the canonical subpath form used by
+        // `exports` keys. Per the Node.js spec, the root subpath is "." and
+        // all other subpaths start with "./". An empty string means the bare
+        // package import (`import x from 'foo'`) and maps to the root subpath.
+        //
+        // Previously the code blindly prepended "./" to everything, turning
+        // "" into "./", which never matched the "." key and made bare imports
+        // silently resolve to zero paths. Packages that also declared `main`
+        // worked anyway because of the fallback in `resolveSourceFile`; other
+        // packages did not.
+        if (exportPath === '' || exportPath === '.') {
+            exportPath = '.';
+        }
+        else if (!exportPath.startsWith('./')) {
+            exportPath = `./${exportPath}`;
+        }
+        return resolver.resolve(exportPath);
+    }
+    #resolveExports(exports, conditions) {
+        if (typeof exports === 'string') {
+            return {
+                '.': [exports],
+            };
+        }
+        const resolved = {};
+        for (const [from, target] of Object.entries(exports)) {
+            const resolvedTarget = this.#resolveExportTarget(target, conditions);
+            if (resolvedTarget !== undefined) {
+                resolved[from] = [resolvedTarget];
+            }
+        }
+        return resolved;
+    }
+    /**
+     * Recursively resolves an export target against the provided conditions,
+     * following the Node.js conditional exports resolution algorithm.
+     *
+     * Returns the first matching string target, or `undefined` if the target
+     * resolves to `null` (blocked export) or cannot be resolved for the given
+     * conditions.
+     */
+    #resolveExportTarget(target, conditions) {
+        // null explicitly blocks an export.
+        if (target === null) {
+            return undefined;
+        }
+        // Direct string target — we're done.
+        if (typeof target === 'string') {
+            return target;
+        }
+        // Array — try each fallback in order until one resolves.
+        if (Array.isArray(target)) {
+            for (const item of target) {
+                const resolvedItem = this.#resolveExportTarget(item, conditions);
+                if (resolvedItem !== undefined) {
+                    return resolvedItem;
+                }
+            }
+            return undefined;
+        }
+        // Object — iterate conditions in insertion order (per the Node.js spec,
+        // `default` is expected to be the last key in a condition object).
+        if (typeof target === 'object') {
+            for (const [condition, nested] of Object.entries(target)) {
+                if (!conditions.includes(condition)) {
+                    continue;
+                }
+                const resolvedNested = this.#resolveExportTarget(nested, conditions);
+                if (resolvedNested !== undefined) {
+                    return resolvedNested;
+                }
+            }
+            return undefined;
+        }
+        return undefined;
+    }
+    get meta() {
+        return this.jsonFile.meta;
+    }
+    get name() {
+        return this.jsonFile.data.name;
+    }
+    get version() {
+        return this.jsonFile.data.version;
+    }
+    get dependencies() {
+        return this.jsonFile.data.dependencies;
+    }
+    get devDependencies() {
+        return this.jsonFile.data.devDependencies;
+    }
+    get engines() {
+        return this.jsonFile.data.engines;
+    }
+    get workspaces() {
+        const workspaces = this.jsonFile.data.workspaces;
+        if (Array.isArray(workspaces)) {
+            return workspaces;
+        }
+        // Bun/Yarn object form: `{ packages: [...], catalogs/nohoist: ... }`.
+        // Anything else (incl. a malformed value) yields no workspace patterns.
+        if (typeof workspaces === 'object' && workspaces !== null && Array.isArray(workspaces.packages)) {
+            return workspaces.packages;
+        }
+        return undefined;
+    }
+    supportsEngine(engine, version) {
+        const requirements = this.engines?.[engine];
+        if (requirements === undefined) {
+            return {
+                engine,
+                incompatible: false,
+            };
+        }
+        try {
+            const ok = semver.satisfies(version, requirements);
+            return {
+                engine,
+                requirements,
+                incompatible: !ok,
+            };
+        }
+        catch {
+            return {
+                engine,
+                requirements,
+                incompatible: false,
+            };
+        }
+    }
+    static make(filePath, data) {
+        const contents = formatContents(data);
+        const sourceFile = new SourceFile(FileMeta.fromFilePath(filePath), contents);
+        const jsonFile = new JsonSourceFile(sourceFile, data);
+        return new PackageJsonFile(jsonFile);
+    }
+    // eslint-disable-next-line require-await
+    static async loadFromJsonSourceFile(jsonFile) {
+        return new PackageJsonFile(jsonFile);
+    }
+    static async loadFromSourceFile(sourceFile) {
+        const jsonSourceFile = await JsonSourceFile.loadFromSourceFile(sourceFile);
+        if (!jsonSourceFile) {
+            return;
+        }
+        return PackageJsonFile.loadFromJsonSourceFile(jsonSourceFile);
+    }
+    static async loadFromFilePath(filePath) {
+        const sourceFile = await SourceFile.loadFromFilePath(filePath);
+        if (!sourceFile) {
+            return;
+        }
+        return PackageJsonFile.loadFromSourceFile(sourceFile);
+    }
+    static filePath(dirPath) {
+        return path.join(dirPath, PackageJsonFile.FILENAME);
+    }
+    upsertDependencies(dependencies) {
+        const result = updateDependencies(this.jsonFile.data.dependencies, dependencies);
+        if (!result.changed) {
+            return false;
+        }
+        this.jsonFile.data.dependencies = sortDependencies(result.dependencies);
+        return true;
+    }
+    upsertDevDependencies(dependencies) {
+        const result = updateDependencies(this.jsonFile.data.devDependencies, dependencies);
+        if (!result.changed) {
+            return false;
+        }
+        this.jsonFile.data.devDependencies = sortDependencies(result.dependencies);
+        return true;
+    }
+    toJSON() {
+        return formatContents(this.jsonFile.data);
+    }
+}
+function updateDependencies(oldDependencies = {}, newDependencies = {}) {
+    const result = {
+        dependencies: { ...oldDependencies },
+        changed: false,
+    };
+    const safeMinVersion = (version) => {
+        try {
+            return semver.minVersion(version);
+        }
+        catch {
+            return null;
+        }
+    };
+    for (const [name, newVersion] of Object.entries(newDependencies)) {
+        const oldVersion = oldDependencies[name];
+        if (oldVersion !== undefined) {
+            const oldMinVersion = safeMinVersion(oldVersion);
+            if (oldMinVersion === null) {
+                // Assume it's something we shouldn't change.
+                continue;
+            }
+            const newMinVersion = safeMinVersion(newVersion);
+            if (newMinVersion === null) {
+                // This should not happen.
+                throw new Error(`Invalid new version '${newVersion}' for dependency '${name}'`);
+            }
+            if (oldMinVersion.compare(newMinVersion) >= 0) {
+                // It's recent enough.
+                continue;
+            }
+        }
+        result.changed = true;
+        result.dependencies[name] = newVersion;
+    }
+    return result;
+}
+function sortDependencies(dependencies) {
+    return Object.fromEntries(Object.keys(dependencies).sort().map(name => {
+        return [name, dependencies[name]];
+    }));
+}
+function formatContents(data) {
+    // NPM adds a trailing newline, so we do too.
+    return JSON.stringify(data, null, 2) + '\n';
+}
+//# sourceMappingURL=package-json-file.js.map

package/dist/services/check-parser/package-files/package-json-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-json-file.js","sourceRoot":"","sources":["../../../../src/services/check-parser/package-files/package-json-file.ts"],"names":[],"mappings":"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"}

package/dist/services/check-parser/package-files/package-manager.d.ts

@@ -0,0 +1,222 @@
+import { PackageJsonFile } from './package-json-file.js';
+import { Workspace } from './workspace.js';
+import { LockfilePackageQuery } from './lockfile-package-version.js';
+export declare class Runnable {
+    executable: string;
+    args: string[];
+    constructor(executable: string, args: string[]);
+    get unsafeDisplayCommand(): string;
+}
+export interface AddCommandOptions {
+    packages: string[];
+    saveDev?: boolean;
+}
+export interface PackageManager {
+    get name(): string;
+    get representativeLockfiles(): string[];
+    get representativeConfigFile(): string | undefined;
+    installCommand(): Runnable;
+    addCommand(options: AddCommandOptions): Runnable;
+    execCommand(args: string[]): Runnable;
+    lookupWorkspace(dir: string): Promise<Workspace | undefined>;
+    /**
+     * Resolves the version of a single package as recorded in the package
+     * manager's lockfile, scoped to a workspace importer. Returns `undefined`
+     * when the lockfile can't be read or parsed, the package isn't present, or
+     * the format isn't supported — the caller is expected to fall back to
+     * another source (e.g. reading the installed package).
+     */
+    resolvePackageVersionFromLockfile(lockfilePath: string, query: LockfilePackageQuery): Promise<string | undefined>;
+    detector(): PackageManagerDetector;
+}
+export type DetectionMethod = 'userAgent' | 'runtime' | 'lockfile' | 'configFile' | 'executable';
+export declare abstract class PackageManagerDetector {
+    abstract get name(): string;
+    /**
+     * Tie-break precedence when more than one detector matches the same detection
+     * method. Higher wins (detectors are sorted descending). Lets a detector rank
+     * itself differently per method — e.g. npm deprioritizes its executable
+     * because npm is almost always on PATH, so its mere presence is no signal.
+     */
+    abstract priority(method: DetectionMethod): number;
+    abstract detectUserAgent(userAgent: string): boolean;
+    abstract detectRuntime(): boolean;
+    abstract get representativeLockfiles(): string[];
+    abstract get representativeConfigFile(): string | undefined;
+    detectLockfile(dir: string): Promise<string>;
+    abstract detectConfigFile(dir: string): Promise<string>;
+    abstract detectExecutable(lookup: PathLookup): Promise<void>;
+    abstract installCommand(): Runnable;
+    abstract addCommand(options: AddCommandOptions): Runnable;
+    abstract execCommand(args: string[]): Runnable;
+    abstract lookupWorkspace(dir: string): Promise<Workspace | undefined>;
+    /**
+     * Default: lockfile parsing is unsupported, so callers fall back. Package
+     * managers that can parse their lockfile override this.
+     */
+    resolvePackageVersionFromLockfile(lockfilePath: string, query: LockfilePackageQuery): Promise<string | undefined>;
+    detector(): PackageManagerDetector;
+}
+export declare class NpmDetector extends PackageManagerDetector implements PackageManager {
+    get name(): string;
+    priority(method: DetectionMethod): number;
+    detectUserAgent(userAgent: string): boolean;
+    detectRuntime(): boolean;
+    get representativeLockfiles(): string[];
+    get representativeConfigFile(): undefined;
+    detectConfigFile(dir: string): Promise<string>;
+    detectExecutable(lookup: PathLookup): Promise<void>;
+    installCommand(): Runnable;
+    addCommand(options: AddCommandOptions): Runnable;
+    execCommand(args: string[]): Runnable;
+    lookupWorkspace(dir: string): Promise<Workspace | undefined>;
+    resolvePackageVersionFromLockfile(lockfilePath: string, query: LockfilePackageQuery): Promise<string | undefined>;
+}
+export declare class CNpmDetector extends PackageManagerDetector implements PackageManager {
+    get name(): string;
+    priority(): number;
+    detectUserAgent(userAgent: string): boolean;
+    detectRuntime(): boolean;
+    get representativeLockfiles(): string[];
+    get representativeConfigFile(): undefined;
+    detectConfigFile(dir: string): Promise<string>;
+    detectExecutable(lookup: PathLookup): Promise<void>;
+    installCommand(): Runnable;
+    addCommand(options: AddCommandOptions): Runnable;
+    execCommand(args: string[]): Runnable;
+    lookupWorkspace(dir: string): Promise<Workspace | undefined>;
+    resolvePackageVersionFromLockfile(lockfilePath: string, query: LockfilePackageQuery): Promise<string | undefined>;
+}
+export declare class PNpmDetector extends PackageManagerDetector implements PackageManager {
+    get name(): string;
+    priority(): number;
+    detectUserAgent(userAgent: string): boolean;
+    detectRuntime(): boolean;
+    get representativeLockfiles(): string[];
+    get representativeConfigFile(): string;
+    detectConfigFile(dir: string): Promise<string>;
+    detectExecutable(lookup: PathLookup): Promise<void>;
+    installCommand(): Runnable;
+    addCommand(options: AddCommandOptions): Runnable;
+    execCommand(args: string[]): Runnable;
+    lookupWorkspace(dir: string): Promise<Workspace | undefined>;
+    resolvePackageVersionFromLockfile(lockfilePath: string, query: LockfilePackageQuery): Promise<string | undefined>;
+}
+export declare class YarnDetector extends PackageManagerDetector implements PackageManager {
+    get name(): string;
+    priority(): number;
+    detectUserAgent(userAgent: string): boolean;
+    detectRuntime(): boolean;
+    get representativeLockfiles(): string[];
+    get representativeConfigFile(): undefined;
+    detectConfigFile(dir: string): Promise<string>;
+    detectExecutable(lookup: PathLookup): Promise<void>;
+    installCommand(): Runnable;
+    addCommand(options: AddCommandOptions): Runnable;
+    execCommand(args: string[]): Runnable;
+    lookupWorkspace(dir: string): Promise<Workspace | undefined>;
+    resolvePackageVersionFromLockfile(lockfilePath: string, query: LockfilePackageQuery): Promise<string | undefined>;
+}
+export declare class DenoDetector extends PackageManagerDetector implements PackageManager {
+    get name(): string;
+    priority(): number;
+    detectUserAgent(userAgent: string): boolean;
+    detectRuntime(): boolean;
+    get representativeLockfiles(): string[];
+    get representativeConfigFile(): string;
+    detectConfigFile(dir: string): Promise<string>;
+    detectExecutable(lookup: PathLookup): Promise<void>;
+    installCommand(): Runnable;
+    addCommand(options: AddCommandOptions): Runnable;
+    execCommand(args: string[]): Runnable;
+    lookupWorkspace(dir: string): Promise<Workspace | undefined>;
+}
+export declare class BunDetector extends PackageManagerDetector implements PackageManager {
+    get name(): string;
+    priority(): number;
+    detectUserAgent(userAgent: string): boolean;
+    detectRuntime(): boolean;
+    get representativeLockfiles(): string[];
+    get representativeConfigFile(): undefined;
+    detectConfigFile(dir: string): Promise<string>;
+    detectExecutable(lookup: PathLookup): Promise<void>;
+    installCommand(): Runnable;
+    addCommand(options: AddCommandOptions): Runnable;
+    execCommand(args: string[]): Runnable;
+    lookupWorkspace(dir: string): Promise<Workspace | undefined>;
+    resolvePackageVersionFromLockfile(lockfilePath: string, query: LockfilePackageQuery): Promise<string | undefined>;
+}
+/**
+ * Inspiration taken from https://github.com/otiai10/lookpath.
+ */
+export declare class PathLookup {
+    static win: boolean;
+    paths: string[];
+    pathext: string[];
+    pathextSet: Set<string>;
+    constructor();
+    detectPresence(executable: string): Promise<void>;
+    lookupPath(executable: string): Promise<string | undefined>;
+}
+export declare const npmPackageManager: NpmDetector;
+export declare const knownPackageManagers: PackageManagerDetector[];
+export interface DetectPackageManagerOptions {
+    detectors: PackageManagerDetector[];
+    root?: string;
+}
+export declare function detectPackageManager(dir: string, options?: DetectPackageManagerOptions): Promise<PackageManager>;
+export interface NearestLockFile {
+    packageManager: PackageManager;
+    lockfile: string;
+}
+export declare class NoLockfileFoundError extends Error {
+    searchPaths: string[];
+    lockfiles: string[];
+    constructor(searchPaths: string[], lockfiles: string[], options?: ErrorOptions);
+}
+export interface DetectNearestLockfileOptions {
+    detectors?: PackageManagerDetector[];
+    root?: string;
+}
+/**
+ * Searches `dir` and every parent directory (up to and including
+ * `options.root`) for a lockfile of any of the given `options.detectors`
+ * (or all known package manager detectors if not given). The search stops
+ * when a directory containing lockfiles is found.
+ *
+ * @returns All detected lockfiles in the directory.
+ * @throws {NoLockfileFoundError} If no directory containing a lockfile is found.
+ */
+export declare function detectNearestLockfiles(dir: string, options?: DetectNearestLockfileOptions): Promise<NearestLockFile[]>;
+export interface NearestConfigFile {
+    packageManager: PackageManager;
+    configFile: string;
+}
+export declare class NoConfigFileFoundError extends Error {
+    searchPaths: string[];
+    configFiles: string[];
+    constructor(searchPaths: string[], configFiles: string[], options?: ErrorOptions);
+}
+export interface DetectNearestConfigFileOptions {
+    detectors?: PackageManagerDetector[];
+    root?: string;
+}
+/**
+ * Searches `dir` and every parent directory (up to and including
+ * `options.root`) for a config file of any of the given `options.detectors`
+ * (or all known package manager detectors if not given). The search stops
+ * when a directory containing config files is found.
+ *
+ * @returns All detected config files in the directory.
+ * @throws {NoConfigFileFoundError} If no directory containing a config file is found.
+ */
+export declare function detectNearestConfigFiles(dir: string, options?: DetectNearestConfigFileOptions): Promise<NearestConfigFile[]>;
+export declare class NoPackageJsonFoundError extends Error {
+    searchPaths: string[];
+    constructor(searchPaths: string[], options?: ErrorOptions);
+}
+export interface DetectNearestPackageJsonOptions {
+    root?: string;
+}
+export declare function detectNearestPackageJson(dir: string, options?: DetectNearestPackageJsonOptions): Promise<PackageJsonFile>;
+export declare function fauxWorkspaceFromPackageJson(packageManager: PackageManager, packageJsonFile: PackageJsonFile): Promise<Workspace>;