@proxima-io/storefront-core 0.3.0 → 0.8.2

package/dist/index.d.ts

@@ -1,1311 +1,46 @@
-export interface ProximaApiConfig {
-    baseUrl: string;
-    domain: string;
-    path: string;
-    websiteId?: string;
-    businessId?: string;
-    serviceKey?: string;
-    /** UUID of a content variant — when set, composition returns the variant snapshot instead of live content. */
-    variantId?: string;
-    /** Preview token obtained from the rotate endpoint. Required when variantId is set. */
-    previewToken?: string;
-}
-export interface ProximaPageSummary {
-    name: string;
-    path: string;
-    resolver_kind: string;
-    is_active: boolean;
-}
-export interface ProximaWebsiteResponse {
-    id: string;
-    business_id: string;
-    name: string;
-    domain: string;
-    subdomain_slug?: string | null;
-    custom_domain?: string | null;
-    publication_status?: string;
-    published_at?: string | null;
-    delivery_mode: string;
-    data_mode?: string | null;
-    website_kind: string;
-    template_key?: string | null;
-    code_profile?: string | null;
-    locale: string;
-    currency: string;
-    og_image_url?: string | null;
-    logo_url?: string | null;
-    favicon_url?: string | null;
-    twitter_handle?: string | null;
-    capabilities: Record<string, any>;
-    theme_tokens: Record<string, any>;
-    animation_config: Record<string, any>;
-    pages: ProximaPageSummary[];
-    shell_sections?: Record<string, {
-        section_id: number;
-        section_type: string;
-        section_name: string;
-        attributes: Record<string, any>;
-    }>;
-}
-export interface ProximaCompositionResponse {
-    page_id: number;
-    website_id: string;
-    path: string;
-    path_template: string;
-    name: string;
-    entity_type?: string | null;
-    resolver_kind?: string | null;
-    route_params: Record<string, string>;
-    resolved_data?: Record<string, any> | null;
-    sections: Array<{
-        id: number;
-        name: string;
-        type: string;
-        order: number;
-        attributes: Record<string, any>;
-        attributes_meta?: Record<string, any>;
-    }>;
-    seo?: Record<string, any> | null;
-}
-export interface ProximaProductListResponse {
-    items: any[];
-    total: number;
-    page: number;
-    size: number;
-}
-/**
- * Fully resolved SEO metadata for a single page.
- * Produced by `buildPageSeo()` — pass directly to `SiteLayout.astro`.
- */
-export interface PageSeoMeta {
-    /** `<title>` tag content */
-    title: string;
-    /** `meta[name="description"]` */
-    description: string;
-    /** og:title */
-    ogTitle: string;
-    /** og:description */
-    ogDescription: string;
-    /** og:image and twitter:image — null when no image is available */
-    ogImage: string | null;
-    /** og:type — "website" | "product" */
-    ogType: string;
-    /** og:site_name */
-    ogSiteName: string;
-    /** og:url and link[rel="canonical"] */
-    canonicalUrl: string;
-    /** meta[name="robots"] — "index, follow" | "noindex, nofollow" */
-    robots: string;
-    /** twitter:card */
-    twitterCard: string;
-    /** twitter:site — "@handle" or null */
-    twitterSite: string | null;
-    /** twitter:image — mirrors ogImage */
-    twitterImage: string | null;
-    /** link[rel="icon"] — null when not set */
-    faviconUrl: string | null;
-}
-/**
- * Minimal website surface required by `buildPageSeo()`.
- * Both `ProximaWebsiteResponse` and the storefront's `ResolvedWebsite` satisfy this.
- */
-export interface PageSeoWebsiteMeta {
-    name: string;
-    og_image_url?: string | null;
-    favicon_url?: string | null;
-    twitter_handle?: string | null;
-}
-/**
- * Build fully resolved SEO metadata for a page.
- *
- * Data priority:
- *   1. Admin-set `PageSEO` fields in `composition.seo` (explicit overrides)
- *   2. Entity-derived data in `composition.seo.entity_name` / `entity_image` (auto-populated by API)
- *   3. Website-level defaults (`website.og_image_url`, etc.)
- *   4. Hard fallbacks (empty strings)
- *
- * @param seoData   The `seo` object from `ProximaCompositionResponse` (may be null)
- * @param website   Website-level SEO fields
- * @param locale    Locale code for resolving localized strings (e.g. "es")
- * @param currentUrl  Absolute URL of the current page — used as canonical fallback
- *
- * @example
- * const seo = buildPageSeo(composition.seo, website, website.locale, canonicalUrl);
- * // → pass to <SiteLayout seo={seo} />
- */
-export declare function buildPageSeo(seoData: Record<string, any> | null | undefined, website: PageSeoWebsiteMeta, locale: string, currentUrl: string): PageSeoMeta;
-/**
- * Minimal website surface required by the JSON-LD builders.
- * Both `ProximaWebsiteResponse` and the storefront's `ResolvedWebsite` satisfy this.
- */
-export interface JsonLdWebsiteMeta {
-    name: string;
-    domain: string;
-    logo_url?: string | null;
-    twitter_handle?: string | null;
-}
-/**
- * Minimal product surface required by `buildProductJsonLd()`.
- */
-export interface JsonLdProductMeta {
-    name: string;
-    slug: string;
-    description?: string | null;
-    image?: string | null;
-    images?: (string | null | undefined)[] | null;
-    sku?: string | null;
-    brand?: string | null;
-    productId?: number | string | null;
-    priceRaw: number;
-    compareAtPrice?: number | null;
-    inStock?: boolean | null;
-}
-/**
- * A single breadcrumb item.
- */
-export interface BreadcrumbItem {
-    label: string;
-    /** Relative or absolute href — omit for the last (current) item */
-    href?: string;
-}
-/**
- * Build a `WebSite` JSON-LD object.
- * Enables Google's Search Action box in SERPs.
- *
- * @example
- * <script type="application/ld+json" set:html={JSON.stringify(buildWebSiteJsonLd(website))} />
- */
-export declare function buildWebSiteJsonLd(website: JsonLdWebsiteMeta): Record<string, any>;
-/**
- * Build an `Organization` JSON-LD object.
- * Returns `null` when `website.logo_url` is absent (Google ignores logo-less org markup).
- *
- * @example
- * {orgJsonLd && <script type="application/ld+json" set:html={JSON.stringify(orgJsonLd)} />}
- */
-export declare function buildOrganizationJsonLd(website: JsonLdWebsiteMeta): Record<string, any> | null;
-/**
- * Build a `Product` JSON-LD object for a product detail page.
- * Includes `Offer` with pricing, currency, and availability.
- *
- * @example
- * <script type="application/ld+json" set:html={JSON.stringify(buildProductJsonLd(product, website))} />
- */
-export declare function buildProductJsonLd(product: JsonLdProductMeta, website: {
-    domain: string;
-    currency: string;
-}): Record<string, any>;
-/**
- * Build a `BreadcrumbList` JSON-LD object.
- *
- * @param items  Array of breadcrumb steps.  The last item typically has no `href`.
- * @param siteUrl  Absolute site URL, e.g. `https://example.com`
- *
- * @example
- * const crumbs = buildBreadcrumbJsonLd(
- *   [{ label: "Inicio", href: "/" }, { label: "Zapatos", href: "/categoria/zapatos" }, { label: "Nike Air Max" }],
- *   `https://${website.domain}`
- * );
- * <script type="application/ld+json" set:html={JSON.stringify(crumbs)} />
- */
-export declare function buildBreadcrumbJsonLd(items: BreadcrumbItem[], siteUrl: string): Record<string, any>;
-/**
- * Minimal surface for a LocalBusiness JSON-LD block (typically emitted by the Footer).
- * All fields are optional — only the ones present will appear in the output.
- */
-export interface JsonLdLocalBusinessMeta {
-    name: string;
-    url: string;
-    image?: string | null;
-    telephone?: string | null;
-    street_address?: string | null;
-    address_locality?: string | null;
-    address_region?: string | null;
-    postal_code?: string | null;
-    address_country?: string | null;
-    latitude?: number | null;
-    longitude?: number | null;
-    opening_hours?: string[] | null;
-    opens?: string | null;
-    closes?: string | null;
-    social_links?: string[] | null;
-}
-/**
- * Build a `LocalBusiness` JSON-LD object for brick-and-mortar stores.
- * Returns `null` when `seo` is falsy so callers can gate rendering easily.
- *
- * @example
- * const schema = buildLocalBusinessJsonLd(seo);
- * {schema && <script type="application/ld+json" set:html={JSON.stringify(schema)} />}
- */
-export declare function buildLocalBusinessJsonLd(seo: JsonLdLocalBusinessMeta | null | undefined): Record<string, unknown> | null;
-/** Minimal website surface needed by the sitemap / robots generators */
-export interface SitemapWebsiteMeta {
-    domain: string;
-    pages?: Array<{
-        resolver_kind: string;
-        path?: string | null;
-    }> | null;
-}
-/**
- * Generate a complete `sitemap.xml` for a storefront.
- *
- * Includes:
- *  1. Content pages from the website manifest (priority 1.0 for home, 0.8 for others)
- *  2. Category pages from the recursive nav tree (priority 0.8)
- *  3. Brand pages from the brands directory (priority 0.7)
- *  4. Product pages — paginated up to `maxProducts` (priority 0.9)
- *
- * All entries use today's date as `lastmod`.
- *
- * @param website  Resolved website object (domain + pages array)
- * @param apiUrl   Base URL of the Proxima API (e.g. `http://localhost:8000`)
- * @param options  Optional overrides: pageSize (default 60), maxProducts (default 3000)
- *
- * @example
- * // apps/{slug}/src/pages/sitemap.xml.ts
- * import type { APIRoute } from "astro";
- * import { resolveWebsiteOnly } from "@/lib/resolver";
- * import { generateSitemapXml } from "@proxima-io/storefront-core";
- *
- * export const GET: APIRoute = async () => {
- *   const website = await resolveWebsiteOnly();
- *   const xml = await generateSitemapXml(website, import.meta.env.PROXIMA_API_URL ?? "http://localhost:8000");
- *   return new Response(xml, {
- *     headers: { "Content-Type": "application/xml; charset=utf-8", "Cache-Control": "public, s-maxage=3600, stale-while-revalidate=86400" },
- *   });
- * };
- */
-export declare function generateSitemapXml(website: SitemapWebsiteMeta, apiUrl: string, options?: {
-    pageSize?: number;
-    maxProducts?: number;
-}): Promise<string>;
-/**
- * Generate a `robots.txt` for a storefront.
- *
- * Blocks all private buyer routes and API paths.
- * Adds a `Sitemap:` directive pointing to `{siteUrl}/sitemap.xml`.
- *
- * @example
- * // apps/{slug}/src/pages/robots.txt.ts
- * import type { APIRoute } from "astro";
- * import { resolveWebsiteOnly } from "@/lib/resolver";
- * import { generateRobotsTxt } from "@proxima-io/storefront-core";
- *
- * export const GET: APIRoute = async () => {
- *   const website = await resolveWebsiteOnly();
- *   return new Response(generateRobotsTxt(website), {
- *     headers: { "Content-Type": "text/plain; charset=utf-8", "Cache-Control": "public, max-age=86400" },
- *   });
- * };
- */
-export declare function generateRobotsTxt(website: {
-    domain: string;
-}): string;
-/**
- * Submit a list of changed URLs to the IndexNow API.
- *
- * IndexNow notifies Bing, Yandex, and (increasingly) Google about new or
- * updated pages so they are re-crawled within seconds instead of waiting for
- * the next sitemap crawl.
- *
- * **Setup (one-time per storefront):**
- * 1. Generate or reuse the key from `PROXIMA_INDEXNOW_KEY` env var.
- * 2. Serve `GET /{key}.txt` returning the key as plain text — see the scaffold
- *    template at `src/pages/[indexnow_key].txt.ts`.
- * 3. That's it — IndexNow verifies the key automatically on first submission.
- *
- * @param apiKey   Your IndexNow key (platform-level; served at `/{apiKey}.txt`)
- * @param siteUrl  Absolute origin of the site, e.g. `https://example.com`
- * @param urls     Absolute URLs that changed (max 10 000 per call)
- *
- * @example
- * await notifyIndexNow("my-secret-key", "https://214store.com", [
- *   "https://214store.com/producto/laptop-gamer",
- * ]);
- */
-export declare function notifyIndexNow(apiKey: string, siteUrl: string, urls: string[]): Promise<void>;
-/** List all websites for a service-key authenticated caller. Useful for build-time scripts. */
-export declare function fetchProximaWebsiteList(config: Pick<ProximaApiConfig, "baseUrl" | "serviceKey">): Promise<ProximaWebsiteResponse[]>;
-/**
- * Resolve a website by domain/host. Call this once per request and cache the result.
- * Pass `host` if the incoming request host differs from `config.domain` (e.g. in middleware).
- *
- * @example
- * const website = await fetchProximaWebsite({ baseUrl: env.apiUrl, domain: Astro.url.hostname });
- */
-export declare function fetchProximaWebsite(config: Pick<ProximaApiConfig, "baseUrl" | "domain" | "serviceKey"> & {
-    host?: string;
-}): Promise<ProximaWebsiteResponse>;
-/**
- * Build a synthetic `ProximaWebsiteResponse` for the visual builder preview.
- * Use this when the builder passes `websiteId` and `businessId` via query params
- * instead of resolving by domain.
- */
-export declare function makeBuilderPreviewWebsite(config: Pick<ProximaApiConfig, "websiteId" | "businessId" | "domain">): ProximaWebsiteResponse;
-/**
- * Fetch the fully resolved page composition for the given path.
- * This is the main data-fetching call for every SSR page render.
- * The response embeds all section data (via smart collections) and, for detail pages,
- * the primary entity in `resolved_data` (product, category, brand, blog post).
- * No additional catalog API calls are needed for the initial render.
- *
- * @example
- * // src/pages/[...path].astro
- * const composition = await fetchProximaComposition(
- *   { ...config, path: Astro.url.pathname },
- *   website
- * );
- */
-export declare function fetchProximaComposition(config: ProximaApiConfig, website: ProximaWebsiteResponse): Promise<ProximaCompositionResponse>;
-/**
- * @deprecated Use `fetchStorefrontProducts` instead. This function calls the raw
- * catalog endpoint (`/api/v1/products`) which is not enriched for storefront use
- * (no price_formatted, no badge, no default_variant_id). It will be removed in a future version.
- */
-export declare function fetchProximaProducts(config: Pick<ProximaApiConfig, "baseUrl" | "serviceKey">, website: ProximaWebsiteResponse): Promise<ProximaProductListResponse>;
-/** Well-known error detail strings returned by the API. Use these for comparison
- *  instead of hardcoding strings in your storefront.
- *
- * @example
- * try { await resetPassword(...) } catch (e: any) {
- *   if (e.data?.detail === BUYER_AUTH_ERRORS.RESET_TOKEN_INVALID) { ... }
- * }
- */
-export declare const BUYER_AUTH_ERRORS: {
-    readonly RESET_TOKEN_INVALID: "RESET_TOKEN_INVALID";
-    readonly VERIFY_TOKEN_INVALID: "VERIFY_TOKEN_INVALID";
-    readonly EMAIL_ALREADY_VERIFIED: "EMAIL_ALREADY_VERIFIED";
-    readonly EMAIL_TAKEN: "Email already registered in this store";
-    readonly MISSING_REQUIRED_FIELDS: "MISSING_REQUIRED_FIELDS";
-};
-/** Token pair returned by /store/auth/register, /store/auth/login, /store/auth/refresh */
-export interface BuyerSession {
-    access_token: string;
-    refresh_token: string | null;
-    token_type: string;
-}
-/** Full customer profile from GET /store/me */
-export interface BuyerProfile {
-    id: number;
-    email: string;
-    business_id: string;
-    full_name: string | null;
-    phone: string | null;
-    doc_type: number | null;
-    doc_number: string | null;
-    birth_date: string | null;
-    newsletter_subscribed: boolean;
-    avatar_url: string | null;
-    metadata: Record<string, any>;
-    registration_source: string;
-    last_login_at: string | null;
-    is_active: boolean;
-    created_at: string;
-    updated_at: string;
-}
-/** A single resolved field in the storefront registration form. */
-export interface RegistrationFormField {
-    name: string;
-    label: string;
-    /** "text" | "password" | "phone" | "date" | "select" | "boolean" | "image" | "address" | "custom" */
-    type: string;
-    /** "text_input" | "phone_input" | "date_picker" | "select" | "checkbox" | "toggle"
-     *  | "image_upload" | "ubigeo_selector" | "google_maps_picker" | "manual" */
-    widget: string;
-    widget_config: Record<string, any>;
-    required: boolean;
-    order: number;
-    options: string[] | null;
-}
-/** A single step in the form (always at least one). */
-export interface RegistrationFormStep {
-    id: string;
-    label: string;
-    order: number;
-    skippable: boolean;
-    fields: RegistrationFormField[];
-}
-/** Full resolved form schema from GET /store/auth/registration-form.
- *  `email` and `password` are always present in steps[0].fields — no need to add them. */
-export interface RegistrationForm {
-    mode: "single_step" | "multi_step";
-    steps: RegistrationFormStep[];
-}
-/** Address submitted during customer registration. */
-export interface AddressInRegistration {
-    line1: string;
-    line2?: string | null;
-    reference?: string | null;
-    /** 6-digit Peruvian ubigeo code, e.g. "150101" */
-    ubigeo_code?: string | null;
-    latitude?: number | null;
-    longitude?: number | null;
-    /** "google_maps" | "ubigeo_centroid" | "manual" */
-    geocoding_source?: string | null;
-}
-/** All accepted fields for POST /store/auth/register.
- *  Which fields are required depends on the merchant's registration form configuration.
- *  Use fetchRegistrationForm() to know which fields to show and which are required. */
-export interface BuyerRegisterParams {
-    email: string;
-    password: string;
-    fullName?: string | null;
-    phone?: string | null;
-    /** 1=DNI 2=CE 3=Pasaporte 6=RUC */
-    docType?: number | null;
-    docNumber?: string | null;
-    /** ISO date "YYYY-MM-DD" */
-    birthDate?: string | null;
-    newsletterSubscribed?: boolean;
-    /** Default "organic". */
-    registrationSource?: string;
-    /** Custom fields configured by the merchant — keyed by field name. */
-    metadata?: Record<string, any>;
-    address?: AddressInRegistration | null;
-    /** Cloudflare Turnstile token from the widget — required when API has TURNSTILE_ENABLED=true */
-    captchaToken?: string | null;
-}
-/** A single field that was missing in the registration request. */
-export interface MissingField {
-    field: string;
-    msg: string;
-}
-/**
- * Thrown when the API returns 422 MISSING_REQUIRED_FIELDS.
- * Use `error.missingFields` to mark exactly which fields are invalid in the UI.
- *
- * @example
- * try {
- *   await registerBuyer(config, website, params);
- * } catch (e) {
- *   if (e instanceof MissingFieldsError) {
- *     for (const { field } of e.missingFields) markFieldError(field);
- *   }
- * }
- */
-export declare class MissingFieldsError extends Error {
-    status: 422;
-    missingFields: MissingField[];
-    constructor(missingFields: MissingField[]);
-}
-/** Fields the customer can update via PATCH /store/me/profile. All optional. */
-export interface BuyerProfileUpdateParams {
-    fullName?: string | null;
-    phone?: string | null;
-    /** 1=DNI 2=CE 3=Pasaporte 6=RUC */
-    docType?: number | null;
-    docNumber?: string | null;
-    /** ISO date "YYYY-MM-DD" */
-    birthDate?: string | null;
-    newsletterSubscribed?: boolean;
-    avatarUrl?: string | null;
-    /** If provided, changes the customer's password. */
-    password?: string;
-}
-/** Lightweight product representation used in listings, search results, and smart collections. */
-export interface StorefrontProductSummary {
-    id: number;
-    name: string;
-    slug: string;
-    price: number;
-    price_formatted?: string | null;
-    image_url: string;
-    brand_name?: string | null;
-    category_name?: string | null;
-    /** Promotional badge text, e.g. "OFERTA", "NUEVO" */
-    badge?: string | null;
-    rating: number;
-    currency?: string | null;
-    /** First variant id — use this when calling addToCart from a listing card */
-    default_variant_id?: number | null;
-}
-/** Pagination metadata returned by listing endpoints. */
-export interface StorefrontPagination {
-    page: number;
-    page_size: number;
-    total: number;
-    total_pages: number;
-}
-export interface StorefrontSortOption {
-    value: string;
-    label: string;
-}
-export interface StorefrontFacetOption {
-    value: string;
-    label: string;
-    count: number;
-}
-/** Response from GET /storefront/search */
-export interface StorefrontSearchResponse {
-    query: string;
-    hits: StorefrontProductSummary[];
-    total: number;
-}
-/** Response from GET /storefront/products (all-products listing with facets) */
-export interface StorefrontProductListingResponse {
-    items: StorefrontProductSummary[];
-    pagination: StorefrontPagination;
-    sort_current: string;
-    sort_options: StorefrontSortOption[];
-    brand_facets: StorefrontFacetOption[];
-    category_facets: StorefrontFacetOption[];
-}
-export interface StorefrontCategorySummary {
-    id: number;
-    name: string;
-    slug: string;
-    image_url?: string | null;
-}
-export interface StorefrontBrandSummary {
-    id: number;
-    name: string;
-    slug: string;
-    logo_url?: string | null;
-}
-/** Response from GET /storefront/categories/{slug}/products */
-export interface StorefrontCategoryListingResponse {
-    category: StorefrontCategorySummary;
-    items: StorefrontProductSummary[];
-    pagination: StorefrontPagination;
-    sort_current: string;
-    sort_options: StorefrontSortOption[];
-    brand_facets: StorefrontFacetOption[];
-}
-/** Response from GET /storefront/brands/{slug}/products */
-export interface StorefrontBrandListingResponse {
-    brand: StorefrontBrandSummary;
-    items: StorefrontProductSummary[];
-    pagination: StorefrontPagination;
-    sort_current: string;
-    sort_options: StorefrontSortOption[];
-    category_facets: StorefrontFacetOption[];
-}
-export interface StorefrontCategoryDirectoryItem {
-    id: number;
-    name: string;
-    slug: string;
-    href: string;
-    image_url?: string | null;
-    description?: string | null;
-    product_count: number;
-}
-export interface StorefrontBrandDirectoryItem {
-    id: number;
-    name: string;
-    slug: string;
-    href: string;
-    logo_url?: string | null;
-    product_count: number;
-}
-export interface StorefrontCategoryDirectoryResponse {
-    items: StorefrontCategoryDirectoryItem[];
-    total: number;
-}
-export interface StorefrontBrandDirectoryResponse {
-    items: StorefrontBrandDirectoryItem[];
-    total: number;
-}
-/** Shared params for product listing endpoints — sort, pagination, filters. */
-export interface StorefrontListingParams {
-    /** Page number, starting at 1 */
-    page?: number;
-    /** Items per page (1–60). Default: 24 */
-    pageSize?: number;
-    /** "newest" | "price_asc" | "price_desc" | "popular". Default: "newest" */
-    sort?: string;
-    /** Locale for translated names, e.g. "es", "en" */
-    locale?: string;
-    /** ISO currency code, e.g. "PEN", "USD" */
-    currency?: string;
-}
-/** Coupon validation result from GET /commerce/coupons/validate */
-export interface CouponValidationResult {
-    valid: boolean;
-    code?: string;
-    /** Amount to deduct from the order total */
-    discount_amount?: number;
-    /** "percentage" | "fixed" */
-    discount_type?: string;
-    discount_value?: number;
-    /** Error message when valid=false */
-    error?: string;
-}
-/** A line item inside a Cart. */
-export interface CartItem {
-    id: number;
-    product_variant_id: number;
-    quantity: number;
-    metadata?: {
-        name?: string | null;
-        slug?: string | null;
-        brand?: string | null;
-        image?: string | null;
-        unit_price?: number | null;
-        unit_price_string?: string | null;
-    } | null;
-}
-export interface CartTotals {
-    subtotal: number;
-    formatted_subtotal: string;
-    currency: string;
-}
-/** Shopping cart for a guest session or authenticated customer. */
-export interface Cart {
-    id: string;
-    session_id?: string | null;
-    customer_id?: number | null;
-    items: CartItem[];
-    totals: CartTotals;
-}
-/** Customer and shipping details submitted at checkout. */
-export interface CheckoutRequest {
-    customer_name: string;
-    customer_phone: string;
-    customer_email?: string | null;
-    shipping_address?: string | null;
-    notes?: string | null;
-    coupon_code?: string | null;
-    customer_doc_type?: number | null;
-    customer_doc_number?: string | null;
-    address_id?: number | null;
-}
-export interface UbigeoResult {
-    code: string;
-    department: string;
-    province: string;
-    district: string;
-    full_name: string;
-}
-export interface CustomerAddress {
-    id: number;
-    customer_id: number;
-    business_id: string;
-    label?: string | null;
-    recipient_name?: string | null;
-    phone?: string | null;
-    line1: string;
-    line2?: string | null;
-    ubigeo_code?: string | null;
-    ubigeo?: UbigeoResult | null;
-    reference?: string | null;
-    latitude?: number | null;
-    longitude?: number | null;
-    geocoding_source?: string | null;
-    is_default: boolean;
-    created_at: string;
-    updated_at: string;
-}
-export interface AddressInput {
-    label?: string | null;
-    recipient_name?: string | null;
-    phone?: string | null;
-    line1: string;
-    line2?: string | null;
-    ubigeo_code?: string | null;
-    reference?: string | null;
-    latitude?: number | null;
-    longitude?: number | null;
-    geocoding_source?: string | null;
-    is_default?: boolean;
-}
-export interface OrderItem {
-    id: number;
-    product_variant_id?: number | null;
-    product_id?: number | null;
-    product_slug?: string | null;
-    product_image?: string | null;
-    product_name?: string | null;
-    brand_name?: string | null;
-    category_name?: string | null;
-    sku?: string | null;
-    quantity: number;
-    price_at_purchase?: number | null;
-    /** @deprecated use price_at_purchase */
-    unit_price?: number | null;
-    /** @deprecated use product_name */
-    name?: string | null;
-}
-/** An order placed by a customer. */
-export interface Order {
-    id: string;
-    order_number?: string | null;
-    status: string;
-    total_amount?: number | null;
-    currency?: string | null;
-    customer_name?: string | null;
-    customer_phone?: string | null;
-    customer_email?: string | null;
-    shipping_address?: string | null;
-    created_at: string;
-    items?: OrderItem[];
-    /** @deprecated use total_amount */
-    total?: number;
-}
-export interface OrderListResponse {
-    items: Order[];
-    total: number;
-    page: number;
-    size: number;
-}
-/** A single item in the customer's wishlist. */
-export interface WishlistItem {
-    id: number;
-    customer_id: number;
-    business_id: string;
-    product_id: string;
-    variant_id: string | null;
-    notes: string | null;
-    added_at: string;
-}
-/**
- * Environment variables needed by server-side `process*` helpers.
- * Typically populated from `import.meta.env` in an Astro API route.
- */
-export interface BuyerServerEnv {
-    apiUrl: string;
-    domain: string;
-    serviceKey?: string;
-}
-/** Recommended options for the buyer session cookie. Apply to both `buyer_token` and `buyer_refresh_token`. */
-export declare const BUYER_COOKIE_OPTIONS: {
-    readonly path: "/";
-    readonly httpOnly: true;
-    readonly sameSite: "lax";
-    readonly maxAge: number;
-};
-export declare const BUYER_COOKIE_NAME = "buyer_token";
-export declare const BUYER_REFRESH_COOKIE_NAME = "buyer_refresh_token";
-/**
- * Fetch the merchant-configured registration form schema.
- * Call this server-side in your /register page to know which fields to render
- * and which are required. `email` and `password` are always prepended by the API.
- *
- * @example
- * // src/pages/register.astro
- * const form = await fetchRegistrationForm({ baseUrl: env.apiUrl }, website);
- * // Pass `form` as a prop to a client component that renders the dynamic form
- */
-export declare function fetchRegistrationForm(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">): Promise<RegistrationForm>;
-/**
- * Register a new customer. The merchant decides which fields are required —
- * call fetchRegistrationForm() first to know what to collect.
- *
- * Throws MissingFieldsError when the merchant marked fields as required but
- * they were omitted, so you can mark exactly which inputs are invalid.
- *
- * @example
- * try {
- *   const session = await registerBuyer(config, website, { email, password, fullName });
- * } catch (e) {
- *   if (e instanceof MissingFieldsError) {
- *     e.missingFields.forEach(({ field }) => markError(field));
- *   }
- * }
- */
-export declare function registerBuyer(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: BuyerRegisterParams): Promise<BuyerSession>;
-/**
- * Authenticate a customer with email and password.
- * Returns a BuyerSession with access_token and refresh_token.
- * Throws { status: 401 } on wrong credentials.
- */
-export declare function loginBuyer(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    email: string;
-    password: string;
-    captchaToken?: string | null;
-}): Promise<BuyerSession>;
-/** Invalidate the current session server-side. Best-effort — always clear the cookie too. */
-export declare function logoutBuyer(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    token: string;
-}): Promise<void>;
-/**
- * Exchange a refresh token for a new access token.
- * Call this when you get a 401 on any authenticated request.
- * Throws { status: 401 } if the refresh token is expired or revoked.
- *
- * @example
- * // In Astro middleware:
- * try {
- *   const session = await refreshBuyerToken(config, website, { refreshToken });
- *   // Set new access_token cookie
- * } catch {
- *   // Clear both cookies, redirect to login
- * }
- */
-export declare function refreshBuyerToken(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    refreshToken: string;
-}): Promise<BuyerSession>;
-/** Fetch the authenticated customer's full profile. */
-export declare function fetchBuyerProfile(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    token: string;
-}): Promise<BuyerProfile>;
-/**
- * Update the authenticated customer's profile. Only the fields you include
- * in `params` are changed — it's a partial update.
- */
-export declare function updateBuyerProfile(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    token: string;
-} & BuyerProfileUpdateParams): Promise<BuyerProfile>;
-/**
- * Send a password reset email. Always resolves — even if the email doesn't exist.
- * Always show: "Si el email existe, recibirás un enlace para restablecer tu contraseña."
- */
-export declare function forgotPassword(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    email: string;
-    captchaToken?: string | null;
-}): Promise<void>;
-/**
- * Reset the customer's password using the token from the reset email link.
- * The token is the `?token=` query param in the reset URL.
- * On success, all active sessions are revoked — redirect to login.
- * Throws { status: 400, data.detail: BUYER_AUTH_ERRORS.RESET_TOKEN_INVALID } on bad token.
- */
-export declare function resetPassword(config: Pick<ProximaApiConfig, "baseUrl">, params: {
-    token: string;
-    newPassword: string;
-}): Promise<void>;
-/**
- * Verify the customer's email using the token from the verification email link.
- * Throws { status: 400, data.detail: BUYER_AUTH_ERRORS.VERIFY_TOKEN_INVALID } on bad token.
- */
-export declare function verifyEmail(config: Pick<ProximaApiConfig, "baseUrl">, params: {
-    token: string;
-}): Promise<void>;
-/**
- * Re-send the email verification link. Requires the customer to be authenticated.
- * Throws { status: 400, data.detail: BUYER_AUTH_ERRORS.EMAIL_ALREADY_VERIFIED } if already verified.
- */
-export declare function resendVerification(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    token: string;
-}): Promise<void>;
-/**
- * Search products by query string. Use this for the search bar, autocomplete,
- * and search results pages — `resolved_data` for a `search` page is intentionally
- * null; query results must be fetched directly.
- *
- * @example
- * const results = await searchStorefront(config, website, { q: 'zapatillas', limit: 10 });
- */
-export declare function searchStorefront(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id" | "locale" | "currency">, params: {
-    q: string;
-    limit?: number;
-    locale?: string;
-    currency?: string;
-}): Promise<StorefrontSearchResponse>;
-/**
- * Fetch the general product listing with optional filters and pagination.
- * Use this for client-side filter/sort/paginate interactions on the all-products page.
- * The initial page render is handled by the composition — call this for subsequent
- * filter changes and page turns.
- */
-export declare function fetchStorefrontProducts(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id" | "locale" | "currency">, params?: StorefrontListingParams & {
-    brand?: string;
-    category?: string;
-    q?: string;
-}): Promise<StorefrontProductListingResponse>;
-/**
- * Fetch paginated + filtered products for a category page (CLP).
- * Use this for client-side filter/sort/paginate after the initial SSR render
- * (which arrives in `resolved_data` from `fetchProximaComposition`).
- */
-export declare function fetchCategoryProducts(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id" | "locale" | "currency">, params: StorefrontListingParams & {
-    /** Category slug, from the URL path */
-    slug: string;
-    brand?: string;
-    q?: string;
-}): Promise<StorefrontCategoryListingResponse>;
-/**
- * Fetch paginated + filtered products for a brand page (BLP).
- * Use this for client-side filter/sort/paginate after the initial SSR render
- * (which arrives in `resolved_data` from `fetchProximaComposition`).
- */
-export declare function fetchBrandProducts(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id" | "locale" | "currency">, params: StorefrontListingParams & {
-    /** Brand slug, from the URL path */
-    slug: string;
-    category?: string;
-    q?: string;
-}): Promise<StorefrontBrandListingResponse>;
-/**
- * Fetch the full category directory (all categories with product counts).
- * Useful for navigation menus and sitemap generation.
- * For section-level category carousels, use smart collections via composition instead.
- */
-export declare function fetchCategoriesDirectory(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id" | "locale">, params?: {
-    locale?: string;
-}): Promise<StorefrontCategoryDirectoryResponse>;
-/**
- * A single node in the category navigation tree.
- * `children` contains nodes at the next depth level (up to `max_depth`).
- */
-export interface CategoryNavNode {
-    id: number;
-    slug: string;
-    name: string;
-    /** Storefront href — always `/categoria/{slug}` */
-    href: string;
-    image_url?: string | null;
-    product_count: number;
-    children: CategoryNavNode[];
-}
-export interface CategoryNavTreeResponse {
-    nodes: CategoryNavNode[];
-    total: number;
-}
-/**
- * Fetch the full category hierarchy as a recursive tree.
- * Use this for data-driven mega menus — it returns nested `children[]`
- * with `/categoria/{slug}` hrefs ready to render.
- *
- * @param maxDepth - Maximum tree depth (1–5, default 3)
- */
-export declare function fetchCategoryNavTree(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id" | "locale">, params?: {
-    maxDepth?: number;
-    locale?: string;
-}): Promise<CategoryNavTreeResponse>;
-/**
- * Fetch the full brand directory (all brands with product counts).
- * Useful for navigation menus and sitemap generation.
- */
-export declare function fetchBrandsDirectory(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id" | "locale">, params?: {
-    locale?: string;
-}): Promise<StorefrontBrandDirectoryResponse>;
-/** Fetch the current cart. Works for both guest sessions and authenticated customers. */
-export declare function fetchCart(config: Pick<ProximaApiConfig, "baseUrl">, website: ProximaWebsiteResponse, params: {
-    token?: string | null;
-    sessionId?: string | null;
-}): Promise<Cart>;
-/**
- * Add a product variant to the cart. Use `StorefrontProductSummary.default_variant_id`
- * as `variantId` when adding from a listing card.
- */
-export declare function addToCart(config: Pick<ProximaApiConfig, "baseUrl">, website: ProximaWebsiteResponse, params: {
-    token?: string | null;
-    sessionId?: string | null;
-    variantId: number;
-    quantity: number;
-}): Promise<Cart>;
-/** Update the quantity of an existing cart item. Set `quantity` to 0 to remove it. */
-export declare function updateCartItem(config: Pick<ProximaApiConfig, "baseUrl">, website: ProximaWebsiteResponse, params: {
-    token?: string | null;
-    sessionId?: string | null;
-    variantId: number;
-    quantity: number;
-}): Promise<Cart>;
-/** Remove a product variant from the cart entirely. */
-export declare function removeCartItem(config: Pick<ProximaApiConfig, "baseUrl">, website: ProximaWebsiteResponse, params: {
-    token?: string | null;
-    sessionId?: string | null;
-    variantId: number;
-}): Promise<Cart>;
-/**
- * Merge a guest cart (identified by session ID) into the authenticated customer's cart.
- * Call this immediately after a successful login if there is an active guest session.
- *
- * @example
- * const sessionId = localStorage.getItem('proxima_session_id');
- * if (sessionId) await mergeGuestCart(config, website, { token, sessionId });
- */
-export declare function mergeGuestCart(config: Pick<ProximaApiConfig, "baseUrl">, website: ProximaWebsiteResponse, params: {
-    token: string;
-    sessionId: string;
-}): Promise<Cart>;
-/**
- * Validate a coupon code before checkout. Always resolves — check `result.valid`.
- * Use the `discount_amount` from the result to preview the discount in the UI.
- *
- * @example
- * const result = await validateCoupon(config, website, { code: 'PROMO10', amount: 150.00 });
- * if (result.valid) showDiscount(result.discount_amount);
- * else showError(result.error);
- */
-export declare function validateCoupon(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    code: string;
-    amount: number;
-}): Promise<CouponValidationResult>;
-/**
- * Submit the current cart as an order (checkout). The cart must be non-empty.
- * On success the cart is cleared. Throws 400 on validation errors (e.g. out of stock).
- */
-export declare function createOrder(config: Pick<ProximaApiConfig, "baseUrl">, website: ProximaWebsiteResponse, params: {
-    token: string;
-    checkout: CheckoutRequest;
-}): Promise<Order>;
-/** Fetch the authenticated customer's order history, paginated. */
-export declare function fetchOrders(config: Pick<ProximaApiConfig, "baseUrl">, website: ProximaWebsiteResponse, params: {
-    token: string;
-    page?: number;
-    size?: number;
-}): Promise<OrderListResponse>;
-/** Fetch a single order by ID. Works for authenticated customers and guests with the receipt token. */
-export declare function fetchOrder(config: Pick<ProximaApiConfig, "baseUrl">, website: ProximaWebsiteResponse, params: {
-    token: string;
-    orderId: string;
-}): Promise<Order>;
-/** Fetch all saved addresses for the authenticated customer. */
-export declare function fetchCustomerAddresses(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    token: string;
-}): Promise<CustomerAddress[]>;
-/** Save a new address to the customer's address book. */
-export declare function createCustomerAddress(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    token: string;
-    address: AddressInput;
-}): Promise<CustomerAddress>;
-/** Partially update a saved address. Only the fields included in `address` are changed. */
-export declare function updateCustomerAddress(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    token: string;
-    addressId: number;
-    address: Partial<AddressInput>;
-}): Promise<CustomerAddress>;
-/** Delete a saved address. Throws if the address does not exist. */
-export declare function deleteCustomerAddress(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    token: string;
-    addressId: number;
-}): Promise<void>;
-/** Mark an address as the customer's default. The previous default is unset automatically. */
-export declare function setDefaultAddress(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    token: string;
-    addressId: number;
-}): Promise<CustomerAddress>;
-/**
- * Search Peruvian ubigeo codes (department/province/district) by name.
- * Use this to power the address form's location selector.
- * Returns an empty array on error instead of throwing.
- */
-export declare function searchUbigeo(config: Pick<ProximaApiConfig, "baseUrl">, params: {
-    q: string;
-}): Promise<UbigeoResult[]>;
-/**
- * Fetch all wishlist items for the authenticated customer.
- * Returns an empty array if the wishlist is empty.
- */
-export declare function fetchWishlist(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    token: string;
-}): Promise<WishlistItem[]>;
-/**
- * Add a product to the wishlist. Idempotent — if the product is already
- * in the wishlist, returns the existing item without creating a duplicate.
- */
-export declare function addToWishlist(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    token: string;
-    productId: string;
-    variantId?: string | null;
-    notes?: string | null;
-}): Promise<WishlistItem>;
-/**
- * Remove a product from the wishlist.
- * Throws { status: 404 } if the product was not in the wishlist.
- */
-export declare function removeFromWishlist(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, params: {
-    token: string;
-    productId: string;
-}): Promise<void>;
-/**
- * Resolve the website then call loginBuyer.
- * Returns { access_token, refresh_token, next } on success, throws on failure.
- */
-export declare function processBuyerLogin(env: BuyerServerEnv, params: {
-    email: string;
-    password: string;
-    next?: string;
-    captchaToken?: string | null;
-}): Promise<{
-    access_token: string;
-    refresh_token: string | null;
-    next: string;
-}>;
-/**
- * Resolve the website then call registerBuyer.
- * Returns { access_token, refresh_token, next } on success, throws on failure.
- * Propagates MissingFieldsError so the API route can return structured 422 errors.
- */
-export declare function processBuyerRegister(env: BuyerServerEnv, params: BuyerRegisterParams & {
-    next?: string;
-}): Promise<{
-    access_token: string;
-    refresh_token: string | null;
-    next: string;
-}>;
-/**
- * Call logoutBuyer (best-effort — never throws).
- * Always clear the session cookie regardless of the result.
- */
-export declare function processBuyerLogout(env: BuyerServerEnv, params: {
-    token: string;
-}): Promise<void>;
-/**
- * Resolve the website then exchange a refresh token for a new access token.
- * Use this in Astro middleware to silently refresh expired sessions.
- * Throws { status: 401 } if the refresh token is expired — clear cookies and redirect to login.
- */
-export declare function processRefreshToken(env: BuyerServerEnv, params: {
-    refreshToken: string;
-}): Promise<{
-    access_token: string;
-    refresh_token: string | null;
-}>;
-/**
- * Resolve the website then send a password reset email.
- * Never throws — always show a generic confirmation message.
- */
-export declare function processForgotPassword(env: BuyerServerEnv, params: {
-    email: string;
-    captchaToken?: string | null;
-}): Promise<void>;
-/**
- * Reset the customer's password with the token from the email link.
- * Throws { status: 400, data.detail: BUYER_AUTH_ERRORS.RESET_TOKEN_INVALID } on bad token.
- */
-export declare function processResetPassword(env: BuyerServerEnv, params: {
-    token: string;
-    newPassword: string;
-}): Promise<void>;
-/**
- * Verify the customer's email with the token from the email link.
- * Throws { status: 400, data.detail: BUYER_AUTH_ERRORS.VERIFY_TOKEN_INVALID } on bad token.
- */
-export declare function processVerifyEmail(env: BuyerServerEnv, params: {
-    token: string;
-}): Promise<void>;
-/**
- * Resolve the website then add a variant to the cart.
- * Token is optional (guest cart supported).
- */
-export declare function processAddToCart(env: BuyerServerEnv, params: {
-    token?: string | null;
-    sessionId?: string | null;
-    variantId: number;
-    quantity: number;
-}): Promise<Cart>;
-/**
- * Resolve the website then remove a variant from the cart.
- * Token is optional (guest cart supported).
- */
-export declare function processRemoveCartItem(env: BuyerServerEnv, params: {
-    token?: string | null;
-    sessionId?: string | null;
-    variantId: number;
-}): Promise<Cart>;
-/**
- * Resolve the website then update the quantity of a variant in the cart.
- * Token is optional (guest cart supported).
- */
-export declare function processUpdateCartItem(env: BuyerServerEnv, params: {
-    token?: string | null;
-    sessionId?: string | null;
-    variantId: number;
-    quantity: number;
-}): Promise<Cart>;
-/**
- * Resolve the website then fetch the current cart.
- * Token is optional (guest cart supported).
- */
-export declare function processGetCart(env: BuyerServerEnv, params: {
-    token?: string | null;
-    sessionId?: string | null;
-}): Promise<Cart>;
-/**
- * Resolve the website then call POST /checkout.
- * Returns { orderId } on success, throws on failure.
- */
-export declare function processBuyerCheckout(env: BuyerServerEnv, params: {
-    token: string;
-    checkout: CheckoutRequest;
-}): Promise<{
-    orderId: string;
-}>;
-/** Resolve website then set the customer's default address. */
-export declare function processSetDefaultAddress(env: BuyerServerEnv, params: {
-    token: string;
-    addressId: number;
-}): Promise<CustomerAddress>;
-/** Resolve website then delete a saved address. */
-export declare function processDeleteAddress(env: BuyerServerEnv, params: {
-    token: string;
-    addressId: number;
-}): Promise<void>;
-export interface ProductListingFilters {
-    brand?: string | null;
-    category?: string | null;
-    price_min?: number | null;
-    price_max?: number | null;
-    in_stock?: boolean | null;
-}
-export type ProductListingSortOption = "newest" | "price_asc" | "price_desc" | "name_asc";
-/** @deprecated Use StorefrontFacetOption from the main listing types */
-export type ProductFacet = StorefrontFacetOption;
-/** @deprecated Use StorefrontProductListingResponse */
-export type ProductListingResult = StorefrontProductListingResponse;
-/**
- * Fetch a filtered, sorted, paginated product listing.
- * Extends fetchStorefrontProducts with price range and stock filters.
- */
-export declare function fetchProductListing(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id" | "locale" | "currency">, params?: {
-    filters?: ProductListingFilters;
-    sort?: ProductListingSortOption;
-    page?: number;
-    page_size?: number;
-}): Promise<StorefrontProductListingResponse>;
-export interface GuestOrderPayload {
-    session_id: string;
-    customer_name: string;
-    customer_phone: string;
-    customer_email: string;
-    shipping_address?: string | null;
-    notes?: string | null;
-}
-export interface GuestOrderResult {
-    orderId: string;
-}
-export declare class GuestOrderError extends Error {
-    readonly code: "CART_NOT_FOUND" | "OUT_OF_STOCK" | "SERVER_ERROR";
-    constructor(code: "CART_NOT_FOUND" | "OUT_OF_STOCK" | "SERVER_ERROR", message: string);
-}
-/**
- * Create an order without buyer authentication.
- * The cart is identified by `session_id` (from the storefront session cookie).
- * Throws `GuestOrderError` for typed error cases.
- */
-export declare function initiateGuestOrder(config: Pick<ProximaApiConfig, "baseUrl">, website: Pick<ProximaWebsiteResponse, "business_id">, payload: GuestOrderPayload): Promise<GuestOrderResult>;
-/**
- * Resolve website then call initiateGuestOrder.
- * Server-side helper for Astro API routes.
- */
-export declare function processGuestCheckout(env: BuyerServerEnv, payload: GuestOrderPayload): Promise<GuestOrderResult>;
-export type StorefrontEventType = 'page_view' | 'product_view' | 'add_to_cart' | 'order_completed' | 'search';
-export interface StorefrontEventPayload {
-    product_slug?: string;
-    product_id?: string;
-    product_name?: string;
-    variant_id?: number;
-    quantity?: number;
-    price?: number;
-    order_id?: string;
-    order_total?: number;
-    query?: string;
-    results_count?: number;
-    [key: string]: unknown;
-}
-export interface StorefrontAnalyticsConfig {
-    apiUrl: string;
-    websiteId: string;
-    businessId: string;
-    locale?: string;
-    flushInterval?: number;
-    debug?: boolean;
-}
-declare class ProximaAnalytics {
-    private config;
-    private queue;
-    private preInitQueue;
-    private timer;
-    private initialized;
-    init(config: StorefrontAnalyticsConfig): void;
-    track(type: StorefrontEventType, payload?: StorefrontEventPayload): void;
-    flush(beacon?: boolean): void;
-    destroy(): void;
-}
-/** Singleton analytics client. Call `analytics.init()` once from SiteLayout. */
-export declare const analytics: ProximaAnalytics;
-export { createFixtureBundle, createStorefrontDataSource, validateFixtureBundle, resolveStorefrontDataSourceForRequest, FixtureGuestOrderError, } from "./fixtures-commerce.js";
-export type { FixtureBundle, FixtureBundleInput, FixtureBrandListingParams, FixtureCartMutationParams, FixtureCatalogItem, FixtureListingParams, FixtureProductListingParams, FixtureSearchParams, ResolveStorefrontDataSourceOptions, StorefrontCartParams, StorefrontDataMode, StorefrontDataSource, StorefrontDataSourceConfig, ValidateFixtureBundleOptions, } from "./fixtures-commerce.js";
+export * from './types/cms.js';
+export * from './types/seo.js';
+export * from './types/business.js';
+export * from './types/buyer.js';
+export * from './types/catalog.js';
+export * from './types/cart.js';
+export * from './types/order.js';
+export * from './types/address.js';
+export * from './types/wishlist.js';
+export * from './types/server-env.js';
+export * from './types/listing.js';
+export * from './types/guest-order.js';
+export * from './types/campaign.js';
+export * from './types/analytics.js';
+export * from './types/cookie-consent.js';
+export * from './api/index.js';
+export * from './seo/hreflang.js';
+export * from './seo/engine-url.js';
+export * from './seo/page-seo.js';
+export * from './seo/json-ld.js';
+export * from './seo/sitemap.js';
+export * from './seo/robots.js';
+export * from './seo/indexnow.js';
+export * from './cms/website.js';
+export * from './cms/payment-methods.js';
+export * from './buyer/auth.js';
+export * from './catalog/listings.js';
+export * from './cart/cart.js';
+export * from './orders/orders.js';
+export * from './orders/guest.js';
+export * from './addresses/address-book.js';
+export * from './wishlist/wishlist.js';
+export * from './server/process.js';
+export * from './campaign/countdown.js';
+export { analytics } from './analytics/analytics.js';
+export type { StorefrontAnalyticsInitOptions } from './analytics/analytics.js';
+export { resolveAnalyticsSessionId, ANALYTICS_SESSION_STORAGE_KEY } from './analytics/session.js';
+export { captureSessionAttribution, getSessionAttribution, clearSessionAttribution, inferAttributionFromReferrer, ATTRIBUTION_STORAGE_KEY, } from './analytics/attribution.js';
+export type { SessionAttribution } from './analytics/attribution.js';
+export { createStorefrontAnalyticsTrackers } from './analytics/trackers.js';
+export type { StorefrontAnalyticsTrackers } from './analytics/trackers.js';
+export * from './cookie-consent/consent.js';
+export * from './cache/cache.js';
+export { createFixtureBundle, createStorefrontDataSource, validateFixtureBundle, resolveStorefrontDataSourceForRequest, FixtureGuestOrderError, } from './fixtures-commerce.js';
+export type { FixtureBundle, FixtureBundleInput, FixtureBrandListingParams, FixtureCartMutationParams, FixtureCatalogItem, FixtureListingParams, FixtureProductListingParams, FixtureSearchParams, ResolveStorefrontDataSourceOptions, StorefrontCartParams, StorefrontDataMode, StorefrontDataSource, StorefrontDataSourceConfig, ValidateFixtureBundleOptions, } from './fixtures-commerce.js';
 //# sourceMappingURL=index.d.ts.map