How sneadxx/nexus-inventory works
nexus-inventory is a Laravel package for normalizing product and inventory operations across Shopify, WooCommerce, Amazon, and Etsy. The principal workflow exposes channel drivers through Nexus, accepts product stock changes through builders, and dispatches queued inventory pushes; incoming webhooks are verified, parsed, logged, and converted into inventory events. The README also describes catalog syncing, dashboard/log views, and queue-based processing. Some of those runtime links are documented but their implementation was not sampled, so those edges are dashed or omitted.
Main entry points: InventoryManager.php Inventory Manager · Drivers Channel Drivers · PushInventoryJob.php Inventory Push Job · WebhookProcessor.php Webhook Processor
Components 25
Sync API
- Nexus Facade
src/Facades/Nexus.php - Inventory Manager
src/InventoryManager.php - Sync Builders
src/Builders/ProductSyncBuilder.php - Catalog Builder
src/Builders/CatalogSyncBuilder.php - Batch Builder
src/Builders/BatchBuilder.php - Inventory Push Job
src/Jobs/PushInventoryJob.php - Catalog Jobs
src/Jobs/CatalogSyncJob.php - Channel Batch Job
src/Jobs/ChannelSyncBatchJob.php
Sales Channels
- Driver Contract
src/Contracts/InventoryDriver.php - Channel Drivers
src/Drivers - Product DTO
src/DataTransferObjects/NexusProduct.php - Inventory Update
src/DataTransferObjects/NexusInventoryUpdate.php - Channel Mapping
src/Models/ChannelMapping.php
Webhook Intake
- Webhook Controller
src/Http/Controllers/WebhookController.php - Signature Middleware
src/Http/Middleware/VerifyNexusWebhookSignature.php - Webhook Processor
src/Services/WebhookProcessor.php - Channel Verifiers
src/Webhooks/Verifiers - Webhook Log
resources/views/livewire/webhook-log.blade.php
Operations
- Inventory Events
src/Events/InventoryUpdated.php - Token Bucket
src/RateLimiting/TokenBucket.php - Dashboard
src/Http/Controllers/DashboardController.php - Dead Letter Queue
src/Models/NexusDeadLetterQueue.php - Package Wiring
src/NexusServiceProvider.php
Other components
- Package User
- Store Admin
Connections 27
- Package User → Nexus Facade: uses
- Nexus Facade → Inventory Manager: resolves
src/Facades/Nexus.php - Inventory Manager → Channel Drivers: creates
src/InventoryManager.php - Inventory Manager → Catalog Builder: creates
src/InventoryManager.php - Inventory Manager → Sync Builders: creates
src/InventoryManager.php - Inventory Manager → Batch Builder: creates
src/InventoryManager.php - Channel Drivers → Driver Contract: implements
src/Drivers/Amazon/AmazonDriver.php - Channel Drivers → Product DTO: normalizes
src/Drivers/Amazon/AmazonDriver.php - Channel Drivers → Inventory Update: parses
src/Drivers/Amazon/AmazonDriver.php - Sync Builders → Inventory Push Job: dispatches
src/Builders/ProductSyncBuilder.php - Package User → Sync Builders: requests stock sync
- Catalog Builder → Channel Batch Job: dispatches
src/Builders/CatalogSyncBuilder.php - Catalog Builder → Catalog Jobs: queues catalog work
- Inventory Push Job → Channel Mapping: reads mapping
src/Jobs/PushInventoryJob.php - Inventory Push Job → Token Bucket: checks capacity
src/Jobs/PushInventoryJob.php - Inventory Push Job → Inventory Events: dispatches events
src/Jobs/PushInventoryJob.php - Store Admin → Webhook Controller: sends webhook
- Webhook Controller → Signature Middleware: requires verification
src/Http/Controllers/WebhookController.php - Webhook Controller → Webhook Processor: processes request
src/Http/Controllers/WebhookController.php - Signature Middleware → Channel Verifiers: verifies signature
src/Http/Middleware/VerifyNexusWebhookSignature.php - Webhook Processor → Channel Drivers: parses and fetches
src/Services/WebhookProcessor.php - Webhook Processor → Inventory Events: dispatches events
src/Services/WebhookProcessor.php - Webhook Processor → Webhook Log: records activity
- Package Wiring → Webhook Controller: registers route
src/NexusServiceProvider.php - Package Wiring → Dashboard: registers routes
src/NexusServiceProvider.php - Package Wiring → Dead Letter Queue: stores failed jobs
src/NexusServiceProvider.php - Package User → Dashboard: views inventory