@bacano/sdk 1.0.1 → 1.1.8

package/marketing/attribution.d.ts

@@ -0,0 +1,53 @@
+import type { WebsiteMarketingAttribution } from "./types";
+export declare function refreshWebsiteMarketingMetaContext(websiteId: string): boolean;
+export declare function storeWebsiteMarketingGa4ClientId(websiteId: string, clientId: unknown): boolean;
+export declare function storeWebsiteMarketingGa4SessionId(websiteId: string, sessionId: unknown): boolean;
+export declare function captureWebsiteMarketingAttribution(websiteId: string, windowDays: number): WebsiteMarketingAttribution | null;
+export declare function getWebsiteMarketingAttribution(websiteId: string): WebsiteMarketingAttribution | null;
+export declare function serializeWebsiteMarketingAttribution(attribution: WebsiteMarketingAttribution): {
+    schema_version: 1;
+    first_touch: {
+        captured_at: string;
+        landing_url: string;
+        referrer_host: string | undefined;
+        source: string | undefined;
+        medium: string | undefined;
+        campaign: string | undefined;
+        term: string | undefined;
+        content: string | undefined;
+        source_platform: string | undefined;
+        campaign_id: string | undefined;
+        sales_origin_key: string | undefined;
+        gclid: string | undefined;
+        gbraid: string | undefined;
+        wbraid: string | undefined;
+        fbclid: string | undefined;
+        ttclid: string | undefined;
+        msclkid: string | undefined;
+    };
+    last_non_direct_touch: {
+        captured_at: string;
+        landing_url: string;
+        referrer_host: string | undefined;
+        source: string | undefined;
+        medium: string | undefined;
+        campaign: string | undefined;
+        term: string | undefined;
+        content: string | undefined;
+        source_platform: string | undefined;
+        campaign_id: string | undefined;
+        sales_origin_key: string | undefined;
+        gclid: string | undefined;
+        gbraid: string | undefined;
+        wbraid: string | undefined;
+        fbclid: string | undefined;
+        ttclid: string | undefined;
+        msclkid: string | undefined;
+    } | null;
+    ga4_client_id: string | undefined;
+    ga4_session_id: string | undefined;
+    meta_fbp: string | undefined;
+    meta_fbc: string | undefined;
+    client_user_agent: string | undefined;
+    captured_at: string;
+};

package/marketing/clarity.d.ts

@@ -0,0 +1,3 @@
+export declare function prepareClarity(projectId: string): void;
+export declare function loadClarityScript(projectId: string): void;
+export declare function sendClarityEvent(eventName: string): void;

package/marketing/domain.d.ts

@@ -0,0 +1 @@
+export declare function matchesCanonicalMarketingHost(canonicalDomain: string | null | undefined, currentHostname: string): boolean;

package/marketing/ga4.d.ts

@@ -0,0 +1,2 @@
+import type { WebsiteMarketingItem } from "./types";
+export declare function mapGa4Items(items: WebsiteMarketingItem[] | undefined): unknown[] | undefined;

package/marketing/index.d.ts

@@ -0,0 +1,5 @@
+export { captureWebsiteMarketingAttribution, getWebsiteMarketingAttribution, serializeWebsiteMarketingAttribution, } from "./attribution";
+export { createWebsiteMarketingRuntime } from "./runtime";
+export { getAllowedMarketingParameters, sanitizeMarketingUrl, } from "./sanitize";
+export type { WebsiteAdvertisingConsent, WebsiteMarketingAttribution, WebsiteMarketingBrowserEvent, WebsiteMarketingBrowserEventName, WebsiteMarketingContactPlacement, WebsiteMarketingDiagnostic, WebsiteMarketingItem, WebsiteMarketingRuntime, WebsiteMarketingRuntimeOptions, WebsiteMarketingScriptLoadStrategy, WebsiteMarketingTouchpoint, } from "./types";
+export { MARKETING_SCHEMA_VERSION, WEBSITE_MARKETING_CONTACT_PLACEMENTS, } from "./types";

package/marketing/runtime.d.ts

@@ -0,0 +1,2 @@
+import type { WebsiteMarketingRuntime, WebsiteMarketingRuntimeOptions } from "./types";
+export declare function createWebsiteMarketingRuntime(options: WebsiteMarketingRuntimeOptions): WebsiteMarketingRuntime;

package/marketing/sanitize.d.ts

@@ -0,0 +1,2 @@
+export declare function sanitizeMarketingUrl(input: string, baseUrl?: string): string;
+export declare function getAllowedMarketingParameters(input: string, baseUrl?: string): Record<string, string>;

package/marketing/types.d.ts

@@ -0,0 +1,111 @@
+import type { WebsiteMarketingPublicConfig } from "../types";
+export declare const MARKETING_SCHEMA_VERSION: 1;
+export type WebsiteMarketingBrowserEventName = "page_view" | "search" | "view_item_list" | "select_item" | "view_item" | "add_to_cart" | "remove_from_cart" | "view_cart" | "begin_checkout" | "add_shipping_info" | "add_payment_info" | "contact";
+export declare const WEBSITE_MARKETING_CONTACT_PLACEMENTS: readonly ["product_detail", "floating", "header", "footer", "contact_page"];
+export type WebsiteMarketingContactPlacement = (typeof WEBSITE_MARKETING_CONTACT_PLACEMENTS)[number];
+export interface WebsiteMarketingItem {
+    /** Stable advertising identifier. Always the Bacano product variant ID. */
+    itemId: string;
+    itemName: string;
+    sku?: string | null;
+    price?: number | null;
+    quantity?: number;
+    itemBrand?: string | null;
+    itemCategory?: string | null;
+    itemVariant?: string | null;
+    index?: number;
+}
+export interface WebsiteMarketingBrowserEvent {
+    schemaVersion: typeof MARKETING_SCHEMA_VERSION;
+    eventId: string;
+    eventName: WebsiteMarketingBrowserEventName;
+    occurredAt: string;
+    currency?: string;
+    value?: number;
+    searchTerm?: string;
+    itemListId?: string;
+    itemListName?: string;
+    shippingTier?: string;
+    paymentType?: string;
+    contactMethod?: "whatsapp" | "phone" | "email";
+    /**
+     * Stable storefront location where a `contact` action was offered.
+     * Ignored by the runtime for every other event.
+     */
+    contactPlacement?: WebsiteMarketingContactPlacement;
+    items?: WebsiteMarketingItem[];
+    pageLocation?: string;
+    pageTitle?: string;
+}
+export interface WebsiteMarketingTouchpoint {
+    capturedAt: string;
+    landingUrl: string;
+    referrerHost?: string;
+    source?: string;
+    medium?: string;
+    campaign?: string;
+    term?: string;
+    content?: string;
+    sourcePlatform?: string;
+    campaignId?: string;
+    /** Optional stable public key of a custom origin configured in Bacano. */
+    salesOriginKey?: string;
+    gclid?: string;
+    gbraid?: string;
+    wbraid?: string;
+    fbclid?: string;
+    ttclid?: string;
+    msclkid?: string;
+}
+export interface WebsiteMarketingAttribution {
+    schemaVersion: typeof MARKETING_SCHEMA_VERSION;
+    firstTouch: WebsiteMarketingTouchpoint;
+    lastNonDirectTouch: WebsiteMarketingTouchpoint | null;
+    /** GA4 browser identifier used to join authoritative server events. */
+    ga4ClientId?: string;
+    /** GA4 browser session used for Realtime and session attribution. */
+    ga4SessionId?: string;
+    /** Meta browser identifier created by the Pixel. */
+    metaFbp?: string;
+    /** Meta click identifier created by the Pixel or derived from fbclid. */
+    metaFbc?: string;
+    /** Browser user agent required to match Meta server events. */
+    clientUserAgent?: string;
+    capturedAt: string;
+    expiresAt: string;
+}
+export interface WebsiteAdvertisingConsent {
+    policyId: string;
+    policyVersion: number;
+    statementHash: string;
+    granted: boolean;
+}
+export type WebsiteMarketingDiagnostic = {
+    level: "debug" | "warning";
+    code: string;
+    message: string;
+    eventName?: WebsiteMarketingBrowserEventName;
+};
+export type WebsiteMarketingScriptLoadStrategy = "immediate" | "idle";
+export interface WebsiteMarketingRuntimeOptions {
+    websiteId: string;
+    config: WebsiteMarketingPublicConfig;
+    /**
+     * Canonical storefront domain. When supplied, measurement remains a no-op
+     * on localhost, preview hosts and copied static artifacts.
+     */
+    canonicalDomain?: string | null;
+    /**
+     * `idle` prepares the provider queues immediately, then downloads vendor
+     * scripts after the first interaction or an idle timeout.
+     */
+    scriptLoadStrategy?: WebsiteMarketingScriptLoadStrategy;
+    diagnostic?: (diagnostic: WebsiteMarketingDiagnostic) => void;
+}
+export interface WebsiteMarketingRuntime {
+    readonly enabled: boolean;
+    track(event: Omit<WebsiteMarketingBrowserEvent, "schemaVersion" | "eventId" | "occurredAt" | "currency"> & Partial<Pick<WebsiteMarketingBrowserEvent, "eventId" | "occurredAt" | "currency">>): void;
+    captureAttribution(): WebsiteMarketingAttribution | null;
+    getAttribution(): WebsiteMarketingAttribution | null;
+    destroy(): void;
+}

package/media.d.ts

@@ -1,9 +1,52 @@
-export type MediaUrlVariant = 'original' | 'thumbnail' | 'card' | 'detail';
-export type MediaTransformFormat = 'auto' | 'same' | 'jpeg' | 'webp' | 'png' | 'avif';
+export type MediaUrlVariant = "original" | "thumbnail" | "card" | "detail";
+export type MediaTransformFormat = "auto" | "same" | "jpeg" | "webp" | "png" | "avif";
+export type MediaTransformOptions = {
+    width?: number;
+    height?: number;
+    quality?: number;
+    format?: MediaTransformFormat;
+};
+export type MediaResponsiveSource = {
+    width: number;
+    url: string;
+};
+export type MediaResponsiveSourceOptions = {
+    widths?: number[];
+    quality?: number;
+    format?: MediaTransformFormat;
+};
 export declare function buildStorageFileUrl(storageUrl: string | undefined, fileId: string, variant?: MediaUrlVariant): string;
+/**
+ * Build an explicitly transformed public storage URL.
+ *
+ * Storefronts should use this helper instead of manually appending storage
+ * query parameters. The gateway remains responsible for validating and
+ * bounding every transform.
+ */
+export declare function buildStorageTransformedFileUrl(storageUrl: string | undefined, fileId: string, options: MediaTransformOptions): string;
+/** Build width-labelled candidates suitable for an HTML `srcset`. */
+export declare function buildStorageResponsiveSources(storageUrl: string | undefined, fileId: string, options?: MediaResponsiveSourceOptions): MediaResponsiveSource[];
+export declare function formatMediaSrcSet(sources: MediaResponsiveSource[]): string;
 export declare function buildStorageMediaUrls(storageUrl: string | undefined, fileId: string): {
     originalUrl: string;
     thumbnailUrl: string;
     cardUrl: string;
     detailUrl: string;
+    responsiveSources: MediaResponsiveSource[];
+};
+/**
+ * Build the semantic URLs used by editorial full-width images.
+ *
+ * Candidates are capped at the original pixel width and always include the
+ * original width as the final candidate. When dimensions are unavailable the
+ * optimized srcset is intentionally empty and `heroUrl` falls back to the
+ * original file, preventing accidental enlargement by the storage service.
+ */
+export declare function buildStorageContentMediaUrls(storageUrl: string | undefined, fileId: string, originalWidth?: number | null): {
+    heroUrl: string;
+    responsiveSources: MediaResponsiveSource[];
+    originalUrl: string;
+    thumbnailUrl: string;
+    cardUrl: string;
+    detailUrl: string;
 };

package/modules/auth.d.ts

@@ -1,4 +1,5 @@
-import type { AccessTokenProvider, GetWebsitePublicConfigOptions, WebsitePublicConfig } from "../types";
+import type { AccessTokenProvider, BacanoClientContext, GetWebsitePublicConfigOptions, ResolvedWebsitePublicConfig, WebsitePublicConfig } from "../types";
+export declare function getWebsiteContextFromPublicConfig(config: WebsitePublicConfig): BacanoClientContext | undefined;
 /** Build a bearer header from a token without inspecting or storing it. */
 export declare function createAuthHeaders(accessToken: string | null | undefined): Record<string, string>;
 export declare function createRequestHeadersProvider(websiteSlug: string, getAccessToken?: AccessTokenProvider): () => Promise<Record<string, string>>;
@@ -6,4 +7,4 @@ export declare function createRequestHeadersProvider(websiteSlug: string, getAcc
  * Load the browser-safe buyer-auth bootstrap for the current storefront.
  * Clerk secrets are intentionally never part of this response.
  */
-export declare function getWebsitePublicConfig(options: GetWebsitePublicConfigOptions): Promise<WebsitePublicConfig>;
+export declare function getWebsitePublicConfig(options: GetWebsitePublicConfigOptions): Promise<ResolvedWebsitePublicConfig>;

package/modules/availability.d.ts

@@ -1,5 +1,5 @@
-import type { ProductAvailability, BacanoClientContext } from '../types';
-import { type RequestHeadersProvider } from '../transport/graphql';
+import { type RequestHeadersProvider } from "../transport/graphql";
+import type { BacanoClientContext, ProductAvailability } from "../types";
 export interface AvailabilityModule {
     checkAvailability(productVariantIds: string[]): Promise<ProductAvailability[]>;
 }

package/modules/cart-errors.d.ts

@@ -0,0 +1,2 @@
+export declare function getStableCartActionErrorCode(errors: string[] | null | undefined, fallbackCode: string): string;
+export declare function hasRecoverableCartSessionError(errors: string[] | null | undefined): boolean;

package/modules/cart-session.d.ts

@@ -1,4 +1,4 @@
-import type { BacanoClientConfig } from '../types';
+import type { BacanoClientConfig } from "../types";
 export interface CartSession {
     orderId: string;
     cartToken: string;
@@ -8,6 +8,6 @@ export interface CartSessionStorage {
     set(session: CartSession): void;
     clear(): void;
 }
-type StorageKind = NonNullable<BacanoClientConfig['tokenStorage']>;
+type StorageKind = NonNullable<BacanoClientConfig["tokenStorage"]>;
 export declare function createCartSessionStorage(kind: StorageKind, getSlug: () => string): CartSessionStorage;
 export {};

package/modules/cart.d.ts

@@ -1,6 +1,6 @@
-import type { Cart, CartItem, StartGuestCheckoutInput, BacanoClientContext, WebsiteFulfillmentFamily, WebsiteGuestContact } from '../types';
-import { type RequestHeadersProvider } from '../transport/graphql';
-import type { CartSessionStorage } from './cart-session';
+import { type RequestHeadersProvider } from "../transport/graphql";
+import type { BacanoClientContext, Cart, CartItem, StartGuestCheckoutInput, WebsiteFulfillmentFamily, WebsiteGuestContact } from "../types";
+import type { CartSessionStorage } from "./cart-session";
 export interface CartModule {
     getOrCreate(contact?: WebsiteGuestContact, fulfillmentFamily?: WebsiteFulfillmentFamily): Promise<Cart>;
     startCheckout(input: StartGuestCheckoutInput): Promise<Cart>;
@@ -12,5 +12,6 @@ export interface CartModule {
         quantity: number;
     }>;
     removeItem(cartItemId: string): Promise<Cart>;
+    clear(): Promise<void>;
 }
 export declare function createCartModule(graphqlUrl: string, getHeaders: RequestHeadersProvider, getContext: () => BacanoClientContext, cartSessionStorage: CartSessionStorage): CartModule;

package/modules/catalog.d.ts

@@ -1,14 +1,26 @@
-import type { Product, ProductPrice, ProductVariantPricing, ProductMedia, ProductMediaKind, ProductCategory, CatalogCategoryList, CatalogAttributeList, Brand, GetProductsOptions, GetCategoryListOptions, GetAttributeListOptions, GetCatalogPageOptions, CatalogPageResult, GetProductRecommendationsOptions, ProductRecommendationsResult, GetProductSeoEntriesOptions, ProductSeoEntriesResult, GetProductFiltersOptions, ProductFilters, SearchSuggestion, GetSearchSuggestionsOptions, BacanoClientContext } from '../types';
-import { type RequestHeadersProvider } from '../transport/graphql';
+import { type RequestHeadersProvider } from "../transport/graphql";
+import type { BacanoClientContext, Brand, CatalogAttributeList, CatalogCategoryList, CatalogPageResult, GetAttributeListOptions, GetCatalogPageOptions, GetCategoryListOptions, GetProductFiltersOptions, GetProductRecommendationsOptions, GetProductSeoEntriesOptions, GetProductsOptions, GetSearchSuggestionsOptions, GetStaticCatalogBootstrapOptions, GetStaticCatalogSnapshotOptions, Product, ProductCategory, ProductFilters, ProductMedia, ProductMediaKind, ProductPrice, ProductRecommendationsResult, ProductSeoEntriesResult, ProductVariant, ProductVariantLiveState, ProductVariantPricing, SearchSuggestion, StaticCatalogBootstrap, StaticCatalogSnapshot } from "../types";
 export declare function getProductMediaKind(mimeType?: string | null): ProductMediaKind;
 export declare function getProductMediaByKind(media: ProductMedia[] | null | undefined, kind: ProductMediaKind): ProductMedia[];
 export declare function getProductImages(media: ProductMedia[] | null | undefined): ProductMedia[];
 export declare function getProductVideos(media: ProductMedia[] | null | undefined): ProductMedia[];
+/**
+ * Returns the variants that belong in a product detail selector.
+ *
+ * Static catalog snapshots expose saleable variants in `variants` so cards,
+ * filters and prices remain stable, while `detailVariants` also preserves
+ * enabled public-price variants that are currently sold out. The fallback
+ * keeps cached snapshots produced by older SDK versions compatible.
+ */
+export declare function getProductDetailVariants(product: Product): ProductVariant[];
 export declare function getPrimaryProductImage(media: ProductMedia[] | null | undefined): ProductMedia | null;
 export declare function resolveProductPricing(prices: ProductPrice[]): ProductVariantPricing;
 export interface CatalogModule {
     getCatalogPage(opts: GetCatalogPageOptions): Promise<CatalogPageResult>;
+    getStaticCatalogSnapshot(opts: GetStaticCatalogSnapshotOptions): Promise<StaticCatalogSnapshot>;
+    getStaticCatalogBootstrap(opts: GetStaticCatalogBootstrapOptions): Promise<StaticCatalogBootstrap>;
     getProductRecommendations(opts: GetProductRecommendationsOptions): Promise<ProductRecommendationsResult>;
+    getProductLiveState(productVariantIds: string[]): Promise<ProductVariantLiveState[]>;
     getProductSeoEntries(opts?: GetProductSeoEntriesOptions): Promise<ProductSeoEntriesResult>;
     getProducts(opts?: GetProductsOptions): Promise<Product[]>;
     getProduct(productId: string): Promise<Product | null>;
@@ -21,4 +33,4 @@ export interface CatalogModule {
     getSearchSuggestions(opts: GetSearchSuggestionsOptions): Promise<SearchSuggestion[]>;
     checkAvailability: never;
 }
-export declare function createCatalogModule(graphqlUrl: string, getHeaders: RequestHeadersProvider, getContext: () => BacanoClientContext, storageUrl?: string): Omit<CatalogModule, 'checkAvailability'>;
+export declare function createCatalogModule(graphqlUrl: string, getHeaders: RequestHeadersProvider, getContext: () => BacanoClientContext, storageUrl?: string): Omit<CatalogModule, "checkAvailability">;

package/modules/content.d.ts

@@ -1,5 +1,5 @@
-import type { GetContentOptions, ContentEntry, ProductContentBlock, BacanoClientContext } from '../types';
-import { type RequestHeadersProvider } from '../transport/graphql';
+import { type RequestHeadersProvider } from "../transport/graphql";
+import type { BacanoClientContext, ContentEntry, GetContentOptions, ProductContentBlock } from "../types";
 export interface ContentModule {
     getByKey(key: string, opts?: GetContentOptions): Promise<ContentEntry | null>;
     getByCategory(categoryKey: string, opts?: GetContentOptions): Promise<ContentEntry[]>;

package/modules/marketing.d.ts

@@ -0,0 +1,5 @@
+import type { BacanoClientContext, WebsiteCampaignCaptureInput, WebsiteCampaignCaptureResult } from "../types";
+export interface MarketingModule {
+    captureLead(input: WebsiteCampaignCaptureInput): Promise<WebsiteCampaignCaptureResult>;
+}
+export declare function createMarketingModule(apiUrl: string, websiteSlug: string, getContext: () => BacanoClientContext): MarketingModule;

package/modules/orders.d.ts

@@ -1,5 +1,5 @@
-import type { BacanoClientContext, GetOrdersOptions, Order, PublicOrder, PublicOrderLookupInput, WaitForPublicOrderPaymentInput } from '../types';
-import { type RequestHeadersProvider } from '../transport/graphql';
+import { type RequestHeadersProvider } from "../transport/graphql";
+import type { BacanoClientContext, GetOrdersOptions, Order, PublicOrder, PublicOrderLookupInput, WaitForPublicOrderPaymentInput } from "../types";
 export interface OrdersModule {
     list(opts?: GetOrdersOptions): Promise<Order[]>;
     get(orderId: string): Promise<Order | null>;

package/modules/profile.d.ts

@@ -1,5 +1,5 @@
-import type { CustomerAddress, CustomerProfile, CustomerProfileUpdate } from "../types";
 import { type RequestHeadersProvider } from "../transport/graphql";
+import type { CustomerAddress, CustomerProfile, CustomerProfileUpdate } from "../types";
 export interface ProfileModule {
     get(): Promise<CustomerProfile>;
     getAddresses(): Promise<CustomerAddress[]>;

package/modules/static-catalog.d.ts

@@ -0,0 +1,13 @@
+import type { CatalogPageResult, GetCatalogPageOptions, GetStaticCatalogBootstrapOptions, GetStaticCatalogSnapshotOptions, StaticCatalogSnapshot } from "../types";
+type StaticCatalogCollectorOptions = {
+    websiteId: string;
+    snapshot: GetStaticCatalogSnapshotOptions;
+    bootstrap?: Pick<GetStaticCatalogBootstrapOptions, "initialPageSize" | "sortBy">;
+    loadPage: (options: GetCatalogPageOptions) => Promise<CatalogPageResult>;
+};
+export type StaticCatalogCollection = {
+    snapshot: StaticCatalogSnapshot;
+    initialPage: CatalogPageResult | null;
+};
+export declare function collectStaticCatalog({ websiteId, snapshot: options, bootstrap, loadPage, }: StaticCatalogCollectorOptions): Promise<StaticCatalogCollection>;
+export {};

package/modules/website.d.ts

@@ -1,3 +1,9 @@
-import type { BacanoClientContext } from "../types";
 import { type RequestHeadersProvider } from "../transport/graphql";
+import type { BacanoClientContext } from "../types";
 export declare function resolveWebsite(graphqlUrl: string, slug: string, headers?: RequestHeadersProvider): Promise<BacanoClientContext>;
+/**
+ * Share the immutable public website bootstrap between SDK clients created by
+ * different React integrations in the same runtime.
+ */
+export declare function resolveWebsiteCached(graphqlUrl: string, slug: string, headers?: RequestHeadersProvider): Promise<BacanoClientContext>;
+export declare function clearWebsiteContextCache(): void;

package/package.json

@@ -1,10 +1,16 @@
 {
   "name": "@bacano/sdk",
-  "version": "1.0.1",
+  "version": "1.1.8",
   "description": "TypeScript SDK for building websites on the Bacano ERP",
   "main": "./index.cjs",
   "module": "./index.js",
   "types": "./index.d.ts",
+  "bin": {
+    "bacano-web": "./skills/bacano-web/scripts/cli.mjs"
+  },
+  "scripts": {
+    "postinstall": "node ./skills/bacano-web/scripts/postinstall.mjs"
+  },
   "exports": {
     ".": {
       "types": "./index.d.ts",
@@ -20,6 +26,11 @@
       "types": "./react.d.ts",
       "import": "./react.js",
       "require": "./react.cjs"
+    },
+    "./react/preview": {
+      "types": "./react/preview.d.ts",
+      "import": "./react/preview.js",
+      "require": "./react/preview.cjs"
     }
   },
   "sideEffects": false,
@@ -28,10 +39,10 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/pulpo-labs/erp.git",
+    "url": "git+https://github.com/bacano-erp/erp.git",
     "directory": "libs/sdk"
   },
-  "homepage": "https://github.com/pulpo-labs/erp/tree/main/libs/sdk#readme",
+  "homepage": "https://github.com/bacano-erp/erp/tree/main/libs/sdk#readme",
   "peerDependencies": {
     "react": ">=18.0.0"
   },

package/react/context-registry.d.ts

@@ -0,0 +1,9 @@
+import { type Context } from "react";
+/**
+ * Returns one React context per key in the current JavaScript realm.
+ *
+ * The SDK publishes independently bundled React entrypoints. A global symbol
+ * prevents those bundles from creating private context instances while still
+ * keeping provider values isolated by each React tree.
+ */
+export declare function getOrCreateReactContext<T>(key: string, defaultValue: T): Context<T>;

package/react/context.d.ts

@@ -1,4 +1,4 @@
-import type { BacanoClient } from '../client';
+import type { BacanoClient } from "../client";
 export interface BacanoClientContextValue {
     client: BacanoClient | null;
     loading: boolean;

package/react/hooks.d.ts

@@ -1,9 +1,11 @@
-import type { BacanoClient } from '../client';
-import type { Product, ProductCategory, CatalogCategoryList, CatalogAttributeList, Brand, ProductAvailability, ProductFilters, GetProductsOptions, GetCategoryListOptions, GetAttributeListOptions, GetProductFiltersOptions, SearchSuggestion, GetSearchSuggestionsOptions, ContentEntry, GetContentOptions, Cart, CartItem, StartGuestCheckoutInput, WebsiteFulfillmentFamily, WebsiteGuestContact, CheckoutSubmission, CheckoutResult, Order, GetOrdersOptions, CustomerProfile, CustomerProfileUpdate, AsyncState } from '../types';
+import type { BacanoClient } from "../client";
+import type { AsyncState, Brand, Cart, CartItem, CatalogAttributeList, CatalogCategoryList, CheckoutResult, CheckoutSubmission, ContentEntry, CustomerProfile, CustomerProfileUpdate, GetAttributeListOptions, GetCategoryListOptions, GetContentOptions, GetOrdersOptions, GetProductFiltersOptions, GetProductsOptions, GetSearchSuggestionsOptions, Order, Product, ProductAvailability, ProductCategory, ProductFilters, ProductVariantLiveState, SearchSuggestion, StartGuestCheckoutInput, WebsiteFulfillmentFamily, WebsiteGuestContact } from "../types";
 /** Returns the initialized BacanoClient instance */
 export declare function useBacano(): BacanoClient;
 /** Returns the initialization state (for loading/error handling) */
 export declare function useBacanoState(): import("./context").BacanoClientContextValue;
+/** Returns the storefront marketing runtime. It is a safe no-op when disabled. */
+export declare function useMarketing(): import("..").WebsiteMarketingRuntime;
 export declare function useProducts(opts?: GetProductsOptions): AsyncState<Product[]> & {
     refetch: () => void;
 };
@@ -31,6 +33,25 @@ export declare function useSearchSuggestions(opts?: GetSearchSuggestionsOptions)
 export declare function useAvailability(productVariantIds: string[]): AsyncState<ProductAvailability[]> & {
     refetch: () => void;
 };
+/**
+ * Stock *and* price, live, in one request.
+ *
+ * `useAvailability` answers only "can this be bought". That is half the
+ * question a storefront needs, because price and discount are baked into the
+ * static export at build time and the cart charges whatever is true now — so a
+ * page can advertise a sale that ended and a price nobody will honour.
+ *
+ * Worse, a promotion ends because *time passed*. No row changes, so no rebuild
+ * is ever triggered, and the stale offer survives until something unrelated
+ * causes a publish. Reading price live is the only thing that fixes that.
+ *
+ * Costs no extra round trip on a product page that already checks stock:
+ * `getProductLiveState` returns both. Prefer it over `useAvailability`
+ * anywhere a price is displayed.
+ */
+export declare function useProductLiveState(productVariantIds: string[]): AsyncState<ProductVariantLiveState[]> & {
+    refetch: () => void;
+};
 export declare function useContentByKey(key: string | null, opts?: GetContentOptions): AsyncState<ContentEntry | null> & {
     refetch: () => void;
 };
@@ -52,6 +73,7 @@ export declare function useCart(): {
         quantity: number;
     }>;
     removeItem: (cartItemId: string) => Promise<void>;
+    clear: () => Promise<void>;
     refresh: () => Promise<void>;
 };
 export declare function useCheckout(): {

package/react/marketing-context.d.ts

@@ -0,0 +1,3 @@
+import type { WebsiteMarketingRuntime } from "../marketing";
+export declare const NOOP_MARKETING_RUNTIME: WebsiteMarketingRuntime;
+export declare const BacanoMarketingContext: import("react").Context<WebsiteMarketingRuntime>;

package/react/marketing-provider.d.ts

@@ -0,0 +1,10 @@
+import { type JSX, type ReactNode } from "react";
+import type { WebsiteMarketingDiagnostic, WebsiteMarketingScriptLoadStrategy } from "../marketing";
+import type { WebsitePublicConfig } from "../types";
+export interface BacanoMarketingProviderProps {
+    publicConfig: WebsitePublicConfig | null;
+    children: ReactNode;
+    scriptLoadStrategy?: WebsiteMarketingScriptLoadStrategy;
+    diagnostic?: (diagnostic: WebsiteMarketingDiagnostic) => void;
+}
+export declare function BacanoMarketingProvider({ publicConfig, children, scriptLoadStrategy, diagnostic, }: BacanoMarketingProviderProps): JSX.Element;

package/react/preview/cache.d.ts

@@ -0,0 +1,23 @@
+import type { BacanoClient } from "../../client";
+import type { PreviewRouteLoader } from "./types";
+export interface PreviewCacheValue<TDocument> {
+    document: TDocument;
+    refreshedAt: Date;
+}
+export declare class PreviewRouteCache<TDocument> {
+    private readonly maxEntries;
+    private readonly values;
+    private readonly inFlight;
+    constructor(maxEntries: number);
+    load(input: {
+        route: string;
+        force: boolean;
+        client: BacanoClient;
+        loader: PreviewRouteLoader<TDocument>;
+    }): Promise<PreviewCacheValue<TDocument>>;
+    clear(): void;
+    private trim;
+}
+export declare class EmptyPreviewDocumentError extends Error {
+    constructor();
+}

package/react/preview/context.d.ts

@@ -0,0 +1,5 @@
+import type { BacanoPreviewContextValue } from "./types";
+export declare const BacanoPreviewModeContext: import("react").Context<boolean>;
+export declare const BacanoPreviewContext: import("react").Context<BacanoPreviewContextValue<unknown> | null>;
+export declare function useBacanoPreview<TDocument = unknown>(): BacanoPreviewContextValue<TDocument>;
+export declare function useBacanoPreviewMode(): boolean;

package/react/preview/navigation.d.ts

@@ -0,0 +1,9 @@
+import type { MouseEvent as ReactMouseEvent } from "react";
+export declare function normalizePreviewRoute(value: string | null | undefined): string;
+export interface PreviewLinkInterceptorOptions {
+    navigate: (route: string) => void;
+    normalizeRoute?: (route: string) => string;
+    isPreviewableRoute?: (route: string) => boolean;
+    origin?: string;
+}
+export declare function interceptPreviewLink(event: Pick<ReactMouseEvent<HTMLElement>, "altKey" | "button" | "ctrlKey" | "defaultPrevented" | "metaKey" | "preventDefault" | "shiftKey" | "target">, options: PreviewLinkInterceptorOptions): boolean;

package/react/preview/provider.d.ts

@@ -0,0 +1,3 @@
+import { type JSX } from "react";
+import type { BacanoPreviewProviderProps } from "./types";
+export declare function BacanoPreviewProvider<TDocument>({ websiteSlug, route: requestedRoute, loadRoute, navigate: navigateStorefront, normalizeRoute, isPreviewableRoute, initialExpanded, initialPosition, cacheMaxEntries, children, }: BacanoPreviewProviderProps<TDocument>): JSX.Element;

package/react/preview/shell.d.ts

@@ -0,0 +1,3 @@
+import type { JSX } from "react";
+import type { BacanoPreviewShellProps } from "./types";
+export declare function BacanoPreviewShell<TDocument>({ toolbar, children, ...providerProps }: BacanoPreviewShellProps<TDocument>): JSX.Element;

package/react/preview/toolbar.d.ts

@@ -0,0 +1,3 @@
+import { type JSX } from "react";
+import type { BacanoPreviewToolbarProps } from "./types";
+export declare function BacanoPreviewToolbar({ websiteName, logo, primaryColor, accentColor, backgroundColor, locale, zIndex, suggestedRoutes, }: BacanoPreviewToolbarProps): JSX.Element;