Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import { BROWSER_RUNTIME_VERSION } from './client-version';
import {
IMAGE_ATTACHMENT_EXTENSIONS,
type ImageAttachmentType,
isImageAttachmentType,
} from './image-attachments';
const importMetaEnv = (import.meta as unknown as { env?: Record<string, string | undefined> }).env;
const FEEDBACK_ENDPOINT = new URL(
'/api/feedback',
importMetaEnv?.VITE_OK_FEEDBACK_INTAKE_ORIGIN || 'https://openknowledge.ai',
).href;
type FeedbackKind = 'general' | 'uninstall';
type FeedbackRating = 'positive' | 'negative';
/*
* WARN: the intake route accepts exactly these image types, and app and
* marketing deploy separately, so drift here only shows up as rejected uploads.
*/
type FeedbackImageType = 'image/png' | 'image/jpeg' | 'image/webp';
interface FeedbackAttachmentPayload {
contentType: FeedbackImageType;
base64: string;
}
export interface FeedbackPayload {
kind: FeedbackKind;
rating?: FeedbackRating;
reasons: string[];
message?: string;
email?: string;
attachments?: FeedbackAttachmentPayload[];
attachmentAssetUrls?: string[];
source?: string;
}
export type FeedbackAttachmentTransport =
| Record<string, never>
| { attachments: FeedbackAttachmentPayload[] }
| { attachmentAssetUrls: string[] };
export type FeedbackResult =
| { ok: true; reference: string }
| { ok: false; reason: 'invalid' | 'unavailable' | 'error' };
function fileToBase64(file: File): Promise<string> {
return new Promise((resolve, reject) => {
const reader = new FileReader();
reader.onload = () => {
const result = typeof reader.result === 'string' ? reader.result : '';
const comma = result.indexOf(',');
resolve(comma === -1 ? '' : result.slice(comma + 1));
};
reader.onerror = () => reject(reader.error ?? new Error('file read failed'));
reader.readAsDataURL(file);
});
}
async function fileToFeedbackAttachment(file: File): Promise<FeedbackAttachmentPayload> {
return { contentType: file.type as FeedbackImageType, base64: await fileToBase64(file) };
}
async function toBase64Transport(files: readonly File[]): Promise<FeedbackAttachmentTransport> {
return { attachments: await Promise.all(files.map(fileToFeedbackAttachment)) };
}
async function uploadThroughDesktop(files: readonly File[]): Promise<string[] | null> {
const bridge = typeof window === 'undefined' ? undefined : window.okDesktop;
if (bridge === undefined) return null;
const assetUrls: string[] = [];
for (const [index, file] of files.entries()) {
if (!isImageAttachmentType(file.type)) return null;
const contentType: ImageAttachmentType = file.type;
const bytes = new Uint8Array(await file.arrayBuffer());
const filename = `feedback-${index + 1}.${IMAGE_ATTACHMENT_EXTENSIONS[contentType]}`;
const result = await bridge.assetUpload.uploadImage({ contentType, bytes, filename });
if (!('assetUrl' in result)) {
console.warn(`[feedback] action=upload-image result=${result.error} index=${index}`);
return null;
}
assetUrls.push(result.assetUrl);
}
return assetUrls;
}
export async function toFeedbackAttachmentPayloads(
files: readonly File[],
): Promise<FeedbackAttachmentTransport> {
if (files.length === 0) return {};
try {
const assetUrls = await uploadThroughDesktop(files);
if (assetUrls !== null) return { attachmentAssetUrls: assetUrls };
} catch (err) {
console.warn(
`[feedback] action=upload-image result=unexpected-error message=${err instanceof Error ? err.message : String(err)}`,
);
}
return toBase64Transport(files);
}
function resolvePlatform(): string {
return (typeof window !== 'undefined' && window.okDesktop?.platform) || 'web';
}
export async function submitFeedback(payload: FeedbackPayload): Promise<FeedbackResult> {
try {
const response = await fetch(FEEDBACK_ENDPOINT, {
method: 'POST',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({
...payload,
appVersion: BROWSER_RUNTIME_VERSION,
platform: resolvePlatform(),
}),
signal: AbortSignal.timeout(30_000),
});
if (response.ok) {
const data = (await response.json().catch((err) => {
console.warn(
`[feedback] action=submit result=ok-parse-error message=${err instanceof Error ? err.message : String(err)}`,
);
return null;
})) as { reference?: unknown } | null;
const reference = data && typeof data.reference === 'string' ? data.reference : '';
return { ok: true, reference };
}
if (response.status === 400 || response.status === 413) {
return { ok: false, reason: 'invalid' };
}
if (response.status === 503) {
return { ok: false, reason: 'unavailable' };
}
console.warn(`[feedback] action=submit result=http-error status=${response.status}`);
return { ok: false, reason: 'error' };
} catch (err) {
console.warn(
`[feedback] action=submit result=network-error message=${
err instanceof Error ? err.message : String(err)
}`,
);
return { ok: false, reason: 'error' };
}
}