hazo_files 2.1.1 → 3.1.0

package/dist/testing/index.d.mts

@@ -30,6 +30,22 @@ interface ProbeResult {
     /** Free-form detail for logging. */
     message?: string;
 }
+/**
+ * A single entry returned by `FileStorageProvider.list()`.
+ *
+ * `path` is the same logical namespace used by `put`/`get` — callers can pass
+ * it directly back to those methods without any transformation.
+ */
+interface FileEntry {
+    /** Logical path within the provider (same namespace as put/get). */
+    path: StoragePath;
+    /** Bare filename or directory name (the last segment of `path`). */
+    name: string;
+    /** Size in bytes. 0 for directories. */
+    size: number;
+    /** True when this entry represents a directory. */
+    isDirectory: boolean;
+}
 /**
  * Storage provider abstraction. Every method MUST be idempotent at the
  * data-content level — re-invoking put with identical body is allowed.
@@ -44,6 +60,24 @@ interface FileStorageProvider {
     getSignedUrl(path: StoragePath, opts?: SignedUrlOpts): Promise<string>;
     /** Used by validation cron + onboarding step 2. */
     probe(): Promise<ProbeResult>;
+    /**
+     * List all entries (files and sub-directories) under a logical path prefix.
+     * Results are recursive — all descendants are included.
+     * Returns an empty array when the prefix does not exist.
+     */
+    list(prefix: StoragePath): Promise<FileEntry[]>;
+    /**
+     * Move bytes from `from` to `to`, creating any intermediate directories.
+     * The source is removed on success.
+     * Throws with a message containing "Not found" when `from` does not exist.
+     */
+    move(from: StoragePath, to: StoragePath): Promise<void>;
+    /**
+     * Rename a file or directory.  `to` is the full new logical path.
+     * Implementations may delegate to `move`.
+     * Throws with a message containing "Not found" when `from` does not exist.
+     */
+    rename(from: StoragePath, to: StoragePath): Promise<void>;
 }
 
 declare class InMemoryProvider implements FileStorageProvider {
@@ -55,6 +89,9 @@ declare class InMemoryProvider implements FileStorageProvider {
     exists(path: string): Promise<boolean>;
     getSignedUrl(path: string, _opts?: SignedUrlOpts): Promise<string>;
     probe(): Promise<ProbeResult>;
+    list(prefix: string): Promise<FileEntry[]>;
+    move(from: string, to: string): Promise<void>;
+    rename(from: string, to: string): Promise<void>;
     /** Test-only escape hatch — exposes the internal store for assertions. */
     snapshot(): Map<string, Buffer>;
 }

package/dist/testing/index.d.ts

@@ -30,6 +30,22 @@ interface ProbeResult {
     /** Free-form detail for logging. */
     message?: string;
 }
+/**
+ * A single entry returned by `FileStorageProvider.list()`.
+ *
+ * `path` is the same logical namespace used by `put`/`get` — callers can pass
+ * it directly back to those methods without any transformation.
+ */
+interface FileEntry {
+    /** Logical path within the provider (same namespace as put/get). */
+    path: StoragePath;
+    /** Bare filename or directory name (the last segment of `path`). */
+    name: string;
+    /** Size in bytes. 0 for directories. */
+    size: number;
+    /** True when this entry represents a directory. */
+    isDirectory: boolean;
+}
 /**
  * Storage provider abstraction. Every method MUST be idempotent at the
  * data-content level — re-invoking put with identical body is allowed.
@@ -44,6 +60,24 @@ interface FileStorageProvider {
     getSignedUrl(path: StoragePath, opts?: SignedUrlOpts): Promise<string>;
     /** Used by validation cron + onboarding step 2. */
     probe(): Promise<ProbeResult>;
+    /**
+     * List all entries (files and sub-directories) under a logical path prefix.
+     * Results are recursive — all descendants are included.
+     * Returns an empty array when the prefix does not exist.
+     */
+    list(prefix: StoragePath): Promise<FileEntry[]>;
+    /**
+     * Move bytes from `from` to `to`, creating any intermediate directories.
+     * The source is removed on success.
+     * Throws with a message containing "Not found" when `from` does not exist.
+     */
+    move(from: StoragePath, to: StoragePath): Promise<void>;
+    /**
+     * Rename a file or directory.  `to` is the full new logical path.
+     * Implementations may delegate to `move`.
+     * Throws with a message containing "Not found" when `from` does not exist.
+     */
+    rename(from: StoragePath, to: StoragePath): Promise<void>;
 }
 
 declare class InMemoryProvider implements FileStorageProvider {
@@ -55,6 +89,9 @@ declare class InMemoryProvider implements FileStorageProvider {
     exists(path: string): Promise<boolean>;
     getSignedUrl(path: string, _opts?: SignedUrlOpts): Promise<string>;
     probe(): Promise<ProbeResult>;
+    list(prefix: string): Promise<FileEntry[]>;
+    move(from: string, to: string): Promise<void>;
+    rename(from: string, to: string): Promise<void>;
     /** Test-only escape hatch — exposes the internal store for assertions. */
     snapshot(): Map<string, Buffer>;
 }

package/dist/testing/index.js

@@ -55,6 +55,39 @@ var InMemoryProvider = class {
   async probe() {
     return { ok: true };
   }
+  async list(prefix) {
+    const base = prefix.replace(/\/$/, "");
+    const matchPrefix = `${base}/`;
+    const entries = [];
+    const seenDirs = /* @__PURE__ */ new Set();
+    for (const [key, buf] of this.store.entries()) {
+      if (key !== base && !key.startsWith(matchPrefix)) continue;
+      const rel = key.startsWith(matchPrefix) ? key.slice(matchPrefix.length) : "";
+      if (!rel) {
+        entries.push({ path: key, name: key.split("/").pop(), size: buf.length, isDirectory: false });
+        continue;
+      }
+      const parts = rel.split("/");
+      for (let i = 1; i < parts.length; i++) {
+        const dirPath = matchPrefix + parts.slice(0, i).join("/");
+        if (!seenDirs.has(dirPath)) {
+          seenDirs.add(dirPath);
+          entries.push({ path: dirPath, name: parts[i - 1], size: 0, isDirectory: true });
+        }
+      }
+      entries.push({ path: key, name: parts[parts.length - 1], size: buf.length, isDirectory: false });
+    }
+    return entries;
+  }
+  async move(from, to) {
+    const buf = this.store.get(from);
+    if (!buf) throw new Error(`Not found: ${from}`);
+    this.store.set(to, buf);
+    this.store.delete(from);
+  }
+  async rename(from, to) {
+    return this.move(from, to);
+  }
   /** Test-only escape hatch — exposes the internal store for assertions. */
   snapshot() {
     return new Map(this.store);

package/dist/testing/index.mjs

@@ -29,6 +29,39 @@ var InMemoryProvider = class {
   async probe() {
     return { ok: true };
   }
+  async list(prefix) {
+    const base = prefix.replace(/\/$/, "");
+    const matchPrefix = `${base}/`;
+    const entries = [];
+    const seenDirs = /* @__PURE__ */ new Set();
+    for (const [key, buf] of this.store.entries()) {
+      if (key !== base && !key.startsWith(matchPrefix)) continue;
+      const rel = key.startsWith(matchPrefix) ? key.slice(matchPrefix.length) : "";
+      if (!rel) {
+        entries.push({ path: key, name: key.split("/").pop(), size: buf.length, isDirectory: false });
+        continue;
+      }
+      const parts = rel.split("/");
+      for (let i = 1; i < parts.length; i++) {
+        const dirPath = matchPrefix + parts.slice(0, i).join("/");
+        if (!seenDirs.has(dirPath)) {
+          seenDirs.add(dirPath);
+          entries.push({ path: dirPath, name: parts[i - 1], size: 0, isDirectory: true });
+        }
+      }
+      entries.push({ path: key, name: parts[parts.length - 1], size: buf.length, isDirectory: false });
+    }
+    return entries;
+  }
+  async move(from, to) {
+    const buf = this.store.get(from);
+    if (!buf) throw new Error(`Not found: ${from}`);
+    this.store.set(to, buf);
+    this.store.delete(from);
+  }
+  async rename(from, to) {
+    return this.move(from, to);
+  }
   /** Test-only escape hatch — exposes the internal store for assertions. */
   snapshot() {
     return new Map(this.store);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_files",
-  "version": "2.1.1",
+  "version": "3.1.0",
   "description": "File management including integration to cloud files",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -102,8 +102,9 @@
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
     "dropbox": "^10.34.0",
-    "hazo_jobs": "^0.8.0",
-    "hazo_llm_api": "^1.2.7",
+    "hazo_core": "^1.1.0",
+    "hazo_jobs": "^0.12.0",
+    "hazo_llm_api": "^2.1.0",
     "jsdom": "^28.1.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
@@ -115,20 +116,22 @@
   },
   "peerDependencies": {
     "@dnd-kit/core": "^6.0.0",
-    "@dnd-kit/sortable": ">=8.0.0",
+    "@dnd-kit/sortable": "^8.0.0",
     "@dnd-kit/utilities": "^3.0.0",
     "dropbox": "^10.0.0",
     "googleapis": "^140.0.0",
-    "hazo_connect": "^2.6.0",
-    "hazo_debug": "^2.0.0",
-    "hazo_jobs": "^0.8.0",
-    "hazo_llm_api": "^1.2.0",
-    "hazo_logs": "^1.0.13",
-    "hazo_secure": "^0.5.0",
+    "hazo_connect": "^3.4.1",
+    "hazo_core": "^1.1.0",
+    "hazo_debug": "^3.1.1",
+    "hazo_jobs": "^0.12.0",
+    "hazo_llm_api": "^2.1.0",
+    "hazo_logs": "^2.0.3",
+    "hazo_secure": "^1.2.0",
+    "hazo_ui": "^3.2.1",
     "react": "^18.0.0",
     "react-dom": "^18.0.0",
-    "server-only": ">=0.0.1",
-    "sonner": ">=1.0.0",
+    "server-only": "^0.0.1",
+    "sonner": "^2.0.7",
     "xxhash-wasm": "^1.0.0"
   },
   "peerDependenciesMeta": {
@@ -150,6 +153,9 @@
     "hazo_connect": {
       "optional": true
     },
+    "hazo_core": {
+      "optional": true
+    },
     "hazo_debug": {
       "optional": true
     },
@@ -159,6 +165,9 @@
     "hazo_llm_api": {
       "optional": true
     },
+    "hazo_ui": {
+      "optional": true
+    },
     "server-only": {
       "optional": true
     },