import { type Stats } from 'node:fs';
export interface DirectoryIdentity {
    path: string;
    stat: Stats;
    followSymbolicLink: boolean;
}
export interface PrivateFileInspection {
    ancestorIdentities: DirectoryIdentity[];
    expectedStat: Stats | undefined;
}
export declare class PrivateArtifactAncestorIdentityMismatchError extends Error {
    constructor(message: string, options?: ErrorOptions);
}
export declare function lstatOrUndefined(path: string): Stats | undefined;
export declare function artifactBoundary(targetPath: string): {
    targetPath: string;
    trustedRoot: string;
    rejectTrustedRootSymlink: boolean;
};
export declare function assertSafePath(targetPath: string, targetIsDirectory: boolean): void;
export declare function inspectPrivateArtifactPath(targetPath: string, targetKind: 'file' | 'directory'): PrivateFileInspection;
export declare function hasMatchingIdentity(expected: Stats, actual: Stats): boolean;
export declare function hasMatchingDirectoryIdentity(expected: Stats, actual: Stats): boolean;
export declare function assertAncestorIdentities(identities: readonly DirectoryIdentity[]): void;
//# sourceMappingURL=private-path-identity.d.ts.map