⚡ Project management that doesn't become the project. Boards, Gantt charts, and GitHub integration. Self-host it or use Kaneo Cloud.
TypeScript honoissue-managementissue-trackerjira-alternativekanbanlinear-alternativemcpproject-managementreactself-hostedtypescript
export const MAX_AVATAR_BYTES = 512 * 1024;
export const MAX_AVATAR_BASE64_CHARS = Math.ceil(MAX_AVATAR_BYTES / 3) * 4;
// Permit the data URL prefix and modest whitespace without unbounded cleanup.
export const MAX_AVATAR_INPUT_CHARS = MAX_AVATAR_BASE64_CHARS + 1024;
export const MAX_AVATAR_REQUEST_BYTES = 768 * 1024;
function avatarSizeError() {
return new Error(
`Image exceeds the maximum avatar size of ${MAX_AVATAR_BYTES / 1024}KB.`,
);
}
const AVATAR_MIME_TYPES = ["image/png", "image/jpeg", "image/webp"] as const;
export type AvatarMimeType = (typeof AVATAR_MIME_TYPES)[number];
const BASE64_PATTERN = /^[A-Za-z0-9+/]+={0,2}$/;
export function isAvatarMimeType(value: string): value is AvatarMimeType {
return (AVATAR_MIME_TYPES as readonly string[]).includes(value);
}
export function normalizeAvatarMimeType(value: string) {
const normalized = value.trim().toLowerCase();
return normalized === "image/jpg" ? "image/jpeg" : normalized;
}
function hasMagicBytes(mimeType: AvatarMimeType, bytes: Buffer) {
switch (mimeType) {
case "image/png":
return (
bytes.length >= 8 &&
bytes.subarray(0, 8).equals(
// prettier-ignore -- PNG signature
Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]),
)
);
case "image/jpeg":
return (
bytes.length >= 3 &&
bytes[0] === 0xff &&
bytes[1] === 0xd8 &&
bytes[2] === 0xff
);
case "image/webp":
return (
bytes.length >= 12 &&
bytes.subarray(0, 4).toString("ascii") === "RIFF" &&
bytes.subarray(8, 12).toString("ascii") === "WEBP"
);
}
}
export function stripDataUrlPrefix(value: string) {
return value.replace(/^data:[^;,]*;base64,/, "");
}
export function decodeAvatarUpload(input: {
contentType: string;
data: string;
}): { mimeType: AvatarMimeType; bytes: Buffer } {
if (input.data.length > MAX_AVATAR_INPUT_CHARS) throw avatarSizeError();
const mimeType = normalizeAvatarMimeType(input.contentType);
if (!isAvatarMimeType(mimeType)) {
throw new Error(
"Unsupported image type. Upload a PNG, JPEG, or WebP image.",
);
}
const payload = stripDataUrlPrefix(input.data).replace(/\s+/g, "");
if (payload.length > MAX_AVATAR_BASE64_CHARS) throw avatarSizeError();
if (!payload || !BASE64_PATTERN.test(payload) || payload.length % 4 !== 0) {
throw new Error("Image data must be base64 encoded.");
}
const padding = payload.endsWith("==") ? 2 : payload.endsWith("=") ? 1 : 0;
if ((payload.length / 4) * 3 - padding > MAX_AVATAR_BYTES)
throw avatarSizeError();
const bytes = Buffer.from(payload, "base64");
if (bytes.length === 0) {
throw new Error("Image data must not be empty.");
}
if (bytes.length > MAX_AVATAR_BYTES) {
throw new Error(
`Image exceeds the maximum avatar size of ${Math.floor(MAX_AVATAR_BYTES / 1024)}KB.`,
);
}
if (!hasMagicBytes(mimeType, bytes)) {
throw new Error(`Image data does not match the declared ${mimeType} type.`);
}
return { mimeType, bytes };
}
export function buildAvatarUrl(avatarId: string) {
return `/api/user/avatar/${avatarId}`;
}
export function isUploadedAvatarUrl(image: string | null | undefined) {
const prefix = buildAvatarUrl("");
if (!image?.startsWith(prefix)) return false;
const avatarId = image.slice(prefix.length);
return avatarId.length > 0 && !/[/?#]/.test(avatarId);
}