@meilisearch/cli 0.0.0-stage → 0.1.0

package/dist/lib/config.js

@@ -0,0 +1,322 @@
+/**
+ * Configuration contract: projects, the config file, connection resolution,
+ * environment variables and secret redaction. See docs/contract/config.md.
+ *
+ * This file, output.ts and errors.ts implement the contract. They change only
+ * through a contract pull request.
+ */
+import { randomBytes } from "node:crypto";
+import { mkdirSync, readFileSync, renameSync, statSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { isRecord, MeiliCliError } from "./errors.js";
+/** Names of the environment variables the CLI reads. Nothing reads `process.env.MEILI_*` directly. */
+export const ENV = {
+    CONFIG: "MEILI_CONFIG",
+    MANAGEMENT_TOKEN: "MEILI_MANAGEMENT_TOKEN",
+    MANAGEMENT_URL: "MEILI_MANAGEMENT_URL",
+    MANAGEMENT_CLIENT_ID: "MEILI_MANAGEMENT_CLIENT_ID",
+    MANAGEMENT_DASHBOARD_URL: "MEILI_MANAGEMENT_DASHBOARD_URL",
+    OUTPUT: "MEILI_OUTPUT",
+    TIMEOUT: "MEILI_TIMEOUT",
+    NO_ANALYTICS: "MEILI_NO_ANALYTICS",
+};
+export const DEFAULT_MANAGEMENT_URL = "https://api.meilisearch.com";
+export const DEFAULT_MANAGEMENT_DASHBOARD_URL = "https://cloud.meilisearch.com";
+/**
+ * The OAuth application of this CLI, which `auth login` identifies itself with.
+ * Every Cloud registers it with this id. A client id is public by definition: it
+ * names the application on the consent page, it is not a secret. See ADR 0014.
+ */
+export const DEFAULT_MANAGEMENT_CLIENT_ID = "meilisearch-cli";
+/**
+ * The table of docs/contract/config.md, in the same order. Rendered in `meili --help`.
+ * `flag` names the flag that carries the same setting: the two share their name,
+ * `MEILI_` plus the flag name in upper snake case (CLAUDE.md, rule 14).
+ */
+export const ENV_VARS = [
+    {
+        name: ENV.CONFIG,
+        description: "Config file path. Default ~/.config/meili/config.json. Give each agent its own file, read-only.",
+    },
+    {
+        name: ENV.MANAGEMENT_TOKEN,
+        description: "Management API token, in place of the session of `auth login`. For development and tests.",
+    },
+    {
+        name: ENV.MANAGEMENT_URL,
+        description: `Management API base URL. Default ${DEFAULT_MANAGEMENT_URL}. For development and tests.`,
+    },
+    {
+        name: ENV.MANAGEMENT_CLIENT_ID,
+        description: "OAuth application the `auth login` command identifies itself with. Default: `meilisearch-cli`, the one of this CLI. For development and tests.",
+    },
+    {
+        name: ENV.MANAGEMENT_DASHBOARD_URL,
+        description: `Dashboard URL, which hosts the consent page of \`auth login\`. Default ${DEFAULT_MANAGEMENT_DASHBOARD_URL}. For development and tests.`,
+    },
+    { name: ENV.OUTPUT, description: "Default output mode: json or ndjson.", flag: "output" },
+    { name: ENV.TIMEOUT, description: "Default --timeout for --wait.", flag: "timeout" },
+    {
+        name: ENV.NO_ANALYTICS,
+        description: "`true` or `1` turns off the anonymous usage data the CLI sends. `DO_NOT_TRACK=1` and `CI` turn it off too.",
+    },
+];
+/** `$MEILI_CONFIG`, else `$XDG_CONFIG_HOME/meili/config.json`, else `~/.config/meili/config.json`. */
+export function configFilePath(env) {
+    return (nonEmpty(env[ENV.CONFIG]) ??
+        join(nonEmpty(env.XDG_CONFIG_HOME) ?? join(homedir(), ".config"), "meili", "config.json"));
+}
+/**
+ * The config file; no projects when it does not exist. A file readable by
+ * others holds API keys that others can read: `warn` receives it, and the
+ * file is read anyway. Windows has no file modes, so no check there.
+ */
+export function readConfigFile(path, warn) {
+    const text = readOwnerOnly(path, "config", warn);
+    if (text === undefined)
+        return { path, projects: {} };
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (cause) {
+        throw new MeiliCliError("cli_config", `The config file ${path} is not valid JSON.`, { cause });
+    }
+    return { path, projects: parseProjects(parsed, path) };
+}
+function parseProjects(parsed, path) {
+    const shape = () => new MeiliCliError("cli_config", `The config file ${path} must be {"projects": {"<name>": {"url": "...", "apiKey": "...", "cloud": {"id": 1, "teamId": 2, "teamName": "..."}}}}, the key and cloud optional, and in cloud the team.`);
+    const projects = isRecord(parsed) ? parsed.projects : undefined;
+    if (!isRecord(projects))
+        throw shape();
+    const result = {};
+    for (const [name, entry] of Object.entries(projects)) {
+        if (!isRecord(entry) || typeof entry.url !== "string")
+            throw shape();
+        if (entry.apiKey !== undefined && typeof entry.apiKey !== "string")
+            throw shape();
+        const { cloud } = entry;
+        if (cloud !== undefined &&
+            (!isRecord(cloud) ||
+                !Number.isInteger(cloud.id) ||
+                (cloud.teamId !== undefined && !Number.isInteger(cloud.teamId)) ||
+                (cloud.teamName !== undefined && typeof cloud.teamName !== "string"))) {
+            throw shape();
+        }
+        result[name] = {
+            url: entry.url,
+            ...(entry.apiKey === undefined ? {} : { apiKey: entry.apiKey }),
+            ...(cloud === undefined
+                ? {}
+                : {
+                    cloud: {
+                        id: cloud.id,
+                        ...(cloud.teamId === undefined ? {} : { teamId: cloud.teamId }),
+                        ...(cloud.teamName === undefined ? {} : { teamName: cloud.teamName }),
+                    },
+                }),
+        };
+    }
+    return result;
+}
+export function writeConfigFile(file) {
+    writeSecretFile(file.path, { projects: file.projects });
+}
+/**
+ * Writes a file of secrets owner-only and atomically: a command reading it
+ * meanwhile sees the previous file or the new one, never a half-written one.
+ * The temporary file is created exclusively, under an unpredictable name: a
+ * pre-existing file or symlink at that path, in a shared directory, would
+ * receive the secrets and keep its own permissions.
+ */
+export function writeSecretFile(path, content) {
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    const temporary = `${path}.${randomBytes(6).toString("hex")}.tmp`;
+    writeFileSync(temporary, `${JSON.stringify(content, null, 2)}\n`, { flag: "wx", mode: 0o600 });
+    renameSync(temporary, path);
+}
+/**
+ * The file, or undefined when it does not exist. A file readable by others
+ * holds secrets that others can read: `warn` receives it, and the file is read
+ * anyway. Windows has no file modes, so no check there.
+ */
+export function readOwnerOnly(path, what, warn) {
+    const stat = statSync(path, { throwIfNoEntry: false });
+    if (stat === undefined)
+        return undefined;
+    if (process.platform !== "win32" && (stat.mode & 0o077) !== 0) {
+        warn(new MeiliCliError("cli_config", `The ${what} file ${path} is readable by others.`, {
+            hint: `Run \`chmod 600 ${path}\`.`,
+        }));
+    }
+    return readFileSync(path, "utf8");
+}
+/**
+ * The rules of docs/contract/config.md, "Resolution: the command line names
+ * the project". The file is read only for `--project`; nothing else is read.
+ * Never falls back to localhost.
+ */
+export function resolveProjectConnection(flags, readFile) {
+    if (flags.url !== undefined) {
+        if (flags.project !== undefined) {
+            throw new MeiliCliError("cli_usage", "`--project` cannot be combined with `--project-url`: the name and the URL contradict each other.");
+        }
+        assertProjectUrl(flags.url);
+        return { url: flags.url, apiKey: flags.apiKey };
+    }
+    if (flags.project !== undefined) {
+        const entry = projectOf(readFile(), flags.project);
+        return { url: entry.url, apiKey: flags.apiKey ?? entry.apiKey };
+    }
+    throw new MeiliCliError("cli_usage", "Name the project with `--project <name>`, an entry of the config file, or with `--project-url <url>`.", { hint: "Run `meili config list` to see the projects of the config file." });
+}
+/**
+ * The Cloud project a management command acts on (config.md, "Cloud projects"):
+ * `--id` as given, or the `cloud.id` of the entry named by `--project`. Both
+ * together contradict each other; neither is a usage error.
+ */
+export function resolveCloudProjectId(flags, readFile) {
+    if (flags.project !== undefined && flags.id !== undefined) {
+        throw new MeiliCliError("cli_usage", "`--project` cannot be combined with `--id`: the name and the id contradict each other.");
+    }
+    if (flags.project === undefined) {
+        if (flags.id === undefined) {
+            throw new MeiliCliError("cli_usage", "Name the project with `--id <id>` or `--project <name>`.");
+        }
+        return flags.id;
+    }
+    const file = readFile();
+    const { cloud } = projectOf(file, flags.project);
+    if (cloud === undefined) {
+        throw new MeiliCliError("cli_config", `Project \`${flags.project}\` has no cloud identifiers in ${file.path}: the management commands need the project's id.`, { hint: `Run \`meili config update --project ${flags.project} --sync-with-cloud\`.` });
+    }
+    return cloud.id;
+}
+/** `cli_config` when the file already has an entry named `name`; `detail` follows the path. */
+export function assertNoProject(file, name, detail) {
+    if (file.projects[name] !== undefined) {
+        throw new MeiliCliError("cli_config", `Project \`${name}\` already exists in ${file.path}${detail}`, {
+            hint: `Run \`meili config update --project ${name}\` to change it, or \`meili config unset --project ${name}\` first.`,
+        });
+    }
+}
+/**
+ * The entry `--sync-config` changes for the Cloud project `id`: the one
+ * `--project` names, else the one whose `cloud.id` is `id`. None, or several,
+ * is `cli_config` before any call; `detail` follows the path.
+ */
+export function cloudProjectEntry(file, project, id, detail) {
+    if (project !== undefined)
+        return project;
+    const names = entriesOfCloudId(file, id);
+    const [name] = names;
+    if (name !== undefined && names.length === 1)
+        return name;
+    throw new MeiliCliError("cli_config", names.length === 0
+        ? `No project of ${file.path} has the cloud id ${id}${detail}`
+        : `Projects ${names.map((each) => `\`${each}\``).join(", ")} of ${file.path} have the cloud id ${id}${detail}`, {
+        hint: names.length === 0
+            ? `Run \`meili config sync-with-cloud --project-url <url>\` first, with the project's URL.`
+            : "Name one with `--project` in place of `--id`.",
+    });
+}
+/** The names of the entries whose `cloud.id` is `id`. */
+export function entriesOfCloudId(file, id) {
+    return Object.keys(file.projects).filter((name) => file.projects[name]?.cloud?.id === id);
+}
+/** `value` as a URL, or undefined. `URL.parse` would do, but only from Node 22.1. */
+export function parseUrl(value) {
+    try {
+        return new URL(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+/** True when `value` is an HTTP(S) URL: a Meilisearch instance answers over nothing else. */
+export function isProjectUrl(value) {
+    const protocol = parseUrl(value)?.protocol;
+    return protocol === "http:" || protocol === "https:";
+}
+/**
+ * `cli_usage` unless `value` is an HTTP(S) URL: a Meilisearch instance answers
+ * over nothing else. The message leaves the value out, which may carry a password.
+ */
+export function assertProjectUrl(value) {
+    if (!isProjectUrl(value)) {
+        throw new MeiliCliError("cli_usage", "Invalid project URL: `--project-url` takes an HTTP(S) URL.");
+    }
+}
+/** In the help of every command that writes the config file (config.md, "Config file"). */
+export const CONFIG_FILE_WARNING = "The file holds API keys and decides where every later command goes, for every process that reads it: an agent runs this only when the human asked for it explicitly.";
+/** The named entry, or `cli_config` with the path and the names the file has. */
+export function projectOf(file, name) {
+    const entry = file.projects[name];
+    if (entry === undefined) {
+        throw new MeiliCliError("cli_config", `No project \`${name}\` in ${file.path}. Projects: ${Object.keys(file.projects).join(", ") || "none"}.`);
+    }
+    return entry;
+}
+// Secrets
+/** `****1a2b`: the last four characters only. Shorter values are fully masked. */
+export function maskSecret(value) {
+    return value.length > 4 ? `****${value.slice(-4)}` : "****";
+}
+/**
+ * Body fields whose value is a secret, as listed in config.md. `apikey` is the
+ * Management API's spelling, `masterKey` a Cloud project's key in the same API.
+ */
+export const REDACTED_FIELDS = new Set([
+    "apiKey",
+    "apikey",
+    "masterKey",
+    "key",
+    "token",
+    "access_token",
+    "refresh_token",
+]);
+const REDACTED_HEADERS = new Set([
+    "authorization",
+    "x-meili-api-key",
+    "cookie",
+    "set-cookie",
+]);
+/** Masks the `Authorization` header (and the legacy `X-Meili-API-Key`) in a header map. */
+export function redactHeaders(headers) {
+    const result = {};
+    for (const [name, value] of headers) {
+        if (REDACTED_HEADERS.has(name.toLowerCase())) {
+            const [scheme, ...rest] = value.split(" ");
+            result[name] =
+                rest.length > 0 && scheme !== undefined
+                    ? `${scheme} ${maskSecret(rest.join(" "))}`
+                    : maskSecret(value);
+        }
+        else {
+            result[name] = value;
+        }
+    }
+    return result;
+}
+/** Deep copy of a JSON value with every secret field masked. */
+export function redactBody(value) {
+    if (Array.isArray(value))
+        return value.map(redactBody);
+    if (!isRecord(value))
+        return value;
+    const result = {};
+    for (const [field, fieldValue] of Object.entries(value)) {
+        if (REDACTED_FIELDS.has(field)) {
+            result[field] = typeof fieldValue === "string" ? maskSecret(fieldValue) : "****";
+        }
+        else {
+            result[field] = redactBody(fieldValue);
+        }
+    }
+    return result;
+}
+export function nonEmpty(value) {
+    return value === undefined || value === "" ? undefined : value;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/errors.js

@@ -0,0 +1,302 @@
+/**
+ * Error contract: codes, exit codes and rendering. See docs/contract/output.md.
+ *
+ * This file, output.ts and config.ts implement the contract. They change only
+ * through a contract pull request.
+ */
+import { stripVTControlCharacters } from "node:util";
+import { Errors } from "@oclif/core";
+import { MeilisearchApiError, MeilisearchRequestError, MeilisearchRequestTimeOutError, } from "meilisearch";
+/** Exit codes, as listed in the table of docs/contract/output.md. */
+export const EXIT_CODES = {
+    success: 0,
+    error: 1,
+    usage: 2,
+    auth: 3,
+    notFound: 4,
+    timeout: 5,
+    network: 6,
+    taskFailed: 7,
+};
+/** Codes of errors raised by the CLI itself, with their default exit code. */
+export const CLI_ERROR_CODES = {
+    cli_usage: EXIT_CODES.usage,
+    cli_config: EXIT_CODES.usage,
+    cli_auth_missing: EXIT_CODES.auth,
+    cli_auth_failed: EXIT_CODES.auth,
+    cli_timeout: EXIT_CODES.timeout,
+    cli_network: EXIT_CODES.network,
+    cli_task_failed: EXIT_CODES.taskFailed,
+    cli_input_invalid: EXIT_CODES.usage,
+    cli_internal: EXIT_CODES.error,
+};
+/** Exit code of an API error, from its HTTP status. Both APIs answer the same shape. */
+export function apiExitCode(status) {
+    if (status === 401 || status === 403)
+        return EXIT_CODES.auth;
+    if (status === 404)
+        return EXIT_CODES.notFound;
+    return EXIT_CODES.error;
+}
+/**
+ * A non-2xx answer of the Management API. Its body is the error object of the
+ * document, the same shape as a Meilisearch one, and it is passed through
+ * (docs/contract/output.md, "Errors"); `body` is undefined when the answer
+ * carried none, which is not the API answering.
+ */
+export class ManagementApiError extends Error {
+    status;
+    body;
+    url;
+    constructor(status, body, url) {
+        super(parseErrorBody(body)?.message ?? `The Management API answered HTTP ${status} to ${url}.`);
+        this.name = "ManagementApiError";
+        this.status = status;
+        this.body = body;
+        this.url = url;
+    }
+}
+/** The error object of either API, or undefined when the body is not one. */
+export function parseErrorBody(body) {
+    if (!isRecord(body))
+        return undefined;
+    const { message, code, type, link } = body;
+    if (typeof message !== "string" || typeof code !== "string" || typeof type !== "string") {
+        return undefined;
+    }
+    return { code, type, message, ...(typeof link === "string" ? { link } : {}) };
+}
+/** The only error class commands may throw. */
+export class MeiliCliError extends Error {
+    code;
+    exitCode;
+    hint;
+    constructor(code, message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = "MeiliCliError";
+        this.code = code;
+        this.exitCode = options.exitCode ?? CLI_ERROR_CODES[code];
+        this.hint = options.hint;
+    }
+    toBody() {
+        const body = { code: this.code, type: "cli", message: this.message };
+        if (this.hint !== undefined)
+            body.hint = this.hint;
+        return body;
+    }
+}
+const HELP_SUFFIX = /\n?See more help with --help\.?\s*$/;
+/**
+ * Both APIs answer the same error object, so both are rendered the same way:
+ * the body passed through, the API's hint for that status, and the exit code
+ * of the status. No error body at all is a proxy or a wrong URL, not the API.
+ */
+function renderApiError(error, status, url, sent, api) {
+    const body = parseErrorBody(sent);
+    if (body === undefined) {
+        return {
+            body: {
+                code: "cli_network",
+                type: "cli",
+                message: `${serverName(url)} answered HTTP ${status} without a ${api.name} error body.`,
+            },
+            exitCode: EXIT_CODES.network,
+            stack: error.stack,
+        };
+    }
+    const hint = api.hint(status);
+    if (hint !== undefined)
+        body.hint = hint;
+    return { body, exitCode: apiExitCode(status), stack: error.stack };
+}
+/**
+ * Converts anything thrown during a command into a contract error. `commandIds`
+ * are the commands of the manifest, `get indexes`, for the hint of an unknown command.
+ * `managementTokenFromEnv` says the Management API token came from
+ * `MEILI_MANAGEMENT_TOKEN`, which a new login would not replace.
+ */
+export function toRenderedError(error, commandIds = [], managementTokenFromEnv = false) {
+    if (error instanceof MeiliCliError) {
+        return { body: error.toBody(), exitCode: error.exitCode, stack: error.stack };
+    }
+    if (error instanceof MeilisearchApiError) {
+        return renderApiError(error, error.response.status, error.response.url, error.cause, {
+            name: "Meilisearch",
+            hint: (status) => status === 401 || status === 403
+                ? "Provide an API key with `--project-api-key <key>`."
+                : undefined,
+        });
+    }
+    if (error instanceof ManagementApiError) {
+        return renderApiError(error, error.status, error.url, error.body, {
+            name: "Management API",
+            // A 403 is a right the account lacks: no new credential grants it.
+            hint: (status) => status !== 401
+                ? undefined
+                : managementTokenFromEnv
+                    ? "Unset or replace `MEILI_MANAGEMENT_TOKEN`: it is used in place of the session of `meili auth login`."
+                    : "Run `meili auth login` to log in again.",
+        });
+    }
+    if (error instanceof MeilisearchRequestTimeOutError) {
+        return {
+            body: {
+                code: "cli_timeout",
+                type: "cli",
+                message: `The HTTP request timed out after ${error.cause.timeout} ms.`,
+            },
+            exitCode: EXIT_CODES.timeout,
+            stack: error.stack,
+        };
+    }
+    if (error instanceof MeilisearchRequestError) {
+        return {
+            body: { code: "cli_network", type: "cli", message: networkMessage(error) },
+            exitCode: EXIT_CODES.network,
+            stack: error.stack,
+        };
+    }
+    if (error instanceof Errors.ExitError) {
+        // Already rendered upstream. Keep the exit code, print nothing.
+        return {
+            body: { code: "cli_internal", type: "cli", message: error.message },
+            exitCode: error.oclif.exit ?? EXIT_CODES.error,
+            stack: undefined,
+        };
+    }
+    if (error instanceof Errors.CLIError) {
+        // oclif parse errors and "command not found". Their exit code is 2 by default.
+        // oclif colors parts of its messages in a terminal: the JSON carries none of it.
+        const cleaned = stripVTControlCharacters(error.message).replace(HELP_SUFFIX, "");
+        const typed = cleaned.match(NOT_FOUND)?.[1]?.replaceAll(":", " ");
+        const closest = typed === undefined ? undefined : closestCommand(typed, commandIds);
+        return {
+            body: {
+                code: "cli_usage",
+                type: "cli",
+                message: typed === undefined ? cleaned : `Command \`${typed}\` not found.`,
+                hint: closest === undefined
+                    ? "Run `meili --help` or `meili <command> --help` to see the usage."
+                    : `Did you mean \`meili ${closest}\`?`,
+            },
+            exitCode: EXIT_CODES.usage,
+            stack: error.stack,
+        };
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        body: {
+            code: "cli_internal",
+            type: "cli",
+            message: `Unexpected error: ${message}`,
+            hint: "This is a bug in meili. Run the command again with `--debug` and report the trace.",
+        },
+        exitCode: EXIT_CODES.error,
+        stack: error instanceof Error ? error.stack : undefined,
+    };
+}
+/** oclif joins command ids with ":" in its messages; the CLI uses spaces. */
+const NOT_FOUND = /^command (\S+) not found$/;
+/** The command closest to what was typed, when it is close enough to be a typo. */
+export function closestCommand(typed, commandIds) {
+    const tolerance = Math.max(2, Math.floor(typed.length / 3));
+    let best;
+    for (const id of commandIds) {
+        const distance = editDistance(typed, id);
+        if (distance <= tolerance && (best === undefined || distance < best.distance)) {
+            best = { id, distance };
+        }
+    }
+    return best?.id;
+}
+/** Levenshtein distance. */
+function editDistance(a, b) {
+    const row = Array.from({ length: b.length + 1 }, (_, index) => index);
+    for (let i = 1; i <= a.length; i += 1) {
+        let diagonal = row[0] ?? 0;
+        row[0] = i;
+        for (let j = 1; j <= b.length; j += 1) {
+            const above = row[j] ?? 0;
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            row[j] = Math.min(above + 1, (row[j - 1] ?? 0) + 1, diagonal + cost);
+            diagonal = above;
+        }
+    }
+    return row[b.length] ?? 0;
+}
+function serverName(url) {
+    return url === "" ? "The server" : `The server at ${url}`;
+}
+function networkMessage(error) {
+    const target = error.message.match(/https?:\/\/\S+/)?.[0];
+    const where = target === undefined ? "the Meilisearch instance" : target.replace(/\/$/, "");
+    return cannotConnectMessage(where, error.cause);
+}
+/** The `cli_network` message: `Cannot connect to <where>`, with the deepest cause when there is one. */
+export function cannotConnectMessage(where, cause) {
+    const reason = deepestCauseMessage(cause);
+    return reason === undefined
+        ? `Cannot connect to ${where}.`
+        : `Cannot connect to ${where}: ${reason}.`;
+}
+/** The innermost reason of a wrapped error: `fetch failed` hides `ECONNREFUSED`. */
+export function deepestCauseMessage(cause) {
+    let current = cause;
+    let message;
+    for (let depth = 0; depth < 5 && current instanceof Error; depth += 1) {
+        if (current.message !== "")
+            message = current.message;
+        current = current.cause;
+    }
+    return message?.replace(/\.$/, "");
+}
+/** Formats an error for stderr: one JSON document, then the stack trace with --debug. */
+export function formatError(rendered, options) {
+    const document = { error: rendered.body };
+    const lines = [options.pretty ? JSON.stringify(document, null, 2) : JSON.stringify(document)];
+    if (options.debug && rendered.stack !== undefined)
+        lines.push(rendered.stack);
+    return `${lines.join("\n")}\n`;
+}
+/** Writes a rendered error on stderr. Nothing ever goes to stdout from here. */
+export function writeError(rendered, options) {
+    process.stderr.write(formatError(rendered, options));
+}
+/**
+ * One line for the human, on stderr, and only when a human is there to read it
+ * (docs/contract/output.md, "Streams"). Data never goes through here.
+ */
+export function writeNotice(line) {
+    if (process.stderr.isTTY === true)
+        process.stderr.write(`${line}\n`);
+}
+/**
+ * Writes a warning on stderr, `{ "warning": ... }` in the shape of an error,
+ * and the command goes on. Indented when stderr is a TTY, like errors. An API
+ * error the command goes on through keeps the API's code.
+ */
+export function writeWarning(warning) {
+    const document = { warning: warning instanceof MeiliCliError ? warning.toBody() : warning };
+    const pretty = process.stderr.isTTY === true;
+    process.stderr.write(`${pretty ? JSON.stringify(document, null, 2) : JSON.stringify(document)}\n`);
+}
+/**
+ * Last-resort handler for bin/run.js: errors thrown before a command exists
+ * (unknown command, bad global flags on a topic) or escaped from one.
+ * Errors already rendered by BaseCommand arrive as ExitError and print nothing.
+ */
+export function handleFatalError(error, argv, commandIds) {
+    const rendered = toRenderedError(error, commandIds);
+    if (!(error instanceof Errors.ExitError)) {
+        writeError(rendered, {
+            pretty: process.stderr.isTTY === true,
+            debug: argv.includes("--debug"),
+        });
+    }
+    process.exitCode = rendered.exitCode;
+}
+/** A JSON object, as opposed to an array, a scalar or null. */
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

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