@statuser/cli 0.0.0-stage → 0.1.0

package/dist/commands/scenarios.js

@@ -0,0 +1,361 @@
+import { readFile } from 'node:fs/promises';
+import { inspect } from 'node:util';
+import { authedClient, globalOptions } from '../context.js';
+import { CliError, ExitCode } from '../errors.js';
+import { t } from '../i18n.js';
+import { printErr, printJson, printLine } from '../output.js';
+import { loadScenarioConfig, resolveEnvValue, scenarioEnvProblem, SCENARIO_DEFAULT_LOCATION, SCENARIO_DEFAULT_TIMEOUT, SCENARIO_LOCATIONS, SCENARIO_TIMEOUTS, } from '../scenarios/config.js';
+import { buildDeployPlan } from '../scenarios/plan.js';
+import { checkScenarioLimits } from '../servers-config/plan.js';
+import { describeWriteFailure } from '../write-failure.js';
+import { listServers, parseId } from './servers.js';
+// The sandbox may wait up to 30 s for a free slot on top of the run itself,
+// then uploads artifacts.
+const PREVIEW_OVERHEAD_MS = 90_000;
+const collect = (value, previous) => [...previous, value];
+export function registerScenariosCommands(program) {
+    const scenarios = program.command('scenarios').description(t.cmdScenarios);
+    scenarios
+        .command('test')
+        .description(t.cmdScenariosTest)
+        .argument('<file>')
+        .option('--timeout <seconds>', t.optTimeout, String(SCENARIO_DEFAULT_TIMEOUT))
+        .option('--location <code>', t.optLocation, SCENARIO_DEFAULT_LOCATION)
+        .option('--env <KEY=VALUE>', t.optEnv, collect, [])
+        .action(async (file, opts, command) => {
+        const timeout = Number(opts.timeout);
+        if (!SCENARIO_TIMEOUTS.includes(timeout)) {
+            throw new CliError(t.optTimeout, ExitCode.Usage);
+        }
+        if (!SCENARIO_LOCATIONS.includes(opts.location)) {
+            throw new CliError(t.optLocation, ExitCode.Usage);
+        }
+        const env = Object.create(null);
+        for (const [position, raw] of opts.env.entries()) {
+            const index = raw.indexOf('=');
+            // The argument may be a bare value: it is never quoted back.
+            // A bad name may be part of a secret passed by mistake
+            // (`--env 'YWJj=='`): the problem is named by position only.
+            if (index <= 0 ||
+                scenarioEnvProblem({ [raw.slice(0, index)]: '' }) !== null) {
+                throw new CliError(t.argInvalid('--env', position + 1), ExitCode.Usage);
+            }
+            env[raw.slice(0, index)] = resolveEnvValue(raw.slice(index + 1), file, process.env);
+        }
+        const envProblem = scenarioEnvProblem(env);
+        if (envProblem)
+            throw new CliError(envProblem, ExitCode.Usage);
+        let script;
+        try {
+            script = await readFile(file, 'utf8');
+        }
+        catch {
+            throw new CliError(t.configNotFound(file), ExitCode.Usage);
+        }
+        const json = globalOptions(command).json;
+        if (!json)
+            printErr(t.scenarioRunning);
+        const { client } = await authedClient(command);
+        // Not retried on a dropped connection: the run may have happened, and
+        // the account allows one on-demand run at a time.
+        const result = await client.call({
+            method: 'POST',
+            path: '/v1/scenario-runs/preview',
+            body: {
+                scenario_script: script,
+                // Both checked against the spec enums above.
+                request_timeout: timeout,
+                locations: [
+                    opts.location,
+                ],
+                ...(Object.keys(env).length ? { scenario_env: env } : {}),
+            },
+            timeoutMs: timeout * 1000 + PREVIEW_OVERHEAD_MS,
+        });
+        // The test may print or compare its passwords; the run result comes
+        // back verbatim, so the values passed here are masked before output.
+        const masked = maskSecrets(result, Object.values(env));
+        if (json)
+            printJson(masked);
+        else
+            printRunResult(masked);
+        process.exitCode = runExitCode(result.status);
+    });
+    scenarios
+        .command('run')
+        .description(t.cmdScenariosRun)
+        .argument('<id>', 'id', parseId)
+        .action(async (id, _opts, command) => {
+        const { client } = await authedClient(command);
+        const server = await client.call({
+            method: 'GET',
+            path: `/v1/servers/${id}`,
+        });
+        if (server.protocol !== 'scenario') {
+            throw new CliError(t.scenarioNotScenario(id, server.protocol), ExitCode.Usage);
+        }
+        // The answer comes when the run ends: up to the scenario's timeout
+        // plus the start. Not retried on a dropped connection — the run may
+        // have happened, and it counts like a scheduled one.
+        const result = await client.call({
+            method: 'POST',
+            path: `/v1/servers/${id}/scenario-run`,
+            timeoutMs: server.request_timeout * 1000 + PREVIEW_OVERHEAD_MS,
+        });
+        // The API returns the saved run's console and error verbatim, and the
+        // values of its variables are not readable. In CI they usually sit in
+        // the environment under the same names (the config refers to them as
+        // `$NAME`): those are masked, the rest are named in a warning.
+        const keys = server.scenario_env_keys ?? [];
+        const known = keys.filter((key) => process.env[key]);
+        const unknown = keys.filter((key) => !process.env[key]);
+        if (unknown.length)
+            printErr(t.scenarioEnvUnmasked(unknown.join(', ')));
+        const masked = maskSecrets(result, known.map((key) => process.env[key]));
+        if (globalOptions(command).json)
+            printJson(masked);
+        else
+            printRunResult(masked);
+        process.exitCode = runExitCode(result.status);
+    });
+    scenarios
+        .command('deploy')
+        .description(t.cmdScenariosDeploy)
+        .option('-c, --config <path>', t.optConfig, 'statuser.json')
+        .option('--dry-run', t.optDryRun)
+        .action(async (opts, command) => {
+        const config = await loadScenarioConfig(opts.config);
+        const { client } = await authedClient(command);
+        // The whole account: duplicate scripts are checked account-wide.
+        const [servers, current] = await Promise.all([
+            listServers(client),
+            client.call({
+                method: 'GET',
+                path: '/v1/billing/current-plan',
+            }),
+        ]);
+        const plan = buildDeployPlan(config, servers);
+        // Plan limits before the first write, as `apply` does.
+        const creates = plan.steps.filter((s) => s.kind === 'create').length;
+        checkScenarioLimits(plan.steps, servers.filter((s) => s.protocol === 'scenario').length, current.features);
+        if (creates &&
+            servers.length + creates > current.features.servers_limit) {
+            throw new CliError(t.applyServersLimit(current.features.servers_limit, servers.length, creates), ExitCode.Usage);
+        }
+        const json = globalOptions(command).json;
+        const pending = plan.steps.filter((s) => s.kind !== 'unchanged');
+        if (!json) {
+            printLine(t.deployPlanTitle(plan.projectId));
+            for (const step of plan.steps)
+                printLine(describeStep(step));
+            for (const item of plan.unmanaged) {
+                printLine(t.deployUnmanaged(item.name ?? '', item.id));
+            }
+            if (pending.some((s) => s.kind === 'update' && s.fields.includes('env'))) {
+                printErr(t.deployEnvAlwaysSent);
+            }
+        }
+        const applied = [];
+        const summary = () => ({
+            project_id: plan.projectId,
+            dry_run: !!opts.dryRun,
+            // Bodies are left out: they carry scenario env values.
+            steps: plan.steps.map((step) => ({
+                name: step.scenario.name,
+                action: step.kind,
+                id: step.kind === 'create' ? null : step.serverId,
+                fields: step.kind === 'update' ? step.fields : undefined,
+            })),
+            unmanaged: plan.unmanaged,
+            applied,
+        });
+        if (opts.dryRun || !pending.length) {
+            if (json)
+                printJson(summary());
+            else
+                printLine(opts.dryRun ? t.deployDryRunDone : t.deployNothing);
+            return;
+        }
+        for (const step of pending) {
+            try {
+                if (step.kind === 'create') {
+                    const created = await client.call({
+                        method: 'POST',
+                        path: '/v1/servers',
+                        body: step.body,
+                    });
+                    applied.push({
+                        name: step.scenario.name,
+                        action: 'create',
+                        id: created.id,
+                    });
+                }
+                else if (step.kind === 'update') {
+                    await client.call({
+                        method: 'PATCH',
+                        path: `/v1/servers/${step.serverId}`,
+                        body: step.body,
+                    });
+                    applied.push({
+                        name: step.scenario.name,
+                        action: 'update',
+                        id: step.serverId,
+                    });
+                }
+                if (!json)
+                    printLine(t.deployApplied(step.scenario.name));
+            }
+            catch (error) {
+                const failure = describeWriteFailure(step.scenario.name, error);
+                if (json)
+                    printJson({ ...summary(), error: failure });
+                throw new CliError(failure.message, failure.exitCode);
+            }
+        }
+        if (json)
+            printJson(summary());
+    });
+}
+export function describeStep(step) {
+    switch (step.kind) {
+        case 'create':
+            return t.deployCreate(step.scenario.name);
+        case 'update':
+            return t.deployUpdate(step.scenario.name, step.serverId, step.fields.join(', '));
+        case 'unchanged':
+            return t.deployUnchanged(step.scenario.name, step.serverId);
+    }
+}
+function printRunResult(result) {
+    if (result.status === 'passed') {
+        printLine(t.scenarioPassed(((result.duration_ms ?? 0) / 1000).toFixed(1)));
+    }
+    else if (result.status === 'runner_error') {
+        printLine(t.scenarioRunnerError);
+    }
+    else {
+        printLine(t.scenarioFailed(result.status));
+        if (result.failed_test)
+            printLine(t.scenarioFailedTest(result.failed_test));
+        if (result.error)
+            printLine(t.scenarioError(result.error));
+    }
+    for (const [kind, url] of Object.entries(result.artifact_urls ?? {})) {
+        if (url)
+            printLine(t.scenarioArtifact(kind, url));
+    }
+}
+/** passed → 0, a site-side failure → 4, our sandbox failing → 1. */
+function runExitCode(status) {
+    if (status === 'passed')
+        return ExitCode.Ok;
+    if (status === 'runner_error')
+        return ExitCode.Failure;
+    return ExitCode.ScenarioFailed;
+}
+/**
+ * Masks the given secret values in the diagnostic fields of a run result:
+ * the error, the failed test title and the console. Structural fields
+ * (status, location, links) are left intact — they are the contract.
+ */
+export function maskSecrets(result, secrets) {
+    const values = secretForms(secrets);
+    if (!values.length)
+        return result;
+    const mask = (text) => typeof text === 'string' ? maskText(text, values) : text;
+    return {
+        ...result,
+        error: mask(result.error),
+        failed_test: mask(result.failed_test),
+        console: result.console?.map((entry) => ({
+            ...entry,
+            text: mask(entry.text) ?? '',
+        })) ?? null,
+    };
+}
+/**
+ * Every form a value may take in the run's output: as given, escaped by
+ * `JSON.stringify` in the script, and without trailing whitespace, which
+ * the runner trims from console lines.
+ */
+function secretForms(secrets) {
+    const forms = new Set();
+    for (const secret of secrets) {
+        // util.inspect (`console.log({ password })`) breaks a long multiline
+        // string into one literal per line, joined with `+` and indented by
+        // nesting: each line of the value is masked on its own too. Lines
+        // shorter than four characters are left, so as not to mask everywhere.
+        const lines = secret.includes('\n')
+            ? secret.split('\n').filter((line) => line.length >= 4)
+            : [];
+        for (const part of [secret, ...lines]) {
+            addForms(forms, part);
+        }
+    }
+    return [...forms];
+}
+function addForms(forms, secret) {
+    // util.inspect has its own escaping and quote choice.
+    for (const form of [
+        secret,
+        JSON.stringify(secret).slice(1, -1),
+        inspect(secret).slice(1, -1),
+    ]) {
+        for (const variant of [form, form.trimEnd()]) {
+            if (variant)
+                forms.add(variant);
+        }
+    }
+}
+/**
+ * Finds every place a value occupies in the original text first and only
+ * then replaces them: masking one value before searching for the next
+ * would break an overlapping one. The backend cuts long lines and appends
+ * `…`, so the start of a value at the cut is masked too.
+ */
+function maskText(text, values) {
+    const cut = text.endsWith('…');
+    const body = cut ? text.slice(0, -1) : text;
+    const ranges = [];
+    for (const value of values) {
+        for (let at = body.indexOf(value); at >= 0; at = body.indexOf(value, at + 1)) {
+            ranges.push([at, at + value.length]);
+        }
+        // The runner keeps only the last part of a long error, without a mark:
+        // a value cut at the start shows as its tail. Four characters at least,
+        // so a common last letter does not mask the start of every line.
+        for (let length = Math.min(value.length - 1, body.length); length >= 4; length -= 1) {
+            if (body.startsWith(value.slice(-length))) {
+                ranges.push([0, length]);
+                break;
+            }
+        }
+        if (cut) {
+            for (let length = Math.min(value.length - 1, body.length); length > 0; length -= 1) {
+                if (body.endsWith(value.slice(0, length))) {
+                    ranges.push([body.length - length, body.length]);
+                    break;
+                }
+            }
+        }
+    }
+    if (!ranges.length)
+        return text;
+    ranges.sort((a, b) => a[0] - b[0]);
+    const merged = [];
+    for (const [start, end] of ranges) {
+        const last = merged.at(-1);
+        if (last && start <= last[1])
+            last[1] = Math.max(last[1], end);
+        else
+            merged.push([start, end]);
+    }
+    let out = '';
+    let pos = 0;
+    for (const [start, end] of merged) {
+        out += `${body.slice(pos, start)}***`;
+        pos = end;
+    }
+    return `${out}${body.slice(pos)}${cut ? '…' : ''}`;
+}
+//# sourceMappingURL=scenarios.js.map

package/dist/commands/scenarios.js.map

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

package/dist/commands/servers-add.js

@@ -0,0 +1,152 @@
+import { isIP } from 'node:net';
+import { authedClient, globalOptions } from '../context.js';
+import { CliError, ExitCode } from '../errors.js';
+import { t } from '../i18n.js';
+import { printErr, printJson, printLine } from '../output.js';
+import { SCENARIO_LOCATIONS } from '../scenarios/config.js';
+import { parseServersSection } from '../servers-config/parse.js';
+import { buildServersPlan } from '../servers-config/plan.js';
+import { listServers, parseId, redactServer } from './servers.js';
+const ADD_PROTOCOLS = ['http', 'keyword', 'ping', 'tcp', 'dns', 'heartbeat'];
+/**
+ * One server, with the panel defaults for everything not given. The entry
+ * goes through the same parser and plan as `apply`, so the same checks run
+ * before the write: ranges, the host gate, account-wide duplicates and the
+ * plan. Settings without a flag here are changed later by `servers update`.
+ */
+export function registerServersAdd(servers) {
+    servers
+        .command('add')
+        .description(t.cmdServersAdd)
+        .argument('[host]', t.argServerHost)
+        .option('--name <name>', t.optServerName)
+        .option('--protocol <protocol>', t.optAddProtocol)
+        .option('--project <id>', t.optProject, parseId)
+        .option('--port <port>', t.optPort)
+        .option('--keyword <word>', t.optKeyword)
+        .option('--keyword-absent', t.optKeywordAbsent)
+        .option('--dns-types <types>', t.optDnsTypes)
+        .option('--interval <seconds>', t.optInterval)
+        .option('--timeout <seconds>', t.optRequestTimeout)
+        .option('--regions <codes>', t.optRegions)
+        .option('--dry-run', t.optDryRun)
+        .action(async (host, opts, command) => {
+        const entry = buildEntry(host, opts);
+        // The parser names the place as in a file, `servers[0].port`; here
+        // the field name alone says which flag to fix.
+        const desired = parseServersSection([entry], process.env, (problem) => usage(problem.replace(/^servers\[0\]\.?/, '')), { allowUnnamed: true });
+        const label = entry.name ?? host ?? '';
+        desired[0].at = label;
+        const { client } = await authedClient(command);
+        const [account, current, projectId] = await Promise.all([
+            listServers(client),
+            client.call({
+                method: 'GET',
+                path: '/v1/billing/current-plan',
+            }),
+            opts.project ?? defaultProject(client),
+        ]);
+        const plan = buildServersPlan(desired, projectId, account, current.features, 0, { createOnly: true });
+        const step = plan.steps[0];
+        if (step.kind !== 'create')
+            throw new Error('expected a create step');
+        for (const warning of step.warnings)
+            printErr(warning);
+        const json = globalOptions(command).json;
+        if (opts.dryRun) {
+            if (json)
+                printJson({ dry_run: true, body: step.body });
+            else
+                printLine(t.addDryRun(label));
+            return;
+        }
+        const created = await client.call({
+            method: 'POST',
+            path: '/v1/servers',
+            body: step.body,
+        });
+        if (json)
+            printJson(redactServer(created));
+        else
+            printLine(t.addCreated(created.id, created.name || label));
+    });
+}
+function buildEntry(host, opts) {
+    const protocol = opts.protocol ?? guessProtocol(host);
+    if (!ADD_PROTOCOLS.includes(protocol)) {
+        usage(`--protocol: ${t.cfgOneOf(ADD_PROTOCOLS.join(', '))}`);
+    }
+    if (protocol === 'heartbeat') {
+        if (host)
+            usage(t.addHostNotUsed);
+        // A heartbeat is told apart by its name: the API requires one.
+        if (!opts.name?.trim())
+            usage(`--name: ${t.cfgNonEmptyString}`);
+    }
+    else if (!host) {
+        usage(t.addHostNeeded);
+    }
+    const entry = { protocol };
+    if (host)
+        entry.host = host;
+    if (opts.name !== undefined)
+        entry.name = opts.name;
+    if (opts.port !== undefined)
+        entry.port = integer('--port', opts.port);
+    if (opts.keyword !== undefined)
+        entry.keyword = opts.keyword;
+    if (opts.keywordAbsent)
+        entry.keyword_mode = 'absent';
+    if (opts.dnsTypes !== undefined)
+        entry.dns_record_types = list(opts.dnsTypes);
+    if (opts.interval !== undefined) {
+        entry.check_interval = integer('--interval', opts.interval);
+    }
+    if (opts.timeout !== undefined) {
+        entry.request_timeout = integer('--timeout', opts.timeout);
+    }
+    if (opts.regions !== undefined) {
+        const regions = list(opts.regions);
+        for (const region of regions) {
+            if (!SCENARIO_LOCATIONS.includes(region)) {
+                usage(t.regionInvalid(region));
+            }
+        }
+        entry.locations = regions;
+    }
+    return entry;
+}
+/** A URL is an HTTP check, an address literal a ping; anything else is asked. */
+function guessProtocol(host) {
+    if (!host)
+        return 'heartbeat';
+    if (/^https?:\/\//i.test(host.trim()))
+        return 'http';
+    if (isIP(host.trim().replace(/^\[|\]$/g, '')))
+        return 'ping';
+    return usage(t.addProtocolNeeded(host));
+}
+/** Where the API puts a server without `project_id`: the oldest project. */
+async function defaultProject(client) {
+    const projects = await client.call({
+        method: 'GET',
+        path: '/v1/projects',
+    });
+    return Math.min(...projects.map((project) => project.id));
+}
+function integer(flag, raw) {
+    const value = Number(raw);
+    if (!Number.isInteger(value))
+        usage(`${flag}: ${t.numberInvalid(raw)}`);
+    return value;
+}
+function list(raw) {
+    return raw
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+function usage(message) {
+    throw new CliError(message, ExitCode.Usage);
+}
+//# sourceMappingURL=servers-add.js.map

package/dist/commands/servers-add.js.map

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

package/dist/commands/servers-checks.js

@@ -0,0 +1,56 @@
+import { authedClient, globalOptions } from '../context.js';
+import { t } from '../i18n.js';
+import { formatTime, printJson, printLine, printTable } from '../output.js';
+import { parseWhen } from './incidents.js';
+import { parseId } from './servers.js';
+/**
+ * Checks of a server as the panel's chart gets them: points over the
+ * period, each with the status and latency per location. Longer periods
+ * come aggregated into time buckets by the API.
+ */
+export function registerServersChecks(servers) {
+    servers
+        .command('checks')
+        .description(t.cmdServersChecks)
+        .argument('<id>', 'id', parseId)
+        .option('--since <when>', t.optChecksSince)
+        .option('--until <when>', t.optChecksUntil)
+        .action(async (id, opts, command) => {
+        const query = {
+            startDate: opts.since ? parseWhen(opts.since) : undefined,
+            endDate: opts.until ? parseWhen(opts.until) : undefined,
+        };
+        const { client } = await authedClient(command);
+        const groups = await client.call({
+            method: 'GET',
+            path: `/v1/servers/${id}/checks`,
+            query,
+        });
+        if (globalOptions(command).json) {
+            printJson(groups);
+            return;
+        }
+        // For a day the API adds the last raw checks (`raw:…`) on top of the
+        // aggregated points, so the panel's chart keeps moving between them;
+        // in a table they repeat the points next to them.
+        const points = groups.some((g) => !g.group_id.startsWith('raw:'))
+            ? groups.filter((g) => !g.group_id.startsWith('raw:'))
+            : groups;
+        if (!points.length) {
+            printLine(t.checksEmpty);
+            return;
+        }
+        printTable([t.colTime, t.colStatus, t.colLocations], points.map((group) => [
+            formatTime(group.group_checked_at),
+            group.locations.some((l) => l.status === 'offline')
+                ? 'offline'
+                : 'online',
+            group.locations
+                .map((l) => l.status === 'online'
+                ? `${l.location} ${Math.round(l.latency)} ms`
+                : `${l.location} ${l.status}`)
+                .join(', '),
+        ]));
+    });
+}
+//# sourceMappingURL=servers-checks.js.map

package/dist/commands/servers-checks.js.map

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