@akinon/projectzero 1.93.0 → 1.95.0-rc.54

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @akinon/projectzero
 
+## 1.95.0-rc.54
+
+### Minor Changes
+
+- d8be48fb: ZERO-3422: Update fetch method to use dynamic request method in wallet complete redirection middleware
+- c67942a4: ZERO-3423: Updated version control and debug messages for the package
+- 5de751aa: ZERO-3428 :Add Hepsipay plugin to the list of available plugins
+- 143be2b9: ZERO-3457: Crop styles are customizable and logic improved for rendering similar products modal
+- 16aff543: ZERO-3431: Add test script for redirect utility in package.json
+- 64699d3ff: ZERO-2761: Fix invalid import for plugin module
+- e974d8e8: ZERO-3406: Fix rc build
+- 7eb51ca9: ZERO-3424 :Update package versions
+- 7727ae55: ZERO-3073: Refactor basket page to use server-side data fetching and simplify component structure
+- 8b1d24eb: ZERO-3422: Update fetch method to use dynamic request method in wallet complete redirection middleware
+- 34578efc: ZERO-3419 :Add new payment plugins and update existing ones in the plugin list
+- d99a6a7d: ZERO-3457: Fixed the settings prop and made sure everything is customizable.
+- 33377cfd: ZERO-3267: Refactor import statement for ROUTES in error-page component
+
+## 1.94.0
+
+### Minor Changes
+
+- c806fad: ZERO-3422: Add Flow Payment plugin to the defined plugins list
+- 72ad7bb: ZERO-3422: Add Flow Payment to the list of available plugins
+
 ## 1.93.0
 
 ## 1.92.0
@@ -8,7 +33,161 @@
 
 ### Minor Changes
 
-- 942490f: ZERO-3295: move third party tailwind content list to akinon-next
+- d8be48fb: ZERO-3422: Update fetch method to use dynamic request method in wallet complete redirection middleware
+- c67942a4: ZERO-3423: Updated version control and debug messages for the package
+- 5de751aa: ZERO-3428 :Add Hepsipay plugin to the list of available plugins
+- 143be2b9: ZERO-3457: Crop styles are customizable and logic improved for rendering similar products modal
+- 16aff543: ZERO-3431: Add test script for redirect utility in package.json
+- 64699d3f: ZERO-2761: Fix invalid import for plugin module
+- e974d8e8: ZERO-3406: Fix rc build
+- 7eb51ca9: ZERO-3424 :Update package versions
+- c806fad7: ZERO-3422: Add Flow Payment plugin to the defined plugins list
+- 7727ae55: ZERO-3073: Refactor basket page to use server-side data fetching and simplify component structure
+- 8b1d24eb: ZERO-3422: Update fetch method to use dynamic request method in wallet complete redirection middleware
+- 72ad7bb1: ZERO-3422: Add Flow Payment to the list of available plugins
+- 34578efc: ZERO-3419 :Add new payment plugins and update existing ones in the plugin list
+- d99a6a7d: ZERO-3457: Fixed the settings prop and made sure everything is customizable.
+- 33377cfd: ZERO-3267: Refactor import statement for ROUTES in error-page component
+
+## 1.92.0-rc.41
+
+## 1.92.0-rc.40
+
+## 1.92.0-rc.39
+
+## 1.92.0-rc.38
+
+## 1.92.0-rc.37
+
+## 1.92.0-rc.36
+
+## 1.92.0-rc.35
+
+## 1.92.0-rc.34
+
+## 1.92.0-rc.33
+
+## 1.92.0-rc.32
+
+## 1.92.0-rc.31
+
+## 1.92.0-rc.30
+
+## 1.92.0-rc.29
+
+## 1.92.0-rc.28
+
+## 1.92.0-rc.27
+
+## 1.92.0-rc.26
+
+### Minor Changes
+
+- 16aff54: ZERO-3431: Add test script for redirect utility in package.json
+
+## 1.92.0-rc.25
+
+## 1.92.0-rc.24
+
+## 1.92.0-rc.23
+
+## 1.92.0-rc.22
+
+### Minor Changes
+
+- 143be2b: ZERO-3457: Crop styles are customizable and logic improved for rendering similar products modal
+
+## 1.92.0-rc.21
+
+### Minor Changes
+
+- d99a6a7: ZERO-3457: Fixed the settings prop and made sure everything is customizable.
+
+## 1.92.0-rc.20
+
+### Minor Changes
+
+- 8b1d24e: ZERO-3422: Update fetch method to use dynamic request method in wallet complete redirection middleware
+
+## 1.92.0-rc.19
+
+### Minor Changes
+
+- d8be48f: ZERO-3422: Update fetch method to use dynamic request method in wallet complete redirection middleware
+
+## 1.92.0-rc.18
+
+### Minor Changes
+
+- c67942a: ZERO-3423: Updated version control and debug messages for the package
+
+## 1.92.0-rc.17
+
+## 1.92.0-rc.16
+
+## 1.92.0-rc.15
+
+### Minor Changes
+
+- 5de751aa: ZERO-3428 :Add Hepsipay plugin to the list of available plugins
+
+## 1.92.0-rc.14
+
+## 1.92.0-rc.13
+
+## 1.92.0-rc.12
+
+## 1.92.0-rc.11
+
+## 1.92.0-rc.10
+
+## 1.92.0-rc.9
+
+### Minor Changes
+
+- 72ad7bb: ZERO-3422: Add Flow Payment to the list of available plugins
+
+## 1.92.0-rc.8
+
+### Minor Changes
+
+- c806fad: ZERO-3422: Add Flow Payment plugin to the defined plugins list
+
+## 1.92.0-rc.7
+
+## 1.91.0-rc.6
+
+## 1.91.0-rc.5
+
+## 1.91.0-rc.4
+
+### Minor Changes
+
+- 7eb51ca: ZERO-3424 :Update package versions
+- 34578ef: ZERO-3419 :Add new payment plugins and update existing ones in the plugin list
+
+## 1.91.0-rc.3
+
+### Minor Changes
+
+- 64699d3f: ZERO-2761: Fix invalid import for plugin module
+- e974d8e8: ZERO-3406: Fix rc build
+- 7727ae55: ZERO-3073: Refactor basket page to use server-side data fetching and simplify component structure
+- 33377cfd: ZERO-3267: Refactor import statement for ROUTES in error-page component
+- 942490f2: ZERO-3295: move third party tailwind content list to akinon-next
+
+## 1.91.0-rc.2
+
+## 1.91.0-rc.1
+
+## 1.91.0-rc.0
+
+### Minor Changes
+
+- 64699d3f: ZERO-2761: Fix invalid import for plugin module
+- e974d8e: ZERO-3406: Fix rc build
+- 7727ae55: ZERO-3073: Refactor basket page to use server-side data fetching and simplify component structure
+- 33377cfd: ZERO-3267: Refactor import statement for ROUTES in error-page component
 
 ## 1.90.0
 
@@ -38,9 +217,67 @@
 
 ### Minor Changes
 
-- 7a1e1f7: ZERO-3138: Close the search input with the esc key
-- c82875b: ZERO-3140: Fix style layout size
-- 6c1dba7: ZERO-3174: update hash structure
+- 33377cf: ZERO-3267: Refactor import statement for ROUTES in error-page component
+
+## 1.82.0-rc.18
+
+## 1.82.0-rc.17
+
+### Minor Changes
+
+- e2583ac2: ZERO-3282: Switch to execSync for synchronous execution, enhance file checks, and add error page replacement script
+
+## 1.82.0-rc.16
+
+### Minor Changes
+
+- 64699d3f: ZERO-2761: Fix invalid import for plugin module
+- 7727ae55: ZERO-3073: Refactor basket page to use server-side data fetching and simplify component structure
+
+## 1.82.0-rc.15
+
+## 1.82.0-rc.14
+
+## 1.82.0-rc.13
+
+## 1.82.0-rc.12
+
+## 1.82.0-rc.11
+
+## 1.82.0-rc.10
+
+## 1.82.0-rc.9
+
+## 1.82.0-rc.8
+
+## 1.82.0-rc.7
+
+## 1.82.0-rc.6
+
+## 1.82.0-rc.5
+
+## 1.82.0-rc.4
+
+## 1.82.0-rc.3
+
+## 1.82.0-rc.2
+
+### Minor Changes
+
+- 64699d3f: ZERO-2761: Fix invalid import for plugin module
+- 7727ae55: ZERO-3073: Refactor basket page to use server-side data fetching and simplify component structure
+
+## 1.82.0-rc.1
+
+## 1.82.0-rc.0
+
+### Minor Changes
+
+- 64699d3f: ZERO-2761: Fix invalid import for plugin module
+- 7a1e1f73: ZERO-3138: Close the search input with the esc key
+- 7727ae55: ZERO-3073: Refactor basket page to use server-side data fetching and simplify component structure
+- c82875bc: ZERO-3140: Fix style layout size
+- 6c1dba75: ZERO-3174: update hash structure
 
 ## 1.81.0
 

package/app-template/.env.example

@@ -6,6 +6,7 @@ NEXT_PUBLIC_GTM_KEY=GTM_KEY
 NEXT_PUBLIC_URL=http://localhost:3000
 SERVICE_BACKEND_URL=https://02fde10fee4440269e695aa10707dfaf.lb.akinoncloud.com
 SITEMAP_S3_BUCKET_NAME=0fb534
+NEXT_PUBLIC_ENABLE_IMAGE_SEARCH=true
 
 # LOG_LEVEL_DEV=debug # For more details, please refer to the Logging documentation.
 

package/app-template/.github/instructions/default.instructions.md

@@ -0,0 +1,279 @@
+---
+applyTo: '**'
+---
+
+# Project Zero Next.js App - Developer Instructions
+
+## Project Overview
+
+This is a **standalone Project Zero Next.js application** - a headless e-commerce storefront built on top of Akinon Commerce Cloud. This app can be cloned and run independently using the `packages/projectzero` command line tool.
+
+## Key Characteristics
+
+- **Standalone Application**: Can be cloned with `packages/projectzero` CLI and run independently
+- **Next.js 14.2.25**: Uses App Router with dynamic routes
+- **TypeScript**: With relaxed strict mode
+- **E-commerce Focus**: Complete storefront with basket, checkout, payments, user management
+
+## Project Structure
+
+```
+apps/projectzeronext/
+├── src/
+│   ├── app/[commerce]/[locale]/[currency]/  # App Router pages
+│   ├── components/                          # App-specific UI components
+│   ├── views/                              # Page-specific view components
+│   ├── hooks/                              # Custom React hooks
+│   ├── redux/                              # App-specific Redux slices
+│   ├── types/                              # App-specific TypeScript types
+│   ├── utils/                              # Utility functions
+│   ├── settings.js                         # Application configuration
+│   ├── routes/                             # Route definitions
+│   └── middleware.ts                       # Next.js middleware
+├── public/                                 # Static assets
+├── config/                                 # Configuration files
+├── docs/                                   # Documentation
+├── package.json                            # Dependencies and scripts
+├── next.config.mjs                         # Next.js configuration
+├── tailwind.config.js                      # TailwindCSS configuration
+└── tsconfig.json                           # TypeScript configuration
+```
+
+## Core Dependencies
+
+### Essential Packages
+
+- `@akinon/next`: Core e-commerce functionality (version ^1.93.0)
+- `next`: Next.js framework (14.2.25)
+- `react` & `react-dom`: React framework
+- `@reduxjs/toolkit`: State management
+- `next-auth`: Authentication
+- `react-hook-form`: Form handling
+- `yup`: Form validation
+
+### UI & Styling
+
+- `tailwindcss`: Utility-first CSS framework
+- `clsx` & `tailwind-merge`: Conditional styling
+- `lucide-react`: Icon library
+
+### Plugin Packages
+
+The app includes various `pz-*` plugin packages for extended functionality:
+
+- `pz-akifast`, `pz-b2b`, `pz-basket-gift-pack`
+- `pz-bkm`, `pz-checkout-gift-pack`, `pz-click-collect`
+- Payment providers: `pz-apple-pay`, `pz-gpay`, `pz-masterpass`, etc.
+
+## Architecture Patterns
+
+### Route Structure
+
+- Dynamic routes: `/[commerce]/[locale]/[currency]/`
+- App Router with server and client components
+- Middleware for routing and internationalization
+
+### Data Fetching
+
+- **RTK Query** for API calls
+- Server components for initial data
+- Client components with hooks for interactivity
+- Example patterns:
+
+```tsx
+// Server component data fetching
+const basketData = await getBasket();
+
+// Client component hooks
+const { data: basket } = useGetBasketQuery();
+const [addToBasket] = useAddProductToBasketMutation();
+```
+
+### State Management
+
+- **Redux Toolkit** with key slices:
+  - `checkout`: Multi-step checkout flow
+  - `basket`: Shopping cart state
+  - `header`: Navigation state
+  - `root`: Global app state
+- Use `useAppSelector` and `useAppDispatch`
+
+### Component Architecture
+
+```tsx
+// Theme components (app-specific)
+import { Button, Input } from '@theme/components';
+
+// Core components (from @akinon/next)
+import { Image } from '@akinon/next/components/image';
+
+// Plugin system
+import PluginModule, { Component } from '@akinon/next/components/plugin-module';
+```
+
+### Forms & Validation
+
+Standard pattern with React Hook Form + Yup:
+
+```tsx
+const schema = (t) =>
+  yup.object().shape({
+    email: yup.string().email().required(t('error.required')),
+    password: yup.string().min(6).required(t('error.required'))
+  });
+
+const {
+  register,
+  handleSubmit,
+  formState: { errors }
+} = useForm({
+  resolver: yupResolver(schema(t))
+});
+```
+
+## E-commerce Features
+
+### Core Functionality
+
+- **Product Catalog**: Browse, search, filter products
+- **Basket Management**: Add/remove items, quantity updates
+- **Checkout Flow**: Multi-step process (auth → shipping → payment → confirmation)
+- **User Accounts**: Registration, login, order history
+- **Payment Integration**: Multiple payment providers
+- **Order Management**: Track orders, view history
+
+### Internationalization
+
+- Multi-language support with `useLocalization()` hook
+- Dynamic locale routing: `/[locale]/`
+- Translation keys: `t('checkout.auth.title')`
+- Settings configuration in `src/settings.js`
+
+### Authentication
+
+- NextAuth.js integration
+- Session management with `useSession()`
+- Protected routes via middleware
+- User account features
+
+## Development Guidelines
+
+### File Naming & Structure
+
+- Components: PascalCase (`ProductCard.tsx`)
+- Pages: kebab-case in App Router directories
+- Hooks: camelCase starting with `use` (`useBasket.ts`)
+- Types: PascalCase with descriptive names (`ProductType.ts`)
+
+### Import Conventions
+
+```tsx
+// Path aliases (configured in tsconfig.json)
+import { Button } from '@theme/components'; // App components
+import { Image } from '@akinon/next/components'; // Core components
+import { useLocalization } from '@akinon/next/hooks'; // Core hooks
+import { ProductType } from '@akinon/next/types'; // Core types
+import { routes } from '@root/routes'; // App routes
+```
+
+### Styling Guidelines
+
+- **TailwindCSS** for all styling
+- Use `clsx` and `twMerge` for conditional classes
+- Responsive design: mobile-first approach
+- Theme customization in `tailwind.config.js`
+
+### Performance Best Practices
+
+- Lazy loading with `LazyComponent`
+- Next.js `Image` component for optimized images
+- Code splitting with dynamic imports
+- Intersection Observer for viewport-based loading
+
+## Development Commands
+
+```bash
+# Development
+yarn dev              # Start development server
+yarn build            # Build for production
+yarn start            # Start production server
+
+# Code Quality
+yarn lint             # Run ESLint
+yarn lint:fix         # Fix ESLint issues
+yarn type-check       # TypeScript type checking
+
+# Testing
+yarn test             # Run Jest tests
+yarn test:watch       # Run tests in watch mode
+```
+
+## Configuration Files
+
+### Key Config Files
+
+- `next.config.mjs`: Next.js configuration
+- `tailwind.config.js`: TailwindCSS theme and plugins
+- `src/settings.js`: App-specific settings (commerce, locales, etc.)
+- `src/middleware.ts`: Route handling and internationalization
+- `package.json`: Dependencies and scripts
+
+### Environment Variables
+
+Configure in `.env.local`:
+
+- `NEXTAUTH_SECRET`: Authentication secret
+- `NEXTAUTH_URL`: Application URL
+- Commerce API endpoints
+- Payment provider configurations
+
+## Plugin System
+
+### Using Plugins
+
+```tsx
+import PluginModule, { Component } from '@akinon/next/components/plugin-module';
+
+// Conditional plugin rendering
+<PluginModule component={Component.BasketGiftPack} props={{ basket }} />;
+```
+
+### Available Plugins
+
+- **Payment**: Apple Pay, Google Pay, BKM, Masterpass
+- **Checkout**: Gift packs, click & collect, one-click checkout
+- **Business**: B2B features, multi-basket, saved cards
+- **Regional**: Tabby, Tamara (MENA region)
+
+## Important Notes
+
+### Critical Middleware
+
+- **Never remove** `withPzDefault` middleware - essential for app functionality
+- Middleware handles routing, locale detection, commerce resolution
+
+### State Management
+
+- Checkout uses multi-step Redux flow
+- Basket state syncs with backend APIs
+- User session integrates with NextAuth
+
+### SEO & Analytics
+
+- GTM integration for e-commerce tracking
+- Server-side rendering for SEO
+- Structured data for products
+
+### Deployment
+
+- Can be deployed standalone
+- Supports various hosting platforms
+- Environment-specific configurations
+
+When working with this app, always consider:
+
+1. **E-commerce context**: Every feature impacts the shopping experience
+2. **Plugin architecture**: Use modular approach for features
+3. **Internationalization**: Support multiple languages/regions
+4. **Performance**: Optimize for mobile commerce
+5. **Standalone nature**: App should work independently when cloned