@aws505/sheetsite 1.0.0

package/src/data/sheets.ts

@@ -0,0 +1,709 @@
+/**
+ * Google Sheets Integration
+ *
+ * Provides data fetching from Google Sheets in two modes:
+ * 1. Public CSV: Fetch published sheets via CSV URLs (simpler, no auth)
+ * 2. Private API: Fetch via Google Sheets API with service account (more secure)
+ *
+ * Both modes return the same SiteData structure.
+ */
+
+import {
+  type SiteData,
+  type PartialSiteData,
+  type SheetConfig,
+  type PublicCsvConfig,
+  type PrivateApiConfig,
+  type InlineDataConfig,
+  type BusinessInfo,
+  type HoursEntry,
+  type Service,
+  type GalleryItem,
+  type Testimonial,
+  type FAQItem,
+  type TeamMember,
+  type MenuItem,
+  type Product,
+  type Announcement,
+  type DayOfWeek,
+} from './types';
+import { parseCSV, type ParsedRow, parseBoolean, parseNumber, parseSortOrder } from './csv-parser';
+import { normalizeGoogleDriveUrl } from './google-drive';
+
+// =============================================================================
+// CONFIGURATION
+// =============================================================================
+
+const DEFAULT_REVALIDATE = 300; // 5 minutes
+
+export interface FetchOptions {
+  revalidate?: number;
+  cache?: RequestCache;
+}
+
+// =============================================================================
+// PUBLIC CSV MODE
+// =============================================================================
+
+/**
+ * Fetch data from a published Google Sheet CSV URL.
+ */
+async function fetchCSV(url: string, options: FetchOptions = {}): Promise<string> {
+  const response = await fetch(url, {
+    next: { revalidate: options.revalidate ?? DEFAULT_REVALIDATE },
+    cache: options.cache,
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to fetch CSV: ${response.status} ${response.statusText}`);
+  }
+
+  return response.text();
+}
+
+/**
+ * Fetch and parse a CSV tab from a public sheet.
+ */
+async function fetchPublicTab<T>(
+  url: string | undefined,
+  parser: (rows: ParsedRow[]) => T,
+  options: FetchOptions = {}
+): Promise<T | undefined> {
+  if (!url) return undefined;
+
+  try {
+    const csvText = await fetchCSV(url, options);
+    const rows = parseCSV(csvText);
+    return parser(rows);
+  } catch (error) {
+    console.error(`Error fetching public tab from ${url}:`, error);
+    return undefined;
+  }
+}
+
+/**
+ * Fetch all data from a public CSV configuration.
+ */
+export async function fetchPublicSheetData(
+  config: PublicCsvConfig,
+  options: FetchOptions = {}
+): Promise<PartialSiteData> {
+  const [business, hours, services, gallery, testimonials, faq, team, menu, products, announcements] =
+    await Promise.all([
+      fetchPublicTab(config.tabs.business, parseBusinessRows, options),
+      fetchPublicTab(config.tabs.hours, parseHoursRows, options),
+      fetchPublicTab(config.tabs.services, parseServicesRows, options),
+      fetchPublicTab(config.tabs.gallery, parseGalleryRows, options),
+      fetchPublicTab(config.tabs.testimonials, parseTestimonialsRows, options),
+      fetchPublicTab(config.tabs.faq, parseFAQRows, options),
+      fetchPublicTab(config.tabs.team, parseTeamRows, options),
+      fetchPublicTab(config.tabs.menu, parseMenuRows, options),
+      fetchPublicTab(config.tabs.products, parseProductsRows, options),
+      fetchPublicTab(config.tabs.announcements, parseAnnouncementsRows, options),
+    ]);
+
+  return {
+    business,
+    hours,
+    services,
+    gallery,
+    testimonials,
+    faq,
+    team,
+    menu,
+    products,
+    announcements,
+  };
+}
+
+// =============================================================================
+// PRIVATE API MODE
+// =============================================================================
+
+/**
+ * Create a JWT for Google Sheets API authentication.
+ * Uses Web Crypto API - no external dependencies needed.
+ */
+async function createJWT(clientEmail: string, privateKey: string): Promise<string> {
+  const now = Math.floor(Date.now() / 1000);
+
+  const header = {
+    alg: 'RS256',
+    typ: 'JWT',
+  };
+
+  const payload = {
+    iss: clientEmail,
+    scope: 'https://www.googleapis.com/auth/spreadsheets.readonly',
+    aud: 'https://oauth2.googleapis.com/token',
+    iat: now,
+    exp: now + 3600, // 1 hour
+  };
+
+  // Encode header and payload
+  const encoder = new TextEncoder();
+  const headerB64 = btoa(JSON.stringify(header))
+    .replace(/\+/g, '-')
+    .replace(/\//g, '_')
+    .replace(/=/g, '');
+  const payloadB64 = btoa(JSON.stringify(payload))
+    .replace(/\+/g, '-')
+    .replace(/\//g, '_')
+    .replace(/=/g, '');
+
+  const signInput = `${headerB64}.${payloadB64}`;
+
+  // Parse PEM private key
+  const pemContents = privateKey
+    .replace(/-----BEGIN PRIVATE KEY-----/g, '')
+    .replace(/-----END PRIVATE KEY-----/g, '')
+    .replace(/\\n/g, '')
+    .replace(/\n/g, '')
+    .replace(/\s/g, '');
+
+  const binaryKey = Uint8Array.from(atob(pemContents), (c) => c.charCodeAt(0));
+
+  // Import key for signing
+  const cryptoKey = await crypto.subtle.importKey(
+    'pkcs8',
+    binaryKey,
+    { name: 'RSASSA-PKCS1-v1_5', hash: 'SHA-256' },
+    false,
+    ['sign']
+  );
+
+  // Sign
+  const signature = await crypto.subtle.sign(
+    'RSASSA-PKCS1-v1_5',
+    cryptoKey,
+    encoder.encode(signInput)
+  );
+
+  // Encode signature
+  const signatureB64 = btoa(String.fromCharCode(...new Uint8Array(signature)))
+    .replace(/\+/g, '-')
+    .replace(/\//g, '_')
+    .replace(/=/g, '');
+
+  return `${signInput}.${signatureB64}`;
+}
+
+/**
+ * Get an access token for the Google Sheets API.
+ */
+async function getAccessToken(clientEmail: string, privateKey: string): Promise<string> {
+  const jwt = await createJWT(clientEmail, privateKey);
+
+  const response = await fetch('https://oauth2.googleapis.com/token', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+    body: new URLSearchParams({
+      grant_type: 'urn:ietf:params:oauth:grant-type:jwt-bearer',
+      assertion: jwt,
+    }),
+  });
+
+  if (!response.ok) {
+    throw new Error(`Failed to get access token: ${response.status}`);
+  }
+
+  const data = await response.json();
+  return data.access_token;
+}
+
+/**
+ * Fetch a single tab from the Google Sheets API.
+ */
+async function fetchPrivateTab<T>(
+  sheetId: string,
+  tabName: string,
+  accessToken: string,
+  parser: (rows: ParsedRow[]) => T
+): Promise<T | undefined> {
+  try {
+    const url = `https://sheets.googleapis.com/v4/spreadsheets/${sheetId}/values/${encodeURIComponent(tabName)}`;
+
+    const response = await fetch(url, {
+      headers: { Authorization: `Bearer ${accessToken}` },
+    });
+
+    if (!response.ok) {
+      if (response.status === 404) {
+        // Tab doesn't exist, return undefined
+        return undefined;
+      }
+      throw new Error(`Failed to fetch tab ${tabName}: ${response.status}`);
+    }
+
+    const data = await response.json();
+    const values: string[][] = data.values || [];
+
+    if (values.length < 2) return undefined;
+
+    // Convert array format to objects
+    const headers = values[0].map((h: string) =>
+      h.toLowerCase().trim().replace(/\s+/g, '_').replace(/[^a-z0-9_]/g, '')
+    );
+    const rows: ParsedRow[] = [];
+
+    for (let i = 1; i < values.length; i++) {
+      const row: ParsedRow = {};
+      for (let j = 0; j < headers.length; j++) {
+        row[headers[j]] = values[i][j]?.trim() ?? '';
+      }
+      rows.push(row);
+    }
+
+    return parser(rows);
+  } catch (error) {
+    console.error(`Error fetching private tab ${tabName}:`, error);
+    return undefined;
+  }
+}
+
+/**
+ * Fetch all data from a private API configuration.
+ */
+export async function fetchPrivateSheetData(
+  config: PrivateApiConfig,
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  _options: FetchOptions = {}
+): Promise<PartialSiteData> {
+  const accessToken = await getAccessToken(config.clientEmail, config.privateKey);
+
+  const tabs = config.tabs || {};
+  const sheetId = config.sheetId;
+
+  const [business, hours, services, gallery, testimonials, faq, team, menu, products, announcements] =
+    await Promise.all([
+      fetchPrivateTab(sheetId, tabs.business || 'business', accessToken, parseBusinessRows),
+      fetchPrivateTab(sheetId, tabs.hours || 'hours', accessToken, parseHoursRows),
+      fetchPrivateTab(sheetId, tabs.services || 'services', accessToken, parseServicesRows),
+      fetchPrivateTab(sheetId, tabs.gallery || 'gallery', accessToken, parseGalleryRows),
+      fetchPrivateTab(sheetId, tabs.testimonials || 'testimonials', accessToken, parseTestimonialsRows),
+      fetchPrivateTab(sheetId, tabs.faq || 'faq', accessToken, parseFAQRows),
+      fetchPrivateTab(sheetId, tabs.team || 'team', accessToken, parseTeamRows),
+      fetchPrivateTab(sheetId, tabs.menu || 'menu', accessToken, parseMenuRows),
+      fetchPrivateTab(sheetId, tabs.products || 'products', accessToken, parseProductsRows),
+      fetchPrivateTab(sheetId, tabs.announcements || 'announcements', accessToken, parseAnnouncementsRows),
+    ]);
+
+  return {
+    business,
+    hours,
+    services,
+    gallery,
+    testimonials,
+    faq,
+    team,
+    menu,
+    products,
+    announcements,
+  };
+}
+
+// =============================================================================
+// INLINE DATA MODE
+// =============================================================================
+
+/**
+ * Process inline data configuration.
+ * Simply returns the provided data - no network requests needed.
+ */
+export function fetchInlineData(config: InlineDataConfig): PartialSiteData {
+  return config.data;
+}
+
+// =============================================================================
+// UNIFIED FETCH
+// =============================================================================
+
+/**
+ * Fetch site data using the provided configuration.
+ * Automatically detects the mode and fetches accordingly.
+ *
+ * Supported modes:
+ * - 'public_csv': Fetch from published Google Sheet CSV URLs
+ * - 'private_api': Fetch via Google Sheets API with service account
+ * - 'inline': Use provided data directly (no network requests)
+ */
+export async function fetchSheetData(
+  config: SheetConfig,
+  options: FetchOptions = {}
+): Promise<PartialSiteData> {
+  switch (config.mode) {
+    case 'public_csv':
+      return fetchPublicSheetData(config, options);
+    case 'private_api':
+      return fetchPrivateSheetData(config, options);
+    case 'inline':
+      return fetchInlineData(config);
+  }
+}
+
+// =============================================================================
+// ROW PARSERS
+// =============================================================================
+
+/**
+ * Parse business info from rows (key-value format).
+ */
+function parseBusinessRows(rows: ParsedRow[]): Partial<BusinessInfo> {
+  const data: Record<string, string> = {};
+
+  for (const row of rows) {
+    const key = row.key?.toLowerCase().replace(/\s+/g, '_');
+    const value = row.value;
+    if (key && value) {
+      data[key] = value;
+    }
+  }
+
+  return {
+    name: data.name || data.business_name || '',
+    tagline: data.tagline,
+    description: data.description || data.about,
+    aboutShort: data.about_short,
+    aboutLong: data.about_long,
+    phone: data.phone,
+    phoneAlt: data.phone_alt || data.phone_secondary,
+    email: data.email,
+    addressLine1: data.address_line1 || data.address || data.street,
+    addressLine2: data.address_line2,
+    city: data.city,
+    state: data.state,
+    zip: data.zip || data.zipcode || data.postal_code,
+    country: data.country || 'USA',
+    googleMapsUrl: data.google_maps_url || data.maps_url,
+    mapsEmbedUrl: data.maps_embed_url || data.embed_url,
+    timezone: data.timezone || 'America/Los_Angeles',
+    logoUrl: normalizeGoogleDriveUrl(data.logo_url || data.logo),
+    heroImageUrl: normalizeGoogleDriveUrl(data.hero_image_url || data.hero_image || data.hero_photo_url),
+    ogImageUrl: normalizeGoogleDriveUrl(data.og_image_url || data.og_image),
+    socialYelp: data.social_yelp || data.yelp,
+    socialInstagram: data.social_instagram || data.instagram,
+    socialFacebook: data.social_facebook || data.facebook,
+    socialTwitter: data.social_twitter || data.twitter,
+    socialLinkedIn: data.social_linkedin || data.linkedin,
+    socialYoutube: data.social_youtube || data.youtube,
+    socialTiktok: data.social_tiktok || data.tiktok,
+    primaryCtaText: data.primary_cta_text || data.cta_text,
+    primaryCtaUrl: data.primary_cta_url || data.cta_url,
+    secondaryCtaText: data.secondary_cta_text,
+    secondaryCtaUrl: data.secondary_cta_url,
+    bookingUrl: data.booking_url || data.booking_or_quote_url,
+    bannerEnabled: parseBoolean(data.banner_enabled),
+    bannerText: data.banner_text,
+    bannerUrl: data.banner_url,
+    priceRange: data.price_range as BusinessInfo['priceRange'],
+    yearEstablished: parseNumber(data.year_established),
+    licenseNumber: data.license_number,
+  };
+}
+
+/**
+ * Parse hours from rows.
+ */
+function parseHoursRows(rows: ParsedRow[]): HoursEntry[] {
+  const dayMap: Record<string, DayOfWeek> = {
+    monday: 'monday',
+    mon: 'monday',
+    tuesday: 'tuesday',
+    tue: 'tuesday',
+    tues: 'tuesday',
+    wednesday: 'wednesday',
+    wed: 'wednesday',
+    thursday: 'thursday',
+    thu: 'thursday',
+    thur: 'thursday',
+    thurs: 'thursday',
+    friday: 'friday',
+    fri: 'friday',
+    saturday: 'saturday',
+    sat: 'saturday',
+    sunday: 'sunday',
+    sun: 'sunday',
+  };
+
+  return rows
+    .map((row) => {
+      const dayKey = (row.day || row.day_of_week || '').toLowerCase();
+      const day = dayMap[dayKey];
+      if (!day) return null;
+
+      return {
+        day,
+        open: row.open || row.open_time || row.opens,
+        close: row.close || row.close_time || row.closes,
+        closed: parseBoolean(row.closed),
+      };
+    })
+    .filter((entry): entry is HoursEntry => entry !== null);
+}
+
+/**
+ * Parse services from rows.
+ */
+function parseServicesRows(rows: ParsedRow[]): Service[] {
+  return rows
+    .map((row, index) => {
+      const title = row.title || row.name || row.service;
+      if (!title) return null;
+
+      return {
+        id: row.id || `service-${index}`,
+        title,
+        description: row.description || row.desc,
+        priceNote: row.price_note || row.price_hint || row.pricing,
+        price: parseNumber(row.price),
+        duration: row.duration || row.time,
+        icon: row.icon,
+        imageUrl: normalizeGoogleDriveUrl(row.image_url || row.image),
+        featured: parseBoolean(row.featured),
+        sortOrder: parseSortOrder(row.sort_order || row.sort),
+        category: row.category,
+      };
+    })
+    .filter((service): service is Service => service !== null)
+    .sort((a, b) => a.sortOrder - b.sortOrder);
+}
+
+/**
+ * Parse gallery items from rows.
+ */
+function parseGalleryRows(rows: ParsedRow[]): GalleryItem[] {
+  return rows
+    .map((row, index) => {
+      const imageUrl = normalizeGoogleDriveUrl(row.image_url || row.url || row.image);
+      if (!imageUrl) return null;
+
+      return {
+        id: row.id || `gallery-${index}`,
+        imageUrl,
+        alt: row.alt || row.alt_text || row.description || '',
+        caption: row.caption,
+        featured: parseBoolean(row.featured),
+        sortOrder: parseSortOrder(row.sort_order || row.sort),
+        category: row.category,
+      };
+    })
+    .filter((item): item is GalleryItem => item !== null)
+    .sort((a, b) => a.sortOrder - b.sortOrder);
+}
+
+/**
+ * Parse testimonials from rows.
+ */
+function parseTestimonialsRows(rows: ParsedRow[]): Testimonial[] {
+  return rows
+    .map((row, index) => {
+      const quote = row.quote || row.text || row.review || row.testimonial;
+      const name = row.name || row.author || row.reviewer;
+      if (!quote || !name) return null;
+
+      return {
+        id: row.id || `testimonial-${index}`,
+        quote,
+        name,
+        context: row.context || row.service,
+        rating: parseNumber(row.rating),
+        source: row.source || row.source_label || row.platform,
+        date: row.date,
+        imageUrl: normalizeGoogleDriveUrl(row.image_url || row.photo),
+        featured: parseBoolean(row.featured),
+        sortOrder: parseSortOrder(row.sort_order || row.sort),
+      };
+    })
+    .filter((item): item is Testimonial => item !== null)
+    .sort((a, b) => a.sortOrder - b.sortOrder);
+}
+
+/**
+ * Parse FAQ items from rows.
+ */
+function parseFAQRows(rows: ParsedRow[]): FAQItem[] {
+  return rows
+    .map((row, index) => {
+      const question = row.question || row.q;
+      const answer = row.answer || row.a;
+      if (!question || !answer) return null;
+
+      return {
+        id: row.id || `faq-${index}`,
+        question,
+        answer,
+        category: row.category,
+        sortOrder: parseSortOrder(row.sort_order || row.sort),
+      };
+    })
+    .filter((item): item is FAQItem => item !== null)
+    .sort((a, b) => a.sortOrder - b.sortOrder);
+}
+
+/**
+ * Parse team members from rows.
+ */
+function parseTeamRows(rows: ParsedRow[]): TeamMember[] {
+  return rows
+    .map((row, index) => {
+      const name = row.name;
+      if (!name) return null;
+
+      return {
+        id: row.id || `team-${index}`,
+        name,
+        role: row.role || row.title || row.position,
+        bio: row.bio || row.description,
+        imageUrl: normalizeGoogleDriveUrl(row.image_url || row.photo || row.image),
+        email: row.email,
+        phone: row.phone,
+        sortOrder: parseSortOrder(row.sort_order || row.sort),
+      };
+    })
+    .filter((item): item is TeamMember => item !== null)
+    .sort((a, b) => a.sortOrder - b.sortOrder);
+}
+
+/**
+ * Parse menu items from rows.
+ */
+function parseMenuRows(rows: ParsedRow[]): MenuItem[] {
+  return rows
+    .map((row, index) => {
+      const name = row.name || row.item || row.title;
+      if (!name) return null;
+
+      const dietary = row.dietary || row.tags || row.dietary_tags;
+
+      return {
+        id: row.id || `menu-${index}`,
+        name,
+        description: row.description || row.desc,
+        price: parseNumber(row.price),
+        priceNote: row.price_note || row.pricing,
+        category: row.category || row.section,
+        imageUrl: normalizeGoogleDriveUrl(row.image_url || row.image),
+        dietary: dietary ? dietary.split(',').map((s: string) => s.trim()) : undefined,
+        featured: parseBoolean(row.featured),
+        available: row.available !== undefined ? parseBoolean(row.available) : true,
+        sortOrder: parseSortOrder(row.sort_order || row.sort),
+      };
+    })
+    .filter((item): item is MenuItem => item !== null)
+    .sort((a, b) => a.sortOrder - b.sortOrder);
+}
+
+/**
+ * Parse products from rows.
+ */
+function parseProductsRows(rows: ParsedRow[]): Product[] {
+  const products = rows
+    .map((row, index): Product | null => {
+      const name = row.name || row.product || row.title;
+      if (!name) return null;
+
+      const images = row.images || row.additional_images;
+
+      const product: Product = {
+        name,
+        featured: parseBoolean(row.featured),
+        sortOrder: parseSortOrder(row.sort_order || row.sort),
+        inStock: row.in_stock !== undefined ? parseBoolean(row.in_stock) : true,
+      };
+
+      if (row.id) product.id = row.id;
+      else product.id = `product-${index}`;
+
+      if (row.description || row.desc) product.description = row.description || row.desc;
+      if (parseNumber(row.price) !== undefined) product.price = parseNumber(row.price);
+      if (row.price_note || row.pricing) product.priceNote = row.price_note || row.pricing;
+      if (row.category) product.category = row.category;
+
+      const imageUrl = normalizeGoogleDriveUrl(row.image_url || row.image);
+      if (imageUrl) product.imageUrl = imageUrl;
+
+      if (images) {
+        product.images = images
+          .split(',')
+          .map((s: string) => normalizeGoogleDriveUrl(s.trim()))
+          .filter(Boolean) as string[];
+      }
+
+      if (row.sku) product.sku = row.sku;
+      if (row.purchase_url || row.buy_url || row.shop_url) {
+        product.purchaseUrl = row.purchase_url || row.buy_url || row.shop_url;
+      }
+
+      return product;
+    })
+    .filter((item): item is Product => item !== null);
+
+  return products.sort((a, b) => a.sortOrder - b.sortOrder);
+}
+
+/**
+ * Parse announcements from rows.
+ */
+function parseAnnouncementsRows(rows: ParsedRow[]): Announcement[] {
+  const announcements = rows
+    .map((row, index): Announcement | null => {
+      const title = row.title || row.headline;
+      if (!title) return null;
+
+      const announcement: Announcement = {
+        title,
+        sortOrder: parseSortOrder(row.sort_order || row.sort),
+        active: row.active !== undefined ? parseBoolean(row.active) : true,
+      };
+
+      if (row.id) announcement.id = row.id;
+      else announcement.id = `announcement-${index}`;
+
+      if (row.content || row.description || row.body) {
+        announcement.content = row.content || row.description || row.body;
+      }
+
+      const imageUrl = normalizeGoogleDriveUrl(row.image_url || row.image);
+      if (imageUrl) announcement.imageUrl = imageUrl;
+
+      if (row.link_url || row.url || row.link) {
+        announcement.linkUrl = row.link_url || row.url || row.link;
+      }
+      if (row.link_text || row.cta) announcement.linkText = row.link_text || row.cta;
+      if (row.start_date) announcement.startDate = row.start_date;
+      if (row.end_date) announcement.endDate = row.end_date;
+
+      return announcement;
+    })
+    .filter((item): item is Announcement => item !== null);
+
+  return announcements.sort((a, b) => a.sortOrder - b.sortOrder);
+}
+
+// =============================================================================
+// MERGE WITH DEFAULTS
+// =============================================================================
+
+/**
+ * Merge partial site data with defaults to create complete site data.
+ */
+export function mergeSiteData(
+  partial: PartialSiteData,
+  defaults: SiteData
+): SiteData {
+  return {
+    business: {
+      ...defaults.business,
+      ...partial.business,
+    },
+    hours: partial.hours ?? defaults.hours,
+    services: partial.services ?? defaults.services,
+    gallery: partial.gallery ?? defaults.gallery,
+    testimonials: partial.testimonials ?? defaults.testimonials,
+    faq: partial.faq ?? defaults.faq,
+    team: partial.team ?? defaults.team,
+    menu: partial.menu ?? defaults.menu,
+    products: partial.products ?? defaults.products,
+    announcements: partial.announcements ?? defaults.announcements,
+  };
+}