@eldrforge/git-tools 0.1.7 → 0.1.9

package/dist/index.d.ts

@@ -1,254 +1,2 @@
-import { default as default_2 } from 'child_process';
-
-/**
- * Default console-based logger implementation
- */
-export declare class ConsoleLogger implements Logger {
-    private level;
-    constructor(level?: string);
-    private shouldLog;
-    error(message: string, ...meta: any[]): void;
-    warn(message: string, ...meta: any[]): void;
-    info(message: string, ...meta: any[]): void;
-    verbose(message: string, ...meta: any[]): void;
-    debug(message: string, ...meta: any[]): void;
-}
-
-/**
- * Escapes shell arguments to prevent command injection
- */
-export declare function escapeShellArg(arg: string): string;
-
-/**
- * Finds the previous release tag based on the current version using semantic versioning.
- * Returns the highest version tag that is less than the current version.
- *
- * @param currentVersion The current version (e.g., "1.2.3", "2.0.0")
- * @param tagPattern The pattern to match tags (e.g., "v*", "working/v*")
- * @returns The previous release tag or null if none found
- */
-export declare const findPreviousReleaseTag: (currentVersion: string, tagPattern?: string) => Promise<string | null>;
-
-/**
- * Gets the commit SHA for a given branch (local or remote)
- */
-export declare const getBranchCommitSha: (branchRef: string) => Promise<string>;
-
-/**
- * Gets the current branch name
- */
-export declare const getCurrentBranch: () => Promise<string>;
-
-/**
- * Gets the current version from package.json
- *
- * @returns The current version string or null if not found
- */
-export declare const getCurrentVersion: () => Promise<string | null>;
-
-/**
- * Gets a reliable default for the --from parameter by trying multiple fallbacks
- *
- * Tries in order:
- * 1. Previous working branch tag (if on working branch)
- * 2. Previous release tag (if current version can be determined)
- * 3. main (local main branch - typical release comparison base)
- * 4. master (local master branch - legacy default)
- * 5. origin/main (remote main branch fallback)
- * 6. origin/master (remote master branch fallback)
- *
- * @param forceMainBranch If true, skip tag detection and use main branch
- * @param currentBranch Current branch name for branch-aware tag detection
- * @returns A valid git reference to use as the default from parameter
- * @throws Error if no valid reference can be found
- */
-export declare const getDefaultFromRef: (forceMainBranch?: boolean, currentBranch?: string) => Promise<string>;
-
-/**
- * Gets git status summary including unstaged files, uncommitted changes, and unpushed commits
- */
-export declare const getGitStatusSummary: (workingDir?: string) => Promise<{
-    branch: string;
-    hasUnstagedFiles: boolean;
-    hasUncommittedChanges: boolean;
-    hasUnpushedCommits: boolean;
-    unstagedCount: number;
-    uncommittedCount: number;
-    unpushedCount: number;
-    status: string;
-}>;
-
-/**
- * Gets the list of globally linked packages (packages available to be linked to)
- */
-export declare const getGloballyLinkedPackages: () => Promise<Set<string>>;
-
-/**
- * Checks for actual semantic version compatibility issues between linked packages and their consumers
- * Returns a set of dependency names that have real compatibility problems
- *
- * This function ignores npm's strict prerelease handling and focuses on actual compatibility:
- * - "^4.4" is compatible with "4.4.53-dev.0" (prerelease of compatible minor version)
- * - "^4.4" is incompatible with "4.5.3" (different minor version)
- */
-export declare const getLinkCompatibilityProblems: (packageDir: string, allPackagesInfo?: Map<string, {
-    name: string;
-    version: string;
-    path: string;
-}>) => Promise<Set<string>>;
-
-/**
- * Gets the list of packages that this package is actively linking to (consuming linked packages)
- */
-export declare const getLinkedDependencies: (packageDir: string) => Promise<Set<string>>;
-
-/**
- * Checks for npm link problems (version mismatches) in a package directory
- * Returns a set of dependency names that have link problems
- *
- * @deprecated Use getLinkCompatibilityProblems instead for better prerelease version handling
- */
-export declare const getLinkProblems: (packageDir: string) => Promise<Set<string>>;
-
-/**
- * Get the global logger instance
- */
-export declare function getLogger(): Logger;
-
-/**
- * Gets the default branch name from the remote repository
- */
-export declare const getRemoteDefaultBranch: () => Promise<string | null>;
-
-/**
- * Checks if a local branch is in sync with its remote counterpart
- */
-export declare const isBranchInSyncWithRemote: (branchName: string, remote?: string) => Promise<{
-    inSync: boolean;
-    localSha?: string;
-    remoteSha?: string;
-    localExists: boolean;
-    remoteExists: boolean;
-    error?: string;
-}>;
-
-/**
- * Checks if a package directory is npm linked (has a global symlink)
- */
-export declare const isNpmLinked: (packageDir: string) => Promise<boolean>;
-
-/**
- * Tests if a git reference exists and is valid
- */
-export declare const isValidGitRef: (ref: string) => Promise<boolean>;
-
-/**
- * Checks if a local branch exists
- */
-export declare const localBranchExists: (branchName: string) => Promise<boolean>;
-
-/**
- * Minimal logging interface that git-tools requires.
- * Allows consumers to provide their own logger implementation (e.g., Winston, console, etc.)
- */
-export declare interface Logger {
-    error(message: string, ...meta: any[]): void;
-    warn(message: string, ...meta: any[]): void;
-    info(message: string, ...meta: any[]): void;
-    verbose(message: string, ...meta: any[]): void;
-    debug(message: string, ...meta: any[]): void;
-}
-
-/**
- * Checks if a remote branch exists
- */
-export declare const remoteBranchExists: (branchName: string, remote?: string) => Promise<boolean>;
-
-export declare function run(command: string, options?: RunOptions): Promise<{
-    stdout: string;
-    stderr: string;
-}>;
-
-export declare interface RunOptions extends default_2.ExecOptions {
-    /** If true, suppresses error logging for non-zero exits (useful when non-zero exit is expected behavior) */
-    suppressErrorLogging?: boolean;
-}
-
-/**
- * Securely executes a command with arguments array (no shell injection risk)
- */
-export declare function runSecure(command: string, args?: string[], options?: default_2.SpawnOptions): Promise<{
-    stdout: string;
-    stderr: string;
-}>;
-
-/**
- * Secure version of runWithDryRunSupport using argument arrays
- */
-export declare function runSecureWithDryRunSupport(command: string, args: string[] | undefined, isDryRun: boolean, options?: default_2.SpawnOptions, useInheritedStdio?: boolean): Promise<{
-    stdout: string;
-    stderr: string;
-}>;
-
-/**
- * Securely executes a command with inherited stdio (no shell injection risk)
- */
-export declare function runSecureWithInheritedStdio(command: string, args?: string[], options?: default_2.SpawnOptions): Promise<void>;
-
-export declare function runWithDryRunSupport(command: string, isDryRun: boolean, options?: default_2.ExecOptions, useInheritedStdio?: boolean): Promise<{
-    stdout: string;
-    stderr: string;
-}>;
-
-/**
- * @deprecated Use runSecureWithInheritedStdio instead for better security
- * Legacy function for backward compatibility - parses shell command string
- */
-export declare function runWithInheritedStdio(command: string, options?: default_2.ExecOptions): Promise<void>;
-
-/**
- * Safely parses JSON with error handling
- */
-export declare const safeJsonParse: <T = any>(jsonString: string, context?: string) => T;
-
-/**
- * Attempts to safely sync a local branch with its remote counterpart
- * Returns true if successful, false if conflicts exist that require manual resolution
- */
-export declare const safeSyncBranchWithRemote: (branchName: string, remote?: string) => Promise<{
-    success: boolean;
-    error?: string;
-    conflictResolutionRequired?: boolean;
-}>;
-
-/**
- * Set the global logger instance
- */
-export declare function setLogger(logger: Logger): void;
-
-/**
- * Validates file paths to prevent injection
- */
-export declare function validateFilePath(filePath: string): boolean;
-
-/**
- * Validates git references to prevent injection
- */
-export declare function validateGitRef(ref: string): boolean;
-
-/**
- * Validates that a value exists and has a specific property
- */
-export declare const validateHasProperty: (obj: any, property: string, context?: string) => void;
-
-/**
- * Validates package.json structure has basic required fields
- */
-export declare const validatePackageJson: (data: any, context?: string, requireName?: boolean) => any;
-
-/**
- * Validates that a value is a non-empty string
- */
-export declare const validateString: (value: any, fieldName: string) => string;
-
-export { }
+export * from './src/index'
+export {}