@mastra/gcs 0.3.1 → 0.3.2

package/dist/index.js

@@ -1,493 +1,527 @@
-import { Storage } from '@google-cloud/storage';
-import { MastraFilesystem, FileNotFoundError, FileExistsError } from '@mastra/core/workspace';
-
-// src/filesystem/index.ts
-var MIME_TYPES = {
-  // Text
-  ".txt": "text/plain",
-  ".md": "text/markdown",
-  ".markdown": "text/markdown",
-  ".html": "text/html",
-  ".htm": "text/html",
-  ".css": "text/css",
-  ".csv": "text/csv",
-  ".xml": "text/xml",
-  // Code
-  ".js": "text/javascript",
-  ".mjs": "text/javascript",
-  ".ts": "text/typescript",
-  ".tsx": "text/typescript",
-  ".jsx": "text/javascript",
-  ".json": "application/json",
-  ".yaml": "text/yaml",
-  ".yml": "text/yaml",
-  ".py": "text/x-python",
-  ".rb": "text/x-ruby",
-  ".sh": "text/x-shellscript",
-  ".bash": "text/x-shellscript",
-  // Images
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".gif": "image/gif",
-  ".svg": "image/svg+xml",
-  ".webp": "image/webp",
-  ".ico": "image/x-icon",
-  // Documents
-  ".pdf": "application/pdf",
-  // Archives
-  ".zip": "application/zip",
-  ".gz": "application/gzip",
-  ".tar": "application/x-tar"
+import { Storage } from "@google-cloud/storage";
+import { FileExistsError, FileNotFoundError, MastraFilesystem } from "@mastra/core/workspace";
+//#region src/filesystem/index.ts
+/**
+* GCS Filesystem Provider
+*
+* A filesystem implementation backed by Google Cloud Storage.
+*/
+/**
+* Common MIME types by file extension.
+*/
+const MIME_TYPES = {
+	".txt": "text/plain",
+	".md": "text/markdown",
+	".markdown": "text/markdown",
+	".html": "text/html",
+	".htm": "text/html",
+	".css": "text/css",
+	".csv": "text/csv",
+	".xml": "text/xml",
+	".js": "text/javascript",
+	".mjs": "text/javascript",
+	".ts": "text/typescript",
+	".tsx": "text/typescript",
+	".jsx": "text/javascript",
+	".json": "application/json",
+	".yaml": "text/yaml",
+	".yml": "text/yaml",
+	".py": "text/x-python",
+	".rb": "text/x-ruby",
+	".sh": "text/x-shellscript",
+	".bash": "text/x-shellscript",
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".gif": "image/gif",
+	".svg": "image/svg+xml",
+	".webp": "image/webp",
+	".ico": "image/x-icon",
+	".pdf": "application/pdf",
+	".zip": "application/zip",
+	".gz": "application/gzip",
+	".tar": "application/x-tar"
 };
+/**
+* Get MIME type from file path extension.
+*/
 function getMimeType(path) {
-  const ext = path.toLowerCase().match(/\.[^.]+$/)?.[0];
-  return ext ? MIME_TYPES[ext] ?? "application/octet-stream" : "application/octet-stream";
+	const ext = path.toLowerCase().match(/\.[^.]+$/)?.[0];
+	return ext ? MIME_TYPES[ext] ?? "application/octet-stream" : "application/octet-stream";
 }
+/**
+* GCS filesystem implementation.
+*
+* Stores files in a Google Cloud Storage bucket.
+* Supports mounting into E2B sandboxes via gcsfuse.
+*
+* @example Using Application Default Credentials
+* ```typescript
+* import { GCSFilesystem } from '@mastra/gcs';
+*
+* // Uses ADC (gcloud auth application-default login)
+* const fs = new GCSFilesystem({
+*   bucket: 'my-bucket',
+*   projectId: 'my-project',
+* });
+* ```
+*
+* @example Using Service Account Key
+* ```typescript
+* import { GCSFilesystem } from '@mastra/gcs';
+*
+* const fs = new GCSFilesystem({
+*   bucket: 'my-bucket',
+*   projectId: 'my-project',
+*   credentials: {
+*     type: 'service_account',
+*     project_id: 'my-project',
+*     private_key_id: '...',
+*     private_key: '-----BEGIN PRIVATE KEY-----\n...',
+*     client_email: '...@...iam.gserviceaccount.com',
+*     // ... rest of service account key
+*   },
+* });
+* ```
+*
+* @example Using Key File Path
+* ```typescript
+* import { GCSFilesystem } from '@mastra/gcs';
+*
+* const fs = new GCSFilesystem({
+*   bucket: 'my-bucket',
+*   projectId: 'my-project',
+*   credentials: '/path/to/service-account-key.json',
+* });
+* ```
+*/
+/** Trim leading and trailing slashes without regex (avoids polynomial regex on user input). */
 function trimSlashes(s) {
-  let start = 0;
-  let end = s.length;
-  while (start < end && s[start] === "/") start++;
-  while (end > start && s[end - 1] === "/") end--;
-  return s.slice(start, end);
+	let start = 0;
+	let end = s.length;
+	while (start < end && s[start] === "/") start++;
+	while (end > start && s[end - 1] === "/") end--;
+	return s.slice(start, end);
 }
 var GCSFilesystem = class extends MastraFilesystem {
-  id;
-  name = "GCSFilesystem";
-  provider = "gcs";
-  readOnly;
-  status = "pending";
-  // Display metadata for UI
-  displayName;
-  icon = "gcs";
-  description;
-  bucketName;
-  projectId;
-  credentials;
-  prefix;
-  endpoint;
-  _storage = null;
-  _bucket = null;
-  constructor(options) {
-    super({ ...options, name: "GCSFilesystem" });
-    this.id = options.id ?? `gcs-fs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
-    this.bucketName = options.bucket;
-    this.projectId = options.projectId;
-    this.credentials = options.credentials;
-    this.prefix = options.prefix ? trimSlashes(options.prefix) + "/" : "";
-    this.endpoint = options.endpoint;
-    this.displayName = options.displayName ?? "Google Cloud Storage";
-    this.icon = options.icon ?? "gcs";
-    this.description = options.description;
-    this.readOnly = options.readOnly;
-  }
-  /**
-   * Get the underlying Google Cloud Storage instance for direct access to GCS APIs.
-   *
-   * Use this when you need to access GCS features not exposed through the
-   * WorkspaceFilesystem interface (e.g., signed URLs, IAM, custom metadata, etc.).
-   *
-   * @example Access other buckets
-   * ```typescript
-   * const storage = fs.storage;
-   * const [buckets] = await storage.getBuckets();
-   * ```
-   */
-  get storage() {
-    return this.getStorage();
-  }
-  /**
-   * Get the underlying GCS Bucket instance for direct access to bucket operations.
-   *
-   * Use this when you need to access bucket features not exposed through the
-   * WorkspaceFilesystem interface (e.g., signed URLs, lifecycle rules, etc.).
-   *
-   * @example Generate a signed URL
-   * ```typescript
-   * const bucket = fs.bucket;
-   * const [url] = await bucket.file('my-file.txt').getSignedUrl({
-   *   action: 'read',
-   *   expires: Date.now() + 15 * 60 * 1000,
-   * });
-   * ```
-   */
-  get bucket() {
-    return this.getBucket();
-  }
-  /**
-   * Get mount configuration for E2B sandbox.
-   * Returns GCS-compatible config that works with gcsfuse.
-   */
-  getMountConfig() {
-    const config = {
-      type: "gcs",
-      bucket: this.bucketName
-    };
-    if (this.credentials && typeof this.credentials === "object") {
-      config.serviceAccountKey = JSON.stringify(this.credentials);
-    }
-    if (this.prefix) {
-      config.prefix = this.prefix.replace(/\/$/, "");
-    }
-    return config;
-  }
-  /**
-   * Get filesystem info for status reporting.
-   */
-  getInfo() {
-    return {
-      id: this.id,
-      name: this.name,
-      provider: this.provider,
-      status: this.status,
-      error: this.error,
-      readOnly: this.readOnly,
-      icon: this.icon,
-      metadata: {
-        bucket: this.bucketName,
-        ...this.endpoint && { endpoint: this.endpoint },
-        ...this.prefix && { prefix: this.prefix }
-      }
-    };
-  }
-  /**
-   * Get instructions describing this GCS filesystem.
-   * Used by agents to understand storage semantics.
-   */
-  getInstructions() {
-    const access = this.readOnly ? "Read-only" : "Persistent";
-    return `Google Cloud Storage in bucket "${this.bucketName}". ${access} storage - files are retained across sessions.`;
-  }
-  getStorage() {
-    if (this._storage) return this._storage;
-    const options = {};
-    if (this.projectId) {
-      options.projectId = this.projectId;
-    }
-    if (this.credentials) {
-      if (typeof this.credentials === "string") {
-        options.keyFilename = this.credentials;
-      } else {
-        options.credentials = this.credentials;
-      }
-    }
-    if (this.endpoint) {
-      options.apiEndpoint = this.endpoint;
-    }
-    this._storage = new Storage(options);
-    return this._storage;
-  }
-  getBucket() {
-    if (this._bucket) return this._bucket;
-    const storage = this.getStorage();
-    this._bucket = storage.bucket(this.bucketName);
-    return this._bucket;
-  }
-  /**
-   * Ensure the filesystem is initialized and return the bucket.
-   * Uses base class ensureReady() for status management, then returns bucket.
-   */
-  async getReadyBucket() {
-    await this.ensureReady();
-    return this.getBucket();
-  }
-  toKey(path) {
-    const cleanPath = path.replace(/^\/+/, "").replace(/^\.(?:\/|$)/, "");
-    return this.prefix + cleanPath;
-  }
-  // ---------------------------------------------------------------------------
-  // File Operations
-  // ---------------------------------------------------------------------------
-  async readFile(path, options) {
-    const bucket = await this.getReadyBucket();
-    const file = bucket.file(this.toKey(path));
-    try {
-      const [content] = await file.download();
-      if (options?.encoding) {
-        return content.toString(options.encoding);
-      }
-      return content;
-    } catch (error) {
-      if (error && typeof error === "object" && "code" in error && error.code === 404) {
-        throw new FileNotFoundError(path);
-      }
-      throw error;
-    }
-  }
-  async writeFile(path, content, options) {
-    const bucket = await this.getReadyBucket();
-    const file = bucket.file(this.toKey(path));
-    if (options?.overwrite === false && await this.exists(path)) {
-      throw new FileExistsError(path);
-    }
-    const body = typeof content === "string" ? Buffer.from(content, "utf-8") : Buffer.from(content);
-    const contentType = getMimeType(path);
-    await file.save(body, {
-      contentType,
-      resumable: false
-    });
-  }
-  async appendFile(path, content) {
-    let existing = "";
-    try {
-      existing = await this.readFile(path, { encoding: "utf-8" });
-    } catch (error) {
-      if (error instanceof FileNotFoundError) ; else {
-        throw error;
-      }
-    }
-    const appendContent = typeof content === "string" ? content : Buffer.from(content).toString("utf-8");
-    await this.writeFile(path, existing + appendContent);
-  }
-  async deleteFile(path, options) {
-    const isDir = await this.isDirectory(path);
-    if (isDir) {
-      await this.rmdir(path, { recursive: true, force: options?.force });
-      return;
-    }
-    const bucket = await this.getReadyBucket();
-    const file = bucket.file(this.toKey(path));
-    try {
-      await file.delete();
-    } catch (error) {
-      if (!options?.force) {
-        if (error && typeof error === "object" && "code" in error && error.code === 404) {
-          throw new FileNotFoundError(path);
-        }
-        throw error;
-      }
-    }
-  }
-  async copyFile(src, dest, options) {
-    const bucket = await this.getReadyBucket();
-    const srcFile = bucket.file(this.toKey(src));
-    const destFile = bucket.file(this.toKey(dest));
-    if (options?.overwrite === false && await this.exists(dest)) {
-      throw new FileExistsError(dest);
-    }
-    try {
-      await srcFile.copy(destFile);
-    } catch (error) {
-      if (error && typeof error === "object" && "code" in error && error.code === 404) {
-        throw new FileNotFoundError(src);
-      }
-      throw error;
-    }
-  }
-  async moveFile(src, dest, options) {
-    await this.copyFile(src, dest, options);
-    await this.deleteFile(src, { force: true });
-  }
-  // ---------------------------------------------------------------------------
-  // Directory Operations
-  // ---------------------------------------------------------------------------
-  async mkdir(_path, _options) {
-  }
-  async rmdir(path, options) {
-    if (!options?.recursive) {
-      const bucket2 = await this.getReadyBucket();
-      const prefix2 = this.toKey(path).replace(/\/$/, "") + "/";
-      const [files] = await bucket2.getFiles({ prefix: prefix2, maxResults: 1 });
-      if (files.length > 0) {
-        throw new Error(`Directory not empty: ${path}`);
-      }
-      return;
-    }
-    const bucket = await this.getReadyBucket();
-    const prefix = this.toKey(path).replace(/\/$/, "") + "/";
-    await bucket.deleteFiles({ prefix });
-  }
-  async readdir(path, options) {
-    const bucket = await this.getReadyBucket();
-    const prefix = this.toKey(path).replace(/\/$/, "");
-    const searchPrefix = prefix ? prefix + "/" : "";
-    const entries = [];
-    const seenDirs = /* @__PURE__ */ new Set();
-    const [files] = await bucket.getFiles({
-      prefix: searchPrefix,
-      autoPaginate: true
-    });
-    for (const file of files) {
-      const key = file.name;
-      if (!key || key === searchPrefix) continue;
-      const relativePath = key.slice(searchPrefix.length);
-      if (!relativePath) continue;
-      if (relativePath.endsWith("/")) {
-        const dirName = relativePath.slice(0, -1);
-        if (!seenDirs.has(dirName)) {
-          seenDirs.add(dirName);
-          entries.push({ name: dirName, type: "directory" });
-        }
-        continue;
-      }
-      const name = options?.recursive ? relativePath : relativePath.split("/")[0];
-      if (!name) continue;
-      if (!options?.recursive && relativePath.includes("/")) {
-        if (!seenDirs.has(name)) {
-          seenDirs.add(name);
-          entries.push({ name, type: "directory" });
-        }
-        continue;
-      }
-      if (options?.extension) {
-        const extensions = Array.isArray(options.extension) ? options.extension : [options.extension];
-        if (!extensions.some((ext) => name.endsWith(ext))) {
-          continue;
-        }
-      }
-      entries.push({
-        name,
-        type: "file",
-        size: file.metadata.size != null ? Number(file.metadata.size) : void 0
-      });
-    }
-    return entries;
-  }
-  // ---------------------------------------------------------------------------
-  // Path Operations
-  // ---------------------------------------------------------------------------
-  async exists(path) {
-    const key = this.toKey(path);
-    if (!key) return true;
-    const bucket = await this.getReadyBucket();
-    const file = bucket.file(key);
-    const [exists] = await file.exists();
-    if (exists) return true;
-    const [files] = await bucket.getFiles({
-      prefix: key.replace(/\/$/, "") + "/",
-      maxResults: 1
-    });
-    return files.length > 0;
-  }
-  async stat(path) {
-    const key = this.toKey(path);
-    if (!key) {
-      return {
-        name: "",
-        path,
-        type: "directory",
-        size: 0,
-        createdAt: /* @__PURE__ */ new Date(),
-        modifiedAt: /* @__PURE__ */ new Date()
-      };
-    }
-    const bucket = await this.getReadyBucket();
-    const file = bucket.file(key);
-    const [exists] = await file.exists();
-    if (exists) {
-      const [metadata] = await file.getMetadata();
-      const name = path.split("/").pop() ?? "";
-      return {
-        name,
-        path,
-        type: "file",
-        size: Number(metadata.size) || 0,
-        // read_file tool gates the native media-part path on `stat.mimeType`.
-        mimeType: typeof metadata.contentType === "string" ? metadata.contentType : getMimeType(path),
-        createdAt: metadata.timeCreated ? new Date(metadata.timeCreated) : /* @__PURE__ */ new Date(),
-        modifiedAt: metadata.updated ? new Date(metadata.updated) : /* @__PURE__ */ new Date()
-      };
-    }
-    const isDir = await this.isDirectory(path);
-    if (isDir) {
-      const name = path.split("/").filter(Boolean).pop() ?? "";
-      return {
-        name,
-        path,
-        type: "directory",
-        size: 0,
-        createdAt: /* @__PURE__ */ new Date(),
-        modifiedAt: /* @__PURE__ */ new Date()
-      };
-    }
-    throw new FileNotFoundError(path);
-  }
-  async isFile(path) {
-    const key = this.toKey(path);
-    if (!key) return false;
-    const bucket = await this.getReadyBucket();
-    const file = bucket.file(key);
-    const [exists] = await file.exists();
-    return exists;
-  }
-  async isDirectory(path) {
-    const key = this.toKey(path);
-    if (!key) return true;
-    const bucket = await this.getReadyBucket();
-    const [files] = await bucket.getFiles({
-      prefix: key.replace(/\/$/, "") + "/",
-      maxResults: 1
-    });
-    return files.length > 0;
-  }
-  // ---------------------------------------------------------------------------
-  // Lifecycle (overrides base class protected methods)
-  // ---------------------------------------------------------------------------
-  /**
-   * Initialize the GCS client.
-   * Status management is handled by the base class.
-   */
-  async init() {
-    const bucket = this.getBucket();
-    try {
-      const [exists] = await bucket.exists();
-      if (!exists) {
-        const err = new Error(`Bucket "${this.bucketName}" does not exist`);
-        err.status = 404;
-        throw err;
-      }
-    } catch (error) {
-      if (error.status) {
-        throw error;
-      }
-      const code = error.code;
-      if (typeof code === "number") {
-        const message = error instanceof Error ? error.message : String(error);
-        const err = new Error(
-          message
-          // code === 403
-          //   ? `Access denied to bucket "${this.bucketName}" - check credentials and permissions`
-          //   : message,
-        );
-        err.status = code;
-        throw err;
-      }
-      throw error;
-    }
-  }
-  /**
-   * Clean up the GCS client.
-   * Status management is handled by the base class.
-   */
-  async destroy() {
-    this._storage = null;
-    this._bucket = null;
-  }
+	id;
+	name = "GCSFilesystem";
+	provider = "gcs";
+	readOnly;
+	status = "pending";
+	displayName;
+	icon = "gcs";
+	description;
+	bucketName;
+	projectId;
+	credentials;
+	prefix;
+	endpoint;
+	_storage = null;
+	_bucket = null;
+	constructor(options) {
+		super({
+			...options,
+			name: "GCSFilesystem"
+		});
+		this.id = options.id ?? `gcs-fs-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+		this.bucketName = options.bucket;
+		this.projectId = options.projectId;
+		this.credentials = options.credentials;
+		this.prefix = options.prefix ? trimSlashes(options.prefix) + "/" : "";
+		this.endpoint = options.endpoint;
+		this.displayName = options.displayName ?? "Google Cloud Storage";
+		this.icon = options.icon ?? "gcs";
+		this.description = options.description;
+		this.readOnly = options.readOnly;
+	}
+	/**
+	* Get the underlying Google Cloud Storage instance for direct access to GCS APIs.
+	*
+	* Use this when you need to access GCS features not exposed through the
+	* WorkspaceFilesystem interface (e.g., signed URLs, IAM, custom metadata, etc.).
+	*
+	* @example Access other buckets
+	* ```typescript
+	* const storage = fs.storage;
+	* const [buckets] = await storage.getBuckets();
+	* ```
+	*/
+	get storage() {
+		return this.getStorage();
+	}
+	/**
+	* Get the underlying GCS Bucket instance for direct access to bucket operations.
+	*
+	* Use this when you need to access bucket features not exposed through the
+	* WorkspaceFilesystem interface (e.g., signed URLs, lifecycle rules, etc.).
+	*
+	* @example Generate a signed URL
+	* ```typescript
+	* const bucket = fs.bucket;
+	* const [url] = await bucket.file('my-file.txt').getSignedUrl({
+	*   action: 'read',
+	*   expires: Date.now() + 15 * 60 * 1000,
+	* });
+	* ```
+	*/
+	get bucket() {
+		return this.getBucket();
+	}
+	/**
+	* Get mount configuration for E2B sandbox.
+	* Returns GCS-compatible config that works with gcsfuse.
+	*/
+	getMountConfig() {
+		const config = {
+			type: "gcs",
+			bucket: this.bucketName
+		};
+		if (this.credentials && typeof this.credentials === "object") config.serviceAccountKey = JSON.stringify(this.credentials);
+		if (this.prefix) config.prefix = this.prefix.replace(/\/$/, "");
+		return config;
+	}
+	/**
+	* Get filesystem info for status reporting.
+	*/
+	getInfo() {
+		return {
+			id: this.id,
+			name: this.name,
+			provider: this.provider,
+			status: this.status,
+			error: this.error,
+			readOnly: this.readOnly,
+			icon: this.icon,
+			metadata: {
+				bucket: this.bucketName,
+				...this.endpoint && { endpoint: this.endpoint },
+				...this.prefix && { prefix: this.prefix }
+			}
+		};
+	}
+	/**
+	* Get instructions describing this GCS filesystem.
+	* Used by agents to understand storage semantics.
+	*/
+	getInstructions() {
+		const access = this.readOnly ? "Read-only" : "Persistent";
+		return `Google Cloud Storage in bucket "${this.bucketName}". ${access} storage - files are retained across sessions.`;
+	}
+	getStorage() {
+		if (this._storage) return this._storage;
+		const options = {};
+		if (this.projectId) options.projectId = this.projectId;
+		if (this.credentials) if (typeof this.credentials === "string") options.keyFilename = this.credentials;
+		else options.credentials = this.credentials;
+		if (this.endpoint) options.apiEndpoint = this.endpoint;
+		this._storage = new Storage(options);
+		return this._storage;
+	}
+	getBucket() {
+		if (this._bucket) return this._bucket;
+		const storage = this.getStorage();
+		this._bucket = storage.bucket(this.bucketName);
+		return this._bucket;
+	}
+	/**
+	* Ensure the filesystem is initialized and return the bucket.
+	* Uses base class ensureReady() for status management, then returns bucket.
+	*/
+	async getReadyBucket() {
+		await this.ensureReady();
+		return this.getBucket();
+	}
+	toKey(path) {
+		const cleanPath = path.replace(/^\/+/, "").replace(/^\.(?:\/|$)/, "");
+		return this.prefix + cleanPath;
+	}
+	async readFile(path, options) {
+		if (path.endsWith("/")) throw new FileNotFoundError(path);
+		const file = (await this.getReadyBucket()).file(this.toKey(path));
+		try {
+			const [content] = await file.download();
+			if (options?.encoding) return content.toString(options.encoding);
+			return content;
+		} catch (error) {
+			if (error && typeof error === "object" && "code" in error && error.code === 404) throw new FileNotFoundError(path);
+			throw error;
+		}
+	}
+	async writeFile(path, content, options) {
+		const file = (await this.getReadyBucket()).file(this.toKey(path));
+		if (options?.overwrite === false && await this.exists(path)) throw new FileExistsError(path);
+		const body = typeof content === "string" ? Buffer.from(content, "utf-8") : Buffer.from(content);
+		const contentType = getMimeType(path);
+		await file.save(body, {
+			contentType,
+			resumable: false
+		});
+	}
+	async appendFile(path, content) {
+		let existing = "";
+		try {
+			existing = await this.readFile(path, { encoding: "utf-8" });
+		} catch (error) {
+			if (error instanceof FileNotFoundError) {} else throw error;
+		}
+		const appendContent = typeof content === "string" ? content : Buffer.from(content).toString("utf-8");
+		await this.writeFile(path, existing + appendContent);
+	}
+	async deleteFile(path, options) {
+		if (await this.isDirectory(path)) {
+			await this.rmdir(path, {
+				recursive: true,
+				force: options?.force
+			});
+			return;
+		}
+		const file = (await this.getReadyBucket()).file(this.toKey(path));
+		try {
+			await file.delete();
+		} catch (error) {
+			if (!options?.force) {
+				if (error && typeof error === "object" && "code" in error && error.code === 404) throw new FileNotFoundError(path);
+				throw error;
+			}
+		}
+	}
+	async copyFile(src, dest, options) {
+		if (src.endsWith("/")) throw new FileNotFoundError(src);
+		const bucket = await this.getReadyBucket();
+		const srcFile = bucket.file(this.toKey(src));
+		const destFile = bucket.file(this.toKey(dest));
+		if (options?.overwrite === false && await this.exists(dest)) throw new FileExistsError(dest);
+		try {
+			await srcFile.copy(destFile);
+		} catch (error) {
+			if (error && typeof error === "object" && "code" in error && error.code === 404) throw new FileNotFoundError(src);
+			throw error;
+		}
+	}
+	async moveFile(src, dest, options) {
+		await this.copyFile(src, dest, options);
+		await this.deleteFile(src, { force: true });
+	}
+	async mkdir(path, _options) {
+		const key = trimSlashes(this.toKey(path));
+		if (!key || key + "/" === this.prefix) return;
+		const bucket = await this.getReadyBucket();
+		let fileExists = false;
+		try {
+			[fileExists] = await bucket.file(key).exists();
+		} catch {
+			fileExists = false;
+		}
+		if (fileExists) throw new FileExistsError(path);
+		await bucket.file(key + "/").save(Buffer.alloc(0), { resumable: false });
+	}
+	async rmdir(path, options) {
+		if (!options?.recursive) {
+			const bucket = await this.getReadyBucket();
+			const key = trimSlashes(this.toKey(path));
+			const prefix = key + "/";
+			const [files] = await bucket.getFiles({
+				prefix,
+				maxResults: 2
+			});
+			if (files.some((file) => file.name !== prefix)) throw new Error(`Directory not empty: ${path}`);
+			if (key && prefix !== this.prefix) await bucket.file(prefix).delete({ ignoreNotFound: true });
+			return;
+		}
+		const bucket = await this.getReadyBucket();
+		const prefix = this.toKey(path).replace(/\/$/, "") + "/";
+		await bucket.deleteFiles({ prefix });
+	}
+	async readdir(path, options) {
+		const bucket = await this.getReadyBucket();
+		const prefix = this.toKey(path).replace(/\/$/, "");
+		const searchPrefix = prefix ? prefix + "/" : "";
+		const entries = [];
+		const seenDirs = /* @__PURE__ */ new Set();
+		const [files] = await bucket.getFiles({
+			prefix: searchPrefix,
+			autoPaginate: true
+		});
+		for (const file of files) {
+			const key = file.name;
+			if (!key || key === searchPrefix) continue;
+			const relativePath = key.slice(searchPrefix.length);
+			if (!relativePath) continue;
+			if (relativePath.endsWith("/")) {
+				if (options?.recursive && options.extension) continue;
+				const dirName = options?.recursive ? relativePath.slice(0, -1) : relativePath.split("/")[0];
+				if (!dirName) continue;
+				if (!seenDirs.has(dirName)) {
+					seenDirs.add(dirName);
+					entries.push({
+						name: dirName,
+						type: "directory"
+					});
+				}
+				continue;
+			}
+			const name = options?.recursive ? relativePath : relativePath.split("/")[0];
+			if (!name) continue;
+			if (!options?.recursive && relativePath.includes("/")) {
+				if (!seenDirs.has(name)) {
+					seenDirs.add(name);
+					entries.push({
+						name,
+						type: "directory"
+					});
+				}
+				continue;
+			}
+			if (options?.extension) {
+				if (!(Array.isArray(options.extension) ? options.extension : [options.extension]).some((ext) => name.endsWith(ext))) continue;
+			}
+			entries.push({
+				name,
+				type: "file",
+				size: file.metadata.size != null ? Number(file.metadata.size) : void 0
+			});
+		}
+		return entries;
+	}
+	async exists(path) {
+		const key = this.toKey(path);
+		if (!key) return true;
+		const bucket = await this.getReadyBucket();
+		const [exists] = await bucket.file(key).exists();
+		if (exists) return true;
+		const [files] = await bucket.getFiles({
+			prefix: key.replace(/\/$/, "") + "/",
+			maxResults: 1
+		});
+		return files.length > 0;
+	}
+	async stat(path) {
+		const key = trimSlashes(this.toKey(path));
+		const directoryOnly = path.endsWith("/");
+		if (!key) return {
+			name: "",
+			path,
+			type: "directory",
+			size: 0,
+			createdAt: /* @__PURE__ */ new Date(),
+			modifiedAt: /* @__PURE__ */ new Date()
+		};
+		const file = (await this.getReadyBucket()).file(key);
+		const name = key.split("/").pop() ?? "";
+		const [exists] = directoryOnly ? [false] : await file.exists();
+		if (exists) {
+			const [metadata] = await file.getMetadata();
+			return {
+				name,
+				path,
+				type: "file",
+				size: Number(metadata.size) || 0,
+				mimeType: typeof metadata.contentType === "string" ? metadata.contentType : getMimeType(path),
+				createdAt: metadata.timeCreated ? new Date(metadata.timeCreated) : /* @__PURE__ */ new Date(),
+				modifiedAt: metadata.updated ? new Date(metadata.updated) : /* @__PURE__ */ new Date()
+			};
+		}
+		if (await this.isDirectory(path)) return {
+			name,
+			path,
+			type: "directory",
+			size: 0,
+			createdAt: /* @__PURE__ */ new Date(),
+			modifiedAt: /* @__PURE__ */ new Date()
+		};
+		throw new FileNotFoundError(path);
+	}
+	async isFile(path) {
+		if (path.endsWith("/")) return false;
+		const key = trimSlashes(this.toKey(path));
+		if (!key) return false;
+		const [exists] = await (await this.getReadyBucket()).file(key).exists();
+		return exists;
+	}
+	async isDirectory(path) {
+		const key = this.toKey(path);
+		if (!key) return true;
+		const [files] = await (await this.getReadyBucket()).getFiles({
+			prefix: key.replace(/\/$/, "") + "/",
+			maxResults: 1
+		});
+		return files.length > 0;
+	}
+	/**
+	* Initialize the GCS client.
+	* Status management is handled by the base class.
+	*/
+	async init() {
+		const bucket = this.getBucket();
+		try {
+			const [exists] = await bucket.exists();
+			if (!exists) {
+				const err = /* @__PURE__ */ new Error(`Bucket "${this.bucketName}" does not exist`);
+				err.status = 404;
+				throw err;
+			}
+		} catch (error) {
+			if (error.status) throw error;
+			const code = error.code;
+			if (typeof code === "number") {
+				const message = error instanceof Error ? error.message : String(error);
+				const err = new Error(message);
+				err.status = code;
+				throw err;
+			}
+			throw error;
+		}
+	}
+	/**
+	* Clean up the GCS client.
+	* Status management is handled by the base class.
+	*/
+	async destroy() {
+		this._storage = null;
+		this._bucket = null;
+	}
 };
-
-// src/provider.ts
-var gcsFilesystemProvider = {
-  id: "gcs",
-  name: "Google Cloud Storage",
-  description: "Google Cloud Storage bucket",
-  configSchema: {
-    type: "object",
-    required: ["bucket"],
-    properties: {
-      bucket: { type: "string", description: "GCS bucket name" },
-      projectId: { type: "string", description: "GCS project ID" },
-      credentials: {
-        description: "Service account key JSON object or path to key file",
-        oneOf: [{ type: "object" }, { type: "string" }]
-      },
-      prefix: { type: "string", description: "Key prefix (acts like a subdirectory)" },
-      readOnly: { type: "boolean", description: "Mount as read-only", default: false },
-      endpoint: { type: "string", description: "Custom API endpoint URL (for local emulators)" }
-    }
-  },
-  createFilesystem: (config) => new GCSFilesystem(config)
+//#endregion
+//#region src/provider.ts
+const gcsFilesystemProvider = {
+	id: "gcs",
+	name: "Google Cloud Storage",
+	description: "Google Cloud Storage bucket",
+	configSchema: {
+		type: "object",
+		required: ["bucket"],
+		properties: {
+			bucket: {
+				type: "string",
+				description: "GCS bucket name"
+			},
+			projectId: {
+				type: "string",
+				description: "GCS project ID"
+			},
+			credentials: {
+				description: "Service account key JSON object or path to key file",
+				oneOf: [{ type: "object" }, { type: "string" }]
+			},
+			prefix: {
+				type: "string",
+				description: "Key prefix (acts like a subdirectory)"
+			},
+			readOnly: {
+				type: "boolean",
+				description: "Mount as read-only",
+				default: false
+			},
+			endpoint: {
+				type: "string",
+				description: "Custom API endpoint URL (for local emulators)"
+			}
+		}
+	},
+	createFilesystem: (config) => new GCSFilesystem(config)
 };
-
+//#endregion
 export { GCSFilesystem, gcsFilesystemProvider };
-//# sourceMappingURL=index.js.map
+
 //# sourceMappingURL=index.js.map