SDK & Packages
Ecommaps provides a layered package ecosystem:
- Core API SDK:
@ecommaps/client - Commerce logic primitives:
@ecommaps/storefront-kit - Buyer-facing AI runtime + UI:
@ecommaps/ai-sales-agent - MCP CLI bridge:
@ecommaps/mcp
Package Boundaries
| Package | Responsibility | Runtime |
|---|---|---|
@ecommaps/client | Typed access to storefront APIs | Node/Edge/Browser |
@ecommaps/storefront-kit | Variant resolution, normalization, promotion logic | Node/Edge |
@ecommaps/ai-sales-agent | Sales-agent server factories + React components | Node + React |
@ecommaps/mcp | MCP bridge CLI | Node CLI |
Live Versions & Compatibility
| Package | Latest | npm | Repository |
|---|---|---|---|
| @ecommaps/client | 1.4.1 | Version history | GitHub |
| @ecommaps/storefront-kit | 0.1.0 | Version history | GitHub |
| @ecommaps/ai-sales-agent | 0.1.0 | Version history | GitHub |
| @ecommaps/mcp | 1.0.10 | Version history | - |
| Capability | Baseline |
|---|---|
| Node runtime | 20+ |
| AI SDK requirement (ai-sales-agent) | AI SDK v6-compatible runtime |
| Package compatibility baseline | @ecommaps/client 1.4.x + storefront-kit 0.1.x + ai-sales-agent 0.1.x |
| React peer range (ai-sales-agent/react) | React 18 or 19 |
Metadata source: npm registry API. Generated: fallback