@boneskull/bargs 0.1.1

package/dist/validate.js

@@ -0,0 +1,448 @@
+/**
+ * Configuration validation for bargs.
+ *
+ * Validates bargs configuration objects at runtime before parsing, ensuring:
+ *
+ * - Required properties are present and correctly typed
+ * - Option definitions have valid type discriminators and defaults
+ * - Aliases are single characters with no conflicts
+ * - Positional schemas have variadic args last and required args before optional
+ * - Command handlers are properly defined
+ * - Command-based CLIs don't have top-level positionals or handlers
+ *
+ * Throws {@link ValidationError} with detailed path information when invalid.
+ *
+ * @packageDocumentation
+ */
+import { ValidationError } from "./errors.js";
+/** Valid option type discriminators */
+const VALID_OPTION_TYPES = [
+    'string',
+    'boolean',
+    'number',
+    'enum',
+    'array',
+    'count',
+];
+/** Valid positional type discriminators */
+const VALID_POSITIONAL_TYPES = [
+    'string',
+    'number',
+    'enum',
+    'variadic',
+];
+/** Valid array/variadic item types */
+const VALID_ITEM_TYPES = ['string', 'number'];
+// ─── Primitive Helpers ──────────────────────────────────────────────────────
+const isObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const isFunction = (value) => typeof value === 'function';
+const isStringArray = (value) => Array.isArray(value) && value.every((v) => typeof v === 'string');
+const isNumberArray = (value) => Array.isArray(value) && value.every((v) => typeof v === 'number');
+// ─── Option Validation ──────────────────────────────────────────────────────
+/**
+ * Validate a single option definition.
+ */
+const validateOption = (name, opt, path, allAliases) => {
+    if (!isObject(opt)) {
+        throw new ValidationError(path, 'option must be an object');
+    }
+    // Validate type discriminator
+    const type = opt['type'];
+    if (typeof type !== 'string') {
+        throw new ValidationError(`${path}.type`, 'must be a string');
+    }
+    if (!VALID_OPTION_TYPES.includes(type)) {
+        throw new ValidationError(`${path}.type`, `must be one of: ${VALID_OPTION_TYPES.join(', ')}`);
+    }
+    // Validate optional description
+    if (opt['description'] !== undefined &&
+        typeof opt['description'] !== 'string') {
+        throw new ValidationError(`${path}.description`, 'must be a string');
+    }
+    // Validate optional group
+    if (opt['group'] !== undefined && typeof opt['group'] !== 'string') {
+        throw new ValidationError(`${path}.group`, 'must be a string');
+    }
+    // Validate optional hidden
+    if (opt['hidden'] !== undefined && typeof opt['hidden'] !== 'boolean') {
+        throw new ValidationError(`${path}.hidden`, 'must be a boolean');
+    }
+    // Validate optional required
+    if (opt['required'] !== undefined && typeof opt['required'] !== 'boolean') {
+        throw new ValidationError(`${path}.required`, 'must be a boolean');
+    }
+    // Validate aliases
+    if (opt['aliases'] !== undefined) {
+        if (!isStringArray(opt['aliases'])) {
+            throw new ValidationError(`${path}.aliases`, 'must be an array of strings');
+        }
+        for (let i = 0; i < opt['aliases'].length; i++) {
+            const alias = opt['aliases'][i];
+            if (alias.length !== 1) {
+                throw new ValidationError(`${path}.aliases[${i}]`, `alias must be a single character, got "${alias}"`);
+            }
+            // Check for duplicates
+            const existingOption = allAliases.get(alias);
+            if (existingOption !== undefined) {
+                throw new ValidationError(`${path}.aliases[${i}]`, `alias "${alias}" is already used by option "${existingOption}"`);
+            }
+            allAliases.set(alias, name);
+        }
+    }
+    // Type-specific validation
+    switch (type) {
+        case 'array': {
+            const items = opt['items'];
+            if (typeof items !== 'string') {
+                throw new ValidationError(`${path}.items`, 'must be "string" or "number"');
+            }
+            if (!VALID_ITEM_TYPES.includes(items)) {
+                throw new ValidationError(`${path}.items`, 'must be "string" or "number"');
+            }
+            if (opt['default'] !== undefined) {
+                if (items === 'string') {
+                    if (!isStringArray(opt['default'])) {
+                        throw new ValidationError(`${path}.default`, 'must be an array of strings');
+                    }
+                }
+                else {
+                    if (!isNumberArray(opt['default'])) {
+                        throw new ValidationError(`${path}.default`, 'must be an array of numbers');
+                    }
+                }
+            }
+            break;
+        }
+        case 'boolean':
+            if (opt['default'] !== undefined && typeof opt['default'] !== 'boolean') {
+                throw new ValidationError(`${path}.default`, 'must be a boolean');
+            }
+            break;
+        case 'count':
+            if (opt['default'] !== undefined && typeof opt['default'] !== 'number') {
+                throw new ValidationError(`${path}.default`, 'must be a number');
+            }
+            break;
+        case 'enum': {
+            const choices = opt['choices'];
+            if (!isStringArray(choices)) {
+                throw new ValidationError(`${path}.choices`, 'must be a non-empty array of strings');
+            }
+            if (choices.length === 0) {
+                throw new ValidationError(`${path}.choices`, 'must not be empty');
+            }
+            if (opt['default'] !== undefined) {
+                if (typeof opt['default'] !== 'string') {
+                    throw new ValidationError(`${path}.default`, 'must be a string');
+                }
+                if (!choices.includes(opt['default'])) {
+                    throw new ValidationError(`${path}.default`, `must be one of the choices: ${choices.join(', ')}`);
+                }
+            }
+            break;
+        }
+        case 'number':
+            if (opt['default'] !== undefined && typeof opt['default'] !== 'number') {
+                throw new ValidationError(`${path}.default`, 'must be a number');
+            }
+            break;
+        case 'string':
+            if (opt['default'] !== undefined && typeof opt['default'] !== 'string') {
+                throw new ValidationError(`${path}.default`, 'must be a string');
+            }
+            break;
+    }
+};
+/**
+ * Validate an options schema.
+ */
+const validateOptionsSchema = (schema, path, allAliases = new Map()) => {
+    if (schema === undefined) {
+        return; // optional
+    }
+    if (!isObject(schema)) {
+        throw new ValidationError(path, 'must be an object');
+    }
+    for (const [name, opt] of Object.entries(schema)) {
+        validateOption(name, opt, `${path}.${name}`, allAliases);
+    }
+};
+// ─── Positional Validation ──────────────────────────────────────────────────
+/**
+ * Validate a single positional definition.
+ */
+const validatePositional = (index, pos, path) => {
+    if (!isObject(pos)) {
+        throw new ValidationError(path, 'positional must be an object');
+    }
+    // Validate type discriminator
+    const type = pos['type'];
+    if (typeof type !== 'string') {
+        throw new ValidationError(`${path}.type`, 'must be a string');
+    }
+    if (!VALID_POSITIONAL_TYPES.includes(type)) {
+        throw new ValidationError(`${path}.type`, `must be one of: ${VALID_POSITIONAL_TYPES.join(', ')}`);
+    }
+    // Validate optional description
+    if (pos['description'] !== undefined &&
+        typeof pos['description'] !== 'string') {
+        throw new ValidationError(`${path}.description`, 'must be a string');
+    }
+    // Validate optional name
+    if (pos['name'] !== undefined && typeof pos['name'] !== 'string') {
+        throw new ValidationError(`${path}.name`, 'must be a string');
+    }
+    // Validate optional required
+    if (pos['required'] !== undefined && typeof pos['required'] !== 'boolean') {
+        throw new ValidationError(`${path}.required`, 'must be a boolean');
+    }
+    // Type-specific validation
+    switch (type) {
+        case 'enum': {
+            const choices = pos['choices'];
+            if (!isStringArray(choices)) {
+                throw new ValidationError(`${path}.choices`, 'must be a non-empty array of strings');
+            }
+            if (choices.length === 0) {
+                throw new ValidationError(`${path}.choices`, 'must not be empty');
+            }
+            if (pos['default'] !== undefined) {
+                if (typeof pos['default'] !== 'string') {
+                    throw new ValidationError(`${path}.default`, 'must be a string');
+                }
+                if (!choices.includes(pos['default'])) {
+                    throw new ValidationError(`${path}.default`, `must be one of the choices: ${choices.join(', ')}`);
+                }
+            }
+            break;
+        }
+        case 'number':
+            if (pos['default'] !== undefined && typeof pos['default'] !== 'number') {
+                throw new ValidationError(`${path}.default`, 'must be a number');
+            }
+            break;
+        case 'string':
+            if (pos['default'] !== undefined && typeof pos['default'] !== 'string') {
+                throw new ValidationError(`${path}.default`, 'must be a string');
+            }
+            break;
+        case 'variadic': {
+            const items = pos['items'];
+            if (typeof items !== 'string') {
+                throw new ValidationError(`${path}.items`, 'must be "string" or "number"');
+            }
+            if (!VALID_ITEM_TYPES.includes(items)) {
+                throw new ValidationError(`${path}.items`, 'must be "string" or "number"');
+            }
+            break;
+        }
+    }
+};
+/**
+ * Validate a positionals schema. Checks:
+ *
+ * - Each positional has valid structure
+ * - Variadic positional (if present) is last
+ * - Required positionals don't follow optional ones
+ */
+const validatePositionalsSchema = (schema, path) => {
+    if (schema === undefined) {
+        return; // optional
+    }
+    if (!Array.isArray(schema)) {
+        throw new ValidationError(path, 'must be an array');
+    }
+    // Validate each positional
+    for (let i = 0; i < schema.length; i++) {
+        validatePositional(i, schema[i], `${path}[${i}]`);
+    }
+    // Check variadic is last
+    const variadicIndex = schema.findIndex((p) => isObject(p) && p['type'] === 'variadic');
+    if (variadicIndex !== -1 && variadicIndex !== schema.length - 1) {
+        throw new ValidationError(`${path}[${variadicIndex}]`, 'variadic positional must be the last positional argument');
+    }
+    // Check required doesn't follow optional
+    let seenOptional = false;
+    for (let i = 0; i < schema.length; i++) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const pos = schema[i];
+        if (!isObject(pos)) {
+            continue;
+        }
+        const isOptional = pos['required'] !== true &&
+            !('default' in pos && pos['default'] !== undefined);
+        const isVariadic = pos['type'] === 'variadic';
+        if (isOptional) {
+            seenOptional = true;
+        }
+        else if (seenOptional && !isVariadic) {
+            throw new ValidationError(`${path}[${i}]`, 'required positional cannot follow an optional positional');
+        }
+    }
+};
+// ─── Handler Validation ─────────────────────────────────────────────────────
+/**
+ * Validate a handler (function or array of functions).
+ */
+const validateHandler = (handler, path) => {
+    if (handler === undefined) {
+        return; // handlers are optional in some contexts
+    }
+    if (Array.isArray(handler)) {
+        if (handler.length === 0) {
+            throw new ValidationError(path, 'handler array must not be empty');
+        }
+        for (let i = 0; i < handler.length; i++) {
+            if (!isFunction(handler[i])) {
+                throw new ValidationError(`${path}[${i}]`, 'must be a function');
+            }
+        }
+    }
+    else if (!isFunction(handler)) {
+        throw new ValidationError(path, 'must be a function or array of functions');
+    }
+};
+// ─── Command Validation ─────────────────────────────────────────────────────
+/**
+ * Validate a single command configuration.
+ */
+const validateCommand = (name, cmd, path, globalAliases) => {
+    if (!isObject(cmd)) {
+        throw new ValidationError(path, 'command must be an object');
+    }
+    // description is required
+    if (typeof cmd['description'] !== 'string') {
+        throw new ValidationError(`${path}.description`, 'must be a string');
+    }
+    // handler is required for commands
+    if (cmd['handler'] === undefined) {
+        throw new ValidationError(`${path}.handler`, 'is required');
+    }
+    validateHandler(cmd['handler'], `${path}.handler`);
+    // Validate options (command-local aliases only, no collision with globals)
+    // Create a new alias map that includes global aliases for collision detection
+    const commandAliases = new Map(globalAliases);
+    validateOptionsSchema(cmd['options'], `${path}.options`, commandAliases);
+    // Validate positionals
+    validatePositionalsSchema(cmd['positionals'], `${path}.positionals`);
+};
+/**
+ * Validate commands record.
+ */
+const validateCommands = (commands, path, globalAliases) => {
+    if (!isObject(commands)) {
+        throw new ValidationError(path, 'must be an object');
+    }
+    const commandNames = Object.keys(commands);
+    if (commandNames.length === 0) {
+        throw new ValidationError(path, 'must have at least one command');
+    }
+    for (const [name, cmd] of Object.entries(commands)) {
+        validateCommand(name, cmd, `${path}.${name}`, globalAliases);
+    }
+    return new Set(commandNames);
+};
+// ─── Main Config Validation ─────────────────────────────────────────────────
+/**
+ * Validate base config properties common to both simple and command-based CLIs.
+ */
+const validateBaseConfig = (config, path) => {
+    if (!isObject(config)) {
+        throw new ValidationError(path, 'config must be an object');
+    }
+    // name is required
+    if (typeof config['name'] !== 'string') {
+        throw new ValidationError(`${path}.name`, 'must be a string');
+    }
+    if (config['name'].length === 0) {
+        throw new ValidationError(`${path}.name`, 'must not be empty');
+    }
+    // description is optional
+    if (config['description'] !== undefined &&
+        typeof config['description'] !== 'string') {
+        throw new ValidationError(`${path}.description`, 'must be a string');
+    }
+    // version is optional
+    if (config['version'] !== undefined &&
+        typeof config['version'] !== 'string') {
+        throw new ValidationError(`${path}.version`, 'must be a string');
+    }
+    // args is optional
+    if (config['args'] !== undefined && !isStringArray(config['args'])) {
+        throw new ValidationError(`${path}.args`, 'must be an array of strings');
+    }
+    // Validate options
+    const aliases = new Map();
+    validateOptionsSchema(config['options'], `${path}.options`, aliases);
+    return { aliases, configObj: config };
+};
+/**
+ * Check if config appears to be a command-based CLI. Returns true if commands
+ * property exists (even if empty - validation will catch that).
+ */
+const isCommandConfig = (config) => {
+    return config['commands'] !== undefined;
+};
+/**
+ * Validate a simple CLI config (no commands).
+ */
+const validateSimpleConfig = (config, path, _aliases) => {
+    // Validate positionals
+    validatePositionalsSchema(config['positionals'], `${path}.positionals`);
+    // Validate handler (optional for simple CLI)
+    validateHandler(config['handler'], `${path}.handler`);
+};
+/**
+ * Validate a command-based CLI config.
+ */
+const validateCommandConfig = (config, path, aliases) => {
+    // Commands must exist and have entries
+    const commandNames = validateCommands(config['commands'], `${path}.commands`, aliases);
+    // Positionals should not be present at top level
+    if (config['positionals'] !== undefined) {
+        const positionals = config['positionals'];
+        if (Array.isArray(positionals) && positionals.length > 0) {
+            throw new ValidationError(`${path}.positionals`, 'top-level positionals are not allowed in command-based CLIs (define them per-command)');
+        }
+    }
+    // handler should not be present (use defaultHandler instead)
+    if (config['handler'] !== undefined) {
+        throw new ValidationError(`${path}.handler`, 'use defaultHandler for command-based CLIs');
+    }
+    // Validate defaultHandler
+    const defaultHandler = config['defaultHandler'];
+    if (defaultHandler !== undefined) {
+        if (typeof defaultHandler === 'string') {
+            // Must reference an existing command
+            if (!commandNames.has(defaultHandler)) {
+                throw new ValidationError(`${path}.defaultHandler`, `must reference an existing command, got "${defaultHandler}"`);
+            }
+        }
+        else if (Array.isArray(defaultHandler)) {
+            // Array of handlers
+            validateHandler(defaultHandler, `${path}.defaultHandler`);
+        }
+        else if (!isFunction(defaultHandler)) {
+            throw new ValidationError(`${path}.defaultHandler`, 'must be a function, array of functions, or command name string');
+        }
+    }
+};
+/**
+ * Validate a bargs configuration object. Throws ValidationError if invalid.
+ *
+ * This validates both simple CLI configs (BargsConfig) and command-based CLI
+ * configs (BargsConfigWithCommands).
+ *
+ * @param config - The configuration to validate
+ * @throws ValidationError if the config is invalid
+ */
+export const validateConfig = (config) => {
+    const { aliases, configObj } = validateBaseConfig(config, 'config');
+    if (isCommandConfig(configObj)) {
+        validateCommandConfig(configObj, 'config', aliases);
+    }
+    else {
+        validateSimpleConfig(configObj, 'config', aliases);
+    }
+};
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/dist/version.cjs

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * Package version and metadata detection utilities.
+ *
+ * Provides functions to locate and read `package.json` files by walking up the
+ * directory tree, extracting version strings, and gathering package metadata
+ * (homepage, repository URLs) for automatic epilog generation in help output.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readPackageInfoSync = exports.detectVersion = void 0;
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+/**
+ * Normalize a repository URL to clean HTTPS format. Strips leading `git+` and
+ * trailing `.git`.
+ */
+const normalizeRepoUrl = (url) => {
+    return url.replace(/^git\+/, '').replace(/\.git$/, '');
+};
+/**
+ * Validate that a URL is HTTPS. Returns the URL if valid, undefined otherwise.
+ */
+const validateHttpsUrl = (url) => {
+    if (!url) {
+        return undefined;
+    }
+    return url.startsWith('https://') ? url : undefined;
+};
+/**
+ * Extract repository URL from package.json repository field. Handles both
+ * string and object forms.
+ */
+const extractRepoUrl = (repository) => {
+    if (!repository) {
+        return undefined;
+    }
+    const rawUrl = typeof repository === 'string' ? repository : repository.url;
+    if (!rawUrl) {
+        return undefined;
+    }
+    const normalized = normalizeRepoUrl(rawUrl);
+    return validateHttpsUrl(normalized);
+};
+/**
+ * Find package.json by walking up from startDir (async).
+ */
+const findPackageJson = async (startDir) => {
+    let dir = startDir;
+    let prevDir = '';
+    while (dir !== prevDir) {
+        const pkgPath = (0, node_path_1.join)(dir, 'package.json');
+        try {
+            await (0, promises_1.readFile)(pkgPath, 'utf-8');
+            return pkgPath;
+        }
+        catch {
+            prevDir = dir;
+            dir = (0, node_path_1.dirname)(dir);
+        }
+    }
+    return undefined;
+};
+/**
+ * Find package.json by walking up from startDir (sync).
+ */
+const findPackageJsonSync = (startDir) => {
+    let dir = startDir;
+    let prevDir = '';
+    while (dir !== prevDir) {
+        const pkgPath = (0, node_path_1.join)(dir, 'package.json');
+        try {
+            (0, node_fs_1.readFileSync)(pkgPath, 'utf-8');
+            return pkgPath;
+        }
+        catch {
+            prevDir = dir;
+            dir = (0, node_path_1.dirname)(dir);
+        }
+    }
+    return undefined;
+};
+/**
+ * Read version from package.json (async).
+ */
+const readVersionFromPackageJson = async (pkgPath) => {
+    try {
+        const content = await (0, promises_1.readFile)(pkgPath, 'utf-8');
+        const pkg = JSON.parse(content);
+        return pkg.version;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Detect version: use provided version or read from nearest package.json.
+ */
+const detectVersion = async (providedVersion, startDir = process.cwd()) => {
+    if (providedVersion) {
+        return providedVersion;
+    }
+    const pkgPath = await findPackageJson(startDir);
+    if (!pkgPath) {
+        return undefined;
+    }
+    return readVersionFromPackageJson(pkgPath);
+};
+exports.detectVersion = detectVersion;
+/**
+ * Read package info (homepage, repository) from package.json synchronously.
+ * Returns only HTTPS URLs; other URL schemes are omitted.
+ */
+const readPackageInfoSync = (startDir = process.cwd()) => {
+    const pkgPath = findPackageJsonSync(startDir);
+    if (!pkgPath) {
+        return {};
+    }
+    try {
+        const content = (0, node_fs_1.readFileSync)(pkgPath, 'utf-8');
+        const pkg = JSON.parse(content);
+        return {
+            homepage: validateHttpsUrl(pkg.homepage),
+            repository: extractRepoUrl(pkg.repository),
+        };
+    }
+    catch {
+        return {};
+    }
+};
+exports.readPackageInfoSync = readPackageInfoSync;
+//# sourceMappingURL=version.js.map

package/dist/version.cjs.map

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

package/dist/version.d.cts

@@ -0,0 +1,27 @@
+/**
+ * Package version and metadata detection utilities.
+ *
+ * Provides functions to locate and read `package.json` files by walking up the
+ * directory tree, extracting version strings, and gathering package metadata
+ * (homepage, repository URLs) for automatic epilog generation in help output.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Package info extracted from `package.json` for epilog generation.
+ */
+interface PackageInfo {
+    homepage?: string;
+    repository?: string;
+}
+/**
+ * Detect version: use provided version or read from nearest package.json.
+ */
+export declare const detectVersion: (providedVersion: string | undefined, startDir?: string) => Promise<string | undefined>;
+/**
+ * Read package info (homepage, repository) from package.json synchronously.
+ * Returns only HTTPS URLs; other URL schemes are omitted.
+ */
+export declare const readPackageInfoSync: (startDir?: string) => PackageInfo;
+export {};
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAqHD;;GAEG;AACH,eAAO,MAAM,aAAa,GACxB,iBAAiB,MAAM,GAAG,SAAS,EACnC,WAAU,MAAsB,KAC/B,OAAO,CAAC,MAAM,GAAG,SAAS,CAW5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,WAAU,MAAsB,KAC/B,WAiBF,CAAC"}