checkly 9.5.0 → 10.0.0-prerelease-4f88d60

package/dist/services/engine-rules-loader.js

@@ -1,4 +1,6 @@
-// Canonical source: monorepo/engines.json
+// Mirrors the engine versions the backend accepts (PLAYWRIGHT_*_ENGINE_VERSIONS
+// in the monorepo's apps/backend/api/src/modules/common/schemas.js); the
+// terraform provider embeds the same rules in its checkly/engines.json.
 // Async to match a future API call signature.
 // eslint-disable-next-line require-await
 export async function loadEngineRules() {
@@ -30,11 +32,18 @@ const enginesConfig = {
         {
             name: 'bun',
             versions: {
-                default: '1.3',
+                // '1' is the newest 1.x the runner image carries; it is also what the
+                // runner uses when a check sets no engine version.
+                default: '1',
+                aliases: ['1'],
                 rules: [
                     { source: '<1.3', target: '1.3', action: 'allow', follow: true, notice: 'Bun ${SOURCE} is not available. Using Bun 1.3 instead.' },
                     { source: '~1.3', target: '1.3', action: 'allow', follow: false },
-                    { source: '^1.4', target: '1.3', action: 'allow', follow: true, notice: 'Bun ${SOURCE} is not available yet. Using Bun 1.3 instead.' },
+                    { source: '~1.4', target: '1.4', action: 'allow', follow: false },
+                    // Like Node's `>=27`: a not-yet-available minor maps to the highest
+                    // pinned minor rather than the floating '1', so the version does not
+                    // drift with later runner images while the project still pins it.
+                    { source: '>=1.5 <2', target: '1.4', action: 'allow', follow: false, notice: 'Bun ${SOURCE} is not available yet. Using Bun 1.4 instead.' },
                     { source: '>=2', action: 'deny', follow: false, notice: 'Bun ${SOURCE} is not available yet.' },
                 ],
             },

package/dist/services/engine-rules-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine-rules-loader.js","sourceRoot":"","sources":["../../src/services/engine-rules-loader.ts"],"names":[],"mappings":"AAsBA,0CAA0C;AAC1C,8CAA8C;AAC9C,yCAAyC;AACzC,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,OAAO,aAAa,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,eAAe,CAAE,MAAqB,EAAE,UAAkB;IACxE,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,EAAE,QAAQ,CAAA;AAClE,CAAC;AAED,MAAM,aAAa,GAAkB;IACnC,OAAO,EAAE;QACP;YACE,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE;gBACR,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE;oBACL,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,oGAAoG,EAAE;oBAC5K,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,oGAAoG,EAAE;oBAC5K,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,qEAAqE,EAAE;oBAC7I,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,wGAAwG,EAAE;oBAChL,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;oBAC/D,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,wGAAwG,EAAE;oBAChL,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;oBAC/D,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,wGAAwG,EAAE;oBAChL,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;oBAC/D,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,yEAAyE,EAAE;iBACnJ;aACF;SACF;QACD;YACE,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE;gBACR,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,wDAAwD,EAAE;oBAClI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;oBACjE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,4DAA4D,EAAE;oBACtI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,qCAAqC,EAAE;iBAChG;aACF;SACF;KACF;CACF,CAAA"}
+{"version":3,"file":"engine-rules-loader.js","sourceRoot":"","sources":["../../src/services/engine-rules-loader.ts"],"names":[],"mappings":"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"}

package/dist/services/oxc-parser.d.ts

@@ -0,0 +1,26 @@
+import type { ParseResult, ParserOptions } from 'oxc-parser';
+export type ParseSync = (filename: string, source: string, options?: ParserOptions) => ParseResult;
+/**
+ * oxc-parser's `parseSync`. Its native binding can be missing, e.g. when
+ * optional dependencies weren't installed or node_modules was copied from
+ * another platform; `oxcLoadError` is thrown then, and again on every later
+ * call without retrying the load.
+ */
+export declare function loadOxcParser(): ParseSync;
+/**
+ * A failure to load oxc-parser, named as such: its own error ("Cannot find
+ * native binding", with how to reinstall) doesn't say which package it is
+ * about.
+ */
+export declare function oxcLoadError(error: unknown): Error;
+/**
+ * Parses a TypeScript or JSX file the way its extension says: declaration
+ * files allow syntax that regular files don't, and JSX is only enabled for
+ * `.tsx` and `.jsx`, since in a `.ts` file type brackets would confuse the
+ * parser. `.cts` files are CommonJS, the rest modules.
+ *
+ * @throws SyntaxError on the first syntax error, with its line and column.
+ * oxc recovers from syntax errors and returns a partial AST, which is never
+ * returned here.
+ */
+export declare function parseWithOxc(parseSync: ParseSync, filePath: string, contents: string, options?: ParserOptions): ParseResult;

package/dist/services/oxc-parser.js

@@ -0,0 +1,70 @@
+import { createRequire } from 'node:module';
+import path from 'node:path';
+let loaded;
+/**
+ * oxc-parser's `parseSync`. Its native binding can be missing, e.g. when
+ * optional dependencies weren't installed or node_modules was copied from
+ * another platform; `oxcLoadError` is thrown then, and again on every later
+ * call without retrying the load.
+ */
+export function loadOxcParser() {
+    if (loaded === undefined) {
+        try {
+            const require = createRequire(import.meta.url);
+            loaded = { parseSync: require('oxc-parser').parseSync };
+        }
+        catch (error) {
+            loaded = { error: oxcLoadError(error) };
+        }
+    }
+    if ('error' in loaded) {
+        throw loaded.error;
+    }
+    return loaded.parseSync;
+}
+/**
+ * A failure to load oxc-parser, named as such: its own error ("Cannot find
+ * native binding", with how to reinstall) doesn't say which package it is
+ * about.
+ */
+export function oxcLoadError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return new Error(`oxc-parser, which parses TypeScript files, failed to load: ${message}`, { cause: error });
+}
+// foo.d.ts, foo.d.mts, foo.d.cts and foo.d.css.ts (allowArbitraryExtensions)
+const DECLARATION_FILE = /\.d\.([^.\\/]+\.)?[cm]?ts$/;
+function lineColumn(contents, offset) {
+    const before = contents.slice(0, offset);
+    const line = before.split('\n').length;
+    // 0-based column, like acorn's
+    const column = offset - before.lastIndexOf('\n') - 1;
+    return `${line}:${column}`;
+}
+/**
+ * Parses a TypeScript or JSX file the way its extension says: declaration
+ * files allow syntax that regular files don't, and JSX is only enabled for
+ * `.tsx` and `.jsx`, since in a `.ts` file type brackets would confuse the
+ * parser. `.cts` files are CommonJS, the rest modules.
+ *
+ * @throws SyntaxError on the first syntax error, with its line and column.
+ * oxc recovers from syntax errors and returns a partial AST, which is never
+ * returned here.
+ */
+export function parseWithOxc(parseSync, filePath, contents, options = {}) {
+    const extension = path.extname(filePath);
+    const result = parseSync(filePath, contents, {
+        lang: DECLARATION_FILE.test(filePath)
+            ? 'dts'
+            : extension === '.tsx' ? 'tsx' : extension === '.jsx' ? 'jsx' : 'ts',
+        sourceType: extension === '.cts' ? 'commonjs' : 'module',
+        astType: 'ts',
+        ...options,
+    });
+    const [error] = result.errors;
+    if (error) {
+        const offset = error.labels[0]?.start;
+        throw new SyntaxError(offset === undefined ? error.message : `${error.message} (${lineColumn(contents, offset)})`);
+    }
+    return result;
+}
+//# sourceMappingURL=oxc-parser.js.map

package/dist/services/oxc-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oxc-parser.js","sourceRoot":"","sources":["../../src/services/oxc-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAA;AAW5B,IAAI,MAAiE,CAAA;AAErE;;;;;GAKG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAC9C,MAAM,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,SAAS,EAAE,CAAA;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAA;QACzC,CAAC;IACH,CAAC;IACD,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACtB,MAAM,MAAM,CAAC,KAAK,CAAA;IACpB,CAAC;IACD,OAAO,MAAM,CAAC,SAAS,CAAA;AACzB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAE,KAAc;IAC1C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACtE,OAAO,IAAI,KAAK,CAAC,8DAA8D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;AAC7G,CAAC;AAED,6EAA6E;AAC7E,MAAM,gBAAgB,GAAG,4BAA4B,CAAA;AAErD,SAAS,UAAU,CAAE,QAAgB,EAAE,MAAc;IACnD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAA;IACtC,+BAA+B;IAC/B,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACpD,OAAO,GAAG,IAAI,IAAI,MAAM,EAAE,CAAA;AAC5B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAoB,EACpB,QAAgB,EAChB,QAAgB,EAChB,UAAyB,EAAE;IAE3B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACxC,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE;QAC3C,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC;YACnC,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QACtE,UAAU,EAAE,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ;QACxD,OAAO,EAAE,IAAI;QACb,GAAG,OAAO;KACX,CAAC,CAAA;IACF,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAA;IAC7B,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAA;QACrC,MAAM,IAAI,WAAW,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,KAAK,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;IACpH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/services/project-cli.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Set to `1` to always run the invoked CLI, even when the project has its own
+ * `checkly` install.
+ */
+export declare const NO_DELEGATION_ENV = "CHECKLY_NO_DELEGATION";
+/** The root of the checkly package this module belongs to. */
+export declare const ownRoot: string;
+export interface Install {
+    root: string;
+    version: string;
+}
+export interface ProjectCli {
+    /** The install's directory as found, i.e. `<dir>/node_modules/checkly`. */
+    dir: string;
+    version: string;
+    binPath: string;
+}
+/**
+ * The short boolean flags of the commands that take `-c`. In a group of
+ * short flags (`-pc path`), oclif lets each boolean letter pass and reads
+ * the next letter, so a `c` after them is still `--config`. Installs from
+ * before a new boolean short flag was added do not know it, and search from
+ * the working directory when it is grouped with `c`.
+ */
+export declare const booleanShortFlags: Set<string>;
+/**
+ * The value of `--config` (or its short form `-c`) in raw command arguments,
+ * in any form oclif accepts: `--config v`, `--config=v`, `-c v`, `-c=v`,
+ * `-cv`, and `c` after boolean short flags in one group (`-pc v`, `-pcv`).
+ * Arguments after `--` are not flags.
+ *
+ * Every command that takes a config file calls the flag `config` with the
+ * short form `-c`, and other checkly installs read it here before handing a
+ * command over, so the flag has to keep that meaning in every release.
+ */
+export declare function findConfigFlag(args: string[]): string | undefined;
+/**
+ * The `checkly` install that a bare `checkly` import in `directory` resolves
+ * to: the nearest `node_modules/checkly`, searched upwards like Node does.
+ * NODE_PATH and global folders are deliberately not searched, because ES
+ * module resolution of the project's files never uses them. Throws when a
+ * candidate's package.json cannot be read, rather than skipping past the
+ * install the project's imports would resolve to.
+ */
+export declare function findProjectCli(directory: string): Promise<ProjectCli | undefined>;
+/** Whether `version` is a development or canary build rather than a release. */
+export declare function isDevelopmentBuild(version: string): boolean;
+/** Whether two paths are the same directory. Throws when either cannot be resolved. */
+export declare function isSameDirectory(a: string, b: string): boolean;
+/**
+ * The project's own CLI to run the command with instead of `self`, if any.
+ *
+ * Constructs in a project's config and check files register with the
+ * `Session` of the `checkly` install the project resolves, so only that
+ * install can load the project: when the running CLI is another install
+ * (global, `pnpx`, an `npx` of another version), its `Session` would never
+ * see them. Every command is handed off, which makes any install behave like
+ * `npx checkly` run in the project's directory.
+ */
+export declare function findProjectCliHandOff(self: Install, directory?: string): Promise<ProjectCli | undefined>;
+/**
+ * Node options for the project's CLI: this process's, minus inspector flags,
+ * which would make the child compete with this process for the debugger
+ * port. Use CHECKLY_NO_DELEGATION=1 to debug a hand-off case.
+ */
+export declare function childNodeOptions(execArgv: string[], nodeOptions: string | undefined): {
+    execArgv: string[];
+    nodeOptions: string | undefined;
+};
+/**
+ * Runs `args` with the project's own CLI when {@link findProjectCliHandOff}
+ * finds one, and exits with its exit status. Resolves to `false` when this
+ * CLI should run the command itself.
+ */
+export declare function runWithProjectCli(args: string[], self?: Install): Promise<boolean>;

package/dist/services/project-cli.js

@@ -0,0 +1,302 @@
+import { spawn } from 'node:child_process';
+import fsSync from 'node:fs';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import Debug from 'debug';
+import semver from 'semver';
+import { lineage } from './check-parser/package-files/walk.js';
+// The launcher runs this module before oclif loads, so it must stay light:
+// nothing here may import the commands or the constructs.
+const debug = Debug('checkly:cli:project-cli');
+/**
+ * Set to `1` to always run the invoked CLI, even when the project has its own
+ * `checkly` install.
+ */
+export const NO_DELEGATION_ENV = 'CHECKLY_NO_DELEGATION';
+/**
+ * The install a hand-off started, set in its environment. That install never
+ * hands off to itself again, while a checkly it starts for another project
+ * still can.
+ */
+const HANDED_OFF_TO_ENV = 'CHECKLY_HANDED_OFF_TO';
+/** The root of the checkly package this module belongs to. */
+export const ownRoot = fileURLToPath(new URL('../..', import.meta.url));
+/**
+ * The short boolean flags of the commands that take `-c`. In a group of
+ * short flags (`-pc path`), oclif lets each boolean letter pass and reads
+ * the next letter, so a `c` after them is still `--config`. Installs from
+ * before a new boolean short flag was added do not know it, and search from
+ * the working directory when it is grouped with `c`.
+ */
+export const booleanShortFlags = new Set(['d', 'f', 'o', 'p', 'u', 'v']);
+/**
+ * The value of `--config` (or its short form `-c`) in raw command arguments,
+ * in any form oclif accepts: `--config v`, `--config=v`, `-c v`, `-c=v`,
+ * `-cv`, and `c` after boolean short flags in one group (`-pc v`, `-pcv`).
+ * Arguments after `--` are not flags.
+ *
+ * Every command that takes a config file calls the flag `config` with the
+ * short form `-c`, and other checkly installs read it here before handing a
+ * command over, so the flag has to keep that meaning in every release.
+ */
+export function findConfigFlag(args) {
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--') {
+            return undefined;
+        }
+        if (arg === '--config') {
+            return args[i + 1] || undefined;
+        }
+        if (arg.startsWith('--config=')) {
+            return arg.slice('--config='.length) || undefined;
+        }
+        if (arg.startsWith('-') && !arg.startsWith('--')) {
+            let j = 1;
+            while (booleanShortFlags.has(arg[j])) {
+                j++;
+            }
+            if (arg[j] === 'c') {
+                if (arg[j + 1] === '=') {
+                    return arg.slice(j + 2) || undefined;
+                }
+                return (arg.slice(j + 1) || args[i + 1]) || undefined;
+            }
+        }
+    }
+    return undefined;
+}
+async function exists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Resolves to `undefined` when the file does not exist; throws on any other error. */
+async function readJsonIfExists(filePath) {
+    let content;
+    try {
+        content = await fs.readFile(filePath, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT' || err.code === 'ENOTDIR') {
+            return undefined;
+        }
+        throw err;
+    }
+    return JSON.parse(content);
+}
+/**
+ * The `checkly` install that a bare `checkly` import in `directory` resolves
+ * to: the nearest `node_modules/checkly`, searched upwards like Node does.
+ * NODE_PATH and global folders are deliberately not searched, because ES
+ * module resolution of the project's files never uses them. Throws when a
+ * candidate's package.json cannot be read, rather than skipping past the
+ * install the project's imports would resolve to.
+ */
+export async function findProjectCli(directory) {
+    for (const current of lineage(directory)) {
+        if (path.basename(current) === 'node_modules') {
+            continue;
+        }
+        const dir = path.join(current, 'node_modules', 'checkly');
+        const packageJson = await readJsonIfExists(path.join(dir, 'package.json'));
+        if (!packageJson) {
+            continue;
+        }
+        if (packageJson.name !== 'checkly') {
+            debug('%s is not the checkly package', dir);
+            return undefined;
+        }
+        const bin = typeof packageJson.bin === 'string' ? packageJson.bin : packageJson.bin?.checkly;
+        if (typeof bin !== 'string') {
+            debug('%s has no checkly bin', dir);
+            return undefined;
+        }
+        const binPath = path.join(dir, bin);
+        if (!await exists(binPath)) {
+            debug('the checkly bin of %s is missing at %s', dir, binPath);
+            return undefined;
+        }
+        return { dir, version: String(packageJson.version), binPath };
+    }
+    return undefined;
+}
+/** Whether `version` is a development or canary build rather than a release. */
+export function isDevelopmentBuild(version) {
+    return version === '0.0.1-dev' || version.startsWith('0.0.0');
+}
+/** Whether two paths are the same directory. Throws when either cannot be resolved. */
+export function isSameDirectory(a, b) {
+    const [realA, realB] = [fsSync.realpathSync(a), fsSync.realpathSync(b)];
+    // Windows paths compare case-insensitively; realpath can return either
+    // casing of a drive letter or folder name.
+    return process.platform === 'win32'
+        ? realA.toLowerCase() === realB.toLowerCase()
+        : realA === realB;
+}
+/**
+ * The project's own CLI to run the command with instead of `self`, if any.
+ *
+ * Constructs in a project's config and check files register with the
+ * `Session` of the `checkly` install the project resolves, so only that
+ * install can load the project: when the running CLI is another install
+ * (global, `pnpx`, an `npx` of another version), its `Session` would never
+ * see them. Every command is handed off, which makes any install behave like
+ * `npx checkly` run in the project's directory.
+ */
+export async function findProjectCliHandOff(self, directory = process.cwd()) {
+    if (process.env[NO_DELEGATION_ENV] === '1') {
+        debug('hand-off disabled via %s=1', NO_DELEGATION_ENV);
+        return undefined;
+    }
+    if (process.versions.deno) {
+        // A child started from process.execPath would run without the
+        // permission flags given to the outer `deno run`.
+        debug('hand-off not supported on Deno');
+        return undefined;
+    }
+    const projectCli = await findProjectCli(directory);
+    if (!projectCli) {
+        debug('no checkly install found from %s', directory);
+        return undefined;
+    }
+    if (isSameDirectory(projectCli.dir, self.root)) {
+        debug('running from the project\'s install at %s', projectCli.dir);
+        return undefined;
+    }
+    const handedOffTo = process.env[HANDED_OFF_TO_ENV];
+    if (handedOffTo && isSameDirectoryOrFalse(projectCli.dir, handedOffTo)) {
+        debug('already handed off to %s', projectCli.dir);
+        return undefined;
+    }
+    return projectCli;
+}
+function isSameDirectoryOrFalse(a, b) {
+    try {
+        return isSameDirectory(a, b);
+    }
+    catch {
+        return false;
+    }
+}
+const forwardedSignals = ['SIGINT', 'SIGTERM', 'SIGHUP'];
+function startFailed(self, err) {
+    process.stderr.write(`Could not start the checkly install of this project (${err.message}); running checkly ${self.version}.\n`);
+    return false;
+}
+const isInspectorFlag = (arg) => /^--(inspect|debug)/.test(arg);
+/**
+ * Node options for the project's CLI: this process's, minus inspector flags,
+ * which would make the child compete with this process for the debugger
+ * port. Use CHECKLY_NO_DELEGATION=1 to debug a hand-off case.
+ */
+export function childNodeOptions(execArgv, nodeOptions) {
+    return {
+        execArgv: execArgv.filter(arg => !isInspectorFlag(arg)),
+        nodeOptions: nodeOptions?.split(/\s+/).filter(arg => arg && !isInspectorFlag(arg)).join(' '),
+    };
+}
+function versionNotice(projectCli, self) {
+    if (projectCli.version === self.version) {
+        return undefined;
+    }
+    const displayDir = path.relative(process.cwd(), projectCli.dir) || projectCli.dir;
+    const notice = `Using checkly ${projectCli.version} from this project (${displayDir}) `
+        + `instead of checkly ${self.version}.`;
+    // Only worth acting on when the invoked version is the newer one.
+    return semver.valid(self.version) && semver.valid(projectCli.version)
+        && semver.gt(self.version, projectCli.version)
+        ? `${notice} To use ${self.version}, install it in this project.`
+        : notice;
+}
+async function readOwnInstall() {
+    const packageJson = await readJsonIfExists(path.join(ownRoot, 'package.json'));
+    return { root: ownRoot, version: String(packageJson?.version) };
+}
+/**
+ * Runs `args` with the project's own CLI when {@link findProjectCliHandOff}
+ * finds one, and exits with its exit status. Resolves to `false` when this
+ * CLI should run the command itself.
+ */
+export async function runWithProjectCli(args, self) {
+    let projectCli;
+    try {
+        self ??= await readOwnInstall();
+        // The project is where the commands load it from: the config file's
+        // directory, or the working directory (splitConfigFilePath in util.ts).
+        const configFile = findConfigFlag(args);
+        projectCli = await findProjectCliHandOff(self, configFile ? path.dirname(path.resolve(configFile)) : undefined);
+    }
+    catch (err) {
+        // Nothing has been handed off yet, so the command can still run here.
+        debug('looking for the project\'s checkly install failed: %O', err);
+        process.stderr.write(`Could not read the checkly install of this project (${err.message}); `
+            + `running checkly${self ? ` ${self.version}` : ''}.\n`);
+        return false;
+    }
+    if (!projectCli) {
+        return false;
+    }
+    debug('handing off to checkly %s at %s', projectCli.version, projectCli.dir);
+    const notice = versionNotice(projectCli, self);
+    if (notice) {
+        process.stderr.write(`${notice}\n`);
+    }
+    let child;
+    try {
+        // With the environment including .env values: installs before 8.0.0
+        // do not load .env themselves, and later ones never override a set key.
+        const { execArgv, nodeOptions } = childNodeOptions(process.execArgv, process.env.NODE_OPTIONS);
+        const env = { ...process.env, [HANDED_OFF_TO_ENV]: projectCli.dir };
+        if (nodeOptions === undefined) {
+            delete env.NODE_OPTIONS;
+        }
+        else {
+            env.NODE_OPTIONS = nodeOptions;
+        }
+        child = spawn(process.execPath, [...execArgv, projectCli.binPath, ...args], { stdio: 'inherit', env });
+    }
+    catch (err) {
+        return startFailed(self, err);
+    }
+    // Keep this process alive until the child exits. A Ctrl+C in a terminal
+    // reaches both processes; the forwarded copy is a duplicate the CLI's
+    // SIGINT handling ignores. Signals sent to this process alone (a CI runner
+    // stopping a job) only reach the child through the forwarding. On Windows
+    // console events already reach the child, and kill() would terminate it
+    // outright, so nothing is forwarded there.
+    const forward = (signal) => {
+        if (process.platform !== 'win32' && child.pid !== undefined) {
+            child.kill(signal);
+        }
+    };
+    for (const signal of forwardedSignals) {
+        process.on(signal, forward);
+    }
+    const stopForwarding = () => {
+        for (const signal of forwardedSignals) {
+            process.off(signal, forward);
+        }
+    };
+    const result = await new Promise(resolve => {
+        child.once('error', resolve);
+        child.once('exit', (code, signal) => resolve({ code, signal }));
+    });
+    stopForwarding();
+    if (result instanceof Error) {
+        // The child never started (spawn errors precede any output of its own).
+        return startFailed(self, result);
+    }
+    if (result.signal) {
+        // Exit the way the child did, so callers see the same signal.
+        process.kill(process.pid, result.signal);
+        return true;
+    }
+    process.exit(result.code ?? 1);
+}
+//# sourceMappingURL=project-cli.js.map

package/dist/services/project-cli.js.map

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

package/dist/services/project-parser.d.ts

@@ -26,6 +26,11 @@ type ProjectParseOpts = {
     loadPlaywrightChecksOnly?: boolean;
     warnOnWebServerConfig?: boolean;
     enableWorkspaces?: boolean;
+    /**
+     * Warn about checks that have no location to run on. Only meaningful for
+     * commands that deploy the project, or validate it for deployment.
+     */
+    warnOnMissingCheckLocations?: boolean;
 };
 export declare function parseProject(opts: ProjectParseOpts): Promise<Project>;
 export {};