initial

ts/classes/smartfs.directory.ts

@@ -0,0 +1,139 @@
+/**
+ * Directory builder for fluent directory operations
+ */
+
+import type { ISmartFsProvider } from '../interfaces/mod.provider.js';
+import type {
+  TFileMode,
+  IFileStats,
+  IDirectoryEntry,
+  IListOptions,
+} from '../interfaces/mod.types.js';
+
+/**
+ * Directory builder class for fluent directory operations
+ * Configuration methods return `this` for chaining
+ * Action methods return Promises for execution
+ */
+export class SmartFsDirectory {
+  private provider: ISmartFsProvider;
+  private path: string;
+
+  // Configuration options
+  private options: {
+    recursive?: boolean;
+    mode?: TFileMode;
+    filter?: string | RegExp | ((entry: IDirectoryEntry) => boolean);
+    includeStats?: boolean;
+  } = {};
+
+  constructor(provider: ISmartFsProvider, path: string) {
+    this.provider = provider;
+    this.path = this.provider.normalizePath(path);
+  }
+
+  // --- Configuration Methods (return this for chaining) ---
+
+  /**
+   * Enable recursive operations (for list, create, delete)
+   */
+  public recursive(): this {
+    this.options.recursive = true;
+    return this;
+  }
+
+  /**
+   * Set directory permissions/mode
+   * @param mode - Directory mode (e.g., 0o755)
+   */
+  public mode(mode: TFileMode): this {
+    this.options.mode = mode;
+    return this;
+  }
+
+  /**
+   * Filter directory entries
+   * @param filter - String pattern, RegExp, or filter function
+   *
+   * @example
+   * ```typescript
+   * // String pattern (glob-like)
+   * .filter('*.ts')
+   *
+   * // RegExp
+   * .filter(/\.ts$/)
+   *
+   * // Function
+   * .filter(entry => entry.isFile && entry.name.endsWith('.ts'))
+   * ```
+   */
+  public filter(filter: string | RegExp | ((entry: IDirectoryEntry) => boolean)): this {
+    this.options.filter = filter;
+    return this;
+  }
+
+  /**
+   * Include file statistics in directory listings
+   */
+  public includeStats(): this {
+    this.options.includeStats = true;
+    return this;
+  }
+
+  // --- Action Methods (return Promises) ---
+
+  /**
+   * List directory contents
+   * @returns Array of directory entries
+   */
+  public async list(): Promise<IDirectoryEntry[]> {
+    const listOptions: IListOptions = {
+      recursive: this.options.recursive,
+      filter: this.options.filter,
+      includeStats: this.options.includeStats,
+    };
+    return this.provider.listDirectory(this.path, listOptions);
+  }
+
+  /**
+   * Create the directory
+   */
+  public async create(): Promise<void> {
+    return this.provider.createDirectory(this.path, {
+      recursive: this.options.recursive,
+      mode: this.options.mode,
+    });
+  }
+
+  /**
+   * Delete the directory
+   */
+  public async delete(): Promise<void> {
+    return this.provider.deleteDirectory(this.path, {
+      recursive: this.options.recursive,
+    });
+  }
+
+  /**
+   * Check if the directory exists
+   * @returns True if directory exists
+   */
+  public async exists(): Promise<boolean> {
+    return this.provider.directoryExists(this.path);
+  }
+
+  /**
+   * Get directory statistics
+   * @returns Directory stats
+   */
+  public async stat(): Promise<IFileStats> {
+    return this.provider.directoryStat(this.path);
+  }
+
+  /**
+   * Get the directory path
+   */
+  public getPath(): string {
+    return this.path;
+  }
+}