Add AI store assistant with catalogue tool calls

- /api/chat streams via AI SDK v7 through OpenRouter (OPENROUTER_API_KEY),
  with a store-specific system prompt and five read-only tools:
  searchCatalogue, getProductDetails, listCollections,
  getCollectionProducts, browseProducts
- Sidebar assistant on the right that opens from a launcher and expands,
  built on ai-elements (conversation, message, prompt-input, tool) with
  shimmer on in-flight tool calls
- Extract services/shopify/catalog.ts so the Storefront fetchers have no
  React imports and can run in a Route Handler; the client hooks now
  re-export from it
- ai-elements pulled in the canonical shadcn primitives, replacing the
  hand-rolled command/dialog/button variants; search dialog moved to the
  cmdk-based Command and CommandDialog forwards shouldFilter
- Pin shiki to ^3.19.0 to match streamdown and drop the duplicate copy
- Add .env.example documenting the required env vars

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016jWbNNJLksC1QG8z8845FX

hooks/use-shopify-collections.ts

@@ -1,142 +1,38 @@
 'use client';
 
 import { useState, useEffect, useCallback } from 'react';
-import { shopifyFetch } from '@/services/shopify/client';
 import {
-  GET_COLLECTIONS_QUERY,
-  GET_COLLECTION_PRODUCTS_QUERY,
-} from '@/graphql/collections';
-import type { Product } from '@/hooks/use-shopify-products';
+  getCollections,
+  getCollectionProducts,
+} from '@/services/shopify/catalog';
 
-interface CollectionImage {
-  url: string;
-  altText?: string;
-}
+export {
+  getCollections,
+  getCollectionProducts,
+  getCollectionProductsPage,
+} from '@/services/shopify/catalog';
+export type {
+  Collection,
+  CollectionWithProducts,
+  CollectionSortKey,
+  CollectionProductsPage,
+  ProductFilterFacet,
+} from '@/services/shopify/catalog';
 
-export interface Collection {
-  id: string;
-  title: string;
-  handle: string;
-  description?: string;
-  descriptionHtml?: string;
-  image?: CollectionImage;
-}
-
-export interface CollectionWithProducts extends Collection {
-  products: Product[];
-}
-
-export type CollectionSortKey =
-  | 'COLLECTION_DEFAULT'
-  | 'BEST_SELLING'
-  | 'CREATED'
-  | 'PRICE'
-  | 'TITLE';
+import type {
+  Collection,
+  CollectionWithProducts,
+  CollectionSortKey,
+} from '@/services/shopify/catalog';
 
 interface UseCollectionProductsOptions {
   first?: number;
   after?: string | null;
   sortKey?: CollectionSortKey;
   reverse?: boolean;
-  /** Raw `input` strings from the connection's `filters` facets. */
   filterInputs?: string[];
 }
 
-export interface CollectionProductsPage {
-  collection: Collection | null;
-  products: Product[];
-  filters: ProductFilterFacet[];
-  hasNextPage: boolean;
-  endCursor: string | null;
-}
-
-export interface ProductFilterFacet {
-  id: string;
-  label: string;
-  type: 'LIST' | 'PRICE_RANGE' | 'BOOLEAN';
-  values: Array<{
-    id: string;
-    label: string;
-    count: number;
-    input: string;
-  }>;
-}
-
-// Fetch all collections
-export async function getCollections(first = 50): Promise<Collection[]> {
-  const response = await shopifyFetch({
-    query: GET_COLLECTIONS_QUERY,
-    variables: { first },
-  });
-
-  return response.data.collections.edges.map((edge: { node: Collection }) => edge.node);
-}
-
-// Fetch products in a collection by handle
-export async function getCollectionProducts(
-  handle: string,
-  options: UseCollectionProductsOptions = {}
-): Promise<CollectionWithProducts | null> {
-  const page = await getCollectionProductsPage(handle, options);
-  if (!page.collection) return null;
-
-  return { ...page.collection, products: page.products };
-}
-
-// Same fetch, but keeps the cursor and facet list for filtering and paging.
-export async function getCollectionProductsPage(
-  handle: string,
-  {
-    first = 50,
-    after = null,
-    sortKey = 'COLLECTION_DEFAULT',
-    reverse = false,
-    filterInputs = [],
-  }: UseCollectionProductsOptions = {}
-): Promise<CollectionProductsPage> {
-  const filters = filterInputs.flatMap((input) => {
-    try {
-      return [JSON.parse(input)];
-    } catch {
-      console.warn('Ignoring malformed product filter input:', input);
-      return [];
-    }
-  });
-
-  const response = await shopifyFetch({
-    query: GET_COLLECTION_PRODUCTS_QUERY,
-    variables: {
-      handle,
-      first,
-      after,
-      sortKey,
-      reverse,
-      filters: filters.length ? filters : null,
-    },
-  });
-
-  const collection = response.data.collection;
-  if (!collection) {
-    return {
-      collection: null,
-      products: [],
-      filters: [],
-      hasNextPage: false,
-      endCursor: null,
-    };
-  }
-
-  const { edges, pageInfo, filters: facets } = collection.products;
-
-  return {
-    collection,
-    products: edges.map((edge: { node: Product }) => edge.node),
-    filters: facets ?? [],
-    hasNextPage: Boolean(pageInfo?.hasNextPage),
-    endCursor: pageInfo?.endCursor ?? null,
-  };
-}
-
 // Hook for fetching all collections
 export function useCollections(first = 50) {
   const [collections, setCollections] = useState<Collection[]>([]);

hooks/use-shopify-products.ts

@@ -1,99 +1,37 @@
 'use client';
 
 import { useState, useEffect, useCallback } from 'react';
-import { shopifyFetch } from '@/services/shopify/client';
 import {
-  GET_PRODUCTS_QUERY,
-  GET_PRODUCT_QUERY,
-  QUERY_PRODUCT_RECOMMENDATIONS,
-} from '@/graphql/products';
+  getProducts,
+  getProduct,
+  getProductRecommendations,
+} from '@/services/shopify/catalog';
 
-interface ProductImage {
-  url: string;
-  altText?: string;
-}
+// Pure fetchers live in services/shopify/catalog so server code can use them
+// too; re-exported here so existing imports keep working.
+export {
+  getProducts,
+  getProductsPage,
+  getProduct,
+  getProductRecommendations,
+} from '@/services/shopify/catalog';
+export type {
+  Product,
+  ProductOption,
+  ProductOptionValue,
+  ProductsPage,
+} from '@/services/shopify/catalog';
 
-interface ProductPrice {
-  amount: string;
-  currencyCode: string;
-}
-
-interface ProductVariant {
-  id: string;
-  title: string;
-  price: ProductPrice;
-  availableForSale: boolean;
-  selectedOptions: Array<{
-    name: string;
-    value: string;
-  }>;
-  image?: ProductImage;
-}
-
-export interface ProductOptionValue {
-  id: string;
-  name: string;
-  swatch?: {
-    color?: string | null;
-    image?: {
-      previewImage?: {
-        url: string;
-      } | null;
-    } | null;
-  } | null;
-  firstSelectableVariant?: {
-    id: string;
-    image?: ProductImage | null;
-  } | null;
-}
-
-export interface ProductOption {
-  id: string;
-  name: string;
-  values: string[];
-  optionValues?: ProductOptionValue[];
-}
-
-export interface Product {
-  id: string;
-  title: string;
-  description?: string;
-  descriptionHtml?: string;
-  handle: string;
-  images: {
-    edges: Array<{
-      node: ProductImage;
-    }>;
-  };
-  priceRange: {
-    minVariantPrice: ProductPrice;
-  };
-  compareAtPriceRange?: {
-    minVariantPrice: ProductPrice;
-  };
-  variants: {
-    edges: Array<{
-      node: ProductVariant;
-    }>;
-  };
-  options: ProductOption[];
-}
+import type { Product } from '@/services/shopify/catalog';
 
 interface UseProductsOptions {
   first?: number;
-  /** Cursor from a previous page's `endCursor`; omit for the first page. */
   after?: string | null;
   query?: string;
   sortKey?: 'BEST_SELLING' | 'CREATED_AT' | 'PRICE' | 'TITLE';
   reverse?: boolean;
 }
 
-export interface ProductsPage {
-  products: Product[];
-  hasNextPage: boolean;
-  endCursor: string | null;
-}
-
 interface UseProductsReturn {
   products: Product[];
   loading: boolean;
@@ -101,56 +39,6 @@ interface UseProductsReturn {
   refetch: () => Promise<void>;
 }
 
-// Fetch multiple products
-export async function getProducts(
-  options: UseProductsOptions = {}
-): Promise<Product[]> {
-  const { products } = await getProductsPage(options);
-  return products;
-}
-
-// Same fetch, but keeps the cursor so callers can page through the catalogue.
-export async function getProductsPage({
-  first = 20,
-  after = null,
-  query = '',
-  sortKey = 'BEST_SELLING',
-  reverse = false,
-}: UseProductsOptions = {}): Promise<ProductsPage> {
-  const response = await shopifyFetch({
-    query: GET_PRODUCTS_QUERY,
-    variables: { first, after, query, sortKey, reverse },
-  });
-
-  const { edges, pageInfo } = response.data.products;
-
-  return {
-    products: edges.map((edge: { node: Product }) => edge.node),
-    hasNextPage: Boolean(pageInfo?.hasNextPage),
-    endCursor: pageInfo?.endCursor ?? null,
-  };
-}
-
-// Fetch a single product by handle
-export async function getProduct(handle: string): Promise<Product | null> {
-  const response = await shopifyFetch({
-    query: GET_PRODUCT_QUERY,
-    variables: { handle },
-  });
-
-  return response.data.product;
-}
-
-// Fetch product recommendations
-export async function getProductRecommendations(productId: string): Promise<Product[]> {
-  const response = await shopifyFetch({
-    query: QUERY_PRODUCT_RECOMMENDATIONS,
-    variables: { productId },
-  });
-
-  return response.data.productRecommendations || [];
-}
-
 // Hook for fetching multiple products
 export function useProducts(options: UseProductsOptions = {}): UseProductsReturn {
   const [products, setProducts] = useState<Product[]>([]);

hooks/use-shopify-search.ts

@@ -1,120 +1,10 @@
-'use client';
-
-import { shopifyFetch } from '@/services/shopify/client';
-import {
-  SEARCH_PRODUCTS_QUERY,
-  SEARCH_SUGGESTIONS_QUERY,
-} from '@/graphql/search';
-import type { Product } from '@/hooks/use-shopify-products';
-
-export type SearchSortKey = 'RELEVANCE' | 'PRICE';
-
-export interface SearchFilterValue {
-  id: string;
-  label: string;
-  count: number;
-  /** JSON string accepted back as a `ProductFilter` input. */
-  input: string;
-}
-
-export interface SearchFilter {
-  id: string;
-  label: string;
-  type: 'LIST' | 'PRICE_RANGE' | 'BOOLEAN';
-  values: SearchFilterValue[];
-}
-
-export interface SearchProductsResult {
-  products: Product[];
-  totalCount: number;
-  filters: SearchFilter[];
-  hasNextPage: boolean;
-  endCursor: string | null;
-}
-
-export interface SearchSuggestion {
-  id: string;
-  title: string;
-  handle: string;
-  featuredImage?: {
-    url: string;
-    altText?: string;
-  } | null;
-  priceRange: {
-    minVariantPrice: {
-      amount: string;
-      currencyCode: string;
-    };
-  };
-}
-
-interface SearchProductsOptions {
-  query: string;
-  first?: number;
-  after?: string | null;
-  sortKey?: SearchSortKey;
-  reverse?: boolean;
-  /** Raw `input` strings from the facets, parsed back into filter objects. */
-  filterInputs?: string[];
-}
-
-function parseFilterInputs(inputs: string[]): unknown[] {
-  return inputs.flatMap((input) => {
-    try {
-      return [JSON.parse(input)];
-    } catch {
-      console.warn('Ignoring malformed product filter input:', input);
-      return [];
-    }
-  });
-}
-
-export async function searchProducts({
-  query,
-  first = 24,
-  after = null,
-  sortKey = 'RELEVANCE',
-  reverse = false,
-  filterInputs = [],
-}: SearchProductsOptions): Promise<SearchProductsResult> {
-  const response = await shopifyFetch({
-    query: SEARCH_PRODUCTS_QUERY,
-    variables: {
-      query,
-      first,
-      after,
-      sortKey,
-      reverse,
-      productFilters: filterInputs.length
-        ? parseFilterInputs(filterInputs)
-        : null,
-    },
-  });
-
-  const search = response.data.search;
-
-  return {
-    products: search.edges.map((edge: { node: Product }) => edge.node),
-    totalCount: search.totalCount ?? 0,
-    filters: search.productFilters ?? [],
-    hasNextPage: Boolean(search.pageInfo?.hasNextPage),
-    endCursor: search.pageInfo?.endCursor ?? null,
-  };
-}
-
-export async function searchSuggestions(
-  query: string,
-  first = 3
-): Promise<{ products: SearchSuggestion[]; totalCount: number }> {
-  const response = await shopifyFetch({
-    query: SEARCH_SUGGESTIONS_QUERY,
-    variables: { query, first },
-  });
-
-  const search = response.data.search;
-
-  return {
-    products: search.edges.map((edge: { node: SearchSuggestion }) => edge.node),
-    totalCount: search.totalCount ?? 0,
-  };
-}
+// Re-exported from the server-safe catalogue module so both client components
+// and Route Handlers can search the storefront.
+export { searchProducts, searchSuggestions } from '@/services/shopify/catalog';
+export type {
+  SearchSortKey,
+  SearchFilter,
+  SearchFilterValue,
+  SearchProductsResult,
+  SearchSuggestion,
+} from '@/services/shopify/catalog';