checkly 9.5.0 → 10.0.0-prerelease-4f88d60

package/dist/services/write-back/helper-edit.js

@@ -0,0 +1,343 @@
+import { hasEscalationPolicy, valueForAlertEscalation } from '../../constructs/alert-escalation-policy-codegen.js';
+import { valueForAssertion } from '../../constructs/api-assertion-codegen.js';
+import { valueForDnsAssertion } from '../../constructs/dns-assertion-codegen.js';
+import { valueForFrequency } from '../../constructs/frequency-codegen.js';
+import { valueForGrpcAssertion } from '../../constructs/grpc-assertion-codegen.js';
+import { valueForIcmpAssertion } from '../../constructs/icmp-assertion-codegen.js';
+import { valueForDate } from '../../constructs/maintenance-window-codegen.js';
+import { valueForRetryStrategy } from '../../constructs/retry-strategy-codegen.js';
+import { valueForSslAssertion } from '../../constructs/ssl-assertion-codegen.js';
+import { valueForTcpAssertion } from '../../constructs/tcp-monitor-codegen.js';
+import { valueForTracerouteAssertion } from '../../constructs/traceroute-assertion-codegen.js';
+import { valueForUrlAssertion } from '../../constructs/url-assertion-codegen.js';
+import { ArgumentsValue, ArrayValue, BooleanValue, CallExpressionValue, GeneratedFile, IdentifierValue, MemberExpressionValue, NewExpressionValue, NullValue, NumberValue, ObjectValue, sortObjectPropertiesByOrderAndName, StringValue, UndefinedValue, } from '../../sourcegen/index.js';
+import { isPlainLiteral, layoutList, quoteString, renderKey } from './literal-edit.js';
+import { memberName, WriteBackSkipped } from './source-file.js';
+/** The codegen for each assertion builder a monitor class spells its assertions with. */
+const ASSERTION_CODEGENS = {
+    AssertionBuilder: valueForAssertion,
+    UrlAssertionBuilder: valueForUrlAssertion,
+    TcpAssertionBuilder: valueForTcpAssertion,
+    DnsAssertionBuilder: valueForDnsAssertion,
+    GrpcAssertionBuilder: valueForGrpcAssertion,
+    SslAssertionBuilder: valueForSslAssertion,
+    IcmpAssertionBuilder: valueForIcmpAssertion,
+    TracerouteAssertionBuilder: valueForTracerouteAssertion,
+};
+/** The names of every assertion builder: each spells the same property, so a file may hold any of them. */
+export const ASSERTION_BUILDERS = Object.keys(ASSERTION_CODEGENS);
+export function isHelperEdit(edit) {
+    return edit.helper !== undefined;
+}
+const HELPER_CLASSES = {
+    frequency: 'Frequency',
+    retryStrategy: 'RetryStrategyBuilder',
+    alertEscalation: 'AlertEscalationBuilder',
+    date: 'Date',
+};
+/** The class the edit's expression is built on, as `checkly/constructs` exports it, or the global `Date`. */
+export function helperClass(edit) {
+    return edit.helper === 'assertions' ? edit.builder : HELPER_CLASSES[edit.helper];
+}
+/** Whether the edit's class is a global every file binds, rather than one imported from `checkly/constructs`. */
+export function isGlobalHelper(edit) {
+    return edit.helper === 'date';
+}
+/**
+ * A `GeneratedFile` that only remembers which names the codegen asked to
+ * import. The names are added to the file's `checkly/constructs` import, so
+ * a codegen asking for anything else cannot be written.
+ */
+class ImportSink extends GeneratedFile {
+    names = [];
+    constructor() {
+        super('write-back.ts');
+    }
+    namedImport(identifier, from, options) {
+        if (from !== 'checkly/constructs' || options?.alias !== undefined) {
+            throw new WriteBackSkipped(`${identifier} is not a class checkly/constructs exports`);
+        }
+        if (!this.names.includes(identifier)) {
+            this.names.push(identifier);
+        }
+        super.namedImport(identifier, from, options);
+    }
+}
+/** The errors of a `cause` chain, outermost first: the codegen wraps each failure in another. */
+function causes(err) {
+    const chain = [];
+    for (let current = err; current !== undefined; current = current instanceof Error ? current.cause : undefined) {
+        chain.push(current);
+    }
+    return chain;
+}
+/** The classes an expression references: the identifiers its member and call chains are rooted at. */
+function referencedClasses(value, names = new Set()) {
+    if (value instanceof IdentifierValue) {
+        names.add(value.value);
+    }
+    else if (value instanceof MemberExpressionValue) {
+        referencedClasses(value.object, names);
+    }
+    else if (value instanceof CallExpressionValue || value instanceof NewExpressionValue) {
+        referencedClasses(value.callee, names);
+        referencedClasses(value.args, names);
+    }
+    else if (value instanceof ArgumentsValue || value instanceof ArrayValue) {
+        value.value.forEach(member => referencedClasses(member, names));
+    }
+    else if (value instanceof ObjectValue) {
+        value.value.forEach(property => referencedClasses(property.value, names));
+    }
+    return names;
+}
+/**
+ * The expression the codegen builds for the edit's value, and the classes
+ * it references (those the codegen asked to import and the expression
+ * names: a gRPC assertion the builder cannot spell comes back as a plain
+ * object, which needs no import). The value is what the account holds, in
+ * the import format `entry.before` carries.
+ *
+ * @throws WriteBackSkipped for a value the codegen cannot spell (an
+ * assertion source or retry type this CLI does not know, a malformed row)
+ * or one that means "unset", which is never written because nothing is
+ * ever removed from the code.
+ */
+export function buildHelperValue(edit, spelledOut = []) {
+    const at = edit.path.join('.');
+    const missing = () => new WriteBackSkipped(`Checkly has no value for ${at}; edit the property by hand`);
+    const sink = new ImportSink();
+    let value;
+    try {
+        switch (edit.helper) {
+            case 'frequency': {
+                const schedule = typeof edit.value === 'number'
+                    ? { frequency: edit.value }
+                    : edit.value;
+                if (typeof schedule?.frequency !== 'number') {
+                    throw missing();
+                }
+                value = valueForFrequency(sink, {
+                    frequency: schedule.frequency,
+                    frequencyOffset: typeof schedule.frequencyOffset === 'number' ? schedule.frequencyOffset : undefined,
+                });
+                break;
+            }
+            case 'retryStrategy': {
+                // A row holds null for no retries; anything else is a strategy of a type.
+                const strategy = edit.value;
+                if (strategy !== null && typeof strategy?.type !== 'string') {
+                    throw missing();
+                }
+                value = valueForRetryStrategy(sink, strategy, spelledOut);
+                break;
+            }
+            case 'alertEscalation':
+                // A v2 group on the global policy spells it as the word 'global';
+                // the column holds `{}` for a check that never set a policy of its own.
+                if (edit.value === 'global') {
+                    value = new StringValue('global');
+                    break;
+                }
+                if (!hasEscalationPolicy(edit.value)) {
+                    throw missing();
+                }
+                value = valueForAlertEscalation(sink, edit.value);
+                break;
+            case 'date': {
+                // The account reports a timestamp as an ISO string; the construct
+                // takes a Date, which the import spells as `new Date('<iso>')`.
+                if (typeof edit.value !== 'string' || Number.isNaN(Date.parse(edit.value))) {
+                    throw missing();
+                }
+                value = valueForDate(edit.value);
+                break;
+            }
+            case 'assertions': {
+                const codegen = ASSERTION_CODEGENS[edit.builder];
+                if (codegen === undefined) {
+                    throw new WriteBackSkipped(`${edit.builder} is not an assertion builder this tool knows`);
+                }
+                if (!Array.isArray(edit.value) || !edit.value.every(isRecord)) {
+                    throw missing();
+                }
+                value = new ArrayValue(edit.value.map(assertion => codegen(sink, assertion)));
+                break;
+            }
+        }
+    }
+    catch (err) {
+        const chain = causes(err);
+        const skipped = chain.find(cause => cause instanceof WriteBackSkipped);
+        if (skipped !== undefined) {
+            throw skipped;
+        }
+        // The codegens refuse what they cannot spell with a plain `Error`
+        // (`Unsupported …`, `… cannot be null`), wrapped by the builders; a
+        // `TypeError` or the like is a defect of this CLI and stays one.
+        const cause = chain[chain.length - 1];
+        if (cause instanceof Error && cause.constructor === Error) {
+            throw new WriteBackSkipped(`Checkly reported a value this CLI cannot spell: ${cause.message}`);
+        }
+        throw err;
+    }
+    const referenced = referencedClasses(value);
+    return { value, imports: sink.names.filter(name => referenced.has(name)) };
+}
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/**
+ * Whether `node` is an expression built on one of `locals` (the names the
+ * file binds the helper class to): a member, call or `new` chain rooted at
+ * such a name, with every argument a literal (see `isReplaceableByHelper`),
+ * `undefined`, or such a chain. Replacing it loses nothing the user wrote
+ * by hand.
+ */
+export function isHelperExpression(node, locals) {
+    const argument = (arg) => arg.type !== 'SpreadElement'
+        && ((arg.type === 'Identifier' && arg.name === 'undefined') || isReplaceableByHelper(arg, locals));
+    switch (node.type) {
+        case 'Identifier':
+            return locals.has(node.name);
+        case 'MemberExpression':
+            return !node.computed && node.property.type === 'Identifier' && isHelperExpression(node.object, locals);
+        case 'CallExpression':
+        case 'NewExpression':
+            return isHelperExpression(node.callee, locals) && node.arguments.every(argument);
+        default:
+            return false;
+    }
+}
+/**
+ * Whether `node` can be replaced by a helper edit without losing anything
+ * written by hand: a plain literal, `null` (the edit writes an expression,
+ * not null, and the codegen spells an assertion it has no builder method
+ * for as an object holding `regex: null`), a helper expression, or an
+ * array or object built only of those.
+ */
+export function isReplaceableByHelper(node, locals) {
+    if (isPlainLiteral(node) || isHelperExpression(node, locals) || (node.type === 'Literal' && node.value === null)) {
+        return true;
+    }
+    if (node.type === 'ArrayExpression') {
+        return node.elements.every(element => element !== null && element.type !== 'SpreadElement' && isReplaceableByHelper(element, locals));
+    }
+    if (node.type === 'ObjectExpression') {
+        return node.properties.every(property => memberName(property) !== undefined
+            && !property.shorthand
+            && isReplaceableByHelper(property.value, locals));
+    }
+    return false;
+}
+/**
+ * The source text of a sourcegen expression in the file's style. Objects
+ * keep the order the codegen gave them (its own sorter), so the text is
+ * the one `checkly import` would print, reindented and requoted.
+ *
+ * @throws WriteBackSkipped for a value class the codegen never produces for
+ * these properties and this renderer does not spell.
+ */
+export function renderExpression(value, style, layout) {
+    const inner = layout.column + style.indentUnit;
+    const nested = (member) => renderExpression(member, style, { ...layout, column: inner });
+    if (value instanceof IdentifierValue) {
+        return layout.locals.get(value.value) ?? value.value;
+    }
+    if (value instanceof MemberExpressionValue) {
+        return `${renderExpression(value.object, style, layout)}.${renderExpression(value.property, style, layout)}`;
+    }
+    if (value instanceof CallExpressionValue) {
+        return `${renderExpression(value.callee, style, layout)}${renderExpression(value.args, style, layout)}`;
+    }
+    if (value instanceof NewExpressionValue) {
+        return `new ${renderExpression(value.callee, style, layout)}${renderExpression(value.args, style, layout)}`;
+    }
+    if (value instanceof ArgumentsValue) {
+        return `(${value.value.map(arg => renderExpression(arg, style, layout)).join(', ')})`;
+    }
+    if (value instanceof StringValue) {
+        return quoteString(value.value, style.quote);
+    }
+    if (value instanceof NumberValue) {
+        if (!Number.isFinite(value.value)) {
+            throw new WriteBackSkipped(`${value.value} cannot be written as a literal`);
+        }
+        return String(value.value);
+    }
+    if (value instanceof BooleanValue) {
+        return String(value.value);
+    }
+    if (value instanceof UndefinedValue) {
+        return 'undefined';
+    }
+    if (value instanceof NullValue) {
+        return 'null';
+    }
+    if (value instanceof ArrayValue) {
+        return layoutList('[', value.value.map(nested), ']', style, layout);
+    }
+    if (value instanceof ObjectValue) {
+        const sorter = value.options?.sort ?? sortObjectPropertiesByOrderAndName;
+        const members = [...value.value].sort(sorter)
+            .map(property => `${renderKey(property.name, style.quote)}: ${nested(property.value)}`);
+        return layoutList('{', members, '}', style, layout);
+    }
+    throw new WriteBackSkipped(`a ${value.constructor.name} cannot be written into the code`);
+}
+/**
+ * Whether a parsed node is the expression `value` renders to: the same
+ * names, members, arguments and literals. The check the read-back of a
+ * written file makes; it says nothing about what the expression means,
+ * which the codegen's own tests cover.
+ */
+export function matchesValue(node, value, locals) {
+    const all = (nodes, values) => nodes.length === values.length
+        && nodes.every((child, i) => child !== null && matchesValue(child, values[i], locals));
+    if (value instanceof IdentifierValue) {
+        return node.type === 'Identifier' && node.name === (locals.get(value.value) ?? value.value);
+    }
+    if (value instanceof MemberExpressionValue) {
+        return node.type === 'MemberExpression' && !node.computed
+            && matchesValue(node.object, value.object, locals) && matchesValue(node.property, value.property, locals);
+    }
+    if (value instanceof CallExpressionValue) {
+        return node.type === 'CallExpression' && matchesValue(node.callee, value.callee, locals)
+            && all(node.arguments, value.args.value);
+    }
+    if (value instanceof NewExpressionValue) {
+        return node.type === 'NewExpression' && matchesValue(node.callee, value.callee, locals)
+            && all(node.arguments, value.args.value);
+    }
+    if (value instanceof StringValue) {
+        return node.type === 'Literal' && node.value === value.value;
+    }
+    if (value instanceof NumberValue) {
+        if (value.value < 0) {
+            return node.type === 'UnaryExpression' && node.operator === '-'
+                && node.argument.type === 'Literal' && node.argument.value === -value.value;
+        }
+        return node.type === 'Literal' && node.value === value.value;
+    }
+    if (value instanceof BooleanValue) {
+        return node.type === 'Literal' && node.value === value.value;
+    }
+    if (value instanceof UndefinedValue) {
+        return node.type === 'Identifier' && node.name === 'undefined';
+    }
+    if (value instanceof NullValue) {
+        return node.type === 'Literal' && node.value === null;
+    }
+    if (value instanceof ArrayValue) {
+        return node.type === 'ArrayExpression' && all(node.elements, value.value);
+    }
+    if (value instanceof ObjectValue) {
+        if (node.type !== 'ObjectExpression' || node.properties.length !== value.value.length) {
+            return false;
+        }
+        return value.value.every(property => {
+            const member = node.properties.find(candidate => memberName(candidate) === property.name);
+            return member !== undefined && !member.shorthand && matchesValue(member.value, property.value, locals);
+        });
+    }
+    return false;
+}
+//# sourceMappingURL=helper-edit.js.map

package/dist/services/write-back/helper-edit.js.map

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

package/dist/services/write-back/imports.d.ts

@@ -0,0 +1,30 @@
+import { type ParsedSource, type Splice } from './source-file.js';
+/**
+ * Makes the classes a helper expression references (`Frequency`,
+ * `RetryStrategyBuilder`, an assertion builder — all exports of
+ * `checkly/constructs`) available in a construct file: under the local name
+ * an existing import or `require` of a checkly package already binds them
+ * to, or by adding them to the file's top-level
+ * `import { … } from 'checkly/constructs'` (or
+ * `const { … } = require('checkly/constructs')`). A name the file already
+ * uses for something else is refused, and so is every name when the file
+ * has no such declaration to extend: no statement is ever added, which
+ * would mean guessing the file's module style.
+ */
+export interface ImportResolution {
+    /** Names that cannot be made available, with the reason. */
+    refused: Map<string, string>;
+    /** Names the file binds nowhere yet, which `appendImports` can add. */
+    missing: string[];
+}
+/** Which of `names` the file lacks, and which it cannot take. Independent of which of them end up written. */
+export declare function resolveImports(source: ParsedSource, names: readonly string[]): ImportResolution;
+/**
+ * The edit that adds `names` (each one `resolveImports` reported missing) to
+ * the file's `checkly/constructs` declaration, after its last specifier: on
+ * the same line when the list is one line, otherwise one per line at the
+ * last specifier's indentation, after the line the last specifier (or its
+ * comma, or a comment behind it) ends on, keeping the trailing comma when
+ * the list has one.
+ */
+export declare function appendImports(source: ParsedSource, names: readonly string[]): Splice | undefined;

package/dist/services/write-back/imports.js

@@ -0,0 +1,88 @@
+import { indentationAt, lineEndingOf } from './literal-edit.js';
+import { appendAfterLast, checklyBindings, CONSTRUCTS_MODULE, isChecklyRequire, stringOf, gapTokens, usesIdentifier, } from './source-file.js';
+/** Which of `names` the file lacks, and which it cannot take. Independent of which of them end up written. */
+export function resolveImports(source, names) {
+    const { program } = source;
+    const refused = new Map();
+    const missing = [];
+    for (const name of new Set(names)) {
+        if (checklyBindings(program, new Set([name])).size > 0) {
+            continue;
+        }
+        if (usesIdentifier(program, name)) {
+            refused.set(name, `${name} is already used for something else in this file`);
+        }
+        else if (constructsDeclaration(source) === undefined) {
+            refused.set(name, `add \`import { ${name} } from '${CONSTRUCTS_MODULE}'\` by hand`);
+        }
+        else {
+            missing.push(name);
+        }
+    }
+    return { refused, missing };
+}
+/**
+ * The edit that adds `names` (each one `resolveImports` reported missing) to
+ * the file's `checkly/constructs` declaration, after its last specifier: on
+ * the same line when the list is one line, otherwise one per line at the
+ * last specifier's indentation, after the line the last specifier (or its
+ * comma, or a comment behind it) ends on, keeping the trailing comma when
+ * the list has one.
+ */
+export function appendImports(source, names) {
+    const declaration = constructsDeclaration(source);
+    if (declaration === undefined || names.length === 0) {
+        return undefined;
+    }
+    const { text } = source;
+    const { last, open, close } = declaration;
+    if (!text.slice(open, close).includes('\n')) {
+        return { start: last.range[1], end: last.range[1], text: names.map(name => `, ${name}`).join('') };
+    }
+    return appendAfterLast(source, last, close, names, indentationAt(text, last.range[0]), lineEndingOf(text));
+}
+/**
+ * The top-level declaration that names what `checkly/constructs` exports:
+ * a value import with named specifiers, or, for a CommonJS file, a
+ * destructuring `require` of the same module.
+ */
+function constructsDeclaration(source) {
+    const { program } = source;
+    const brace = (start, end, value) => gapTokens(source, start, end).find(token => token.kind === 'token' && token.value === value)?.range[0];
+    for (const statement of program.body) {
+        if (statement.type === 'ImportDeclaration' && statement.source.value === CONSTRUCTS_MODULE
+            && statement.importKind !== 'type') {
+            const named = statement.specifiers.filter(specifier => specifier.type === 'ImportSpecifier');
+            if (named.length === 0) {
+                continue;
+            }
+            const last = named[named.length - 1];
+            const open = brace(statement.range[0], named[0].range[0], '{');
+            const close = brace(last.range[1], statement.source.range[0], '}');
+            if (open !== undefined && close !== undefined) {
+                return { last, open, close };
+            }
+        }
+        if (statement.type === 'VariableDeclaration') {
+            for (const declarator of statement.declarations) {
+                if (declarator.id.type !== 'ObjectPattern' || !isChecklyRequire(declarator.init)
+                    || stringOf(declarator.init.arguments[0]) !== CONSTRUCTS_MODULE) {
+                    continue;
+                }
+                const properties = declarator.id.properties.filter(property => property.type === 'Property');
+                if (properties.length > 0) {
+                    const pattern = declarator.id;
+                    const last = properties[properties.length - 1];
+                    // A TypeScript annotation (`const { … }: T = require(…)`) is part of
+                    // the pattern's range; the closing brace comes before it.
+                    const close = brace(last.range[1], pattern.typeAnnotation?.range[0] ?? pattern.range[1], '}');
+                    if (close !== undefined) {
+                        return { last, open: pattern.range[0], close };
+                    }
+                }
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=imports.js.map

package/dist/services/write-back/imports.js.map

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