managarten/services/mana-sync/internal/billing/check.go
Till JS ed76f53b00 feat(sync): Phase 2 — server-side billing gate, cron charging, email notifications
Server-side gating (mana-sync Go):
- New billing.Checker with 5-minute cache per user
- Middleware wraps POST/GET /sync/{appId} endpoints
- Returns 402 Payment Required when sync subscription inactive
- Fail-open: if mana-credits is unreachable, sync is allowed
- Config: MANA_CREDITS_URL + MANA_SERVICE_KEY env vars

Recurring charge cron (mana-credits):
- Hourly setInterval checks for due sync subscriptions
- Calls chargeRecurring() which debits credits and advances nextChargeAt
- On insufficient credits: pauses subscription, sends email via mana-notify

Email notifications:
- Sends "Cloud Sync pausiert" email via mana-notify when subscription paused
- Uses POST /api/v1/notifications/send with X-Service-Key auth

Client-side 402 handling:
- sync.ts detects 402 from push/pull, fires onBillingRequired callback
- Layout wires callback to reload syncBilling store → shows pause banner

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-10 22:28:57 +02:00

127 lines
3.4 KiB
Go

// Package billing provides sync billing status checks against mana-credits.
package billing
import (
"encoding/json"
"fmt"
"log/slog"
"net/http"
"sync"
"time"
)
// SyncStatus represents the billing status for a user's sync subscription.
type SyncStatus struct {
Active bool `json:"active"`
Interval string `json:"interval"`
PausedAt *string `json:"pausedAt"`
}
type cachedStatus struct {
status SyncStatus
fetchedAt time.Time
}
// Checker verifies sync billing status via the mana-credits service.
// Results are cached per user for cacheTTL to avoid hitting mana-credits on every request.
type Checker struct {
creditsURL string
serviceKey string
cacheTTL time.Duration
client *http.Client
mu sync.RWMutex
cache map[string]cachedStatus
}
// NewChecker creates a billing checker.
func NewChecker(creditsURL, serviceKey string) *Checker {
return &Checker{
creditsURL: creditsURL,
serviceKey: serviceKey,
cacheTTL: 5 * time.Minute,
client: &http.Client{Timeout: 5 * time.Second},
cache: make(map[string]cachedStatus),
}
}
// IsActive checks whether a user has an active sync subscription.
// Returns true if the billing check fails (fail-open to not block sync on service outage).
func (c *Checker) IsActive(userID string) bool {
// Check cache first
c.mu.RLock()
entry, ok := c.cache[userID]
c.mu.RUnlock()
if ok && time.Since(entry.fetchedAt) < c.cacheTTL {
return entry.status.Active
}
// Fetch from mana-credits
status, err := c.fetchStatus(userID)
if err != nil {
slog.Warn("billing check failed, allowing sync (fail-open)", "userID", userID, "error", err)
return true // Fail-open: don't block sync if billing service is down
}
// Update cache
c.mu.Lock()
c.cache[userID] = cachedStatus{status: status, fetchedAt: time.Now()}
c.mu.Unlock()
return status.Active
}
func (c *Checker) fetchStatus(userID string) (SyncStatus, error) {
url := fmt.Sprintf("%s/api/v1/internal/sync/status/%s", c.creditsURL, userID)
req, err := http.NewRequest("GET", url, nil)
if err != nil {
return SyncStatus{}, err
}
req.Header.Set("X-Service-Key", c.serviceKey)
resp, err := c.client.Do(req)
if err != nil {
return SyncStatus{}, fmt.Errorf("request failed: %w", err)
}
defer resp.Body.Close()
if resp.StatusCode != http.StatusOK {
return SyncStatus{}, fmt.Errorf("unexpected status: %d", resp.StatusCode)
}
var status SyncStatus
if err := json.NewDecoder(resp.Body).Decode(&status); err != nil {
return SyncStatus{}, fmt.Errorf("decode failed: %w", err)
}
return status, nil
}
// Middleware returns an HTTP middleware that checks sync billing status.
// Returns 402 Payment Required if the user's sync subscription is not active.
func (c *Checker) Middleware(validator interface{ UserIDFromRequest(*http.Request) (string, error) }) func(http.Handler) http.Handler {
return func(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
userID, err := validator.UserIDFromRequest(r)
if err != nil {
// Let the downstream handler deal with auth errors
next.ServeHTTP(w, r)
return
}
if !c.IsActive(userID) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusPaymentRequired)
json.NewEncoder(w).Encode(map[string]string{
"error": "sync_inactive",
"message": "Cloud Sync ist nicht aktiv. Aktiviere Sync in den Einstellungen.",
})
return
}
next.ServeHTTP(w, r)
})
}
}