@pinelab/vendure-plugin-qls-fulfillment 2.2.0 → 2.2.1

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+# 2.2.1 (2026-07-15)
+
+- Emit `StockMovementEvent` with corresponding `StockAdjustment` whenever a QLS webhook updates stock of a variant.
+
 # 2.2.0 (2026-07-15)
 
 - Added buttons on variant and order detail to view the product and order in QLS dashboard.

package/dist/services/qls-product.service.d.ts

@@ -66,9 +66,10 @@ export declare class QlsProductService implements OnModuleInit, OnApplicationBoo
      */
     addAdditionalEANsToQls(ctx: RequestContext, variantId: ID, additionalEANs: string[]): Promise<string[]>;
     /**
-     * Update the stock level for a variant based on the given available stock
+     * Update the stock level for a variant based on the given available stock.
+     * Returns true if the stock changed
      */
-    updateStockBySku(ctx: RequestContext, sku: string, availableStock: number): Promise<void>;
+    updateStockBySku(ctx: RequestContext, sku: string, availableStock: number): Promise<boolean>;
     /**
      * Determines if a product needs to be created or updated in QLS based on the given variant and existing QLS product.
      */
@@ -85,7 +86,8 @@ export declare class QlsProductService implements OnModuleInit, OnApplicationBoo
      */
     private getAllVariants;
     /**
-     * Update stock level for a variant based on the given available stock
+     * Update stock level for a variant based on the given available stock.
+     * Returns true if the stock changed.
      */
     private updateStock;
 }

package/dist/services/qls-product.service.js

@@ -312,20 +312,22 @@ let QlsProductService = class QlsProductService {
         return eansToAdd;
     }
     /**
-     * Update the stock level for a variant based on the given available stock
+     * Update the stock level for a variant based on the given available stock.
+     * Returns true if the stock changed
      */
     async updateStockBySku(ctx, sku, availableStock) {
         const result = await this.variantService.findAll(ctx, {
             filter: { sku: { eq: sku } },
         });
         if (!result.items.length) {
-            return core_1.Logger.info(`Variant with sku '${sku}' not found, not updating stock`, constants_1.loggerCtx);
+            core_1.Logger.info(`Variant with sku '${sku}' not found, not updating stock`, constants_1.loggerCtx);
+            return false;
         }
         const variant = result.items[0];
         if (result.items.length > 1) {
             core_1.Logger.error(`Multiple variants found for sku '${sku}', using '${variant.id}'`, constants_1.loggerCtx);
         }
-        await this.updateStock(ctx, variant.id, availableStock);
+        return await this.updateStock(ctx, variant.id, availableStock);
     }
     /**
      * Determines if a product needs to be created or updated in QLS based on the given variant and existing QLS product.
@@ -431,24 +433,43 @@ let QlsProductService = class QlsProductService {
         return allVariants;
     }
     /**
-     * Update stock level for a variant based on the given available stock
+     * Update stock level for a variant based on the given available stock.
+     * Returns true if the stock changed.
      */
     async updateStock(ctx, variantId, availableStock) {
         if (!this.options.productSync.synchronizeStockLevels) {
             core_1.Logger.warn(`Stock sync disabled. Not updating stock for variant '${variantId}'`, constants_1.loggerCtx);
-            return;
+            return false;
         }
         // Find default Stock Location
         const defaultStockLocation = await this.stockLocationService.defaultStockLocation(ctx);
-        // Get current stock level id
-        const { id: stockLevelId } = await this.stockLevelService.getStockLevel(ctx, variantId, defaultStockLocation.id);
-        // Update stock level
-        await this.connection.getRepository(ctx, core_1.StockLevel).save({
-            id: stockLevelId,
-            stockOnHand: availableStock,
-            stockAllocated: 0, // Reset allocations, because allocation is handled by QLS
-        });
+        // Get current stock level
+        const stockLevel = await this.stockLevelService.getStockLevel(ctx, variantId, defaultStockLocation.id);
+        const delta = availableStock - stockLevel.stockOnHand;
+        if (delta !== 0) {
+            const adjustment = new core_1.StockAdjustment({
+                quantity: delta,
+                stockLocation: { id: defaultStockLocation.id },
+                productVariant: { id: variantId },
+            });
+            // Update stock level
+            await this.connection.getRepository(ctx, core_1.StockLevel).save({
+                id: stockLevel.id,
+                stockOnHand: availableStock,
+                stockAllocated: 0, // Reset allocations, because allocation is handled by QLS
+            });
+            await this.eventBus.publish(new core_1.StockMovementEvent(ctx, [adjustment]));
+        }
+        else {
+            // No stock change, but still reset allocations to ensure consistency
+            await this.connection.getRepository(ctx, core_1.StockLevel).save({
+                id: stockLevel.id,
+                stockOnHand: availableStock,
+                stockAllocated: 0, // Reset allocations, because allocation is handled by QLS
+            });
+        }
         core_1.Logger.info(`Updated stock for variant ${variantId} to ${availableStock}`, constants_1.loggerCtx);
+        return delta !== 0;
     }
 };
 exports.QlsProductService = QlsProductService;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pinelab/vendure-plugin-qls-fulfillment",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "Vendure plugin to fulfill orders via QLS.",
   "keywords": [
     "fulfillment",