Add subscription product admin

[zacjones93]

Summary

• add an administrator-only subscription product management surface to the builder
• create and update CourseBuilder and Stripe product/price mappings together
• restrict commerce writes to local Docker and Stripe test mode while keeping beta read-only and production blocked
• add contract coverage and document the Phase 0 workflow

Stack

• builds on Add team subscription purchasing #17
• Add team learning dashboard prototype #20 follows this PR

Verification

• pnpm check

Note

Add subscription product admin at /admin/subscriptions with Stripe sync

• New admin page and client UI to create and update membership subscription products, syncing records across CourseBuilder and Stripe (product, price, active status).
• Server actions createSubscriptionProductAction and updateSubscriptionProductAction parse form data via Zod schema, call the workflows in subscription-products.ts, and return structured success/error states.
• getSubscriptionProductAdminData assembles the admin list with sync status, interval, price, currency, and write capability per product.
• DB layer now uses createDatabase() factory in index.ts: picks a shared mysql2 pool for local Docker and Planetscale serverless otherwise. closeBuilderDatabase added for graceful shutdown.
• Writes are hard-blocked outside local Docker + Stripe test mode via assertBuilderCommerceWritesAllowed and assertStripeTestMode.
• Behavioral Change: DB backend now switches dynamically based on DATABASE_URL; updateSubscriptionProduct rolls back active state on adapter failure.

📊 Macroscope summarized 95722f1. 11 files reviewed, 4 issues evaluated, 0 issues filtered, 3 comments posted

🗂️ Filtered Issues

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
beta-egghead	Ready	Preview	Aug 20, 2026 2:41pm
course-builder-egghead	Error		Aug 20, 2026 2:41pm

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 49063211-b1e5-4158-a3b2-f373492fd450

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[macroscopeapp]

🟠 High subscriptions/subscription-admin-client.tsx:90

Editing an existing non-USD product labels its price as USD, so an administrator can enter the wrong amount for products such as EUR subscriptions. The label is hard-coded even though product.currency contains the Stripe currency preserved by updates; render that currency instead.

Suggested change

	<FieldLabel htmlFor={`${idPrefix}-price`}>Price (USD)</FieldLabel>
	<FieldLabel htmlFor={`${idPrefix}-price`}>Price ({product?.currency?.toUpperCase() ?? 'USD'})</FieldLabel>

🚀 Reply "fix it for me" or copy this AI Prompt for your agent:

In file @apps/builder-egghead/src/app/admin/subscriptions/subscription-admin-client.tsx around line 90:

Editing an existing non-USD product labels its price as USD, so an administrator can enter the wrong amount for products such as EUR subscriptions. The label is hard-coded even though `product.currency` contains the Stripe currency preserved by updates; render that currency instead.

[macroscopeapp]

🟠 High lib/subscription-products.ts:363

An unsuccessful update after line 332 leaves a previously inactive product active in both the local database and Stripe. The rollback only catches errors from courseBuilderAdapter.updateProduct, so failures from the missing-price check, getProductCommerceRecords, the price update, or final setSubscriptionProductActive skip restoration; wrap the entire post-activation workflow in one rollback path.

🚀 Reply "fix it for me" or copy this AI Prompt for your agent:

In file @apps/builder-egghead/src/lib/subscription-products.ts around line 363:

An unsuccessful update after line 332 leaves a previously inactive product active in both the local database and Stripe. The rollback only catches errors from `courseBuilderAdapter.updateProduct`, so failures from the missing-`price` check, `getProductCommerceRecords`, the price update, or final `setSubscriptionProductActive` skip restoration; wrap the entire post-activation workflow in one rollback path.

[macroscopeapp]

🟠 High lib/subscription-products.ts:124

prepareProductForAdapterUpdate can leave an inactive product partially activated when any later setSubscriptionProductActive write fails: updatePrice may succeed before updateProduct or a database update throws, leaving Stripe and local statuses inconsistent. Because this call runs before updateSubscriptionProduct's try block, the caller cannot restore the previous state; add compensation for partial Stripe/database writes and include the preparation step in the failure-handling path.

🚀 Reply "fix it for me" or copy this AI Prompt for your agent:

In file @apps/builder-egghead/src/lib/subscription-products.ts around line 124:

`prepareProductForAdapterUpdate` can leave an inactive product partially activated when any later `setSubscriptionProductActive` write fails: `updatePrice` may succeed before `updateProduct` or a database update throws, leaving Stripe and local statuses inconsistent. Because this call runs before `updateSubscriptionProduct`'s `try` block, the caller cannot restore the previous state; add compensation for partial Stripe/database writes and include the preparation step in the failure-handling path.