@statewalker/webrun-files 0.4.0 → 0.7.0

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;AAkGD,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/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Utility functions
- */
-export * from "./collect-stream.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,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,167 +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 { joinPath, resolveFileRef } from "./utils/index.js";
-
-const IGNORE_FILE = ".gitkeep";
-
-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";

package/src/impl/mem-files-api.ts

@@ -1,306 +0,0 @@
-/**
- * In-memory implementation of IFilesApi for testing
- */
-
-import type {
-  AppendOptions,
-  BinaryStream,
-  FileHandle,
-  FileInfo,
-  FileRef,
-  IFilesApi,
-  ListOptions,
-  ReadStreamOptions,
-  WriteStreamOptions,
-} from "../types.js";
-import { toBinaryAsyncIterable } from "../utils/collect-stream.js";
-import { basename, joinPath, resolveFileRef } from "../utils/index.js";
-
-interface FileEntry {
-  kind: "file";
-  content: Uint8Array;
-  lastModified: number;
-}
-
-interface DirEntry {
-  kind: "directory";
-  lastModified: number;
-}
-
-type Entry = FileEntry | DirEntry;
-
-class MemFileHandle implements FileHandle {
-  constructor(
-    private store: Map<string, Entry>,
-    private path: string,
-  ) {}
-
-  get size(): number {
-    const entry = this.store.get(this.path);
-    if (entry?.kind === "file") {
-      return entry.content.length;
-    }
-    return 0;
-  }
-
-  private getOrCreateFile(): FileEntry {
-    let entry = this.store.get(this.path);
-    if (!entry || entry.kind !== "file") {
-      entry = {
-        kind: "file",
-        content: new Uint8Array(0),
-        lastModified: Date.now(),
-      };
-      this.store.set(this.path, entry);
-    }
-    return entry;
-  }
-
-  async close(): Promise<void> {
-    // No-op for memory implementation
-  }
-
-  async appendFile(data: BinaryStream, options: AppendOptions = {}): Promise<number> {
-    const file = this.getOrCreateFile();
-    const chunks: Uint8Array[] = [file.content];
-    let bytesWritten = 0;
-
-    for await (const chunk of toBinaryAsyncIterable(data)) {
-      if (options.signal?.aborted) {
-        throw new Error("Operation aborted");
-      }
-      chunks.push(chunk);
-      bytesWritten += chunk.length;
-    }
-
-    // Merge all chunks
-    const totalLength = chunks.reduce((sum, c) => sum + c.length, 0);
-    const merged = new Uint8Array(totalLength);
-    let offset = 0;
-    for (const chunk of chunks) {
-      merged.set(chunk, offset);
-      offset += chunk.length;
-    }
-
-    file.content = merged;
-    file.lastModified = Date.now();
-
-    return bytesWritten;
-  }
-
-  async *createReadStream(options: ReadStreamOptions = {}): AsyncGenerator<Uint8Array> {
-    const entry = this.store.get(this.path);
-    if (!entry || entry.kind !== "file") return;
-
-    const { start = 0, end = Infinity, signal } = options;
-    const bufferSize = 8192;
-    const content = entry.content;
-    const actualEnd = Math.min(end, content.length);
-
-    let position = start;
-
-    while (position < actualEnd) {
-      if (signal?.aborted) {
-        throw new Error("Operation aborted");
-      }
-
-      const remaining = actualEnd - position;
-      const toRead = Math.min(bufferSize, remaining);
-
-      yield content.subarray(position, position + toRead);
-      position += toRead;
-    }
-  }
-
-  async createWriteStream(data: BinaryStream, options: WriteStreamOptions = {}): Promise<number> {
-    const { start = 0, signal } = options;
-    const file = this.getOrCreateFile();
-
-    const chunks: Uint8Array[] = [];
-    let bytesWritten = 0;
-
-    // Keep content before start position
-    if (start > 0 && file.content.length > 0) {
-      chunks.push(file.content.subarray(0, Math.min(start, file.content.length)));
-    }
-
-    // Pad with zeros if start is beyond current content
-    if (start > file.content.length) {
-      chunks.push(new Uint8Array(start - file.content.length));
-    }
-
-    for await (const chunk of toBinaryAsyncIterable(data)) {
-      if (signal?.aborted) {
-        throw new Error("Operation aborted");
-      }
-      chunks.push(chunk);
-      bytesWritten += chunk.length;
-    }
-
-    // Merge all chunks
-    const totalLength = chunks.reduce((sum, c) => sum + c.length, 0);
-    const merged = new Uint8Array(totalLength);
-    let offset = 0;
-    for (const chunk of chunks) {
-      merged.set(chunk, offset);
-      offset += chunk.length;
-    }
-
-    file.content = merged;
-    file.lastModified = Date.now();
-
-    return bytesWritten;
-  }
-}
-
-export class MemFilesApi implements IFilesApi {
-  private store = new Map<string, Entry>();
-
-  async *list(file: FileRef, options: ListOptions = {}): AsyncGenerator<FileInfo> {
-    const normalized = resolveFileRef(file);
-    const prefix = normalized === "/" ? "/" : `${normalized}/`;
-    const { recursive = false } = options;
-
-    const seen = new Set<string>();
-
-    for (const [path, entry] of this.store.entries()) {
-      if (!path.startsWith(prefix)) continue;
-
-      const relativePath = path.substring(prefix.length);
-      const segments = relativePath.split("/");
-
-      if (segments.length === 0 || segments[0] === "") continue;
-
-      if (segments.length === 1) {
-        // Direct child file or directory
-        if (seen.has(path)) continue;
-        seen.add(path);
-
-        const info: FileInfo = {
-          kind: entry.kind,
-          name: basename(path),
-          path,
-          lastModified: entry.lastModified,
-        };
-
-        if (entry.kind === "file") {
-          info.size = entry.content.length;
-        }
-
-        yield info;
-      } else {
-        // This is a nested path
-        if (recursive) {
-          // Yield all nested entries
-          if (seen.has(path)) continue;
-          seen.add(path);
-
-          const info: FileInfo = {
-            kind: entry.kind,
-            name: basename(path),
-            path,
-            lastModified: entry.lastModified,
-          };
-
-          if (entry.kind === "file") {
-            info.size = entry.content.length;
-          }
-
-          yield info;
-        } else {
-          // Non-recursive: yield the intermediate directory
-          const dirName = segments[0];
-          const dirPath = joinPath(normalized, dirName);
-          if (!seen.has(dirPath)) {
-            seen.add(dirPath);
-            yield {
-              kind: "directory",
-              name: dirName,
-              path: dirPath,
-              lastModified: 0,
-            };
-          }
-        }
-      }
-    }
-  }
-
-  async stats(file: FileRef): Promise<FileInfo | undefined> {
-    const normalized = resolveFileRef(file);
-
-    const entry = this.store.get(normalized);
-    if (entry) {
-      const info: FileInfo = {
-        kind: entry.kind,
-        name: basename(normalized),
-        path: normalized,
-        lastModified: entry.lastModified,
-      };
-      if (entry.kind === "file") {
-        info.size = entry.content.length;
-      }
-      return info;
-    }
-
-    // Check if it's an implicit directory (root always exists)
-    if (normalized === "/") {
-      return {
-        kind: "directory",
-        name: "",
-        path: "/",
-        lastModified: 0,
-      };
-    }
-
-    const prefix = `${normalized}/`;
-    for (const path of this.store.keys()) {
-      if (path.startsWith(prefix)) {
-        return {
-          kind: "directory",
-          name: basename(normalized),
-          path: normalized,
-          lastModified: 0,
-        };
-      }
-    }
-
-    return undefined;
-  }
-
-  async remove(file: FileRef): Promise<boolean> {
-    const normalized = resolveFileRef(file);
-    const prefix = `${normalized}/`;
-
-    let removed = false;
-
-    // Remove exact match
-    if (this.store.delete(normalized)) {
-      removed = true;
-    }
-
-    // Remove all children (for directories)
-    for (const path of [...this.store.keys()]) {
-      if (path.startsWith(prefix)) {
-        this.store.delete(path);
-        removed = true;
-      }
-    }
-
-    return removed;
-  }
-
-  async open(file: FileRef): Promise<FileHandle> {
-    const normalized = resolveFileRef(file);
-    return new MemFileHandle(this.store, normalized);
-  }
-
-  async mkdir(file: FileRef): Promise<void> {
-    const normalized = resolveFileRef(file);
-    if (!this.store.has(normalized)) {
-      this.store.set(normalized, {
-        kind: "directory",
-        lastModified: Date.now(),
-      });
-    }
-  }
-}