checkly 9.5.0 → 10.0.0-rc.1

package/dist/services/deploy-diff/render.js

@@ -0,0 +1,317 @@
+import { randomUUID } from 'node:crypto';
+import { ConstructCodegen } from '../../constructs/construct-codegen.js';
+import { Context, renderConstruct } from '../../constructs/internal/codegen/index.js';
+import { Program } from '../../sourcegen/index.js';
+import { blankRedacted, carriesMarker, fillUnchangedFromBefore, isMaskedMarker, markChanged, MASK, nodeAt, pointerSegments, UNRENDERED_KEYS, registerProject, registerUnderCodeName, relationResourcesForAfter, relationResourcesFromBefore, toImportResource, UnshapeableError, } from './import-shape.js';
+import { isShapeChangePath } from './shape-changes.js';
+import { diffLines } from './diff-lines.js';
+const note = (text) => ({ kind: 'note', text });
+/** The line with its text transformed, whichever kind it is. */
+function mapText(line, fn) {
+    if (line.kind === 'nested') {
+        return { kind: 'nested', line: { ...line.line, text: fn(line.line.text) } };
+    }
+    return { ...line, text: fn(line.text) };
+}
+const textOf = (line) => line.kind === 'nested' ? line.line.text : line.text;
+const INLINE_VALUE_CAP = 256;
+/**
+ * Properties a codegen writes to a file of its own rather than into the
+ * construct — a browser or multi-step check's script to a spec file, an API
+ * check's setup and teardown scripts to support files, a dashboard's CSS to
+ * a style file — leaving an `entrypoint` path behind. A change to one is
+ * invisible in the construct diff and is shown as a text diff of its own,
+ * whether or not the constructs differ too.
+ */
+const OUTSIDE_CONSTRUCT = {
+    check: new Set(['/script', '/localSetupScript', '/localTearDownScript']),
+    dashboard: new Set(['/customCSS']),
+};
+function isOutsideConstruct(type, path) {
+    return OUTSIDE_CONSTRUCT[type]?.has(path) ?? false;
+}
+/**
+ * Whether a redaction rule reaches the path a secret change names: the two
+ * agree segment for segment as far as the shorter goes, a rule's `*` standing
+ * for any one segment. A rule under the path blanks inside the list the
+ * change reports whole; a rule above it blanks the object that holds it.
+ */
+function ruleReaches(rulePath, changePath) {
+    const rule = pointerSegments(rulePath);
+    const change = pointerSegments(changePath);
+    const shared = Math.min(rule.length, change.length);
+    for (let index = 0; index < shared; index += 1) {
+        if (rule[index] !== '*' && rule[index] !== change[index]) {
+            return false;
+        }
+    }
+    return true;
+}
+function isHash(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) && '$hash' in value;
+}
+/** A marker spelled the way the construct prints it. */
+const spellMarker = (_key, member) => (isMaskedMarker(member) ? (member.$masked === 'changed' ? `${MASK} (changed)` : MASK) : member);
+function inline(value) {
+    if (value === undefined) {
+        return '(absent)';
+    }
+    if (isHash(value)) {
+        return '(content)';
+    }
+    const text = JSON.stringify(value, spellMarker);
+    return text.length > INLINE_VALUE_CAP ? `${text.slice(0, INLINE_VALUE_CAP)}…` : text;
+}
+/** The value at an RFC 6901 pointer, or undefined when the path does not resolve. */
+const valueAt = (root, pointer) => nodeAt(root, pointerSegments(pointer));
+function originNote(change) {
+    switch (change.origin) {
+        case 'remote':
+            return ' (changed in Checkly, overwritten by this deploy)';
+        case 'both':
+            return ' (also changed in Checkly, overwritten by this deploy)';
+        case 'unmanaged':
+            return ' (not managed by this project)';
+        default:
+            return '';
+    }
+}
+/** One change as a line of the listing: path, values, and where it came from. */
+function listChange(change) {
+    if (change.cause !== undefined) {
+        return `${change.path}: changed (${change.cause})${originNote(change)}`;
+    }
+    return `${change.path}: ${inline(change.before)} -> ${inline(change.after)}${originNote(change)}`;
+}
+function listing(changes, reason) {
+    const lines = reason === undefined ? [] : [{ kind: 'reason', text: `(${reason})` }];
+    for (const change of changes) {
+        lines.push(note(listChange(change)));
+    }
+    return lines;
+}
+/**
+ * The import codegen, with the rendered construct's own variable named as in
+ * the user's code, or else after its logical id, on both sides.
+ */
+class SideCodegen extends ConstructCodegen {
+    variableNames;
+    constructor(program, variableNames) {
+        super(program);
+        this.variableNames = variableNames;
+    }
+    prepare(logicalId, resource, context) {
+        super.prepare(logicalId, resource, context);
+        registerUnderCodeName(context, resource, this.variableNames);
+    }
+}
+/** A side of the comparison rendered to source text, with its relations registered first. */
+function renderSide(resource, relations, project, ids, maskedValues, variableNames, spelledOut) {
+    const program = new Program({
+        rootDirectory: '.',
+        constructFileSuffix: '.check',
+        specFileSuffix: '.spec',
+        language: 'typescript',
+    });
+    const context = new Context({ maskedValues, spelledOut });
+    const codegen = new SideCodegen(program, variableNames);
+    registerProject(context, program, project, ids, variableNames);
+    for (const relation of relations) {
+        codegen.prepare(relation.logicalId, relation, context);
+    }
+    return renderConstruct(codegen, resource.logicalId, resource, { context });
+}
+/**
+ * The text diff of a change whose values are content (a script, a body): the
+ * deployed text read from `before` at the same pointer, the local text from
+ * the local payload. Either side missing means the pointer is spelled
+ * differently in the two vocabularies, and only the fact is reported.
+ */
+function contentDiff(change, before, local, maxLines) {
+    const deployed = valueAt(before, change.path);
+    const current = valueAt(local, change.path);
+    if (typeof deployed !== 'string' || typeof current !== 'string') {
+        return [note(`${change.path}: content changed${originNote(change)}`)];
+    }
+    const lines = diffLines(deployed, current, { maxLines });
+    if (lines === undefined) {
+        return [note(`${change.path}: content changed (too large to show)${originNote(change)}`)];
+    }
+    const nested = lines.map((line) => ({ kind: 'nested', line }));
+    return [note(`${change.path}:${originNote(change)}`), ...nested];
+}
+export function renderResourceDiff(input) {
+    const { entry, local, localResources, diff, project, ids, ...options } = input;
+    const { pruneRelations, variableNames, spelledOut, maxLines } = options;
+    const lines = [];
+    const changes = entry.changes ?? [];
+    // A secret is shown inline, masked, with `(changed)` on the element the
+    // report marks; a secret change whose mark could not be placed (no
+    // markers reported, an element the payload does not hold, a position the
+    // rules blank to null) is named after the block instead, so a secret's
+    // movement is visible exactly once. The block is rendered for a secret
+    // change even when nothing else is reported, since the API reports the
+    // list holding a moved secret whole, plain siblings' edits included.
+    const shown = changes.filter(change => change.secret !== true);
+    const marked = new Set();
+    try {
+        lines.push(...renderShown(shown, marked, entry, local, localResources, diff, project, ids, { pruneRelations, variableNames, spelledOut, maxLines }));
+    }
+    catch (cause) {
+        // A payload this CLI cannot shape like an import resource, a codegen that
+        // does not cover the type, a script it cannot
+        // parse, a construct it refuses: the listing says what changed even when
+        // the rendering cannot.
+        const reason = cause instanceof UnshapeableError
+            ? cause.message
+            : `could not render this resource: ${cause instanceof Error ? cause.message : cause}`;
+        if (shown.length > 0) {
+            lines.push(...listing(shown, reason));
+        }
+    }
+    for (const change of changes) {
+        if (change.secret !== true) {
+            continue;
+        }
+        if (!marked.has(change)) {
+            lines.push(note(`secret changed: ${change.path}${originNote(change)}`));
+        }
+        else if (originNote(change) !== '') {
+            // The inline mark says which secret moved; the note says the deploy overwrites it.
+            lines.push(note(`${change.path}:${originNote(change)}`));
+        }
+    }
+    return lines;
+}
+/** The reported side a mark is read from: the local side follows the code's movement, the deployed side the backend's. */
+function reportedFor(change, side) {
+    if (side === 'local') {
+        return change.origin === 'code' || change.origin === 'both' ? change.after : undefined;
+    }
+    return change.origin === 'both' ? change.remote?.after : change.origin === 'remote' ? change.after : undefined;
+}
+function renderShown(shown, marked, entry, local, localResources, diff, project, ids, options) {
+    const { pruneRelations, variableNames, spelledOut, maxLines } = options;
+    // A secret change withholds the list it is in whole, plain siblings' edits
+    // included, so the construct diff — both sides blanked — is the only place
+    // such an edit shows: an entry with a secret change is rendered even when
+    // nothing else is reported, and a cause alone does not stand in for it.
+    // Rendered only when a reported rule reaches every secret's path, though:
+    // the local side's blanks come from that table, and a gap in it must not
+    // print what the API withheld.
+    const secrets = (entry.changes ?? []).filter(change => change.secret === true);
+    const withSecrets = secrets.length > 0;
+    if (shown.length === 0 && !withSecrets) {
+        return [];
+    }
+    if (!withSecrets && shown.every(change => change.cause !== undefined)) {
+        return [note(`changed: ${[...new Set(shown.map(change => change.cause))].join(', ')}`)];
+    }
+    // A change that is secret or carries a marker (a reorder of a list holding
+    // one) is rendered only when a reported rule reaches its path.
+    const guarded = (entry.changes ?? []).filter(change => change.secret === true
+        || carriesMarker(change.before) || carriesMarker(change.after) || carriesMarker(change.remote));
+    if (!guarded.every(change => (entry.redactions ?? []).some(rule => ruleReaches(rule.path, change.path)))) {
+        return listing(shown);
+    }
+    if (entry.before === undefined || local === undefined || local.payload === null || local.payload === undefined) {
+        return listing(shown);
+    }
+    const { type, logicalId } = entry;
+    // The deployed side is the import format already, straight from the API,
+    // less what neither side renders — dropped before the local side is filled
+    // from it, so the fill cannot copy it across.
+    const before = { ...entry.before };
+    for (const key of UNRENDERED_KEYS) {
+        delete before[key];
+    }
+    // Both sides masked by the same rules; the deployed side arrives blanked.
+    // A copy, since the marks are written in place and `entry.before` is
+    // read again for relations and text diffs.
+    const deployed = {
+        type: type,
+        logicalId,
+        payload: blankRedacted(structuredClone(before), entry.redactions),
+    };
+    // Shaped first, then filled with what the deploy leaves as it is, masked
+    // last: the rules are spelled in the import format's vocabulary, which is
+    // what the shaped payload is in.
+    const shaped = toImportResource(deployed.type, logicalId, local.payload, ids);
+    fillUnchangedFromBefore(shaped.payload, before, entry.changes ?? []);
+    const after = { ...shaped, payload: blankRedacted(shaped.payload, entry.redactions) };
+    // Then the marks: the element whose secret moved reads `(changed)` on the
+    // side that moved it, so the diff names the secret beside its key. Each
+    // change writes its own sentinel, unguessable by any value the account or
+    // the code could hold, so only a change whose sentinel reached the returned
+    // lines counts as marked; the sentinels read `(changed)` in the output.
+    // The codegen prints a secret only as one of these strings. The two labels
+    // end alike (`#<nonce>-<index>)`): a codegen that names a file or variable
+    // after the tail of a credential (an unnamed Slack or PagerDuty channel
+    // takes the last four characters of its URL or key) then derives the same
+    // name on both sides, and the diff stays free of a spurious rename.
+    const nonce = randomUUID();
+    const sentinels = new Map();
+    secrets.forEach((change, index) => {
+        const localLabel = `${MASK} (changed#${nonce}-${index})`;
+        const deployedLabel = `${MASK} (changed in Checkly#${nonce}-${index})`;
+        const onLocal = markChanged(after.payload, change.path, reportedFor(change, 'local'), localLabel);
+        const onDeployed = markChanged(deployed.payload, change.path, reportedFor(change, 'deployed'), deployedLabel);
+        if (onLocal || onDeployed) {
+            sentinels.set(change, { local: localLabel, deployed: deployedLabel });
+        }
+    });
+    const maskedValues = new Set([MASK, ...[...sentinels.values()].flatMap(pair => [pair.local, pair.deployed])]);
+    const showing = (lines) => {
+        for (const [change, pair] of sentinels) {
+            if (lines.some(line => textOf(line).includes(pair.local) || textOf(line).includes(pair.deployed))) {
+                marked.add(change);
+            }
+        }
+        const sentinel = new RegExp(` \\(changed( in Checkly)?#${nonce}-\\d+\\)`, 'g');
+        return lines.map(line => mapText(line, text => text.replace(sentinel, ' (changed$1)')));
+    };
+    const afterRelations = relationResourcesForAfter({ ids, local: localResources, entry, diff, pruneRelations });
+    const beforeRelations = relationResourcesFromBefore(type, entry.before);
+    const beforeText = renderSide(deployed, beforeRelations, project, ids, maskedValues, variableNames, spelledOut);
+    const afterText = renderSide(after, afterRelations, project, ids, maskedValues, variableNames, spelledOut);
+    const rendered = diffLines(beforeText, afterText, { maxLines });
+    if (rendered === undefined) {
+        return shown.length > 0 ? listing(shown, 'the construct diff is too large to show') : [];
+    }
+    if (rendered.length > 0) {
+        // The constructs differ. What they cannot show follows: a property kept
+        // in a file of its own as a text diff, and a change that is only a cause
+        // (a new code bundle, a dependency list) as a line.
+        const lines = [...rendered];
+        for (const change of shown) {
+            if (isOutsideConstruct(type, change.path)) {
+                lines.push(...contentDiff(change, entry.before, local.payload, maxLines));
+            }
+            else if (change.cause !== undefined) {
+                lines.push(note(listChange(change)));
+            }
+        }
+        return showing(lines);
+    }
+    // The renderings agree. When every change is a known shape change, that is
+    // the CLI upgrade spelling the same construct differently; the paths alone
+    // cannot tell an upgrade from a user editing the same property, so a real
+    // edit shows up as construct lines above and never gets here.
+    if (shown.length > 0 && shown.every(change => change.origin === 'code' && isShapeChangePath(change.path))) {
+        return [note('payload format changed (CLI upgrade)')];
+    }
+    // Otherwise what changed lives outside the construct (a script in its own
+    // file, a request body), or is a value the codegen elides.
+    const lines = [];
+    for (const change of shown) {
+        const hashed = isHash(change.before) || isHash(change.after) || isHash(change.remote?.after);
+        if (hashed || isOutsideConstruct(type, change.path)) {
+            lines.push(...contentDiff(change, entry.before, local.payload, maxLines));
+        }
+        else {
+            lines.push(note(listChange(change)));
+        }
+    }
+    return lines;
+}
+//# sourceMappingURL=render.js.map

package/dist/services/deploy-diff/render.js.map

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

package/dist/services/deploy-diff/shape-changes.d.ts

@@ -0,0 +1,2 @@
+/** Whether a reported change path is one of the known shape changes, or lies under one. */
+export declare function isShapeChangePath(path: string): boolean;

package/dist/services/deploy-diff/shape-changes.js

@@ -0,0 +1,35 @@
+/**
+ * Leaf paths whose difference is a CLI upgrade changing how a payload is
+ * spelled, not a user editing a construct: private locations moving from an
+ * inline list to assignment resources, `doubleCheck` becoming a retry
+ * strategy, alert settings and parallel scheduling moving to the v2 group
+ * defaults. After such an upgrade every affected resource reports a
+ * code-origin change once and rewrites its snapshot; rather than render a
+ * property diff of two spellings of the same thing, the preview says so.
+ *
+ * An enumerated list, extended with each shape change. It carries no copy of
+ * any backend default: membership is by path alone, which is why the
+ * renderer consults it only once the two renderings agree — a user editing
+ * one of these properties differs in the construct, and prints as that.
+ */
+const SHAPE_CHANGE_PATHS = new Set([
+    '/privateLocations',
+    '/doubleCheck',
+    '/retryStrategy',
+    '/alertSettings',
+    '/useGlobalAlertSettings',
+    '/runParallel',
+]);
+/** Whether a reported change path is one of the known shape changes, or lies under one. */
+export function isShapeChangePath(path) {
+    if (SHAPE_CHANGE_PATHS.has(path)) {
+        return true;
+    }
+    for (const known of SHAPE_CHANGE_PATHS) {
+        if (path.startsWith(`${known}/`)) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=shape-changes.js.map

package/dist/services/deploy-diff/shape-changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-changes.js","sourceRoot":"","sources":["../../../src/services/deploy-diff/shape-changes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC;IACtD,mBAAmB;IACnB,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,yBAAyB;IACzB,cAAc;CACf,CAAC,CAAA;AAEF,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAAE,IAAY;IAC7C,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAA;IACb,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,kBAAkB,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/services/deploy-diff/source-index.d.ts

@@ -0,0 +1,18 @@
+import type { TSESTree } from '@typescript-eslint/typescript-estree';
+import type { Construct } from '../../constructs/construct.js';
+import { type ParsedSource } from '../write-back/source-file.js';
+/**
+ * The project's source files as the deploy plan reads them, each parsed
+ * once however many constructs it declares. Everything here is best effort:
+ * a file that cannot be read or parsed, or a construct whose declaration
+ * cannot be found in it, yields `undefined`, and the plan renders without
+ * what the source would have told it.
+ */
+export declare class SourceIndex {
+    #private;
+    source(filePath: string): ParsedSource | undefined;
+    /** The options literal of the construct's `new <Class>('<logicalId>', { … })` in the file that declares it. */
+    options(construct: Construct): TSESTree.ObjectExpression | undefined;
+    /** The properties the construct's declaration spells out (`ContextOptions.spelledOut`), when it can be read. */
+    spelledOut(construct: Construct): ReadonlySet<string> | undefined;
+}

package/dist/services/deploy-diff/source-index.js

@@ -0,0 +1,48 @@
+import fs from 'node:fs';
+import { exportedNamesOf, findConstructOptions, parseSource, spelledOutPaths, WriteBackSkipped, } from '../write-back/source-file.js';
+/**
+ * The project's source files as the deploy plan reads them, each parsed
+ * once however many constructs it declares. Everything here is best effort:
+ * a file that cannot be read or parsed, or a construct whose declaration
+ * cannot be found in it, yields `undefined`, and the plan renders without
+ * what the source would have told it.
+ */
+export class SourceIndex {
+    #sources = new Map();
+    source(filePath) {
+        if (!this.#sources.has(filePath)) {
+            let source;
+            try {
+                source = parseSource(filePath, fs.readFileSync(filePath, 'utf8'));
+            }
+            catch {
+                // A file that cannot be read or parsed tells nothing.
+            }
+            this.#sources.set(filePath, source);
+        }
+        return this.#sources.get(filePath);
+    }
+    /** The options literal of the construct's `new <Class>('<logicalId>', { … })` in the file that declares it. */
+    options(construct) {
+        const filePath = construct.checkFileAbsolutePath;
+        const source = filePath !== undefined ? this.source(filePath) : undefined;
+        if (source === undefined) {
+            return undefined;
+        }
+        try {
+            return findConstructOptions(source, construct.logicalId, exportedNamesOf(construct));
+        }
+        catch (err) {
+            if (err instanceof WriteBackSkipped) {
+                return undefined;
+            }
+            throw err;
+        }
+    }
+    /** The properties the construct's declaration spells out (`ContextOptions.spelledOut`), when it can be read. */
+    spelledOut(construct) {
+        const options = this.options(construct);
+        return options === undefined ? undefined : spelledOutPaths(options);
+    }
+}
+//# sourceMappingURL=source-index.js.map

package/dist/services/deploy-diff/source-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-index.js","sourceRoot":"","sources":["../../../src/services/deploy-diff/source-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AAKxB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,WAAW,EAEX,eAAe,EACf,gBAAgB,GACjB,MAAM,8BAA8B,CAAA;AAErC;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IACb,QAAQ,GAAG,IAAI,GAAG,EAAoC,CAAA;IAE/D,MAAM,CAAE,QAAgB;QACtB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjC,IAAI,MAAgC,CAAA;YACpC,IAAI,CAAC;gBACH,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAA;YACnE,CAAC;YAAC,MAAM,CAAC;gBACP,sDAAsD;YACxD,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QACrC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACpC,CAAC;IAED,+GAA+G;IAC/G,OAAO,CAAE,SAAoB;QAC3B,MAAM,QAAQ,GAAG,SAAS,CAAC,qBAAqB,CAAA;QAChD,MAAM,MAAM,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACzE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,IAAI,CAAC;YACH,OAAO,oBAAoB,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC,CAAA;QACtF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,gBAAgB,EAAE,CAAC;gBACpC,OAAO,SAAS,CAAA;YAClB,CAAC;YACD,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;IAED,gHAAgH;IAChH,UAAU,CAAE,SAAoB;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QACvC,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IACrE,CAAC;CACF"}

package/dist/services/deploy-diff/variable-names.d.ts

@@ -0,0 +1,30 @@
+import type { Project } from '../../constructs/project.js';
+import { type ConstructExport } from '../../constructs/session.js';
+import { SourceIndex } from './source-index.js';
+/** The variable each construct goes by in the user's code, keyed like `PhysicalIds` (`idKey`). */
+export type VariableNames = ReadonlyMap<string, string>;
+/**
+ * The name each referenceable construct of the project (a group, an alert
+ * channel, a private location, a status page and its parts) has in the
+ * user's code, so a deploy preview refers to it the way the code does rather
+ * than by a name generated from its logical id.
+ *
+ * The name the file that creates the construct exports it by comes first: it
+ * is what another file imports the construct by, and it is known however the
+ * construct was made. A file that exports the construct by several names
+ * settles it with the one its declaration uses. Check files are the only
+ * files whose exports are seen, so for the rest (a construct declared in a
+ * shared module, or one that is not exported) the name is read from the
+ * declaration in the file that creates the construct. An export from some
+ * other check file, which passes the construct on under a name of its own,
+ * comes last. A construct with none of these is left out and keeps its
+ * generated name.
+ *
+ * The name is the one where the construct is made. A file that imports the
+ * construct under an alias, or reaches it through a namespace, still calls
+ * it something else. And two constructs that go by the same name in
+ * different files cannot both have it in one rendered construct: the second
+ * one registered gets a counter (`group`, `group2`), the same on both sides
+ * of a comparison.
+ */
+export declare function constructVariableNames(project: Project, exports?: readonly ConstructExport[], sources?: SourceIndex): VariableNames;

package/dist/services/deploy-diff/variable-names.js

@@ -0,0 +1,64 @@
+import { Session } from '../../constructs/session.js';
+import { exportedNamesOf, findConstructVariable, IDENTIFIER } from '../write-back/source-file.js';
+import { idKey, REFERENCEABLE_TYPES } from './import-shape.js';
+import { SourceIndex } from './source-index.js';
+/**
+ * The name each referenceable construct of the project (a group, an alert
+ * channel, a private location, a status page and its parts) has in the
+ * user's code, so a deploy preview refers to it the way the code does rather
+ * than by a name generated from its logical id.
+ *
+ * The name the file that creates the construct exports it by comes first: it
+ * is what another file imports the construct by, and it is known however the
+ * construct was made. A file that exports the construct by several names
+ * settles it with the one its declaration uses. Check files are the only
+ * files whose exports are seen, so for the rest (a construct declared in a
+ * shared module, or one that is not exported) the name is read from the
+ * declaration in the file that creates the construct. An export from some
+ * other check file, which passes the construct on under a name of its own,
+ * comes last. A construct with none of these is left out and keeps its
+ * generated name.
+ *
+ * The name is the one where the construct is made. A file that imports the
+ * construct under an alias, or reaches it through a namespace, still calls
+ * it something else. And two constructs that go by the same name in
+ * different files cannot both have it in one rendered construct: the second
+ * one registered gets a counter (`group`, `group2`), the same on both sides
+ * of a comparison.
+ */
+export function constructVariableNames(project, exports = Session.constructExports, sources = new SourceIndex()) {
+    const names = new Map();
+    for (const type of REFERENCEABLE_TYPES) {
+        for (const [logicalId, construct] of Object.entries(project.data[type])) {
+            // A reference construct (`fromId(...)`) is rendered as the reference it is.
+            if (construct.member === false) {
+                continue;
+            }
+            const declaredIn = construct.checkFileAbsolutePath;
+            const exported = exports
+                .filter(candidate => candidate.type === type && candidate.logicalId === logicalId
+                && candidate.exportName !== 'default' && IDENTIFIER.test(candidate.exportName));
+            const own = exported.filter(candidate => candidate.filePath === declaredIn).map(({ exportName }) => exportName);
+            const declared = () => {
+                const source = declaredIn !== undefined ? sources.source(declaredIn) : undefined;
+                return source && findConstructVariable(source, logicalId, exportedNamesOf(construct));
+            };
+            let name;
+            if (own.length === 1) {
+                name = own[0];
+            }
+            else if (own.length > 1) {
+                const variable = declared();
+                name = variable !== undefined && own.includes(variable) ? variable : own[0];
+            }
+            else {
+                name = declared() ?? exported[0]?.exportName;
+            }
+            if (name !== undefined) {
+                names.set(idKey(type, logicalId), name);
+            }
+        }
+    }
+    return names;
+}
+//# sourceMappingURL=variable-names.js.map

package/dist/services/deploy-diff/variable-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-names.js","sourceRoot":"","sources":["../../../src/services/deploy-diff/variable-names.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AACjG,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAK/C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAgB,EAChB,UAAsC,OAAO,CAAC,gBAAgB,EAC9D,UAAuB,IAAI,WAAW,EAAE;IAExC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvC,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACxE,4EAA4E;YAC5E,IAAI,SAAS,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;gBAC/B,SAAQ;YACV,CAAC;YACD,MAAM,UAAU,GAAG,SAAS,CAAC,qBAAqB,CAAA;YAClD,MAAM,QAAQ,GAAG,OAAO;iBACrB,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS;mBAC5E,SAAS,CAAC,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAA;YACnF,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,CAAA;YAC/G,MAAM,QAAQ,GAAG,GAAG,EAAE;gBACpB,MAAM,MAAM,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;gBAChF,OAAO,MAAM,IAAI,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC,CAAA;YACvF,CAAC,CAAA;YACD,IAAI,IAAwB,CAAA;YAC5B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrB,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;YACf,CAAC;iBAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAG,QAAQ,EAAE,CAAA;gBAC3B,IAAI,GAAG,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAC7E,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,QAAQ,EAAE,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,CAAA;YAC9C,CAAC;YACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAA;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

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 {};