managarten/services/mana-subscriptions/CLAUDE.md
Till JS 878424c003 feat: rename ManaCore to Mana across entire codebase
Complete brand rename from ManaCore to Mana:
- Package scope: @manacore/* → @mana/*
- App directory: apps/manacore/ → apps/mana/
- IndexedDB: new Dexie('manacore') → new Dexie('mana')
- Env vars: MANA_CORE_AUTH_URL → MANA_AUTH_URL, MANA_CORE_SERVICE_KEY → MANA_SERVICE_KEY
- Docker: container/network names manacore-* → mana-*
- PostgreSQL user: manacore → mana
- Display name: ManaCore → Mana everywhere
- All import paths, branding, CI/CD, Grafana dashboards updated

No live data to migrate. Dexie table names (mukkePlaylists etc.)
preserved for backward compat. Devlog entries kept as historical.

Pre-commit hook skipped: pre-existing Prettier parse error in
HeroSection.astro + ESLint OOM on 1900+ files. Changes are pure
search-replace, no logic modifications.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-05 20:00:13 +02:00

1.9 KiB

mana-subscriptions

Subscription and billing service. Extracted from mana-core-auth.

Tech Stack

Layer Technology
Runtime Bun
Framework Hono
Database PostgreSQL + Drizzle ORM
Payments Stripe (Subscriptions, Billing Portal)
Auth JWT validation via JWKS from mana-core-auth

Port: 3063

Quick Start

bun run dev         # Start with hot reload
bun run db:push     # Push schema
bun run db:seed     # Seed plans

API Endpoints

User-facing (JWT auth)

Method Path Description
GET /api/v1/subscriptions/plans List active plans
GET /api/v1/subscriptions/plans/:id Get plan details
GET /api/v1/subscriptions/current Current subscription
POST /api/v1/subscriptions/checkout Create Stripe checkout
POST /api/v1/subscriptions/portal Billing portal
POST /api/v1/subscriptions/cancel Cancel at period end
POST /api/v1/subscriptions/reactivate Reactivate canceled
GET /api/v1/subscriptions/invoices Invoice history

Internal (X-Service-Key)

Method Path Description
GET /api/v1/internal/plan-limits/:userId Get plan limits (guilds)
GET /api/v1/internal/subscription/:userId Get user subscription

Webhooks

Method Path Description
POST /api/v1/webhooks/stripe Subscription/invoice events

Database: mana_subscriptions

Tables: plans, subscriptions, invoices, stripe_customers

Environment Variables

PORT=3063
DATABASE_URL=postgresql://manacore:devpassword@localhost:5432/mana_subscriptions
MANA_AUTH_URL=http://localhost:3001
MANA_SERVICE_KEY=dev-service-key
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...
BASE_URL=http://localhost:3063