@rytass/wms-module-graphql 0.4.0 → 0.5.0

package/index.cjs.js

@@ -10,6 +10,7 @@ var typeorm = require('typeorm');
 var DataLoader = require('dataloader');
 var graphql = require('@nestjs/graphql');
 var core = require('@nestjs/core');
+var rxjs = require('rxjs');
 var wmsBaseNestjsModule = require('@rytass/wms-base-nestjs-module');
 var warehouseMap_entity = require('@rytass/wms-base-nestjs-module/models/warehouse-map.entity');
 
@@ -304,6 +305,87 @@ exports.WmsAuthGuard = tslib.__decorate([
  */
 const WmsOperation = (requirement) => common.applyDecorators(common.SetMetadata(WMS_OPERATION_METADATA, requirement), common.SetMetadata(HOST_SKIP_METADATA_KEY, true), common.UseGuards(exports.WmsAuthGuard));
 
+/** Reflector metadata key carrying the {@link WmsMutationEventConfig}. */
+const WMS_MUTATION_EVENT_METADATA = 'wms:mutation-event';
+
+const defaultResolveId = (result, args) => {
+    if (result &&
+        typeof result === 'object' &&
+        'id' in result &&
+        typeof result.id === 'string') {
+        return result.id;
+    }
+    const argId = args['id'];
+    return typeof argId === 'string' ? argId : null;
+};
+/**
+ * Wraps each `@WmsMutationEvent` mutation in a dispatch scope:
+ * 1. runs the before-hook (throw -> veto, before any transaction);
+ * 2. executes the resolver (services collect stock events into the scope);
+ * 3. emits the operation event after the handler resolves (post-commit);
+ * 4. flushes the whole buffer to after-listeners + emitter bridge.
+ *
+ * When no hook/listener/bridge is configured it passes through untouched.
+ */
+exports.WmsMutationInterceptor = class WmsMutationInterceptor {
+    reflector;
+    dispatcher;
+    constructor(reflector, dispatcher) {
+        this.reflector = reflector;
+        this.dispatcher = dispatcher;
+    }
+    async intercept(context, next) {
+        const config = this.reflector.get(WMS_MUTATION_EVENT_METADATA, context.getHandler());
+        if (!config || !this.dispatcher.isActive()) {
+            return next.handle();
+        }
+        const args = graphql.GqlExecutionContext.create(context).getArgs() ??
+            {};
+        // Before-hook runs before any DB work; a throw vetoes with zero side effects.
+        await this.dispatcher.runBeforeHook({
+            event: config.event,
+            args,
+            executionContext: context,
+        });
+        const { result, events } = await wmsModuleCore.runInDispatchScope(async () => {
+            const handlerResult = await rxjs.firstValueFrom(next.handle());
+            const id = config.resolveId
+                ? config.resolveId(handlerResult, args)
+                : defaultResolveId(handlerResult, args);
+            const operationEvent = {
+                name: config.event,
+                payload: { id, result: handlerResult },
+            };
+            wmsModuleCore.collectToScope(operationEvent);
+            return handlerResult;
+        });
+        if (events) {
+            await this.dispatcher.flush(events);
+        }
+        return rxjs.of(result);
+    }
+};
+exports.WmsMutationInterceptor = tslib.__decorate([
+    common.Injectable(),
+    tslib.__metadata("design:paramtypes", [core.Reflector,
+        wmsModuleCore.WmsEventDispatcher])
+], exports.WmsMutationInterceptor);
+
+/**
+ * Declares the operation event for a WMS root mutation and wires the
+ * {@link WmsMutationInterceptor} that runs before-hooks (veto) and flushes
+ * collected events post-commit. Apply alongside `@WmsOperation` on each mutation.
+ *
+ * @example
+ * ```ts
+ * @Mutation(() => ShipInventoryOrderDto)
+ * @WmsOperation({ resource: 'ship-inventory-order', action: 'ship' })
+ * @WmsMutationEvent({ event: 'ship-inventory-order.shipped' })
+ * ship(@Args() args: ShipArgs): Promise<boolean> { ... }
+ * ```
+ */
+const WmsMutationEvent = (config) => common.applyDecorators(common.SetMetadata(WMS_MUTATION_EVENT_METADATA, config), common.UseInterceptors(exports.WmsMutationInterceptor));
+
 const IdGenFunction = (input) => {
     const hash = crypto.createHash('sha256');
     hash.update(input);
@@ -1633,6 +1715,7 @@ let LoaderMutation = class LoaderMutation {
 tslib.__decorate([
     graphql.Mutation(() => [LoaderDto]),
     WmsOperation({ resource: 'loader', action: 'create' }),
+    WmsMutationEvent({ event: 'loader.created' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [CreateLoaderArgs]),
@@ -1641,6 +1724,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => [LoaderDto]),
     WmsOperation({ resource: 'loader', action: 'create' }),
+    WmsMutationEvent({ event: 'loader.batch-created' }),
     tslib.__param(0, graphql.Args('items', { type: () => [CreateLoadersArgs] })),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [Array]),
@@ -1649,6 +1733,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => LoaderDto),
     WmsOperation({ resource: 'loader', action: 'update' }),
+    WmsMutationEvent({ event: 'loader.updated' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [UpdateLoaderArgs]),
@@ -1657,6 +1742,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => LoaderTypeDto),
     WmsOperation({ resource: 'loader', action: 'create' }),
+    WmsMutationEvent({ event: 'loader.type-created' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [CreateLoaderTypeArgs]),
@@ -1665,6 +1751,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => LoaderTypeDto),
     WmsOperation({ resource: 'loader', action: 'update' }),
+    WmsMutationEvent({ event: 'loader.type-updated' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [UpdateLoaderTypeArgs]),
@@ -2028,6 +2115,7 @@ let MaterialMutation = class MaterialMutation {
 tslib.__decorate([
     graphql.Mutation(() => MaterialDto),
     WmsOperation({ resource: 'material', action: 'create' }),
+    WmsMutationEvent({ event: 'material.created' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [CreateMaterialArgs]),
@@ -2036,6 +2124,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => MaterialDto),
     WmsOperation({ resource: 'material', action: 'update' }),
+    WmsMutationEvent({ event: 'material.updated' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [UpdateMaterialArgs]),
@@ -2431,6 +2520,7 @@ let ReceiveInventoryOrderMutation = class ReceiveInventoryOrderMutation {
 tslib.__decorate([
     graphql.Mutation(() => ReceiveInventoryOrderDto),
     WmsOperation({ resource: 'receive-inventory-order', action: 'create' }),
+    WmsMutationEvent({ event: 'receive-inventory-order.created' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [CreateReceiveInventoryOrderArgs]),
@@ -2439,6 +2529,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => ReceiveInventoryOrderDto),
     WmsOperation({ resource: 'receive-inventory-order', action: 'update' }),
+    WmsMutationEvent({ event: 'receive-inventory-order.updated' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [UpdateReceiveInventoryOrderArgs]),
@@ -2447,6 +2538,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => Boolean),
     WmsOperation({ resource: 'receive-inventory-order', action: 'receive' }),
+    WmsMutationEvent({ event: 'receive-inventory-order.received' }),
     tslib.__param(0, graphql.Args('items', { type: () => [ReceiveOrderArgs] })),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [Array]),
@@ -2790,6 +2882,7 @@ let ShipInventoryOrderMutation = class ShipInventoryOrderMutation {
 tslib.__decorate([
     graphql.Mutation(() => ShipInventoryOrderDto),
     WmsOperation({ resource: 'ship-inventory-order', action: 'create' }),
+    WmsMutationEvent({ event: 'ship-inventory-order.created' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [CreateShipInventoryOrderArgs]),
@@ -2798,6 +2891,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => ShipInventoryOrderDto),
     WmsOperation({ resource: 'ship-inventory-order', action: 'update' }),
+    WmsMutationEvent({ event: 'ship-inventory-order.updated' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [UpdateShipInventoryOrderArgs]),
@@ -2806,6 +2900,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => Boolean),
     WmsOperation({ resource: 'ship-inventory-order', action: 'ship' }),
+    WmsMutationEvent({ event: 'ship-inventory-order.shipped' }),
     tslib.__param(0, graphql.Args('items', { type: () => [ShipOrderArgs] })),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [Array]),
@@ -2814,6 +2909,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => Boolean),
     WmsOperation({ resource: 'ship-inventory-order', action: 'cancel' }),
+    WmsMutationEvent({ event: 'ship-inventory-order.ship-cancelled' }),
     tslib.__param(0, graphql.Args('items', { type: () => [CancelShipOrderArgs] })),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [Array]),
@@ -3469,6 +3565,7 @@ let WarehouseMapMutation = class WarehouseMapMutation {
 tslib.__decorate([
     graphql.Mutation(() => MapDataDto),
     WmsOperation({ resource: 'warehouse-map', action: 'update' }),
+    WmsMutationEvent({ event: 'warehouse-map.updated' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [UpdateWarehouseMapArgs]),
@@ -3650,6 +3747,7 @@ let LocationMutation = class LocationMutation {
 tslib.__decorate([
     graphql.Mutation(() => LocationDto),
     WmsOperation({ resource: 'location', action: 'create' }),
+    WmsMutationEvent({ event: 'location.created' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [CreateLocationArgs]),
@@ -3658,6 +3756,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => LocationDto),
     WmsOperation({ resource: 'location', action: 'update' }),
+    WmsMutationEvent({ event: 'location.updated' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [UpdateLocationArgs]),
@@ -3961,6 +4060,7 @@ let TransferOrderMutation = class TransferOrderMutation {
 tslib.__decorate([
     graphql.Mutation(() => TransferOrderDto),
     WmsOperation({ resource: 'transfer-order', action: 'create' }),
+    WmsMutationEvent({ event: 'transfer-order.created' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [CreateTransferOrderArgs]),
@@ -3969,6 +4069,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => TransferOrderDto),
     WmsOperation({ resource: 'transfer-order', action: 'update' }),
+    WmsMutationEvent({ event: 'transfer-order.updated' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [UpdateTransferOrderArgs]),
@@ -3977,6 +4078,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => Boolean),
     WmsOperation({ resource: 'transfer-order', action: 'transfer' }),
+    WmsMutationEvent({ event: 'transfer-order.transferred' }),
     tslib.__param(0, graphql.Args('items', { type: () => [TransferOrderArgs] })),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [Array]),
@@ -3985,6 +4087,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => Boolean),
     WmsOperation({ resource: 'transfer-order', action: 'cancel' }),
+    WmsMutationEvent({ event: 'transfer-order.transfer-cancelled' }),
     tslib.__param(0, graphql.Args('items', { type: () => [CancelTransferOrderArgs] })),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [Array]),
@@ -4436,6 +4539,7 @@ let HoldInventoryOrderMutation = class HoldInventoryOrderMutation {
 tslib.__decorate([
     graphql.Mutation(() => HoldInventoryOrderDto),
     WmsOperation({ resource: 'hold-inventory-order', action: 'create' }),
+    WmsMutationEvent({ event: 'hold-inventory-order.created' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [CreateHoldInventoryOrderArgs]),
@@ -4444,6 +4548,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => HoldInventoryOrderDto),
     WmsOperation({ resource: 'hold-inventory-order', action: 'update' }),
+    WmsMutationEvent({ event: 'hold-inventory-order.updated' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [UpdateHoldInventoryOrderArgs]),
@@ -4452,6 +4557,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => Boolean),
     WmsOperation({ resource: 'hold-inventory-order', action: 'release' }),
+    WmsMutationEvent({ event: 'hold-inventory-order.released' }),
     tslib.__param(0, graphql.Args('items', { type: () => [ReleaseOrderArgs] })),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [Array]),
@@ -4970,6 +5076,7 @@ let AllocateInventoryOrderMutation = class AllocateInventoryOrderMutation {
 tslib.__decorate([
     graphql.Mutation(() => AllocateInventoryOrderDto),
     WmsOperation({ resource: 'allocate-inventory-order', action: 'create' }),
+    WmsMutationEvent({ event: 'allocate-inventory-order.created' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [CreateAllocateInventoryOrderArgs]),
@@ -4978,6 +5085,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => AllocateInventoryOrderDto),
     WmsOperation({ resource: 'allocate-inventory-order', action: 'update' }),
+    WmsMutationEvent({ event: 'allocate-inventory-order.updated' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [UpdateAllocateInventoryOrderArgs]),
@@ -4986,6 +5094,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => Boolean),
     WmsOperation({ resource: 'allocate-inventory-order', action: 'deallocate' }),
+    WmsMutationEvent({ event: 'allocate-inventory-order.deallocated' }),
     tslib.__param(0, graphql.Args('items', { type: () => [DeallocateOrderArgs] })),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [Array]),
@@ -5442,6 +5551,7 @@ let SplitBatchMutation = class SplitBatchMutation {
 tslib.__decorate([
     graphql.Mutation(() => SplitBatchOrderDto),
     WmsOperation({ resource: 'batch', action: 'split' }),
+    WmsMutationEvent({ event: 'batch.splitted' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [SplitBatchArgs]),
@@ -5561,6 +5671,7 @@ let MergeBatchMutation = class MergeBatchMutation {
 tslib.__decorate([
     graphql.Mutation(() => MergeBatchOrderDto),
     WmsOperation({ resource: 'batch', action: 'merge' }),
+    WmsMutationEvent({ event: 'batch.merged' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [MergeBatchArgs]),
@@ -5686,6 +5797,7 @@ let ReclassifyInventoryOrderMutation = class ReclassifyInventoryOrderMutation {
 tslib.__decorate([
     graphql.Mutation(() => ReclassifyInventoryOrderDto),
     WmsOperation({ resource: 'reclassify-inventory-order', action: 'reclassify' }),
+    WmsMutationEvent({ event: 'reclassify-inventory-order.reclassified' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [ReclassifyInventoryOrderArgs]),
@@ -5859,6 +5971,7 @@ let TransferCustomerOrderMutation = class TransferCustomerOrderMutation {
 tslib.__decorate([
     graphql.Mutation(() => TransferCustomerOrderDto),
     WmsOperation({ resource: 'transfer-customer-order', action: 'create' }),
+    WmsMutationEvent({ event: 'transfer-customer-order.created' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [CreateTransferCustomerOrderArgs]),
@@ -5867,6 +5980,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => TransferCustomerOrderDto),
     WmsOperation({ resource: 'transfer-customer-order', action: 'update' }),
+    WmsMutationEvent({ event: 'transfer-customer-order.updated' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [UpdateTransferCustomerOrderArgs]),
@@ -5875,6 +5989,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => Boolean),
     WmsOperation({ resource: 'transfer-customer-order', action: 'return' }),
+    WmsMutationEvent({ event: 'transfer-customer-order.returned' }),
     tslib.__param(0, graphql.Args('items', { type: () => [ReturnTransferCustomerOrderArgs] })),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [Array]),
@@ -6067,6 +6182,7 @@ let TransferVendorOrderMutation = class TransferVendorOrderMutation {
 tslib.__decorate([
     graphql.Mutation(() => TransferVendorOrderDto),
     WmsOperation({ resource: 'transfer-vendor-order', action: 'create' }),
+    WmsMutationEvent({ event: 'transfer-vendor-order.created' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [CreateTransferVendorOrderArgs]),
@@ -6075,6 +6191,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => TransferVendorOrderDto),
     WmsOperation({ resource: 'transfer-vendor-order', action: 'update' }),
+    WmsMutationEvent({ event: 'transfer-vendor-order.updated' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [UpdateTransferVendorOrderArgs]),
@@ -6083,6 +6200,7 @@ tslib.__decorate([
 tslib.__decorate([
     graphql.Mutation(() => Boolean),
     WmsOperation({ resource: 'transfer-vendor-order', action: 'return' }),
+    WmsMutationEvent({ event: 'transfer-vendor-order.returned' }),
     tslib.__param(0, graphql.Args('items', { type: () => [ReturnTransferVendorOrderArgs] })),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [Array]),
@@ -6205,6 +6323,7 @@ let ScrapeMutation = class ScrapeMutation {
 tslib.__decorate([
     graphql.Mutation(() => ScrapeOrderDto),
     WmsOperation({ resource: 'scrape-order', action: 'scrape' }),
+    WmsMutationEvent({ event: 'scrape-order.scraped' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [ScrapeOrderArgs]),
@@ -6288,6 +6407,7 @@ let QualityInspectionOrderMutation = class QualityInspectionOrderMutation {
 tslib.__decorate([
     graphql.Mutation(() => QualityInspectionOrderDto),
     WmsOperation({ resource: 'quality-inspection-order', action: 'inspect' }),
+    WmsMutationEvent({ event: 'quality-inspection-order.inspected' }),
     tslib.__param(0, graphql.Args()),
     tslib.__metadata("design:type", Function),
     tslib.__metadata("design:paramtypes", [CreateQualityInspectionOrderArgs]),
@@ -6401,13 +6521,18 @@ const exportDependencies = [
 ];
 exports.WmsModuleGraphqlModule = WmsModuleGraphqlModule_1 = class WmsModuleGraphqlModule {
     static forRootAsync(options) {
-        const { authChecker, ...coreOptions } = options;
+        const { authChecker, beforeHooks, afterListeners, eventEmitterBridge, ...coreOptions } = options;
         const coreModule = wmsModuleCore.WmsModuleCoreModule.forRootAsync(coreOptions);
         const authOptions = { authChecker };
+        const eventOptions = { beforeHooks, afterListeners };
         const providers = [
             ...exportDependencies,
             exports.WmsAuthGuard,
             { provide: WMS_AUTH_OPTIONS, useValue: authOptions },
+            { provide: wmsModuleCore.WMS_EVENT_OPTIONS, useValue: eventOptions },
+            wmsModuleCore.WmsEventDispatcher,
+            exports.WmsMutationInterceptor,
+            ...(eventEmitterBridge ? [eventEmitterBridge] : []),
         ];
         return {
             module: WmsModuleGraphqlModule_1,
@@ -6425,6 +6550,8 @@ exports.WmsModuleGraphqlModule = WmsModuleGraphqlModule_1 = tslib.__decorate([
 
 exports.HOST_SKIP_METADATA_KEY = HOST_SKIP_METADATA_KEY;
 exports.WMS_AUTH_OPTIONS = WMS_AUTH_OPTIONS;
+exports.WMS_MUTATION_EVENT_METADATA = WMS_MUTATION_EVENT_METADATA;
 exports.WMS_OPERATION_METADATA = WMS_OPERATION_METADATA;
+exports.WmsMutationEvent = WmsMutationEvent;
 exports.WmsOperation = WmsOperation;
 exports.createWmsLoaders = createWmsLoaders;

package/index.d.ts

@@ -5,3 +5,5 @@ export type { LoaderType } from './lib/helpers/dataloader.type';
 export { createWmsLoaders, type WmsLoaders, } from './lib/helpers/create-wms-loaders';
 export { HOST_SKIP_METADATA_KEY, WmsAuthGuard, WmsOperation, WMS_AUTH_OPTIONS, WMS_OPERATION_METADATA, type WmsAuthChecker, type WmsAuthModuleOptions, type WmsOperationRequirement, } from './lib/auth';
 export type { WmsModuleGraphqlModuleAsyncOptions } from './lib/graphql.module';
+export { WmsMutationEvent, WmsMutationInterceptor, WMS_MUTATION_EVENT_METADATA, type WmsMutationEventConfig, } from './lib/events';
+export type { WmsAfterEventContext, WmsAfterListener, WmsAfterListenerMap, WmsBeforeHook, WmsBeforeHookContext, WmsBeforeHookMap, WmsDomainEvent, WmsEventModuleOptions, WmsEventName, WmsEventPayloadMap, WmsOperationEventName, WmsOperationEventPayload, WmsStockEventName, WmsStockEventPayload, } from '@rytass/wms-module-core';

package/index.js

@@ -5,3 +5,6 @@ export { HOST_SKIP_METADATA_KEY } from './lib/auth/host-skip.constant.js';
 export { WmsAuthGuard } from './lib/auth/wms-auth.guard.js';
 export { WmsOperation } from './lib/auth/wms-operation.decorator.js';
 export { WMS_AUTH_OPTIONS, WMS_OPERATION_METADATA } from './lib/auth/wms-auth.types.js';
+export { WmsMutationEvent } from './lib/events/wms-mutation-event.decorator.js';
+export { WMS_MUTATION_EVENT_METADATA } from './lib/events/wms-mutation-event.constants.js';
+export { WmsMutationInterceptor } from './lib/events/wms-mutation.interceptor.js';

package/lib/events/index.d.ts

@@ -0,0 +1,3 @@
+export { WmsMutationEvent } from './wms-mutation-event.decorator';
+export { WMS_MUTATION_EVENT_METADATA, type WmsMutationEventConfig, } from './wms-mutation-event.constants';
+export { WmsMutationInterceptor } from './wms-mutation.interceptor';

package/lib/events/wms-mutation-event.constants.d.ts

@@ -0,0 +1,12 @@
+import type { WmsOperationEventName } from '@rytass/wms-module-core';
+/** Reflector metadata key carrying the {@link WmsMutationEventConfig}. */
+export declare const WMS_MUTATION_EVENT_METADATA = "wms:mutation-event";
+export interface WmsMutationEventConfig {
+    /** The operation event emitted for this mutation (post-commit). */
+    readonly event: WmsOperationEventName;
+    /**
+     * Optional override for deriving the operation's primary id from the handler
+     * result and/or arguments. Defaults to `result.id ?? args.id ?? null`.
+     */
+    readonly resolveId?: (result: unknown, args: Readonly<Record<string, unknown>>) => string | null;
+}

package/lib/events/wms-mutation-event.constants.js

@@ -0,0 +1,4 @@
+/** Reflector metadata key carrying the {@link WmsMutationEventConfig}. */
+const WMS_MUTATION_EVENT_METADATA = 'wms:mutation-event';
+
+export { WMS_MUTATION_EVENT_METADATA };

package/lib/events/wms-mutation-event.decorator.d.ts

@@ -0,0 +1,15 @@
+import { type WmsMutationEventConfig } from './wms-mutation-event.constants';
+/**
+ * Declares the operation event for a WMS root mutation and wires the
+ * {@link WmsMutationInterceptor} that runs before-hooks (veto) and flushes
+ * collected events post-commit. Apply alongside `@WmsOperation` on each mutation.
+ *
+ * @example
+ * ```ts
+ * @Mutation(() => ShipInventoryOrderDto)
+ * @WmsOperation({ resource: 'ship-inventory-order', action: 'ship' })
+ * @WmsMutationEvent({ event: 'ship-inventory-order.shipped' })
+ * ship(@Args() args: ShipArgs): Promise<boolean> { ... }
+ * ```
+ */
+export declare const WmsMutationEvent: (config: WmsMutationEventConfig) => MethodDecorator;

package/lib/events/wms-mutation-event.decorator.js

@@ -0,0 +1,20 @@
+import { applyDecorators, SetMetadata, UseInterceptors } from '@nestjs/common';
+import { WMS_MUTATION_EVENT_METADATA } from './wms-mutation-event.constants.js';
+import { WmsMutationInterceptor } from './wms-mutation.interceptor.js';
+
+/**
+ * Declares the operation event for a WMS root mutation and wires the
+ * {@link WmsMutationInterceptor} that runs before-hooks (veto) and flushes
+ * collected events post-commit. Apply alongside `@WmsOperation` on each mutation.
+ *
+ * @example
+ * ```ts
+ * @Mutation(() => ShipInventoryOrderDto)
+ * @WmsOperation({ resource: 'ship-inventory-order', action: 'ship' })
+ * @WmsMutationEvent({ event: 'ship-inventory-order.shipped' })
+ * ship(@Args() args: ShipArgs): Promise<boolean> { ... }
+ * ```
+ */
+const WmsMutationEvent = (config) => applyDecorators(SetMetadata(WMS_MUTATION_EVENT_METADATA, config), UseInterceptors(WmsMutationInterceptor));
+
+export { WmsMutationEvent };

package/lib/events/wms-mutation.interceptor.d.ts

@@ -0,0 +1,19 @@
+import { type CallHandler, type ExecutionContext, type NestInterceptor } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { WmsEventDispatcher } from '@rytass/wms-module-core';
+import { type Observable } from 'rxjs';
+/**
+ * Wraps each `@WmsMutationEvent` mutation in a dispatch scope:
+ * 1. runs the before-hook (throw -> veto, before any transaction);
+ * 2. executes the resolver (services collect stock events into the scope);
+ * 3. emits the operation event after the handler resolves (post-commit);
+ * 4. flushes the whole buffer to after-listeners + emitter bridge.
+ *
+ * When no hook/listener/bridge is configured it passes through untouched.
+ */
+export declare class WmsMutationInterceptor implements NestInterceptor {
+    private readonly reflector;
+    private readonly dispatcher;
+    constructor(reflector: Reflector, dispatcher: WmsEventDispatcher);
+    intercept(context: ExecutionContext, next: CallHandler): Promise<Observable<unknown>>;
+}

package/lib/events/wms-mutation.interceptor.js

@@ -0,0 +1,72 @@
+import { __decorate, __metadata } from 'tslib';
+import { Injectable } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { GqlExecutionContext } from '@nestjs/graphql';
+import { WmsEventDispatcher, runInDispatchScope, collectToScope } from '@rytass/wms-module-core';
+import { firstValueFrom, of } from 'rxjs';
+import { WMS_MUTATION_EVENT_METADATA } from './wms-mutation-event.constants.js';
+
+const defaultResolveId = (result, args) => {
+    if (result &&
+        typeof result === 'object' &&
+        'id' in result &&
+        typeof result.id === 'string') {
+        return result.id;
+    }
+    const argId = args['id'];
+    return typeof argId === 'string' ? argId : null;
+};
+/**
+ * Wraps each `@WmsMutationEvent` mutation in a dispatch scope:
+ * 1. runs the before-hook (throw -> veto, before any transaction);
+ * 2. executes the resolver (services collect stock events into the scope);
+ * 3. emits the operation event after the handler resolves (post-commit);
+ * 4. flushes the whole buffer to after-listeners + emitter bridge.
+ *
+ * When no hook/listener/bridge is configured it passes through untouched.
+ */
+let WmsMutationInterceptor = class WmsMutationInterceptor {
+    reflector;
+    dispatcher;
+    constructor(reflector, dispatcher) {
+        this.reflector = reflector;
+        this.dispatcher = dispatcher;
+    }
+    async intercept(context, next) {
+        const config = this.reflector.get(WMS_MUTATION_EVENT_METADATA, context.getHandler());
+        if (!config || !this.dispatcher.isActive()) {
+            return next.handle();
+        }
+        const args = GqlExecutionContext.create(context).getArgs() ??
+            {};
+        // Before-hook runs before any DB work; a throw vetoes with zero side effects.
+        await this.dispatcher.runBeforeHook({
+            event: config.event,
+            args,
+            executionContext: context,
+        });
+        const { result, events } = await runInDispatchScope(async () => {
+            const handlerResult = await firstValueFrom(next.handle());
+            const id = config.resolveId
+                ? config.resolveId(handlerResult, args)
+                : defaultResolveId(handlerResult, args);
+            const operationEvent = {
+                name: config.event,
+                payload: { id, result: handlerResult },
+            };
+            collectToScope(operationEvent);
+            return handlerResult;
+        });
+        if (events) {
+            await this.dispatcher.flush(events);
+        }
+        return of(result);
+    }
+};
+WmsMutationInterceptor = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [Reflector,
+        WmsEventDispatcher])
+], WmsMutationInterceptor);
+
+export { WmsMutationInterceptor };

package/lib/graphql.module.d.ts

@@ -1,12 +1,22 @@
-import { DynamicModule } from '@nestjs/common';
-import type { WmsModuleCoreModuleAsyncOptions } from '@rytass/wms-module-core';
+import { DynamicModule, type Provider } from '@nestjs/common';
+import { type WmsModuleCoreModuleAsyncOptions, type WmsEventModuleOptions } from '@rytass/wms-module-core';
 import { type WmsAuthModuleOptions } from './auth';
 /**
  * Options for `WmsModuleGraphqlModule.forRootAsync`. Extends the core module
- * options with an optional {@link WmsAuthModuleOptions.authChecker}; when the
- * checker is omitted the module stays fully permissive (pre-auth behaviour).
+ * options with:
+ * - {@link WmsAuthModuleOptions.authChecker} — opt-in resolver authorization;
+ * - {@link WmsEventModuleOptions} — `beforeHooks` (veto) / `afterListeners`
+ *   (post-commit notify) for the mutation event/hook system;
+ * - `eventEmitterBridge` — pass `wmsEventEmitterBridgeProvider` from
+ *   `@rytass/wms-module-graphql/adapters/event-emitter` to also fan events out
+ *   to `@nestjs/event-emitter` (`@OnEvent('wms.<event>')`).
+ *
+ * Everything is optional; with nothing configured the module behaves exactly as
+ * before (no events emitted, fully permissive).
  */
-export type WmsModuleGraphqlModuleAsyncOptions = WmsModuleCoreModuleAsyncOptions & WmsAuthModuleOptions;
+export type WmsModuleGraphqlModuleAsyncOptions = WmsModuleCoreModuleAsyncOptions & WmsAuthModuleOptions & WmsEventModuleOptions & {
+    readonly eventEmitterBridge?: Provider;
+};
 export declare class WmsModuleGraphqlModule {
     static forRootAsync(options: WmsModuleGraphqlModuleAsyncOptions): DynamicModule;
 }

package/lib/graphql.module.js

@@ -1,11 +1,12 @@
 import { __decorate } from 'tslib';
 import { Module } from '@nestjs/common';
-import { WmsModuleCoreModule } from '@rytass/wms-module-core';
+import { WmsModuleCoreModule, WMS_EVENT_OPTIONS, WmsEventDispatcher } from '@rytass/wms-module-core';
 import './helpers/loader.service.js';
 import { HelperModule } from './helpers/helper.module.js';
 import './helpers/query-path.js';
 import { WmsAuthGuard } from './auth/wms-auth.guard.js';
 import { WMS_AUTH_OPTIONS } from './auth/wms-auth.types.js';
+import { WmsMutationInterceptor } from './events/wms-mutation.interceptor.js';
 import { LoaderMutation } from './mutations/loader.mutation.js';
 import { LoaderQuery } from './queries/loader.query.js';
 import { MaterialMutation } from './mutations/material.mutation.js';
@@ -110,13 +111,18 @@ const exportDependencies = [
 ];
 let WmsModuleGraphqlModule = WmsModuleGraphqlModule_1 = class WmsModuleGraphqlModule {
     static forRootAsync(options) {
-        const { authChecker, ...coreOptions } = options;
+        const { authChecker, beforeHooks, afterListeners, eventEmitterBridge, ...coreOptions } = options;
         const coreModule = WmsModuleCoreModule.forRootAsync(coreOptions);
         const authOptions = { authChecker };
+        const eventOptions = { beforeHooks, afterListeners };
         const providers = [
             ...exportDependencies,
             WmsAuthGuard,
             { provide: WMS_AUTH_OPTIONS, useValue: authOptions },
+            { provide: WMS_EVENT_OPTIONS, useValue: eventOptions },
+            WmsEventDispatcher,
+            WmsMutationInterceptor,
+            ...(eventEmitterBridge ? [eventEmitterBridge] : []),
         ];
         return {
             module: WmsModuleGraphqlModule_1,