@pinelab/vendure-plugin-qls-fulfillment 3.0.0 → 3.1.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+# 3.1.0 (2026-08-12)
+
+- Trigger `saveAdditionalVariantData` from incoming stock webhooks using the webhook payload directly.
+- Avoid fetching the QLS product entity during this flow.
+- Add webhook coverage for additional variant data.
+
 # 3.0.0 (2026-07-29)
 
 - Migrated to React Dashboard.

package/dist/api/qls-webhooks-controller.js

@@ -40,7 +40,7 @@ let QlsWebhooksController = class QlsWebhooksController {
                 return core_1.Logger.error(`Incoming webhook with invalid channel token for channel '${channelToken}' to '${request.url}'`, constants_1.loggerCtx, JSON.stringify(body));
             }
             if (isStockWebhook(body)) {
-                await this.qlsProductService.updateStockBySku(ctx, body.sku, body.amount_available);
+                await this.qlsProductService.handleStockWebhook(ctx, body);
             }
             else if (isOrderWebhook(body)) {
                 await this.qlsOrderService.handleOrderStatusUpdate(ctx, body);

package/dist/lib/client-types.d.ts

@@ -163,7 +163,7 @@ export interface FulfillmentOrder {
         product: unknown;
     }>;
 }
-export type IncomingStockWebhook = Pick<FulfillmentProduct, 'sku' | 'amount_available'>;
+export type IncomingStockWebhook = FulfillmentProductDetail;
 export type IncomingOrderWebhook = Pick<FulfillmentOrder, 'customer_reference' | 'status' | 'cancelled' | 'amount_delivered' | 'amount_total'>;
 /**
  * This is the full data returend by the QLS API when fetching a fulfillment product by ID

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

@@ -1,6 +1,6 @@
 import { OnApplicationBootstrap, OnModuleInit } from '@nestjs/common';
 import { EventBus, ID, Job, JobQueueService, ListQueryBuilder, ProductPriceApplicator, ProductVariant, ProductVariantService, RequestContext, StockLevelService, StockLocationService, TransactionalConnection } from '@vendure/core';
-import { FulfillmentProduct } from '../lib/client-types';
+import { FulfillmentProduct, IncomingStockWebhook } from '../lib/client-types';
 import { QlsClient } from '../lib/qls-client';
 import { QlsPluginOptions, QlsProductJobData } from '../types';
 import { ModuleRef } from '@nestjs/core';
@@ -66,10 +66,13 @@ 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.
-     * Returns true if the stock changed
+     * Update the stock level for a variant based on its SKU.
      */
     updateStockBySku(ctx: RequestContext, sku: string, availableStock: number): Promise<boolean>;
+    /**
+     * Handles an incoming stock webhook and saves any additional variant data.
+     */
+    handleStockWebhook(ctx: RequestContext, qlsProduct: IncomingStockWebhook): Promise<boolean>;
     /**
      * Determines if a product needs to be created or updated in QLS based on the given variant and existing QLS product.
      */

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

@@ -217,18 +217,6 @@ let QlsProductService = class QlsProductService {
                 else if (result.status === 'updated') {
                     updatedInQls.push(variant);
                 }
-                if (result.qlsProductId &&
-                    this.options.productSync.saveAdditionalVariantData) {
-                    try {
-                        const qlsProduct = await client.getFulfillmentProductById(result.qlsProductId);
-                        if (qlsProduct) {
-                            await this.options.productSync.saveAdditionalVariantData(ctx, new core_1.Injector(this.moduleRef), qlsProduct, variant);
-                        }
-                    }
-                    catch (e) {
-                        core_1.Logger.error(`Error in saveAdditionalData for variant '${variant.sku}': ${(0, catch_unknown_1.asError)(e).message}`, constants_1.loggerCtx);
-                    }
-                }
             }
             catch (e) {
                 const error = (0, catch_unknown_1.asError)(e);
@@ -312,8 +300,7 @@ let QlsProductService = class QlsProductService {
         return eansToAdd;
     }
     /**
-     * Update the stock level for a variant based on the given available stock.
-     * Returns true if the stock changed
+     * Update the stock level for a variant based on its SKU.
      */
     async updateStockBySku(ctx, sku, availableStock) {
         const result = await this.variantService.findAll(ctx, {
@@ -329,6 +316,33 @@ let QlsProductService = class QlsProductService {
         }
         return await this.updateStock(ctx, variant.id, availableStock);
     }
+    /**
+     * Handles an incoming stock webhook and saves any additional variant data.
+     */
+    async handleStockWebhook(ctx, qlsProduct) {
+        const result = await this.variantService.findAll(ctx, {
+            filter: { sku: { eq: qlsProduct.sku } },
+        });
+        if (!result.items.length) {
+            core_1.Logger.info(`Variant with sku '${qlsProduct.sku}' not found, not handling stock webhook`, constants_1.loggerCtx);
+            return false;
+        }
+        const variant = result.items[0];
+        if (result.items.length > 1) {
+            core_1.Logger.error(`Multiple variants found for sku '${qlsProduct.sku}', using '${variant.id}'`, constants_1.loggerCtx);
+        }
+        await this.updateStockBySku(ctx, qlsProduct.sku, qlsProduct.amount_available);
+        if (!this.options.productSync.saveAdditionalVariantData) {
+            return true;
+        }
+        try {
+            await this.options.productSync.saveAdditionalVariantData(ctx, new core_1.Injector(this.moduleRef), qlsProduct, variant);
+        }
+        catch (e) {
+            core_1.Logger.error(`Error in saveAdditionalData for variant '${variant.sku}': ${(0, catch_unknown_1.asError)(e).message}`, constants_1.loggerCtx);
+        }
+        return true;
+    }
     /**
      * Determines if a product needs to be created or updated in QLS based on the given variant and existing QLS product.
      */

package/package.json

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