brainerce 1.23.12 → 1.23.13

package/README.md

@@ -3047,7 +3047,7 @@ const attributes = await client.listAttributes();
 // Create a color swatch attribute
 const colorAttr = await client.createAttribute({
   name: 'Color',
-  displayType: 'COLOR_SWATCH', // Options: 'DEFAULT' | 'COLOR_SWATCH' | 'IMAGE_SWATCH'
+  displayType: 'COLOR_SWATCH', // Options: 'DEFAULT' | 'COLOR_SWATCH' | 'IMAGE_SWATCH' | 'MIXED_SWATCH'
   source: 'GLOBAL',
 });
 
@@ -3081,6 +3081,25 @@ await client.createAttributeOption(materialAttr.id, {
   source: 'GLOBAL',
 });
 
+// Mixed swatch attribute — each option independently uses color or image (image takes priority)
+const finishAttr = await client.createAttribute({
+  name: 'Finish',
+  displayType: 'MIXED_SWATCH',
+  source: 'GLOBAL',
+});
+await client.createAttributeOption(finishAttr.id, {
+  name: 'Gold',
+  value: 'gold',
+  swatchColor: '#FFD700',
+  source: 'GLOBAL',
+});
+await client.createAttributeOption(finishAttr.id, {
+  name: 'Marble',
+  value: 'marble',
+  swatchImageUrl: 'https://example.com/marble.jpg',
+  source: 'GLOBAL',
+});
+
 // Default attribute (text buttons/dropdown)
 const sizeAttr = await client.createAttribute({
   name: 'Size',

package/dist/index.d.mts

@@ -4354,6 +4354,8 @@ interface Modifier {
     isDefault: boolean;
     /** Sold-out toggle: `false` = out of stock, hidden as selectable in storefronts. */
     available: boolean;
+    /** When `true`, this modifier is never allocated as a free selection — customers always pay its `priceDelta` even when `freeQuantity > 0` on the group. */
+    excludeFromFree?: boolean;
     /**
      * Nested-combo target. When present, picking this modifier opens the
      * referenced product's own modifier groups (depth ≤ 3).
@@ -4524,6 +4526,8 @@ interface CreateModifierInput {
     position?: number;
     isDefault?: boolean;
     available?: boolean;
+    /** When `true`, never allocated as a free selection — customers always pay this modifier's `priceDelta`. */
+    excludeFromFree?: boolean;
     referencedProductId?: string;
 }
 interface UpdateModifierInput extends Partial<CreateModifierInput> {

package/dist/index.d.ts

@@ -4354,6 +4354,8 @@ interface Modifier {
     isDefault: boolean;
     /** Sold-out toggle: `false` = out of stock, hidden as selectable in storefronts. */
     available: boolean;
+    /** When `true`, this modifier is never allocated as a free selection — customers always pay its `priceDelta` even when `freeQuantity > 0` on the group. */
+    excludeFromFree?: boolean;
     /**
      * Nested-combo target. When present, picking this modifier opens the
      * referenced product's own modifier groups (depth ≤ 3).
@@ -4524,6 +4526,8 @@ interface CreateModifierInput {
     position?: number;
     isDefault?: boolean;
     available?: boolean;
+    /** When `true`, never allocated as a free selection — customers always pay this modifier's `priceDelta`. */
+    excludeFromFree?: boolean;
     referencedProductId?: string;
 }
 interface UpdateModifierInput extends Partial<CreateModifierInput> {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainerce",
-  "version": "1.23.12",
+  "version": "1.23.13",
   "description": "Official SDK for building e-commerce storefronts with Brainerce Platform. Perfect for vibe-coded sites, AI-built stores (Cursor, Lovable, v0), and custom storefronts.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",