@akinon/projectzero 1.92.0-rc.15 → 1.92.0-rc.16

package/CHANGELOG.md

@@ -1,5 +1,7 @@
 # @akinon/projectzero
 
+## 1.92.0-rc.16
+
 ## 1.92.0-rc.15
 
 ### Minor Changes

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/CHANGELOG.md

@@ -1,5 +1,37 @@
 # projectzeronext
 
+## 1.92.0-rc.16
+
+### Minor Changes
+
+- 1a8622a9: ZERO-3392: Implemented AI Search functionality and update env
+- b55acb76: ZERO-2577: Fix pagination bug and update usePagination hook and ensure pagination controls rendering correctly
+- 9f8cd3b: ZERO-3449: AI Search Active Filters & Crop Style changes have been implemented
+- b05c3543: ZERO-2570: Category filters routes to absolute url
+
+### Patch Changes
+
+- Updated dependencies [b55acb76]
+- Updated dependencies [9f8cd3b]
+- Updated dependencies [4de5303c]
+  - @akinon/next@1.92.0-rc.16
+  - @akinon/pz-akifast@1.92.0-rc.16
+  - @akinon/pz-b2b@1.92.0-rc.16
+  - @akinon/pz-basket-gift-pack@1.92.0-rc.16
+  - @akinon/pz-bkm@1.92.0-rc.16
+  - @akinon/pz-checkout-gift-pack@1.92.0-rc.16
+  - @akinon/pz-click-collect@1.92.0-rc.16
+  - @akinon/pz-credit-payment@1.92.0-rc.16
+  - @akinon/pz-gpay@1.92.0-rc.16
+  - @akinon/pz-hepsipay@1.92.0-rc.16
+  - @akinon/pz-masterpass@1.92.0-rc.16
+  - @akinon/pz-one-click-checkout@1.92.0-rc.16
+  - @akinon/pz-otp@1.92.0-rc.16
+  - @akinon/pz-pay-on-delivery@1.92.0-rc.16
+  - @akinon/pz-saved-card@1.92.0-rc.16
+  - @akinon/pz-tabby-extension@1.92.0-rc.16
+  - @akinon/pz-tamara-extension@1.92.0-rc.16
+
 ## 1.92.0-rc.15
 
 ### Patch Changes

package/app-template/README.md

@@ -12,6 +12,30 @@ Run `cp .env.example .env && yarn` command at project root and all dependencies
 
 - `SITEMAP_S3_BUCKET_NAME`: S3 bucket name for XML sitemaps (e.g., "0fb534"). This is required for the sitemap route to function correctly.
 
+### Optional Environment Variables
+
+- `NEXT_PUBLIC_ENABLE_IMAGE_SEARCH`: Set to `true` to enable image search feature for all users. If not set or `false`, the feature will only be visible to users who have enabled it via localStorage.
+
+## Image Search Feature
+
+The image search functionality allows users to search for similar products by uploading images or cropping existing product images.
+
+### Feature Visibility Control
+
+The image search feature can be controlled in two ways:
+
+1. **Environment Variable (Global)**: Set `NEXT_PUBLIC_ENABLE_IMAGE_SEARCH=true` to enable for all users
+2. **localStorage (Individual Users)**: Users can enable it locally using browser developer tools
+
+````
+
+### Feature Locations
+
+When enabled, the image search feature appears in:
+
+- **Header Search**: Camera icon next to the search input
+- **Product Detail Page**: "View Similar Styles" button on product images
+
 ### Build
 
 To build the app, run the following command:
@@ -19,7 +43,7 @@ To build the app, run the following command:
 ```bash
 cd projectzeronext # Project root
 yarn build
-```
+````
 
 ### Develop
 

package/app-template/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectzeronext",
-  "version": "1.92.0-rc.15",
+  "version": "1.92.0-rc.16",
   "private": true,
   "license": "MIT",
   "scripts": {
@@ -24,23 +24,23 @@
     "test:middleware": "jest middleware-matcher.test.ts --bail"
   },
   "dependencies": {
-    "@akinon/next": "1.92.0-rc.15",
-    "@akinon/pz-akifast": "1.92.0-rc.15",
-    "@akinon/pz-b2b": "1.92.0-rc.15",
-    "@akinon/pz-basket-gift-pack": "1.92.0-rc.15",
-    "@akinon/pz-bkm": "1.92.0-rc.15",
-    "@akinon/pz-checkout-gift-pack": "1.92.0-rc.15",
-    "@akinon/pz-click-collect": "1.92.0-rc.15",
-    "@akinon/pz-credit-payment": "1.92.0-rc.15",
-    "@akinon/pz-gpay": "1.92.0-rc.15",
-    "@akinon/pz-hepsipay": "1.92.0-rc.15",
-    "@akinon/pz-masterpass": "1.92.0-rc.15",
-    "@akinon/pz-one-click-checkout": "1.92.0-rc.15",
-    "@akinon/pz-otp": "1.92.0-rc.15",
-    "@akinon/pz-pay-on-delivery": "1.92.0-rc.15",
-    "@akinon/pz-saved-card": "1.92.0-rc.15",
-    "@akinon/pz-tabby-extension": "1.92.0-rc.15",
-    "@akinon/pz-tamara-extension": "1.92.0-rc.15",
+    "@akinon/next": "1.92.0-rc.16",
+    "@akinon/pz-akifast": "1.92.0-rc.16",
+    "@akinon/pz-b2b": "1.92.0-rc.16",
+    "@akinon/pz-basket-gift-pack": "1.92.0-rc.16",
+    "@akinon/pz-bkm": "1.92.0-rc.16",
+    "@akinon/pz-checkout-gift-pack": "1.92.0-rc.16",
+    "@akinon/pz-click-collect": "1.92.0-rc.16",
+    "@akinon/pz-credit-payment": "1.92.0-rc.16",
+    "@akinon/pz-gpay": "1.92.0-rc.16",
+    "@akinon/pz-hepsipay": "1.92.0-rc.16",
+    "@akinon/pz-masterpass": "1.92.0-rc.16",
+    "@akinon/pz-one-click-checkout": "1.92.0-rc.16",
+    "@akinon/pz-otp": "1.92.0-rc.16",
+    "@akinon/pz-pay-on-delivery": "1.92.0-rc.16",
+    "@akinon/pz-saved-card": "1.92.0-rc.16",
+    "@akinon/pz-tabby-extension": "1.92.0-rc.16",
+    "@akinon/pz-tamara-extension": "1.92.0-rc.16",
     "@hookform/resolvers": "2.9.0",
     "@next/third-parties": "14.1.0",
     "@react-google-maps/api": "2.17.1",
@@ -63,7 +63,7 @@
     "yup": "0.32.11"
   },
   "devDependencies": {
-    "@akinon/eslint-plugin-projectzero": "1.92.0-rc.15",
+    "@akinon/eslint-plugin-projectzero": "1.92.0-rc.16",
     "@semantic-release/changelog": "6.0.2",
     "@semantic-release/exec": "6.0.3",
     "@semantic-release/git": "10.0.1",

package/app-template/public/locales/en/common.json

@@ -27,7 +27,25 @@
     "clean": "clean",
     "categories": "CATEGORIES",
     "view_all": "VIEW ALL",
-    "not_found": "Search Results Not Found"
+    "not_found": "Search Results Not Found",
+    "image_search": {
+      "title": "Search by Image",
+      "upload_image": "Upload an image to find similar products",
+      "select_image": "Select Image",
+      "crop_image": "Crop Image",
+      "cancel_crop": "Cancel Crop",
+      "apply_crop": "Apply Crop",
+      "try_another": "Try Another Image",
+      "search_image": "Search Image",
+      "similar_products": "Similar Products",
+      "loading_cropper": "Loading cropper...",
+      "no_products": "No similar products found",
+      "best_results": "For best results:",
+      "tip_1": "Upload clear images of products",
+      "tip_2": "Use images with simple backgrounds",
+      "tip_3": "Focus on the main product",
+      "tip_4": "Use the crop tool to focus on specific details"
+    }
   },
   "page_404": {
     "title": "Page not found.",
@@ -71,5 +89,28 @@
   "file_input": {
     "select_file": "Select File",
     "no_file": "No file selected"
+  },
+  "product": {
+    "no_products": "No products found",
+    "new_image": "New Image",
+    "view_similar_styles": "View Similar Styles",
+    "clear_all_filters": "Clear All Filters",
+    "reset_to_original": "Reset to Original",
+    "similar_styles": "Similar Styles",
+    "filters": "Filters",
+    "active_filters": "Active Filters"
+  },
+  "similar_products": {
+    "errors": {
+      "file_size_too_large": "Image size should be less than 5MB",
+      "invalid_image_file": "The selected file is not a valid image",
+      "invalid_image_format": "Invalid image format detected",
+      "search_failed": "Search failed. Please try again later",
+      "connection_failed": "Image search failed. Please check your connection and try again",
+      "invalid_image_properties": "Invalid image properties detected",
+      "file_read_error": "Error reading the file",
+      "processing_error": "Error processing image",
+      "crop_processing_error": "Error processing cropped image"
+    }
   }
 }

package/app-template/public/locales/tr/common.json

@@ -27,7 +27,25 @@
     "clean": "temizle",
     "categories": "KATEGORİLER",
     "view_all": "HEPSİNİ GÖSTER",
-    "not_found": "Arama Sonuçları Bulunamadı"
+    "not_found": "Arama Sonuçları Bulunamadı",
+    "image_search": {
+      "title": "Görsel ile Ara",
+      "upload_image": "Benzer ürünleri bulmak için bir görsel yükleyin",
+      "select_image": "Görsel Seç",
+      "crop_image": "Görsel Kırp",
+      "cancel_crop": "Kırpmayı İptal Et",
+      "apply_crop": "Kırpmayı Uygula",
+      "try_another": "Başka Görsel Dene",
+      "search_image": "Arama Görseli",
+      "similar_products": "Benzer Ürünler",
+      "loading_cropper": "Kırpıcı yükleniyor...",
+      "no_products": "Benzer ürün bulunamadı",
+      "best_results": "En iyi sonuçlar için:",
+      "tip_1": "Net ürün görselleri yükleyin",
+      "tip_2": "Basit arka planlı görseller kullanın",
+      "tip_3": "Ana ürüne odaklanın",
+      "tip_4": "Belirli detaylara odaklanmak için kırpma aracını kullanın"
+    }
   },
   "page_404": {
     "title": "Sayfa bulunamadı.",
@@ -71,5 +89,28 @@
   "file_input": {
     "select_file": "Dosya Seç",
     "no_file": "Dosya seçilmedi"
+  },
+  "product": {
+    "no_products": "Ürün bulunamadı",
+    "new_image": "Yeni Görsel",
+    "view_similar_styles": "Benzer Stillere Göz At",
+    "clear_all_filters": "Tüm Filtreleri Temizle",
+    "reset_to_original": "Orjinale Dön",
+    "similar_styles": "Benzer Stillere Göz At",
+    "filters": "Filtreler",
+    "active_filters": "Aktif Filtreler"
+  },
+  "similar_products": {
+    "errors": {
+      "file_size_too_large": "Görsel boyutu 5MB'dan küçük olmalıdır",
+      "invalid_image_file": "Seçilen dosya geçerli bir görsel değil",
+      "invalid_image_format": "Geçersiz görsel formatı tespit edildi",
+      "search_failed": "Arama başarısız oldu. Lütfen daha sonra tekrar deneyin",
+      "connection_failed": "Görsel arama başarısız oldu. Lütfen bağlantınızı kontrol edip tekrar deneyin",
+      "invalid_image_properties": "Geçersiz görsel özellikleri tespit edildi",
+      "file_read_error": "Dosya okuma hatası",
+      "processing_error": "Görsel işleme hatası",
+      "crop_processing_error": "Kırpılan görsel işleme hatası"
+    }
   }
 }

package/app-template/src/app/api/image-proxy/route.ts

@@ -0,0 +1 @@
+export * from '@akinon/next/api/image-proxy';

package/app-template/src/app/api/similar-product-list/route.ts

@@ -0,0 +1 @@
+export * from '@akinon/next/api/similar-product-list';

package/app-template/src/app/api/similar-products/route.ts

@@ -0,0 +1 @@
+export * from '@akinon/next/api/similar-products';

package/app-template/src/hooks/index.ts

@@ -1 +1,3 @@
+export * from './use-contract';
+export * from './use-fav-button';
 export * from './use-add-product-to-basket';

package/app-template/src/plugins.js

@@ -15,5 +15,6 @@ module.exports = [
   'pz-saved-card',
   'pz-tabby-extension',
   'pz-tamara-extension',
-  'pz-hepsipay'
+  'pz-hepsipay',
+  'pz-similar-products'
 ];

package/app-template/src/views/header/search/index.tsx

@@ -4,11 +4,11 @@ import { useEffect, useRef, useState } from 'react';
 import { useAppDispatch, useAppSelector } from '@akinon/next/redux/hooks';
 import { closeSearch } from '@akinon/next/redux/reducers/header';
 import clsx from 'clsx';
-
-import { Icon } from '@theme/components';
+import { Icon, Input } from '@theme/components';
 import Results from './results';
 import { ROUTES } from '@theme/routes';
 import { useLocalization, useRouter } from '@akinon/next/hooks';
+import PluginModule, { Component } from '@akinon/next/components/plugin-module';
 
 export default function Search() {
   const { t } = useLocalization();
@@ -41,6 +41,14 @@ export default function Search() {
     };
   }, [isSearchOpen, dispatch]);
 
+  const handleSearchTextChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+    setSearchText(e.target.value);
+  };
+
+  const handleCloseSearch = () => {
+    dispatch(closeSearch());
+  };
+
   return (
     <>
       <div
@@ -66,9 +74,9 @@ export default function Search() {
               {t('common.search.results_for')}
             </span>
             <div className="flex items-center">
-              <input
+              <Input
                 value={searchText}
-                onChange={(e) => setSearchText(e.target.value)}
+                onChange={handleSearchTextChange}
                 onKeyDown={(e) => {
                   if (e.key === 'Enter' && searchText.trim() !== '') {
                     router.push(`${ROUTES.LIST}/?search_text=${searchText}`);
@@ -78,14 +86,21 @@ export default function Search() {
                 placeholder={t('common.search.placeholder')}
                 ref={inputRef}
               />
+
+              <PluginModule
+                component={Component.HeaderImageSearchFeature}
+                props={{}}
+              />
+
               <Icon
                 name="close"
                 size={14}
-                onClick={() => dispatch(closeSearch())}
+                onClick={handleCloseSearch}
                 className="cursor-pointer"
               />
             </div>
           </div>
+
           <Results searchText={searchText} />
         </div>
       </div>

package/app-template/src/views/product/slider.tsx

@@ -7,6 +7,7 @@ import { Product } from '@akinon/next/types';
 import { Image } from '@akinon/next/components/image';
 import useFavButton from '../../hooks/use-fav-button';
 import { twMerge } from 'tailwind-merge';
+import PluginModule, { Component } from '@akinon/next/components/plugin-module';
 
 type ProductSliderItem = {
   product: Product;
@@ -35,90 +36,102 @@ export default function ProductInfoSlider({ product }: ProductSliderItem) {
     carouselRef.current?.next();
   };
 
-  const handleThumbnailClick = (index) => {
+  const handleThumbnailClick = (index: number) => {
     setActiveIndex(index);
     carouselRef.current?.goToSlide(index);
   };
 
   return (
-    <div className="lg:grid lg:grid-cols-6">
-      <div className="lg:col-span-1">
-        <div className="flex flex-col items-center justify-center md:mr-[6px]">
-          <button
-            onClick={goToPrev}
-            className={twMerge(
-              'hidden justify-center p-2 mb-3 border border-gray-100 rounded-full cursor-pointer lg:block',
-              [activeIndex === 0 && 'cursor-not-allowed opacity-45']
-            )}
-            disabled={activeIndex === 0}
+    <>
+      <div className="lg:grid lg:grid-cols-6">
+        <div className="lg:col-span-1">
+          <div className="flex flex-col items-center justify-center md:mr-[6px]">
+            <button
+              onClick={goToPrev}
+              className={twMerge(
+                'hidden justify-center p-2 mb-3 border border-gray-100 rounded-full cursor-pointer lg:block',
+                [activeIndex === 0 && 'cursor-not-allowed opacity-45']
+              )}
+              disabled={activeIndex === 0}
+            >
+              <Icon name="chevron-up" size={15} className="fill-[#000000]" />
+            </button>
+            <div className="hidden flex-col items-center overflow-scroll w-[80px] max-h-[620px] lg:block">
+              {product?.productimage_set?.map((item, index) => (
+                <Image
+                  key={index}
+                  src={item.image}
+                  alt={`Thumbnail ${index}`}
+                  width={80}
+                  height={128}
+                  aspectRatio={80 / 128}
+                  className={twMerge('cursor-pointer', [
+                    activeIndex === index && 'border-2 border-primary'
+                  ])}
+                  onClick={() => handleThumbnailClick(index)}
+                />
+              ))}
+            </div>
+            <button
+              onClick={goToNext}
+              className={twMerge(
+                'hidden justify-center p-2 mt-3 border border-gray-100 rounded-full cursor-pointer lg:block',
+                [
+                  activeIndex === product.productimage_set.length - 1 &&
+                    'cursor-not-allowed opacity-45'
+                ]
+              )}
+              disabled={activeIndex === product.productimage_set.length - 1}
+            >
+              <Icon name="chevron-down" size={15} className="fill-[#000000]" />
+            </button>
+          </div>
+        </div>
+
+        <div className="relative lg:col-span-5">
+          <FavButton className="absolute right-8 top-6 z-[20] sm:hidden" />
+
+          <PluginModule
+            component={Component.ProductImageSearchFeature}
+            props={{
+              product,
+              activeIndex,
+              showResetButton: true
+            }}
+          />
+
+          <CarouselCore
+            responsive={{
+              all: {
+                breakpoint: { max: 5000, min: 0 },
+                items: 1
+              }
+            }}
+            arrows={false}
+            swipeable={true}
+            ref={carouselRef}
+            afterChange={(previousSlide, { currentSlide }) => {
+              setActiveIndex(currentSlide);
+            }}
+            containerAspectRatio={{ mobile: 520 / 798, desktop: 484 / 726 }}
           >
-            <Icon name="chevron-up" size={15} className="fill-[#000000]" />
-          </button>
-          <div className="hidden flex-col items-center overflow-scroll w-[80px] max-h-[620px] lg:block">
-            {product?.productimage_set?.map((item, index) => (
+            {product?.productimage_set?.map((item, i) => (
               <Image
-                key={index}
+                key={i}
                 src={item.image}
-                alt={`Thumbnail ${index}`}
-                width={80}
-                height={128}
-                className={twMerge('cursor-pointer', [
-                  activeIndex === index && 'border-2 border-primary'
-                ])}
-                onClick={() => handleThumbnailClick(index)}
+                alt={product?.name || 'Product image'}
+                draggable={false}
+                aspectRatio={484 / 726}
+                sizes="(min-width: 425px) 512px,
+              (min-width: 601px) 576px,
+              (min-width: 768px) 336px,
+              (min-width: 1024px) 484px, 368px"
+                fill
               />
             ))}
-          </div>
-          <button
-            onClick={goToNext}
-            className={twMerge(
-              'hidden justify-center p-2 mt-3 border border-gray-100 rounded-full cursor-pointer lg:block',
-              [
-                activeIndex === product.productimage_set.length - 1 &&
-                  'cursor-not-allowed opacity-45'
-              ]
-            )}
-            disabled={activeIndex === product.productimage_set.length - 1}
-          >
-            <Icon name="chevron-down" size={15} className="fill-[#000000]" />
-          </button>
+          </CarouselCore>
         </div>
       </div>
-
-      <div className="relative lg:col-span-5">
-        <FavButton className="absolute right-8 top-6 z-[20] sm:hidden" />
-
-        <CarouselCore
-          responsive={{
-            all: {
-              breakpoint: { max: 5000, min: 0 },
-              items: 1
-            }
-          }}
-          arrows={false}
-          swipeable={true}
-          ref={carouselRef}
-          afterChange={(previousSlide, { currentSlide }) => {
-            setActiveIndex(currentSlide);
-          }}
-          containerAspectRatio={{ mobile: 520 / 798, desktop: 484 / 726 }}
-        >
-          {product?.productimage_set?.map((item, i) => (
-            <Image
-              key={i}
-              src={item.image}
-              alt={product.name}
-              draggable={false}
-              aspectRatio={484 / 726}
-              sizes="(min-width: 425px) 512px,
-            (min-width: 601px) 576px,
-            (min-width: 768px) 336px,
-            (min-width: 1024px) 484px, 368px"
-              fill
-            />
-          ))}
-        </CarouselCore>
-      </div>
-    </div>
+    </>
   );
 }

package/commands/plugins.ts

@@ -144,6 +144,10 @@ export default async () => {
     {
       name: 'Hepsipay',
       value: 'pz-hepsipay'
+    },
+    {
+      name: 'Similar Products',
+      value: 'pz-similar-products'
     }
   ];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akinon/projectzero",
-  "version": "1.92.0-rc.15",
+  "version": "1.92.0-rc.16",
   "private": false,
   "description": "CLI tool to manage your Project Zero Next project",
   "bin": {