@proxima-io/storefront-core 0.2.0 → 0.8.1

package/dist/catalog/listings.d.ts

@@ -0,0 +1,87 @@
+import type { ProximaApiConfig, ProximaWebsiteResponse } from '../types/cms.js';
+import type { CategoryNavTreeResponse, StorefrontBrandDirectoryResponse, StorefrontBrandListingResponse, StorefrontCategoryDirectoryResponse, StorefrontCategoryListingResponse, StorefrontListingParams, StorefrontProductListingResponse, StorefrontSearchResponse } from '../types/catalog.js';
+import type { ProductListingFilters, ProductListingSortOption } from '../types/listing.js';
+/**
+ * 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>;
+/**
+ * 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 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>;
+//# sourceMappingURL=listings.d.ts.map

package/dist/catalog/listings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listings.d.ts","sourceRoot":"","sources":["../../src/catalog/listings.ts"],"names":[],"mappings":"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"}

package/dist/catalog/listings.js

@@ -0,0 +1,140 @@
+import { StorefrontEndpoints, createStorefrontClient } from '../api/index.js';
+function storefrontContext(website, params = {}) {
+    return {
+        businessId: website.business_id,
+        locale: params.locale ?? website.locale,
+        currency: params.currency ?? website.currency,
+    };
+}
+/**
+ * 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 async function searchStorefront(config, website, params) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.catalog.search(), {
+        ...storefrontContext(website, params),
+        query: { q: params.q, limit: params.limit },
+    });
+}
+/**
+ * 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 async function fetchStorefrontProducts(config, website, params = {}) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.catalog.products(), {
+        ...storefrontContext(website, params),
+        query: {
+            page: params.page,
+            page_size: params.pageSize,
+            sort: params.sort,
+            brand: params.brand,
+            category: params.category,
+            q: params.q,
+        },
+    });
+}
+/**
+ * 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 async function fetchCategoryProducts(config, website, params) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.catalog.categoryProducts(params.slug), {
+        ...storefrontContext(website, params),
+        query: {
+            page: params.page,
+            page_size: params.pageSize,
+            sort: params.sort,
+            brand: params.brand,
+            q: params.q,
+        },
+    });
+}
+/**
+ * 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 async function fetchBrandProducts(config, website, params) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.catalog.brandProducts(params.slug), {
+        ...storefrontContext(website, params),
+        query: {
+            page: params.page,
+            page_size: params.pageSize,
+            sort: params.sort,
+            category: params.category,
+            q: params.q,
+        },
+    });
+}
+/**
+ * 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 async function fetchCategoriesDirectory(config, website, params = {}) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.catalog.categories(), {
+        businessId: website.business_id,
+        locale: params.locale ?? website.locale,
+    });
+}
+/**
+ * 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 async function fetchCategoryNavTree(config, website, params = {}) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.catalog.categoryTree(), {
+        businessId: website.business_id,
+        locale: params.locale ?? website.locale,
+        query: { max_depth: params.maxDepth },
+    });
+}
+/**
+ * Fetch the full brand directory (all brands with product counts).
+ * Useful for navigation menus and sitemap generation.
+ */
+export async function fetchBrandsDirectory(config, website, params = {}) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.catalog.brands(), {
+        businessId: website.business_id,
+        locale: params.locale ?? website.locale,
+    });
+}
+/**
+ * Fetch a filtered, sorted, paginated product listing.
+ * Extends fetchStorefrontProducts with price range and stock filters.
+ */
+export async function fetchProductListing(config, website, params = {}) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.catalog.products(), {
+        businessId: website.business_id,
+        locale: website.locale,
+        currency: website.currency,
+        query: {
+            brand: params.filters?.brand,
+            category: params.filters?.category,
+            price_min: params.filters?.price_min,
+            price_max: params.filters?.price_max,
+            in_stock: params.filters?.in_stock ? 'true' : undefined,
+            sort: params.sort,
+            page: params.page,
+            page_size: params.page_size,
+        },
+    });
+}
+//# sourceMappingURL=listings.js.map

package/dist/catalog/listings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listings.js","sourceRoot":"","sources":["../../src/catalog/listings.ts"],"names":[],"mappings":"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"}

package/dist/cms/payment-methods.d.ts

@@ -0,0 +1,13 @@
+import type { StorefrontPaymentMethod } from '../types/business.js';
+import type { ProximaWebsiteResponse } from '../types/cms.js';
+/**
+ * Normalize payment method payloads embedded in CMS shell/footer attributes.
+ * The API injects enabled methods at `shell_sections.footer.attributes.payment_methods`
+ * during website resolve (same tenant-wide list previously fetched separately).
+ */
+export declare function paymentMethodsFromAttributes(attributes: Record<string, unknown> | undefined | null): StorefrontPaymentMethod[];
+/**
+ * Read enabled payment methods from a resolved website's shell footer slot.
+ */
+export declare function paymentMethodsFromShell(shellSections: ProximaWebsiteResponse['shell_sections'] | undefined, footerKey?: string): StorefrontPaymentMethod[];
+//# sourceMappingURL=payment-methods.d.ts.map

package/dist/cms/payment-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-methods.d.ts","sourceRoot":"","sources":["../../src/cms/payment-methods.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAuB9D;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,GACrD,uBAAuB,EAAE,CAM3B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,GAAG,SAAS,EACnE,SAAS,SAAW,GACnB,uBAAuB,EAAE,CAI3B"}

package/dist/cms/payment-methods.js

@@ -0,0 +1,41 @@
+function normalizePaymentMethod(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const item = raw;
+    const code = String(item.code ?? '').trim();
+    if (!code)
+        return null;
+    const kind = item.kind;
+    const normalizedKind = kind === 'online' || kind === 'hybrid' ? kind : 'offline';
+    return {
+        code,
+        name_es: String(item.name_es ?? code),
+        description_es: item.description_es == null ? null : String(item.description_es),
+        category: String(item.category ?? ''),
+        kind: normalizedKind,
+        icon_url: item.icon_url == null ? null : String(item.icon_url),
+    };
+}
+/**
+ * Normalize payment method payloads embedded in CMS shell/footer attributes.
+ * The API injects enabled methods at `shell_sections.footer.attributes.payment_methods`
+ * during website resolve (same tenant-wide list previously fetched separately).
+ */
+export function paymentMethodsFromAttributes(attributes) {
+    const raw = attributes?.payment_methods;
+    if (!Array.isArray(raw))
+        return [];
+    return raw
+        .map(normalizePaymentMethod)
+        .filter((item) => item !== null);
+}
+/**
+ * Read enabled payment methods from a resolved website's shell footer slot.
+ */
+export function paymentMethodsFromShell(shellSections, footerKey = 'footer') {
+    const footer = shellSections?.[footerKey];
+    if (!footer?.attributes)
+        return [];
+    return paymentMethodsFromAttributes(footer.attributes);
+}
+//# sourceMappingURL=payment-methods.js.map

package/dist/cms/payment-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-methods.js","sourceRoot":"","sources":["../../src/cms/payment-methods.ts"],"names":[],"mappings":"AAGA,SAAS,sBAAsB,CAAC,GAAY;IAC1C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,IAAI,GAAG,GAA8B,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,MAAM,cAAc,GAClB,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IAE5D,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;QACrC,cAAc,EACZ,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;QAClE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QACrC,IAAI,EAAE,cAAc;QACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAAsD;IAEtD,MAAM,GAAG,GAAG,UAAU,EAAE,eAAe,CAAC;IACxC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,GAAG;SACP,GAAG,CAAC,sBAAsB,CAAC;SAC3B,MAAM,CAAC,CAAC,IAAI,EAAmC,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,aAAmE,EACnE,SAAS,GAAG,QAAQ;IAEpB,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,UAAU;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,4BAA4B,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACzD,CAAC"}

package/dist/cms/website.d.ts

@@ -0,0 +1,74 @@
+import type { ProximaApiConfig, ProximaCompositionResponse, ProximaRenderResponse, ProximaWebsiteResponse } from '../types/cms.js';
+import type { StorefrontBusinessProfile, StorefrontCampaign } from '../types/business.js';
+export declare function fetchBusinessProfile(config: Pick<ProximaApiConfig, "baseUrl" | "serviceKey">, businessId: string): Promise<StorefrontBusinessProfile>;
+/**
+ * Fetch all active campaigns for a tenant. An "active" campaign is
+ * `is_active=true` AND (active_until is null OR active_until > now).
+ * Scheduled-but-not-yet-started campaigns are included so the storefront
+ * can render teasers ("Empieza en X días"); filter by `active_from` if
+ * you only want strictly-live ones.
+ */
+export declare function fetchCampaigns(config: Pick<ProximaApiConfig, "baseUrl" | "serviceKey">, businessId: string): Promise<StorefrontCampaign[]>;
+/**
+ * Fetch a single campaign by slug. Returns null if the campaign doesn't
+ * exist or is no longer active — sections pinned to a specific campaign
+ * (e.g. a hero hardcoded to 'black-week-2026') use this to detect when
+ * to fall back to their generic copy.
+ */
+export declare function fetchCampaignBySlug(config: Pick<ProximaApiConfig, "baseUrl" | "serviceKey">, businessId: string, slug: string): Promise<StorefrontCampaign | null>;
+/** 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>;
+/**
+ * Fetch everything needed to SSR any page in a single round-trip.
+ *
+ * Returns `shell` (theme, nav tree, payment methods), `page` (sections + resolved data + SEO),
+ * `bootstrap` (categories, brands, store config) and `website` metadata.
+ * The response is cached at the CDN edge with `stale-while-revalidate`, so warm requests
+ * are served in ~5ms without hitting the API origin.
+ *
+ * Use this instead of calling `fetchProximaWebsite` + `fetchProximaComposition` +
+ * `fetchCategoryNavTree` + `fetchBusinessProfile` separately.
+ *
+ * @example
+ * // src/pages/[...path].astro
+ * const render = await fetchProximaRender(
+ *   { baseUrl: env.apiUrl, domain: Astro.url.hostname, path: Astro.url.pathname, serviceKey: env.serviceKey }
+ * );
+ * if (render.page.requires_auth) return Astro.redirect('/login');
+ */
+export declare function fetchProximaRender(config: Pick<ProximaApiConfig, 'baseUrl' | 'domain' | 'path' | 'serviceKey'> & {
+    /** Override domain for dev/testing (maps to ?domain= query param). */
+    host?: string;
+}): Promise<ProximaRenderResponse>;
+//# sourceMappingURL=website.d.ts.map

package/dist/cms/website.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"website.d.ts","sourceRoot":"","sources":["../../src/cms/website.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EACV,yBAAyB,EACzB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAE9B,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,YAAY,CAAC,EACxD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,yBAAyB,CAAC,CAMpC;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,YAAY,CAAC,EACxD,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAM/B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,YAAY,CAAC,EACxD,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAOpC;AAED,+FAA+F;AAC/F,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAKzI;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACtF,OAAO,CAAC,sBAAsB,CAAC,CAMjC;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,YAAY,GAAG,QAAQ,CAAC,GACpE,sBAAsB,CAoBxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,0BAA0B,CAAC,CAoBrC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAC,GAAG;IAC7E,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,qBAAqB,CAAC,CAShC"}

package/dist/cms/website.js

@@ -0,0 +1,144 @@
+import { StorefrontEndpoints, createStorefrontClient } from '../api/index.js';
+export async function fetchBusinessProfile(config, businessId) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.business.profile(), {
+        query: { business_id: businessId },
+        failPrefix: 'Business profile fetch failed',
+    });
+}
+/**
+ * Fetch all active campaigns for a tenant. An "active" campaign is
+ * `is_active=true` AND (active_until is null OR active_until > now).
+ * Scheduled-but-not-yet-started campaigns are included so the storefront
+ * can render teasers ("Empieza en X días"); filter by `active_from` if
+ * you only want strictly-live ones.
+ */
+export async function fetchCampaigns(config, businessId) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.campaigns.list(), {
+        query: { business_id: businessId },
+        failPrefix: 'Campaigns fetch failed',
+    });
+}
+/**
+ * Fetch a single campaign by slug. Returns null if the campaign doesn't
+ * exist or is no longer active — sections pinned to a specific campaign
+ * (e.g. a hero hardcoded to 'black-week-2026') use this to detect when
+ * to fall back to their generic copy.
+ */
+export async function fetchCampaignBySlug(config, businessId, slug) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.campaigns.bySlug(slug), {
+        query: { business_id: businessId },
+        notFound: 'null',
+        failPrefix: 'Campaign fetch failed',
+    });
+}
+/** List all websites for a service-key authenticated caller. Useful for build-time scripts. */
+export async function fetchProximaWebsiteList(config) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.cms.websites(), {
+        failPrefix: 'Website list failed',
+    });
+}
+/**
+ * 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 async function fetchProximaWebsite(config) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.cms.resolveWebsite(), {
+        query: { host: config.host || config.domain },
+        failPrefix: 'Website resolve failed',
+    });
+}
+/**
+ * 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 function makeBuilderPreviewWebsite(config) {
+    if (!config.websiteId || !config.businessId) {
+        throw new Error("Builder preview requires websiteId and businessId");
+    }
+    return {
+        id: config.websiteId,
+        business_id: config.businessId,
+        name: "Builder preview",
+        domain: config.domain,
+        delivery_mode: "custom_managed",
+        website_kind: "ecommerce",
+        template_key: null,
+        code_profile: null,
+        locale: "es",
+        currency: "PEN",
+        capabilities: {},
+        theme_tokens: {},
+        animation_config: {},
+        pages: [],
+    };
+}
+/**
+ * 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 async function fetchProximaComposition(config, website) {
+    const locale = website.locale ?? "es";
+    const currency = website.currency ?? "PEN";
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.cms.composition(website.id), {
+        businessId: website.business_id,
+        locale,
+        currency,
+        query: {
+            path: config.path,
+            locale,
+            business_id: website.business_id,
+            variant_id: config.variantId,
+            preview_token: config.previewToken,
+        },
+        failPrefix: 'Composition failed',
+    });
+}
+/**
+ * Fetch everything needed to SSR any page in a single round-trip.
+ *
+ * Returns `shell` (theme, nav tree, payment methods), `page` (sections + resolved data + SEO),
+ * `bootstrap` (categories, brands, store config) and `website` metadata.
+ * The response is cached at the CDN edge with `stale-while-revalidate`, so warm requests
+ * are served in ~5ms without hitting the API origin.
+ *
+ * Use this instead of calling `fetchProximaWebsite` + `fetchProximaComposition` +
+ * `fetchCategoryNavTree` + `fetchBusinessProfile` separately.
+ *
+ * @example
+ * // src/pages/[...path].astro
+ * const render = await fetchProximaRender(
+ *   { baseUrl: env.apiUrl, domain: Astro.url.hostname, path: Astro.url.pathname, serviceKey: env.serviceKey }
+ * );
+ * if (render.page.requires_auth) return Astro.redirect('/login');
+ */
+export async function fetchProximaRender(config) {
+    const client = createStorefrontClient(config);
+    return client.get(StorefrontEndpoints.cms.render(), {
+        query: {
+            path: config.path,
+            domain: config.host ?? config.domain,
+        },
+        failPrefix: 'Render fetch failed',
+    });
+}
+//# sourceMappingURL=website.js.map

package/dist/cms/website.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"website.js","sourceRoot":"","sources":["../../src/cms/website.ts"],"names":[],"mappings":"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"}

package/dist/cookie-consent/consent.d.ts

@@ -0,0 +1,22 @@
+import { type CookieConsentState } from '../types/cookie-consent.js';
+/** Read persisted consent, or `null` if none / stale version. */
+export declare function readCookieConsent(): CookieConsentState | null;
+/** Whether the shopper already accepted or rejected non-essential cookies. */
+export declare function hasCookieConsentDecision(): boolean;
+/** Whether analytics events may be sent (requires explicit accept). */
+export declare function isAnalyticsConsentGranted(state?: CookieConsentState | null): boolean;
+export declare function isMarketingConsentGranted(state?: CookieConsentState | null): boolean;
+/** Persist consent and notify listeners (analytics gating, third-party tags). */
+/** Persist consent and dispatch `COOKIE_CONSENT_CHANGED_EVENT` (analytics client listens). */
+export declare function writeCookieConsent(categories: {
+    analytics: boolean;
+    marketing: boolean;
+}): CookieConsentState;
+/** Accept analytics + marketing — call from cookie banner "Accept all". */
+export declare function acceptAllCookieConsent(): CookieConsentState;
+/** Reject non-essential cookies — analytics stays gated until user accepts. */
+export declare function rejectNonEssentialCookieConsent(): CookieConsentState;
+export declare function dispatchCookieConsentChanged(state: CookieConsentState): void;
+/** Subscribe to consent updates. Returns an unsubscribe function. */
+export declare function onCookieConsentChanged(listener: (state: CookieConsentState) => void): () => void;
+//# sourceMappingURL=consent.d.ts.map

package/dist/cookie-consent/consent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent.d.ts","sourceRoot":"","sources":["../../src/cookie-consent/consent.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AA2BpC,iEAAiE;AACjE,wBAAgB,iBAAiB,IAAI,kBAAkB,GAAG,IAAI,CAG7D;AAED,8EAA8E;AAC9E,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAED,uEAAuE;AACvE,wBAAgB,yBAAyB,CAAC,KAAK,GAAE,kBAAkB,GAAG,IAA0B,GAAG,OAAO,CAEzG;AAED,wBAAgB,yBAAyB,CAAC,KAAK,GAAE,kBAAkB,GAAG,IAA0B,GAAG,OAAO,CAEzG;AAYD,iFAAiF;AACjF,8FAA8F;AAC9F,wBAAgB,kBAAkB,CAAC,UAAU,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,kBAAkB,CAO7G;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,IAAI,kBAAkB,CAE3D;AAED,+EAA+E;AAC/E,wBAAgB,+BAA+B,IAAI,kBAAkB,CAEpE;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAK5E;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,CAQhG"}