SDK TypeScript

npm install @alana-shopping/search-sdk

const client = new AlanaSearchClient({
  apiKey?: string;    // cabeçalho x-api-key (auth via chave de API)
  m2mToken?: string;  // Bearer token (Auth0 M2M — service-to-service)
  baseUrl?: string;   // Sobrescreve a URL base (padrão: https://app.alana.shopping)
});

const { suggestions, products } = await client.autocomplete({
  query: "tên",
  limit: 5,
  includeProducts: true,
});

const { hits, nbHits } = await client.browse({
  categoryPath: "calcados/tenis",
  page: 0,
  hitsPerPage: 24,
  sortBy: "price_asc",
  facets: ["brand", "color"],
  facetFilters: [["color:vermelho", "color:azul"]],
});

const { hits, model, fallback } = await client.recommend({
  model: "related-products",
  productId: "sku-123",
  userId: "user-456",
  limit: 10,
});

import { AlanaSearchClient, AlanaApiError } from "@alana-shopping/search-sdk";

const client = new AlanaSearchClient({ apiKey: "sua-chave" });

try {
  const results = await client.search({ query: "tênis" });
} catch (err) {
  if (err instanceof AlanaApiError) {
    console.error(`Erro de API ${err.status}:`, err.message);
    // err.body contém o corpo completo da resposta
  } else {
    // Erro de rede, timeout de requisição, etc.
    console.error("Erro de rede:", err);
  }
}

import type {
  SearchParams,
  SearchResponse,
  SearchHit,
  AutocompleteParams,
  AutocompleteResponse,
  BrowseParams,
  BrowseResponse,
  RecommendModel,
  RecommendParams,
  RecommendResponse,
  TrackEventParams,
  TrackEvent,
} from "@alana-shopping/search-sdk";