hey-pharmacist-ecommerce 1.0.6 → 1.0.7

package/README.md

@@ -1,16 +1,17 @@
-# Hey Pharmacist E-commerce Package
+# Hey Pharmacist E‑commerce
 
-A multi-tenant e-commerce package for Next.js applications with stunning design and full functionality.
+Production‑ready, multi‑tenant e‑commerce UI + API adapter for Next.js. It ships with end‑to‑end flows (browse, cart, checkout, orders), robust authentication, typed SDKs, and a polished pharmacist‑grade UX. Drop it into a Next.js app, point it at your API, and ship a beautiful store in hours—not weeks.
 
-## Features
+## Highlights
 
-- 🛒 **Complete E-commerce Flow**: Shop, cart, checkout, orders
-- 🎨 **Stunning Design**: Modern UI with smooth animations
-- 🔐 **Authentication**: Login, register, profile management
-- 💳 **Stripe Integration**: Secure payment processing
-- 🏪 **Multi-tenant**: Single package, multiple stores
-- 📱 **Responsive**: Works on all devices
-- ⚡ **Fast**: Optimized for performance
+- 🛒 **Complete flows**: Shop, product details, wishlist, cart, checkout, orders (history + current)
+- 🔐 **Auth built‑in**: Sign up/in, profile, token persistence, background rehydration
+- 💳 **Payments**: Card/Cash/Credit modes; Stripe‑ready checkout handoff
+- 🧩 **Typed API adapters**: Generated axios SDK under `src/lib/Apis` with bearer + store key headers
+- 🎨 **Themeable**: Brand colors + configurable header gradient via `EcommerceConfig`
+- 🧠 **Smart UX**: Skeletons, optimistic UI, searchable overflow filters, and mobile‑first layouts
+- 🧱 **Composable**: Use our screens, or import atomic components and hooks
+- ⚡ **Production‑grade**: Tree‑shakable build, types, sourcemaps, React 18, Next 14
 
 ## Installation
 
@@ -20,7 +21,7 @@ npm install hey-pharmacist-ecommerce react-hook-form @hookform/resolvers
 
 ## Quick Start
 
-### 1. Configure Your Store
+### 1) Configure your store
 
 Create a config file for your store:
 
@@ -40,7 +41,7 @@ export const ecommerceConfig = {
 };
 ```
 
-### 2. Wrap Your App
+### 2) Wrap your app
 
 ```tsx
 // app/layout.tsx
@@ -64,7 +65,7 @@ export default function RootLayout({
 }
 ```
 
-### 3. Use the Screens
+### 3) Use the screens
 
 ```tsx
 // app/shop/page.tsx
@@ -75,7 +76,7 @@ export default function ShopPage() {
 }
 ```
 
-## Available Screens
+## Available screens
 
 - `<ShopScreen />` - Product listing with filters
 - `<ProductDetailScreen />` - Individual product page
@@ -87,9 +88,26 @@ export default function ShopPage() {
 - `<OrdersScreen />` - Order history
 - `<CurrentOrdersScreen />` - Active orders
 
-## Customization
+## Theming and customization
 
-The package uses CSS variables for theming. Your colors are automatically applied throughout the interface.
+The package exposes CSS variables for theme colors and a dynamic header gradient. Update via `EcommerceConfig`:
+
+```ts
+headerGradient?: { from: string; via: string; to: string } // hex colors
+```
+
+Under the hood, `ThemeProvider` sets `--color-<brand>-<shade>` and:
+
+```css
+from: rgb(var(--header-from));
+via:  rgb(var(--header-via));
+to:   rgb(var(--header-to));
+```
+
+Update colors/gradient at runtime and the UI updates automatically.
+
+### Using individual components
+You can import components like `Header`, `Footer`, `ProductCard`, `OrderCard`, and UI primitives (`Button`, `Input`, `Modal`, etc.) for bespoke pages.
 
 ## Requirements
 
@@ -97,9 +115,19 @@ The package uses CSS variables for theming. Your colors are automatically applie
 - Next.js 14+
 - react-hook-form 7+
 
-## Local Development & Testing
+## Architecture
+
+- Screens (page‑level flows) under `src/screens`
+- Providers for Auth, Cart, Wishlist, Theme under `src/providers`
+- Hooks for products, orders, wishlist, addresses under `src/hooks`
+- Generated API SDK under `src/lib/Apis` (axios + typed models)
+- API adapter bridge under `src/lib/api-adapter`
+
+Auth persists access token using `localStorage` and rehydrates on load. Requests attach `x-store-key` and `Authorization: Bearer` automatically.
 
-### Testing Locally Before Publishing
+## Local development & testing
+
+### Testing locally before publishing
 
 You can test the package locally in your frontend project using npm link:
 
@@ -203,6 +231,12 @@ npm version patch  # or minor, or major
 npm publish
 ```
 
+## Troubleshooting
+
+- Types not emitted: ensure `tsup` dts is enabled and `tsconfig` does not use incremental for dts build.
+- 401 after refresh: confirm `AuthProvider` calls `setAuthToken` on login/register and that `initializeApiAdapter` runs at app boot.
+- Filters not working server‑side: pass `orderStatus` and `paymentStatus` to `useOrders` to forward to `getAllOrders`.
+
 ## License
 
-MIT# hey-pharmacist-customer
+MIT

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hey-pharmacist-ecommerce",
-  "version": "1.0.6",
-  "description": "Multi-tenant e-commerce package for Next.js",
+  "version": "1.0.7",
+  "description": "Production-ready, multi-tenant e‑commerce UI + API adapter for Next.js with auth, carts, checkout, orders, theming, and pharmacist-focused UX.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",