@kody/dropbox

import { dropboxRpc } from './request.ts'
import type { JsonRecord } from './types.ts'
import { optionalBoolean, requireDropboxPath, requireRecord } from './types.ts'

export type GetMetadataInput = {
	path: string
	includeDeleted?: boolean
	includeMediaInfo?: boolean
	includeHasExplicitSharedMembers?: boolean
}

/**
 * Get metadata for a Dropbox file or folder path.
 * @param input.path - Absolute Dropbox path starting with /.
 * @returns Dropbox metadata object.
 * @example
 * import getMetadata from 'kody:@kody/dropbox/get-metadata'
 * const meta = await getMetadata({ path: '/notes/todo.txt' })
 */
export async function getMetadata(input: GetMetadataInput): Promise<JsonRecord> {
	const path = requireDropboxPath(input.path)
	return dropboxRpc<JsonRecord>('files/get_metadata', {
		path,
		include_deleted: optionalBoolean(input.includeDeleted, 'includeDeleted') ?? false,
		include_media_info: optionalBoolean(input.includeMediaInfo, 'includeMediaInfo') ?? false,
		include_has_explicit_shared_members:
			optionalBoolean(
				input.includeHasExplicitSharedMembers,
				'includeHasExplicitSharedMembers',
			) ?? false,
	})
}

/**
 * Return metadata for a Dropbox file or folder path.
 * @example
 * import getMetadata from 'kody:@kody/dropbox/get-metadata'
 * const metadata = await getMetadata({ path: '/notes/todo.txt' })
 */
export default async function getMetadataEntrypoint(
	params: Partial<GetMetadataInput> & Record<string, unknown> = {},
) {
	const input = requireRecord(params, 'get-metadata')
	requireDropboxPath(input.path)
	return getMetadata(input as unknown as GetMetadataInput)
}