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

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+# 3.2.0 (2026-08-12)
+
+- Restore the legacy Angular Admin UI extension alongside the React Dashboard.
+
+# 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/dist/ui/providers.ts

@@ -0,0 +1,246 @@
+import {
+  addActionBarDropdownMenuItem,
+  addActionBarItem,
+  ModalService,
+} from '@vendure/admin-ui/core';
+import { firstValueFrom, of } from 'rxjs';
+import { map, catchError, take } from 'rxjs/operators';
+import gql from 'graphql-tag';
+
+export default [
+  // Product sync button in product list
+  addActionBarDropdownMenuItem({
+    id: 'qls-fulfillment-sync',
+    label: 'Synchronize with QLS',
+    locationId: 'product-list',
+    icon: 'resistor',
+    requiresPermission: ['QLSFullSync'],
+    onClick: (_, { dataService, notificationService }) => {
+      dataService
+        .mutate(
+          gql`
+            mutation TriggerQlsProductSync {
+              triggerQlsProductSync
+            }
+          `
+        )
+        .subscribe({
+          next: () => {
+            notificationService.notify({
+              message: `Triggered QLS full product sync...`,
+              type: 'success',
+            });
+          },
+          error: (err) => {
+            notificationService.notify({
+              message: err.message,
+              type: 'error',
+            });
+          },
+        });
+    },
+  }),
+  // QLS order link button on order detail page
+  addActionBarItem({
+    id: 'qls-visit-order',
+    label: 'QLS',
+    locationId: 'order-detail',
+    buttonColor: 'primary',
+    buttonStyle: 'outline',
+    icon: 'link',
+    buttonState: (context) => {
+      return context.entity$.pipe(
+        map((entity) => ({
+          visible: !!entity?.orderPlacedAt,
+          disabled: false,
+        }))
+      );
+    },
+    onClick: async (event, { route, dataService, notificationService }) => {
+      const orderId = route.snapshot.params.id;
+      const res = await firstValueFrom(
+        dataService.query(
+          gql`
+            query Order($orderId: ID!) {
+              order(id: $orderId) {
+                id
+                qlsOrderUrl
+              }
+            }
+          `,
+          { orderId }
+        ).single$
+      );
+      const url = (res as any).order.qlsOrderUrl;
+      if (url) {
+        window.open(url, '_blank');
+      } else {
+        notificationService.notify({
+          message: 'No QLS order found for this order.',
+          type: 'error',
+        });
+      }
+    },
+  }),
+  // QLS product link button on product variant detail page
+  addActionBarItem({
+    id: 'qls-visit-product',
+    label: 'QLS',
+    locationId: 'product-variant-detail',
+    buttonColor: 'primary',
+    buttonStyle: 'outline',
+    icon: 'link',
+    onClick: async (event, { route, dataService, notificationService }) => {
+      const variantId = route.snapshot.params.id;
+      const res = await firstValueFrom(
+        dataService.query(
+          gql`
+            query ProductVariant($id: ID!) {
+              productVariant(id: $id) {
+                id
+                qlsProductUrl
+              }
+            }
+          `,
+          { id: variantId }
+        ).single$
+      );
+      const url = (res as any).productVariant.qlsProductUrl;
+      if (url) {
+        window.open(url, '_blank');
+      } else {
+        notificationService.notify({
+          message: 'No QLS product found for this variant.',
+          type: 'error',
+        });
+      }
+    },
+  }),
+  // Push order to QLS button on order detail page
+  addActionBarDropdownMenuItem({
+    id: 'qls-fulfillment-push-order',
+    label: 'Push order to QLS',
+    locationId: 'order-detail',
+    icon: 'resistor',
+    requiresPermission: ['QLSFullSync'],
+    hasDivider: true,
+    onClick: async (
+      _,
+      { route, dataService, notificationService, injector }
+    ) => {
+      const orderId = route.snapshot.params.id;
+      const res = await firstValueFrom(
+        dataService.query(
+          gql`
+            query Order($orderId: ID!) {
+              order(id: $orderId) {
+                id
+                qlsOrderIds
+              }
+            }
+          `,
+          { orderId }
+        ).single$
+      );
+      if ((res as any).order.qlsOrderIds.length > 0) {
+        const modalService = injector.get(ModalService);
+        const confirmed = await firstValueFrom(
+          modalService.dialog({
+            title: 'Push order to QLS',
+            body: 'This order already exists in QLS. Are you sure you want to push it again?',
+            buttons: [
+              { type: 'secondary', label: 'Cancel', returnValue: false },
+              { type: 'primary', label: 'Push to QLS', returnValue: true },
+            ],
+          })
+        );
+        if (!confirmed) return;
+      }
+
+      dataService
+        .mutate(
+          gql`
+            mutation PushOrderToQls($orderId: ID!) {
+              pushOrderToQls(orderId: $orderId)
+            }
+          `,
+          { orderId }
+        )
+        .subscribe({
+          next: (result) => {
+            notificationService.notify({
+              message: (result as any).pushOrderToQls,
+              type: 'success',
+            });
+          },
+          error: (err) => {
+            notificationService.notify({
+              message: err.message,
+              type: 'error',
+            });
+          },
+        });
+    },
+  }),
+  addActionBarDropdownMenuItem({
+    id: 'qls-fulfillment-add-ean',
+    label: 'Add additional EAN to QLS',
+    locationId: 'product-variant-detail',
+    icon: 'resistor',
+    requiresPermission: ['QLSFullSync'],
+    onClick: async (
+      _,
+      { route, dataService, notificationService, entity$ }
+    ) => {
+      const ean = window.prompt('Enter additional EAN to add to QLS:');
+      if (!ean) {
+        return;
+      }
+      const variantId = route.snapshot.params.id;
+      try {
+        const variant = await firstValueFrom(entity$.pipe(take(1)));
+        const confirmed = window.confirm(
+          `Wil je EAN "${ean}" toevoegen aan "${variant?.name}"?`
+        );
+        if (!confirmed) {
+          return;
+        }
+      } catch (err) {
+        notificationService.notify({
+          message: (err as any).message,
+          type: 'error',
+        });
+        return;
+      }
+      dataService
+        .mutate(
+          gql`
+            mutation AddAdditionalEANSToQLS(
+              $variantId: ID!
+              $additionalEANS: [String!]!
+            ) {
+              addAdditionalEANSToQLS(
+                variantId: $variantId
+                additionalEANS: $additionalEANS
+              )
+            }
+          `,
+          { variantId, additionalEANS: [ean] }
+        )
+        .subscribe({
+          next: () => {
+            notificationService.notify({
+              message: `Added EAN ${ean} to QLS`,
+              type: 'success',
+            });
+          },
+          error: (err) => {
+            notificationService.notify({
+              message: err.message,
+              type: 'error',
+            });
+          },
+        });
+    },
+  }),
+];

package/package.json

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