Download the PHP package malikad778/laravel-nexus without Composer

Nexus Inventory

A unified, driver-based Laravel package for synchronizing products and inventory across multiple e-commerce channels — Shopify, WooCommerce, Amazon SP-API, and Etsy.

Nexus Inventory is not a SaaS platform. It is a drop-in Composer package that lives inside your Laravel application, giving you full code-level control over every sync, every webhook, and every rate limit — for free.

Why Nexus Inventory?

The multi-channel commerce problem is real and expensive. When a product sells on Amazon, your Shopify stock must decrement in seconds — not minutes. Every channel has its own API, its own authentication scheme, its own rate limits, and its own webhook signature format. Solving this from scratch takes months.

The existing options leave developers stuck:

Nexus Inventory fills the gap. It provides a production-grade, extensible foundation — a unified driver interface, a fluent API, distributed rate limiting, secure webhook handling, job batching, and a real-time dashboard — all installable in minutes via Composer.

Features

🔌 Driver-Based Architecture

Every channel implements the same InventoryDriver interface. Your application code never touches a channel SDK directly. Add support for a new channel (eBay, TikTok Shop, Walmart) by implementing one interface and registering one class — zero changes to the core.

🔄 Fluent Sync API

A clean, chainable builder API for common sync operations:

⚡ Distributed Rate Limiting

Each channel enforces API rate limits at the key level — not the server level. Run 10 queue workers and a naive implementation blows through your API quota in seconds. Nexus solves this with a Token Bucket algorithm backed by atomic Redis Lua scripting, race-condition-free across any number of concurrent workers.

📦 Three-Layer Job Architecture

Syncing 10,000 SKUs across 4 channels means 40,000 API calls. Nexus handles this with a structured job hierarchy using Laravel's Bus::batch():

• CatalogSyncJob — Orchestrator. Partitions the catalog, creates the batch, registers then() and catch() callbacks.
• ChannelSyncBatchJob — Channel executor. Acquires rate limit tokens, dispatches push jobs, fires lifecycle events.
• PushInventoryJob — Atomic unit per SKU/channel pair. Implements ShouldBeUnique to prevent duplicate in-flight jobs.

🔒 Secure Unified Webhook Receiver

A single route handles all four channels. Every request is cryptographically verified before processing:

• Shopify — X-Shopify-Hmac-Sha256 — HMAC-SHA256 (base64)
• WooCommerce — X-WC-Webhook-Signature — HMAC-SHA256 (base64)
• Amazon — X-AMZ-SNS-Signature — RSA-SHA1 via AWS SNS (certificate downloaded, domain-validated, cached)
• Etsy — X-Etsy-Signature — HMAC-SHA256 (hex)

📡 Standardized Event System

Once a webhook is verified, a single InventoryUpdated event fires — regardless of which channel triggered it. Write one listener to handle all channels:

Full lifecycle hooks at every stage of the pipeline:

🗄️ Polymorphic Channel Mapping

Any Eloquent model becomes syncable with one trait — no schema changes to your existing tables:

The nexus_channel_mappings table stores each channel's remote ID against your local model using a polymorphic relationship with a composite unique index, preventing duplicate mappings.

💀 Dead Letter Queue

Jobs that exhaust all retries are written to nexus_dead_letter_queue with their full serialized payload and exception detail. No silent failures. From the dashboard you can replay individual jobs or bulk-replay after an API outage — no artisan required.

📊 Real-Time Livewire Dashboard

A Livewire 3 dashboard at /nexus with wire:poll.3s real-time updates:

• Channel Status Cards — Connected / Throttled / Disconnected, with live token bucket fill level per channel
• Sync Job Monitor — Active Bus::batch() instances with per-job progress
• Webhook Event Log — Paginated, searchable log of every inbound webhook with verification status and processing duration
• Dead Letter Queue Manager — Replay or resolve failed jobs with one click
• Real-Time Alerts — ChannelThrottled broadcasts via Laravel Reverb when rate limiting is detected

🔧 Extensible Driver System

Register community-contributed or internal channel drivers without touching the package core:

🧩 Normalized Product DTOs

Channel-specific product structures are normalized into a single NexusProduct DTO, eliminating transformation logic from your application:

The channelMeta field preserves the raw channel payload so channel-specific data (Amazon FBA routing, Etsy listing state) is never permanently discarded.

Requirements

• PHP 8.2+
• Laravel 12+
• Redis (for rate limiting and queues)
• MySQL 8+ or PostgreSQL

Installation

Publish the config file and migrations:

Configuration

Add channel credentials to your .env:

See config/nexus.php for rate limit overrides, dashboard middleware, and queue configuration.

Usage

Sync a Single Product

Bulk Catalog Sync

Access Drivers Directly

Listen to Events

Make Your Model Syncable

Dashboard

Visit /nexus. Secure it in config/nexus.php:

Queue Workers

Architecture Overview

Database Tables

Testing

Changelog

Please see CHANGELOG for recent changes.

License

The MIT License (MIT). Please see License File for more information.