Skip to content

Email for professionals and teams

3.8 KB
Raw Blame
import type { B2Config, StorageStatus } from "@/lib/storage/b2-types";

type B2Env = Partial<Pick<CloudflareEnv, "B2_KEY_ID" | "B2_APPLICATION_KEY" | "B2_BUCKET" | "B2_ENDPOINT" | "S3_BUCKET" | "S3_REGION" | "S3_ACCESS_KEY_ID" | "S3_SECRET_ACCESS_KEY" | "MAILFLARE_RUNTIME">> &
	Partial<Record<"AWS_ACCESS_KEY_ID" | "AWS_SECRET_ACCESS_KEY" | "AWS_REGION" | "AWS_DEFAULT_REGION", string>>;

const ENDPOINT_PATTERN = /^s3\.([a-z0-9-]+)\.backblazeb2\.com$/;

/** Accepts `s3.us-west-004.backblazeb2.com` with or without a scheme or trailing slash. */
export function normalizeB2Endpoint(value: string): string {
	return value.trim().replace(/^https?:\/\//i, "").replace(/\/+$/, "").toLowerCase();
}

export function b2RegionFromEndpoint(endpoint: string): string | null {
	return ENDPOINT_PATTERN.exec(endpoint)?.[1] ?? null;
}

/**
 * Backblaze B2 settings from the Worker environment (B2_KEY_ID, B2_APPLICATION_KEY, B2_BUCKET, B2_ENDPOINT).
 * Returns null when any is missing, which leaves the R2 binding (or local files) in use.
 */
export function getB2Config(env: B2Env): B2Config | null {
	const keyId = env.B2_KEY_ID?.trim();
	const applicationKey = env.B2_APPLICATION_KEY?.trim();
	const bucket = env.B2_BUCKET?.trim();
	const endpoint = env.B2_ENDPOINT ? normalizeB2Endpoint(env.B2_ENDPOINT) : "";
	if (!keyId || !applicationKey || !bucket || !endpoint) return null;
	const region = b2RegionFromEndpoint(endpoint);
	if (!region) return null;
	return { keyId, applicationKey, bucket, endpoint, region };
}

const S3_REGION_PATTERN = /^[a-z]{2}(-gov|-iso[a-z]?)?-[a-z]+-\d$/;

/**
 * AWS S3 settings: S3_BUCKET and S3_REGION, with S3_ACCESS_KEY_ID / S3_SECRET_ACCESS_KEY falling back to the
 * AWS_* variables the SES integration already uses. Backblaze wins when both are configured.
 */
export function getS3Config(env: B2Env): B2Config | null {
	const bucket = env.S3_BUCKET?.trim();
	const region = (env.S3_REGION ?? env.AWS_REGION ?? env.AWS_DEFAULT_REGION)?.trim();
	const keyId = (env.S3_ACCESS_KEY_ID ?? env.AWS_ACCESS_KEY_ID)?.trim();
	const applicationKey = (env.S3_SECRET_ACCESS_KEY ?? env.AWS_SECRET_ACCESS_KEY)?.trim();
	if (!bucket || !region || !keyId || !applicationKey || !S3_REGION_PATTERN.test(region)) return null;
	return { keyId, applicationKey, bucket, region, endpoint: `s3.${region}.amazonaws.com` };
}

/** The S3-compatible bucket in use, if any. */
export function getObjectStorageConfig(env: B2Env): (B2Config & { provider: "backblaze" | "s3" }) | null {
	const b2 = getB2Config(env);
	if (b2) return { ...b2, provider: "backblaze" };
	const s3 = getS3Config(env);
	return s3 ? { ...s3, provider: "s3" } : null;
}

export function getStorageStatus(env: B2Env): StorageStatus {
	const configured = getObjectStorageConfig(env);
	if (configured) return { provider: configured.provider, configured: true, bucket: configured.bucket, endpoint: configured.endpoint };
	return { provider: env.MAILFLARE_RUNTIME === "node" ? "files" : "r2", configured: true, bucket: null, endpoint: null };
}

/** Names the variables that are set without exposing values, so a half-finished setup can be diagnosed. */
export function describeB2Problem(env: B2Env): string | null {
	if (!getB2Config(env) && !(env.B2_KEY_ID || env.B2_APPLICATION_KEY || env.B2_BUCKET || env.B2_ENDPOINT) && env.S3_BUCKET && !getS3Config(env)) {
		return "AWS S3 needs S3_BUCKET, S3_REGION and credentials (S3_ACCESS_KEY_ID and S3_SECRET_ACCESS_KEY, or AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY).";
	}
	const present = [env.B2_KEY_ID, env.B2_APPLICATION_KEY, env.B2_BUCKET, env.B2_ENDPOINT].filter((value) => value?.trim()).length;
	if (present === 0 || getB2Config(env)) return null;
	if (getS3Config(env)) return null;
	if (present < 4) return "Backblaze B2 needs B2_KEY_ID, B2_APPLICATION_KEY, B2_BUCKET and B2_ENDPOINT together.";
	return "B2_ENDPOINT must look like s3.us-west-004.backblazeb2.com.";
}