///
import { isServer } from "@solidjs/web";
import type { AsyncFileSystemAdapter, DirEntries } from "./types.ts";
/**
* Adapter that provides access to the actual filesystem in the browser using a directory picker
* receives the options for showDirectoryPicker(options: DirectoryPickerOptions) as optional argument
*
* relies on https://wicg.github.io/file-system-access/ - basic api (https://caniuse.com/native-filesystem-api)
*/
export const makeWebAccessFileSystem = async (
options?: DirectoryPickerOptions | { webkitEntry: FileSystemDirectoryHandle } | undefined,
): Promise => {
const webkitEntry = options && "webkitEntry" in options ? options.webkitEntry : undefined;
// a given directory handle (e.g. the OPFS root from `navigator.storage.getDirectory()`) works
// without `showDirectoryPicker`, which Firefox and Safari don't have
if (isServer || (!webkitEntry && typeof globalThis.showDirectoryPicker !== "function")) {
return null;
}
const handle =
webkitEntry ?? (await globalThis.showDirectoryPicker(options as DirectoryPickerOptions));
const walk = async (
path: string,
handler: (
handle: FileSystemDirectoryHandle | FileSystemFileHandle,
part: string,
index: number,
parts: string[],
) => Promise | undefined,
): Promise => {
const parts = path.split("/").filter(part => part);
let currentHandle: FileSystemDirectoryHandle | FileSystemFileHandle | undefined = handle;
for (let index = 0; index < parts.length; index++) {
const part = parts[index]!;
currentHandle = (await handler(currentHandle, part, index, parts)) || undefined;
if (!currentHandle) {
return undefined;
}
}
return currentHandle;
};
const getNext = (handle: FileSystemDirectoryHandle | FileSystemFileHandle, part: string) =>
handle.kind === "directory"
? handle
.getDirectoryHandle(part)
.catch(() => handle.getFileHandle(part))
.catch(() => undefined)
: undefined;
return {
async: true as const,
getType: async (path: string) =>
walk(path, getNext)
.then(handle => (handle?.kind === "directory" ? "dir" : handle?.kind || null))
.catch(() => null),
readdir: async (path: string) =>
walk(path, getNext).then(async handle => {
if (handle?.kind !== "directory") {
return [];
}
const items: string[] = [];
for await (const name of handle.keys()) {
items.push(name);
}
return items as DirEntries;
}),
mkdir: async (path: string) => {
await walk(path, (handle, part, index, parts) =>
handle.kind === "file"
? Promise.reject(
new Error(
`attempt to create directory "${path}" failed - "${parts
.slice(0, index)
.join("/")}" is a file`,
),
)
: handle.getDirectoryHandle(part, { create: true }),
);
},
readFile: async (path: string) =>
await walk(path, (handle, part, index, parts) =>
index < parts.length - 1
? getNext(handle, part)
: handle.kind === "directory"
? handle.getFileHandle(part)
: undefined,
).then(handle =>
handle?.kind === "file"
? handle.getFile().then(file => file.text())
: Promise.reject(`reading file "${path}" failed - not a file`),
),
writeFile: async (path: string, data: string) =>
void (await walk(path, (handle, part, index, parts) =>
index < parts.length - 1
? getNext(handle, part)
: handle.kind === "directory"
? handle.getFileHandle(part, { create: true }).then(fileHandle =>
fileHandle
.createWritable()
.then(writable => writable.write(data).then(() => writable.close()))
.then(() => fileHandle),
)
: Promise.reject(
new Error(`could not write file ${path}, since path is no parent directory`),
),
)),
rm: async (path: string) =>
void (await walk(path, (handle, part, index, parts) =>
index < parts.length - 1
? getNext(handle, part)
: handle.kind === "directory"
? handle.removeEntry(part, { recursive: true })
: Promise.reject(new Error(`${path} not found; could not be removed`)),
)),
};
};