feat(billing): integrate Stripe for subscription management and billing access

- Added billing-related fields to the User model in the database.
- Implemented functions for managing billing access, including trial periods and subscription statuses.
- Created new billing utility functions for Stripe integration.
- Updated onboarding page to include billing overview and workspace creation eligibility.
- Enhanced route access checks to require billing access for certain actions.
- Implemented cleanup scripts for expired billing workspaces and associated media.
- Updated header component to conditionally show app navigation based on billing access.
- Added new migrations for billing-related database changes.

prisma/migrations/20260320110000_add_stripe_billing/migration.sql

@@ -0,0 +1,20 @@
+CREATE TYPE "BillingSubscriptionStatus" AS ENUM (
+  'FREE',
+  'TRIALING',
+  'ACTIVE',
+  'PAST_DUE',
+  'CANCELED',
+  'UNPAID',
+  'INCOMPLETE',
+  'INCOMPLETE_EXPIRED'
+);
+
+ALTER TABLE "users"
+ADD COLUMN "stripeCustomerId" TEXT,
+ADD COLUMN "stripeSubscriptionId" TEXT,
+ADD COLUMN "stripePriceId" TEXT,
+ADD COLUMN "stripeCurrentPeriodEnd" TIMESTAMP(3),
+ADD COLUMN "subscriptionStatus" "BillingSubscriptionStatus" NOT NULL DEFAULT 'FREE';
+
+CREATE UNIQUE INDEX "users_stripeCustomerId_key" ON "users"("stripeCustomerId");
+CREATE UNIQUE INDEX "users_stripeSubscriptionId_key" ON "users"("stripeSubscriptionId");

prisma/migrations/20260320123000_add_billing_trials_and_cleanup_dates/migration.sql

@@ -0,0 +1,7 @@
+ALTER TABLE "users"
+ADD COLUMN "trialEndsAt" TIMESTAMP(3),
+ADD COLUMN "billingAccessEndedAt" TIMESTAMP(3);
+
+UPDATE "users"
+SET "trialEndsAt" = "createdAt" + INTERVAL '7 days'
+WHERE "trialEndsAt" IS NULL;

prisma/migrations/20260321003000_add_subscription_cancel_state/migration.sql

@@ -0,0 +1,3 @@
+ALTER TABLE "users"
+ADD COLUMN "stripeCancelAtPeriodEnd" BOOLEAN NOT NULL DEFAULT false,
+ADD COLUMN "stripeCancelAt" TIMESTAMP(3);

prisma/migrations/20260321094500_add_billing_trial_consumed_at/migration.sql

@@ -0,0 +1,6 @@
+ALTER TABLE "users"
+ADD COLUMN "billingTrialConsumedAt" TIMESTAMP(3);
+
+UPDATE "users"
+SET "billingTrialConsumedAt" = "trialEndsAt"
+WHERE "trialEndsAt" IS NOT NULL;