@statewalker/webrun-files 0.5.0 → 0.9.0

package/src/types.ts

@@ -1,79 +1,162 @@
 /**
- * Type definitions for IFilesApi
+ * Core types for FilesApi abstraction
  */
 
 export type FileKind = "file" | "directory";
 
-export interface FileInfo {
-  kind: FileKind;
-  name: string;
-  path: string;
-  type?: string;
-  size?: number;
-  lastModified: number;
+/**
+ * Options for reading file content with range support.
+ *
+ * @example
+ * // Read 100 bytes starting at position 50
+ * api.read("/file.bin", { start: 50, length: 100 })
+ *
+ * @example
+ * // Read from position 1000 to end of file
+ * api.read("/file.bin", { start: 1000 })
+ */
+export interface ReadOptions {
+  /** Starting byte position (0-indexed). Defaults to 0. */
+  start?: number;
+  /** Number of bytes to read. If omitted, reads to end of file. */
+  length?: number;
+  /** AbortSignal for cancellation support. */
+  signal?: AbortSignal;
 }
 
-export type FileRef = string | { path: string };
-
+/**
+ * Options for listing directory contents.
+ */
 export interface ListOptions {
+  /** If true, lists all descendants recursively. Defaults to false. */
   recursive?: boolean;
 }
 
-export interface CopyOptions {
-  recursive?: boolean;
+/**
+ * Metadata of a regular file.
+ *
+ * `size` and `lastModified` are REQUIRED. Every storage that can hold a file
+ * can say how large it is and when it last changed; an implementation that
+ * cannot is claiming less than it must, and the omission must surface as a
+ * failure rather than as an `undefined` a consumer has to defend against.
+ */
+export interface FileEntryStats {
+  kind: "file";
+  /** Length in bytes. A zero-byte file is `0`, never `undefined`. */
+  size: number;
+  /** Modification time as milliseconds since the epoch. */
+  lastModified: number;
 }
 
-export interface AppendOptions {
-  signal?: AbortSignal;
+/**
+ * Metadata of a directory.
+ *
+ * Deliberately carries nothing else. A directory has no size, and a
+ * modification time is available on some storages (memory, a local
+ * filesystem) and unavailable on others (an object store, where a directory
+ * is a common prefix that exists only as an artefact of key naming). Neither
+ * value may be relied upon, so neither is part of the contract: an
+ * implementation that happens to know one drops it here instead of leaking a
+ * value consumers would have to treat as optional anyway.
+ */
+export interface DirectoryEntryStats {
+  kind: "directory";
 }
 
-export interface ReadStreamOptions {
-  start?: number;
-  end?: number;
-  signal?: AbortSignal;
-}
+/**
+ * File or directory metadata returned by `stats()`.
+ *
+ * A DISCRIMINATED UNION on `kind`, not a single shape with optional fields.
+ * The optionality this replaces never expressed what a given implementation
+ * could report — it expressed a property of the entry kind, collapsed into
+ * one type because `kind` was an ordinary field. Narrow on `kind` and the
+ * fields that exist for that kind are then known to be present:
+ *
+ * @example
+ * const stats = await api.stats("/some/path");
+ * if (stats?.kind === "file") {
+ *   console.log(stats.size, stats.lastModified); // both `number`
+ * }
+ */
+export type FileStats = FileEntryStats | DirectoryEntryStats;
 
-export interface WriteStreamOptions {
-  start?: number;
-  signal?: AbortSignal;
+/** Name and path carried by every entry a `list()` yields. */
+export interface FileEntryLocation {
+  name: string;
+  path: string;
 }
 
-export type BinaryStream = AsyncIterable<Uint8Array> | Iterable<Uint8Array>;
+/** A file yielded by `list()`. */
+export interface FileEntryInfo extends FileEntryStats, FileEntryLocation {}
 
-export interface FileHandle {
-  readonly size: number;
-  close(): Promise<void>;
+/** A directory yielded by `list()`. */
+export interface DirectoryEntryInfo extends DirectoryEntryStats, FileEntryLocation {}
 
-  appendFile(data: BinaryStream, options?: AppendOptions): Promise<number>;
-  createReadStream(options?: ReadStreamOptions): AsyncGenerator<Uint8Array>;
-  createWriteStream(data: BinaryStream, options?: WriteStreamOptions): Promise<number>;
+/**
+ * File or directory information returned by `list()`.
+ *
+ * The same union as {@link FileStats}, plus `name` and `path`, so a listing
+ * consumer narrows per entry exactly as a `stats()` consumer does.
+ */
+export type FileInfo = FileEntryInfo | DirectoryEntryInfo;
 
+/**
+ * Cross-platform filesystem abstraction interface.
+ *
+ * All paths are virtual paths using forward slashes and starting with "/".
+ * Implementations handle mapping to underlying storage.
+ */
+export interface FilesApi {
   /**
-   * Read bytes from the file at a specific position.
-   *
-   * @param buffer - The buffer to read bytes into
-   * @param offset - The offset in the buffer to start writing at
-   * @param length - The number of bytes to read
-   * @param position - The position in the file to start reading from
-   * @returns The number of bytes actually read (may be less than length at EOF)
+   * Read file content as an async iterable of chunks.
+   * Returns empty iterable for non-existent files.
    */
-  read(buffer: Uint8Array, offset: number, length: number, position: number): Promise<number>;
+  read(path: string, options?: ReadOptions): AsyncIterable<Uint8Array>;
 
-  chmod?(mode: number): Promise<void>;
-  chown?(uid: number, gid: number): Promise<void>;
-}
+  /**
+   * Write content to a file, creating parent directories as needed.
+   * Overwrites existing file content.
+   */
+  write(path: string, content: Iterable<Uint8Array> | AsyncIterable<Uint8Array>): Promise<void>;
 
-/**
- * Core filesystem interface - minimal contract for implementations.
- * Platform-specific implementations should implement this interface.
- */
-export interface IFilesApi {
-  list(file: FileRef, options?: ListOptions): AsyncGenerator<FileInfo>;
-  stats(file: FileRef): Promise<FileInfo | undefined>;
-  remove(file: FileRef): Promise<boolean>;
-  open(file: FileRef): Promise<FileHandle>;
-
-  move?(source: FileRef, target: FileRef): Promise<boolean>;
-  copy?(source: FileRef, target: FileRef, options?: CopyOptions): Promise<boolean>;
-  mkdir?(file: FileRef): Promise<void>;
+  /**
+   * Create a directory and all parent directories.
+   * No-op if directory already exists.
+   */
+  mkdir(path: string): Promise<void>;
+
+  /**
+   * List directory contents.
+   * Returns empty iterable for non-existent or non-directory paths.
+   */
+  list(path: string, options?: ListOptions): AsyncIterable<FileInfo>;
+
+  /**
+   * Get file or directory metadata.
+   * Returns undefined for non-existent paths.
+   */
+  stats(path: string): Promise<FileStats | undefined>;
+
+  /**
+   * Check if a path exists.
+   */
+  exists(path: string): Promise<boolean>;
+
+  /**
+   * Remove a file or directory (recursively).
+   * Returns true if something was removed, false if path didn't exist.
+   */
+  remove(path: string): Promise<boolean>;
+
+  /**
+   * Move/rename a file or directory.
+   * Returns true on success, false if source doesn't exist.
+   */
+  move(source: string, target: string): Promise<boolean>;
+
+  /**
+   * Copy a file or directory (recursively).
+   * Returns true on success, false if source doesn't exist.
+   */
+  copy(source: string, target: string): Promise<boolean>;
 }

package/dist/files-api.d.ts

@@ -1,44 +0,0 @@
-/**
- * FilesApi wrapper class providing convenience methods on top of IFilesApi
- */
-import type { BinaryStream, CopyOptions, FileHandle, FileInfo, FileRef, IFilesApi, ListOptions, ReadStreamOptions } from "./types.js";
-export declare class FilesApi implements IFilesApi {
-    private fs;
-    constructor(fs: IFilesApi);
-    list(file: FileRef, options?: ListOptions): AsyncGenerator<FileInfo>;
-    stats(file: FileRef): Promise<FileInfo | undefined>;
-    remove(file: FileRef): Promise<boolean>;
-    open(file: FileRef): Promise<FileHandle>;
-    /**
-     * Checks if a file or directory exists.
-     */
-    exists(file: FileRef): Promise<boolean>;
-    /**
-     * Reads file content as a stream.
-     */
-    read(file: FileRef, options?: ReadStreamOptions): AsyncGenerator<Uint8Array>;
-    /**
-     * Writes content to a file.
-     */
-    write(file: FileRef, content: BinaryStream): Promise<void>;
-    /**
-     * Reads entire file into a single buffer.
-     */
-    readFile(file: FileRef): Promise<Uint8Array>;
-    /**
-     * Copies file or directory.
-     * Uses native implementation if available, otherwise falls back to read/write.
-     */
-    copy(source: FileRef, target: FileRef, options?: CopyOptions): Promise<boolean>;
-    /**
-     * Moves file or directory.
-     * Uses native implementation if available, otherwise falls back to copy+delete.
-     */
-    move(source: FileRef, target: FileRef): Promise<boolean>;
-    /**
-     * Creates a directory.
-     * Uses native implementation if available, otherwise creates a placeholder file.
-     */
-    mkdir(file: FileRef): Promise<void>;
-}
-//# sourceMappingURL=files-api.d.ts.map

package/dist/files-api.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"files-api.d.ts","sourceRoot":"","sources":["../src/files-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,QAAQ,EACR,OAAO,EACP,SAAS,EACT,WAAW,EACX,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAOpB,qBAAa,QAAS,YAAW,SAAS;IAC5B,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,SAAS;IAMjC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC;IAIpE,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAInD,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAQxC;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAK7C;;OAEG;IACI,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,iBAAsB,GAAG,cAAc,CAAC,UAAU,CAAC;IASvF;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAShE;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAqBlD;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BzF;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAa9D;;;OAGG;IACG,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAW1C"}

package/dist/impl/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * IFilesApi implementations
- */
-export * from "./mem-files-api.js";
-export * from "./node-files-api.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/impl/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/impl/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/impl/mem-files-api.d.ts

@@ -1,13 +0,0 @@
-/**
- * In-memory implementation of IFilesApi for testing
- */
-import type { FileHandle, FileInfo, FileRef, IFilesApi, ListOptions } from "../types.js";
-export declare class MemFilesApi implements IFilesApi {
-    private store;
-    list(file: FileRef, options?: ListOptions): AsyncGenerator<FileInfo>;
-    stats(file: FileRef): Promise<FileInfo | undefined>;
-    remove(file: FileRef): Promise<boolean>;
-    open(file: FileRef): Promise<FileHandle>;
-    mkdir(file: FileRef): Promise<void>;
-}
-//# sourceMappingURL=mem-files-api.d.ts.map

package/dist/impl/mem-files-api.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mem-files-api.d.ts","sourceRoot":"","sources":["../../src/impl/mem-files-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAGV,UAAU,EACV,QAAQ,EACR,OAAO,EACP,SAAS,EACT,WAAW,EAGZ,MAAM,aAAa,CAAC;AA8JrB,qBAAa,WAAY,YAAW,SAAS;IAC3C,OAAO,CAAC,KAAK,CAA4B;IAElC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,cAAc,CAAC,QAAQ,CAAC;IAqEzE,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IA0CnD,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBvC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAKxC,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAS1C"}

package/dist/impl/node-files-api.d.ts

@@ -1,24 +0,0 @@
-/**
- * Node.js implementation of IFilesApi
- */
-import type * as NodeFS from "node:fs/promises";
-import type { CopyOptions, FileHandle, FileInfo, FileRef, IFilesApi, ListOptions } from "../types.js";
-interface NodeFilesApiOptions {
-    fs: typeof NodeFS;
-    rootDir?: string;
-}
-export declare class NodeFilesApi implements IFilesApi {
-    private fs;
-    private rootDir;
-    constructor(options: NodeFilesApiOptions);
-    private resolvePath;
-    list(file: FileRef, options?: ListOptions): AsyncGenerator<FileInfo>;
-    stats(file: FileRef): Promise<FileInfo | undefined>;
-    remove(file: FileRef): Promise<boolean>;
-    open(file: FileRef): Promise<FileHandle>;
-    move(source: FileRef, target: FileRef): Promise<boolean>;
-    copy(source: FileRef, target: FileRef, options?: CopyOptions): Promise<boolean>;
-    mkdir(file: FileRef): Promise<void>;
-}
-export {};
-//# sourceMappingURL=node-files-api.d.ts.map

package/dist/impl/node-files-api.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node-files-api.d.ts","sourceRoot":"","sources":["../../src/impl/node-files-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAEhD,OAAO,KAAK,EAGV,WAAW,EACX,UAAU,EACV,QAAQ,EACR,OAAO,EACP,SAAS,EACT,WAAW,EAGZ,MAAM,aAAa,CAAC;AAIrB,UAAU,mBAAmB;IAC3B,EAAE,EAAE,OAAO,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4GD,qBAAa,YAAa,YAAW,SAAS;IAC5C,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,mBAAmB;IAKxC,OAAO,CAAC,WAAW;IAKZ,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,cAAc,CAAC,QAAQ,CAAC;IAsCzE,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAkBnD,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBvC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAexC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBxD,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBnF,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAI1C"}

package/dist/utils/collect-stream.d.ts

@@ -1,16 +0,0 @@
-/**
- * Stream collection utilities
- */
-/**
- * Collects all values from an async generator into an array.
- */
-export declare function collectGenerator<T>(generator: AsyncIterable<T>): Promise<T[]>;
-/**
- * Converts a synchronous iterable to an async iterable.
- */
-export declare function toAsyncIterable<T>(iterable: Iterable<T>): AsyncIterable<T>;
-/**
- * Normalizes BinaryStream to AsyncIterable<Uint8Array>.
- */
-export declare function toBinaryAsyncIterable(data: AsyncIterable<Uint8Array> | Iterable<Uint8Array>): AsyncIterable<Uint8Array>;
-//# sourceMappingURL=collect-stream.d.ts.map

package/dist/utils/collect-stream.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"collect-stream.d.ts","sourceRoot":"","sources":["../../src/utils/collect-stream.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAMnF;AAED;;GAEG;AACH,wBAAuB,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAIjF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,GACrD,aAAa,CAAC,UAAU,CAAC,CAK3B"}

package/dist/utils/file-info-utils.d.ts

@@ -1,10 +0,0 @@
-import type { FileInfo } from "../types.js";
-/**
- * Check if FileInfo represents a directory
- */
-export declare function isDirectory(info: FileInfo | undefined): boolean;
-/**
- * Check if FileInfo represents a file
- */
-export declare function isFile(info: FileInfo | undefined): boolean;
-//# sourceMappingURL=file-info-utils.d.ts.map

package/dist/utils/file-info-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"file-info-utils.d.ts","sourceRoot":"","sources":["../../src/utils/file-info-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAE/D;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAE1D"}

package/dist/utils/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Utility functions
- */
-export * from "./collect-stream.js";
-export * from "./file-info-utils.js";
-export * from "./normalize-path.js";
-export * from "./path-utils.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}

package/dist/utils/normalize-path.d.ts

@@ -1,21 +0,0 @@
-/**
- * Path normalization utilities
- */
-import type { FileRef } from "../types.js";
-/**
- * Normalizes a file path to a consistent format.
- * - Adds leading slash if missing
- * - Removes trailing slash
- * - Removes `.` segments
- * - Collapses multiple slashes
- */
-export declare function normalizePath(filePath: string): string;
-/**
- * Extracts path string from FileRef.
- */
-export declare function toPath(file: FileRef): string;
-/**
- * Normalizes FileRef to a path string.
- */
-export declare function resolveFileRef(file: FileRef): string;
-//# sourceMappingURL=normalize-path.d.ts.map

package/dist/utils/normalize-path.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"normalize-path.d.ts","sourceRoot":"","sources":["../../src/utils/normalize-path.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEpD"}

package/dist/utils/path-utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-utils.d.ts","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAGtD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C"}

package/src/files-api.ts

@@ -1,168 +0,0 @@
-/**
- * FilesApi wrapper class providing convenience methods on top of IFilesApi
- */
-
-import type {
-  BinaryStream,
-  CopyOptions,
-  FileHandle,
-  FileInfo,
-  FileRef,
-  IFilesApi,
-  ListOptions,
-  ReadStreamOptions,
-} from "./types.js";
-import { toBinaryAsyncIterable } from "./utils/collect-stream.js";
-import { resolveFileRef } from "./utils/index.js";
-import { joinPath } from "./utils/path-utils.js";
-
-const IGNORE_FILE = ".ignore";
-
-export class FilesApi implements IFilesApi {
-  constructor(private fs: IFilesApi) {}
-
-  // ========================================
-  // IFilesApi delegation
-  // ========================================
-
-  list(file: FileRef, options?: ListOptions): AsyncGenerator<FileInfo> {
-    return this.fs.list(file, options);
-  }
-
-  stats(file: FileRef): Promise<FileInfo | undefined> {
-    return this.fs.stats(file);
-  }
-
-  remove(file: FileRef): Promise<boolean> {
-    return this.fs.remove(file);
-  }
-
-  open(file: FileRef): Promise<FileHandle> {
-    return this.fs.open(file);
-  }
-
-  // ========================================
-  // Convenience methods built on core API
-  // ========================================
-
-  /**
-   * Checks if a file or directory exists.
-   */
-  async exists(file: FileRef): Promise<boolean> {
-    const info = await this.stats(file);
-    return info !== undefined;
-  }
-
-  /**
-   * Reads file content as a stream.
-   */
-  async *read(file: FileRef, options: ReadStreamOptions = {}): AsyncGenerator<Uint8Array> {
-    const handle = await this.open(file);
-    try {
-      yield* handle.createReadStream(options);
-    } finally {
-      await handle.close();
-    }
-  }
-
-  /**
-   * Writes content to a file.
-   */
-  async write(file: FileRef, content: BinaryStream): Promise<void> {
-    const handle = await this.open(file);
-    try {
-      await handle.createWriteStream(toBinaryAsyncIterable(content));
-    } finally {
-      await handle.close();
-    }
-  }
-
-  /**
-   * Reads entire file into a single buffer.
-   */
-  async readFile(file: FileRef): Promise<Uint8Array> {
-    const chunks: Uint8Array[] = [];
-    let totalLength = 0;
-
-    for await (const chunk of this.read(file)) {
-      chunks.push(chunk);
-      totalLength += chunk.length;
-    }
-
-    if (chunks.length === 0) return new Uint8Array(0);
-    if (chunks.length === 1) return chunks[0];
-
-    const result = new Uint8Array(totalLength);
-    let offset = 0;
-    for (const chunk of chunks) {
-      result.set(chunk, offset);
-      offset += chunk.length;
-    }
-    return result;
-  }
-
-  /**
-   * Copies file or directory.
-   * Uses native implementation if available, otherwise falls back to read/write.
-   */
-  async copy(source: FileRef, target: FileRef, options: CopyOptions = {}): Promise<boolean> {
-    // Try native implementation first
-    if (this.fs.copy) {
-      return this.fs.copy(source, target, options);
-    }
-
-    // Fallback: read from source, write to target
-    const sourceInfo = await this.stats(source);
-    if (!sourceInfo) return false;
-
-    const sourcePath = resolveFileRef(source);
-    const targetPath = resolveFileRef(target);
-    const recursive = options.recursive ?? true;
-
-    if (sourceInfo.kind === "directory") {
-      for await (const entry of this.list(source, { recursive })) {
-        if (entry.kind === "directory") continue;
-        const suffix = entry.path.substring(sourcePath.length);
-        const newTargetPath = targetPath + suffix;
-        await this.write(newTargetPath, this.read(entry.path));
-      }
-    } else {
-      await this.write(targetPath, this.read(sourcePath));
-    }
-
-    return true;
-  }
-
-  /**
-   * Moves file or directory.
-   * Uses native implementation if available, otherwise falls back to copy+delete.
-   */
-  async move(source: FileRef, target: FileRef): Promise<boolean> {
-    // Try native implementation first
-    if (this.fs.move) {
-      return this.fs.move(source, target);
-    }
-
-    // Fallback: copy then delete
-    const copied = await this.copy(source, target);
-    if (!copied) return false;
-    await this.remove(source);
-    return true;
-  }
-
-  /**
-   * Creates a directory.
-   * Uses native implementation if available, otherwise creates a placeholder file.
-   */
-  async mkdir(file: FileRef): Promise<void> {
-    // Try native implementation first
-    if (this.fs.mkdir) {
-      return this.fs.mkdir(file);
-    }
-
-    // Fallback: create a placeholder file to establish the directory
-    const dirPath = resolveFileRef(file);
-    const placeholderPath = joinPath(dirPath, IGNORE_FILE);
-    await this.write(placeholderPath, [new Uint8Array(0)]);
-  }
-}

package/src/impl/index.ts

@@ -1,6 +0,0 @@
-/**
- * IFilesApi implementations
- */
-
-export * from "./mem-files-api.js";
-export * from "./node-files-api.js";