rerobe-js-orm 4.4.8 → 4.5.0

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

@@ -59,5 +59,8 @@ export default class ProductFormState extends FormState {
     private discountValueChangeHandler;
     private calculateSalePrice;
     private inventoryLocationsChangeHandler;
+    private generateVariantId;
+    private variantInventoryChangeHandler;
+    private aggregateInventoryLocationsFromVariants;
     private fieldFactory;
 }

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

@@ -85,8 +85,10 @@ class ProductFormState extends FormState_1.default {
         this.fields.metaDataTitle = this.fieldFactory('textInput', 'metaDataTitle');
         this.fields.metaDataDescription = this.fieldFactory('textInput', 'metaDataDescription');
         this.fields.handle = this.fieldFactory('textInput', 'handle');
-        // Product Classification (UNIQUE, MULTI, TEMPLATE)
+        // 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 +571,84 @@ class ProductFormState extends FormState_1.default {
             this.multiSelectChangeHandler('inventoryLocations', val);
         }
     }
+    generateVariantId(options) {
+        const entries = Object.entries(options || {}).sort(([a], [b]) => (a > b ? 1 : a < b ? -1 : 0));
+        return entries.map(([k, v]) => `${this.utilities.camelCase(k)}=${String(v).trim()}`).join('|');
+    }
+    variantInventoryChangeHandler(val) {
+        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) || this.generateVariantId((val === null || val === void 0 ? void 0 : val.options) || {});
+        const next = {
+            id,
+            options: val.options || {},
+            locations: val === null || val === void 0 ? void 0 : val.locations,
+        };
+        const existingIds = this.fields.variantInventory.selectedValues.map((i) => i.id);
+        if (existingIds.includes(id)) {
+            const foundInd = this.fields.variantInventory.selectedValues.findIndex((i) => i.id === id);
+            const foundI = this.fields.variantInventory.selectedValues[foundInd];
+            const sameLocations = (() => {
+                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('|');
+                return norm(foundI.locations) === norm(next.locations);
+            })();
+            if (sameLocations) {
+                // same locations => toggle remove
+                this.fields.variantInventory.selectedValues.splice(foundInd, 1);
+            }
+            else {
+                // update quantity/options
+                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();
+    }
+    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 +939,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/form-states/Product/options.js

@@ -1062,17 +1062,27 @@ const productClassOptions = [
     {
         label: 'Unique',
         value: 'UNIQUE',
-        description: 'One-of-a-kind, no variants',
+        description: 'One-of-a-kind product with no variants (e.g., vintage clothing, collectibles).',
     },
     {
-        label: 'Multiple',
-        value: 'MULTI',
-        description: 'Many duplicates of the same product (e.g., gift cards, shopping bags, etc.)',
+        label: 'Multi-Variant',
+        value: 'MULTIVARIANT',
+        description: 'A product that has multiple variants (e.g., size, color, style).',
     },
     {
         label: 'Template',
         value: 'TEMPLATE',
-        description: 'Blueprint for cloning a variant of the product at checkout',
+        description: 'A blueprint used to quickly clone or create a variant of the product at checkout.',
+    },
+    {
+        label: 'Supply',
+        value: 'SUPPLY',
+        description: 'Order-related inventory items such as shopping bags or other sellable supplies.',
+    },
+    {
+        label: 'Digital',
+        value: 'DIGITAL',
+        description: 'Non-physical products that never run out of stock (e.g., gift cards, downloads).',
     },
 ];
 exports.productClassOptions = productClassOptions;

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' | 'MULTI' | '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.8",
+  "version": "4.5.0",
   "description": "ReRobe's Javascript ORM Framework",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",