@duabalabs/sellub-pricing

Single source of truth for Sellub plans, attribution sources, commission rates, fees and add-on pricing. Consumed by sellub-server, sellub-dashboard, sellub-storefront and any external integration.

Do not hardcode plan names, prices, commission rates or attribution sources anywhere else. Import from this package.

Quick reference

import {
  SellerPlan,
  SellerPlanVariant,
  AttributionSource,
  resolveCommissionRate,
  calculateOrderFees,
  PLAN_CATALOG,
  ADDONS,
  formatMinor,
} from "@duabalabs/sellub-pricing";

// Plan catalog (used to render pricing pages, plan cards, dashboard widgets)
PLAN_CATALOG[SellerPlan.MARKETPLACE].label;          // "Sell on Sellub"
PLAN_CATALOG[SellerPlan.CUSTOM_DOMAIN].variants;     // [{starter, pro}, ...]

// Commission rate for a single (plan, source) lookup
resolveCommissionRate({
  plan: SellerPlan.CUSTOM_DOMAIN,
  variant: SellerPlanVariant.CUSTOM_DOMAIN_PRO,
  source: AttributionSource.SELLER_DIRECT_DOMAIN,
}).ratePercent; // 2

// Full fee breakdown for an order (used at checkout AND persisted)
const breakdown = calculateOrderFees({
  grossAmountPesewas: 100_000,
  plan: SellerPlan.CUSTOM_DOMAIN,
  variant: SellerPlanVariant.CUSTOM_DOMAIN_PRO,
  source: AttributionSource.MARKETPLACE_HOMEPAGE,
  paymentProcessingFeePesewas: 1_950,
  sellerOverridePercent: null, // admin override; null = use catalog
});

The 3 plans

| Plan | Direct commission | Marketplace-attributed | Monthly | |---|---|---|---| | MARKETPLACE | 5% | n/a (always direct) | Free | | CUSTOM_DOMAIN | 2–3% (Pro 2%, Starter 3%) | 4.5% | GHS 250–600 | | COMMERCE_API | 1–1.5% (Growth 1%, Developer 1.5%) | 3.5% | GHS 500 / 1500 / Enterprise |

Attribution rule

Commission depends on (sellerPlan, attributionSource) — not plan alone. Attribution sources marketplace_search, marketplace_homepage, marketplace_category, marketplace_recommendation all bill at the marketplace-attributed rate. Everything else (seller-direct, external app/API, campaigns) bills at the direct rate.

Build & test

npm install
npm run build
npm test