@contrail/flexplm 1.5.0 → 1.5.1-alpha.2e74ff1

package/CHANGELOG.md

@@ -7,6 +7,10 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [1.5.1] - 2026-05-14
+### Added
+- Added sending an external event with the publish payload and trigger key of `VibeIQ|AssortmentPublishedToFlexPLM` to enable secondary events to run on the event / data which was generated.  Also includes the payload in the data which can be passed to the next action.
+
 ## [1.5.0] - 2026-05-12
 ### Added
 - Added support for Inbound `LCSMaterial` to sync to the entity class `item` with type path `item:material` and `itemNumber` as identifier.  This is controlled by an `LCSMaterial.processAsItem` (default `false`) config default.

package/lib/publish/base-process-publish-assortment.d.ts

@@ -77,8 +77,10 @@ export declare class BaseProcessPublishAssortment {
     getResultsCount(events: any): any;
     private sendEvents;
     private sendToFlexPLM;
+    private buildPublishError;
     private saveToLocalFile;
     private handleVibeIQFile;
+    private sendPublishPayloadEvent;
     private getCurrentDateString;
     getItemFamilyChanges(pcd: PublishChangeData, changeDetail: any, assortmentItemFullChangeMap: Map<string, any>, assortmentItemDeleteMap: Map<string, any>): Map<string, ItemFamilyChanges>;
     getEventsForPublishChangeData(publishChangeData: PublishChangeData): Promise<SeasonalPayload[]>;

package/lib/publish/base-process-publish-assortment.js

@@ -569,14 +569,37 @@ class BaseProcessPublishAssortment {
         }
     }
     async sendToFlexPLM(events, eventType) {
-        const asyncEvent = {
+        const outboundPublishEvent = {
             taskId: this.config.taskId,
             eventType,
             objectClass: 'LCSSeason',
             events
         };
         const flexPLMConnect = new flexplm_connect_1.FlexPLMConnect(this.config);
-        return await flexPLMConnect.sendToFlexPLM(asyncEvent);
+        const [sendResult, eventResult] = await Promise.allSettled([
+            flexPLMConnect.sendToFlexPLM(outboundPublishEvent),
+            this.sendPublishPayloadEvent(outboundPublishEvent)
+        ]);
+        if (sendResult.status === 'rejected' || eventResult.status === 'rejected') {
+            throw this.buildPublishError(sendResult, eventResult, outboundPublishEvent);
+        }
+        const result = sendResult.value;
+        const isResultObject = typeof result === 'object' && result !== null;
+        return isResultObject
+            ? { ...result, outboundPublishEvent }
+            : { result, outboundPublishEvent };
+    }
+    buildPublishError(sendResult, eventResult, outboundPublishEvent) {
+        const baseReason = sendResult.status === 'rejected' ? sendResult.reason : eventResult.reason;
+        const error = baseReason instanceof Error ? baseReason : new Error(String(baseReason));
+        error.outboundPublishEvent = outboundPublishEvent;
+        error.sendToFlexPLMResult = sendResult.status === 'fulfilled'
+            ? sendResult.value
+            : { error: sendResult.reason?.message ?? String(sendResult.reason) };
+        error.sendPublishPayloadEventResult = eventResult.status === 'fulfilled'
+            ? eventResult.value
+            : { error: eventResult.reason?.message ?? String(eventResult.reason) };
+        return error;
     }
     async saveToLocalFile(events, eventType) {
         let results = {};
@@ -588,15 +611,16 @@ class BaseProcessPublishAssortment {
             const eventDirName = 'events-output';
             const fileName = `${path.sep}${eventDirName}${path.sep}events-${dateString}.json`;
             fileHandle = await fsPromise.open('.' + fileName, 'a');
-            const asyncEvent = {
+            const outboundPublishEvent = {
                 taskId: this.config.taskId,
                 eventType,
                 objectClass: 'LCSSeason',
                 events
             };
-            await fileHandle.writeFile(JSON.stringify(asyncEvent));
+            await fileHandle.writeFile(JSON.stringify(outboundPublishEvent));
             results = {
                 message: 'Successfully Saved File',
+                outboundPublishEvent,
                 fileLocation: dirName + fileName
             };
         }
@@ -612,7 +636,7 @@ class BaseProcessPublishAssortment {
         const eventBuffer = Buffer.from(JSON.stringify(events), 'utf-8');
         const fileName = 'ASYNC_PUBLISH_SEASON-events.json';
         const uploadFile = await new sdk_1.Files().createAndUploadFileFromBuffer(eventBuffer, 'application/json', fileName, null, this.TTL);
-        const asyncEvent = {
+        const outboundPublishEvent = {
             taskId: this.config.taskId,
             eventType,
             objectClass: 'LCSSeason',
@@ -622,15 +646,46 @@ class BaseProcessPublishAssortment {
         };
         if (sendMode === 'vibeiqfile') {
             const flexPLMConnect = new flexplm_connect_1.FlexPLMConnect(this.config);
-            return await flexPLMConnect.sendToFlexPLM(asyncEvent);
+            const [sendResult, eventResult] = await Promise.allSettled([
+                flexPLMConnect.sendToFlexPLM(outboundPublishEvent),
+                this.sendPublishPayloadEvent(outboundPublishEvent)
+            ]);
+            if (sendResult.status === 'rejected' || eventResult.status === 'rejected') {
+                throw this.buildPublishError(sendResult, eventResult, outboundPublishEvent);
+            }
+            const result = sendResult.value;
+            const isResultObject = typeof result === 'object' && result !== null;
+            return isResultObject
+                ? { ...result, outboundPublishEvent }
+                : { result, outboundPublishEvent };
         }
         else {
+            await this.sendPublishPayloadEvent(outboundPublishEvent);
             return {
                 message: 'Successfully Uploaded File.',
-                asyncEvent
+                outboundPublishEvent
             };
         }
     }
+    async sendPublishPayloadEvent(outboundPublishEvent) {
+        console.info('sendPublishPayloadEvent()');
+        let initialEvent = {};
+        if (this.config?.event) {
+            initialEvent = (typeof this.config?.event === 'string')
+                ? JSON.parse(this.config?.event)
+                : this.config?.event;
+        }
+        const eventBody = {
+            originSystemType: 'VibeIQ',
+            objectClass: 'AssortmentPublishedToFlexPLM',
+            outboundPublishEvent,
+            initialEvent
+        };
+        await new sdk_1.Entities().create({
+            entityName: 'external-event',
+            object: eventBody
+        });
+    }
     getCurrentDateString() {
         const d = new Date();
         return '' + d.getUTCFullYear()

package/lib/publish/base-process-publish-assortment.spec.js

@@ -9,6 +9,7 @@ const sdk_1 = require("@contrail/sdk");
 const type_conversion_utils_1 = require("../util/type-conversion-utils");
 const map_utils_1 = require("../util/map-utils");
 const item_family_changes_1 = require("../interfaces/item-family-changes");
+const flexplm_connect_1 = require("../util/flexplm-connect");
 let federatedId = '';
 jest.mock('../util/data-converter', () => {
     return {
@@ -30,6 +31,13 @@ jest.mock('../util/federation', () => {
 });
 let entityObject = {};
 let getOptionsObject = {};
+let createCallArg = undefined;
+let fileUploadCalls = [];
+let fileUploadResult = {
+    id: 'file-123',
+    downloadUrl: 'https://download.url',
+    adminDownloadUrl: 'https://admin.download.url'
+};
 jest.mock('@contrail/sdk', () => {
     return {
         Entities: class {
@@ -37,6 +45,18 @@ jest.mock('@contrail/sdk', () => {
                 getOptionsObject = _getOtionsObject;
                 return entityObject;
             }
+            create(arg) {
+                createCallArg = arg;
+                return Promise.resolve({});
+            }
+        },
+        Files: class {
+            createAndUploadFileFromBuffer(buffer, mimeType, fileName, _x, ttl) {
+                fileUploadCalls.push({ buffer, mimeType, fileName, ttl });
+                return Promise.resolve(fileUploadResult);
+            }
+        },
+        Request: class {
         }
     };
 });
@@ -1668,3 +1688,195 @@ describe('getEventsForItemFamilyChanges - conditional eventType', () => {
         expect(type_conversion_utils_1.TypeConversionUtils.isOutboundCreatableFromEntity).toHaveBeenNthCalledWith(2, undefined, mapFileUtil, colorProjectItem, { item: itemData, assortment });
     });
 });
+describe('sendToFlexPLM / handleVibeIQFile / sendPublishPayloadEvent', () => {
+    const config = {
+        taskId: 'task-abc',
+        event: '{"sourceEventId":"src-1"}'
+    };
+    const mapFileUtil = new transform_data_1.MapFileUtil(new sdk_1.Entities());
+    const dc = new data_converter_1.DataConverter(config, mapFileUtil);
+    const events = [{ objectClass: 'LCSProductSeasonLink' }];
+    const eventType = 'ASYNC_PUBLISH_SEASON';
+    beforeEach(() => {
+        createCallArg = undefined;
+        fileUploadCalls = [];
+        fileUploadResult = {
+            id: 'file-123',
+            downloadUrl: 'https://download.url',
+            adminDownloadUrl: 'https://admin.download.url'
+        };
+    });
+    afterEach(() => {
+        jest.restoreAllMocks();
+    });
+    it('should merge outboundPublishEvent into result and call sendPublishPayloadEvent in parallel', async () => {
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(config, dc, mapFileUtil);
+        const flexResponse = { status: 200, data: { ok: true } };
+        let flexResolved = false;
+        let eventResolved = false;
+        const spyFlex = jest.spyOn(flexplm_connect_1.FlexPLMConnect.prototype, 'sendToFlexPLM')
+            .mockImplementation(async () => {
+            await new Promise(r => setTimeout(r, 5));
+            flexResolved = true;
+            return flexResponse;
+        });
+        const spyEvent = jest.spyOn(bppa, 'sendPublishPayloadEvent')
+            .mockImplementation(async () => {
+            await new Promise(r => setTimeout(r, 5));
+            eventResolved = true;
+        });
+        const result = await bppa.sendToFlexPLM(events, eventType);
+        expect(spyFlex).toHaveBeenCalledTimes(1);
+        expect(spyEvent).toHaveBeenCalledTimes(1);
+        expect(flexResolved).toBe(true);
+        expect(eventResolved).toBe(true);
+        const passedOutboundPublishEvent = spyFlex.mock.calls[0][0];
+        expect(passedOutboundPublishEvent.taskId).toBe('task-abc');
+        expect(passedOutboundPublishEvent.eventType).toBe(eventType);
+        expect(passedOutboundPublishEvent.objectClass).toBe('LCSSeason');
+        expect(passedOutboundPublishEvent.events).toBe(events);
+        expect(spyEvent).toHaveBeenCalledWith(passedOutboundPublishEvent);
+        expect(result).toEqual({ ...flexResponse, outboundPublishEvent: passedOutboundPublishEvent });
+    });
+    it('sendToFlexPLM throws when flexPLMConnect.sendToFlexPLM fails, attaching outboundPublishEvent and both results', async () => {
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(config, dc, mapFileUtil);
+        const flexError = new Error('flex failed');
+        const eventResponse = { eventOk: true };
+        jest.spyOn(flexplm_connect_1.FlexPLMConnect.prototype, 'sendToFlexPLM').mockRejectedValue(flexError);
+        jest.spyOn(bppa, 'sendPublishPayloadEvent').mockResolvedValue(eventResponse);
+        await expect(bppa.sendToFlexPLM(events, eventType)).rejects.toMatchObject({
+            message: 'flex failed',
+            outboundPublishEvent: expect.objectContaining({ taskId: 'task-abc', eventType, objectClass: 'LCSSeason', events }),
+            sendToFlexPLMResult: { error: 'flex failed' },
+            sendPublishPayloadEventResult: eventResponse
+        });
+    });
+    it('sendToFlexPLM throws when sendPublishPayloadEvent fails, with flex result attached', async () => {
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(config, dc, mapFileUtil);
+        const flexResponse = { status: 200 };
+        const eventError = new Error('event failed');
+        jest.spyOn(flexplm_connect_1.FlexPLMConnect.prototype, 'sendToFlexPLM').mockResolvedValue(flexResponse);
+        jest.spyOn(bppa, 'sendPublishPayloadEvent').mockRejectedValue(eventError);
+        await expect(bppa.sendToFlexPLM(events, eventType)).rejects.toMatchObject({
+            message: 'event failed',
+            outboundPublishEvent: expect.objectContaining({ taskId: 'task-abc', eventType }),
+            sendToFlexPLMResult: flexResponse,
+            sendPublishPayloadEventResult: { error: 'event failed' }
+        });
+    });
+    it('sendToFlexPLM throws the flexPLMConnect error when both fail', async () => {
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(config, dc, mapFileUtil);
+        const flexError = new Error('flex failed');
+        const eventError = new Error('event failed');
+        jest.spyOn(flexplm_connect_1.FlexPLMConnect.prototype, 'sendToFlexPLM').mockRejectedValue(flexError);
+        jest.spyOn(bppa, 'sendPublishPayloadEvent').mockRejectedValue(eventError);
+        await expect(bppa.sendToFlexPLM(events, eventType)).rejects.toBe(flexError);
+        expect(flexError.outboundPublishEvent).toBeDefined();
+        expect(flexError.sendToFlexPLMResult).toEqual({ error: 'flex failed' });
+        expect(flexError.sendPublishPayloadEventResult).toEqual({ error: 'event failed' });
+    });
+    it('handleVibeIQFile (vibeiqfile) throws when flexPLMConnect.sendToFlexPLM fails, with both results attached', async () => {
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(config, dc, mapFileUtil);
+        const flexError = new Error('flex failed');
+        const eventResponse = { eventOk: true };
+        jest.spyOn(flexplm_connect_1.FlexPLMConnect.prototype, 'sendToFlexPLM').mockRejectedValue(flexError);
+        jest.spyOn(bppa, 'sendPublishPayloadEvent').mockResolvedValue(eventResponse);
+        await expect(bppa.handleVibeIQFile(events, eventType, 'vibeiqfile')).rejects.toMatchObject({
+            message: 'flex failed',
+            outboundPublishEvent: expect.objectContaining({ eventsFileId: 'file-123' }),
+            sendToFlexPLMResult: { error: 'flex failed' },
+            sendPublishPayloadEventResult: eventResponse
+        });
+    });
+    it('handleVibeIQFile (vibeiqfile) throws when sendPublishPayloadEvent fails, with flex result attached', async () => {
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(config, dc, mapFileUtil);
+        const flexResponse = { status: 200 };
+        const eventError = new Error('event failed');
+        jest.spyOn(flexplm_connect_1.FlexPLMConnect.prototype, 'sendToFlexPLM').mockResolvedValue(flexResponse);
+        jest.spyOn(bppa, 'sendPublishPayloadEvent').mockRejectedValue(eventError);
+        await expect(bppa.handleVibeIQFile(events, eventType, 'vibeiqfile')).rejects.toMatchObject({
+            message: 'event failed',
+            outboundPublishEvent: expect.objectContaining({ eventsFileId: 'file-123' }),
+            sendToFlexPLMResult: flexResponse,
+            sendPublishPayloadEventResult: { error: 'event failed' }
+        });
+    });
+    it('handleVibeIQFile (vibeiqfile) throws the flexPLMConnect error when both fail', async () => {
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(config, dc, mapFileUtil);
+        const flexError = new Error('flex failed');
+        const eventError = new Error('event failed');
+        jest.spyOn(flexplm_connect_1.FlexPLMConnect.prototype, 'sendToFlexPLM').mockRejectedValue(flexError);
+        jest.spyOn(bppa, 'sendPublishPayloadEvent').mockRejectedValue(eventError);
+        await expect(bppa.handleVibeIQFile(events, eventType, 'vibeiqfile')).rejects.toBe(flexError);
+        expect(flexError.sendToFlexPLMResult).toEqual({ error: 'flex failed' });
+        expect(flexError.sendPublishPayloadEventResult).toEqual({ error: 'event failed' });
+    });
+    it('should merge outboundPublishEvent into FlexPLM result and call sendPublishPayloadEvent when mode is vibeiqfile', async () => {
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(config, dc, mapFileUtil);
+        const flexResponse = { status: 200, data: { ok: true } };
+        const spyFlex = jest.spyOn(flexplm_connect_1.FlexPLMConnect.prototype, 'sendToFlexPLM')
+            .mockResolvedValue(flexResponse);
+        const spyEvent = jest.spyOn(bppa, 'sendPublishPayloadEvent')
+            .mockResolvedValue(undefined);
+        const result = await bppa.handleVibeIQFile(events, eventType, 'vibeiqfile');
+        expect(fileUploadCalls).toHaveLength(1);
+        expect(fileUploadCalls[0].fileName).toBe('ASYNC_PUBLISH_SEASON-events.json');
+        expect(fileUploadCalls[0].mimeType).toBe('application/json');
+        const passedOutboundPublishEvent = spyFlex.mock.calls[0][0];
+        expect(passedOutboundPublishEvent.taskId).toBe('task-abc');
+        expect(passedOutboundPublishEvent.eventType).toBe(eventType);
+        expect(passedOutboundPublishEvent.objectClass).toBe('LCSSeason');
+        expect(passedOutboundPublishEvent.eventsFileId).toBe('file-123');
+        expect(passedOutboundPublishEvent.eventsDownloadLink).toBe('https://download.url');
+        expect(passedOutboundPublishEvent.eventsAdminDownloadLink).toBe('https://admin.download.url');
+        expect(spyFlex).toHaveBeenCalledTimes(1);
+        expect(spyEvent).toHaveBeenCalledTimes(1);
+        expect(spyEvent).toHaveBeenCalledWith(passedOutboundPublishEvent);
+        expect(result).toEqual({ ...flexResponse, outboundPublishEvent: passedOutboundPublishEvent });
+    });
+    it('should skip FlexPLM but still call sendPublishPayloadEvent when mode is vibeiqfile-dontsendtoflexplm', async () => {
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(config, dc, mapFileUtil);
+        const spyFlex = jest.spyOn(flexplm_connect_1.FlexPLMConnect.prototype, 'sendToFlexPLM')
+            .mockResolvedValue({});
+        const spyEvent = jest.spyOn(bppa, 'sendPublishPayloadEvent')
+            .mockResolvedValue(undefined);
+        const result = await bppa.handleVibeIQFile(events, eventType, 'vibeiqfile-dontsendtoflexplm');
+        expect(spyFlex).not.toHaveBeenCalled();
+        expect(spyEvent).toHaveBeenCalledTimes(1);
+        const passedOutboundPublishEvent = spyEvent.mock.calls[0][0];
+        expect(passedOutboundPublishEvent.eventsFileId).toBe('file-123');
+        expect(result).toEqual({
+            message: 'Successfully Uploaded File.',
+            outboundPublishEvent: passedOutboundPublishEvent
+        });
+    });
+    it('should create an external-event with initialEvent parsed from config', async () => {
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(config, dc, mapFileUtil);
+        const outboundPublishEvent = { foo: 'bar' };
+        await bppa.sendPublishPayloadEvent(outboundPublishEvent);
+        expect(createCallArg).toEqual({
+            entityName: 'external-event',
+            object: {
+                originSystemType: 'VibeIQ',
+                objectClass: 'AssortmentPublishedToFlexPLM',
+                outboundPublishEvent,
+                initialEvent: { sourceEventId: 'src-1' }
+            }
+        });
+    });
+    it('should default initialEvent to {} when config has no event', async () => {
+        const bareConfig = { taskId: 'task-x' };
+        const bppa = new base_process_publish_assortment_1.BaseProcessPublishAssortment(bareConfig, dc, mapFileUtil);
+        const outboundPublishEvent = { hello: 'world' };
+        await bppa.sendPublishPayloadEvent(outboundPublishEvent);
+        expect(createCallArg).toEqual({
+            entityName: 'external-event',
+            object: {
+                originSystemType: 'VibeIQ',
+                objectClass: 'AssortmentPublishedToFlexPLM',
+                outboundPublishEvent,
+                initialEvent: {}
+            }
+        });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrail/flexplm",
-  "version": "1.5.0",
+  "version": "1.5.1-alpha.2e74ff1",
   "description": "Library used for integration with flexplm.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/publish/base-process-publish-assortment.spec.ts

@@ -8,6 +8,7 @@ import { Entities } from '@contrail/sdk';
 import { TypeConversionUtils } from '../util/type-conversion-utils';
 import { MapUtil } from '../util/map-utils';
 import { ItemFamilyChanges } from '../interfaces/item-family-changes';
+import { FlexPLMConnect } from '../util/flexplm-connect';
 
 let federatedId = '';
 jest.mock('../util/data-converter', () => {
@@ -32,6 +33,13 @@ jest.mock('../util/federation', () => {
 });
 let entityObject = {};
 let getOptionsObject = {};
+let createCallArg: any = undefined;
+let fileUploadCalls: any[] = [];
+let fileUploadResult: any = {
+  id: 'file-123',
+  downloadUrl: 'https://download.url',
+  adminDownloadUrl: 'https://admin.download.url'
+};
 jest.mock('@contrail/sdk', () => {
   return {
     Entities: class{
@@ -39,7 +47,18 @@ jest.mock('@contrail/sdk', () => {
         getOptionsObject = _getOtionsObject;
         return entityObject;
       }
-    }
+      create(arg){
+        createCallArg = arg;
+        return Promise.resolve({});
+      }
+    },
+    Files: class{
+      createAndUploadFileFromBuffer(buffer, mimeType, fileName, _x, ttl){
+        fileUploadCalls.push({ buffer, mimeType, fileName, ttl });
+        return Promise.resolve(fileUploadResult);
+      }
+    },
+    Request: class{}
   };
 });
 describe('process publish assortment', () => {
@@ -1989,4 +2008,238 @@ describe('getEventsForItemFamilyChanges - conditional eventType', () => {
     );
   });
 
+});
+
+describe('sendToFlexPLM / handleVibeIQFile / sendPublishPayloadEvent', () => {
+  const config = {
+    taskId: 'task-abc',
+    event: '{"sourceEventId":"src-1"}'
+  } as unknown as FCConfig;
+  const mapFileUtil = new MapFileUtil(new Entities());
+  const dc = new DataConverter(config, mapFileUtil);
+  const events = [{ objectClass: 'LCSProductSeasonLink' }] as any;
+  const eventType = 'ASYNC_PUBLISH_SEASON';
+
+  beforeEach(() => {
+    createCallArg = undefined;
+    fileUploadCalls = [];
+    fileUploadResult = {
+      id: 'file-123',
+      downloadUrl: 'https://download.url',
+      adminDownloadUrl: 'https://admin.download.url'
+    };
+  });
+  afterEach(() => {
+    jest.restoreAllMocks();
+  });
+
+  it('should merge outboundPublishEvent into result and call sendPublishPayloadEvent in parallel', async () => {
+    const bppa = new BaseProcessPublishAssortment(config, dc, mapFileUtil);
+    const flexResponse = { status: 200, data: { ok: true } };
+
+    let flexResolved = false;
+    let eventResolved = false;
+    const spyFlex = jest.spyOn(FlexPLMConnect.prototype, 'sendToFlexPLM')
+      .mockImplementation(async () => {
+        await new Promise(r => setTimeout(r, 5));
+        flexResolved = true;
+        return flexResponse as any;
+      });
+    const spyEvent = jest.spyOn(bppa as any, 'sendPublishPayloadEvent')
+      .mockImplementation(async () => {
+        await new Promise(r => setTimeout(r, 5));
+        eventResolved = true;
+      });
+
+    const result = await (bppa as any).sendToFlexPLM(events, eventType);
+
+    expect(spyFlex).toHaveBeenCalledTimes(1);
+    expect(spyEvent).toHaveBeenCalledTimes(1);
+    expect(flexResolved).toBe(true);
+    expect(eventResolved).toBe(true);
+
+    const passedOutboundPublishEvent = spyFlex.mock.calls[0][0] as any;
+    expect(passedOutboundPublishEvent.taskId).toBe('task-abc');
+    expect(passedOutboundPublishEvent.eventType).toBe(eventType);
+    expect(passedOutboundPublishEvent.objectClass).toBe('LCSSeason');
+    expect(passedOutboundPublishEvent.events).toBe(events);
+    expect(spyEvent).toHaveBeenCalledWith(passedOutboundPublishEvent);
+    expect(result).toEqual({ ...flexResponse, outboundPublishEvent: passedOutboundPublishEvent });
+  });
+
+  it('sendToFlexPLM throws when flexPLMConnect.sendToFlexPLM fails, attaching outboundPublishEvent and both results', async () => {
+    const bppa = new BaseProcessPublishAssortment(config, dc, mapFileUtil);
+    const flexError = new Error('flex failed');
+    const eventResponse = { eventOk: true };
+
+    jest.spyOn(FlexPLMConnect.prototype, 'sendToFlexPLM').mockRejectedValue(flexError);
+    jest.spyOn(bppa as any, 'sendPublishPayloadEvent').mockResolvedValue(eventResponse as any);
+
+    await expect((bppa as any).sendToFlexPLM(events, eventType)).rejects.toMatchObject({
+      message: 'flex failed',
+      outboundPublishEvent: expect.objectContaining({ taskId: 'task-abc', eventType, objectClass: 'LCSSeason', events }),
+      sendToFlexPLMResult: { error: 'flex failed' },
+      sendPublishPayloadEventResult: eventResponse
+    });
+  });
+
+  it('sendToFlexPLM throws when sendPublishPayloadEvent fails, with flex result attached', async () => {
+    const bppa = new BaseProcessPublishAssortment(config, dc, mapFileUtil);
+    const flexResponse = { status: 200 };
+    const eventError = new Error('event failed');
+
+    jest.spyOn(FlexPLMConnect.prototype, 'sendToFlexPLM').mockResolvedValue(flexResponse as any);
+    jest.spyOn(bppa as any, 'sendPublishPayloadEvent').mockRejectedValue(eventError);
+
+    await expect((bppa as any).sendToFlexPLM(events, eventType)).rejects.toMatchObject({
+      message: 'event failed',
+      outboundPublishEvent: expect.objectContaining({ taskId: 'task-abc', eventType }),
+      sendToFlexPLMResult: flexResponse,
+      sendPublishPayloadEventResult: { error: 'event failed' }
+    });
+  });
+
+  it('sendToFlexPLM throws the flexPLMConnect error when both fail', async () => {
+    const bppa = new BaseProcessPublishAssortment(config, dc, mapFileUtil);
+    const flexError = new Error('flex failed');
+    const eventError = new Error('event failed');
+
+    jest.spyOn(FlexPLMConnect.prototype, 'sendToFlexPLM').mockRejectedValue(flexError);
+    jest.spyOn(bppa as any, 'sendPublishPayloadEvent').mockRejectedValue(eventError);
+
+    await expect((bppa as any).sendToFlexPLM(events, eventType)).rejects.toBe(flexError);
+    expect((flexError as any).outboundPublishEvent).toBeDefined();
+    expect((flexError as any).sendToFlexPLMResult).toEqual({ error: 'flex failed' });
+    expect((flexError as any).sendPublishPayloadEventResult).toEqual({ error: 'event failed' });
+  });
+
+  it('handleVibeIQFile (vibeiqfile) throws when flexPLMConnect.sendToFlexPLM fails, with both results attached', async () => {
+    const bppa = new BaseProcessPublishAssortment(config, dc, mapFileUtil);
+    const flexError = new Error('flex failed');
+    const eventResponse = { eventOk: true };
+
+    jest.spyOn(FlexPLMConnect.prototype, 'sendToFlexPLM').mockRejectedValue(flexError);
+    jest.spyOn(bppa as any, 'sendPublishPayloadEvent').mockResolvedValue(eventResponse as any);
+
+    await expect((bppa as any).handleVibeIQFile(events, eventType, 'vibeiqfile')).rejects.toMatchObject({
+      message: 'flex failed',
+      outboundPublishEvent: expect.objectContaining({ eventsFileId: 'file-123' }),
+      sendToFlexPLMResult: { error: 'flex failed' },
+      sendPublishPayloadEventResult: eventResponse
+    });
+  });
+
+  it('handleVibeIQFile (vibeiqfile) throws when sendPublishPayloadEvent fails, with flex result attached', async () => {
+    const bppa = new BaseProcessPublishAssortment(config, dc, mapFileUtil);
+    const flexResponse = { status: 200 };
+    const eventError = new Error('event failed');
+
+    jest.spyOn(FlexPLMConnect.prototype, 'sendToFlexPLM').mockResolvedValue(flexResponse as any);
+    jest.spyOn(bppa as any, 'sendPublishPayloadEvent').mockRejectedValue(eventError);
+
+    await expect((bppa as any).handleVibeIQFile(events, eventType, 'vibeiqfile')).rejects.toMatchObject({
+      message: 'event failed',
+      outboundPublishEvent: expect.objectContaining({ eventsFileId: 'file-123' }),
+      sendToFlexPLMResult: flexResponse,
+      sendPublishPayloadEventResult: { error: 'event failed' }
+    });
+  });
+
+  it('handleVibeIQFile (vibeiqfile) throws the flexPLMConnect error when both fail', async () => {
+    const bppa = new BaseProcessPublishAssortment(config, dc, mapFileUtil);
+    const flexError = new Error('flex failed');
+    const eventError = new Error('event failed');
+
+    jest.spyOn(FlexPLMConnect.prototype, 'sendToFlexPLM').mockRejectedValue(flexError);
+    jest.spyOn(bppa as any, 'sendPublishPayloadEvent').mockRejectedValue(eventError);
+
+    await expect((bppa as any).handleVibeIQFile(events, eventType, 'vibeiqfile')).rejects.toBe(flexError);
+    expect((flexError as any).sendToFlexPLMResult).toEqual({ error: 'flex failed' });
+    expect((flexError as any).sendPublishPayloadEventResult).toEqual({ error: 'event failed' });
+  });
+
+  it('should merge outboundPublishEvent into FlexPLM result and call sendPublishPayloadEvent when mode is vibeiqfile', async () => {
+    const bppa = new BaseProcessPublishAssortment(config, dc, mapFileUtil);
+    const flexResponse = { status: 200, data: { ok: true } };
+
+    const spyFlex = jest.spyOn(FlexPLMConnect.prototype, 'sendToFlexPLM')
+      .mockResolvedValue(flexResponse as any);
+    const spyEvent = jest.spyOn(bppa as any, 'sendPublishPayloadEvent')
+      .mockResolvedValue(undefined as any);
+
+    const result = await (bppa as any).handleVibeIQFile(events, eventType, 'vibeiqfile');
+
+    expect(fileUploadCalls).toHaveLength(1);
+    expect(fileUploadCalls[0].fileName).toBe('ASYNC_PUBLISH_SEASON-events.json');
+    expect(fileUploadCalls[0].mimeType).toBe('application/json');
+
+    const passedOutboundPublishEvent = spyFlex.mock.calls[0][0] as any;
+    expect(passedOutboundPublishEvent.taskId).toBe('task-abc');
+    expect(passedOutboundPublishEvent.eventType).toBe(eventType);
+    expect(passedOutboundPublishEvent.objectClass).toBe('LCSSeason');
+    expect(passedOutboundPublishEvent.eventsFileId).toBe('file-123');
+    expect(passedOutboundPublishEvent.eventsDownloadLink).toBe('https://download.url');
+    expect(passedOutboundPublishEvent.eventsAdminDownloadLink).toBe('https://admin.download.url');
+
+    expect(spyFlex).toHaveBeenCalledTimes(1);
+    expect(spyEvent).toHaveBeenCalledTimes(1);
+    expect(spyEvent).toHaveBeenCalledWith(passedOutboundPublishEvent);
+    expect(result).toEqual({ ...flexResponse, outboundPublishEvent: passedOutboundPublishEvent });
+  });
+
+  it('should skip FlexPLM but still call sendPublishPayloadEvent when mode is vibeiqfile-dontsendtoflexplm', async () => {
+    const bppa = new BaseProcessPublishAssortment(config, dc, mapFileUtil);
+
+    const spyFlex = jest.spyOn(FlexPLMConnect.prototype, 'sendToFlexPLM')
+      .mockResolvedValue({} as any);
+    const spyEvent = jest.spyOn(bppa as any, 'sendPublishPayloadEvent')
+      .mockResolvedValue(undefined as any);
+
+    const result = await (bppa as any).handleVibeIQFile(events, eventType, 'vibeiqfile-dontsendtoflexplm');
+
+    expect(spyFlex).not.toHaveBeenCalled();
+    expect(spyEvent).toHaveBeenCalledTimes(1);
+
+    const passedOutboundPublishEvent = spyEvent.mock.calls[0][0] as any;
+    expect(passedOutboundPublishEvent.eventsFileId).toBe('file-123');
+    expect(result).toEqual({
+      message: 'Successfully Uploaded File.',
+      outboundPublishEvent: passedOutboundPublishEvent
+    });
+  });
+
+  it('should create an external-event with initialEvent parsed from config', async () => {
+    const bppa = new BaseProcessPublishAssortment(config, dc, mapFileUtil);
+    const outboundPublishEvent = { foo: 'bar' };
+
+    await (bppa as any).sendPublishPayloadEvent(outboundPublishEvent);
+
+    expect(createCallArg).toEqual({
+      entityName: 'external-event',
+      object: {
+        originSystemType: 'VibeIQ',
+        objectClass: 'AssortmentPublishedToFlexPLM',
+        outboundPublishEvent,
+        initialEvent: { sourceEventId: 'src-1' }
+      }
+    });
+  });
+
+  it('should default initialEvent to {} when config has no event', async () => {
+    const bareConfig = { taskId: 'task-x' } as unknown as FCConfig;
+    const bppa = new BaseProcessPublishAssortment(bareConfig, dc, mapFileUtil);
+    const outboundPublishEvent = { hello: 'world' };
+
+    await (bppa as any).sendPublishPayloadEvent(outboundPublishEvent);
+
+    expect(createCallArg).toEqual({
+      entityName: 'external-event',
+      object: {
+        originSystemType: 'VibeIQ',
+        objectClass: 'AssortmentPublishedToFlexPLM',
+        outboundPublishEvent,
+        initialEvent: {}
+      }
+    });
+  });
 });

package/src/publish/base-process-publish-assortment.ts

@@ -685,7 +685,7 @@ export class BaseProcessPublishAssortment {
   }
 
   private async sendToFlexPLM(events: SeasonalPayload[], eventType: string) {
-    const asyncEvent: AsyncEventsPayloadType = {
+    const outboundPublishEvent: AsyncEventsPayloadType = {
       taskId: this.config.taskId,
       eventType,
       objectClass: 'LCSSeason',
@@ -693,7 +693,37 @@ export class BaseProcessPublishAssortment {
     };
 
     const flexPLMConnect = new FlexPLMConnect(this.config);
-    return await flexPLMConnect.sendToFlexPLM(asyncEvent);
+    const [sendResult, eventResult] = await Promise.allSettled([
+      flexPLMConnect.sendToFlexPLM(outboundPublishEvent),
+      this.sendPublishPayloadEvent(outboundPublishEvent)
+    ]);
+
+    if (sendResult.status === 'rejected' || eventResult.status === 'rejected') {
+      throw this.buildPublishError(sendResult, eventResult, outboundPublishEvent);
+    }
+
+    const result = sendResult.value;
+    const isResultObject = typeof result === 'object' && result !== null;
+    return isResultObject
+      ? { ...result, outboundPublishEvent }
+      : { result, outboundPublishEvent };
+  }
+
+  private buildPublishError(
+    sendResult: PromiseSettledResult<any>,
+    eventResult: PromiseSettledResult<any>,
+    outboundPublishEvent: AsyncEventsPayloadType
+  ): Error {
+    const baseReason = sendResult.status === 'rejected' ? sendResult.reason : (eventResult as PromiseRejectedResult).reason;
+    const error: any = baseReason instanceof Error ? baseReason : new Error(String(baseReason));
+    error.outboundPublishEvent = outboundPublishEvent;
+    error.sendToFlexPLMResult = sendResult.status === 'fulfilled'
+      ? sendResult.value
+      : { error: sendResult.reason?.message ?? String(sendResult.reason) };
+    error.sendPublishPayloadEventResult = eventResult.status === 'fulfilled'
+      ? eventResult.value
+      : { error: eventResult.reason?.message ?? String(eventResult.reason) };
+    return error;
   }
 
   private async saveToLocalFile(events: SeasonalPayload[], eventType: string) {
@@ -708,17 +738,18 @@ export class BaseProcessPublishAssortment {
       const fileName = `${path.sep}${eventDirName}${path.sep}events-${dateString}.json`;
       fileHandle = await fsPromise.open('.' + fileName, 'a');
 
-      const asyncEvent: AsyncEventsPayloadType = {
+      const outboundPublishEvent: AsyncEventsPayloadType = {
         taskId: this.config.taskId,
         eventType,
         objectClass: 'LCSSeason',
         events
       };
 
-      await fileHandle.writeFile(JSON.stringify(asyncEvent));
+      await fileHandle.writeFile(JSON.stringify(outboundPublishEvent));
 
       results = {
         message: 'Successfully Saved File',
+        outboundPublishEvent,
         fileLocation: dirName + fileName
       };
     } catch (e) {
@@ -735,26 +766,62 @@ export class BaseProcessPublishAssortment {
     const fileName = 'ASYNC_PUBLISH_SEASON-events.json';
     const uploadFile = await new Files().createAndUploadFileFromBuffer(eventBuffer, 'application/json', fileName, null, this.TTL);
 
-    const asyncEvent: AsyncEventsPayloadType = {
+    const outboundPublishEvent: AsyncEventsPayloadType = {
       taskId: this.config.taskId,
       eventType,
       objectClass: 'LCSSeason',
       eventsFileId: uploadFile.id,
       eventsDownloadLink: uploadFile.downloadUrl,
       eventsAdminDownloadLink: uploadFile.adminDownloadUrl
-};
+    };
 
     if (sendMode === 'vibeiqfile') {
       const flexPLMConnect = new FlexPLMConnect(this.config);
-      return await flexPLMConnect.sendToFlexPLM(asyncEvent);
+      const [sendResult, eventResult] = await Promise.allSettled([
+        flexPLMConnect.sendToFlexPLM(outboundPublishEvent),
+        this.sendPublishPayloadEvent(outboundPublishEvent)
+      ]);
+
+      if (sendResult.status === 'rejected' || eventResult.status === 'rejected') {
+        throw this.buildPublishError(sendResult, eventResult, outboundPublishEvent);
+      }
+
+      const result = sendResult.value;
+      const isResultObject = typeof result === 'object' && result !== null;
+      return isResultObject
+        ? { ...result, outboundPublishEvent }
+        : { result, outboundPublishEvent };
     } else {
+      await this.sendPublishPayloadEvent(outboundPublishEvent);
       return {
         message: 'Successfully Uploaded File.',
-        asyncEvent
+        outboundPublishEvent
       };
     }
   }
 
+    private async sendPublishPayloadEvent(outboundPublishEvent: AsyncEventsPayloadType){
+    console.info('sendPublishPayloadEvent()');
+    let initialEvent = {};
+    if (this.config?.event){
+      initialEvent = (typeof this.config?.event === 'string')
+        ? JSON.parse(this.config?.event)
+        : this.config?.event;
+    }
+    const eventBody = {
+      originSystemType: 'VibeIQ',
+      objectClass: 'AssortmentPublishedToFlexPLM',
+      outboundPublishEvent,
+      initialEvent
+    };
+
+    await new Entities().create({
+      entityName: 'external-event',
+      object: eventBody
+    });
+  }
+
+
   private getCurrentDateString() {
     const d = new Date();
     return '' + d.getUTCFullYear()