[baktun14]

Why

Part of CON-1191. Affiliate commission is paid as Console credit, and it has to show up in the affiliate's billing history like any other credit. This PR adds the transaction type and the storage; the next one grants the commission.

Merges after #4277. It targets main so CI runs; until #4277 merges, the diff also shows the PRs below it.

What

• stripe_transactions gets the affiliate_commission type and a source_transaction_id column pointing at the referred user's payment (migration 0128). A partial unique index allows at most one commission per payment. If the referred user's account is deleted, the commission row stays on the affiliate's ledger and its source becomes null.
• The migration adds the enum value in a statement of its own, and nothing else in it uses that value.
• Repository methods to create a commission row and find it by its source payment (with a row lock).
• Billing history (API schema, http-sdk type, deploy-web table) and the credits-added Slack message label it "Affiliate commission" and show it as a credit.
• Only payment_intent rows count as a purchase, so a commission can never trigger the first-purchase bonus.

Testing

Repository integration specs (create, find, lock, unique violation, deleting the referred user), plus BillingView and Slack message specs. Mutation score on changed lines: API 100%, deploy-web 100%.

Screenshots

Billing history with test data: a commission credit, a commission fully taken back after a refund, a card payment and a coupon.

[claude]

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review for a one-time review, or @claude review always to subscribe this PR to a review on every future push.

_{Tip: disable this comment in your organization's Code Review settings.}

[coderabbitai]

Warning

Review limit reached

• Run on-demand review

_{This review includes 35 billable files and costs up to $8.75.}

• Ask an admin to make reviews automatic

Open in CodeRabbit

Reviews can continue after your included limit without a manual trigger. An admin must approve usage-based billing.

Or wait 16 minutes for your next included review.

Check out review usage here.

View limit details

Limit details: You’ve used all 2 included reviews currently available.

Learn how review limits work.

Review configuration:

Run configuration

• Source mode: Auto
• Repository: akash-network/console
• Branch: main
• File: .coderabbit.yaml
• Commit: d9c0882
• Layers: Repository YAML
• Review profile: CHILL
• Plan: Essentials
• Run ID: 90848d8d-ac55-43a9-bb05-4a8dd64baed2

Commits

Reviewing files that changed from the base of the PR and between d9c0882 and 5a0bd9f.

Files ignored due to path filters: 1

• apps/api/test/functional/__snapshots__/docs.spec.ts.snap is excluded by !**/*.snap

Files selected for processing: 35

• apps/api/drizzle/0128_affiliate_commission.sql
• apps/api/drizzle/meta/0128_snapshot.json
• apps/api/drizzle/meta/_journal.json
• apps/api/src/affiliate/controllers/referral/referral.controller.ts
• apps/api/src/affiliate/http-schemas/referral.schema.ts
• apps/api/src/affiliate/index.ts
• apps/api/src/affiliate/routes/referral/referral.router.ts
• apps/api/src/affiliate/services/referral/referral.service.spec.ts
• apps/api/src/affiliate/services/referral/referral.service.ts
• apps/api/src/app/services/credits-added-slack-alert/credits-added-slack-message.spec.ts
• apps/api/src/app/services/credits-added-slack-alert/credits-added-slack-message.ts
• apps/api/src/billing/http-schemas/stripe.schema.ts
• apps/api/src/billing/model-schemas/stripe-transaction/stripe-transaction.schema.ts
• apps/api/src/billing/repositories/stripe-transaction/stripe-transaction.repository.integration.ts
• apps/api/src/billing/repositories/stripe-transaction/stripe-transaction.repository.ts
• apps/api/src/billing/services/activate-trial/trial-activation-instrumentation.service.spec.ts
• apps/api/src/billing/services/activate-trial/trial-activation-instrumentation.service.ts
• apps/api/src/billing/services/managed-user-wallet/managed-user-wallet.service.spec.ts
• apps/api/src/billing/services/managed-user-wallet/managed-user-wallet.service.ts
• apps/api/src/billing/services/stripe-transaction/stripe-transaction.service.spec.ts
• apps/api/src/billing/services/wallet-initializer/wallet-initializer.service.spec.ts
• apps/api/src/billing/services/wallet-initializer/wallet-initializer.service.ts
• apps/api/src/routers/open-api-handlers.ts
• apps/api/swagger/openapi.json
• apps/api/test/functional/referral.spec.ts
• apps/api/test/seeders/database-stripe-transaction.seeder.ts
• apps/deploy-web/src/components/billing-usage/BillingView/BillingView.spec.tsx
• apps/deploy-web/src/components/billing-usage/BillingView/BillingView.tsx
• apps/deploy-web/src/components/onboarding-picker/OnboardingPickerPage.spec.tsx
• apps/deploy-web/src/components/onboarding-picker/OnboardingPickerPage.tsx
• apps/deploy-web/src/queries/useReferralQuery.spec.tsx
• apps/deploy-web/src/queries/useReferralQuery.ts
• packages/console-api-types/src/operations.gen.ts
• packages/console-api-types/src/schema.d.ts
• packages/http-sdk/src/stripe/stripe.types.ts

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

[baktun14]

@claude review

[claude]

⚠️ Code review skipped — your organization's remaining monthly code review budget is too low to start another review, so this review was not started.

An organization admin can view or raise the monthly spending cap at claude.ai/admin-settings/usage, on the Claude Code Review row under Services. The cap resets at the start of the next billing period.

Once the cap resets or is raised, someone with write access to this repository can comment @claude review on this pull request to trigger a review.

[codecov]

Codecov Report

❌ Patch coverage is 98.48485% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 95.10%. Comparing base (d9c0882) to head (5a0bd9f).
⚠️ Report is 11 commits behind head on main.
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
...as/stripe-transaction/stripe-transaction.schema.ts	50.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4278      +/-   ##
==========================================
+ Coverage   94.89%   95.10%   +0.20%     
==========================================
  Files        2145     2077      -68     
  Lines       62324    60619    -1705     
  Branches    15578    15256     -322     
==========================================
- Hits        59143    57649    -1494     
+ Misses       2861     2665     -196     
+ Partials      320      305      -15     

Flag	Coverage Δ		*Carryforward flag
api	96.84% <97.87%> (+<0.01%)	⬆️
deploy-web	93.62% <100.00%> (+0.08%)	⬆️
log-collector	?
notifications	96.68% <ø> (ø)
provider-console	81.68% <ø> (ø)		Carriedforward from d50dd71
provider-inventory	?
provider-proxy	95.18% <ø> (ø)		Carriedforward from d50dd71
tx-signer	93.50% <ø> (ø)

*This pull request uses carry forward flags. Click here to find out more.

Files with missing lines	Coverage Δ
...iliate/controllers/referral/referral.controller.ts	100.00% <100.00%> (ø)
...rc/affiliate/services/referral/referral.service.ts	100.00% <100.00%> (ø)
...s-added-slack-alert/credits-added-slack-message.ts	100.00% <100.00%> (ø)
...tripe-transaction/stripe-transaction.repository.ts	87.25% <100.00%> (+0.79%)	⬆️
...-trial/trial-activation-instrumentation.service.ts	100.00% <100.00%> (ø)
...managed-user-wallet/managed-user-wallet.service.ts	100.00% <100.00%> (ø)
...s/wallet-initializer/wallet-initializer.service.ts	100.00% <100.00%> (ø)
...mponents/billing-usage/BillingView/BillingView.tsx	100.00% <100.00%> (ø)
...ponents/onboarding-picker/OnboardingPickerPage.tsx	100.00% <100.00%> (ø)
apps/deploy-web/src/queries/useReferralQuery.ts	100.00% <100.00%> (ø)
... and 1 more

... and 94 files with indirect coverage changes

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.