@pinelab/vendure-plugin-qls-fulfillment 1.7.0 → 1.8.1

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+# 1.8.1 (2026-04-24)
+
+- Replaced `saveRawWarehouseStockData` boolean with `saveAdditionalData` hook, allowing you to handle and persist any QLS product data yourself
+
+# 1.8.0 (2026-04-21)
+
+- Added configurable `saveRawWarehouseStockData` option
+
 # 1.7.0 (2026-03-15)
 
 - Pass order phone number to QLS

package/dist/custom-fields.d.ts

@@ -2,6 +2,7 @@ import { CustomFieldConfig } from '@vendure/core';
 declare module '@vendure/core' {
     interface CustomProductVariantFields {
         qlsProductId?: string;
+        qlsRawWarehouseStockData?: string;
     }
     interface CustomOrderFields {
         qlsServicePointId?: string;

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

@@ -69,6 +69,7 @@ export type FulfillmentProduct = {
      * All EANs of the product, including the main EAN
      */
     barcodes_and_ean: string[];
+    warehouse_stocks?: unknown[];
 };
 export interface FulfillmentOrderInput {
     brand_id: string;

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

@@ -15,6 +15,7 @@ export declare class QlsClient {
      * Returns the first product found, or undefined if no product is found.
      */
     getFulfillmentProductBySku(sku: string): Promise<FulfillmentProduct | undefined>;
+    getFulfillmentProductById(fulfillmentProductId: string): Promise<FulfillmentProduct | undefined>;
     /**
      * Get stock for all fulfillment products.
      * Might require multiple requests if the result is paginated.

package/dist/lib/qls-client.js

@@ -34,6 +34,13 @@ class QlsClient {
         }
         return result.data[0];
     }
+    async getFulfillmentProductById(fulfillmentProductId) {
+        const result = await this.rawRequest('GET', `fulfillment/products/${fulfillmentProductId}`);
+        if (!result.data) {
+            return undefined;
+        }
+        return result.data;
+    }
     /**
      * Get stock for all fulfillment products.
      * Might require multiple requests if the result is paginated.

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

@@ -62,7 +62,10 @@ export declare class QlsProductService implements OnModuleInit, OnApplicationBoo
     /**
      * Determines if a product needs to be created or updated in QLS based on the given variant and existing QLS product.
      */
-    createOrUpdateProductInQls(ctx: RequestContext, client: QlsClient, variant: ProductVariant, existingProduct: FulfillmentProduct | null): Promise<'created' | 'updated' | 'not-changed'>;
+    createOrUpdateProductInQls(ctx: RequestContext, client: QlsClient, variant: ProductVariant, existingProduct: FulfillmentProduct | null): Promise<{
+        status: 'created' | 'updated' | 'not-changed';
+        qlsProductId?: string;
+    }>;
     /**
      * Update the additional EANs/barcodes for a product in QLS if needed
      */

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

@@ -127,13 +127,13 @@ let QlsProductService = class QlsProductService {
                 try {
                     const existingQlsProduct = allQlsProducts.find((p) => p.sku == variant.sku);
                     const result = await this.createOrUpdateProductInQls(ctx, client, variant, existingQlsProduct ?? null);
-                    if (result === 'created') {
+                    if (result.status === 'created') {
                         createdQlsProducts.push(variant);
                     }
-                    else if (result === 'updated') {
+                    else if (result.status === 'updated') {
                         updatedQlsProducts.push(variant);
                     }
-                    if (result === 'created' || result === 'updated') {
+                    if (result.status === 'created' || result.status === 'updated') {
                         // Wait only if we created or updated a product, otherwise no calls have been made yet.
                         await waitToPreventRateLimit();
                     }
@@ -212,12 +212,23 @@ let QlsProductService = class QlsProductService {
             try {
                 const existingQlsProduct = await client.getFulfillmentProductBySku(variant.sku);
                 const result = await this.createOrUpdateProductInQls(ctx, client, variant, existingQlsProduct ?? null);
-                if (result === 'created') {
+                if (result.status === 'created') {
                     createdInQls.push(variant);
                 }
-                else if (result === 'updated') {
+                else if (result.status === 'updated') {
                     updatedInQls.push(variant);
                 }
+                if (result.qlsProductId && this.options.saveAdditionalData) {
+                    try {
+                        const qlsProduct = await client.getFulfillmentProductById(result.qlsProductId);
+                        if (qlsProduct) {
+                            await this.options.saveAdditionalData(ctx, new core_1.Injector(this.moduleRef), qlsProduct);
+                        }
+                    }
+                    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);
@@ -280,7 +291,7 @@ let QlsProductService = class QlsProductService {
     async createOrUpdateProductInQls(ctx, client, variant, existingProduct) {
         if (await this.options.excludeVariantFromSync?.(ctx, new core_1.Injector(this.moduleRef), variant)) {
             core_1.Logger.info(`Variant '${variant.sku}' excluded from sync to QLS.`, constants_1.loggerCtx);
-            return 'not-changed';
+            return { status: 'not-changed' };
         }
         if (!variant.enabled || !variant.product?.enabled) {
             const disabledEntity = !variant.enabled ? 'Variant' : 'Product';
@@ -290,7 +301,7 @@ let QlsProductService = class QlsProductService {
             else {
                 core_1.Logger.info(`${disabledEntity} '${variant.sku}' is disabled, skipping sync to QLS.`, constants_1.loggerCtx);
             }
-            return 'not-changed';
+            return { status: 'not-changed', qlsProductId: existingProduct?.id };
         }
         let qlsProduct = existingProduct;
         let createdOrUpdated = 'not-changed';
@@ -332,7 +343,7 @@ let QlsProductService = class QlsProductService {
         if (createdOrUpdated === 'not-changed') {
             core_1.Logger.info(`Variant '${variant.sku}' not updated in QLS, because no changes were found.`, constants_1.loggerCtx);
         }
-        return createdOrUpdated;
+        return { status: createdOrUpdated, qlsProductId: qlsProduct?.id };
     }
     /**
      * Update the additional EANs/barcodes for a product in QLS if needed

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import { ID, Injector, Order, ProductVariant, RequestContext, SerializedRequestContext } from '@vendure/core';
-import { CustomValue, FulfillmentOrderInput, FulfillmentOrderLineInput, FulfillmentProductInput } from './lib/client-types';
+import { CustomValue, FulfillmentOrderInput, FulfillmentOrderLineInput, FulfillmentProduct, FulfillmentProductInput } from './lib/client-types';
 export interface QlsPluginOptions {
     /**
      * Get the QLS client config for the current channel based on given context
@@ -53,6 +53,13 @@ export interface QlsPluginOptions {
      * Defaults to 'QLS'.
      */
     qlsProductIdUiTab?: string | null;
+    /**
+     * Optional hook called after syncing a variant to QLS.
+     * Receives the full QLS product, a RequestContext, and an Injector, allowing
+     * you to save any additional data to your own database. The saving itself
+     * happens inside this hook — if not provided, nothing is persisted.
+     */
+    saveAdditionalData?: (ctx: RequestContext, injector: Injector, qlsProduct: FulfillmentProduct) => Promise<void> | void;
     /**
      * Additional order items to add to the QLS order.
      */

package/package.json

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