SellubSDKsOverview

Sellub SDKs

Public, framework-agnostic packages on npm for building on top of the Sellub commerce platform — payments, subscriptions, invoices, catalog, embeds and webhooks.

All packages are published under the @duabalabs/ npm scope and are MIT licensed. Source lives in packages/ in the monorepo.

Pick the right SDK

You want to…Reach for
Take a one-off payment from a Next.js / React appsellub-client + sellub-react
Take a one-off payment from a React Native appsellub-client + sellub-react-native
Drop a “Sellub storefront” into any HTML pagesellub-embed
Verify an inbound Sellub webhooksellub-webhooks
Quote commission/processor fees in your UIsellub-pricing
Call the Sellub API from a CLI script / CIsellub-cli
Share the Sellub money/order types in your TS codesellub-types

Packages

Server- and browser-safe TS client for ExternalPayments, Subscriptions and Invoices. The “money layer” SDK.

sellub-client

Shared TypeScript types: Money, OrderRef, Subscription, ApiResult. Zero runtime dependencies.

sellub-types

Pure-TS pricing engine: plan catalog, commission rates, attribution-aware fee calculator, currency formatters.

sellub-pricing

HMAC-SHA256 sign + verify helpers and a fetch-based dispatcher. Used by both Sellub server and your integration.

sellub-webhooks

React hooks (currently useSubscription). Pairs with sellub-client.

sellub-react

React Native hooks. Same surface as sellub-react, plus mobile-specific primitives (offline cache landing in v0.2).

sellub-react-native

<script src=…> storefront embed. One function call mounts a Sellub catalog/checkout into any HTML page.

sellub-embed

sellub command-line tool for operators (channel listings, catalog imports, subscription checks).

sellub-cli

Versioning

  • Packages are versioned independently with semver.
  • Anything below 1.0.0 may break between minor versions; pin exact versions in production until a package hits 1.x.
  • Breaking changes are listed in the package’s CHANGELOG (root of each package directory).

Status snapshot

See Package status for the live readiness matrix and migration notes.

Internal-only packages (deprecated)

The 16 @duabalabs/sellub-vendure-* packages were deprecated on npm and deleted from GitHub as of 2026-05-11. They were broken source-only mirrors of the Sellub server’s internal Vendure plugins and were never intended for public consumption. Use the SDKs above instead — they cover every supported integration surface.

API referencesellub-client