@arkebcacy/beacon-cli-temp 0.1.1

package/dist/ui/progress/formatName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatName.js","sourceRoot":"","sources":["../../../src/ui/progress/formatName.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,CAAC,OAAO,UAAU,UAAU,CACjC,IAAY,EACZ,cAAc,GAAG,QAAQ;IAEzB,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;IAClC,IAAI,cAAc,GAAG,aAAa,EAAE,CAAC;QACpC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;IACxC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC;AAClE,CAAC","sourcesContent":["import { styleText } from 'node:util';\nimport type StyledText from './StyledText.js';\n\nexport default function formatName(\n\tname: string,\n\tavailableWidth = Infinity,\n): StyledText {\n\tconst visibleLength = name.length;\n\tif (availableWidth < visibleLength) {\n\t\treturn { value: '', visibleLength: 0 };\n\t}\n\n\treturn { value: styleText('yellowBright', name), visibleLength };\n}\n"]}

package/dist/ui/progress/formatProgress.d.ts

@@ -0,0 +1,4 @@
+import type { ConsoleUiContext } from '#cli/ui/UiContext.js';
+import type { GenericFormatter } from 'cli-progress';
+export default function formatProgress(ui: ConsoleUiContext, ...args: Parameters<GenericFormatter>): string;
+//# sourceMappingURL=formatProgress.d.ts.map

package/dist/ui/progress/formatProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatProgress.d.ts","sourceRoot":"","sources":["../../../src/ui/progress/formatProgress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAU,MAAM,cAAc,CAAC;AAS7D,MAAM,CAAC,OAAO,UAAU,cAAc,CACrC,EAAE,EAAE,gBAAgB,EACpB,GAAG,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,UAUrC"}

package/dist/ui/progress/formatProgress.js

@@ -0,0 +1,48 @@
+import { styleText } from 'node:util';
+import formatAction from './formatAction.js';
+import formatCounter from './formatCounter.js';
+import formatName from './formatName.js';
+import { isPayload } from './Payload.js';
+export default function formatProgress(ui, ...args) {
+    const [, params] = args;
+    const payload = args[2];
+    if (!isPayload(payload)) {
+        throw new TypeError('Invalid payload');
+    }
+    return [...components(ui, params, payload)].filter(Boolean).join(' ');
+}
+function* components(ui, params, payload) {
+    let remaining = process.stdout.columns || Infinity;
+    const counter = formatCounter(ui, params);
+    yield counter.value;
+    remaining -= counter.visibleLength + 1;
+    const bar = formatBar(params, remaining);
+    if (bar.value) {
+        yield bar.value;
+        remaining -= bar.visibleLength + 1;
+    }
+    const name = formatName(payload.name, remaining);
+    if (name.value) {
+        yield name.value;
+        remaining -= name.visibleLength + 1;
+    }
+    yield formatAction(payload, remaining).value;
+}
+function formatBar(params, availableWidth) {
+    const openGlyph = '[';
+    const closeGlyph = ']';
+    const barWidth = 40;
+    const visibleLength = openGlyph.length + barWidth + closeGlyph.length;
+    if (availableWidth < visibleLength) {
+        return { value: '', visibleLength: 0 };
+    }
+    const completeWidth = Math.round(params.progress * barWidth);
+    const remainingWidth = barWidth - completeWidth;
+    const open = styleText('dim', openGlyph);
+    const complete = styleText('greenBright', '█'.repeat(completeWidth));
+    const remaining = styleText('green', '░'.repeat(remainingWidth));
+    const close = styleText('dim', closeGlyph);
+    const value = `${open}${complete}${remaining}${close}`;
+    return { value, visibleLength };
+}
+//# sourceMappingURL=formatProgress.js.map

package/dist/ui/progress/formatProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatProgress.js","sourceRoot":"","sources":["../../../src/ui/progress/formatProgress.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ConsoleUiContext } from '#cli/ui/UiContext.js';\nimport type { GenericFormatter, Params } from 'cli-progress';\nimport { styleText } from 'node:util';\nimport formatAction from './formatAction.js';\nimport formatCounter from './formatCounter.js';\nimport formatName from './formatName.js';\nimport type Payload from './Payload.js';\nimport { isPayload } from './Payload.js';\nimport type StyledText from './StyledText.js';\n\nexport default function formatProgress(\n\tui: ConsoleUiContext,\n\t...args: Parameters<GenericFormatter>\n) {\n\tconst [, params] = args;\n\tconst payload = args[2] as unknown;\n\n\tif (!isPayload(payload)) {\n\t\tthrow new TypeError('Invalid payload');\n\t}\n\n\treturn [...components(ui, params, payload)].filter(Boolean).join(' ');\n}\n\nfunction* components(ui: ConsoleUiContext, params: Params, payload: Payload) {\n\tlet remaining = process.stdout.columns || Infinity;\n\n\tconst counter = formatCounter(ui, params);\n\tyield counter.value;\n\tremaining -= counter.visibleLength + 1;\n\n\tconst bar = formatBar(params, remaining);\n\tif (bar.value) {\n\t\tyield bar.value;\n\t\tremaining -= bar.visibleLength + 1;\n\t}\n\n\tconst name = formatName(payload.name, remaining);\n\tif (name.value) {\n\t\tyield name.value;\n\t\tremaining -= name.visibleLength + 1;\n\t}\n\n\tyield formatAction(payload, remaining).value;\n}\n\nfunction formatBar(params: Params, availableWidth: number): StyledText {\n\tconst openGlyph = '[';\n\tconst closeGlyph = ']';\n\tconst barWidth = 40;\n\tconst visibleLength = openGlyph.length + barWidth + closeGlyph.length;\n\n\tif (availableWidth < visibleLength) {\n\t\treturn { value: '', visibleLength: 0 };\n\t}\n\n\tconst completeWidth = Math.round(params.progress * barWidth);\n\tconst remainingWidth = barWidth - completeWidth;\n\n\tconst open = styleText('dim', openGlyph);\n\tconst complete = styleText('greenBright', '█'.repeat(completeWidth));\n\tconst remaining = styleText('green', '░'.repeat(remainingWidth));\n\tconst close = styleText('dim', closeGlyph);\n\tconst value = `${open}${complete}${remaining}${close}`;\n\n\treturn { value, visibleLength };\n}\n"]}

package/dist/ui/version.d.ts

@@ -0,0 +1,2 @@
+export default function version(): Promise<string>;
+//# sourceMappingURL=version.d.ts.map

package/dist/ui/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/ui/version.ts"],"names":[],"mappings":"AAGA,wBAA8B,OAAO,oBAoBpC"}

package/dist/ui/version.js

@@ -0,0 +1,21 @@
+import isRecord from '#cli/util/isRecord.js';
+import { readFile } from 'node:fs/promises';
+export default async function version() {
+    try {
+        const packageUrl = new URL('../../package.json', import.meta.url);
+        const rawPackage = await readFile(packageUrl, 'utf8');
+        const packageJson = JSON.parse(rawPackage);
+        if (!isRecord(packageJson)) {
+            throw new Error('package.json is not an object');
+        }
+        const { version: result } = packageJson;
+        if (typeof result !== 'string') {
+            throw new Error('version is not a string');
+        }
+        return result;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+//# sourceMappingURL=version.js.map

package/dist/ui/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/ui/version.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,OAAO;IACpC,IAAI,CAAC;QACJ,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACtD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAY,CAAC;QAEtD,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC;QAExC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,MAAM,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC","sourcesContent":["import isRecord from '#cli/util/isRecord.js';\nimport { readFile } from 'node:fs/promises';\n\nexport default async function version() {\n\ttry {\n\t\tconst packageUrl = new URL('../../package.json', import.meta.url);\n\t\tconst rawPackage = await readFile(packageUrl, 'utf8');\n\t\tconst packageJson = JSON.parse(rawPackage) as unknown;\n\n\t\tif (!isRecord(packageJson)) {\n\t\t\tthrow new Error('package.json is not an object');\n\t\t}\n\n\t\tconst { version: result } = packageJson;\n\n\t\tif (typeof result !== 'string') {\n\t\t\tthrow new Error('version is not a string');\n\t\t}\n\n\t\treturn result;\n\t} catch {\n\t\treturn 'unknown';\n\t}\n}\n"]}

package/dist/util/OmitIndex.d.ts

@@ -0,0 +1,5 @@
+type OmitIndex<T> = {
+    [K in keyof T as {} extends Record<K, 1> ? never : K]: T[K];
+};
+export default OmitIndex;
+//# sourceMappingURL=OmitIndex.d.ts.map

package/dist/util/OmitIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OmitIndex.d.ts","sourceRoot":"","sources":["../../src/util/OmitIndex.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,CAAC,CAAC,IAAI;KAIlB,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC3D,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/util/OmitIndex.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=OmitIndex.js.map

package/dist/util/OmitIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OmitIndex.js","sourceRoot":"","sources":["../../src/util/OmitIndex.ts"],"names":[],"mappings":"","sourcesContent":["type OmitIndex<T> = {\n\t// Justification: This is used to remove an index signature from an object\n\t// type, and the {} is needed instead of `unknown` or `object`.\n\t// eslint-disable-next-line @typescript-eslint/no-empty-object-type\n\t[K in keyof T as {} extends Record<K, 1> ? never : K]: T[K];\n};\n\nexport default OmitIndex;\n"]}

package/dist/util/escapeRegex.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Escapes special regular expression characters in a string.
+ *
+ * This function makes a string safe to use as a literal pattern in a RegExp constructor
+ * by escaping all characters that have special meaning in regular expressions.
+ *
+ * @param str - The string to escape
+ * @returns The escaped string safe for use in a RegExp pattern
+ *
+ * @example
+ * const filename = 'My.Entry.Title';
+ * const pattern = new RegExp(`^${escapeRegex(filename)}\\.yaml$`, 'u');
+ * // Creates pattern: /^My\.Entry\.Title\.yaml$/u
+ */
+export default function escapeRegex(str: string): string;
+//# sourceMappingURL=escapeRegex.d.ts.map

package/dist/util/escapeRegex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeRegex.d.ts","sourceRoot":"","sources":["../../src/util/escapeRegex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/util/escapeRegex.js

@@ -0,0 +1,18 @@
+/**
+ * Escapes special regular expression characters in a string.
+ *
+ * This function makes a string safe to use as a literal pattern in a RegExp constructor
+ * by escaping all characters that have special meaning in regular expressions.
+ *
+ * @param str - The string to escape
+ * @returns The escaped string safe for use in a RegExp pattern
+ *
+ * @example
+ * const filename = 'My.Entry.Title';
+ * const pattern = new RegExp(`^${escapeRegex(filename)}\\.yaml$`, 'u');
+ * // Creates pattern: /^My\.Entry\.Title\.yaml$/u
+ */
+export default function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
+}
+//# sourceMappingURL=escapeRegex.js.map

package/dist/util/escapeRegex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeRegex.js","sourceRoot":"","sources":["../../src/util/escapeRegex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,GAAW;IAC9C,OAAO,GAAG,CAAC,OAAO,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC","sourcesContent":["/**\n * Escapes special regular expression characters in a string.\n *\n * This function makes a string safe to use as a literal pattern in a RegExp constructor\n * by escaping all characters that have special meaning in regular expressions.\n *\n * @param str - The string to escape\n * @returns The escaped string safe for use in a RegExp pattern\n *\n * @example\n * const filename = 'My.Entry.Title';\n * const pattern = new RegExp(`^${escapeRegex(filename)}\\\\.yaml$`, 'u');\n * // Creates pattern: /^My\\.Entry\\.Title\\.yaml$/u\n */\nexport default function escapeRegex(str: string): string {\n\treturn str.replace(/[.*+?^${}()|[\\]\\\\]/gu, '\\\\$&');\n}\n"]}

package/dist/util/isRecord.d.ts

@@ -0,0 +1,2 @@
+export default function isRecord(o: unknown): o is Record<string, unknown>;
+//# sourceMappingURL=isRecord.d.ts.map

package/dist/util/isRecord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isRecord.d.ts","sourceRoot":"","sources":["../../src/util/isRecord.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}

package/dist/util/isRecord.js

@@ -0,0 +1,4 @@
+export default function isRecord(o) {
+    return o !== null && typeof o === 'object';
+}
+//# sourceMappingURL=isRecord.js.map

package/dist/util/isRecord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isRecord.js","sourceRoot":"","sources":["../../src/util/isRecord.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,CAAU;IAC1C,OAAO,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC;AAC5C,CAAC","sourcesContent":["export default function isRecord(o: unknown): o is Record<string, unknown> {\n\treturn o !== null && typeof o === 'object';\n}\n"]}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "author": "Chris Nielsen <cnielsen@arke.com>",
+  "bin": {
+    "beacon": "./dist/beacon.js"
+  },
+  "bugs": "https://github.com/Arke-Systems/beacon/issues",
+  "dependencies": {
+    "@arke-systems/cs-rate-limit-middleware": "^1.0.4",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "asciichart": "^1.5.25",
+    "cli-progress": "^3.12.0",
+    "commander": "^14.0.2",
+    "http-status-codes": "^2.3.0",
+    "mime": "^4.1.0",
+    "minimatch": "^10.1.1",
+    "openapi-fetch": "^0.15.0",
+    "sanitize-filename": "^1.6.3",
+    "tslib": "^2.8.1",
+    "yaml": "^2.8.2"
+  },
+  "description": "Beacon facilitates serialization and deserialization of Contentstack content",
+  "devDependencies": {
+    "@types/asciichart": "^1.5.8",
+    "@types/cli-progress": "^3.11.6",
+    "@types/node": "^22.19.3",
+    "json-schema-to-typescript": "^15.0.4",
+    "openapi-typescript": "^7.10.1",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "homepage": "https://github.com/Arke-Systems/beacon",
+  "imports": {
+    "#cli/*": "./dist/*"
+  },
+  "license": "MIT",
+  "name": "@arkebcacy/beacon-cli-temp",
+  "publishConfig": {
+    "executableFiles": [
+      "./dist/beacon.js"
+    ]
+  },
+  "repository": "github:Arke-Systems/beacon",
+  "scripts": {
+    "build": "node ./build/build.js",
+    "clean": "node ./build/clean.js",
+    "generate": "node ./build/generate.js",
+    "prepack": "node ./build/prepack.js"
+  },
+  "type": "module",
+  "version": "0.1.1"
+}

package/src/beacon.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import clear from './ui/command/clear.js';
+import pull from './ui/command/pull.js';
+import push from './ui/command/push.js';
+import version from './ui/version.js';
+
+const program = new Command();
+
+program
+	.version(await version())
+	.description('Beacon CLI')
+	.addCommand(clear)
+	.addCommand(pull)
+	.addCommand(push);
+
+await program.parseAsync();

package/src/cfg/CliOptions.ts

@@ -0,0 +1,7 @@
+import type { PathLike } from 'node:fs';
+import type { PartialOptions } from '../ui/PartialOptions.js';
+
+export type CliOptions = PartialOptions & {
+	readonly configFile: PathLike;
+	readonly namedEnvironment?: string | undefined;
+};

package/src/cfg/Config.schema.d.yaml.ts

@@ -0,0 +1,94 @@
+/* eslint-disable */
+/**
+ * This file was automatically generated by json-schema-to-typescript.
+ * DO NOT MODIFY IT BY HAND. Instead, modify the source JSONSchema file,
+ * and run json-schema-to-typescript to regenerate this file.
+ */
+
+export interface Config {
+  client?: {
+    "api-key"?: string;
+    "base-url"?: string;
+    branch?: string;
+    "management-token"?: string;
+    timeout?: number;
+  };
+  schema?: {
+    "deletion-strategy"?: "delete" | "ignore" | "warn";
+    extension?: {
+      [k: string]: string;
+    };
+    "json-rte-plugin"?: {
+      [k: string]: string;
+    };
+    "schema-path"?: string;
+    /**
+     * Include or exclude assets using glob patterns.
+     */
+    assets?: {
+      include?: string[];
+      exclude?: string[];
+    };
+    /**
+     * Determine whether to serialize taxonomy terms or just the
+     * taxonomy structure.
+     *
+     */
+    taxonomies?: {
+      [k: string]: "only taxonomy" | "taxonomy and terms";
+    };
+  };
+  verbose?: boolean;
+  /**
+   * An optional list of named environments. Environment names are arbitrary.
+   *
+   * Named environments may be targetted using the `--environment` option.
+   *
+   * If specified, an environment's settings will be merged with the base
+   * settings:
+   *
+   *   - `schema.extension`, `schema.json-rte-plugin`, and `schema.taxonomies`
+   *     are merged.
+   *
+   *   - `schema.assets.include` and `schema.assets.exclude` are concatenated.
+   *
+   *   - All other values will prefer the named environment.
+   *
+   */
+  environments?: {
+    [k: string]: {
+      client?: {
+        "api-key"?: string;
+        "base-url"?: string;
+        branch?: string;
+        "management-token"?: string;
+        timeout?: number;
+      };
+      schema?: {
+        "deletion-strategy"?: "delete" | "ignore" | "warn";
+        extension?: {
+          [k: string]: string;
+        };
+        "json-rte-plugin"?: {
+          [k: string]: string;
+        };
+        "schema-path"?: string;
+        /**
+         * Include or exclude assets using glob patterns.
+         */
+        assets?: {
+          include?: string[];
+          exclude?: string[];
+        };
+        /**
+         * Determine whether to serialize taxonomy terms or just the
+         * taxonomy structure.
+         *
+         */
+        taxonomies?: {
+          [k: string]: "only taxonomy" | "taxonomy and terms";
+        };
+      };
+    };
+  };
+}

package/src/cfg/Config.schema.yaml

@@ -0,0 +1,122 @@
+# yaml-language-server: $schema=http://json-schema.org/draft-07/schema
+
+type: object
+additionalProperties: false
+properties:
+  client: &client
+    type: object
+    additionalProperties: false
+    properties:
+      api-key:
+        type: string
+        minLength: 1
+
+      base-url:
+        type: string
+        minLength: 8
+        format: uri
+
+      branch:
+        type: string
+        minLength: 1
+        default: main
+
+      management-token:
+        type: string
+        minLength: 1
+
+      timeout:
+        type: integer
+        minimum: 1
+        default: 10000
+
+  schema: &schema
+    type: object
+    additionalProperties: false
+    properties:
+      deletion-strategy:
+        type: string
+        enum: ['delete', 'ignore', 'warn']
+        default: warn
+
+      extension:
+        type: object
+        minProperties: 1
+        additionalProperties:
+          type: string
+          minLength: 1
+
+      json-rte-plugin:
+        type: object
+        minProperties: 1
+        additionalProperties:
+          type: string
+          minLength: 1
+
+      schema-path:
+        type: string
+        minLength: 1
+
+      assets:
+        type: object
+        additionalProperties: false
+        description: Include or exclude assets using glob patterns.
+        default:
+          include: ['**']
+          exclude: []
+        properties:
+          include:
+            type: array
+            items:
+              type: string
+              minLength: 1
+          exclude:
+            type: array
+            items:
+              type: string
+              minLength: 1
+
+      taxonomies:
+        type: object
+        minProperties: 1
+
+        description: |
+          Determine whether to serialize taxonomy terms or just the
+          taxonomy structure.
+
+        additionalProperties:
+          type: string
+          enum: ['only taxonomy', 'taxonomy and terms']
+        default:
+          '*': 'taxonomy and terms'
+
+  verbose:
+    type: boolean
+    default: false
+
+  environments:
+    type: object
+    minProperties: 1
+
+    description: |
+      An optional list of named environments. Environment names are arbitrary.
+
+      Named environments may be targetted using the `--environment` option.
+
+      If specified, an environment's settings will be merged with the base
+      settings:
+
+        - `schema.extension`, `schema.json-rte-plugin`, and `schema.taxonomies`
+          are merged.
+
+        - `schema.assets.include` and `schema.assets.exclude` are concatenated.
+
+        - All other values will prefer the named environment.
+
+    additionalProperties:
+      type: object
+      minProperties: 1
+      additionalProperties: false
+      properties:
+        client: *client
+        schema: *schema

package/src/cfg/ConfigMissingError.ts

@@ -0,0 +1,6 @@
+export default class ConfigMissingError extends Error {
+	public constructor(message: string) {
+		super(message);
+		this.name = 'ConfigMissingError';
+	}
+}

package/src/cfg/ConfigurationError.ts

@@ -0,0 +1,28 @@
+import type { ErrorObject } from 'ajv';
+import { Ajv } from 'ajv';
+import type { PathLike } from 'node:fs';
+import { inspect } from 'node:util';
+import HandledError from '../ui/HandledError.js';
+import createStylus from '../ui/createStylus.js';
+
+export default class ConfigurationError extends HandledError {
+	public constructor(
+		public readonly configPath: PathLike,
+		public readonly details: ErrorObject[] | null | undefined,
+	) {
+		const ajv = new Ajv();
+
+		const y = createStylus('yellowBright');
+		const msg1 = y`Configuration file ${String(configPath)} is invalid:\n\t`;
+
+		const msg2 = ajv.errorsText(details, {
+			dataVar: 'config',
+			separator: '\n\t',
+		});
+
+		const msg3 = inspect(details, { colors: true, depth: 3 });
+
+		super(`${msg1}${msg2}\n\n${msg3}`);
+		this.name = 'ConfigurationError';
+	}
+}

package/src/cfg/createSchemaValidationFn.ts

@@ -0,0 +1,23 @@
+import { Ajv } from 'ajv';
+import formats from 'ajv-formats';
+import readYaml from '../fs/readYaml.js';
+import isRecord from '../util/isRecord.js';
+import type { Config } from './Config.schema.yaml';
+
+export default async function createSchemaValidationFn() {
+	const ajv = new Ajv();
+
+	// I'm having trouble getting both TSC and ESLint to agree that the
+	// default export of `ajv-formats` is a `FormatsPlugin`, and thus
+	// a callable function.
+	const addFormats = formats as unknown as (ajv: Ajv) => void;
+	addFormats(ajv);
+
+	const schemaUrl = new URL('./Config.schema.yaml', import.meta.url);
+	const schema = await readYaml(schemaUrl);
+	if (!isRecord(schema)) {
+		throw new Error('Invalid schema');
+	}
+
+	return ajv.compile<Config>(schema);
+}

package/src/cfg/defaultValues.ts

@@ -0,0 +1,12 @@
+import { defaultValue as timeout } from '../ui/option/apiTimeout.js';
+import { defaultValue as branch } from '../ui/option/branch.js';
+import { defaultValue as configFile } from '../ui/option/configFile.js';
+import { defaultValue as strategy } from '../ui/option/deletionStrategy.js';
+import { defaultValue as schemaPath } from '../ui/option/schemaPath.js';
+import type { CliOptions } from './CliOptions.js';
+
+export const defaultValues = {
+	client: { branch, timeout },
+	configFile: configFile,
+	schema: { deletionStrategy: strategy, schemaPath },
+} as const satisfies CliOptions;