@statewalker/webrun-files 0.3.1 → 0.5.0

package/src/utils/collect-stream.ts

@@ -0,0 +1,35 @@
+/**
+ * Stream collection utilities
+ */
+
+/**
+ * Collects all values from an async generator into an array.
+ */
+export async function collectGenerator<T>(generator: AsyncIterable<T>): Promise<T[]> {
+  const results: T[] = [];
+  for await (const item of generator) {
+    results.push(item);
+  }
+  return results;
+}
+
+/**
+ * Converts a synchronous iterable to an async iterable.
+ */
+export async function* toAsyncIterable<T>(iterable: Iterable<T>): AsyncIterable<T> {
+  for (const item of iterable) {
+    yield item;
+  }
+}
+
+/**
+ * Normalizes BinaryStream to AsyncIterable<Uint8Array>.
+ */
+export function toBinaryAsyncIterable(
+  data: AsyncIterable<Uint8Array> | Iterable<Uint8Array>,
+): AsyncIterable<Uint8Array> {
+  if (Symbol.asyncIterator in data) {
+    return data as AsyncIterable<Uint8Array>;
+  }
+  return toAsyncIterable(data as Iterable<Uint8Array>);
+}

package/src/utils/file-info-utils.ts

@@ -0,0 +1,15 @@
+import type { FileInfo } from "../types.js";
+
+/**
+ * Check if FileInfo represents a directory
+ */
+export function isDirectory(info: FileInfo | undefined): boolean {
+  return info?.kind === "directory";
+}
+
+/**
+ * Check if FileInfo represents a file
+ */
+export function isFile(info: FileInfo | undefined): boolean {
+  return info?.kind === "file";
+}

package/src/utils/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Utility functions
+ */
+
+export * from "./collect-stream.js";
+export * from "./file-info-utils.js";
+export * from "./normalize-path.js";
+export * from "./path-utils.js";

package/src/utils/normalize-path.ts

@@ -0,0 +1,34 @@
+/**
+ * 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 function normalizePath(filePath: string): string {
+  const segments = filePath.split("/").filter((s) => !!s && s !== ".");
+  if (segments.length === 0) {
+    return "/";
+  }
+  return `/${segments.join("/")}`;
+}
+
+/**
+ * Extracts path string from FileRef.
+ */
+export function toPath(file: FileRef): string {
+  return typeof file === "object" ? file.path : String(file);
+}
+
+/**
+ * Normalizes FileRef to a path string.
+ */
+export function resolveFileRef(file: FileRef): string {
+  return normalizePath(toPath(file));
+}

package/src/utils/path-utils.ts

@@ -0,0 +1,46 @@
+/**
+ * Path manipulation utilities
+ */
+
+import { normalizePath } from "./normalize-path.js";
+
+/**
+ * Joins path segments with proper normalization.
+ */
+export function joinPath(...segments: string[]): string {
+  const combined = segments.join("/");
+  return normalizePath(combined);
+}
+
+/**
+ * Returns the directory portion of a path.
+ */
+export function dirname(path: string): string {
+  const normalized = normalizePath(path);
+  const lastSlash = normalized.lastIndexOf("/");
+  if (lastSlash <= 0) return "/";
+  return normalized.substring(0, lastSlash);
+}
+
+/**
+ * Returns the filename portion of a path.
+ */
+export function basename(path: string, ext?: string): string {
+  const normalized = normalizePath(path);
+  const lastSlash = normalized.lastIndexOf("/");
+  const name = lastSlash === -1 ? normalized : normalized.substring(lastSlash + 1);
+  if (ext && name.endsWith(ext)) {
+    return name.substring(0, name.length - ext.length);
+  }
+  return name;
+}
+
+/**
+ * Returns the file extension including the dot.
+ */
+export function extname(path: string): string {
+  const name = basename(path);
+  const dotIndex = name.lastIndexOf(".");
+  if (dotIndex <= 0) return "";
+  return name.substring(dotIndex);
+}

package/CHANGELOG.md

@@ -1,2 +0,0 @@
-# @statewalker/files
-