algolia-data-handling

# Algolia Data Handling ## Overview Algolia stores your records in their cloud. You control what data goes in (via `saveObjects`), what comes back (via `attributesToRetrieve`), and what users can search (via `searchableAttributes`). For privacy compliance, you must filter PII before indexing and implement deletion workflows. ## Data Flow: Source → Algolia → User ``` Source Database Transform Algolia Index Search Response ┌──────────┐ ┌──────────────┐ ┌──────────────────┐ ┌──────────────┐ │ Full user │ │ Strip PII │ │ Searchable │ │ Retrieved │ │ record │ ──▶ │ Truncate │ ──▶ │ fields only │ ──▶ │ fields only │ │ (all cols)│ │ Normalize │ │ + ranking data │ │ (UI needs) │ └──────────┘ └──────────────┘ └──────────────────┘ └──────────────┘ ``` ## Instructions ### Step 1: Transform Records Before Indexing ```typescript import { algoliasearch } from 'algoliasearch'; const client = algoliasearch(process.env.ALGOLIA_APP_ID!, process.env.ALGOLIA_ADMIN_KEY!); // Define what goes into Algolia — NOT everything from your DB interface AlgoliaProduct { objectID: string; name: string; description: string; // Truncated, plain text category: string; brand: string; price: number; in_stock: boolean; image_url: string; rating: number; _tags: string[]; } function transformForAlgolia(dbRecord: any): AlgoliaProduct { return { objectID: dbRecord.id, ...