rerobe-js-orm 4.4.9 → 4.5.1

package/lib/factories/Product/ProductFromFormState.js

@@ -4,7 +4,7 @@ const ProductFactory_1 = require("./ProductFactory");
 const Product_1 = require("../../models/Product");
 class ProductFromFormState extends ProductFactory_1.default {
     createProduct(props) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18, _19, _20, _21, _22, _23, _24, _25, _26, _27, _28, _29, _30, _31;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18, _19, _20, _21, _22, _23, _24, _25, _26, _27, _28, _29, _30, _31, _32;
         const productAttributes = {
             availableForSale: props.fields.availableForSale.selectedValue,
             description: props.fields.description.inputValue,
@@ -28,19 +28,20 @@ class ProductFromFormState extends ProductFactory_1.default {
             variantId: ((_j = props.props) === null || _j === void 0 ? void 0 : _j.variantId) || '',
             reservedBy: ((_k = props.props) === null || _k === void 0 ? void 0 : _k.reservedBy) || [],
             options: props.fields.options.selectedValue,
+            variantInventory: ((_l = props.fields.variantInventory) === null || _l === void 0 ? void 0 : _l.selectedValues) || [],
             costPerItem: props.fields.costPerItem.inputValue,
             compareAtPrice: props.fields.compareAtPrice.inputValue,
             quantity: props.fields.quantity.inputValue,
-            merchants: ((_l = props.props) === null || _l === void 0 ? void 0 : _l.merchants) || [],
-            merchantId: ((_m = props.props) === null || _m === void 0 ? void 0 : _m.merchantId) || '',
+            merchants: ((_m = props.props) === null || _m === void 0 ? void 0 : _m.merchants) || [],
+            merchantId: ((_o = props.props) === null || _o === void 0 ? void 0 : _o.merchantId) || '',
             editorAuthorizations: props.fields.editorAuthorizations.selectedValue,
             rfidTag: props.fields.rfidTag.inputValue || '',
             sku: props.fields.sku.inputValue || '',
-            metaDataDescription: ((_o = props.fields.metaDataDescription) === null || _o === void 0 ? void 0 : _o.inputValue) || '',
-            metaDataTitle: ((_p = props.fields.metaDataTitle) === null || _p === void 0 ? void 0 : _p.inputValue) || '',
+            metaDataDescription: ((_p = props.fields.metaDataDescription) === null || _p === void 0 ? void 0 : _p.inputValue) || '',
+            metaDataTitle: ((_q = props.fields.metaDataTitle) === null || _q === void 0 ? void 0 : _q.inputValue) || '',
         };
         const productFilterAttributes = {
-            documentId: (_q = props.props) === null || _q === void 0 ? void 0 : _q.documentId,
+            documentId: (_r = props.props) === null || _r === void 0 ? void 0 : _r.documentId,
             brand: props.fields.brand.selectedValue,
             measurementCategory: props.fields.measurementCategory.selectedValue,
             size: props.fields.size.selectedValue,
@@ -61,10 +62,10 @@ class ProductFromFormState extends ProductFactory_1.default {
             featuredCollections: props.fields.featuredCollections.selectedValues || [],
             primaryAgeCategory: props.fields.primaryAgeCategory.selectedValue || '',
             tags: props.fields.tags.selectedValues || [],
-            systemTags: ((_r = props.props) === null || _r === void 0 ? void 0 : _r.systemTags) || [],
+            systemTags: ((_s = props.props) === null || _s === void 0 ? void 0 : _s.systemTags) || [],
         };
         const consignmentAttributes = {
-            sellRequestId: ((_s = props.props) === null || _s === void 0 ? void 0 : _s.sellRequestId) || '',
+            sellRequestId: ((_t = props.props) === null || _t === void 0 ? void 0 : _t.sellRequestId) || '',
             publishType: props.fields.publishType.selectedValue,
             conditionRemarks: props.fields.conditionRemarks.inputValue,
             productRemarks: props.fields.productRemarks.inputValue,
@@ -77,14 +78,14 @@ class ProductFromFormState extends ProductFactory_1.default {
             nextAvailableSeason: props.fields.nextAvailableSeason.selectedValue,
             notesForProductionTeam: props.fields.notesForProductionTeam.inputValue,
             reviewedBy: props.fields.reviewedBy.selectedValue,
-            sellRequestImageUrls: ((_t = props.props) === null || _t === void 0 ? void 0 : _t.sellRequestImageUrls) || [],
+            sellRequestImageUrls: ((_u = props.props) === null || _u === void 0 ? void 0 : _u.sellRequestImageUrls) || [],
             salesChannel: props.fields.salesChannel.selectedValues || [],
             sizeComment: props.fields.sizeComment.selectedValue,
-            salePrice: ((_u = props.props) === null || _u === void 0 ? void 0 : _u.salePrice) || '',
+            salePrice: ((_v = props.props) === null || _v === void 0 ? void 0 : _v.salePrice) || '',
             isOnSale: props.fields.isOnSale.selectedValue || '',
             discountType: props.fields.discountType.selectedValue || '',
             discountValue: props.fields.discountValue.inputValue || '',
-            selectedForClearance: ((_v = props.props) === null || _v === void 0 ? void 0 : _v.selectedForClearance) || '',
+            selectedForClearance: ((_w = props.props) === null || _w === void 0 ? void 0 : _w.selectedForClearance) || '',
             locationIds: props.fields.locationIds.selectedValues || [],
             inventoryLocations: props.fields.inventoryLocations.selectedValues || [],
             majorDefects: props.fields.majorDefects.selectedValues || [], // ToDo: Deprecate
@@ -92,44 +93,44 @@ class ProductFromFormState extends ProductFactory_1.default {
             careInstructions: props.fields.careInstructions.inputValue || '',
         };
         const timestampAttributes = {
-            createdAtTimestamp: (_w = props.props) === null || _w === void 0 ? void 0 : _w.createdAtTimestamp,
-            updatedAtTimestamp: (_x = props.props) === null || _x === void 0 ? void 0 : _x.updatedAtTimestamp,
-            sellRequestReviewTimestamp: (_y = props.props) === null || _y === void 0 ? void 0 : _y.sellRequestReviewTimestamp,
-            sellRequestReviewDraftTimestamp: (_z = props.props) === null || _z === void 0 ? void 0 : _z.sellRequestReviewDraftTimestamp,
-            rejectedTimestamp: (_0 = props.props) === null || _0 === void 0 ? void 0 : _0.rejectedTimestamp,
-            holdTimestamp: (_1 = props.props) === null || _1 === void 0 ? void 0 : _1.holdTimestamp,
-            acceptedTimestamp: (_2 = props.props) === null || _2 === void 0 ? void 0 : _2.acceptedTimestamp,
-            sellerToDropOffTimestamp: (_3 = props.props) === null || _3 === void 0 ? void 0 : _3.sellerToDropOffTimestamp,
-            sellerToShipTimestamp: (_4 = props.props) === null || _4 === void 0 ? void 0 : _4.sellerToShipTimestamp,
-            sellerToGetPickUpTimestamp: (_5 = props.props) === null || _5 === void 0 ? void 0 : _5.sellerToGetPickUpTimestamp,
-            qualityControlTimestamp: (_6 = props.props) === null || _6 === void 0 ? void 0 : _6.qualityControlTimestamp,
-            pendingPublicationTimestamp: (_7 = props.props) === null || _7 === void 0 ? void 0 : _7.pendingPublicationTimestamp,
-            listedTimestamp: (_8 = props.props) === null || _8 === void 0 ? void 0 : _8.listedTimestamp,
-            clearanceTimestamp: (_9 = props.props) === null || _9 === void 0 ? void 0 : _9.clearanceTimestamp,
-            reservedTimestamp: (_10 = props.props) === null || _10 === void 0 ? void 0 : _10.reservedTimestamp,
-            soldTimestamp: (_11 = props.props) === null || _11 === void 0 ? void 0 : _11.soldTimestamp,
-            returnedTimestamp: (_12 = props.props) === null || _12 === void 0 ? void 0 : _12.returnedTimestamp,
-            soldSellerSelfPayTimestamp: (_13 = props.props) === null || _13 === void 0 ? void 0 : _13.soldSellerSelfPayTimestamp,
-            soldSellerPayoutProcessingTimestamp: (_14 = props.props) === null || _14 === void 0 ? void 0 : _14.soldSellerPayoutProcessingTimestamp,
-            soldSellerPayoutFailedTimestamp: (_15 = props.props) === null || _15 === void 0 ? void 0 : _15.soldSellerPayoutFailedTimestamp,
-            soldSellerToBePaidTimestamp: (_16 = props.props) === null || _16 === void 0 ? void 0 : _16.soldSellerToBePaidTimestamp,
-            soldSellerPaidTimestamp: (_17 = props.props) === null || _17 === void 0 ? void 0 : _17.soldSellerPaidTimestamp,
-            sellerSelfRejectTimestamp: (_18 = props.props) === null || _18 === void 0 ? void 0 : _18.sellerSelfRejectTimestamp,
-            liquidationRequestedTimestamp: (_19 = props.props) === null || _19 === void 0 ? void 0 : _19.liquidationRequestedTimestamp,
-            sellerLiquidatedTimestamp: (_20 = props.props) === null || _20 === void 0 ? void 0 : _20.sellerLiquidatedTimestamp,
-            archivedTimestamp: (_21 = props.props) === null || _21 === void 0 ? void 0 : _21.archivedTimestamp,
-            liquidationReadyTimestamp: (_22 = props.props) === null || _22 === void 0 ? void 0 : _22.liquidationReadyTimestamp,
-            sellerDonatedTimestamp: (_23 = props.props) === null || _23 === void 0 ? void 0 : _23.sellerDonatedTimestamp,
-            merchantDonatedTimestamp: (_24 = props.props) === null || _24 === void 0 ? void 0 : _24.merchantDonatedTimestamp,
-            draftTimestamp: (_25 = props.props) === null || _25 === void 0 ? void 0 : _25.draftTimestamp,
-            hiddenTimestamp: (_26 = props.props) === null || _26 === void 0 ? void 0 : _26.hiddenTimestamp,
-            bookedTimestamp: (_27 = props.props) === null || _27 === void 0 ? void 0 : _27.bookedTimestamp,
-            openTimestamp: (_28 = props.props) === null || _28 === void 0 ? void 0 : _28.openTimestamp,
+            createdAtTimestamp: (_x = props.props) === null || _x === void 0 ? void 0 : _x.createdAtTimestamp,
+            updatedAtTimestamp: (_y = props.props) === null || _y === void 0 ? void 0 : _y.updatedAtTimestamp,
+            sellRequestReviewTimestamp: (_z = props.props) === null || _z === void 0 ? void 0 : _z.sellRequestReviewTimestamp,
+            sellRequestReviewDraftTimestamp: (_0 = props.props) === null || _0 === void 0 ? void 0 : _0.sellRequestReviewDraftTimestamp,
+            rejectedTimestamp: (_1 = props.props) === null || _1 === void 0 ? void 0 : _1.rejectedTimestamp,
+            holdTimestamp: (_2 = props.props) === null || _2 === void 0 ? void 0 : _2.holdTimestamp,
+            acceptedTimestamp: (_3 = props.props) === null || _3 === void 0 ? void 0 : _3.acceptedTimestamp,
+            sellerToDropOffTimestamp: (_4 = props.props) === null || _4 === void 0 ? void 0 : _4.sellerToDropOffTimestamp,
+            sellerToShipTimestamp: (_5 = props.props) === null || _5 === void 0 ? void 0 : _5.sellerToShipTimestamp,
+            sellerToGetPickUpTimestamp: (_6 = props.props) === null || _6 === void 0 ? void 0 : _6.sellerToGetPickUpTimestamp,
+            qualityControlTimestamp: (_7 = props.props) === null || _7 === void 0 ? void 0 : _7.qualityControlTimestamp,
+            pendingPublicationTimestamp: (_8 = props.props) === null || _8 === void 0 ? void 0 : _8.pendingPublicationTimestamp,
+            listedTimestamp: (_9 = props.props) === null || _9 === void 0 ? void 0 : _9.listedTimestamp,
+            clearanceTimestamp: (_10 = props.props) === null || _10 === void 0 ? void 0 : _10.clearanceTimestamp,
+            reservedTimestamp: (_11 = props.props) === null || _11 === void 0 ? void 0 : _11.reservedTimestamp,
+            soldTimestamp: (_12 = props.props) === null || _12 === void 0 ? void 0 : _12.soldTimestamp,
+            returnedTimestamp: (_13 = props.props) === null || _13 === void 0 ? void 0 : _13.returnedTimestamp,
+            soldSellerSelfPayTimestamp: (_14 = props.props) === null || _14 === void 0 ? void 0 : _14.soldSellerSelfPayTimestamp,
+            soldSellerPayoutProcessingTimestamp: (_15 = props.props) === null || _15 === void 0 ? void 0 : _15.soldSellerPayoutProcessingTimestamp,
+            soldSellerPayoutFailedTimestamp: (_16 = props.props) === null || _16 === void 0 ? void 0 : _16.soldSellerPayoutFailedTimestamp,
+            soldSellerToBePaidTimestamp: (_17 = props.props) === null || _17 === void 0 ? void 0 : _17.soldSellerToBePaidTimestamp,
+            soldSellerPaidTimestamp: (_18 = props.props) === null || _18 === void 0 ? void 0 : _18.soldSellerPaidTimestamp,
+            sellerSelfRejectTimestamp: (_19 = props.props) === null || _19 === void 0 ? void 0 : _19.sellerSelfRejectTimestamp,
+            liquidationRequestedTimestamp: (_20 = props.props) === null || _20 === void 0 ? void 0 : _20.liquidationRequestedTimestamp,
+            sellerLiquidatedTimestamp: (_21 = props.props) === null || _21 === void 0 ? void 0 : _21.sellerLiquidatedTimestamp,
+            archivedTimestamp: (_22 = props.props) === null || _22 === void 0 ? void 0 : _22.archivedTimestamp,
+            liquidationReadyTimestamp: (_23 = props.props) === null || _23 === void 0 ? void 0 : _23.liquidationReadyTimestamp,
+            sellerDonatedTimestamp: (_24 = props.props) === null || _24 === void 0 ? void 0 : _24.sellerDonatedTimestamp,
+            merchantDonatedTimestamp: (_25 = props.props) === null || _25 === void 0 ? void 0 : _25.merchantDonatedTimestamp,
+            draftTimestamp: (_26 = props.props) === null || _26 === void 0 ? void 0 : _26.draftTimestamp,
+            hiddenTimestamp: (_27 = props.props) === null || _27 === void 0 ? void 0 : _27.hiddenTimestamp,
+            bookedTimestamp: (_28 = props.props) === null || _28 === void 0 ? void 0 : _28.bookedTimestamp,
+            openTimestamp: (_29 = props.props) === null || _29 === void 0 ? void 0 : _29.openTimestamp,
         };
         const payoutAttributes = {
-            payoutMethod: (_29 = props.props) === null || _29 === void 0 ? void 0 : _29.payoutMethod,
-            payoutSystem: (_30 = props.props) === null || _30 === void 0 ? void 0 : _30.payoutSystem,
-            payoutReference: (_31 = props.props) === null || _31 === void 0 ? void 0 : _31.payoutReference,
+            payoutMethod: (_30 = props.props) === null || _30 === void 0 ? void 0 : _30.payoutMethod,
+            payoutSystem: (_31 = props.props) === null || _31 === void 0 ? void 0 : _31.payoutSystem,
+            payoutReference: (_32 = props.props) === null || _32 === void 0 ? void 0 : _32.payoutReference,
         };
         return new Product_1.default(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, productAttributes), productFilterAttributes), consignmentAttributes), timestampAttributes), payoutAttributes));
     }

package/lib/form-states/Product/ProductFormState.d.ts

@@ -3,6 +3,7 @@ import Product from '../../models/Product';
 export default class ProductFormState extends FormState {
     fields: ProductFormFields;
     props: CompleteProduct;
+    private variantAxes?;
     opts: {
         featuredCollectionOpts: {
             label: string;
@@ -59,5 +60,41 @@ export default class ProductFormState extends FormState {
     private discountValueChangeHandler;
     private calculateSalePrice;
     private inventoryLocationsChangeHandler;
+    private isSameOptions;
+    private getExistingVariantByOptions;
+    private variantInventoryChangeHandler;
+    setVariantAxes(axes?: {
+        [axis: string]: string[];
+    }): void;
+    generateVariantsFromAxes(defaults?: Partial<VariantInventory>): void;
+    addAxis(axis: string): void;
+    removeAxis(axis: string): void;
+    addAxisValue(axis: string, value: string): void;
+    removeAxisValue(axis: string, value: string): void;
+    reorderAxes(order: string[]): void;
+    upsertVariantByOptions(options: {
+        [k: string]: string;
+    }, patch: Partial<VariantInventory>): void;
+    removeVariantByOptions(options: {
+        [k: string]: string;
+    }): void;
+    findVariantByOptions(options: {
+        [k: string]: string;
+    }): VariantInventory | undefined;
+    validateAxes(axes: {
+        [axis: string]: string[];
+    }): {
+        ok: boolean;
+        errors: string[];
+    };
+    diffVariantsFromAxes(nextAxes: {
+        [axis: string]: string[];
+    }): {
+        toAdd: {
+            [k: string]: string;
+        }[];
+        toRemove: string[];
+    };
+    private aggregateInventoryLocationsFromVariants;
     private fieldFactory;
 }

package/lib/form-states/Product/ProductFormState.js

@@ -1,4 +1,15 @@
 "use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const FormState_1 = require("../FormState");
 const options_1 = require("./options");
@@ -87,6 +98,8 @@ class ProductFormState extends FormState_1.default {
         this.fields.handle = this.fieldFactory('textInput', 'handle');
         // Product Classification (UNIQUE, MULTIVARIANT, TEMPLATE)
         this.fields.productClass = this.fieldFactory('singleSelect', 'productClass', options_1.productClassOptions);
+        // Variant inventory per option-combination (max 3 axes)
+        this.fields.variantInventory = this.fieldFactory('multiSelect', 'variantInventory');
     }
     autoCreateTitle() {
         return this.createProduct().autoCreateTitle();
@@ -569,6 +582,289 @@ class ProductFormState extends FormState_1.default {
             this.multiSelectChangeHandler('inventoryLocations', val);
         }
     }
+    isSameOptions(a = {}, b = {}) {
+        const aKeys = Object.keys(a || {});
+        const bKeys = Object.keys(b || {});
+        if (aKeys.length !== bKeys.length)
+            return false;
+        return aKeys.every((k) => String(a[k]) === String(b[k]));
+    }
+    getExistingVariantByOptions(options = {}) {
+        var _a;
+        return ((_a = this.fields.variantInventory) === null || _a === void 0 ? void 0 : _a.selectedValues).find((v) => this.isSameOptions(v.options, options));
+    }
+    variantInventoryChangeHandler(val) {
+        var _a;
+        const numAxes = (val === null || val === void 0 ? void 0 : val.options) ? Object.keys(val.options).length : 0;
+        if (numAxes > 3) {
+            return; // silently ignore invalid (>3 axes)
+        }
+        const id = (val === null || val === void 0 ? void 0 : val.id) ||
+            ((val === null || val === void 0 ? void 0 : val.options) ? (_a = this.getExistingVariantByOptions(val.options)) === null || _a === void 0 ? void 0 : _a.id : undefined) ||
+            this.utilities.makeRandId(28);
+        const existingInd = this.fields.variantInventory.selectedValues.findIndex((i) => i.id === id);
+        const existing = existingInd !== -1 ? this.fields.variantInventory.selectedValues[existingInd] : {};
+        const next = {
+            id,
+            options: val.options || existing.options || {},
+            locations: (val === null || val === void 0 ? void 0 : val.locations) !== undefined ? val.locations : existing.locations,
+            price: (val === null || val === void 0 ? void 0 : val.price) !== undefined ? val.price : existing.price,
+            compareAtPrice: (val === null || val === void 0 ? void 0 : val.compareAtPrice) !== undefined ? val.compareAtPrice : existing.compareAtPrice,
+            salePrice: (val === null || val === void 0 ? void 0 : val.salePrice) !== undefined ? val.salePrice : existing.salePrice,
+            isOnSale: (val === null || val === void 0 ? void 0 : val.isOnSale) !== undefined ? val.isOnSale : existing.isOnSale,
+            sku: (val === null || val === void 0 ? void 0 : val.sku) !== undefined ? val.sku : existing.sku,
+            taxable: (val === null || val === void 0 ? void 0 : val.taxable) !== undefined ? val.taxable : existing.taxable,
+        };
+        const foundInd = this.fields.variantInventory.selectedValues.findIndex((i) => i.id === id);
+        if (foundInd !== -1) {
+            const foundI = this.fields.variantInventory.selectedValues[foundInd];
+            let shouldToggleRemove = false;
+            if ((val === null || val === void 0 ? void 0 : val.locations) !== undefined) {
+                const norm = (arr = []) => [...arr]
+                    .filter((l) => l && l.id)
+                    .sort((a, b) => (a.id > b.id ? 1 : a.id < b.id ? -1 : 0))
+                    .map((l) => `${l.id}:${Number(l.availableAmount) || 0}:${Number(l.incomingAmount) || 0}`)
+                    .join('|');
+                shouldToggleRemove = norm(foundI.locations) === norm(next.locations);
+            }
+            if (shouldToggleRemove) {
+                this.fields.variantInventory.selectedValues.splice(foundInd, 1);
+            }
+            else {
+                this.fields.variantInventory.selectedValues.splice(foundInd, 1, next);
+            }
+        }
+        else {
+            this.multiSelectChangeHandler('variantInventory', next);
+        }
+        // aggregate updates
+        const totalQty = this.fields.variantInventory.selectedValues.reduce((acc, cur) => {
+            const locs = cur.locations;
+            const sum = Array.isArray(locs) ? locs.reduce((a, l) => a + (Number(l === null || l === void 0 ? void 0 : l.availableAmount) || 0), 0) : 0;
+            return acc + sum;
+        }, 0);
+        this.fields.quantity.inputValue = totalQty;
+        this.fields.availableForSale.selectedValue = totalQty > 0;
+        // aggregate main inventoryLocations from variant locations (sum by location id)
+        this.aggregateInventoryLocationsFromVariants();
+    }
+    // Public: define axes (≤3) for generating combinations
+    setVariantAxes(axes = {}) {
+        const axisKeys = Object.keys(axes || {});
+        if (axisKeys.length > 3) {
+            // trim to first 3 axes to enforce limit
+            this.variantAxes = axisKeys.slice(0, 3).reduce((acc, k) => {
+                acc[k] = Array.from(new Set((axes[k] || []).map((v) => String(v).trim()).filter(Boolean)));
+                return acc;
+            }, {});
+        }
+        else {
+            this.variantAxes = axisKeys.reduce((acc, k) => {
+                acc[k] = Array.from(new Set((axes[k] || []).map((v) => String(v).trim()).filter(Boolean)));
+                return acc;
+            }, {});
+        }
+    }
+    // Public: regenerate variants from axes, preserving existing per-variant fields where options match
+    generateVariantsFromAxes(defaults = {}) {
+        const axes = this.variantAxes || {};
+        const axisKeys = Object.keys(axes);
+        if (axisKeys.length === 0) {
+            this.fields.variantInventory.selectedValues = [];
+            this.fields.variantInventory.valid = false;
+            this.aggregateInventoryLocationsFromVariants();
+            this.fields.quantity.inputValue = 0;
+            this.fields.availableForSale.selectedValue = false;
+            return;
+        }
+        const cartesian = (keys, idx, cur, out) => {
+            if (idx >= keys.length) {
+                out.push(Object.assign({}, cur));
+                return;
+            }
+            const key = keys[idx];
+            const values = axes[key] || [];
+            values.forEach((v) => {
+                cartesian(keys, idx + 1, Object.assign(Object.assign({}, cur), { [key]: v }), out);
+            });
+        };
+        const combos = [];
+        cartesian(axisKeys, 0, {}, combos);
+        const regenerated = combos.map((opts) => {
+            var _a, _b, _c, _d, _e, _f;
+            const prev = this.getExistingVariantByOptions(opts);
+            const id = (prev === null || prev === void 0 ? void 0 : prev.id) || this.utilities.makeRandId(28);
+            const merged = {
+                id,
+                options: opts,
+                locations: (prev === null || prev === void 0 ? void 0 : prev.locations) || defaults.locations,
+                price: (_a = prev === null || prev === void 0 ? void 0 : prev.price) !== null && _a !== void 0 ? _a : defaults.price,
+                compareAtPrice: (_b = prev === null || prev === void 0 ? void 0 : prev.compareAtPrice) !== null && _b !== void 0 ? _b : defaults.compareAtPrice,
+                salePrice: (_c = prev === null || prev === void 0 ? void 0 : prev.salePrice) !== null && _c !== void 0 ? _c : defaults.salePrice,
+                isOnSale: (_d = prev === null || prev === void 0 ? void 0 : prev.isOnSale) !== null && _d !== void 0 ? _d : defaults.isOnSale,
+                sku: (_e = prev === null || prev === void 0 ? void 0 : prev.sku) !== null && _e !== void 0 ? _e : defaults.sku,
+                taxable: (_f = prev === null || prev === void 0 ? void 0 : prev.taxable) !== null && _f !== void 0 ? _f : defaults.taxable,
+            };
+            return merged;
+        });
+        this.fields.variantInventory.selectedValues = regenerated;
+        this.fields.variantInventory.valid = regenerated.length > 0;
+        // Aggregate quantity and master locations
+        const totalQty = regenerated.reduce((acc, cur) => {
+            const locs = cur.locations;
+            const sum = Array.isArray(locs) ? locs.reduce((a, l) => a + (Number(l === null || l === void 0 ? void 0 : l.availableAmount) || 0), 0) : 0;
+            return acc + sum;
+        }, 0);
+        this.fields.quantity.inputValue = totalQty;
+        this.fields.availableForSale.selectedValue = totalQty > 0;
+        this.aggregateInventoryLocationsFromVariants();
+    }
+    // Convenience helpers for UI
+    addAxis(axis) {
+        const k = String(axis).trim();
+        if (!k)
+            return;
+        const current = this.variantAxes || {};
+        if (Object.keys(current).includes(k))
+            return;
+        const nextKeys = Object.keys(current).concat(k).slice(0, 3);
+        const next = {};
+        nextKeys.forEach((key) => (next[key] = current[key] || []));
+        if (!next[k])
+            next[k] = [];
+        this.variantAxes = next;
+    }
+    removeAxis(axis) {
+        const current = this.variantAxes || {};
+        if (!current[axis])
+            return;
+        const _a = current, _b = axis, _ = _a[_b], rest = __rest(_a, [typeof _b === "symbol" ? _b : _b + ""]);
+        this.variantAxes = rest;
+        // remove affected variants by regenerating from remaining axes
+        this.generateVariantsFromAxes();
+    }
+    addAxisValue(axis, value) {
+        const current = this.variantAxes || {};
+        if (!current[axis])
+            current[axis] = [];
+        const val = String(value).trim();
+        if (!val)
+            return;
+        if (!current[axis].includes(val))
+            current[axis].push(val);
+        this.variantAxes = current;
+        this.generateVariantsFromAxes();
+    }
+    removeAxisValue(axis, value) {
+        const current = this.variantAxes || {};
+        if (!current[axis])
+            return;
+        const val = String(value).trim();
+        current[axis] = current[axis].filter((v) => v !== val);
+        this.variantAxes = current;
+        this.generateVariantsFromAxes();
+    }
+    reorderAxes(order) {
+        const current = this.variantAxes || {};
+        const keys = order.filter((k) => current[k]).slice(0, 3);
+        const rest = Object.keys(current)
+            .filter((k) => !keys.includes(k))
+            .slice(0, Math.max(0, 3 - keys.length));
+        const nextOrder = keys.concat(rest);
+        const next = {};
+        nextOrder.forEach((k) => (next[k] = current[k]));
+        this.variantAxes = next;
+        // No regen required; only presentation order
+    }
+    upsertVariantByOptions(options, patch) {
+        const prev = this.getExistingVariantByOptions(options);
+        const id = (prev === null || prev === void 0 ? void 0 : prev.id) || this.utilities.makeRandId(28);
+        this.variantInventoryChangeHandler(Object.assign({ id,
+            options }, patch));
+    }
+    removeVariantByOptions(options) {
+        const prev = this.getExistingVariantByOptions(options);
+        if (!prev)
+            return;
+        const ind = this.fields.variantInventory.selectedValues.findIndex((v) => v.id === prev.id);
+        if (ind !== -1) {
+            this.fields.variantInventory.selectedValues.splice(ind, 1);
+            // re-aggregate
+            const totalQty = this.fields.variantInventory.selectedValues.reduce((acc, cur) => {
+                const locs = cur.locations;
+                const sum = Array.isArray(locs) ? locs.reduce((a, l) => a + (Number(l === null || l === void 0 ? void 0 : l.availableAmount) || 0), 0) : 0;
+                return acc + sum;
+            }, 0);
+            this.fields.quantity.inputValue = totalQty;
+            this.fields.availableForSale.selectedValue = totalQty > 0;
+            this.aggregateInventoryLocationsFromVariants();
+        }
+    }
+    findVariantByOptions(options) {
+        return this.getExistingVariantByOptions(options);
+    }
+    validateAxes(axes) {
+        const errors = [];
+        const keys = Object.keys(axes || {});
+        if (keys.length > 3)
+            errors.push('Too many axes (max 3).');
+        keys.forEach((k) => {
+            const vals = axes[k] || [];
+            const clean = vals.map((v) => String(v).trim()).filter(Boolean);
+            if (clean.length !== vals.length)
+                errors.push(`Axis "${k}" has empty/invalid values.`);
+        });
+        return { ok: errors.length === 0, errors };
+    }
+    diffVariantsFromAxes(nextAxes) {
+        const curRows = this.fields.variantInventory.selectedValues || [];
+        const curKeySet = new Set(curRows.map((r) => JSON.stringify(r.options || {})));
+        // build combos for nextAxes
+        const keys = Object.keys(nextAxes || {});
+        const out = [];
+        const cart = (i, acc) => {
+            if (i >= keys.length) {
+                out.push(Object.assign({}, acc));
+                return;
+            }
+            const k = keys[i];
+            const vals = nextAxes[k] || [];
+            vals.forEach((v) => cart(i + 1, Object.assign(Object.assign({}, acc), { [k]: v })));
+        };
+        cart(0, {});
+        const nextKeySet = new Set(out.map((o) => JSON.stringify(o)));
+        const toAdd = out.filter((o) => !curKeySet.has(JSON.stringify(o)));
+        const toRemove = curRows.filter((r) => !nextKeySet.has(JSON.stringify(r.options || {}))).map((r) => r.id);
+        return { toAdd, toRemove };
+    }
+    aggregateInventoryLocationsFromVariants() {
+        var _a;
+        const variants = ((_a = this.fields.variantInventory) === null || _a === void 0 ? void 0 : _a.selectedValues) || [];
+        const aggregateMap = {};
+        variants
+            .filter((v) => Array.isArray(v === null || v === void 0 ? void 0 : v.locations))
+            .forEach((v) => {
+            (v.locations || []).forEach((loc) => {
+                if (!loc || !loc.id || !loc.name)
+                    return;
+                if (!aggregateMap[loc.id]) {
+                    aggregateMap[loc.id] = {
+                        id: loc.id,
+                        name: loc.name,
+                        availableAmount: Number(loc.availableAmount) || 0,
+                        incomingAmount: Number(loc.incomingAmount) || 0,
+                    };
+                }
+                else {
+                    aggregateMap[loc.id].availableAmount += Number(loc.availableAmount) || 0;
+                    aggregateMap[loc.id].incomingAmount += Number(loc.incomingAmount) || 0;
+                }
+            });
+        });
+        const aggregated = Object.values(aggregateMap);
+        this.fields.inventoryLocations.selectedValues = aggregated;
+        this.fields.inventoryLocations.valid = aggregated.length > 0;
+    }
     fieldFactory(fieldType, fieldKey, fieldOptions) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
         let options = fieldOptions || [];
@@ -859,6 +1155,9 @@ class ProductFormState extends FormState_1.default {
             if (fieldKey === 'inventoryLocations') {
                 onChangeHandler = (val) => this.inventoryLocationsChangeHandler(val);
             }
+            if (fieldKey === 'variantInventory') {
+                onChangeHandler = (val) => this.variantInventoryChangeHandler(val);
+            }
             return {
                 options,
                 hidden,

package/lib/models/Product.d.ts

@@ -11,6 +11,25 @@ export default class Product extends Base {
     toObj(): CompleteProduct;
     toProductInputObjForShopify(location?: string): any;
     toProductInputObjForShopifyV2(locationId: string, weightUnit?: string): any[];
+    toProductInputObjForShopifyV3(locationId: string, weightUnit?: string): {
+        title: string;
+        status: string;
+        productOptions: {
+            name: string;
+            values: {
+                name: string;
+            }[];
+        }[];
+        descriptionHtml: string;
+        productType: string;
+        vendor: string;
+        tags: (string | null)[];
+        files: {
+            originalSource: string;
+            contentType: string;
+        }[];
+        variants: any[];
+    };
     toObjForTextTranslation(): TranslatableAttributes;
     toObjForTypesense(isCanonicalMerchant?: boolean): TypesenseProductObj;
     buildUpdatedFieldsForSalesChannel(): {

package/lib/models/Product.js

@@ -29,6 +29,7 @@ class Product extends Base_1.default {
             variantId: (props === null || props === void 0 ? void 0 : props.variantId) || '',
             reservedBy: (props === null || props === void 0 ? void 0 : props.reservedBy) || [],
             options: (props === null || props === void 0 ? void 0 : props.options) || {},
+            variantInventory: (props === null || props === void 0 ? void 0 : props.variantInventory) || [],
             costPerItem: (props === null || props === void 0 ? void 0 : props.costPerItem) || '',
             compareAtPrice: (props === null || props === void 0 ? void 0 : props.compareAtPrice) || '',
             quantity: (props === null || props === void 0 ? void 0 : props.quantity) || 0,
@@ -289,6 +290,150 @@ class Product extends Base_1.default {
         }
         return [productInputObj];
     }
+    toProductInputObjForShopifyV3(locationId, weightUnit) {
+        var _a;
+        const title = this.attributes.title || `Ribbn Product ${this.attributes.handle || this.filterAttributes.documentId}`;
+        const inInventoryStatuses = [
+            product_constants_1.PRODUCT_STATES.draft,
+            product_constants_1.PRODUCT_STATES.qualityControl,
+            product_constants_1.PRODUCT_STATES.pendingPublication,
+            product_constants_1.PRODUCT_STATES.listed,
+            product_constants_1.PRODUCT_STATES.availableInStore,
+            product_constants_1.PRODUCT_STATES.hold,
+            product_constants_1.PRODUCT_STATES.archived,
+        ];
+        const baseVariantFields = () => ({
+            inventoryPolicy: 'DENY',
+            inventoryItem: {
+                cost: this.utilities.sanitizeNumber(this.attributes.costPerItem, 0),
+                tracked: true,
+                measurement: {
+                    weight: {
+                        weight: parseFloat(this.attributes.weight) || parseFloat('999'),
+                        weightUnit: weightUnit || 'GRAMS',
+                    },
+                },
+            },
+            sku: this.attributes.sku,
+            price: this.attributes.price || '0',
+            compareAtPrice: this.attributes.price || '0',
+            taxable: this.attributes.isTaxable === 'yes' ? true : false,
+        });
+        const passedTags = ((_a = this.filterAttributes.tags) === null || _a === void 0 ? void 0 : _a.length) ? this.filterAttributes.tags : [];
+        const tags = [
+            this.filterAttributes.documentId ? `ribbnId:${this.filterAttributes.documentId}` : null,
+            ...passedTags,
+        ].filter(Boolean);
+        const files = this.attributes.imageUrls
+            ? this.attributes.imageUrls.map((image) => ({
+                originalSource: image.trim(),
+                contentType: 'IMAGE',
+            }))
+            : [];
+        const variantsFromInventory = Array.isArray(this.attributes.variantInventory)
+            ? this.attributes.variantInventory
+            : [];
+        if (variantsFromInventory.length === 0) {
+            // Fallback: single-variant product (legacy behavior)
+            const variant = Object.assign(Object.assign({}, baseVariantFields()), { inventoryQuantities: [
+                    {
+                        locationId: `gid://shopify/Location/${locationId}`,
+                        name: 'available',
+                        quantity: 0,
+                    },
+                ], optionValues: [{ optionName: 'Variant', name: title }] });
+            if (inInventoryStatuses.indexOf(this.consignmentAttributes.status) !== -1) {
+                variant.inventoryQuantities[0].quantity = 1;
+            }
+            if (this.consignmentAttributes.salePrice &&
+                Boolean(this.timestampAttributes.clearanceTimestamp) &&
+                this.consignmentAttributes.isOnSale === 'yes') {
+                variant.price = this.consignmentAttributes.salePrice;
+                variant.compareAtPrice = this.attributes.price || variant.compareAtPrice;
+            }
+            return {
+                title,
+                status: 'DRAFT',
+                productOptions: [{ name: 'Variant', values: [{ name: title }] }],
+                descriptionHtml: this.attributes.description,
+                productType: this.filterAttributes.productType,
+                vendor: this.attributes.vendorId,
+                tags,
+                files,
+                variants: [variant],
+            };
+        }
+        // Multi-variant: derive axes and values from variantInventory
+        const axisOrder = [];
+        const axisValuesMap = {};
+        variantsFromInventory.forEach((v) => {
+            Object.keys(v.options || {}).forEach((axis) => {
+                if (!axisOrder.includes(axis))
+                    axisOrder.push(axis);
+                if (!axisValuesMap[axis])
+                    axisValuesMap[axis] = new Set();
+                const value = String(v.options[axis]);
+                if (value)
+                    axisValuesMap[axis].add(value);
+            });
+        });
+        const limitedAxes = axisOrder.slice(0, 3);
+        const productOptions = limitedAxes.map((axis) => ({
+            name: axis,
+            values: Array.from(axisValuesMap[axis] || new Set()).map((name) => ({ name })),
+        }));
+        const variants = variantsFromInventory.map((v) => {
+            var _a, _b, _c, _d, _e, _f, _g;
+            const optionValues = limitedAxes.map((axis) => ({
+                optionName: axis,
+                name: String(v.options[axis] || ''),
+            }));
+            const inventoryQuantities = Array.isArray(v.locations) && v.locations.length > 0
+                ? [
+                    {
+                        locationId: `gid://shopify/Location/${locationId}`,
+                        name: 'available',
+                        quantity: (v.locations || []).reduce((acc, l) => acc + (Number(l === null || l === void 0 ? void 0 : l.availableAmount) || 0), 0),
+                    },
+                ]
+                : [
+                    {
+                        locationId: `gid://shopify/Location/${locationId}`,
+                        name: 'available',
+                        quantity: inInventoryStatuses.indexOf(this.consignmentAttributes.status) !== -1 ? 1 : 0,
+                    },
+                ];
+            const basePrice = ((_b = (_a = v.price) !== null && _a !== void 0 ? _a : this.attributes.price) !== null && _b !== void 0 ? _b : '0');
+            const variant = Object.assign(Object.assign({}, baseVariantFields()), { optionValues,
+                inventoryQuantities });
+            if (v.sku) {
+                variant.sku = v.sku;
+            }
+            if (v.taxable !== undefined) {
+                variant.taxable = v.taxable === 'yes';
+            }
+            variant.price = basePrice;
+            variant.compareAtPrice = ((_c = v.compareAtPrice) !== null && _c !== void 0 ? _c : basePrice);
+            const onSale = ((_d = v.isOnSale) !== null && _d !== void 0 ? _d : this.consignmentAttributes.isOnSale);
+            const salePrice = ((_e = v.salePrice) !== null && _e !== void 0 ? _e : this.consignmentAttributes.salePrice);
+            if (salePrice && Boolean(this.timestampAttributes.clearanceTimestamp) && onSale === 'yes') {
+                variant.price = salePrice;
+                variant.compareAtPrice = ((_g = (_f = v.compareAtPrice) !== null && _f !== void 0 ? _f : this.attributes.price) !== null && _g !== void 0 ? _g : basePrice);
+            }
+            return variant;
+        });
+        return {
+            title,
+            status: 'DRAFT',
+            productOptions,
+            descriptionHtml: this.attributes.description,
+            productType: this.filterAttributes.productType,
+            vendor: this.attributes.vendorId,
+            tags,
+            files,
+            variants,
+        };
+    }
     toObjForTextTranslation() {
         return {
             description: this.attributes.description || this.FIELD_NOT_TRANSLATABLE_KEY,

package/lib/types/rerobe-product-types.d.ts

@@ -30,7 +30,8 @@ type ProductAttributes = {
     metaDataTitle?: string;
     metaDataDescription?: string;
     isTaxable?: string;
-    productClass?: 'UNIQUE' | 'MULTIVARIANT' | 'TEMPLATE' | string;
+    productClass?: 'UNIQUE' | 'MULTIVARIANT' | 'TEMPLATE' | 'SUPPLY' | 'DIGITAL' | string;
+    variantInventory?: VariantInventory[];
 };
 type ProductFilterAttributes = {
     documentId: string;
@@ -151,6 +152,18 @@ type MaterialComposition = {
 type EditorAuthorization = {
     [key: string]: string[];
 };
+type VariantOptions = Record<string, string>;
+type VariantInventory = {
+    id: string;
+    options: VariantOptions;
+    locations?: InventoryLocation[];
+    price?: string;
+    compareAtPrice?: string;
+    salePrice?: string;
+    isOnSale?: 'yes' | 'no';
+    sku?: string;
+    taxable?: 'yes' | 'no';
+};
 type ProductSellStatusKeys = 'SELL_REQUEST_REVIEW' | 'REJECTED' | 'HOLD' | 'ACCEPTED' | 'DROP_OFF_AT_REROBE' | 'SHIP_TO_REROBE' | 'AT_HOME_PICK_UP' | 'QUALITY_CONTROL' | 'LISTED' | 'SOLD' | 'RETURNED' | 'SOLD_SELLER_TO_BE_PAID' | 'SOLD_SELLER_PAID' | 'HIDDEN' | 'BOOKED' | 'OPEN';
 type ProductPublishKeys = 'USER_PUBLISHED' | 'MERCHANT_PUBLISHED';
 type ShopifyProduct = ProductAttributes & ProductFilterAttributes;
@@ -186,6 +199,7 @@ type ProductAttributesFormFields = {
     handle: TextInputFormField<string>;
     isTaxable: SingleSelectFormField<string>;
     productClass: SingleSelectFormField<string>;
+    variantInventory: MultiSelectFormField<VariantInventory>;
 };
 type ProductFilterAttributesFormFields = {
     brand: SingleSelectFormField<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rerobe-js-orm",
-  "version": "4.4.9",
+  "version": "4.5.1",
   "description": "ReRobe's Javascript ORM Framework",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",