instrumentality 0.0.3 → 0.0.4

package/dist/road.d.ts

@@ -1,37 +1,46 @@
 import * as fs from "node:fs";
 import * as cr from "node:crypto";
 import * as bs from "./base.ts";
-/**
- * Subclass of {@link bs.InsErr} that represents an error thrown from this specific module of the library
- */
+/** Subclass of {@link bs.InsErr} that represents an error thrown from this specific module of the library */
 export declare class RdErr extends bs.InsErr {
     name: string;
 }
+export { RdErr as RoadError };
 /**
- * Returns the constructor function corresponding to the file mode.
+ * Returns the constructor function corresponding to the file mode (statmode).
  *
- * @param statmode The file mode to check.
- * @returns The constructor function corresponding to the file mode.
+ * @param statmode_ The file mode to check.
+ * @returns The constructor function corresponding to the road type (e.g., {@link File}, {@link Folder}, etc.).
  * @throws If the file mode is unknown, throws a {@link RdErr}.
  */
-export declare function resolveMode(statmode: number): typeof File | typeof Folder | typeof SymbolicLink | typeof BlockDevice;
+export declare function resolveMode(statmode_: number): typeof File | typeof Folder | typeof BlockDevice | typeof CharacterDevice | typeof SymbolicLink | typeof Fifo | typeof Socket;
+/**
+ * Creates the appropriate subclass of {@link Road} based on the file mode of the specified path.
+ *
+ * @param path_ The path to follow.
+ * @returns A new instance of {@link Road}.
+ * @throws If {@link fp.lstat}/{@link fs.lstatSync} fails to retrieved the status of {@link path_}.
+ */
+export declare function factory(path_: string): Promise<BlockDevice | CharacterDevice | Fifo | File | Folder | Socket | SymbolicLink>;
+/** Sync version of {@link factory}. */
+export declare function factorySync(path_: string): BlockDevice | CharacterDevice | Fifo | File | Folder | Socket | SymbolicLink;
 /**
- * Creates a new instance of the appropriate subclass of {@link Road} based on the file mode of the specified path.
+ * A map that keeps track of locked roads to prevent concurrent modifications.
+ *
+ * @key The absolute path of the road that is currently locked.
+ * @value A promise that resolves when the lock on the road is released.
  *
- * @param lookFor The path to check.
- * @returns A new instance of the appropriate subclass of {@link Road}.
- * @throws If the path does not exist, throws a fs {@link Error}.
+ * @remarks The map is initialized lazily when the first lock is created to minimize import-time side effects.
+ * It's generally meant for read-only purposes. It's not advised to modify this map directly if there are built-in mechanisms that do the job for you as well.
  */
-export declare function factorySync(lookFor: string): BlockDevice | File | Folder | SymbolicLink;
-/** Async version of {@link factorySync}. */
-export declare function factory(lookFor: string): Promise<BlockDevice | File | Folder | SymbolicLink>;
+export declare let lockedRoads: Map<string, Promise<void>> | null;
 /**
- * Getter for the locked roads map.
+ * Road is an OOP, pointer-like representation of an entry in the local file system. It wraps around the Node.js fs module and provides a more convenient access to it.
+ * It's meant to help the user mentally model an entry and help them reason about it, as well as provide a more convenient API and guardrails for common operations.
  *
- * @param roadOrPath - A {@link Road} instance or a string representing the absolute path of the road to check.
- * @returns The promise associated with the locked road, or `undefined` if the road is not currently locked.
+ * @remarks This is by no means a one-to-one mapping of the underlying file system (after initialization).
+ * It is more like a memory representation, similar to a pointer in low-level programming languages; other processes might mess with the underlying entry. There are methods to check for consistency, but they are not guaranteed to be foolproof.
  */
-export declare function lockFor(roadOrPath: Road | string): Promise<void> | undefined;
 export declare abstract class Road {
     /** The absolute path to the file or directory that this Road instance represents.
      * @remarks Intentionally made protected to prevent external modification, as changing this value could lead to inconsistencies and unexpected behavior. */
@@ -39,163 +48,189 @@ export declare abstract class Road {
     /** Indicates whether the file or directory represented by this Road instance can be modified.
      * Changing this value does not affect the actual file system permissions, but rather serves as a safeguard within the application to prevent accidental modifications. */
     mutable: boolean;
-    /** Accessor for the absolute path to the file or directory that this Road instance represents. */
+    /** Copy of the absolute path. */
     get isAt(): string;
-    /** Accessor for the name of the file or directory that this Road instance represents. */
+    /** Name of the road without the path (including extensions). */
     get name(): string;
-    /** Same as {@link isAt} but for compatibility with external libraries that try to convert the object to a string. */
+    /** The amount of path segments in the absolute path to the file or directory represented by this Road instance, minus one (i.e., the depth of the path in the file system hierarchy). */
+    get depth(): number;
+    /** Same as {@link isAt} but for compatibility with external APIs. */
     toString(): string;
-    /** Returns the OS file type of the file or directory.
-     * Return value (OS type) and the type of this instance are not guaranteed to be the same, as the file system may have changed since this instance was created. */
-    typeSync(): typeof File | typeof Folder | typeof SymbolicLink | typeof BlockDevice;
-    /** Async version of {@link typeSync}. */
-    type(): Promise<typeof File | typeof Folder | typeof SymbolicLink | typeof BlockDevice>;
     /**
-     * Constructs a new Road instance representing the file or directory at the specified path.
+     * Creates a new instance of the Road class.
      *
-     * @param lookFor The path to the file or directory that this Road instance will represent.
-     * @param typeCheck Whether to check if the type of the file or directory at the specified path matches the type of this instance.
-     * This can be skipped for performance reasons if the type is known to be correct, but it is recommended to keep it enabled for safety.
-     * @throws If the specified path does not exist, throws a fs.{@link Error}.
-     * @throws If the type of the file or directory at the specified path does not match the type of this instance, throws a {@link RdErr}. Useful for subclasses.
-     */
-    constructor(lookFor: string, typeCheck: boolean | 1 | 0);
-    /**
-     * Verifies that the file or directory represented by this Road instance exists, is of the same type as this instance, and (optionally) is writable.
+     * @param path_ Any path-like string that can be resolved to an absolute path. It will be resolved to an absolute path using {@link ph.resolve}.
+     * @param typeCheck_ If true, the constructor will check if the path corresponds to the expected type of road (e.g., file, folder, etc.) and throw an error if it doesn't. If false, no type checking will be performed.
      *
-     * @param expectMode The expected access mode for this Road other than visibility by this process.
-     * @returns Result of the verification.
+     * @throws If {@link typeCheck_} is true and the path does not correspond to the expected type of road, a {@link RdErr} will be thrown.
      */
-    verify(expectMode: number, typeCheck: boolean): Promise<boolean>;
-    /** Sync version of {@link verify}. */
-    verifySync(expectMode: number, typeCheck: boolean): boolean;
+    constructor(path_: string, typeCheck_: boolean | 1 | 0);
     /**
-     * Creates a disposable lock for the file or directory represented by this Road instance, preventing concurrent modifications.
+     * Aquires a lock for the path represented by this Road instance, preventing concurrent modifications from this and other Road instances pointing to the same path.
      *
-     * @returns An object with a `dispose` method that releases the lock when called. The lock is automatically released when the object is garbage collected.
-     * @remarks Please use this method with the `await using` statement to ensure that the lock is properly released after the operation is complete. This method is intended for internal use and shouldn't be called directly in most cases. (that's why it's protected)
-     */
-    protected initChange(): Promise<{
-        [Symbol.dispose](): void;
-        [Symbol.asyncDispose](): Promise<void>;
-    }>;
-    /**
-     * Sync version of {@link initChangeSync}.
+     * @param cb_ A callback function that will be called when the lock is released. This is used internally to manage the lock state.
+     * @returns An object with a dispose method that releases the lock when called.
+     * @throws If the road is immutable, a {@link RdErr} will be thrown.
      *
-     * @remarks This sync version will throw if the road is already locked by another operation.
+     * @remarks This method MUST be used with a `using` statement to ensure that the lock is released properly. Failing to do so may result in deadlocks or other concurrency issues.
+     * Non-deterministic release is unfortunately not possible due to the nature of JavaScript's garbage collection, thus the lock must be released deterministically by the user (to which the `using` statement is a convenient way to do so).
      */
-    protected initChangeSync(): {
-        [Symbol.dispose](): void;
-        [Symbol.asyncDispose](): Promise<void>;
-    };
+    protected lock(cb_?: () => void): Promise<AsyncDisposable & Disposable>;
     /**
-     * Checks if the file or directory represented by this Road is both visible and of the same type as expected.
+     * Sync version of {@link lock}.
+     * @throws Also throws a {@link RdErr} if the road is currently locked by another operation as it cannot wait for the lock to be released in a synchronous context.
      */
-    exists(): Promise<boolean>;
-    existsSync(): boolean;
+    protected lockSync(cb_?: () => void): Disposable & AsyncDisposable;
+    /** @returns An instance of {@link Folder} representing the parent directory of the current road. */
+    parent(): Folder;
     /**
-     * @returns The file system stats for the file or directory.
-     * @see {@link fs.lstat}
+     * An async generator that yields the ancestors of the current road, starting from its parent and moving up the directory tree until it reaches the root.
+     *
+     * @yields Each ancestor folder as a {@link Folder} instance.
      */
-    stats(): Promise<fs.Stats>;
+    ancestorsIt(): Generator<Folder, void, unknown>;
+    /** @returns An array of {@link Folder} instances representing the ancestors of the current road. */
+    ancestors(): Folder[];
     /**
-     * @returns The file system stats for the file or directory.
-     * @see {@link fs.lstatSync}
+     * Watches the current entry for changes and resolves when the entry becomes accessible (i.e., exists and can be accessed).
+     *
+     * @param abs An {@link AbortSignal} that stops the watching process when aborted.
+     * @param expectMode The expected access mode for the entry, defaults to {@link fsc.F_OK} (existence check).
+     * @param cb_ An optional callback function that will be called with any errors encountered while checking for accessibility.
+     * @see {@link fp.access} on how the check for accessibility is performed.
+     * @see {@link fs.watch} for more information on how the watching process works.
+     * @see {@link on} for more information on how the event listener is set up.
      */
-    statsSync(): fs.Stats;
+    untilAccessible(abs: AbortSignal, expectMode?: number, cb_?: (err: unknown) => unknown): Promise<void>;
     /**
-     * @returns The amount of path segments in the absolute path to the file or directory represented by this Road instance, minus one (i.e., the depth of the file or directory in the file system hierarchy).
-     * @remarks As subclasses of {@link Road} require all paths to be absolute/normalized and valid, this method is guaranteed to return a non-negative integer.
+     * Watches the current entry for changes and resolves when the entry is changed.
+     *
+     * @param abs_ An {@link AbortSignal} that stops the watching process when aborted.
+     * @param cb_ An optional callback function that will be called when the entry is changed.
+     * @returns The return value of the callback function, or null if no callback is provided.
      */
-    depth(): number;
-    /** @returns The parent folder of the file or directory represented by this Road instance. */
-    parent(): Folder;
-    ancestorsIt(): Generator<Folder, void, unknown>;
-    ancestors(): Folder[];
-    untilAccessible(mode: number | undefined, abs: AbortSignal, onEachAttempt?: () => unknown): Promise<void>;
-    onChange<T>(abs: AbortSignal, cb?: () => T): Promise<NonNullable<Awaited<T>> | null>;
-    metaSync(suffixID?: string): NonSharedBuffer;
-    meta(suffixID?: string): Promise<Record<string, unknown>>;
-    setMetaSync(meta: Record<string, unknown>, suffixID?: string): void;
-    setMeta(meta: Record<string, unknown>, suffixID?: string): Promise<void>;
-    abstract deleteSync(): void;
+    onChange<T>(abs_: AbortSignal, cb_?: () => T): Promise<NonNullable<Awaited<T>> | null>;
+    /** @returns The result of {@link fp.lstat} for the current entry. */
+    lstat(): Promise<fs.Stats>;
+    /** @returns The result of {@link fs.lstatSync} for the current entry. */
+    lstatSync(): fs.Stats;
+    /** @returns The result of {@link fp.stat} for the current entry. */
+    stat(): Promise<fs.Stats>;
+    /** @returns The result of {@link fs.statSync} for the current entry. */
+    statSync(): fs.Stats;
     abstract delete(): Promise<void>;
-    abstract moveSync(into: Folder): void;
-    abstract move(into: Folder): Promise<void>;
-    abstract copySync(into: Folder): this;
-    abstract copy(into: Folder): Promise<this>;
-    abstract renameSync(to: string): void;
-    abstract rename(to: string): Promise<void>;
-    abstract resurrectSync(): void;
-    abstract resurrect(): Promise<void>;
+    abstract deleteSync(): void;
+    abstract moveSync(into_: Folder): void;
+    abstract move(into_: Folder): Promise<void>;
+    abstract copySync(into_: Folder): this;
+    abstract copy(into_: Folder): Promise<this>;
+    abstract renameSync(to_: string): void;
+    abstract rename(to_: string): Promise<void>;
+    abstract check(): Promise<boolean>;
+    abstract checkSync(): boolean;
+    /** Type narrowing for {@link File} (similar to `instanceof` without unnecessary runtime checks). */
+    isFile(): this is File;
+    /** Type narrowing for {@link Folder} (similar to `instanceof` without unnecessary runtime checks). */
+    isDir(): this is Folder;
+    /** Type narrowing for {@link Folder} (similar to `instanceof` without unnecessary runtime checks). */
+    isFolder(): this is Folder;
+    /** Type narrowing for {@link Folder} (similar to `instanceof` without unnecessary runtime checks). */
+    isDirectory(): this is Folder;
+    /** Type narrowing for {@link Folder} (similar to `instanceof` without unnecessary runtime checks). */
+    isDict(): this is Folder;
+    /** Type narrowing for {@link Folder} (similar to `instanceof` without unnecessary runtime checks). */
+    isDictionary(): this is Folder;
+    /** Type narrowing for {@link SymbolicLink} (similar to `instanceof` without unnecessary runtime checks). */
+    isSymlink(): this is SymbolicLink;
+    /** Type narrowing for {@link SymbolicLink} (similar to `instanceof` without unnecessary runtime checks). */
+    isSymbolicLink(): this is SymbolicLink;
+    /** Type narrowing for {@link UnusableRoad} (similar to `instanceof` without unnecessary runtime checks). */
+    isUnusable(): this is UnusableRoad;
+    /** Type narrowing for {@link BlockDevice} (similar to `instanceof` without unnecessary runtime checks). */
+    isBlockDevice(): this is BlockDevice;
+    /** Type narrowing for {@link CharacterDevice} (similar to `instanceof` without unnecessary runtime checks). */
+    isCharacterDevice(): this is CharacterDevice;
+    /** Type narrowing for {@link Fifo} (similar to `instanceof` without unnecessary runtime checks). */
+    isFifo(): this is Fifo;
+    /** Type narrowing for {@link Socket} (similar to `instanceof` without unnecessary runtime checks). */
+    isSocket(): this is Socket;
 }
+/** Subclass of {@link Road} that represents a file. */
 export declare class File extends Road {
+    static create(at_: string): Promise<File>;
+    static createSync(at_: string): File;
     get ext(): string;
     get noExt(): string;
-    static createSync(at: string): File;
-    static create(at: string): Promise<File>;
-    readSync(): Buffer;
-    readSync(encoding: BufferEncoding, flag?: string): string;
     read(): Promise<Buffer>;
-    read(encoding: BufferEncoding, flag?: string): Promise<string>;
-    itBuffSync(chunkSize?: number, flags?: string | number, mode?: fs.Mode): Generator<Buffer<ArrayBuffer>, void, unknown>;
-    itBuff(chunkSize?: number, flags?: string | number, mode?: fs.Mode): AsyncGenerator<Buffer<ArrayBuffer>, void, unknown>;
-    itLines(options?: Parameters<typeof fs.createReadStream>[1]): AsyncGenerator<string, void, unknown>;
-    computeHashSync(algorithm?: string, options?: cr.HashOptions): Buffer;
-    computeHashSync(algorithm?: string, options?: cr.HashOptions, encoding?: BufferEncoding): string;
-    computeHash(algorithm?: string, options?: cr.HashOptions): Promise<Buffer>;
-    computeHash(algorithm?: string, options?: cr.HashOptions, encoding?: BufferEncoding): Promise<string>;
-    streamHash(algorithm?: string, options?: cr.HashOptions, encoding?: BufferEncoding): Promise<Buffer | string>;
-    writeSync(data: Buffer | string, options?: fs.WriteFileOptions): void;
-    write(data: Buffer | string, options?: fs.WriteFileOptions): Promise<void>;
-    appendSync(data: Buffer | string, options?: fs.WriteFileOptions): void;
-    append(data: Buffer | string, options?: fs.WriteFileOptions): Promise<void>;
-    sameAs(other: File): Promise<boolean>;
-    sameAsSync(other: File): boolean;
-    deleteSync(): void;
+    read(encoding_: BufferEncoding, flag_?: string): Promise<string>;
+    readSync(): Buffer;
+    readSync(encoding_: BufferEncoding, flag_?: string): string;
+    itBuff(chunkSize_?: number, flags_?: string | number, mode_?: fs.Mode): AsyncGenerator<Buffer<ArrayBuffer>, void, unknown>;
+    itBuffSync(chunkSize_?: number, flags_?: string | number, mode_?: fs.Mode): Generator<Buffer<ArrayBuffer>, void, unknown>;
+    write(data_: Buffer | string, options_?: fs.WriteFileOptions): Promise<void>;
+    writeSync(data_: Buffer | string, options_?: fs.WriteFileOptions): void;
+    append(data_: Buffer | string, options_?: fs.WriteFileOptions): Promise<void>;
+    appendSync(data_: Buffer | string, options_?: fs.WriteFileOptions): void;
     delete(): Promise<void>;
-    moveSync(into: Folder): void;
-    move(into: Folder): Promise<void>;
-    copySync(into: Folder): this;
-    copy(into: Folder): Promise<this>;
-    renameSync(to: string): void;
-    rename(to: string): Promise<void>;
-    resurrectSync(): void;
-    resurrect(): Promise<void>;
+    deleteSync(): void;
+    move(into_: Folder): Promise<void>;
+    moveSync(into_: Folder): void;
+    copy(into_: Folder): Promise<this>;
+    copySync(into_: Folder): this;
+    rename(to_: string): Promise<void>;
+    renameSync(to_: string): void;
+    check(): Promise<boolean>;
+    checkSync(): boolean;
+    isFile(): this is File;
 }
-export declare function entry(): File;
+export declare function computeHash(f_: File, algorithm_?: string, options_?: cr.HashOptions): Promise<Buffer>;
+export declare function computeHash(f_: File, algorithm_?: string, options_?: cr.HashOptions, encoding_?: BufferEncoding): Promise<string>;
+export declare function computeHashSync(f_: File, algorithm_?: string, options_?: cr.HashOptions): Buffer;
+export declare function computeHashSync(f_: File, algorithm_?: string, options_?: cr.HashOptions, encoding_?: BufferEncoding): string;
+export declare function streamHash(f_: File, algorithm_?: string, options_?: cr.HashOptions): Promise<Buffer>;
+export declare function streamHash(f_: File, algorithm_?: string, options_?: cr.HashOptions, encoding_?: BufferEncoding): Promise<string>;
+export declare function streamHashSync(f_: File, algorithm_?: string, options_?: cr.HashOptions): Buffer;
+export declare function streamHashSync(f_: File, algorithm_?: string, options_?: cr.HashOptions, encoding_?: BufferEncoding): string;
+export declare function itLines(f_: File, options_?: fs.ReadStreamOptions): AsyncGenerator<string, void, unknown>;
+export declare function fileSameAs(f1_: File, f2_: File): Promise<boolean>;
+export declare function fileSameAsSync(f1_: File, f2_: File): boolean;
 export declare class Folder extends Road {
-    static create(at: string): Promise<Folder>;
-    static createSync(at: string): Folder;
-    join(...paths: string[]): string;
-    itSync(): Iterable<Road>;
-    itSync<T extends Road>(expectedType: new () => T): Iterable<T>;
+    static create(at_: string): Promise<Folder>;
+    static createSync(at_: string): Folder;
+    join(...paths_: string[]): string;
     it(): AsyncIterable<Road>;
-    it<T extends Road>(expectedType: new () => T): AsyncIterable<T>;
-    listSync(): Road[];
-    listSync<T extends Road>(expectedType: new () => T): T[];
+    it<T extends Road>(expectedType_: new () => T): AsyncIterable<T>;
+    itSync(): Iterable<Road>;
+    itSync<T extends Road>(expectedType_: new () => T): Iterable<T>;
     list(): Promise<Road[]>;
-    list<T extends Road>(_expectedType: new () => T): Promise<T[]>;
-    findSync(name: string): Road | null;
-    findSync<T extends Road>(name: string, _expectedType: new () => T): T | null;
-    find(name: string): Promise<Road | null>;
-    find<T extends Road>(name: string, _expectedType: new () => T): Promise<T | null>;
-    addSync<T extends Road>(name: string, createable: {
-        createSync: (at: string) => T;
-    }): T;
-    add<T extends Road>(name: string, createable: {
+    list<T extends Road>(expectedType_: new () => T): Promise<T[]>;
+    listSync(): Road[];
+    listSync<T extends Road>(expectedType_: new () => T): T[];
+    find(name_: string): Promise<Road | null>;
+    find<T extends Road>(name_: string, expectedType_: new () => T): Promise<T | null>;
+    findSync(name_: string): Road | null;
+    findSync<T extends Road>(name_: string, expectedType_: new () => T): T | null;
+    add<T extends Road>(name_: string, createable_: {
         create: (at: string) => Promise<T>;
     }): Promise<T>;
-    deleteSync(options?: fs.RmOptions): void;
-    delete(options?: fs.RmOptions): Promise<void>;
-    moveSync(into: Folder): void;
-    move(into: Folder): Promise<void>;
-    copySync(into: Folder): this;
-    copy(into: Folder): Promise<this>;
-    renameSync(to: string): void;
-    rename(to: string): Promise<void>;
-    resurrectSync(): void;
-    resurrect(): Promise<void>;
+    addSync<T extends Road>(name_: string, createable_: {
+        createSync: (at: string) => T;
+    }): T;
+    delete(options_?: fs.RmOptions): Promise<void>;
+    deleteSync(options_?: fs.RmOptions): void;
+    move(into_: Folder): Promise<void>;
+    moveSync(into_: Folder): void;
+    copy(into_: Folder): Promise<this>;
+    copySync(into_: Folder): this;
+    rename(to_: string): Promise<void>;
+    renameSync(to_: string): void;
+    check(): Promise<boolean>;
+    checkSync(): boolean;
+    isFolder(): this is Folder;
+    isDir(): this is Folder;
+    isDirectory(): this is Folder;
+    isDict(): this is Folder;
+    isDictionary(): this is Folder;
 }
 export declare function sysRoot(): Folder;
 export declare function home(): Folder;
@@ -203,59 +238,64 @@ export declare function tmp(): Folder;
 export declare function here(): Folder;
 export { Folder as Dir, Folder as Directory, Folder as Dict, Folder as Dictionary };
 export declare class SymbolicLink extends Road {
-    static create(at: string, target: Road): Promise<SymbolicLink>;
-    static createSync(_at: string, _target: Road): SymbolicLink;
-    targetSync(): BlockDevice | File | Folder | SymbolicLink;
-    target(): Promise<BlockDevice | File | Folder | SymbolicLink>;
-    retargetSync(_newTarget: Road): void;
-    retarget(_newTarget: Road): Promise<void>;
-    deleteSync(): void;
+    static create(at_: string, target_: string | Road): Promise<SymbolicLink>;
+    static createSync(at_: string, target_: string | Road): SymbolicLink;
+    target(): Promise<BlockDevice | CharacterDevice | Fifo | File | Folder | Socket | SymbolicLink>;
+    targetSync(): BlockDevice | CharacterDevice | Fifo | File | Folder | Socket | SymbolicLink;
+    retarget(to_: Road): Promise<void>;
+    retargetSync(to_: Road): void;
     delete(): Promise<void>;
-    moveSync(_into: Folder): void;
-    move(_into: Folder): Promise<void>;
-    copySync(_into: Folder): this;
-    copy(_into: Folder): Promise<this>;
-    renameSync(_to: string): void;
-    rename(_to: string): Promise<void>;
-    resurrectSync(): void;
-    resurrect(): Promise<void>;
+    deleteSync(): void;
+    move(into_: Folder): Promise<void>;
+    moveSync(into_: Folder): void;
+    copy(into_: Folder): Promise<this>;
+    copySync(into_: Folder): this;
+    rename(to_: string): Promise<void>;
+    renameSync(to_: string): void;
+    check(): Promise<boolean>;
+    checkSync(): boolean;
+    isSymlink(): this is SymbolicLink;
+    isSymbolicLink(): this is SymbolicLink;
 }
 export { SymbolicLink as Symlink };
 export declare abstract class UnusableRoad extends Road {
     readonly mutable: boolean;
-    constructor(_at: string, typeCheck: boolean);
+    constructor(...args_: ConstructorParameters<typeof Road>);
     error(): never;
-    initChangeSync(): never;
-    initChange(): Promise<never>;
-    deleteSync(): never;
+    lock(): Promise<never>;
+    lockSync(): never;
     delete(): Promise<never>;
-    moveSync(): never;
+    deleteSync(): never;
     move(): Promise<never>;
-    copySync(): never;
+    moveSync(): never;
     copy(): Promise<never>;
-    renameSync(): never;
+    copySync(): never;
     rename(): Promise<never>;
-    resurrectSync(): never;
-    resurrect(): Promise<never>;
+    renameSync(): never;
+    isUnusable(): this is UnusableRoad;
 }
 export declare class BlockDevice extends UnusableRoad {
+    check(): Promise<boolean>;
+    checkSync(): boolean;
+    isBlockDevice(): this is BlockDevice;
 }
 export declare class CharacterDevice extends UnusableRoad {
+    check(): Promise<boolean>;
+    checkSync(): boolean;
+    isCharacterDevice(): this is CharacterDevice;
 }
 export declare class Fifo extends UnusableRoad {
+    check(): Promise<boolean>;
+    checkSync(): boolean;
+    isFifo(): this is Fifo;
 }
 export declare class Socket extends UnusableRoad {
+    check(): Promise<boolean>;
+    checkSync(): boolean;
+    isSocket(): this is Socket;
 }
-export declare let finalizer: FinalizationRegistry<string> | null;
-export declare let toDelete: Set<string> | null;
-/**
- * Forcefully cleans up all files and folders registered for cleanup on exit.
- *
- * @remarks This function is not recommended to be called manually, as it will delete all files and folders registered for cleanup on exit, which may lead to data loss if called at the wrong time. This function is intended to be called automatically when the process exits.
- */
-export declare function forceCleanupToDelete(): void;
-export declare function registerToCleanup(self: Road): void;
-export declare function Temp<T extends Road>(createable: {
+export declare function registerToCleanup(self_: Road): void;
+export declare function Temp<T extends Road>(createable_: {
     createSync: (at: string) => T;
-}, autoCleanup: boolean): T & Disposable & AsyncDisposable;
+}, autoCleanup_: boolean): T & Disposable & AsyncDisposable;
 //# sourceMappingURL=road.d.ts.map

package/dist/road.d.ts.map

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