@harryy/react-file-browser 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hariom Sharma
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,247 @@
+# react-file-browser
+
+A standalone, storage-agnostic React file manager component. Ships UI and client logic only, with
+zero server code. Storage access goes through a host-provided adapter, so the same component drives
+S3, Cloudflare R2, Supabase Storage, an in-memory store, or any backend you implement.
+
+[![npm version](https://img.shields.io/npm/v/react-file-browser.svg)](https://www.npmjs.com/package/react-file-browser)
+[![npm downloads](https://img.shields.io/npm/dm/react-file-browser.svg)](https://www.npmjs.com/package/react-file-browser)
+[![CI](https://github.com/harryy2510/react-file-browser/actions/workflows/ci.yml/badge.svg)](https://github.com/harryy2510/react-file-browser/actions/workflows/ci.yml)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/react-file-browser)](https://bundlephobia.com/package/react-file-browser)
+[![types](https://img.shields.io/npm/types/react-file-browser.svg)](https://www.npmjs.com/package/react-file-browser)
+[![license](https://img.shields.io/npm/l/react-file-browser.svg)](LICENSE)
+
+**[Live demo →](https://harryy2510.github.io/react-file-browser/)**
+
+## Features
+
+- **Storage-agnostic** — one component, pluggable adapters. Ships adapters for S3, R2, Supabase, and
+  in-memory, or implement the `FileBrowserAdapter` interface for any backend.
+- **Capability-gated UI** — controls appear only when the adapter supports them. Omit `rename` and the
+  rename affordance disappears; no config flags to keep in sync.
+- **Resumable uploads** — session-scoped transfer manager with multipart support, a floating transfer
+  widget, progress, and a resume prompt after a hard refresh.
+- **Grid and list views**, search, filter, sort, drag-and-drop move, cut/copy/paste, multi-select,
+  keyboard shortcuts, file preview, and a details panel.
+- **Bulk download** — uses the adapter's `bulkDownloadUrl` when present, otherwise builds a client-side
+  zip from signed URLs.
+- **Upload policies** — reject files by MIME type, size, remaining quota, or a custom validator before
+  they enqueue.
+- **Themeable** with CSS variables that inherit your Tailwind v4 / design-system tokens. No global CSS
+  shipped.
+- **Read-only mode**, comfortable/compact density, ESM-only, fully typed.
+
+## Install
+
+```bash
+bun add react-file-browser
+# or: npm install react-file-browser
+```
+
+`react` and `react-dom` (>=18 <20) are peer dependencies. The AWS SDK and Supabase client are
+optional peers, needed only for their respective adapters.
+
+## Quick start
+
+```tsx
+import { FileBrowser, FileBrowserProvider } from "react-file-browser";
+import { InMemoryFileBrowserAdapter } from "react-file-browser/adapters/in-memory";
+
+const adapter = new InMemoryFileBrowserAdapter();
+
+export function App() {
+  return (
+    <FileBrowserProvider>
+      <FileBrowser adapter={adapter} />
+    </FileBrowserProvider>
+  );
+}
+```
+
+`FileBrowserProvider` belongs above your router. It owns the session-scoped `TransferManager`, the
+floating transfer widget, and the refresh guard. `FileBrowser` can mount on any page or modal and can
+unmount while transfers keep running.
+
+## Mount points
+
+After a hard refresh, browsers cannot restore the original `File` object automatically. Use
+`resolveRestoredUpload` to reattach the host adapter and a user-selected file when the resume prompt
+is accepted:
+
+```tsx
+<FileBrowserProvider
+  resolveRestoredUpload={async (upload) => {
+    const file = await askUserForFile(upload.name);
+    return file ? { adapter, file } : undefined;
+  }}
+>
+  <App />
+</FileBrowserProvider>
+```
+
+## Adapters
+
+The core contract is the `FileBrowserAdapter` interface. Available built-in adapters:
+
+- `react-file-browser/adapters/in-memory`
+- `react-file-browser/adapters/s3`
+- `react-file-browser/adapters/r2`
+- `react-file-browser/adapters/supabase`
+
+The in-memory adapter is usable for tests and demos. It can opt into multipart methods with
+`capabilities: { multipart: true }` and `multipartPartSize` so resumable upload flows are testable
+without cloud credentials. Cloud adapter subpaths fail closed when used without options, so importing
+them is safe.
+
+### S3 and R2
+
+S3 and R2 use the S3-compatible SDK surface when you provide a client and bucket:
+
+```ts
+import { S3Client } from "@aws-sdk/client-s3";
+import { S3FileBrowserAdapter } from "react-file-browser/adapters/s3";
+
+const adapter = new S3FileBrowserAdapter({
+  bucket: "assets",
+  client: new S3Client({ region: "us-east-1" }),
+  prefix: "users/123",
+});
+```
+
+`R2FileBrowserAdapter` accepts the same options. Both require `@aws-sdk/client-s3` and
+`@aws-sdk/s3-request-presigner` to be installed.
+
+### Supabase
+
+```ts
+import { createClient } from "@supabase/supabase-js";
+import { SupabaseFileBrowserAdapter } from "react-file-browser/adapters/supabase";
+
+const supabase = createClient(url, anonKey);
+const adapter = new SupabaseFileBrowserAdapter({
+  bucket: "assets",
+  client: supabase,
+  prefix: "users/123",
+});
+```
+
+### Custom backends
+
+Implement the `FileBrowserAdapter` interface directly, or pass a custom `implementation` to any cloud
+adapter to delegate required and optional methods:
+
+```ts
+import { S3FileBrowserAdapter } from "react-file-browser/adapters/s3";
+
+const adapter = new S3FileBrowserAdapter({
+  implementation: hostBackedAdapter,
+});
+```
+
+Only `list`, `delete`, `signedUrl`, and `upload` are required. Everything else is optional and toggles
+UI capabilities by presence. If an adapter omits `createFolder`, `move`, `rename`, `copy`, multipart,
+or `bulkDownloadUrl`, those controls are hidden. Recursive folder drops are rejected when
+`createFolder` is absent rather than flattened.
+
+## API reference
+
+### `<FileBrowser>` props
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `adapter` | `FileBrowserAdapter` | — (required) | Storage backend. |
+| `initialPath` | `string` | `"/"` | Directory to open on mount. |
+| `density` | `"comfortable" \| "compact"` | `"comfortable"` | Row/tile density. |
+| `readOnly` | `boolean` | `false` | Hides all mutating affordances. |
+| `showDetailsPanel` | `boolean` | `true` | Toggles the right-hand details panel. |
+| `uploadPolicy` | `FileBrowserUploadPolicy` | — | Reject files before they enqueue. |
+| `warnZipSizeBytes` | `number` | — | Warn before building a large client-side zip. |
+
+### `<FileBrowserProvider>` props
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `manager` | `TransferManager` | auto-created | Bring your own transfer manager. |
+| `options` | `TransferManagerOptions` | — | Storage, storage key, id factory, clock. |
+| `resolveRestoredUpload` | `(upload) => ... \| undefined` | — | Reattach a `File` when resuming after reload. |
+| `showFloatingWidget` | `boolean` | `true` | Toggles the floating transfer widget. |
+
+### `FileBrowserAdapter` interface
+
+**Required:** `list`, `delete`, `signedUrl`, `upload`.
+
+**Optional (each toggles a UI capability):** `createFolder`, `rename`, `move`, `copy`, `stat`,
+`exists`, `createMultipartUpload`, `uploadPart`, `completeMultipartUpload`, `abortMultipartUpload`,
+`bulkDownloadUrl`.
+
+Throw `FileBrowserAdapterError` with a code (`access_denied`, `aborted`, `conflict`, `invalid_path`,
+`not_found`, `not_supported`) for correct error mapping, and `FileBrowserBulkActionError` for partial
+bulk failures so successful paths stay applied and failed paths roll back.
+
+### Headless usage
+
+`useFileBrowser({ adapter, initialPath })` exposes the full state and actions if you want to build your
+own UI. The `FileBrowser` component is a consumer of this hook.
+
+### Entry points
+
+| Import | Contents |
+| --- | --- |
+| `react-file-browser` | `FileBrowser`, `FileBrowserProvider`, `useFileBrowser`, `TransferManager`, adapter types and errors, path utilities. |
+| `react-file-browser/adapters/in-memory` | `InMemoryFileBrowserAdapter`, `createInMemoryFileBrowserAdapter`. |
+| `react-file-browser/adapters/s3` | `S3FileBrowserAdapter`. |
+| `react-file-browser/adapters/r2` | `R2FileBrowserAdapter`. |
+| `react-file-browser/adapters/supabase` | `SupabaseFileBrowserAdapter`. |
+| `react-file-browser/theme` | `FILE_BROWSER_THEME_CONTRACT`, `getFileBrowserDensityAttributes`. |
+
+## Styling
+
+The package does not ship global CSS. Components use utility classes and `--fb-*` CSS variables that
+fall back to your Tailwind v4 / design-system tokens:
+
+```css
+--fb-accent: var(--color-primary-500, oklch(.54 .19 285));
+--fb-surface: var(--color-white, #fff);
+--fb-border: var(--color-gray-200, #e5e5ee);
+--fb-radius: var(--radius-lg, 10px);
+--fb-gap: var(--spacing, .25rem);
+```
+
+Add the library source to your Tailwind v4 content/source setup so host builds include the classes.
+The demo app defines a full theme; the package itself does not. `FILE_BROWSER_THEME_CONTRACT`
+documents every token and its default.
+
+## UI behavior
+
+- `readOnly` hides upload, create, rename, move, copy, and delete affordances while keeping browsing,
+  preview, details, and download available.
+- `uploadPolicy` can reject files before enqueueing transfers by MIME type, extension, max file size,
+  remaining quota, or a custom validator. Rejections render as an alert and valid files in the same
+  batch still upload.
+- Upload conflicts surface a replace / keep both / skip dialog with apply-to-all support.
+- Partial bulk failures can be reported with `FileBrowserBulkActionError`; successful paths stay
+  applied and failed paths are surfaced in a dialog.
+- Single-file download uses `signedUrl`. Folder and multi-select bulk download uses `bulkDownloadUrl`
+  when present, otherwise it builds a client zip from signed URLs after the configured size warning.
+- Move-capable adapters enable the destination tree picker, Cut/Paste, and drag onto folders.
+- Keyboard shortcuts include Enter preview/open, F2 rename, Delete confirm, Cmd/Ctrl+A selection, and
+  Cmd/Ctrl+C/X/V for adapter-gated copy, cut, and paste.
+
+## Required backend lifecycle
+
+The package never creates server routes or lifecycle rules. Hosts must configure:
+
+- Abort incomplete multipart uploads after N days.
+- Expire temporary bulk-download zip objects after 4 to 8 hours.
+- Keep zip output outside browsed/listed user prefixes.
+
+Skipping these leaks storage cost.
+
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for local setup, conventions, and
+the release process. Please follow the [Code of Conduct](CODE_OF_CONDUCT.md).
+
+## License
+
+[MIT](LICENSE) © Hariom Sharma

package/dist/adapters/cloud-adapter-base.d.ts

@@ -0,0 +1,27 @@
+import type { FileBrowserAdapter, FileBrowserListOptions, FileBrowserListResult, FileBrowserUploadOptions, FileNode } from '../core/types';
+export type CloudAdapterName = 'S3' | 'R2' | 'Supabase';
+export type CloudFileBrowserAdapterOptions = {
+    implementation?: FileBrowserAdapter;
+};
+export declare class UnsupportedCloudFileBrowserAdapter implements FileBrowserAdapter {
+    private readonly adapterName;
+    readonly rename?: NonNullable<FileBrowserAdapter['rename']>;
+    readonly createFolder?: NonNullable<FileBrowserAdapter['createFolder']>;
+    readonly move?: NonNullable<FileBrowserAdapter['move']>;
+    readonly copy?: NonNullable<FileBrowserAdapter['copy']>;
+    readonly stat?: NonNullable<FileBrowserAdapter['stat']>;
+    readonly exists?: NonNullable<FileBrowserAdapter['exists']>;
+    readonly createMultipartUpload?: NonNullable<FileBrowserAdapter['createMultipartUpload']>;
+    readonly uploadPart?: NonNullable<FileBrowserAdapter['uploadPart']>;
+    readonly completeMultipartUpload?: NonNullable<FileBrowserAdapter['completeMultipartUpload']>;
+    readonly abortMultipartUpload?: NonNullable<FileBrowserAdapter['abortMultipartUpload']>;
+    readonly bulkDownloadUrl?: NonNullable<FileBrowserAdapter['bulkDownloadUrl']>;
+    private readonly implementation?;
+    constructor(adapterName: CloudAdapterName, options?: CloudFileBrowserAdapterOptions);
+    list(path: string, opts?: FileBrowserListOptions): Promise<FileBrowserListResult>;
+    delete(paths: string[]): Promise<void>;
+    signedUrl(path: string): Promise<string>;
+    upload(path: string, file: File, opts?: FileBrowserUploadOptions): Promise<FileNode>;
+    private error;
+}
+//# sourceMappingURL=cloud-adapter-base.d.ts.map

package/dist/adapters/cloud-adapter-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-adapter-base.d.ts","sourceRoot":"","sources":["../../src/adapters/cloud-adapter-base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,QAAQ,EACR,MAAM,eAAe,CAAA;AAEtB,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,GAAG,UAAU,CAAA;AAEvD,MAAM,MAAM,8BAA8B,GAAG;IAC5C,cAAc,CAAC,EAAE,kBAAkB,CAAA;CACnC,CAAA;AAED,qBAAa,kCAAmC,YAAW,kBAAkB;IAgB3E,OAAO,CAAC,QAAQ,CAAC,WAAW;IAf7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC,CAAA;IACvE,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAA;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAA;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAA;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC3D,QAAQ,CAAC,qBAAqB,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,CAAC,CAAA;IACzF,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAA;IACnE,QAAQ,CAAC,uBAAuB,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,CAAC,CAAA;IAC7F,QAAQ,CAAC,oBAAoB,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,CAAC,CAAA;IACvF,QAAQ,CAAC,eAAe,CAAC,EAAE,WAAW,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAE7E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAoB;gBAGlC,WAAW,EAAE,gBAAgB,EAC9C,OAAO,GAAE,8BAAmC;IAuC7C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IASjF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAUpF,OAAO,CAAC,KAAK;CAMb"}

package/dist/adapters/in-memory/in-memory-file-browser-adapter.d.ts

@@ -0,0 +1,53 @@
+import type { FileBrowserAdapter, FileBrowserListOptions, FileBrowserListResult, FileBrowserUploadOptions, FileNode } from '../../core/types';
+export type InMemoryFileBrowserCapability = 'createFolder' | 'rename' | 'move' | 'copy' | 'stat' | 'exists' | 'bulkDownloadUrl' | 'multipart';
+export type InMemoryFileBrowserAdapterOptions = {
+    capabilities?: Partial<Record<InMemoryFileBrowserCapability, boolean>>;
+    multipartPartSize?: number;
+    pageSize?: number;
+    now?: () => Date;
+};
+export declare class InMemoryFileBrowserAdapter implements FileBrowserAdapter {
+    readonly createFolder?: NonNullable<FileBrowserAdapter['createFolder']>;
+    readonly rename?: NonNullable<FileBrowserAdapter['rename']>;
+    readonly move?: NonNullable<FileBrowserAdapter['move']>;
+    readonly copy?: NonNullable<FileBrowserAdapter['copy']>;
+    readonly stat?: NonNullable<FileBrowserAdapter['stat']>;
+    readonly exists?: NonNullable<FileBrowserAdapter['exists']>;
+    readonly bulkDownloadUrl?: NonNullable<FileBrowserAdapter['bulkDownloadUrl']>;
+    readonly createMultipartUpload?: NonNullable<FileBrowserAdapter['createMultipartUpload']>;
+    readonly uploadPart?: NonNullable<FileBrowserAdapter['uploadPart']>;
+    readonly completeMultipartUpload?: NonNullable<FileBrowserAdapter['completeMultipartUpload']>;
+    readonly abortMultipartUpload?: NonNullable<FileBrowserAdapter['abortMultipartUpload']>;
+    private readonly entries;
+    private readonly multipartUploads;
+    private readonly multipartPartSize;
+    private readonly pageSize?;
+    private readonly now;
+    private etagSequence;
+    private multipartSequence;
+    constructor(options?: InMemoryFileBrowserAdapterOptions);
+    list(path: string, opts?: FileBrowserListOptions): Promise<FileBrowserListResult>;
+    private createFolderEntry;
+    delete(paths: string[]): Promise<void>;
+    signedUrl(path: string): Promise<string>;
+    upload(path: string, file: File, opts?: FileBrowserUploadOptions): Promise<FileNode>;
+    private nextAvailablePath;
+    private renameEntry;
+    private moveEntries;
+    private copyEntries;
+    private statEntry;
+    private existsEntries;
+    private createBulkDownloadUrl;
+    private createMultipartUploadEntry;
+    private uploadMultipartPart;
+    private completeMultipartUploadEntry;
+    private abortMultipartUploadEntry;
+    private getMultipartUpload;
+    private collectTree;
+    private assertFolderExists;
+    private getEntry;
+    private timestamp;
+    private nextEtag;
+}
+export declare function createInMemoryFileBrowserAdapter(options?: InMemoryFileBrowserAdapterOptions): InMemoryFileBrowserAdapter;
+//# sourceMappingURL=in-memory-file-browser-adapter.d.ts.map

package/dist/adapters/in-memory/in-memory-file-browser-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-file-browser-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/in-memory/in-memory-file-browser-adapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/in-memory/index.d.ts

@@ -0,0 +1,2 @@
+export { InMemoryFileBrowserAdapter, createInMemoryFileBrowserAdapter, type InMemoryFileBrowserAdapterOptions, type InMemoryFileBrowserCapability } from './in-memory-file-browser-adapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/in-memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/in-memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,0BAA0B,EAC1B,gCAAgC,EAChC,KAAK,iCAAiC,EACtC,KAAK,6BAA6B,EAClC,MAAM,kCAAkC,CAAA"}

package/dist/adapters/in-memory/index.js

@@ -0,0 +1,270 @@
+import { a as e, c as t, i as n, n as r, o as i, r as a, s as o } from "../../chunks/path-CPm7s9NF.js";
+import { t as s } from "../../chunks/browser-4lIkMGbo.js";
+//#region src/adapters/in-memory/in-memory-file-browser-adapter.ts
+var c = {
+	createFolder: !0,
+	rename: !0,
+	move: !0,
+	copy: !0,
+	stat: !0,
+	exists: !0,
+	bulkDownloadUrl: !0,
+	multipart: !1
+}, l = class {
+	createFolder;
+	rename;
+	move;
+	copy;
+	stat;
+	exists;
+	bulkDownloadUrl;
+	createMultipartUpload;
+	uploadPart;
+	completeMultipartUpload;
+	abortMultipartUpload;
+	entries = /* @__PURE__ */ new Map();
+	multipartUploads = /* @__PURE__ */ new Map();
+	multipartPartSize;
+	pageSize;
+	now;
+	etagSequence = 0;
+	multipartSequence = 0;
+	constructor(e = {}) {
+		let t = {
+			...c,
+			...e.capabilities
+		};
+		this.pageSize = e.pageSize, this.multipartPartSize = Math.max(1, e.multipartPartSize ?? 5 * 1024 * 1024), this.now = e.now ?? (() => /* @__PURE__ */ new Date()), this.entries.set("/", {
+			path: "/",
+			name: "",
+			kind: "folder",
+			modifiedAt: this.timestamp()
+		}), t.createFolder && (this.createFolder = this.createFolderEntry.bind(this)), t.rename && (this.rename = this.renameEntry.bind(this)), t.move && (this.move = this.moveEntries.bind(this)), t.copy && (this.copy = this.copyEntries.bind(this)), t.stat && (this.stat = this.statEntry.bind(this)), t.exists && (this.exists = this.existsEntries.bind(this)), t.bulkDownloadUrl && (this.bulkDownloadUrl = this.createBulkDownloadUrl.bind(this)), t.multipart && (this.createMultipartUpload = this.createMultipartUploadEntry.bind(this), this.uploadPart = this.uploadMultipartPart.bind(this), this.completeMultipartUpload = this.completeMultipartUploadEntry.bind(this), this.abortMultipartUpload = this.abortMultipartUploadEntry.bind(this));
+	}
+	list(e, n = {}) {
+		p(n.signal);
+		let r = i(e);
+		if (this.getEntry(r).kind !== "folder") throw new t("invalid_path", `Cannot list a file path: ${r}`);
+		let o = Array.from(this.entries.values()).filter((e) => e.path !== "/").filter((e) => a(e.path) === r).sort(f).map(d);
+		if (!this.pageSize) return Promise.resolve({ items: o });
+		let s = n.cursor ? Number.parseInt(n.cursor, 10) : 0, c = Number.isFinite(s) && s > 0 ? s : 0, l = o.slice(c, c + this.pageSize), u = c + l.length;
+		return Promise.resolve({
+			items: l,
+			cursor: u < o.length ? String(u) : void 0
+		});
+	}
+	createFolderEntry(e) {
+		let n = i(e);
+		if (n === "/") return Promise.resolve(d(this.getEntry("/")));
+		if (this.entries.has(n)) throw new t("conflict", `A file browser entry already exists at ${n}`);
+		this.assertFolderExists(a(n));
+		let o = {
+			path: n,
+			name: r(n),
+			kind: "folder",
+			modifiedAt: this.timestamp(),
+			etag: this.nextEtag()
+		};
+		return this.entries.set(n, o), Promise.resolve(d(o));
+	}
+	delete(e) {
+		for (let r of e.map(i)) {
+			if (r === "/") throw new t("invalid_path", "Cannot delete the root folder");
+			this.getEntry(r);
+			for (let e of Array.from(this.entries.keys())) n(r, e) && this.entries.delete(e);
+		}
+		return Promise.resolve();
+	}
+	signedUrl(e) {
+		let n = this.getEntry(e);
+		if (n.kind !== "file" || !n.blob) throw new t("invalid_path", `Cannot create a signed URL for a folder: ${n.path}`);
+		return Promise.resolve(URL.createObjectURL(n.blob));
+	}
+	upload(e, n, o = {}) {
+		p(o.signal);
+		let s = i(e);
+		if (this.assertFolderExists(a(s)), this.entries.has(s) && o.onConflict !== "replace") if (o.onConflict === "keep-both") s = this.nextAvailablePath(s);
+		else throw new t("conflict", `A file browser entry already exists at ${s}`);
+		o.onProgress?.(0, n.size), p(o.signal);
+		let c = {
+			path: s,
+			name: r(s) || n.name,
+			kind: "file",
+			size: n.size,
+			mimeType: n.type || void 0,
+			modifiedAt: this.timestamp(),
+			etag: this.nextEtag(),
+			blob: n
+		};
+		return this.entries.set(s, c), o.onProgress?.(n.size, n.size), Promise.resolve(d(c));
+	}
+	nextAvailablePath(n) {
+		let i = a(n), o = r(n), s = o.lastIndexOf("."), c = s > 0, l = c ? o.slice(0, s) : o, u = c ? o.slice(s) : "";
+		for (let t = 1; t < 2 ** 53 - 1; t += 1) {
+			let n = e(i, `${l} (${t})${u}`);
+			if (!this.entries.has(n)) return n;
+		}
+		throw new t("conflict", `Could not allocate a unique file browser path for ${n}`);
+	}
+	renameEntry(e, n) {
+		let r = i(e), a = this.getEntry(r), o = n.trim();
+		if (!o || o.includes("/") || o.includes("\\")) throw new t("invalid_path", `Invalid file browser name: ${n}`);
+		let s = {
+			...a,
+			name: o,
+			modifiedAt: this.timestamp(),
+			etag: this.nextEtag()
+		};
+		return this.entries.set(r, s), Promise.resolve(d(s));
+	}
+	async moveEntries(e, t) {
+		await this.copyEntries(e, t);
+		for (let t of e) await this.delete([t]);
+	}
+	copyEntries(n, a) {
+		let s = i(a);
+		this.assertFolderExists(s);
+		let c = /* @__PURE__ */ new Map();
+		for (let a of n.map(i)) {
+			let n = this.getEntry(a), i = e(s, r(n.path));
+			for (let e of this.collectTree(n.path)) {
+				let a = o(e.path, n.path, i);
+				if (this.entries.has(a) || c.has(a)) throw new t("conflict", `A file browser entry already exists at ${a}`);
+				c.set(a, {
+					...e,
+					path: a,
+					name: e.path === n.path ? r(a) : e.name,
+					modifiedAt: this.timestamp(),
+					etag: this.nextEtag()
+				});
+			}
+		}
+		for (let [e, t] of c) this.entries.set(e, t);
+		return Promise.resolve();
+	}
+	statEntry(e) {
+		return Promise.resolve(d(this.getEntry(e)));
+	}
+	existsEntries(e) {
+		return Promise.resolve(Object.fromEntries(e.map((e) => {
+			let t = i(e);
+			return [t, this.entries.has(t)];
+		})));
+	}
+	async createBulkDownloadUrl(e) {
+		let t = {};
+		for (let n of e) {
+			this.getEntry(n);
+			let e = this.collectTree(n);
+			for (let n of e) n.kind === "folder" || !n.blob || (t[m(n.path)] = new Uint8Array(await n.blob.arrayBuffer()));
+		}
+		let n = new Blob([s(t)], { type: "application/zip" });
+		return {
+			url: URL.createObjectURL(n),
+			expiresAt: new Date(this.now().getTime() + 14400 * 1e3).toISOString()
+		};
+	}
+	createMultipartUploadEntry(e, n) {
+		let r = i(e);
+		if (this.assertFolderExists(a(r)), this.entries.get(r)?.kind === "folder") throw new t("conflict", `A file browser entry already exists at ${r}`);
+		this.multipartSequence += 1;
+		let o = `memory-multipart-${this.multipartSequence}`;
+		return this.multipartUploads.set(o, {
+			path: r,
+			size: n,
+			partSize: this.multipartPartSize,
+			parts: /* @__PURE__ */ new Map()
+		}), Promise.resolve({
+			uploadId: o,
+			partSize: this.multipartPartSize
+		});
+	}
+	uploadMultipartPart({ chunk: e, onProgress: t, partNumber: n, signal: r, uploadId: i }) {
+		return Promise.resolve().then(() => {
+			p(r);
+			let a = this.getMultipartUpload(i), o = `memory-part-${n}`;
+			return a.parts.set(n, {
+				blob: e,
+				etag: o
+			}), t?.(e.size), p(r), { etag: o };
+		});
+	}
+	completeMultipartUploadEntry({ parts: e, uploadId: n }) {
+		return Promise.resolve().then(() => {
+			let i = this.getMultipartUpload(n), a = [];
+			for (let r of e.sort((e, t) => e.partNumber - t.partNumber)) {
+				let e = i.parts.get(r.partNumber);
+				if (!e || e.etag !== r.etag) throw new t("not_found", `No uploaded part ${r.partNumber} exists for ${n}`);
+				a.push(e.blob);
+			}
+			let o = new Blob(a);
+			if (o.size !== i.size) throw new t("invalid_path", `Multipart upload ${n} size mismatch`);
+			let s = {
+				path: i.path,
+				name: r(i.path),
+				kind: "file",
+				size: o.size,
+				modifiedAt: this.timestamp(),
+				etag: this.nextEtag(),
+				blob: o
+			};
+			return this.entries.set(i.path, s), this.multipartUploads.delete(n), d(s);
+		});
+	}
+	abortMultipartUploadEntry(e) {
+		return Promise.resolve().then(() => {
+			this.getMultipartUpload(e), this.multipartUploads.delete(e);
+		});
+	}
+	getMultipartUpload(e) {
+		let n = this.multipartUploads.get(e);
+		if (!n) throw new t("not_found", `No multipart upload exists for ${e}`);
+		return n;
+	}
+	collectTree(e) {
+		let t = i(e);
+		return Array.from(this.entries.values()).filter((e) => n(t, e.path)).sort((e, t) => e.path.localeCompare(t.path));
+	}
+	assertFolderExists(e) {
+		let n = this.getEntry(e);
+		if (n.kind !== "folder") throw new t("invalid_path", `Expected a folder at ${n.path}`);
+	}
+	getEntry(e) {
+		let n = i(e), r = this.entries.get(n);
+		if (!r) throw new t("not_found", `No file browser entry exists at ${n}`);
+		return r;
+	}
+	timestamp() {
+		return this.now().toISOString();
+	}
+	nextEtag() {
+		return this.etagSequence += 1, `memory-${this.etagSequence}`;
+	}
+};
+function u(e) {
+	return new l(e);
+}
+function d(e) {
+	let t = {
+		path: e.path,
+		name: e.name,
+		kind: e.kind
+	};
+	return e.size !== void 0 && (t.size = e.size), e.mimeType !== void 0 && (t.mimeType = e.mimeType), e.modifiedAt !== void 0 && (t.modifiedAt = e.modifiedAt), e.etag !== void 0 && (t.etag = e.etag), e.thumbnailUrl !== void 0 && (t.thumbnailUrl = e.thumbnailUrl), t;
+}
+function f(e, t) {
+	return e.kind === t.kind ? e.name.localeCompare(t.name, void 0, {
+		numeric: !0,
+		sensitivity: "base"
+	}) : e.kind === "folder" ? -1 : 1;
+}
+function p(e) {
+	if (e?.aborted) throw new t("aborted", "Operation was aborted");
+}
+function m(e) {
+	return e.replace(/^\/+/, "") || "download";
+}
+//#endregion
+export { l as InMemoryFileBrowserAdapter, u as createInMemoryFileBrowserAdapter };
+
+//# sourceMappingURL=index.js.map