function useRecommendations(
  params: GetSectionsParams,
  options?: UseRecommendationsOptions
): UseRecommendationsResult

import { useRecommendations } from '@glood/hydrogen';

const { sections, loading, error } = useRecommendations({
  pageType: 'product_page',
  productId: '8977367564515',
});

const { sections, data, loading, error, refetch, trackClick } =
  useRecommendations(
    {
      pageType: 'cart',
      cartProductIds: ['8977367564515', '9311227838783'],
      cartValue: '199.00',
      currency: 'USD',
      customerId: '7412356789',
      sections: [218966], // only this section
    },
    { skip: false },
  );

async function fetchRecommendationSections(
  options: HeadlessRequestOptions,
  params: GetSectionsParams
): Promise<SectionsResponse>

import { fetchRecommendationSections } from '@glood/hydrogen';

export async function loader({ request, params, context }) {
  const recommendations = await fetchRecommendationSections(
    {
      apiKey: context.env.GLOOD_API_KEY,
      myShopifyDomain: 'your-store.myshopify.com',
    },
    {
      pageType: 'product_page',
      pageUrl: request.url,
      locale: 'en-US',
      productId: params.productId,
    },
  ).catch(() => null);

  return { recommendations };
}

async function fetchHeadlessInit(
  options: HeadlessRequestOptions,
  params?: InitParams
): Promise<InitResponse>

async function sendHeadlessEvent(
  options: HeadlessRequestOptions,
  params: HeadlessEventParams
): Promise<HeadlessEventResponse>

async function fetchRecommendations(
  options: HeadlessRequestOptions,
  params: RecommendationsParams
): Promise<RecommendationsResponse | V2RecommendationsResponse>

async function fetchV3Recommendations(
  options: HeadlessRequestOptions,
  params: RecommendationsParams
): Promise<RecommendationsResponse>

async function fetchV2Recommendations(
  options: HeadlessRequestOptions,
  params: V2RecommendationsParams
): Promise<V2RecommendationsResponse>

async function fetchAutomaticRecommendations(
  options: HeadlessRequestOptions,
  params: AutomaticRecommendationsParams
): Promise<AutomaticRecommendationsResponse>

async function fetchTopRecommendations(
  options: HeadlessRequestOptions,
  params: TopRecommendationsParams
): Promise<TopRecommendationsResponse>

async function runHeadlessInit(
  client: GloodClient
): Promise<InitResponse | null>

async function headlessRequest<T>(
  resource: string,
  body: Record<string, any>,
  options: HeadlessRequestOptions
): Promise<T>

class GloodApiError extends Error {
  /** HTTP status code, e.g. 401 */
  readonly status: number;

  /** Parsed JSON error body, e.g. { error: 'Invalid authentication' } */
  readonly body: unknown;
}

import { GloodApiError } from '@glood/hydrogen';

try {
  await fetchRecommendationSections(options, params);
} catch (error) {
  if (error instanceof GloodApiError && error.status === 401) {
    // Invalid or mismatched API key
  }
}

import { RecommendationsApp } from '@glood/hydrogen';

const app = client.getApp('recommendations') as RecommendationsApp;

const data = await app.getSections({ pageType: 'home' });

app.trackClick({
  section: '218966',
  sectionServeId: data.sections[0].section_serve_id,
  products: [{ productId: '9311227838783' }],
});

const track: SectionTrack = {
  section: '218966',
  sectionServeId: '56a98d2d-a014-4dd7-ab2d-1a5191b84262',
  requestId: '671778ec-8382-4d9e-9671-fb91daccf049',
  page: 'product_page',
  parent: { productId: '8977367564515' },
  products: [
    { productId: '9311227838783', variantId: '48792371233087', quantity: 1 },
  ],
};

interface SectionsResponse {
  /** Unique id for this request — pass to attribution events */
  request_id: string;

  /** Sections with full product data */
  sections: RecommendationSection[];

  /** Current product details (product pages), or null */
  product: Record<string, any> | null;

  /** Shopify storefront access token from the shop config */
  token: string | null;

  /** Shop configuration (currency, money format, integrations, ...) */
  config: Record<string, any>;

  /** Assigned A/B experience id — persisted to localStorage automatically */
  experience: string | null;

  /** Unique id for this visit */
  visit_id: string | null;
}

{
  "request_id": "671778ec-8382-4d9e-9671-fb91daccf049",
  "sections": [
    {
      "id": 218966,
      "section_serve_id": "56a98d2d-a014-4dd7-ab2d-1a5191b84262",
      "page_type": "home",
      "experience_id": 27647,
      "layout": "horizontal_grid",
      "location": "MainContent",
      "type": "bestsellers",
      "position": 3,
      "title": "Bestsellers",
      "extra": {},
      "discount_config": { "enabled": false },
      "show_discount_label": false,
      "translations": {},
      "products": [
        {
          "product_id": 9311227838783,
          "title": "The Collection Snowboard: Oxygen",
          "handle": "the-collection-snowboard-oxygen",
          "vendor": "Hydrogen Vendor",
          "product_type": "snowboard",
          "tags": "Premium, Snow",
          "price": 1025,
          "compare_at_price": null,
          "image": { "url": "https://cdn.shopify.com/..." },
          "options": [
            { "id": 1, "name": "Title", "values": ["Default Title"], "position": 1 }
          ],
          "variants": [
            {
              "variant_id": 48792371233087,
              "title": "Default Title",
              "price": 1025,
              "compare_at_price": null,
              "sku": "",
              "selected_options": [{ "name": "Title", "value": "Default Title" }]
            }
          ],
          "metafields": []
        }
      ],
      "cursor": null,
      "hasMore": false
    }
  ],
  "product": null,
  "token": "shpat_...",
  "config": { "shop": { "currency": "USD", "money_format": "${{amount}}" } },
  "experience": "27647",
  "visit_id": "fc300769-ea40-43d9-8bf3-6b721913fea8"
}