feat(attachments): R2 toggle, storage metrics, and demo R2 config

Add an ATTACHMENTS_ENABLED switch (default on when R2 is bound) via a
central getAttachmentBucket helper, surface R2 + estimated KV usage
against the free tier on the status page and /api/stats (refreshed by the
hourly cron), let setup.sh create and wire the R2 bucket, and bind the
demo bucket so the deployed demo has attachments.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
Julien Herr
2026-05-23 17:33:50 +02:00
parent 7226e718f7
commit f150d40c45
19 changed files with 387 additions and 23 deletions
+7
View File
@@ -5,6 +5,7 @@ export interface Env {
DOMAIN: string;
EMAIL_DOMAIN?: string;
ATTACHMENT_BUCKET?: R2Bucket;
ATTACHMENTS_ENABLED?: string; // "false" disables attachments even when R2 is bound
FEED_MAX_SIZE_BYTES?: string;
PROXY_TRUSTED_IPS?: string;
PROXY_AUTH_SECRET?: string;
@@ -83,12 +84,18 @@ export interface Counters {
last_email_at?: string; // ISO 8601
last_feed_created_at?: string; // ISO 8601
first_seen?: string; // ISO 8601 — first time counters were written (instance start)
// Storage usage snapshot, refreshed by the hourly cron (overwritten, not incremented).
attachments_bytes?: number; // Total R2 bytes used by attachments
attachments_count?: number; // Number of R2 objects
kv_bytes_estimated?: number; // Estimated KV bytes (sum of stored email sizes)
storage_scanned_at?: string; // ISO 8601 — last storage scan
}
// Monitoring API response: persisted counters + live-computed values
export interface StatsResponse extends Counters {
active_feeds: number;
websub_subscriptions_active: number;
attachments_enabled: boolean;
}
// WebSub (PubSubHubbub) subscription configuration