cboxdk/laravel-nexus
| Install | |
|---|---|
composer require cboxdk/laravel-nexus |
|
| Latest Version: | v0.3.0 |
| PHP: | ^8.4 |
| Laravel: | 12 · 13 |
| License: | MIT |
| Last Updated: | Aug 15, 2026 |
| Links: | GitHub · Packagist |
Cbox Nexus
The US economic-nexus engine for Laravel — accumulate a seller's sales per state, detect when a post-Wayfair threshold is crossed, and report where registration is required.
Cbox Nexus is UI-free engine primitives, not a finished application. It owns the
decision logic (below / approaching / triggered / registered per state); the
data — thresholds, the seller's cumulative activity, physical presence, and
existing registrations — is sourced behind contracts. Thresholds ship from the
cited us-tax-data dataset (with each state's measurement period and sales basis);
you bind your own billing data for the rest.
It never accumulates sales itself and never infers nexus from a single invoice — economic nexus turns on the seller's cumulative totals in a state over a measuring period, which the host supplies.
Install
composer require cboxdk/laravel-nexus
Quick use
use Cbox\Nexus\Contracts\NexusEngine;
use Cbox\Geo\ValueObjects\SubdivisionCode;
$report = app(NexusEngine::class)->report([
new SubdivisionCode('US-CA'),
new SubdivisionCode('US-TX'),
]);
foreach ($report->triggered() as $evaluation) {
// $evaluation->state, $evaluation->reason, $evaluation->threshold->describe()
}
Bind a SalesLedger (from your invoices), and optionally PhysicalNexus and
NexusRegistrations, so the engine has the seller's side of the equation.
Documentation
See /docs: the quickstart, the
decision model, and the
data seams you bind.
License
MIT.
Related Packages
Cbox Tax — a self-hostable consumption-tax engine for Laravel: it owns the calcu...
Laravel queue monitoring with individual job tracking, payload storage, replay,...
Extension hooks for a Cbox admin console — nav areas, feature gates, UI slots, d...
Cbox Billing — Stripe payment-gateway adapter: a PaymentGateway implementation b...
Cbox Billing — app-local enforcement SDK: leases allowance from a remote Cbox Bi...
Version History
| Version | Released | PHP | Laravel | License |
|---|---|---|---|---|
| v0.3.0 | ^8.4 | ^12.0 || | MIT | |
| v0.2.1 | ^8.4 | ^12.0 || | MIT | |
| v0.2.0 | ^8.4 | ^12.0 || | MIT | |
| v0.1.1 | ^8.4 | ^12.0 || | MIT | |
| v0.1.0 | ^8.4 | ^12.0 || | MIT |