@visulima/cerebro 3.0.0-alpha.2 → 3.0.0-alpha.21

package/dist/util/command-processing/nested-command-parser.d.ts

@@ -1,25 +0,0 @@
-/**
- * Parses nested command paths from argv.
- * Supports both flat commands (e.g., "build") and nested commands (e.g., "deploy staging").
- * @param availableCommands Map of all available commands keyed by their full path string
- * @param argv Command line arguments to parse
- * @returns Object with the matched command path and remaining argv
- */
-export declare const parseNestedCommand: (availableCommands: Map<string, string[]>, argv: string[]) => {
-    argv: string[];
-    commandPath: string[] | undefined;
-};
-/**
- * Generates a lookup key from a command path array.
- * @param commandPath Array of command path segments
- * @returns The command path key string
- */
-export declare const getCommandPathKey: (commandPath: string[]) => string;
-/**
- * Generates the full command path for a command, including its commandPath if present.
- * Combines the command name with any parent path segments.
- * @param commandName The name of the command to add to the path
- * @param commandPath Optional path segments from the command definition
- * @returns The full command path array combining commandPath and commandName
- */
-export declare const getFullCommandPath: (commandName: string, commandPath?: string[]) => string[];

package/dist/util/command-processing/option-processor.d.ts

@@ -1,44 +0,0 @@
-import type { OptionDefinition } from "../../types/command.d.ts";
-import type { Toolbox as IToolbox } from "../../types/toolbox.d.ts";
-/**
- * Converts option names to camelCase and adds them as __camelCaseName__ properties.
- * @template OD The option definition type
- * @param command The command object containing options to process
- * @param command.options The options array to process
- */
-export declare const processOptionNames: <OD extends OptionDefinition<unknown>>(command: {
-    options?: OD[];
-}) => void;
-/**
- * Adds negatable options for boolean flags.
- * For options starting with "no-", creates a corresponding non-negated option.
- * @template OD The option definition type
- * @param command The command object to add negatable options to
- * @param command.name The name of the command (used for error messages)
- * @param command.options The array of option definitions to process
- * @throws {Error} When a negated option is not of type Boolean
- */
-export declare const addNegatableOptions: <OD extends OptionDefinition<unknown>>(command: {
-    name: string;
-    options?: OD[];
-}) => void;
-/**
- * Maps negatable options to their non-negated counterparts.
- * Processes toolbox options starting with "no" and converts them to non-negated form.
- * @param toolbox The command toolbox containing options
- * @param command The command object with option definitions
- * @param command.options The command options array
- */
-export declare const mapNegatableOptions: <O extends OptionDefinition<unknown>, TLogger extends Console = Console>(toolbox: IToolbox<TLogger>, command: {
-    options?: ReadonlyArray<O | OptionDefinition<boolean[]> | OptionDefinition<boolean> | OptionDefinition<number[]> | OptionDefinition<number> | OptionDefinition<string[]> | OptionDefinition<string>>;
-}) => void;
-/**
- * Applies implied option values.
- * Sets implied option values from option definitions that have an implies property.
- * @param toolbox The command toolbox to apply implied values to
- * @param command The command object with option definitions
- * @param command.options The command options array
- */
-export declare const mapImpliedOptions: <O extends OptionDefinition<unknown>, TLogger extends Console = Console>(toolbox: IToolbox<TLogger>, command: {
-    options?: ReadonlyArray<O | OptionDefinition<boolean[]> | OptionDefinition<boolean> | OptionDefinition<number[]> | OptionDefinition<number> | OptionDefinition<string[]> | OptionDefinition<string>>;
-}) => void;

package/dist/util/data-processing/list-missing-arguments.d.ts

@@ -1,15 +0,0 @@
-import type { CommandLineOptions } from "@visulima/command-line-args";
-import type { OptionDefinition, PossibleOptionDefinition } from "../../types/command.d.ts";
-/**
- * Lists missing required arguments from parsed command line options
- * Optimized to use pre-filtered required options when available
- * Combines filter operations for better performance
- *
- * Note: This function mutates parsedArguments by setting missing boolean options to false.
- * @param commandLineConfig All command options OR pre-filtered required options
- * @param parsedArguments Parsed command line arguments (will be mutated for boolean defaults)
- * @param onlyRequired If true, commandLineConfig already contains only required options (optimization)
- * @returns Array of missing required options
- */
-declare const listMissingArguments: <OD extends OptionDefinition<any>>(commandLineConfig: PossibleOptionDefinition<OD>[], parsedArguments: CommandLineOptions, onlyRequired?: boolean) => PossibleOptionDefinition<OD>[];
-export default listMissingArguments;

package/dist/util/data-processing/merge-arguments.d.ts

@@ -1,7 +0,0 @@
-import type { OptionDefinition, PossibleOptionDefinition } from "../../types/command.d.ts";
-/**
- * Performs a simple merge of multiple argument lists. Does not mutate given
- * argument lists or argument.
- */
-declare const mergeArguments: <OD extends OptionDefinition<any>>(argumentLists: PossibleOptionDefinition<OD>[]) => PossibleOptionDefinition<OD>[];
-export default mergeArguments;

package/dist/util/general/find-alternatives.d.ts

@@ -1,8 +0,0 @@
-/**
- * Finds strings in an array that are similar to the given string.
- * @param string The target string to match against
- * @param array Array of candidate strings to search
- * @returns Array of similar strings from the input array
- */
-declare const findAlternatives: (string: string, array: string[]) => string[];
-export default findAlternatives;

package/dist/util/general/hide-bin.d.ts

@@ -1,2 +0,0 @@
-declare const hideBin: (argv: string[]) => string[];
-export default hideBin;

package/dist/util/general/parse-raw-command.d.ts

@@ -1,7 +0,0 @@
-/**
- * Parses the raw command into an array of strings.
- * @param commandArray Command string or list of command parts.
- * @returns The command as an array of strings.
- */
-declare const parseRawCommand: (commandArray: string[] | string) => string[];
-export default parseRawCommand;

package/dist/util/general/register-exception-handler.d.ts

@@ -1,9 +0,0 @@
-/**
- * Registers global exception handlers for uncaught exceptions and unhandled promise rejections.
- * Logs errors using the provided logger and exits the process with code 1.
- * @template T - Logger type that extends Console interface
- * @param logger Console-like logger instance for error reporting
- * @returns Cleanup function to remove event listeners
- */
-declare const registerExceptionHandler: <T extends Console = Console>(logger: T) => () => void;
-export default registerExceptionHandler;

package/dist/util/general/runtime-process.d.ts

@@ -1,65 +0,0 @@
-/**
- * Runtime-agnostic process-like APIs that work across Node.js, Deno, and Bun.
- */
-/**
- * Gets command line arguments compatible with process.argv format.
- * For Deno, constructs argv from Deno.args (prepending execPath).
- * For Node.js and Bun, uses process.argv directly.
- * @returns Array of command line arguments
- */
-export declare const getArgv: () => ReadonlyArray<string>;
-/**
- * Gets the current working directory.
- * @returns The current working directory path
- */
-export declare const getCwd: () => string;
-/**
- * Gets environment variables as a mutable object.
- * Returns a proxy object that handles mutations across different runtimes.
- * @returns Environment variables object (mutable proxy)
- */
-export declare const getEnv: () => Record<string, string | undefined>;
-/**
- * Gets execution arguments (e.g., --inspect, --trace-warnings).
- * @returns Array of execution arguments
- */
-export declare const getExecArgv: () => ReadonlyArray<string>;
-/**
- * Gets the absolute pathname of the executable that started the process.
- * @returns The executable path
- */
-export declare const getExecPath: () => string;
-/**
- * Gets the operating system platform.
- * @returns Platform string (e.g., "darwin", "linux", "win32")
- */
-export declare const getPlatform: () => string;
-/**
- * Gets the CPU architecture.
- * @returns Architecture string (e.g., "x64", "arm64")
- */
-export declare const getArch: () => string;
-/**
- * Gets version information about the runtime.
- * @returns Object with version strings
- */
-export declare const getVersions: () => Record<string, string>;
-/**
- * Terminates the process with the specified exit code.
- * @param exitCode Exit code (default: 0)
- */
-export declare const exitProcess: (exitCode?: number) => never;
-/**
- * Runtime-agnostic event handler registration.
- * Note: Deno and Bun don't have equivalent event emitters, so this only works in Node.js.
- * In other runtimes, handlers are registered but may not be called for all events.
- */
-export type ProcessEventType = "uncaughtException" | "unhandledRejection";
-export type ProcessEventHandler = (...args: unknown[]) => void;
-/**
- * Registers an event handler for process events.
- * @param event Event type to listen for
- * @param handler Handler function
- * @returns Cleanup function to remove the handler
- */
-export declare const onProcessEvent: (event: ProcessEventType, handler: ProcessEventHandler) => () => void;

package/dist/util/general/semver-gt.d.ts

@@ -1,2 +0,0 @@
-declare const semverGt: (version1: string, version2: string) => boolean;
-export default semverGt;

package/dist/util/general/validate-input.d.ts

@@ -1,24 +0,0 @@
-/**
- * Validates that a string is not empty or whitespace-only.
- */
-export declare const validateNonEmptyString: (value: unknown, fieldName: string) => string;
-/**
- * Validates that a value is an array of strings.
- */
-export declare const validateStringArray: (value: unknown, fieldName: string) => string[];
-/**
- * Validates that a value is a function.
- */
-export declare const validateFunction: (value: unknown, fieldName: string) => (...args: unknown[]) => unknown;
-/**
- * Validates that a value is an object (but not null).
- */
-export declare const validateObject: (value: unknown, fieldName: string) => Record<string, unknown>;
-/**
- * Validates command name format and prevents malicious inputs.
- */
-export declare const validateCommandName: (name: string) => string;
-/**
- * Validates plugin name format and prevents malicious inputs.
- */
-export declare const validatePluginName: (name: string) => string;

package/dist/util/process-env-variables.d.ts

@@ -1,9 +0,0 @@
-import type { EnvDefinition } from "../types/command.d.ts";
-/**
- * Processes environment variables from a command definition.
- * Transforms string values to their specified types and applies default values.
- * @param envDefinitions Array of environment variable definitions
- * @returns Object with camelCase keys and transformed values
- */
-declare const processEnvVariables: (envDefinitions: (EnvDefinition<boolean> | EnvDefinition<number> | EnvDefinition<string>)[] | undefined) => Record<string, unknown>;
-export default processEnvVariables;

package/dist/util/security.d.ts

@@ -1,58 +0,0 @@
-/**
- * Security utilities for preventing injection attacks and malicious inputs
- */
-/**
- * Sanitizes a command argument to prevent injection attacks.
- * @param argument The argument string to sanitize.
- * @returns The sanitized argument with whitespace trimmed.
- * @throws {TypeError} If the argument is not a string.
- * @throws {Error} If the argument exceeds maximum length or contains dangerous characters.
- */
-export declare const sanitizeArgument: (argument: string) => string;
-/**
- * Sanitizes an array of arguments.
- * @param args The array of arguments to sanitize.
- * @returns Array of sanitized arguments.
- * @throws {TypeError} If args is not an array or if any argument is not a string.
- * @throws {Error} If there are too many arguments or if any argument is invalid.
- */
-export declare const sanitizeArguments: (args: ReadonlyArray<string>) => string[];
-/**
- * Validates that a file path is safe (prevents directory traversal).
- * @param path The file path to validate.
- * @returns The validated path with whitespace trimmed.
- * @throws {TypeError} If the path is not a string.
- * @throws {Error} If the path contains traversal sequences, is absolute, or exceeds maximum length.
- */
-export declare const validateSafePath: (path: string) => string;
-/**
- * Rate limiting helper to prevent brute force attacks
- * Automatically cleans up expired entries to prevent memory leaks
- */
-export declare class RateLimiter {
-    private attempts;
-    private readonly maxAttempts;
-    private readonly windowMs;
-    /**
-     * Creates a new RateLimiter instance.
-     * @param maxAttempts Maximum number of attempts allowed within the time window (default: 5).
-     * @param windowMs Time window in milliseconds (default: 60000).
-     */
-    constructor(maxAttempts?: number, windowMs?: number);
-    /**
-     * Checks if the key has exceeded the rate limit.
-     * @param key Unique identifier for the rate limit check.
-     * @returns true if the request is allowed, false if rate limit exceeded.
-     */
-    checkLimit(key: string): boolean;
-    /**
-     * Resets the rate limit for a specific key.
-     * @param key The key to reset.
-     */
-    reset(key: string): void;
-    /**
-     * Removes expired entries from the attempts map.
-     * @param now Current timestamp.
-     */
-    private cleanup;
-}

package/dist/util/text-processing/template-format.d.ts

@@ -1,5 +0,0 @@
-/**
- * Formats templates with intelligent caching.
- */
-declare const templateFormat: (string_?: string) => string;
-export default templateFormat;