Package status
Live readiness matrix for the public Sellub SDKs (npm) and the server-side
plugins (apps/sellub/sellub-server/src/plugins/).
Public SDKs (packages/)
| Package | npm version | Status | What works today | What’s next |
|---|---|---|---|---|
@duabalabs/sellub-client | 0.6.x | Stable | externalPayments, subscriptions, invoices, shop (catalog/cart/checkout/orders), admin (channels, orders, refunds, subscriptions) | Granular ErrorResult typing on cancel/refund; server-side sellubSubscriptions resolver (work-stream C3) |
@duabalabs/sellub-types | 0.3.x | Stable | Money, OrderRef, Subscription, ApiResult, PaymentRef, PriceQuote, PlanVariant, InventoryItem, FulfillmentGroup, typed WebhookEvent union (incl. inventory events), StockMovement | TaxLine, RefundRef, ShippingQuote |
@duabalabs/sellub-pricing | 0.2.x | Stable | Plans, commission, attribution, fees, currency, addons | More plan presets; tax/VAT helpers |
@duabalabs/sellub-webhooks | 0.3.x | Stable | sign / verify / dispatch / verifyAndParse (typed events incl. inventory) | replay(eventId) helper |
@duabalabs/sellub-react | 0.1.x | Beta | useSubscription | <Checkout>, <PriceGate>, <CatalogBrowser> |
@duabalabs/sellub-react-native | 0.1.x | Beta | useSubscription | AsyncStorage cache, useSellubCheckout |
@duabalabs/sellub-embed | 0.1.x | Alpha | mountSellubEmbed API surface (stub renderer) | Lazy iframe + Shop API binding |
@duabalabs/sellub-cli | 0.2.x | Beta | login, doctor, channels list, subscriptions check (wired against Sellub Admin + DPS); 17 vitest specs | catalog import <file.csv>, orders list |
@duabalabs/dps-client | 0.3.x | Stable | checkSubscription, listEvents, getEvent (typed DpsEvent); browser + server modes | More registry queries as DPS evolves |
Status legend:
- Stable — public API is unlikely to change in
0.x; safe to depend on. - Beta — API may evolve; pin exact version in production.
- Alpha — surface is in place but the implementation is a placeholder; use only against the explicit roadmap below.
Deprecated npm packages
The following 16 packages were deprecated and removed on 2026-05-11:
@duabalabs/sellub-vendure-{api-keys, billing, bundles, core, delivery,
delivery-base, e-commerce-api, event-bridge, external-payments, freight,
fulfilment, payment, pricing, print, services, social, subscriptions}They were source-only mirrors of internal Vendure plugins and never worked when consumed from npm. The plugins themselves still exist in the server; only the npm distribution was removed. If a colleague’s tooling references one of these packages, point them at the SDK matrix above.
Server plugins
See Plugin architecture for the full map. Status of the vertical / future-product plugins:
| Plugin | Status | What works | What’s missing |
|---|---|---|---|
sellub-core | Stable | RBAC primitives, channel guards | — |
sellub-api-keys | Stable | Publishable/secret key CRUD, embed sessions | UI for key rotation history |
sellub-pricing-plugin | Stable | OrderFeeBreakdown persistence, plan custom fields | Plan-change audit trail |
sellub-commerce-api-plugin | Stable | Subscriptions, sandbox channels, webhooks (HMAC + retry) | Per-event dead-letter UI |
sellub-event-bridge | Stable | 5 Vendure events forwarded to DPS | Backfill / replay endpoint |
sellub-payment | Stable | Paystack init/verify/webhook | Refund webhook reconciliation (informational only today) |
sellub-external-payments | Stable | Donations, hosted invoices | Saved card support |
sellub-subscriptions | Stable | Paystack subscription create/cancel/status | Mid-cycle plan changes |
sellub-billing | Stable | Operator invoicing of platform fees | Bulk credit-note flow |
sellub-delivery (wrapper) | Stable | Registers delivery-base | Folded into base in v2 of plugin |
sellub-delivery-base | Stable | Local courier method, address validation | Courier-API auth handshake |
sellub-fulfilment | Stable | Fulfilment handler glue | Per-line partial fulfilment |
sellub-freight | Alpha | Plugin scaffold + entity | Quoting engine, partner adapters |
sellub-print | Alpha | Plugin scaffold + product type | POD partner adapter (Printify/Gelato) |
sellub-services | Alpha | Plugin scaffold + bookable product type | Calendar / availability resolver |
sellub-bundles | Alpha | Plugin scaffold | Bundle pricing, inventory rollup |
sellub-social | Alpha | Plugin scaffold | Like/follow stores, feed resolver |
multivendor-plugin | Stable | Channel-per-seller setup, payouts | TS strict-mode pass |
marketplace-shop-plugin | Beta | Cross-channel listing resolver | Faceted search, recommendations |
seller-profile-plugin | Beta | Public profile resolver, admin mutations | Profile media gallery |
admin-customer-plugin | Stable | Admin customer extensions | — |
inventory-sync-plugin | Alpha | Plugin scaffold | Stock sync workers, partner webhooks |
arkesel-sms-plugin | Stable | SMS notifications via Arkesel | — |
How to update this page
When you change a plugin or SDK status:
- Update the row(s) here.
- Update the package’s
README.mdand (for SDKs) itsCHANGELOG.md. - If you ship a new namespace on
sellub-client, also updatesellub-clientdocs. - If you flip an Alpha → Beta, mention it in the next release notes.