Autocomplete

interface AutocompleteProductsRequest {
  input: string;
  locale?: string;
  currency?: string;
  pageable?: Pageable;
  aggregation?: AggregationType;
  productTags?: string[];
}

interface Pageable {
  page?: number;
  size?: number;
  sort?: string[];
}

enum AggregationType {
  PRODUCT = "PRODUCT",
  VARIANT = "VARIANT",
  OFFER = "OFFER",
}

const autocompleteParams: AutocompleteProductsRequest = {
  input: "dell laptop",
  locale: "en-GB",
  currency: "EUR",
  pageable: {
    page: 0,
    size: 10,
  },
  aggregation: AggregationType.PRODUCT,
  productTags: ["electronics", "business"],
};

const suggestions = await autoCompleteSearchProducts(autocompleteParams);

// Return type (inferred from API response)
interface AutocompleteResponse {
  success: boolean;
  products: ProductSearchContent[];
}

interface ProductSearchContent {
  offerPrice: OfferPriceSearch;
  offer: OfferSearch;
  variant: VariantSearch;
  product: ProductSearch;
  attributes: AttributeSearch[];
  supplier: SupplierSearch;
}

interface ProductSearch {
  id: string;
  externalId: string;
  sku: string;
  name: string;
  description: string | null;
  brand: string | null;
  mainPictureUrl: string | null;
  tags: any[];
  unit: string | null;
}

interface VariantSearch {
  id: string;
  externalId: string;
  sku: string;
  name: string;
  description: string | null;
  pictureUrls: PictureUrl[];
  ean: string;
  mpn: string | null;
}

[
  {
    "offerPrice": {
      "unitPrice": 899.99,
      "currency": "EUR",
      "taxIncluded": false
    },
    "offer": {
      "id": "offer-001",
      "externalId": "EXT-OFFER-001",
      "quantityPerItem": 1,
      "stock": 150,
      "currency": "EUR",
      "minOrderQuantity": 1,
      "maxOrderQuantity": 100,
      "leadTimeToShip": 2
    },
    "variant": {
      "id": "variant-001",
      "externalId": "DELL-LAT-5520-16GB",
      "sku": "DELL-LAT-5520-16GB-SLV",
      "name": "Dell Latitude 5520 - 16GB RAM - Silver",
      "description": "Professional laptop with Intel i7 processor",
      "pictureUrls": [
        {
          "url": "https://cdn.example.com/dell-latitude-5520-main.jpg",
          "width": 800,
          "height": 600
        }
      ],
      "ean": "1234567890123",
      "mpn": "LAT5520-16-SLV"
    },
    "product": {
      "id": "product-001",
      "externalId": "DELL-LATITUDE-5520",
      "sku": "DELL-LAT-5520",
      "name": "Dell Latitude 5520",
      "description": "Professional business laptop series",
      "brand": "Dell",
      "mainPictureUrl": "https://cdn.example.com/dell-latitude-main.jpg",
      "tags": [
        {
          "name": "Business",
          "category": "USE_CASE"
        },
        {
          "name": "Intel",
          "category": "PROCESSOR"
        }
      ],
      "unit": "piece"
    },
    "attributes": [
      {
        "name": "RAM Size",
        "externalId": "RAM_SIZE",
        "value": "16GB",
        "values": ["16GB"]
      },
      {
        "name": "Color",
        "externalId": "COLOR",
        "value": "Silver",
        "values": ["Silver"]
      }
    ],
    "supplier": {
      "id": "supplier-001",
      "name": "TechPro Distribution",
      "externalId": "TECH-PRO-001"
    }
  },
  {
    "offerPrice": {
      "unitPrice": 1299.99,
      "currency": "EUR",
      "taxIncluded": false
    },
    "offer": {
      "id": "offer-002",
      "externalId": "EXT-OFFER-002",
      "quantityPerItem": 1,
      "stock": 75,
      "currency": "EUR",
      "minOrderQuantity": 1,
      "maxOrderQuantity": 50,
      "leadTimeToShip": 3
    },
    "variant": {
      "id": "variant-002",
      "externalId": "DELL-XPS-13-32GB",
      "sku": "DELL-XPS-13-32GB-BLK",
      "name": "Dell XPS 13 - 32GB RAM - Black",
      "description": "Premium ultrabook with enhanced performance",
      "pictureUrls": [
        {
          "url": "https://cdn.example.com/dell-xps-13-main.jpg",
          "width": 800,
          "height": 600
        }
      ],
      "ean": "1234567890124",
      "mpn": "XPS13-32-BLK"
    },
    "product": {
      "id": "product-002",
      "externalId": "DELL-XPS-13",
      "sku": "DELL-XPS-13",
      "name": "Dell XPS 13",
      "description": "Premium ultrabook series for professionals",
      "brand": "Dell",
      "mainPictureUrl": "https://cdn.example.com/dell-xps-main.jpg",
      "tags": [
        {
          "name": "Premium",
          "category": "TIER"
        },
        {
          "name": "Ultrabook",
          "category": "FORM_FACTOR"
        }
      ],
      "unit": "piece"
    },
    "attributes": [
      {
        "name": "RAM Size",
        "externalId": "RAM_SIZE",
        "value": "32GB",
        "values": ["32GB"]
      },
      {
        "name": "Color",
        "externalId": "COLOR",
        "value": "Black",
        "values": ["Black"]
      }
    ],
    "supplier": {
      "id": "supplier-002",
      "name": "Premium Tech Solutions",
      "externalId": "PREM-TECH-001"
    }
  }
]

// Global error handling in composable
const autoCompleteSearchProducts = async ({
  input,
  locale,
  currency,
  pageable,
  aggregation,
  productTags,
}: AutocompleteProductsRequest) => {
  try {
    // Input validation
    if (!input?.trim() || input.length < 2) {
      console.warn("Autocomplete requires at least 2 characters");
      return [];
    }

    // Set loading state
    loading.value = true;

    const { data, status, error } = await useFetch("/api/search/autocomplete", {
      params: {
        input,
        locale,
        currency,
        pageable: JSON.stringify(pageable),
        aggregation,
        productTags: JSON.stringify(productTags),
      },
      key: `autocomplete-${input}-${locale}-${currency}-${JSON.stringify(
        pageable
      )}-${aggregation}`,
    });

    // Update loading state
    loading.value = status.value === "pending";

    if (error.value) {
      console.error("Error fetching autocomplete products:", {
        input,
        locale,
        error: error.value,
      });
      return [];
    }

    // Return products array or empty array
    return data.value?.products || [];
  } catch (error) {
    console.error("Unexpected error in autoCompleteSearchProducts:", error);
    return [];
  } finally {
    loading.value = false;
  }
};

// Component-level error handling
const handleAutocomplete = async (searchTerm: string) => {
  try {
    if (searchTerm.length < 2) {
      suggestions.value = [];
      return;
    }

    const results = await autoCompleteSearchProducts({
      input: searchTerm,
      locale: userLocale.value,
      currency: userCurrency.value,
      pageable: { page: 0, size: 8 },
    });

    suggestions.value = results;
  } catch (error) {
    console.error("Autocomplete error:", error);

    // User notification for persistent errors
    useToast().add({
      title: "Search Error",
      description: "Unable to load search suggestions",
      color: "yellow",
    });

    // Fallback to empty suggestions
    suggestions.value = [];
  }
};

/**
 * Provides real-time autocomplete suggestions for product search
 *
 * @param params - Autocomplete request parameters
 * @param params.input - Search term for generating suggestions
 * @param params.locale - Locale for internationalized suggestions
 * @param params.currency - Currency for pricing context
 * @param params.pageable - Pagination configuration
 * @param params.aggregation - Aggregation level for results
 * @param params.productTags - Tags to filter suggestions
 * @returns Promise resolving to array of product suggestions
 *
 * @example
 * ```typescript
 * const { autoCompleteSearchProducts } = useSearchProduct();
 *
 * const suggestions = await autoCompleteSearchProducts({
 *   input: "dell laptop",
 *   locale: "en-GB",
 *   currency: "EUR",
 *   pageable: { page: 0, size: 8 }
 * });
 *
 * console.log('Suggestions found:', suggestions.length);
 * suggestions.forEach(product => {
 *   console.log(`${product.product.name}: €${product.offerPrice.unitPrice}`);
 * });
 * ```
 *
 * @throws {Error} When network request fails or invalid input provided
 * @since 1.0.0
 */
const autoCompleteSearchProducts = async ({
  input,
  locale,
  currency,
  pageable,
  aggregation,
  productTags,
}: AutocompleteProductsRequest) => {
  try {
    // Input validation
    if (!input?.trim()) {
      console.warn("Autocomplete input is required");
      return [];
    }

    if (input.length < 2) {
      console.info("Autocomplete requires at least 2 characters");
      return [];
    }

    // Set loading state
    loading.value = true;

    const { data, status, error } = await useFetch("/api/search/autocomplete", {
      params: {
        input: input.trim(),
        locale,
        currency,
        pageable: JSON.stringify(pageable),
        aggregation,
        productTags: JSON.stringify(productTags),
      },
      // Unique cache key for this specific search
      key: `autocomplete-${input}-${locale}-${currency}-${JSON.stringify(
        pageable
      )}-${aggregation}`,
    });

    // Sync loading state with request status
    loading.value = status.value === "pending";

    // Handle API errors
    if (error.value) {
      console.error("Error fetching autocomplete products:", {
        input,
        locale,
        currency,
        error: error.value,
      });
      return [];
    }

    // Return products array or empty fallback
    return data.value?.products || [];
  } catch (error) {
    console.error("Unexpected error in autoCompleteSearchProducts:", error);
    return [];
  } finally {
    // Ensure loading state is always reset
    loading.value = false;
  }
};