@actsecurity/cli 0.2.66

package/dist/esm/cli.js

@@ -0,0 +1,494 @@
+import {} from './arguments/argument.js';
+import { exit } from './utils.js';
+/**
+ * Parse CLI Arguments and return the parsed typesafe results.
+ *
+ * @param command the name of the command arguments are being parsed for.
+ * @param subcommands the list of subcommands that can be used, if any.
+ * @param cliArgs the configuration options for the CLI command.
+ * @param additionalOptions additional arguments to be used for parsing and displaying help.
+ * @returns the parsed arguments, operands, and subcommand if applicable.
+ */
+export async function parseCliArguments(command, subcommands, cliArgs, additionalOptions) {
+    const args = additionalOptions?.args ?? process.argv.slice(2);
+    const env = additionalOptions?.env ?? process.env;
+    const parsedArgs = {};
+    const operands = [];
+    const booleanOptions = {};
+    const subcommandKeys = Object.keys(subcommands);
+    const numberOfSubcommands = subcommandKeys.length;
+    const combinedOptions = { ...cliArgs };
+    const logger = additionalOptions?.consoleLogger ?? console;
+    let subcommand;
+    const expectOperands = Object.hasOwn(additionalOptions || {}, 'expectOperands')
+        ? !!additionalOptions?.expectOperands
+        : true;
+    if (args.length === 0 && additionalOptions?.showHelpIfNoArgs) {
+        printHelpContents(command, subcommands, cliArgs, additionalOptions);
+        exit(0, undefined);
+        return {};
+    }
+    const allDefaults = {};
+    const isSetByCli = {};
+    // Step 1: Initialize defaults
+    const parsedEnvironmentArgs = {};
+    initializeOptionDefaults(allDefaults, booleanOptions, cliArgs);
+    // Step 2: Handle environment variables
+    await parseEnvironmentVariables(cliArgs, parsedEnvironmentArgs, env, additionalOptions?.envPrefix, isSetByCli);
+    // Step 3: Group arguments into objects
+    const commandChunks = groupArguments(args);
+    // Step 4: Validation and parsing arguments
+    for (const { first, rest, isLast, isFirst } of commandChunks) {
+        // Handle --help and --version
+        if (first === '--help') {
+            printHelpContents(command, subcommands, cliArgs, additionalOptions, subcommand);
+            exit(0, undefined);
+            return {};
+        }
+        if (first === '--version') {
+            if (additionalOptions?.version) {
+                await printVersion(additionalOptions.version, logger);
+                exit(0, undefined);
+                return {};
+            }
+        }
+        // Handle commands if applicable
+        if (isFirst && !first.startsWith('-')) {
+            if (numberOfSubcommands === 0) {
+                if (isLast) {
+                    operands.push(first, ...rest);
+                }
+                else {
+                    exit(2, `Invalid: ${first}, all arguments must specified using a --argument`);
+                }
+            }
+            else {
+                if (!isLast && rest.length > 0) {
+                    exit(2, `Arguments must be specified using a --argument, ${rest.join(' ')} is ambiguous`);
+                }
+                const matchingCommands = subcommandKeys.filter((cmd) => cmd.toLowerCase().startsWith(first.toLowerCase()));
+                if (matchingCommands.length === 0) {
+                    exit(2, `Unknown command: ${first}`);
+                    return {};
+                }
+                else if (matchingCommands.length > 1) {
+                    exit(2, `Ambiguous command: ${first}`);
+                    return {};
+                }
+                subcommand = matchingCommands.at(0);
+                const subcommandOptions = subcommands[subcommand].arguments;
+                initializeOptionDefaults(allDefaults, booleanOptions, subcommandOptions);
+                await parseEnvironmentVariables(subcommandOptions, parsedEnvironmentArgs, env, additionalOptions?.envPrefix, isSetByCli);
+                for (const [key, option] of Object.entries(subcommandOptions)) {
+                    combinedOptions[key] = option;
+                }
+                operands.push(...rest);
+            }
+        }
+        // Validate options
+        if (first == '--') {
+            if (!expectOperands) {
+                exit(2, `Operands are not expected but '--' separator was used`);
+            }
+            operands.push(...rest);
+        }
+        else if (first.startsWith('--')) {
+            const key = first.slice(2).replaceAll('-', '').toLowerCase();
+            const matchingOptions = Object.keys(combinedOptions).filter((k) => k.toLowerCase().startsWith(key));
+            let matchingOption = undefined;
+            if (matchingOptions.length === 1) {
+                matchingOption = matchingOptions[0];
+            }
+            else if (matchingOptions.length > 1) {
+                //Look for an exact match, it's possible that one option name is the beginning of another
+                const exactMatch = matchingOptions.find((k) => k.toLowerCase() === key);
+                if (!exactMatch) {
+                    exit(2, `Ambiguous argument: ${first}`);
+                }
+                matchingOption = exactMatch;
+            }
+            else {
+                if ('--help'.startsWith(first)) {
+                    printHelpContents(command, subcommands, cliArgs, additionalOptions, subcommand);
+                    exit(0, undefined);
+                    return {};
+                }
+                else if ('--version'.startsWith(first) && additionalOptions?.version) {
+                    await printVersion(additionalOptions.version, logger);
+                    exit(0, undefined);
+                    return {};
+                }
+                exit(2, `Unknown argument: ${first}`);
+            }
+            if (!matchingOption) {
+                exit(2, `Unknown argument: ${first}`);
+                return {};
+            }
+            const selectedArgument = matchingOption;
+            const fullArgumentName = `--${camelToKebabCase(selectedArgument)}`;
+            const optionConfig = combinedOptions[selectedArgument];
+            initializeDefault(parsedArgs, combinedOptions, selectedArgument);
+            if (optionConfig.present) {
+                parsedArgs[selectedArgument] = await optionConfig.present(parsedArgs[selectedArgument]);
+            }
+            if (rest.length > 0 && optionConfig.character) {
+                if (!isLast) {
+                    exit(2, `Validation error for ${fullArgumentName}: does not accept values but received ${rest.join(', ')}`);
+                    return {};
+                }
+                else {
+                    // If we're at the last argument and there are values, check if operands are expected
+                    if (!expectOperands) {
+                        exit(2, `Validation error for ${fullArgumentName}: does not accept values but received ${rest.join(', ')}`);
+                        return {};
+                    }
+                    else {
+                        operands.push(...rest);
+                    }
+                }
+            }
+            else {
+                const acceptsMultiple = optionConfig.acceptMultipleValues
+                    ? optionConfig.acceptMultipleValues()
+                    : false;
+                let theRest = rest;
+                if (!acceptsMultiple && rest.length > 1) {
+                    if (isLast && expectOperands) {
+                        theRest = [rest[0]];
+                        operands.push(...rest.slice(1));
+                    }
+                }
+                const currentValue = parsedArgs[selectedArgument];
+                const validation = await optionConfig.validateValues(currentValue, theRest, isSetByCli[selectedArgument] === undefined);
+                if (!validation.valid) {
+                    exit(2, `Validation error for ${fullArgumentName}: ${validation.message}`);
+                    return {};
+                }
+                else {
+                    parsedArgs[selectedArgument] = await optionConfig.reduceValues(currentValue, validation.value, isSetByCli[selectedArgument] === undefined);
+                    isSetByCli[selectedArgument] = true;
+                }
+            }
+        }
+        else if (first.startsWith('-')) {
+            if (rest.length > 0 && !isLast) {
+                exit(2, `Boolean flag(s) ${first} should not have values but received ${rest.join(', ')}`);
+                return {};
+            }
+            else if (isLast && rest.length > 0) {
+                // If we're at the last argument and there are values, check if operands are expected
+                if (!expectOperands) {
+                    exit(2, `Boolean flag(s) ${first} should not have values but received ${rest.join(', ')}`);
+                    return {};
+                }
+                else {
+                    operands.push(...rest);
+                }
+            }
+            // Short options (-s, -spq)
+            for (const char of first.slice(1)) {
+                if (!(char in booleanOptions)) {
+                    exit(2, `Unknown flag: -${char}`);
+                }
+                const key = booleanOptions[char];
+                parsedArgs[key] = true;
+            }
+        }
+    }
+    if (numberOfSubcommands > 0 && additionalOptions?.requireSubcommand && !subcommand) {
+        exit(2, `A subcommand is required`);
+    }
+    // Step 5: Validate operands if expectOperands is false
+    if (!expectOperands && operands.length > 0) {
+        exit(2, `Operands are not expected but received: ${operands.join(', ')}`);
+    }
+    // Step 4: Return results
+    return {
+        args: { ...allDefaults, ...parsedEnvironmentArgs, ...parsedArgs },
+        operands: expectOperands ? operands : [],
+        subcommand: subcommand,
+        anyValues: args.length > 0,
+        printHelp: () => {
+            printHelpContents(command, subcommands, cliArgs, additionalOptions, subcommand);
+        }
+    };
+}
+/**
+ * Initialize the default values for arguments.
+ *
+ * Will populate the parsedArgs object with default values from the cliArguments.
+ * Will also populate the booleanOptions map with single character boolean options.
+ *
+ * @param parsedArgs the parsed arguments to default the values in
+ * @param booleanOptions a map of single character boolean options to their full names
+ * @param cliArguments the configuration options for the CLI commands
+ */
+function initializeOptionDefaults(parsedArgs, booleanOptions, cliArguments) {
+    for (const [key, option] of Object.entries(cliArguments)) {
+        parsedArgs[key] = option.defaultValue;
+        if (option.character) {
+            booleanOptions[option.character.toLowerCase()] = key;
+        }
+    }
+}
+/**
+ * Initialize the default value for a specific argument if it is not already set.
+ *
+ * If the argument is not already present in parsedArgs, it will be set to the default value from cliArguments.
+ *
+ * @param parsedArgs the parsed arguments so far.
+ * @param cliArguments the CLI arguments configuration
+ * @param key the specific argument key to initialize
+ */
+function initializeDefault(parsedArgs, cliArguments, key) {
+    if (!Object.hasOwn(parsedArgs, key)) {
+        parsedArgs[key] = cliArguments[key].defaultValue;
+    }
+}
+/**
+ * Parse environment variables and set the values in the parsed arguments.
+ *
+ * @param cliArguments the configuration options for the CLI commands
+ * @param parsedArgs the parsed arguments to set the values in
+ * @param env the environment variables to get values from
+ * @param envPrefix the prefix to use for environment variables, if any
+ */
+async function parseEnvironmentVariables(cliArguments, parsedArgs, env, envPrefix, valuesSetByCli) {
+    if (!envPrefix) {
+        return;
+    }
+    const prefix = envPrefix + '_';
+    const envToKeys = Object.keys(cliArguments).reduce((acc, key) => {
+        acc[camelToCapitalSnakeCase(key)] = key;
+        return acc;
+    }, {});
+    for (const [key, value] of Object.entries(env)) {
+        if (key.startsWith(prefix)) {
+            const optionKey = key.slice(prefix.length);
+            const option = envToKeys[optionKey];
+            if (option) {
+                const config = cliArguments[option];
+                initializeDefault(parsedArgs, cliArguments, option);
+                if (config.present) {
+                    parsedArgs[option] = await config.present(parsedArgs[option]);
+                }
+                if (!config.character) {
+                    const values = value.split(' ');
+                    const validation = await config.validateValues(parsedArgs[option], values, valuesSetByCli[option] === undefined);
+                    if (!validation.valid) {
+                        const s = values.length > 1 ? 's' : '';
+                        exit(2, `Invalid value${s} for environment ${key}: ${validation.message}`);
+                        return;
+                    }
+                    parsedArgs[option] = await config.reduceValues(parsedArgs[option], validation.value, valuesSetByCli[option] === undefined);
+                    valuesSetByCli[option] = true;
+                }
+            }
+        }
+    }
+}
+/**
+ * Groups arguments into chunks based on the -- separator.
+ *
+ * @param args
+ * @returns
+ */
+function groupArguments(args) {
+    const grouped = [];
+    let currentChunk = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--') {
+            grouped.push({
+                first: arg,
+                rest: args.slice(i + 1),
+                isFirst: grouped.length === 0,
+                isLast: true
+            });
+            break;
+        }
+        if (arg.startsWith('-') && currentChunk.length > 0) {
+            grouped.push({
+                first: currentChunk.at(0),
+                rest: currentChunk.slice(1),
+                isFirst: grouped.length === 0,
+                isLast: false
+            });
+            currentChunk = [];
+        }
+        currentChunk.push(arg);
+    }
+    if (currentChunk.length > 0) {
+        grouped.push({
+            first: currentChunk.at(0),
+            rest: currentChunk.slice(1),
+            isFirst: grouped.length === 0,
+            isLast: true
+        });
+    }
+    return grouped;
+}
+export function camelToCapitalSnakeCase(input) {
+    return input
+        .replace(/([a-z0-9])([A-Z])/g, '$1_$2') // Insert underscore before capital letters
+        .toUpperCase(); // Convert to uppercase
+}
+export function camelToKebabCase(input) {
+    return input
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2') // Insert dash before capital letters
+        .toLowerCase(); // Convert to lowercase
+}
+export function printHelpContents(command, subcommands, cliOptions, additionalArgs, selectedSubcommand) {
+    const logger = additionalArgs?.consoleLogger ?? console;
+    const operandsExpected = additionalArgs?.expectOperands != undefined ? additionalArgs?.expectOperands : true;
+    const operandsName = additionalArgs?.operandsName ?? 'operand';
+    const operandsString = operandsExpected ? ` [--] [${operandsName}1] [${operandsName}2]` : '';
+    const anyGlobalFlags = Object.values(cliOptions).some((option) => option.character);
+    if (selectedSubcommand) {
+        const anyCommandFlags = Object.values(subcommands[selectedSubcommand].arguments).some((option) => option.character);
+        const flags = anyGlobalFlags || anyCommandFlags ? ' [flags]' : '';
+        let usageString = `Usage: ${command} ${selectedSubcommand} [options]${flags}${operandsString}`;
+        if (additionalArgs?.allowOperandsFromStdin) {
+            usageString += `\n       <${operandsName}s to stdout> | ${command} ${selectedSubcommand} [options]${flags}`;
+        }
+        logger.log(usageString);
+        logger.log('');
+        logger.log(`${subcommands[selectedSubcommand].description}`);
+        logger.log(`${selectedSubcommand} Options:`);
+        printOptions(subcommands[selectedSubcommand].arguments, logger);
+        logger.log('');
+    }
+    else {
+        const anyCommandFlags = Object.values(subcommands).some((subcommand) => Object.values(subcommand.arguments).some((option) => option.character));
+        const flags = anyGlobalFlags || anyCommandFlags ? ' [flags]' : '';
+        let singleUseString = `${command}`;
+        const subcommandKeys = Object.keys(subcommands);
+        if (subcommandKeys.length > 0 && additionalArgs?.requireSubcommand) {
+            singleUseString += ' <subcommand>';
+        }
+        else if (subcommandKeys.length > 0) {
+            singleUseString += ' [subcommand]';
+        }
+        singleUseString += ` [options]${flags}`;
+        let usageString = `Usage: ${singleUseString}${operandsString}`;
+        if (additionalArgs?.allowOperandsFromStdin) {
+            usageString += `\n       <${operandsName}s to stdout> | ${singleUseString}`;
+        }
+        logger.log(usageString);
+        const longestCommand = subcommandKeys.reduce((acc, cmd) => Math.max(acc, cmd.length), 0);
+        if (subcommandKeys.length > 0) {
+            logger.log('Subcommands:');
+            for (const cmd of subcommandKeys) {
+                const description = subcommands[cmd].description;
+                logger.log(`  ${(cmd + ':').padEnd(longestCommand + 1)} ${description}`);
+            }
+            logger.log('');
+            logger.log(` Use ${command} <subcommand> --help for more information about a subcommand`);
+        }
+    }
+    logger.log('Global Options:');
+    const globalOptions = {
+        ...cliOptions,
+        ...{
+            help: {
+                description: 'Print the help contents and exit'
+            }
+        }
+    };
+    if (additionalArgs?.version) {
+        globalOptions['version'] = {
+            description: 'Print the version and exit'
+        };
+    }
+    printOptions(globalOptions, logger);
+}
+function printOptions(cliOptions, logger) {
+    const longestOption = Object.keys(cliOptions).reduce((acc, key) => Math.max(acc, camelToKebabCase(key).length + 2), 0) + 1;
+    const terminalWidth = process.stdout.columns ?? 80;
+    const nonBooleanBuffer = '     ';
+    for (const [key, option] of Object.entries(cliOptions)) {
+        let optionString = `  --${camelToKebabCase(key)}:`.padEnd(longestOption + 3);
+        if (option.character) {
+            optionString += `(-${option.character}) `;
+        }
+        else {
+            optionString += nonBooleanBuffer;
+        }
+        const leftBar = optionString.length;
+        optionString += option.description;
+        logger.log(optionString.slice(0, terminalWidth));
+        let stringToPrint = optionString.slice(terminalWidth);
+        const secondLineLength = terminalWidth - leftBar;
+        while (stringToPrint.length > 0) {
+            logger.log(' '.repeat(leftBar) + stringToPrint.slice(0, secondLineLength).trimStart());
+            stringToPrint = stringToPrint.slice(secondLineLength);
+        }
+    }
+}
+async function printVersion(versionInfo, logger) {
+    if (!versionInfo) {
+        logger.log('Version information not available. This is a bug.');
+        return;
+    }
+    if (typeof versionInfo === 'string') {
+        logger.log(versionInfo);
+        return;
+    }
+    let currentVersion = null;
+    if (typeof versionInfo.currentVersion === 'string') {
+        currentVersion = versionInfo.currentVersion;
+    }
+    else if (typeof versionInfo.currentVersion === 'function') {
+        currentVersion = await versionInfo.currentVersion();
+    }
+    if (!currentVersion) {
+        logger.log('Current version not available');
+        return;
+    }
+    let latestVersion = null;
+    if (typeof versionInfo.checkForUpdates == 'string') {
+        latestVersion = await getLatestVersionFromNpm(versionInfo.checkForUpdates);
+    }
+    else if (typeof versionInfo.checkForUpdates === 'function') {
+        latestVersion = await versionInfo.checkForUpdates();
+    }
+    let updateMessage = undefined;
+    if (currentVersion && latestVersion && currentVersion !== latestVersion) {
+        if (versionInfo.updateMessage) {
+            updateMessage = versionInfo.updateMessage(currentVersion, latestVersion);
+        }
+        else if (typeof versionInfo.checkForUpdates === 'string') {
+            updateMessage = `Latest: ${latestVersion}. To update run: npm update -g ${versionInfo.checkForUpdates}`;
+        }
+        else {
+            updateMessage = `Latest: ${latestVersion}.`;
+        }
+    }
+    else if (currentVersion && latestVersion && currentVersion === latestVersion) {
+        // updateMessage = 'You are using the latest version.'
+    }
+    logger.log(currentVersion);
+    if (updateMessage) {
+        logger.log(updateMessage);
+    }
+}
+/**
+ * Fetch the latest version of a package from the npm registry.
+ *
+ * @param packageName the name of the npm package to check, e.g. "my-cli-tool" or "@my-org/my-cli-tool"
+ * @returns the latest version of the package published on npm or null if any error occurs
+ */
+async function getLatestVersionFromNpm(packageName) {
+    try {
+        const res = await fetch(`https://registry.npmjs.org/${packageName}/latest`);
+        if (res.ok) {
+            const data = await res.json();
+            return data.version || null;
+        }
+    }
+    catch (e) {
+        // Ignore errors fetching latest version
+    }
+    return null;
+}
+//# sourceMappingURL=cli.js.map

package/dist/esm/cli.js.map

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

package/dist/esm/index.d.ts

@@ -0,0 +1,13 @@
+export { type CustomArgument } from './arguments/argument.js';
+export { arrayValueArgument } from './arguments/arrayValueArgument.js';
+export { booleanArgument } from './arguments/booleanArgument.js';
+export { enumArgument } from './arguments/enumArgument.js';
+export { enumArrayArgument } from './arguments/enumArrayArgument.js';
+export { mapArgument } from './arguments/mapArgument.js';
+export { numberArgument, numberArrayArgument } from './arguments/numberArguments.js';
+export { singleValueArgument } from './arguments/singleValueArgument.js';
+export { stringArgument, stringArrayArgument } from './arguments/stringArguments.js';
+export { parseCliArguments, type AdditionalCliOptions, type Config } from './cli.js';
+export { createPackageFileReader, type PackageFileReader } from './readRelative.js';
+export { readStdin } from './stdin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAA;AACxE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACpF,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAA;AACpF,OAAO,EAAE,uBAAuB,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,13 @@
+export {} from './arguments/argument.js';
+export { arrayValueArgument } from './arguments/arrayValueArgument.js';
+export { booleanArgument } from './arguments/booleanArgument.js';
+export { enumArgument } from './arguments/enumArgument.js';
+export { enumArrayArgument } from './arguments/enumArrayArgument.js';
+export { mapArgument } from './arguments/mapArgument.js';
+export { numberArgument, numberArrayArgument } from './arguments/numberArguments.js';
+export { singleValueArgument } from './arguments/singleValueArgument.js';
+export { stringArgument, stringArrayArgument } from './arguments/stringArguments.js';
+export { parseCliArguments } from './cli.js';
+export { createPackageFileReader } from './readRelative.js';
+export { readStdin } from './stdin.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAA;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAA;AACxE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACpF,OAAO,EAAE,iBAAiB,EAA0C,MAAM,UAAU,CAAA;AACpF,OAAO,EAAE,uBAAuB,EAA0B,MAAM,mBAAmB,CAAA;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+    "type": "module"
+}

package/dist/esm/readRelative.d.ts

@@ -0,0 +1,35 @@
+/**
+ * An interface for reading files from a relative path inside your packaged cli app. For instance to
+ * read the package.json inside your package. Works on ESM and CommonJS modules.
+ */
+export interface PackageFileReader {
+    /**
+     * Read a file from a relative path inside your packaged cli app. For instance to
+     * read the package.json inside your package. Works on ESM and CommonJS modules.
+     *
+     * @param pathParts the path to the file, relative to the root of your project with each
+     * directory as a separate string in the array and the file name as the last string in the array.
+     */
+    readFile(pathParts: string[]): Promise<string>;
+}
+/**
+ * A relatively sane way to read a file from a relative path inside your packaged cli app. For instance to
+ * read the package.json inside your package. Works on ESM and CommonJS modules. Use __filename
+ * or import.meta.url to get the path of the file you are in and pass it to this function. Set the `levelsUp`
+ * based on how your project is packaged. For instance, if your file is packaged in `dist/cli.js` and you would use `1` if
+ * you packaged your file is in `dist/src/cli.js` and you would use `2`. Whatever you need to get to the root.
+ *
+ * You get back a `PackageFileReader` which has a `readFile` method. You can then call that method
+ * with the path parts to the file you want to read, relative to the root of your project.
+ * For instance, to read the `package.json` file in the root of your project, you would call:
+ * ```ts
+ *   const reader = await createPackageFileReader(import.meta.url, 1) // if your file is in dist/cli.js
+ *   const packageJson = await reader.readFile(['package.json'])
+ * ```
+ *
+ * @param currentFile the path to start from use `import.meta.url` for esm or `__filename` for CommonJS in most cases
+ * @param levelsUp since __import.meta.url or __filename is the file you are in, you need to go up a few levels to ge to the root of your project. Use 0 for the current directory of the file you're calling from.
+ * @returns a `PackageFileReader` you can use to read files relative to the root of your project.
+ */
+export declare function createPackageFileReader(currentFile: string, levelsUp: number): PackageFileReader;
+//# sourceMappingURL=readRelative.d.ts.map

package/dist/esm/readRelative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readRelative.d.ts","sourceRoot":"","sources":["../../src/readRelative.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CAC/C;AA+CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAMhG"}