Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import {
ProblemDetailsSchema,
UploadAssetSuccessSchema,
} from '@inkeep/open-knowledge-core/schemas/api';
import { HttpResponseParseError } from '../http-client.ts';
import { getCurrentDocName } from './current-doc-name.ts';
import { singleFileUploadMessage } from './upload-admission.ts';
import {
attachmentFolderRefusalMessage,
reportUploadFailure,
UploadFailedError,
type UploadFailureReport,
UploadRejectedError,
} from './upload-failure.ts';
interface UploadFileResult {
url: string;
}
const UPLOAD_ENDPOINT = '/api/upload';
interface UploadFileDeps {
fetch?: typeof fetch;
docName?: string | null;
singleFile?: boolean;
}
export async function uploadFile(
file: File,
// biome-ignore lint/correctness/noUnusedFunctionParameters: kept on the public signature so PropPanel + PropUploadButton compile unchanged after the per-MIME → unified endpoint flip; the picker's <input accept> already filters at the OS dialog
accept: readonly string[],
deps: UploadFileDeps = {},
): Promise<UploadFileResult> {
if (deps.singleFile) throw new UploadFailedError(singleFileUploadMessage(), 'single-file-mode');
const fetchImpl = deps.fetch ?? globalThis.fetch;
const sizeAtPick = file.size;
const docName = deps.docName !== undefined ? deps.docName : getCurrentDocName();
if (!docName) {
throw new Error('No document is open');
}
const formData = new FormData();
formData.append('file', file);
formData.append('parentDocName', `${docName}.md`);
let res: Response;
try {
res = await fetchImpl(UPLOAD_ENDPOINT, { method: 'POST', body: formData });
} catch (networkError) {
let report: UploadFailureReport | undefined;
try {
report = await reportUploadFailure({ file, sizeAtDrop: sizeAtPick, error: networkError });
} catch (reportError) {
console.error('[uploadFile] upload failed, and diagnosing it failed too', {
docName,
networkError,
reportError,
});
}
if (!report) {
throw new Error(networkError instanceof Error ? networkError.message : String(networkError));
}
console.error('[uploadFile] upload failed before reaching the server', {
...report.log,
docName,
});
throw new UploadFailedError(report.message, report.kind);
}
let rawBody: unknown;
try {
rawBody = await res.json();
} catch (parseError) {
throw new HttpResponseParseError('Upload response is not JSON.', {
cause: parseError,
status: res.status,
});
}
if (!res.ok) {
const problem = ProblemDetailsSchema.safeParse(rawBody);
if (!problem.success) {
throw new HttpResponseParseError('Upload error response did not match ProblemDetails.', {
cause: problem.error,
status: res.status,
});
}
const refusal = attachmentFolderRefusalMessage(problem.data);
if (refusal) throw new UploadRejectedError(refusal);
throw new Error(problem.data.title);
}
const success = UploadAssetSuccessSchema.safeParse(rawBody);
if (!success.success) {
throw new HttpResponseParseError('Upload success response did not match UploadAssetSuccess.', {
cause: success.error,
status: res.status,
});
}
const resolved = success.data.path ?? success.data.src;
const url = resolved.startsWith('/') ? resolved : `/${resolved}`;
return { url };
}