drive/packages/convex/shared/filesystem.ts

/**
 * Client-safe filesystem types and utilities.
 * This file contains types and pure functions that can be safely imported by frontend code.
 * NO server-only dependencies should be imported here.
 */

import type { Doc, Id } from "@fileone/convex/dataModel"
import type { ApplicationErrorData } from "./error"

export enum FileType {
	File = "File",
	Directory = "Directory",
}

export type Directory = {
	kind: FileType.Directory
	doc: Doc<"directories">
}

export type File = {
	kind: FileType.File
	doc: Doc<"files">
}

export type FileSystemItem = Directory | File

export type DirectoryPathComponent = {
	handle: DirectoryHandle
	name: string
}

export type FilePathComponent = {
	handle: FileHandle
	name: string
}

export type PathComponent = FilePathComponent | DirectoryPathComponent

export type DirectoryPath = [
	DirectoryPathComponent,
	...DirectoryPathComponent[],
]

export type FilePath = [...DirectoryPathComponent[], PathComponent]

export type ReverseFilePath = [PathComponent, ...DirectoryPathComponent[]]

export type DirectoryHandle = {
	kind: FileType.Directory
	id: Id<"directories">
}

export type FileHandle = {
	kind: FileType.File
	id: Id<"files">
}

export type FileSystemHandle = DirectoryHandle | FileHandle

export type OpenedFile = {
	file: Doc<"files">
	shareToken: string
}

export type DeleteResult = {
	deleted: {
		files: number
		directories: number
	}
	errors: ApplicationErrorData[]
}

export function newFileSystemHandle(item: FileSystemItem): FileSystemHandle {
	switch (item.kind) {
		case FileType.File:
			return { kind: item.kind, id: item.doc._id }
		case FileType.Directory:
			return { kind: item.kind, id: item.doc._id }
	}
}

export function isSameHandle(
	handle1: FileSystemHandle,
	handle2: FileSystemHandle,
): boolean {
	return handle1.kind === handle2.kind && handle1.id === handle2.id
}

export function newDirectoryHandle(id: Id<"directories">): DirectoryHandle {
	return { kind: FileType.Directory, id }
}

export function newFileHandle(id: Id<"files">): FileHandle {
	return { kind: FileType.File, id }
}