@bacano/sdk 1.1.0 → 1.1.9

package/types.d.ts

@@ -35,6 +35,11 @@ export interface WebsitePublicConfig {
     clerkPublishableKey: string | null;
     customerIdentification: WebsiteCustomerIdentificationPolicy;
     marketing: WebsiteMarketingPublicConfig;
+    /**
+     * Optional on caller-constructed configs. `getWebsitePublicConfig()` always
+     * resolves this block, including a safe empty fallback.
+     */
+    branding?: WebsiteBrandingPublicConfig;
     /**
      * Optional on caller-constructed configs for compatibility with SDK 1.0.10.
      * `getWebsitePublicConfig()` always returns this block.
@@ -45,6 +50,28 @@ export interface WebsitePublicConfig {
      * resolves this block, including a safe disabled fallback.
      */
     construction?: WebsiteConstructionPublicConfig;
+    /** Public thresholds for displaying quantity-pricing guidance. */
+    volumePricing?: WebsiteVolumePricingPublicConfig;
+}
+export interface WebsiteVolumePricingPublicConfig {
+    schemaVersion: 1;
+    enabled: boolean;
+    tiers: Array<{
+        priceType: "WHOLESALE" | "WHOLESALE_2";
+        minQuantity: number;
+    }>;
+}
+export interface WebsiteBrandingMedia {
+    fileId: string;
+    name: string | null;
+    altText: string | null;
+    width: number | null;
+    height: number | null;
+    originalUrl: string;
+}
+export interface WebsiteBrandingPublicConfig {
+    schemaVersion: 1;
+    favicon: WebsiteBrandingMedia | null;
 }
 export interface WebsiteConstructionMedia {
     fileId: string;
@@ -123,8 +150,10 @@ export interface WebsiteCampaignCaptureResult {
     message: string;
 }
 export type ResolvedWebsitePublicConfig = WebsitePublicConfig & {
+    branding: WebsiteBrandingPublicConfig;
     legal: WebsiteLegalPublicConfig;
     construction: WebsiteConstructionPublicConfig;
+    volumePricing: WebsiteVolumePricingPublicConfig;
 };
 export interface WebsiteMarketingPublicConfig {
     schemaVersion: 1;
@@ -220,8 +249,60 @@ export interface Product {
     media: ProductMedia[];
     attributes: ProductAttribute[];
     relatedProducts: ProductRelatedProduct[];
+    optionGroup: ProductOptionGroup | null;
+    /** Public, non-empty technical specification resolved by Bacano. */
+    specification: ProductSpecification | null;
+}
+export interface ProductSpecification {
+    contentTypeId: string;
+    key: string;
+    name: string;
+    sections: ProductSpecificationSection[];
+}
+export interface ProductSpecificationSection {
+    id: string | null;
+    key: string;
+    title: string;
+    description: string | null;
+    sortOrder: number;
+    fields: ProductSpecificationField[];
+}
+export interface ProductSpecificationField {
+    id: string;
+    key: string;
+    label: string;
+    type: "text" | "number" | "measure" | "boolean" | "date" | "select" | "component";
+    sortOrder: number;
+    value: string | number | boolean | ProductSpecificationOption | ProductSpecificationOption[] | ProductSpecificationMeasure | ProductSpecificationField[];
+}
+export interface ProductSpecificationOption {
+    id: string;
+    key: string;
+    label: string;
+}
+export interface ProductSpecificationMeasure {
+    value: number;
+    unit: {
+        code: string;
+        symbol: string;
+        name: string;
+    };
 }
 export interface ProductRelatedProduct {
+    id: string;
+    productId: string;
+    slug: string | null;
+    name: string;
+    sku: string | null;
+    sortOrder: number;
+    media: ProductMedia[];
+}
+export interface ProductOptionGroup {
+    id: string;
+    title: string | null;
+    members: ProductOptionGroupMember[];
+}
+export interface ProductOptionGroupMember {
     id: string;
     productId: string;
     slug: string | null;
@@ -509,6 +590,40 @@ export interface ProductFilters {
     };
     /** Category-specific dynamic attributes — populated when categoryName is provided */
     attributes: AttributeFilter[];
+    /** Public technical facets derived from Bacano's typed index. */
+    technical: ProductSpecificationFacet[];
+}
+export interface ProductSpecificationFacet {
+    fieldId: string;
+    fieldPath: string;
+    key: string;
+    label: string;
+    type: "number" | "measure" | "boolean" | "date" | "select";
+    sectionKey: string | null;
+    unitCode: string | null;
+    min: number | null;
+    max: number | null;
+    dateFrom: string | null;
+    dateTo: string | null;
+    booleanValues: Array<{
+        value: boolean;
+        count: number;
+    }>;
+    options: Array<{
+        id: string;
+        key: string;
+        label: string;
+        count: number;
+        sortOrder: number;
+    }>;
+}
+export interface ProductSpecificationFilterSelection {
+    optionIds?: string[];
+    booleanValues?: boolean[];
+    min?: number;
+    max?: number;
+    dateFrom?: string;
+    dateTo?: string;
 }
 export interface GetProductFiltersOptions {
     /** When set, includes category-specific attribute facets */
@@ -542,6 +657,8 @@ export interface GetCatalogPageOptions {
     minPrice?: number;
     maxPrice?: number;
     attributesBySlug?: Record<string, string[]>;
+    /** Technical filters keyed by the stable field ID exposed in facets. */
+    technicalByField?: Record<string, ProductSpecificationFilterSelection>;
     sortBy?: ProductSortBy;
     limit?: number;
     offset?: number;
@@ -793,11 +910,30 @@ export interface Cart {
     status: string;
     createdAt: string;
     updatedAt: string;
+    volumePricing: CartVolumePricing;
+}
+export interface CartVolumePricing {
+    enabled: boolean;
+    eligibleQuantity: number;
+    appliedPriceType: "WHOLESALE" | "WHOLESALE_2" | null;
+    appliedMinQuantity: number | null;
+    nextPriceType: "WHOLESALE" | "WHOLESALE_2" | null;
+    nextMinQuantity: number | null;
+    remainingQuantity: number | null;
+    totalSavings?: number;
 }
 export interface CartItem {
     id: string;
     productVariantId: string;
     quantity: number;
+    unitPrice: number | null;
+    lineTotal: number | null;
+    baseUnitPrice?: number | null;
+    unitSavings?: number;
+    lineSavings?: number;
+    volumePricingEligible?: boolean;
+    resolvedPriceType: ProductPriceType | null;
+    volumePricingMinQuantity: number | null;
     productVariant: {
         sku: string;
         product: {